fix: 修复行缘、切分还原与语言解析并同步文档

保留逐字 margin／jiya.bias 字体后备方案；补齐 demo 重排、量测边界说明及共享规则 1.0.1 反例向量。

验证：完整构建通过，Node 376 项、WKWebView 64 项及原生 demo 9 项通过；Firefox 仍暂缓。

dist/core/dom.d.ts

@@ -7,6 +7,8 @@ export interface CreateOptions {
     /** 文本內容。 */
     text?: string;
 }
+/** 切分時記錄真實來源身份；須於 clone 的排版標記覆寫前呼叫。 */
+export declare function registerSplitoffSource(clone: Element, source: Element, pass: string, ownedElements: WeakSet<Element>): void;
 /** 完成受控解包後登記；只接受真實、已移除且空的受管產物。 */
 export declare function recordUnwrappedParent(el: Element, parent: Node, ownedElements: WeakSet<Element>): void;
 /** 其他 pass／實例合法撤回來源包裹後，搬移記錄沿受控解包鏈查詢現父。 */

dist/core/finder.d.ts

@@ -82,8 +82,8 @@ export declare class Finder {
      * collectRuns／jiyaAdjacency／jinze／orphan／split 各 pass 逐元素重算——以 categoryCache
      * 記憶化砍除跨 pass 重複。安全性：單次 render 內一元素之分類**恆定**（class／skip 屬性／
      * nodeName 皆不因 render 變更；jz-* 包裹為新建元素、按 nodeName 分類亦恆定），且 Finder
-     * 隨 makeCtx 每次 render 重建 → 快取僅存活單次 render，無跨 render 失效問題（持久化屬 C1，
-     * 另議）。
+     * 隨實例持久化，跨 render／revert 復用；屬性或位置變化由 invalidateSubtree 清除受影響
+     * 子樹，不能沿用舊祖先鏈結果。
      */
     category(el: Element): InlineCategory;
     private computeCategory;

dist/core/locale.d.ts

@@ -20,12 +20,13 @@ export interface LocaleConfig {
     stylePolicy?: StyleRule[];
 }
 /**
- * 由節點向上找最近帶 lang 屬性之祖先，回傳小寫值；無則回傳 fallback。
+ * 由節點（含元素自身）向上找最近 lang，回傳小寫值；空值表示語言未知，僅缺失時回退。
  */
 export declare function effectiveLang(node: Node, fallback: string): string;
 /**
  * 將 BCP-47 語言標籤歸類。前綴以子標籤邊界比對（'zh-tw' 命中 zh-Hant，
- * 'zhx' 不命中 zh）。香港／台灣繁體歸 zh-Hant；含 Hant／Hans 子標籤者優先。
+ * 'zhx' 不命中 zh）。只讀 BCP-47 的 script／region 位置，不把 extension／private-use
+ * 內容當成腳本或地區；本函數不是完整標籤驗證器。
  */
 export declare function classify(lang: string): LangClass;
 /**

dist/core/unicode.d.ts

@@ -43,7 +43,7 @@ export declare const BD_LIGA = "\u2026\u2014";
 /** 全寬標點之六子類鍵。 */
 export type BdSubclass = "stop" | "pause" | "open" | "close" | "middle" | "liga";
 /**
- * 字符分類規則集（§4.2）：把「中文／西文／全寬標點各子類」各表為 regex 字元類片段。
+ * 字符分類規則集（§4.2）：中文／西文表為 regex 字元類片段，標點各子類為逐碼點字串（不解析範圍）。
  * 各 pass（spacing 之 CJK／ANS 正則、jiya 之 classifyBiaodian、jinze 之 anyCjk）皆由此
  * 取分類，不再各自硬編碼。內置默認見 DEFAULT_RULESET；消費端經 options.charClass 擴充
  * （resolveRuleset）。
@@ -60,11 +60,11 @@ export interface Ruleset {
 }
 /** 消費端字符分類覆寫（追加語義；見 README「自定義字符分類」）。 */
 export interface CharClassOverride {
-    /** 追加為中文（CJK）。 */
+    /** 追加為中文（CJK）：regex 字元類片段，特殊字元須轉義。 */
     cjk?: string;
-    /** 追加為西文（半寬標點亦歸此，按西文處理間隙）；併入 ansAfter／ansBefore。 */
+    /** 追加為西文：regex 字元類片段，特殊字元須轉義；併入 ansAfter／ansBefore。 */
     western?: string;
-    /** 追加為全寬標點，按子類。 */
+    /** 追加為全寬標點，按子類列出逐碼點字串；例如 "①②③"，不解析 "①-③" 為範圍。 */
     biaodian?: Partial<Record<BdSubclass, string>>;
 }
 /** 內置默認規則集（即現狀硬編碼值）。 */