@guodun/antdv 1.7.12 → 1.7.14

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

@@ -11,6 +11,7 @@ export * from './src/utils/signing-layout-presets';
 export * from './src/utils/content-image';
 export * from './src/utils/advanced-controls';
 export { configureContractPrintFonts, resolveContractFontBaseUrl, toAbsoluteContractFontBaseUrl, CONTRACT_PRINT_FONT_UNCONFIGURED_MESSAGE, } from './src/utils/contract-print-document';
+export { checkContractTemplateLayout, createContractTemplateLayoutChecker, describeContractTemplateLayoutIssue, isContractTemplateLayoutAbortError, type ContractTemplateLayoutCheckOptions, type ContractTemplateLayoutChecker, type ContractTemplateLayoutCheckerOptions, type ContractTemplateLayoutTarget, } from './src/utils/contract-layout-check';
 export declare const GdAntProContractTemplateDesigner: SFCWithInstall<typeof ProContractTemplateDesigner>;
 export declare const GdAntProContractTemplateRenderer: SFCWithInstall<typeof ProContractTemplateRenderer>;
 export default GdAntProContractTemplateDesigner;

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

@@ -1,5 +1,6 @@
 import { VNode } from 'vue';
 import { ContractTemplateRenderValues, ContractTemplateRendererFieldSlotProps, ContractTemplateRendererProps, ContractTemplateValidationError, ContractTemplateControlWarning } from './types';
+import { ContractPrintFrameMetrics } from './utils/contract-print-document';
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: Readonly<{
@@ -33,6 +34,7 @@ declare const __VLS_component: import('vue').DefineComponent<ContractTemplateRen
     resetValues: () => ContractTemplateRenderValues;
     showValidation: (errors: ContractTemplateValidationError[]) => void;
     focusError: (error: ContractTemplateValidationError) => void;
+    getMountedLayoutMetrics: (key: string) => ContractPrintFrameMetrics | undefined;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     validate: (errors: ContractTemplateValidationError[]) => any;
     change: (value: ContractTemplateRenderValues) => any;

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

@@ -1,5 +1,5 @@
 import { nextTick } from 'vue';
-import { ContractTemplateContentImage, ContractTemplateData, ContractTemplateFile, ContractTemplateFilesExportResult, ContractTemplateDesignerProps, ContractTemplateDraftCacheStatus, ContractTemplateEditorCommand, ContractTemplateEditorState, ContractTemplateEditorTextAlign, ContractTemplateFieldStyle, ContractTemplateFieldType, ContractTemplatePageDecorations, ContractTemplatePageSize, ContractTemplateTableCommandCapabilities, ContractTemplateValidationError, ContractTemplateVariable, ContractTemplateVariableData } from './types';
+import { ContractTemplateContentImage, ContractTemplateData, ContractTemplateFile, ContractTemplateFilesExportResult, ContractTemplateLayoutIssue, ContractTemplateDesignerProps, ContractTemplateDraftCacheStatus, ContractTemplateEditorCommand, ContractTemplateEditorState, ContractTemplateEditorTextAlign, ContractTemplateFieldStyle, ContractTemplateFieldType, ContractTemplatePageDecorations, ContractTemplatePageSize, ContractTemplateTableCommandCapabilities, ContractTemplateValidationError, ContractTemplateVariable, ContractTemplateVariableData } from './types';
 import { ContractTemplateImageSource } from './utils/content-image';
 declare const _default: import('vue').DefineComponent<ContractTemplateDesignerProps, {
     getValue: () => ContractTemplateData;
@@ -13,6 +13,7 @@ declare const _default: import('vue').DefineComponent<ContractTemplateDesignerPr
     moveFile: (fileId: string, direction: -1 | 1) => ContractTemplateFile | undefined;
     validate: () => ContractTemplateValidationError[];
     exportTemplate: () => import('./types').ContractTemplateExportResult;
+    checkLayout: () => Promise<ContractTemplateLayoutIssue[]>;
     exportFiles: () => ContractTemplateFilesExportResult;
     getSubmitData: () => import('./types').ContractTemplateExportResult;
     clearTemplate: () => ContractTemplateData;
@@ -53,6 +54,7 @@ declare const _default: import('vue').DefineComponent<ContractTemplateDesignerPr
     "draft-cache-change": (status: ContractTemplateDraftCacheStatus) => any;
     "page-limit": (maxPages: number, source: "add" | "duplicate" | "auto-pagination") => any;
     "image-error": (error: Error, source: ContractTemplateImageSource) => any;
+    "layout-warning": (issues: ContractTemplateLayoutIssue[]) => any;
 }, string, import('vue').PublicProps, Readonly<ContractTemplateDesignerProps> & Readonly<{
     onValidate?: ((errors: ContractTemplateValidationError[]) => any) | undefined;
     "onUpdate:modelValue"?: ((value: ContractTemplateData) => any) | undefined;
@@ -68,6 +70,7 @@ declare const _default: import('vue').DefineComponent<ContractTemplateDesignerPr
     "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;
+    "onLayout-warning"?: ((issues: ContractTemplateLayoutIssue[]) => any) | undefined;
 }>, {
     disabled: boolean;
     modelValue: ContractTemplateData;
@@ -79,6 +82,7 @@ declare const _default: import('vue').DefineComponent<ContractTemplateDesignerPr
     showClearButton: boolean;
     showSubmitDataViewer: boolean;
     showVariableDataViewer: boolean;
+    checkLayoutOnExport: boolean;
     maxPages: number;
     variableTypes: import('./types').ContractTemplateFieldTypeOption[];
     showImageControl: boolean;

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

@@ -88,6 +88,7 @@ declare function __VLS_template(): {
                 resetValues: () => ContractTemplateRenderValues;
                 showValidation: (errors: ContractTemplateValidationError[]) => void;
                 focusError: (error: ContractTemplateValidationError) => void;
+                getMountedLayoutMetrics: (key: string) => import('./utils/contract-print-document').ContractPrintFrameMetrics | undefined;
             }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
                 validate: (errors: ContractTemplateValidationError[]) => any;
                 change: (value: ContractTemplateRenderValues) => any;
@@ -174,7 +175,7 @@ declare function __VLS_template(): {
             "onUpdate:valuesByFile"?: ((value: import('./types').ContractTemplateRenderValuesByFile) => any) | undefined;
             "onUpdate:values"?: ((value: ContractTemplateRenderValues) => any) | undefined;
             "onControl-warning"?: ((warning: import('./types').ContractTemplateControlWarning) => any) | undefined;
-        }>, "validate" | "submit" | "fitWidth" | "scrollToPage" | "setZoom" | "getZoom" | "resetZoom" | "scrollToVariable" | "focusError" | "getValues" | "setValues" | "resetValues" | "showValidation" | ("values" | "disabled" | "title" | "template" | "readonly" | "zoom" | "showToolbar" | "showSubmitButton" | "contractFontBaseUrl" | "selectorHttp" | "selectorUrlPrefix" | "showValidateButton" | "showResetButton" | "interactionMode" | "validateOnSubmit" | "showPageMeta" | "collapsiblePanel" | "controlRegistry" | "optionResolver" | "requester" | "allowedRemoteOrigins" | "remoteRequestTimeoutMs" | "remoteOptionsCacheTtlMs")> & {
+        }>, "validate" | "submit" | "fitWidth" | "scrollToPage" | "setZoom" | "getZoom" | "resetZoom" | "scrollToVariable" | "focusError" | "getValues" | "setValues" | "resetValues" | "showValidation" | "getMountedLayoutMetrics" | ("values" | "disabled" | "title" | "template" | "readonly" | "zoom" | "showToolbar" | "showSubmitButton" | "contractFontBaseUrl" | "selectorHttp" | "selectorUrlPrefix" | "showValidateButton" | "showResetButton" | "interactionMode" | "validateOnSubmit" | "showPageMeta" | "collapsiblePanel" | "controlRegistry" | "optionResolver" | "requester" | "allowedRemoteOrigins" | "remoteRequestTimeoutMs" | "remoteOptionsCacheTtlMs")> & {
             validate: () => ContractTemplateValidationError[];
             submit: () => false | ContractTemplateRenderValues;
             fitWidth: () => number;
@@ -188,6 +189,7 @@ declare function __VLS_template(): {
             resetValues: () => ContractTemplateRenderValues;
             showValidation: (errors: ContractTemplateValidationError[]) => void;
             focusError: (error: ContractTemplateValidationError) => void;
+            getMountedLayoutMetrics: (key: string) => import('./utils/contract-print-document').ContractPrintFrameMetrics | undefined;
         } & {} & import('vue').ComponentCustomProperties & {} & {
             $slots: Readonly<{
                 field?: (props: ContractTemplateRendererFieldSlotProps) => VNode[] | undefined;
@@ -206,6 +208,7 @@ type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<ContractTemplateRendererProps, {
     getAllValues: () => import('./types').ContractTemplateRenderValuesByFile;
     validateAll: () => ContractTemplateValidationError[];
+    validateLayoutAll: () => Promise<ContractTemplateValidationError[]>;
     getValues: () => ContractTemplateRenderValues;
     setValues: (values: ContractTemplateRenderValues) => void;
     validate: () => ContractTemplateValidationError[];
@@ -338,6 +341,7 @@ declare const __VLS_component: import('vue').DefineComponent<ContractTemplateRen
             resetValues: () => ContractTemplateRenderValues;
             showValidation: (errors: ContractTemplateValidationError[]) => void;
             focusError: (error: ContractTemplateValidationError) => void;
+            getMountedLayoutMetrics: (key: string) => import('./utils/contract-print-document').ContractPrintFrameMetrics | undefined;
         }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
             validate: (errors: ContractTemplateValidationError[]) => any;
             change: (value: ContractTemplateRenderValues) => any;
@@ -424,7 +428,7 @@ declare const __VLS_component: import('vue').DefineComponent<ContractTemplateRen
         "onUpdate:valuesByFile"?: ((value: import('./types').ContractTemplateRenderValuesByFile) => any) | undefined;
         "onUpdate:values"?: ((value: ContractTemplateRenderValues) => any) | undefined;
         "onControl-warning"?: ((warning: import('./types').ContractTemplateControlWarning) => any) | undefined;
-    }>, "validate" | "submit" | "fitWidth" | "scrollToPage" | "setZoom" | "getZoom" | "resetZoom" | "scrollToVariable" | "focusError" | "getValues" | "setValues" | "resetValues" | "showValidation" | ("values" | "disabled" | "title" | "template" | "readonly" | "zoom" | "showToolbar" | "showSubmitButton" | "contractFontBaseUrl" | "selectorHttp" | "selectorUrlPrefix" | "showValidateButton" | "showResetButton" | "interactionMode" | "validateOnSubmit" | "showPageMeta" | "collapsiblePanel" | "controlRegistry" | "optionResolver" | "requester" | "allowedRemoteOrigins" | "remoteRequestTimeoutMs" | "remoteOptionsCacheTtlMs")> & {
+    }>, "validate" | "submit" | "fitWidth" | "scrollToPage" | "setZoom" | "getZoom" | "resetZoom" | "scrollToVariable" | "focusError" | "getValues" | "setValues" | "resetValues" | "showValidation" | "getMountedLayoutMetrics" | ("values" | "disabled" | "title" | "template" | "readonly" | "zoom" | "showToolbar" | "showSubmitButton" | "contractFontBaseUrl" | "selectorHttp" | "selectorUrlPrefix" | "showValidateButton" | "showResetButton" | "interactionMode" | "validateOnSubmit" | "showPageMeta" | "collapsiblePanel" | "controlRegistry" | "optionResolver" | "requester" | "allowedRemoteOrigins" | "remoteRequestTimeoutMs" | "remoteOptionsCacheTtlMs")> & {
         validate: () => ContractTemplateValidationError[];
         submit: () => false | ContractTemplateRenderValues;
         fitWidth: () => number;
@@ -438,6 +442,7 @@ declare const __VLS_component: import('vue').DefineComponent<ContractTemplateRen
         resetValues: () => ContractTemplateRenderValues;
         showValidation: (errors: ContractTemplateValidationError[]) => void;
         focusError: (error: ContractTemplateValidationError) => void;
+        getMountedLayoutMetrics: (key: string) => import('./utils/contract-print-document').ContractPrintFrameMetrics | undefined;
     } & {} & import('vue').ComponentCustomProperties & {} & {
         $slots: Readonly<{
             field?: (props: ContractTemplateRendererFieldSlotProps) => VNode[] | undefined;

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

@@ -12,8 +12,8 @@ export declare const DEFAULT_MULTILINE_ROWS = 3;
 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";
+/** 合同渲染 CSS 版本快照，用于服务端 PDF 复现；唯一来源是 contract-print-css。 */
+export declare const CONTRACT_TEMPLATE_STYLE_VERSION = "contract-render-css-1.1.0";
 /** 与 PDF 模板填值服务保持一致，避免设计器允许保存但服务端拒绝的变量标识。 */
 export declare const CONTRACT_TEMPLATE_VARIABLE_KEY_PATTERN: RegExp;
 export declare const CONTRACT_TEMPLATE_RESERVED_VARIABLE_KEYS: Set<string>;

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

@@ -603,6 +603,11 @@ export interface ContractTemplateRendererExpose {
     getAllValues: () => ContractTemplateRenderValuesByFile;
     /** 校验全部文件并切换、定位首个错误；disabled 时只校验、不切换。单文件等价于 validate。 */
     validateAll: () => ContractTemplateValidationError[];
+    /**
+     * 生成前的排版预检：覆盖全部文件的全部页（含未挂载的页），检测正文纵向或横向超出纸张。
+     * 只测量，不切换文件、不改填写值；结果对应调用时的填写值。无法确认排版的页返回 PAGE_LAYOUT_UNVERIFIED，不视为通过。
+     */
+    validateLayoutAll: () => Promise<ContractTemplateValidationError[]>;
     /** 获取当前填写值快照 */
     getValues: () => ContractTemplateRenderValues;
     /** 替换当前填写值 */
@@ -655,6 +660,27 @@ export interface ContractTemplateDraftCacheStatus {
     maxBytes?: number;
     error?: string;
 }
+/**
+ * 按打印样式（统一 CSS）逐页度量得到的排版问题。
+ * 渲染器、指定位置用于阻断生成；设计器保存时只作为提示（checkLayoutOnExport）。
+ */
+export interface ContractTemplateLayoutIssue {
+    /** 多文件模式下的文件 id；单文件留空。 */
+    fileId?: string;
+    /** 模板 pages 数组下标，从 0 开始。 */
+    pageIndex: number;
+    /** 物理页号，从 1 开始。 */
+    pageNumber: number;
+    pageId: string;
+    /** overflow：正文超出纸张；measure-failed：无法确认排版（字体、图片或超时）。 */
+    kind: 'overflow' | 'measure-failed';
+    /** 相对「页高 − 底部安全边距」的纵向溢出量（CSS px）。 */
+    overflowHeight: number;
+    /** 横向超出纸张可用宽度的量（CSS px）。 */
+    overflowWidth: number;
+    /** 度量失败的原因，仅 measure-failed 存在。 */
+    error?: string;
+}
 export interface ContractTemplateDesignerProps {
     /** 合同模板数据，正文占位统一写入 variables */
     modelValue?: ContractTemplateData;
@@ -670,6 +696,12 @@ export interface ContractTemplateDesignerProps {
      * @default false
      */
     readonly?: boolean;
+    /**
+     * 保存/导出（exportTemplate / exportFiles / getSubmitData）后，后台按统一打印样式检查每页正文。
+     * 发现溢出只提示与触发 layout-warning，不阻断保存；生成合同时会被拦截。
+     * @default true
+     */
+    checkLayoutOnExport?: boolean;
     /**
      * 禁用整个设计器
      * @default false
@@ -817,6 +849,8 @@ export interface ContractTemplateDesignerEmits {
     'page-limit': [maxPages: number, source: 'add' | 'duplicate' | 'auto-pagination'];
     /** 本地图片读取、压缩或上传失败 */
     'image-error': [error: Error, source: ContractTemplateImageSource];
+    /** 保存/导出后后台排版预检的结果；仅提示，不阻断保存。 */
+    'layout-warning': [issues: ContractTemplateLayoutIssue[]];
 }
 export interface ContractTemplateDesignerExpose {
     /** 获取当前模板数据快照 */
@@ -841,6 +875,8 @@ export interface ContractTemplateDesignerExpose {
     validate: () => ContractTemplateValidationError[];
     /** 导出 HTML、页面、变量、模板 pageSize 与每页 pageSize */
     exportTemplate: () => ContractTemplateExportResult;
+    /** 按打印样式对全部文件、全部页做排版预检（以默认值测量）；仅返回问题页，不阻断保存。 */
+    checkLayout: () => Promise<ContractTemplateLayoutIssue[]>;
     /** 逐文件导出，同时返回明确标注的连续预览 HTML。 */
     exportFiles: () => ContractTemplateFilesExportResult;
     /** 获取将提交给服务端的模板数据 */

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

@@ -0,0 +1,104 @@
+import { ContractTemplateData, ContractTemplateLayoutIssue, ContractTemplateRenderValues } from '../types';
+import { ContractTemplateRenderPage } from './template-renderer';
+import { ContractPrintFrameMetrics } from './contract-print-document';
+/**
+ * 共享布局预检：用与渲染器、指定位置底图相同的 srcdoc 与打印 CSS，逐页在隐藏 iframe 中测量溢出。
+ *
+ * - 串行执行：所有检查共用一个隐藏 iframe 与一条队列，不一次挂载全部页。
+ * - 缓存键 = 样式版本 + 页尺寸 + 页边距 + 装饰 HTML + 正文 HTML（正文已包含填充值）。输入变化自动落到新键。
+ * - 过期检查通过 AbortSignal 终止：被终止的检查 reject 为 AbortError，绝不返回「通过」。
+ * - 度量失败（超时、图片、环境不可用）记为 measure-failed，同样不被当作通过。
+ * - 只在浏览器中执行；无 document 时每页返回明确的 measure-failed 错误，不抛出异常。
+ */
+export interface ContractTemplateLayoutTarget {
+    /** 多文件模式的文件 id；单文件留空。 */
+    fileId?: string;
+    template: ContractTemplateData;
+    /** 与渲染器展示口径一致的填写值；缺省变量按模板默认值补齐。 */
+    values?: ContractTemplateRenderValues;
+    /**
+     * 宿主已按自身页面口径构建好的页（如指定位置底图的展示尺寸）。提供时直接使用，不再由 template 推导。
+     * 必须由 createContractTemplateLayoutPage 生成，保证缓存键与 iframe 入参一致。
+     */
+    layoutPages?: ContractTemplateLayoutPage[];
+}
+export interface ContractTemplateLayoutPage {
+    fileId?: string;
+    /** 模板 pages 数组下标，从 0 开始。 */
+    pageIndex: number;
+    /** 物理页号，从 1 开始，与页眉页脚 {pageNumber} 口径一致。 */
+    pageNumber: number;
+    pageId: string;
+    pageFormat: string;
+    width: number;
+    height: number;
+    paddingTop: number;
+    paddingBottom: number;
+    classNames: string;
+    decorationsHtml: string;
+    contentHtml: string;
+    /** 测量缓存键；同一键的页在同一样式版本下排版结果相同。 */
+    key: string;
+}
+export type { ContractTemplateLayoutIssue } from '../types';
+export interface ContractTemplateLayoutCheckOptions {
+    /** 调用方取消信号；取消后检查 reject 为 AbortError。 */
+    signal?: AbortSignal;
+    /** 已挂载页的测量结果，按页键查询；命中即跳过隐藏 iframe 测量。 */
+    reuse?: (key: string) => ContractPrintFrameMetrics | undefined;
+    /** 每页测完（无论是否有问题）后回调，用于统计首页结果时间。 */
+    onPage?: (page: ContractTemplateLayoutPage, issue: ContractTemplateLayoutIssue | undefined) => void;
+}
+export type ContractTemplateLayoutMeasurer = (page: ContractTemplateLayoutPage, signal: AbortSignal | undefined) => Promise<ContractPrintFrameMetrics>;
+export interface ContractTemplateLayoutCheckerOptions {
+    /** 替换默认隐藏 iframe 测量器（测试或无浏览器环境使用）。 */
+    measure?: ContractTemplateLayoutMeasurer;
+    /** 缓存条数上限，超出按最近最少使用淘汰。 */
+    cacheLimit?: number;
+}
+export interface ContractTemplateLayoutChecker {
+    check: (targets: ContractTemplateLayoutTarget[], options?: ContractTemplateLayoutCheckOptions) => Promise<ContractTemplateLayoutIssue[]>;
+    /** 清空测量缓存；不影响进行中的检查。 */
+    clear: () => void;
+    /** 终止进行中的检查、清空缓存，并释放隐藏 iframe 的引用。dispose 之后 check 立即 reject。 */
+    dispose: () => void;
+}
+export declare class ContractTemplateLayoutMeasureError extends Error {
+    constructor(message: string);
+}
+/** 构建单页测量输入：与 ContractTemplateRendererPage / ContractSigningTemplatePage 的 iframe 入参完全一致。 */
+export declare function createContractTemplateLayoutPage(rendered: ContractTemplateRenderPage, position: {
+    fileId?: string;
+    pageIndex: number;
+    pageNumber: number;
+    totalPages: number;
+}): ContractTemplateLayoutPage;
+/** 缓存键只包含影响排版的输入；messageId 等每次都变的字段不参与。 */
+export declare function createContractTemplateLayoutKey(input: Pick<ContractTemplateLayoutPage, 'pageFormat' | 'width' | 'height' | 'paddingTop' | 'paddingBottom' | 'classNames' | 'decorationsHtml' | 'contentHtml'>): string;
+/**
+ * 展开模板的全部页（按 pages 数组顺序）。非法页直接跳过：结构错误由结构校验单独报告。
+ * 填写值与渲染器展示口径一致：调用方传入的应是展示值（已做自定义控件展示适配）。
+ */
+export declare function buildContractTemplateLayoutPages(target: ContractTemplateLayoutTarget): ContractTemplateLayoutPage[];
+/**
+ * 替换默认的浏览器测量器。仅用于单元测试和挂载测试（happy-dom 不会执行 srcdoc）；
+ * 传 undefined 恢复隐藏 iframe 测量。生产代码不应调用。
+ */
+export declare function setContractTemplateLayoutMeasurer(measurer: ContractTemplateLayoutMeasurer | undefined): void;
+/** 一次性检查：创建临时检查器、执行并释放。需要复用缓存时请使用 createContractTemplateLayoutChecker。 */
+export declare function checkContractTemplateLayout(targets: ContractTemplateLayoutTarget[], options?: ContractTemplateLayoutCheckOptions & ContractTemplateLayoutCheckerOptions): Promise<ContractTemplateLayoutIssue[]>;
+export declare function createContractTemplateLayoutChecker(options?: ContractTemplateLayoutCheckerOptions): ContractTemplateLayoutChecker;
+/** 调用方可据此区分「已取消」与真正的失败；取消的结果不得展示为通过或失败。 */
+export declare function isContractTemplateLayoutAbortError(error: unknown): boolean;
+/** 默认测量器：在隐藏 iframe 中加载单页 srcdoc，等待 ready/metrics 或 error/超时。 */
+declare function measureInHiddenFrame(page: ContractTemplateLayoutPage, signal: AbortSignal | undefined): Promise<ContractPrintFrameMetrics>;
+/** 仅供 Chromium 端到端测试与诊断直接调用默认测量器；不从设计器 index 导出。 */
+export { measureInHiddenFrame as measureContractPageInHiddenFrame };
+/**
+ * 把一条问题转成可展示文案。一页可能同时溢出纵向与横向，因此返回数组。
+ * - generate：渲染器与指定位置，告诉用户在生成前修改模板；
+ * - design：设计器保存/导出提示，明确说明生成时会被拦截。
+ */
+export declare function describeContractTemplateLayoutIssue(issue: ContractTemplateLayoutIssue, variant?: 'generate' | 'design'): string[];
+/** 度量失败原因的用户文案；原始技术细节只留给控制台。 */
+export declare function describeLayoutMeasureFailure(error: string | undefined): "排版校验超时" | "底图图片未能加载" | "当前环境无法执行排版校验" | "字体或排版度量未通过";

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

@@ -2,7 +2,7 @@ export declare const CONTRACT_PRINT_MESSAGE_NAMESPACE = "gd-contract-print";
 /** 汉字/标点/数字与混排基线共用的容差；超过说明排版盒已分叉，不能靠 signTop 补偿。 */
 export declare const CONTRACT_PRINT_METRICS_TOLERANCE = 0.5;
 export declare const CONTRACT_PRINT_METRICS_SAMPLE = "\u5408\u540C\u7B7E\u7F72\u4F4D\u7F6E\uFF1A\u7532\u65B9\uFF08Company A\uFF09\u7F16\u53F7 2026-08-31\u3002";
-/** 父页超时比 iframe 内 document.fonts.ready 再多 1s，让内层度量错误先到达，而不是只报初始化超时。 */
+/** iframe 内字体与图片共用 CONTRACT_PRINT_FONT_TIMEOUT_MS 截止时间；父侧再多 1s，让内层错误先到达，而不是只报初始化超时。 */
 export declare const CONTRACT_PRINT_FRAME_TIMEOUT_MS: number;
 type FrameMessageHandler = (event: MessageEvent) => void;
 export declare function subscribeContractPrintFrameMessages(handler: FrameMessageHandler): void;
@@ -32,6 +32,7 @@ export interface ContractPrintFrameMetrics {
     pageHeight: number;
     contentHeight: number;
     overflowHeight: number;
+    overflowWidth: number;
     paddingTop: number;
     paddingBottom: number;
     paddingLeft: number;
@@ -96,6 +97,8 @@ export interface BuildContractPrintDocumentOptions {
  * 文案不能再写成「必须配置字体目录」。
  */
 export declare const CONTRACT_PRINT_FONT_UNCONFIGURED_MESSAGE = "\u5408\u540C\u6392\u7248\u5EA6\u91CF\u6821\u9A8C\u5931\u8D25\uFF0C\u7981\u6B62\u751F\u6210\u7B7E\u7F72\u5750\u6807";
+/** 合同底图图片加载失败的稳定标识；iframe 与父页提示共用，禁止两侧各写一份文案。 */
+export declare const CONTRACT_PRINT_IMAGE_ERROR_MESSAGE = "\u5408\u540C\u56FE\u7247\u52A0\u8F7D\u5931\u8D25";
 export interface ConfigureContractPrintFontsOptions {
     /** 可选字体目录 URL，仅兼容旧宿主；系统字体路径不再依赖它。 */
     baseUrl: string;

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

@@ -1,11 +1,6 @@
 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;
+import { CONTRACT_PAGE_BASE_PADDING } from '../../../../contract-print-css';
+export { CONTRACT_PAGE_BASE_PADDING };
 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';
@@ -84,7 +79,6 @@ export declare function getWatermarkDensityGrid(density: ContractTemplateWaterma
     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/signing-layout-presets.d.ts

@@ -1,6 +1,8 @@
 import { JSONContent } from '@tiptap/core';
 import { ContractTemplateSigningLayoutArrangement, ContractTemplateSigningLayoutFields, ContractTemplateSigningLayoutOptions, ContractTemplateSigningLayoutPreset, ContractTemplateSigningLayoutPresetKey } from '../types';
 export declare const DUAL_PARTY_SIGNING_LAYOUT = "dual-party";
+/** 单行多列（并排分栏、表格单元格、末页集中）允许的最多签署方数；再多则单格过窄，盖章框放不下。 */
+export declare const MAX_SIDE_BY_SIDE_SIGNING_LAYOUT_PARTY_COUNT = 3;
 /** 自定义参数生成的签署版式统一落这个标识，避免宿主 key 进入 schema 白名单。 */
 export declare const CUSTOM_SIGNING_LAYOUT = "custom";
 export declare const MIN_SIGNING_LAYOUT_PARTY_COUNT = 1;
@@ -19,6 +21,13 @@ export declare function isSigningLayoutPresetKey(value: unknown): value is Contr
 export declare function isSigningLayoutAttributeValue(value: unknown): value is string;
 /** 收敛外部入参：夹取签署方数量、校验排列方式、保证至少留一个签署占位。 */
 export declare function normalizeSigningLayoutOptions(options: Partial<ContractTemplateSigningLayoutOptions> | undefined): ContractTemplateSigningLayoutOptions;
+/** 单行多列排列（并排分栏、表格单元格、末页集中）：true；逐行列出为整行宽，不受栏宽约束。 */
+export declare function isSingleRowSigningLayoutArrangement(arrangement: ContractTemplateSigningLayoutArrangement): boolean;
+/**
+ * 单行多列时签字线按栏宽收缩，使每格内容不超出 A4 正文宽度；上限仍为默认 80mm。
+ * 盖章框代表实际印章尺寸，不在此缩小。
+ */
+export declare function resolveSingleRowSignatureLineWidth(partyCount: number): number;
 /**
  * 参数化生成正文流签署版式；内置预设与自定义面板共用这一个 builder。
  *

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

@@ -1,4 +1,4 @@
-import { ContractTemplateData, ContractTemplatePageFormat, ContractTemplatePageDecorations, ContractTemplateRenderValue, ContractTemplateRenderValues, ContractTemplateValidationError, ContractTemplateVariable, ContractTemplateControlOption, ContractTemplateVariableData } from '../types';
+import { ContractTemplateControlRegistry, ContractTemplateData, ContractTemplatePageFormat, ContractTemplatePageDecorations, ContractTemplateRenderValue, ContractTemplateRenderValues, ContractTemplateValidationError, ContractTemplateVariable, ContractTemplateControlOption, ContractTemplateVariableData } from '../types';
 import { isSafeContractImageUrl } from './image-url';
 export { isSafeContractImageUrl };
 /**
@@ -31,6 +31,11 @@ export interface ContractTemplateRenderPage {
 export declare function buildInitialRenderValues(template: ContractTemplateData | undefined): ContractTemplateRenderValues;
 /** 合并模板初始值与外部传入值，外部值优先。 */
 export declare function normalizeRenderValues(template: ContractTemplateData | undefined, values: ContractTemplateRenderValues | undefined): ContractTemplateRenderValues;
+/**
+ * 面板与只读展示使用的填写值：先对自定义控件的 `toDisplayText` 做展示适配，适配失败保留标准值。
+ * 渲染器画页与合同布局预检必须共用这一步，否则预检测到的正文与用户看到的不一致。
+ */
+export declare function resolveTemplateDisplayValues(template: ContractTemplateData | undefined, values: ContractTemplateRenderValues, controlRegistry?: ContractTemplateControlRegistry): ContractTemplateRenderValues;
 /** 模板结构校验 + 按 PDF 服务规则逐项校验填写值。 */
 export declare function validateTemplateRenderValues(template: ContractTemplateData | undefined, values: ContractTemplateRenderValues): ContractTemplateValidationError[];
 /** 当前文本字段的容量校验；与全量/提交共用 PDF 估算，不能用 DOM 边框或滚动高度判溢出。 */

package/dist/types/contract-print-css/index.d.ts

@@ -1,3 +1,73 @@
+/**
+ * 合同打印公共模块（无 Vue / DOM 模块依赖，浏览器与 Node 共用）：排版几何、正文安全区、
+ * 版面度量函数与打印 CSS。不得在此新增 import，否则原生 Node 无法直接加载测试与 dist 产物。
+ */
+/** 合同排版共用几何：单位为 CSS px，签署坐标仍由既有 72/96 换算负责。 */
+export declare const CONTRACT_PAGE_BASE_PADDING: {
+    readonly top: 54;
+    readonly right: 64;
+    readonly bottom: 54;
+    readonly left: 64;
+};
+/** 有效页眉/页脚占用的最小安全区；实际值还要与 offset + 字高 + 间距取最大。 */
+export declare const CONTRACT_PAGE_DECORATED_SAFE_PADDING = 80;
+export declare const CONTRACT_PAGE_LAYOUT_TOLERANCE = 1;
+export declare const CONTRACT_PRINT_STYLE_VERSION = "contract-render-css-1.1.0";
+export type ContractPageDecorationSlotKey = 'left' | 'center' | 'right';
+/**
+ * 页眉或页脚的最小输入。宿主必须先经设计器 normalizePageDecorations 归一化：
+ * offset / fontSize 已夹紧到合法区间，slots 已补齐三栏。
+ */
+export interface ContractPageDecorationSafeAreaSide {
+    enabled: boolean;
+    showOnFirstPage: boolean;
+    slots: Record<ContractPageDecorationSlotKey, string>;
+    offset: number;
+    fontSize: number;
+}
+export interface ContractPageDecorationSafeAreaSource {
+    header?: ContractPageDecorationSafeAreaSide;
+    footer?: ContractPageDecorationSafeAreaSide;
+}
+export interface ContractPagePadding {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+export interface ContractPageLayoutOptions {
+    width: number;
+    height: number;
+    contentSelector?: string;
+}
+export interface ContractPageLayoutMetrics {
+    pageWidth: number;
+    pageHeight: number;
+    contentHeight: number;
+    overflowHeight: number;
+    overflowWidth: number;
+    paddingTop: number;
+    paddingBottom: number;
+    paddingLeft: number;
+    paddingRight: number;
+}
+/** 页眉或页脚在指定物理页是否真实显示：启用、任一栏有文本，且首页受 showOnFirstPage 约束。 */
+export declare function isContractPageDecorationVisible(side: ContractPageDecorationSafeAreaSide | undefined, pageNumber?: number): boolean;
+/** 单侧装饰占用的安全区高度：offset + 1.5 倍字号（向上取整）+ 20px 间距，且不小于 80px。 */
+export declare function resolveContractDecorationSafePadding(side: Pick<ContractPageDecorationSafeAreaSide, 'offset' | 'fontSize'>): number;
+/**
+ * 正文四边内边距的唯一算法（纯函数，无 Vue/DOM 依赖）。
+ *
+ * 有效页眉时上边改为安全区，有效页脚时下边改为安全区；安全区与基础内边距取较大者。
+ * 浏览器 iframe、设计器与渲染器预览都必须调用这里；Node 渲染服务的同类逻辑须与此保持一致。
+ */
+export declare function resolveContractPagePadding(decorations?: ContractPageDecorationSafeAreaSource, pageNumber?: number): ContractPagePadding;
+/**
+ * 同时用于浏览器 iframe 和 Node 的 page.evaluate（Locator.evaluate(measureContractPageLayout, options)）。
+ * 函数必须自包含，不捕获模块变量，以便作为打印文档脚本序列化。
+ * 只测正文和实际文本行，不把水印/页眉页脚算成溢出，也不展开固定容量控件内部文本。
+ */
+export declare function measureContractPageLayout(page: HTMLElement, options: ContractPageLayoutOptions): ContractPageLayoutMetrics;
 export declare const CONTRACT_RENDER_STYLE_MARKER = "data-contract-render-style=\"true\"";
 /** 拉丁走 local Times/Arial 锁定盒宽；CJK 走系统宋体/黑体栈。不要用 @font-face local() 绑 CJK，Chromium 会匹配失败。 */
 export declare const CONTRACT_PRINT_FONT_FAMILY = "\"GD Contract Latin\", \"Songti SC\", SimSun, \"Noto Serif CJK SC\", \"Source Han Serif SC\", serif";

package/dist/types/contract-print.d.ts

@@ -0,0 +1,2 @@
+/** 无 Vue/组件依赖的合同打印工具公共子入口，浏览器与 Node 共用。 */
+export * from './contract-print-css';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guodun/antdv",
-  "version": "1.7.12",
+  "version": "1.7.14",
   "type": "module",
   "files": [
     "CHANGELOG.md",
@@ -23,11 +23,23 @@
       "require": "./dist/lib/index.cjs"
     },
     "./src/*": "./src/*.js",
-    "./*": "./*"
+    "./*": "./*",
+    "./contract-print": {
+      "types": "./dist/types/contract-print.d.ts",
+      "import": "./dist/es/contract-print.mjs",
+      "require": "./dist/lib/contract-print.cjs"
+    }
   },
   "main": "./dist/lib/index.cjs",
   "module": "./dist/es/index.mjs",
   "types": "./dist/types/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "contract-print": [
+        "./dist/types/contract-print.d.ts"
+      ]
+    }
+  },
   "sideEffects": [
     "**/*.css",
     "**/*.scss",