@flowgram.ai/form 0.1.0-alpha.3 → 0.1.0-alpha.30

package/dist/index.d.mts

@@ -1,11 +1,20 @@
-import * as React from 'react';
+import * as React$1 from 'react';
 import React__default from 'react';
 import * as _flowgram_ai_utils from '@flowgram.ai/utils';
 import { MaybePromise, Disposable, Emitter, DisposableCollection } from '@flowgram.ai/utils';
 import { ReactiveState } from '@flowgram.ai/reactive';
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 type Context = any;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare enum FeedbackLevel {
     Error = "error",
     Warning = "warning"
@@ -26,7 +35,7 @@ interface Feedback<FeedbackLevel> {
     /**
      * Feedback message
      */
-    message: string;
+    message: string | React.ReactNode;
 }
 type FieldError = Feedback<FeedbackLevel.Error>;
 type FieldWarning = Feedback<FeedbackLevel.Warning>;
@@ -58,6 +67,10 @@ declare enum ValidateTrigger {
 }
 type FormValidateReturn = (FieldError | FieldWarning)[];
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 declare class Path {
     protected _path: string[];
     constructor(path: string | string[]);
@@ -82,11 +95,15 @@ declare class Path {
     replaceParent(parent: Path, newParent: Path): Path;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare class Store<TValues = FieldValue> {
     protected _values: TValues;
     get values(): TValues;
     set values(v: TValues);
-    setInitialValues<TValue = FieldValue>(values: TValues): void;
     setIn<TValue = FieldValue>(path: Path, value: TValue): void;
     getIn<TValue = FieldValue>(path: Path): TValue;
     dispose(): void;
@@ -148,6 +165,7 @@ declare class FieldModel<TValue extends FieldValue = FieldValue> implements Disp
     updateState(s: Partial<FieldModel>): void;
     dispose(): void;
     onDispose(fn: () => void): void;
+    get disposed(): boolean;
 }
 
 declare class FieldArrayModel<TValue = FieldValue> extends FieldModel<Array<TValue>> {
@@ -173,13 +191,26 @@ declare class FieldArrayModel<TValue = FieldValue> extends FieldModel<Array<TVal
     map<T>(cb: (f: FieldModel, index: number, arr: FieldModel[]) => T): T[];
     append(value?: TValue): FieldModel<any>;
     /**
-     * 删除数组项，该操作会删除数组项的值并销毁数组项的Field模型
+     * Delete the element in given index and delete the corresponding FieldModel as well
      * @param index
      */
     delete(index: number): void;
     _splice(start: number, deleteCount?: number): void;
     swap(from: number, to: number): void;
     move(from: number, to: number): void;
+    protected insertAt(index: number, value: TValue): void;
+    /**
+     * get element path at given index
+     * @param index
+     * @protected
+     */
+    protected getPathAt(index: number): Path;
+    /**
+     * find all fields including child and grandchild fields at given index.
+     * @param index
+     * @protected
+     */
+    protected findAllFieldsAt(index: number): FieldModel<any>[];
 }
 
 declare class FormModel<TValues = any> implements Disposable {
@@ -233,13 +264,20 @@ declare class FormModel<TValues = any> implements Disposable {
     getValueIn<TValue>(name: FieldName): TValue;
     setValueIn<TValue>(name: FieldName, value: TValue): void;
     setInitValueIn<TValue = any>(name: FieldName, value: TValue): void;
+    validateDisabled: boolean;
     clearValueIn(name: FieldName): void;
-    validateIn(name: FieldName): Promise<string | FormErrorOptions | FormWarningOptions | undefined>;
+    validateIn(name: FieldName): Promise<(string | FormErrorOptions | FormWarningOptions | undefined)[] | undefined>;
+    protected getValidateOptions(): Record<string, Validate> | undefined;
     validate(): Promise<FormValidateReturn>;
     alignStateWithFieldMap(): void;
     dispose(): void;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 interface FormState {
     /**
      * If the form data is valid
@@ -282,7 +320,7 @@ interface FormOptions<TValues = any> {
     /**
      * Form data's validation rules. It's a key value map, where the key is a pattern of data's path (or field name), the value is a validate function.
      */
-    validate?: Record<string, Validate>;
+    validate?: Record<string, Validate> | ((value: TValues, ctx: Context) => Record<string, Validate>);
     /**
      * Custom context. It will be accessible via form instance or in validate function.
      */
@@ -312,6 +350,10 @@ interface Form$1<TValues = any> {
      * @param name path
      */
     setValueIn<TValue>(name: FieldName, value: TValue): void;
+    /**
+     * Trigger validate for the whole form.
+     */
+    validate: () => Promise<FormValidateReturn>;
 }
 interface FormRenderProps<TValues> {
     /**
@@ -330,7 +372,7 @@ interface CreateFormReturn<TValues> {
     control: FormControl<TValues>;
 }
 interface OnFormValuesChangeOptions {
-    action?: 'array-append' | 'array-splice';
+    action?: 'array-append' | 'array-splice' | 'array-swap';
     indexes?: number[];
 }
 interface OnFormValuesChangePayload {
@@ -351,6 +393,11 @@ interface OnFormValuesUpdatedPayload {
     options?: OnFormValuesChangeOptions;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 type FieldValue = any;
 type FieldName = string;
 type CustomElement = Partial<HTMLElement> & {
@@ -404,17 +451,23 @@ interface FieldArray$1<TFieldValue extends FieldValue = FieldValue> extends Fiel
      * Same as native Array.map, the first param of the callback function is the child field of this FieldArray.
      * @param cb callback function
      */
-    map: <T = any>(cb: (f: Field$1, index: number) => T) => T[];
+    map: <T = any>(cb: (f: Field$1<TFieldValue>, index: number) => T) => T[];
     /**
      * Append a value at the end of the array, it will create a new Field for this value as well.
      * @param value the value to append
      */
     append: (value: TFieldValue) => Field$1<TFieldValue>;
     /**
+     * @deprecated use remove instead
      * Delete the value and the related field at certain index of the array.
      * @param index the index of the element to delete
      */
     delete: (index: number) => void;
+    /**
+     * Delete the value and the related field at certain index of the array.
+     * @param index the index of the element to delete
+     */
+    remove: (index: number) => void;
     /**
      * Move an array element from one position to another.
      * @param from from position
@@ -505,11 +558,16 @@ interface FieldModelState extends Omit<FieldState, 'errors' | 'warnings'> {
     warnings?: Warnings;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 type FieldProps<TValue> = FieldOptions<TValue> & {
     /**
      * A React element or a render prop
      */
-    children?: ((props: FieldRenderProps<TValue>) => React.ReactElement) | React.ReactElement;
+    children?: ((props: FieldRenderProps<TValue>) => React$1.ReactElement) | React$1.ReactElement;
     /**
      * Dependencies of the current field. If a field name is given in deps, current field will re-render if the given field name data is updated
      */
@@ -518,7 +576,12 @@ type FieldProps<TValue> = FieldOptions<TValue> & {
 /**
  * HOC That declare a field, an Field model will be created it's rendered. Multiple Field rendering with a same name will link to the same model, which means they shared data、 status and methods
  */
-declare function Field<TValue>({ name, defaultValue, render, children, deps, }: FieldProps<TValue>): React.ReactElement;
+declare function Field<TValue>({ name, defaultValue, render, children, deps, }: FieldProps<TValue>): React$1.ReactElement;
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 
 type FormProps<TValues> = FormOptions & {
     /**
@@ -542,22 +605,37 @@ type FormProps<TValues> = FormOptions & {
  */
 declare function Form<TValues>(props: FormProps<TValues>): React__default.JSX.Element;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 /**
  * Get Form instance. It should be use in a child component of  <Form />
  */
 declare function useForm(): Form$1;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 /**
  * Listen to the field data change and refresh the React component.
  * @param name the field's uniq name (path)
  */
 declare function useWatch<TValue = FieldValue>(name: FieldName): TValue;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 type FieldArrayProps<TValue> = FieldArrayOptions<TValue> & {
     /**
      * A React element or a render prop
      */
-    children?: ((props: FieldArrayRenderProps<TValue>) => React.ReactElement) | React.ReactElement;
+    children?: ((props: FieldArrayRenderProps<TValue>) => React$1.ReactElement) | React$1.ReactElement;
     /**
      * Dependencies of the current field. If a field name is given in deps, current field will re-render if the given field name data is updated
      */
@@ -566,7 +644,12 @@ type FieldArrayProps<TValue> = FieldArrayOptions<TValue> & {
 /**
  * HOC That declare an array field, an FieldArray model will be created when it's rendered. Multiple FieldArray rendering with a same name will link to the same model, which means they shared data、 status and methods
  */
-declare function FieldArray<TValue extends FieldValue>({ name, defaultValue, deps, render, children, }: FieldArrayProps<TValue>): React.ReactElement;
+declare function FieldArray<TValue extends FieldValue>({ name, defaultValue, deps, render, children, }: FieldArrayProps<TValue>): React$1.ReactElement;
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 
 /**
  * @deprecated
@@ -580,6 +663,11 @@ declare function useFormState(control?: FormControl<any> | Form$1): FormState;
 declare function useFormErrors(control?: FormControl<any> | Form$1): Errors | undefined;
 declare function useFormWarnings(control?: FormControl<any> | Form$1): Warnings | undefined;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 /**
  * Get validate method of a field with given name. the returned function could possibly do nothing if the field is not found.
  * The reason could be that the field is not rendered yet or the name given is wrong.
@@ -587,17 +675,32 @@ declare function useFormWarnings(control?: FormControl<any> | Form$1): Warnings
  */
 declare function useFieldValidate(name?: FieldName): () => void;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 /**
  * Get the current Field. It should be used in a child component of <Field />, otherwise it throws an error
  */
 declare function useCurrentField<TFieldValue = FieldValue, TField extends Field$1<TFieldValue> | FieldArray$1<TFieldValue> = Field$1<TFieldValue>>(): Field$1<TFieldValue> | FieldArray$1<TFieldValue>;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 /**
  * Get the current field state. It should be used in a child component of <Field />, otherwise it throws an error
  */
 declare function useCurrentFieldState(): FieldState;
 
-type CreateFormOptions = FormOptions & {
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+type CreateFormOptions<T = any> = FormOptions<T> & {
     /**
      * 为 true 时，createForm 不会对form 初始化， 用户需要手动调用 control.init()
      * 该配置主要为了解决，用户需要去监听一些form 的初始化事件，那么他需要再配置完监听后再初始化。
@@ -605,8 +708,12 @@ type CreateFormOptions = FormOptions & {
      **/
     disableAutoInit?: boolean;
 };
-declare function createForm<TValues>(options?: CreateFormOptions): CreateFormReturn<TValues>;
+declare function createForm<TValues>(options?: CreateFormOptions<TValues>): CreateFormReturn<TValues>;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 declare namespace Glob {
     const DIVIDER = ".";
     const ALL = "*";
@@ -663,9 +770,19 @@ declare function toFieldState(modelState: FieldModelState): {
     readonly warnings: FieldWarning[] | undefined;
 };
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare function toFieldArray<TValue>(model: FieldArrayModel<TValue>): FieldArray$1<TValue>;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare function toForm<TValue>(model: FormModel): Form$1<TValue>;
 declare function toFormState(modelState: FormModelState): FormState;
 
-export { type Errors, Field, FieldArray, FieldArrayModel, type FieldArrayProps, type FieldArrayRenderProps, type FieldError, FieldModel, type FieldName, type FieldProps, type FieldRenderProps, type FieldState, type FieldValue, type FieldWarning, Form, type FormControl, FormModel, type FormProps, type FormRenderProps, type FormState, type FormValidateReturn, Glob, type Field$1 as IField, type FieldArray$1 as IFieldArray, type Form$1 as IForm, Path, type Validate, ValidateTrigger, type Warnings, createForm, toField, toFieldArray, toFieldState, toForm, toFormState, useCurrentField, useCurrentFieldState, useField, useFieldValidate, useForm, useFormErrors, useFormState, useFormWarnings, useWatch };
+export { type CreateFormOptions, type Errors, FeedbackLevel, Field, FieldArray, FieldArrayModel, type FieldArrayProps, type FieldArrayRenderProps, type FieldError, FieldModel, type FieldName, type FieldProps, type FieldRenderProps, type FieldState, type FieldValue, type FieldWarning, Form, type FormControl, FormModel, type FormProps, type FormRenderProps, type FormState, type FormValidateReturn, Glob, type Field$1 as IField, type FieldArray$1 as IFieldArray, type Form$1 as IForm, Path, type Validate, ValidateTrigger, type Warnings, createForm, toField, toFieldArray, toFieldState, toForm, toFormState, useCurrentField, useCurrentFieldState, useField, useFieldValidate, useForm, useFormErrors, useFormState, useFormWarnings, useWatch };

package/dist/index.d.ts

@@ -1,11 +1,20 @@
-import * as React from 'react';
+import * as React$1 from 'react';
 import React__default from 'react';
 import * as _flowgram_ai_utils from '@flowgram.ai/utils';
 import { MaybePromise, Disposable, Emitter, DisposableCollection } from '@flowgram.ai/utils';
 import { ReactiveState } from '@flowgram.ai/reactive';
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 type Context = any;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare enum FeedbackLevel {
     Error = "error",
     Warning = "warning"
@@ -26,7 +35,7 @@ interface Feedback<FeedbackLevel> {
     /**
      * Feedback message
      */
-    message: string;
+    message: string | React.ReactNode;
 }
 type FieldError = Feedback<FeedbackLevel.Error>;
 type FieldWarning = Feedback<FeedbackLevel.Warning>;
@@ -58,6 +67,10 @@ declare enum ValidateTrigger {
 }
 type FormValidateReturn = (FieldError | FieldWarning)[];
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 declare class Path {
     protected _path: string[];
     constructor(path: string | string[]);
@@ -82,11 +95,15 @@ declare class Path {
     replaceParent(parent: Path, newParent: Path): Path;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare class Store<TValues = FieldValue> {
     protected _values: TValues;
     get values(): TValues;
     set values(v: TValues);
-    setInitialValues<TValue = FieldValue>(values: TValues): void;
     setIn<TValue = FieldValue>(path: Path, value: TValue): void;
     getIn<TValue = FieldValue>(path: Path): TValue;
     dispose(): void;
@@ -148,6 +165,7 @@ declare class FieldModel<TValue extends FieldValue = FieldValue> implements Disp
     updateState(s: Partial<FieldModel>): void;
     dispose(): void;
     onDispose(fn: () => void): void;
+    get disposed(): boolean;
 }
 
 declare class FieldArrayModel<TValue = FieldValue> extends FieldModel<Array<TValue>> {
@@ -173,13 +191,26 @@ declare class FieldArrayModel<TValue = FieldValue> extends FieldModel<Array<TVal
     map<T>(cb: (f: FieldModel, index: number, arr: FieldModel[]) => T): T[];
     append(value?: TValue): FieldModel<any>;
     /**
-     * 删除数组项，该操作会删除数组项的值并销毁数组项的Field模型
+     * Delete the element in given index and delete the corresponding FieldModel as well
      * @param index
      */
     delete(index: number): void;
     _splice(start: number, deleteCount?: number): void;
     swap(from: number, to: number): void;
     move(from: number, to: number): void;
+    protected insertAt(index: number, value: TValue): void;
+    /**
+     * get element path at given index
+     * @param index
+     * @protected
+     */
+    protected getPathAt(index: number): Path;
+    /**
+     * find all fields including child and grandchild fields at given index.
+     * @param index
+     * @protected
+     */
+    protected findAllFieldsAt(index: number): FieldModel<any>[];
 }
 
 declare class FormModel<TValues = any> implements Disposable {
@@ -233,13 +264,20 @@ declare class FormModel<TValues = any> implements Disposable {
     getValueIn<TValue>(name: FieldName): TValue;
     setValueIn<TValue>(name: FieldName, value: TValue): void;
     setInitValueIn<TValue = any>(name: FieldName, value: TValue): void;
+    validateDisabled: boolean;
     clearValueIn(name: FieldName): void;
-    validateIn(name: FieldName): Promise<string | FormErrorOptions | FormWarningOptions | undefined>;
+    validateIn(name: FieldName): Promise<(string | FormErrorOptions | FormWarningOptions | undefined)[] | undefined>;
+    protected getValidateOptions(): Record<string, Validate> | undefined;
     validate(): Promise<FormValidateReturn>;
     alignStateWithFieldMap(): void;
     dispose(): void;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 interface FormState {
     /**
      * If the form data is valid
@@ -282,7 +320,7 @@ interface FormOptions<TValues = any> {
     /**
      * Form data's validation rules. It's a key value map, where the key is a pattern of data's path (or field name), the value is a validate function.
      */
-    validate?: Record<string, Validate>;
+    validate?: Record<string, Validate> | ((value: TValues, ctx: Context) => Record<string, Validate>);
     /**
      * Custom context. It will be accessible via form instance or in validate function.
      */
@@ -312,6 +350,10 @@ interface Form$1<TValues = any> {
      * @param name path
      */
     setValueIn<TValue>(name: FieldName, value: TValue): void;
+    /**
+     * Trigger validate for the whole form.
+     */
+    validate: () => Promise<FormValidateReturn>;
 }
 interface FormRenderProps<TValues> {
     /**
@@ -330,7 +372,7 @@ interface CreateFormReturn<TValues> {
     control: FormControl<TValues>;
 }
 interface OnFormValuesChangeOptions {
-    action?: 'array-append' | 'array-splice';
+    action?: 'array-append' | 'array-splice' | 'array-swap';
     indexes?: number[];
 }
 interface OnFormValuesChangePayload {
@@ -351,6 +393,11 @@ interface OnFormValuesUpdatedPayload {
     options?: OnFormValuesChangeOptions;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 type FieldValue = any;
 type FieldName = string;
 type CustomElement = Partial<HTMLElement> & {
@@ -404,17 +451,23 @@ interface FieldArray$1<TFieldValue extends FieldValue = FieldValue> extends Fiel
      * Same as native Array.map, the first param of the callback function is the child field of this FieldArray.
      * @param cb callback function
      */
-    map: <T = any>(cb: (f: Field$1, index: number) => T) => T[];
+    map: <T = any>(cb: (f: Field$1<TFieldValue>, index: number) => T) => T[];
     /**
      * Append a value at the end of the array, it will create a new Field for this value as well.
      * @param value the value to append
      */
     append: (value: TFieldValue) => Field$1<TFieldValue>;
     /**
+     * @deprecated use remove instead
      * Delete the value and the related field at certain index of the array.
      * @param index the index of the element to delete
      */
     delete: (index: number) => void;
+    /**
+     * Delete the value and the related field at certain index of the array.
+     * @param index the index of the element to delete
+     */
+    remove: (index: number) => void;
     /**
      * Move an array element from one position to another.
      * @param from from position
@@ -505,11 +558,16 @@ interface FieldModelState extends Omit<FieldState, 'errors' | 'warnings'> {
     warnings?: Warnings;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 type FieldProps<TValue> = FieldOptions<TValue> & {
     /**
      * A React element or a render prop
      */
-    children?: ((props: FieldRenderProps<TValue>) => React.ReactElement) | React.ReactElement;
+    children?: ((props: FieldRenderProps<TValue>) => React$1.ReactElement) | React$1.ReactElement;
     /**
      * Dependencies of the current field. If a field name is given in deps, current field will re-render if the given field name data is updated
      */
@@ -518,7 +576,12 @@ type FieldProps<TValue> = FieldOptions<TValue> & {
 /**
  * HOC That declare a field, an Field model will be created it's rendered. Multiple Field rendering with a same name will link to the same model, which means they shared data、 status and methods
  */
-declare function Field<TValue>({ name, defaultValue, render, children, deps, }: FieldProps<TValue>): React.ReactElement;
+declare function Field<TValue>({ name, defaultValue, render, children, deps, }: FieldProps<TValue>): React$1.ReactElement;
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 
 type FormProps<TValues> = FormOptions & {
     /**
@@ -542,22 +605,37 @@ type FormProps<TValues> = FormOptions & {
  */
 declare function Form<TValues>(props: FormProps<TValues>): React__default.JSX.Element;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 /**
  * Get Form instance. It should be use in a child component of  <Form />
  */
 declare function useForm(): Form$1;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 /**
  * Listen to the field data change and refresh the React component.
  * @param name the field's uniq name (path)
  */
 declare function useWatch<TValue = FieldValue>(name: FieldName): TValue;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 type FieldArrayProps<TValue> = FieldArrayOptions<TValue> & {
     /**
      * A React element or a render prop
      */
-    children?: ((props: FieldArrayRenderProps<TValue>) => React.ReactElement) | React.ReactElement;
+    children?: ((props: FieldArrayRenderProps<TValue>) => React$1.ReactElement) | React$1.ReactElement;
     /**
      * Dependencies of the current field. If a field name is given in deps, current field will re-render if the given field name data is updated
      */
@@ -566,7 +644,12 @@ type FieldArrayProps<TValue> = FieldArrayOptions<TValue> & {
 /**
  * HOC That declare an array field, an FieldArray model will be created when it's rendered. Multiple FieldArray rendering with a same name will link to the same model, which means they shared data、 status and methods
  */
-declare function FieldArray<TValue extends FieldValue>({ name, defaultValue, deps, render, children, }: FieldArrayProps<TValue>): React.ReactElement;
+declare function FieldArray<TValue extends FieldValue>({ name, defaultValue, deps, render, children, }: FieldArrayProps<TValue>): React$1.ReactElement;
+
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 
 /**
  * @deprecated
@@ -580,6 +663,11 @@ declare function useFormState(control?: FormControl<any> | Form$1): FormState;
 declare function useFormErrors(control?: FormControl<any> | Form$1): Errors | undefined;
 declare function useFormWarnings(control?: FormControl<any> | Form$1): Warnings | undefined;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 /**
  * Get validate method of a field with given name. the returned function could possibly do nothing if the field is not found.
  * The reason could be that the field is not rendered yet or the name given is wrong.
@@ -587,17 +675,32 @@ declare function useFormWarnings(control?: FormControl<any> | Form$1): Warnings
  */
 declare function useFieldValidate(name?: FieldName): () => void;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 /**
  * Get the current Field. It should be used in a child component of <Field />, otherwise it throws an error
  */
 declare function useCurrentField<TFieldValue = FieldValue, TField extends Field$1<TFieldValue> | FieldArray$1<TFieldValue> = Field$1<TFieldValue>>(): Field$1<TFieldValue> | FieldArray$1<TFieldValue>;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 /**
  * Get the current field state. It should be used in a child component of <Field />, otherwise it throws an error
  */
 declare function useCurrentFieldState(): FieldState;
 
-type CreateFormOptions = FormOptions & {
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+type CreateFormOptions<T = any> = FormOptions<T> & {
     /**
      * 为 true 时，createForm 不会对form 初始化， 用户需要手动调用 control.init()
      * 该配置主要为了解决，用户需要去监听一些form 的初始化事件，那么他需要再配置完监听后再初始化。
@@ -605,8 +708,12 @@ type CreateFormOptions = FormOptions & {
      **/
     disableAutoInit?: boolean;
 };
-declare function createForm<TValues>(options?: CreateFormOptions): CreateFormReturn<TValues>;
+declare function createForm<TValues>(options?: CreateFormOptions<TValues>): CreateFormReturn<TValues>;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 declare namespace Glob {
     const DIVIDER = ".";
     const ALL = "*";
@@ -663,9 +770,19 @@ declare function toFieldState(modelState: FieldModelState): {
     readonly warnings: FieldWarning[] | undefined;
 };
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare function toFieldArray<TValue>(model: FieldArrayModel<TValue>): FieldArray$1<TValue>;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare function toForm<TValue>(model: FormModel): Form$1<TValue>;
 declare function toFormState(modelState: FormModelState): FormState;
 
-export { type Errors, Field, FieldArray, FieldArrayModel, type FieldArrayProps, type FieldArrayRenderProps, type FieldError, FieldModel, type FieldName, type FieldProps, type FieldRenderProps, type FieldState, type FieldValue, type FieldWarning, Form, type FormControl, FormModel, type FormProps, type FormRenderProps, type FormState, type FormValidateReturn, Glob, type Field$1 as IField, type FieldArray$1 as IFieldArray, type Form$1 as IForm, Path, type Validate, ValidateTrigger, type Warnings, createForm, toField, toFieldArray, toFieldState, toForm, toFormState, useCurrentField, useCurrentFieldState, useField, useFieldValidate, useForm, useFormErrors, useFormState, useFormWarnings, useWatch };
+export { type CreateFormOptions, type Errors, FeedbackLevel, Field, FieldArray, FieldArrayModel, type FieldArrayProps, type FieldArrayRenderProps, type FieldError, FieldModel, type FieldName, type FieldProps, type FieldRenderProps, type FieldState, type FieldValue, type FieldWarning, Form, type FormControl, FormModel, type FormProps, type FormRenderProps, type FormState, type FormValidateReturn, Glob, type Field$1 as IField, type FieldArray$1 as IFieldArray, type Form$1 as IForm, Path, type Validate, ValidateTrigger, type Warnings, createForm, toField, toFieldArray, toFieldState, toForm, toFormState, useCurrentField, useCurrentFieldState, useField, useFieldValidate, useForm, useFormErrors, useFormState, useFormWarnings, useWatch };