@dazhicheng/ui 1.5.164 → 1.5.165

package/dist/components/tt-form/src/form-render/array-register/FormArrayRegister.d.ts

@@ -0,0 +1,34 @@
+import { VNodeChild } from 'vue';
+import { Recordable } from '../../../../../../../utils/src';
+import { ArraySchemaContext, FormSchema } from '../../types';
+import { FieldEntry } from '../../types/forms';
+export declare const FormArrayRegister: import('vue').DefineComponent<{
+    disabled?: boolean | undefined;
+    hide?: boolean | undefined;
+    wrapperClass?: string | undefined;
+    arraySchema?: FormSchema[] | ((entry: FieldEntry<Recordable>, currentIndex: number, ctx: ArraySchemaContext) => FormSchema[]) | undefined;
+    dependencies?: import('./types').ArrayRegisterDependencies | undefined;
+    fieldName: string;
+    rules?: import('../../types').FormSchemaRuleType | undefined;
+    formItemClass?: (() => string) | string | undefined;
+    virtual?: boolean | undefined;
+}, () => VNodeChild, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{
+    disabled?: boolean | undefined;
+    hide?: boolean | undefined;
+    wrapperClass?: string | undefined;
+    arraySchema?: FormSchema[] | ((entry: FieldEntry<Recordable>, currentIndex: number, ctx: ArraySchemaContext) => FormSchema[]) | undefined;
+    dependencies?: import('./types').ArrayRegisterDependencies | undefined;
+    fieldName: string;
+    rules?: import('../../types').FormSchemaRuleType | undefined;
+    formItemClass?: (() => string) | string | undefined;
+    virtual?: boolean | undefined;
+}> & Readonly<{}>, {
+    readonly disabled: boolean | undefined;
+    readonly hide: boolean | undefined;
+    readonly wrapperClass: string;
+    readonly arraySchema: import('./props').ArraySchemaProp;
+    readonly dependencies: import('./types').ArrayRegisterDependencies | undefined;
+    readonly rules: import('../../types').FormSchemaRuleType | undefined;
+    readonly formItemClass: NonNullable<string | (() => string) | undefined>;
+    readonly virtual: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;

package/dist/components/tt-form/src/form-render/array-register/index.d.ts

@@ -0,0 +1,3 @@
+export { FormArrayRegister } from './FormArrayRegister';
+export { formArrayRegisterProps, type ArraySchemaProp } from './props';
+export type { ArrayRegisterProps } from './types';

package/dist/components/tt-form/src/form-render/array-register/props.d.ts

@@ -0,0 +1,44 @@
+import { PropType } from 'vue';
+import { Recordable } from '../../../../../../../utils/src';
+import { FieldEntry } from '../../types/forms';
+import { ArrayRegisterDependencies, ArraySchemaContext, FormSchema } from '../../types';
+export type ArraySchemaProp = FormSchema[] | ((entry: FieldEntry<Recordable>, currentIndex: number, ctx: ArraySchemaContext) => FormSchema[]);
+export declare const formArrayRegisterProps: {
+    readonly fieldName: {
+        readonly type: PropType<string>;
+        readonly required: true;
+    };
+    readonly hide: {
+        readonly type: PropType<boolean | undefined>;
+        readonly default: undefined;
+    };
+    readonly disabled: {
+        readonly type: PropType<boolean | undefined>;
+        readonly default: undefined;
+    };
+    readonly dependencies: {
+        readonly type: PropType<ArrayRegisterDependencies | undefined>;
+        readonly default: undefined;
+    };
+    readonly arraySchema: {
+        readonly type: PropType<ArraySchemaProp>;
+        readonly default: () => FormSchema[];
+    };
+    readonly formItemClass: {
+        readonly type: PropType<NonNullable<FormSchema["formItemClass"]>>;
+        readonly default: undefined;
+    };
+    readonly rules: {
+        readonly type: PropType<FormSchema["rules"]>;
+        readonly default: undefined;
+    };
+    readonly virtual: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /** useArraySchema 时：每一行数组项的外层容器 class（边框、间距等） */
+    readonly wrapperClass: {
+        readonly type: PropType<NonNullable<FormSchema["wrapperClass"]>>;
+        readonly default: undefined;
+    };
+};

package/dist/components/tt-form/src/form-render/array-register/types.d.ts

@@ -0,0 +1,15 @@
+import { ArrayRegisterDependencies, ArrayRegisterSchema } from '../../types';
+import { FieldEntry } from '../../types/forms';
+import { Recordable } from '../../../../../../../utils/src';
+export type ArrayRegisterProps = Pick<ArrayRegisterSchema, "fieldName" | "arraySchema" | "formItemClass" | "rules" | "wrapperClass" | "hide" | "disabled" | "dependencies"> & {
+    /**
+     * 虚拟滚动/懒渲染开关（来自渲染层，不属于 FormSchema）
+     */
+    virtual?: boolean;
+};
+export type { ArrayRegisterDependencies };
+export type RowRenderCtx = {
+    entry: FieldEntry<Recordable>;
+    index: number;
+    itemFieldName: string;
+};

package/dist/components/tt-form/src/form-render/array-register/utils.d.ts

@@ -0,0 +1,23 @@
+import { FormSchema } from '../../types';
+import { ArrayRegisterProps } from './types';
+/**
+ * 数组子项字段状态（规则/样式/禁用）解析结果。
+ */
+export type ArrayItemResolvedState = {
+    rules: FormSchema["rules"];
+    formItemClass: FormSchema["formItemClass"];
+    disabled: FormSchema["disabled"];
+};
+/**
+ * 对齐 FormField: shouldDisabled = isDisabled || disabled || computedProps.disabled
+ * 在 useArraySchema 场景下的通用禁用合并。
+ */
+export declare function getMergedDisabled(dynamicDisabled: boolean, ownDisabled?: boolean, outerDisabled?: boolean): boolean;
+/**
+ * 按“子项 > 外部动态 > 外部静态”优先级解析数组子项状态。
+ */
+export declare function resolveArrayItemState(schema: FormSchema, options: {
+    dynamicRules: FormSchema["rules"];
+    dynamicDisabled: boolean;
+    props: ArrayRegisterProps;
+}): ArrayItemResolvedState;

package/dist/components/tt-form/src/group-form/groupFormApi.d.ts

@@ -44,6 +44,8 @@ export declare class GroupFormApi extends FormApi {
     private _fieldToGroupKey;
     /** 子分组 key → 父分组 key 的映射，用于递归向上查找祖先分组是否被隐藏 */
     private _groupParentMap;
+    /** 分组 key 构建时的去重集合，用于检测重复 key */
+    private _groupKeySet;
     /** 是否已执行过 validate，用于控制导航栏错误同步是否需要重新校验未挂载字段 */
     private _hasValidated;
     /** VirtualGroupForm 组件实例引用，由 useGroupForm 的 h() 渲染时赋值 */
@@ -280,6 +282,10 @@ export declare class GroupFormApi extends FormApi {
      * @returns {string[]} 字段名列表
      */
     getGroupFieldNames(key: string, includeChildren?: boolean): string[];
+    /**
+     * @description 获取指定分组字段名（带防环保护），避免异常 schema 导致递归栈溢出
+     */
+    private _getGroupFieldNamesWithVisited;
     /**
      * @description 清空分组下的所有字段值
      * @param {string} key 分组 key

package/dist/components/tt-form/src/index.vue.d.ts

@@ -1,4 +1,4 @@
-import { ExtendedFormApi, TtFormProps, FormSchema } from './types';
+import { ExtendedFormApi, TtFormProps } from './types';
 import { nextTick } from 'vue';
 interface Props extends TtFormProps {
     formApi?: ExtendedFormApi;
@@ -28,7 +28,7 @@ declare function __VLS_template(): {
                 readonly fieldMappingTime?: import('./types').FieldMappingTime | undefined;
                 readonly form?: import('./types').FormActions | undefined;
                 readonly layout?: import('./types').FormLayout | undefined;
-                readonly schema?: (FormSchema<keyof import('./types').BaseFormComponentMap> | import('./types').FormSlotSchema)[] | undefined;
+                readonly schema?: (import('./types').FormSlotSchema | import('./types').FormSchemaItem<keyof import('./types').BaseFormComponentMap>)[] | undefined;
                 readonly showCollapseButton?: boolean | undefined;
                 readonly wrapperClass?: import('./types').WrapperClassType | undefined;
                 readonly globalCommonConfig?: import('./types').FormCommonConfig | undefined;
@@ -115,7 +115,7 @@ declare const __VLS_component: import('vue').DefineComponent<Props, {}, {}, {},
             readonly fieldMappingTime?: import('./types').FieldMappingTime | undefined;
             readonly form?: import('./types').FormActions | undefined;
             readonly layout?: import('./types').FormLayout | undefined;
-            readonly schema?: (FormSchema<keyof import('./types').BaseFormComponentMap> | import('./types').FormSlotSchema)[] | undefined;
+            readonly schema?: (import('./types').FormSlotSchema | import('./types').FormSchemaItem<keyof import('./types').BaseFormComponentMap>)[] | undefined;
             readonly showCollapseButton?: boolean | undefined;
             readonly wrapperClass?: import('./types').WrapperClassType | undefined;
             readonly globalCommonConfig?: import('./types').FormCommonConfig | undefined;

package/dist/components/tt-form/src/types.d.ts

@@ -1,6 +1,6 @@
 import { ButtonProps, CheckboxProps, CheckboxGroupProps, DatePickerProps, InputProps, InputNumberProps, RadioProps, RadioGroupProps, SelectProps, SelectV2Props, SwitchProps, TimePickerDefaultProps, UploadProps, CascaderProps, ColorPickerProps } from 'element-plus';
 import { FieldOptions, FormContext, GenericObject } from 'vee-validate';
-import { Component, HtmlHTMLAttributes, MaybeRefOrGetter, Ref, VNode } from 'vue';
+import { Component, HtmlHTMLAttributes, MaybeRefOrGetter, Ref, VNodeChild } from 'vue';
 import { ZodTypeAny } from 'zod';
 import { TtTextProps } from '../../tt-text';
 import { TtSelectProp } from '../../tt-select';
@@ -170,6 +170,13 @@ export interface FormItemDependencies {
      */
     immediate?: boolean;
 }
+/**
+ * `useArraySchema: true` 的数组字段依赖约束：
+ * - 允许用 `if/show` 控制可见性
+ * - 允许用 `rules/disabled` 动态控制规则与禁用
+ * - 允许声明 `triggerFields` 作为依赖触发源
+ */
+export type ArrayRegisterDependencies = Pick<FormItemDependencies, "if" | "show" | "rules" | "disabled" | "triggerFields">;
 type ComponentProps = ((value: Partial<Record<string, any>>, actions: FormActions) => MaybeComponentProps) | MaybeComponentProps;
 export interface FormCommonConfig {
     /**
@@ -254,6 +261,7 @@ export type FieldMappingTime = [
     (((value: any, fieldName: string) => any) | [string, string] | null | string)?
 ][];
 export type ArrayToStringFields = Array<[string[], string?] | string | string[]>;
+export type NoInfer<T> = [T][T extends any ? 0 : never];
 export interface FormSchema<T extends BaseFormComponentType = BaseFormComponentType> extends FormCommonConfig {
     /** 组件 */
     component: Component | T;
@@ -297,6 +305,21 @@ export interface FormSchema<T extends BaseFormComponentType = BaseFormComponentT
     /** 第三参数由 FormArrayRegister 注入；旧写法可忽略 */
     ctx: ArraySchemaContext) => FormSchema[]);
 }
+/**
+ * 普通字段：不走 `useArraySchema` 渲染链路。
+ */
+export type NonArrayFormSchema<T extends BaseFormComponentType = BaseFormComponentType> = Omit<FormSchema<T>, "useArraySchema" | "arraySchema"> & {
+    useArraySchema?: undefined;
+    arraySchema?: never;
+};
+export type ArrayRegisterSchema<T extends BaseFormComponentType = BaseFormComponentType> = Pick<FormSchema<T>, "component" | "fieldName" | "arraySchema" | "formItemClass" | "rules" | "wrapperClass" | "hide" | "disabled"> & {
+    dependencies?: ArrayRegisterDependencies;
+    useArraySchema: true;
+};
+/**
+ * 表单 schema 项：普通字段 or 数组字段（受 `useArraySchema` 判别约束）。
+ */
+export type FormSchemaItem<T extends BaseFormComponentType = BaseFormComponentType> = NonArrayFormSchema<T> | ArrayRegisterSchema<T>;
 /** 插槽 scope 参数，传递给渲染函数或具名插槽 */
 export interface FormSlotScope {
     /** 当前表单所有字段的值 */
@@ -314,20 +337,23 @@ export interface FormArraySlotScope extends FormSlotScope {
     arrayPath?: string;
     arrayIndex?: number;
     fieldName?: string;
+    /** 数组层统一禁用态（外层 disabled 或 dependencies.disabled） */
+    disabled?: boolean;
 }
+export type { ArrayRegisterProps } from './form-render/array-register/types';
 /**
  * 自定义插槽 schema，在表单字段之间插入任意自定义内容。
  * content 为字符串时作为具名插槽名，在模板中用 `<template #slotName="{ values, formActions }">` 编写；
  * content 为函数时直接返回 VNode。
  * @property {"slot"} type - 固定为 "slot"
- * @property {string | ((scope: FormSlotScope) => VNode)} content - 插槽名或渲染函数
+ * @property {string | ((scope: FormSlotScope) => VNodeChild)} content - 插槽名或渲染函数
  * @property {WrapperClassType} [wrapperClass] - 容器额外 class（如 col-span-full）
  */
 export interface FormSlotSchema {
     /** 类型标识 */
     type: "slot";
     /** 插槽名（字符串）或渲染函数 */
-    content: string | ((scope: FormSlotScope) => VNode);
+    content: string | ((scope: FormSlotScope) => VNodeChild);
     /** 容器额外 class */
     wrapperClass?: WrapperClassType;
     /**
@@ -390,7 +416,7 @@ export interface FormRenderProps<T extends BaseFormComponentType = BaseFormCompo
     /**
      * 表单定义，支持普通字段
      */
-    schema?: (FormSchema<T> | FormSlotSchema)[];
+    schema?: (FormSchemaItem<T> | FormSlotSchema)[];
     /**
      * 是否显示展开/折叠
      */

package/dist/components/tt-modal/src/typing.d.ts

@@ -140,7 +140,7 @@ export type ModalRenderState = {
      * @default { type: 'primary' }
      */
     okButtonProps?: Partial<ButtonProps> & {
-        disabledTip?: TipConfig[];
+        disabledTip?: TipConfig | TipConfig[];
     };
     /**
      * 取消按钮的样式