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
parent 8098991b6b
commit 2d42c7ecf2
46 changed files with 7737 additions and 27 deletions
@@ -0,0 +1,68 @@
+// 構建腳本：esbuild 產出 ESM / IIFE / CSS；d.ts 由 `tsc --emitDeclarationOnly`
+// 另行產出（見 package.json scripts）。
+//
+//   dist/juzhen.mjs       ESM，供打包器／TypeScript／jsdom 測試。
+//   dist/juzhen.iife.js   IIFE，全域 `Juzhen`，原生 <script> 直跑；額外掛
+//                         `globalThis.createCjkAutospace` 別名（v1 相容消費端）。
+//   dist/juzhen.css       合併之樣式（css/juzhen.css 之 @import 展開）。
+
+import { build } from "esbuild";
+
+const ENTRY = "src/index.ts";
+
+const SHARED = (
+    {
+        bundle: true,
+        target: [ "es2020", "chrome111", "safari16", "firefox115" ],
+        logLevel: "info",
+    }
+);
+
+// IIFE：把 Juzhen 掛上 globalThis，並補 v1 全域別名。
+const IIFE_FOOTER = (
+    "if(typeof globalThis!=='undefined'){"
+    + "globalThis.Juzhen=Juzhen;"
+    + "if(Juzhen&&Juzhen.createCjkAutospace&&!globalThis.createCjkAutospace)"
+    + "{globalThis.createCjkAutospace=Juzhen.createCjkAutospace;}"
+    + "}"
+);
+
+async function main()
+{
+    await build(
+        {
+            ...SHARED,
+            entryPoints: [ ENTRY ],
+            format: "esm",
+            outfile: "dist/juzhen.mjs",
+        }
+    );
+
+    await build(
+        {
+            ...SHARED,
+            entryPoints: [ ENTRY ],
+            format: "iife",
+            globalName: "Juzhen",
+            outfile: "dist/juzhen.iife.js",
+            footer: { js: IIFE_FOOTER },
+        }
+    );
+
+    await build(
+        {
+            ...SHARED,
+            entryPoints: [ "src/css/juzhen.css" ],
+            outfile: "dist/juzhen.css",
+            loader: { ".css": "css" },
+        }
+    );
+}
+
+main().catch(
+    (err) =>
+    {
+        console.error(err);
+        process.exit(1);
+    }
+);