@guodun/antdv 1.5.2 → 1.6.0

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

@@ -0,0 +1,19 @@
+import { ContractTemplateSigningLayoutPreset } from './types';
+type __VLS_Props = {
+    presets: ContractTemplateSigningLayoutPreset[];
+    disabled?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    select: (preset: ContractTemplateSigningLayoutPreset) => any;
+    close: () => any;
+    custom: () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((preset: ContractTemplateSigningLayoutPreset) => any) | undefined;
+    onClose?: (() => any) | undefined;
+    onCustom?: (() => any) | undefined;
+}>, {
+    disabled: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    listElement: HTMLDivElement;
+}, HTMLDivElement>;
+export default _default;

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

@@ -1,7 +1,6 @@
-import { ContractTemplatePageSize, ContractTemplateSigningPlacement } from './types';
+import { ContractTemplateSigningLayoutPreviewModel } from './utils/signing-layout-presets';
 type __VLS_Props = {
-    pageSize: ContractTemplatePageSize;
-    placements: ContractTemplateSigningPlacement[];
+    model: ContractTemplateSigningLayoutPreviewModel;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
 export default _default;

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

@@ -5,18 +5,15 @@ export interface SetActiveFileIdOptions {
     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

@@ -1,5 +1,5 @@
 import { ComputedRef, Ref } from 'vue';
-import { ContractTemplateData, ContractTemplateDraftCacheStatus, ContractTemplateFile, ContractTemplatePageSize, ContractTemplateValidationError } from '../types';
+import { ContractTemplateData, ContractTemplateDraftCacheStatus, ContractTemplateFile, ContractTemplatePageSize } from '../types';
 import { SetActiveFileIdOptions } from './use-designer-files';
 /**
  * 草稿缓存会话：定时写入、空白才恢复、卸载时停表。
@@ -22,10 +22,6 @@ export declare function useDraftCacheSession(options: {
     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>;

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

@@ -0,0 +1,13 @@
+import { Editor } from '@tiptap/core';
+import { ContractTextMatch, ContractTextSearch } from '../utils/authoring-search';
+/** 页面层持有编辑器位置与事务；父级只编排跨页结果，不读取或改写 DOM 正文。 */
+export declare function usePageAuthoring(options: {
+    editor: () => Editor | undefined;
+    readonly: () => boolean;
+    search: () => ContractTextSearch;
+}): {
+    findText: (query: string, matchCase: boolean) => ContractTextMatch[];
+    revealSearchMatch: (match: ContractTextMatch) => boolean;
+    replaceSearchMatches: (search: Pick<ContractTextSearch, "query" | "matchCase">, replacement: string, matches: readonly ContractTextMatch[]) => number;
+    focusHeading: (headingIndex: number) => boolean;
+};

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

@@ -0,0 +1,44 @@
+import { ContractTemplateClauseSnippetKey, ContractTemplateEditorCommand, ContractTemplatePage } from '../types';
+import { ContractTextMatch, ContractTextSearch } from '../utils/authoring-search';
+export type ContractAuthoringPanel = 'find' | 'replace' | 'snippets' | 'help';
+export interface ContractAuthoringPage {
+    findText: (query: string, matchCase: boolean) => ContractTextMatch[];
+    revealSearchMatch: (match: ContractTextMatch) => boolean;
+    replaceSearchMatches: (search: Pick<ContractTextSearch, 'query' | 'matchCase'>, replacement: string, matches: readonly ContractTextMatch[]) => number;
+}
+interface PageTextMatch extends ContractTextMatch {
+    pageId: string;
+    pageIndex: number;
+}
+/** 实例级编写会话：仅跨页聚合与分发，正文写入仍经 DesignerPage 的 Tiptap 事务回流。 */
+export declare function useTemplateAuthoring(options: {
+    pages: () => ContractTemplatePage[];
+    fileId: () => string;
+    readonly: () => boolean;
+    root: () => HTMLElement | undefined;
+    pageRefs: Map<string, ContractAuthoringPage>;
+    activatePage: (pageId: string, scroll: boolean) => void;
+    beforeOpen: () => void;
+    focusPanel: () => void;
+    focusTrigger: (panel: ContractAuthoringPanel) => void;
+    command: (command: ContractTemplateEditorCommand) => void;
+}): {
+    panel: import('vue').ShallowRef<ContractAuthoringPanel | undefined, ContractAuthoringPanel | undefined>;
+    query: import('vue').ShallowRef<string, string>;
+    replacement: import('vue').ShallowRef<string, string>;
+    matchCase: import('vue').ShallowRef<boolean, boolean>;
+    matches: import('vue').ComputedRef<PageTextMatch[]>;
+    currentIndex: import('vue').ShallowRef<number, number>;
+    currentMatch: import('vue').ComputedRef<PageTextMatch>;
+    feedback: import('vue').ShallowRef<string, string>;
+    highlightQuery: import('vue').ComputedRef<string>;
+    searchOpen: import('vue').ComputedRef<boolean>;
+    open: (nextPanel: ContractAuthoringPanel) => Promise<void>;
+    close: (restoreFocus?: boolean) => void;
+    navigate: (direction: -1 | 1) => void;
+    replaceCurrent: () => Promise<void>;
+    replaceAll: () => Promise<void>;
+    insertSnippet: (snippet: ContractTemplateClauseSnippetKey) => void;
+    handleKeydown: (event: KeyboardEvent) => void;
+};
+export {};

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" | "insert" | "cleanup" | "typography")[], ("table" | "insert" | "cleanup" | "typography")[]>;
+    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/editor-extensions.d.ts

@@ -2,6 +2,8 @@ import { AnyExtension, Editor } from '@tiptap/core';
 import { ContractTemplateEditorCommand } from '../types';
 export interface ContractTemplateEditorExtensionOptions {
     processImageFile?: (file: File) => Promise<string | null>;
+    /** 外部 HTML 含不一致字体时的确认回调；返回 false 将取消本次粘贴。 */
+    confirmExternalFontPaste?: (families: string[]) => boolean | Promise<boolean>;
     getZoom?: () => number;
 }
 /** 组装合同正文编辑器的扩展列表；顺序影响 Tiptap 的解析优先级，勿随意调整。 */

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/extensions/word-paste.d.ts

@@ -15,6 +15,7 @@ interface PendingPastePayload {
     source: ClipboardHtmlSource;
     recoveredRtfImages: number;
     trustedInternal: boolean;
+    replacedFontFamilies: string[];
 }
 interface WordPasteStorage {
     pending?: PendingPastePayload;
@@ -22,6 +23,7 @@ interface WordPasteStorage {
 }
 interface WordPasteOptions {
     processImageFile?: (file: File) => Promise<string | null>;
+    confirmExternalFontPaste?: (families: string[]) => boolean | Promise<boolean>;
 }
 /**
  * Office 粘贴扩展优先恢复/清洗 HTML，但保留 ProseMirror 默认事务与 table paste。

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/clipboard.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 写入纯文本剪贴板。
+ *
+ * Clipboard API 在非安全上下文、权限未授予或部分 WebView 中不可用；
+ * 退回隐藏 textarea + `execCommand('copy')` 可覆盖 macOS/Windows 的旧浏览器。
+ */
+export declare function writeContractClipboardText(text: string): Promise<void>;