admin
c4e8c6cfd5
下游問題六：行內公式緊鄰禁則標點時，jinze 為綁鄰字透明下潛 .katex（全樹皆 SPAN，
僅憑標籤名判透明），把公式內側末字連同完整殼層逐層克隆切出（splitoff），上標漂移
錯位；pillSelector／skipAttribute／scope.avoid 三層防護全被刺穿。復現另揭兩向量：
相鄰 pill 時 descend 刺穿致 jz-hws 插入公式內部；pill 內部標點被 jiya charify。
確立三分類（§4.1，所有遍歷原語共用同一判定）：
透明（styleInlines＋jz-*）— 穿越／run 延續／可克隆切分；
隔離（isolateSelector，預設 "mark"，新增選項）— 邊界斷 run／斷相鄰／不可切分、
兩端補隙（同 pill），內部照常處理（自成脈絡）；
整體（pillSelector）— 內部對一切 pass 不可見（insidePill 過濾），禁則時作為
原子鄰字單位整體綁入 jz-jinze。
機制修復：
finder — transparentInline 改以元素判定（先排除 pill／isolate／avoid 再查標籤集）；
avoidsSelf 自身判定（isAvoided 僅查祖先，自身命中 avoid 曾被穿越）；descend 三態
（邊界字／無內容續找兄弟／blocked 終止——不可越界跳找更遠之字）；eachTextNode
過濾 pill 內部；collectRuns 隔離元素內部自成 run。
core/split — canSplit 諮詢 finder（pill／isolate／avoid 不可切 → 退化整綁）；
MARK 移出 SPLITTABLE（背景盒切分有可見接縫）。
jiyaAdjacency — pill／avoid（自身判定）斷相鄰不下探；isolate 斷而內部自成脈絡。
spacing Pass B — 邊界選擇器擴為 pill ∪ isolate；巢於 pill 內者跳過。
orphan — avoidsSelf 邊界；avoid 塊不綁（舊漏判：avoid 子樹內裸文本曾被計數包綁）。
v1 相容層移除（消費端已全數遷移 v2 API）：src/compat/v1.ts、IIFE 全域別名
createCjkAutospace、死選項 autospaceClass（經查從未被任何 pass 讀取）一併刪；
I8 退役。dist/compat 殘留聲明清除、dist/core/split.d.ts 補入庫（前次遺漏）。
測試 112 全綠（問題六 ×7、isolate ×6、compat 移除 ×1）；headless Chrome 實證
公式完整（splitoff=0、內部無 jz-hws／jz-char）、mark 與公式整體入 jz-jinze。
文檔：README 三分類節＋選項示例＋功能表（hanging 行補「已移除」）；ARCHITECTURE
§4.1 三分類／§3.5 相容層移除／§6.1／§6.3／§6.4／I8 退役。
30 lines
1.7 KiB
TypeScript
30 lines
1.7 KiB
TypeScript
/** jz-* 自訂元素名（皆含連字號，合法 custom element，預設 inline）。 */
|
|
export type JzTag = "jz-hws" | "jz-char" | "jz-inner" | "jz-cs" | "jz-jinze" | "jz-orphan" | "jz-em" | "jz-ruby" | "jz-rb" | "jz-rt";
|
|
type JzKind = "marker" | "wrap";
|
|
export interface CreateOptions {
|
|
/** 追加之 class（空白分隔或陣列）。 */
|
|
classes?: string | string[];
|
|
/** 文本內容。 */
|
|
text?: string;
|
|
/** 其餘屬性。 */
|
|
attrs?: Record<string, string>;
|
|
}
|
|
/** 造一個帶 pass 標記之 jz-* 元素。 */
|
|
export declare function createJz(tag: JzTag, pass: string, kind: JzKind, opts?: CreateOptions): HTMLElement;
|
|
/** 造一個 copy-clean 間隙標記（內含真實空白，user-select 由 CSS 關閉）。 */
|
|
export declare function createMarker(tag: JzTag, pass: string): HTMLElement;
|
|
/**
|
|
* 還原某 pass 之全部產物（I6）。以 data-jz 定址，逆文件序處理（先內層後
|
|
* 外層），marker 移除、wrap 解包，最後 normalize 受影響父節點合併文本。
|
|
*
|
|
* splitoff（克隆切分之邊界詞元，見 core/split.ts）須在 wrap 全部解包**之後**才併回：
|
|
* 否則其前兄弟可能仍是 wrap 殼（如 jz-jinze）而非原元素。故主迴圈跳過 splitoff，於
|
|
* 解包後第二階段以文件序逐一併回前兄弟（同標籤元素），還原為單一元素（I6 一致）。
|
|
*/
|
|
export declare function revertPass(pass: string, root: ParentNode): void;
|
|
/** 讀取 jz-char 之 bd-* 子類（無則 null）。 */
|
|
export declare function bdClassOf(el: Element): string | null;
|
|
/** 該元素是否為某／任一 pass 之 jz 產物。 */
|
|
export declare function isJz(node: Node | null, pass?: string): boolean;
|
|
export {};
|