@sheinx/base 3.8.0-beta.2 → 3.8.0-beta.21

package/esm/form/form-field.js

@@ -1,5 +1,5 @@
 import React, { useContext, useMemo } from 'react';
-import { useFormConfig, useFormControl, usePersistFn, util, FieldsetContext } from '@sheinx/hooks';
+import { useFormConfig, useFormControl, usePersistFn, util, FieldsetContext, FormItemContext, useFormSchema } from '@sheinx/hooks';
 import { FormFieldContext } from "./form-field-context";
 import { jsx as _jsx } from "react/jsx-runtime";
 var FormField = function FormField(props) {
@@ -18,7 +18,8 @@ var FormField = function FormField(props) {
     rules: props.rules,
     onError: props.onError,
     bind: props.bind,
-    getValidateProps: getValidateProps
+    getValidateProps: getValidateProps,
+    clearToUndefined: props.clearToUndefined
   });
   var handleChange = usePersistFn(function (value) {
     for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
@@ -73,9 +74,31 @@ var FormField = function FormField(props) {
   } else {
     finalChildren = children;
   }
+  var formSchema = useFormSchema();
+  var _useContext3 = useContext(FormItemContext),
+    label = _useContext3.label;
+  var finalFieldId = formFieldId || fieldId || fieldsetPathId;
+
+  // 只有当 formConfig.formName 存在时才运行 schema 逻辑
+  if (formConfig.formName && formSchema && finalFieldId) {
+    var schemaFields = finalFieldId.split(separator) || [];
+    var schemaMeta = formSchema.buildSchemaFromComponent({
+      componentElement: finalChildren,
+      rules: props.rules,
+      label: label,
+      finalFieldId: finalFieldId,
+      separator: separator
+    });
+    schemaFields.forEach(function (field) {
+      formSchema.updateSchema({
+        path: util.getOriginField(field, formConfig.formName),
+        meta: schemaMeta
+      });
+    });
+  }
   return /*#__PURE__*/_jsx(FormFieldContext.Provider, {
     value: {
-      fieldId: formFieldId || fieldId || fieldsetPathId,
+      fieldId: finalFieldId,
       separator: separator
     },
     children: finalChildren

package/esm/form/form-field.type.d.ts

@@ -12,38 +12,29 @@ export interface FieldControlProps<T> {
 export type FormFieldChildrenFunc<T> = (props: FieldControlProps<T>) => React.ReactElement;
 export interface FormFieldProps<T> extends Partial<BaseFormControlProps<T>> {
     /**
-     * @en Form field, used with Form
-     * @cn 表单字段, 配合 Form 使用
+     * @en The field name that binds to form data. Supports nested object access with dot notation (e.g., 'user.name') or array syntax (e.g. ['user', 'name']). Used to identify and manage specific form field data
+     * @cn 绑定到表单数据的字段名称。支持点表示法访问嵌套对象（如 'user.name'）或数组语法（如 ['user', 'name']）。用于标识和管理特定的表单字段数据
      */
     name: string | string[];
     /**
-     * @en If set to true, the form will not automatically delete the data after the component is uninstalled
-     * @cn 设置为 true 组件卸载后表单不自动删除数据
+     * @en Controls whether to preserve field data when component unmounts. Set to true to keep data in form state after component removal. Useful for dynamic forms, conditional fields, or when temporarily hiding/showing fields while preserving their values
+     * @cn 控制组件卸载时是否保留字段数据。设置为 true 时，组件移除后在表单状态中保留数据。适用于动态表单、条件字段，或需要临时隐藏/显示字段但保留其值的场景
      */
     reserveAble?: boolean;
     /**
-     * @en default Value
-     * @cn 默认值
+     * @en The initial value for the field when form first renders. Only takes effect during component initialization and won't update if changed later. Commonly used to set initial state for new records or provide fallback values
+     * @cn 表单首次渲染时字段的初始值。仅在组件初始化时生效，后续更改不会更新。常用于为新记录设置初始状态或提供默认值
      */
     defaultValue?: T;
     /**
-     * @en Validation rules, see [Rule](/components/rule) usage for details
-     * @cn 校验规则 详见 [Rule](/components/rule)
+     * @en Array of validation rules to validate field value. Each rule can be a function, regular expression, or rule object. Supports built-in rules (required, email, etc.) and custom validation logic. See [Rule](/components/rule) for detailed configuration
+     * @cn 用于校验字段值的规则数组。每个规则可以是函数、正则表达式或规则对象。支持内置规则（必填、邮箱等）和自定义校验逻辑。详细配置参见 [Rule](/components/rule)
      * @override RuleItem[]
      */
     rules?: FormItemRule<any>;
     /**
-     * @en React components that support value and onChange or function. The function object attribute is as follows:
-     * value: The value obtained from the parent Form or Form.Block by name.
-     * error: the error information of data validation. type is Error.
-     * onChange: The callback when the value is changing.
-     * disabled: inherit the disabled attribute of Form.
-     *
-     * @cn 支持 value 和 onChange 的 React 组件，或者函数，函数object属性如下
-     * value: 根据 name 从上级 Form 或 Form.Block 获取的值
-     * error：数据校验错误信息，类型为 Error
-     * onChange: 值改变回调函数
-     * disabled: 继承 Form 的 disabled 属性
+     * @en The form control to render. Can be either a React element with value/onChange props or a render function. When using render function, it receives an object with: value (current field value), onChange (value change handler), error (validation error), disabled (inherited from form), status (field status). Perfect for custom components, third-party controls, or complex input scenarios
+     * @cn 要渲染的表单控件。可以是具有 value/onChange 属性的 React 元素，或渲染函数。使用渲染函数时，会接收包含以下属性的对象：value（当前字段值）、onChange（值变更处理器）、error（校验错误）、disabled（继承自表单）、status（字段状态）。适用于自定义组件、第三方控件或复杂输入场景
      *
      * @override ((opts: object) => ReactNode) | ReactNode
      */
@@ -57,8 +48,8 @@ export interface FormFieldProps<T> extends Partial<BaseFormControlProps<T>> {
      */
     onChange?: (value: T, ...rest: any) => void;
     /**
-     * @en rules validation callback
-     * @cn rules 校验回调
+     * @en Callback function triggered when validation completes. Receives validation error (if any) as parameter. Useful for custom error handling, logging validation results, or triggering side effects based on validation state
+     * @cn 校验完成时触发的回调函数。接收校验错误（如果有）作为参数。适用于自定义错误处理、记录校验结果，或根据校验状态触发副作用
      */
     onError?: (error?: Error) => void;
     /**

package/esm/form/form-field.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-field.type.d.ts","sourceRoot":"","sources":["form-field.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE/E,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;CACvC;AAED,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,YAAY,CAAC;AAE3F,MAAM,WAAW,cAAc,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACzE;;;OAGG;IACH,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;IAC1B;;;;;;;;;;;;;;OAcG;IACH,QAAQ,EACJ,KAAK,CAAC,YAAY,CAAC;QAAE,KAAK,CAAC,EAAE,GAAG,CAAC;QAAC,QAAQ,CAAC,EAAE,GAAG,CAAC;QAAC,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC,GACxE,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;IAC5C;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IAClC;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,UAAU,CAAC;CACrC"}
+{"version":3,"file":"form-field.type.d.ts","sourceRoot":"","sources":["form-field.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE/E,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;CACvC;AAED,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,YAAY,CAAC;AAE3F,MAAM,WAAW,cAAc,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACzE;;;OAGG;IACH,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;IAC1B;;;;;OAKG;IACH,QAAQ,EACJ,KAAK,CAAC,YAAY,CAAC;QAAE,KAAK,CAAC,EAAE,GAAG,CAAC;QAAC,QAAQ,CAAC,EAAE,GAAG,CAAC;QAAC,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC,GACxE,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;IAC5C;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IAClC;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,UAAU,CAAC;CACrC"}

package/esm/form/form-fieldset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-fieldset.d.ts","sourceRoot":"","sources":["form-fieldset.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGzD,QAAA,MAAM,YAAY,yCA6FjB,CAAC;AAEF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"form-fieldset.d.ts","sourceRoot":"","sources":["form-fieldset.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGzD,QAAA,MAAM,YAAY,yCAuGjB,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/esm/form/form-fieldset.js

@@ -87,8 +87,13 @@ var FormFieldSet = function FormFieldSet(props) {
         },
         onInsert: function onInsert(val) {
           var oldValue = formFunc === null || formFunc === void 0 ? void 0 : formFunc.getValue(name);
+          var insertValue = val;
+          var valueTemplate = oldValue[i];
+          if (insertValue === undefined) {
+            insertValue = util.clearValue(util.deepClone(valueTemplate));
+          }
           var newValue = produce(oldValue, function (draft) {
-            draft.splice(i, 0, val);
+            draft.splice(i, 0, insertValue);
           });
           _onChange(newValue);
           // context.ids.splice(i, 0, util.generateUUID());
@@ -96,8 +101,13 @@ var FormFieldSet = function FormFieldSet(props) {
         },
         onAppend: function onAppend(val) {
           var oldValue = formFunc === null || formFunc === void 0 ? void 0 : formFunc.getValue(name);
+          var insertValue = val;
+          var valueTemplate = oldValue[i];
+          if (insertValue === undefined) {
+            insertValue = util.clearValue(util.deepClone(valueTemplate));
+          }
           var newValue = produce(oldValue, function (draft) {
-            draft.splice(i + 1, 0, val);
+            draft.splice(i + 1, 0, insertValue);
           });
           _onChange(newValue);
           // context.ids.splice(i + 1, 0, util.generateUUID());

package/esm/form/form-fieldset.type.d.ts

@@ -17,37 +17,49 @@ export interface FormFieldSetChildrenFunc<ValueItem = any> {
 }
 export interface FormFieldSetProps<T> extends Partial<BaseFormFieldSetProps<T>> {
     /**
-     * @en The name that accesses data from from
-     * @cn 从 Form 中存取数据的名称
+     * @en The field name that binds to form data for the fieldset. Used to identify and manage a group of related form fields or array data. Supports nested object access with dot notation (e.g., 'users', 'company.employees')
+     * @cn 绑定到表单数据的字段集名称。用于标识和管理一组相关的表单字段或数组数据。支持点表示法访问嵌套对象（如 'users'、'company.employees'）
      */
     name: string;
     /**
-     * @en When children type is not function, handle a set data type of object
-     * When children type is function, handle a group of data type of array. options property:
-     * list: all data of name.
-     * value: a single piece of data for the value obtained by name.
-     * onChange: a callback when the value is changing.
-     * onRemove: a callback when a child component is removed.
-     * index: the current index.
-     * onInsert: Insert a piece of data before the current item.
-     * onAppend: Insert a piece of data after the current item.
-     *
-     * @cn children 不为 function，用来处理 object 类型数据，children 内的 name 会拼接 FieldSet name，如 FieldSet name 为 'a', children 元素name 为 b，children 实际处理的数据为 a.b;
-     * children 为 function 时，用来处理数组数据。options 属性为
-     * list: name 下的全部数据。
-     * value: 根据name获取的值的单条数据。
-     * onChange: 子组件数据改变回调。
-     * onRemove: 子组件删除回调。
-     * index: 当前项索引。
-     * onInsert: 在当前项之前插入一条数据。
-     * onAppend: 在当前项之后附加一条数据。
+     * @en Content to render within the fieldset. Supports two modes:
+     *
+     * **Object Mode** (React element): For managing nested object fields. Child field names are automatically prefixed with fieldset name. Perfect for grouping related form fields like address, contact info, or user profile sections.
+     *
+     * **Array Mode** (render function): For managing dynamic array data. The function receives an object with:
+     * - `list`: Complete array data for this fieldset
+     * - `value`: Current item data at this index
+     * - `index`: Current item index in the array
+     * - `error`: Validation errors for current item
+     * - `onChange`: Update current item data
+     * - `onInsert`: Insert new item before current position
+     * - `onAppend`: Insert new item after current position
+     * - `onRemove`: Remove current item from array
+     *
+     * Ideal for dynamic lists, repeatable form sections, or editable tables.
+     *
+     * @cn 在字段集内渲染的内容。支持两种模式：
+     *
+     * **对象模式**（React 元素）：用于管理嵌套对象字段。子字段名称会自动加上字段集名称前缀。适用于分组相关表单字段，如地址、联系信息或用户资料等部分。
+     *
+     * **数组模式**（渲染函数）：用于管理动态数组数据。函数接收包含以下属性的对象：
+     * - `list`：该字段集的完整数组数据
+     * - `value`：当前索引位置的数据项
+     * - `index`：当前数据项在数组中的索引
+     * - `error`：当前数据项的校验错误
+     * - `onChange`：更新当前数据项
+     * - `onInsert`：在当前位置之前插入新数据项
+     * - `onAppend`：在当前位置之后插入新数据项
+     * - `onRemove`：从数组中移除当前数据项
+     *
+     * 适用于动态列表、可重复表单部分或可编辑表格。
      *
      * @override ((opts: object) => ReactNode) |ReactNode
      */
     children: React.ReactNode | FormFieldSetChildrenFunc<T extends (infer ValueItem)[] ? ValueItem : never>;
     /**
-     * @en Show content when data is empty. (only valid when children is function)
-     * @cn 数据为空时展示内容。（仅在children为function时有效）
+     * @en Content to display when the array is empty. Only effective in array mode (when children is a function). The render function receives an `insert` callback to add the first item. Perfect for showing "Add first item" buttons, empty state messages, or onboarding guidance for dynamic lists
+     * @cn 数组为空时显示的内容。仅在数组模式下（children 为函数时）有效。渲染函数接收 `insert` 回调来添加第一个数据项。适用于显示“添加第一个项目”按钮、空状态提示或动态列表的引导信息
      */
     empty?: (insert: (val: any) => void) => React.ReactNode;
 }

package/esm/form/form-fieldset.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-fieldset.type.d.ts","sourceRoot":"","sources":["form-fieldset.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,UAAU,mCAAmC;IAE3C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AACD,MAAM,WAAW,wBAAwB,CAAC,SAAS,GAAG,GAAG;IACvD,CAAC,MAAM,EAAE;QACP,IAAI,EAAE,SAAS,EAAE,CAAC;QAClB,KAAK,EAAE,SAAS,CAAC;QACjB,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,mCAAmC,KAAK,IAAI,CAAC;QACpF,QAAQ,EAAE,MAAM,IAAI,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;QACrC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;QACrC,KAAK,EAAE,KAAK,EAAE,CAAC;KAChB,GAAG,KAAK,CAAC,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC7E;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,QAAQ,EACJ,KAAK,CAAC,SAAS,GACf,wBAAwB,CAAC,CAAC,SAAS,CAAC,MAAM,SAAS,CAAC,EAAE,GAAG,SAAS,GAAG,KAAK,CAAC,CAAC;IAChF;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,KAAK,KAAK,CAAC,SAAS,CAAC;CACzD"}
+{"version":3,"file":"form-fieldset.type.d.ts","sourceRoot":"","sources":["form-fieldset.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,UAAU,mCAAmC;IAE3C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AACD,MAAM,WAAW,wBAAwB,CAAC,SAAS,GAAG,GAAG;IACvD,CAAC,MAAM,EAAE;QACP,IAAI,EAAE,SAAS,EAAE,CAAC;QAClB,KAAK,EAAE,SAAS,CAAC;QACjB,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,mCAAmC,KAAK,IAAI,CAAC;QACpF,QAAQ,EAAE,MAAM,IAAI,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;QACrC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;QACrC,KAAK,EAAE,KAAK,EAAE,CAAC;KAChB,GAAG,KAAK,CAAC,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC7E;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,QAAQ,EACJ,KAAK,CAAC,SAAS,GACf,wBAAwB,CAAC,CAAC,SAAS,CAAC,MAAM,SAAS,CAAC,EAAE,GAAG,SAAS,GAAG,KAAK,CAAC,CAAC;IAChF;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,KAAK,KAAK,CAAC,SAAS,CAAC;CACzD"}

package/esm/form/form-flow.type.d.ts

@@ -1,26 +1,30 @@
 import React from 'react';
-import { UseFormFlowProps, FormDatum } from '@sheinx/hooks';
+import { UseFormFlowProps, FormDatum as UiFormDatum } from '@sheinx/hooks';
 /**
  * @title FormFlow
  */
 export interface FormFlowProps extends UseFormFlowProps {
     /**
-     * @en datum is the object of Datum.Form.
-     * @cn datum 为 Datum.Form 对象
+     * @en Render function that receives the form data manager (datum) and returns React nodes. The datum object provides methods to get/set form values dynamically. Perfect for creating form field dependencies, conditional rendering based on form state, or performing actions that need access to multiple form values
+     * @cn 渲染函数，接收表单数据管理器（datum）并返回 React 节点。datum 对象提供了动态获取/设置表单值的方法。适用于创建表单字段依赖关系、基于表单状态的条件渲染，或执行需要访问多个表单值的操作
      * @override (datum: FormDatum) => ReactNode
      */
     children: ((datum?: FormDatum) => React.ReactNode) | React.ReactNode;
     /**
-     * @en Specifying which fields to change trigger the Flow update.
-     * @cn names 为空时，Form 内任意值变化会触发 Flow 更新；不为空时，只监听指定字段变化
+     * @en Array of field names to watch for changes. When empty or undefined, any form value change triggers re-render. When specified, only changes to these fields trigger updates. Supports nested paths like "user.name" or "items[0].price". Use this to optimize performance by limiting unnecessary re-renders
+     * @cn 要监听变化的字段名称数组。为空或未定义时，表单内任意值变化都会触发重新渲染。指定后，仅这些字段的变化会触发更新。支持嵌套路径如 "user.name" 或 "items[0].price"。通过限制不必要的重新渲染来优化性能
      */
     names?: string[];
     /**
-     * @en Whether to strictly follow the watch rules.
-     * @cn 严格根据 names 配置监听变化
+     * @en When true, uses memoization to prevent re-renders unless watched field values actually change. In strict mode, children only re-render when the specified names fields change their values (not just references). Useful for performance optimization in complex forms with expensive render operations
+     * @cn 设为 true 时，使用缓存机制防止重新渲染，除非监听的字段值真正发生变化。在严格模式下，只有指定的 names 字段值（而非仅引用）改变时才重新渲染子组件。适用于包含昂贵渲染操作的复杂表单的性能优化
      * @default false
      * @version 3.6.0
      */
     strict?: boolean;
 }
+/**
+ * @title FormDatum
+ */
+export type FormDatum = UiFormDatum;
 //# sourceMappingURL=form-flow.type.d.ts.map

package/esm/form/form-flow.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-flow.type.d.ts","sourceRoot":"","sources":["form-flow.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACrD;;;;OAIG;IACH,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,SAAS,KAAK,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;IACrE;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}
+{"version":3,"file":"form-flow.type.d.ts","sourceRoot":"","sources":["form-flow.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACrD;;;;OAIG;IACH,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,SAAS,KAAK,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;IACrE;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC"}

package/esm/form/form-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-item.d.ts","sourceRoot":"","sources":["form-item.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEvE,QAAA,MAAM,QAAQ,UAAW,aAAa,4CA6GrC,CAAC;AAEF,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"form-item.d.ts","sourceRoot":"","sources":["form-item.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEvE,QAAA,MAAM,QAAQ,UAAW,aAAa,4CAsHrC,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/esm/form/form-item.js

@@ -7,7 +7,7 @@ function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol"
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
-import React from 'react';
+import React, { useRef } from 'react';
 import { useFormItem, util } from '@sheinx/hooks';
 import { useTooltipStyle } from '@sheinx/shineout-style';
 import classNames from 'classnames';
@@ -18,7 +18,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { Fragment as _Fragment } from "react/jsx-runtime";
 import { jsxs as _jsxs } from "react/jsx-runtime";
 var FormItem = function FormItem(props) {
-  var _jssStyle$formItem;
+  var _jssStyle$formItem, _labelRef$current, _labelTipRef$current;
   var children = props.children,
     jssStyle = props.jssStyle,
     className = props.className,
@@ -29,7 +29,7 @@ var FormItem = function FormItem(props) {
     rest = _objectWithoutProperties(props, _excluded);
   var formItemClasses = jssStyle === null || jssStyle === void 0 || (_jssStyle$formItem = jssStyle.formItem) === null || _jssStyle$formItem === void 0 ? void 0 : _jssStyle$formItem.call(jssStyle);
   var _useFormItem = useFormItem(),
-    Provider = _useFormItem.Provider,
+    FormItemContextProvider = _useFormItem.Provider,
     ProviderValue = _useFormItem.ProviderValue,
     labelConfig = _useFormItem.labelConfig,
     errors = _useFormItem.errors,
@@ -89,11 +89,19 @@ var FormItem = function FormItem(props) {
       children: label
     });
   };
+  var labelRef = useRef(null);
+  var labelTipRef = useRef(null);
+  var labelText = (_labelRef$current = labelRef.current) === null || _labelRef$current === void 0 ? void 0 : _labelRef$current.textContent;
+  if ((_labelTipRef$current = labelTipRef.current) !== null && _labelTipRef$current !== void 0 && _labelTipRef$current.textContent) {
+    var _labelTipRef$current2;
+    labelText += " (tip: ".concat((_labelTipRef$current2 = labelTipRef.current) === null || _labelTipRef$current2 === void 0 ? void 0 : _labelTipRef$current2.textContent, ")");
+  }
   return /*#__PURE__*/_jsxs("div", _objectSpread(_objectSpread({
-    className: classNames(className, formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.wrapper, _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.wrapperLabelTop, labelAlign === 'top'), formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.wrapperLabelVerticalMiddle, labelAlign !== 'top' && labelVerticalAlign === 'middle'), formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.wrapperLabelVerticalBottom, labelAlign !== 'top' && labelVerticalAlign === 'bottom'), formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.wrapperInline, inline), formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.wrapperKeepHeight, keepErrorHeight), formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.wrapperRequired, required), formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.wrapperTip, showError || tip))
+    className: classNames(className, formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.wrapper, _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.wrapperLabelTop, labelAlign === 'top'), formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.wrapperLabelVerticalMiddle, labelAlign !== 'top' && labelVerticalAlign === 'middle'), formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.wrapperLabelVerticalBottom, labelAlign !== 'top' && labelVerticalAlign === 'bottom'), formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.wrapperInline, inline), formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.wrapperKeepHeight, keepErrorHeight), formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.wrapperRequired, required), formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.wrapperHideRequired, required === false), formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.wrapperTip, showError || tip))
   }, attributes), {}, {
     style: style,
     children: [label !== undefined ? /*#__PURE__*/_jsx("div", {
+      ref: labelRef,
       className: classNames(formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.label, _defineProperty(_defineProperty(_defineProperty({}, formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.labelLeft, labelAlign === 'left'), formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.labelWithColon, colon), formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.labelWithTooltip, label && _typeof(label) === 'object' && 'tooltip' in label)),
       style: labelAlign !== 'top' || inline ? {
         width: labelWidth
@@ -104,10 +112,13 @@ var FormItem = function FormItem(props) {
     }, util.getDataAttribute({
       role: 'form-control'
     })), {}, {
-      children: [/*#__PURE__*/_jsx(Provider, {
-        value: ProviderValue,
+      children: [/*#__PURE__*/_jsx(FormItemContextProvider, {
+        value: _objectSpread(_objectSpread({}, ProviderValue), {}, {
+          label: labelText
+        }),
         children: children
       }), !!tip && (!showError || keepErrorBelow) && /*#__PURE__*/_jsx("div", {
+        ref: labelTipRef,
         className: formItemClasses === null || formItemClasses === void 0 ? void 0 : formItemClasses.tip,
         children: tip
       }), showError && /*#__PURE__*/_jsx("div", {

package/esm/form/form-item.type.d.ts

@@ -11,6 +11,7 @@ export interface FormItemClasses {
     wrapperLabelVerticalBottom: string;
     wrapperKeepHeight: string;
     wrapperRequired: string;
+    wrapperHideRequired: string;
     wrapperTip: string;
     label: string;
     labelWithColon: string;

package/esm/form/form-item.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-item.type.d.ts","sourceRoot":"","sources":["form-item.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,0BAA0B,EAAE,MAAM,CAAC;IACnC,0BAA0B,EAAE,MAAM,CAAC;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,KAAK,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,KAAK,GAAG,UAAU,CAAC,GAAG;IAC3D,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC;CACvB,CAAA;AACD,UAAU,WAAW;IACnB,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,YAAY,CAAC;CAC1C;AAED,MAAM,WAAW,aAAc,SAAQ,eAAe,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,GAAG,OAAO,CAAC;IAC7F;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,WAAW,CAAC;IACtC;;;OAGG;IACH,GAAG,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE;QACT,QAAQ,CAAC,EAAE,MAAM,eAAe,CAAC;KAClC,CAAC;CACH"}
+{"version":3,"file":"form-item.type.d.ts","sourceRoot":"","sources":["form-item.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,0BAA0B,EAAE,MAAM,CAAC;IACnC,0BAA0B,EAAE,MAAM,CAAC;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,KAAK,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,KAAK,GAAG,UAAU,CAAC,GAAG;IAC3D,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC;CACvB,CAAA;AACD,UAAU,WAAW;IACnB,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,YAAY,CAAC;CAC1C;AAED,MAAM,WAAW,aAAc,SAAQ,eAAe,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,GAAG,OAAO,CAAC;IAC7F;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,WAAW,CAAC;IACtC;;;OAGG;IACH,GAAG,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE;QACT,QAAQ,CAAC,EAAE,MAAM,eAAe,CAAC;KAClC,CAAC;CACH"}

package/esm/form/form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["form.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,QAAA,MAAM,IAAI,wFA6HT,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["form.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,QAAA,MAAM,IAAI,wFA8HT,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/esm/form/form.js

@@ -66,7 +66,8 @@ var Form = function Form(props) {
     validateFieldsWithValue: validateFieldsWithValue,
     validateFieldsWithError: formFunc.validateFields,
     set: formFunc.setValue,
-    scrollToField: formFunc.scrollToField
+    scrollToField: formFunc.scrollToField,
+    getFormSchema: formFunc.getFormSchema
   });
   React.useEffect(function () {
     if (formRef) {

package/esm/form/form.type.d.ts

@@ -14,50 +14,54 @@ export interface FormValidateFn<FormValue> {
      */
     (fields?: string | string[]): Promise<FormValue>;
 }
+/**
+ * FormValue 泛型表示表单数据的类型，通常是一个对象类型
+ * 例如：{ name: string, age: number, address: { city: string } }
+ */
 export interface FormRef<FormValue> {
     /**
-     * @en return form value
-     * @cn 返回表单的值
+     * @en Get form data. Returns the entire form data object (FormValue type) when no parameter is passed, returns the value of the specified field when a field path is passed. Field paths support dot notation and array indexes, such as 'user.name' (get nested object), 'list[0].id' (get array element). Commonly used to get form data for other operations
+     * @cn 获取表单数据。不传参数时返回整个表单的数据对象（FormValue 类型），传入字段路径时返回指定字段的值。字段路径支持点表示法和数组索引，如 'user.name'（获取嵌套对象）、'list[0].id'（获取数组元素）。常用于获取表单数据进行其他操作
      */
     getValue: (name?: string) => any | FormValue;
     /**
-     * @en Validate form
-     * @cn 校验表单
+     * @en Validate all fields in the entire form. Returns a Promise that resolves with the entire form data object (FormValue type) on successful validation, and rejects with error information on failure. Usually called before form submission to ensure all data validity
+     * @cn 校验整个表单的所有字段。返回一个 Promise，校验成功时 resolve 整个表单的数据对象（FormValue 类型），失败时 reject 错误信息。通常在提交表单前调用以确保所有数据的有效性
      */
     validate: () => Promise<any>;
     /**
-     * @en Validation form fields
-     * @cn 校验表单指定字段
+     * @en Validate specified form fields. The fields parameter is a field path, which can be a single path string or an array of paths. Field paths support: 'name' (top-level field), 'user.email' (nested object), 'list[0].name' (array element). Returns a Promise that resolves with the specified field data on success, and rejects with the first error encountered on failure. Suitable for step-by-step forms or partial validation scenarios
+     * @cn 校验指定的表单字段。fields 参数为字段路径，可以是单个路径字符串或路径数组。字段路径支持：'name'（顶层字段）、'user.email'（嵌套对象）、'list[0].name'（数组元素）。返回 Promise，成功时 resolve 指定字段的数据，失败时 reject 第一个遇到的错误。适用于分步表单或部分校验场景
      */
     validateFields: (fields: string | string[]) => Promise<any>;
     /**
-     * @en Validation form fields and return the value
-     * @cn 校验表单指定字段并返回值, 也可以通过 catch 获取报错信息
+     * @en Validate specified fields and always return form data. The fields parameter is a field path, validates all fields when not passed. Resolves with specified field data on success, rejects with a ValidationError object on failure, containing: values (form data) and errorFields (array containing name and errors information for each error field). Suitable for scenarios that need to get both form data and detailed error information
+     * @cn 校验指定字段并始终返回表单数据。fields 参数为字段路径，不传时校验所有字段。成功时 resolve 指定字段的数据，失败时 reject 一个 ValidationError 对象，包含：values（表单数据）和 errorFields（数组，包含每个错误字段的 name 和 errors 信息）。适用于需要同时获取表单数据和详细错误信息的场景
      */
     validateFieldsWithValue: (fields?: (string | keyof FormValue) | (string | keyof FormValue)[]) => Promise<any>;
     /**
-     * @en The verification can get the error message through Promise.catch
-     * @cn 校验可以通过 catch 获取报错信息
+     * @en Validate specified fields and return the first error encountered. The fields parameter is a field path. Same functionality as validateFields, but the name more clearly indicates that it will return error information. Rejects with a FormError object (containing only the first error) on failure. Suitable for scenarios that only care about the first error
+     * @cn 校验指定字段并返回第一个遇到的错误。fields 参数为字段路径。与 validateFields 功能相同，但名称更明确地表示会返回错误信息。失败时 reject 一个 FormError 对象（仅包含第一个错误）。适用于只关心第一个错误的场景
      */
     validateFieldsWithError: (fields: string | string[]) => Promise<any>;
     /**
-     * @en Clear check
-     * @cn 清除校验
+     * @en Clear validation error information for specified fields. The names parameter is an array of field paths, clears errors for all fields when not passed. Field paths support formats like 'name', 'user.email', 'list[0].id'. Commonly used for resetting form state, clearing specific field errors, etc.
+     * @cn 清除指定字段的校验错误信息。names 参数为字段路径数组，不传时清除所有字段的错误。字段路径支持 'name'、'user.email'、'list[0].id' 等格式。常用于重置表单状态、清除特定字段错误等场景
      */
     clearValidate: (names?: string[]) => void;
     /**
-     * @en Submit Form, withValidate: Whether to verify
-     * @cn 提交表单, withValidate: 是否校验
+     * @en Manually trigger form submission. The withValidate parameter controls whether to validate before submission, default is true. After validation passes, it will call the Form's onSubmit callback with the entire form data object (FormValue type). Usually used for custom submit buttons or programmatic submission
+     * @cn 手动触发表单提交。withValidate 参数控制是否在提交前进行校验，默认为 true。校验通过后会调用 Form 的 onSubmit 回调，传入整个表单的数据对象（FormValue 类型）。通常用于自定义提交按钮或程序化提交
      */
     submit: (withValidate?: boolean) => void;
     /**
-     * @en reset form
-     * @cn 重置表单
+     * @en Reset the form to its initial state. Restores form data to defaultValue (uncontrolled) or empty object (controlled), and clears all validation errors. Will trigger the Form's onReset callback
+     * @cn 重置表单到初始状态。将表单数据恢复为 defaultValue（非受控）或空对象（受控），并清除所有校验错误。会触发 Form 的 onReset 回调
      */
     reset: () => void;
     /**
-     * @en set field value, key is field path, Example: { 'name': 'sanmao', 'account.name': 'sanmao', 'friends[0].name': 'sanmao' }
-     * @cn 设置字段值, key为字段路径,示例：{ 'name': 'sanmao', 'account.name': 'sanmao', 'friends[0].name': 'sanmao' }
+     * @en Batch set form field values. Pass in an object where key is the field path and value is the value to set. Field paths support: dot notation ('user.name') to access nested objects, array indexes ('list[0].id') to access array elements. Options parameters: validate controls whether to trigger validation (default false), forceUpdate controls whether to force update (default false). Suitable for dynamically setting form values, linked updates, etc.
+     * @cn 批量设置表单字段值。传入一个对象，key 为字段路径，value 为要设置的值。字段路径支持：点表示法（'user.name'）访问嵌套对象，数组索引（'list[0].id'）访问数组元素。options 参数：validate 控制是否触发校验（默认 false），forceUpdate 控制是否强制更新（默认 false）。适用于动态设置表单值、联动更新等场景
      */
     set: (value: {
         [key: string]: any;
@@ -66,10 +70,16 @@ export interface FormRef<FormValue> {
         forceUpdate?: boolean;
     }) => void;
     /**
-     * @en Scroll to the position of the specified field
-     * @cn 滚动到指定字段的位置
+     * @en Scroll the page to the position of the specified form field. The name parameter is a field path, supporting formats like 'name', 'user.email', 'list[0].id'. Requires the Form to set the name property to work properly. The scrollIntoViewOptions parameter conforms to the standard ScrollIntoViewOptions interface, which can control scrolling behavior, position, etc. Commonly used for error positioning, step-by-step form navigation, etc.
+     * @cn 滚动页面到指定表单字段的位置。name 参数为字段路径，支持 'name'、'user.email'、'list[0].id' 等格式。需要 Form 设置 name 属性才能正常工作。scrollIntoViewOptions 参数符合标准 ScrollIntoViewOptions 接口，可以控制滚动行为、位置等。常用于错误定位、分步表单导航等
      */
     scrollToField: (name: string, scrollIntoViewOptions?: ScrollIntoViewOptions) => void;
+    /**
+     * @en Get the JSON Schema of the form structure. Returns a standard JSON Schema object that describes the form's structure, field types, validation rules, and constraints. Useful for form documentation, validation, and integration with JSON Schema-based tools
+     * @cn 获取表单结构的 JSON Schema。返回一个标准的 JSON Schema 对象，描述表单的结构、字段类型、验证规则和约束。用于表单文档化、验证以及与基于 JSON Schema 的工具集成
+     * @version 3.8.0
+     */
+    getFormSchema: () => any;
 }
 export interface FormProps<V extends ObjectType> extends Partial<BaseFormProps<V>>, Pick<CommonType, 'className' | 'style'> {
     jssStyle: {
@@ -87,16 +97,16 @@ export interface FormProps<V extends ObjectType> extends Partial<BaseFormProps<V
      */
     scrollToError?: boolean | number;
     /**
-     * @en bind form ref, Can call some form methods
-     * @cn 绑定 form 的引用, 可以调用某些 form 的方法
+     * @en Get a reference to the form instance. Supports both function callback and ref object methods. Through formRef, you can call various form methods, such as manually triggering validation (validate, validateFields), submission (submit), reset (reset), getting/setting values (getValue, set), etc. The generic V in FormRef<V> represents the type of form data
+     * @cn 获取表单实例的引用。支持函数回调和 ref 对象两种方式。通过 formRef 可以调用表单的各种方法，如手动触发校验（validate、validateFields）、提交（submit）、重置（reset）、获取/设置值（getValue、set）等。FormRef<V> 中的泛型 V 表示表单数据的类型
      * @override
      */
     formRef?: ((form: FormRef<V>) => void) | {
         current?: FormRef<V>;
     };
     /**
-     * @en When using hooks, set the form ref
-     * @cn hooks用法下，设置 form 的引用
+     * @en Callback function for setting form reference when using Form.useForm() hooks. Usually doesn't need to be set manually, the Form component will handle it automatically. But may be needed in some special scenarios (such as cross-component communication)
+     * @cn 在使用 Form.useForm() hooks 时，用于设置表单引用的回调函数。通常不需要手动设置，Form 组件会自动处理。但在某些特殊场景（如跨组件通信）可能需要使用
      */
     setForm?: (form: FormRef<V>) => void;
     /**

package/esm/form/form.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form.type.d.ts","sourceRoot":"","sources":["form.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAC/C,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc,CAC7B,SAAS;IAIT;;;OAGG;IACH,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CAClD;AAGD,MAAM,WAAW,OAAO,CAAC,SAAS;IAChC;;;OAGG;IACH,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,GAAG,GAAG,SAAS,CAAC;IAC7C;;;OAGG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B;;;OAGG;IACH,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAE5D;;;OAGG;IACH,uBAAuB,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,SAAS,CAAC,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9G;;;OAGG;IACH,uBAAuB,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IACrE;;;OAGG;IACH,aAAa,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC1C;;;OAGG;IACH,MAAM,EAAE,CAAC,YAAY,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC;;;OAGG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB;;;OAGG;IACH,GAAG,EAAE,CAAC,KAAK,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,EAAE,OAAO,CAAC,EAAE;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAC,KAAK,IAAI,CAAC;IACpG;;;OAGG;IACH,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,qBAAqB,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACtF;AACD,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,UAAU,CAC7C,SAAQ,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAC/B,IAAI,CAAC,UAAU,EAAE,WAAW,GAAG,OAAO,CAAC;IACzC,QAAQ,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,WAAW,CAAC;KAC1B,CAAC;IACF;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE,CAAC;IAElE;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACrC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;;AACD,wBAAkB"}
+{"version":3,"file":"form.type.d.ts","sourceRoot":"","sources":["form.type.ts"],"names":[],"mappings":"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"}

package/esm/form/form.type.js

@@ -1 +1,6 @@
+/**
+ * FormValue 泛型表示表单数据的类型，通常是一个对象类型
+ * 例如：{ name: string, age: number, address: { city: string } }
+ */
+
 export default {};

package/esm/form/index.d.ts

@@ -8,5 +8,5 @@ export type { FormProps, FormRef, FormClasses } from './form.type';
 export type { FormItemProps, FormItemClasses } from './form-item.type';
 export type { FormFieldProps, FormFieldChildrenFunc } from './form-field.type';
 export type { FormFieldSetProps, FormFieldSetChildrenFunc } from './form-fieldset.type';
-export type { FormFlowProps } from './form-flow.type';
+export type { FormFlowProps, FormDatum } from './form-flow.type';
 //# sourceMappingURL=index.d.ts.map

package/esm/form/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,aAAa,CAAC;AAElD,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACxF,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,aAAa,CAAC;AAElD,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACxF,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/esm/input/input-password.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input-password.d.ts","sourceRoot":"","sources":["input-password.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;;AAmD3D,wBAAoC"}
+{"version":3,"file":"input-password.d.ts","sourceRoot":"","sources":["input-password.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;;AAoD3D,wBAAoC"}

package/esm/input/input-password.js

@@ -45,7 +45,8 @@ var Password = function Password(props) {
   return /*#__PURE__*/_jsx(SimpleInput, _objectSpread(_objectSpread(_objectSpread({}, forwardProps), inputProps), {}, {
     className: props.className,
     suffix: suffix,
-    hasSuffix: true
+    hasSuffix: true,
+    showClear: props.showClear
   }));
 };
 export default /*#__PURE__*/React.memo(Password);

package/esm/input/input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["input.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,KAAK,MAAM,OAAO,CAAC;;AA4C1B,wBAAiC"}
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["input.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,KAAK,MAAM,OAAO,CAAC;;AA6C1B,wBAAiC"}

package/esm/input/input.js

@@ -33,6 +33,7 @@ var Input = function Input(props) {
   return /*#__PURE__*/_jsx(SimpleInputInput, _objectSpread(_objectSpread(_objectSpread({}, forwardProps), inputFormatProps), {}, {
     value: (_inputFormatProps$val = inputFormatProps.value) !== null && _inputFormatProps$val !== void 0 ? _inputFormatProps$val : '',
     hasSuffix: !!props.suffix,
+    showClear: props.showClear,
     onKeyDown: function onKeyDown(e) {
       var _props$onKeyDown;
       if (e.key === 'Enter' && !e.defaultPrevented) {