@guodun/antdv 1.3.2 → 1.4.0

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

@@ -119,6 +119,12 @@ export interface ContractTemplateData {
     /** 旧模板可缺省；归一化后的模板始终带空数组。 */
     signingPlacements?: ContractTemplateSigningPlacement[];
 }
+/** 多文件设计器中的一份独立合同文件；正文、变量和签署位置均在文件内隔离。 */
+export interface ContractTemplateFile {
+    id: string;
+    name: string;
+    template: ContractTemplateData;
+}
 export interface ContractTemplateFieldTypeOption {
     type: ContractTemplateFieldType;
     label: string;
@@ -293,6 +299,8 @@ export interface ContractTemplateValidationError {
     type: 'field' | 'variable' | 'page' | 'security' | 'signing-placement';
     id: string;
     message: string;
+    /** 多文件校验时标识错误所属文件；旧单文件模式缺省。 */
+    fileId?: string;
     /** 服务端错误码，透传给宿主应用做精细化提示 */
     code?: string;
     /** 服务端返回的变量 key，用于定位正文变量 */
@@ -422,6 +430,19 @@ export interface ContractTemplateExportResult extends ContractTemplateData {
     styleVersion: string;
     html: string;
 }
+/** 多文件导出保持文件边界，避免把合并 HTML 误当成可回填的单文件模板。 */
+export interface ContractTemplateFileExportResult {
+    id: string;
+    name: string;
+    template: ContractTemplateExportResult;
+    /** 当前文件独立导出 HTML，方便宿主无需再解构 template。 */
+    html: string;
+}
+export interface ContractTemplateFilesExportResult {
+    files: ContractTemplateFileExportResult[];
+    /** 仅供连续预览/打印的辅助 HTML；正式持久化仍应使用 files。 */
+    combinedHtml: string;
+}
 export type ContractTemplateDraftCacheStatusType = 'idle' | 'saved' | 'unchanged' | 'restored' | 'cleared' | 'too-large' | 'unavailable' | 'invalid' | 'read-failed' | 'write-failed';
 export interface ContractTemplateDraftCacheStatus {
     type: ContractTemplateDraftCacheStatusType;
@@ -434,6 +455,13 @@ export interface ContractTemplateDraftCacheStatus {
 export interface ContractTemplateDesignerProps {
     /** 合同模板数据，正文占位统一写入 variables */
     modelValue?: ContractTemplateData;
+    /**
+     * 多文件受控数据；传入后优先于 modelValue，并通过 update:files 同步。
+     * 每个文件独立保存页面、变量、签署位置和草稿正文。
+     */
+    files?: ContractTemplateFile[];
+    /** 多文件模式当前文件 id，可使用 v-model:active-file-id */
+    activeFileId?: string;
     /**
      * 只读模式，禁止编辑正文和字段
      * @default false
@@ -461,7 +489,7 @@ export interface ContractTemplateDesignerProps {
     pageSizeOptions?: ContractTemplatePageSize[];
     /**
      * 合同允许的最大页数；手动新增、复制页面与自动分页共用此上限
-     * @default 50
+     * @default 20
      */
     maxPages?: number;
     /**
@@ -536,6 +564,20 @@ export interface ContractTemplateDesignerEmits {
     'update:modelValue': [value: ContractTemplateData];
     /** 模板数据变化时触发 */
     change: [value: ContractTemplateData];
+    /** 多文件数据变化时同步 v-model:files */
+    'update:files': [files: ContractTemplateFile[]];
+    /** 当前文件变化时同步 v-model:active-file-id */
+    'update:activeFileId': [fileId: string];
+    /** 多文件任一内容或顺序发生变化 */
+    'files-change': [files: ContractTemplateFile[]];
+    /** 新增文件 */
+    'file-add': [file: ContractTemplateFile];
+    /** 文件名称或内容发生变化 */
+    'file-change': [file: ContractTemplateFile];
+    /** 删除文件 */
+    'file-remove': [file: ContractTemplateFile];
+    /** 文件排序发生变化 */
+    'file-move': [file: ContractTemplateFile, fromIndex: number, toIndex: number];
     /** 新增正文变量时触发 */
     'variable-add': [variable: ContractTemplateVariable];
     /** 调用 validate 后返回校验错误 */
@@ -560,10 +602,26 @@ export interface ContractTemplateDesignerExpose {
     getValue: () => ContractTemplateData;
     /** 替换当前模板数据 */
     setValue: (value: ContractTemplateData) => void;
+    /** 获取多文件快照；单文件模式返回包装后的一项。 */
+    getFiles: () => ContractTemplateFile[];
+    /** 替换多文件数据并定位可用文件。 */
+    setFiles: (files: ContractTemplateFile[], activeFileId?: string) => void;
+    /** 新增空白文件并切换到该文件。 */
+    addFile: (name?: string) => ContractTemplateFile | undefined;
+    /** 切换当前文件。 */
+    selectFile: (fileId: string) => void;
+    /** 重命名文件。 */
+    renameFile: (fileId: string, name: string) => ContractTemplateFile | undefined;
+    /** 删除文件；至少保留一份。 */
+    removeFile: (fileId: string) => ContractTemplateFile | undefined;
+    /** 按方向移动文件。 */
+    moveFile: (fileId: string, direction: -1 | 1) => ContractTemplateFile | undefined;
     /** 校验变量 key 与正文变量节点引用 */
     validate: () => ContractTemplateValidationError[];
     /** 导出 HTML、页面、变量、模板 pageSize 与每页 pageSize */
     exportTemplate: () => ContractTemplateExportResult;
+    /** 逐文件导出，同时返回明确标注的连续预览 HTML。 */
+    exportFiles: () => ContractTemplateFilesExportResult;
     /** 获取将提交给服务端的模板数据 */
     getSubmitData: () => ContractTemplateExportResult;
     /** 清空全部合同信息，仅保留一个空白 A4 合同页 */

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

@@ -0,0 +1,3 @@
+export type ContractTemplateFileTabNavigationKey = 'ArrowDown' | 'ArrowLeft' | 'ArrowRight' | 'ArrowUp' | 'End' | 'Home';
+/** 按 WAI-ARIA Tabs 模式计算自动激活的目标文件；方向键在首尾循环。 */
+export declare function resolveContractTemplateFileTabTargetIndex(currentIndex: number, key: string, fileCount: number): number | undefined;

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

@@ -0,0 +1,11 @@
+export declare const CONTRACT_TEMPLATE_TOOLBAR_OVERFLOW_PRIORITY: readonly ["table", "cleanup", "typography", "insert"];
+export type ContractTemplateToolbarOverflowKey = typeof CONTRACT_TEMPLATE_TOOLBAR_OVERFLOW_PRIORITY[number];
+export interface ContractTemplateToolbarOverflowOptions {
+    availableWidth: number;
+    fixedWidth: number;
+    groupWidths: Partial<Record<ContractTemplateToolbarOverflowKey, number>>;
+    moreWidth: number;
+    buffer?: number;
+}
+/** 按既定优先级收纳工具组；插入组只作为窄中栏下的最后兜底。 */
+export declare function resolveContractTemplateToolbarOverflowKeys(options: ContractTemplateToolbarOverflowOptions): ContractTemplateToolbarOverflowKey[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guodun/antdv",
-  "version": "1.3.2",
+  "version": "1.4.0",
   "type": "module",
   "files": [
     "CHANGELOG.md",
@@ -91,6 +91,7 @@
     "test:contract-signing-location": "node ./test/run-contract-signing-location.mjs",
     "test:contract-signing-flow": "node ./test/run-contract-signing-flow.mjs",
     "test:contract-template-designer": "node ./test/run-contract-template-designer.mjs",
+    "test:contract-template-designer:mounted": "node ./test/run-contract-template-designer-mounted.mjs",
     "test:contract-template-agent": "node ./test/run-contract-template-agent.mjs",
     "pack:release": "pnpm pack",
     "validate:release": "node ../../scripts/base/validate-publish-tarball.mjs guodun-antdv-$(node -p \"require('./package.json').version\").tgz",