fix(web): 修復排版邊界與增量生命週期

dist/core/finder.d.ts

@@ -25,6 +25,7 @@ export interface AdjacentChar {
     textNode: Text;
     offset: number;
     ch: string;
+    parts: TextSpan[];
 }
 /** 行內元素對排版之口徑分類（§4.1）——恰屬其一，優先序見 Finder.category。 */
 export type InlineCategory = "avoid" | "pill" | "isolate" | "block" | "transparent" | "opaque";
@@ -115,19 +116,21 @@ export declare class Finder {
     inScope(node: Node): boolean;
     /** 走訪 root 下所有「可處理」文本節點（已過濾 avoid / pill 內部 / 非作用域）。 */
     eachTextNode(root: Element, cb: (node: Text) => void): void;
-    /** 走訪 root 下所有 block 元素（含 root 本身若為 block）。 */
+    /** 走訪 root 下可處理之 block（含 root 本身若為 block）；pill／avoid 內部不可見。 */
     eachBlock(root: Element, cb: (block: Element) => void): void;
     /**
      * 收集 block 之邏輯文本 run（架構 §4.1，I7）：透明行內（isTransparent：styleInlines
      * ＋ wrap 類 jz-*）穿越、run 延續；block／pill／avoid 中斷 run；isolate 與**未知行內
-     * 標籤**（嚴格白名單）中斷 run 且內部自成獨立 run。回傳 text.length >= 2 之 run。
+     * 標籤**（嚴格白名單）中斷 run 且內部自成獨立 run。預設至少兩原子；includeSingletons
+     * 供段落邊界查詢保留單原子 run，不改間隙處理之預設。
      */
-    collectRuns(block: Element): LogicalRun[];
-    /**
-     * pill 之邏輯鄰字（架構 §4.1）：經樣式鏈遞迴，遇 pill／block／avoid／間隙
-     * marker 即止。direction = -1 取前鄰字，+1 取後鄰字。
-     */
-    adjacentLogicalChar(el: Element, direction: -1 | 1): AdjacentChar | null;
+    collectRuns(block: Element, includeSingletons?: boolean, feature?: string): LogicalRun[];
+    /** 從節點邊界或 Text offset 取相鄰碼點；只穿越透明、域內內容，scopeRoot 為硬邊界。 */
+    private adjacentTextCodePoint;
+    /** 補全透明 Text 邊界拆開的 surrogate pair；孤立碼元保留自身，不跨任何邊界拼接。 */
+    private adjacentCodePoint;
+    /** pill 之完整鄰字（base+至多一個 VS）；after 供查單個作者空格另一側，不越 scopeRoot。 */
+    adjacentLogicalChar(el: Element, direction: -1 | 1, scopeRoot?: Element, after?: AdjacentChar, feature?: string): AdjacentChar | null;
     /**
      * 節點之功能級別（§6.5.0a）。自 node 向上找**最近**之顯式信號：元素屬性
      * `data-jz-level="text|paragraph"`（最優先），或命中 `level.text` 選擇器（→ text）；