Commit Graph

2 Commits

Author SHA1 Message Date
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
admin 8098991b6b docs: ARCHITECTURE.md — 聚珍(Juzhen)架構契約
從零重寫之實作契約,先於程式碼。涵蓋:
- 設計不變量 I1–I10(複製乾淨、JS/CSS 分離、依 lang、跨瀏覽器一致並顯式禁用
  不一致原語、justify 單份間距、冪等可還原、邊界感知、v1 向下相容、遍歷聚合、
  作用域與分塊)。
- createJuzhen API;3 階段聚合管線(collect/apply,把 ~9 次走訪壓到 3 次)。
- 核心基座 finder/unicode/locale/dom;jz-* 元素詞彙。
- 對照 Han.css 逐功能點實作方案(間隙/長詞/擠壓/禁則/懸掛/標點修正/著重號/注音)。
- 切片 1=v1 對等之映射;§3.5 v1 相容層;§3.6 作用域與分塊功能選擇。
- §8 justify 句末單份間距解法;§9.1 顯式禁用層;§14 風險+預案。
2026-06-01 19:24:03 +08:00