Files
cjk-autospace/docs/changelog.src.html
T
admin 38a1cbaace docs: 功能分級 + 垂懸字 + 標點懸掛(同步 main §6.5 落地)
changelog 增「功能分級 + 垂懸字 + 標點懸掛」條目(2026-06-09):功能分級
(文本/段落級)、垂懸字 orphan(方案 C,預設開)、標點懸掛 hanging(按類凸出量、
headless 校準、需 justifyAtoms:false)、行歸屬 bug 修正、兩階段防自我應驗、demo 增區。
index 功能表增 orphan/hanging/level 三列、選項示例與 md twin 同步、各功能標級別。
重建 index.html/changelog.html。
2026-06-09 22:19:29 +08:00

212 lines
21 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!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-09">
<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-09</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-09</span></h2>
<p>ARCHITECTURE §6.5 整體計劃落地(功能分級前置 → 垂懸字 → 行端模式重構 → 標點懸掛),共 87 單元測試全綠,懸掛經 headless Chrome 校準。</p>
<h3>新增</h3>
<ul>
<li><strong>功能分級(文本級 vs 段落級)</strong>:把已實作功能切為兩級——<strong>文本級</strong>(中西間隙 <code>spacing</code>、標點擠壓 <code>jiya</code>,任意文本片段適用)與<strong>段落級</strong>(禁則 <code>jinze</code>、垂懸字 <code>orphan</code>、標點懸掛 <code>hanging</code>、長詞 <code>longWord</code>,需行/段布局)。塊級元素預設全功能;<code>data-jz-level="text"</code> 子樹(最近祖先勝)或選項 <code>level:{text:"選擇器"}</code> 標記之元素(標題/按鈕/UI)僅跑文本級。實作為 <code>Finder.levelFor</code><code>levelAllows</code> 各 pass <code>level</code> 元數據;段落級 pass(含 charify 之 longWord)逐元素受閘。<code>spacing</code> 補單元素 root 支援(行內/非塊 root 亦處理)。</li>
<li><strong>垂懸字避免 <code>orphan</code>(方案 C,斷行層無測量,order 70)</strong>:段末行 CJK 實義字 ≥ N(預設 2;標點/符號不計)。把段末「第 N 個實義字起至段末」(含尾隨標點)包入 <code>jz-orphan</code><code>white-space:nowrap</code>),整體不可斷 → 末行恒含之 ⇒ 末行實義字 ≥ N,任意寬度/字型成立、無需量測。邊界字落於行內元素內時綁定整個塊級直接子(跨 <code>jz-jinze</code> 攀爬、不切割)。<strong>預設開 chars=2</strong><code>orphan:false</code> 關);段落級,<code>data-jz-level="text"</code> 跳過。</li>
<li><strong>標點懸掛 <code>hanging</code>(渲染層 layout,§6.5.2</strong>:行尾點號/閉類右凸、行首開類左凸出版心,令正文格線齊邊(自管負 margin)。凸出量按類校準(headless 實測,Noto Sans CJK SC):點號近全形 <code>--jz-hang-stop</code>1em)、括號半形 <code>--jz-hang-bracket</code>(0.5em),CSS 變數可逐字型調。逐 lang 閘:繁體橫排預設不懸掛(降回 squeeze,clreq)。<strong>預設關</strong>;已 baseline 半形之標點不懸掛。lineedge 行端處理升級為可配模式 <code>squeezehangnone</code>(抽出共用偵測碼,squeeze 行為不變)。</li>
</ul>
<h3>修復</h3>
<ul>
<li><strong>行歸屬判定 bug(連帶改善 squeeze</strong>:原以「行盒 <code>top</code>&gt; EPS=4px」判同/異行,但 <code>jz-char</code> 為 inline-block,其行盒 <code>top</code> 與相鄰純文本字形 <code>top</code> 因基線差約 5px、遠小於行高卻超舊容差,致同行誤判為下一行(懸掛句末標點過度觸發之根因)。改判「垂直區間」:下一行=<code>b.top ≥ a.bottom</code>、上一行=<code>b.bottom ≤ a.top</code>(容 2px)。</li>
<li><strong>懸掛自我應驗</strong><code>relayout</code> 改兩階段——先清全部行端效果、於自然佈局量測全部標點、再一次性套用(仿 gapTrim 教訓),終態穩定。</li>
</ul>
<h3>已知限制</h3>
<ul>
<li><strong>懸掛與 inline-block 對齊原子互斥</strong>headless 實測):預設 <code>justifyAtoms:true</code><code>jz-char</code> inline-block)下,懸掛之負 margin 被 justify 重分配吸收、標點不凸出;欲懸掛須設 <code>justifyAtoms:false</code><code>jz-char</code> 改 inline)。容器宜留左右 padding ≥1em 容納凸出標點。</li>
<li><strong>懸掛凸出量逐字型校準</strong>:現預設依 Noto Sans CJK SC;他字型留白比例略異,經 CSS 變數調校。繁體若日後欲開懸掛須另校。</li>
</ul>
<h3>工具</h3>
<ul>
<li><code>demo/resize-check.html</code> 增垂懸字(<code>jz-orphan</code> 描框 + 關閉對照)與標點懸掛(獨立實例、句號密集文本、版心虛線)兩檢查區,工具列增對應顯示開關。</li>
</ul>
<h2>標點挤压一致性 <span class="badge accent">2026-06-04</span></h2>
<h3>新增/修復</h3>
<ul>
<li><strong>全角句點 <code></code> 納入句末標點</strong><code>BD_STOP</code><code>。!?</code> 擴為 <code>。.!?</code>——納入全角句點 <code></code>U+FF0E,異於表意句號 <code></code> U+3002)。實測 Noto CJK SCTC 之 <code>halt</code> 皆覆蓋、挤压收半形 advance 0.5em,與 <code></code> 一致;<code>inkBias</code> 同步補(簡 left/繁 center)。政策行為同 <code>。!?</code><strong>全角式與開明式句末保持全角 1em</strong>,banjiao(或鄰接被收)挤半。設計原則:<code>halt</code> 即字型之「挤压意願」,字型不提供某標點 <code>halt</code>(字形占滿、不宜挤)則信任字型、保持全角不強挤。</li>
<li><strong>連續標點挤压規則:雙側獨立 + 透明穿越</strong>(修正既有不一致)。規則:相鄰兩標點,<strong>對每一標點</strong>獨立判斷——若其「有空白之側」緊鄰另一標點即收半。原為「二選一只收一側」,致 <code>,「</code> 全角式誤為 1.5em;修後 <code>,「</code> <strong>全角式與開明式皆 1em</strong><code>。」</code> <strong>全角式 1.5em/開明式 1em</strong><code>·—</code> 兩式皆 2em(不宜挤)。並改「同 parent 直接兄弟」掃描為<strong>從 root 之透明遍歷</strong>(穿越 <code>strong</code><code>em</code> 等行內邊界、blockavoid 斷相鄰),使跨 inline 邊界之連續標點亦正確配對(原漏致達 2em)。</li>
</ul>
<h2>字符分類規則集 <span class="badge accent">2026-06-04</span></h2>
<h3>新增</h3>
<ul>
<li><strong>可配置字符分類(<code>charClass</code></strong>:把散落各 pass 之硬編碼分類(中文 CJK/西文 ANS/全寬標點 BD_* 子類)統一抽象為<strong>規則集</strong>,內置默認即現狀值,消費端經 <code>options.charClass</code><code>{ cjk?, western?, biaodian?:{stop,pause,open,close,middle,liga} }</code><strong>追加擴充</strong>,覆寫 <code>spacing</code><code>jiya</code><code>jinze</code> 之分類判定。動機:未分類符號(如二點省略 <code></code> U+2025)——不 charify/不挤;以 <code>charClass:{biaodian:{stop:"‥"}}</code> 即可歸入對應類。<strong>向下兼容</strong>:不傳則行為與內置完全一致、各實例隔離(覆寫不污染默認)。v1 為追加語義(不重分類/移除內置);結構性 ASCII 不開放。<code>spacing</code> 之間隙正則改由規則集 per-instance 編譯。測試 66 通過(含 9 條 charClass)。</li>
</ul>
<h2>下游回饋修復批次 <span class="badge accent">2026-06-03</span></h2>
<p>聚焦 Peek.nvim 等下游回饋之原子透明與中西間隙正確性,皆以真實 Chromium 量測驗證(jsdom 之 TreeWalkeroffset 失真,不可信)。</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,相容 2016Windows 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>leftcenterrightfull</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>&lt;span lang&gt;</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>esbuildESMIIFECSS)+ tscd.ts);jsdom 測試;<code>demo/</code> 簡繁並列+justify+標點寬度量測。</li>
</ul>
<h3>相對 v1 之改進</h3>
<ul>
<li>中西間隙複製乾淨(<code>textContent</code> 不變;v1 之 <code>&lt;span&gt;</code> 真實空格會被選取)。</li>
<li>擠壓由「<code>halt</code> 套整段=半角式」進化為依 <code>lang</code> 之全角/開明/半角,且加入行內連續與行端擠壓。</li>
<li>新增禁則避頭尾、justify 句末單份間距、跨瀏覽器一致策略與顯式禁用層。</li>
</ul>
<h2>v1cjk-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 Bpill<code>code</code><code>kbd</code>)邊界間隙。</li>
<li>Pass C:長英文詞 <code>&lt;span lang&gt;</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 聚珍Juzhencjk-autospace
## 標點挤压一致性2026-06-04
### 新增修復
- 全角句點 納入句末標點BD_STOP 擴為 U+FF0E 異於 U+3002Noto CJK halt挤压收 0.5em 一致inkBias left center政策同 全角式與開明式句末保持全角 1embanjiao 挤半原則halt 即字型挤压意願字型不給某標點 halt不宜挤則信任字型不強挤
- 連續標點挤压雙側獨立 透明穿越規則相鄰兩標點對每一標點獨立判斷若其有空白之側緊鄰另一標點即收半修後 全角式與開明式皆 1em 全角式 1.5em開明式 1em· 兩式皆 2em並改同 parent 掃描為從 root 透明遍歷 strong/em 邊界之連續標點亦正確挤原漏致 2em
## 字符分類規則集2026-06-04
### 新增
- 可配置字符分類 charClass硬編碼分類中文西文全寬標點子類統一抽象為規則集內置默認消費端經 options.charClasscjkwesternbiaodian{stop,pause,open,close,middle,liga}追加擴充覆寫 spacingjiyajinze 判定未分類符號 U+2025可經 biaodian.stop 歸全寬句末標點向下兼容不傳則行為不變實例隔離v1 追加語義不重分類內置結構性 ASCII 不開放spacing 間隙正則改由規則集 per-instance 編譯測試 66 通過
## 下游回饋修復批次2026-06-03
皆以真實 Chromium 量測驗證jsdom 不可信
### 修復
- 原子透明段落繼承屬性漏溢jz-* inline-block 原子對段落樣式透明歸零 text-indenthanging-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連同 haltrender 不改 langhaltmargin 兩模式字型繼承與 locl 皆驗證正常
### 工具
- demo/resize-check.html可拖曳容器檢查頁各寬度間隙穩定性標點無誤隙
## v2 切片 1 · 增補2026-06
### 新增
- 標點半形 margin 後備模式 halt 字型jiya.halfWidth "halt"|"margin"margin width:0.5em字身偏側溢出定位重現 halt模式由 data-jz-halfwidth 子樹屬性決定
- 字形偏側表 inkBiasleft/center/right/fulljiya.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 緊鄰標點之左緣間隙與作者空格剝除復原
- CJKCJK 贅餘作者空格含跨 inline 標籤剝除不留隙
### 已知限制
- margin 後備與 justifyAtoms:false 不可兼得分頁器場景用 halt 字型
## v2.0.0 切片 1 · 從零重寫
ARCHITECTURE.md 從零重寫公開 API createJuzhen全域 Juzhen前綴 jz-
- 核心引擎 finderunicodelocaledompass
- 中西間隙margin 模型copy-cleangapTrim 行末去隙
- 標點擠壓 全角開明半角三機制半形 halt
- 禁則避頭尾justify 綁定長英文詞justify 句末單份間距v1 相容層
## v1cjk-autospacev1-autospace 分支
Pangu 風格 CJKLatin 間距 shimPass A 中西間隙B pillC 長詞D 開明擠壓
</script>
<!-- RUNTIME_JS -->
</body>
</html>