@guodun/antdv 1.5.2 → 1.6.0

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

@@ -0,0 +1,20 @@
+import { ContractTemplatePage } from '../types';
+export interface ContractDocumentHeading {
+    pageId: string;
+    /** 当前页真实 heading 节点的零基序号，包含未展示的空标题。 */
+    headingIndex: number;
+    level: number;
+    depth: number;
+    text: string;
+}
+export interface ContractPageNavigationContent {
+    text: string;
+    summary: string;
+    headings: ContractDocumentHeading[];
+}
+/**
+ * 与 DesignerPage 一样以 contentHtml 为准，并复用编辑器 schema。
+ * 不直接数 DOM h 标签：atom 内部 HTML、非法嵌套与表格都应服从 Tiptap 的解析结果。
+ * 解析文档永不挂到页面；只把纯文本交给 Vue 插值，不渲染用户 HTML。
+ */
+export declare function readContractPageNavigation(page: ContractTemplatePage): ContractPageNavigationContent;

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

@@ -0,0 +1,2 @@
+/** 面板内搜索按空白分词、忽略大小写；不修改正文或变量数据。 */
+export declare function matchesContractPanelSearch(query: string, ...values: Array<string | number | undefined>): boolean;

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

@@ -0,0 +1,49 @@
+import { JSONContent } from '@tiptap/core';
+import { ContractTemplateSigningLayoutArrangement, ContractTemplateSigningLayoutFields, ContractTemplateSigningLayoutOptions, ContractTemplateSigningLayoutPreset, ContractTemplateSigningLayoutPresetKey } from '../types';
+export declare const DUAL_PARTY_SIGNING_LAYOUT = "dual-party";
+/** 自定义参数生成的签署版式统一落这个标识，避免宿主 key 进入 schema 白名单。 */
+export declare const CUSTOM_SIGNING_LAYOUT = "custom";
+export declare const MIN_SIGNING_LAYOUT_PARTY_COUNT = 1;
+export declare const MAX_SIGNING_LAYOUT_PARTY_COUNT = 6;
+export declare const SIGNING_LAYOUT_ARRANGEMENTS: ContractTemplateSigningLayoutArrangement[];
+export declare const SIGNING_LAYOUT_ARRANGEMENT_LABELS: Record<ContractTemplateSigningLayoutArrangement, string>;
+export declare const SIGNING_LAYOUT_FIELD_KEYS: Array<keyof ContractTemplateSigningLayoutFields>;
+export declare const SIGNING_LAYOUT_FIELD_LABELS: Record<keyof ContractTemplateSigningLayoutFields, string>;
+/** 默认按天干生成签署方名称，超出十方退化为「11方」。 */
+export declare function resolvePartyName(index: number): string;
+export declare const SIGNING_LAYOUT_PRESETS: Record<ContractTemplateSigningLayoutPresetKey, ContractTemplateSigningLayoutPreset>;
+export declare const SIGNING_LAYOUT_PRESET_KEYS: ContractTemplateSigningLayoutPresetKey[];
+/** schema 允许写入 data-signing-layout 的全部取值；外部 HTML 的其他取值一律丢弃。 */
+export declare const SIGNING_LAYOUT_ATTRIBUTE_VALUES: string[];
+export declare function isSigningLayoutPresetKey(value: unknown): value is ContractTemplateSigningLayoutPresetKey;
+export declare function isSigningLayoutAttributeValue(value: unknown): value is string;
+/** 收敛外部入参：夹取签署方数量、校验排列方式、保证至少留一个签署占位。 */
+export declare function normalizeSigningLayoutOptions(options: Partial<ContractTemplateSigningLayoutOptions> | undefined): ContractTemplateSigningLayoutOptions;
+/**
+ * 参数化生成正文流签署版式；内置预设与自定义面板共用这一个 builder。
+ *
+ * 表格属性只用于区分版式，签章留白始终是正文流内的 signingMark 节点，
+ * 绝不生成 CSL 的 locationRules —— 绝对坐标签署统一归 ContractSigningLocation。
+ */
+export declare function buildSigningLayoutContent(options: Partial<ContractTemplateSigningLayoutOptions>, layout?: string): JSONContent[];
+/** 按注册表 key 生成内置版式内容；data-signing-layout 直接落 preset key。 */
+export declare function buildSigningLayoutPresetContent(key: ContractTemplateSigningLayoutPresetKey): JSONContent[];
+/** @deprecated 使用 buildSigningLayoutPresetContent('dual-party')。 */
+export declare function buildDualPartySigningLayoutPreset(): JSONContent[];
+/** 自定义版式没有预设文案，用参数生成一句摘要给卡片与保存后的预设复用。 */
+export declare function describeSigningLayoutOptions(options: Partial<ContractTemplateSigningLayoutOptions>): string;
+export type ContractTemplateSigningLayoutPreviewItem = 'seal' | 'line' | 'date' | 'text';
+export interface ContractTemplateSigningLayoutPreviewCell {
+    partyLabel: string;
+    items: ContractTemplateSigningLayoutPreviewItem[];
+}
+/** 排版缩略图模型；预览用普通 div 渲染，不实例化编辑器。 */
+export interface ContractTemplateSigningLayoutPreviewModel {
+    arrangement: ContractTemplateSigningLayoutArrangement;
+    columns: number;
+    title?: string;
+    columnLabels?: string[];
+    cells: ContractTemplateSigningLayoutPreviewCell[];
+}
+/** 预览模型与 buildSigningLayoutContent 同源推导，保证 hover 缩略图与插入结果一致。 */
+export declare function buildSigningLayoutPreviewModel(options: Partial<ContractTemplateSigningLayoutOptions>): ContractTemplateSigningLayoutPreviewModel;

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

@@ -0,0 +1,57 @@
+import { ContractTemplateSigningMarkType } from '../types';
+export type SigningMarkResizeHandle = 'top-left' | 'top' | 'top-right' | 'right' | 'bottom-right' | 'bottom' | 'bottom-left' | 'left';
+export declare const MIN_SIGNING_MARK_DIMENSION = 24;
+export declare const MAX_SIGNING_MARK_DIMENSION = 800;
+export declare const SIGNING_MARK_TYPE_LABELS: Record<ContractTemplateSigningMarkType, string>;
+/** 三种正文流签署标记的默认尺寸（96dpi CSS 像素）。 */
+export declare const SIGNING_MARK_DEFAULT_SIZES: Record<ContractTemplateSigningMarkType, {
+    width: number;
+    height: number;
+}>;
+export declare const SIGNING_MARK_DEFAULT_LABELS: Record<ContractTemplateSigningMarkType, string>;
+export interface ContractTemplateSigningMarkAttrs {
+    markType: ContractTemplateSigningMarkType;
+    width: number;
+    height: number;
+    label: string;
+    sealType?: string;
+}
+export interface SigningMarkPresentation {
+    markType: ContractTemplateSigningMarkType;
+    width: number;
+    height: number;
+    label: string;
+    sealType?: string;
+    className: string;
+    style: Record<string, string>;
+    displayLabel: string;
+}
+export interface SigningMarkResizeInput {
+    width: number;
+    height: number;
+    startClientX: number;
+    startClientY: number;
+    clientX: number;
+    clientY: number;
+    handle: SigningMarkResizeHandle;
+    zoom: number;
+    markType: ContractTemplateSigningMarkType;
+    sealType?: string;
+}
+export declare function normalizeSigningMarkDimension(value: unknown): number | undefined;
+export declare function isContractTemplateSigningMarkType(value: unknown): value is ContractTemplateSigningMarkType;
+export declare function getSigningMarkDefaultSize(markType: ContractTemplateSigningMarkType, sealType?: string): {
+    width: number;
+    height: number;
+};
+export declare function getSigningMarkDefaultLabel(markType: ContractTemplateSigningMarkType): string;
+export declare function buildSigningMarkAttrs(markType: ContractTemplateSigningMarkType, overrides?: Partial<ContractTemplateSigningMarkAttrs>): ContractTemplateSigningMarkAttrs;
+export declare function resolveSigningMarkSealAspectRatio(sealType?: string): number;
+/** 签署标记在文档与打印中的外观；数值走内联 CSS 变量，样式表只负责结构。 */
+export declare function resolveSigningMarkPresentation(input: Partial<ContractTemplateSigningMarkAttrs>): SigningMarkPresentation;
+export declare function resolveSigningMarkResizeHandles(markType: ContractTemplateSigningMarkType): SigningMarkResizeHandle[];
+/** 把指针视口位移换算成页面像素尺寸；印章类型锁定章型宽高比。 */
+export declare function resolveSigningMarkResizeDimensions(input: SigningMarkResizeInput): {
+    width: number;
+    height: number;
+};

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

@@ -1,12 +1,12 @@
 import { Component } from 'vue';
-import { ContractTemplateFieldType, ContractTemplateSigningPlacementType } from '../types';
+import { ContractTemplateFieldType, ContractTemplateSigningMarkType } from '../types';
 /**
  * 设计器工具面板与填写渲染器共用类型 icon，避免两处映射漂移。
  * 本版 icons-vue 无 StampOutlined，印章用 SafetyCertificateOutlined。
  */
 export declare const FIELD_TYPE_ICONS: Record<ContractTemplateFieldType, Component>;
-export declare const SIGNING_PLACEMENT_TYPE_ICONS: Record<ContractTemplateSigningPlacementType, Component>;
+export declare const SIGNING_MARK_TYPE_ICONS: Record<ContractTemplateSigningMarkType, Component>;
 /** 未知或缺省正文类型回退为 text，与填写渲染器缺省规则一致。 */
 export declare function resolveFieldTypeIcon(type: unknown): Component;
-/** 签署位置工具项 icon；类型由签署工具列表保证，不做正文变量那种子集回退。 */
-export declare function resolveSigningPlacementTypeIcon(type: ContractTemplateSigningPlacementType): Component;
+/** 签署标记工具项 icon。 */
+export declare function resolveSigningMarkTypeIcon(type: ContractTemplateSigningMarkType): Component;

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

@@ -1,4 +1,4 @@
-export declare const CONTRACT_TEMPLATE_TOOLBAR_OVERFLOW_PRIORITY: readonly ["table", "cleanup", "typography", "insert"];
+export declare const CONTRACT_TEMPLATE_TOOLBAR_OVERFLOW_PRIORITY: readonly ["table", "cleanup", "list", "font-family", "alignment", "font-appearance", "signing", "insert"];
 export type ContractTemplateToolbarOverflowKey = typeof CONTRACT_TEMPLATE_TOOLBAR_OVERFLOW_PRIORITY[number];
 export interface ContractTemplateToolbarOverflowOptions {
     availableWidth: number;
@@ -7,5 +7,5 @@ export interface ContractTemplateToolbarOverflowOptions {
     moreWidth: number;
     buffer?: number;
 }
-/** 按既定优先级收纳工具组；插入组只作为窄中栏下的最后兜底。 */
+/** 按使用频率渐进收纳工具组；签署组与插入组只作为窄中栏下的最后兜底。 */
 export declare function resolveContractTemplateToolbarOverflowKeys(options: ContractTemplateToolbarOverflowOptions): ContractTemplateToolbarOverflowKey[];

package/dist/types/components/pro-dynamic-tags/src/index.vue.d.ts

@@ -13,6 +13,7 @@ declare const _default: import('vue').DefineComponent<ProDynamicTagsPropsType, {
     size: "large" | "middle" | "small";
     closable: boolean;
     modelValue: ProDynamicTagItem[];
+    maxCount: number;
     tagMaxWidth: number | string;
     showAdd: boolean;
     addText: string;

package/dist/types/components/pro-dynamic-tags/src/types.d.ts

@@ -1,6 +1,10 @@
 export interface ProDynamicTagItem {
     label: string;
     value: string | number;
+    /**
+     * 可选的业务类型。选择器场景用它与 value 组成稳定身份，旧的 value-only 标签继续兼容。
+     */
+    type?: string;
     closable?: boolean;
     [key: string]: any;
 }
@@ -9,6 +13,11 @@ export interface ProDynamicTagsPropsType {
      * 标签数据，支持 v-model
      */
     modelValue?: ProDynamicTagItem[];
+    /**
+     * 最大显示数量，超出部分折叠为 +N；不限制实际 modelValue 数量
+     * @default 5
+     */
+    maxCount?: number;
     /**
      * 标签最大宽度（单位：px）
      * @default 60

package/dist/types/components/pro-menu-tree/index.d.ts

@@ -152,9 +152,9 @@ export declare const GdAntProMenuTree: import('../utils/install').SFCWithInstall
     readonly modelValue: string[];
     readonly fieldNames: import('.').MenuTreeFieldNames;
     readonly http: import('.').ProMenuTreeHttpClient;
-    readonly isBuiltInRequest: boolean;
-    readonly treeData: import('.').MenuTreeNode[];
     readonly defaultExpandAll: boolean;
+    readonly treeData: import('.').MenuTreeNode[];
+    readonly isBuiltInRequest: boolean;
     readonly nodeTypeField: string;
     readonly buttonType: string;
     readonly iconField: string;

package/dist/types/components/pro-menu-tree/src/pro-menu-tree.d.ts

@@ -152,9 +152,9 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     readonly modelValue: string[];
     readonly fieldNames: import('./types').MenuTreeFieldNames;
     readonly http: import('./types').ProMenuTreeHttpClient;
-    readonly isBuiltInRequest: boolean;
-    readonly treeData: MenuTreeNode[];
     readonly defaultExpandAll: boolean;
+    readonly treeData: MenuTreeNode[];
+    readonly isBuiltInRequest: boolean;
     readonly nodeTypeField: string;
     readonly buttonType: string;
     readonly iconField: string;