feat: 功能分級（文本級 vs 段落級）＋ data-jz-level 標記（§6.5.0a）

整體計劃 §6.5 之前置基礎設施。把已實作功能切為兩級：
- 文本級（spacing 中西間隙、jiya 標點擠壓／鄰接）：任意文本片段皆適用。
- 段落級（jinze 禁則、longWord 斷詞、lineEdge 行端、gapTrim）：需行／段布局。

標記 API：
- 預設塊級元素 → 段落級（全功能）。
- 元素屬性 data-jz-level="text"｜"paragraph"（最近祖先勝）。
- 選項 level:{ text: "選擇器" }（如標題／按鈕一鍵降為文本級）。

實作：
- 每個 pass 加 level 元數據；Finder.levelFor／levelAllows（含快取）。
- charify 段落級 pass（longWord）於共享走訪受閘；standalone 段落級 pass
  （jinze／lineEdge／gapTrim）逐元素受閘。文本級不受限。
- spacing 補單元素 root 支援：root 為行內／單一非塊元素時亦處理（標題等
  之中西間隙、標點半形生效）。

6 項新單元測試（text-level 跳段落級、選擇器標記、巢狀最近勝、單元素 spacing、
預設段落級回歸）。共 76 測試全綠。

dist/core/finder.d.ts

@@ -1,4 +1,4 @@
-import type { ResolvedOptions } from "../types.js";
+import type { FeatureLevel, ResolvedOptions } from "../types.js";
 /** 邏輯 run 中之單一字元來源位置。 */
 export interface CharPos {
     textNode: Text;
@@ -25,7 +25,9 @@ export declare class Finder {
     private readonly includeSelector;
     private readonly skipAttr;
     private readonly userIsSkipped;
+    private readonly levelTextSelector;
     private readonly featureCache;
+    private readonly levelCache;
     constructor(opts: ResolvedOptions);
     /** 該元素是否匹配 pill 選擇器（行內塊，如 code/kbd）。 */
     pillMatches(el: Element): boolean;
@@ -53,6 +55,18 @@ export declare class Finder {
      * marker 即止。direction = -1 取前鄰字，+1 取後鄰字。
      */
     adjacentLogicalChar(el: Element, direction: -1 | 1): AdjacentChar | null;
+    /**
+     * 節點之功能級別（§6.5.0a）。自 node 向上找**最近**之顯式信號：元素屬性
+     * `data-jz-level="text|paragraph"`（最優先），或命中 `level.text` 選擇器（→ text）；
+     * 皆無則預設 paragraph（全功能）。結果以解析後之元素為鍵快取。
+     */
+    levelFor(node: Node): FeatureLevel;
+    /**
+     * 某級別之 pass 是否可作用於該節點（§6.5.0a gate）。文本級 pass 不受限（恆 true）；
+     * 段落級 pass 僅作用於段落級元素（text-level 子樹跳過）。與 featureEnabledFor 疊加：
+     * level 為粗粒度語義組（先判），blocks／屬性為細粒度逐功能（後調）。
+     */
+    levelAllows(node: Node, passLevel: FeatureLevel): boolean;
     /**
      * 解析節點對某功能之有效啟用狀態（§3.6，per-node 閘）。向上找最近帶
      * 功能指令之祖先（data-juzhen 白名單 / data-juzhen-off 黑名單 / 命中

dist/core/unicode.d.ts

@@ -11,8 +11,10 @@ export declare const ANY_CJK: RegExp;
 export declare const ANS_AFTER_CJK: string;
 /** CJK 之前可接間隙之西文集（去 @）。 */
 export declare const ANS_BEFORE_CJK: string;
-/** 句末點號：。！？（開明式與全角式皆保持全形，不擠壓）。 */
-export declare const BD_STOP = "\u3002\uFF01\uFF1F";
+/** 句末點號：。．！？（開明式與全角式皆保持全形，不擠壓；banjiao 擠半）。
+ *  含全角句點 ．（U+FF0E，異於表意句號 。U+3002）——實測 Noto CJK SC／TC 皆有 halt、
+ *  挤壓收 0.5em，故與 。！？ 同列為句末點號（下游回饋）。 */
+export declare const BD_STOP = "\u3002\uFF0E\uFF01\uFF1F";
 /** 句內點號：，、；：（開明式擠成半形；全角式保持全形）。 */
 export declare const BD_PAUSE = "\uFF0C\u3001\uFF1B\uFF1A";
 /** 開始括號／引號：「『（《〈【〖〔［｛“‘。 */

dist/juzhen.iife.js

@@ -37,9 +37,11 @@ var Juzhen = (() => {
       this.pillSelector = opts.finder.pillSelector;
       this.skipAttr = opts.finder.skipAttribute;
       this.userIsSkipped = opts.finder.isSkipped;
+      this.levelTextSelector = opts.levelText;
       this.avoidSelector = opts.scope.avoid;
       this.includeSelector = opts.scope.include;
       this.featureCache = /* @__PURE__ */ new WeakMap();
+      this.levelCache = /* @__PURE__ */ new WeakMap();
     }
     /** 該元素是否匹配 pill 選擇器（行內塊，如 code/kbd）。 */
     pillMatches(el) {
@@ -259,6 +261,48 @@ var Juzhen = (() => {
         p = pe.parentNode;
       }
     }
+    /**
+     * 節點之功能級別（§6.5.0a）。自 node 向上找**最近**之顯式信號：元素屬性
+     * `data-jz-level="text|paragraph"`（最優先），或命中 `level.text` 選擇器（→ text）；
+     * 皆無則預設 paragraph（全功能）。結果以解析後之元素為鍵快取。
+     */
+    levelFor(node) {
+      const start = node.nodeType === 1 ? node : node.parentElement;
+      if (!start) {
+        return "paragraph";
+      }
+      const cached = this.levelCache.get(start);
+      if (cached) {
+        return cached;
+      }
+      let el = start;
+      let result = "paragraph";
+      while (el) {
+        const attr = el.getAttribute ? el.getAttribute("data-jz-level") : null;
+        if (attr === "text" || attr === "paragraph") {
+          result = attr;
+          break;
+        }
+        if (this.levelTextSelector && el.matches && el.matches(this.levelTextSelector)) {
+          result = "text";
+          break;
+        }
+        el = el.parentElement;
+      }
+      this.levelCache.set(start, result);
+      return result;
+    }
+    /**
+     * 某級別之 pass 是否可作用於該節點（§6.5.0a gate）。文本級 pass 不受限（恆 true）；
+     * 段落級 pass 僅作用於段落級元素（text-level 子樹跳過）。與 featureEnabledFor 疊加：
+     * level 為粗粒度語義組（先判），blocks／屬性為細粒度逐功能（後調）。
+     */
+    levelAllows(node, passLevel) {
+      if (passLevel === "text") {
+        return true;
+      }
+      return this.levelFor(node) === "paragraph";
+    }
     /**
      * 解析節點對某功能之有效啟用狀態（§3.6，per-node 閘）。向上找最近帶
      * 功能指令之祖先（data-juzhen 白名單 / data-juzhen-off 黑名單 / 命中
@@ -331,6 +375,9 @@ var Juzhen = (() => {
     ctx.finder.eachTextNode(ctx.root, (node) => {
       let requests = [];
       for (const p of passes) {
+        if (!ctx.finder.levelAllows(node, p.level)) {
+          continue;
+        }
         const got = p.collect(node, ctx);
         if (got.length > 0) {
           requests = requests.concat(got);
@@ -665,6 +712,7 @@ var Juzhen = (() => {
     name: PASS,
     kind: "charify",
     order: 20,
+    level: "text",
     enabled: (o) => o.features.jiya,
     collect(node, ctx) {
       if (inJzChar(node)) {
@@ -718,6 +766,7 @@ var Juzhen = (() => {
     name: "jiyaAdjacency",
     kind: "standalone",
     order: 25,
+    level: "text",
     enabled: (o) => o.features.jiya,
     render(ctx) {
       const { finder, options } = ctx;
@@ -890,11 +939,15 @@ var Juzhen = (() => {
     name: PASS2,
     kind: "standalone",
     order: 40,
+    level: "paragraph",
     enabled: (o) => o.features.jinze,
     render(ctx) {
       const anyCjk = new RegExp("[" + ctx.options.ruleset.cjk + "]");
       const parents = /* @__PURE__ */ new Set();
       ctx.root.querySelectorAll("jz-char").forEach((c) => {
+        if (!ctx.finder.levelAllows(c, "paragraph")) {
+          return;
+        }
         if (c.parentNode) {
           parents.add(c.parentNode);
         }
@@ -1004,6 +1057,9 @@ var Juzhen = (() => {
       (c) => finder.inScope(c) && !finder.isAvoided(c)
     );
     for (const el of chars) {
+      if (!finder.levelAllows(el, "paragraph")) {
+        continue;
+      }
       if (!finder.featureEnabledFor(el, "jiya")) {
         continue;
       }
@@ -1032,6 +1088,7 @@ var Juzhen = (() => {
     name: "jiyaLineEdge",
     kind: "standalone",
     order: 90,
+    level: "paragraph",
     enabled: (o) => o.features.jiya,
     render(ctx) {
       if (!hasLayout()) {
@@ -1047,7 +1104,7 @@ var Juzhen = (() => {
   var TRIM = "jz-hws-trim";
   function trimGaps(root, finder) {
     const gaps = Array.from(root.querySelectorAll("jz-hws")).filter(
-      (g) => finder.inScope(g) && !finder.isAvoided(g)
+      (g) => finder.inScope(g) && !finder.isAvoided(g) && finder.levelAllows(g, "paragraph")
     );
     if (!gaps.length) {
       return;
@@ -1066,6 +1123,7 @@ var Juzhen = (() => {
     name: "spacingGapTrim",
     kind: "standalone",
     order: 92,
+    level: "paragraph",
     enabled: (o) => o.features.spacing,
     render(ctx) {
       if (!hasLayout()) {
@@ -1096,6 +1154,7 @@ var Juzhen = (() => {
     name: PASS3,
     kind: "charify",
     order: 60,
+    level: "paragraph",
     enabled: (o) => o.features.longWord,
     collect(node, ctx) {
       if (inLangSpan(node)) {
@@ -1347,6 +1406,7 @@ var Juzhen = (() => {
     name: PASS4,
     kind: "standalone",
     order: 50,
+    level: "text",
     enabled: (o) => o.features.spacing,
     render(ctx) {
       const { finder, options } = ctx;
@@ -1357,6 +1417,9 @@ var Juzhen = (() => {
         }
         processBlock(block, finder, R);
       });
+      if (!options.finder.blockTags.has(ctx.root.nodeName) && finder.featureEnabledFor(ctx.root, PASS4) && finder.inScope(ctx.root) && !finder.isAvoided(ctx.root)) {
+        processBlock(ctx.root, finder, R);
+      }
       processPills(ctx.root, finder, options.finder.pillSelector, R.pillNeighbor);
     },
     revert(ctx) {
@@ -1551,6 +1614,7 @@ var Juzhen = (() => {
       ruleset: resolveRuleset(opts.charClass),
       autospaceClass: opts.autospaceClass || "",
       justifyAtoms: opts.justifyAtoms === false ? false : true,
+      levelText: opts.level && opts.level.text || null,
       scope: {
         root: scope.root || null,
         include: scope.include || null,

dist/juzhen.mjs

@@ -9,9 +9,11 @@ var Finder = class {
     this.pillSelector = opts.finder.pillSelector;
     this.skipAttr = opts.finder.skipAttribute;
     this.userIsSkipped = opts.finder.isSkipped;
+    this.levelTextSelector = opts.levelText;
     this.avoidSelector = opts.scope.avoid;
     this.includeSelector = opts.scope.include;
     this.featureCache = /* @__PURE__ */ new WeakMap();
+    this.levelCache = /* @__PURE__ */ new WeakMap();
   }
   /** 該元素是否匹配 pill 選擇器（行內塊，如 code/kbd）。 */
   pillMatches(el) {
@@ -231,6 +233,48 @@ var Finder = class {
       p = pe.parentNode;
     }
   }
+  /**
+   * 節點之功能級別（§6.5.0a）。自 node 向上找**最近**之顯式信號：元素屬性
+   * `data-jz-level="text|paragraph"`（最優先），或命中 `level.text` 選擇器（→ text）；
+   * 皆無則預設 paragraph（全功能）。結果以解析後之元素為鍵快取。
+   */
+  levelFor(node) {
+    const start = node.nodeType === 1 ? node : node.parentElement;
+    if (!start) {
+      return "paragraph";
+    }
+    const cached = this.levelCache.get(start);
+    if (cached) {
+      return cached;
+    }
+    let el = start;
+    let result = "paragraph";
+    while (el) {
+      const attr = el.getAttribute ? el.getAttribute("data-jz-level") : null;
+      if (attr === "text" || attr === "paragraph") {
+        result = attr;
+        break;
+      }
+      if (this.levelTextSelector && el.matches && el.matches(this.levelTextSelector)) {
+        result = "text";
+        break;
+      }
+      el = el.parentElement;
+    }
+    this.levelCache.set(start, result);
+    return result;
+  }
+  /**
+   * 某級別之 pass 是否可作用於該節點（§6.5.0a gate）。文本級 pass 不受限（恆 true）；
+   * 段落級 pass 僅作用於段落級元素（text-level 子樹跳過）。與 featureEnabledFor 疊加：
+   * level 為粗粒度語義組（先判），blocks／屬性為細粒度逐功能（後調）。
+   */
+  levelAllows(node, passLevel) {
+    if (passLevel === "text") {
+      return true;
+    }
+    return this.levelFor(node) === "paragraph";
+  }
   /**
    * 解析節點對某功能之有效啟用狀態（§3.6，per-node 閘）。向上找最近帶
    * 功能指令之祖先（data-juzhen 白名單 / data-juzhen-off 黑名單 / 命中
@@ -303,6 +347,9 @@ function runCharify(passes, ctx) {
   ctx.finder.eachTextNode(ctx.root, (node) => {
     let requests = [];
     for (const p of passes) {
+      if (!ctx.finder.levelAllows(node, p.level)) {
+        continue;
+      }
       const got = p.collect(node, ctx);
       if (got.length > 0) {
         requests = requests.concat(got);
@@ -637,6 +684,7 @@ var jiyaPass = {
   name: PASS,
   kind: "charify",
   order: 20,
+  level: "text",
   enabled: (o) => o.features.jiya,
   collect(node, ctx) {
     if (inJzChar(node)) {
@@ -690,6 +738,7 @@ var jiyaAdjacencyPass = {
   name: "jiyaAdjacency",
   kind: "standalone",
   order: 25,
+  level: "text",
   enabled: (o) => o.features.jiya,
   render(ctx) {
     const { finder, options } = ctx;
@@ -862,11 +911,15 @@ var jinzePass = {
   name: PASS2,
   kind: "standalone",
   order: 40,
+  level: "paragraph",
   enabled: (o) => o.features.jinze,
   render(ctx) {
     const anyCjk = new RegExp("[" + ctx.options.ruleset.cjk + "]");
     const parents = /* @__PURE__ */ new Set();
     ctx.root.querySelectorAll("jz-char").forEach((c) => {
+      if (!ctx.finder.levelAllows(c, "paragraph")) {
+        return;
+      }
       if (c.parentNode) {
         parents.add(c.parentNode);
       }
@@ -976,6 +1029,9 @@ function relayout(root, finder) {
     (c) => finder.inScope(c) && !finder.isAvoided(c)
   );
   for (const el of chars) {
+    if (!finder.levelAllows(el, "paragraph")) {
+      continue;
+    }
     if (!finder.featureEnabledFor(el, "jiya")) {
       continue;
     }
@@ -1004,6 +1060,7 @@ var lineEdgePass = {
   name: "jiyaLineEdge",
   kind: "standalone",
   order: 90,
+  level: "paragraph",
   enabled: (o) => o.features.jiya,
   render(ctx) {
     if (!hasLayout()) {
@@ -1019,7 +1076,7 @@ var lineEdgePass = {
 var TRIM = "jz-hws-trim";
 function trimGaps(root, finder) {
   const gaps = Array.from(root.querySelectorAll("jz-hws")).filter(
-    (g) => finder.inScope(g) && !finder.isAvoided(g)
+    (g) => finder.inScope(g) && !finder.isAvoided(g) && finder.levelAllows(g, "paragraph")
   );
   if (!gaps.length) {
     return;
@@ -1038,6 +1095,7 @@ var gapTrimPass = {
   name: "spacingGapTrim",
   kind: "standalone",
   order: 92,
+  level: "paragraph",
   enabled: (o) => o.features.spacing,
   render(ctx) {
     if (!hasLayout()) {
@@ -1068,6 +1126,7 @@ var longWordPass = {
   name: PASS3,
   kind: "charify",
   order: 60,
+  level: "paragraph",
   enabled: (o) => o.features.longWord,
   collect(node, ctx) {
     if (inLangSpan(node)) {
@@ -1319,6 +1378,7 @@ var spacingPass = {
   name: PASS4,
   kind: "standalone",
   order: 50,
+  level: "text",
   enabled: (o) => o.features.spacing,
   render(ctx) {
     const { finder, options } = ctx;
@@ -1329,6 +1389,9 @@ var spacingPass = {
       }
       processBlock(block, finder, R);
     });
+    if (!options.finder.blockTags.has(ctx.root.nodeName) && finder.featureEnabledFor(ctx.root, PASS4) && finder.inScope(ctx.root) && !finder.isAvoided(ctx.root)) {
+      processBlock(ctx.root, finder, R);
+    }
     processPills(ctx.root, finder, options.finder.pillSelector, R.pillNeighbor);
   },
   revert(ctx) {
@@ -1523,6 +1586,7 @@ function normalizeOptions(opts = {}) {
     ruleset: resolveRuleset(opts.charClass),
     autospaceClass: opts.autospaceClass || "",
     justifyAtoms: opts.justifyAtoms === false ? false : true,
+    levelText: opts.level && opts.level.text || null,
     scope: {
       root: scope.root || null,
       include: scope.include || null,

dist/types.d.ts

@@ -37,6 +37,14 @@ export interface JuzhenOptions {
     /** 自定義字符分類（擴充內置規則集）。把未分類字符或新符號歸入中文／西文／
      *  全寬標點各子類，以覆寫 spacing／jiya 等規則之分類判定（追加語義）。 */
     charClass?: CharClassOverride;
+    /** 功能分級標記（§6.5.0a）。段落級功能（禁則／行端／懸掛／垂懸字／長詞斷字）
+     *  僅作用於段落級元素；文本級功能（中西間隙／標點擠壓）任意文本皆適用。
+     *  - `text`：選擇器，命中之子樹**僅文本級**（標題／按鈕／UI 文字典型）；亦可
+     *    經元素屬性 `data-jz-level="text"`／`"paragraph"` 標記（屬性優先、最近祖先勝）。
+     *  預設：塊級元素（blockTags）→ 段落級（全功能）。 */
+    level?: {
+        text?: string;
+    };
     /** 間隙標記沿用之 class（v1 相容；預設無額外 class）。 */
     autospaceClass?: string;
     /** justify 原子化：jz-char／jz-jinze 是否以 inline-block 作對齊單一原子
@@ -74,6 +82,8 @@ export interface ResolvedOptions {
     ruleset: Ruleset;
     autospaceClass: string;
     justifyAtoms: boolean;
+    /** 功能分級之 text-level 選擇器（§6.5.0a）；null 表示未設。 */
+    levelText: string | null;
     scope: {
         root: Element | string | null;
         include: string | null;
@@ -126,10 +136,14 @@ export interface WrapRequest {
 }
 /** pass 種類。 */
 export type PassKind = "charify" | "standalone";
+/** 功能分級（§6.5.0a）：text＝任意文本片段皆適用；paragraph＝需行／段布局。 */
+export type FeatureLevel = "text" | "paragraph";
 interface BasePass {
     name: string;
     order: number;
     kind: PassKind;
+    /** 功能分級（§6.5.0a）。paragraph 級 pass 對 text-level 元素自動跳過。 */
+    level: FeatureLevel;
     enabled: (options: ResolvedOptions) => boolean;
     revert: (ctx: RenderContext) => void;
 }