docs: 同步現行契約並保留逐字半形後備

README.md

@@ -93,7 +93,8 @@ import { createJuzhen } from "cjk-autospace";
 import "cjk-autospace/css";
 
 const jz = createJuzhen({ lang: { default: "zh-Hant" } });
-jz.render(document.querySelector("main"));
+const main = document.querySelector("main");
+if (main) { jz.render(main); }
 ```
 
 **JS 與 CSS 缺一不可**：JS 只注入 `jz-*` 結構，所有視覺尺寸（間隙寬度、擠壓量、
@@ -145,11 +146,12 @@ jz.observe(document.body);        // 之後 DOM 變動即自動增量恢復
 > 器之固有限制（任何外科式文本 patch 之框架皆會與注入後之 DOM 失步）、非缺陷——聚珍對當前
 > DOM 之處理始終自洽。欲改文字，以塊為單位替換內容即可。
 
-> **`revert` 之範圍**：`revert` 乾淨移除聚珍注入之全部結構（`jz-*`／`data-jz-*`），DOM 回到**邏輯
-> 等價**態；但**不還原** `spacing` 依契約規範化之贅餘作者空格（CJK↔西文吸收為 margin 間隙、
-> CJK↔CJK 剝除；見上表「中西間隙」）。即 `render→revert` 對含 CJK↔西文作者空格之源，還原後語義
-> 一致、無 `jz-*` 殘留，唯該空格已正規化（此差異穩定、不隨反覆 render／revert 累積）。若消費端需
-> 保留原始作者空格以供編輯，應自存原文、勿以 `revert` 當「還原到未處理源碼」。
+> **`revert` 之範圍**：撤回本實例仍持有所有權、且符合產物與來源完整性檢查的結構及屬性，
+> 保留作者標記與其他實例的產物。沒有外部修改時，DOM 回到處理前的**邏輯等價**態；但
+> **不還原** `spacing` 依契約規範化之贅餘作者空格（CJK↔西文吸收為 margin 間隙、
+> CJK↔CJK 剝除；見後面的「中西間隙」功能表）。此差異穩定、不隨反覆 render／revert 累積。
+> 外部克隆、替換或刪除後，以作者當前內容為準，不保證恢復歷史快照或清空所有 `jz-*`。
+> 若消費端需保留原始作者空格以供編輯，應自存原文、勿以 `revert` 當「還原到未處理源碼」。
 
 外部克隆／替換／刪除跨節點載體後，`revert` 保留作者當前內容，不補回已刪文字；
 克隆不繼承本實例所有權。欲修改原文，先 `revert` 再修改，或直接替換整塊內容。
@@ -217,7 +219,7 @@ createJuzhen({
 |---|---|---|---|
 | `lang.default` | string | `"zh-Hant"` | 無 `lang` 祖先時之預設語言標籤 |
 | `lang.style` | `quanjiao｜kaiming｜banjiao` | 逐語言內建（繁→全角、簡→開明） | **全域政策一鍵覆寫** |
-| `lang.policy` | `Record<lang, style>` | `{}` | 逐 lang 政策 |
+| `lang.policy` | `Partial<Record<LangClass, PunctStyle>>` | `{}` | 按語言分類覆寫：鍵僅為 `zh-Hans`、`zh-Hant`、`ja`、`other`；如 `zh-TW` 先歸入 `zh-Hant`，不直接作為鍵 |
 | `lang.stylePolicy` | `{selector,style}[]` | `[]` | **逐元素樣式覆寫**（選擇器命中之子樹用指定樣式；如 `[{selector:"h1,button,.ui",style:"banjiao"}]`）；配合 `data-jz-style` 屬性，優先於 lang |
 
 **作用域**
@@ -248,8 +250,8 @@ createJuzhen({
 |---|---|---|---|
 | `pillSelector` | CSS 選擇器 | `"code, kbd"` | 整體元素（內部不可見、兩端補隙） |
 | `isolateSelector` | CSS 選擇器 | `"mark"`（`""` 停用） | 隔離元素（內部照常、兩端補隙） |
-| `styleInlines` | 標籤名[] | 27 個標準行內標籤 | **透明穿越白名單**（未列之行內標籤＝邊界） |
-| `blockTags` | 標籤名[] | 36 個塊標籤 | 塊級邊界集 |
+| `styleInlines` | 標籤名[] | 28 個標準行內標籤 | **透明穿越白名單**（未列之行內標籤＝邊界） |
+| `blockTags` | 標籤名[] | 43 個塊標籤 | 塊級邊界集 |
 | `skipTags` | 標籤名[] | `PRE,SAMP,TT,VAR,SCRIPT,STYLE,TEXTAREA,INPUT` | avoid 標籤集（**不含 CODE/KBD**，由 pill 涵蓋） |
 | `skipAttribute` | string | `null` | 自訂「跳過」屬性名（命中即 avoid） |
 | `isSkipped` | `(node)=>bool` | `null` | 自訂跳過謂詞（函數級排除鉤子） |
@@ -291,8 +293,9 @@ createJuzhen({
 ```
 
 優先序：**逐元素覆寫**（`data-jz-style` 屬性／`stylePolicy` 選擇器，**近祖先勝、同層屬性優先於
-選擇器**）＞ `lang.policy` ＞ `lang.style` ＞ 內建逐語言預設。屬性值非法（拼錯）則忽略、回退
-lang。半角式渲染沿用既有 `halt`／`margin` 機制（見下節），本功能只做「按元素選樣式」、無新增
+選擇器**）＞ `lang.policy` ＞ `lang.style` ＞ 內建逐語言預設。屬性值非法（拼錯）只忽略該信號，
+仍查同層 `stylePolicy` 選擇器與祖先；沒有任何逐元素信號時才回退語言政策。
+半角式渲染沿用既有 `halt`／`margin` 機制（見下節），本功能只做「按元素選樣式」、無新增
 渲染邏輯。
 
 ### 行內元素三分類：透明／隔離／整體
@@ -487,6 +490,10 @@ CSS 皆刪）。`hanging` 選項仍被接受（API 相容）但**無任何效果
 
 ## 標點半形：`halt` 預設與 `margin` 後備
 
+**缺半形特性字型的逐字相容方案仍保留**：`margin` 後備搭配 `jiya.bias`，可按語言分類、
+逐標點指定 `left`／`center`／`right`／`full`。它與字型自帶的 `halt` 是兩條渲染路徑；
+偏側覆寫、量測工具與目視微調流程見本節，不因移除舊負 letter-spacing 方案而取消。
+
 開明／半角式把標點收成「半形」，有兩種渲染機制：
 
 | 機制 | 設定 | 原理 | 適用 |
@@ -605,11 +612,11 @@ JS 只注入 `jz-*` 結構，**所有視覺尺寸在 `juzhen.css`**——故 CSS
    關閉原生 `text-autospace`（避免與受管間隙重複作用）；不設定 `text-spacing-trim`，
    間隙不注入空白字元；僅跨節點 IVS gap 之 `U+200B ::after`
    設 `user-select:none`，避免該斷行提示進入選取／複製。
-8. **段落屬性照常設、原子透明**：聚珍把標點拆成 inline-block 原子，但已確保這些原子對
-   消費端段落樣式透明——可在段落正常設 `text-indent`（首行縮排）、`hanging-punctuation`、
-   `text-decoration`（下劃線）等；庫內已歸零會被原子重複套用之繼承屬性、並令原子承接段落
-   裝飾，故首行縮排正常、下劃線連續不斷，無需任何額外配置（機制見 ARCHITECTURE「原子透明
-   原則」）。
+8. **段落縮排與裝飾**：聚珍把標點拆成 inline-block 原子，於原子上歸零 `text-indent`，
+   避免段落首行縮排被每個原子重複套用；原子也承接 `text-decoration` 裝飾。
+   可在段落設定縮排與下劃線（機制見 ARCHITECTURE「原子透明原則」）。
+   `hanging-punctuation` 在原子上設為 `none`；當前管線不提供標點懸掛，不能由此推定
+   段落設定該屬性便會使受管標點出版心。
 
 ---