@guodun/antdv 1.5.3 → 1.6.1

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

@@ -1,5 +1,5 @@
 import { JSONContent } from '@tiptap/core';
-import { ContractTemplateData, ContractTemplateExportResult, ContractTemplateFieldStyle, ContractTemplateFieldType, ContractTemplateFieldTypeOption, ContractTemplatePage, ContractTemplatePageFormat, ContractTemplatePageSize, ContractTemplateSigningPlacement, ContractTemplateValidationError, ContractTemplateVariable } from '../types';
+import { ContractTemplateData, ContractTemplateExportResult, ContractTemplateFieldStyle, ContractTemplateFieldType, ContractTemplateFieldTypeOption, ContractTemplatePage, ContractTemplatePageFormat, ContractTemplatePageSize, ContractTemplateValidationError, ContractTemplateVariable } from '../types';
 /** 内置页面尺寸预设，宽高按 96 DPI 像素给出。 */
 export declare const PAGE_SIZE_OPTIONS: ContractTemplatePageSize[];
 /** 默认页面尺寸 A4；拷贝一份避免调用方改写预设数组。 */
@@ -53,18 +53,7 @@ export declare function getPageSizeKey(pageSize: ContractTemplatePageSize): stri
 export declare function normalizePageSizeOptions(options?: ContractTemplatePageSize[]): ContractTemplatePageSize[];
 /** 在已归一化的白名单中查找与页面尺寸完全一致的候选项。 */
 export declare function findPageSizeOption(pageSize: ContractTemplatePageSize, options: ContractTemplatePageSize[]): ContractTemplatePageSize | undefined;
-export interface ContractTemplatePageSizeConstraintResult {
-    value: ContractTemplateData;
-    /** 页面尺寸回退后发生缩放的签署位置 ID。 */
-    resizedSigningPlacementIds: string[];
-}
-/**
- * 把模板默认尺寸和每页尺寸约束到宿主白名单。
- *
- * 不支持的尺寸回退到第一个候选；页面上的签署位置同步按宽高比例缩放。
- * 入参应先经过 `normalizeTemplateValue`，保证每页都有完整尺寸和签署位置结构。
- */
-export declare function constrainTemplatePageSizes(value: ContractTemplateData, options?: ContractTemplatePageSize[]): ContractTemplatePageSizeConstraintResult;
+export declare function constrainTemplatePageSizes(value: ContractTemplateData, options?: ContractTemplatePageSize[]): ContractTemplateData;
 /** 新建带引导文案的页面，用于首次进入设计器。 */
 export declare function createDefaultPage(index?: number, pageSize?: ContractTemplatePageSize): ContractTemplatePage;
 /** 新建空白页面，用于清空模板、追加页面和自动分页。 */
@@ -101,17 +90,15 @@ export declare function buildTemplateExpressionHtml(value: ContractTemplateData)
  * 行内样式，让预览弹窗不依赖设计器画布的容器尺寸。
  */
 export declare function buildTemplatePreviewHtml(value: ContractTemplateData): string;
-/** 单页预览快照；签署位置保持独立数据，不能拼入正文 HTML。 */
+/** 单页预览快照。 */
 export interface ContractTemplatePreviewPage {
     page: ContractTemplatePage;
     contentHtml: string;
-    signingPlacements: ContractTemplateSigningPlacement[];
 }
 /**
  * 构建供 Vue 预览页消费的只读快照。
  *
- * 正文仍沿用既有净化和变量展示逻辑；签署位置按 pageId 单独分组，
- * 由受控覆盖层渲染，避免进入 contentHtml、导出 HTML 或 PDF DTO。
+ * 正文仍沿用既有净化和变量展示逻辑；签署标记已写入正文 HTML。
  */
 export declare function buildTemplatePreviewPages(value: ContractTemplateData): ContractTemplatePreviewPage[];
 /**
@@ -130,7 +117,6 @@ export declare function exportTemplateValue(value: ContractTemplateData): Contra
  *
  * 覆盖四类问题：变量缺少 key、key 重复、显式声明了不支持的类型，以及变量配置与
  * 正文节点两侧互相缺失（正文引用了未配置的 key，或配置了没有正文节点的变量）。
- * 签署位置的校验委托给 `validateSigningPlacements`。
  */
 export declare function validateTemplateValue(value: ContractTemplateData, options?: {
     maxPages?: number;
@@ -169,8 +155,6 @@ export interface ContractTemplateContentSplitResult {
  * 把它及之后的内容整体挪到下一页。返回 `undefined` 表示无需分页。
  */
 export declare function splitPageContentByMeasurements(content: JSONContent[] | undefined, measurements: ContractTemplateBlockMeasurement[], maxContentHeight: number): ContractTemplateContentSplitResult | undefined;
-/** 规则导出必须先通过完整模板校验，不能只检查签署位置自身。 */
-export declare function collectTemplateLocationRuleExportErrors(value: ContractTemplateData, inputErrors?: ContractTemplateValidationError[]): ContractTemplateValidationError[];
 /**
  * 常量的兼容转发。
  *

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

@@ -104,7 +104,7 @@ export declare function clearTemplateDraftCache(storage: ContractTemplateDraftCa
  *
  * 空模板也会被序列化成一份完整结构（一页空段落），如果不识别出来，
  * 用户一打开设计器就会看到「已恢复本地草稿」的提示，属于噪音。
- * 判定条件：无变量、只有一页、无签署位置，且这一页正文 HTML 与 JSON 都是空的。
+ * 判定条件：无变量、只有一页，且这一页正文 HTML 与 JSON 都是空的。
  */
 export declare function isBlankTemplateDraftValue(value: ContractTemplateData | undefined): boolean;
 /** 仅当当前每份文件都为空时才自动恢复多文件草稿，避免覆盖宿主已有正文。 */

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

@@ -14,7 +14,7 @@ export declare function normalizeContractTemplateFiles(input: ContractTemplateFi
 /**
  * 对每份文件独立套用页面尺寸白名单。
  *
- * 导入超页数上限时不在这里截断；被回退的签署位置 id 按文件分组，便于宿主同步坐标。
+ * 导入超页数上限时不在这里截断；页面尺寸只影响页面自身，不改变正文内容。
  */
 export declare function constrainContractTemplateFiles(files: ContractTemplateFile[], pageSizeOptions: ContractTemplatePageSize[] | undefined): {
     files: {
@@ -22,7 +22,6 @@ export declare function constrainContractTemplateFiles(files: ContractTemplateFi
         id: string;
         name: string;
     }[];
-    resizedSigningPlacementIds: Map<string, string[]>;
 };
 /** 当前 id 不可用时稳定回退第一份文件，空数组返回空字符串。 */
 export declare function resolveContractTemplateActiveFileId(files: ContractTemplateFile[], activeFileId?: string): string;

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

@@ -12,7 +12,7 @@ export declare function useToolbarOverflow(options: {
     measureDependencies: () => unknown;
     isDisposed: () => boolean;
 }): {
-    toolbarOverflowKeys: Ref<("table" | "list" | "font-family" | "insert" | "cleanup" | "alignment" | "font-appearance")[], ("table" | "list" | "font-family" | "insert" | "cleanup" | "alignment" | "font-appearance")[]>;
+    toolbarOverflowKeys: Ref<("table" | "list" | "font-family" | "insert" | "cleanup" | "alignment" | "font-appearance" | "signing")[], ("table" | "list" | "font-family" | "insert" | "cleanup" | "alignment" | "font-appearance" | "signing")[]>;
     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, ContractTemplateBlockStyle, ContractTemplateFontFamilyMode, ContractTemplateFontFamilyOption, ContractTemplateTextStylePreset, ContractTemplateTextStylePresetKey } from './types';
+import { ContractTemplateEditorCommand, ContractTemplateEditorTextAlign, ContractTemplateBlockStyle, ContractTemplateFontFamilyMode, ContractTemplateFontFamilyOption, ContractTemplateSigningMarkType, ContractTemplateTextStylePreset, ContractTemplateTextStylePresetKey } from './types';
 /**
  * 合同正文默认字体。
  *
@@ -99,6 +99,9 @@ export declare function resolveContractTextStylePresetCommands(key: ContractTemp
     preset: ContractTemplateTextStylePresetKey;
 } | {
     type: "insert-horizontal-rule";
+} | {
+    type: "insert-clause-snippet";
+    snippet: import('./types').ContractTemplateClauseSnippetKey;
 } | {
     type: "insert-content-image";
     image: import('./types').ContractTemplateContentImage;
@@ -106,6 +109,17 @@ export declare function resolveContractTextStylePresetCommands(key: ContractTemp
         from: number;
         to: number;
     };
+} | {
+    type: "insert-signing-mark";
+    mark: import('./types').ContractTemplateSigningMark;
+    position?: number | {
+        from: number;
+        to: number;
+    };
+} | {
+    type: "insert-signing-layout";
+    preset?: import('./types').ContractTemplateSigningLayoutPresetKey;
+    options?: import('./types').ContractTemplateSigningLayoutOptions;
 } | {
     type: "insert-table";
     options: import('./types').ContractTemplateTableInsertOptions;
@@ -151,3 +165,8 @@ export declare function normalizeFontFamilyValue(value: string | undefined): str
  * 用 Map 按归一化后的值去重，后写入的覆盖先写入的，所以宿主可以借同名项改标签。
  */
 export declare function resolveFontFamilyOptions(customOptions: ContractTemplateFontFamilyOption[] | undefined, mode?: ContractTemplateFontFamilyMode): ContractTemplateFontFamilyOption[];
+/** 工具栏签署标记入口的五种正文流标记工具项。 */
+export declare const SIGNING_MARK_TOOL_ITEMS: Array<{
+    markType: ContractTemplateSigningMarkType;
+    label: string;
+}>;

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

@@ -0,0 +1,5 @@
+import { NodeViewProps } from '@tiptap/core';
+declare const _default: import('vue').DefineComponent<NodeViewProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<NodeViewProps> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    markElement: HTMLSpanElement;
+}, any>;
+export default _default;

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

@@ -0,0 +1,12 @@
+import { Editor } from '@tiptap/core';
+import { Plugin, PluginKey } from '@tiptap/pm/state';
+import { DecorationSet } from '@tiptap/pm/view';
+import { ContractTextSearch } from '../utils/authoring-search';
+interface SearchState extends ContractTextSearch {
+    decorations: DecorationSet;
+}
+export declare const contractTextSearchKey: PluginKey<SearchState>;
+/** 高亮只在编辑视图中作为 Decoration 存在，不污染 contentHtml / JSON / 导出。 */
+export declare function createContractTextSearchPlugin(): Plugin<SearchState>;
+export declare function updateContractTextSearch(editor: Editor, search: ContractTextSearch): void;
+export {};

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

@@ -0,0 +1,16 @@
+import { Node } from '@tiptap/core';
+import { ContractTemplateSigningMarkType } from '../types';
+export interface SigningMarkExtensionOptions {
+    /** 页面 CSS transform 缩放比例；指针位移换算回页面像素时使用。 */
+    getZoom?: () => number;
+}
+/** 正文流内的签署标记：纯视觉占位，不参与变量绑定或外部坐标规则。 */
+export declare const SigningMark: Node<SigningMarkExtensionOptions, any>;
+export declare function insertSigningMarkNode(editor: {
+    chain: () => any;
+}, markType: ContractTemplateSigningMarkType, position?: number, overrides?: Partial<{
+    width: number;
+    height: number;
+    label: string;
+    sealType?: string;
+}>): any;

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

@@ -1,7 +1,7 @@
 import { JSONContent } from '@tiptap/core';
 import { Component } from 'vue';
 import { ContractTemplateImageCompression, ContractTemplateImageSource, ContractTemplateImageUploadHandler } from './utils/content-image';
-/** 正文变量只描述文档流内的填写项；签署位置使用独立的 signingPlacements。 */
+/** 正文变量只描述文档流内的填写项；签署标记写入正文流，由 CSL 负责坐标规则。 */
 export type ContractTemplateBasicFieldType = 'text' | 'date' | 'number' | 'image' | 'checkbox';
 export type ContractTemplateAdvancedChoiceFieldType = 'select' | 'radio';
 export type ContractTemplateBuiltinSelectorFieldType = 'user-selector' | 'dept-selector' | 'role-selector' | 'org-selector';
@@ -189,7 +189,7 @@ export interface ContractTemplatePage {
     contentHtml: string;
     contentJson?: JSONContent;
 }
-/** 合同正文中的真实图片节点；它不属于 variables 或 signingPlacements。 */
+/** 合同正文中的真实图片节点；它不属于 variables 或签署标记。 */
 export interface ContractTemplateContentImage {
     src: string;
     alt?: string;
@@ -201,57 +201,50 @@ export interface ContractTemplateContentImage {
 export interface ContractTemplateSelectedContentImage extends ContractTemplateContentImage {
     position: number;
 }
-/** 与正文变量并列的 PDF 页面签署位置；坐标以所属页面原始尺寸为基准。 */
-export type ContractTemplateSigningPlacementType = 'seal' | 'signature' | 'date';
-export interface ContractTemplateSigningPlacement {
-    id: string;
-    pageId: string;
-    type: ContractTemplateSigningPlacementType;
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    mustSign: boolean;
-    /** 仅印章位置允许输出印章类型；空数组等同于未选择。 */
-    sealTypes?: string[];
-}
-export interface ContractTemplateLocationRuleLocation {
-    signType: ContractTemplateSigningPlacementType;
-    signTop: number;
-    signLeft: number;
-    signWidth: number;
-    signHeight: number;
-    pageList: Record<string, number[]>;
-    sealType?: string[];
-}
-/** locationRules 的兼容 DTO；顶层元数据仅用于关联模板中的指定位置。 */
-export interface ContractTemplateLocationRule {
-    mustSign: boolean;
-    placementId: string;
-    pageId: string;
-    pageIndex: number;
-    location: ContractTemplateLocationRuleLocation;
-}
-/** 可直接传给 packages/contract 的严格 locationRules DTO。 */
-export interface ContractLocationRule {
-    mustSign: boolean;
-    location: ContractTemplateLocationRuleLocation;
-}
-export interface ContractTemplateLocationRulePageSize {
-    width: number;
-    height: number;
-}
-export type ContractTemplateLocationRuleTargetPageSizes = Record<string, ContractTemplateLocationRulePageSize> | ContractTemplateLocationRulePageSize[];
-export interface ContractTemplateLocationRuleOptions {
-    fileId: string;
-    targetPageSizes?: ContractTemplateLocationRuleTargetPageSizes;
+/** 正文流内的签署标记类型；纯视觉占位，不参与变量绑定。 */
+export type ContractTemplateSigningMarkType = 'seal' | 'signature' | 'date' | 'area' | 'line';
+export interface ContractTemplateSigningMark {
+    markType: ContractTemplateSigningMarkType;
+    width?: number;
+    height?: number;
+    label?: string;
+    sealType?: string;
+}
+/** 签署版式的排列方式；决定参数化 builder 生成的表格结构。 */
+export type ContractTemplateSigningLayoutArrangement = 'side-by-side' | 'stacked' | 'table-cell' | 'final-page';
+/** 签署版式包含项；均为正文流内的视觉占位，不产生绝对坐标规则。 */
+export interface ContractTemplateSigningLayoutFields {
+    /** 盖章框（seal 签署标记）。 */
+    seal: boolean;
+    /** 授权代表签字线（line 签署标记）。 */
+    signature: boolean;
+    /** 签署日期行。 */
+    date: boolean;
+    /** 职务行。 */
+    title: boolean;
+}
+/** 参数化签署版式入参；内置预设与自定义面板共用同一套 builder。 */
+export interface ContractTemplateSigningLayoutOptions {
+    /** 签署方数量，允许 1~6。 */
+    partyCount: number;
+    arrangement: ContractTemplateSigningLayoutArrangement;
+    fields: ContractTemplateSigningLayoutFields;
+    /** 缺省按天干生成「甲方 / 乙方 / 丙方…」。 */
+    partyNames?: string[];
+}
+/** 内置签署版式预设 key；同时写入表格的 data-signing-layout 属性。 */
+export type ContractTemplateSigningLayoutPresetKey = 'dual-party' | 'party-list' | 'table-cell' | 'final-page';
+/** 签署版式预设定义；宿主可通过 signingLayoutPresets 追加自定义项。 */
+export interface ContractTemplateSigningLayoutPreset {
+    key: string;
+    label: string;
+    description: string;
+    options: ContractTemplateSigningLayoutOptions;
 }
 export interface ContractTemplateData {
     pages: ContractTemplatePage[];
     variables: ContractTemplateVariable[];
     pageSize: ContractTemplatePageSize;
-    /** 旧模板可缺省；归一化后的模板始终带空数组。 */
-    signingPlacements?: ContractTemplateSigningPlacement[];
     /** 旧模板可缺省；配置后由设计器预览、填写渲染器和 PDF 服务共同消费。 */
     pageDecorations?: ContractTemplatePageDecorations;
 }
@@ -262,7 +255,7 @@ export interface ContractTemplateVariableData {
     /** 当前文件完整变量定义，顺序与模板保持一致。 */
     variables: ContractTemplateVariable[];
 }
-/** 多文件设计器中的一份独立合同文件；正文、变量和签署位置均在文件内隔离。 */
+/** 多文件设计器中的一份独立合同文件；正文、变量和页面配置均在文件内隔离。 */
 export interface ContractTemplateFile {
     id: string;
     name: string;
@@ -346,6 +339,7 @@ export interface ContractTemplateTableCommandCapabilities {
     toggleHeaderColumn: boolean;
     deleteTable: boolean;
 }
+export type ContractTemplateClauseSnippetKey = 'scope' | 'payment' | 'delivery';
 export type ContractTemplateEditorCommand = {
     type: 'undo';
 } | {
@@ -414,6 +408,9 @@ export type ContractTemplateEditorCommand = {
     preset: ContractTemplateTextStylePresetKey;
 } | {
     type: 'insert-horizontal-rule';
+} | {
+    type: 'insert-clause-snippet';
+    snippet: ContractTemplateClauseSnippetKey;
 } | {
     type: 'insert-content-image';
     image: ContractTemplateContentImage;
@@ -421,6 +418,17 @@ export type ContractTemplateEditorCommand = {
         from: number;
         to: number;
     };
+} | {
+    type: 'insert-signing-mark';
+    mark: ContractTemplateSigningMark;
+    position?: number | {
+        from: number;
+        to: number;
+    };
+} | {
+    type: 'insert-signing-layout';
+    preset?: ContractTemplateSigningLayoutPresetKey;
+    options?: ContractTemplateSigningLayoutOptions;
 } | {
     type: 'insert-table';
     options: ContractTemplateTableInsertOptions;
@@ -453,7 +461,7 @@ export type ContractTemplateEditorCommand = {
     type: 'delete-table';
 };
 export interface ContractTemplateValidationError {
-    type: 'field' | 'variable' | 'page' | 'security' | 'signing-placement';
+    type: 'field' | 'variable' | 'page' | 'security';
     id: string;
     message: string;
     /** 多文件校验时标识错误所属文件；旧单文件模式缺省。 */
@@ -639,7 +647,7 @@ export interface ContractTemplateDesignerProps {
     modelValue?: ContractTemplateData;
     /**
      * 多文件受控数据；传入后优先于 modelValue，并通过 update:files 同步。
-     * 每个文件独立保存页面、变量、签署位置和草稿正文。
+     * 每个文件独立保存页面、变量和草稿正文。
      */
     files?: ContractTemplateFile[];
     /** 多文件模式当前文件 id，可使用 v-model:active-file-id */
@@ -688,6 +696,11 @@ export interface ContractTemplateDesignerProps {
      * @default 内置 text/date/number/image/checkbox
      */
     variableTypes?: ContractTemplateFieldTypeOption[];
+    /**
+     * 内置签署版式之外追加的自定义版式；同 key 覆盖内置项。
+     * 由宿主加载已有版式；设计器本身不持久化自定义版式。
+     */
+    signingLayoutPresets?: ContractTemplateSigningLayoutPreset[];
     /** 展示下拉框与单选框工具；默认关闭，与组织选择器能力独立。 */
     showAdvancedChoiceControls?: boolean;
     /** 展示用户、部门、角色、组织架构工具；默认关闭。 */
@@ -723,11 +736,6 @@ export interface ContractTemplateDesignerProps {
      * @default true
      */
     showClearButton?: boolean;
-    /**
-     * 是否展示左侧签署位置导航、右侧新增工具、属性面板检查器与画布覆盖层；关闭后不删除已有位置，预览和导出仍可保留
-     * @default false
-     */
-    showSigningPlacementTools?: boolean;
     /**
      * 是否启用本地草稿缓存
      * @default true
@@ -783,14 +791,6 @@ export interface ContractTemplateDesignerEmits {
     'page-limit': [maxPages: number, source: 'add' | 'duplicate' | 'auto-pagination'];
     /** 本地图片读取、压缩或上传失败 */
     'image-error': [error: Error, source: ContractTemplateImageSource];
-    /** 新增签署位置；位置数据始终独立于正文 HTML/JSON */
-    'signing-placement-add': [placement: ContractTemplateSigningPlacement];
-    /** 签署位置几何或属性变化 */
-    'signing-placement-change': [placement: ContractTemplateSigningPlacement];
-    /** 删除签署位置 */
-    'signing-placement-remove': [placement: ContractTemplateSigningPlacement];
-    /** 选中签署位置变化；取消选中时为 undefined */
-    'signing-placement-select': [placement: ContractTemplateSigningPlacement | undefined];
 }
 export interface ContractTemplateDesignerExpose {
     /** 获取当前模板数据快照 */
@@ -855,8 +855,6 @@ export interface ContractTemplateDesignerExpose {
     clearValidationErrors: () => void;
     /** 滚动并高亮指定正文变量 */
     scrollToVariable: (variableKey: string) => void;
-    /** 滚动并选中指定签署位置 */
-    scrollToSigningPlacement: (placementId: string) => void;
     /** 滚动到指定页面 */
     scrollToPage: (pageId: string) => void;
     /** 设置设计区缩放比例，返回裁剪后的实际比例 */
@@ -867,17 +865,6 @@ export interface ContractTemplateDesignerExpose {
     getZoom: () => number;
     /** 按当前画布宽度缩放页面，并回到自动适宽模式 */
     fitWidth: () => number;
-    /** 在指定页面创建签署位置并返回归一化后的快照。 */
-    insertSigningPlacement: (type: ContractTemplateSigningPlacementType, pageId?: string, position?: {
-        x: number;
-        y: number;
-    }) => ContractTemplateSigningPlacement | undefined;
-    /** 选中签署位置；传入空值可清除选择。 */
-    selectSigningPlacement: (id?: string) => void;
-    /** 将当前模板签署位置转换为 contract locationRules 兼容结构。 */
-    buildLocationRules: (options: ContractTemplateLocationRuleOptions) => ContractTemplateLocationRule[];
-    /** 将当前模板签署位置投影为 packages/contract 使用的严格 DTO。 */
-    buildContractLocationRules: (options: ContractTemplateLocationRuleOptions) => ContractLocationRule[];
 }
 export type ContractTemplateEditorContextMenuPayload = {
     type: 'text';

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

@@ -0,0 +1,23 @@
+import { Editor } from '@tiptap/core';
+import { Node as ProseMirrorNode } from '@tiptap/pm/model';
+import { EditorState } from '@tiptap/pm/state';
+export interface ContractTextMatch {
+    from: number;
+    to: number;
+}
+export interface ContractTextSearch {
+    query: string;
+    matchCase: boolean;
+    activeMatch?: ContractTextMatch;
+}
+/** 仅拼接同一文本块内相邻的 text 节点：跨 mark 可查，atom / 换行 / 块边界不可穿越。 */
+export declare function findContractTextMatches(doc: ProseMirrorNode, query: string, matchCase?: boolean): ContractTextMatch[];
+/** 以当前文档重新校验位置；只替换完整合法命中，不能用过期选区或伪造范围删除 atom。 */
+export declare function buildContractTextReplacement(state: EditorState, search: Pick<ContractTextSearch, 'query' | 'matchCase'>, replacement: string, requestedMatches: readonly ContractTextMatch[]): {
+    transaction: import('prosemirror-state').Transaction;
+    count: number;
+};
+/** 每页一次事务；与前后输入分别形成撤销边界，不抢走查找输入框焦点。 */
+export declare function replaceContractTextMatches(editor: Editor | null | undefined, readonly: boolean, search: Pick<ContractTextSearch, 'query' | 'matchCase'>, replacement: string, matches: readonly ContractTextMatch[]): number;
+/** 大纲序号只计算真实 heading 节点（包含空标题）；返回可安全设置 TextSelection 的正文位置。 */
+export declare function findContractHeadingPosition(doc: ProseMirrorNode, headingIndex: number): number | undefined;

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

@@ -0,0 +1,3 @@
+export type ContractAuthoringShortcut = 'find' | 'replace' | 'next' | 'previous' | 'help';
+/** 只认当前实例的正文或工具按钮；属性面板、宿主表单、其它设计器与输入法组合态均不接管。 */
+export declare function resolveContractAuthoringShortcut(event: KeyboardEvent, root: HTMLElement | undefined): ContractAuthoringShortcut | undefined;

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

@@ -0,0 +1,10 @@
+import { JSONContent } from '@tiptap/core';
+import { ContractTemplateClauseSnippetKey } from '../types';
+/** 结构提示而非法律结论；插入后均为普通标题 / 段落，由编写人按实际约定填写。 */
+export declare const CONTRACT_CLAUSE_SNIPPETS: ReadonlyArray<{
+    key: ContractTemplateClauseSnippetKey;
+    label: string;
+    description: string;
+    prompts: readonly string[];
+}>;
+export declare function buildContractClauseSnippet(key: ContractTemplateClauseSnippetKey): JSONContent[];

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

@@ -0,0 +1,20 @@
+import { ContractTemplatePage } from '../types';
+export interface ContractDocumentHeading {
+    pageId: string;
+    /** 当前页真实 heading 节点的零基序号，包含未展示的空标题。 */
+    headingIndex: number;
+    level: number;
+    depth: number;
+    text: string;
+}
+export interface ContractPageNavigationContent {
+    text: string;
+    summary: string;
+    headings: ContractDocumentHeading[];
+}
+/**
+ * 与 DesignerPage 一样以 contentHtml 为准，并复用编辑器 schema。
+ * 不直接数 DOM h 标签：atom 内部 HTML、非法嵌套与表格都应服从 Tiptap 的解析结果。
+ * 解析文档永不挂到页面；只把纯文本交给 Vue 插值，不渲染用户 HTML。
+ */
+export declare function readContractPageNavigation(page: ContractTemplatePage): ContractPageNavigationContent;

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

@@ -0,0 +1,2 @@
+/** 面板内搜索按空白分词、忽略大小写；不修改正文或变量数据。 */
+export declare function matchesContractPanelSearch(query: string, ...values: Array<string | number | undefined>): boolean;

package/dist/types/components/pro-contract-template-designer/src/utils/signing-layout-presets.d.ts

@@ -0,0 +1,49 @@
+import { JSONContent } from '@tiptap/core';
+import { ContractTemplateSigningLayoutArrangement, ContractTemplateSigningLayoutFields, ContractTemplateSigningLayoutOptions, ContractTemplateSigningLayoutPreset, ContractTemplateSigningLayoutPresetKey } from '../types';
+export declare const DUAL_PARTY_SIGNING_LAYOUT = "dual-party";
+/** 自定义参数生成的签署版式统一落这个标识，避免宿主 key 进入 schema 白名单。 */
+export declare const CUSTOM_SIGNING_LAYOUT = "custom";
+export declare const MIN_SIGNING_LAYOUT_PARTY_COUNT = 1;
+export declare const MAX_SIGNING_LAYOUT_PARTY_COUNT = 6;
+export declare const SIGNING_LAYOUT_ARRANGEMENTS: ContractTemplateSigningLayoutArrangement[];
+export declare const SIGNING_LAYOUT_ARRANGEMENT_LABELS: Record<ContractTemplateSigningLayoutArrangement, string>;
+export declare const SIGNING_LAYOUT_FIELD_KEYS: Array<keyof ContractTemplateSigningLayoutFields>;
+export declare const SIGNING_LAYOUT_FIELD_LABELS: Record<keyof ContractTemplateSigningLayoutFields, string>;
+/** 默认按天干生成签署方名称，超出十方退化为「11方」。 */
+export declare function resolvePartyName(index: number): string;
+export declare const SIGNING_LAYOUT_PRESETS: Record<ContractTemplateSigningLayoutPresetKey, ContractTemplateSigningLayoutPreset>;
+export declare const SIGNING_LAYOUT_PRESET_KEYS: ContractTemplateSigningLayoutPresetKey[];
+/** schema 允许写入 data-signing-layout 的全部取值；外部 HTML 的其他取值一律丢弃。 */
+export declare const SIGNING_LAYOUT_ATTRIBUTE_VALUES: string[];
+export declare function isSigningLayoutPresetKey(value: unknown): value is ContractTemplateSigningLayoutPresetKey;
+export declare function isSigningLayoutAttributeValue(value: unknown): value is string;
+/** 收敛外部入参：夹取签署方数量、校验排列方式、保证至少留一个签署占位。 */
+export declare function normalizeSigningLayoutOptions(options: Partial<ContractTemplateSigningLayoutOptions> | undefined): ContractTemplateSigningLayoutOptions;
+/**
+ * 参数化生成正文流签署版式；内置预设与自定义面板共用这一个 builder。
+ *
+ * 表格属性只用于区分版式，签章留白始终是正文流内的 signingMark 节点，
+ * 绝不生成 CSL 的 locationRules —— 绝对坐标签署统一归 ContractSigningLocation。
+ */
+export declare function buildSigningLayoutContent(options: Partial<ContractTemplateSigningLayoutOptions>, layout?: string): JSONContent[];
+/** 按注册表 key 生成内置版式内容；data-signing-layout 直接落 preset key。 */
+export declare function buildSigningLayoutPresetContent(key: ContractTemplateSigningLayoutPresetKey): JSONContent[];
+/** @deprecated 使用 buildSigningLayoutPresetContent('dual-party')。 */
+export declare function buildDualPartySigningLayoutPreset(): JSONContent[];
+/** 自定义版式没有预设文案，用参数生成一句摘要给卡片与保存后的预设复用。 */
+export declare function describeSigningLayoutOptions(options: Partial<ContractTemplateSigningLayoutOptions>): string;
+export type ContractTemplateSigningLayoutPreviewItem = 'seal' | 'line' | 'date' | 'text';
+export interface ContractTemplateSigningLayoutPreviewCell {
+    partyLabel: string;
+    items: ContractTemplateSigningLayoutPreviewItem[];
+}
+/** 排版缩略图模型；预览用普通 div 渲染，不实例化编辑器。 */
+export interface ContractTemplateSigningLayoutPreviewModel {
+    arrangement: ContractTemplateSigningLayoutArrangement;
+    columns: number;
+    title?: string;
+    columnLabels?: string[];
+    cells: ContractTemplateSigningLayoutPreviewCell[];
+}
+/** 预览模型与 buildSigningLayoutContent 同源推导，保证 hover 缩略图与插入结果一致。 */
+export declare function buildSigningLayoutPreviewModel(options: Partial<ContractTemplateSigningLayoutOptions>): ContractTemplateSigningLayoutPreviewModel;

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

@@ -0,0 +1,57 @@
+import { ContractTemplateSigningMarkType } from '../types';
+export type SigningMarkResizeHandle = 'top-left' | 'top' | 'top-right' | 'right' | 'bottom-right' | 'bottom' | 'bottom-left' | 'left';
+export declare const MIN_SIGNING_MARK_DIMENSION = 24;
+export declare const MAX_SIGNING_MARK_DIMENSION = 800;
+export declare const SIGNING_MARK_TYPE_LABELS: Record<ContractTemplateSigningMarkType, string>;
+/** 三种正文流签署标记的默认尺寸（96dpi CSS 像素）。 */
+export declare const SIGNING_MARK_DEFAULT_SIZES: Record<ContractTemplateSigningMarkType, {
+    width: number;
+    height: number;
+}>;
+export declare const SIGNING_MARK_DEFAULT_LABELS: Record<ContractTemplateSigningMarkType, string>;
+export interface ContractTemplateSigningMarkAttrs {
+    markType: ContractTemplateSigningMarkType;
+    width: number;
+    height: number;
+    label: string;
+    sealType?: string;
+}
+export interface SigningMarkPresentation {
+    markType: ContractTemplateSigningMarkType;
+    width: number;
+    height: number;
+    label: string;
+    sealType?: string;
+    className: string;
+    style: Record<string, string>;
+    displayLabel: string;
+}
+export interface SigningMarkResizeInput {
+    width: number;
+    height: number;
+    startClientX: number;
+    startClientY: number;
+    clientX: number;
+    clientY: number;
+    handle: SigningMarkResizeHandle;
+    zoom: number;
+    markType: ContractTemplateSigningMarkType;
+    sealType?: string;
+}
+export declare function normalizeSigningMarkDimension(value: unknown): number | undefined;
+export declare function isContractTemplateSigningMarkType(value: unknown): value is ContractTemplateSigningMarkType;
+export declare function getSigningMarkDefaultSize(markType: ContractTemplateSigningMarkType, sealType?: string): {
+    width: number;
+    height: number;
+};
+export declare function getSigningMarkDefaultLabel(markType: ContractTemplateSigningMarkType): string;
+export declare function buildSigningMarkAttrs(markType: ContractTemplateSigningMarkType, overrides?: Partial<ContractTemplateSigningMarkAttrs>): ContractTemplateSigningMarkAttrs;
+export declare function resolveSigningMarkSealAspectRatio(sealType?: string): number;
+/** 签署标记在文档与打印中的外观；数值走内联 CSS 变量，样式表只负责结构。 */
+export declare function resolveSigningMarkPresentation(input: Partial<ContractTemplateSigningMarkAttrs>): SigningMarkPresentation;
+export declare function resolveSigningMarkResizeHandles(markType: ContractTemplateSigningMarkType): SigningMarkResizeHandle[];
+/** 把指针视口位移换算成页面像素尺寸；印章类型锁定章型宽高比。 */
+export declare function resolveSigningMarkResizeDimensions(input: SigningMarkResizeInput): {
+    width: number;
+    height: number;
+};

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

@@ -1,12 +1,12 @@
 import { Component } from 'vue';
-import { ContractTemplateFieldType, ContractTemplateSigningPlacementType } from '../types';
+import { ContractTemplateFieldType, ContractTemplateSigningMarkType } from '../types';
 /**
  * 设计器工具面板与填写渲染器共用类型 icon，避免两处映射漂移。
  * 本版 icons-vue 无 StampOutlined，印章用 SafetyCertificateOutlined。
  */
 export declare const FIELD_TYPE_ICONS: Record<ContractTemplateFieldType, Component>;
-export declare const SIGNING_PLACEMENT_TYPE_ICONS: Record<ContractTemplateSigningPlacementType, Component>;
+export declare const SIGNING_MARK_TYPE_ICONS: Record<ContractTemplateSigningMarkType, Component>;
 /** 未知或缺省正文类型回退为 text，与填写渲染器缺省规则一致。 */
 export declare function resolveFieldTypeIcon(type: unknown): Component;
-/** 签署位置工具项 icon；类型由签署工具列表保证，不做正文变量那种子集回退。 */
-export declare function resolveSigningPlacementTypeIcon(type: ContractTemplateSigningPlacementType): Component;
+/** 签署标记工具项 icon。 */
+export declare function resolveSigningMarkTypeIcon(type: ContractTemplateSigningMarkType): Component;

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

@@ -1,4 +1,4 @@
-export declare const CONTRACT_TEMPLATE_TOOLBAR_OVERFLOW_PRIORITY: readonly ["table", "cleanup", "list", "font-family", "alignment", "font-appearance", "insert"];
+export declare const CONTRACT_TEMPLATE_TOOLBAR_OVERFLOW_PRIORITY: readonly ["table", "cleanup", "list", "font-family", "alignment", "font-appearance", "signing", "insert"];
 export type ContractTemplateToolbarOverflowKey = typeof CONTRACT_TEMPLATE_TOOLBAR_OVERFLOW_PRIORITY[number];
 export interface ContractTemplateToolbarOverflowOptions {
     availableWidth: number;
@@ -7,5 +7,5 @@ export interface ContractTemplateToolbarOverflowOptions {
     moreWidth: number;
     buffer?: number;
 }
-/** 按使用频率渐进收纳工具组；插入组只作为窄中栏下的最后兜底。 */
+/** 按使用频率渐进收纳工具组；签署组与插入组只作为窄中栏下的最后兜底。 */
 export declare function resolveContractTemplateToolbarOverflowKeys(options: ContractTemplateToolbarOverflowOptions): ContractTemplateToolbarOverflowKey[];