admin
c00fb3e482
下游需求：非段落／特定範圍元素用半角式（banjiao），段落用全角／開明。原標點樣式僅由 lang
決定（lang.policy／lang.style），無逐元素覆寫。新增與 data-jz-level／level.text 同構之逐元素樣式
機制（banjiao 渲染早已就緒，此為純路由、無新壓縮邏輯、無新 CSS）。
設置格式（供下游）：
・HTML 屬性：data-jz-style="banjiao|kaiming|quanjiao"——標於元素或其祖先，該子樹用此樣式。
・選項：lang: { stylePolicy: [{ selector, style }] }——如
[{ selector: "h1,h2,button,.ui", style: "banjiao" }]。
・優先序：逐元素覆寫（近祖先勝、同層屬性優先於選擇器）＞ lang.policy ＞ lang.style ＞ 內建。
實作：resolveStyle 先查 resolveStyleOverride（自身及祖先鏈掃 data-jz-style 屬性／stylePolicy
選擇器命中），無則回退 lang。屬性值非法（拼錯）則忽略、續回退。types.ts 補 lang.stylePolicy
＋導出 StyleRule；index.ts 正規化（stylePolicy 預設 []）。
冒烟三例通過（屬性 banjiao／選擇器 banjiao／屬性覆蓋選擇器）；既有 121 測試無回歸（stylePolicy
預設空、行為不變）。回歸測試＋文檔隨後補（e2e 階段）。
41 lines
2.0 KiB
TypeScript
41 lines
2.0 KiB
TypeScript
/** 標點寬度政策。 */
|
||
export type PunctStyle = "quanjiao" | "kaiming" | "banjiao";
|
||
/** 語言分類。 */
|
||
export type LangClass = "zh-Hans" | "zh-Hant" | "ja" | "other";
|
||
/** 按選擇器逐元素覆寫標點樣式之規則（§4.3；如非段落／UI 元素用半角式）。 */
|
||
export interface StyleRule {
|
||
selector: string;
|
||
style: PunctStyle;
|
||
}
|
||
export interface LocaleConfig {
|
||
/** 無 lang 祖先時之預設語言。 */
|
||
default: string;
|
||
/** 全域標點擠壓預設（全角／開明／半角）。設則覆寫內建之逐語言預設，
|
||
* 但仍可被 policy 之逐 lang 設定覆寫。未設則回退內建預設。 */
|
||
style?: PunctStyle;
|
||
/** 語言分類 → 標點寬度政策之逐 lang 覆寫。 */
|
||
policy: Partial<Record<LangClass, PunctStyle>>;
|
||
/** 按選擇器**逐元素**覆寫標點樣式（優先於 lang；與 `data-jz-style` 屬性同一機制）。
|
||
* 近祖先勝、同層屬性優先於選擇器。空／未設則不覆寫、純由 lang 決定。 */
|
||
stylePolicy?: StyleRule[];
|
||
}
|
||
/**
|
||
* 由節點向上找最近帶 lang 屬性之祖先，回傳小寫值；無則回傳 fallback。
|
||
*/
|
||
export declare function effectiveLang(node: Node, fallback: string): string;
|
||
/**
|
||
* 將 BCP-47 語言標籤歸類。前綴以子標籤邊界比對（'zh-tw' 命中 zh-Hant，
|
||
* 'zhx' 不命中 zh）。香港／台灣繁體歸 zh-Hant；含 Hant／Hans 子標籤者優先。
|
||
*/
|
||
export declare function classify(lang: string): LangClass;
|
||
/**
|
||
* 回傳該語言分類在給定 config 下之標點寬度政策。優先序：
|
||
* 逐 lang policy ＞ 全域 style ＞ 內建逐語言預設 DEFAULT_POLICY。
|
||
*/
|
||
export declare function styleFor(langClass: LangClass, config: LocaleConfig): PunctStyle;
|
||
/**
|
||
* 解析節點之有效標點樣式。優先序：**逐元素覆寫**（`data-jz-style` 屬性／`stylePolicy`
|
||
* 選擇器，近祖先勝）＞ 逐 lang `policy` ＞ 全域 `style` ＞ 內建逐語言預設。
|
||
*/
|
||
export declare function resolveStyle(node: Node, config: LocaleConfig): PunctStyle;
|