@file-viewer/docx 0.3.33 → 0.3.34

package/dist/document/section.d.ts

@@ -0,0 +1,82 @@
+import { XmlParser } from "../parser/xml-parser";
+import { Borders } from "./border";
+import { Length } from "./common";
+import { NoteProperties } from "../notes/properties";
+export interface Column {
+    space: Length;
+    width: Length;
+}
+export interface Columns {
+    space: Length;
+    numberOfColumns: number;
+    separator: boolean;
+    equalWidth: boolean;
+    columns: Column[];
+}
+export interface PageSize {
+    width: Length;
+    height: Length;
+    orientation: "landscape" | string;
+}
+export interface PageNumber {
+    start: number;
+    chapSep: "colon" | "emDash" | "endash" | "hyphen" | "period" | string;
+    chapStyle: string;
+    format: "none" | "cardinalText" | "decimal" | "decimalEnclosedCircle" | "decimalEnclosedFullstop" | "decimalEnclosedParen" | "decimalZero" | "lowerLetter" | "lowerRoman" | "ordinalText" | "upperLetter" | "upperRoman" | string;
+}
+export interface PageMargins {
+    top: Length;
+    right: Length;
+    bottom: Length;
+    left: Length;
+    header: Length;
+    footer: Length;
+    gutter: Length;
+}
+export interface DocumentGrid {
+    type: "default" | "lines" | "linesAndChars" | "snapToChars" | string;
+    linePitch: Length;
+    /**
+     * CSS letter-spacing approximation for w:docGrid@charSpace.
+     *
+     * OOXML stores the delta from the Normal-style character pitch in
+     * 1/4096 point units. This is a point delta, not an em value.
+     */
+    charSpace: Length;
+    /** Raw Open XML value: desired character pitch delta multiplied by 4096. */
+    charSpaceRaw: number;
+}
+export declare enum SectionType {
+    Continuous = "continuous",
+    NextPage = "nextPage",
+    NextColumn = "nextColumn",
+    EvenPage = "evenPage",
+    OddPage = "oddPage"
+}
+export declare function isSectionPageBreak(type: string): boolean;
+export declare function isSectionColumnBreak(type: string): boolean;
+export interface FooterHeaderReference {
+    id: string;
+    type: string | "first" | "even" | "default";
+}
+export interface SectionProperties {
+    type: SectionType | string;
+    pageSize: PageSize;
+    pageMargins: PageMargins;
+    pageBorders: Borders;
+    pageNumber: PageNumber;
+    columns: Columns;
+    docGrid: DocumentGrid;
+    footerRefs: FooterHeaderReference[];
+    headerRefs: FooterHeaderReference[];
+    titlePage: boolean;
+    footnoteProps?: NoteProperties;
+    endnoteProps?: NoteProperties;
+}
+/**
+ * Word applies page geometry even when generated DOCX files omit all or part
+ * of sectPr/pgSz/pgMar. Resolve those application defaults in the document
+ * model so main-thread and Worker rendering share the same behavior without
+ * rewriting the original OOXML package.
+ */
+export declare function parseSectionProperties(elem?: Element, xml?: XmlParser): SectionProperties;

package/dist/document/style.d.ts

@@ -0,0 +1,21 @@
+import { ParagraphProperties } from "./paragraph";
+import { RunProperties } from "./run";
+export interface IDomStyle {
+    id: string;
+    name?: string;
+    cssName?: string;
+    aliases?: string[];
+    target: string;
+    basedOn?: string;
+    isDefault?: boolean;
+    styles: IDomSubStyle[];
+    linked?: string;
+    next?: string;
+    paragraphProps: ParagraphProperties;
+    runProps: RunProperties;
+}
+export interface IDomSubStyle {
+    target: string;
+    mod?: string;
+    values: Record<string, string>;
+}

package/dist/document/symbol-encoding.d.ts

@@ -0,0 +1,28 @@
+/*! @license Adobe Symbol Encoding to Unicode
+ *  Copyright (c) 1991-2011 Unicode, Inc. All Rights reserved.
+ *
+ *  This file is provided as-is by Unicode, Inc. (The Unicode Consortium). No
+ *  claims are made as to fitness for any particular purpose. No warranties of
+ *  any kind are expressed or implied. The recipient agrees to determine
+ *  applicability of information provided. If this file has been provided on
+ *  magnetic media by Unicode, Inc., the sole remedy for any claim will be
+ *  exchange of defective media within 90 days of receipt.
+ *
+ *  Unicode, Inc. hereby grants the right to freely use the information
+ *  supplied in this file in the creation of products supporting the
+ *  Unicode Standard, and to make copies of this file in any form for
+ *  internal or external distribution as long as this notice remains
+ *  attached.
+ *
+ * Source: https://www.unicode.org/Public/MAPPINGS/VENDORS/ADOBE/symbol.txt
+ */
+export interface DecodedSymbol {
+    text: string;
+    normalized: boolean;
+}
+/**
+ * w:sym selects a font-specific character, including Word's F000 byte offset.
+ * Resolve known Symbol encoding slots to their Unicode glyph so missing legacy
+ * symbol fonts do not turn authored marks into private-use tofu.
+ */
+export declare function decodeWordSymbol(font: string, code: number): DecodedSymbol;

package/dist/document-parser.d.ts

@@ -0,0 +1,156 @@
+import { DomType, WmlTable, IDomNumbering, WmlHyperlink, WmlSmartTag, IDomImage, IDomShape, OpenXmlElement, WmlTableColumn, WmlTableCell, WmlTableRow, NumberingPicBullet, WmlAltChunk, IDomChart, IDomSmartArt, IDomInk, IDomRuby } from './document/dom';
+import { DocumentElement } from './document/document';
+import { WmlParagraph } from './document/paragraph';
+import { WmlRun } from './document/run';
+import { IDomStyle, IDomSubStyle } from './document/style';
+import { WmlFieldSimple } from './document/fields';
+/**
+ * "auto" 颜色的解析结果。使用 CSS 变量而不是字面量 "black"，
+ * 这样暗色模式只需在渲染层改变变量值，无需重新解析文档。
+ * 变量未定义时（例如未启用暗色模式）回退到原有的 black 字面量，行为与之前完全一致。
+ */
+export declare var autos: {
+    shd: string;
+    color: string;
+    borderColor: string;
+    highlight: string;
+};
+/** XML 到内部 DOM 的解析选项，决定宽度保留、调试日志和修订内容处理。 */
+export interface DocumentParserOptions {
+    exposeDisplayTargets?: boolean;
+    ignoreWidth: boolean;
+    debug: boolean;
+    hideWebHiddenContent: boolean;
+    renderChanges?: boolean;
+    reviewMode?: "final" | "original" | "simple" | "all" | "auto";
+}
+/**
+ * DOCX XML 解析器。
+ * 它把 WordprocessingML 的 body、段落、run、表格、图片、字段等节点转换为渲染器可消费的内部 DOM。
+ */
+export declare class DocumentParser {
+    private readonly paragraphAddress;
+    /** 当前解析策略；构造时会与默认值合并，后续方法都从这里读取兼容开关。 */
+    options: DocumentParserOptions;
+    constructor(options?: Partial<DocumentParserOptions>);
+    parseNotes(xmlDoc: Element, elemName: string, elemClass: any): any[];
+    parseComments(xmlDoc: Element): any[];
+    /** 解析主文档 word/document.xml，输出包含正文和节属性的根节点。 */
+    parseDocumentFile(xmlDoc: Element): DocumentElement;
+    parseBackground(elem: Element): any;
+    /** 解析 body/header/footer/comment 等容器内的块级元素。 */
+    parseBodyElements(element: Element): OpenXmlElement[];
+    /** 解析 styles.xml 中的样式定义，并保留继承关系供渲染阶段合并。 */
+    parseStylesFile(xstyles: Element): IDomStyle[];
+    parseDefaultStyles(node: Element): IDomStyle;
+    parseStyle(node: Element): IDomStyle;
+    parseTableStyle(node: Element): IDomSubStyle[];
+    parseNumberingFile(node: Element): IDomNumbering[];
+    cloneNumberingLevel(level: IDomNumbering, id: string): IDomNumbering;
+    parseNumberingPicBullet(elem: Element): NumberingPicBullet;
+    parseAbstractNumbering(node: Element, bullets: any[]): IDomNumbering[];
+    parseNumberingLevel(id: string, node: Element, bullets: any[]): IDomNumbering;
+    parseSdt(node: Element, parser: Function): OpenXmlElement[];
+    parseInserted(node: Element, parentParser: Function): OpenXmlElement;
+    parseDeleted(node: Element, parentParser: Function): OpenXmlElement;
+    parseRevision(type: DomType.Inserted | DomType.Deleted, node: Element, parentParser: Function, kind?: "insert" | "delete" | "move-from" | "move-to"): OpenXmlElement;
+    parseAltChunk(node: Element): WmlAltChunk;
+    /** 解析单个段落，合并 pPr、run、超链接、书签、批注和复杂字段。 */
+    parseParagraph(node: Element): OpenXmlElement;
+    parseParagraphProperties(elem: Element, paragraph: WmlParagraph): void;
+    parseFrame(node: Element, paragraph: WmlParagraph): void;
+    parseHyperlink(node: Element, parent?: OpenXmlElement): WmlHyperlink;
+    parseSmartTag(node: Element, parent?: OpenXmlElement): WmlSmartTag;
+    parseSimpleField(node: Element, parent?: OpenXmlElement): WmlFieldSimple;
+    /** 解析文本 run，将文本、制表符、换行、图片、字段和 run 属性收集到同一节点下。 */
+    parseRun(node: Element, parent?: OpenXmlElement): WmlRun;
+    parseRuby(elem: Element): IDomRuby;
+    parseRubyContent(elem: Element, type: DomType.RubyBase | DomType.RubyText): OpenXmlElement;
+    parseMathElement(elem: Element): OpenXmlElement | null;
+    hasVisibleMathContent(elem: OpenXmlElement): boolean;
+    parseMathProperies(elem: Element): Record<string, any>;
+    parseRunProperties(elem: Element, run: WmlRun): void;
+    parseVmlPicture(elem: Element): OpenXmlElement;
+    checkAlternateContent(elem: Element): Element;
+    /** 解析 DrawingML 图片/形状/图表/SmartArt，并处理浮动定位与环绕方式。 */
+    parseDrawing(node: Element): OpenXmlElement;
+    parseDrawingWrapper(node: Element): OpenXmlElement;
+    /** Map explicit column/paragraph offsets onto the float exclusion box. */
+    applyDrawingFloatOffsets(drawing: OpenXmlElement, wrapper: Element): OpenXmlElement;
+    parseWrapPolygon(elem: Element): string;
+    parseGraphic(elem: Element): OpenXmlElement;
+    parseDrawingContainer(elem: Element, parentTransform?: any): IDomShape;
+    parseDmlGroupTransform(elem: Element, parentTransform?: any): any;
+    parseDmlPositionedPicture(elem: Element, transform?: any): IDomImage;
+    parseDmlPositionedShape(elem: Element, transform?: any): IDomShape;
+    parseDmlShapeBounds(spPr: Element, transform?: any): {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    parseDmlFillStyle(spPr: Element): any;
+    parseDmlLineStyle(line: Element): any;
+    parseDmlCustomGeometry(geom: Element): any;
+    parseDmlPathData(path: Element, width: number, height: number): string;
+    dmlCoord(value: string, width: number, height: number): number;
+    dmlVerticalAlign(bodyPr: Element): string;
+    applyDmlTextInsets(bodyPr: Element, cssStyle: Record<string, string>): void;
+    parseDmlTextBoxProperties(bodyPr: Element): Record<string, any>;
+    emuToPt(value: number): number;
+    pt(value: number): string;
+    parseChartReference(elem: Element): IDomChart;
+    parseSmartArtReference(elem: Element): IDomSmartArt;
+    parseInkReference(elem: Element): IDomInk;
+    parseGraphicPlaceholder(label: string): IDomShape;
+    parseWordprocessingShape(elem: Element): IDomShape;
+    parseDmlShapeProperties(elem: Element, style: Record<string, string>): void;
+    parseDmlColor(elem: Element): string;
+    resolveDmlSchemeColor(value: string): string;
+    dmlSchemeColorFallback(value: string): string;
+    applyDmlColorTransforms(elem: Element, color: string): string;
+    findDescendant(elem: Element, localName: string): Element;
+    parsePicture(elem: Element): IDomImage;
+    /** 解析表格结构，包含 tblPr、tblGrid、tr、tc、合并单元格和嵌套内容。 */
+    parseTable(node: Element): WmlTable;
+    parseTableColumns(node: Element): WmlTableColumn[];
+    parseTableProperties(elem: Element, table: WmlTable): void;
+    parseTableIndentation(node: Element): string;
+    parseTablePosition(node: Element, table: WmlTable): void;
+    parseTableRow(node: Element): WmlTableRow;
+    /**
+     * Older producers such as Apache POI may emit the deprecated hMerge form
+     * instead of gridSpan. Normalize each valid restart/continue run so every
+     * later table-layout stage sees the same grid model.
+     */
+    normalizeHorizontalMerges(cells: WmlTableCell[]): WmlTableCell[];
+    parseTableRowProperties(elem: Element, row: WmlTableRow): void;
+    parseTableCell(node: Element): OpenXmlElement;
+    parseTableCellProperties(elem: Element, cell: WmlTableCell): void;
+    addStructuralRevision(element: OpenXmlElement, node: Element, kind: "insert" | "delete"): void;
+    addFormatRevision(element: OpenXmlElement, node: Element, kind: string, currentPropertiesNode?: Element): void;
+    captureFormatProperties(node?: Element): Record<string, string>;
+    serializeFormatProperty(node: Element): string;
+    revisionMetadata(node: Element, kind: string): {
+        id: string;
+        author: string;
+        date: string;
+        kind: string;
+    };
+    parseTableCellVerticalText(elem: Element, cell: WmlTableCell): void;
+    parseDefaultProperties(elem: Element, style?: Record<string, string>, childStyle?: Record<string, string>, handler?: (prop: Element) => boolean): Record<string, string>;
+    parseFitText(node: Element, style: Record<string, string>): void;
+    parseEastAsianLayout(node: Element, style: Record<string, string>): void;
+    parseUnderline(node: Element, style: Record<string, string>): void;
+    parseFont(node: Element, style: Record<string, string>, languages?: {
+        latin?: string;
+        eastAsia?: string;
+        bidi?: string;
+    }): void;
+    scriptThemeFontValue(value: string, language: string): string;
+    parseIndentation(node: Element, style: Record<string, string>): void;
+    parseSpacing(node: Element, style: Record<string, string>): void;
+    parseMarginProperties(node: Element, output: Record<string, string>): void;
+    parseTrHeight(node: Element, output: Record<string, string>): void;
+    parseBorderProperties(node: Element, output: Record<string, string>): void;
+}

package/dist/document-props/core-props-part.d.ts

@@ -0,0 +1,6 @@
+import { Part } from "../common/part";
+import { CorePropsDeclaration } from "./core-props";
+export declare class CorePropsPart extends Part {
+    props: CorePropsDeclaration;
+    parseXml(root: Element): void;
+}

package/dist/document-props/core-props.d.ts

@@ -0,0 +1,12 @@
+import { XmlParser } from "../parser/xml-parser";
+export interface CorePropsDeclaration {
+    title: string;
+    description: string;
+    subject: string;
+    creator: string;
+    keywords: string;
+    language: string;
+    lastModifiedBy: string;
+    revision: number;
+}
+export declare function parseCoreProps(root: Element, xmlParser: XmlParser): CorePropsDeclaration;

package/dist/document-props/custom-props-part.d.ts

@@ -0,0 +1,6 @@
+import { Part } from "../common/part";
+import { CustomProperty } from "./custom-props";
+export declare class CustomPropsPart extends Part {
+    props: CustomProperty[];
+    parseXml(root: Element): void;
+}

package/dist/document-props/custom-props.d.ts

@@ -0,0 +1,8 @@
+import { XmlParser } from "../parser/xml-parser";
+export interface CustomProperty {
+    formatId: string;
+    name: string;
+    type: string;
+    value: string;
+}
+export declare function parseCustomProps(root: Element, xml: XmlParser): CustomProperty[];

package/dist/document-props/extended-props-part.d.ts

@@ -0,0 +1,6 @@
+import { Part } from "../common/part";
+import { ExtendedPropsDeclaration } from "./extended-props";
+export declare class ExtendedPropsPart extends Part {
+    props: ExtendedPropsDeclaration;
+    parseXml(root: Element): void;
+}

package/dist/document-props/extended-props.d.ts

@@ -0,0 +1,14 @@
+import { XmlParser } from "../parser/xml-parser";
+export interface ExtendedPropsDeclaration {
+    template: string;
+    totalTime: number;
+    pages: number;
+    words: number;
+    characters: number;
+    application: string;
+    lines: number;
+    paragraphs: number;
+    company: string;
+    appVersion: string;
+}
+export declare function parseExtendedProps(root: Element, xmlParser: XmlParser): ExtendedPropsDeclaration;

package/dist/docx-preview-esm.d.mts

@@ -0,0 +1,3 @@
+import * as docx from './docx-preview.js';
+export * from './docx-preview.js';
+export default docx;

package/dist/docx-preview-worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/docx-preview.d.ts

@@ -1,33 +1,82 @@
+import { h } from './html';
+import type { ReviewModeOption } from './review';
+export { collectDocxReviewChanges, resolveDocxReviewState, setDocxReviewMode } from './review';
+export type { ReviewChange, ReviewChangeKind, ReviewChangePresentation, ReviewFormatChange, ReviewMode, ReviewModeOption } from './review';
+/** DOCX 解析和渲染的总配置，业务侧通常只需要覆盖其中少量字段。 */
 export interface Options {
     /** Emit read-only part/paragraph identities for independent display adapters. Off by default. */
     exposeDisplayTargets?: boolean;
     inWrapper: boolean;
     hideWrapperOnPrint: boolean;
     ignoreWidth: boolean;
+    /** In flow mode, Word page height is still preserved as a visual min-height. */
     ignoreHeight: boolean;
+    /** Keep print-layout pages at an exact Word page height. Disable to use Word page height as min-height. */
     fixedPageHeight: boolean;
     ignoreFonts: boolean;
     breakPages: boolean;
+    /**
+     * Enables the stricter Word-layout compatibility path. The renderer uses measured
+     * post-render pagination, tries to split oversized paragraphs/tables instead of
+     * leaving them overflowing, preserves widow/orphan constraints where the browser
+     * exposes enough geometry, and applies East Asian grid/kinsoku compatibility CSS.
+     */
     strictWordCompatibility: boolean;
+    /** Pixel slack tolerated by measured pagination before a page is considered overflowing. */
     paginationTolerance: number;
+    /** Safety cap for the measured pagination loop. */
     maxDynamicPaginationPasses: number;
+    /** Await fonts, images and the measured pagination pass in renderAsync before resolving. */
     awaitLayout: boolean;
+    /** Use a Web Worker for ZIP/XML parsing and relationship preloading when workerUrl is available. */
     useWorker: boolean;
+    /** URL of dist/docx-preview.worker.js or an equivalent same-origin worker bundle. */
     workerUrl?: string;
+    /** Application-owned Worker factory for strict Trusted Types/CSP deployments. */
     workerFactory?: () => Worker;
+    /** Explicit same-origin HTTP(S) or Blob JSZip URL without credentials; relative URLs resolve against the Worker script. Omit to use the bundled dependency. */
     workerJsZipUrl?: string;
+    /** Fall back to main-thread parsing if worker construction or parsing fails. */
     workerFallback: boolean;
+    /** Abort worker parsing after this many milliseconds. 0 disables the timeout. */
     workerTimeout: number;
+    /** Yield after rendering this many pages to keep the browser responsive. */
     renderPageBatchSize: number;
+    /** Yield after this many milliseconds of renderer work. */
     renderYieldEveryMs: number;
+    /** Progress hook used by demos/integrations. Not posted to workers. */
     progress?: (event: DocxProgressEvent) => void;
+    /** Runtime token issued by the sealed WASM license gate. */
     licenseToken?: unknown;
+    /**
+     * Preserve Word's stored complex-field result runs when they are present. This is the
+     * default for PAGEREF/TOC/cross-reference fields because those values are calculated by
+     * Word and saved in the document. PAGE/NUMPAGES are still refreshed after pagination.
+     */
     preserveComplexFieldResults: boolean;
+    /** Update PAGEREF fields from browser-calculated anchors instead of using Word's stored field result. */
     updatePageReferences: boolean;
+    /** Hide w:webHidden content. The print-layout renderer shows it by default because webHidden affects only web view. */
     hideWebHiddenContent: boolean;
+    /** Controls whether links that leave the rendered DOCX receive an active href. Internal bookmark links are always preserved. */
     externalLinkPolicy: "allow" | "block";
+    /**
+     * Controls whether TargetMode="External" image relationships may load HTTP(S)
+     * resources. The default is block. Package-embedded images and local data:/blob:
+     * image URLs remain available without enabling network access.
+     */
     externalResourcePolicy: "allow" | "block";
+    /**
+     * Word Online-style dark mode: every color (text, backgrounds/highlights, borders, theme
+     * colors, shape fills/strokes) is converted in CIE Lab space by inverting only the
+     * lightness channel around the "L" of #333333, keeping hue/chroma unchanged - the same
+     * lightness-inversion approach Microsoft uses for this exact purpose (see roosterjs'
+     * getDarkColor). Black becomes white, white becomes #333333, and any other color keeps its
+     * hue while becoming light enough to read on a dark page. Purely a rendering-time CSS
+     * transform; print output always reverts to the original light-mode colors.
+     */
     darkMode: boolean;
+    /** 打开后会输出兼容性警告和解析兜底信息，便于定位复杂文档问题。 */
     debug: boolean;
     experimental: boolean;
     className: string;
@@ -39,30 +88,27 @@ export interface Options {
     ignoreLastRenderedPageBreak: boolean;
     useBase64URL: boolean;
     renderChanges: boolean;
-    reviewMode?: ReviewMode;
+    /** Word-style tracked-change view. Omit to keep review preview disabled. */
+    reviewMode?: ReviewModeOption;
+    /** Keep deletion balloons by default; inline mode is available to hosts without a review rail. */
+    reviewPresentation?: "inline" | "balloon";
     renderComments: boolean;
     renderAltChunks: boolean;
-    h: (elem: any) => Node;
-}
-export type ReviewMode = "final" | "original" | "simple" | "all";
-export type ReviewChangeKind = "insert" | "delete" | "move-from" | "move-to" | "format";
-export interface ReviewChange {
-    id?: string;
-    kind: ReviewChangeKind;
-    author?: string;
-    date?: string;
-    text: string;
+    h: typeof h;
 }
+/** 解析、渲染、布局各阶段的进度事件，用于 Demo loading 或宿主侧状态提示。 */
 export interface DocxProgressEvent {
     phase: "worker" | "parse" | "render" | "layout" | "done" | string;
     current?: number;
     total?: number;
     message?: string;
 }
+/** 页面布局快照中的字段结果，主要用于 PAGE/NUMPAGES/PAGEREF 等动态域调试。 */
 export interface LayoutFieldSnapshot {
     instruction: string;
     value: string;
 }
+/** 单页渲染后的几何和内容摘要，可帮助判断分页溢出、锚点和媒体加载情况。 */
 export interface LayoutPageSnapshot {
     index: number;
     section: string;
@@ -78,19 +124,44 @@ export interface LayoutPageSnapshot {
     floats: number;
     unresolvedMedia: number;
 }
+/** 完整布局快照，记录总页数、溢出页和未解析媒体数量。 */
 export interface LayoutSnapshot {
     pageCount: number;
     overflowPages: number[];
     unresolvedMedia: number;
+    textLength: number;
+    fields: LayoutFieldSnapshot[];
+    floats: number;
     pages: LayoutPageSnapshot[];
 }
+/** 默认选项保持接近 Word 打印布局，同时允许 Worker 和动态分页提升大文档体验。 */
 export declare const defaultOptions: Options;
+/** 只解析 DOCX 包，返回 WordDocument；不会向页面写入任何 DOM。 */
 export declare function parseAsync(data: Blob | any, userOptions?: Partial<Options>): Promise<any>;
+/**
+ * Create detached document nodes. Mount the returned nodes, then call
+ * awaitRenderedLayout(container, options) when measured layout is needed.
+ * Nodes that have not been mounted do not start a background polling timer.
+ */
 export declare function renderDocument(document: any, userOptions?: Partial<Options>): Promise<any>;
+/**
+ * 一站式渲染入口：解析文件、生成 DOM、插入容器，并按需等待字体/图片/分页测量完成。
+ * Demo 和普通浏览器集成优先使用该方法。
+ */
 export declare function renderAsync(data: Blob | any, bodyContainer: HTMLElement, styleContainer?: HTMLElement, userOptions?: Partial<Options>): Promise<any>;
+/** 使用 Web Worker 完成 ZIP/XML 解析，避免大文档阻塞主线程。 */
 export declare function parseAsyncInWorker(data: Blob | any, userOptions?: Partial<Options>): Promise<any>;
+/**
+ * Wait for fonts, images, tabs, drawings and dynamic pagination before collecting
+ * diagnostics. Reject with AbortError if the container is detached; reject with
+ * Error if pagination fails or the existing pagination wait budget is exhausted.
+ */
 export declare function awaitRenderedLayout(container: HTMLElement, userOptions?: Partial<Options>): Promise<LayoutSnapshot>;
+/** Release document-scoped layout, comment and bookmark handlers on replacement/unmount. */
+export declare function disposeRenderedDocument(container: HTMLElement): void;
+/** 从当前 DOM 收集分页和媒体加载状态，不触发重新渲染。 */
 export declare function collectLayoutSnapshot(container: HTMLElement, userOptions?: Partial<Options>): LayoutSnapshot;
+/** 让 CSS counter 生成的编号继承段落首个真实 run 的字体，避免标题编号退回默认字号。 */
+export declare function syncNumberingMarkerStyles(container: HTMLElement, className?: string): void;
+/** 把长任务让回浏览器事件循环，避免连续渲染页面时 UI 卡死。 */
 export declare function yieldToBrowser(): Promise<void>;
-export declare function collectDocxReviewChanges(documentOrRoot: any): ReviewChange[];
-export declare function setDocxReviewMode(container: HTMLElement, mode: ReviewMode): boolean;