 admin
|
3fbb2904ef
|
fix(split): 攀升對稱守衛——切分前驗整條祖先鏈可切，opaque 中間祖先不再被克隆肢解
下游 .selection-bar-message 病例：段末實義字落於 opaque <button>（巢於可切 <span>），
splitElementAt 僅驗頂層 span 可切；splitTreeAfter 逐層克隆 textNode→top 祖先鏈時，中間
opaque button 從未複查即被克隆肢解（複製出 splitoff button、破壞互動元素）。firstText／
lastText 守下潛（遇非可切回 null），但攀升無對稱守衛——此即真正病根，A7 之 per-instance
.selection-bar-message 迴避僅治標。
修復：splitTreeAfter 切分前先驗「textNode.parentNode…top（含 top）」整條祖先鏈皆 canSplit，
任一層 opaque／pill／isolate／帶 id 即回 null → 呼叫端綁整個 top（退化但安全，與下潛對稱）。
純新增守衛、無新克隆邏輯；jinze 之 isolateBoundaryToken 因下潛已守，行為不變。附帶亦杜絕
中間祖先帶 id 之克隆重複 id。
測試（129 全綠，+2）：末實義字在 opaque button（巢於可切 span）→ 綁整 span、無 splitoff、
button 完整無缺；退化路徑 render→revert 還原一致。亲驗：暫禁守衛則該測試於「無 splitoff」
斷言失敗（證明非空通過、病根屬實）。
文檔：split.ts 檔頭＋splitTreeAfter JSDoc＋ARCHITECTURE §6.5.1 補「canSplit 須對整條祖先鏈
成立、下潛＋攀升雙向守衛」之不變量。dist 重建。
|
2026-07-11 13:31:42 +08:00 |
|
|
admin
|
4f84d31785
|
refactor: 元素分類單一入口 finder.category ＋ ResizeObserver 派發序不變量確認
承階段二之兩件收尾：確認 lineedge 雙 ResizeObserver 之派發序（審計唯一未闭環項），並把散落
各遍歷原語之元素分類優先序收斂為單一 finder.category。
ResizeObserver 派發序——**確認為非缺陷**（Chrome headless 實測）：resize 時回調按 observer
**創建順序**派發（ResizeObserver 規範遍歷 observers 之插入序，非 observe 序；實測 seq=12——
反向 observe 仍按創建序）。lineEdgePass（order 90）之 observer 先於 gapTrimPass（order 92）建、
故每次 resize 皆先派發，gapTrim 之行末去隙判定恆基於 lineEdge **已套用**之半形版面（非陳舊態）。
以註解鎖為不變量（勿調換兩 pass 之 order／創建序），不需改碼。
元素分類單一入口：新增 `Finder.category(el): InlineCategory`——一元素恰屬 avoid／pill／isolate／
block／transparent／opaque 之一，優先序 `avoid ＞ pill ＞ isolate ＞ block ＞ transparent ＞ opaque`
集中一處（原散落 collectRuns／jiyaAdjacency／canSplit／isTransparent 各自短路、易漂移）。
・isTransparent ＝ `category === "transparent"`；collectRuns／jiyaAdjacency 改 `switch(category)`；
canSplit ＝ `SPLITTABLE ∩ transparent`（結構切分為獨立層、白名單更窄）。
・行為等價（121 全綠）；多命中優先序（data-jz-skip pill→avoid、pill＋isolate→pill、未知行內
→opaque 邊界）由既有行為測試覆蓋。
・README 三分類要點＋ARCHITECTURE §4.1 補優先序與 category 說明。
|
2026-07-07 21:45:06 +08:00 |
|
|
admin
|
c4e8c6cfd5
|
fix: 行內元素三分類（透明／隔離／整體）——jinze 下潛肢解 KaTeX 修復（下游問題六）；v1 相容層移除
下游問題六：行內公式緊鄰禁則標點時，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 退役。
|
2026-06-12 17:15:24 +08:00 |
|
|
admin
|
2890549f44
|
fix: 行內排版透明性——pill 前標點誤隙＋行內元素整體掉行＋審計（Bug1／Bug2／T4-T6）
統一「行內元素對排版透明」原則在各遍歷原語之口徑，修復兩個下游 Bug 及三項同根隱患。
Bug1（pill 前標點誤加間隙）：
isTransparentInline 補 JZ-CHAR／JZ-INNER。`漢字。<code>` 經禁則綁定後，
adjacentLogicalChar 之 descend 遇不透明 jz-char 既不進入亦不終止、而跳過它越過
標點取到「字」誤補 jz-hws；透明後回傳標點「。」（非 pill 鄰字）→ 不補隙，與
collectRuns 既有透明遞迴對齊。
Bug2（行內樣式元素整體掉行）：
新增 core/split.ts 之 isolateBoundaryToken／splitElementAt——沿祖先鏈逐層把邊界
詞元剝入淺克隆（保留標籤／class／style／lang、去 id；標 data-jz-kind="splitoff"），
jinze／orphan 改最小綁定：`<strong>長串</strong>，` 只綁末字＋逗號（非整串入 nowrap
inline-block 致行末整體掉行）；段末長 strong 不再整綁溢出容器。revertPass 增延後
階段把 splitoff 併回原元素（先解包 wrap、後併 splitoff），render→revert 還原一致。
純樣式標籤白名單可切，a／abbr／ruby／帶 id 退化整綁。
審計（同根隱患）：
T4 lineedge edgeRect 攀爬集改由 options.finder.styleInlines 派生（棄硬編碼子集，
免遺漏 ins／del／sub 等致行端誤判）。
T5 jiyaAdjacency 遇 pill（pillMatches）斷相鄰、不穿越（內容對排版不可見）。
T6 spacing processPills 補 per-node 功能閘（data-juzhen-off=spacing 區域內不補隙）。
文檔：README 切片表（spacing／jinze／orphan 三行）＋ARCHITECTURE §4.1 透明性原則、
§4.4 splitoff 還原、§6.4 行內元素最小綁定、§5 jz-orphan 詞彙。
測試 90→102（Bug1×4、Bug2×6、T5／T6×2）。headless Chrome 實證 Bug2：段末 strong
最小切分、orphan 寬 60px 不溢出版心。
|
2026-06-11 16:06:17 +08:00 |
|