@guodun/antdv 1.4.1 → 1.4.2

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,209 @@ 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;
+        pageDecorationsOpen: boolean;
+        pageDecorationsStudioId: string;
+        pageDecorationsPresetLabel: string;
+        pageDecorationsEnabledCount: number;
+        pageDecorationsEnabledStates: {
+            header: boolean;
+            footer: boolean;
+            watermark: boolean;
+        };
+    }> & 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;
+        onSubmitData?: (() => any) | undefined;
+        onTogglePageDecorations?: (() => any) | undefined;
+    }>, {
+        focusPageDecorations: () => void | undefined;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+        clear: () => any;
+        validate: () => any;
+        preview: () => any;
+        fitWidth: () => any;
+        zoomOut: () => any;
+        zoomIn: () => any;
+        resetZoom: () => any;
+        toggleFullscreen: () => any;
+        submitData: () => any;
+        togglePageDecorations: () => 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;
+        pageDecorationsOpen: boolean;
+        pageDecorationsStudioId: string;
+        pageDecorationsPresetLabel: string;
+        pageDecorationsEnabledCount: number;
+        pageDecorationsEnabledStates: {
+            header: boolean;
+            footer: boolean;
+            watermark: boolean;
+        };
+    }> & 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;
+        onSubmitData?: (() => any) | undefined;
+        onTogglePageDecorations?: (() => any) | undefined;
+    }>, {
+        focusPageDecorations: () => void | undefined;
+    }, {}, {}, {}, {}> | null;
     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 +320,182 @@ 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;
     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 {};

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

@@ -0,0 +1,22 @@
+export interface SetActiveFileIdOptions {
+    /** 切换前是否把当前编辑器快照写回文件数组。 */
+    syncCurrent?: boolean;
+    /** 是否向外抛 `update:activeFileId`。 */
+    shouldEmit?: boolean;
+    /** 即使 fileId 没变也强制重装当前文件（外部 files 整体替换时用）。 */
+    forceRefresh?: boolean;
+    /** 切换前是否把当前文件的签署入参错误快照留下来。 */
+    persistCurrentErrors?: boolean;
+}
+/**
+ * 文件切换选项。
+ *
+ * 以前五个布尔参数排队，调用点几乎读不懂；收成具名 options 后默认值仍保持
+ * 「同步当前文件、向外抛事件、保留错误」。
+ */
+export declare function resolveSetActiveFileIdOptions(options?: SetActiveFileIdOptions): {
+    syncCurrent: boolean;
+    shouldEmit: boolean;
+    forceRefresh: boolean;
+    persistCurrentErrors: boolean;
+};

package/dist/types/components/pro-contract-template-designer/src/composables/use-draft-cache-session.d.ts

@@ -0,0 +1,41 @@
+import { ComputedRef, Ref } from 'vue';
+import { ContractTemplateData, ContractTemplateDraftCacheStatus, ContractTemplateFile, ContractTemplatePageSize, ContractTemplateValidationError } from '../types';
+import { SetActiveFileIdOptions } from './use-designer-files';
+/**
+ * 草稿缓存会话：定时写入、空白才恢复、卸载时停表。
+ *
+ * 宿主已有正文时不得用本地草稿覆盖；指纹用来跳过内容没变的重复写入。
+ */
+export declare function useDraftCacheSession(options: {
+    draftCacheWritable: ComputedRef<boolean>;
+    multipleFilesMode: ComputedRef<boolean>;
+    filesValue: Ref<ContractTemplateFile[]>;
+    activeFileIdValue: Ref<string>;
+    templateValue: Ref<ContractTemplateData>;
+    draftCacheKey: ComputedRef<string | undefined>;
+    draftCacheInterval: () => number | undefined;
+    draftCacheMaxBytes: () => number | undefined;
+    pageSize: () => ContractTemplatePageSize | undefined;
+    pageSizeOptions: () => ContractTemplatePageSize[] | undefined;
+    syncActiveFileSnapshot: (shouldEmit?: boolean) => ContractTemplateData;
+    syncPageEditors: () => ContractTemplateData;
+    setActiveFileId: (fileId: string, opts?: SetActiveFileIdOptions) => void;
+    emitFilesChange: (files: ContractTemplateFile[], changedFileId?: string) => void;
+    commit: (value: ContractTemplateData) => ContractTemplateData;
+    setSigningPlacementInputErrorsByFile: (value: Record<string, ContractTemplateValidationError[]>) => void;
+    buildSigningPlacementInputErrorsByFile: (files: ContractTemplateFile[], rawFiles?: Array<{
+        template?: ContractTemplateData;
+    }>) => Record<string, ContractTemplateValidationError[]>;
+    updateDraftCacheStatus: (status: ContractTemplateDraftCacheStatus, shouldEmit?: boolean) => void;
+    scheduleAutoPaginate: (pageId?: string) => void;
+    activePageId: Ref<string>;
+    selectedVariableKey: Ref<string>;
+}): {
+    saveDraftCache: () => ContractTemplateDraftCacheStatus;
+    loadDraftCache: () => ContractTemplateData | undefined;
+    clearDraftCache: () => void;
+    restoreDraftCacheIfNeeded: () => void;
+    stopDraftCacheTimer: () => void;
+    restartDraftCacheTimer: () => void;
+    resetDraftFingerprint: () => void;
+};

package/dist/types/components/pro-contract-template-designer/src/composables/use-signing-placement-editor.d.ts

@@ -0,0 +1,49 @@
+import { ComputedRef, Ref } from 'vue';
+import { ContractTemplateData, ContractTemplatePage, ContractTemplatePageSize, ContractTemplateSigningPlacement, ContractTemplateSigningPlacementType } from '../types';
+import { ContractTemplateSigningPlacementDragPayload, ContractTemplateSigningPlacementToolItem } from '../utils/signing-placement';
+/**
+ * 深克隆签署位置。
+ *
+ * 位置对象会通过事件抛给宿主，`sealTypes` 是数组，直接透传会让宿主拿到内部引用；
+ * 这里只需要复制这一层数组，其余字段都是原始值。
+ */
+export declare function cloneSigningPlacement(placement: ContractTemplateSigningPlacement): ContractTemplateSigningPlacement;
+/**
+ * 签署位置 CRUD 与拖放。
+ *
+ * `showSigningPlacementTools === false` 时 drop 必须短路，不能只藏 UI。
+ */
+export declare function useSigningPlacementEditor(options: {
+    templateValue: Ref<ContractTemplateData>;
+    signingPlacements: ComputedRef<ContractTemplateSigningPlacement[]>;
+    selectedSigningPlacement: ComputedRef<ContractTemplateSigningPlacement | undefined>;
+    selectedSigningPlacementId: Ref<string>;
+    selectedPage: ComputedRef<ContractTemplatePage | undefined>;
+    activePageId: Ref<string>;
+    readonly: () => boolean;
+    disabled: () => boolean;
+    showSigningPlacementTools: () => boolean;
+    getPageSize: (page?: ContractTemplatePage) => ContractTemplatePageSize;
+    getVisiblePosition: (pageId: string, type: ContractTemplateSigningPlacementType) => {
+        x: number;
+        y: number;
+    } | undefined;
+    commitSigningPlacements: (placements: ContractTemplateSigningPlacement[], resolvedPlacementIds?: Iterable<string>) => ContractTemplateData;
+    selectSigningPlacement: (id?: string) => void;
+    emitAdd: (placement: ContractTemplateSigningPlacement) => void;
+    emitChange: (placement: ContractTemplateSigningPlacement) => void;
+    emitRemove: (placement: ContractTemplateSigningPlacement) => void;
+}): {
+    insertSigningPlacement: (type: ContractTemplateSigningPlacementType, pageId?: string, position?: {
+        x: number;
+        y: number;
+    }) => ContractTemplateSigningPlacement | undefined;
+    handleSigningPlacementDrop: (pageId: string, payload: ContractTemplateSigningPlacementDragPayload, centerX: number, centerY: number) => void;
+    insertSigningPlacementTool: (item: ContractTemplateSigningPlacementDragPayload) => ContractTemplateSigningPlacement | undefined;
+    handleSigningPlacementDragStart: (event: DragEvent, item: ContractTemplateSigningPlacementToolItem) => void;
+    updateSigningPlacement: (nextPlacement: ContractTemplateSigningPlacement) => void;
+    patchSelectedSigningPlacement: (patch: Partial<ContractTemplateSigningPlacement>) => void;
+    duplicateSigningPlacement: (placement?: ContractTemplateSigningPlacement | undefined) => void;
+    removeSigningPlacement: (placement?: ContractTemplateSigningPlacement | undefined) => void;
+    cloneSigningPlacement: typeof cloneSigningPlacement;
+};

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

@@ -14,6 +14,11 @@ export declare const DEFAULT_MULTILINE_LINE_HEIGHT = 28;
 export declare const CONTRACT_TEMPLATE_RENDERER_VERSION = "contract-template-renderer-1.0.0";
 /** 合同渲染 CSS 版本快照，用于服务端 PDF 复现。 */
 export declare const CONTRACT_TEMPLATE_STYLE_VERSION = "contract-render-css-1.0.0";
+/** 与 PDF 模板填值服务保持一致，避免设计器允许保存但服务端拒绝的变量标识。 */
+export declare const CONTRACT_TEMPLATE_VARIABLE_KEY_PATTERN: RegExp;
+export declare const CONTRACT_TEMPLATE_RESERVED_VARIABLE_KEYS: Set<string>;
+/** 属性面板和模板全量校验共用的变量标识规则。 */
+export declare function validateContractTemplateVariableKey(key: unknown, variables: ContractTemplateVariable[], currentVariableId?: string): string;
 /** 页数配置只接受正整数；非法值回落到默认 20 页。 */
 export declare function normalizeContractTemplateMaxPages(value: unknown): number;
 /** 正文可插入的变量类型及其默认尺寸。 */
@@ -111,6 +116,10 @@ export declare function buildTemplatePreviewPages(value: ContractTemplateData):
  * 先深拷贝再附加渲染器/样式版本号和表达式 HTML，保证导出快照与设计态数据解耦，
  * 宿主后续改动设计态不会污染已经拿到的导出对象。
  */
+export declare class ContractTemplatePageDecorationValidationError extends Error {
+    readonly errors: ContractTemplateValidationError[];
+    constructor(errors: ContractTemplateValidationError[]);
+}
 export declare function exportTemplateValue(value: ContractTemplateData): ContractTemplateExportResult;
 /**
  * 全量校验模板结构，返回可定位到具体节点的错误列表。
@@ -131,7 +140,12 @@ export declare function validateTemplateValue(value: ContractTemplateData, optio
 export declare function collectTemplateVariableKeys(page: ContractTemplatePage): Set<string>;
 /** 汇总整份模板引用到的变量 key。 */
 export declare function collectTemplateValueVariableKeys(value: Pick<ContractTemplateData, 'pages'>): Set<string>;
-/** 删除正文里已经不存在的变量配置，让 `variables` 与正文节点保持一致。 */
+/**
+ * 删除正文和页面装饰里已经不存在的合法变量配置。
+ *
+ * 空 key、非法 key、保留字和重复声明必须继续留到校验层；若在这里按“无引用”
+ * 一并裁掉，外部脏模板会在首次正文同步后静默变成合法数据，用户反而看不到可定位错误。
+ */
 export declare function syncTemplateVariablesWithPages(value: ContractTemplateData): ContractTemplateData;
 /** 自动分页用的单个顶层块测量结果，坐标相对正文容器顶部。 */
 export interface ContractTemplateBlockMeasurement {

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

@@ -11,6 +11,19 @@ export declare function createContractTemplateFile(name?: string, pageSize?: Con
  * 重复/空 id 只在编辑态补成稳定新 id，外部数据不会被原地改写。
  */
 export declare function normalizeContractTemplateFiles(input: ContractTemplateFile[] | undefined, fallbackTemplate?: ContractTemplateData, pageSize?: ContractTemplatePageSize): ContractTemplateFile[];
+/**
+ * 对每份文件独立套用页面尺寸白名单。
+ *
+ * 导入超页数上限时不在这里截断；被回退的签署位置 id 按文件分组，便于宿主同步坐标。
+ */
+export declare function constrainContractTemplateFiles(files: ContractTemplateFile[], pageSizeOptions: ContractTemplatePageSize[] | undefined): {
+    files: {
+        template: ContractTemplateData;
+        id: string;
+        name: string;
+    }[];
+    resizedSigningPlacementIds: Map<string, string[]>;
+};
 /** 当前 id 不可用时稳定回退第一份文件，空数组返回空字符串。 */
 export declare function resolveContractTemplateActiveFileId(files: ContractTemplateFile[], activeFileId?: string): string;
 /** 不可变替换一份文件的模板；找不到 id 时保持原数组内容。 */

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

@@ -0,0 +1,19 @@
+import { Ref } from 'vue';
+import { ContractTemplateToolbarOverflowKey } from '../utils/toolbar-overflow';
+/**
+ * 工具栏按组收纳进「更多」面板。
+ *
+ * 组宽只在该组仍是主行子元素时缓存；进面板后量到的是竖排宽度，不能拿去算主行。
+ */
+export declare function useToolbarOverflow(options: {
+    toolbarMainElement: Ref<HTMLElement | undefined>;
+    toolbarMoreElement: Ref<HTMLElement | undefined>;
+    toolbarMoreOpen: Ref<boolean>;
+    measureDependencies: () => unknown;
+    isDisposed: () => boolean;
+}): {
+    toolbarOverflowKeys: Ref<("table" | "insert" | "cleanup" | "typography")[], ("table" | "insert" | "cleanup" | "typography")[]>;
+    toolbarHasOverflow: import('vue').ComputedRef<boolean>;
+    isToolbarGroupOverflowed: (key: ContractTemplateToolbarOverflowKey) => boolean;
+    measureToolbarOverflow: (settlePass?: number) => void;
+};