變更紀錄（Changelog）

聚珍（Juzhen）／cjk-autospace 變更紀錄。← 回文檔

標點擠壓句界例外（句末點號接開類保留右空白） 2026-06-13

行內連續擠壓（機制 A）新增句界例外：句末點號（。．！？）後接開類引號／括號（。「／？「）時保留句末點號右側空白、僅收開類左側，全角式與開明式皆合占 1.5em（對稱於 。」）——下游回饋之語感修正。單元測試 113→116 全綠。

變更

• 句界例外：原機制 A 對相鄰標點對 (L, R) 兩側獨立收——L 有右側空白即收、不看 R 為何類，致句末點號接開類兩側皆收、合占 1em，丟失句界視覺（句末點號收尾後緊接開類起新引文，本應保留句界間距）。修為：L 為句末點號（bd-stop）且 R 為開類（bd-open）時不收 L、僅收 R 左側 → 1.5em。
• 例外僅限句末點號＋開類：句內點號 ，「（屬同句）與雙括號 」「／》《（貼合相連）不屬句界，仍兩側皆收 1em；。」（句末接閉類，閉類左為墨無左空白）本就只收句末點號、合占 1.5em，未變。
• 半角式不回歸：半角式句末點號由 baseline（機制 C）已收半形，句界守衛僅跳過 adjacency 之重複追加、不移除 baseline 之 jz-half；32 個可壓縮標點於半角式仍全半形（實測 0 回歸）。非可壓縮 ·・‧／…— 各式皆全寬，屬設計。

範圍

• 唯一改動點 jiyaAdjacencyPass.squeeze()（src/typeset/jiya.ts）加 stopBeforeOpen 守衛；行端擠壓 lineedge、baseline 政策、jinze／orphan／spacing 皆不波及（純視覺寬度、無結構變更）。

行內元素三分類（KaTeX 肢解修復）＋ v1 相容層移除 2026-06-12

下游問題六（KaTeX 公式被禁則綁定肢解）修復：確立行內元素三分類口徑（透明／隔離／整體），所有遍歷原語共用同一判定。v1 相容層隨最後一批消費端遷移完成而移除。單元測試 101→112 全綠。

修復（下游問題六）

• Bug：jinze 透明下潛肢解 pill。行內公式緊鄰禁則標點（…$x$，）時，jinze 為綁鄰字下潛 .katex——KaTeX 全樹皆 <span>，舊版僅憑標籤名判透明，把公式內側末字連同完整殼層逐層克隆切出（splitoff），上標漂移錯位；pillSelector／skipAttribute／scope.avoid 三層防護全被刺穿。復現另揭兩向量：相鄰兩 pill 時 descend 刺穿致 jz-hws 插入公式內部；pill 內部標點被 jiya charify。
• 根因一：判透明以標籤名而非元素。transparentInline(el) 改以元素判定——先排除 pill／isolate／avoid 再查標籤集；core/split 之 canSplit 諮詢 finder（pill／isolate／avoid 一律不可切 → 退化整元素綁定——pill 即「作為原子鄰字單位整體綁入 jz-jinze」之期望行為）。
• 根因二：avoid 僅查祖先。新增 avoidsSelf(el) 自身判定——元素自身命中 scope.avoid／skipAttribute／data-jz-skip 時即為邊界（舊版被當透明穿越，防護形同虛設）。
• 根因三：descend 越界跳找。adjacentLogicalChar 之 descend 改三態（邊界字／無內容續找兄弟／blocked 終止）——遇 pill／isolate／avoid 不可跳過續找更遠之字。
• pill 內部全面不可見：eachTextNode 過濾 insidePill——pill 內部不 charify、不插間隙、不做長詞包裝（舊版消費端自加之 pill 如 .katex 內部曾被直接變更）。

新增：行內元素三分類（§4.1）

• 透明（styleInlines ＋ jz-*）：穿越、run 延續、禁則可克隆切分——strong／em 等純樣式。
• 隔離（isolateSelector，新增選項，預設 "mark"，"" 停用）：邊界斷 run／斷相鄰／不可切分、兩端補隙（同 pill），內部照常處理（自成脈絡）——帶背景色之 <mark> 等盒樣式行內（切分背景盒有可見接縫，MARK 並自可切白名單移除）。
• 整體（pillSelector）：內部對一切 pass 不可見，禁則時整體綁入——code／kbd、行內公式 .katex、引用標 .cite-ref 等宜納入。
• spacing Pass B 邊界選擇器擴為 pill ∪ isolate；jiyaAdjacency 對 isolate 斷相鄰而內部自成脈絡；orphan 補 avoid 塊不綁（舊漏判）。

移除：v1 相容層

• 最後一批 v1 消費端遷移 v2 API 完成，src/compat/v1.ts（createCjkAutospace）、IIFE 全域別名、死選項 autospaceClass（經查從未被任何 pass 讀取）一併移除；不變量 I8 退役。v1 原始碼保存於 v1-autospace 分支。

行內排版透明性修復 ＋ 標點懸掛移除 2026-06-11

修復兩個下游 Bug（同源於「行內元素對排版透明」原則在各遍歷原語口徑不一）＋三項同根隱患審計；並把上一輪「停用」之標點懸掛正式移除（負 margin 程式碼／CSS／型別一併刪）。單元測試 90→101 全綠。

修復

• Bug：pill 前標點誤加間隙（如 漢字。<code>）。根因：finder.adjacentLogicalChar 之 descend 遇不透明之 jz-char 既不進入亦不終止、而跳過它越過標點取到更前之漢字，誤補 jz-hws。修復＝isTransparentInline 補 JZ-CHAR／JZ-INNER，descend 遂回傳標點（非 pill 鄰字、不補隙），與 collectRuns 之既有透明遞迴一致。
• Bug：行內樣式元素整體掉行（<strong>很長一串</strong>， 把整串粗體塞進 nowrap inline-block，行末放不下即整體掉行、上行留巨大空隙）。新增 core/split.ts 之克隆切分：沿祖先鏈把邊界詞元剝入淺克隆（保留標籤／class／style／lang、去 id；標 data-jz-kind="splitoff"），禁則／垂懸字只綁該克隆（最小綁定），原元素餘部留原位、渲染無縫。revertPass 增延後階段把 splitoff 併回原元素（先解包 wrap、後併 splitoff），render→revert 還原一致。純樣式標籤白名單可切，a／abbr／ruby／帶 id 退化整綁。
• 審計（同根隱患）：T4 lineedge 之行端攀爬集改由 options.finder.styleInlines 派生（棄硬編碼子集，免遺漏 ins／del／sub 等致行端誤判）；T5 jiyaAdjacency 遇 pill 斷相鄰、不穿越；T6 spacing processPills 補 per-node 功能閘（data-juzhen-off="spacing" 區域內不補隙）。

標點懸掛：實作後停用 → 正式移除

純 CSS 手段（負 margin／相對位移／零寬盒）經實測為機制級死路，已移除（負 margin 之 lineedge 程式碼／jz-hang-* CSS／LineEndMode／lineEnd／features.hanging 一併刪）。行端僅餘半形擠壓（jz-half-le）。

• 寬度守恆論證：行端標點盒若保持非零寬，則墨色出去多少、版心內就空出多少（行末實義字無法齊版心右緣）；若收為零寬，則釋放一整字寬、斷行器把下一字拉上本行與標點重疊（且 justifyAtoms 預設之 inline-block 下負 margin 被 justify 吸收）。CSS hack 接觸不到斷行器，此恒等式無解。
• 唯一正解＝原生 hanging-punctuation，惟 Chrome／Firefox 至今不支援（僅 Safari），且 jz-char 為 inline-block 原子非文本、原生懸掛不作用之。未來若做須是繞開 jz-char 的「原生管線」新功能（text-spacing-trim ＋ hanging-punctuation，按能力門控），與已移除碼無共享，故不保留休眠碼。
• hanging 公開選項保留為 @deprecated no-op（API 相容；測試覆蓋 option／data-juzhen／blocks 各路徑皆不產生 jz-hang-* 且輸出與不傳一致）。詳見 ARCHITECTURE §6.5.6。

功能分級 ＋ 垂懸字（標點懸掛停用） 2026-06-09

ARCHITECTURE §6.5：功能分級、垂懸字（方案 C）落地工作良好；原計劃之標點懸掛經實測確認不可行、全面停用。共 90 單元測試全綠（含懸掛防逃逸覆蓋）。

新增

• 功能分級（文本級 vs 段落級）：把已實作功能切為兩級——文本級（中西間隙 spacing、標點擠壓 jiya，任意文本片段適用）與段落級（禁則 jinze、垂懸字 orphan、長詞 longWord，需行／段布局）。塊級元素預設全功能；data-jz-level="text" 子樹（最近祖先勝）或選項 level:{text:"選擇器"} 標記之元素（標題／按鈕／UI）僅跑文本級。實作為 Finder.levelFor／levelAllows ＋ 各 pass level 元數據；段落級 pass（含 charify 之 longWord）逐元素受閘。spacing 補單元素 root 支援（行內／非塊 root 亦處理）。
• 垂懸字避免 orphan（方案 C，斷行層無測量，order 70）：段末行 CJK 實義字 ≥ N（預設 2；標點／符號不計）。把段末「第 N 個實義字起至段末」（含尾隨標點）包入 jz-orphan（white-space:nowrap），整體不可斷 → 末行恒含之 ⇒ 末行實義字 ≥ N，任意寬度／字型成立、無需量測。邊界字落於行內元素內時綁定整個塊級直接子（跨 jz-jinze 攀爬、不切割）。預設開 chars=2（orphan:false 關）；段落級，data-jz-level="text" 跳過。
• 行端模式重構 ＋ 行歸屬判定 bug 修正：lineedge 行端處理抽象為可配模式（squeeze／hang／none），現有行端半形＝squeeze、保留並改善。修「行歸屬判定」bug：jz-char 為 inline-block，其行盒 top 與相鄰純文本字形 top 因基線差約 5px、遠小於行高卻超舊容差（EPS=4px），致同行誤判為下一行；改判「垂直區間」（下一行＝b.top ≥ a.bottom、上一行＝b.bottom ≤ a.top，容 2px）。

標點懸掛：實作後全面停用

原計劃之標點懸掛（行端標點凸出版心）經 headless ＋ 真實瀏覽器實測確認純負 margin 機制不可行，已全面停用（hanging 選項仍被接受但無任何效果）。

• 不可行原因：① 句號墨色偏字框左下角，安全凸出量（< 1 個 CJK 字寬 1em）只把空白半框推出版心、墨色仍在內（視覺不懸掛）；② 凸出滿 1em 釋放一整字寬、把下一字拉上本行致重疊；③ 與 inline-block 對齊原子互斥（justifyAtoms:true 下負 margin 被 justify 吸收）；④ ResizeObserver 重排時兩階段標記錯亂。
• 三重防逃逸：① index 鎖 lineEnd:"squeeze"（忽略 hanging 選項）；② modeForChar 無條件降 squeeze；③ applyEdge 之 HANG_ENABLED=false 總開關。縱使下游以 hanging／data-juzhen／blocks 任何方式要求亦不啟用（單元測試覆蓋各路徑皆不產生 jz-hang-*）。
• 未來路徑：原生 CSS hanging-punctuation 為正解，待 Chrome 支援（現僅 Safari）並解決與 inline-block 原子衝突。hang 之程式碼、CSS、型別保留休眠。詳見 ARCHITECTURE §6.5.6。

工具

• demo/showcase.html（新增）：定寬文本框並排對照，逐場景演示功能分級與垂懸字（關閉/開啟孤字、chars=3、標點不計入 N）。
• demo/resize-check.html：增垂懸字（jz-orphan 描框 ＋ 關閉對照）拖曳檢查區。兩頁均不含懸掛（已停用）。

標點挤压一致性 2026-06-04

新增／修復

• 全角句點 ． 納入句末標點：BD_STOP 由 。！？ 擴為 。．！？——納入全角句點 ．（U+FF0E，異於表意句號 。 U+3002）。實測 Noto CJK SC／TC 之 halt 皆覆蓋、挤压收半形 advance 0.5em，與 。 一致；inkBias 同步補（簡 left／繁 center）。政策行為同 。！？：全角式與開明式句末保持全角 1em，banjiao（或鄰接被收）挤半。設計原則：halt 即字型之「挤压意願」，字型不提供某標點 halt（字形占滿、不宜挤）則信任字型、保持全角不強挤。
• 連續標點挤压規則：雙側獨立 ＋ 透明穿越（修正既有不一致）。規則：相鄰兩標點，對每一標點獨立判斷——若其「有空白之側」緊鄰另一標點即收半。原為「二選一只收一側」，致 ，「 全角式誤為 1.5em；修後 ，「 全角式與開明式皆 1em、。」 全角式 1.5em／開明式 1em、·— 兩式皆 2em（不宜挤）。並改「同 parent 直接兄弟」掃描為從 root 之透明遍歷（穿越 strong／em 等行內邊界、block／avoid 斷相鄰），使跨 inline 邊界之連續標點亦正確配對（原漏致達 2em）。

字符分類規則集 2026-06-04

新增

• 可配置字符分類（charClass）：把散落各 pass 之硬編碼分類（中文 CJK／西文 ANS／全寬標點 BD_* 子類）統一抽象為規則集，內置默認即現狀值，消費端經 options.charClass（{ cjk?, western?, biaodian?:{stop,pause,open,close,middle,liga} }）追加擴充，覆寫 spacing／jiya／jinze 之分類判定。動機：未分類符號（如二點省略 ‥ U+2025）——不 charify／不挤；以 charClass:{biaodian:{stop:"‥"}} 即可歸入對應類。向下兼容：不傳則行為與內置完全一致、各實例隔離（覆寫不污染默認）。v1 為追加語義（不重分類／移除內置）；結構性 ASCII 不開放。spacing 之間隙正則改由規則集 per-instance 編譯。測試 66 通過（含 9 條 charClass）。

下游回饋修復批次 2026-06-03

聚焦 Peek.nvim 等下游回饋之原子透明與中西間隙正確性，皆以真實 Chromium 量測驗證（jsdom 之 TreeWalker／offset 失真，不可信）。

修復

• 原子透明（段落繼承屬性漏溢）：jz-* inline-block 原子對消費端段落樣式透明——歸零會被原子重複套用之 text-indent／hanging-punctuation（過套用），並令原子 text-decoration: inherit 以接續段落下劃線（欠套用）。段落首行縮排正常、下劃線連續不斷，消費端無需配置。
• 中西間隙 · gapTrim 自我應驗：行末去隙原依「後字是否在更低行」判定，而後字落點受間隙自身（及下游間隙）之 margin 推擠，致行中間隙被誤 trim——表現為容器寬相關之「最後一個間隙消失」、行內 code pill 跨行時右側間隙消失。改為「起始全部 trim、由左至右逐一定案」，量測不受任何 margin 污染。
• 中西間隙 · 西文字集完整化：補入貨幣符號（€ 等 U+20A0–20BF）、拉丁擴充 A/B（拼音聲調 ā ǎ ē）、西里爾、數學運算符，並把希臘補全至含 α-ω。鄰接 CJK 之手工空格遂正規化、邊界補隙。列舉法以 \uXXXX 表示、無需 regex flag，相容 2016／Windows 10 時代瀏覽器。
• 標點誤隙：全角省略號 …… 後接 CJK 不再誤補隙（DOTS_CJK 移除 |…）；收尾彎引號 ” 後接拉丁／數字不再補隙（移除 pangu QUOTE_AN 偏例，與 」』）》】〕 等所有收尾標點一致）。全部常用中文標點 × 簡繁共 104 例稽核，CJK 間皆 0 誤隙。

變更

• 字型移出聚珍管理：字型屬消費端領域，聚珍不再內建任何 font-family／字型堆疊（移除 _lang.css，dist/juzhen.css 零字型規則）。逐語言字型完全由消費端 CSS 設定（範式見文檔「字型與 locl」）。聚珍僅守三項非管理性本分：jz-* { font: inherit } 使原子繼承消費端字型、不強加；半形 font-feature-settings 顯式併入 "locl" 1（連同 halt）確保泛 CJK 字型之地域標點字形不因設 halt 而失；render 只讀不改 lang。halt／margin 兩模式皆已驗證字型繼承與 locl 正常。

工具

• demo/resize-check.html：可拖曳容器檢查頁——拖動方框寬度，驗證中西間隙在各寬度下恆穩、標點無誤隙；可切 justify 與「顯示間隙」描邊。

v2 切片 1 · 增補 2026-06

切片 1 之上的修補與強化，聚焦標點半形對缺 halt 字型之支援，及下游回饋之邊界／分頁器修復。

新增

• 標點半形 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 實測，可經 jiya.bias 逐 lang 逐字覆寫。
• 字型適配工具與工作流：tools/measure-bias.py（量 glyph ink 中心、產偏側建議表）＋文檔之「字型適配工作流」。demo/fallback.html：方正書宋 GBK 對照 halt 失效 vs margin 生效。
• justifyAtoms 選項：預設 true；設 false 時 jz-char／jz-jinze 改 display:inline，相容分頁器（Paged.js）之對齊引擎（halt 半形與禁則 nowrap 保留）。

修復

• 字型不覆寫消費端：_lang.css 之 Noto 字型堆疊改為純後備——全包 :where() 零特異度、只命中帶 lang 屬性之元素、不直接覆寫標點字面容器 jz-inner。消費端 font-family 恆優先，標點隨之以消費端字型渲染（修正先前標點被強制換成 Noto 之缺陷）。
• pill 緊鄰標點之左緣間隙：adjacentLogicalChar 透明穿越 jz-jinze（同 jz-hws／樣式行內）→ pill 後接 CJK 標點時，左緣 jz-hws 與作者空格剝除復原。
• CJK↔CJK 贅餘作者空格：含跨 inline 標籤者一律剝除、不留隙，與 CJK↔西文之邊界正規化一致（全形空格 U+3000 不動）。

已知限制

• margin 後備半形依賴 inline-block（width:0.5em），與 justifyAtoms:false 不可兼得——分頁器場景請用含 halt 之字型。
• margin 偏側為三檔量化（0／0.25／0.5em）之近似；字形極端者須以 jiya.bias 逐字微調。

v2.0.0 切片 1 · 從零重寫

依 ARCHITECTURE.md 契約，從零重寫為「現代簡／繁中文網頁排版套件」。倉庫名 cjk-autospace 不變；公開 API 為 createJuzhen ／全域 Juzhen；自訂元素前綴 jz-。v1 完整保留於 v1-autospace 分支。

新增

• 核心引擎：finder（遍歷／avoid／scope.include／邏輯 run／pill 鄰字／分塊閘 featureEnabledFor）、unicode（字元表＋標點子類＋字形側位）、locale（語言分類＋全角／開明政策）、dom（jz-* 工廠＋可還原標記）、pass 聚合管線。
• 中西間隙（margin 模型）：包裹邊界左側字、以 margin-right 留隙，不注入空白字元 → textContent 完全不變、複製緊湊、justify 不暴增、不撐框、行首乾淨。gapTrim layout pass 行末去隙以齊右。
• 標點擠壓：全角式／開明式／半角式，三機制（baseline 政策＋行內連續擠壓＋行端擠壓）。半形以字型 OpenType halt 渲染。全域 lang.style ＋逐 lang policy。
• 禁則（避頭尾）：閉類／點號綁前一字、開類綁後一字，以詞元為邊界、長引文中段可斷；兼作 justify 綁定。
• 長英文詞：<span lang> ＋ hyphens 原生斷詞。
• justify 句末單份間距：jz-char inline-block 原子化。
• v1 相容層：createCjkAutospace().apply() 映射；IIFE 全域別名。
• 構建／測試：esbuild（ESM／IIFE／CSS）＋ tsc（d.ts）；jsdom 測試；demo/ 簡繁並列＋justify＋標點寬度量測。

相對 v1 之改進

• 中西間隙複製乾淨（textContent 不變；v1 之 <span> 真實空格會被選取）。
• 擠壓由「halt 套整段＝半角式」進化為依 lang 之全角／開明／半角，且加入行內連續與行端擠壓。
• 新增禁則避頭尾、justify 句末單份間距、跨瀏覽器一致策略與顯式禁用層。

v1（cjk-autospace） · v1-autospace 分支

Pangu.js v7.2.1 風格之 CJK↔Latin 邊界自動間距 shim，工廠 createCjkAutospace(options).apply(root)。

• Pass A：跨樣式邊界中西間隙（marker span 含真實空格 ＋ user-select:none）。
• Pass B：pill（code／kbd）邊界間隙。
• Pass C：長英文詞 <span lang> ＋ hyphens。
• Pass D：開明式標點擠壓（句內點號 font-feature-settings:"halt" 半形）。