@guodun/antdv 1.2.5 → 1.3.0

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

@@ -0,0 +1,71 @@
+import { VNode } from 'vue';
+type __VLS_Props = {
+    title: string;
+    filledCount: number;
+    totalCount: number;
+    requiredMissingCount: number;
+    zoom: number;
+    pages: Array<{
+        id: string;
+        title: string;
+    }>;
+    activePageId: string;
+    minZoom: number;
+    maxZoom: number;
+    showToolbar?: boolean;
+    showValidateButton?: boolean;
+    showResetButton?: boolean;
+    showSubmitButton?: boolean;
+    showPanelToggle?: boolean;
+    panelCollapsed?: boolean;
+    readonly?: boolean;
+    disabled?: boolean;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: Readonly<{
+        extra?: () => VNode[] | undefined;
+    }> & {
+        extra?: () => VNode[] | undefined;
+    };
+    refs: {};
+    rootEl: HTMLElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    validate: () => any;
+    reset: () => any;
+    submit: () => any;
+    fitWidth: () => any;
+    resetZoom: () => any;
+    zoomIn: () => any;
+    zoomOut: () => any;
+    selectPage: (pageId: string) => any;
+    togglePanel: () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onValidate?: (() => any) | undefined;
+    onReset?: (() => any) | undefined;
+    onSubmit?: (() => any) | undefined;
+    onFitWidth?: (() => any) | undefined;
+    onResetZoom?: (() => any) | undefined;
+    onZoomIn?: (() => any) | undefined;
+    onZoomOut?: (() => any) | undefined;
+    onSelectPage?: ((pageId: string) => any) | undefined;
+    onTogglePanel?: (() => any) | undefined;
+}>, {
+    disabled: boolean;
+    readonly: boolean;
+    showToolbar: boolean;
+    showValidateButton: boolean;
+    showResetButton: boolean;
+    showSubmitButton: boolean;
+    showPanelToggle: boolean;
+    panelCollapsed: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/{antdv/src/components → components}/pro-contract-template-designer/src/ContractTemplateRendererToolbar.vue.d.ts

@@ -1,3 +1,9 @@
+/**
+ * 渲染器 header 内的缩放与页码工具组。
+ *
+ * 无状态组件，缩放与翻页都上抛给渲染器处理；
+ * 禁用阈值由 minZoom / maxZoom 传入，与渲染器裁剪范围对齐。
+ */
 type __VLS_Props = {
     zoom: number;
     pages: Array<{
@@ -5,18 +11,23 @@ type __VLS_Props = {
         title: string;
     }>;
     activePageId: string;
+    minZoom?: number;
+    maxZoom?: number;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    fitWidth: () => any;
     resetZoom: () => any;
     zoomIn: () => any;
     zoomOut: () => any;
-    fitWidth: () => any;
     selectPage: (pageId: string) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onFitWidth?: (() => any) | undefined;
     onResetZoom?: (() => any) | undefined;
     onZoomIn?: (() => any) | undefined;
     onZoomOut?: (() => any) | undefined;
-    onFitWidth?: (() => any) | undefined;
     onSelectPage?: ((pageId: string) => any) | undefined;
-}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+}>, {
+    minZoom: number;
+    maxZoom: number;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
 export default _default;

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

@@ -0,0 +1,197 @@
+import { JSONContent } from '@tiptap/core';
+import { ContractTemplateEditorCommand, ContractTemplateEditorState, ContractTemplateEditorTextAlign, ContractTemplateContentImage, ContractTemplateFieldType, ContractTemplatePage, ContractTemplatePageSize, ContractTemplateSelectedContentImage, 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;
+    variables: ContractTemplateVariable[];
+    selectedVariableKey?: string;
+    active?: boolean;
+    readonly?: boolean;
+    disabled?: boolean;
+    zoom?: number;
+    signingPlacements?: ContractTemplateSigningPlacement[];
+    selectedSigningPlacementId?: string;
+    processImageFile?: (file: File) => Promise<string | null>;
+};
+/**
+ * 探测每个表格命令当前是否可用，用于禁用右键菜单里不适用的项。
+ *
+ * 光标不在表格里时全部为 false；`probe` 把「先判断是否在表格、再问 Tiptap can()」
+ * 这段判断收敛到一处，省掉一份手写的全 false 兜底对象。
+ */
+declare function getTableCommandCapabilities(): ContractTemplateTableCommandCapabilities;
+/**
+ * 预演一次破坏性表格操作，算出会被删掉的变量个数。
+ *
+ * 手法是把命令的 `dispatch` 换成只读回调：ProseMirror 命令会照常算出结果事务，
+ * 但事务不会被提交到 view，因此这里只是「试算」，编辑器内容保持不变。
+ */
+declare function getAffectedVariableCount(action: 'delete-table-row' | 'delete-table-column' | 'delete-table'): number;
+/**
+ * 汇总工具栏需要的编辑器状态。
+ *
+ * 工具栏按钮的激活态、可撤销状态、字体字号颜色全部来自这里，
+ * 编辑器尚未创建时各项取默认值，保证父组件拿到的结构始终完整。
+ */
+declare function getEditorState(): ContractTemplateEditorState;
+/**
+ * 计算「插入到当前可见区域中心」的签署位置坐标。
+ *
+ * 工具栏插入签署控件时不该放到页面正中——长页面下用户可能正看着页尾，
+ * 因此取页面与画布可视区的交集中心；两者不相交（页面完全滚出视野）时退回页面中心。
+ */
+declare function getVisibleSigningPlacementPosition(type: ContractTemplateSigningPlacementType): {
+    x: number;
+    y: number;
+};
+/**
+ * 插入变量节点。
+ *
+ * 给了屏幕坐标就插到落点处（拖拽落地），否则插在当前光标处（工具栏点击）；
+ * 两条路径只差插入命令本身，其余共用同一个 chain。
+ */
+declare function insertVariable(variable: ContractTemplateVariable, position?: {
+    left: number;
+    top: number;
+}): ContractTemplatePage | undefined;
+/** 插入合同正文真实图片；variables 与签署位置均不受影响。 */
+declare function insertContentImage(image: ContractTemplateContentImage, position?: number | {
+    from: number;
+    to: number;
+}): ContractTemplatePage | undefined;
+/**
+ * 更新当前 NodeSelection 图片的尺寸。
+ *
+ * patch 没有出现的维度保持不变；显式传入 undefined 会写回 schema 默认 null，
+ * 让浏览器重新按图片固有比例和自然尺寸渲染。
+ */
+declare function updateSelectedContentImage(patch: Pick<ContractTemplateContentImage, 'width' | 'height'>): ContractTemplatePage | undefined;
+/** 异步图片处理前冻结选区，避免上传完成后插到用户新切换的光标位置。 */
+declare function getSelectionRange(): {
+    from: number;
+    to: number;
+} | undefined;
+/** 只测量、不改正文；页数已达上限时由根组件先调用，防止 split 后内容丢失。 */
+declare function hasOverflowContent(): boolean;
+declare function splitOverflowContent(): {
+    page: ContractTemplatePage;
+    overflowContent: JSONContent[];
+    overflowHtml: string;
+} | undefined;
+/** 把上一页挤下来的内容插到本页开头；本页原本是空段落时直接丢弃那个空段落。 */
+declare function prependContent(content: JSONContent[]): ContractTemplatePage | undefined;
+/**
+ * 把变量的最新配置同步到正文里所有同名节点。
+ *
+ * 改 key 的场景要按旧 key 查找，所以 `previousKey` 单独传；
+ * 一次事务改完全部节点，撤销时也是一步还原。没有命中节点则不提交事务。
+ */
+declare function updateVariable(variable: ContractTemplateVariable, previousKey?: string): ContractTemplatePage | undefined;
+/**
+ * 删除正文里所有同名变量节点。
+ *
+ * 删除必须从后往前执行，否则前面的删除会让后面记录的位置整体前移而删错内容。
+ */
+declare function removeVariable(variableKey: string): ContractTemplatePage | undefined;
+/** 滚动到指定变量并高亮，同时把焦点交回编辑器；本页没有该变量时返回 false。 */
+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;
+/** 编辑器未就绪时退回 props 里的正文，保证导出不会拿到空字符串。 */
+declare function getHTML(): string;
+/** 按变量 id 或 key 滚动定位；变量面板里点击条目走这条路径。 */
+declare function scrollIntoField(fieldId: string): void;
+declare function scrollIntoPage(): void;
+declare const _default: import('vue').DefineComponent<__VLS_Props, {
+    focus: typeof focus;
+    getHTML: typeof getHTML;
+    getJSON: typeof getJSON;
+    getEditorState: typeof getEditorState;
+    getTableCommandCapabilities: typeof getTableCommandCapabilities;
+    getAffectedVariableCount: typeof getAffectedVariableCount;
+    getVisibleSigningPlacementPosition: typeof getVisibleSigningPlacementPosition;
+    insertVariable: typeof insertVariable;
+    insertContentImage: typeof insertContentImage;
+    updateSelectedContentImage: typeof updateSelectedContentImage;
+    getSelectionRange: typeof getSelectionRange;
+    hasOverflowContent: typeof hasOverflowContent;
+    updateVariable: typeof updateVariable;
+    removeVariable: typeof removeVariable;
+    splitOverflowContent: typeof splitOverflowContent;
+    prependContent: typeof prependContent;
+    runCommand: typeof runCommand;
+    scrollIntoField: typeof scrollIntoField;
+    scrollIntoVariable: typeof scrollIntoVariable;
+    scrollIntoSigningPlacement: typeof scrollIntoSigningPlacement;
+    scrollIntoPage: typeof scrollIntoPage;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "page-update": (page: ContractTemplatePage) => any;
+    "variable-drop": (pageId: string, type: ContractTemplateFieldType, clientX: number, clientY: number) => any;
+    "signing-placement-drop": (pageId: string, payload: ContractTemplateSigningPlacementDragPayload, x: number, y: number) => any;
+    "signing-placement-select": (placement: ContractTemplateSigningPlacement) => any;
+    "signing-placement-move": (placement: ContractTemplateSigningPlacement) => any;
+    "signing-placement-remove": (placement: ContractTemplateSigningPlacement) => any;
+    "variable-select": (variableKey: string) => any;
+    "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;
+}, 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;
+    "onSigning-placement-drop"?: ((pageId: string, payload: ContractTemplateSigningPlacementDragPayload, x: number, y: number) => any) | undefined;
+    "onSigning-placement-select"?: ((placement: ContractTemplateSigningPlacement) => any) | undefined;
+    "onSigning-placement-move"?: ((placement: ContractTemplateSigningPlacement) => any) | undefined;
+    "onSigning-placement-remove"?: ((placement: ContractTemplateSigningPlacement) => any) | undefined;
+    "onVariable-select"?: ((variableKey: string) => any) | undefined;
+    "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;
+}>, {
+    disabled: boolean;
+    readonly: boolean;
+    active: boolean;
+    zoom: number;
+    processImageFile: (file: File) => Promise<string | null>;
+    signingPlacements: ContractTemplateSigningPlacement[];
+    selectedVariableKey: string;
+    selectedSigningPlacementId: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    pageElement: HTMLDivElement;
+}, HTMLElement>;
+export default _default;

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

@@ -0,0 +1,120 @@
+import { ContractTemplateContentImage, ContractTemplateData, 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;
+    validate: () => ContractTemplateValidationError[];
+    exportTemplate: () => import('./types').ContractTemplateExportResult;
+    getSubmitData: () => import('./types').ContractTemplateExportResult;
+    clearTemplate: () => ContractTemplateData;
+    saveDraftCache: () => ContractTemplateDraftCacheStatus;
+    loadDraftCache: () => ContractTemplateData | undefined;
+    clearDraftCache: () => void;
+    getDraftCacheStatus: () => ContractTemplateDraftCacheStatus;
+    insertVariable: (variable: Partial<ContractTemplateVariable> & Pick<ContractTemplateVariable, "key" | "label">) => ContractTemplateVariable | undefined;
+    insertImage: (source: File | string, image?: Omit<ContractTemplateContentImage, "src">) => Promise<string | undefined>;
+    focus: () => void;
+    openPreview: () => void;
+    closePreview: () => void;
+    openSubmitDataViewer: () => import('./types').ContractTemplateExportResult;
+    closeSubmitDataViewer: () => void;
+    setServerValidationErrors: (errors: ContractTemplateValidationError[]) => void;
+    clearValidationErrors: () => void;
+    scrollToVariable: (variableKey: string) => void;
+    scrollToSigningPlacement: (placementId: string) => void;
+    scrollToPage: (pageId: string) => void;
+    setZoom: (value: number) => number;
+    resetZoom: () => number;
+    getZoom: () => number;
+    fitWidth: () => number;
+    insertSigningPlacement: (type: ContractTemplateSigningPlacementType, pageId?: string, position?: {
+        x: number;
+        y: number;
+    }) => ContractTemplateSigningPlacement | undefined;
+    selectSigningPlacement: (id?: string) => void;
+    buildLocationRules: (options: ContractTemplateLocationRuleOptions) => ContractTemplateLocationRule[];
+    buildContractLocationRules: (options: ContractTemplateLocationRuleOptions) => ContractLocationRule[];
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    validate: (errors: ContractTemplateValidationError[]) => any;
+    "update:modelValue": (value: ContractTemplateData) => any;
+    change: (value: ContractTemplateData) => any;
+    "signing-placement-select": (placement: ContractTemplateSigningPlacement | undefined) => any;
+    "signing-placement-remove": (placement: ContractTemplateSigningPlacement) => any;
+    "variable-add": (variable: ContractTemplateVariable) => any;
+    "draft-cache-change": (status: ContractTemplateDraftCacheStatus) => any;
+    "page-limit": (maxPages: number, source: "add" | "duplicate" | "auto-pagination") => any;
+    "image-error": (error: Error, source: ContractTemplateImageSource) => any;
+    "signing-placement-add": (placement: ContractTemplateSigningPlacement) => any;
+    "signing-placement-change": (placement: ContractTemplateSigningPlacement) => any;
+}, string, import('vue').PublicProps, Readonly<ContractTemplateDesignerProps> & Readonly<{
+    onValidate?: ((errors: ContractTemplateValidationError[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: ContractTemplateData) => any) | undefined;
+    onChange?: ((value: ContractTemplateData) => any) | undefined;
+    "onSigning-placement-select"?: ((placement: ContractTemplateSigningPlacement | undefined) => any) | undefined;
+    "onSigning-placement-remove"?: ((placement: ContractTemplateSigningPlacement) => 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;
+    "onImage-error"?: ((error: Error, source: ContractTemplateImageSource) => any) | undefined;
+    "onSigning-placement-add"?: ((placement: ContractTemplateSigningPlacement) => any) | undefined;
+    "onSigning-placement-change"?: ((placement: ContractTemplateSigningPlacement) => any) | undefined;
+}>, {
+    disabled: boolean;
+    modelValue: ContractTemplateData;
+    readonly: boolean;
+    pageSize: ContractTemplatePageSize;
+    maxPages: number;
+    variableTypes: import('./types').ContractTemplateFieldTypeOption[];
+    defaultVariableStyle: ContractTemplateFieldStyle;
+    fontFamilies: import('./types').ContractTemplateFontFamilyOption[];
+    fontFamilyMode: import('./types').ContractTemplateFontFamilyMode;
+    showSubmitDataViewer: boolean;
+    showClearButton: boolean;
+    showSigningPlacementTools: boolean;
+    enableDraftCache: boolean;
+    draftCacheKey: string;
+    draftCacheInterval: number;
+    draftCacheMaxBytes: number;
+    showDraftCacheStatus: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    designerElement: HTMLDivElement;
+    workspaceElement: HTMLElement;
+    toolbarMainElement: HTMLDivElement;
+    toolbarExtraOverflowElement: HTMLDivElement;
+    canvasElement: HTMLDivElement;
+    tableContextMenuElement: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<{
+        capabilities: ContractTemplateTableCommandCapabilities;
+        activeAlignment: ContractTemplateEditorTextAlign | "mixed";
+    }> & Readonly<{
+        onKeydown?: ((event: KeyboardEvent) => any) | undefined;
+        onExecute?: ((command: ContractTemplateEditorCommand) => any) | undefined;
+    }>, {
+        focusFirstItem: () => void;
+        getMenuElement: () => HTMLElement | undefined;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+        keydown: (event: KeyboardEvent) => any;
+        execute: (command: ContractTemplateEditorCommand) => 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<{
+        capabilities: ContractTemplateTableCommandCapabilities;
+        activeAlignment: ContractTemplateEditorTextAlign | "mixed";
+    }> & Readonly<{
+        onKeydown?: ((event: KeyboardEvent) => any) | undefined;
+        onExecute?: ((command: ContractTemplateEditorCommand) => any) | undefined;
+    }>, {
+        focusFirstItem: () => void;
+        getMenuElement: () => HTMLElement | undefined;
+    }, {}, {}, {}, {}> | null;
+    imageContextMenuElement: HTMLDivElement;
+    textContextMenuElement: HTMLDivElement;
+    imageFileInputElement: HTMLInputElement;
+}, HTMLDivElement>;
+export default _default;

package/dist/types/{antdv/src/components → components}/pro-contract-template-designer/src/ProContractTemplateRenderer.vue.d.ts

@@ -4,12 +4,15 @@ declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: Readonly<{
         field?: (props: ContractTemplateRendererFieldSlotProps) => VNode[] | undefined;
+        headerExtra?: () => VNode[] | undefined;
     }> & {
         field?: (props: ContractTemplateRendererFieldSlotProps) => VNode[] | undefined;
+        headerExtra?: () => VNode[] | undefined;
     };
     refs: {
         rendererElement: HTMLElement;
         pagesViewportElement: HTMLDivElement;
+        fieldListElement: HTMLDivElement;
     };
     rootEl: HTMLElement;
 };
@@ -30,28 +33,33 @@ declare const __VLS_component: import('vue').DefineComponent<ContractTemplateRen
     validate: (errors: ContractTemplateValidationError[]) => any;
     change: (value: ContractTemplateRenderValues) => any;
     submit: (value: ContractTemplateRenderValues) => any;
-    "update:values": (value: ContractTemplateRenderValues) => any;
     "update:zoom": (value: number) => any;
+    "update:values": (value: ContractTemplateRenderValues) => any;
 }, string, import('vue').PublicProps, Readonly<ContractTemplateRendererProps> & Readonly<{
     onValidate?: ((errors: ContractTemplateValidationError[]) => any) | undefined;
     onChange?: ((value: ContractTemplateRenderValues) => any) | undefined;
     onSubmit?: ((value: ContractTemplateRenderValues) => any) | undefined;
-    "onUpdate:values"?: ((value: ContractTemplateRenderValues) => any) | undefined;
     "onUpdate:zoom"?: ((value: number) => any) | undefined;
+    "onUpdate:values"?: ((value: ContractTemplateRenderValues) => any) | undefined;
 }>, {
     values: ContractTemplateRenderValues;
     disabled: boolean;
+    title: string;
     template: import('./types').ContractTemplateData;
     readonly: boolean;
     zoom: number;
     showToolbar: boolean;
-    interactionMode: import('./types').ContractTemplateRendererMode;
+    showValidateButton: boolean;
+    showResetButton: boolean;
     showSubmitButton: boolean;
+    interactionMode: import('./types').ContractTemplateRendererMode;
     validateOnSubmit: boolean;
     showPageMeta: boolean;
+    collapsiblePanel: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     rendererElement: HTMLElement;
     pagesViewportElement: HTMLDivElement;
+    fieldListElement: HTMLDivElement;
 }, HTMLElement>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;

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

@@ -0,0 +1,17 @@
+import { ContractTemplatePageSize, ContractTemplateSigningPlacement } from './types';
+type __VLS_Props = {
+    placement?: ContractTemplateSigningPlacement;
+    pageSize: ContractTemplatePageSize;
+    readonly?: boolean;
+    disabled?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    remove: () => any;
+    update: (patch: Partial<ContractTemplateSigningPlacement>) => any;
+    duplicate: () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onRemove?: (() => any) | undefined;
+    onUpdate?: ((patch: Partial<ContractTemplateSigningPlacement>) => any) | undefined;
+    onDuplicate?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLElement>;
+export default _default;

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

@@ -0,0 +1,19 @@
+import { ContractTemplatePageSize, ContractTemplateSigningPlacement } from './types';
+type __VLS_Props = {
+    pageSize: ContractTemplatePageSize;
+    placements: ContractTemplateSigningPlacement[];
+    selectedId?: string;
+    zoom: number;
+    readonly?: boolean;
+    disabled?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    select: (placement: ContractTemplateSigningPlacement) => any;
+    remove: (placement: ContractTemplateSigningPlacement) => any;
+    move: (placement: ContractTemplateSigningPlacement) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((placement: ContractTemplateSigningPlacement) => any) | undefined;
+    onRemove?: ((placement: ContractTemplateSigningPlacement) => any) | undefined;
+    onMove?: ((placement: ContractTemplateSigningPlacement) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

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

@@ -0,0 +1,22 @@
+import { ContractTemplateEditorCommand, ContractTemplateEditorTextAlign, ContractTemplateTableCommandCapabilities } from './types';
+type __VLS_Props = {
+    capabilities: ContractTemplateTableCommandCapabilities;
+    activeAlignment: ContractTemplateEditorTextAlign | 'mixed';
+};
+/** 菜单弹出后把焦点放到第一个可用项，禁用项要跳过。 */
+declare function focusFirstItem(): void;
+/** 暴露根节点，供设计器遍历菜单项做键盘导航。 */
+declare function getMenuElement(): HTMLElement | undefined;
+declare const _default: import('vue').DefineComponent<__VLS_Props, {
+    focusFirstItem: typeof focusFirstItem;
+    getMenuElement: typeof getMenuElement;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    keydown: (event: KeyboardEvent) => any;
+    execute: (command: ContractTemplateEditorCommand) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onKeydown?: ((event: KeyboardEvent) => any) | undefined;
+    onExecute?: ((command: ContractTemplateEditorCommand) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    menuElement: HTMLDivElement;
+}, HTMLDivElement>;
+export default _default;

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

@@ -0,0 +1,23 @@
+type __VLS_Props = {
+    disabled?: boolean;
+    maxSize?: number;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    select: (value: {
+        rows: number;
+        cols: number;
+    }) => any;
+    close: () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((value: {
+        rows: number;
+        cols: number;
+    }) => any) | undefined;
+    onClose?: (() => any) | undefined;
+}>, {
+    disabled: boolean;
+    maxSize: number;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    gridElement: HTMLDivElement;
+}, HTMLDivElement>;
+export default _default;

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

@@ -0,0 +1,28 @@
+import { MaybeRefOrGetter } from 'vue';
+export interface UseFitWidthZoomOptions {
+    /** 画布滚动容器的内容宽度（不含纵向滚动条占用时以 clientWidth 为准）。 */
+    viewportWidth: MaybeRefOrGetter<number>;
+    /** 未缩放时最宽一页的逻辑像素宽度。 */
+    widestPageWidth: MaybeRefOrGetter<number>;
+    /** 从容器宽度里扣除的左右留白，默认 48（两侧各 24）。 */
+    padding?: MaybeRefOrGetter<number>;
+    minZoom: MaybeRefOrGetter<number>;
+    maxZoom: MaybeRefOrGetter<number>;
+    /** 读取当前缩放，避免自动适宽在浮点误差内反复写入。 */
+    getZoom: () => number;
+    /** 写入缩放；自动路径与手动路径共用，由调用方决定是否回抛给宿主。 */
+    applyZoom: (value: number) => number;
+}
+/**
+ * 画布适宽缩放。
+ *
+ * 容器放不下最宽一页时自动缩小；用户点过 +/- / 百分比后不再自动覆盖。
+ * 只自动缩小、不自动放大，避免滚动条显隐造成宽度振荡。
+ */
+export declare function useFitWidthZoom(options: UseFitWidthZoomOptions): {
+    fitZoom: import('vue').ComputedRef<number>;
+    fitWidth: () => number;
+    applyAutoFit: () => number;
+    markUserAdjusted: () => void;
+    userAdjusted: import('vue').Ref<boolean, boolean>;
+};