@gct-paas/word 0.1.14 → 0.1.16

package/dist/core/cursor/CursorController.d.ts

@@ -1,5 +1,6 @@
 import { Doc } from '../view/Doc';
 import { MoveOpts } from '../event/types';
+import { PointerHitResult } from './hit/types';
 import { Pos } from './session/CursorDragSession';
 export declare class CursorController {
     doc: Doc;
@@ -47,5 +48,19 @@ export declare class CursorController {
         phase?: 'preview' | 'commit';
         syncCaret?: boolean;
     }): void;
+    /**
+     * 根据鼠标位置，计算命中的页面及坐标信息
+     */
+    getPageHitInfo(canvasX: number, canvasY: number): {
+        page: import('..').Page;
+        canvasX: number;
+        canvasY: number;
+        relX: number;
+        relY: number;
+    } | null;
+    /**
+     * 解析指针命中结果
+     */
+    resolvePointerHit(canvasX: number, canvasY: number, pos?: Pos): PointerHitResult | null;
     destroy(): void;
 }

package/dist/core/cursor/hit/OverlayLayoutHitHandler.d.ts

@@ -0,0 +1,9 @@
+import { Doc } from '../../view/Doc';
+import { BaseMetaNode } from '../../layout/types';
+import { HitHandler, HitResult } from './types';
+import { HitHandlerRegistry } from './HitHandlerRegistry';
+export declare class OverlayLayoutHitHandler implements HitHandler {
+    private registry?;
+    constructor(registry?: HitHandlerRegistry);
+    handleHitDetection(doc: Doc, node: BaseMetaNode, actualX: number, actualY: number): HitResult | null;
+}

package/dist/core/cursor/hit/types.d.ts

@@ -1,6 +1,7 @@
 import { BaseMetaNode } from '../../layout/types';
 import { Doc } from '../../view/Doc';
 import { CursorIntent, Side } from '../types/cursor';
+import { Page } from '../../view/Page';
 export interface HitResult {
     id: string;
     offset: number;
@@ -34,3 +35,19 @@ export interface HitHandler {
     /** 是否点中即全选 */
     isClickSelectAll?: (doc: Doc, node: BaseMetaNode) => HitIntent;
 }
+/**
+ * 指针命中结果（统一数据结构）
+ * 所有拖拽 / hover / 点击 / cursor 都应该基于它
+ */
+export interface PointerHitResult {
+    /** 命中的页面 */
+    page: Page;
+    /** 命中的区域 */
+    zone: 'header' | 'footer' | 'body';
+    /** 画布坐标 */
+    canvasX: number;
+    canvasY: number;
+    /** 相对于 page 的坐标 */
+    relX: number;
+    relY: number;
+}

package/dist/core/cursor/layout/baseMeta.d.ts

@@ -5,8 +5,8 @@ import { BaseMetaNode } from '../../layout/types';
  */
 export declare function getBaseMetaInfo(node: BaseMetaNode): {
     isPlaceholder: boolean;
-    id: string;
     path: string[];
+    id: string;
     pathIndex: number[];
     pageId: string;
     preId: string;

package/dist/core/data/DataManager.d.ts

@@ -1,5 +1,6 @@
 import { Doc } from '../view/Doc';
 export type Data = Record<string, any>;
+export type PartialData = Partial<Data>;
 type JsonPath = string;
 type SubscriptionCallback = (newValue: any, oldValue: any) => void;
 /**
@@ -53,6 +54,10 @@ export declare class DataManager {
      * @returns 是否设置成功
      */
     set(path: JsonPath, value: any, source?: 'user' | 'dependency'): boolean;
+    /**
+     * 将一个部分值对象合进整体
+     */
+    patch(data: PartialData): void;
     /**
      * 根据 jsonpath 删除数据
      * @param path jsonpath 路径

package/dist/core/event/DocumentEventBridge.d.ts

@@ -36,7 +36,11 @@ export declare class DocumentEventBridge {
     private onDown;
     private onMove;
     private onUp;
-    private emit;
+    emit(type: string, pos: {
+        clientX: number;
+        clientY: number;
+        pointerId: number;
+    }): void;
     private onScroll;
     private onRequestScroll;
     private ensureCaretVisibleByHiddenInput;

package/dist/core/event/EventManager.d.ts

@@ -29,7 +29,7 @@ export declare class EventManager {
      * 绑定单个事件
      */
     private bindEvent;
-    dispatchCustom(eventName: string, payload: any): void;
+    dispatchCustom<T = any>(eventName: string, payload: any): T[];
     /**
      * 销毁事件管理器，清理所有事件监听
      */

package/dist/core/event/handlers/InteractionHandler.d.ts

@@ -12,4 +12,7 @@ export declare class InteractionHandler implements IEventHandler {
     private handleFocusWidget;
     private handleShowValidationComment;
     private handleFocusValidation;
+    private handleChangeHeader2footerBool;
+    private handleSetAnnotation;
+    private handleFocusAnnotation;
 }

package/dist/core/event/handlers/KonvaHandler.d.ts

@@ -2,6 +2,7 @@ import { EventHandlerConfig, IEventHandler } from '../types';
 import { EventManager } from '../EventManager';
 export declare class KonvaHandler implements IEventHandler {
     private eventManager;
+    private dragMode;
     constructor(eventManager: EventManager);
     getHandlers(): EventHandlerConfig[];
     /** 从 Konva shape 向上查找组件id： */
@@ -13,6 +14,8 @@ export declare class KonvaHandler implements IEventHandler {
     private handleDragStart;
     private handleDragMove;
     private handleDragEnd;
+    /** 根据 pointer（鼠标/触摸）位置，解析命中结果 */
+    private handlePointerResolve;
     /** 光标定位 */
     private handleCaretLocate;
 }

package/dist/core/index.d.ts

@@ -1,8 +1,9 @@
-export { createDoc, createDocInfo } from './sdk/createDoc';
+export { newDoc } from './sdk/createDoc';
 export { useDocPubApiContext } from './sdk/DocPubApiContext';
-export { usePagesToPdf } from './sdk/usePagesToPdf';
+export { usePrint } from './sdk/usePagesToPdf';
 export { useInteraction } from './interaction/useInteraction';
 export { formulaUtils } from './utils/calculate-formula';
+export { TextUtil } from './view/utils/TextUtil';
 export { resolveWidgetState } from './widget/widget-state';
 export { validateTextWidgetMarker } from './layout/logic/LayoutBuilder';
 export { CommandType } from './command/types';
@@ -11,7 +12,7 @@ export { DocumentEventBridge } from './event/DocumentEventBridge';
 export { DocModeTypeConst, PageSizeEnumConst, BuiltinComponentTypeConst } from './constants';
 export { default as CursorOverlay } from './cursor/render/cursor-overlay.vue';
 export { default as HiddenInput } from './cursor/render/hidden-input.vue';
-export type { EnginePublic, PublicDoc, DocInfo } from './sdk/types/public-types';
+export type { PaperItem } from './sdk/usePagesToPdf';
 export type { DocInitOptions } from './view/Doc';
 export type { WidgetMeta } from './widget/widget-meta';
 export type { DocModeType, CompleteComponentType, BuiltinComponentType } from './constants';
@@ -22,9 +23,12 @@ export type { TextRun } from './view/runs/TextRun';
 export type { ImageRun } from './view/runs/ImageRun';
 export type { ITextWidget } from './view/runs/TextWidget';
 export type { IImageWidget } from './view/runs/ImageWidget';
+export type { TextWidget } from './view/runs/TextWidget';
+export type { WrPageWidget } from './model/document';
 export type { Border, Paragraph } from './view/Paragraph';
+export type { OverlayLayout } from './view/base/OverlayLayout';
 export type { Table } from './view/Table';
 export type { SubRenderer } from './view/TableCell';
 export type { Wtbl } from './model/document';
-export type { BoundedRegion } from './model/logic';
+export type { BoundedRegion, CheckTableRegion, _2DTableRegion } from './model/logic';
 export type { WidgetStateContext } from './widget/widget-state';

package/dist/core/interaction/InteractionController.d.ts

@@ -17,7 +17,7 @@ export declare class InteractionController {
     }): void;
     clearTableSelection(): void;
     onChangeDragHoverId(hitId: string): void;
-    resolveIntent(id: string | undefined): void;
+    resolveIntent(id: string | undefined, hitId: string | undefined): void;
     onActivePanelData(payload: {
         type: PanelType;
         modelId?: string;
@@ -39,5 +39,12 @@ export declare class InteractionController {
     onContextMenu(payload: ContextMenuParams & {
         contextMenuRef: any;
     }): void;
+    onChangeHeader2footerBool(visible: boolean): void;
+    onSetAnnotation(payload: {
+        ids: string[];
+        list: any[];
+        focus: string | null;
+    }): void;
+    onFocusAnnotation(payload: string | null): void;
     destroy(): void;
 }

package/dist/core/interaction/InteractionPolicy.d.ts

@@ -11,6 +11,8 @@ export declare class InteractionPolicy {
     constructor(doc: Doc);
     /** 是否允许输入 */
     canInput(run?: LayoutNode): boolean;
+    /** 是否允许删除 */
+    canBackspace(run?: LayoutNode): boolean;
     /** 事件前置拦截 */
     guardEvent(eventName: string, payload: any): boolean;
     /** 全局互斥规则 统一处理变量互斥 */

package/dist/core/interaction/types.d.ts

@@ -25,5 +25,13 @@ export type InteractionState = {
     }>> | null;
     /** 当前 focus 的字段校验批注信息  */
     focusValidation: string | '';
+    /** 页眉页脚配置开关 */
+    isHeaderFooterEdit: boolean;
+    /** 记录变更的字段列表 */
+    annotationIds: string[] | null;
+    /** 当前点击的记录变更 id */
+    focusAnnotationId: string | null;
+    /** 记录变更的详情信息列表 */
+    annotationList: any[] | null;
 };
 export type InteractionType = keyof InteractionState;

package/dist/core/interaction/useInteraction.d.ts

@@ -1,6 +1,6 @@
 import { Ref } from 'vue';
-import { EnginePublic } from '..';
-export declare function useInteraction(publicDocApi: Ref<EnginePublic | null>): {
+import { Doc } from '../view/Doc';
+export declare function useInteraction(docRef: Ref<Doc | null>): {
     readonly tableSelection?: {
         readonly tableId: string;
         readonly axis: "row" | "col" | "all";
@@ -12,12 +12,12 @@ export declare function useInteraction(publicDocApi: Ref<EnginePublic | null>):
     readonly focusTick?: number | undefined;
     readonly panelData?: {
         readonly panelType: import('../../domain/active/active-types').PanelType;
-        readonly widgetId?: string | undefined;
         readonly modelId?: string | undefined;
         readonly context: {
             readonly mainModelKey?: string | undefined;
             readonly subFieldKey?: string | undefined;
             readonly regionId?: string | undefined;
+            readonly secRefId?: string | undefined;
         };
     } | null | undefined;
     readonly validationCommentMap?: {
@@ -28,4 +28,8 @@ export declare function useInteraction(publicDocApi: Ref<EnginePublic | null>):
         }[];
     } | null | undefined;
     readonly focusValidation?: string | undefined;
+    readonly isHeaderFooterEdit?: boolean | undefined;
+    readonly annotationIds?: readonly string[] | null | undefined;
+    readonly focusAnnotationId?: string | null | undefined;
+    readonly annotationList?: readonly any[] | null | undefined;
 };

package/dist/core/layout/LayoutContext.d.ts

@@ -1,17 +1,20 @@
 import { Page, PageChild, PageOptions } from '../view/Page';
 import { Paragraph } from '../view/Paragraph';
-import { LayoutNode } from '../view/base';
+import { BandContainer, LayoutNode } from '../view/base';
 import { TableCell } from '../view/TableCell';
 import { Doc } from '../view/Doc';
 import { Section } from '../view/Section';
+import { OverlayLayout } from '../view/base/OverlayLayout';
 interface ContextOptions {
-    type: 'page' | 'cell';
+    type: 'page' | 'cell' | 'header' | 'footer' | 'overlayLayout';
     doc: Doc;
     section?: Section;
     page?: Page;
     cell?: TableCell;
     paragraph?: PageChild;
     layoutRun?: LayoutNode;
+    current?: OverlayLayout;
+    onPageCreated?: (page: Page) => void;
 }
 export declare class LayoutContext {
     type: ContextOptions['type'];
@@ -21,11 +24,14 @@ export declare class LayoutContext {
     cell?: TableCell;
     paragraph?: PageChild;
     layoutRun?: LayoutNode;
+    current?: OverlayLayout;
     modelRef?: {
         id: string;
     };
+    onPageCreated?: (page: Page) => void;
+    /** 当前 section 内的页码 */
     constructor(options: ContextOptions);
-    get container(): Page | TableCell;
+    get container(): Page | TableCell | BandContainer | OverlayLayout;
     updateSection(section: Section): void;
     updatePage(page: Page): void;
     updateParagraph(paragraph: PageChild): void;
@@ -37,6 +43,10 @@ export declare class LayoutContext {
     createNewParagraph(y?: number): Paragraph;
     resetModelRef(id: string): void;
     getRunX(): number;
+    /**
+     * 获取当前行剩余的空间
+     */
+    getParagraphRemainingSize(): number;
     addRun(run: LayoutNode): void;
     /**
      * 根据 dataIndex 替换 path 中的 [n] 为实际值

package/dist/core/layout/LayoutManager.d.ts

@@ -6,6 +6,20 @@ export declare class LayoutManager {
     private layoutHandlers;
     constructor(doc: Doc);
     layout(): void;
+    /**
+     * 当前页创建后，初始化页眉页脚和悬浮层
+     */
+    private decorateCurrentPage;
+    /**
+     * 布局页眉/页脚内部的段落和表格
+     */
+    private layoutHeaderFooterChildren;
+    /**
+     * 所有页布局完成后，在处理悬浮层，主要是要拿到实际总页数
+     */
+    private resolveOverlay;
+    /** 悬浮层内部的布局和段落 */
+    private layoutOverlayChildren;
     /**
      * 统一的表格布局内部方法
      */

package/dist/core/layout/LayoutMapper.d.ts

@@ -14,7 +14,6 @@ export declare class LayoutMapper {
     lineCenter: Map<string, LineInfo>;
     lineIdByPage: Map<string, string[]>;
     /** 组件信息中心 */
-    widgetMetaIds: Set<string>;
     widgetMetaMap: Map<string, any>;
     modelMap: Map<string, ModelMode>;
     modelSplitMap: Map<string, string[]>;
@@ -27,7 +26,6 @@ export declare class LayoutMapper {
     getAllPageIds(): string[];
     getLineIdsByPageId(pageId: string): string[];
     getLineInfoById(lineId: string): LineInfo | undefined;
-    getWidgetMetaIds(): string[];
     getWidgetMetaListById(wId: string): any;
     /**
      * 获取某个节点下的所有子节点

package/dist/core/layout/handlers/PageWidgetHandler.d.ts

@@ -0,0 +1,5 @@
+import { WrText } from '../../model/document';
+import { LayoutContext } from '../LayoutContext';
+export declare class PageWidgetHandler {
+    static layout(context: LayoutContext, wr: WrText): void;
+}

package/dist/core/layout/handlers/TextHandler.d.ts

@@ -2,5 +2,16 @@ import { WrText } from '../../model/document';
 import { LayoutContext } from '../LayoutContext';
 export declare class TextHandler {
     static getId(context: LayoutContext, wr: WrText): string;
+    /**
+     * 合并部分run
+     * @param context
+     * @param wr
+     */
+    static __layout(context: LayoutContext, wr: WrText): void;
+    /**
+     * 每个文本独立渲染
+     * @param context
+     * @param wr
+     */
     static layout(context: LayoutContext, wr: WrText): void;
 }

package/dist/core/layout/handlers/base/BaseHandler.d.ts

@@ -0,0 +1,26 @@
+import { WrText } from '../../../model/document';
+import { LayoutContext } from '../../LayoutContext';
+import { TextRun } from '../../../view/runs/TextRun';
+import { TableCell } from '../../../view/TableCell';
+export type HandlerContext = {
+    context: LayoutContext;
+    wr: WrText;
+};
+export declare abstract class BaseHandler {
+    context: LayoutContext;
+    wr: WrText;
+    constructor(ctx: HandlerContext);
+    /**
+     * 获取所在单元格
+     * @returns
+     */
+    getCell(): TableCell | null;
+    /**
+     * 获取所在子表的数据索引
+     * @returns
+     */
+    getDataIndex(init?: 0 | null): number | null;
+    getId(): string;
+    getLayoutStyle(): ReturnType<typeof TextRun.textStyle2LayoutStyle>;
+    abstract layout(): void;
+}

package/dist/core/layout/handlers/fields/{ImgHandler.d.ts → ImageHandler.d.ts}

@@ -1,5 +1,5 @@
 import { BaseHandler, HandlerContext } from './BaseHandler';
-export declare class ImgHandler extends BaseHandler {
+export declare class ImageHandler extends BaseHandler {
     static layout(ctx: HandlerContext): void;
     static layoutField(ctx: HandlerContext): void;
 }

package/dist/core/layout/handlers/fields/index.d.ts

@@ -1,6 +1,6 @@
 export { BaseHandler, type HandlerContext } from './BaseHandler';
 export { OptionHandler } from './OptionHandler';
-export { ImgHandler } from './ImgHandler';
+export { ImageHandler } from './ImageHandler';
 export { SignatureHandler } from './SignatureHandler';
 export { InputHandler } from './InputHandler';
 export { AttachmentHandler } from './AttachmentHandler';

package/dist/core/layout/handlers/index.d.ts

@@ -1,3 +1,4 @@
 export * from './TextHandler';
 export * from './ImageHandler';
 export * from './FieldHandler';
+export * from './PageWidgetHandler';

package/dist/core/layout/handlers/pageWidgets/BarcodeHandler.d.ts

@@ -0,0 +1,11 @@
+import { BaseHandler } from '../base/BaseHandler';
+import { ImageWidgetOptions } from '../../../view/runs/ImageWidget';
+export declare class BarcodeHandler extends BaseHandler {
+    getDecorationsInfo(width: number, height: number, label?: string): {
+        render: boolean;
+        rectWidth: number;
+        rectHeight: number;
+        decorations?: ImageWidgetOptions['decorations'];
+    };
+    layout(): void;
+}

package/dist/core/layout/handlers/pageWidgets/DefaultHandler.d.ts

@@ -0,0 +1,4 @@
+import { BaseHandler } from '../base/BaseHandler';
+export declare class DefaultHandler extends BaseHandler {
+    layout(): void;
+}

package/dist/core/layout/handlers/pageWidgets/DiagonalHandler.d.ts

@@ -0,0 +1,4 @@
+import { BaseHandler } from '../base/BaseHandler';
+export declare class DiagonalHandler extends BaseHandler {
+    layout(): void;
+}

package/dist/core/layout/handlers/pageWidgets/ImageHandler.d.ts

@@ -0,0 +1,4 @@
+import { BaseHandler } from '../base/BaseHandler';
+export declare class ImageHandler extends BaseHandler {
+    layout(): void;
+}

package/dist/core/layout/handlers/pageWidgets/LineHandler.d.ts

@@ -0,0 +1,4 @@
+import { BaseHandler } from '../base/BaseHandler';
+export declare class LineHandler extends BaseHandler {
+    layout(): void;
+}

package/dist/core/layout/handlers/pageWidgets/PaginationHandler.d.ts

@@ -0,0 +1,7 @@
+import { BaseHandler } from '../base/BaseHandler';
+export declare class PaginationHandler extends BaseHandler {
+    layout(): void;
+    /** 解析 ${no} ${total} */
+    private parseTokens;
+    private calcPagination;
+}

package/dist/core/layout/handlers/pageWidgets/QrCodeHandler.d.ts

@@ -0,0 +1,4 @@
+import { BaseHandler } from '../base/BaseHandler';
+export declare class QrCodeHandler extends BaseHandler {
+    layout(): void;
+}

package/dist/core/layout/handlers/pageWidgets/SerialNumberHandler.d.ts

@@ -0,0 +1,4 @@
+import { BaseHandler } from '../base/BaseHandler';
+export declare class SerialNumberHandler extends BaseHandler {
+    layout(): void;
+}

package/dist/core/layout/handlers/pageWidgets/index.d.ts

@@ -0,0 +1,8 @@
+export { SerialNumberHandler } from './SerialNumberHandler';
+export { DefaultHandler } from './DefaultHandler';
+export { QrCodeHandler } from './QrCodeHandler';
+export { BarcodeHandler } from './BarcodeHandler';
+export { ImageHandler } from './ImageHandler';
+export { DiagonalHandler } from './DiagonalHandler';
+export { PaginationHandler } from './PaginationHandler';
+export { LineHandler } from './LineHandler';

package/dist/core/layout/logic/LayoutBuilder.d.ts

@@ -6,7 +6,6 @@ export declare function buildLayoutMeta(pages: Page[]): {
     dataCenter: Map<string, BaseMetaNode>;
     lineCenter: Map<string, LineInfo>;
     widgetIds: string[];
-    widgetMetaIds: Set<string>;
     widgetMetaMap: Map<string, any>;
 };
 /** 是否是原子组件 */
@@ -14,15 +13,20 @@ export declare function isAtom(component: BuiltinComponentType): boolean;
 /** 判断是否为占位符文本原子节点 */
 export declare function isPlaceholderNode(node: any): boolean;
 /**
- * 判断是否点击是组件节点
+ * 判断是否点击是字段组件节点
  * @param node - 节点
  * @param checkMarker - 是否需要校验 widgetFieldLeftMarker / RightMarker，默认 true
  */
 export declare function isClickSelectAllNode(node: BaseMetaNode, checkMarker?: boolean): boolean;
 /**
- * 校验文本组件是否符合选中规则
+ * 校验组件是否符合选中规则
  * @param raw - 文本组件原始数据
  * @param checkMarker - 是否校验左右标记位
  * @returns 符合规则返回 true，否则返回 false
  */
 export declare function validateTextWidgetMarker(raw: TextWidget, checkMarker: boolean): boolean;
+/**
+ * 判断是否点击是页面组件节点
+ * @param node - 节点
+ */
+export declare function isClickPaperWidgetAllNode(node: BaseMetaNode): boolean;

package/dist/core/layout/logic/ModelBuilder.d.ts

@@ -1 +1,2 @@
-export declare function generateModelMap(node: any, map?: Map<string, any>): Map<string, any> | undefined;
+import { Doc } from '../../view/Doc';
+export declare function generateDocModelMap(doc: Doc): Map<string, any>;

package/dist/core/layout/providers/TableInfoProvider.d.ts

@@ -2,8 +2,8 @@ import { Wtbl, Wtc, Wtr } from '../../model/document';
 import { TableExpander, CellFragment } from '../../utils/expand';
 import { SubRenderer } from '../../view/TableCell';
 export declare class TableInfoProvider {
-    private wtbl;
-    private tableExpander;
+    wtbl: Wtbl;
+    tableExpander: TableExpander;
     constructor(wtbl: Wtbl, tableExpander: TableExpander);
     getRows(): {
         id: string;
@@ -20,4 +20,10 @@ export declare class TableInfoProvider {
         id: string;
     };
     getCellSubRenderer(cell: CellFragment): SubRenderer | undefined;
+    /**
+     * 获取当前行是都能分割
+     * @param rowIndex
+     * @returns
+     */
+    getAllowRowSplit(rowIndex: number): boolean;
 }

package/dist/core/layout/types/index.d.ts

@@ -4,6 +4,7 @@ import { TextRun } from '../../view/runs/TextRun';
 export type LineType = 'paragraph' | 'tablerow' | undefined;
 export interface BuildCtx {
     currentPageId: string;
+    area: 'body' | 'header' | 'footer' | 'overlay';
     lineId?: string;
     lineIndex: number;
     lineType?: LineType;
@@ -24,6 +25,8 @@ export interface LineInfo {
     type: 'tablerow' | 'paragraph';
     /** 纸张 id */
     pageId: string;
+    /** 所属区域 */
+    pageArea: 'body' | 'header' | 'footer' | 'overlay';
     /** 排序 */
     sort: number;
     nextIds: string[];
@@ -56,8 +59,12 @@ export interface BaseMetaNode {
     component: BuiltinComponentType;
     /** 组件节点信息 */
     raw?: LayoutNode;
+    /** 章节引用 id */
+    secRefId: string;
     /** 纸张 id */
     pageId: string;
+    /** 所属区域 */
+    pageArea: 'body' | 'header' | 'footer' | 'overlay';
     /** 上级节点 id */
     preId: string;
     /** 宽度 */

package/dist/core/model/DocModel.d.ts

@@ -1,7 +1,12 @@
 import { Wdocument } from './document';
 import { Wstyles } from './styles';
 import { Wimages } from './images';
+import { Wsettings } from './settings/Wsettings';
+import { Wheaders } from './headers/Wheaders';
+import { Wfooters } from './footers/Wfooters';
+import { Woverlays } from './overlays/Woverlays';
 import { Wr } from './document/Wp';
+import { Section } from '../view/Section';
 /**
  * Word 文档模型
  * 包含文档的所有组件（document、styles、images 等）
@@ -15,13 +20,21 @@ import { Wr } from './document/Wp';
  */
 export interface DocModelOptions {
     document: Wdocument;
+    headers: Wheaders;
+    footers: Wfooters;
     styles: Wstyles;
     images: Wimages;
+    settings: Wsettings;
+    overlays: Woverlays;
 }
 export declare class DocModel {
     document: Wdocument;
+    headers: Wheaders;
+    footers: Wfooters;
     styles: Wstyles;
     images: Wimages;
+    settings: Wsettings;
+    overlays: Woverlays;
     constructor(options: DocModelOptions);
     /**
      * 从原始 DOCX JSON 转换为 DocModel 实例
@@ -40,4 +53,11 @@ export declare class DocModel {
      * @returns Wr 实例数组（包含 widgetMeta 和 valuePath 的文本或图片 run）
      */
     getWidgetInstances(): Wr[];
+    /** 根据 pageIndex 获取页眉实例 */
+    getHeader(pageIndex: number, section: Section): import('./headers/Wheader').Wheader | null;
+    /** 根据 pageIndex 获取页脚实例 */
+    getFooter(pageIndex: number, section: Section): import('./footers/Wfooter').Wfooter | null;
+    /** 获取章节对应的浮层实例 */
+    getOverlay(section: Section): import('./overlays/Woverlay').Woverlay | null;
+    private collectSecPrs;
 }

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

@@ -1,4 +1,5 @@
 import { DocModel } from '../DocModel';
+import { WsecPr, Wtbl, Wp } from '../document';
 export interface ModelNodeOptions {
     id?: string;
     attrs?: Record<string, any>;
@@ -41,11 +42,14 @@ export declare abstract class ModelNode {
     static fromXmlJson(json: any): any;
     remove(): void;
     getCurrentIndex(): number;
+    getTopBlock<T extends Wp | Wtbl>(): T;
+    getSection<T extends WsecPr | null>(): T;
     /**
      * 获取根节点（顶层 DocModel 对象）
      * @returns DocModel 根节点，如果找不到则返回 null
      */
     getRoot(): DocModel | null;
+    getWlayout(): this | null;
     /**
      * 获取前一个兄弟节点
      * @returns 前一个兄弟节点，如果没有则返回 null