@gct-paas/word 0.1.13 → 0.1.15

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.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';
@@ -22,9 +22,17 @@ 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;
     /**
      * 请求延迟重算
      * 在微任务队列中安排一次重算，同一事件循环内的多次操作会自动合并
@@ -42,11 +50,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

@@ -16,8 +16,12 @@ export declare class Wtc extends ModelGroup {
     mergeFromId?: string;
     mergeId?: string;
     repeatingId?: string;
+    _2DTableId?: string;
     boundedId?: string;
     boundedItemId?: string;
+    checkTableId?: string;
+    dataGroup2DId?: string;
+    headerId?: string;
     vMergeType?: 'restart' | 'continue';
     constructor(options: ModelGroupOptions & {
         tcPrRaw?: RawElement;
@@ -26,8 +30,12 @@ export declare class Wtc extends ModelGroup {
         mergeFromId?: string;
         mergeId?: string;
         repeatingId?: string;
+        _2DTableId?: string;
         boundedId?: string;
         boundedItemId?: string;
+        checkTableId?: string;
+        dataGroup2DId?: string;
+        headerId?: string;
         vMergeType?: 'restart' | 'continue';
     });
     get table(): Wtbl;

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

@@ -5,6 +5,7 @@ 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;
+}

package/dist/core/model/headers/Wheader.d.ts

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

package/dist/core/model/headers/Wheaders.d.ts

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

package/dist/core/model/logic/CheckTableRegion.d.ts

@@ -0,0 +1,44 @@
+import { Wtbl } from '../document';
+import { Region, RegionOptions } from './Region';
+import { RegionJson } from '../types';
+import { DataGroup2DRegion, DataGroup2DRegionOptions } from './DataGroup2DRegion';
+export type CheckTableWidgetPropsMeta = {
+    /** 引用填充（撑满固定表）*/
+    autoFill: boolean;
+    refColField: string | undefined;
+    refRowField: string | undefined;
+    [key: string]: any;
+};
+export type CheckTableWidgetMeta = {
+    props: CheckTableWidgetPropsMeta;
+};
+export type CheckTableRegionOptions = RegionOptions & {
+    name: string;
+    valuePath: string;
+    widgetMeta: CheckTableWidgetMeta;
+    itemRegion?: DataGroup2DRegion;
+};
+export type CheckTableRegionJson = RegionJson & {
+    name: string;
+    valuePath: string;
+    widgetMeta: CheckTableWidgetMeta;
+    itemRegion?: any;
+};
+export declare class CheckTableRegion extends Region {
+    type: "checkTable";
+    name: string;
+    valuePath: string;
+    widgetMeta: CheckTableWidgetMeta;
+    itemRegion?: DataGroup2DRegion;
+    constructor(options: CheckTableRegionOptions);
+    /**
+     * 序列化为 JSON 对象
+     */
+    toJSON(): CheckTableRegionJson;
+    /**
+     * 从 JSON 对象还原
+     */
+    static fromJSON(json: CheckTableRegionJson, table: Wtbl): CheckTableRegion;
+    setItemRegion(options: Omit<DataGroup2DRegionOptions, 'table'>): DataGroup2DRegion;
+    removeItemRegion(): void;
+}

package/dist/core/model/logic/DataGroup2DRegion.d.ts

@@ -0,0 +1,12 @@
+import { Region, RegionOptions } from './Region';
+import { CheckTableRegion } from './CheckTableRegion';
+import { _2DTableRegion } from './_2DTableRegion';
+export type DataGroup2DRegionOptions = RegionOptions & {
+    parent?: CheckTableRegion | _2DTableRegion;
+};
+export declare class DataGroup2DRegion extends Region {
+    type: "dataGroup2D";
+    parent?: CheckTableRegion | _2DTableRegion;
+    constructor(options: DataGroup2DRegionOptions);
+    remove(): void;
+}

package/dist/core/model/logic/SubTableHeaderRegion.d.ts

@@ -0,0 +1,22 @@
+import { Wtbl } from '../document';
+import { Region, RegionOptions } from './Region';
+import { RegionJson } from '../types';
+export type SubTableHeaderRegionOptions = RegionOptions & {
+    name: string;
+    subTableId: string;
+};
+export type SubTableRegionJson = RegionJson & {
+    name: string;
+    subTableId: string;
+};
+export declare class SubTableHeaderRegion extends Region {
+    type: "sub-table-header";
+    name: string;
+    subTableId: SubTableHeaderRegionOptions['subTableId'];
+    constructor(options: SubTableHeaderRegionOptions);
+    /**
+     * 序列化为 JSON 对象
+     */
+    toJSON(): SubTableRegionJson;
+    static fromJSON(json: SubTableRegionJson, table: Wtbl): SubTableHeaderRegion;
+}

package/dist/core/model/logic/TableHeaderRegion.d.ts

@@ -0,0 +1,16 @@
+import { Wtbl } from '../document';
+import { Region, RegionOptions } from './Region';
+import { RegionJson } from '../types';
+export type TableHeaderRegionOptions = RegionOptions & {
+    name: string;
+};
+export type TableRegionJson = RegionJson & {
+    name: string;
+};
+export declare class TableHeaderRegion extends Region {
+    type: "table-header";
+    name: string;
+    constructor(options: TableHeaderRegionOptions);
+    toJSON(): TableRegionJson;
+    static fromJSON(json: TableRegionJson, table: Wtbl): TableHeaderRegion;
+}

package/dist/core/model/logic/_2DTableRegion.d.ts

@@ -0,0 +1,44 @@
+import { Wtbl } from '../document';
+import { Region, RegionOptions } from './Region';
+import { RegionJson } from '../types';
+import { DataGroup2DRegion, DataGroup2DRegionOptions } from './DataGroup2DRegion';
+export type _2DTableWidgetPropsMeta = {
+    /** 引用填充（撑满固定表）*/
+    autoFill: boolean;
+    refColField: string | undefined;
+    refRowField: string | undefined;
+    [key: string]: any;
+};
+export type _2DTableWidgetMeta = {
+    props: _2DTableWidgetPropsMeta;
+};
+export type _2DTableRegionOptions = RegionOptions & {
+    name: string;
+    valuePath: string;
+    widgetMeta: _2DTableWidgetMeta;
+    itemRegion?: DataGroup2DRegion;
+};
+export type _2DTableRegionJson = RegionJson & {
+    name: string;
+    valuePath: string;
+    widgetMeta: _2DTableWidgetMeta;
+    itemRegion?: any;
+};
+export declare class _2DTableRegion extends Region {
+    type: "_2DTable";
+    name: string;
+    valuePath: string;
+    widgetMeta: _2DTableWidgetMeta;
+    itemRegion?: DataGroup2DRegion;
+    constructor(options: _2DTableRegionOptions);
+    /**
+     * 序列化为 JSON 对象
+     */
+    toJSON(): _2DTableRegionJson;
+    /**
+     * 从 JSON 对象还原
+     */
+    static fromJSON(json: _2DTableRegionJson, table: Wtbl): _2DTableRegion;
+    setItemRegion(options: Omit<DataGroup2DRegionOptions, 'table'>): DataGroup2DRegion;
+    removeItemRegion(): void;
+}

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

@@ -1,9 +1,22 @@
 import { RepeatingRegion } from './RepeatingRegion';
 import { BoundedRegion } from './BoundedRegion';
+import { CheckTableRegion } from './CheckTableRegion';
+import { TableHeaderRegion } from './TableHeaderRegion';
+import { SubTableHeaderRegion } from './SubTableHeaderRegion';
+import { _2DTableRegion } from './_2DTableRegion';
 export { Region } from './Region';
 export { RepeatingRegion } from './RepeatingRegion';
+export { _2DTableRegion } from './_2DTableRegion';
 export { BoundedRegion } from './BoundedRegion';
+export { CheckTableRegion } from './CheckTableRegion';
+export { TableHeaderRegion } from './TableHeaderRegion';
+export { SubTableHeaderRegion } from './SubTableHeaderRegion';
 export type { RegionOptions, CellPos } from './Region';
 export type { RepeatingRegionOptions } from './RepeatingRegion';
+export type { _2DTableRegionOptions } from './_2DTableRegion';
 export type { BoundedRegionOptions } from './BoundedRegion';
-export type TableRegion = RepeatingRegion | BoundedRegion;
+export type { CheckTableRegionOptions } from './CheckTableRegion';
+export type { TableHeaderRegionOptions } from './TableHeaderRegion';
+export type { SubTableHeaderRegionOptions } from './SubTableHeaderRegion';
+export type TableRegion = RepeatingRegion | _2DTableRegion | BoundedRegion | CheckTableRegion | TableHeaderRegion | SubTableHeaderRegion;
+export type SubTableRegion = RepeatingRegion | BoundedRegion;

package/dist/core/model/overlays/Wlayout.d.ts

@@ -0,0 +1,70 @@
+import { RawElement } from '../types';
+import { ModelGroup, ModelNode, ModelGroupOptions } from '../base';
+export type WlayoutXmlJson = RawElement & {
+    name: 'w:lyt';
+    /** 布局坐标信息 */
+    '@layout'?: {
+        x: number;
+        y: number;
+        width?: number;
+        height?: number;
+        zIndex?: number;
+    };
+};
+export interface WlayoutOptions extends ModelGroupOptions<ModelNode> {
+    raw?: WlayoutXmlJson;
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+    zIndex?: number;
+}
+/**
+ * 布局容器
+ */
+export declare class Wlayout extends ModelGroup<ModelNode> {
+    /** 节点名称 */
+    name: 'w:lyt';
+    /** 节点类型 */
+    type: "element";
+    /** 原始 XML */
+    raw?: WlayoutXmlJson;
+    x: number;
+    y: number;
+    width?: number;
+    height?: number;
+    zIndex: number;
+    parent?: ModelNode;
+    constructor(options: WlayoutOptions);
+    /**
+     * XML -> Wlayout
+     */
+    static fromXmlJson(json: WlayoutXmlJson): Wlayout;
+    /**
+     * XML JSON 输出
+     */
+    toXmlJson(): WlayoutXmlJson;
+    /** 获取组件信息 */
+    getWrPageWidget(): RawElement | ModelNode | undefined;
+    /**
+     * 调整容器尺寸
+     * @param width 新宽度
+     * @param height 新高度
+     */
+    resize(pos: {
+        x?: number;
+        y?: number;
+        width?: number;
+        height?: number;
+    }): void;
+    /**
+     * 从模板创建 layout
+     */
+    static fromTemplate(opts: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        zIndex: number;
+    }): Wlayout;
+}

package/dist/core/model/overlays/Woverlay.d.ts

@@ -0,0 +1,41 @@
+import { DocModel } from '../DocModel';
+import { RawElement } from '../types';
+import { ModelGroup, ModelNode, ModelGroupOptions } from '../base';
+export type WoverlayXmlJson = RawElement & {
+    name: 'w:ovl';
+    '@Relationship': {
+        Type: string;
+        Target: string;
+        Id: string;
+    };
+};
+/**
+ * 浮层类
+ * 每个 Woverlay 对应一个章节（Section），持有该章节内所有悬浮段落节点。
+ */
+export declare class Woverlay extends ModelGroup<ModelNode> {
+    /** 节点名称 */
+    name: 'w:ovl';
+    /** 节点类型 */
+    type: "element";
+    /** 原始 XML JSON 数据 */
+    raw?: WoverlayXmlJson;
+    /** 关系 ID（rId） */
+    relId?: string;
+    parent?: DocModel;
+    constructor(options: ModelGroupOptions<ModelNode> & {
+        raw: WoverlayXmlJson;
+    });
+    /**
+     * 从原始 XML JSON 转换为 Woverlay 实例
+     *
+     * @param json - 原始 XML JSON 数据
+     * @returns Woverlay 实例
+     */
+    static fromXmlJson(json: WoverlayXmlJson): Woverlay;
+    /**
+     * 转换为 XML JSON
+     */
+    toXmlJson(): WoverlayXmlJson;
+    static fromTemplate(index: string): Woverlay;
+}

package/dist/core/model/overlays/Woverlays.d.ts

@@ -0,0 +1,45 @@
+import { Woverlay, WoverlayXmlJson } from './Woverlay';
+import { DocModel } from '../DocModel';
+import { WsecPr } from '../document';
+/**
+ * 浮层集合类
+ */
+export declare class Woverlays {
+    raw?: WoverlayXmlJson[];
+    overlays: Woverlay[];
+    parent?: DocModel;
+    constructor(raw: WoverlayXmlJson[], parent?: DocModel);
+    /**
+     * 批量从 JSON 转换
+     */
+    static fromXmlJsonArray(json: WoverlayXmlJson[], parent?: DocModel): Woverlays;
+    /**
+     * 转为 XML JSON 数组
+     */
+    toXmlJson(): WoverlayXmlJson[];
+    /**
+     * 根据 relId 查找浮层
+     */
+    getByRelId(rId: string): Woverlay | null;
+    /**
+     * 获取当前所有悬浮层的 relId
+     */
+    getRefIds(): string[];
+    /**
+     * 计算下一个浮层序号
+     */
+    private getNextOverlayIndex;
+    /**
+     * overlays 重建回 raw
+     */
+    private syncRaw;
+    /**
+     * 根据章节补齐浮层槽位，并同步 raw
+     * 保证 overlays.length >= sections.length（一对一）
+     */
+    ensureComplete(sections: WsecPr[]): void;
+    /**
+     * 统一修复所有 section 的浮层引用
+     */
+    syncSectionRefs(sections: WsecPr[]): void;
+}

package/dist/core/model/settings/Wsettings.d.ts

@@ -0,0 +1,47 @@
+import { RawElement } from '../types/raw';
+/**
+ * w:settings 根元素的原始 JSON 类型
+ */
+type WsettingsXmlJson = RawElement & {
+    name: 'w:settings';
+};
+/**
+ * Word 文档全局设置（settings.xml）
+ */
+export declare class Wsettings {
+    type: 'settings';
+    raw: WsettingsXmlJson;
+    /**
+     * 是否启用奇偶页不同页眉页脚
+     * <w:evenAndOddHeaders/>
+     */
+    evenAndOddHeaders: boolean;
+    /**
+     * （兼容字段：部分文档可能在 settings 中也有 titlePg
+     * 实际优先级低于 section
+     */
+    titlePg: boolean;
+    constructor(raw: WsettingsXmlJson);
+    /**
+     * 从 XML JSON 转换
+     */
+    static fromXmlJson(json: WsettingsXmlJson): Wsettings;
+    /**
+     * 转回 XML JSON
+     * 保持原始结构
+     */
+    toXmlJson(): RawElement;
+    /**
+     * 是否启用奇偶页
+     */
+    isEvenAndOddEnabled(): boolean;
+    /**
+     * 是否首页特殊
+     */
+    hasTitlePg(): boolean;
+    /**
+     * 设置奇偶页不同页眉页脚，并同步回原始 settings.xml
+     */
+    setEvenAndOddHeaders(enabled: boolean): void;
+}
+export {};