admin/cjk-autospace
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
22 Commits 4 Branches 0 Tags
2890549f4469b9e3bd8e48c73104c386721c18f3
Commit Graph

9 Commits

Author SHA1 Message Date
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 754b00da42 feat: 垂懸字避免（方案 C，斷行層無測量，order 70）（§6.5.1） 
段末行 CJK 實義字數 ≥ N（預設 2；標點／符號不計）。standalone 段落級 pass：
自段末向前數 N 個實義字，把「第 N 字起至段末」（含其間／尾隨標點）包入
<jz-orphan>（white-space:nowrap）。該整體不可斷 → 末行恒含之 ⇒ 末行實義字 ≥ N，
任意寬度／字型／瀏覽器成立，無需量測 layout。

要點：
- 邊界字定位跨 jz-jinze／行內元素攀爬：實義字落於行內元素內時綁定整個塊級
  直接子（不切割 nowrap 群、revert 乾淨）；僅裸文本直接子才精確切分（最小綁定）。
- 僅處理葉段落（無塊級後代）；段落實義字 < N 不綁；單行段方案 C 本就無害。
- 選項 orphan?: boolean | { chars? }；**預設開 chars=2**（§6.5.6 建議）；
  下游可 orphan:false 關閉。段落級，data-jz-level=text 子樹自動跳過。
- order=70：jinze(40)／spacing(50)／longWord(60) 後、layout pass(90/92) 前。

新增 _orphan.css（jz-orphan{white-space:nowrap}）；JzTag 加 jz-orphan。
9 項單元測試（末 N＋尾標點、chars 選項、標點不計、實義字<N 不綁、跨 jinze、
關閉、冪等、revert、段落級閘）。共 85 測試全綠。

窄容器拖動「末行恒 ≥N」之 layout 驗證留待 demo（Step 4-5，瀏覽器）。
 2026-06-09 17:00:04 +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 fdf071c5bb feat: 全角句點 ． 納入句末挤压 ＋ 連續標點挤压規則（雙側獨立＋透明穿越） 
本會話標點挤压一致性兩項（改內置默認；皆以 Noto CJK + 真實 Chromium 量測驗證）。

一、全角句點 ．（U+FF0E）納入句末標點
- BD_STOP 由 。！？ 擴為 。．！？——納入全角句點 ．（異於表意句號 。U+3002）。實測
  Noto CJK SC／TC 之 halt（GPOS SinglePos）皆覆蓋 ．、挤压收半形 advance 0.5em，與 。
  一致。inkBias 同步補 ．（簡 left／繁 center），margin 後備亦可挤。
- 政策行為與 。！？ 同：全角式與開明式句末保持全角 1em，banjiao（或鄰接被收）挤半。
- 設計原則：halt 即字型之「挤压意願」——字型不提供某標點 halt（字形占滿、不宜挤，如某些
  字型之全角 ？、〈〉）則信任字型、保持全角不強挤；margin 後備僅用於整體無 halt 之字型。

二、連續標點挤压規則：雙側獨立 ＋ 透明穿越（修正既有不一致）
- 規則（用戶確定）：相鄰兩標點，**對每一標點**獨立判斷——若其「有空白之側」緊鄰另一標點，
  即挤掉該側空白（收半形）。原 jiyaAdjacencyPass 為「二選一只收一側」，致：
  · ，「（pause 右空白 ＋ open 左空白）原只收 ，→ 全角式 1.5em；應雙側皆收 → 1em。
  改 else-if 為雙獨立 if。修後：，「 全角式與開明式皆 1em；。」 全角式 1.5em／開明式 1em
  （」左為墨不收）；·— 兩式皆 2em（不宜挤之例外）。
- 透明穿越：原以「同 parent 直接兄弟」掃描，漏掉跨 strong/em 等行內邊界之連續標點（致
  跨邊界標點對未挤、達 2em）。改為從 root 之透明遍歷（穿越樣式行內；block 邊界與 avoid
  子樹斷相鄰；jz-char 為原子不下探），跨 inline 邊界之連續標點亦正確配對。

- src/core/unicode.ts：BD_STOP ＋．；inkBias 表 ＋．。
- src/typeset/jiya.ts：jiyaAdjacencyPass 重寫（雙側收 ＋ root 透明遍歷）。
- test：． 納入＋連續挤压（雙側／句末單側／跨 inline／多標點鏈）回歸，70 測試通過。
- README／ARCHITECTURE：． 與連續挤压規則、halt 挤压意願原則；**涉長度處標明全角式／
  開明式**（。」 全角 1.5em／開明 1em 等）。dist 重建（僅 JS，juzhen.css 不變）。
 2026-06-09 15:19:35 +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 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 7b4a051a1f feat: 標點半形 margin 後備模式＋下游回饋修復 
margin 後備（供缺 OpenType halt 之字型）：
- jiya.halfWidth: "halt"（預設）｜"margin"。margin 以 width:0.5em＋字身依墨色
  偏側溢出定位，於 CSS 盒模型重現 halt 之半形 advance（真 0.5em；相鄰標點各
  0.5em、合佔 1em，無負 margin 之鄰接疊加／單側重疊）。模式由 data-jz-halfwidth
  子樹屬性決定（可逐區塊／逐 lang，含 halt-island 反置）。
- 偏側 inkBias 依字身墨色中心給 left／center／right／full；參考表據方正書宋 GBK
  實測，consumer 可經 jiya.bias 逐 lang 逐字覆寫。
- _lang.css 字型堆疊僅作後備（全包 :where 零特異度、只命中帶 lang 屬性之元素、
  不直接覆寫 jz-inner）→ 消費端 font-family 恆優先，標點隨之以消費端字型渲染。
- 新增 tools/measure-bias.py（量 glyph ink 中心、產偏側建議表）＋ README
  「字型適配工作流」。demo/fallback.html：方正書宋 GBK 對照 halt 失效 vs margin。

下游回饋修復：
- 1a：adjacentLogicalChar 透明穿越 jz-jinze（同 jz-hws／樣式行內）→ pill 緊鄰
  CJK 標點時，左緣間隙與作者空格剝除復原（jinze 先於 spacing 之交互）。
- 1b：CJK↔CJK 贅餘作者空格（含跨 inline 標籤）剝除、不留隙，與 CJK↔Latin 之
  邊界正規化一致（DEL 哨符，全形空格 U+3000 不動）。
- 問題二：新增 justifyAtoms 選項；false → jz-char／jz-jinze 改 display:inline，
  相容分頁器（Paged.js）對齊引擎（halt 半形與禁則 nowrap 保留）。

測試 43→49 全通過；dist 重建；README／ARCHITECTURE 同步更新契約。
 2026-06-02 01:21:52 +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