@gct-paas/word 0.1.13 → 0.1.15

package/dist/core/command/commands/DeleteTableHeader.d.ts

@@ -0,0 +1,12 @@
+import { Doc } from '../../view/Doc';
+import { CommandPayloadMap } from '../types';
+import { CommandBase, PostCommandContext } from '../base/CommandBase';
+/**
+ * 删除有界区域命令
+ *
+ * 删除指定的 table header 区域
+ */
+export declare class DeleteTableHeader extends CommandBase<'deleteTableHeader'> {
+    constructor(doc: Doc, payload?: CommandPayloadMap['deleteTableHeader']);
+    protected execute(): Promise<PostCommandContext>;
+}

package/dist/core/command/commands/InsertFloatingOverlay.d.ts

@@ -0,0 +1,9 @@
+import { CommandBase, PostCommandContext } from '../base/CommandBase';
+import { Doc } from '../../view/Doc';
+import { CommandPayloadMap } from '../types';
+type InsertFloatingOverlayCommandOptions = CommandPayloadMap['insertFloatingOverlay'];
+export declare class InsertFloatingOverlay extends CommandBase<'insertFloatingOverlay'> {
+    constructor(doc: Doc, payload: InsertFloatingOverlayCommandOptions);
+    protected execute(): Promise<PostCommandContext>;
+}
+export {};

package/dist/core/command/commands/InsertPaperWidget.d.ts

@@ -1,59 +1,19 @@
 import { CommandBase, PostCommandContext } from '../base/CommandBase';
 import { Doc } from '../../view/Doc';
 import { CommandPayloadMap } from '../types';
-import { Wp, Wtc } from '../../model/document';
-import { ModelNode } from '../../model/base';
+import { Wp } from '../../model/document';
 type InsertPaperWidgetCommandOptions = CommandPayloadMap['insertPaperWidget'];
 export declare class InsertPaperWidget extends CommandBase<'insertPaperWidget'> {
     constructor(doc: Doc, payload: InsertPaperWidgetCommandOptions);
     protected execute(): Promise<PostCommandContext>;
-    /**
-     * 处理折叠状态下的图片插入
-     */
-    private handleCollapseImage;
+    checkDiagonalWrapper(wp: Wp): boolean;
     /**
      * 处理折叠状态下的文本（字段）插入
      */
     private handleCollapseText;
-    /**
-     * 处理选区下的图片插入
-     */
-    private handleSelectionImage;
     /**
      * 处理选区下的文本（字段）插入
      */
     private handleSelectionText;
-    protected isRootField(valuePath?: string): boolean;
-    protected isNestedTableField(valuePath?: string): boolean;
-    /**
-     * 判断两个 valuePath 是否连续（父子关系）
-     * @param parentPath 父路径，如 "$.a[n]"
-     * @param childPath 子路径，如 "$.a[n].b" 或 "$.a[n].b[n].c"
-     * @returns 是否为连续的父子关系
-     *
-     * @example
-     * isConsecutivePath("$.a", "$.a.b")           // true
-     * isConsecutivePath("$.a[n]", "$.a[n].b")     // true
-     * isConsecutivePath("$.a[n].b[n]", "$.a[n].b[n].c") // true
-     * isConsecutivePath("$.a", "$.b")             // false
-     * isConsecutivePath("$.a[n].b", "$.a[n]")     // false (反向)
-     */
-    protected isConsecutivePath(parentPath: string, childPath: string): boolean;
-    /**
-     * 判断 childPath 是否可以在 parentPath 的循环区域中使用
-     * @param parentPath 循环区域的路径，不以 [n] 结尾，如 "$.a" 或 "$.a[n].b"
-     * @param childPath 要插入字段的路径，不以 [n] 结尾，如 "$.a.b" 或 "$.a[n].b.c"
-     * @returns 是否兼容
-     *
-     * @example
-     * isFieldPathCompatible("$.a", "$.a.b")              // true
-     * isFieldPathCompatible("$.a", "$.a[n].b")           // true - 去掉开头 [n] 后 .b 没有 [n]
-     * isFieldPathCompatible("$.a", "$.a[n].b[n].c")      // false - 去掉开头 [n] 后 .b[n].c 还有 [n]
-     * isFieldPathCompatible("$.a[n].b", "$.a[n].b.c")    // true
-     * isFieldPathCompatible("$.a[n].b", "$.a[n].b[n].c") // false - 去掉开头 [n] 后 .c 实际上应该检查原逻辑
-     */
-    protected isFieldPathCompatible(parentPath: string, childPath: string): boolean;
-    protected getAncestorCell(node: ModelNode): Wtc | null;
-    protected validateFieldPath(valuePath: string | undefined, node: Wp): boolean;
 }
 export {};

package/dist/core/command/commands/ResizeOverlayLayout.d.ts

@@ -0,0 +1,7 @@
+import { CommandBase, PostCommandContext } from '../base/CommandBase';
+import { Doc } from '../../view/Doc';
+import { CommandPayloadMap } from '../types';
+export declare class ResizeOverlayLayout extends CommandBase<'resizeOverlayLayout'> {
+    constructor(doc: Doc, payload: CommandPayloadMap['resizeOverlayLayout']);
+    protected execute(): Promise<PostCommandContext>;
+}

package/dist/core/command/commands/Set2DTable.d.ts

@@ -0,0 +1,7 @@
+import { CommandBase, PostCommandContext } from '../base/CommandBase';
+import { Doc } from '../../view/Doc';
+import { CommandPayloadMap } from '../types';
+export declare class Set2DTable extends CommandBase<'set2DTable'> {
+    constructor(doc: Doc, payload?: CommandPayloadMap['set2DTable']);
+    protected execute(): Promise<PostCommandContext>;
+}

package/dist/core/command/commands/SetCheckTable.d.ts

@@ -0,0 +1,7 @@
+import { CommandBase, PostCommandContext } from '../base/CommandBase';
+import { Doc } from '../../view/Doc';
+import { CommandPayloadMap } from '../types';
+export declare class SetCheckTable extends CommandBase<'setCheckTable'> {
+    constructor(doc: Doc, payload?: CommandPayloadMap['setCheckTable']);
+    protected execute(): Promise<PostCommandContext>;
+}

package/dist/core/command/commands/SetDataGroup2D.d.ts

@@ -0,0 +1,25 @@
+import { CommandBase, PostCommandContext } from '../base/CommandBase';
+import { Doc } from '../../view/Doc';
+import { Wtc } from '../../model/document';
+import { CheckTableRegion, _2DTableRegion, Region } from '../../model/logic';
+import { CommandPayloadMap } from '../types';
+type DataGroup2DSubTableRegion = CheckTableRegion | _2DTableRegion;
+export declare class SetDataGroup2D extends CommandBase<'setDataGroup2D'> {
+    constructor(doc: Doc, payload?: CommandPayloadMap['setDataGroup2D']);
+    protected execute(): Promise<PostCommandContext>;
+    /**
+     *
+     * @param startCell
+     * @param endCell
+     * @returns
+     */
+    protected getSubTableRegion(startCell: Wtc, endCell: Wtc): DataGroup2DSubTableRegion | undefined;
+    /**
+     * 获取公共区域
+     * @param startCell
+     * @param endCell
+     * @returns
+     */
+    protected getRegion(startCell: Wtc, endCell: Wtc): Region | undefined;
+}
+export {};

package/dist/core/command/commands/SetHeaderFooterConfig.d.ts

@@ -0,0 +1,11 @@
+import { Doc } from '../../view/Doc';
+import { CommandPayloadMap } from '../types';
+import { CommandBase, PostCommandContext } from '../base/CommandBase';
+/**
+ * 设置页眉页脚配置（全局生效）
+ * 会遍历文档中所有 WsecPr 节点并统一写入
+ */
+export declare class SetHeaderFooterConfig extends CommandBase {
+    constructor(doc: Doc, payload: CommandPayloadMap['setHeaderFooterConfig']);
+    protected execute(): Promise<PostCommandContext>;
+}

package/dist/core/command/commands/SetSubTableHeader.d.ts

@@ -0,0 +1,8 @@
+import { CommandBase, PostCommandContext } from '../base/CommandBase';
+import { Doc } from '../../view/Doc';
+import { CommandPayloadMap } from '../types';
+export declare class SetSubTableHeader extends CommandBase<'setSubTableHeader'> {
+    constructor(doc: Doc, payload?: CommandPayloadMap['setSubTableHeader']);
+    protected execute(): Promise<PostCommandContext>;
+    private getSubTableRegion;
+}

package/dist/core/command/commands/SetTableHeader.d.ts

@@ -0,0 +1,7 @@
+import { CommandBase, PostCommandContext } from '../base/CommandBase';
+import { Doc } from '../../view/Doc';
+import { CommandPayloadMap } from '../types';
+export declare class SetTableHeader extends CommandBase<'setTableHeader'> {
+    constructor(doc: Doc, payload?: CommandPayloadMap['setTableHeader']);
+    protected execute(): Promise<PostCommandContext>;
+}

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

@@ -2,6 +2,7 @@ import { VOrientationType } from '../../domain/constants/enum';
 import { Doc } from '../view/Doc';
 import { WidgetMeta } from '../widget/widget-meta';
 import { WordHighlight } from '../model/types';
+import { PointerHitResult } from '../cursor/hit/types';
 export interface CursorMeta {
     nodeId: string;
     offset: number;
@@ -27,11 +28,13 @@ export type CommandConstructor = new (doc: Doc, payload?: any) => ICommand<any>;
 export declare const CommandType: {
     readonly setOrient: "setOrient";
     readonly setPadding: "setPadding";
+    readonly setHeaderFooterConfig: "setHeaderFooterConfig";
     readonly insertText: "insertText";
     readonly insertTable: "insertTable";
     readonly insertImage: "insertImage";
     readonly insertField: "insertField";
     readonly insertPaperWidget: "insertPaperWidget";
+    readonly insertFloatingOverlay: "insertFloatingOverlay";
     readonly delete: "delete";
     readonly backspace: "backspace";
     readonly enter: "enter";
@@ -44,12 +47,21 @@ export declare const CommandType: {
     readonly setUnderline: "setUnderline";
     readonly setStrike: "setStrike";
     readonly setAlign: "setAlign";
+    readonly setTableHeader: "setTableHeader";
+    readonly deleteTableHeader: "deleteTableHeader";
     readonly setRepeating: "setRepeating";
+    readonly set2DTable: "set2DTable";
     readonly setBounded: "setBounded";
     readonly setBoundedItem: "setBoundedItem";
+    readonly setCheckTable: "setCheckTable";
+    readonly setDataGroup2D: "setDataGroup2D";
+    readonly setSubTableHeader: "setSubTableHeader";
     readonly deleteRepeating: "deleteRepeating";
+    readonly delete2DTable: "delete2DTable";
     readonly deleteBounded: "deleteBounded";
     readonly deleteBoundedItem: "deleteBoundedItem";
+    readonly deleteCheckTable: "deleteCheckTable";
+    readonly deleteDataGroup2D: "deleteDataGroup2D";
     readonly insertRow: "insertRow";
     readonly insertCol: "insertCol";
     readonly deleteRow: "deleteRow";
@@ -61,6 +73,7 @@ export declare const CommandType: {
     readonly resizeImage: "resizeImage";
     readonly resizeCol: "resizeCol";
     readonly resizeRow: "resizeRow";
+    readonly resizeOverlayLayout: "resizeOverlayLayout";
 };
 export type CommandType = ValueOf<typeof CommandType>;
 /**
@@ -84,8 +97,11 @@ export type CommandPayloadMap = {
         valuePath: string;
     };
     insertPaperWidget: CommandPayload & {
-        widgetMeta: WidgetMeta;
-        valuePath: string;
+        pageWidgetMeta: WidgetMeta;
+    };
+    insertFloatingOverlay: CommandPayload & {
+        hit: PointerHitResult;
+        pageWidgetMeta: WidgetMeta;
     };
     delete: CommandPayload & Record<string, never>;
     backspace: CommandPayload & Record<string, never>;
@@ -95,6 +111,13 @@ export type CommandPayloadMap = {
     };
     setPadding: CommandPayload & {
         padding: [number, number, number, number];
+        serRefId: string;
+    };
+    setHeaderFooterConfig: CommandPayload & {
+        headerMargin?: number;
+        footerMargin?: number;
+        titlePg?: boolean;
+        evenAndOddHeaders?: boolean;
     };
     setHighlight: CommandPayload & {
         highlight: WordHighlight;
@@ -127,15 +150,34 @@ export type CommandPayloadMap = {
         name: string;
         valuePath: string;
     };
+    set2DTable: CommandPayload & {
+        name: string;
+        valuePath: string;
+    };
     setBounded: CommandPayload & {
         name: string;
         valuePath: string;
     };
     setBoundedItem: CommandPayload & Record<string, never>;
+    setCheckTable: CommandPayload & {
+        name: string;
+        valuePath: string;
+    };
+    setDataGroup2D: CommandPayload & Record<string, never>;
+    setTableHeader: CommandPayload & {
+        name: string;
+    };
+    setSubTableHeader: CommandPayload & {
+        name: string;
+    };
     deleteRepeating: CommandPayload & {
         tableId: string;
         regionId: string;
     };
+    delete2DTable: CommandPayload & {
+        tableId: string;
+        regionId: string;
+    };
     deleteBounded: CommandPayload & {
         tableId: string;
         regionId: string;
@@ -144,6 +186,18 @@ export type CommandPayloadMap = {
         tableId: string;
         regionId: string;
     };
+    deleteCheckTable: CommandPayload & {
+        tableId: string;
+        regionId: string;
+    };
+    deleteDataGroup2D: CommandPayload & {
+        tableId: string;
+        regionId: string;
+    };
+    deleteTableHeader: CommandPayload & {
+        tableId: string;
+        regionId: string;
+    };
     insertRow: CommandPayload & {
         tableId: string;
         rowIndex: number;
@@ -185,11 +239,21 @@ export type CommandPayloadMap = {
         rowIndex: number;
         height: number;
     };
+    resizeOverlayLayout: CommandPayload & {
+        id: string;
+        pos: {
+            width: number;
+            height: number;
+            x?: number;
+            y?: number;
+        };
+        needsReLayout?: boolean;
+    };
 };
 /**
  * payload 可选的命令类型（不需要额外参数）
  */
-export type OptionalPayloadCommands = 'delete' | 'backspace' | 'enter' | 'setBoundedItem' | 'mergeCells' | 'unmergeCells' | 'snapshot';
+export type OptionalPayloadCommands = 'delete' | 'backspace' | 'enter' | 'setBoundedItem' | 'setDataGroup2D' | 'mergeCells' | 'unmergeCells' | 'setTableHeader' | 'setSubTableHeader' | 'snapshot';
 /**
  * 必须提供 payload 的命令类型
  */

package/dist/core/constants/index.d.ts

@@ -3,6 +3,13 @@ import { ExternalNodeType } from '../../domain/widget/component-type';
 export declare const BuiltinComponentTypeConst: {
     /** 纸张 */
     readonly Paper: "paper";
+    /** 页眉 */
+    readonly Header: "header";
+    /** 页脚 */
+    readonly Footer: "footer";
+    /** 浮层容器 */
+    readonly OverlayContainer: "overlay-container";
+    readonly OverlayLayout: "overlay-layout";
     /** 段落 */
     readonly Paragraph: "paragraph";
     /** 文本 */

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,16 +1,18 @@
-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';
 export { ModelConverter } from './model';
 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';
@@ -21,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] 为实际值