聚珍(Juzhen)/cjk-autospace 變更紀錄。← 回文檔
v2 切片 1 · 增補 2026-06
切片 1 之上的修補與強化,聚焦標點半形對缺 halt 字型之支援,及下游回饋之邊界/分頁器修復。
新增
- 標點半形
margin後備模式(缺 OpenTypehalt之字型):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不暴增、不撐框、行首乾淨。gapTrimlayout pass 行末去隙以齊右。 - 標點擠壓:全角式/開明式/半角式,三機制(baseline 政策+行內連續擠壓+行端擠壓)。半形以字型 OpenType
halt渲染。全域lang.style+逐langpolicy。 - 禁則(避頭尾):閉類/點號綁前一字、開類綁後一字,以詞元為邊界、長引文中段可斷;兼作
justify綁定。 - 長英文詞:
<span lang>+hyphens原生斷詞。 - justify 句末單份間距:
jz-charinline-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"半形)。