@gct-paas/word 0.1.14 → 0.1.16

package/dist/core/model/base/RefManager.d.ts

@@ -0,0 +1,50 @@
+import { RawElement } from '../types';
+/** slot 类型（页眉页脚专用） */
+export type RefSlotType = 'default' | 'first' | 'even';
+/** 带 slot 的引用 */
+export interface SlotRef {
+    type: RefSlotType;
+    rId: string;
+}
+/** 普通引用 */
+export interface SimpleRef {
+    /** 悬浮类引用 id */
+    rId: string;
+    /** 章节id */
+    secId: string;
+}
+/** 通用 Ref 类型 */
+type AnyRef = SlotRef | SimpleRef;
+interface RefManagerOptions {
+    /** XML tag 名 */
+    tagName: string;
+    /** 是否是 slot 类型 */
+    withSlot: boolean;
+    /** raw 数据 */
+    raw: RawElement;
+}
+export declare class RefManager<T extends AnyRef> {
+    private tagName;
+    private withSlot;
+    private raw;
+    refs: T[];
+    constructor(options: RefManagerOptions);
+    /**
+     * 从 JSON 中提取引用
+     * @param json 原始JSON数据
+     * @param tag 标签名
+     * @returns 格式化后的引用列表
+     */
+    parse(): T[];
+    /**
+     * 重新计算引用，并写回 raw
+     */
+    normalize(refs: string[], secIds?: string[]): T[];
+    private normalizeSlotRefs;
+    private normalizeSimpleRefs;
+    /**
+     * 将引用写回 raw
+     */
+    syncToRaw(): void;
+}
+export {};

package/dist/core/model/base/index.d.ts

@@ -1,2 +1,3 @@
 export { ModelNode, type ModelNodeOptions } from './ModelNode';
 export { ModelGroup, type ModelGroupOptions } from './ModelGroup';
+export { RefManager, type SimpleRef, type SlotRef, type RefSlotType } from './RefManager';

package/dist/core/model/document/Wbackground.d.ts

@@ -0,0 +1,22 @@
+import { RawElement } from '../types/raw';
+import { ModelNode, ModelNodeOptions } from '../base';
+export declare class Wbackground extends ModelNode {
+    /** 节点名称 */
+    name: 'w:background';
+    /** 节点类型 */
+    type: "element";
+    constructor(options: ModelNodeOptions);
+    /**
+     * 从原始 XML JSON 转换为 Wbackground 实例
+     *
+     * @param json - 原始 XML JSON 数据
+     * @returns Wbackground 实例
+     */
+    static fromXmlJson(json: RawElement): Wbackground;
+    /**
+     * 将 Wbackground 实例转换为原始 XML JSON
+     *
+     * @returns RawElement 格式的 XML JSON
+     */
+    toXmlJson(): RawElement;
+}

package/dist/core/model/document/Wdocument.d.ts

@@ -1,5 +1,6 @@
 import { RawElement } from '../types/raw';
 import { Wbody } from './Wbody';
+import { Wbackground } from './Wbackground';
 import { ModelGroup, ModelGroupOptions } from '../base';
 import { DocModel } from '../DocModel';
 /**
@@ -15,8 +16,13 @@ export declare class Wdocument extends ModelGroup<Wbody> {
     name: 'w:document';
     /** 节点类型 */
     type: "element";
+    background?: Wbackground;
+    /** 配置对象 */
+    config?: Record<string, any>;
     parent?: DocModel;
-    constructor(options: ModelGroupOptions<Wbody>);
+    constructor(options: ModelGroupOptions<Wbody> & {
+        background?: Wbackground;
+    });
     get body(): Wbody;
     /**
      * 从原始 XML JSON 转换为 Wdocument 实例

package/dist/core/model/document/Wp.d.ts

@@ -4,12 +4,13 @@ import { Wtc } from './Wtc';
 import { WrText } from './WrText';
 import { WrImage } from './WrImage';
 import { WrField } from './WrField';
+import { WrPageWidget } from './WrPageWidget';
 import { ModelGroup, ModelGroupOptions } from '../base';
 import { WpPr } from './WpPr';
 /**
  * Run 类型定义 - 可以是文本 Run 或图片 Run
  */
-export type Wr = WrText | WrImage | WrField;
+export type Wr = WrText | WrImage | WrField | WrPageWidget;
 export declare class Wp extends ModelGroup {
     name: 'w:p';
     type: "element";
@@ -60,4 +61,10 @@ export declare class Wp extends ModelGroup {
      * wp.setAlignment('center');
      */
     setAlignment(alignment: string): void;
+    /**
+     * 从模板创建段落
+     * @param width 单元格宽度（DXA/缇）
+     * @returns Wtc 实例
+     */
+    static fromTemplate(): Wp;
 }

package/dist/core/model/document/WrImage.d.ts

@@ -48,6 +48,8 @@ export declare class WrImage extends ModelNode {
      * // before: null，after: this（图片作为整体保留）
      */
     splitAt(index: number): [WrImage | null, WrImage | null];
+    /** 需要进行拼接成运行时的 modelId */
+    cloneWithSuffix(suffix: string, index: string | undefined): WrImage;
     /**
      * 从原始 XML JSON 转换为 WrImage 实例
      * @param json w:r XML JSON 对象

package/dist/core/model/document/WrPageWidget.d.ts

@@ -0,0 +1,8 @@
+import { RawElement } from '../types';
+import { WrText } from './WrText';
+export declare class WrPageWidget extends WrText {
+    static fromXmlJson(json: RawElement & {
+        valuePath?: string;
+        widgetMeta?: any;
+    }): WrPageWidget;
+}

package/dist/core/model/document/WrText.d.ts

@@ -20,14 +20,16 @@ export declare class WrText extends ModelNode {
     elements?: IElement[];
     valuePath?: string;
     widgetMeta?: WidgetMeta;
+    pageWidgetMeta?: WidgetMeta;
     constructor(options: ModelNodeOptions & {
         text: string;
         rPr?: WrPr;
         elements?: IElement[];
         isComposition?: boolean;
         isPlaceholder?: boolean;
-        widgetMeta?: WidgetMeta;
         valuePath?: string;
+        widgetMeta?: WidgetMeta;
+        pageWidgetMeta?: WidgetMeta;
     });
     /**
      * 在指定位置插入文本
@@ -104,6 +106,10 @@ export declare class WrText extends ModelNode {
      * // n 为 null，all 为 this（无分割）
      */
     splitAt(index: number): [WrText | null, WrText | null];
+    /** 需要使用运行时的 modelId */
+    cloneWithId(id: string): WrText;
+    /** 需要进行拼接成运行时的 modelId */
+    cloneWithSuffix(suffix: string, index: string | undefined): WrText;
     /**
      * 从原始 XML JSON 转换为 WrText 实例
      * @param json w:r XML JSON 对象
@@ -111,7 +117,8 @@ export declare class WrText extends ModelNode {
      */
     static fromXmlJson(json: RawElement & {
         valuePath?: string;
-        widgetMeta?: any;
+        widgetMeta?: WidgetMeta;
+        pageWidgetMeta?: WidgetMeta;
     }): WrText;
     /**
      * 将实例转换为 XML JSON 格式

package/dist/core/model/document/WsecPr.d.ts

@@ -1,5 +1,6 @@
 import { RawElement } from '../types/raw';
-import { ModelNode, ModelNodeOptions } from '../base';
+import { ModelNode, RefManager, ModelNodeOptions, SimpleRef, SlotRef } from '../base';
+export type HeaderFooterKind = 'header' | 'footer';
 /**
  * 页面大小配置
  */
@@ -48,6 +49,14 @@ export declare class WsecPr extends ModelNode {
     margins?: PageMargins;
     columns?: Columns;
     docGrid?: DocGrid;
+    /** 页眉页脚首页不同 */
+    titlePg: boolean;
+    /** 页眉引用关系 */
+    headerRefManager: RefManager<SlotRef>;
+    /** 页脚引用关系 */
+    footerRefManager: RefManager<SlotRef>;
+    /** 浮层引用关系 */
+    overlayRefManager: RefManager<SimpleRef>;
     fromParagraph: boolean;
     constructor(options: ModelNodeOptions & {
         raw: RawElement;
@@ -55,6 +64,7 @@ export declare class WsecPr extends ModelNode {
         margins?: PageMargins;
         columns?: Columns;
         docGrid?: DocGrid;
+        titlePg: boolean;
     });
     /**
      * 从原始 XML JSON 转换为 WsecPr 实例
@@ -64,6 +74,9 @@ export declare class WsecPr extends ModelNode {
      * 将 WsecPr 实例转换为原始 XML JSON
      */
     toXmlJson(): RawElement;
+    /**
+     * 获取页面宽度
+     */
     getPageWidth(): number | undefined;
     /**
      * 获取页面高度（单位：twip，1/20点）
@@ -73,6 +86,44 @@ export declare class WsecPr extends ModelNode {
      * 获取有效的左边距（考虑装订线）
      */
     getEffectiveLeftMargin(): number | undefined;
+    /**
+     * 根据页码解析页眉/页脚引用
+     * @param type 'header' | 'footer'
+     * @param pageIndex 页码
+     * @param evenAndOddHeaders 是否启用奇偶页不同
+     */
+    private resolveHeaderFooterRef;
+    /**
+     * 根据 pageIndex 获取页眉引用
+     * @param pageIndex 页码
+     * @param evenAndOddHeaders 是否启用奇偶页
+     */
+    getHeaderRef(pageIndex: number, evenAndOddHeaders: boolean): string | null;
+    /**
+     * 根据 pageIndex 获取页脚引用
+     * @param pageIndex 页码
+     * @param evenAndOddHeaders 是否启用奇偶页
+     */
+    getFooterRef(pageIndex: number, evenAndOddHeaders: boolean): string | null;
+    /** 根据章节 id 获取浮层引用 */
+    getOverlayRef(): string | null;
+    /**
+     * 重新计算页眉引用，并写回 raw
+     */
+    normalizeHeaderRefs(refIds: string[]): void;
+    /**
+     * 重新计算页脚引用，并写回 raw
+     */
+    normalizeFooterRefs(refIds: string[]): void;
+    /**
+     * 重新计算浮层引用，并写回 raw
+     */
+    normalizeOverlayRefs(refs: string[], secIds: string[]): void;
+    /**
+     * 获取当前页面方向
+     * @returns 'portrait' | 'landscape' | null
+     */
+    getOrient(): 'portrait' | 'landscape' | null;
     setOrient(val: 'portrait' | 'landscape'): void;
     /**
      * 设置为横向（宽 > 高）
@@ -112,4 +163,18 @@ export declare class WsecPr extends ModelNode {
      * @param right 右边距值，单位：twip（1/20点）
      */
     setMargins(top: number, bottom: number, left: number, right: number): void;
+    /**
+     * 设置页眉距页面顶边距离
+     * @param value 单位：twip
+     */
+    setHeaderMargin(value: number): void;
+    /**
+     * 设置页脚距页面底边距离
+     * @param value 单位：twip
+     */
+    setFooterMargin(value: number): void;
+    /**
+     * 设置首页不同页眉页脚
+     */
+    setTitlePg(enabled: boolean): void;
 }

package/dist/core/model/document/Wtbl/Calculation.d.ts

@@ -12,6 +12,10 @@ export declare class WtblCalculation {
      * 处理 repeating 数据
      */
     private static processRepeating;
+    /**
+     * 处理 2d-table 数据
+     */
+    private static process2DTable;
     /**
      * 处理 bounded 数据
      */
@@ -20,4 +24,12 @@ export declare class WtblCalculation {
      * 处理 boundedItem 数据
      */
     private static processBoundedItem;
+    /**
+     * 处理 check-table 数据
+     */
+    private static processCheckTable;
+    /**
+     * 处理 dataGroup2D 数据
+     */
+    private static processDataGroup2D;
 }

package/dist/core/model/document/Wtbl/RegionManager.d.ts

@@ -1,4 +1,4 @@
-import { BoundedRegionOptions, RepeatingRegionOptions, TableRegion, BoundedRegion, RepeatingRegion } from '../../logic';
+import { BoundedRegionOptions, CheckTableRegionOptions, RepeatingRegionOptions, TableRegion, TableHeaderRegionOptions, SubTableHeaderRegionOptions, _2DTableRegionOptions, BoundedRegion, CheckTableRegion, RepeatingRegion, TableHeaderRegion, SubTableHeaderRegion, _2DTableRegion } from '../../logic';
 import { Wtbl } from '../Wtbl';
 /**
  * 表格区域管理功能类
@@ -9,6 +9,8 @@ export declare class WtblRegionManager {
      * 根据 region id 查找对应的 region
      */
     static findRegionById(table: Wtbl, regionId: string): TableRegion | undefined;
+    static findCrossRegion(table: Wtbl, options: Pick<TableRegion, 'start' | 'end'>): TableRegion | undefined;
+    static findCrossRegions(table: Wtbl, options: Pick<TableRegion, 'start' | 'end'>): TableRegion[];
     /**
      * 根据 region id 删除对应的 region
      */
@@ -17,8 +19,18 @@ export declare class WtblRegionManager {
      * 设置重复区域
      */
     static setRepeating(table: Wtbl, options: Omit<RepeatingRegionOptions, 'table'>): RepeatingRegion;
+    /**
+     * 设置二维表
+     */
+    static set2DTable(table: Wtbl, options: Omit<_2DTableRegionOptions, 'table'>): _2DTableRegion;
     /**
      * 设置有界区域
      */
     static setBounded(table: Wtbl, options: Omit<BoundedRegionOptions, 'table'>): BoundedRegion;
+    /**
+     * 设置检验表
+     */
+    static setCheckTable(table: Wtbl, options: Omit<CheckTableRegionOptions, 'table'>): CheckTableRegion;
+    static setTableHeader(table: Wtbl, options: Omit<TableHeaderRegionOptions, 'table'>): TableHeaderRegion;
+    static setSubTableHeader(table: Wtbl, options: Omit<SubTableHeaderRegionOptions, 'table'>): SubTableHeaderRegion;
 }

package/dist/core/model/document/Wtbl/RowColumnOps.d.ts

@@ -4,6 +4,12 @@ import { Wtbl } from '../Wtbl';
  * 提供插入和删除行列的功能
  */
 export declare class WtblRowColumnOps {
+    /**
+     * 新单元格同步引用信息
+     * refCell: 参考单元格 (above | left)
+     * nextRefCell: 后参考单元格 (below | right )，如果传入，需要跟 refCell 比对一致后同步
+     */
+    private static syncRefInfo;
     /**
      * 在指定行位置插入新行
      */

package/dist/core/model/document/Wtbl/Serialization.d.ts

@@ -1,5 +1,7 @@
 import { RawElement } from '../../types/raw';
+import { Wtr } from '../Wtr';
 import { Wtbl } from '../Wtbl';
+import { Wtc } from '../Wtc';
 /**
  * 表格序列化功能类
  * 提供 XML 转换、快照序列化等功能
@@ -17,4 +19,14 @@ export declare class WtblSerialization {
      * 在指定行索引处断开表格
      */
     static splitAt(table: Wtbl, index: number): [Wtbl | null, Wtbl | null];
+    static getCell(rows: Wtr[], rowIndex: number, col: number): Wtc | undefined;
+    static findCellById(rows: Wtr[], cellId: string): Wtc | null;
+    /**
+     * 给起始单元格设置 rowspan
+     */
+    static applyRowspan(rows: Wtr[], rowIndex: number, col: number, rowspan: number): void;
+    /**
+     * 获取最大列数
+     */
+    static getMaxCols(rows: Wtr[]): number;
 }

package/dist/core/model/document/Wtbl.d.ts

@@ -3,7 +3,7 @@ import { Wbody } from './Wbody';
 import { Wtr } from './Wtr';
 import { Wtc } from './Wtc';
 import { ModelGroup, ModelGroupOptions } from '../base';
-import { TableRegion, BoundedRegionOptions, RepeatingRegionOptions, BoundedRegion, RepeatingRegion } from '../logic';
+import { TableRegion, BoundedRegionOptions, CheckTableRegionOptions, RepeatingRegionOptions, _2DTableRegionOptions, TableHeaderRegion, SubTableHeaderRegion, TableHeaderRegionOptions, SubTableHeaderRegionOptions, CheckTableRegion, BoundedRegion, RepeatingRegion, _2DTableRegion } from '../logic';
 import { WtblPr } from './WtblPr';
 export declare class Wtbl extends ModelGroup {
     name: 'w:tbl';
@@ -14,6 +14,8 @@ export declare class Wtbl extends ModelGroup {
     parent?: Wbody;
     children: Wtr[];
     private pendingRecalculate;
+    private mutationDepth;
+    private mutationNeedsRecalculate;
     constructor(options: ModelGroupOptions & {
         tblPr?: WtblPr;
         colWidths?: number[];
@@ -22,14 +24,28 @@ export declare class Wtbl extends ModelGroup {
     get repeating(): RepeatingRegion[];
     getRepeatingById(id: string): RepeatingRegion | undefined;
     get hasRepeating(): boolean;
+    get _2DTable(): _2DTableRegion[];
+    get2DTableById(id: string): _2DTableRegion | undefined;
+    get has2DTable(): boolean;
     get bounded(): BoundedRegion[];
     getBoundedById(id: string): BoundedRegion | undefined;
     get hasBounded(): boolean;
+    get checkTable(): CheckTableRegion[];
+    getCheckTableById(id: string): CheckTableRegion | undefined;
+    get hasCheckTable(): boolean;
+    get tableHeader(): Array<TableHeaderRegion | SubTableHeaderRegion>;
+    getTableHeaderById(id: string): TableHeaderRegion | SubTableHeaderRegion | undefined;
     /**
      * 请求延迟重算
      * 在微任务队列中安排一次重算，同一事件循环内的多次操作会自动合并
      */
     scheduleRecalculate(): void;
+    runConsistencyMutation(options: {
+        validate?: () => void;
+        mutate: () => void;
+        syncRefs?: () => void;
+        finalize?: () => void;
+    }): void;
     static fromXmlJson(json: RawElement): Wtbl;
     toXmlJson(): RawElement;
     /**
@@ -42,11 +58,16 @@ export declare class Wtbl extends ModelGroup {
      */
     splitAt(index: number): [Wtbl | null, Wtbl | null];
     setRepeating(options: Omit<RepeatingRegionOptions, 'table'>): RepeatingRegion;
+    set2DTable(options: Omit<_2DTableRegionOptions, 'table'>): _2DTableRegion;
     setBounded(options: Omit<BoundedRegionOptions, 'table'>): BoundedRegion;
+    setCheckTable(options: Omit<CheckTableRegionOptions, 'table'>): CheckTableRegion;
+    setTableHeader(options: Omit<TableHeaderRegionOptions, 'table'>): TableHeaderRegion;
+    setSubTableHeader(options: Omit<SubTableHeaderRegionOptions, 'table'>): SubTableHeaderRegion;
     /**
      * 根据 region id 查找对应的 region
      */
     findRegionById(regionId: string): TableRegion | undefined;
+    findCrossRegion(options: Pick<TableRegion, 'start' | 'end'>): TableRegion | undefined;
     /**
      * 根据 region id 删除对应的 region
      */

package/dist/core/model/document/Wtc.d.ts

@@ -3,6 +3,7 @@ import { Wtr } from './Wtr';
 import { Wp } from './Wp';
 import { ModelGroup, ModelGroupOptions } from '../base';
 import { Wtbl } from './Wtbl';
+export declare const WTC_REF_KEYS: string[];
 /**
  * w:tc 表格单元格
  */
@@ -13,12 +14,18 @@ export declare class Wtc extends ModelGroup {
     tcPrRaw?: RawElement;
     colspan?: number;
     rowspan?: number;
+    backgroundColor?: string;
     mergeFromId?: string;
     mergeId?: string;
     repeatingId?: string;
+    _2DTableId?: string;
     boundedId?: string;
     boundedItemId?: string;
+    checkTableId?: string;
+    dataGroup2DId?: string;
+    headerId?: string;
     vMergeType?: 'restart' | 'continue';
+    tempMergeId?: string;
     constructor(options: ModelGroupOptions & {
         tcPrRaw?: RawElement;
         colspan?: number;
@@ -26,15 +33,52 @@ export declare class Wtc extends ModelGroup {
         mergeFromId?: string;
         mergeId?: string;
         repeatingId?: string;
+        _2DTableId?: string;
         boundedId?: string;
         boundedItemId?: string;
+        checkTableId?: string;
+        dataGroup2DId?: string;
+        headerId?: string;
+        backgroundColor?: string;
         vMergeType?: 'restart' | 'continue';
+        tempMergeId?: string;
     });
     get table(): Wtbl;
-    get isMerged(): boolean;
+    /** 是否是被合并单元格 */
+    get isMergeSlave(): boolean;
+    /** 是否是合并起始单元格 */
+    get isMergeStart(): boolean;
     get contents(): Wp[];
     get firstContent(): Wp | undefined;
     get lastContent(): Wp | undefined;
+    get cellMergeInfo(): {
+        /** 是否属于合并单元格(不包括起点的) */
+        isMerged: boolean;
+        /** 合并方向 */
+        direction: 'horizontal' | 'vertical' | null;
+        /** 当前单元格在 XML 生成时是否需要跳过 */
+        skip: boolean;
+        /** 合并来源位置（左上角） */
+        from: null | {
+            row: number;
+            col: number;
+        };
+        /** 合并区域尺寸 */
+        span: null | {
+            rows: number;
+            cols: number;
+        };
+        /**
+         * 当前单元格是否是“某一行的起点”
+         * 用于决定是否输出 w:gridSpan
+         */
+        isRowStart: boolean;
+        /**
+         * 当前单元格是否是“整个合并区域的起点（左上角）”
+         * 用于决定 vMerge restart
+         */
+        isRoot: boolean;
+    };
     /**
      * 查找当前单元格对应的区域
      * @returns
@@ -55,7 +99,9 @@ export declare class Wtc extends ModelGroup {
      *   ├── w:tcPr（如果存在）
      *   └── w:p（所有段落子元素）
      */
-    toXmlJson(): RawElement;
+    toXmlJson(): RawElement | null;
+    private buildTcPr;
+    private static normalizeWordColor;
     /**
      * 从模板创建单元格
      * @param width 单元格宽度（DXA/缇）
@@ -87,7 +133,9 @@ export declare class Wtc extends ModelGroup {
      * // 支持链式调用
      * cell.merge(2, 3).merge(1, 2);
      */
-    merge(rowSpan: number, colSpan: number): this;
+    merge(rowSpan: number, colSpan: number, options?: {
+        skipConsistency?: boolean;
+    }): this;
     /**
      * 取消当前单元格的合并状态
      *
@@ -109,5 +157,7 @@ export declare class Wtc extends ModelGroup {
      * const cell = table.rows[1].cells[0];  // rowspan=2, colspan=2
      * cell.unmerge();  // 覆盖范围内的所有单元格恢复为独立状态
      */
-    unmerge(): void;
+    unmerge(options?: {
+        skipConsistency?: boolean;
+    }): void;
 }

package/dist/core/model/document/WtrPr.d.ts

@@ -51,4 +51,5 @@ export declare class WtrPr extends ModelNode {
      * wpPr.removeElement('w:keepNext');
      */
     removeElement(name: string): boolean;
+    static fromTemplate(): WtrPr;
 }

package/dist/core/model/document/index.d.ts

@@ -1,10 +1,12 @@
 export { Wdocument } from './Wdocument';
 export { Wbody } from './Wbody';
+export { Wbackground } from './Wbackground';
 export { Wp } from './Wp';
 export type { Wr } from './Wp';
 export { WrText } from './WrText';
 export { WrImage } from './WrImage';
 export { WrField } from './WrField';
+export { WrPageWidget } from './WrPageWidget';
 export { Wtbl } from './Wtbl';
 export { Wtr } from './Wtr';
 export { Wtc } from './Wtc';

package/dist/core/model/footers/Wfooter.d.ts

@@ -0,0 +1,40 @@
+import { ModelGroup, ModelNode, ModelGroupOptions } from '../base';
+import { DocModel } from '../DocModel';
+import { RawElement } from '../types';
+export type WfooterXmlJson = RawElement & {
+    name: 'w:ftr';
+    '@Relationship': {
+        Type: string;
+        Target: string;
+        Id: string;
+    };
+};
+/**
+ * 页脚类
+ */
+export declare class Wfooter extends ModelGroup<ModelNode> {
+    /** 节点名称 */
+    name: 'w:ftr';
+    /** 节点类型 */
+    type: "element";
+    /** 原始 XML JSON 数据 */
+    raw?: WfooterXmlJson;
+    /** 关系 ID（rId） */
+    relId?: string;
+    parent?: DocModel;
+    constructor(options: ModelGroupOptions<ModelNode> & {
+        raw: WfooterXmlJson;
+    });
+    /**
+     * 从原始 XML JSON 转换为 Wfooter 实例
+     *
+     * @param json - 原始 XML JSON 数据
+     * @returns Wfooter 实例
+     */
+    static fromXmlJson(json: WfooterXmlJson): Wfooter;
+    /**
+     * 转换为 XML JSON
+     */
+    toXmlJson(): WfooterXmlJson;
+    static fromTemplate(index: string): Wfooter;
+}

package/dist/core/model/footers/Wfooters.d.ts

@@ -0,0 +1,42 @@
+import { Wfooter, WfooterXmlJson } from './Wfooter';
+import { DocModel } from '../DocModel';
+import { WsecPr } from '../document';
+export declare class Wfooters {
+    raw?: WfooterXmlJson[];
+    footers: Wfooter[];
+    parent?: DocModel;
+    FOOTER_SLOT_COUNT: number;
+    constructor(raw: WfooterXmlJson[], parent?: DocModel);
+    /**
+     * 批量从 JSON 转换
+     */
+    static fromXmlJsonArray(json: WfooterXmlJson[], parent?: DocModel): Wfooters;
+    /**
+     * 转为 XML JSON 数组
+     */
+    toXmlJson(): WfooterXmlJson[];
+    /**
+     * 根据 relId 查找页脚
+     */
+    getByRelId(rId: string): Wfooter | null;
+    /**
+     * 获取当前所有页脚的 relId
+     */
+    getRefIds(): string[];
+    /**
+     * 计算下一个页脚序号
+     */
+    private getNextFooterIndex;
+    /**
+     * footers 重建回 raw
+     */
+    private syncRaw;
+    /**
+     * 补齐页脚槽位，并同步 raw
+     */
+    ensureComplete(): void;
+    /**
+     * 统一修复所有 section 的页脚引用
+     */
+    syncSectionRefs(sections: WsecPr[]): void;
+}