@dazhicheng/ui 1.5.141 → 1.5.142

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

@@ -1,55 +1,56 @@
 import { PropType } from 'vue';
+import { Recordable } from '../../../../../../utils/src';
 import { FieldEntry } from '../types/forms';
 import { FormSchema } from '../types';
-import { Recordable } from '../../../../../../utils/src';
+/** 数组字段：整表赋值后按 `formApi.arrayFieldSyncKey` remount 内层官方 `useFieldArray` */
 declare const FormArrayRegister: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
-    fieldName: {
-        type: PropType<string>;
-        required: true;
+    readonly fieldName: {
+        readonly type: PropType<string>;
+        readonly required: true;
     };
-    arraySchema: {
-        type: PropType<FormSchema[] | ((entry: FieldEntry<Recordable>, currentIndex: number) => FormSchema[])>;
-        default: () => FormSchema[];
+    readonly arraySchema: {
+        readonly type: PropType<FormSchema[] | ((entry: FieldEntry<Recordable>, currentIndex: number) => FormSchema[])>;
+        readonly default: () => FormSchema[];
     };
-    formItemClass: {
-        type: PropType<NonNullable<FormSchema["formItemClass"]>>;
-        default: undefined;
+    readonly formItemClass: {
+        readonly type: PropType<NonNullable<FormSchema["formItemClass"]>>;
+        readonly default: undefined;
     };
-    rules: {
-        type: PropType<FormSchema["rules"]>;
-        default: undefined;
+    readonly rules: {
+        readonly type: PropType<FormSchema["rules"]>;
+        readonly default: undefined;
     };
-    virtual: {
-        type: BooleanConstructor;
-        default: boolean;
+    readonly virtual: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
     };
-}>, () => (import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+}>, () => 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;
+}>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    readonly fieldName: {
+        readonly type: PropType<string>;
+        readonly required: true;
     };
-    arraySchema: {
-        type: PropType<FormSchema[] | ((entry: FieldEntry<Recordable>, currentIndex: number) => FormSchema[])>;
-        default: () => FormSchema[];
+    readonly arraySchema: {
+        readonly type: PropType<FormSchema[] | ((entry: FieldEntry<Recordable>, currentIndex: number) => FormSchema[])>;
+        readonly default: () => FormSchema[];
     };
-    formItemClass: {
-        type: PropType<NonNullable<FormSchema["formItemClass"]>>;
-        default: undefined;
+    readonly formItemClass: {
+        readonly type: PropType<NonNullable<FormSchema["formItemClass"]>>;
+        readonly default: undefined;
     };
-    rules: {
-        type: PropType<FormSchema["rules"]>;
-        default: undefined;
+    readonly rules: {
+        readonly type: PropType<FormSchema["rules"]>;
+        readonly default: undefined;
     };
-    virtual: {
-        type: BooleanConstructor;
-        default: boolean;
+    readonly virtual: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
     };
 }>> & Readonly<{}>, {
-    rules: import('../types').FormSchemaRuleType | undefined;
-    arraySchema: FormSchema<keyof import('../types').BaseFormComponentMap>[] | ((entry: FieldEntry<Recordable>, currentIndex: number) => FormSchema[]);
-    formItemClass: NonNullable<string | (() => string) | undefined>;
-    virtual: boolean;
+    readonly rules: import('../types').FormSchemaRuleType | undefined;
+    readonly arraySchema: FormSchema<keyof import('../types').BaseFormComponentMap>[] | ((entry: FieldEntry<Recordable>, currentIndex: number) => FormSchema[]);
+    readonly formItemClass: NonNullable<string | (() => string) | undefined>;
+    readonly virtual: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 export { FormArrayRegister };

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

@@ -11,6 +11,10 @@ export declare class FormApi {
     stateHandler: StateHandler;
     store: Store<TtFormProps>;
     private readonly _arrayFields;
+    /**
+     * 整表赋值后递增，用于 remount `FormArrayRegister` 内官方 `useFieldArray` 实例，避免与外部 `setValues` 循环更新。
+     */
+    readonly arrayFieldSyncKey: import('vue').Ref<number, number>;
     /**
      * 组件实例映射
      */
@@ -87,6 +91,12 @@ export declare class FormApi {
      * @param shouldValidate
      */
     setValues(fields: Record<string, any>, filterFields?: boolean, shouldValidate?: boolean): Promise<void>;
+    /** 声明了 `useArraySchema` 的顶层 fieldName */
+    protected getArraySchemaFieldNames(): string[];
+    protected bumpArrayFieldSyncKey(): void;
+    /** 整表写入后：remount 数组块 + 对已注册的数组字段调用官方 `replace` */
+    protected afterArrayValuesPatch(source?: Record<string, any>): Promise<void>;
+    protected syncRegisteredArrayFields(source?: Record<string, any>): Promise<void>;
     submitForm(e?: Event): Promise<Recordable<any>>;
     unmount(): void;
     updateSchema(schema: Partial<FormSchema>[]): void;

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

@@ -431,6 +431,8 @@ export interface TtFormProps<T extends BaseFormComponentType = BaseFormComponent
     submitOnEnter?: boolean;
 }
 export type ExtendedFormApi = Omit<FormApi, "getValues" | "validate" | "setState"> & {
+    /** 数组字段整表同步版本号，供 `FormArrayRegister` remount 官方 `useFieldArray` */
+    arrayFieldSyncKey: FormApi["arrayFieldSyncKey"];
     /**
      * @description 设置表单状态，支持扩展字段（如 navAnchorProps、groupSchema 等）
      * @param {Partial<TtFormProps & Record<string, any>> | ((prev: TtFormProps & Record<string, any>) => Partial<TtFormProps & Record<string, any>>)} stateOrFn - 新状态或更新函数