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

7 Commits

Author SHA1 Message Date
admin a3c94ddee5 refactor: 移除標點懸掛（機制級死路）——負 margin 程式碼／CSS／型別一併刪 
標點懸掛經實測為**機制級死路**（純 CSS 之寬度守恆矛盾）：行端標點盒保持非零寬則墨色
出去多少版心內就空多少（行末實義字無法齊邊）；收為零寬則釋放一整字寬、斷行器把下一字
拉上本行與標點重疊（且 justifyAtoms 預設之 inline-block 下負 margin 被 justify 吸收）。
CSS hack 接觸不到斷行器，此恒等式無解。唯一正解為原生 hanging-punctuation（僅 Safari
支援、且 jz-char 為 inline-block 原子非文本，原生懸掛不作用），屬遠期「原生管線」新功能、
與此處無共享，故不保留休眠碼。

移除：
  lineedge.ts — jz-hang-* class、HANG_* 常量、applyEdge hang 分支、modeForChar、
    HANG_ENABLED 總開關；行端僅餘 squeeze（半形）。
  _jiya.css — jz-hang-* 三條規則（margin 半形 fallback 完整保留）。
  types.ts — LineEndMode 型別、ResolvedOptions.lineEnd、features.hanging。
  index.ts — lineEnd 鎖。
  hanging 公開選項保留為 @deprecated no-op（API 相容）。

文檔：README「標點懸掛」節、ARCHITECTURE §6.5（開頭／§6.5.2／§6.5.4／§6.5.5／§6.5.6）、
demo（showcase §三／resize-check）全部由「停用／休眠」改為「已移除」＋寬度守恆論證。

測試：防逃逸測試改寫為「hanging 為 no-op、輸出與不傳一致、各路徑不產生 jz-hang-*」。
全綠 101。dist 已無 jz-hang／lineEnd／HANG 殘留。
 2026-06-11 16:16:01 +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 5b9c6b5fa1 refactor: 字型移出聚珍管理（移除 _lang.css），交消費端；半形顯式保留 locl 
下游回饋之字型樹需求。決策：字型屬消費端領域，聚珍不應內建字型堆疊（原 _lang.css
之 Noto 後備係越權，且曾蓋掉消費端字型釀 bug）。採「完全移除、交消費端 CSS」（A 案），
否決「以參數管字型」（B 案——JS 管字型須注入 CSS、違反 JS 注入結構／CSS 給視覺之分工；
而缺 halt 字型須逐字型微調 margin 之指引，由既有 jiya.halfWidth／jiya.bias ＋文檔承擔）。

移除：
- 刪 src/css/_lang.css，juzhen.css 移除其 @import。dist/juzhen.css 現零 font-family
  規則（3.1→2.5kb）。

聚珍保留之三項非管理性本分（確保不礙消費端字型與 locl）：
- _normalize.css `jz-* { font: inherit }`：原子繼承消費端字型、不強加。
- _jiya.css 半形 font-feature-settings 顯式改 "locl" 1, "halt" 1（預設＋halt-island 兩
  處）：確保泛 CJK 字型（思源／Noto CJK）之地域標點字形不因設 halt 而失。
- render 只讀不改 lang。body 文本之 locl 全由消費端字型＋正確 lang 決定。

驗證（真實 Chromium）：
- halt 模式：消費端逐 lang 字型生效並繼承至 jz-inner，無強制 Noto。
- margin 後備：半形盒 0.5em、字身依墨色偏側位移正確、jz-inner 繼承消費端字型、
  feature normal（locl 既定開），皆不受字型移除影響。

- demo/index.html、resize-check.html 改示範「消費端逐 lang 設 font-family」之推薦範式；
  fallback.html 更新註解。
- README 新增「字型與 locl」節＋改寫 CSS 基礎設定字型項；ARCHITECTURE §6.9 改寫
  （A 案決策、否決 B 案、三項本分）＋檔案樹。
- test：新增 CSS 回歸（不內建 font-family、半形保留 locl）。57 測試通過。
- dist/ 重建（僅 juzhen.css 變動，JS 不變）。
 2026-06-03 02:04:34 +08:00
admin 96f5ac32e1 fix: 原子透明——段落繼承屬性漏溢修復（text-indent／hanging-punctuation／text-decoration） 
下游回報：段落設 text-indent 時，標點附近冒出巨大間距。根因為聚珍把標點拆成
inline-block 原子，繼承屬性被每個原子重複套用（過套用），且裝飾盒跳過原子（欠套用）。
以「同類問題整體界定」原則統一在庫內修復，使原子對消費端段落樣式透明。

範圍（headless Chrome 逐屬性實測界定，非逐案補丁）：

過套用（繼承屬性被 inline-block 原子各自重套），於原子歸零：
- text-indent: 0——段落首行縮排傳入後每原子內部各縮排一次，shrink-to-fit 寬膨脹為
  縮排量＋字形。實測：歸零後段落首行縮排保持 2em、原子寬由 ~3em 回到 0.5em／1em。
- hanging-punctuation: none——同屬區塊容器首／末行機制；Chrome 未實作、Safari 觸發，
  且與規劃中之標點懸掛相衝，按機制一併歸零。

欠套用（text-decoration 非繼承、由段落裝飾盒繪製並跳過原子致下劃線斷缺），令原子
inherit 自繪接續：
- jz-char／jz-jinze 設 text-decoration: inherit；margin 模式 jz-inner 亦為
  inline-block，於 _jiya.css 補一條。像素掃描實測：halt／margin 兩模式下劃線
  coverage 由 ~0.25 回到 1.0，且 margin 下劃線隨半形收為 0.5em advance。

不處理者（實測不洩漏或本應逐字穿透）：letter-spacing／word-spacing／text-align 系／
text-transform／line-height／color／font／word-break／overflow-wrap／hyphens／
white-space／tab-size／text-emphasis／text-shadow／font-variant／font-stretch。

- src/css/_normalize.css：過套用歸零 + text-decoration 透明（含原則與實測依據注釋）。
- src/css/_jiya.css：margin 模式 jz-inner 裝飾接續。
- test/juzhen.test.mjs：三項回歸斷言（51 測試通過）。
- README.md CSS 基礎設定第 8 項、ARCHITECTURE.md「原子透明原則」一節。
- dist/ 重建。
 2026-06-02 17:18:41 +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