@guodun/antdv 1.3.2 → 1.4.1

package/dist/types/components/pro-contract-signing-flow/src/types.d.ts

@@ -99,6 +99,14 @@ export interface ContractSigningFlowExpose {
     removeSignNode: (nodeKey: string) => void;
     moveSignNode: (nodeKey: string, direction: -1 | 1) => void;
     setNodeLocationRules: (nodeKey: string, locationRules: ContractSigningFlowLocationRule[]) => void;
+    /** 设置画布缩放比例，自动裁剪到 0.5~1.5，返回实际比例。 */
+    setZoom: (value: number) => number;
+    /** 将画布缩放重置为 100%。 */
+    resetZoom: () => number;
+    /** 获取当前画布缩放比例。 */
+    getZoom: () => number;
+    /** 按当前画布可用宽度计算缩放比例。 */
+    fitWidth: () => number;
 }
 export interface ContractSigningFlowProps {
     modelValue?: ContractSigningFlowDefinition;
@@ -110,6 +118,10 @@ export interface ContractSigningFlowProps {
      * @default true
      */
     requireSigningLocation?: boolean;
+    /** 是否展示节点的签署位置设置入口；默认跟随 requireSigningLocation。 */
+    showSigningLocation?: boolean;
+    /** 当前画布缩放比例，可使用 v-model:zoom 受控。 */
+    zoom?: number;
 }
 export interface ContractSigningFlowEmits {
     'update:modelValue': [value: ContractSigningFlowDefinition];
@@ -121,4 +133,6 @@ export interface ContractSigningFlowEmits {
     'node-move': [nodeKey: string, direction: -1 | 1];
     'node-select': [node: ContractSigningFlowNode | undefined];
     'placement-request': [payload: ContractSigningFlowPlacementRequest];
+    /** 画布缩放变化时同步 v-model:zoom。 */
+    'update:zoom': [value: number];
 }

package/dist/types/components/pro-contract-template-designer/index.d.ts

@@ -3,6 +3,7 @@ import { default as ProContractTemplateDesigner } from './src/ProContractTemplat
 import { default as ProContractTemplateRenderer } from './src/ProContractTemplateRenderer.vue';
 export * from './src/types';
 export * from './src/composables/use-template-designer';
+export * from './src/composables/use-template-files';
 export * from './src/composables/use-template-draft-cache';
 export * from './src/utils/template-renderer';
 export * from './src/utils/signing-placement';

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

@@ -0,0 +1,103 @@
+import { ContractTemplateFieldStyle, ContractTemplateFieldType, ContractTemplatePageSize, ContractTemplateSigningPlacement, ContractTemplateVariable } from './types';
+type __VLS_Props = {
+    collapsed: boolean;
+    readonly: boolean;
+    disabled: boolean;
+    showSigningPlacementTools: boolean;
+    bodyControlToolItems: Array<{
+        type: ContractTemplateFieldType;
+        label: string;
+        icon: unknown;
+    }>;
+    signingPlacementTools: Array<{
+        key: string;
+        type: ContractTemplateSigningPlacement['type'];
+        label: string;
+    }>;
+    signingPlacements: ContractTemplateSigningPlacement[];
+    selectedSigningPlacement?: ContractTemplateSigningPlacement;
+    selectedSigningPlacementPageSize: ContractTemplatePageSize;
+    selectedVariable?: ContractTemplateVariable;
+    currentVariableFontFamily: string;
+    fontFamilySelectOptions: Array<{
+        label: string;
+        value: string;
+    }>;
+    textAlignOptions: Array<{
+        label: string;
+        value: string;
+    }>;
+    borderStyleOptions: Array<{
+        label: string;
+        value: string;
+    }>;
+    objectFitOptions: Array<{
+        label: string;
+        value: string;
+    }>;
+    selectedVariableWidthMax: number;
+    selectedVariableHeightMax: number;
+    minFontSize: number;
+    maxFontSize: number;
+    defaultMultilineRows: number;
+    resolveSigningPlacementTypeIcon: (type: ContractTemplateSigningPlacement['type']) => unknown;
+    signingPlacementTypeLabels: Record<string, string>;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    toggle: () => any;
+    insertVariable: (type: ContractTemplateFieldType) => any;
+    removeVariable: (variable: ContractTemplateVariable) => any;
+    variableDragStart: (event: DragEvent, type: ContractTemplateFieldType) => any;
+    signingPlacementDragStart: (event: DragEvent, item: {
+        key: string;
+        type: ContractTemplateSigningPlacement["type"];
+        label: string;
+    }) => any;
+    insertSigningPlacement: (item: {
+        key: string;
+        type: ContractTemplateSigningPlacement["type"];
+        label: string;
+    }) => any;
+    patchSigningPlacement: (patch: Partial<ContractTemplateSigningPlacement>) => any;
+    duplicateSigningPlacement: () => any;
+    removeSigningPlacement: () => any;
+    duplicateVariable: (variable: ContractTemplateVariable) => any;
+    patchVariable: (patch: Partial<ContractTemplateVariable>) => any;
+    patchStyle: (patch: ContractTemplateFieldStyle) => any;
+    patchMultiline: (checked: boolean) => any;
+    patchRows: (value: unknown) => any;
+    patchFontFamily: (value: unknown) => any;
+    patchFontSize: (value: unknown) => any;
+    patchTextAlign: (value: unknown) => any;
+    patchBorderStyle: (value: unknown) => any;
+    patchObjectFit: (value: unknown) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onToggle?: (() => any) | undefined;
+    onInsertVariable?: ((type: ContractTemplateFieldType) => any) | undefined;
+    onRemoveVariable?: ((variable: ContractTemplateVariable) => any) | undefined;
+    onVariableDragStart?: ((event: DragEvent, type: ContractTemplateFieldType) => any) | undefined;
+    onSigningPlacementDragStart?: ((event: DragEvent, item: {
+        key: string;
+        type: ContractTemplateSigningPlacement["type"];
+        label: string;
+    }) => any) | undefined;
+    onInsertSigningPlacement?: ((item: {
+        key: string;
+        type: ContractTemplateSigningPlacement["type"];
+        label: string;
+    }) => any) | undefined;
+    onPatchSigningPlacement?: ((patch: Partial<ContractTemplateSigningPlacement>) => any) | undefined;
+    onDuplicateSigningPlacement?: (() => any) | undefined;
+    onRemoveSigningPlacement?: (() => any) | undefined;
+    onDuplicateVariable?: ((variable: ContractTemplateVariable) => any) | undefined;
+    onPatchVariable?: ((patch: Partial<ContractTemplateVariable>) => any) | undefined;
+    onPatchStyle?: ((patch: ContractTemplateFieldStyle) => any) | undefined;
+    onPatchMultiline?: ((checked: boolean) => any) | undefined;
+    onPatchRows?: ((value: unknown) => any) | undefined;
+    onPatchFontFamily?: ((value: unknown) => any) | undefined;
+    onPatchFontSize?: ((value: unknown) => any) | undefined;
+    onPatchTextAlign?: ((value: unknown) => any) | undefined;
+    onPatchBorderStyle?: ((value: unknown) => any) | undefined;
+    onPatchObjectFit?: ((value: unknown) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLElement>;
+export default _default;

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

@@ -0,0 +1,48 @@
+import { ContractTemplatePage, ContractTemplatePageSize, ContractTemplateSigningPlacement, ContractTemplateVariable } from './types';
+type __VLS_Props = {
+    collapsed: boolean;
+    pages: ContractTemplatePage[];
+    variables: ContractTemplateVariable[];
+    signingPlacementNavigationItems: Array<{
+        placement: ContractTemplateSigningPlacement;
+        label: string;
+        detail: string;
+    }>;
+    activePageId: string;
+    selectedVariableKey: string;
+    selectedSigningPlacementId: string;
+    normalizedMaxPages: number;
+    pageLimitReached: boolean;
+    selectedPage?: ContractTemplatePage;
+    selectedPageSize: ContractTemplatePageSize;
+    normalizedPageSizeOptions: ContractTemplatePageSize[];
+    pageSizeOptions: Array<{
+        label: string;
+        value: string;
+    }>;
+    selectedPageSizeOptionValue: string;
+    showSigningPlacementTools: boolean;
+    readonly: boolean;
+    getPageSize: (page?: ContractTemplatePage) => ContractTemplatePageSize;
+    getPageSigningPlacements: (pageId: string) => ContractTemplateSigningPlacement[];
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    toggle: () => any;
+    addPage: () => any;
+    activatePage: (pageId: string) => any;
+    duplicatePage: (page: ContractTemplatePage) => any;
+    removePage: (page: ContractTemplatePage) => any;
+    patchPageFormat: (value: unknown) => any;
+    scrollToVariable: (variable: ContractTemplateVariable) => any;
+    scrollToSigningPlacement: (placementId: string) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onToggle?: (() => any) | undefined;
+    onAddPage?: (() => any) | undefined;
+    onActivatePage?: ((pageId: string) => any) | undefined;
+    onDuplicatePage?: ((page: ContractTemplatePage) => any) | undefined;
+    onRemovePage?: ((page: ContractTemplatePage) => any) | undefined;
+    onPatchPageFormat?: ((value: unknown) => any) | undefined;
+    onScrollToVariable?: ((variable: ContractTemplateVariable) => any) | undefined;
+    onScrollToSigningPlacement?: ((placementId: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLElement>;
+export default _default;

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

@@ -0,0 +1,231 @@
+import { ContractTemplateFile } from './types';
+type __VLS_Props = {
+    files: ContractTemplateFile[];
+    activeFileId: string;
+    readonly: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    add: () => any;
+    select: (fileId: string) => any;
+    remove: (fileId: string) => any;
+    move: (fileId: string, direction: 1 | -1) => any;
+    rename: (fileId: string, name: string) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onAdd?: (() => any) | undefined;
+    onSelect?: ((fileId: string) => any) | undefined;
+    onRemove?: ((fileId: string) => any) | undefined;
+    onMove?: ((fileId: string, direction: 1 | -1) => any) | undefined;
+    onRename?: ((fileId: string, name: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    renameInput: (import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<Omit<{
+        id: StringConstructor;
+        placeholder: {
+            type: import('vue').PropType<string | number>;
+        };
+        autocomplete: StringConstructor;
+        type: {
+            type: import('vue').PropType<"number" | "reset" | "submit" | "button" | "time" | "image" | "text" | "search" | "hidden" | "color" | "checkbox" | "radio" | "range" | "date" | "url" | "email" | "week" | "month" | "datetime-local" | "file" | "password" | "tel">;
+            default: "number" | "reset" | "submit" | "button" | "time" | "image" | "text" | "search" | "hidden" | "color" | "checkbox" | "radio" | "range" | "date" | "url" | "email" | "week" | "month" | "datetime-local" | "file" | "password" | "tel";
+        };
+        name: StringConstructor;
+        size: {
+            type: import('vue').PropType<import('ant-design-vue/es/button').SizeType>;
+        };
+        autofocus: {
+            type: BooleanConstructor;
+            default: any;
+        };
+        lazy: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        maxlength: NumberConstructor;
+        loading: {
+            type: BooleanConstructor;
+            default: any;
+        };
+        bordered: {
+            type: BooleanConstructor;
+            default: any;
+        };
+        showCount: {
+            type: import('vue').PropType<boolean | import('ant-design-vue/es/vc-input/inputProps').ShowCountProps>;
+        };
+        htmlSize: NumberConstructor;
+        onPressEnter: import('vue').PropType<import('ant-design-vue/es/_util/EventInterface').KeyboardEventHandler>;
+        onKeydown: import('vue').PropType<import('ant-design-vue/es/_util/EventInterface').KeyboardEventHandler>;
+        onKeyup: import('vue').PropType<import('ant-design-vue/es/_util/EventInterface').KeyboardEventHandler>;
+        onFocus: import('vue').PropType<import('ant-design-vue/es/_util/EventInterface').FocusEventHandler>;
+        onBlur: import('vue').PropType<import('ant-design-vue/es/_util/EventInterface').FocusEventHandler>;
+        onChange: import('vue').PropType<import('ant-design-vue/es/_util/EventInterface').ChangeEventHandler>;
+        onInput: import('vue').PropType<import('ant-design-vue/es/_util/EventInterface').ChangeEventHandler>;
+        'onUpdate:value': import('vue').PropType<(val: string) => void>;
+        onCompositionstart: import('vue').PropType<import('ant-design-vue/es/_util/EventInterface').CompositionEventHandler>;
+        onCompositionend: import('vue').PropType<import('ant-design-vue/es/_util/EventInterface').CompositionEventHandler>;
+        valueModifiers: ObjectConstructor;
+        hidden: {
+            type: BooleanConstructor;
+            default: any;
+        };
+        status: import('vue').PropType<"" | "error" | "warning">;
+        value: {
+            type: import('vue').PropType<string | number>;
+            default: any;
+        };
+        defaultValue: {
+            type: import('vue').PropType<string | number>;
+            default: any;
+        };
+        inputElement: import('vue-types').VueTypeValidableDef<any>;
+        prefixCls: StringConstructor;
+        disabled: {
+            type: BooleanConstructor;
+            default: any;
+        };
+        focused: {
+            type: BooleanConstructor;
+            default: any;
+        };
+        triggerFocus: import('vue').PropType<() => void>;
+        readonly: {
+            type: BooleanConstructor;
+            default: any;
+        };
+        handleReset: import('vue').PropType<import('ant-design-vue/es/_util/EventInterface').MouseEventHandler>;
+        addonBefore: import('vue-types').VueTypeValidableDef<any>;
+        addonAfter: import('vue-types').VueTypeValidableDef<any>;
+        prefix: import('vue-types').VueTypeValidableDef<any>;
+        suffix: import('vue-types').VueTypeValidableDef<any>;
+        clearIcon: import('vue-types').VueTypeValidableDef<any>;
+        affixWrapperClassName: StringConstructor;
+        groupClassName: StringConstructor;
+        wrapperClassName: StringConstructor;
+        inputClassName: StringConstructor;
+        allowClear: {
+            type: BooleanConstructor;
+            default: any;
+        };
+    }, "wrapperClassName" | "affixWrapperClassName" | "groupClassName" | "inputClassName">>> & Readonly<{}>, () => import('ant-design-vue/es/_util/type').VueNode, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {
+        value: string | number;
+        type: "number" | "reset" | "submit" | "button" | "time" | "image" | "text" | "search" | "hidden" | "color" | "checkbox" | "radio" | "range" | "date" | "url" | "email" | "week" | "month" | "datetime-local" | "file" | "password" | "tel";
+        focused: boolean;
+        hidden: boolean;
+        disabled: boolean;
+        autofocus: boolean;
+        readonly: boolean;
+        defaultValue: string | number;
+        loading: boolean;
+        lazy: boolean;
+        bordered: boolean;
+        allowClear: boolean;
+    }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<import('vue').ExtractPropTypes<Omit<{
+        id: StringConstructor;
+        placeholder: {
+            type: import('vue').PropType<string | number>;
+        };
+        autocomplete: StringConstructor;
+        type: {
+            type: import('vue').PropType<"number" | "reset" | "submit" | "button" | "time" | "image" | "text" | "search" | "hidden" | "color" | "checkbox" | "radio" | "range" | "date" | "url" | "email" | "week" | "month" | "datetime-local" | "file" | "password" | "tel">;
+            default: "number" | "reset" | "submit" | "button" | "time" | "image" | "text" | "search" | "hidden" | "color" | "checkbox" | "radio" | "range" | "date" | "url" | "email" | "week" | "month" | "datetime-local" | "file" | "password" | "tel";
+        };
+        name: StringConstructor;
+        size: {
+            type: import('vue').PropType<import('ant-design-vue/es/button').SizeType>;
+        };
+        autofocus: {
+            type: BooleanConstructor;
+            default: any;
+        };
+        lazy: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        maxlength: NumberConstructor;
+        loading: {
+            type: BooleanConstructor;
+            default: any;
+        };
+        bordered: {
+            type: BooleanConstructor;
+            default: any;
+        };
+        showCount: {
+            type: import('vue').PropType<boolean | import('ant-design-vue/es/vc-input/inputProps').ShowCountProps>;
+        };
+        htmlSize: NumberConstructor;
+        onPressEnter: import('vue').PropType<import('ant-design-vue/es/_util/EventInterface').KeyboardEventHandler>;
+        onKeydown: import('vue').PropType<import('ant-design-vue/es/_util/EventInterface').KeyboardEventHandler>;
+        onKeyup: import('vue').PropType<import('ant-design-vue/es/_util/EventInterface').KeyboardEventHandler>;
+        onFocus: import('vue').PropType<import('ant-design-vue/es/_util/EventInterface').FocusEventHandler>;
+        onBlur: import('vue').PropType<import('ant-design-vue/es/_util/EventInterface').FocusEventHandler>;
+        onChange: import('vue').PropType<import('ant-design-vue/es/_util/EventInterface').ChangeEventHandler>;
+        onInput: import('vue').PropType<import('ant-design-vue/es/_util/EventInterface').ChangeEventHandler>;
+        'onUpdate:value': import('vue').PropType<(val: string) => void>;
+        onCompositionstart: import('vue').PropType<import('ant-design-vue/es/_util/EventInterface').CompositionEventHandler>;
+        onCompositionend: import('vue').PropType<import('ant-design-vue/es/_util/EventInterface').CompositionEventHandler>;
+        valueModifiers: ObjectConstructor;
+        hidden: {
+            type: BooleanConstructor;
+            default: any;
+        };
+        status: import('vue').PropType<"" | "error" | "warning">;
+        value: {
+            type: import('vue').PropType<string | number>;
+            default: any;
+        };
+        defaultValue: {
+            type: import('vue').PropType<string | number>;
+            default: any;
+        };
+        inputElement: import('vue-types').VueTypeValidableDef<any>;
+        prefixCls: StringConstructor;
+        disabled: {
+            type: BooleanConstructor;
+            default: any;
+        };
+        focused: {
+            type: BooleanConstructor;
+            default: any;
+        };
+        triggerFocus: import('vue').PropType<() => void>;
+        readonly: {
+            type: BooleanConstructor;
+            default: any;
+        };
+        handleReset: import('vue').PropType<import('ant-design-vue/es/_util/EventInterface').MouseEventHandler>;
+        addonBefore: import('vue-types').VueTypeValidableDef<any>;
+        addonAfter: import('vue-types').VueTypeValidableDef<any>;
+        prefix: import('vue-types').VueTypeValidableDef<any>;
+        suffix: import('vue-types').VueTypeValidableDef<any>;
+        clearIcon: import('vue-types').VueTypeValidableDef<any>;
+        affixWrapperClassName: StringConstructor;
+        groupClassName: StringConstructor;
+        wrapperClassName: StringConstructor;
+        inputClassName: StringConstructor;
+        allowClear: {
+            type: BooleanConstructor;
+            default: any;
+        };
+    }, "wrapperClassName" | "affixWrapperClassName" | "groupClassName" | "inputClassName">>> & Readonly<{}>, () => import('ant-design-vue/es/_util/type').VueNode, {}, {}, {}, {
+        value: string | number;
+        type: "number" | "reset" | "submit" | "button" | "time" | "image" | "text" | "search" | "hidden" | "color" | "checkbox" | "radio" | "range" | "date" | "url" | "email" | "week" | "month" | "datetime-local" | "file" | "password" | "tel";
+        focused: boolean;
+        hidden: boolean;
+        disabled: boolean;
+        autofocus: boolean;
+        readonly: boolean;
+        defaultValue: string | number;
+        loading: boolean;
+        lazy: boolean;
+        bordered: boolean;
+        allowClear: boolean;
+    }> | null)[];
+}, HTMLElement>;
+export default _default;

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

@@ -0,0 +1,15 @@
+import { ContractTemplateValidationError } from './types';
+type __VLS_Props = {
+    passed: boolean;
+    summary: string;
+    errors: ContractTemplateValidationError[];
+    expanded: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    toggle: () => any;
+    focusError: (error: ContractTemplateValidationError) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onToggle?: (() => any) | undefined;
+    onFocusError?: ((error: ContractTemplateValidationError) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

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

@@ -187,8 +187,8 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
     readonly: boolean;
     active: boolean;
     zoom: number;
-    processImageFile: (file: File) => Promise<string | null>;
     signingPlacements: ContractTemplateSigningPlacement[];
+    processImageFile: (file: File) => Promise<string | null>;
     selectedVariableKey: string;
     selectedSigningPlacementId: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {

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

@@ -1,10 +1,18 @@
-import { ContractTemplateContentImage, ContractTemplateData, 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, ContractTemplateEditorTextAlign, ContractTemplateFieldStyle, ContractTemplatePageSize, ContractTemplateLocationRule, ContractTemplateLocationRuleOptions, ContractTemplateSigningPlacement, ContractTemplateSigningPlacementType, ContractTemplateTableCommandCapabilities, ContractTemplateValidationError, ContractTemplateVariable } from './types';
 import { ContractTemplateImageSource } from './utils/content-image';
 declare const _default: import('vue').DefineComponent<ContractTemplateDesignerProps, {
     getValue: () => ContractTemplateData;
     setValue: (value: ContractTemplateData) => void;
+    getFiles: () => ContractTemplateFile[];
+    setFiles: (files: ContractTemplateFile[], activeFileId?: string) => void;
+    addFile: (name?: string) => ContractTemplateFile | undefined;
+    selectFile: (fileId: string) => void;
+    renameFile: (fileId: string, name: string) => ContractTemplateFile | undefined;
+    removeFile: (fileId: string) => ContractTemplateFile | undefined;
+    moveFile: (fileId: string, direction: -1 | 1) => ContractTemplateFile | undefined;
     validate: () => ContractTemplateValidationError[];
     exportTemplate: () => import('./types').ContractTemplateExportResult;
+    exportFiles: () => ContractTemplateFilesExportResult;
     getSubmitData: () => import('./types').ContractTemplateExportResult;
     clearTemplate: () => ContractTemplateData;
     saveDraftCache: () => ContractTemplateDraftCacheStatus;
@@ -38,8 +46,15 @@ declare const _default: import('vue').DefineComponent<ContractTemplateDesignerPr
     validate: (errors: ContractTemplateValidationError[]) => any;
     "update:modelValue": (value: ContractTemplateData) => any;
     change: (value: ContractTemplateData) => any;
+    "file-change": (file: ContractTemplateFile) => any;
     "signing-placement-select": (placement: ContractTemplateSigningPlacement | undefined) => any;
     "signing-placement-remove": (placement: ContractTemplateSigningPlacement) => any;
+    "update:files": (files: ContractTemplateFile[]) => any;
+    "update:activeFileId": (fileId: string) => any;
+    "files-change": (files: ContractTemplateFile[]) => any;
+    "file-add": (file: ContractTemplateFile) => any;
+    "file-remove": (file: ContractTemplateFile) => any;
+    "file-move": (file: ContractTemplateFile, fromIndex: number, toIndex: number) => any;
     "variable-add": (variable: ContractTemplateVariable) => any;
     "draft-cache-change": (status: ContractTemplateDraftCacheStatus) => any;
     "page-limit": (maxPages: number, source: "add" | "duplicate" | "auto-pagination") => any;
@@ -50,8 +65,15 @@ declare const _default: import('vue').DefineComponent<ContractTemplateDesignerPr
     onValidate?: ((errors: ContractTemplateValidationError[]) => any) | undefined;
     "onUpdate:modelValue"?: ((value: ContractTemplateData) => any) | undefined;
     onChange?: ((value: ContractTemplateData) => any) | undefined;
+    "onFile-change"?: ((file: ContractTemplateFile) => any) | undefined;
     "onSigning-placement-select"?: ((placement: ContractTemplateSigningPlacement | undefined) => any) | undefined;
     "onSigning-placement-remove"?: ((placement: ContractTemplateSigningPlacement) => any) | undefined;
+    "onUpdate:files"?: ((files: ContractTemplateFile[]) => any) | undefined;
+    "onUpdate:activeFileId"?: ((fileId: string) => any) | undefined;
+    "onFiles-change"?: ((files: ContractTemplateFile[]) => any) | undefined;
+    "onFile-add"?: ((file: ContractTemplateFile) => any) | undefined;
+    "onFile-remove"?: ((file: ContractTemplateFile) => any) | undefined;
+    "onFile-move"?: ((file: ContractTemplateFile, fromIndex: number, toIndex: number) => any) | undefined;
     "onVariable-add"?: ((variable: ContractTemplateVariable) => any) | undefined;
     "onDraft-cache-change"?: ((status: ContractTemplateDraftCacheStatus) => any) | undefined;
     "onPage-limit"?: ((maxPages: number, source: "add" | "duplicate" | "auto-pagination") => any) | undefined;
@@ -64,6 +86,7 @@ declare const _default: import('vue').DefineComponent<ContractTemplateDesignerPr
     height: string | number;
     readonly: boolean;
     pageSize: ContractTemplatePageSize;
+    showSigningPlacementTools: boolean;
     maxPages: number;
     variableTypes: import('./types').ContractTemplateFieldTypeOption[];
     defaultVariableStyle: ContractTemplateFieldStyle;
@@ -71,7 +94,6 @@ declare const _default: import('vue').DefineComponent<ContractTemplateDesignerPr
     fontFamilyMode: import('./types').ContractTemplateFontFamilyMode;
     showSubmitDataViewer: boolean;
     showClearButton: boolean;
-    showSigningPlacementTools: boolean;
     enableDraftCache: boolean;
     draftCacheKey: string;
     draftCacheInterval: number;
@@ -82,6 +104,7 @@ declare const _default: import('vue').DefineComponent<ContractTemplateDesignerPr
     workspaceElement: HTMLElement;
     toolbarMainElement: HTMLDivElement;
     toolbarMoreElement: HTMLDivElement;
+    toolbarInsertSlotElement: HTMLDivElement;
     toolbarTypographySlotElement: HTMLDivElement;
     toolbarCleanupSlotElement: HTMLDivElement;
     toolbarTableSlotElement: HTMLDivElement;

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

@@ -7,11 +7,11 @@ type __VLS_Props = {
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     remove: () => any;
-    update: (patch: Partial<ContractTemplateSigningPlacement>) => any;
     duplicate: () => any;
+    update: (patch: Partial<ContractTemplateSigningPlacement>) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     onRemove?: (() => any) | undefined;
-    onUpdate?: ((patch: Partial<ContractTemplateSigningPlacement>) => any) | undefined;
     onDuplicate?: (() => any) | undefined;
+    onUpdate?: ((patch: Partial<ContractTemplateSigningPlacement>) => any) | undefined;
 }>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLElement>;
 export default _default;

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

@@ -14,7 +14,7 @@ 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";
-/** 页数配置只接受正整数；非法值回落到默认 50 页。 */
+/** 页数配置只接受正整数；非法值回落到默认 20 页。 */
 export declare function normalizeContractTemplateMaxPages(value: unknown): number;
 /** 正文可插入的变量类型及其默认尺寸。 */
 export declare const DEFAULT_FIELD_TYPES: ContractTemplateFieldTypeOption[];

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

@@ -1,4 +1,4 @@
-import { ContractTemplateData, ContractTemplateDraftCacheStatus } from '../types';
+import { ContractTemplateData, ContractTemplateDraftCacheStatus, ContractTemplateFile } from '../types';
 /**
  * 合同模板草稿的本地缓存层。
  *
@@ -8,6 +8,7 @@ import { ContractTemplateData, ContractTemplateDraftCacheStatus } from '../types
  */
 /** 载荷版本号。结构变更时递增，读到旧版本一律按不兼容丢弃，避免反序列化出半截数据。 */
 export declare const CONTRACT_TEMPLATE_DRAFT_CACHE_VERSION = 1;
+export declare const CONTRACT_TEMPLATE_FILES_DRAFT_CACHE_VERSION = 1;
 export declare const DEFAULT_DRAFT_CACHE_KEY = "gd-antdv:pro-contract-template-designer:draft";
 /** 自动缓存间隔，5s 是编辑手感与写盘频率的折中。 */
 export declare const DEFAULT_DRAFT_CACHE_INTERVAL = 5000;
@@ -43,6 +44,28 @@ export interface LoadTemplateDraftCacheResult {
     value?: ContractTemplateData;
     valueSerialized?: string;
 }
+export interface ContractTemplateFilesDraftCacheValue {
+    files: ContractTemplateFile[];
+    activeFileId: string;
+}
+export interface ContractTemplateFilesDraftCachePayload {
+    kind: 'files';
+    version: number;
+    savedAt: number;
+    value: ContractTemplateFilesDraftCacheValue;
+}
+export interface SaveTemplateFilesDraftCacheOptions {
+    storage?: ContractTemplateDraftCacheStorage;
+    key: string;
+    value: ContractTemplateFilesDraftCacheValue;
+    maxBytes: number;
+    previousValueSerialized?: string;
+}
+export interface LoadTemplateFilesDraftCacheResult {
+    status: ContractTemplateDraftCacheStatus;
+    value?: ContractTemplateFilesDraftCacheValue;
+    valueSerialized?: string;
+}
 /**
  * 探测可用的 localStorage。
  *
@@ -64,6 +87,8 @@ export declare function formatDraftCacheSavedAt(savedAt?: number): string;
  * 重新序列化、重新超限，白白消耗一次 JSON.stringify。
  */
 export declare function saveTemplateDraftCache(options: SaveTemplateDraftCacheOptions): SaveTemplateDraftCacheResult;
+/** 多文件模式以单个 envelope 保存名称、顺序、全部正文与当前文件。 */
+export declare function saveTemplateFilesDraftCache(options: SaveTemplateFilesDraftCacheOptions): SaveTemplateDraftCacheResult;
 /**
  * 读取草稿。
  *
@@ -71,6 +96,7 @@ export declare function saveTemplateDraftCache(options: SaveTemplateDraftCacheOp
  * 有但解析不了或版本不对（invalid）——只有第二种是正常状态，不该提示异常。
  */
 export declare function loadTemplateDraftCache(storage: ContractTemplateDraftCacheStorage | undefined, key: string): LoadTemplateDraftCacheResult;
+export declare function loadTemplateFilesDraftCache(storage: ContractTemplateDraftCacheStorage | undefined, key: string): LoadTemplateFilesDraftCacheResult;
 /** 清理草稿。删除失败同样只回报状态，不影响后续编辑。 */
 export declare function clearTemplateDraftCache(storage: ContractTemplateDraftCacheStorage | undefined, key: string): ContractTemplateDraftCacheStatus;
 /**
@@ -81,3 +107,5 @@ export declare function clearTemplateDraftCache(storage: ContractTemplateDraftCa
  * 判定条件：无变量、只有一页、无签署位置，且这一页正文 HTML 与 JSON 都是空的。
  */
 export declare function isBlankTemplateDraftValue(value: ContractTemplateData | undefined): boolean;
+/** 仅当当前每份文件都为空时才自动恢复多文件草稿，避免覆盖宿主已有正文。 */
+export declare function isBlankTemplateFilesDraftValue(value: ContractTemplateFilesDraftCacheValue | undefined): boolean;

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

@@ -0,0 +1,24 @@
+import { ContractTemplateData, ContractTemplateFile, ContractTemplateFilesExportResult, ContractTemplatePageSize } from '../types';
+/** 深拷贝多文件数据，避免宿主与设计器共享嵌套页面引用。 */
+export declare function cloneContractTemplateFiles(files: ContractTemplateFile[]): {
+    id: string;
+    name: string;
+    template: ContractTemplateData;
+}[];
+export declare function createContractTemplateFile(name?: string, pageSize?: ContractTemplatePageSize): ContractTemplateFile;
+/**
+ * 归一化文件 id、名称和内部模板。
+ * 重复/空 id 只在编辑态补成稳定新 id，外部数据不会被原地改写。
+ */
+export declare function normalizeContractTemplateFiles(input: ContractTemplateFile[] | undefined, fallbackTemplate?: ContractTemplateData, pageSize?: ContractTemplatePageSize): ContractTemplateFile[];
+/** 当前 id 不可用时稳定回退第一份文件，空数组返回空字符串。 */
+export declare function resolveContractTemplateActiveFileId(files: ContractTemplateFile[], activeFileId?: string): string;
+/** 不可变替换一份文件的模板；找不到 id 时保持原数组内容。 */
+export declare function replaceContractTemplateFile(files: ContractTemplateFile[], fileId: string, template: ContractTemplateData): ContractTemplateFile[];
+/** 文件名去首尾空白；空名称沿用旧名称，避免生成不可识别的空标签。 */
+export declare function renameContractTemplateFile(files: ContractTemplateFile[], fileId: string, name: string): ContractTemplateFile[];
+/** 至少保留一份文件；无法删除时返回原顺序的浅拷贝。 */
+export declare function removeContractTemplateFile(files: ContractTemplateFile[], fileId: string): ContractTemplateFile[];
+/** 按相邻方向移动文件，越界或找不到文件时保持原顺序。 */
+export declare function moveContractTemplateFile(files: ContractTemplateFile[], fileId: string, direction: -1 | 1): ContractTemplateFile[];
+export declare function exportContractTemplateFiles(files: ContractTemplateFile[]): ContractTemplateFilesExportResult;