@guodun/antdv 1.7.3 → 1.7.5

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

@@ -471,6 +471,8 @@ export interface ContractTemplateValidationError {
 }
 export type ContractTemplateRenderValue = string | number | boolean | ContractTemplateSelectionValue | ContractTemplateSelectionValue[] | null | undefined;
 export type ContractTemplateRenderValues = Record<string, ContractTemplateRenderValue>;
+/** 按稳定文件 id 隔离填写值；不同文件的同名变量互不共享。 */
+export type ContractTemplateRenderValuesByFile = Record<string, ContractTemplateRenderValues>;
 export type ContractTemplateRendererMode = 'panel' | 'inline';
 export interface ContractTemplateRendererFieldSlotProps {
     variable: ContractTemplateVariable;
@@ -486,6 +488,12 @@ export interface ContractTemplateRendererFieldSlotProps {
     focusVariable: () => void;
 }
 export interface ContractTemplateRendererProps {
+    /** 显式传入即启用多文件模式（包括空数组）；优先于 template，不补造文件或 id。 */
+    files?: ContractTemplateFile[];
+    /** 当前文件 id；无效时回退第一份 id 合法且唯一的文件。 */
+    activeFileId?: string;
+    /** 多文件填写值，优先于单文件 values。 */
+    valuesByFile?: ContractTemplateRenderValuesByFile;
     /** 设计器导出的模板数据 */
     template?: ContractTemplateData;
     /** 按变量 key 记录的填写值 */
@@ -516,7 +524,7 @@ export interface ContractTemplateRendererProps {
      */
     showSubmitButton?: boolean;
     /**
-     * 点击提交时是否校验填写值；模板结构与安全错误始终阻止提交
+     * 点击提交时是否主动展示填写校验结果；服务端一定会拒绝的规则始终阻止提交
      * @default true
      */
     validateOnSubmit?: boolean;
@@ -572,13 +580,15 @@ export interface ContractTemplateRendererProps {
     contractFontBaseUrl?: string;
 }
 export interface ContractTemplateRendererEmits {
+    'update:activeFileId': [value: string];
+    'update:valuesByFile': [value: ContractTemplateRenderValuesByFile];
     /** 填写值变化时同步 v-model:values */
     'update:values': [value: ContractTemplateRenderValues];
     /** 填写值变化时触发 */
     change: [value: ContractTemplateRenderValues];
     /** 调用 validate 后返回校验错误 */
     validate: [errors: ContractTemplateValidationError[]];
-    /** 提交当前填写值；模板结构与安全校验必须通过，填写值校验受 validateOnSubmit 控制 */
+    /** 提交当前填写值；服务端一定会拒绝的模板、资源和填写值规则必须通过 */
     submit: [value: ContractTemplateRenderValues];
     /** 缩放比例变化时同步 v-model:zoom */
     'update:zoom': [value: number];
@@ -586,6 +596,10 @@ export interface ContractTemplateRendererEmits {
     'control-warning': [warning: ContractTemplateControlWarning];
 }
 export interface ContractTemplateRendererExpose {
+    /** 所有合法文件的填写值（含未访问文件默认值）；单文件模式返回空 map，不合成 id。 */
+    getAllValues: () => ContractTemplateRenderValuesByFile;
+    /** 校验全部文件并切换、定位首个错误；disabled 时只校验、不切换。单文件等价于 validate。 */
+    validateAll: () => ContractTemplateValidationError[];
     /** 获取当前填写值快照 */
     getValues: () => ContractTemplateRenderValues;
     /** 替换当前填写值 */

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

@@ -31,10 +31,10 @@ export interface ContractTemplateRenderPage {
 export declare function buildInitialRenderValues(template: ContractTemplateData | undefined): ContractTemplateRenderValues;
 /** 合并模板初始值与外部传入值，外部值优先。 */
 export declare function normalizeRenderValues(template: ContractTemplateData | undefined, values: ContractTemplateRenderValues | undefined): ContractTemplateRenderValues;
-/** 模板结构校验 + 按变量类型逐项校验填写值。 */
+/** 模板结构校验 + 按 PDF 服务规则逐项校验填写值。 */
 export declare function validateTemplateRenderValues(template: ContractTemplateData | undefined, values: ContractTemplateRenderValues): ContractTemplateValidationError[];
-/** 保留 validateOnSubmit=false 的兼容语义，但模板结构和安全错误始终阻止提交。 */
-export declare function resolveTemplateRenderSubmitErrors(template: ContractTemplateData | undefined, values: ContractTemplateRenderValues, validateOnSubmit: boolean): ContractTemplateValidationError[];
+/** 保留参数以兼容已有调用方；服务端一定会拒绝的错误不能被关闭。 */
+export declare function resolveTemplateRenderSubmitErrors(template: ContractTemplateData | undefined, values: ContractTemplateRenderValues, _validateOnSubmit: boolean): ContractTemplateValidationError[];
 /** 联合检查模板结构、正文引用与不可信 HTML，供渲染和提交共用。 */
 export declare function validateTemplateRenderStructure(template: ContractTemplateData | undefined): ContractTemplateValidationError[];
 /** 把模板逐页渲染成可直接注入的正文 HTML 与页面尺寸信息。 */

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

@@ -3,8 +3,10 @@ export type ContractTemplateToolbarOverflowKey = typeof CONTRACT_TEMPLATE_TOOLBA
 export interface ContractTemplateToolbarOverflowOptions {
     availableWidth: number;
     fixedWidth: number;
+    fixedItemCount: number;
     groupWidths: Partial<Record<ContractTemplateToolbarOverflowKey, number>>;
     moreWidth: number;
+    itemGap?: number;
     buffer?: number;
 }
 /** 按使用频率渐进收纳工具组；签署组与插入组只作为窄中栏下的最后兜底。 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guodun/antdv",
-  "version": "1.7.3",
+  "version": "1.7.5",
   "type": "module",
   "files": [
     "CHANGELOG.md",
@@ -83,8 +83,8 @@
     "vue-types": "3.0.2",
     "vue": "^3.5.18",
     "@guodun/utils": "^1.0.0",
-    "@guodun/contract-print-css": "^0.1.1",
-    "@guodun/contract-template-agent": "^0.1.0"
+    "@guodun/contract-template-agent": "^0.1.0",
+    "@guodun/contract-print-css": "^0.1.1"
   },
   "scripts": {
     "build": "rm -rf dist/types && vite build && vite build --config vite.theme.config.ts",