@guodun/antdv 1.4.1 → 1.4.3

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

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

@@ -1,4 +1,4 @@
-import { ContractTemplateEditorCommand, ContractTemplateEditorTextAlign, ContractTemplateFontFamilyMode, ContractTemplateFontFamilyOption, ContractTemplateTextStylePreset, ContractTemplateTextStylePresetKey } from './types';
+import { ContractTemplateEditorCommand, ContractTemplateEditorTextAlign, ContractTemplateBlockStyle, ContractTemplateFontFamilyMode, ContractTemplateFontFamilyOption, ContractTemplateTextStylePreset, ContractTemplateTextStylePresetKey } from './types';
 /**
  * 合同正文默认字体。
  *
@@ -17,6 +17,9 @@ export declare const DEFAULT_TEXT_ALIGN_OPTIONS: Array<{
     label: string;
     value: ContractTemplateEditorTextAlign;
 }>;
+/** Word 式段落样式；只统一结构、字号、粗体和段距，其余人工格式继续保留。 */
+export declare const CONTRACT_BLOCK_STYLES: ContractTemplateBlockStyle[];
+export declare function getContractBlockStyle(format: ContractTemplateBlockStyle['format']): ContractTemplateBlockStyle | undefined;
 /**
  * 合同文本样式预设。
  *
@@ -39,6 +42,9 @@ export declare function resolveContractTextStylePresetCommands(key: ContractTemp
 } | {
     type: "set-heading";
     level: import('./types').ContractTemplateHeadingLevel;
+} | {
+    type: "apply-block-style";
+    format: import('./types').ContractTemplateBlockFormat;
 } | {
     type: "toggle-heading";
     level: import('./types').ContractTemplateHeadingLevel;

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

@@ -11,6 +11,52 @@ export interface ContractTemplatePageSize {
     height: number;
     label?: string;
 }
+export type ContractTemplateDecorationTextAlign = 'left' | 'center' | 'right';
+export interface ContractTemplateHeaderFooterSlots {
+    left: string;
+    center: string;
+    right: string;
+}
+/** 页眉或页脚的纯文本配置；支持 {pageNumber} / {totalPages} 页码令牌。 */
+export interface ContractTemplateHeaderFooterConfig {
+    enabled: boolean;
+    text: string;
+    textAlign: ContractTemplateDecorationTextAlign;
+    fontSize: number;
+    color: string;
+    /** 新渲染器的三栏权威内容；缺省时由 text/textAlign 迁移。 */
+    slots?: ContractTemplateHeaderFooterSlots;
+    showOnFirstPage?: boolean;
+    fontFamily?: string;
+    fontWeight?: 400 | 600;
+    /** 距对应页面边缘的距离，单位 px。 */
+    offset?: number;
+    divider?: {
+        enabled: boolean;
+        color: string;
+    };
+}
+/** 每页居中的文字水印配置。 */
+export interface ContractTemplateWatermarkConfig {
+    enabled: boolean;
+    text: string;
+    fontSize: number;
+    color: string;
+    opacity: number;
+    rotation: number;
+    showOnFirstPage?: boolean;
+    layout?: 'single' | 'tiled';
+    density?: 'sparse' | 'normal' | 'dense';
+}
+/** 模板级页面装饰；所有页面共享同一份页眉、页脚和水印配置。 */
+export interface ContractTemplatePageDecorations {
+    header: ContractTemplateHeaderFooterConfig;
+    footer: ContractTemplateHeaderFooterConfig;
+    watermark: ContractTemplateWatermarkConfig;
+    pageNumbering?: {
+        countFirstPage: boolean;
+    };
+}
 export interface ContractTemplateFieldStyle {
     border?: boolean;
     underline?: boolean;
@@ -118,6 +164,8 @@ export interface ContractTemplateData {
     pageSize: ContractTemplatePageSize;
     /** 旧模板可缺省；归一化后的模板始终带空数组。 */
     signingPlacements?: ContractTemplateSigningPlacement[];
+    /** 旧模板可缺省；配置后由设计器预览、填写渲染器和 PDF 服务共同消费。 */
+    pageDecorations?: ContractTemplatePageDecorations;
 }
 /** 多文件设计器中的一份独立合同文件；正文、变量和签署位置均在文件内隔离。 */
 export interface ContractTemplateFile {
@@ -138,6 +186,15 @@ export interface ContractTemplateFontFamilyOption {
 export type ContractTemplateFontFamilyMode = 'append' | 'replace';
 export type ContractTemplateEditorTextAlign = 'left' | 'center' | 'right';
 export type ContractTemplateHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+export type ContractTemplateBlockFormat = 'paragraph' | ContractTemplateHeadingLevel;
+export interface ContractTemplateBlockStyle {
+    format: ContractTemplateBlockFormat;
+    label: string;
+    fontSize: number;
+    bold: boolean;
+    marginTop: number;
+    marginBottom: number;
+}
 export type ContractTemplateTextStylePresetKey = 'contractTitle' | 'clauseTitle' | 'bodyClause' | 'appendixTitle';
 export interface ContractTemplateTextStylePreset {
     key: ContractTemplateTextStylePresetKey;
@@ -162,6 +219,8 @@ export interface ContractTemplateEditorState {
     isOrderedList: boolean;
     isTableActive: boolean;
     currentHeadingLevel?: ContractTemplateHeadingLevel;
+    /** 选区内同时包含正文与标题或多个标题层级。 */
+    hasMixedBlockFormats?: boolean;
     textAlign: ContractTemplateEditorTextAlign;
     fontFamily?: string;
     fontSize?: number;
@@ -203,6 +262,9 @@ export type ContractTemplateEditorCommand = {
 } | {
     type: 'set-heading';
     level: ContractTemplateHeadingLevel;
+} | {
+    type: 'apply-block-style';
+    format: ContractTemplateBlockFormat;
 } | {
     type: 'toggle-heading';
     level: ContractTemplateHeadingLevel;
@@ -678,3 +740,30 @@ export interface ContractTemplateDesignerExpose {
     /** 将当前模板签署位置投影为 packages/contract 使用的严格 DTO。 */
     buildContractLocationRules: (options: ContractTemplateLocationRuleOptions) => ContractLocationRule[];
 }
+export type ContractTemplateEditorContextMenuPayload = {
+    type: 'text';
+    pageId: string;
+    clientX: number;
+    clientY: number;
+    hasSelection: boolean;
+    selectionWidth?: number;
+    leadingText?: string;
+} | {
+    type: 'table';
+    pageId: string;
+    clientX: number;
+    clientY: number;
+    capabilities: ContractTemplateTableCommandCapabilities;
+    activeAlignment: ContractTemplateEditorTextAlign | 'mixed';
+    affectedVariableCounts: {
+        deleteRow: number;
+        deleteColumn: number;
+        deleteTable: number;
+    };
+} | {
+    type: 'image';
+    pageId: string;
+    clientX: number;
+    clientY: number;
+    image: ContractTemplateSelectedContentImage;
+};

package/dist/types/components/pro-contract-template-designer/src/utils/block-style.d.ts

@@ -0,0 +1,4 @@
+import { Editor } from '@tiptap/core';
+import { ContractTemplateBlockFormat } from '../types';
+/** 将段落样式应用到当前选区覆盖的完整块，保留字体、颜色、对齐和装饰等其它格式。 */
+export declare function applyContractTemplateBlockStyle(editor: Editor, format: ContractTemplateBlockFormat): boolean;

package/dist/types/components/pro-contract-template-designer/src/utils/context-menu-viewport.d.ts

@@ -0,0 +1,25 @@
+/** 右键菜单贴边时的视口内边距；正文/图片/表格共用，避免各写一套魔法数。 */
+export declare const CONTEXT_MENU_VIEWPORT_PADDING = 12;
+export declare const TEXT_CONTEXT_MENU_ESTIMATED_WIDTH = 304;
+export declare const TEXT_CONTEXT_MENU_ESTIMATED_HEIGHT = 300;
+export declare const IMAGE_CONTEXT_MENU_ESTIMATED_WIDTH = 288;
+export declare const IMAGE_CONTEXT_MENU_ESTIMATED_HEIGHT = 196;
+export declare const TABLE_CONTEXT_MENU_ESTIMATED_WIDTH = 248;
+export declare const TABLE_CONTEXT_MENU_ESTIMATED_HEIGHT = 400;
+/** 选区气泡是紧凑单行工具条，首帧按这组估算值夹位，渲染后再按实测尺寸校正。 */
+export declare const TEXT_BUBBLE_MENU_ESTIMATED_WIDTH = 380;
+export declare const TEXT_BUBBLE_MENU_ESTIMATED_HEIGHT = 40;
+/**
+ * 把菜单左上角夹进视口。
+ *
+ * 首帧常用估算宽高，渲染后再用 {@link clampContextMenuToElement} 按实测尺寸校正。
+ */
+export declare function clampContextMenuPosition(clientX: number, clientY: number, width: number, height: number, padding?: number): {
+    x: number;
+    y: number;
+};
+/** 按菜单真实包围盒再夹一次，避免估算尺寸和实测不一致时贴边被裁。 */
+export declare function clampContextMenuToElement(x: number, y: number, element: HTMLElement, padding?: number): {
+    x: number;
+    y: number;
+};

package/dist/types/components/pro-contract-template-designer/src/utils/editor-state.d.ts

@@ -0,0 +1,8 @@
+import { ContractTemplateEditorState } from '../types';
+/**
+ * 比较两份工具栏编辑器状态是否等价。
+ *
+ * Tiptap 每次 transaction 都会上报状态；工具栏按钮激活态往往没变。
+ * 只比较扁平字段和当前选中图片，避免对整份 state 做 JSON.stringify。
+ */
+export declare function isSameEditorState(previous: ContractTemplateEditorState, next: ContractTemplateEditorState): boolean;

package/dist/types/components/pro-contract-template-designer/src/utils/page-decorations.d.ts

@@ -0,0 +1,90 @@
+import { ContractTemplateHeaderFooterConfig, ContractTemplateHeaderFooterSlots, ContractTemplatePageDecorations, ContractTemplateRenderValues, ContractTemplateValidationError, ContractTemplateVariable, ContractTemplateWatermarkConfig } from '../types';
+export declare const CONTRACT_PAGE_BASE_PADDING: {
+    readonly top: 54;
+    readonly right: 64;
+    readonly bottom: 54;
+    readonly left: 64;
+};
+export declare const CONTRACT_PAGE_DECORATED_PADDING = 80;
+export declare const CONTRACT_PAGE_DECORATION_TOKEN_LIMIT = 240;
+export type ContractTemplatePageDecorationPresetKey = 'none' | 'page-number' | 'internal-review' | 'draft' | 'custom';
+export type ContractTemplateWatermarkDensity = 'sparse' | 'normal' | 'dense';
+export type ContractTemplatePageDecorationFieldPath = `header.slots.${keyof ContractTemplateHeaderFooterSlots}` | `footer.slots.${keyof ContractTemplateHeaderFooterSlots}` | 'watermark.text';
+export interface NormalizedContractTemplateHeaderFooterConfig extends ContractTemplateHeaderFooterConfig {
+    slots: ContractTemplateHeaderFooterSlots;
+    showOnFirstPage: boolean;
+    fontFamily: string;
+    fontWeight: 400 | 600;
+    offset: number;
+    divider: {
+        enabled: boolean;
+        color: string;
+    };
+}
+export interface NormalizedContractTemplateWatermarkConfig extends ContractTemplateWatermarkConfig {
+    showOnFirstPage: boolean;
+    layout: 'single' | 'tiled';
+    density: ContractTemplateWatermarkDensity;
+}
+export interface NormalizedContractTemplatePageDecorations extends ContractTemplatePageDecorations {
+    header: NormalizedContractTemplateHeaderFooterConfig;
+    footer: NormalizedContractTemplateHeaderFooterConfig;
+    watermark: NormalizedContractTemplateWatermarkConfig;
+    pageNumbering: {
+        countFirstPage: boolean;
+    };
+}
+export type PageDecorationToken = {
+    type: 'text';
+    value: string;
+} | {
+    type: 'pageNumber';
+} | {
+    type: 'totalPages';
+} | {
+    type: 'variable';
+    key: string;
+    raw: string;
+};
+export interface PageDecorationTokenIssue {
+    code: 'DECORATION_TOKEN_MALFORMED' | 'DECORATION_VARIABLE_UNKNOWN' | 'DECORATION_VARIABLE_IMAGE_UNSUPPORTED';
+    message: string;
+    token: string;
+    offset: number;
+}
+export declare const WATERMARK_DENSITY_GRID: Record<ContractTemplateWatermarkDensity, {
+    columns: number;
+    rows: number;
+}>;
+export declare const DEFAULT_PAGE_DECORATIONS: NormalizedContractTemplatePageDecorations;
+/** 旧 text/textAlign 在这里一次性迁移，后续所有调用方只消费完整三栏模型。 */
+export declare function normalizePageDecorations(value?: Partial<ContractTemplatePageDecorations>): NormalizedContractTemplatePageDecorations;
+export declare function createPageDecorationPreset(key: Exclude<ContractTemplatePageDecorationPresetKey, 'custom'>): NormalizedContractTemplatePageDecorations;
+export declare function resolvePageDecorationPreset(value?: Partial<ContractTemplatePageDecorations>): ContractTemplatePageDecorationPresetKey;
+export declare function hasEnabledPageHeader(value?: Partial<ContractTemplatePageDecorations>, physicalPageNumber?: number): boolean;
+export declare function hasEnabledPageFooter(value?: Partial<ContractTemplatePageDecorations>, physicalPageNumber?: number): boolean;
+export declare function hasEnabledPageWatermark(value?: Partial<ContractTemplatePageDecorations>, physicalPageNumber?: number): boolean;
+export declare function getPageDecorationNumbers(physicalPageNumber: number, physicalTotalPages: number, countFirstPage?: boolean): {
+    pageNumber: string;
+    totalPages: string;
+};
+export declare function interpolatePageDecorationText(text: string, physicalPageNumber: number, physicalTotalPages: number, countFirstPage?: boolean): string;
+export declare function parsePageDecorationText(text: string, variables?: readonly ContractTemplateVariable[], validateReferences?: boolean): {
+    tokens: PageDecorationToken[];
+    issues: PageDecorationTokenIssue[];
+};
+export declare function collectPageDecorationVariableKeys(value?: Partial<ContractTemplatePageDecorations>): Set<string>;
+export declare function validatePageDecorations(value: Partial<ContractTemplatePageDecorations> | undefined, variables: readonly ContractTemplateVariable[]): ContractTemplateValidationError[];
+/** 从页面装饰校验错误中还原可聚焦的表单字段路径。 */
+export declare function resolvePageDecorationValidationPath(error: Pick<ContractTemplateValidationError, 'code' | 'id'>): ContractTemplatePageDecorationFieldPath | undefined;
+/** 重命名与显式删除只改变量令牌，固定正文中相同字样不会被误改。 */
+export declare function rewritePageDecorationVariableTokens(value: Partial<ContractTemplatePageDecorations> | undefined, previousKey: string, nextKey?: string): NormalizedContractTemplatePageDecorations;
+export declare function resolvePageDecorationTokenText(token: PageDecorationToken, variables: readonly ContractTemplateVariable[], values: ContractTemplateRenderValues | undefined, physicalPageNumber: number, physicalTotalPages: number, countFirstPage: boolean): string;
+export declare function getWatermarkDensityGrid(density: ContractTemplateWatermarkDensity): {
+    columns: number;
+    rows: number;
+};
+export declare function getPageDecorationSafePadding(config: ContractTemplateHeaderFooterConfig): number;
+export declare function buildPageDecorationClassNames(value?: Partial<ContractTemplatePageDecorations>, physicalPageNumber?: number): string;
+/** 导出 HTML 只输出转义文本、白名单样式和静态平铺节点，不依赖运行时脚本。 */
+export declare function buildPageDecorationsHtml(value: Partial<ContractTemplatePageDecorations> | undefined, physicalPageNumber: number, physicalTotalPages: number, variables?: readonly ContractTemplateVariable[], values?: ContractTemplateRenderValues): string;

package/dist/types/components/pro-contract-template-designer/src/utils/serialize-fingerprint.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 模板 / 文件快照指纹。
+ *
+ * 设计器用序列化字符串判断「是不是自己 emit 回去的同一份数据」，
+ * 避免 v-model 回流把光标和选中态清掉。各处必须走同一套算法，不能有的
+ * stringify、有的手写比较，否则指纹对不上就会误重置编辑器。
+ */
+export declare function serializeFingerprint(value: unknown): string;

package/dist/types/components/pro-contract-template-designer/src/utils/template-renderer.d.ts

@@ -1,4 +1,4 @@
-import { ContractTemplateData, ContractTemplatePageFormat, ContractTemplateRenderValue, ContractTemplateRenderValues, ContractTemplateValidationError } from '../types';
+import { ContractTemplateData, ContractTemplatePageFormat, ContractTemplatePageDecorations, ContractTemplateRenderValue, ContractTemplateRenderValues, ContractTemplateValidationError, ContractTemplateVariable } from '../types';
 import { isSafeContractImageUrl } from './image-url';
 export { isSafeContractImageUrl };
 export type ContractTemplateRenderHtmlMode = 'control' | 'display';
@@ -15,6 +15,9 @@ export interface ContractTemplateRenderPage {
     width: number;
     height: number;
     contentHtml: string;
+    pageDecorations?: ContractTemplatePageDecorations;
+    decorationVariables: ContractTemplateVariable[];
+    decorationValues: ContractTemplateRenderValues;
 }
 /** 按变量默认值生成初始填写值，供渲染器首次挂载和 resetValues 共用。 */
 export declare function buildInitialRenderValues(template: ContractTemplateData | undefined): ContractTemplateRenderValues;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guodun/antdv",
-  "version": "1.4.1",
+  "version": "1.4.3",
   "type": "module",
   "files": [
     "CHANGELOG.md",
@@ -52,8 +52,8 @@
     "vite": "^8.0.1",
     "vite-plugin-dts": "^4.5.4",
     "vue-tsc": "^3.2.5",
-    "@guodun/tsconfig": "^1.0.0",
-    "@guodun/theme": "^1.0.1"
+    "@guodun/theme": "^1.0.1",
+    "@guodun/tsconfig": "^1.0.0"
   },
   "dependencies": {
     "@ant-design/icons-vue": "^7.0.1",