admin
c5a503580c
承 Tier1（S2+S3，已於 main 168e9e7）。本批為效能第二層＋第三層，全程獨立複驗（差分/往返/ 增量≡全量/進程隔離測速/真瀏覽器）＋4 份真人撰寫真實文檔驗收，行為保真、提速真實。 掃描層（無狀態、保行為）： - 中間發現＋S4：insidePill／isAvoided 之「逐文本節點沿祖先鏈」以 ancestorOrSelfPill／…Avoided 迭代回填記憶化（每元素恰算一次、兄弟共用祖先鏈快取），O(文本×depth)→O(元素)。實測掃描層 el.matches() 累計約降五成；深嵌套 render 進程隔離墻鐘 pre-Tier1 707ms→254ms（2.8×）。 佈局層（僅瀏覽器、正確性敏感）： - S1 gapTrim 對齊門：尾隨 margin 僅在右緣 flush 之對齊可見，唯 left／start(ltr) 之 ragged 右緣 可整批跳過，省其 O(gaps) 次同步重排。實測非兩端對齊內容 gapTrim 數千 ms→數十 ms；justify／ center／right／RTL 保留完整逐一定案、行為不變（真瀏覽器差分：justify trim 集指紋逐位相同）。 增量恢復（第三層，向下兼容 API）： - C1 持久化 Finder：跨 render 復用元素鍵快取（category／level／feature／祖先游走）。正確性靠 失效：新增 finder.invalidate(el) 清整棵子樹快取（祖先屬性變則後代快取變脏），revert 自動失效 其子樹（安全預設）。 - C3 rerender(root)＝revert+render；局部恢復（實測編輯 400 段中一段 766×、matches 1441×）。 - C2 observe/disconnect：MutationObserver 自動增量——內容/分類屬性變化重處理最近塊、新增之塊 直接 render；render/revert 期間暫停觀察，自身注入絕不自觸發。 - append 修復（IV-3 差分複驗發現、單測漏掉）：向葉塊（帶 jz-orphan）追加子塊使其轉非葉，須撤 容器陳舊 orphan——追加塊時若塊級父有 jz-orphan 直接子則改重處理該父。 測試 130→140（+S2 非葉塊、C1/C3、C2 觀察/失效/append、不自觸發）。基準設施：bench-incremental （增量恢復）、bench-layout（版面層，headless Chrome）。dist 重建。
28 lines
1.9 KiB
TypeScript
28 lines
1.9 KiB
TypeScript
import type { JuzhenOptions, Pass, ResolvedOptions } from "./types.js";
|
||
export type { JuzhenOptions, ResolvedOptions, Pass };
|
||
export type { CharClassOverride, BdSubclass, Ruleset, Bias, BiasTable } from "./types.js";
|
||
/** 正規化公開選項為內部 ResolvedOptions。 */
|
||
export declare function normalizeOptions(opts?: JuzhenOptions): ResolvedOptions;
|
||
export interface Juzhen {
|
||
render(root?: Element | string): void;
|
||
revert(root?: Element | string): void;
|
||
/** revert 後重新 render 同一（子）樹（C3 增量便利）；等價於 revert(root) + render(root)。
|
||
* 頁面局部變化後，對受影響之最近塊調用即可只重處理該子樹、免全樹重掃。 */
|
||
rerender(root?: Element | string): void;
|
||
/** 清除該（子）樹之內部元素快取（C1）。**revert 已自動失效其子樹**，故僅在「改了既有元素之
|
||
* 分類相關屬性（class／data-jz-*／lang 等）但不走 revert」時才需顯式調用，以免下次 render
|
||
* 沿用陳舊分類。內容（子節點／文本）變化不改分類、無需 invalidate（但須 revert+render 該塊
|
||
* 方能重處理）。 */
|
||
invalidate(root?: Element | string): void;
|
||
/** 開始觀察 root 子樹之 DOM 變化（C2 增量模式，opt-in）：內容／分類屬性變化時自動只重處理
|
||
* 受影響之最近塊（revert+render），新增之塊直接 render——免消費端手動 rerender 或全樹重掃。
|
||
* **juzhen 自身之變更**（jz-* 注入、data-jz* 屬性）於處理期間暫停觀察、絕不自觸發。需
|
||
* MutationObserver（瀏覽器／jsdom 有；無則 no-op）。重複 observe 前自動 disconnect 前者。 */
|
||
observe(root?: Element | string): void;
|
||
/** 停止 C2 觀察。 */
|
||
disconnect(): void;
|
||
readonly options: ResolvedOptions;
|
||
}
|
||
/** 建立一個聚珍實例。 */
|
||
export declare function createJuzhen(opts?: JuzhenOptions): Juzhen;
|