 admin
|
b1a16c4969
|
fix(web): 修復排版邊界與增量生命週期
|
2026-10-02 19:08:02 +08:00 |
|
|
admin
|
993cf576c6
|
feat(rules): 建立共享排版契约并收束 WebKit 与 Unicode 基线
|
2026-09-04 21:44:11 +08:00 |
|
|
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
|
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
|
e3296104a6
|
refactor: 專案整理階段二——透明判定單一真相源＋跨透明邊界避頭尾＋avoid 排除歸一
承階段一之下游審計。核心貫穿問題：「透明穿越」判定實有兩套口徑散落各處，抵觸 finder
檔頭「所有遍歷共用同一判定」之聲明。用戶抉擇：**嚴格白名單**（未知行內標籤＝邊界，
透明須顯式登記 styleInlines）。
透明判定單一真相源（2a）：
・transparentInline 提升為公開 isTransparent，作邏輯文本流之單一透明判定。
・collectRuns 改由 isTransparent 判定——未在 styleInlines 之未知行內標籤（如 <button>／自訂
元素）當隔離式邊界（斷 run、內部自成脈絡）；isolate 與未知行內併為同一分支。
・jiyaAdjacency 同改用 finder.isTransparent；adjacentLogicalChar 沿用（僅隨改名）。
・分層澄清（承 #4 教訓，不強行一統）：邏輯文本流統一為 isTransparent；另兩層各有正當之
不同邊界、刻意不併入——結構切分安全（split canSplit：更窄白名單，<a>／ABBR 不可切）與
物理版面（lineedge：getClientRects 物理相鄰，須跨 isolate 找真實鄰接）。檔頭改分層表述。
跨透明元素邊界避頭尾綁定（2b，修下游審計 #3）：
・避頭類標點若落於透明元素邊緣（「你好<strong>。世界</strong>」之 。位於 strong 首位、與
「好」不同 DOM parent），舊版 forbiddenBreak 僅認直接 jz-char、render 僅處理 jz-char 之直接
父（strong），外層 p 之「好↔strong」綁定從不被評估 → 。漏綁、可誤置行首。
・偵測：edgeCharEl 經 finder.isTransparent 穿越透明元素定位邊緣 jz-char。
・父級處理：render 沿透明元素邊緣上攀納入外層 parent，父集深者先處理。綁定端沿用
isolateBoundaryToken（可切則最小綁定；邊界字為已 charify 之 jz-char 無法越過時退化整綁，
安全、與 <a> 同型）。
avoid 排除機制歸一（2c）：
・isAvoided 改單一組合入口（自身即邊界 或 祖先鏈任一邊界），免除「avoidsSelf ‖ isAvoided」
易漏一半之誤用（階段一 #2 即此類）；avoidsSelf 保留供遍歷原語逐元素下探自判（免 O(n²)）。
・processPills／orphan／spacing root 收斂為 isAvoided(x)；doc 補齊七種 avoid 來源與優先序。
一致性小項（2e）：scope.include 型別去多餘 `| null`；PASSES 陣列補註（執行序由 pass.order
分群排序決定）；gapTrim 補 featureEnabledFor("spacing")，與 lineEdge relayout 逐節點閘對稱。
評估後不做（2d）：五處幂等判斷（jiya 祖先／longword 父／spacing 父／orphan 子／jinze 父）檢查
不同位置關係、無單一 isJz 形狀可全覆蓋；真正缺陷（jinze 二次 render 巢狀）已於階段一以 isJz
修復，其餘各自正確，強行歸一徒增風險（承 #4 教訓：正當差異不硬併）。
新增契約／回歸測試（button 嚴格白名單、跨透明邊界避頭）；121 測試全綠、構建乾淨。
|
2026-07-07 21:05:25 +08:00 |
|
|
admin
|
30a11b5d6e
|
refactor: 專案整理階段一——確認缺陷修復（jinze 冪等／pill 自身 avoid）＋死代碼清理
下游審計（4 路並行測繪 ＋ 逐條源碼複驗）之階段一：落地已複驗確認之缺陷與低風險
清理；架構統一（透明判定單一真相源）與文檔重整留待階段二／三。
修復（複驗確認）：
・jinze 二次 render（未 revert）產生巢狀 jz-jinze、違反 I6 冪等——守衛改判 parent
自身即本 pass 產物（isJz(parent, PASS)），已綁定內容不再重包（實測 jz-jinze 3→6 已修）。
・processPills 漏檢 avoidsSelf——自身命中 avoid（如 <code data-jz-skip>）之 pill 仍被補
間隙（isAvoided 只查祖先、不含自身，同「下游問題六」型）。processPills ＋ root 自處理
分支補 avoidsSelf 檢查。
・三分類互斥：CODE／KBD 自 DEFAULT_SKIP_TAGS 移除——二者已由預設 pillSelector
"code, kbd" 以 pill 機制涵蓋（內部不可見＋兩端補隙＋斷 run／相鄰），再列 skipTags 致
同元素既 pill 又 avoid、pill 兩端間隙被 avoid 抹掉（違反互斥，且令上一項修復誤傷普通
code）。移除後普通 code 為純 pill、正常補隙；唯自身 data-jz-skip 者不補（即上項修復）。
清理：
・刪零引用死代碼 createMarker／ANY_CJK／BD_ALL／BD_CLASS_NAMES／CreateOptions.attrs；
isJz 由 jinze 冪等守衛啟用、脫離死代碼。
・死旗標 biaodian／emphasis／ruby 補 @reserved 註記（比照 hanging；點明與
charClass.biaodian 撞名異義，避免混淆）。
・JzKind 補註 data-jz-kind 第三值 "splitoff"（split.ts 直接設、不經 createJz）；
longWord／orphan 冗餘 ===false 特判簡化（feature() 已對 false 回 false）。
複驗後重新定性（不照單全收）：
・jinze 跨透明元素邊界避頭尾漏綁（你好<strong>。世界</strong> 之句末點號漏綁）——**真
缺陷**，但正解須改 jinze 之父級處理模型（穿越透明包裹上攀評估跨層綁定），與階段二
「透明判定單一真相源」一併處理更穩；forbiddenBreak 下探草稿已還原、缺口以註解標記。
・lineedge edgeRect 攀穿 isolate——**非缺陷**：edgeRect 為物理版面測量（getClientRects），
isolate 斷的是邏輯 run／相鄰，其內部字元之物理行首／行尾判定須跨 <mark> 找真實相鄰
內容（否則「文字<mark>「引」</mark>」之 「 誤判行首而錯收左半）。初評誤判、已還原並補註。
新增 3 回歸測試（jinze 冪等、預設 code 為 pill 非 skipTags、自身 avoid 之 pill 不補隙）；
119 測試全綠、tsc ＋ esbuild 構建乾淨。
|
2026-07-07 20:28:11 +08:00 |
|
|
admin
|
a3c94ddee5
|
refactor: 移除標點懸掛（機制級死路）——負 margin 程式碼／CSS／型別一併刪
標點懸掛經實測為**機制級死路**（純 CSS 之寬度守恆矛盾）：行端標點盒保持非零寬則墨色
出去多少版心內就空多少（行末實義字無法齊邊）；收為零寬則釋放一整字寬、斷行器把下一字
拉上本行與標點重疊（且 justifyAtoms 預設之 inline-block 下負 margin 被 justify 吸收）。
CSS hack 接觸不到斷行器，此恒等式無解。唯一正解為原生 hanging-punctuation（僅 Safari
支援、且 jz-char 為 inline-block 原子非文本，原生懸掛不作用），屬遠期「原生管線」新功能、
與此處無共享，故不保留休眠碼。
移除：
lineedge.ts — jz-hang-* class、HANG_* 常量、applyEdge hang 分支、modeForChar、
HANG_ENABLED 總開關；行端僅餘 squeeze（半形）。
_jiya.css — jz-hang-* 三條規則（margin 半形 fallback 完整保留）。
types.ts — LineEndMode 型別、ResolvedOptions.lineEnd、features.hanging。
index.ts — lineEnd 鎖。
hanging 公開選項保留為 @deprecated no-op（API 相容）。
文檔：README「標點懸掛」節、ARCHITECTURE §6.5（開頭／§6.5.2／§6.5.4／§6.5.5／§6.5.6）、
demo（showcase §三／resize-check）全部由「停用／休眠」改為「已移除」＋寬度守恆論證。
測試：防逃逸測試改寫為「hanging 為 no-op、輸出與不傳一致、各路徑不產生 jz-hang-*」。
全綠 101。dist 已無 jz-hang／lineEnd／HANG 殘留。
|
2026-06-11 16:16:01 +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 |
|
|
admin
|
04f2b25e4c
|
feat: lineedge 行端模式（squeeze）；標點懸掛實作後全面停用（§6.5.2）
行端 lineedge 升級為可配模式（squeeze｜hang｜none），抽出共用行端標點偵測；
squeeze（現有行端半形）保留並修正「行歸屬判定」bug：jz-char 為 inline-block，其行盒
top 與相鄰純文本字形 top 因基線差約 5px、遠小於行高卻超舊容差（EPS=4px），致同行誤判
為下一行；改判「垂直區間」（下一行＝b.top≥a.bottom、上一行＝b.bottom≤a.top，容 2px）。
標點懸掛 hang 模式經 headless ＋ 真實瀏覽器實測**確認不可行、全面停用**（純負 margin）：
1. 句號墨色偏框左下，安全凸出量（<1em）只推出空白半框、墨色仍在版心內（視覺不懸掛）；
2. 凸出滿 1em 釋放一整字寬、把下一字拉上本行致重疊；
3. 與 inline-block 對齊原子互斥（justifyAtoms:true 下 margin 被 justify 吸收）；
4. ResizeObserver 重排時兩階段標記錯亂。
真正的解為原生 hanging-punctuation，惟 Chrome 不支援、且與本庫原子結構衝突。
**三重防逃逸**（下游以任何方式皆無法啟用）：① index 鎖 lineEnd:"squeeze"（忽略 hanging
選項）；② lineedge.modeForChar 無條件降 squeeze；③ applyEdge 之 HANG_ENABLED=false 總開關。
hang 之 lineedge 程式碼、CSS（jz-hang-*）、LineEndMode 型別保留休眠，俟原生支援再議。
hanging 選項仍被接受（API 相容）但無效果。
單元測試 90 通過，含防逃逸覆蓋（hanging:true／data-juzhen／blocks 各路徑皆不產生 jz-hang-*）。
|
2026-06-09 23:25:47 +08:00 |
|
|
admin
|
c1fbabf5b0
|
feat: 功能分級（文本級 vs 段落級）＋ data-jz-level 標記（§6.5.0a）
整體計劃 §6.5 之前置基礎設施。把已實作功能切為兩級：
- 文本級（spacing 中西間隙、jiya 標點擠壓／鄰接）：任意文本片段皆適用。
- 段落級（jinze 禁則、longWord 斷詞、lineEdge 行端、gapTrim）：需行／段布局。
標記 API：
- 預設塊級元素 → 段落級（全功能）。
- 元素屬性 data-jz-level="text"｜"paragraph"（最近祖先勝）。
- 選項 level:{ text: "選擇器" }（如標題／按鈕一鍵降為文本級）。
實作：
- 每個 pass 加 level 元數據；Finder.levelFor／levelAllows（含快取）。
- charify 段落級 pass（longWord）於共享走訪受閘；standalone 段落級 pass
（jinze／lineEdge／gapTrim）逐元素受閘。文本級不受限。
- spacing 補單元素 root 支援：root 為行內／單一非塊元素時亦處理（標題等
之中西間隙、標點半形生效）。
6 項新單元測試（text-level 跳段落級、選擇器標記、巢狀最近勝、單元素 spacing、
預設段落級回歸）。共 76 測試全綠。
|
2026-06-09 16:52:00 +08:00 |
|
|
admin
|
79fee8481f
|
fix: 中西間隙下游回饋批次（B 省略號／C+E gapTrim 自我應驗／D 西文集／標點稽核）
實 Chromium 定位並修復下游回饋（Peek.nvim，commit 96f5ac3 基線）之全部間隙問題，
另完成現代漢語標點之誤隙稽核。jsdom 不可信（TreeWalker／offset 失真），結論均以
真實 Chromium 量測。
B 全角省略號誤隙：DOTS_CJK 之 alternation `|…` 誤把全角省略號 U+2026 納入，致
`……` 後接 CJK 冒出中西隙。移除 `|…`，僅留 ASCII `...`。
C+E gapTrim 自我應驗誤判（容器寬相關「最後一個間隙消失」、pill 跨行右隙消失）：
間隙之 margin-right 參與斷行；依「後字是否在更低行」判行末，而後字落點又被
margin 推擠 → 間隙自身 margin 把後字擠到次行 → 判行末 → trim 去 margin → 後字
回同行，自相矛盾、卡死於「已 trim、後字同行、間隙消失」。污染雙向：下游間隙之
margin 亦令夾在中間之內容放不下其行。修法：trimGaps 改「起始全部 trim、由左至右
逐一定案」——量測時前方已定案、自身與其後皆 trim，後字落點不受任何 margin 污染。
以 lastRect 為準兼顧跨行 pill。實測 8–22em（ragged／justify）偽 trim 歸零、真行末
仍 trim（justify 齊右不變）。
D 西文字集完整化（列舉法，2016／Windows 10 相容、\uXXXX 無需 flag）：補入貨幣
U+20A0–20BF（€ 等）、拉丁擴充 A/B（拼音聲調 ā ǎ ē）、西里爾、數學運算符
U+2200–22FF；並把希臘由原 U+0370–037D 補全至整塊（原漏 α-ω 本身）。€ 鄰接 CJK
之手工空格遂正規化、邊界補隙。
標點稽核：實 Chromium 全部常用中文標點 × 簡繁共 104 例，CJK 間皆 0 誤隙。修正
唯一偏例——收尾彎引號 `”`（pangu QUOTE_AN 令其後接拉丁／數字補隙，為唯一會補隙
之收尾標點，與 」』）》】〕 不一致；clreq 下全角收尾標點字身已含右側留白）。移除
QUOTE_AN。
- src/core/unicode.ts：WEST_SHARED 列舉補全（\uXXXX、區塊註記）。
- src/typeset/spacing.ts：DOTS_CJK 去 `|…`；移除 QUOTE_AN。
- src/typeset/lineedge.ts：trimGaps 起始全 trim、左→右逐一定案；新增 lastRect。
- test/juzhen.test.mjs：B／D／標點稽核／彎引號 回歸（56 測試通過）。
- demo/resize-check.html：可拖曳容器檢查頁（各寬度間隙穩定性、標點無誤隙）。
- README.md 目視驗證、ARCHITECTURE.md §6.1／§6.1a 自我應驗／§6.1b 標點稽核。
- dist/ 重建（juzhen.css 不變，僅 JS 邏輯）。
|
2026-06-03 00:57:40 +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 |
|