admin
0f49ba8ecc
changelog 增「變更：字型移出聚珍管理」（不內建 font-family、半形顯式保留 locl、 render 不改 lang；halt／margin 兩模式驗證正常）。使用文檔 CSS 基礎設定「字型」項 改寫為「字型由消費端負責」＋推薦逐 lang 範式。HTML 與 Markdown 孿生同步、manifest 重建。
165 lines
13 KiB
HTML
165 lines
13 KiB
HTML
<!DOCTYPE html>
|
||
<html lang="zh-Hant">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||
<title>變更紀錄（Changelog）</title>
|
||
<meta name="generated-at" content="2026-06-02">
|
||
<meta name="source" content="cjk-autospace · 變更紀錄">
|
||
<!-- RUNTIME_CSS -->
|
||
</head>
|
||
<body>
|
||
|
||
<header class="page">
|
||
<div class="meta">
|
||
<h1>變更紀錄（Changelog）</h1>
|
||
<p class="subtitle">聚珍（Juzhen）／cjk-autospace 之版本變更紀錄。</p>
|
||
<p class="timestamp"><time>2026-06-02</time> · <span>cjk-autospace · 變更紀錄</span></p>
|
||
</div>
|
||
<div class="actions">
|
||
<!-- ACTIONS -->
|
||
</div>
|
||
</header>
|
||
|
||
<main>
|
||
<!-- BODY -->
|
||
<p class="lede">聚珍（Juzhen）／cjk-autospace 變更紀錄。<a href="./index.html">← 回文檔</a></p>
|
||
|
||
<h2>下游回饋修復批次 <span class="badge accent">2026-06-03</span></h2>
|
||
<p>聚焦 Peek.nvim 等下游回饋之原子透明與中西間隙正確性，皆以真實 Chromium 量測驗證（jsdom 之 TreeWalker／offset 失真，不可信）。</p>
|
||
|
||
<h3>修復</h3>
|
||
<ul>
|
||
<li><strong>原子透明（段落繼承屬性漏溢）</strong>：<code>jz-*</code> inline-block 原子對消費端段落樣式透明——歸零會被原子重複套用之 <code>text-indent</code>／<code>hanging-punctuation</code>（過套用），並令原子 <code>text-decoration: inherit</code> 以接續段落下劃線（欠套用）。段落首行縮排正常、下劃線連續不斷，消費端無需配置。</li>
|
||
<li><strong>中西間隙 · <code>gapTrim</code> 自我應驗</strong>：行末去隙原依「後字是否在更低行」判定，而後字落點受間隙自身（及下游間隙）之 <code>margin</code> 推擠，致行中間隙被誤 trim——表現為容器寬相關之「最後一個間隙消失」、行內 <code>code</code> pill 跨行時右側間隙消失。改為「起始全部 trim、由左至右逐一定案」，量測不受任何 <code>margin</code> 污染。</li>
|
||
<li><strong>中西間隙 · 西文字集完整化</strong>：補入貨幣符號（<code>€</code> 等 U+20A0–20BF）、拉丁擴充 A/B（拼音聲調 ā ǎ ē）、西里爾、數學運算符，並把希臘補全至含 α-ω。鄰接 CJK 之手工空格遂正規化、邊界補隙。列舉法以 <code>\uXXXX</code> 表示、無需 regex flag，相容 2016／Windows 10 時代瀏覽器。</li>
|
||
<li><strong>標點誤隙</strong>：全角省略號 …… 後接 CJK 不再誤補隙（<code>DOTS_CJK</code> 移除 <code>|…</code>）；收尾彎引號 ” 後接拉丁／數字不再補隙（移除 pangu <code>QUOTE_AN</code> 偏例，與 」』）》】〕 等所有收尾標點一致）。全部常用中文標點 × 簡繁共 104 例稽核，CJK 間皆 0 誤隙。</li>
|
||
</ul>
|
||
|
||
<h3>變更</h3>
|
||
<ul>
|
||
<li><strong>字型移出聚珍管理</strong>：字型屬消費端領域，聚珍不再內建任何 <code>font-family</code>／字型堆疊（移除 <code>_lang.css</code>，<code>dist/juzhen.css</code> 零字型規則）。逐語言字型完全由消費端 CSS 設定（範式見文檔「字型與 locl」）。聚珍僅守三項非管理性本分：<code>jz-* { font: inherit }</code> 使原子繼承消費端字型、不強加；半形 <code>font-feature-settings</code> 顯式併入 <code>"locl" 1</code>（連同 <code>halt</code>）確保泛 CJK 字型之地域標點字形不因設 halt 而失；render 只讀不改 <code>lang</code>。halt／margin 兩模式皆已驗證字型繼承與 locl 正常。</li>
|
||
</ul>
|
||
|
||
<h3>工具</h3>
|
||
<ul>
|
||
<li><strong><code>demo/resize-check.html</code></strong>：可拖曳容器檢查頁——拖動方框寬度，驗證中西間隙在各寬度下恆穩、標點無誤隙；可切 <code>justify</code> 與「顯示間隙」描邊。</li>
|
||
</ul>
|
||
|
||
<h2>v2 切片 1 · 增補 <span class="badge accent">2026-06</span></h2>
|
||
<p>切片 1 之上的修補與強化，聚焦標點半形對缺 <code>halt</code> 字型之支援，及下游回饋之邊界／分頁器修復。</p>
|
||
|
||
<h3>新增</h3>
|
||
<ul>
|
||
<li><strong>標點半形 <code>margin</code> 後備模式</strong>（缺 OpenType <code>halt</code> 之字型）：<code>jiya.halfWidth: "halt"</code>（預設）｜<code>"margin"</code>。<code>margin</code> 以 <code>width:0.5em</code> ＋字身依墨色偏側溢出定位，於 CSS 盒模型重現 <code>halt</code> 之半形 advance（真 0.5em；相鄰標點各 0.5em、合佔 1em，無負 margin 之鄰接疊加／單側重疊）。模式由 <code>data-jz-halfwidth</code> 子樹屬性決定，可逐區塊／逐 <code>lang</code>（含 halt-island 反置）。</li>
|
||
<li><strong>字形偏側表 <code>inkBias</code></strong>：依字身墨色中心給 <code>left／center／right／full</code>；彎引號／角括號／尖括號偏一側、圓方括號近中。參考表據方正書宋 GBK 實測，可經 <code>jiya.bias</code> 逐 <code>lang</code> 逐字覆寫。</li>
|
||
<li><strong>字型適配工具與工作流</strong>：<code>tools/measure-bias.py</code>（量 glyph ink 中心、產偏側建議表）＋文檔之「字型適配工作流」。<code>demo/fallback.html</code>：方正書宋 GBK 對照 halt 失效 vs margin 生效。</li>
|
||
<li><strong><code>justifyAtoms</code> 選項</strong>：預設 <code>true</code>；設 <code>false</code> 時 <code>jz-char</code>／<code>jz-jinze</code> 改 <code>display:inline</code>，相容分頁器（Paged.js）之對齊引擎（<code>halt</code> 半形與禁則 <code>nowrap</code> 保留）。</li>
|
||
</ul>
|
||
|
||
<h3>修復</h3>
|
||
<ul>
|
||
<li><strong>字型不覆寫消費端</strong>：<code>_lang.css</code> 之 Noto 字型堆疊改為純後備——全包 <code>:where()</code> 零特異度、只命中帶 <code>lang</code> 屬性之元素、不直接覆寫標點字面容器 <code>jz-inner</code>。消費端 <code>font-family</code> 恆優先，標點隨之以消費端字型渲染（修正先前標點被強制換成 Noto 之缺陷）。</li>
|
||
<li><strong>pill 緊鄰標點之左緣間隙</strong>：<code>adjacentLogicalChar</code> 透明穿越 <code>jz-jinze</code>（同 <code>jz-hws</code>／樣式行內）→ pill 後接 CJK 標點時，左緣 <code>jz-hws</code> 與作者空格剝除復原。</li>
|
||
<li><strong>CJK↔CJK 贅餘作者空格</strong>：含跨 inline 標籤者一律剝除、不留隙，與 CJK↔西文之邊界正規化一致（全形空格 U+3000 不動）。</li>
|
||
</ul>
|
||
|
||
<h3>已知限制</h3>
|
||
<ul>
|
||
<li><code>margin</code> 後備半形依賴 <code>inline-block</code>（<code>width:0.5em</code>），與 <code>justifyAtoms:false</code> 不可兼得——分頁器場景請用含 <code>halt</code> 之字型。</li>
|
||
<li><code>margin</code> 偏側為三檔量化（0／0.25／0.5em）之近似；字形極端者須以 <code>jiya.bias</code> 逐字微調。</li>
|
||
</ul>
|
||
|
||
<h2>v2.0.0 <span class="badge accent">切片 1</span> · 從零重寫</h2>
|
||
<p>依 <code>ARCHITECTURE.md</code> 契約，從零重寫為「現代簡／繁中文網頁排版套件」。倉庫名 <code>cjk-autospace</code> 不變；公開 API 為 <code>createJuzhen</code> ／全域 <code>Juzhen</code>；自訂元素前綴 <code>jz-</code>。v1 完整保留於 <code>v1-autospace</code> 分支。</p>
|
||
|
||
<h3>新增</h3>
|
||
<ul>
|
||
<li><strong>核心引擎</strong>：<code>finder</code>（遍歷／avoid／<code>scope.include</code>／邏輯 run／pill 鄰字／分塊閘 <code>featureEnabledFor</code>）、<code>unicode</code>（字元表＋標點子類＋字形側位）、<code>locale</code>（語言分類＋全角／開明政策）、<code>dom</code>（<code>jz-*</code> 工廠＋可還原標記）、<code>pass</code> 聚合管線。</li>
|
||
<li><strong>中西間隙</strong>（margin 模型）：包裹邊界左側字、以 <code>margin-right</code> 留隙，<strong>不注入空白字元</strong> → <code>textContent</code> 完全不變、複製緊湊、<code>justify</code> 不暴增、不撐框、行首乾淨。<code>gapTrim</code> layout pass 行末去隙以齊右。</li>
|
||
<li><strong>標點擠壓</strong>：全角式／開明式／半角式，三機制（baseline 政策＋行內連續擠壓＋行端擠壓）。半形以字型 OpenType <code>halt</code> 渲染。全域 <code>lang.style</code> ＋逐 <code>lang</code> <code>policy</code>。</li>
|
||
<li><strong>禁則（避頭尾）</strong>：閉類／點號綁前一字、開類綁後一字，以詞元為邊界、長引文中段可斷；兼作 <code>justify</code> 綁定。</li>
|
||
<li><strong>長英文詞</strong>：<code><span lang></code> ＋ <code>hyphens</code> 原生斷詞。</li>
|
||
<li><strong>justify 句末單份間距</strong>：<code>jz-char</code> inline-block 原子化。</li>
|
||
<li><strong>v1 相容層</strong>：<code>createCjkAutospace().apply()</code> 映射；IIFE 全域別名。</li>
|
||
<li><strong>構建／測試</strong>：esbuild（ESM／IIFE／CSS）＋ tsc（d.ts）；jsdom 測試；<code>demo/</code> 簡繁並列＋justify＋標點寬度量測。</li>
|
||
</ul>
|
||
|
||
<h3>相對 v1 之改進</h3>
|
||
<ul>
|
||
<li>中西間隙複製乾淨（<code>textContent</code> 不變；v1 之 <code><span></code> 真實空格會被選取）。</li>
|
||
<li>擠壓由「<code>halt</code> 套整段＝半角式」進化為依 <code>lang</code> 之全角／開明／半角，且加入行內連續與行端擠壓。</li>
|
||
<li>新增禁則避頭尾、justify 句末單份間距、跨瀏覽器一致策略與顯式禁用層。</li>
|
||
</ul>
|
||
|
||
<h2>v1（cjk-autospace） · v1-autospace 分支</h2>
|
||
<p>Pangu.js v7.2.1 風格之 CJK↔Latin 邊界自動間距 shim，工廠 <code>createCjkAutospace(options).apply(root)</code>。</p>
|
||
<ul>
|
||
<li>Pass A：跨樣式邊界中西間隙（marker span 含真實空格 ＋ <code>user-select:none</code>）。</li>
|
||
<li>Pass B：pill（<code>code</code>／<code>kbd</code>）邊界間隙。</li>
|
||
<li>Pass C：長英文詞 <code><span lang></code> ＋ <code>hyphens</code>。</li>
|
||
<li>Pass D：開明式標點擠壓（句內點號 <code>font-feature-settings:"halt"</code> 半形）。</li>
|
||
</ul>
|
||
|
||
</main>
|
||
|
||
<footer class="page">
|
||
<p>本頁由聚珍排版工程記錄。所有文檔操作均於 docs 分支進行；main 僅存一份未追蹤之本地鏡像。</p>
|
||
</footer>
|
||
|
||
<!-- RUNTIME_SPRITE -->
|
||
|
||
<script type="text/markdown" id="md-source">
|
||
# 變更紀錄（Changelog）— 聚珍（Juzhen）／cjk-autospace
|
||
|
||
## 下游回饋修復批次（2026-06-03）
|
||
|
||
皆以真實 Chromium 量測驗證（jsdom 不可信）。
|
||
|
||
### 修復
|
||
- 原子透明（段落繼承屬性漏溢）：jz-* inline-block 原子對段落樣式透明——歸零 text-indent／hanging-punctuation（過套用），令原子 text-decoration:inherit 接續下劃線（欠套用）。
|
||
- 中西間隙 gapTrim 自我應驗：行末去隙原依「後字是否在更低行」判定，後字落點受間隙自身及下游間隙 margin 推擠致行中間隙誤 trim（容器寬相關「最後一個間隙消失」、pill 跨行右隙消失）。改「起始全 trim、左→右逐一定案」。
|
||
- 中西間隙西文集完整化：補貨幣（€ 等）、拉丁擴充 A/B（拼音 ā ǎ ē）、西里爾、數學運算符，希臘補全至 α-ω。列舉法 \uXXXX、無需 flag、相容 2016。
|
||
- 標點誤隙：…… 後接 CJK 不誤補（DOTS_CJK 去 |…）；收尾彎引號 ” 後接拉丁／數字不補（移除 pangu QUOTE_AN 偏例）。中文標點 × 簡繁 104 例稽核皆 0 誤隙。
|
||
|
||
### 變更
|
||
- 字型移出聚珍管理：不再內建 font-family／字型堆疊（移除 _lang.css）；逐語言字型交消費端 CSS（範式見文檔「字型與 locl」）。聚珍僅守：jz-* font:inherit 繼承消費端字型、半形 font-feature 顯式併 locl（連同 halt）、render 不改 lang。halt／margin 兩模式字型繼承與 locl 皆驗證正常。
|
||
|
||
### 工具
|
||
- demo/resize-check.html：可拖曳容器檢查頁（各寬度間隙穩定性、標點無誤隙）。
|
||
|
||
## v2 切片 1 · 增補（2026-06）
|
||
|
||
### 新增
|
||
- 標點半形 margin 後備模式（缺 halt 字型）：jiya.halfWidth "halt"|"margin"；margin 以 width:0.5em＋字身偏側溢出定位重現 halt。模式由 data-jz-halfwidth 子樹屬性決定。
|
||
- 字形偏側表 inkBias（left/center/right/full），jiya.bias 逐 lang 逐字覆寫。
|
||
- tools/measure-bias.py 字型偏側量測＋字型適配工作流；demo/fallback.html。
|
||
- justifyAtoms 選項（false → jz-char/jz-jinze 改 inline，相容 Paged.js）。
|
||
|
||
### 修復
|
||
- _lang.css 字型堆疊改純後備（:where 零特異度、只命中 [lang] 元素、不覆寫 jz-inner）→ 消費端字型恆優先。
|
||
- adjacentLogicalChar 透明穿越 jz-jinze → pill 緊鄰標點之左緣間隙與作者空格剝除復原。
|
||
- CJK↔CJK 贅餘作者空格（含跨 inline 標籤）剝除不留隙。
|
||
|
||
### 已知限制
|
||
- margin 後備與 justifyAtoms:false 不可兼得（分頁器場景用 halt 字型）。
|
||
|
||
## v2.0.0 切片 1 · 從零重寫
|
||
|
||
依 ARCHITECTURE.md 從零重寫。公開 API createJuzhen／全域 Juzhen，前綴 jz-。
|
||
|
||
- 核心引擎 finder／unicode／locale／dom／pass。
|
||
- 中西間隙（margin 模型，copy-clean）＋gapTrim 行末去隙。
|
||
- 標點擠壓 全角／開明／半角，三機制，半形 halt。
|
||
- 禁則避頭尾＋justify 綁定；長英文詞；justify 句末單份間距；v1 相容層。
|
||
|
||
## v1（cjk-autospace，v1-autospace 分支）
|
||
|
||
Pangu 風格 CJK↔Latin 間距 shim。Pass A 中西間隙／B pill／C 長詞／D 開明擠壓。
|
||
</script>
|
||
|
||
<!-- RUNTIME_JS -->
|
||
|
||
</body>
|
||
</html>
|