@guodun/antdv 1.4.4 → 1.4.6

package/dist/types/components/contract-signing-location/src/ContractSigningLocation.vue.d.ts

@@ -1,4 +1,4 @@
-import { ContractSigningLocationError, ContractSigningLocationProps, ContractSigningLocationValue, ContractSigningPlacement, ContractSigningPlacementType } from './types';
+import { ContractSigningFile, ContractSigningLocationError, ContractSigningLocationProps, ContractSigningLocationValue, ContractSigningPlacement, ContractSigningPlacementType } from './types';
 declare const _default: import('vue').DefineComponent<ContractSigningLocationProps, {
     load: () => Promise<ContractSigningLocationValue | false>;
     validate: () => ContractSigningLocationError[];
@@ -54,7 +54,7 @@ declare const _default: import('vue').DefineComponent<ContractSigningLocationPro
     showInspector: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     canvasRef: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<{
-        file?: import('./types').ContractSigningFile;
+        file?: ContractSigningFile;
         pages: import('./types').ContractSigningPage[];
         placements: ContractSigningPlacement[];
         selectedPlacementId: string;
@@ -105,7 +105,7 @@ declare const _default: import('vue').DefineComponent<ContractSigningLocationPro
         M: {};
         Defaults: {};
     }, Readonly<{
-        file?: import('./types').ContractSigningFile;
+        file?: ContractSigningFile;
         pages: import('./types').ContractSigningPage[];
         placements: ContractSigningPlacement[];
         selectedPlacementId: string;

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

@@ -8,6 +8,7 @@ export * from './src/composables/use-template-draft-cache';
 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 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/ContractTemplateDesignerInspector.vue.d.ts

@@ -8,6 +8,7 @@ type __VLS_Props = {
         type: ContractTemplateFieldType;
         label: string;
         icon: unknown;
+        group: 'basic' | 'advanced-choice' | 'builtin-selector' | 'custom';
     }>;
     signingPlacementTools: Array<{
         key: string;

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

@@ -5,6 +5,7 @@ type __VLS_Props = {
     showDraftCacheStatus: boolean;
     showClearButton: boolean;
     showSubmitDataViewer: boolean;
+    showVariableDataViewer: boolean;
     readonly: boolean;
     zoomPercent: string;
     zoomOutDisabled: boolean;
@@ -39,6 +40,7 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
     toggleFullscreen: () => any;
     toggleImmersive: () => any;
     submitData: () => any;
+    variableData: () => any;
     togglePageDecorations: () => any;
     toggleChrome: () => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
@@ -52,6 +54,7 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
     onToggleFullscreen?: (() => any) | undefined;
     onToggleImmersive?: (() => any) | undefined;
     onSubmitData?: (() => any) | undefined;
+    onVariableData?: (() => any) | undefined;
     onTogglePageDecorations?: (() => any) | undefined;
     onToggleChrome?: (() => any) | undefined;
 }>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {

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

@@ -1,4 +1,4 @@
-import { ContractTemplateRenderValue, ContractTemplateValidationError, ContractTemplateVariable } from './types';
+import { ContractTemplateControlOption, ContractTemplateControlRegistration, ContractTemplateRenderValue, ContractTemplateValidationError, ContractTemplateVariable } from './types';
 type __VLS_Props = {
     variable: ContractTemplateVariable;
     value: ContractTemplateRenderValue;
@@ -6,6 +6,12 @@ type __VLS_Props = {
     active: boolean;
     readonly: boolean;
     disabled: boolean;
+    options?: ContractTemplateControlOption[];
+    loading?: boolean;
+    loadError?: string;
+    registration?: ContractTemplateControlRegistration;
+    selectorHttp?: unknown;
+    selectorUrlPrefix?: string;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     updateValue: (value: ContractTemplateRenderValue) => any;

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

@@ -0,0 +1,14 @@
+import { ContractTemplateVariableData } from './types';
+type __VLS_Props = {
+    open: boolean;
+    data: ContractTemplateVariableData;
+    fileName?: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    cancel: () => any;
+    "update:open": (value: boolean) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onCancel?: (() => any) | undefined;
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -1,4 +1,4 @@
-import { ContractTemplateContentImage, ContractTemplateData, ContractTemplateFile, ContractTemplateFilesExportResult, ContractLocationRule, ContractTemplateDesignerProps, ContractTemplateDraftCacheStatus, ContractTemplateEditorCommand, ContractTemplateEditorState, ContractTemplateEditorTextAlign, ContractTemplateFieldStyle, ContractTemplateFieldType, ContractTemplatePageDecorations, ContractTemplatePageSize, ContractTemplateLocationRule, ContractTemplateLocationRuleOptions, ContractTemplateSigningPlacement, ContractTemplateSigningPlacementType, ContractTemplateTableInsertOptions, ContractTemplateTableCommandCapabilities, ContractTemplateValidationError, ContractTemplateVariable } from './types';
+import { ContractTemplateContentImage, ContractTemplateData, ContractTemplateFile, ContractTemplateFilesExportResult, ContractLocationRule, ContractTemplateDesignerProps, ContractTemplateDraftCacheStatus, ContractTemplateEditorCommand, ContractTemplateEditorState, ContractTemplateEditorTextAlign, ContractTemplateFieldStyle, ContractTemplateFieldType, ContractTemplatePageDecorations, ContractTemplatePageSize, ContractTemplateLocationRule, ContractTemplateLocationRuleOptions, ContractTemplateSigningPlacement, ContractTemplateSigningPlacementType, ContractTemplateTableInsertOptions, ContractTemplateTableCommandCapabilities, ContractTemplateValidationError, ContractTemplateVariable, ContractTemplateVariableData } from './types';
 import { ContractTemplateImageSource } from './utils/content-image';
 declare const _default: import('vue').DefineComponent<ContractTemplateDesignerProps, {
     getValue: () => ContractTemplateData;
@@ -26,6 +26,9 @@ declare const _default: import('vue').DefineComponent<ContractTemplateDesignerPr
     closePreview: () => void;
     openSubmitDataViewer: () => import('./types').ContractTemplateExportResult;
     closeSubmitDataViewer: () => void;
+    getVariableData: () => ContractTemplateVariableData;
+    openVariableDataViewer: () => ContractTemplateVariableData;
+    closeVariableDataViewer: () => void;
     setServerValidationErrors: (errors: ContractTemplateValidationError[]) => void;
     clearValidationErrors: () => void;
     scrollToVariable: (variableKey: string) => void;
@@ -89,9 +92,13 @@ declare const _default: import('vue').DefineComponent<ContractTemplateDesignerPr
     showDraftCacheStatus: boolean;
     showClearButton: boolean;
     showSubmitDataViewer: boolean;
+    showVariableDataViewer: boolean;
     showSigningPlacementTools: boolean;
     maxPages: number;
     variableTypes: import('./types').ContractTemplateFieldTypeOption[];
+    showAdvancedChoiceControls: boolean;
+    showBuiltinSelectorControls: boolean;
+    showCustomControls: boolean;
     defaultVariableStyle: ContractTemplateFieldStyle;
     fontFamilies: import('./types').ContractTemplateFontFamilyOption[];
     fontFamilyMode: import('./types').ContractTemplateFontFamilyMode;
@@ -109,6 +116,7 @@ declare const _default: import('vue').DefineComponent<ContractTemplateDesignerPr
         showDraftCacheStatus: boolean;
         showClearButton: boolean;
         showSubmitDataViewer: boolean;
+        showVariableDataViewer: boolean;
         readonly: boolean;
         zoomPercent: string;
         zoomOutDisabled: boolean;
@@ -136,6 +144,7 @@ declare const _default: import('vue').DefineComponent<ContractTemplateDesignerPr
         onToggleFullscreen?: (() => any) | undefined;
         onToggleImmersive?: (() => any) | undefined;
         onSubmitData?: (() => any) | undefined;
+        onVariableData?: (() => any) | undefined;
         onTogglePageDecorations?: (() => any) | undefined;
         onToggleChrome?: (() => any) | undefined;
     }>, {
@@ -153,6 +162,7 @@ declare const _default: import('vue').DefineComponent<ContractTemplateDesignerPr
         toggleFullscreen: () => any;
         toggleImmersive: () => any;
         submitData: () => any;
+        variableData: () => any;
         togglePageDecorations: () => any;
         toggleChrome: () => any;
     }, import('vue').PublicProps, {}, false, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
@@ -171,6 +181,7 @@ declare const _default: import('vue').DefineComponent<ContractTemplateDesignerPr
         showDraftCacheStatus: boolean;
         showClearButton: boolean;
         showSubmitDataViewer: boolean;
+        showVariableDataViewer: boolean;
         readonly: boolean;
         zoomPercent: string;
         zoomOutDisabled: boolean;
@@ -198,6 +209,7 @@ declare const _default: import('vue').DefineComponent<ContractTemplateDesignerPr
         onToggleFullscreen?: (() => any) | undefined;
         onToggleImmersive?: (() => any) | undefined;
         onSubmitData?: (() => any) | undefined;
+        onVariableData?: (() => any) | undefined;
         onTogglePageDecorations?: (() => any) | undefined;
         onToggleChrome?: (() => any) | undefined;
     }>, {

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

@@ -1,5 +1,5 @@
 import { VNode } from 'vue';
-import { ContractTemplateRenderValues, ContractTemplateRendererFieldSlotProps, ContractTemplateRendererProps, ContractTemplateValidationError } from './types';
+import { ContractTemplateRenderValues, ContractTemplateRendererFieldSlotProps, ContractTemplateRendererProps, ContractTemplateValidationError, ContractTemplateControlWarning } from './types';
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: Readonly<{
@@ -35,12 +35,14 @@ declare const __VLS_component: import('vue').DefineComponent<ContractTemplateRen
     submit: (value: ContractTemplateRenderValues) => any;
     "update:zoom": (value: number) => any;
     "update:values": (value: ContractTemplateRenderValues) => any;
+    "control-warning": (warning: ContractTemplateControlWarning) => any;
 }, string, import('vue').PublicProps, Readonly<ContractTemplateRendererProps> & Readonly<{
     onValidate?: ((errors: ContractTemplateValidationError[]) => any) | undefined;
     onChange?: ((value: ContractTemplateRenderValues) => any) | undefined;
     onSubmit?: ((value: ContractTemplateRenderValues) => any) | undefined;
     "onUpdate:zoom"?: ((value: number) => any) | undefined;
     "onUpdate:values"?: ((value: ContractTemplateRenderValues) => any) | undefined;
+    "onControl-warning"?: ((warning: ContractTemplateControlWarning) => any) | undefined;
 }>, {
     values: ContractTemplateRenderValues;
     disabled: boolean;
@@ -50,12 +52,20 @@ declare const __VLS_component: import('vue').DefineComponent<ContractTemplateRen
     zoom: number;
     showToolbar: boolean;
     showSubmitButton: boolean;
+    selectorHttp: undefined;
+    selectorUrlPrefix: string;
     showValidateButton: boolean;
     showResetButton: boolean;
     interactionMode: import('./types').ContractTemplateRendererMode;
     validateOnSubmit: boolean;
     showPageMeta: boolean;
     collapsiblePanel: boolean;
+    controlRegistry: import('./types').ContractTemplateControlRegistry;
+    optionResolver: import('./types').ContractTemplateOptionResolver;
+    requester: import('./types').ContractTemplateControlRequester;
+    allowedRemoteOrigins: string[];
+    remoteRequestTimeoutMs: number;
+    remoteOptionsCacheTtlMs: number;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     rendererElement: HTMLElement;
     pagesViewportElement: HTMLDivElement;

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

@@ -23,6 +23,10 @@ export declare function validateContractTemplateVariableKey(key: unknown, variab
 export declare function normalizeContractTemplateMaxPages(value: unknown): number;
 /** 正文可插入的变量类型及其默认尺寸。 */
 export declare const DEFAULT_FIELD_TYPES: ContractTemplateFieldTypeOption[];
+export declare const DEFAULT_ADVANCED_CHOICE_FIELD_TYPES: ContractTemplateFieldTypeOption[];
+export declare const DEFAULT_BUILTIN_SELECTOR_FIELD_TYPES: ContractTemplateFieldTypeOption[];
+export declare const DEFAULT_CUSTOM_FIELD_TYPES: ContractTemplateFieldTypeOption[];
+export declare const ALL_DEFAULT_FIELD_TYPES: ContractTemplateFieldTypeOption[];
 /** 生成设计器内部 ID；时间戳加自增序号，保证同一次会话内不重复。 */
 export declare function createDesignerId(prefix: string): string;
 /** 深拷贝模板数据，切断与响应式对象的引用。 */

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

@@ -1,5 +1,5 @@
 import { Node, Editor } from '@tiptap/core';
-import { ContractTemplateFieldStyle, ContractTemplateFieldType, ContractTemplateVariable } from '../types';
+import { ContractTemplateControlOption, ContractTemplateFieldStyle, ContractTemplateFieldType, ContractTemplateJsonObject, ContractTemplateRemoteDataSource, ContractTemplateVariable } from '../types';
 /** 正文变量节点在 Tiptap 中持久化的全部属性；每一项都对应一个 `data-*`。 */
 export interface TemplateVariableAttrs {
     key: string;
@@ -15,6 +15,11 @@ export interface TemplateVariableAttrs {
     useGrouping?: boolean;
     checkedText: string;
     uncheckedText: string;
+    options: ContractTemplateControlOption[];
+    dataSource?: ContractTemplateRemoteDataSource;
+    multiple: boolean;
+    componentKey: string;
+    componentConfig: ContractTemplateJsonObject;
     multiline: boolean;
     rows: number;
     lineHeight: number;
@@ -52,6 +57,11 @@ export declare function buildTemplateVariableAttrs(variable: {
     useGrouping?: boolean;
     checkedText?: string;
     uncheckedText?: string;
+    options?: ContractTemplateControlOption[];
+    dataSource?: ContractTemplateRemoteDataSource;
+    multiple?: boolean;
+    componentKey?: string;
+    componentConfig?: ContractTemplateJsonObject;
     multiline?: boolean;
     rows?: number;
     lineHeight?: number;

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

@@ -1,8 +1,86 @@
 import { JSONContent } from '@tiptap/core';
+import { Component } from 'vue';
 import { ContractTemplateImageCompression, ContractTemplateImageSource, ContractTemplateImageUploadHandler } from './utils/content-image';
 /** 正文变量只描述文档流内的填写项；签署位置使用独立的 signingPlacements。 */
-export type ContractTemplateFieldType = 'text' | 'date' | 'number' | 'image' | 'checkbox';
+export type ContractTemplateBasicFieldType = 'text' | 'date' | 'number' | 'image' | 'checkbox';
+export type ContractTemplateAdvancedChoiceFieldType = 'select' | 'radio';
+export type ContractTemplateBuiltinSelectorFieldType = 'user-selector' | 'dept-selector' | 'role-selector' | 'org-selector';
+export type ContractTemplateFieldType = ContractTemplateBasicFieldType | ContractTemplateAdvancedChoiceFieldType | ContractTemplateBuiltinSelectorFieldType | 'custom';
 export declare function isContractTemplateFieldType(value: unknown): value is ContractTemplateFieldType;
+export declare function isContractTemplateAdvancedChoiceFieldType(value: unknown): value is ContractTemplateAdvancedChoiceFieldType;
+export declare function isContractTemplateBuiltinSelectorFieldType(value: unknown): value is ContractTemplateBuiltinSelectorFieldType;
+/** JSON 配置在边界处按纯数据处理；具体 schema 由注册表/宿主负责约束。 */
+export type ContractTemplateJsonPrimitive = string | number | boolean | null;
+export type ContractTemplateJsonValue = ContractTemplateJsonPrimitive | unknown[] | Record<string, unknown>;
+export type ContractTemplateJsonObject = Record<string, ContractTemplateJsonValue>;
+/** 高级控件统一使用可序列化对象，保证交互渲染、HTML/PDF 与服务端持久化口径一致。 */
+export interface ContractTemplateSelectionValue {
+    value: string | number;
+    label: string;
+    type: string;
+    /** 宿主已解析出的展示文案；存在时优先于 label。 */
+    displayText?: string;
+    /**
+     * 扩展字段必须保持 JSON 可序列化；显式可选属性（如 disabled）需要允许 undefined，
+     * 否则 TypeScript 会把可选字段判定为不符合索引签名。
+     */
+    [key: string]: unknown;
+}
+export interface ContractTemplateControlOption extends ContractTemplateSelectionValue {
+    disabled?: boolean;
+}
+export type ContractTemplateRemoteDataSource = {
+    kind: 'resolver';
+    resolverKey: string;
+    params?: ContractTemplateJsonObject;
+} | {
+    kind: 'url';
+    url: string;
+    method?: 'GET' | 'POST';
+    params?: ContractTemplateJsonObject;
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+    valueField?: string;
+    labelField?: string;
+    dataPath?: string;
+};
+export interface ContractTemplateControlRequest {
+    url: string;
+    method: 'GET' | 'POST';
+    params?: ContractTemplateJsonObject;
+    headers?: Record<string, string>;
+    timeoutMs: number;
+    signal: AbortSignal;
+    variable: ContractTemplateVariable;
+}
+export type ContractTemplateControlRequester = (request: ContractTemplateControlRequest) => Promise<unknown>;
+export interface ContractTemplateOptionResolveContext {
+    resolverKey: string;
+    params?: ContractTemplateJsonObject;
+    variable: ContractTemplateVariable;
+    signal: AbortSignal;
+}
+export type ContractTemplateOptionResolver = (context: ContractTemplateOptionResolveContext) => Promise<ContractTemplateControlOption[]>;
+export interface ContractTemplateControlAdapterContext {
+    variable: ContractTemplateVariable;
+    config: ContractTemplateJsonObject;
+}
+export interface ContractTemplateControlRegistration {
+    component: Component;
+    /** 可选 JSON Schema，供宿主设计器或配置平台校验 componentConfig。 */
+    schema?: ContractTemplateJsonObject;
+    normalizeValue?: (value: unknown, context: ContractTemplateControlAdapterContext) => ContractTemplateRenderValue;
+    toDisplayText?: (value: ContractTemplateRenderValue, context: ContractTemplateControlAdapterContext) => string;
+    resolveProps?: (context: ContractTemplateControlAdapterContext) => Record<string, unknown>;
+}
+export type ContractTemplateControlRegistry = Record<string, ContractTemplateControlRegistration>;
+export interface ContractTemplateControlWarning {
+    code: 'CONTROL_OPTIONS_LOAD_FAILED' | 'CONTROL_COMPONENT_MISSING' | 'CONTROL_REMOTE_URL_BLOCKED';
+    variableKey: string;
+    componentKey?: string;
+    message: string;
+    cause?: unknown;
+}
 export type ContractTemplatePageFormat = 'A0' | 'A1' | 'A2' | 'A3' | 'A4' | 'A5' | 'Letter' | 'Legal' | 'Custom';
 export interface ContractTemplatePageSize {
     /** 页面格式；常用预设会自动带出宽高 */
@@ -85,6 +163,16 @@ export interface ContractTemplateVariable {
     useGrouping?: boolean;
     checkedText?: string;
     uncheckedText?: string;
+    /** 下拉/单选的本地选项；远程加载成功后由渲染器中的运行时选项覆盖。 */
+    options?: ContractTemplateControlOption[];
+    /** 远程数据声明。模板只保存声明，请求始终交给宿主注入的 resolver/requester。 */
+    dataSource?: ContractTemplateRemoteDataSource;
+    /** 下拉和内置选择器是否允许多选；单选框始终按单选处理。 */
+    multiple?: boolean;
+    /** 自定义控件注册键；模板不持久化 Vue 组件或函数。 */
+    componentKey?: string;
+    /** 自定义控件的纯 JSON 配置。 */
+    componentConfig?: ContractTemplateJsonObject;
     /** 文本变量是否以多行下划线展示 */
     multiline?: boolean;
     /** 多行下划线行数，仅在 multiline 为 true 时生效 */
@@ -167,6 +255,13 @@ export interface ContractTemplateData {
     /** 旧模板可缺省；配置后由设计器预览、填写渲染器和 PDF 服务共同消费。 */
     pageDecorations?: ContractTemplatePageDecorations;
 }
+/** 当前活动合同文件可直接用于接口联调的变量快照。 */
+export interface ContractTemplateVariableData {
+    /** 按变量 key 组织的请求示例值；每个变量都会保留一个 key。 */
+    values: Record<string, string | number | boolean>;
+    /** 当前文件完整变量定义，顺序与模板保持一致。 */
+    variables: ContractTemplateVariable[];
+}
 /** 多文件设计器中的一份独立合同文件；正文、变量和签署位置均在文件内隔离。 */
 export interface ContractTemplateFile {
     id: string;
@@ -370,7 +465,7 @@ export interface ContractTemplateValidationError {
     /** 服务端返回的页面 id，用于定位具体页面 */
     pageId?: string;
 }
-export type ContractTemplateRenderValue = string | number | boolean | undefined;
+export type ContractTemplateRenderValue = string | number | boolean | ContractTemplateSelectionValue | ContractTemplateSelectionValue[] | null | undefined;
 export type ContractTemplateRenderValues = Record<string, ContractTemplateRenderValue>;
 export type ContractTemplateRendererMode = 'panel' | 'inline';
 export interface ContractTemplateRendererFieldSlotProps {
@@ -380,6 +475,9 @@ export interface ContractTemplateRendererFieldSlotProps {
     active: boolean;
     readonly: boolean;
     disabled: boolean;
+    options: ContractTemplateControlOption[];
+    loading: boolean;
+    loadError?: string;
     updateValue: (value: ContractTemplateRenderValue) => void;
     focusVariable: () => void;
 }
@@ -448,6 +546,21 @@ export interface ContractTemplateRendererProps {
      * @default 1
      */
     zoom?: number;
+    /** 自定义控件注册表。模板仅通过 componentKey 引用，组件实例与适配器不会持久化。 */
+    controlRegistry?: ContractTemplateControlRegistry;
+    /** resolver 型远程数据源统一入口。 */
+    optionResolver?: ContractTemplateOptionResolver;
+    /** URL 型远程数据源统一入口；组件库本身不会发起网络请求。 */
+    requester?: ContractTemplateControlRequester;
+    /** 允许 URL 型数据源访问的绝对地址 origin；相对路径不受此项限制。 */
+    allowedRemoteOrigins?: string[];
+    /** 远程选项默认超时，变量级 timeoutMs 可缩短但不能超过该值。 */
+    remoteRequestTimeoutMs?: number;
+    /** 远程选项完成态缓存时长；设为 0 可关闭缓存。 */
+    remoteOptionsCacheTtlMs?: number;
+    /** 透传给内置用户/部门/角色选择器的宿主请求实例。 */
+    selectorHttp?: unknown;
+    selectorUrlPrefix?: string;
 }
 export interface ContractTemplateRendererEmits {
     /** 填写值变化时同步 v-model:values */
@@ -460,6 +573,8 @@ export interface ContractTemplateRendererEmits {
     submit: [value: ContractTemplateRenderValues];
     /** 缩放比例变化时同步 v-model:zoom */
     'update:zoom': [value: number];
+    /** 高级控件降级时抛出可定位告警；失败不会清空用户已有值。 */
+    'control-warning': [warning: ContractTemplateControlWarning];
 }
 export interface ContractTemplateRendererExpose {
     /** 获取当前填写值快照 */
@@ -568,6 +683,12 @@ export interface ContractTemplateDesignerProps {
      * @default 内置 text/date/number/image/checkbox
      */
     variableTypes?: ContractTemplateFieldTypeOption[];
+    /** 展示下拉框与单选框工具；默认关闭，与组织选择器能力独立。 */
+    showAdvancedChoiceControls?: boolean;
+    /** 展示用户、部门、角色、组织架构工具；默认关闭。 */
+    showBuiltinSelectorControls?: boolean;
+    /** 展示通用自定义控件工具；默认关闭。 */
+    showCustomControls?: boolean;
     /**
      * 新增模板变量的默认样式
      * @default 内置默认样式
@@ -585,6 +706,8 @@ export interface ContractTemplateDesignerProps {
      * @default true
      */
     showSubmitDataViewer?: boolean;
+    /** 是否展示控件变量查看入口；关闭后 expose 方法仍可用。 */
+    showVariableDataViewer?: boolean;
     /**
      * 是否展示内置清空模板按钮；关闭后仍可通过 expose 方法清空
      * @default true
@@ -710,6 +833,12 @@ export interface ContractTemplateDesignerExpose {
     openSubmitDataViewer: () => ContractTemplateExportResult;
     /** 关闭提交数据查看弹窗 */
     closeSubmitDataViewer: () => void;
+    /** 获取当前活动文件的变量请求示例与完整变量定义。 */
+    getVariableData: () => ContractTemplateVariableData;
+    /** 打开控件变量查看弹窗，并返回当前活动文件变量数据。 */
+    openVariableDataViewer: () => ContractTemplateVariableData;
+    /** 关闭控件变量查看弹窗。 */
+    closeVariableDataViewer: () => void;
     /** 展示服务端校验错误，并复用组件内错误定位能力 */
     setServerValidationErrors: (errors: ContractTemplateValidationError[]) => void;
     /** 清空组件内与服务端校验错误 */

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

@@ -0,0 +1,15 @@
+import { ContractTemplateControlOption, ContractTemplateJsonObject, ContractTemplateRenderValue, ContractTemplateRemoteDataSource, ContractTemplateSelectionValue } from '../types';
+export declare function isContractTemplateSelectionValue(value: unknown): value is ContractTemplateSelectionValue;
+/** 把高级控件脏值收敛成稳定 DTO；函数、Symbol 等宿主私有数据不会进入模板值。 */
+export declare function normalizeContractTemplateSelectionValue(value: unknown, fallbackType: string): ContractTemplateSelectionValue | undefined;
+export declare function normalizeContractTemplateSelectionValues(value: unknown, fallbackType: string, multiple: boolean): ContractTemplateRenderValue;
+export declare function formatContractTemplateRenderValue(value: ContractTemplateRenderValue): string;
+/** data-* 里使用 URI 编码承载 JSON，避免引号与无 DOM 正则解析互相冲突。 */
+export declare function encodeContractTemplateJsonAttribute(value: unknown): string;
+export declare function decodeContractTemplateJsonAttribute<T>(value: unknown): T | undefined;
+export declare function normalizeContractTemplateControlOptions(payload: unknown, source: Extract<ContractTemplateRemoteDataSource, {
+    kind: 'url';
+}> | undefined, fallbackType: string): ContractTemplateControlOption[];
+export declare function isAllowedContractTemplateRemoteUrl(url: string, allowedOrigins: readonly string[]): boolean;
+export declare function normalizeContractTemplateRequestTimeout(value: unknown, maximum?: number): number;
+export declare function normalizeContractTemplateJsonObject(value: unknown): ContractTemplateJsonObject;

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

@@ -1,12 +1,20 @@
-import { ContractTemplateData, ContractTemplatePageFormat, ContractTemplatePageDecorations, ContractTemplateRenderValue, ContractTemplateRenderValues, ContractTemplateValidationError, ContractTemplateVariable } from '../types';
+import { ContractTemplateData, ContractTemplatePageFormat, ContractTemplatePageDecorations, ContractTemplateRenderValue, ContractTemplateRenderValues, ContractTemplateValidationError, ContractTemplateVariable, ContractTemplateControlOption, ContractTemplateVariableData } from '../types';
 import { isSafeContractImageUrl } from './image-url';
 export { isSafeContractImageUrl };
+/**
+ * 生成当前模板变量的接口联调快照。
+ *
+ * 这个快照刻意与填写渲染器的 `undefined` 语义分离：远程请求通常需要一个
+ * 可直接序列化且字段完整的对象，因此没有默认值的变量统一使用空字符串。
+ */
+export declare function buildTemplateVariableData(template: ContractTemplateData | undefined): ContractTemplateVariableData;
 export type ContractTemplateRenderHtmlMode = 'control' | 'display';
 export interface ContractTemplateRenderHtmlOptions {
     readonly?: boolean;
     disabled?: boolean;
     mode?: ContractTemplateRenderHtmlMode;
     activeKey?: string;
+    optionsByKey?: ReadonlyMap<string, ContractTemplateControlOption[]>;
 }
 export interface ContractTemplateRenderPage {
     id: string;
@@ -34,7 +42,7 @@ export declare function buildTemplateRenderPages(template: ContractTemplateData
 /** 把整个模板拼成单段 HTML，页面尺寸写进 section 内联样式。 */
 export declare function buildTemplateRenderHtml(template: ContractTemplateData | undefined, values: ContractTemplateRenderValues, options?: ContractTemplateRenderHtmlOptions): string;
 /** 空值判定与 required 校验共用；`false` 是有效的复选值，不算空。 */
-export declare function isEmptyRenderValue(value: ContractTemplateRenderValue): value is "" | undefined;
+export declare function isEmptyRenderValue(value: ContractTemplateRenderValue): boolean;
 /**
  * 净化不可信正文 HTML。
  *

package/dist/types/components/pro-selector/index.d.ts

@@ -114,6 +114,10 @@ export declare const GdAntUserSelectorCheckbox: import('../utils/install').SFCWi
         type: BooleanConstructor;
         default: boolean;
     };
+    selectionType: {
+        type: import('vue').PropType<"checkbox" | "radio">;
+        default: string;
+    };
 }>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     'delete-user': (id: string) => string;
     'change-checked': (checked: boolean, _info: import('.').DeptMember) => boolean;
@@ -130,6 +134,10 @@ export declare const GdAntUserSelectorCheckbox: import('../utils/install').SFCWi
         type: BooleanConstructor;
         default: boolean;
     };
+    selectionType: {
+        type: import('vue').PropType<"checkbox" | "radio">;
+        default: string;
+    };
 }>> & Readonly<{
     "onDelete-user"?: ((id: string) => any) | undefined;
     "onChange-checked"?: ((checked: boolean, _info: import('.').DeptMember) => any) | undefined;
@@ -137,6 +145,7 @@ export declare const GdAntUserSelectorCheckbox: import('../utils/install').SFCWi
     userInfo: import('.').DeptMember;
     isChecked: boolean;
     isDelete: boolean;
+    selectionType: "checkbox" | "radio";
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>>;
 export { ProUserSelector };
 export { ProUserSelectorCheckbox };

package/dist/types/components/pro-selector/src/components/user.d.ts

@@ -13,6 +13,10 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: BooleanConstructor;
         default: boolean;
     };
+    selectionType: {
+        type: PropType<"checkbox" | "radio">;
+        default: string;
+    };
 }>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     'delete-user': (id: string) => string;
     'change-checked': (checked: boolean, _info: DeptMember) => boolean;
@@ -29,6 +33,10 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: BooleanConstructor;
         default: boolean;
     };
+    selectionType: {
+        type: PropType<"checkbox" | "radio">;
+        default: string;
+    };
 }>> & Readonly<{
     "onDelete-user"?: ((id: string) => any) | undefined;
     "onChange-checked"?: ((checked: boolean, _info: DeptMember) => any) | undefined;
@@ -36,5 +44,6 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     userInfo: DeptMember;
     isChecked: boolean;
     isDelete: boolean;
+    selectionType: "checkbox" | "radio";
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/types/components/pro-selector/src/types.d.ts

@@ -5,6 +5,7 @@ export declare const selectUserContextKey: InjectionKey<{
     http?: any;
     isBuiltInRequest?: boolean;
     prefix?: string;
+    type?: 'checkbox' | 'radio';
 }>;
 export declare const UserSelectorProps: {
     readonly visible: {
@@ -99,3 +100,4 @@ export interface SelectUserType {
 export interface InstanceExpose {
     deleteCheckedUser: (id: string) => void;
 }
+export declare function resolveUserSelectorMaxCount(type: 'checkbox' | 'radio', maxCount: number): number;

package/dist/types/components/pro-selector/src/utils/orgTree.d.ts

@@ -11,7 +11,10 @@ export declare function debounce(func: (...args: any[]) => void, wait: number):
     (this: any, ...args: any[]): void;
     cancel(): void;
 };
-export declare function uniqueById(array: any): any;
+export declare function uniqueById<T extends {
+    id?: string;
+    userId?: string;
+}>(array: T[]): T[];
 /**
  * 初始化树形数据，需要递归，给deptType属性为department增加一个属性微 checkedUserIds，值为空数组
  * 然后返回修改完的数据

package/dist/types/components/pro-selector-group/src/compoents/select-box.vue.d.ts

@@ -5,11 +5,11 @@ type __VLS_PublicProps = {
 declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     "update:modelValue": (value: Options[]) => any;
 } & {
-    delete: (value: string) => any;
-    deleteAll: (values: string[]) => any;
+    delete: (value: Options) => any;
+    deleteAll: (values: Options[]) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
-    onDelete?: ((value: string) => any) | undefined;
+    onDelete?: ((value: Options) => any) | undefined;
     "onUpdate:modelValue"?: ((value: Options[]) => any) | undefined;
-    onDeleteAll?: ((values: string[]) => any) | undefined;
+    onDeleteAll?: ((values: Options[]) => any) | undefined;
 }>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
 export default _default;

package/dist/types/components/pro-selector-group/src/hooks/useApi.d.ts

@@ -1,4 +1,4 @@
-import { DeptMember } from '../../../../index';
+import { DeptMember } from '../../../pro-selector/src/types';
 export declare enum ApiUrl {
     GET_USER = "/security/dept/user/tree",
     GET_DEPT = "/security/dept/company/tree",
@@ -104,4 +104,9 @@ export declare function useApi(http: any, prefix?: string): {
         authority: string;
     }[]>;
     userLoading: import('vue').Ref<boolean, boolean>;
+    deptLoading: import('vue').Ref<boolean, boolean>;
+    roleLoading: import('vue').Ref<boolean, boolean>;
+    deptError: import('vue').Ref<string, string>;
+    userError: import('vue').Ref<string, string>;
+    roleError: import('vue').Ref<string, string>;
 };

package/dist/types/components/pro-selector-group/src/utils/index.d.ts

@@ -1,2 +1,10 @@
 import { DeptUserType } from '../hooks/useApi';
+import { Options } from '../types';
 export declare function formatDeptTree(deptTree: DeptUserType[]): DeptUserType[];
+/**
+ * 选择器组的每个 Tab 只维护自己类型的数据。这里把外部值规范为可安全编辑的草稿，
+ * 避免子 Tab 的异步回显把其它 Tab 的已选项覆盖掉。
+ */
+export declare function normalizeSelectorOptions(value: unknown): Options[];
+export declare function replaceSelectorOptionsForType(current: Options[], type: Options['type'], next: Options[]): Options[];
+export declare function removeSelectorOption(current: Options[], value: string, type?: Options['type']): Options[];