@guodun/antdv 1.4.8 → 1.5.1

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

@@ -9,6 +9,7 @@ export * from './src/utils/template-renderer';
 export * from './src/utils/signing-placement';
 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 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/ContractPrintIframe.vue.d.ts

@@ -0,0 +1,35 @@
+import { ContractPrintFrameInteraction, ContractPrintFrameMetrics, ContractPrintFrameStatus } from './utils/contract-print-document';
+type __VLS_Props = {
+    pageId: string;
+    pageFormat?: string;
+    width: number;
+    height: number;
+    paddingTop: number;
+    paddingBottom: number;
+    classNames: string;
+    decorationsHtml: string;
+    contentHtml: string;
+    /** 兼容旧宿主传入；系统字体路径不再消费该值，也不参与 srcdoc 重载。 */
+    fontBaseUrl?: string;
+    activeKey?: string;
+    scrollRequest?: number;
+    title?: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    status: (status: ContractPrintFrameStatus, detail?: string | undefined) => any;
+    metrics: (metrics: ContractPrintFrameMetrics) => any;
+    interaction: (interaction: ContractPrintFrameInteraction) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onStatus?: ((status: ContractPrintFrameStatus, detail?: string | undefined) => any) | undefined;
+    onMetrics?: ((metrics: ContractPrintFrameMetrics) => any) | undefined;
+    onInteraction?: ((interaction: ContractPrintFrameInteraction) => any) | undefined;
+}>, {
+    title: string;
+    activeKey: string;
+    pageFormat: string;
+    fontBaseUrl: string;
+    scrollRequest: number;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    iframe: HTMLIFrameElement;
+}, HTMLIFrameElement>;
+export default _default;

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

@@ -42,8 +42,8 @@ type __VLS_PublicProps = {
     'toolbarMoreOpen'?: boolean;
 } & __VLS_Props;
 declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    "insert-table": (rows: number, cols: number) => any;
     command: (command: ContractTemplateEditorCommand) => any;
+    "insert-table": (rows: number, cols: number) => any;
     "patch-block-format": (value: unknown) => any;
     "patch-font-family": (value: unknown) => any;
     "patch-font-size": (value: unknown) => any;
@@ -68,8 +68,8 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {},
     "update:tableInsertDraft": (value: ContractTemplateTableInsertOptions) => any;
     "update:toolbarMoreOpen": (value: boolean) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
-    "onInsert-table"?: ((rows: number, cols: number) => any) | undefined;
     onCommand?: ((command: ContractTemplateEditorCommand) => any) | undefined;
+    "onInsert-table"?: ((rows: number, cols: number) => any) | undefined;
     "onPatch-block-format"?: ((value: unknown) => any) | undefined;
     "onPatch-font-family"?: ((value: unknown) => any) | undefined;
     "onPatch-font-size"?: ((value: unknown) => any) | undefined;

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

@@ -23,6 +23,7 @@ type __VLS_Props = {
         }>;
     };
     previewSnapshot?: ContractTemplateData;
+    fontBaseUrl?: string;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     cancel: () => any;

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

@@ -8,6 +8,7 @@ type __VLS_Props = {
     pageNumber: number;
     totalPages: number;
     variables: ContractTemplateVariable[];
+    fontBaseUrl?: string;
 };
 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, {}, HTMLElement>;
 export default _default;

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

@@ -1,10 +1,22 @@
 import { ContractTemplateRenderPage } from './utils/template-renderer';
+import { ContractPrintFrameInteraction, ContractPrintFrameMetrics, ContractPrintFrameStatus } from './utils/contract-print-document';
 type __VLS_Props = {
     page: ContractTemplateRenderPage;
     index: number;
     total: number;
     zoom: number;
     showMeta: boolean;
+    fontBaseUrl?: string;
+    activeKey?: string;
+    scrollRequest?: number;
 };
-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, {}, HTMLElement>;
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    status: (status: ContractPrintFrameStatus, detail?: string | undefined) => any;
+    metrics: (metrics: ContractPrintFrameMetrics) => any;
+    interaction: (interaction: ContractPrintFrameInteraction) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onStatus?: ((status: ContractPrintFrameStatus, detail?: string | undefined) => any) | undefined;
+    onMetrics?: ((metrics: ContractPrintFrameMetrics) => any) | undefined;
+    onInteraction?: ((interaction: ContractPrintFrameInteraction) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLElement>;
 export default _default;

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

@@ -166,6 +166,9 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
     "editor-focus": (pageId: string) => any;
     "editor-state-change": (pageId: string, state: ContractTemplateEditorState) => any;
     "editor-context-menu": (payload: ContractTemplateEditorContextMenuPayload) => any;
+    "word-paste": (payload: {
+        replacedFontFamilies: string[];
+    }) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     "onPage-update"?: ((page: ContractTemplatePage) => any) | undefined;
     "onVariable-drop"?: ((pageId: string, type: ContractTemplateFieldType, clientX: number, clientY: number) => any) | undefined;
@@ -178,6 +181,9 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
     "onEditor-focus"?: ((pageId: string) => any) | undefined;
     "onEditor-state-change"?: ((pageId: string, state: ContractTemplateEditorState) => any) | undefined;
     "onEditor-context-menu"?: ((payload: ContractTemplateEditorContextMenuPayload) => any) | undefined;
+    "onWord-paste"?: ((payload: {
+        replacedFontFamilies: string[];
+    }) => any) | undefined;
 }>, {
     disabled: boolean;
     readonly: boolean;

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

@@ -89,6 +89,7 @@ declare const _default: import('vue').DefineComponent<ContractTemplateDesignerPr
     height: string | number;
     readonly: boolean;
     pageSize: ContractTemplatePageSize;
+    contractFontBaseUrl: string;
     showDraftCacheStatus: boolean;
     showClearButton: boolean;
     showSubmitDataViewer: boolean;

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

@@ -52,6 +52,7 @@ declare const __VLS_component: import('vue').DefineComponent<ContractTemplateRen
     zoom: number;
     showToolbar: boolean;
     showSubmitButton: boolean;
+    contractFontBaseUrl: string;
     selectorHttp: undefined;
     selectorUrlPrefix: string;
     showValidateButton: boolean;

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

@@ -2,11 +2,11 @@ import { ContractTemplateEditorCommand, ContractTemplateEditorTextAlign, Contrac
 /**
  * 合同正文默认字体。
  *
- * 按「思源宋体 → 系统宋体 → 通用衬线」的顺序回退，保证 Windows / macOS / Linux
- * 都能落到一款宋体上；合同排版对字形宽度敏感，缺字体时的替换会影响分页结果。
+ * 拉丁由 GD Contract Latin 锁定 Times 盒宽，CJK 走系统宋体栈；
+ * iframe 度量门禁失败时禁止保存签署坐标，不为对齐跨 OS 去补偿 signTop。
  */
-export declare const DEFAULT_CONTRACT_FONT_FAMILY = "Noto Serif SC, Source Han Serif SC, Songti SC, STSong, SimSun, serif";
-/** 字体下拉的内置选项：前四项是合同常用中文字体，后三项兼顾英文合同。 */
+export declare const DEFAULT_CONTRACT_FONT_FAMILY = "\"GD Contract Latin\", \"Songti SC\", SimSun, \"Noto Serif CJK SC\", \"Source Han Serif SC\", serif";
+/** 内置字体只保留合同宋体 / 文档黑体两档；其它字体可由宿主自定义，但不承诺打印一致。 */
 export declare const DEFAULT_FONT_FAMILY_OPTIONS: ContractTemplateFontFamilyOption[];
 /** 字号下拉的预设档位；不在此列表里的字号仍可手动输入，由工具栏临时补进选项。 */
 export declare const DEFAULT_FONT_SIZE_PRESETS: number[];

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

@@ -1,5 +1,12 @@
 import { Extension } from '@tiptap/core';
 import { ClipboardHtmlSource } from '../utils/word-paste';
+declare module '@tiptap/core' {
+    interface EditorEvents {
+        'contract-word-paste': {
+            replacedFontFamilies: string[];
+        };
+    }
+}
 interface PendingPastePayload {
     html: string;
     plainText: string;
@@ -11,6 +18,7 @@ interface PendingPastePayload {
 }
 interface WordPasteStorage {
     pending?: PendingPastePayload;
+    lastReplacedFontFamilies: string[];
 }
 interface WordPasteOptions {
     processImageFile?: (file: File) => Promise<string | null>;

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

@@ -561,6 +561,11 @@ export interface ContractTemplateRendererProps {
     /** 透传给内置用户/部门/角色选择器的宿主请求实例。 */
     selectorHttp?: unknown;
     selectorUrlPrefix?: string;
+    /**
+     * 可选合同打印字体目录 URL。优先于 `configureContractPrintFonts()`。
+     * 系统字体路径不再依赖它；未配置不会阻断。
+     */
+    contractFontBaseUrl?: string;
 }
 export interface ContractTemplateRendererEmits {
     /** 填写值变化时同步 v-model:values */
@@ -701,6 +706,11 @@ export interface ContractTemplateDesignerProps {
      * @default 'append'
      */
     fontFamilyMode?: ContractTemplateFontFamilyMode;
+    /**
+     * 可选合同打印字体目录 URL。优先于 `configureContractPrintFonts()`。
+     * 系统字体路径不再依赖它；未配置不会阻断。
+     */
+    contractFontBaseUrl?: string;
     /**
      * 是否展示内置提交数据查看入口；关闭后仍可通过 expose 方法打开
      * @default true

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

@@ -0,0 +1,119 @@
+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，让内层度量错误先到达，而不是只报初始化超时。 */
+export declare const CONTRACT_PRINT_FRAME_TIMEOUT_MS: number;
+type FrameMessageHandler = (event: MessageEvent) => void;
+export declare function subscribeContractPrintFrameMessages(handler: FrameMessageHandler): void;
+export declare function unsubscribeContractPrintFrameMessages(handler: FrameMessageHandler): void;
+export declare const CONTRACT_PRINT_METRICS_HANZI = "\u5408\u540C\u7B7E\u7F72\u4F4D\u7F6E\u7532\u4E59\u53CC\u65B9";
+export declare const CONTRACT_PRINT_METRICS_PUNCT = "\uFF1A\uFF0C\uFF08\uFF09\u3002\uFF1B";
+export declare const CONTRACT_PRINT_METRICS_DIGIT = "20260831";
+/** 16px 宋体汉字与 `text-spacing-trim: space-all` 下的中文标点都是 1em。 */
+export declare const CONTRACT_PRINT_METRICS_HANZI_ADVANCE = 16;
+export declare const CONTRACT_PRINT_METRICS_PUNCT_ADVANCE = 16;
+/** Times / GD Contract Latin 数字半角宽为 0.5em。 */
+export declare const CONTRACT_PRINT_METRICS_DIGIT_ADVANCE = 8;
+/**
+ * 混排样本与变量行高由本机 Chromium 探针钉死（macOS 2026-08-31）。
+ * 汉字/标点按 1em、数字按 Times 0.5em 另做门禁；字形允许 Songti SC / SimSun 差异。
+ * 行高探针挂在 body 上，吃的是显式 16px/28px，不是变量节点 32px min-height。
+ * Windows 未测，禁止用这组 macOS 数字代称 Windows 结果。
+ */
+export declare const CONTRACT_PRINT_METRICS_BASELINE: {
+    readonly textWidth: 379.546875;
+    readonly sansTextWidth: 393;
+    readonly variableRowHeight: 28;
+};
+export type ContractPrintFrameStatus = 'loading' | 'ready' | 'error';
+export interface ContractPrintFrameMetrics {
+    pageWidth: number;
+    pageHeight: number;
+    contentHeight: number;
+    overflowHeight: number;
+    paddingTop: number;
+    paddingBottom: number;
+    paddingLeft: number;
+    paddingRight: number;
+    fontSize: number;
+    lineHeight: number;
+    fontFamily: string;
+    textWidth: number;
+    sansTextWidth: number;
+    variableRowHeight: number;
+    probeOffsets: Record<string, number>;
+    blocks: Array<{
+        text: string;
+        top: number;
+        lineCount: number;
+    }>;
+}
+export interface ContractPrintFrameMessage {
+    namespace: typeof CONTRACT_PRINT_MESSAGE_NAMESPACE;
+    messageId: string;
+    type: 'ready' | 'metrics' | 'error' | 'interaction';
+    metrics?: ContractPrintFrameMetrics;
+    error?: string;
+    interaction?: ContractPrintFrameInteraction;
+}
+export type ContractPrintFrameInteraction = {
+    kind: 'select';
+    key: string;
+    pageId: string;
+} | {
+    kind: 'input';
+    key: string;
+    pageId: string;
+    value: string | number | boolean | undefined;
+};
+export interface ContractPrintFrameCommand {
+    namespace: typeof CONTRACT_PRINT_MESSAGE_NAMESPACE;
+    messageId: string;
+    type: 'command';
+    command: {
+        kind: 'highlight';
+        key: string;
+        scroll: boolean;
+    };
+}
+export interface BuildContractPrintDocumentOptions {
+    messageId: string;
+    parentOrigin: string;
+    pageId: string;
+    pageFormat?: string;
+    width: number;
+    height: number;
+    paddingTop: number;
+    paddingBottom: number;
+    classNames: string;
+    decorationsHtml: string;
+    contentHtml: string;
+}
+/**
+ * 公共错误文案别名，标识符保留给旧宿主 import，不得改名。
+ * 系统字体路径不再因未配置字体目录而抛出；仅度量门禁失败时阻断签署坐标。
+ * 文案不能再写成「必须配置字体目录」。
+ */
+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";
+export interface ConfigureContractPrintFontsOptions {
+    /** 可选字体目录 URL，仅兼容旧宿主；系统字体路径不再依赖它。 */
+    baseUrl: string;
+}
+/**
+ * 可选配置合同打印 iframe 的字体目录。
+ *
+ * 解析顺序：组件 `contractFontBaseUrl` / `fontBaseUrl` > 本函数 > 空字符串。
+ * 未配置不再阻断，改由页盒度量门禁（汉字/标点 1em、数字 0.5em）校验排版盒。
+ */
+export declare function configureContractPrintFonts(options: ConfigureContractPrintFontsOptions): void;
+export declare function resolveContractFontBaseUrl(explicit?: string): string;
+/** srcdoc 文档 URL 是 about:srcdoc，相对路径必须先落到当前页 origin。 */
+export declare function toAbsoluteContractFontBaseUrl(baseUrl: string, origin?: string): string;
+/**
+ * contentHtml 在进入这里前必须由现有模板净化器清洗；这里只负责安全组合 srcdoc，
+ * 不把正文拼进脚本，也不允许正文覆盖 canonical style。
+ */
+export declare function buildContractPrintDocument(options: BuildContractPrintDocumentOptions): string;
+export declare function isContractPrintFrameMessage(value: unknown): value is ContractPrintFrameMessage;
+export {};

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

@@ -13,6 +13,8 @@ export interface WordPasteResult {
     converted: boolean;
     fallback: boolean;
     recoveredImageCount: number;
+    /** 被收敛为合同标准字体的原始字体名，已去重；内部粘贴为空。 */
+    replacedFontFamilies: string[];
 }
 export interface OfficeListMetadata {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guodun/antdv",
-  "version": "1.4.8",
+  "version": "1.5.1",
   "type": "module",
   "files": [
     "CHANGELOG.md",
@@ -82,8 +82,9 @@
     "scroll-into-view-if-needed": "2.2.31",
     "vue-types": "3.0.2",
     "vue": "^3.5.18",
-    "@guodun/contract-template-agent": "^0.1.0",
-    "@guodun/utils": "^1.0.0"
+    "@guodun/contract-print-css": "^0.1.1",
+    "@guodun/utils": "^1.0.0",
+    "@guodun/contract-template-agent": "^0.1.0"
   },
   "scripts": {
     "build": "rm -rf dist/types && vite build && vite build --config vite.theme.config.ts",