@guodun/antdv 1.4.1 → 1.4.3

package/dist/types/components/pro-contract-template-designer/src/DesignerPage.vue.d.ts

@@ -1,38 +1,12 @@
 import { JSONContent } from '@tiptap/core';
-import { ContractTemplateEditorCommand, ContractTemplateEditorState, ContractTemplateEditorTextAlign, ContractTemplateContentImage, ContractTemplateFieldType, ContractTemplatePage, ContractTemplatePageSize, ContractTemplateSelectedContentImage, ContractTemplateSigningPlacement, ContractTemplateSigningPlacementType, ContractTemplateTableCommandCapabilities, ContractTemplateVariable } from './types';
+import { ContractTemplateEditorCommand, ContractTemplateEditorContextMenuPayload, ContractTemplateEditorState, ContractTemplateContentImage, ContractTemplateFieldType, ContractTemplatePage, ContractTemplatePageDecorations, ContractTemplatePageSize, ContractTemplateSigningPlacement, ContractTemplateSigningPlacementType, ContractTemplateTableCommandCapabilities, ContractTemplateVariable } from './types';
 import { ContractTemplateSigningPlacementDragPayload } from './utils/signing-placement';
-/** 右键菜单载荷：图片节点优先，其次按既有规则落到正文或表格菜单。 */
-type EditorContextMenuPayload = {
-    type: 'text';
-    pageId: string;
-    clientX: number;
-    clientY: number;
-    hasSelection: boolean;
-    selectionWidth?: number;
-    leadingText?: string;
-} | {
-    type: 'image';
-    pageId: string;
-    clientX: number;
-    clientY: number;
-    image: ContractTemplateSelectedContentImage;
-} | {
-    type: 'table';
-    pageId: string;
-    clientX: number;
-    clientY: number;
-    capabilities: ContractTemplateTableCommandCapabilities;
-    activeAlignment: ContractTemplateEditorTextAlign | 'mixed';
-    affectedVariableCounts: {
-        deleteRow: number;
-        deleteColumn: number;
-        deleteTable: number;
-    };
-};
 type __VLS_Props = {
     page: ContractTemplatePage;
     pageIndex: number;
     pageSize: ContractTemplatePageSize;
+    pageDecorations?: ContractTemplatePageDecorations;
+    totalPages?: number;
     variables: ContractTemplateVariable[];
     selectedVariableKey?: string;
     active?: boolean;
@@ -43,6 +17,19 @@ type __VLS_Props = {
     selectedSigningPlacementId?: string;
     processImageFile?: (file: File) => Promise<string | null>;
 };
+/**
+ * 选区在视口坐标下的包围盒；供选区气泡工具条定位。
+ *
+ * 「哪种选区不配气泡」的判断收在这里：空选区、`CellSelection`、`NodeSelection`
+ * 一律返回 `undefined`，父组件就不用再去猜 `isTableActive` 的语义
+ * （光标只是落在表格里时它也为真，那种情况气泡应该照常出现）。
+ */
+declare function getSelectionViewportRect(): {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+} | undefined;
 /**
  * 探测每个表格命令当前是否可用，用于禁用右键菜单里不适用的项。
  *
@@ -57,6 +44,13 @@ declare function getTableCommandCapabilities(): ContractTemplateTableCommandCapa
  * 但事务不会被提交到 view，因此这里只是「试算」，编辑器内容保持不变。
  */
 declare function getAffectedVariableCount(action: 'delete-table-row' | 'delete-table-column' | 'delete-table'): number;
+/**
+ * 由选区气泡的「更多」调起完整正文右键菜单。
+ *
+ * 走同一条 `emitTextContextMenu` 通道，选区宽度与前置文字仍在页面内一次算好，
+ * 父组件不需要为气泡再拼一份会漂移的载荷。
+ */
+declare function requestTextContextMenu(clientX: number, clientY: number): void;
 /**
  * 汇总工具栏需要的编辑器状态。
  *
@@ -127,7 +121,7 @@ declare function removeVariable(variableKey: string): ContractTemplatePage | und
 declare function scrollIntoVariable(variableKey: string): boolean;
 /** 滚动到指定签署位置；签署层在正文之外，只能按 `data-signing-placement-id` 找。 */
 declare function scrollIntoSigningPlacement(placementId: string): boolean;
-/** 执行一条编辑器命令；样式预设走本地实现，其余交给统一的命令映射。 */
+/** 执行一条编辑器命令；段落样式与历史预设保留各自的兼容实现。 */
 declare function runCommand(command: ContractTemplateEditorCommand): void;
 declare function focus(): void;
 declare function getJSON(): JSONContent | undefined;
@@ -148,6 +142,8 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
     insertContentImage: typeof insertContentImage;
     updateSelectedContentImage: typeof updateSelectedContentImage;
     getSelectionRange: typeof getSelectionRange;
+    getSelectionViewportRect: typeof getSelectionViewportRect;
+    requestTextContextMenu: typeof requestTextContextMenu;
     hasOverflowContent: typeof hasOverflowContent;
     updateVariable: typeof updateVariable;
     removeVariable: typeof removeVariable;
@@ -169,7 +165,7 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
     "variable-move-blocked": (pageId: string) => any;
     "editor-focus": (pageId: string) => any;
     "editor-state-change": (pageId: string, state: ContractTemplateEditorState) => any;
-    "editor-context-menu": (payload: EditorContextMenuPayload) => any;
+    "editor-context-menu": (payload: ContractTemplateEditorContextMenuPayload) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     "onPage-update"?: ((page: ContractTemplatePage) => any) | undefined;
     "onVariable-drop"?: ((pageId: string, type: ContractTemplateFieldType, clientX: number, clientY: number) => any) | undefined;
@@ -181,12 +177,14 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
     "onVariable-move-blocked"?: ((pageId: string) => any) | undefined;
     "onEditor-focus"?: ((pageId: string) => any) | undefined;
     "onEditor-state-change"?: ((pageId: string, state: ContractTemplateEditorState) => any) | undefined;
-    "onEditor-context-menu"?: ((payload: EditorContextMenuPayload) => any) | undefined;
+    "onEditor-context-menu"?: ((payload: ContractTemplateEditorContextMenuPayload) => any) | undefined;
 }>, {
     disabled: boolean;
     readonly: boolean;
     active: boolean;
     zoom: number;
+    totalPages: number;
+    pageDecorations: ContractTemplatePageDecorations;
     signingPlacements: ContractTemplateSigningPlacement[];
     processImageFile: (file: File) => Promise<string | null>;
     selectedVariableKey: string;

package/dist/types/components/pro-contract-template-designer/src/ProContractTemplateDesigner.vue.d.ts

@@ -1,4 +1,4 @@
-import { ContractTemplateContentImage, ContractTemplateData, ContractTemplateFile, ContractTemplateFilesExportResult, ContractLocationRule, ContractTemplateDesignerProps, ContractTemplateDraftCacheStatus, ContractTemplateEditorCommand, ContractTemplateEditorTextAlign, ContractTemplateFieldStyle, ContractTemplatePageSize, ContractTemplateLocationRule, ContractTemplateLocationRuleOptions, ContractTemplateSigningPlacement, ContractTemplateSigningPlacementType, ContractTemplateTableCommandCapabilities, ContractTemplateValidationError, ContractTemplateVariable } from './types';
+import { ContractTemplateContentImage, ContractTemplateData, ContractTemplateFile, ContractTemplateFilesExportResult, ContractLocationRule, ContractTemplateDesignerProps, ContractTemplateDraftCacheStatus, ContractTemplateEditorCommand, ContractTemplateEditorState, ContractTemplateEditorTextAlign, ContractTemplateFieldStyle, ContractTemplateFieldType, ContractTemplatePageDecorations, ContractTemplatePageSize, ContractTemplateLocationRule, ContractTemplateLocationRuleOptions, ContractTemplateSigningPlacement, ContractTemplateSigningPlacementType, ContractTemplateTableInsertOptions, ContractTemplateTableCommandCapabilities, ContractTemplateValidationError, ContractTemplateVariable } from './types';
 import { ContractTemplateImageSource } from './utils/content-image';
 declare const _default: import('vue').DefineComponent<ContractTemplateDesignerProps, {
     getValue: () => ContractTemplateData;
@@ -86,29 +86,225 @@ declare const _default: import('vue').DefineComponent<ContractTemplateDesignerPr
     height: string | number;
     readonly: boolean;
     pageSize: ContractTemplatePageSize;
+    showDraftCacheStatus: boolean;
+    showClearButton: boolean;
+    showSubmitDataViewer: boolean;
     showSigningPlacementTools: boolean;
     maxPages: number;
     variableTypes: import('./types').ContractTemplateFieldTypeOption[];
     defaultVariableStyle: ContractTemplateFieldStyle;
     fontFamilies: import('./types').ContractTemplateFontFamilyOption[];
     fontFamilyMode: import('./types').ContractTemplateFontFamilyMode;
-    showSubmitDataViewer: boolean;
-    showClearButton: boolean;
     enableDraftCache: boolean;
     draftCacheKey: string;
     draftCacheInterval: number;
     draftCacheMaxBytes: number;
-    showDraftCacheStatus: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     designerElement: HTMLDivElement;
     workspaceElement: HTMLElement;
-    toolbarMainElement: HTMLDivElement;
-    toolbarMoreElement: HTMLDivElement;
-    toolbarInsertSlotElement: HTMLDivElement;
-    toolbarTypographySlotElement: HTMLDivElement;
-    toolbarCleanupSlotElement: HTMLDivElement;
-    toolbarTableSlotElement: HTMLDivElement;
+    workspaceHeaderElement: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<{
+        summary: string;
+        draftCacheStatusText: string;
+        draftCacheStatusClass: Record<string, boolean>;
+        showDraftCacheStatus: boolean;
+        showClearButton: boolean;
+        showSubmitDataViewer: boolean;
+        readonly: boolean;
+        zoomPercent: string;
+        zoomOutDisabled: boolean;
+        zoomInDisabled: boolean;
+        isFullscreen: boolean;
+        immersive: boolean;
+        pageDecorationsOpen: boolean;
+        pageDecorationsStudioId: string;
+        pageDecorationsPresetLabel: string;
+        pageDecorationsEnabledCount: number;
+        pageDecorationsEnabledStates: {
+            header: boolean;
+            footer: boolean;
+            watermark: boolean;
+        };
+        chromeControlsId: string;
+    }> & Readonly<{
+        onClear?: (() => any) | undefined;
+        onValidate?: (() => any) | undefined;
+        onPreview?: (() => any) | undefined;
+        onFitWidth?: (() => any) | undefined;
+        onZoomOut?: (() => any) | undefined;
+        onZoomIn?: (() => any) | undefined;
+        onResetZoom?: (() => any) | undefined;
+        onToggleFullscreen?: (() => any) | undefined;
+        onToggleImmersive?: (() => any) | undefined;
+        onSubmitData?: (() => any) | undefined;
+        onTogglePageDecorations?: (() => any) | undefined;
+        onToggleChrome?: (() => any) | undefined;
+    }>, {
+        focusPageDecorations: () => void | undefined;
+        focusImmersive: () => void | undefined;
+        focusChromeToggle: () => void | undefined;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+        clear: () => any;
+        validate: () => any;
+        preview: () => any;
+        fitWidth: () => any;
+        zoomOut: () => any;
+        zoomIn: () => any;
+        resetZoom: () => any;
+        toggleFullscreen: () => any;
+        toggleImmersive: () => any;
+        submitData: () => any;
+        togglePageDecorations: () => any;
+        toggleChrome: () => any;
+    }, import('vue').PublicProps, {}, false, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
+        workspaceHeader: HTMLElement;
+    }, HTMLElement, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<{
+        summary: string;
+        draftCacheStatusText: string;
+        draftCacheStatusClass: Record<string, boolean>;
+        showDraftCacheStatus: boolean;
+        showClearButton: boolean;
+        showSubmitDataViewer: boolean;
+        readonly: boolean;
+        zoomPercent: string;
+        zoomOutDisabled: boolean;
+        zoomInDisabled: boolean;
+        isFullscreen: boolean;
+        immersive: boolean;
+        pageDecorationsOpen: boolean;
+        pageDecorationsStudioId: string;
+        pageDecorationsPresetLabel: string;
+        pageDecorationsEnabledCount: number;
+        pageDecorationsEnabledStates: {
+            header: boolean;
+            footer: boolean;
+            watermark: boolean;
+        };
+        chromeControlsId: string;
+    }> & Readonly<{
+        onClear?: (() => any) | undefined;
+        onValidate?: (() => any) | undefined;
+        onPreview?: (() => any) | undefined;
+        onFitWidth?: (() => any) | undefined;
+        onZoomOut?: (() => any) | undefined;
+        onZoomIn?: (() => any) | undefined;
+        onResetZoom?: (() => any) | undefined;
+        onToggleFullscreen?: (() => any) | undefined;
+        onToggleImmersive?: (() => any) | undefined;
+        onSubmitData?: (() => any) | undefined;
+        onTogglePageDecorations?: (() => any) | undefined;
+        onToggleChrome?: (() => any) | undefined;
+    }>, {
+        focusPageDecorations: () => void | undefined;
+        focusImmersive: () => void | undefined;
+        focusChromeToggle: () => void | undefined;
+    }, {}, {}, {}, {}> | null;
+    workspaceChromeHandleElement: HTMLButtonElement;
+    immersiveExitElement: HTMLButtonElement;
     canvasElement: HTMLDivElement;
+    pageDecorationsStudioElement: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<{
+        id?: string;
+        open: boolean;
+        decorations?: ContractTemplatePageDecorations;
+        variables: ContractTemplateVariable[];
+        fontFamilyOptions: Array<{
+            label: string;
+            value: string;
+        }>;
+        readonly: boolean;
+        disabled: boolean;
+        activeTab?: "header" | "footer" | "watermark";
+    }> & Readonly<{
+        onChange?: ((value: ContractTemplatePageDecorations) => any) | undefined;
+        onClose?: (() => any) | undefined;
+        "onUpdate:activeTab"?: ((value: "footer" | "header" | "watermark") => any) | undefined;
+    }>, {
+        focusField: (path: import('./utils/page-decorations').ContractTemplatePageDecorationFieldPath) => Promise<void>;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+        change: (value: ContractTemplatePageDecorations) => any;
+        close: () => any;
+        "update:activeTab": (value: "footer" | "header" | "watermark") => any;
+    }, import('vue').PublicProps, {}, false, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
+        studioRoot: HTMLElement;
+        inspectorRef: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<{
+            decorations?: ContractTemplatePageDecorations;
+            variables: ContractTemplateVariable[];
+            fontFamilyOptions: Array<{
+                label: string;
+                value: string;
+            }>;
+            readonly: boolean;
+            disabled: boolean;
+            activeTab?: "header" | "footer" | "watermark";
+            embedded?: boolean;
+        }> & Readonly<{
+            onChange?: ((value: ContractTemplatePageDecorations) => any) | undefined;
+            "onUpdate:activeTab"?: ((value: "footer" | "header" | "watermark") => any) | undefined;
+        }>, {
+            resetToDefault: () => void;
+        }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+            change: (value: ContractTemplatePageDecorations) => any;
+            "update:activeTab": (value: "footer" | "header" | "watermark") => any;
+        }, import('vue').PublicProps, {
+            embedded: boolean;
+        }, false, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, HTMLElement, import('vue').ComponentProvideOptions, {
+            P: {};
+            B: {};
+            D: {};
+            C: {};
+            M: {};
+            Defaults: {};
+        }, Readonly<{
+            decorations?: ContractTemplatePageDecorations;
+            variables: ContractTemplateVariable[];
+            fontFamilyOptions: Array<{
+                label: string;
+                value: string;
+            }>;
+            readonly: boolean;
+            disabled: boolean;
+            activeTab?: "header" | "footer" | "watermark";
+            embedded?: boolean;
+        }> & Readonly<{
+            onChange?: ((value: ContractTemplatePageDecorations) => any) | undefined;
+            "onUpdate:activeTab"?: ((value: "footer" | "header" | "watermark") => any) | undefined;
+        }>, {
+            resetToDefault: () => void;
+        }, {}, {}, {}, {
+            embedded: boolean;
+        }> | null;
+    }, HTMLElement, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<{
+        id?: string;
+        open: boolean;
+        decorations?: ContractTemplatePageDecorations;
+        variables: ContractTemplateVariable[];
+        fontFamilyOptions: Array<{
+            label: string;
+            value: string;
+        }>;
+        readonly: boolean;
+        disabled: boolean;
+        activeTab?: "header" | "footer" | "watermark";
+    }> & Readonly<{
+        onChange?: ((value: ContractTemplatePageDecorations) => any) | undefined;
+        onClose?: (() => any) | undefined;
+        "onUpdate:activeTab"?: ((value: "footer" | "header" | "watermark") => any) | undefined;
+    }>, {
+        focusField: (path: import('./utils/page-decorations').ContractTemplatePageDecorationFieldPath) => Promise<void>;
+    }, {}, {}, {}, {}> | null;
     tableContextMenuElement: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<{
         capabilities: ContractTemplateTableCommandCapabilities;
         activeAlignment: ContractTemplateEditorTextAlign | "mixed";
@@ -140,8 +336,256 @@ declare const _default: import('vue').DefineComponent<ContractTemplateDesignerPr
         focusFirstItem: () => void;
         getMenuElement: () => HTMLElement | undefined;
     }, {}, {}, {}, {}> | null;
-    imageContextMenuElement: HTMLDivElement;
-    textContextMenuElement: HTMLDivElement;
+    imageContextMenuElement: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<{
+        width?: number | undefined;
+        height?: number | undefined;
+    } & {
+        x: number;
+        y: number;
+        readonly: boolean;
+    }> & Readonly<{
+        onKeydown?: ((event: KeyboardEvent) => any) | undefined;
+        onRestore?: (() => any) | undefined;
+        onApply?: (() => any) | undefined;
+        "onUpdate:width"?: ((value: number | undefined) => any) | undefined;
+        "onUpdate:height"?: ((value: number | undefined) => any) | undefined;
+    }>, {
+        getMenuElement: () => HTMLElement | undefined;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+        keydown: (event: KeyboardEvent) => any;
+        restore: () => any;
+        apply: () => any;
+        "update:width": (value: number | undefined) => any;
+        "update:height": (value: number | undefined) => any;
+    }, import('vue').PublicProps, {}, false, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
+        menuElement: HTMLDivElement;
+    }, HTMLDivElement, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<{
+        width?: number | undefined;
+        height?: number | undefined;
+    } & {
+        x: number;
+        y: number;
+        readonly: boolean;
+    }> & Readonly<{
+        onKeydown?: ((event: KeyboardEvent) => any) | undefined;
+        onRestore?: (() => any) | undefined;
+        onApply?: (() => any) | undefined;
+        "onUpdate:width"?: ((value: number | undefined) => any) | undefined;
+        "onUpdate:height"?: ((value: number | undefined) => any) | undefined;
+    }>, {
+        getMenuElement: () => HTMLElement | undefined;
+    }, {}, {}, {}, {}> | null;
+    textContextMenuElement: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<{
+        bindOpen?: boolean;
+        bindKeyword?: string;
+    } & {
+        x: number;
+        y: number;
+        hasSelection: boolean;
+        editorState: ContractTemplateEditorState;
+        fontSizePresetOptions: Array<{
+            label: string;
+            value: number | string;
+        }>;
+        currentEditorFontSize: number;
+        editorFontSizeSearchValue: string;
+        textAlignOptions: Array<{
+            label: string;
+            value: ContractTemplateEditorTextAlign;
+        }>;
+        currentEditorTextColor: string;
+        bodyControlToolItems: Array<{
+            type: ContractTemplateFieldType;
+            label: string;
+            icon: import('vue').Component;
+        }>;
+        textMenuBindableVariables: ContractTemplateVariable[];
+        pageLimitReached: boolean;
+        tableInsertDraft: ContractTemplateTableInsertOptions;
+        variablesCount: number;
+        resolveBindVariableTypeLabel: (variable: ContractTemplateVariable) => string;
+    }> & Readonly<{
+        onKeydown?: ((event: KeyboardEvent) => any) | undefined;
+        onCommand?: ((command: ContractTemplateEditorCommand) => any) | undefined;
+        "onPatch-font-size"?: ((value: unknown) => any) | undefined;
+        "onPatch-color"?: ((value: string) => any) | undefined;
+        "onPatch-text-align"?: ((value: unknown) => any) | undefined;
+        "onInsert-variable"?: ((type: ContractTemplateFieldType) => any) | undefined;
+        "onAdd-page"?: (() => any) | undefined;
+        "onFont-size-search"?: ((value: string) => any) | undefined;
+        "onFont-size-commit"?: (() => any) | undefined;
+        "onFont-size-dropdown-change"?: ((open: boolean) => any) | undefined;
+        "onFont-size-keydown"?: ((event: KeyboardEvent) => any) | undefined;
+        onClipboard?: ((command: "copy" | "cut" | "paste") => any) | undefined;
+        "onOpen-image"?: (() => any) | undefined;
+        "onBind-variable"?: ((variable: ContractTemplateVariable) => any) | undefined;
+        "onOpen-bind-panel"?: (() => any) | undefined;
+        "onUpdate:bindOpen"?: ((value: boolean) => any) | undefined;
+        "onUpdate:bindKeyword"?: ((value: string) => any) | undefined;
+    }>, {
+        getMenuElement: () => HTMLElement | undefined;
+        focusBindSearch: () => void;
+        focusFirstButton: () => void;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+        keydown: (event: KeyboardEvent) => any;
+        command: (command: ContractTemplateEditorCommand) => any;
+        "patch-font-size": (value: unknown) => any;
+        "patch-color": (value: string) => any;
+        "patch-text-align": (value: unknown) => any;
+        "insert-variable": (type: ContractTemplateFieldType) => any;
+        "add-page": () => any;
+        "font-size-search": (value: string) => any;
+        "font-size-commit": () => any;
+        "font-size-dropdown-change": (open: boolean) => any;
+        "font-size-keydown": (event: KeyboardEvent) => any;
+        clipboard: (command: "copy" | "cut" | "paste") => any;
+        "open-image": () => any;
+        "bind-variable": (variable: ContractTemplateVariable) => any;
+        "open-bind-panel": () => any;
+        "update:bindOpen": (value: boolean) => any;
+        "update:bindKeyword": (value: string) => any;
+    }, import('vue').PublicProps, {}, false, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
+        menuElement: HTMLDivElement;
+    }, HTMLDivElement, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<{
+        bindOpen?: boolean;
+        bindKeyword?: string;
+    } & {
+        x: number;
+        y: number;
+        hasSelection: boolean;
+        editorState: ContractTemplateEditorState;
+        fontSizePresetOptions: Array<{
+            label: string;
+            value: number | string;
+        }>;
+        currentEditorFontSize: number;
+        editorFontSizeSearchValue: string;
+        textAlignOptions: Array<{
+            label: string;
+            value: ContractTemplateEditorTextAlign;
+        }>;
+        currentEditorTextColor: string;
+        bodyControlToolItems: Array<{
+            type: ContractTemplateFieldType;
+            label: string;
+            icon: import('vue').Component;
+        }>;
+        textMenuBindableVariables: ContractTemplateVariable[];
+        pageLimitReached: boolean;
+        tableInsertDraft: ContractTemplateTableInsertOptions;
+        variablesCount: number;
+        resolveBindVariableTypeLabel: (variable: ContractTemplateVariable) => string;
+    }> & Readonly<{
+        onKeydown?: ((event: KeyboardEvent) => any) | undefined;
+        onCommand?: ((command: ContractTemplateEditorCommand) => any) | undefined;
+        "onPatch-font-size"?: ((value: unknown) => any) | undefined;
+        "onPatch-color"?: ((value: string) => any) | undefined;
+        "onPatch-text-align"?: ((value: unknown) => any) | undefined;
+        "onInsert-variable"?: ((type: ContractTemplateFieldType) => any) | undefined;
+        "onAdd-page"?: (() => any) | undefined;
+        "onFont-size-search"?: ((value: string) => any) | undefined;
+        "onFont-size-commit"?: (() => any) | undefined;
+        "onFont-size-dropdown-change"?: ((open: boolean) => any) | undefined;
+        "onFont-size-keydown"?: ((event: KeyboardEvent) => any) | undefined;
+        onClipboard?: ((command: "copy" | "cut" | "paste") => any) | undefined;
+        "onOpen-image"?: (() => any) | undefined;
+        "onBind-variable"?: ((variable: ContractTemplateVariable) => any) | undefined;
+        "onOpen-bind-panel"?: (() => any) | undefined;
+        "onUpdate:bindOpen"?: ((value: boolean) => any) | undefined;
+        "onUpdate:bindKeyword"?: ((value: string) => any) | undefined;
+    }>, {
+        getMenuElement: () => HTMLElement | undefined;
+        focusBindSearch: () => void;
+        focusFirstButton: () => void;
+    }, {}, {}, {}, {}> | null;
+    textBubbleElement: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<{
+        x: number;
+        y: number;
+        editorState: ContractTemplateEditorState;
+        fontSizePresetOptions: Array<{
+            label: string;
+            value: number | string;
+        }>;
+        currentEditorFontSize: number;
+        editorFontSizeSearchValue: string;
+        currentEditorTextColor: string;
+        textAlignOptions: Array<{
+            label: string;
+            value: ContractTemplateEditorTextAlign;
+        }>;
+    }> & Readonly<{
+        onMore?: ((clientX: number, clientY: number) => any) | undefined;
+        onCommand?: ((command: ContractTemplateEditorCommand) => any) | undefined;
+        "onPatch-font-size"?: ((value: unknown) => any) | undefined;
+        "onPatch-color"?: ((value: string) => any) | undefined;
+        "onPatch-text-align"?: ((value: unknown) => any) | undefined;
+        "onFont-size-search"?: ((value: string) => any) | undefined;
+        "onFont-size-commit"?: (() => any) | undefined;
+        "onFont-size-dropdown-change"?: ((open: boolean) => any) | undefined;
+        "onFont-size-keydown"?: ((event: KeyboardEvent) => any) | undefined;
+    }>, {
+        getMenuElement: () => HTMLElement | undefined;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+        more: (clientX: number, clientY: number) => any;
+        command: (command: ContractTemplateEditorCommand) => any;
+        "patch-font-size": (value: unknown) => any;
+        "patch-color": (value: string) => any;
+        "patch-text-align": (value: unknown) => any;
+        "font-size-search": (value: string) => any;
+        "font-size-commit": () => any;
+        "font-size-dropdown-change": (open: boolean) => any;
+        "font-size-keydown": (event: KeyboardEvent) => any;
+    }, import('vue').PublicProps, {}, false, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
+        menuElement: HTMLDivElement;
+    }, HTMLDivElement, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<{
+        x: number;
+        y: number;
+        editorState: ContractTemplateEditorState;
+        fontSizePresetOptions: Array<{
+            label: string;
+            value: number | string;
+        }>;
+        currentEditorFontSize: number;
+        editorFontSizeSearchValue: string;
+        currentEditorTextColor: string;
+        textAlignOptions: Array<{
+            label: string;
+            value: ContractTemplateEditorTextAlign;
+        }>;
+    }> & Readonly<{
+        onMore?: ((clientX: number, clientY: number) => any) | undefined;
+        onCommand?: ((command: ContractTemplateEditorCommand) => any) | undefined;
+        "onPatch-font-size"?: ((value: unknown) => any) | undefined;
+        "onPatch-color"?: ((value: string) => any) | undefined;
+        "onPatch-text-align"?: ((value: unknown) => any) | undefined;
+        "onFont-size-search"?: ((value: string) => any) | undefined;
+        "onFont-size-commit"?: (() => any) | undefined;
+        "onFont-size-dropdown-change"?: ((open: boolean) => any) | undefined;
+        "onFont-size-keydown"?: ((event: KeyboardEvent) => any) | undefined;
+    }>, {
+        getMenuElement: () => HTMLElement | undefined;
+    }, {}, {}, {}, {}> | null;
     imageFileInputElement: HTMLInputElement;
 }, HTMLDivElement>;
 export default _default;

package/dist/types/components/pro-contract-template-designer/src/composables/use-auto-pagination.d.ts

@@ -0,0 +1,43 @@
+import { ComputedRef, Ref } from 'vue';
+import { JSONContent } from '@tiptap/core';
+import { ContractTemplateData, ContractTemplatePage, ContractTemplatePageSize } from '../types';
+export interface AutoPaginationPageRef {
+    hasOverflowContent: () => boolean;
+    splitOverflowContent: () => {
+        page: ContractTemplatePage;
+        overflowContent: JSONContent[];
+        overflowHtml: string;
+    } | undefined;
+    prependContent: (content: JSONContent[]) => ContractTemplatePage | undefined;
+}
+declare function createDocContent(content: JSONContent[]): ContractTemplatePage['contentJson'];
+/**
+ * 把上一页溢出的内容插到本页开头（页面组件不可用时的纯数据兜底路径）。
+ *
+ * 本页原本是空白时丢掉它的占位 HTML，否则拼接后会多出一个空段落。
+ */
+export declare function prependOverflowToPageData(page: ContractTemplatePage, overflowContent: JSONContent[], overflowHtml: string): ContractTemplatePage;
+/**
+ * 自动分页编排：登记待办、测量 DOM、连锁切页。
+ *
+ * 正文真源在各页 Tiptap；本 composable 只调度循环，不自己改坐标。
+ */
+export declare function useAutoPagination(options: {
+    templateValue: Ref<ContractTemplateData>;
+    readonlyState: Ref<boolean> | ComputedRef<boolean>;
+    isAutoPaginating: Ref<boolean>;
+    pendingPaginationPageId: Ref<string>;
+    activePageId: Ref<string>;
+    normalizedMaxPages: Ref<number> | ComputedRef<number>;
+    pageRefs: Map<string, AutoPaginationPageRef>;
+    syncPageEditors: () => ContractTemplateData;
+    commitBodyChange: (nextValue: ContractTemplateData) => ContractTemplateData;
+    getPageSize: (page?: ContractTemplatePage) => ContractTemplatePageSize;
+    notifyPageLimit: (source: 'add' | 'duplicate' | 'auto-pagination') => void;
+}): {
+    scheduleAutoPaginate: (pageId?: string) => void;
+    runAutoPagination: () => Promise<void>;
+    createDocContent: typeof createDocContent;
+    prependOverflowToPageData: typeof prependOverflowToPageData;
+};
+export {};