cjk-autospace

admin/cjk-autospace

Fork 0

Commit Graph

Author	SHA1	Message	Date
admin	8ee9895247	feat(levelmark): 塊級分類 CSS 鉤子 data-jz-block-level＋增量塊粒度契約（下游建議七／說明八）建議七：新增 levelMark pass（standalone，order 10，恆開）——render 時把 resolved 功能級別寫回「直接承載可處理文本」之塊級元素：data-jz-block-level="paragraph\|text"， revert 全數移除（I6 之 data-jz-* 清單涵蓋）。消費端段落級 CSS（首要 text-align: justify）自此與 jinze／orphan 共用單一真相源，免另立必然漂移之選擇器白名單。 - 僅標直接承載文本之塊：純容器（body／ul／table…，直接文本僅空白）不標——否則 body 恆判 paragraph、justify 鉤子經繼承污染全頁；此集合恰為段落級 pass 實際作用之塊集。avoid 子樹／pill 內部文本不計，未被處理之塊一致不標。 - 輸入／輸出分離：作者輸入 data-jz-level 只讀不寫；輸出屬性本庫絕不讀取、亦不在 C2 OBSERVE_ATTRS 白名單（外部改動不觸發）；增量路徑 revert 即清、render 即重標。 - 實現：一次 eachTextNode 走訪＋短程上攀定塊（per-run 快取），O(文本)；levelFor 已記憶化。上攀止於 ctx.root，不越界外標。說明八：README／ARCHITECTURE §3.1 明載增量粒度契約——增量須以塊為粒度（換塊內容、增刪塊、改分類屬性皆與全量重繪一致）；不支持對聚珍已切分文本節點之外科式 characterData 直改（charify 以 fragment 替換原節點，舊引用已脫離文檔）——後處理排版器之固有限制、非缺陷，以塊為單位替換內容即可。測試 140→145（標記／純容器不標、text 解析三路（選擇器／屬性／祖先）、avoid／ pill 不標、revert 全清含 root、C2 class 翻轉自動刷新）；tsc 聲明構建通過； headless Chrome 整管線煙測零報錯、段落屬性實際落 DOM。	2026-07-16 16:42:56 +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	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

Author

SHA1

Message

Date

admin

8ee9895247

feat(levelmark): 塊級分類 CSS 鉤子 data-jz-block-level＋增量塊粒度契約（下游建議七／說明八）

建議七：新增 levelMark pass（standalone，order 10，恆開）——render 時把 resolved
功能級別寫回「直接承載可處理文本」之塊級元素：data-jz-block-level="paragraph|text"，
revert 全數移除（I6 之 data-jz-* 清單涵蓋）。消費端段落級 CSS（首要 text-align:
justify）自此與 jinze／orphan 共用單一真相源，免另立必然漂移之選擇器白名單。

- 僅標直接承載文本之塊：純容器（body／ul／table…，直接文本僅空白）不標——否則
  body 恆判 paragraph、justify 鉤子經繼承污染全頁；此集合恰為段落級 pass 實際
  作用之塊集。avoid 子樹／pill 內部文本不計，未被處理之塊一致不標。
- 輸入／輸出分離：作者輸入 data-jz-level 只讀不寫；輸出屬性本庫絕不讀取、亦不在
  C2 OBSERVE_ATTRS 白名單（外部改動不觸發）；增量路徑 revert 即清、render 即重標。
- 實現：一次 eachTextNode 走訪＋短程上攀定塊（per-run 快取），O(文本)；levelFor
  已記憶化。上攀止於 ctx.root，不越界外標。

說明八：README／ARCHITECTURE §3.1 明載增量粒度契約——增量須以塊為粒度（換塊
內容、增刪塊、改分類屬性皆與全量重繪一致）；不支持對聚珍已切分文本節點之外科式
characterData 直改（charify 以 fragment 替換原節點，舊引用已脫離文檔）——後處理
排版器之固有限制、非缺陷，以塊為單位替換內容即可。

測試 140→145（標記／純容器不標、text 解析三路（選擇器／屬性／祖先）、avoid／
pill 不標、revert 全清含 root、C2 class 翻轉自動刷新）；tsc 聲明構建通過；
headless Chrome 整管線煙測零報錯、段落屬性實際落 DOM。

2026-07-16 16:42:56 +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

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

3 Commits