4 Commits

Author	SHA1	Message	Date
admin	c5a503580c	perf+feat: 掃描/佈局提速（中間/S4＋S1）＋增量恢復（Tier3 C1/C3/C2） ... 承 Tier1（S2+S3，已於 main 168e9e7）。本批為效能第二層＋第三層，全程獨立複驗（差分/往返/ 增量≡全量/進程隔離測速/真瀏覽器）＋4 份真人撰寫真實文檔驗收，行為保真、提速真實。 掃描層（無狀態、保行為）： - 中間發現＋S4：insidePill／isAvoided 之「逐文本節點沿祖先鏈」以 ancestorOrSelfPill／…Avoided 迭代回填記憶化（每元素恰算一次、兄弟共用祖先鏈快取），O(文本×depth)→O(元素)。實測掃描層 el.matches() 累計約降五成；深嵌套 render 進程隔離墻鐘 pre-Tier1 707ms→254ms（2.8×）。 佈局層（僅瀏覽器、正確性敏感）： - S1 gapTrim 對齊門：尾隨 margin 僅在右緣 flush 之對齊可見，唯 left／start(ltr) 之 ragged 右緣 可整批跳過，省其 O(gaps) 次同步重排。實測非兩端對齊內容 gapTrim 數千 ms→數十 ms；justify／ center／right／RTL 保留完整逐一定案、行為不變（真瀏覽器差分：justify trim 集指紋逐位相同）。 增量恢復（第三層，向下兼容 API）： - C1 持久化 Finder：跨 render 復用元素鍵快取（category／level／feature／祖先游走）。正確性靠 失效：新增 finder.invalidate(el) 清整棵子樹快取（祖先屬性變則後代快取變脏），revert 自動失效 其子樹（安全預設）。 - C3 rerender(root)＝revert+render；局部恢復（實測編輯 400 段中一段 766×、matches 1441×）。 - C2 observe/disconnect：MutationObserver 自動增量——內容/分類屬性變化重處理最近塊、新增之塊 直接 render；render/revert 期間暫停觀察，自身注入絕不自觸發。 - append 修復（IV-3 差分複驗發現、單測漏掉）：向葉塊（帶 jz-orphan）追加子塊使其轉非葉，須撤 容器陳舊 orphan——追加塊時若塊級父有 jz-orphan 直接子則改重處理該父。 測試 130→140（+S2 非葉塊、C1/C3、C2 觀察/失效/append、不自觸發）。基準設施：bench-incremental （增量恢復）、bench-layout（版面層，headless Chrome）。dist 重建。	2026-07-12 02:20:20 +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	b821cd1134	feat: 字符分類規則集抽象（charClass，可配置；向下兼容） ... 把散落於各 pass 之硬編碼字符分類（中文 CJK／西文 ANS／全寬標點 BD_* 子類）統一抽象為 規則集 Ruleset：內置默認即現狀值，消費端經 options.charClass 擴充，以覆寫 spacing／ jiya／jinze 對特定字符之分類判定。 動機：英文全角句號 ．（U+FF0E，異於中文句號 。U+3002）實證為**完全未分類**——不被 charify、不挤壓、與 CJK 間不補隙。與其每次硬編碼補字符（如先前 € 之西文集），不如給 消費端可配置之分類鉤子。 API（追加語義）： charClass?: { cjk?: string; // 追加為中文 western?: string; // 追加為西文（半寬標點亦歸此） biaodian?: { stop?, pause?, open?, close?, middle?, liga? }; // 追加為全寬標點，按子類 } 實作： - core/unicode.ts：新增 Ruleset／CharClassOverride／BdSubclass 型別、DEFAULT_RULESET、 resolveRuleset（追加合併）；classifyBiaodian(ch, biaodian) 改吃規則集（預設參數向下兼容）。 - types.ts：JuzhenOptions.charClass；ResolvedOptions.ruleset；index 再匯出公開型別。 - index.ts：resolveRuleset(opts.charClass) → ResolvedOptions.ruleset。 - typeset/spacing.ts：所有 CJK／ANS 依賴正則移入 makeRules(ruleset)，per-instance 編譯 （非每 block）；ALNUM／ALPHA／運算符等結構性 ASCII 仍為固定常數。 - typeset/jiya.ts：classifyBiaodian(ch, ruleset.biaodian)。 - typeset/jinze.ts：詞元邊界之 anyCjk 由 ruleset.cjk 建。 向下兼容：不傳 charClass 則 ruleset === DEFAULT_RULESET、行為與重構前完全一致。 v1 為追加語義，不支援重分類／移除內置字符（範圍式集合難挖洞、需求罕見，列後續）。 驗證：實 Chromium end-to-end——charClass.biaodian.stop="．" → ． charify 為 bd-stop （开明式句末維持全角，比照 。）；western="★"／cjk="〇" → 與對側正確補／不補中西間隙。 測試 66 通過（含 9 條 charClass 新測——默認未分類／各子類 charify／實例隔離不可變 （resolveRuleset 不污染 DEFAULT）／追加不破壞內置／多子類組合；57 既有不變）。 - README「自定義字符分類」節＋ARCHITECTURE §4.2 規則集抽象。dist 重建。	2026-06-04 16:22:14 +08:00
admin	2d42c7ecf2	feat: 聚珍切片 1 — 中西間隙／標點擠壓／禁則 + v1 相容層 ... 從零重寫之第一垂直切片（依 ARCHITECTURE.md 契約），涵蓋並超越 v1 全部功能。 核心基座（src/core）：unicode 字元表＋標點子類＋字形側位；locale 語言與 全角／開明政策（全域 lang.style ＋逐 lang policy）；dom（jz-* 工廠＋可還原 標記）；finder 遍歷引擎（avoid／scope.include／邏輯 run／pill 鄰字／分塊閘）； pass 聚合管線。 功能 pass（src/typeset）： - spacing：中西間隙採 margin 模型——包裹邊界左側字、以 margin-right 留隙， 不注入空白字元（textContent 完全不變、複製緊湊、justify 不暴增、不撐框、 行首乾淨）。含跨樣式邊界、pill、原檔空格移除。 - gapTrim（lineedge）：layout pass，行末去隙，修正 justify 右緣內縮。 - longword：長英文詞 <span lang> + hyphens。 - jiya：標點 charify + 全角／開明／半角（全域 + 逐 lang）；半形以字型 OpenType halt 渲染（按字形正確定位、不重疊，居中字形 ！？ 與繁體 locl 句逗點號皆正確）； 行內連續擠壓。 - jinze：行首行末避頭尾（閉類／點號綁前字、開類綁後字，以詞元為邊界、長引文 中段可斷）；亦為 justify 綁定載體。 - lineedge：行端擠壓 layout pass（括號引號；ResizeObserver 重算，瀏覽器專用）。 §8 justify：jz-char inline-block 原子，句末標點單份間距。 v1 相容層（compat/v1）：createCjkAutospace().apply 映射，IIFE 全域別名。 構建：esbuild → ESM／IIFE／CSS；tsc → d.ts。測試：39 個 jsdom 案例。 demo：簡繁並列＋justify＋強制繁體開明＋標點寬度量測，載 Noto webfont 作參考 （擠壓依賴字型 halt）。間隔號 · 不觸發中西間隙；200% 等詞元不被禁則切斷。	2026-06-01 21:31:07 +08:00