@guodun/antdv 1.2.4 → 1.3.0

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/components/pro-contract-template-designer/src/ProContractTemplateRenderer.vue.d.ts

@@ -0,0 +1,70 @@
+import { VNode } from 'vue';
+import { ContractTemplateRenderValues, ContractTemplateRendererFieldSlotProps, ContractTemplateRendererProps, ContractTemplateValidationError } from './types';
+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;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<ContractTemplateRendererProps, {
+    getValues: () => ContractTemplateRenderValues;
+    setValues: (values: ContractTemplateRenderValues) => void;
+    validate: () => ContractTemplateValidationError[];
+    submit: () => false | ContractTemplateRenderValues;
+    resetValues: () => ContractTemplateRenderValues;
+    scrollToVariable: (variableKey: string) => void;
+    setZoom: (value: number) => number;
+    resetZoom: () => number;
+    getZoom: () => number;
+    fitWidth: () => number;
+    scrollToPage: (pageId: string) => void;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    validate: (errors: ContractTemplateValidationError[]) => any;
+    change: (value: ContractTemplateRenderValues) => any;
+    submit: (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: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;
+    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;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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>;
+};

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

@@ -0,0 +1,139 @@
+import { JSONContent } from '@tiptap/core';
+import { ContractTemplateData, ContractTemplateExportResult, ContractTemplateFieldStyle, ContractTemplateFieldType, ContractTemplateFieldTypeOption, ContractTemplatePage, ContractTemplatePageFormat, ContractTemplatePageSize, ContractTemplateSigningPlacement, ContractTemplateValidationError, ContractTemplateVariable } from '../types';
+/** 内置页面尺寸预设，宽高按 96 DPI 像素给出。 */
+export declare const PAGE_SIZE_OPTIONS: ContractTemplatePageSize[];
+/** 默认页面尺寸 A4；拷贝一份避免调用方改写预设数组。 */
+export declare const DEFAULT_PAGE_SIZE: ContractTemplatePageSize;
+/** 新建变量的默认展示样式；变量自身样式和类型默认值会在其之上覆盖。 */
+export declare const DEFAULT_FIELD_STYLE: ContractTemplateFieldStyle;
+/** 多行文本变量的默认行数。 */
+export declare const DEFAULT_MULTILINE_ROWS = 3;
+/** 多行文本变量的默认行高（px）。 */
+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 页。 */
+export declare function normalizeContractTemplateMaxPages(value: unknown): number;
+/** 正文可插入的变量类型及其默认尺寸。 */
+export declare const DEFAULT_FIELD_TYPES: ContractTemplateFieldTypeOption[];
+/** 生成设计器内部 ID；时间戳加自增序号，保证同一次会话内不重复。 */
+export declare function createDesignerId(prefix: string): string;
+/** 深拷贝模板数据，切断与响应式对象的引用。 */
+export declare function cloneTemplateValue(value: ContractTemplateData): ContractTemplateData;
+/** 按纸张格式取预设尺寸；`Custom` 或未知格式返回 undefined。 */
+export declare function getPageSizeOption(format: ContractTemplatePageFormat): ContractTemplatePageSize | undefined;
+/** 反推纸张格式：显式 format 优先，其次按宽高匹配预设。 */
+export declare function inferPageFormat(pageSize?: Partial<ContractTemplatePageSize>): ContractTemplatePageFormat | undefined;
+/**
+ * 归一化页面尺寸。
+ *
+ * 命中预设格式时强制使用预设宽高，只有 `Custom` 才保留外部传入的数值，
+ * 避免同一格式的页面在不同模板里出现细微尺寸差。
+ */
+export declare function resolvePageSize(pageSize: Partial<ContractTemplatePageSize> | undefined, fallback?: ContractTemplatePageSize): ContractTemplatePageSize;
+/** 新建带引导文案的页面，用于首次进入设计器。 */
+export declare function createDefaultPage(index?: number, pageSize?: ContractTemplatePageSize): ContractTemplatePage;
+/** 新建空白页面，用于清空模板、追加页面和自动分页。 */
+export declare function createBlankPage(index?: number, pageSize?: ContractTemplatePageSize, contentHtml?: string, contentJson?: ContractTemplatePage['contentJson']): ContractTemplatePage;
+/** 带引导文案的初始模板。 */
+export declare function createDefaultTemplate(pageSize?: ContractTemplatePageSize): ContractTemplateData;
+/** 全空白模板，`clearTemplate()` 使用。 */
+export declare function createBlankTemplate(pageSize?: ContractTemplatePageSize): ContractTemplateData;
+/** 取变量类型选项；未知类型退回第一项，保证 UI 仍有可展示的标签和尺寸。 */
+export declare function getFieldOption(type: ContractTemplateFieldType, fieldTypes?: ContractTemplateFieldTypeOption[]): ContractTemplateFieldTypeOption;
+/**
+ * 补全变量的所有字段。
+ *
+ * 优先级为「显式入参 > 类型默认值 > 类型选项默认值 > 全局默认」，样式按同样顺序
+ * 逐层覆盖，宽高和行高会做下限裁剪防止渲染出不可见控件。
+ */
+export declare function createTemplateVariable(options: Partial<ContractTemplateVariable> & Pick<ContractTemplateVariable, 'key'>, fieldTypes?: ContractTemplateFieldTypeOption[], defaultStyle?: ContractTemplateFieldStyle): ContractTemplateVariable;
+/**
+ * 把外部传入的模板归一成设计器可用的完整结构。
+ *
+ * 缺页补一页空白页、缺 ID 现场补 ID、页面尺寸逐层继承模板尺寸；变量以
+ * `variables` 字段为基础，再用正文里扫出来的节点补齐遗漏的 key。正文显式声明
+ * 的未知类型会覆盖 `variables` 里的默认 text，避免脏数据在校验前被抹平。
+ */
+export declare function normalizeTemplateValue(value: ContractTemplateData | undefined, pageSize?: ContractTemplatePageSize): ContractTemplateData;
+/** 拼接设计态整册 HTML：每页一个 `section`，正文保持编辑器原样。 */
+export declare function buildTemplateHtml(value: ContractTemplateData): string;
+/** 拼接服务端渲染用整册 HTML：变量节点文本换成 `${{key}}` 表达式。 */
+export declare function buildTemplateExpressionHtml(value: ContractTemplateData): string;
+/**
+ * 拼接预览用整册 HTML。
+ *
+ * 变量节点按 `variables` 的权威元数据重算展示文本与样式，并把页面宽高写进
+ * 行内样式，让预览弹窗不依赖设计器画布的容器尺寸。
+ */
+export declare function buildTemplatePreviewHtml(value: ContractTemplateData): string;
+/** 单页预览快照；签署位置保持独立数据，不能拼入正文 HTML。 */
+export interface ContractTemplatePreviewPage {
+    page: ContractTemplatePage;
+    contentHtml: string;
+    signingPlacements: ContractTemplateSigningPlacement[];
+}
+/**
+ * 构建供 Vue 预览页消费的只读快照。
+ *
+ * 正文仍沿用既有净化和变量展示逻辑；签署位置按 pageId 单独分组，
+ * 由受控覆盖层渲染，避免进入 contentHtml、导出 HTML 或 PDF DTO。
+ */
+export declare function buildTemplatePreviewPages(value: ContractTemplateData): ContractTemplatePreviewPage[];
+/**
+ * 生成提交给宿主的导出结果。
+ *
+ * 先深拷贝再附加渲染器/样式版本号和表达式 HTML，保证导出快照与设计态数据解耦，
+ * 宿主后续改动设计态不会污染已经拿到的导出对象。
+ */
+export declare function exportTemplateValue(value: ContractTemplateData): ContractTemplateExportResult;
+/**
+ * 全量校验模板结构，返回可定位到具体节点的错误列表。
+ *
+ * 覆盖四类问题：变量缺少 key、key 重复、显式声明了不支持的类型，以及变量配置与
+ * 正文节点两侧互相缺失（正文引用了未配置的 key，或配置了没有正文节点的变量）。
+ * 签署位置的校验委托给 `validateSigningPlacements`。
+ */
+export declare function validateTemplateValue(value: ContractTemplateData, options?: {
+    maxPages?: number;
+}): ContractTemplateValidationError[];
+/**
+ * 收集单页引用到的变量 key。
+ *
+ * 同时扫描 Tiptap JSON 和正文 HTML：前者覆盖当前编辑态，后者兼容只存了
+ * `contentHtml` 的历史模板；`templateField` 是旧节点名，必须继续识别。
+ */
+export declare function collectTemplateVariableKeys(page: ContractTemplatePage): Set<string>;
+/** 汇总整份模板引用到的变量 key。 */
+export declare function collectTemplateValueVariableKeys(value: Pick<ContractTemplateData, 'pages'>): Set<string>;
+/** 删除正文里已经不存在的变量配置，让 `variables` 与正文节点保持一致。 */
+export declare function syncTemplateVariablesWithPages(value: ContractTemplateData): ContractTemplateData;
+/** 自动分页用的单个顶层块测量结果，坐标相对正文容器顶部。 */
+export interface ContractTemplateBlockMeasurement {
+    top: number;
+    height: number;
+}
+/** 自动分页结果：`splitIndex` 为溢出块下标，`-1` 表示当前页无需拆分。 */
+export interface ContractTemplateContentSplitResult {
+    splitIndex: number;
+    currentContent: JSONContent[];
+    overflowContent: JSONContent[];
+}
+/**
+ * 依据实测块高决定当前页在哪个顶层块处溢出。
+ *
+ * 只按块边界拆分：找到第一个底边超出可用高度（留 1px 容差抵消亚像素误差）的块，
+ * 把它及之后的内容整体挪到下一页。返回 `undefined` 表示无需分页。
+ */
+export declare function splitPageContentByMeasurements(content: JSONContent[] | undefined, measurements: ContractTemplateBlockMeasurement[], maxContentHeight: number): ContractTemplateContentSplitResult | undefined;
+/** 规则导出必须先通过完整模板校验，不能只检查签署位置自身。 */
+export declare function collectTemplateLocationRuleExportErrors(value: ContractTemplateData, inputErrors?: ContractTemplateValidationError[]): ContractTemplateValidationError[];
+/**
+ * 常量的兼容转发。
+ *
+ * 这些常量的实现已经搬到 `../constants`，但历史上是从本模块对外导出的，
+ * 保留转发以免破坏 `@guodun/antdv` 的既有引用路径。
+ */
+export { CONTRACT_TEXT_STYLE_PRESETS, CONTRACT_TEXT_STYLE_PRESET_COMMANDS, DEFAULT_CONTRACT_FONT_FAMILY, DEFAULT_FONT_FAMILY_OPTIONS, DEFAULT_FONT_SIZE_PRESETS, DEFAULT_TEXT_ALIGN_OPTIONS, getContractTextStylePreset, normalizeFontFamilyValue, resolveContractTextStylePresetCommands, resolveFontFamilyOptions, } from '../constants';

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

@@ -0,0 +1,83 @@
+import { ContractTemplateData, ContractTemplateDraftCacheStatus } from '../types';
+/**
+ * 合同模板草稿的本地缓存层。
+ *
+ * 纯函数集合：storage 由调用方注入（浏览器传 localStorage，测试传内存实现），
+ * 所有失败都折成 `ContractTemplateDraftCacheStatus` 返回而不抛异常——
+ * 草稿缓存属于「尽力而为」的能力，绝不能因为写不进去而中断用户编辑。
+ */
+/** 载荷版本号。结构变更时递增，读到旧版本一律按不兼容丢弃，避免反序列化出半截数据。 */
+export declare const CONTRACT_TEMPLATE_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;
+/** 单份草稿上限 2MB：localStorage 总配额通常 5–10MB，留出余量给宿主自己的数据。 */
+export declare const DEFAULT_DRAFT_CACHE_MAX_BYTES: number;
+/** 只取 localStorage 的三个方法，便于测试注入内存实现。 */
+export interface ContractTemplateDraftCacheStorage {
+    getItem: (key: string) => string | null;
+    setItem: (key: string, value: string) => void;
+    removeItem: (key: string) => void;
+}
+/** 落盘的完整载荷。`savedAt` 用于状态栏展示「几点几分已缓存」。 */
+export interface ContractTemplateDraftCachePayload {
+    version: number;
+    savedAt: number;
+    value: ContractTemplateData;
+}
+export interface SaveTemplateDraftCacheOptions {
+    storage?: ContractTemplateDraftCacheStorage;
+    key: string;
+    value: ContractTemplateData;
+    maxBytes: number;
+    /** 上一次写入时的序列化结果，用来跳过内容没变的定时写入。 */
+    previousValueSerialized?: string;
+}
+export interface SaveTemplateDraftCacheResult {
+    status: ContractTemplateDraftCacheStatus;
+    /** 回传本次序列化结果，调用方缓存下来作为下一轮的 `previousValueSerialized`。 */
+    valueSerialized?: string;
+}
+export interface LoadTemplateDraftCacheResult {
+    status: ContractTemplateDraftCacheStatus;
+    value?: ContractTemplateData;
+    valueSerialized?: string;
+}
+/**
+ * 探测可用的 localStorage。
+ *
+ * 只判断 `window` 存在不够：隐私模式、被策略禁用、配额为 0 时读写都会抛异常，
+ * 所以写一个探测键再删掉，真正能写才认为可用。
+ */
+export declare function getBrowserDraftCacheStorage(): ContractTemplateDraftCacheStorage | undefined;
+/** 状态对象工厂：统一 type 与 message 的位置，额外字段（字节数、时间、错误）按需补。 */
+export declare function createDraftCacheStatus(type: ContractTemplateDraftCacheStatus['type'], message: string, patch?: Omit<Partial<ContractTemplateDraftCacheStatus>, 'type' | 'message'>): ContractTemplateDraftCacheStatus;
+/** 估算 UTF-8 字节数，用于和 `maxBytes` 比对。 */
+export declare function estimateDraftCacheBytes(value: string): number;
+/** 状态栏只显示 `HH:mm`，日期对「几分钟前存过」这个信息没有帮助。 */
+export declare function formatDraftCacheSavedAt(savedAt?: number): string;
+/**
+ * 写入草稿。
+ *
+ * 顺序是「无 storage → 内容未变 → 超限 → 实际写入」，越便宜的判断越靠前。
+ * 注意超限和写失败也会回传 `valueSerialized`：否则下一轮定时器会对同样的内容
+ * 重新序列化、重新超限，白白消耗一次 JSON.stringify。
+ */
+export declare function saveTemplateDraftCache(options: SaveTemplateDraftCacheOptions): SaveTemplateDraftCacheResult;
+/**
+ * 读取草稿。
+ *
+ * 三类失败要分开告知用户：读不出来（read-failed）、没有草稿（idle）、
+ * 有但解析不了或版本不对（invalid）——只有第二种是正常状态，不该提示异常。
+ */
+export declare function loadTemplateDraftCache(storage: ContractTemplateDraftCacheStorage | undefined, key: string): LoadTemplateDraftCacheResult;
+/** 清理草稿。删除失败同样只回报状态，不影响后续编辑。 */
+export declare function clearTemplateDraftCache(storage: ContractTemplateDraftCacheStorage | undefined, key: string): ContractTemplateDraftCacheStatus;
+/**
+ * 判断草稿是否等价于「什么都没写」。
+ *
+ * 空模板也会被序列化成一份完整结构（一页空段落），如果不识别出来，
+ * 用户一打开设计器就会看到「已恢复本地草稿」的提示，属于噪音。
+ * 判定条件：无变量、只有一页、无签署位置，且这一页正文 HTML 与 JSON 都是空的。
+ */
+export declare function isBlankTemplateDraftValue(value: ContractTemplateData | undefined): boolean;