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
parent 2890549f44
commit a3c94ddee5
12 changed files with 156 additions and 336 deletions
@@ -77,7 +77,7 @@
 <script src="../dist/juzhen.iife.js"></script>
 <script>
    // 全頁一次渲染（quanjiao 全角式，與下游回饋之政策一致）；各框由其 lang 屬性
-    // 驅動簡／繁字形。（標點懸掛已停用，見 ARCHITECTURE §6.5.6。）
+    // 驅動簡／繁字形。（標點懸掛已移除，見 ARCHITECTURE §6.5.6。）
    Juzhen.createJuzhen({ scope: { include: ".juzhen" }, lang: { style: "quanjiao" } })
          .render(document.body);

@@ -44,7 +44,7 @@
 <body>

 <h1>聚珍 — 新功能效果演示（定寬對照）</h1>
-<p class="lede">本頁以<strong>定寬文本框</strong>（不可拖動）並排對照，逐場景展示兩項新功能：<strong>功能分級</strong>（文本級／段落級）、<strong>垂懸字避免</strong>（<code>orphan</code>）。各框寬度經 headless 校準，配 Noto Sans CJK 可穩定重現所述效果。勾選下方開關可描出聚珍注入之結構（紫＝垂懸字綁定、紅＝中西間隙、藍＝半形標點）。第三項曾規劃之「標點懸掛」經實測停用，說明見文末。</p>
+<p class="lede">本頁以<strong>定寬文本框</strong>（不可拖動）並排對照，逐場景展示兩項新功能：<strong>功能分級</strong>（文本級／段落級）、<strong>垂懸字避免</strong>（<code>orphan</code>）。各框寬度經 headless 校準，配 Noto Sans CJK 可穩定重現所述效果。勾選下方開關可描出聚珍注入之結構（紫＝垂懸字綁定、紅＝中西間隙、藍＝半形標點）。第三項曾規劃之「標點懸掛」經實測為機制級死路、已移除，說明見文末。</p>

 <div class="toolbar">
    <label><input type="checkbox" id="t-orphan"> 顯示垂懸字綁定（紫 <code>jz-orphan</code>）</label>
@@ -110,9 +110,9 @@
 <p class="hint">邊界：段落實義字 &lt; N（或單行段）→ 不綁、無副作用。極窄容器（&lt;N 字寬）→ 該尾段可能溢出（罕見）。</p>
 </div>

-<!-- ===================== 三、標點懸掛（已停用） ===================== -->
-<h2>三、標點懸掛（<code>hanging</code>）— 已評估停用</h2>
-<p class="note">原計劃之標點懸掛（行端標點凸出版心）經 headless ＋ 真實瀏覽器實測<strong>確認不可行</strong>，已<strong>全面停用</strong>（<code>hanging</code> 選項仍被接受但無任何效果）。原因：純負 <code>margin</code> 機制下，句號墨色偏字框左下角，安全凸出量（&lt; 1em）只把空白半框推出版心、墨色仍在內（視覺不懸掛）；凸出滿 1em 又釋放一整字寬、把下一字拉上本行致重疊；且 <code>ResizeObserver</code> 重排時標記錯亂。真正的解是原生 CSS <code>hanging-punctuation</code>，惟 Chrome 至今不支援、且與本庫 inline-block 對齊原子結構衝突。程式碼與 CSS 保留休眠，俟原生支援成熟再議。詳見 <code>ARCHITECTURE.md §6.5.6</code>。</p>
+<!-- ===================== 三、標點懸掛（已移除） ===================== -->
+<h2>三、標點懸掛（<code>hanging</code>）— 已移除</h2>
+<p class="note">原計劃之標點懸掛（行端標點凸出版心）經 headless ＋ 真實瀏覽器實測確認為<strong>機制級死路</strong>，已<strong>移除</strong>（負 <code>margin</code> 程式碼與 CSS 皆刪；<code>hanging</code> 選項保留為 no-op，無任何效果）。<strong>寬度守恆矛盾</strong>：行端標點盒若保持非零寬，墨色出去多少、版心內就空出多少（行末實義字無法齊版心右緣）；若收為零寬，釋放一整字寬、斷行器把下一字拉上本行與標點重疊（且 <code>justifyAtoms</code> 預設之 inline-block 下負 margin 被 justify 吸收）。<strong>CSS hack 接觸不到斷行器，此恒等式無解。</strong>唯一正解為原生 CSS <code>hanging-punctuation</code>，惟 Chrome／Firefox 至今不支援（僅 Safari），且本庫 <code>jz-char</code> 為 inline-block 原子非文本、原生懸掛不作用之——未來若做須是繞開 jz-char 的「原生管線」新功能。詳見 <code>ARCHITECTURE.md §6.5.6</code>。</p>

 <footer style="margin-top:2.4rem;color:#888;font-size:.78rem;border-top:1px solid #eee;padding-top:.6rem">
 聚珍（Juzhen）· 新功能效果演示。另見 <a href="./resize-check.html">resize-check.html</a>（可拖動容器之穩定性檢查）。寬度配 Noto Sans CJK 校準；換字型時斷行點略異，效果方向不變。