@file-viewer/docx 0.3.33 → 0.3.35

package/dist/font-table/font-table.d.ts

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

package/dist/font-table/fonts.d.ts

@@ -0,0 +1,15 @@
+import { XmlParser } from "../parser/xml-parser";
+export interface FontDeclaration {
+    name: string;
+    altName: string;
+    family: string;
+    embedFontRefs: EmbedFontRef[];
+}
+export interface EmbedFontRef {
+    id: string;
+    key: string;
+    type: 'regular' | 'bold' | 'italic' | 'boldItalic';
+}
+export declare function parseFonts(root: Element, xml: XmlParser): FontDeclaration[];
+export declare function parseFont(elem: Element, xml: XmlParser): FontDeclaration;
+export declare function parseEmbedFontRef(elem: Element, xml: XmlParser): EmbedFontRef;

package/dist/header-footer/elements.d.ts

@@ -0,0 +1,7 @@
+import { OpenXmlElementBase, DomType } from "../document/dom";
+export declare class WmlHeader extends OpenXmlElementBase {
+    type: DomType;
+}
+export declare class WmlFooter extends OpenXmlElementBase {
+    type: DomType;
+}

package/dist/header-footer/parts.d.ts

@@ -0,0 +1,18 @@
+import { OpenXmlPackage } from "../common/open-xml-package";
+import { Part } from "../common/part";
+import { DocumentParser } from "../document-parser";
+import { OpenXmlElement } from "../document/dom";
+import { WmlHeader, WmlFooter } from "./elements";
+export declare abstract class BaseHeaderFooterPart<T extends OpenXmlElement = OpenXmlElement> extends Part {
+    rootElement: T;
+    private _documentParser;
+    constructor(pkg: OpenXmlPackage, path: string, parser: DocumentParser);
+    parseXml(root: Element): void;
+    protected abstract createRootElement(): T;
+}
+export declare class HeaderPart extends BaseHeaderFooterPart<WmlHeader> {
+    protected createRootElement(): WmlHeader;
+}
+export declare class FooterPart extends BaseHeaderFooterPart<WmlFooter> {
+    protected createRootElement(): WmlFooter;
+}

package/dist/html-renderer.d.ts

@@ -0,0 +1,567 @@
+import { LayoutGeneration } from './layout-readiness';
+import { AnchorPosition } from './anchor-layout';
+import { WordDocument } from './word-document';
+import { WmlTable, IDomNumbering, WmlHyperlink, IDomImage, IDomShape, OpenXmlElement, WmlTableColumn, WmlTableCell, WmlText, WmlSymbol, WmlBreak, WmlNoteReference, WmlSmartTag, WmlAltChunk, WmlTableRow, IDomChart, IDomSmartArt, IDomInk } from './document/dom';
+import { Options } from './docx-preview';
+import { DocumentElement } from './document/document';
+import { ParagraphTab, WmlParagraph } from './document/paragraph';
+import { FontTablePart } from './font-table/font-table';
+import { FooterHeaderReference, SectionProperties } from './document/section';
+import { WmlRun } from './document/run';
+import { WmlFieldChar, WmlFieldSimple } from './document/fields';
+import { WmlBookmarkStart } from './document/bookmarks';
+import { IDomStyle } from './document/style';
+import { WmlBaseNote, WmlFootnote } from './notes/elements';
+import { ThemePart } from './theme/theme-part';
+import { DmlFormInfo } from './theme/theme';
+import { Part } from './common/part';
+import { VmlElement } from './vml/vml';
+import { WmlCommentRangeStart, WmlCommentReference } from './comments/elements';
+import { h, ns } from './html';
+import { NoteKind, NoteAssignment, NoteNumbering } from './notes/properties';
+interface CellPos {
+    col: number;
+    row: number;
+}
+interface Section {
+    sectProps: SectionProperties;
+    elements: OpenXmlElement[];
+    pageBreak: boolean;
+    columnBreak?: boolean;
+    startsAfterExplicitPageBreak?: boolean;
+    endsWithExplicitPageBreak?: boolean;
+}
+interface PageHeaderFooterState {
+    headerProps: SectionProperties;
+    footerProps: SectionProperties;
+    headerId?: string;
+    footerId?: string;
+}
+interface DynamicNoteState {
+    references: HTMLElement[];
+    items: HTMLElement[];
+    fragments: Map<HTMLElement, HTMLElement[]>;
+    owners: Map<HTMLElement, HTMLElement>;
+    text: Map<HTMLElement, string>;
+    fields: Map<HTMLElement, HTMLElement[]>;
+}
+interface TocEntry {
+    level: number;
+    text: string;
+    id: string;
+}
+interface ChartSeries {
+    name: string;
+    categories: string[];
+    /** Missing or invalid cache points remain NaN so their indexes never shift. */
+    values: number[];
+}
+interface ChartAxes {
+    category: Element | null;
+    value: Element | null;
+    date1904: boolean;
+}
+interface ChartPlotOptions {
+    type?: string;
+    group?: Element;
+    seriesNodes?: Element[];
+    colorOffset?: number;
+    noLegend?: boolean;
+}
+interface VmlRenderContext {
+    originX: number;
+    originY: number;
+    offsetX: number;
+    offsetY: number;
+    scaleX: number;
+    scaleY: number;
+    width: number;
+    height: number;
+}
+interface VmlBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** Release the source-owned layout and comment bindings for this mounted render. */
+export declare function disposeRenderedLayout(container: HTMLElement): void;
+/** Await source-owned tab and drawing layout for nodes produced by renderDocument. */
+export declare function layoutRenderedDocument(container: HTMLElement, generation?: LayoutGeneration): Promise<void>;
+interface CellVerticalMerge {
+    cell: HTMLTableCellElement;
+    span: number;
+    lastRow: number;
+    bottomBorder: string;
+    bottomBorderPriority: string;
+}
+type CellVerticalMergeType = Record<number, CellVerticalMerge>;
+/**
+ * DOCX HTML 渲染器。
+ * 负责把 DocumentParser 生成的内部 DOM 转成真实 DOM 节点，并处理样式继承、分页、
+ * 页眉页脚、脚注尾注、表格合并、目录字段和浮动对象等 Word 兼容行为。
+ */
+export declare class HtmlRenderer {
+    /** 根 CSS 类名，所有生成选择器都会以它作为命名空间，避免污染宿主页面。 */
+    className: string;
+    rootSelector: string;
+    /** 当前渲染的 WordDocument，供图片、字体、关系 part 和页眉页脚按需加载。 */
+    document: WordDocument;
+    options: Options;
+    /** styleId 到样式对象的索引，渲染段落/run/表格时用于快速合并继承样式。 */
+    styleMap: Record<string, IDomStyle>;
+    currentPart: Part;
+    currentSectionProps: SectionProperties;
+    currentPageNumber: number;
+    currentSectionNumber: number;
+    currentSectionPageNumber: number;
+    totalPages: number;
+    sectionPageCount: number;
+    /** 表格纵向合并状态栈，用来把 Word 的 vMerge 转换成 HTML rowspan。 */
+    tableVerticalMerges: CellVerticalMergeType[];
+    currentVerticalMerge: CellVerticalMergeType;
+    tableCellPositions: CellPos[];
+    currentCellPosition: CellPos;
+    currentTableRow: WmlTableRow;
+    private repeatedTableHeaderRows;
+    footnoteMap: Record<string, WmlFootnote>;
+    endnoteMap: Record<string, WmlFootnote>;
+    currentFootnoteIds: string[];
+    currentEndnoteIds: string[];
+    noteNumbering: NoteNumbering;
+    renderedNoteIds: Set<string>;
+    noteSectionIds: Map<SectionProperties, string>;
+    notePageIndex: number;
+    dynamicNoteState: WeakMap<HTMLElement, DynamicNoteState>;
+    noteContinuationOrigins: WeakMap<HTMLElement, HTMLElement>;
+    headerFooterModels: Map<string, OpenXmlElement>;
+    pageHeaderFooterState: WeakMap<HTMLElement, PageHeaderFooterState>;
+    defaultTabSize: string;
+    currentTabs: any[];
+    anchorLayouts: Map<string, AnchorPosition>;
+    currentParagraph: WmlParagraph;
+    currentParagraphTabIndex: number;
+    currentParagraphTabCount: number;
+    commentHighlight: any;
+    commentMap: Record<string, Range>;
+    private commentLayer;
+    private commentPresentations;
+    private renderingComment;
+    private hyperlinkDepth;
+    private static nextCommentId;
+    private layoutGenerations;
+    bookmarkTextMap: Record<string, string>;
+    bookmarkIdToName: Record<string, string>;
+    /** 目录与交叉引用相关的运行时索引，渲染字段时会回填页面锚点和编号。 */
+    tocEntries: TocEntry[];
+    fieldSeqCounters: Record<string, number>;
+    fieldSetValues: Record<string, string>;
+    headingIndex: number;
+    tasks: Promise<any>[];
+    postRenderTasks: any[];
+    h: typeof h;
+    /**
+     * 暗色模式下，任意字面量颜色（非 --docx-*-color 主题/auto 变量）都会被包装成
+     * `var(--docx-dm-N, 暗色值)`：正常屏幕下该变量未定义，直接退回暗色值；
+     * 打印时统一在 .className 根选择器上把这些变量重新定义为浅色原值（见
+     * renderDarkModePrintReset()），这样无论颜色来自内联样式还是 styles.xml/编号
+     * 样式表，打印永远还原成 Word 文档本身的颜色，不需要逐元素处理。
+     */
+    darkModeVarNames: Map<string, string>;
+    darkModePrintReset: Record<string, string>;
+    /** 渲染入口：生成样式节点、页面节点，并等待异步图片/字体任务完成。 */
+    render(document: WordDocument, options: Options): Promise<Node[]>;
+    renderTheme(themePart: ThemePart): Node[];
+    documentThemeLanguages(): {
+        latin: string;
+        eastAsia: string;
+        bidi: string;
+    };
+    addThemeScriptFontVariables(variables: Record<string, string>, size: "major" | "minor", font: DmlFormInfo): void;
+    themeFontFamily(font: DmlFormInfo, slot: "latin" | "eastAsia" | "complexScript", language: string, scriptOverride?: string): string;
+    renderFontTable(fontsPart: FontTablePart): Promise<any[]>;
+    processStyleName(className: string): string;
+    /** 处理样式继承链，并为每个 styleId 生成稳定 CSS class。 */
+    processStyles(styles: IDomStyle[]): Record<any, IDomStyle>;
+    prodessNumberings(numberings: IDomNumbering[]): void;
+    processElement(element: OpenXmlElement | null | undefined): void;
+    /** 预处理表格：补齐首末行/列、奇偶带状样式、继承单元格边框和内边距。 */
+    processTable(table: WmlTable): void;
+    /** 扫描书签、标题和目录候选项，为 TOC/PAGEREF 等字段建立运行时索引。 */
+    collectDocumentMetadata(document: DocumentElement): void;
+    collectTocEntries(elem: OpenXmlElement): void;
+    findFirstBookmark(elem: OpenXmlElement): WmlBookmarkStart;
+    extractText(elem: OpenXmlElement): string;
+    appendClassName(elem: OpenXmlElement, className: string): void;
+    copyStyleProperties(input: Record<string, string>, output: Record<string, string>, attrs?: string[]): Record<string, string>;
+    createPageElement(className: string, props: SectionProperties, docStyle: Record<string, any>): HTMLElement;
+    addSize(a: string, b: string): string;
+    parseCssLengthValue(value: string): number;
+    applyPageBorder(style: Record<string, string>, side: "top" | "right" | "bottom" | "left", border: any): void;
+    borderTypeToCss(type: string): "none" | "solid" | "dashed" | "dotted" | "double";
+    borderColor(color: string): string;
+    createSectionContent(props: SectionProperties): HTMLElement;
+    /** 按 Word 节属性拆分页面，并渲染页眉、正文、脚注和页脚。 */
+    renderSections(document: DocumentElement): Promise<HTMLElement[]>;
+    resolveSectionHeaderFooterReferences(sections: Section[]): void;
+    selectHeaderFooterReference(refs: FooterHeaderReference[], props: SectionProperties, page: number, firstOfSection: boolean): FooterHeaderReference;
+    renderHeaderFooter(refs: FooterHeaderReference[], props: SectionProperties, page: number, firstOfSection: boolean, into: HTMLElement): void;
+    isPageBreakElement(elem: OpenXmlElement): boolean;
+    isPageBreakSection(prev: SectionProperties, next: SectionProperties): boolean;
+    splitBySection(elements: OpenXmlElement[], defaultProps: SectionProperties): Section[];
+    hasPageBreakElement(elem: OpenXmlElement): boolean;
+    splitTableByPageBreaks(table: WmlTable): {
+        table: WmlTable;
+        breakAfter: boolean;
+    }[];
+    /** Hidden revisions stay in the model/DOM but do not contribute page breaks. */
+    isHiddenRevisionForPagination(element: OpenXmlElement): boolean;
+    hasOnlyHiddenRevisionTail(elements: OpenXmlElement[]): boolean;
+    splitElementByPageBreaks(elem: OpenXmlElement): {
+        element?: OpenXmlElement;
+        breakAfter?: boolean;
+        explicitPageBreak?: boolean;
+    }[];
+    splitParagraphByPageBreaks(paragraph: WmlParagraph): {
+        paragraph: WmlParagraph;
+        breakAfter: boolean;
+        explicitPageBreak?: boolean;
+    }[];
+    styleValuesForTarget(style: IDomStyle, target: string): Record<string, string>;
+    styleValue(style: IDomStyle, target: string, name: string): string;
+    effectiveParagraphCssValue(elem: WmlParagraph, style: IDomStyle, name: string): string;
+    isInsideTableCell(elem: OpenXmlElement): boolean;
+    paragraphUsesDocumentGrid(elem: WmlParagraph, style: IDomStyle): boolean;
+    setCssStyle(element: HTMLElement, name: string, value: string): void;
+    applyDocumentGridMinimumHeight(elem: WmlParagraph, style: IDomStyle, result: HTMLElement, linePitch: string): void;
+    applyDocumentGridLinePitch(elem: WmlParagraph, style: IDomStyle, result: HTMLElement): void;
+    preserveGridInlineMetrics(result: HTMLElement): void;
+    groupByPageBreaks(sections: Section[]): Section[][];
+    hasPageModelContent(element: OpenXmlElement): boolean;
+    yieldDuringRender(current: number, total: number): Promise<void>;
+    yieldToBrowser(): Promise<void>;
+    renderWrapper(children: HTMLElement[]): HTMLElement;
+    shouldRunDynamicPagination(): boolean;
+    scheduleDynamicPagination(wrapper: HTMLElement, generation?: LayoutGeneration): void;
+    performDynamicPagination(wrapper: HTMLElement, generation?: LayoutGeneration): Promise<void>;
+    /** Move a measured, simple block tail in one DOM operation, preserving order. */
+    moveOverflowingTail(article: HTMLElement, page: HTMLElement, nextArticle: HTMLElement): boolean;
+    pickPaginationChunk(article: HTMLElement): HTMLElement[];
+    isKeepWithNext(elem: HTMLElement): boolean;
+    isPageOverflowing(page: HTMLElement): boolean;
+    createContinuationPage(page: HTMLElement, attach?: boolean): HTMLElement;
+    /** Redistribute canonical note bodies and their ordered, content-owning fragments. */
+    syncDynamicNotes(wrapper: HTMLElement): void;
+    getOrCreateNoteList(page: HTMLElement, kind: string): HTMLElement;
+    /** Rejoin only shells split from the same source; preserve authored boundaries. */
+    mergeNoteContents(target: HTMLElement, source: HTMLElement): void;
+    /** Footer/body boundary in CSS pixels, respecting the section's own margins. */
+    getPageNoteBottom(page: HTMLElement): number;
+    /** Reserve the measured, non-shrinking note regions above the footer. */
+    getPageBodyBottom(page: HTMLElement): number;
+    /** Minimum measured body prefix to retain while reserving an oversized note. */
+    getMinimumNoteBodyBottom(page: HTMLElement): number;
+    /** Try complete endnotes after the body before dividing a valid body paragraph. */
+    moveEndnotesAfterBody(page: HTMLElement, nextPage: HTMLElement): boolean;
+    /** Split only note space exceeding a page's measured capacity, before body flow. */
+    splitDynamicNotes(page: HTMLElement, nextPage: HTMLElement): boolean;
+    /** Measure the first retained line/atom, restoring all source nodes afterward. */
+    measureNoteMinimum(item: HTMLElement, nextPage: HTMLElement, page: HTMLElement): number;
+    moveNoteItemTail(item: HTMLElement, destination: HTMLElement, page: HTMLElement, overflows: () => boolean): boolean;
+    /** Identity-aware prefix guard; bookmarks do not count as a visible atom. */
+    hasNoteContentOutside(root: HTMLElement, excluded: Node): boolean;
+    firstNoteTextBoundary(text: string): number;
+    getNoteItemHeight(item: HTMLElement): number;
+    hasVisibleNoteContent(item: HTMLElement): boolean;
+    /** Notes reuse the inline text search, moving atoms and preserving unique IDs. */
+    splitNoteBlock(block: HTMLElement, destination: HTMLElement, page: HTMLElement, overflows: () => boolean, root?: HTMLElement): boolean;
+    moveNoteBlockTail(source: HTMLElement, destination: HTMLElement, page: HTMLElement, overflows: () => boolean, root: HTMLElement): boolean;
+    moveNoteTailNode(source: HTMLElement, destination: HTMLElement, page: HTMLElement, overflows: () => boolean, root: HTMLElement): boolean;
+    isNoteAtomicElement(element: HTMLElement): boolean;
+    /** Only the field kinds actually refreshed by evaluateDynamicField may change. */
+    isMutableNoteField(element: HTMLElement): boolean;
+    noteTextSignature(item: HTMLElement, fields: HTMLElement[]): string;
+    /** A completed layout must contain neither overlapping notes nor missing fragments. */
+    assertDynamicNotesFit(wrapper: HTMLElement): void;
+    refreshDynamicHeaderFooters(pages: HTMLElement[]): Promise<void>;
+    splitOverflowBlock(block: HTMLElement, page: HTMLElement, nextArticle: HTMLElement): boolean;
+    splitParagraphBlock(paragraph: HTMLElement, page: HTMLElement, nextArticle: HTMLElement): boolean;
+    splitTableBlock(table: HTMLTableElement, page: HTMLElement, nextArticle: HTMLElement): boolean;
+    cloneBlockShell<T extends HTMLElement>(element: T): T;
+    tableContentRows(table: HTMLTableElement): HTMLTableRowElement[];
+    firstMovedTableRow(table: HTMLTableElement): HTMLTableRowElement;
+    moveTailInlineNode(source: Node, dest: Node, page: HTMLElement): boolean;
+    moveTextTail(textNode: Text, dest: Node, page: HTMLElement, overflows?: () => boolean, preserveGraphemes?: boolean, minimumPrefix?: number): boolean;
+    adjustSplitToWordBoundary(text: string, moveLength: number): number;
+    removeEmptyInlineContainers(element: HTMLElement): void;
+    cleanupEmptyNumberedParagraphs(wrapper: HTMLElement): void;
+    removeEmptyDynamicPages(wrapper: HTMLElement): void;
+    findNextVisiblePaginationBlock(wrapper: HTMLElement, start: HTMLElement): HTMLElement | null;
+    hasVisiblePaginationContent(element: HTMLElement): boolean;
+    moveAnchorsToBlock(source: HTMLElement, target: HTMLElement): void;
+    rebalanceWidowOrphan(source: HTMLElement, continuation: HTMLElement, page: HTMLElement): void;
+    visualLineCount(element: HTMLElement): number;
+    updateDynamicFieldPages(wrapper: HTMLElement): void;
+    evaluateDynamicField(instruction: string, page: number, totalPages: number, pageByAnchor: Record<string, number>, sectionPages?: number, sectionPageNumber?: number, sectionNumber?: number): string;
+    renderDefaultStyle(): Node[];
+    renderNumbering(numberings: IDomNumbering[]): Promise<Node[]>;
+    renderStyles(styles: IDomStyle[]): Node[];
+    renderNotes(noteIds: string[], notesMap: Record<string, WmlBaseNote>, part?: Part, kind?: NoteKind): HTMLElement;
+    formatNoteAssignment(assignment: NoteAssignment): string;
+    applyNoteAssignment(element: HTMLElement, assignment: NoteAssignment, reference: boolean): void;
+    /** 按内部 DOM 类型分发到段落、表格、图片、字段等具体渲染函数。 */
+    renderElement(elem: OpenXmlElement): Node | Node[];
+    renderElements(elems: OpenXmlElement[], into?: Node): Node[];
+    private reviewParagraphs;
+    isPositionedParagraphFrame(paragraph?: WmlParagraph): boolean;
+    paragraphFrameKey(paragraph: WmlParagraph): string;
+    paragraphFrameStyle(paragraph: WmlParagraph): Record<string, string>;
+    tryRenderComplexField(elems: OpenXmlElement[], startIndex: number): {
+        node: Node | Node[];
+        nextIndex: number;
+    };
+    hasFieldChar(elem: OpenXmlElement, charType: WmlFieldChar["charType"]): boolean;
+    renderContainer<T extends keyof HTMLElementTagNameMap>(elem: OpenXmlElement, tagName: T): HTMLElementTagNameMap[T];
+    renderContainerNS(elem: OpenXmlElement, ns: ns, tagName: string, props?: Record<string, any>): Node;
+    effectiveParagraphTabs(directTabs: ParagraphTab[], styleTabs: ParagraphTab[]): ParagraphTab[];
+    countParagraphTabs(elem: OpenXmlElement): number;
+    isLeaderTabStop(tab: ParagraphTab): boolean;
+    resolveRenderedTabStop(effectiveStops: ParagraphTab[], tabIndex: number, tabCount: number): ParagraphTab;
+    /** 渲染段落节点，负责段落样式、列表标签、字段和书签锚点。 */
+    renderParagraph(elem: WmlParagraph): any;
+    /**
+     * 对整段比例一致的纯文本保留原生行内排版。混合比例、制表位、图形、
+     * 数学式与列表有独立的横向坐标，不能被整段变换误缩放；这些情况保持原渲染。
+     * 与页眉、语言或文本内容无关，同样适用于正文、表格单元格及页脚。
+     */
+    uniformParagraphTextScale(paragraph: WmlParagraph, style: IDomStyle): number | null;
+    hasParagraphRelativeAnchor(elem: OpenXmlElement): boolean;
+    renderAnchoredElement(model: OpenXmlElement, element: HTMLElement | SVGElement): HTMLElement | SVGElement;
+    refreshAnchors(root: HTMLElement): void;
+    ownsLayoutElement(element: Element): boolean;
+    prepareLayout(root: HTMLElement, generation?: LayoutGeneration): Promise<void>;
+    disposeLayout(): void;
+    renderHyperlink(elem: WmlHyperlink): HTMLAnchorElement;
+    private renderHyperlinkChildren;
+    applyHyperlinkTarget(result: HTMLAnchorElement, target: string, external: boolean): void;
+    wrapTabLeaderChildren(children: Node[], wrapLine?: boolean): Node[];
+    wrapLiteralLeaderChildren(children: Node[], wrapLine?: boolean): Node[] | null;
+    findLastTextualNodeIndex(children: Node[]): number;
+    literalLeaderKind(leader: string): "dot" | "middleDot";
+    cloneTextNodeWithText(node: Node, text: string): Node;
+    nodeElementName(node: Node): string;
+    nodeStyleObject(node: Node): Record<string, string>;
+    nodeTextContent(node: Node): string;
+    isTabLeaderNode(node: Node): boolean;
+    nodeDatasetValue(node: Node, name: string): string;
+    hasCssClass(node: Node, className: string): boolean;
+    addCssClass(node: Node, className: string): void;
+    nodeClassName(node: any): string;
+    renderSmartTag(elem: WmlSmartTag): HTMLSpanElement;
+    renderCommentRangeStart(commentStart: WmlCommentRangeStart): Node;
+    renderCommentRangeEnd(commentEnd: WmlCommentRangeStart): HTMLElement;
+    renderCommentReference(commentRef: WmlCommentReference): HTMLElement;
+    /** Mutable layout data belongs to this render, never to the reusable parsed parts. */
+    private cloneRenderData;
+    private renderCommentContent;
+    renderAltChunk(elem: WmlAltChunk): HTMLIFrameElement;
+    renderDrawing(elem: OpenXmlElement): any;
+    renderImage(elem: IDomImage): any;
+    renderShape(elem: IDomShape): any;
+    renderDmlTextBox(elem: IDomShape): SVGElement;
+    renderDmlSvgShape(elem: IDomShape): SVGSVGElement;
+    renderChart(elem: IDomChart): HTMLElement;
+    renderSmartArt(elem: IDomSmartArt): HTMLElement;
+    renderInk(elem: IDomInk): HTMLElement;
+    renderGraphicLoading(label: string): Node;
+    renderChartSvg(chartDoc: Document): SVGElement;
+    /** Chart lookup is namespace-aware and local to the requested XML level. */
+    chartChildren(node: Element | null, name?: string): Element[];
+    chartChild(node: Element | null, name: string): Element | null;
+    chartDescendant(node: Element | null, name: string): Element | null;
+    detectChartType(root: Element): string;
+    parseChartSeries(root: Element, chartType: string): ChartSeries[];
+    chartCacheValues(elem: Element | null): string[];
+    chartText(elem: Element | null): string;
+    chartNumber(node: Element | null, name: string): number | null;
+    chartBoolean(node: Element | null): boolean;
+    chartTitleText(title: Element | null): string;
+    extractChartTitle(root: Element): string;
+    resolveChartAxes(root: Element, type: string, selectedGroup?: Element): ChartAxes | null;
+    chartValueBounds(series: ChartSeries[]): {
+        min: number;
+        max: number;
+    };
+    drawCategoryLabels(svg: SVGElement, categories: string[], position: (index: number) => number, y: number): void;
+    drawBarChart(svg: SVGElement, series: ChartSeries[]): void;
+    drawLineChart(svg: SVGElement, series: ChartSeries[], fillArea?: boolean): void;
+    drawPieChart(svg: SVGElement, series: ChartSeries): void;
+    drawCombinedChartAxes(svg: SVGElement, root: Element, groups: Element[]): void;
+    /** Render linked axes, using serial dates as coordinates rather than category indexes. */
+    drawDateLineChart(svg: SVGElement, series: ChartSeries[], axes: ChartAxes, options?: ChartPlotOptions): void;
+    drawChartAxisTitles(svg: SVGElement, axes: ChartAxes | null): void;
+    syncChartAxisLegend(svg: SVGElement): void;
+    chartAxisNumberLabel(value: number, format?: string): string;
+    chartDateTicks(axis: Element | null, values: number[], min: number, max: number, date1904: boolean): number[];
+    formatChartDateLabel(raw: string, format: string, date1904?: boolean): string;
+    pieSlicePath(cx: number, cy: number, r: number, startAngle: number, endAngle: number): string;
+    polar(cx: number, cy: number, r: number, angleDeg: number): {
+        x: number;
+        y: number;
+    };
+    drawLegend(svg: SVGElement, text: string, colorIndex: number, x: number, y: number): void;
+    drawBottomLegend(svg: SVGElement, labels: string[], y: number): void;
+    chartLegendTextWidth(text: string): number;
+    chartColor(index: number): string;
+    renderSmartArtSvg(diagramDoc: Document): SVGElement;
+    layoutDiagramNodes(nodes: {
+        id: string;
+        text: string;
+    }[], connections: {
+        src: string;
+        dst: string;
+    }[]): {
+        id: string;
+        text: string;
+    }[][];
+    renderInkSvg(inkDoc: Document): SVGElement;
+    inkTraceToPoints(trace: string): number[][];
+    svgLine(x1: number, y1: number, x2: number, y2: number): SVGLineElement;
+    svgText(text: string, x: number, y: number, anchor?: "start" | "middle" | "end", fontSize?: string, weight?: string): SVGTextElement;
+    elementsByLocal(root: Element | Document, localName: string): Element[];
+    firstByLocal(root: Element | Document, localName: string): Element;
+    renderSimpleField(elem: WmlFieldSimple): Node | Node[];
+    renderFieldText(value: string, instruction: string): HTMLElement;
+    evaluateFieldNode(elem: WmlFieldSimple): string | Node | Node[] | null | undefined;
+    shouldPreserveStoredFieldResult(name: string, elem: WmlFieldSimple): boolean;
+    tokenizeFieldInstruction(instruction: string): string[];
+    fieldSwitch(tokens: string[], switchName: string): string;
+    hasFieldSwitch(tokens: string[], switchName: string): boolean;
+    firstFieldArgument(tokens: string[], startIndex?: number): string;
+    evaluateDateField(tokens: string[], fieldName: string): string;
+    formatFieldDate(date: Date, format: string): string;
+    evaluateDocPropertyField(tokens: string[]): string;
+    evaluateSetField(tokens: string[]): void;
+    evaluateDocVariableField(tokens: string[]): string;
+    renderHyperlinkField(tokens: string[], elem: WmlFieldSimple): HTMLElement;
+    evaluateIfField(tokens: string[]): string;
+    resolveFieldValue(value: string): string;
+    evaluateRefField(tokens: string[]): string;
+    evaluatePageRefField(tokens: string[]): string;
+    evaluateSeqField(tokens: string[]): string;
+    evaluateListNumField(tokens: string[]): string;
+    renderTocField(tokens: string[]): HTMLElement;
+    evaluateSymbolField(tokens: string[]): string;
+    evaluateFormula(expression: string): number;
+    applyFieldFormatting(value: string, instruction: string): string;
+    formatNumberPicture(value: number, picture: string): string;
+    fieldFormatSwitchToNumFormat(format: string): string;
+    formatFieldNumber(value: number, format?: string): string;
+    toRoman(value: number): string;
+    toLetters(value: number): string;
+    renderRuby(elem: OpenXmlElement): HTMLElement;
+    hasRenderedContent(nodes: Node[]): boolean;
+    renderText(elem: WmlText): Node;
+    applyCjkLineBreakGuards(text: string): string;
+    renderDeletedText(elem: WmlText): Node;
+    renderBreak(elem: WmlBreak): Node;
+    renderInserted(elem: OpenXmlElement): Node | Node[];
+    renderDeleted(elem: OpenXmlElement): Node;
+    renderRevisionContainer(elem: OpenXmlElement, tagName: "ins" | "del"): HTMLElement;
+    hasOwnRevisionContent(elem: OpenXmlElement): boolean;
+    renderSymbol(elem: WmlSymbol): HTMLElement;
+    renderFootnoteReference(elem: WmlNoteReference): HTMLElement;
+    renderEndnoteReference(elem: WmlNoteReference): HTMLElement;
+    renderNoteReference(elem: WmlNoteReference, kind: NoteKind): HTMLElement;
+    /** Only explicit eachPage numbering follows measured page changes. */
+    updateDynamicNoteNumbers(wrapper: HTMLElement): void;
+    renderTab(elem: OpenXmlElement): HTMLElement;
+    renderBookmarkStart(elem: WmlBookmarkStart): HTMLElement;
+    renderRun(elem: WmlRun): any;
+    /** 渲染表格，并把 Word 表格网格、边框、宽度和带状样式转换为 HTML table。 */
+    renderTable(elem: WmlTable): any;
+    renderTableColumns(columns: WmlTableColumn[]): Node;
+    /** 渲染表格行，同时维护行级样式和垂直合并上下文。 */
+    renderTableRow(elem: WmlTableRow): HTMLTableRowElement;
+    renderTableCellPlaceholder(colSpan: number): Node;
+    /** 渲染表格单元格，处理 colspan/rowspan、单元格宽度、内边距和嵌套内容。 */
+    renderTableCell(elem: WmlTableCell): any;
+    renderVmlPicture(elem: OpenXmlElement): HTMLDivElement | HTMLSpanElement;
+    vmlLengthInPoints(value: string): number | null;
+    vmlRenderContext(elem: VmlElement, bounds?: VmlBounds): VmlRenderContext;
+    vmlMappedValue(value: string, context: VmlRenderContext, axis: "x" | "y", size: boolean): number;
+    vmlBounds(elem: VmlElement, context: VmlRenderContext, inherited?: VmlBounds): VmlBounds;
+    vmlCombinedLength(first: string, second: string): string;
+    vmlRootStyle(elem: VmlElement): Record<string, string>;
+    applyVmlAttributes(result: SVGElement, attrs: Record<string, string>, excluded?: Set<string>): void;
+    loadVmlImage(elem: VmlElement, image: SVGImageElement): void;
+    renderVmlElement(elem: VmlElement): SVGElement;
+    renderVmlChildElement(elem: VmlElement, context: VmlRenderContext, inheritedBounds?: VmlBounds, isRoot?: boolean): SVGElement;
+    renderMmlMathParagraph(elem: OpenXmlElement): Node;
+    renderMmlPhantom(elem: OpenXmlElement): Node;
+    renderMmlAccent(elem: OpenXmlElement): MathMLElement;
+    renderMmlRadical(elem: OpenXmlElement): MathMLElement;
+    renderMmlDelimiter(elem: OpenXmlElement): MathMLElement;
+    renderMmlNary(elem: OpenXmlElement): MathMLElement;
+    renderMmlPreSubSuper(elem: OpenXmlElement): MathMLElement;
+    renderMmlGroupChar(elem: OpenXmlElement): any;
+    renderMmlBar(elem: OpenXmlElement): MathMLElement;
+    renderMmlRun(elem: OpenXmlElement): Node | Node[];
+    extractMathRunText(elem: OpenXmlElement): string | null;
+    renderMathTextTokens(text: string, style?: Record<string, any>): Node[];
+    createMathToken(tagName: "mi" | "mn" | "mo" | "mtext", text: string, style?: Record<string, any>): MathMLElement;
+    renderMllList(elem: OpenXmlElement): any;
+    toH(elem: OpenXmlElement, ns: ns, tagName: string, children?: Node[]): any;
+    /**
+     * 暗色模式下把一段已解析好的内联样式里的颜色属性换算成 Word 风格暗色颜色
+     * （CIE Lab 明度翻转，色相/彩度不变）。浅色模式或没有颜色属性时原样返回，
+     * 不产生额外开销。除了 --docx-*-color 主题/auto 变量（它们的打印还原在定义处
+     * 单独处理）之外，每个发生变化的值都会包一层 wrapForPrint()，以保证打印结果
+     * 不受屏幕暗色模式影响。
+     */
+    darkenStyle<T extends Record<string, any>>(style: T): T;
+    /** darkenStyle() 的单值版本，用于 SVG fill/stroke 等不经过 cssStyle 对象的颜色属性。 */
+    darkenColorAttr(color: string): string;
+    /**
+     * 把一个"浅色值 -> 暗色值"的换算结果包装成 `var(--docx-dm-N, 暗色值)`：
+     * 屏幕正常显示时该变量未定义，直接使用暗色值；同一个浅色值始终复用同一个变量名。
+     * 具体的打印还原声明由 renderDarkModePrintReset() 统一生成。
+     */
+    wrapForPrint(lightValue: string, darkValue: string): string;
+    /**
+     * 暗色模式专用：把所有被 wrapForPrint() 生成的 --docx-dm-N 变量在 @media print
+     * 下统一重新定义为浅色原值。因为这些变量只在这里被定义过，屏幕上它们始终未定义、
+     * var() 退回暗色值；一旦打印，这里的定义会让文档在纸面上完全还原 Word 原始配色，
+     * 且无需对每一个元素单独处理。
+     */
+    renderDarkModePrintReset(): Node[];
+    toHTML(elem: OpenXmlElement, ns: ns, tagName: string, children?: Node[]): any;
+    applyElementRevisionMetadata(result: HTMLElement, elem: OpenXmlElement): void;
+    findStyle(styleName: string): IDomStyle;
+    isTocParagraphStyle(styleName: string, style?: IDomStyle): boolean;
+    numberingClass(id: string, lvl: number): string;
+    numberingSelector(id: string, lvl: number): string;
+    tabStopClass(): string;
+    scopeDocumentStyleSelector(selector: string): string;
+    styleToString(selectors: string, values: Record<string, string>, cssText?: string): string;
+    numberingCounter(id: string, lvl: number): string;
+    numberingRestartLevel(num: IDomNumbering): number | null;
+    numberingMarkerRunStyle(style: Record<string, string>, normalized: boolean): Record<string, string>;
+    normalizeNumberingLevelText(text: string, format: string, runStyle?: Record<string, string>): {
+        text: string;
+        normalized: boolean;
+    };
+    symbolBulletMap(): Record<number, string>;
+    wingdingsBulletMap(): Record<number, string>;
+    levelTextToContent(text: string, suff: string, id: string, numformat: string, levelFormats?: Map<string, string>): string;
+    numberingSuffixToCssContent(suff: string): "" | "\"\\000020\"" | "\"\\000009\"";
+    escapeCssString(value: string): string;
+    numFormatToCssValue(format: string): any;
+    refreshTabStops(root?: HTMLElement): void;
+    createElementNS(ns: any, tagName: string, props?: Partial<Record<any, any>>, children?: any[]): any;
+    createElement<T extends keyof HTMLElementTagNameMap>(tagName: T, props?: Partial<Record<keyof HTMLElementTagNameMap[T], any>>, children?: any[]): HTMLElementTagNameMap[T];
+    createMathMLElement<T extends keyof MathMLElementTagNameMap>(tagName: T, props?: Partial<Record<keyof MathMLElementTagNameMap[T], any>>, children?: any[]): MathMLElementTagNameMap[T];
+    createSvgElement<T extends keyof SVGElementTagNameMap>(tagName: T, props?: Partial<Record<keyof SVGElementTagNameMap[T], any>>, children?: any[]): SVGElementTagNameMap[T];
+    later(func: Function): void;
+}
+export {};

package/dist/html.d.ts

@@ -0,0 +1,16 @@
+export declare enum ns {
+    html = "http://www.w3.org/1999/xhtml",
+    svg = "http://www.w3.org/2000/svg",
+    mathML = "http://www.w3.org/1998/Math/MathML"
+}
+export type HElement = {
+    ns?: ns;
+    tagName: "#fragment" | "#comment" | string;
+    className?: string;
+    style?: string | Record<string, string>;
+    children?: (HElement | Node | string)[];
+} & Record<string, any>;
+/** 小型 DOM 工厂，渲染器用它统一创建 HTML/SVG/MathML 节点。 */
+export declare function h(elem: HElement | Node | string): Node;
+/** 合并 className，过滤掉 false/undefined，减少渲染代码里的条件拼接。 */
+export declare function cx(...classNames: (string | false | undefined)[]): string;

package/dist/input-validation.d.ts

@@ -0,0 +1,2 @@
+export declare const EMPTY_DOCX_ERROR_MESSAGE = "\u6587\u4EF6\u4E3A\u7A7A\u6216\u5C1A\u672A\u4FDD\u5B58\uFF0C\u65E0\u6CD5\u4F5C\u4E3A Word \u6587\u6863\u6253\u5F00\u3002\u8BF7\u5728 WPS/Word \u4E2D\u4FDD\u5B58\u540E\u91CD\u65B0\u4E0A\u4F20\u3002";
+export declare function assertNonEmptyDocxInput(input: any): void;

package/dist/javascript.d.ts

@@ -0,0 +1,8 @@
+import { Length } from "./document/common";
+import { ParagraphTab } from "./document/paragraph";
+export declare function computePixelToPoint(container?: HTMLElement): number;
+export declare function updateTabStop(elem: HTMLElement, tabs: ParagraphTab[], defaultTabSize: Length, pixelToPoint?: number): void;
+/** Strict physical lengths, in points; unsupported relative units stay unresolved. */
+export declare function physicalLengthToPoint(value: string): number | null;
+/** Layout an explicit, non-leader tab using only its following text segment. */
+export declare function updateExplicitTabStop(elem: HTMLElement, tabs: ParagraphTab[]): boolean;