@guodun/antdv 1.4.1 → 1.4.2

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guodun/antdv",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "type": "module",
   "files": [
     "CHANGELOG.md",