@dazhicheng/ui 1.5.96 → 1.5.98

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

@@ -7,4 +7,4 @@ export { default as FormMessage } from './FormMessage.vue';
 export { default as FormWarnMessage } from './FormWarnMessage.vue';
 export { default as RenderContent } from './RenderContent.vue';
 export { FORM_ITEM_INJECTION_KEY } from './injectionKeys';
-export { Form, Field as FormField, FieldArray as FormFieldArray } from 'vee-validate';
+export { Form, Field as FormField, FieldArray as FormFieldArray, useFieldArray } from 'vee-validate';

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

@@ -0,0 +1,53 @@
+import { PropType } from 'vue';
+import { FormSchema } from '../types';
+declare const FormArrayRegister: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    fieldName: {
+        type: PropType<string>;
+        required: true;
+    };
+    arraySchema: {
+        type: PropType<FormSchema[]>;
+        default: () => FormSchema[];
+    };
+    formItemClass: {
+        type: PropType<NonNullable<FormSchema["formItemClass"]>>;
+        default: undefined;
+    };
+    rules: {
+        type: PropType<FormSchema["rules"]>;
+        default: undefined;
+    };
+    virtual: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>, () => (import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    [key: string]: any;
+}>[] | undefined)[], {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    fieldName: {
+        type: PropType<string>;
+        required: true;
+    };
+    arraySchema: {
+        type: PropType<FormSchema[]>;
+        default: () => FormSchema[];
+    };
+    formItemClass: {
+        type: PropType<NonNullable<FormSchema["formItemClass"]>>;
+        default: undefined;
+    };
+    rules: {
+        type: PropType<FormSchema["rules"]>;
+        default: undefined;
+    };
+    virtual: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>> & Readonly<{}>, {
+    rules: import('../types').FormSchemaRuleType | undefined;
+    arraySchema: FormSchema<keyof import('../types').BaseFormComponentMap>[];
+    formItemClass: NonNullable<string | (() => string) | undefined>;
+    virtual: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export { FormArrayRegister };

package/dist/components/tt-form/src/{group-form/FieldRenderer.d.ts → form-render/FormFieldContact.d.ts}

@@ -1,73 +1,57 @@
 import { PropType, VNode } from 'vue';
 import { FormSchema } from '../types';
-/**
- * @description 根据 virtual 标志选择 LazyFormField 或 FormField 渲染单个字段，
- *   消除模板中重复的条件分支
- * @property {Record<string, unknown>} fieldConfig - mergeFieldConfig 合并后的完整字段配置
- * @property {FormSchema["rules"]} [rules] - 字段校验规则
- * @property {boolean} [virtual] - 是否启用虚拟化（LazyFormField）
- * @property {Element | null} [scrollElement] - 虚拟化滚动容器
- * @property {string} [rootMargin] - IntersectionObserver rootMargin
- * @property {number} [estimateFieldHeight] - 预估占位高度
- */
 export declare const FieldRenderer: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
-    /** mergeFieldConfig 合并后的完整字段配置 */
     fieldConfig: {
-        type: PropType<Record<string, unknown>>;
+        type: PropType<FormSchema & {
+            commonComponentProps: Record<string, any>;
+            formFieldProps: Record<string, any>;
+        }>;
         required: true;
     };
-    /** 字段校验规则 */
     rules: {
         type: PropType<FormSchema["rules"]>;
         default: undefined;
     };
-    /** 是否启用虚拟化 */
     virtual: {
         type: BooleanConstructor;
         default: boolean;
     };
-    /** 虚拟化滚动容器 */
     scrollElement: {
         type: PropType<Element | null>;
         default: null;
     };
-    /** IntersectionObserver rootMargin */
     rootMargin: {
         type: StringConstructor;
         default: string;
     };
-    /** 预估占位高度（px） */
     estimateFieldHeight: {
         type: NumberConstructor;
         default: number;
     };
 }>, () => VNode, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
-    /** mergeFieldConfig 合并后的完整字段配置 */
     fieldConfig: {
-        type: PropType<Record<string, unknown>>;
+        type: PropType<FormSchema & {
+            commonComponentProps: Record<string, any>;
+            formFieldProps: Record<string, any>;
+        }>;
         required: true;
     };
-    /** 字段校验规则 */
     rules: {
         type: PropType<FormSchema["rules"]>;
         default: undefined;
     };
-    /** 是否启用虚拟化 */
     virtual: {
         type: BooleanConstructor;
         default: boolean;
     };
-    /** 虚拟化滚动容器 */
     scrollElement: {
         type: PropType<Element | null>;
         default: null;
     };
-    /** IntersectionObserver rootMargin */
     rootMargin: {
         type: StringConstructor;
         default: string;
     };
-    /** 预估占位高度（px） */
     estimateFieldHeight: {
         type: NumberConstructor;
         default: number;

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

@@ -1,23 +1,9 @@
-import { FormCommonConfig, FormRenderProps, FormShape } from '../types';
+import { FormCommonConfig, FormRenderProps } from '../types';
 type Props = FormRenderProps;
 type __VLS_Props = Props & {
     globalCommonConfig?: FormCommonConfig;
 };
-declare function __VLS_template(): {
-    attrs: Partial<{}>;
-    slots: Partial<Record<string, (_: {
-        values: Record<string, any>;
-        formActions: import('../types').FormActions;
-    }) => any>> & Partial<Record<string, (_: any) => any>> & {
-        default?(_: {
-            shapes: FormShape[];
-        }): any;
-    };
-    refs: {
-        wrapperRef: HTMLDivElement;
-    };
-    rootEl: any;
-};
+declare function __VLS_template(): any;
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     submit: (event: any) => any;
@@ -29,9 +15,7 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}
     showCollapseButton: boolean;
     wrapperClass: import('../types').WrapperClassType;
     globalCommonConfig: FormCommonConfig;
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
-    wrapperRef: HTMLDivElement;
-}, any>;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, any, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
 type __VLS_WithTemplateSlots<T, S> = T & {

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

@@ -2,6 +2,7 @@ import { FormState, GenericObject, ResetFormOpts, ValidationOptions } from 'vee-
 import { ComponentPublicInstance } from 'vue';
 import { Recordable, StateHandler } from '../../../../../utils/src';
 import { FormActions, FormSchema, TtFormProps } from './types';
+import { FieldArrayContext } from './types/forms';
 import { Store } from './shared/store';
 export declare class FormApi {
     form: FormActions;
@@ -9,10 +10,15 @@ export declare class FormApi {
     state: null | TtFormProps;
     stateHandler: StateHandler;
     store: Store<TtFormProps>;
+    private readonly _arrayFields;
     /**
      * 组件实例映射
      */
     private componentRefMap;
+    /**
+     * @description 数组字段操作集合
+     */
+    private readonly _arrayAction;
     private latestSubmissionValues;
     private prevState;
     constructor(options?: TtFormProps);
@@ -130,4 +136,76 @@ export declare class FormApi {
      * 避免 `removeFields` / 删项后 `getValues` 仍带出旧字段。
      */
     private updateState;
+    /**
+     * @description 注册数组方法
+     * @param name 需要注册的数组字段
+     * @param actions 操作方法
+     */
+    registerArrayField(name: string, actions: FieldArrayContext): void;
+    unregisterArrayField(name: string): void;
+    /** @description 数组字段操作集合 */
+    get arrayAction(): {
+        /**
+         * @description 获取指定数组字段的操作上下文
+         * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
+         * @returns 只读
+         */
+        get: <TValue = unknown>(name: string) => Readonly<FieldArrayContext<TValue>> | undefined;
+        /**
+         * @description 在数组末尾新增一项
+         * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
+         * @param value 要追加的数组项值
+         */
+        push: <TValue = unknown>(name: string, value: TValue) => void | undefined;
+        /**
+         * @description 删除指定索引的项
+         * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
+         * @param idx 要删除的索引位置
+         */
+        remove: (name: string, idx: number) => void | undefined;
+        /**
+         * @description 整体替换数组值
+         * @template TValue 数组项类型
+         * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
+         * @param values 新的完整数组字段
+         */
+        replace: <TValue = unknown>(name: string, values: TValue[]) => void | undefined;
+        /**
+         * @description更新指定索引的项
+         * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
+         * @param idx 要更新的索引位置
+         * @param value 更新后的数组项值
+         */
+        update: <TValue = unknown>(name: string, idx: number, value: TValue) => void | undefined;
+        /**
+         * @description 在指定索引插入一项
+         * @template TValue 数组项类型
+         * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
+         * @param idx 插入位置索引
+         * @param value 要插入的数组项值
+         */
+        insert: <TValue = unknown>(name: string, idx: number, value: TValue) => void | undefined;
+        /**
+         * @description 在数组头部新增一项
+         * @template TValue 数组项类型
+         * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
+         * @param value 要插入到头部的数组项值
+         */
+        prepend: <TValue = unknown>(name: string, value: TValue) => void | undefined;
+        /**
+         * @description 将项从旧索引移动到新索引
+         * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
+         * @param oldIdx 原索引位置
+         * @param newIdx 新索引位置
+         */
+        move: (name: string, oldIdx: number, newIdx: number) => void | undefined;
+        /**
+         * @description 交换两个索引位置的项
+         * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
+         * @param indexA 第一个索引位置
+         * @param indexB 第二个索引位置
+         */
+        swap: (name: string, indexA: number, indexB: number) => void | undefined;
+    };
+    private _getArrayFieldActions;
 }

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

@@ -9,11 +9,11 @@ declare const __VLS_component: import('vue').DefineComponent<GroupSectionProps,
     commonConfig: import('../types').FormCommonConfig;
     compact: boolean;
     layout: string;
-    globalCommonConfig: import('../types').FormCommonConfig;
     virtual: boolean;
     rootMargin: string;
     estimateFieldHeight: number;
     scrollElement: Element | null;
+    globalCommonConfig: import('../types').FormCommonConfig;
     depth: number;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;

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

@@ -1,7 +1,9 @@
 import { LazyFormFieldProps } from './types';
 declare function __VLS_template(): {
     attrs: Partial<{}>;
-    slots: Partial<Record<{}, (_: any) => any>>;
+    slots: {
+        default?(_: any): any;
+    };
     refs: {
         containerRef: HTMLDivElement;
     };

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

@@ -144,6 +144,13 @@ export declare class GroupFormApi extends FormApi {
      * @returns {boolean} 是否属于隐藏分组
      */
     private _isFieldInHiddenGroup;
+    /**
+     * @description 判断错误键是否命中字段（支持数组/对象嵌套键）
+     * @param {string} errorKey - 错误键（如 a[0].b）
+     * @param {string} field - schema 字段（如 a）
+     * @returns {boolean}
+     */
+    private _matchFieldOrNested;
     /**
      * @description 按当前 store 中的 groupSchema（若无则用初始 schema）重置折叠状态：
      *   先清空已有 key，再按 `defaultCollapsed` 写入默认值。
@@ -263,5 +270,16 @@ export declare class GroupFormApi extends FormApi {
     /**
      * @description 卸载分组表单时恢复初始schema
      */
+    get arrayAction(): {
+        get: <TValue = unknown>(name: string) => Readonly<import('../types').FieldArrayContext<TValue>> | undefined;
+        push: <TValue = unknown>(name: string, value: TValue) => void;
+        remove: (name: string, idx: number) => void;
+        replace: <TValue = unknown>(name: string, values: TValue[]) => void;
+        update: <TValue = unknown>(name: string, idx: number, value: TValue) => void;
+        insert: <TValue = unknown>(name: string, idx: number, value: TValue) => void;
+        prepend: <TValue = unknown>(name: string, value: TValue) => void;
+        move: (name: string, oldIdx: number, newIdx: number) => void;
+        swap: (name: string, indexA: number, indexB: number) => void;
+    };
     unmount(): void;
 }

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

@@ -41,7 +41,7 @@ export interface FormRowSchema {
     /** 是否显示，支持布尔值或函数 (values, actions) => boolean | Promise<boolean>，默认 true */
     ifShow?: IfShowConditionType;
 }
-export type GroupFormSchema = FormGroupSchema | FormRowSchema | FormSlotSchema | FormSchema;
+export type GroupFormSchema = FormSchema | FormGroupSchema | FormRowSchema | FormSlotSchema;
 /**
  * 导航锚点基础配置：排除由内部维护的 `items` 与 `modelValue`，增加 `show` 控制是否渲染。
  * @property {boolean} [show] - 是否显示悬浮导航，默认 true
@@ -85,7 +85,9 @@ export type GroupFormState = TtFormProps & GroupFormExtraState;
 /** LazyFormField 组件 props */
 export interface LazyFormFieldProps {
     /** 传给 FormField 的完整 props（通过 v-bind 透传） */
-    fieldProps: Record<string, unknown>;
+    fieldProps: FormSchema & {
+        commonComponentProps: Record<string, any>;
+    };
     /** FormSchema.rules */
     rules?: FormSchema["rules"];
     /** FormSchema.formItemClass（用于外层 class） */

package/dist/components/tt-form/src/hooks/useArrayRegistry.d.ts

@@ -0,0 +1,2 @@
+import { FieldArrayContext } from '../types/forms';
+export declare function useArrayRegistry(name: string): readonly [(actions?: FieldArrayContext) => void, () => void];

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

@@ -5,9 +5,7 @@ interface Props extends TtFormProps {
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: Partial<Record<string, (_: any) => any>> & {
-        default?(_: {
-            shapes: import('./types').FormShape[];
-        }): any;
+        default?(_: any): any;
         'reset-before'?(_: {}): any;
         'submit-before'?(_: {}): any;
         'expand-before'?(_: {}): any;

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

@@ -93,7 +93,7 @@ export type FieldEntry<TValue = unknown> = {
     isLast: boolean;
 };
 export type FieldArrayContext<TValue = unknown> = {
-    fields: Ref<FieldEntry<TValue>[]>;
+    fields: FieldEntry<TValue>[];
     remove: (idx: number) => void;
     replace: (newArray: TValue[]) => void;
     update: (idx: number, value: TValue) => void;

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

@@ -6,6 +6,7 @@ import { TtTextProps } from '../../tt-text';
 import { TtSelectProp } from '../../tt-select';
 import { TtUploadProps } from '../../tt-upload';
 import { Props as TtApiComponentProps } from '../../tt-api-component';
+import { FieldEntry, FieldArrayContext } from './types/forms';
 import { FormApi } from './formApi';
 export type FormLayout = "horizontal" | "inline" | "vertical";
 export interface BaseFormComponentMap {
@@ -57,7 +58,20 @@ export type MaybeComponentPropKey = "options" | "placeholder" | "title" | keyof
 export type MaybeComponentProps = {
     [K in MaybeComponentPropKey]?: any;
 };
-export type FormActions = FormContext<GenericObject>;
+export interface FormArrayActions {
+    get: <TValue = unknown>(name: string) => Readonly<FieldArrayContext<TValue>> | undefined;
+    push: <TValue = unknown>(name: string, value: TValue) => void;
+    remove: (name: string, idx: number) => void;
+    replace: <TValue = unknown>(name: string, values: TValue[]) => void;
+    update: <TValue = unknown>(name: string, idx: number, value: TValue) => void;
+    insert: <TValue = unknown>(name: string, idx: number, value: TValue) => void;
+    prepend: <TValue = unknown>(name: string, value: TValue) => void;
+    move: (name: string, oldIdx: number, newIdx: number) => void;
+    swap: (name: string, indexA: number, indexB: number) => void;
+}
+export type FormActions = FormContext<GenericObject> & {
+    arrayAction?: FormArrayActions;
+};
 export type CustomRenderType = ((value: Partial<Record<string, any>>, actions: FormActions) => Component | string) | string;
 export type FormSchemaRuleType = "required" | "selectRequired" | null | (Record<never, never> & string) | ZodTypeAny;
 type FormItemDependenciesCondition<T = boolean | PromiseLike<boolean>> = (value: Partial<Record<string, any>>, actions: FormActions) => T;
@@ -220,6 +234,15 @@ export interface FormSchema<T extends BaseFormComponentType = BaseFormComponentT
     toolTip?: TtTextProps;
     /** 非label文字气泡设置 */
     toolTipText?: CustomRenderType;
+    /** 是否使用动态新增 */
+    useArraySchema?: true;
+    /**
+     * 动态新增表单项配置
+     * @description 支持直接传入配置数组 或 动态函数生成
+     * @example arraySchema: []
+     * @example arraySchema: (entry, index) => []
+     */
+    arraySchema?: FormSchema[] | ((entry: FieldEntry, currentIndex: number) => FormSchema[]);
 }
 /** 插槽 scope 参数，传递给渲染函数或具名插槽 */
 export interface FormSlotScope {
@@ -228,6 +251,15 @@ export interface FormSlotScope {
     /** 表单操作方法（validate / resetForm / getValues 等） */
     formActions: FormActions;
 }
+/**
+ * Extra slot props exposed for `useArraySchema: true` fields.
+ */
+export interface FormArraySlotScope extends FormSlotScope {
+    arrayEntry?: unknown;
+    arrayAction?: unknown;
+    arrayIndex?: number;
+    fieldName?: string;
+}
 /**
  * 自定义插槽 schema，在表单字段之间插入任意自定义内容。
  * content 为字符串时作为具名插槽名，在模板中用 `<template #slotName="{ values, formActions }">` 编写；