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

package/cjs/components/use-form/use-form-control/use-form-control.type.d.ts

@@ -24,14 +24,20 @@ export interface BaseFormControlProps<T> {
      */
     onError: ((error: Error | undefined) => void) | undefined;
     /**
-     * @en When the value changes, it will link to verify the fields in the bind, which needs to be used with Form
-     * @cn 当值改变是会联动校验 bind 中的字段, 需要配合 Form 使用
+     * @en Array of field names that should be re-validated when current field's value changes. Enables field linkage validation for dependent fields. Commonly used in scenarios like password confirmation, related dropdown selections, or interdependent form calculations
+     * @cn 当前字段值改变时需要重新校验的字段名称数组。启用字段间的联动校验功能。常用于密码确认、关联下拉选择或相互依赖的表单计算等场景
      */
     bind: string[] | undefined;
     /**
      * @private 内部属性 for validate
      */
     getValidateProps: (() => ObjectType) | undefined;
+    /**
+     * @en If set to true, the form will not automatically delete the data after the component is uninstalled
+     * @cn 设置为 true 组件后，有defaultValue时，允许undefined作为最终值
+     * @version 3.8.0
+     */
+    clearToUndefined?: boolean;
 }
 export interface FormControlContext {
     mounted: boolean;

package/cjs/components/use-form/use-form-control/use-form-control.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-form-control.type.d.ts","sourceRoot":"","sources":["use-form-control.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB;;;OAGG;IACH,YAAY,EAAE,CAAC,GAAG,SAAS,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC5D;;;OAGG;IACH,WAAW,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC;;;;OAIG;IACH,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IACnC;;OAEG;IACH,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC1D;;;OAGG;IACH,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC3B;;OAEG;IACH,gBAAgB,EAAE,CAAC,MAAM,UAAU,CAAC,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;CAClB"}
+{"version":3,"file":"use-form-control.type.d.ts","sourceRoot":"","sources":["use-form-control.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB;;;OAGG;IACH,YAAY,EAAE,CAAC,GAAG,SAAS,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC5D;;;OAGG;IACH,WAAW,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC;;;;OAIG;IACH,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IACnC;;OAEG;IACH,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC1D;;;OAGG;IACH,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC3B;;OAEG;IACH,gBAAgB,EAAE,CAAC,MAAM,UAAU,CAAC,GAAG,SAAS,CAAC;IAEjD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/cjs/components/use-form/use-form-flow/use-form-datum.d.ts

@@ -1,7 +1,15 @@
 export interface FormDatum {
+    /**
+     * @en Set form field values. Accepts either an object to set multiple fields at once, or a field name with value to set a single field. Field names support nested paths like "user.name" or "items[0].price". Changes trigger form validation and re-render of affected Flow components
+     * @cn 设置表单字段值。可以接收对象以批量设置多个字段，或接收字段名和值以设置单个字段。字段名支持嵌套路径如 "user.name" 或 "items[0].price"。更改会触发表单校验和相关 Flow 组件的重新渲染
+     */
     set: (vals: {
         [name: string]: any;
     } | string, value?: any) => void;
+    /**
+     * @en Get form field value by name. When no name is provided, returns the entire form data object. Supports nested paths like "user.name" or "items[0].price" to access deeply nested values
+     * @cn 根据名称获取表单字段值。未提供名称时返回整个表单数据对象。支持嵌套路径如 "user.name" 或 "items[0].price" 来访问深层嵌套的值
+     */
     get: (name?: string) => any;
 }
 declare const useFormDatum: () => FormDatum | undefined;

package/cjs/components/use-form/use-form-flow/use-form-datum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-form-datum.d.ts","sourceRoot":"","sources":["use-form-datum.tsx"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,CAAC,IAAI,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IACnE,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,GAAG,CAAC;CAC7B;AAED,QAAA,MAAM,YAAY,6BAgBjB,CAAC;AAEF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"use-form-datum.d.ts","sourceRoot":"","sources":["use-form-datum.tsx"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,GAAG,EAAE,CAAC,IAAI,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IACnE;;;OAGG;IACH,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,GAAG,CAAC;CAC7B;AAED,QAAA,MAAM,YAAY,6BAgBjB,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/cjs/components/use-form/use-form-item/form-item-context.d.ts

@@ -1,5 +1,6 @@
 import * as React from 'react';
 export interface FormItemContextValueType {
+    label?: any;
     updateError: (name: string, error?: Error) => void;
 }
 export declare const FormItemContext: React.Context<FormItemContextValueType>;

package/cjs/components/use-form/use-form-item/form-item-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-item-context.d.ts","sourceRoot":"","sources":["form-item-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;CACpD;AAED,eAAO,MAAM,eAAe,yCAE1B,CAAC"}
+{"version":3,"file":"form-item-context.d.ts","sourceRoot":"","sources":["form-item-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;CACpD;AAED,eAAO,MAAM,eAAe,yCAE1B,CAAC"}

package/cjs/components/use-form/use-form-item/form-item-context.js

@@ -11,4 +11,5 @@ function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 var FormItemContext = exports.FormItemContext = /*#__PURE__*/React.createContext({
   updateError: function updateError() {}
-});
+});
+FormItemContext.displayName = 'FormItemContext';

package/cjs/components/use-form/use-form-item/index.d.ts

@@ -1,2 +1,3 @@
 export { default, default as useFormItem } from './use-form-item';
+export { FormItemContext } from './form-item-context';
 //# sourceMappingURL=index.d.ts.map

package/cjs/components/use-form/use-form-item/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,WAAW,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/cjs/components/use-form/use-form-item/index.js

@@ -4,6 +4,12 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+Object.defineProperty(exports, "FormItemContext", {
+  enumerable: true,
+  get: function get() {
+    return _formItemContext.FormItemContext;
+  }
+});
 Object.defineProperty(exports, "default", {
   enumerable: true,
   get: function get() {
@@ -17,4 +23,5 @@ Object.defineProperty(exports, "useFormItem", {
   }
 });
 var _useFormItem = _interopRequireDefault(require("./use-form-item"));
+var _formItemContext = require("./form-item-context");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }

package/cjs/components/use-form/use-form-schema/form-schema-builder.d.ts

@@ -0,0 +1,49 @@
+interface SchemaMeta {
+    type?: string;
+    required?: boolean;
+    title?: string;
+    format?: string;
+    items?: any;
+    enum?: any[] | {
+        anyOf: any[];
+    };
+    description?: string;
+    [key: string]: any;
+}
+export interface SchemaProperty {
+    type?: string;
+    properties?: Record<string, SchemaProperty>;
+    items?: SchemaProperty;
+    required?: string[];
+    title?: string;
+    description?: string;
+    format?: string;
+    enum?: any;
+    [key: string]: any;
+}
+export declare class SchemaBuilder {
+    private schema;
+    constructor(formName: string);
+    updateSchema({ path, meta }: {
+        path: string;
+        meta: SchemaMeta;
+    }): void;
+    /**
+     * 根据组件信息构建 schema meta
+     */
+    buildSchemaFromComponent(params: {
+        componentElement: any;
+        rules?: any[];
+        label?: string;
+        finalFieldId?: string;
+        separator?: string;
+    }): SchemaMeta;
+    parsePath(path?: string): string[] | null;
+    mergeSchema(currentSchema: SchemaProperty, pathSegments: string[], meta: SchemaMeta): void;
+    handleArraySegment(currentSchema: SchemaProperty, remainingSegments: string[], meta: SchemaMeta): void;
+    handleObjectProperty(currentSchema: SchemaProperty, propertyName: string, remainingSegments: string[], meta: SchemaMeta): void;
+    handleRequired(parentSchema: SchemaProperty, propertyName: string, isRequired: boolean): void;
+    getFormSchema(): SchemaProperty;
+}
+export {};
+//# sourceMappingURL=form-schema-builder.d.ts.map

package/cjs/components/use-form/use-form-schema/form-schema-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-schema-builder.d.ts","sourceRoot":"","sources":["form-schema-builder.ts"],"names":[],"mappings":"AAAA,UAAU,UAAU;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG;QAAE,KAAK,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAiB;gBACnB,QAAQ,EAAE,MAAM;IAQ5B,YAAY,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,GAAG,IAAI;IAMtE;;OAEG;IACH,wBAAwB,CAAC,MAAM,EAAE;QAC/B,gBAAgB,EAAE,GAAG,CAAC;QACtB,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,UAAU;IAmId,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAuCzC,WAAW,CAAC,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IAkB1F,kBAAkB,CAAC,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IAatG,oBAAoB,CAAC,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IA0B9H,cAAc,CAAC,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI;IAwB7F,aAAa,IAAI,cAAc;CAGhC"}

package/cjs/components/use-form/use-form-schema/form-schema-builder.js

@@ -0,0 +1,311 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.SchemaBuilder = void 0;
+var _excluded = ["required"];
+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; }
+function _toArray(arr) { return _arrayWithHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+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); }
+var SchemaBuilder = exports.SchemaBuilder = /*#__PURE__*/function () {
+  function SchemaBuilder(formName) {
+    _classCallCheck(this, SchemaBuilder);
+    _defineProperty(this, "schema", void 0);
+    this.schema = {
+      type: 'object',
+      title: formName,
+      properties: {}
+    };
+  }
+  _createClass(SchemaBuilder, [{
+    key: "updateSchema",
+    value: function updateSchema(_ref) {
+      var path = _ref.path,
+        meta = _ref.meta;
+      var pathSegments = this.parsePath(path);
+      if (!pathSegments) return;
+      this.mergeSchema(this.schema, pathSegments, meta);
+    }
+
+    /**
+     * 根据组件信息构建 schema meta
+     */
+  }, {
+    key: "buildSchemaFromComponent",
+    value: function buildSchemaFromComponent(params) {
+      var _componentElement$pro;
+      var componentElement = params.componentElement,
+        rules = params.rules,
+        label = params.label,
+        finalFieldId = params.finalFieldId,
+        separator = params.separator;
+      var fieldSchemaInfo = {
+        title: label
+      };
+      var data = componentElement.props.data;
+      var isRequired = rules === null || rules === void 0 ? void 0 : rules.some(function (rule) {
+        return rule.required;
+      });
+      fieldSchemaInfo.required = isRequired;
+      fieldSchemaInfo.description = '';
+      if (rules !== null && rules !== void 0 && rules.length) {
+        var messageRules = rules.filter(function (rule) {
+          return typeof rule.message === 'string';
+        });
+        if (messageRules.length) {
+          fieldSchemaInfo.description += "rules: ".concat(messageRules.map(function (rule) {
+            return rule.message;
+          }).join(', '), ";");
+        }
+      }
+      var itemType;
+      if (typeof componentElement.type === 'function') {
+        switch (componentElement.type.name) {
+          case 'Input':
+            fieldSchemaInfo.type = 'string';
+            break;
+          case 'InputNumber':
+            fieldSchemaInfo.type = 'number';
+            break;
+          case 'InputPassword':
+            fieldSchemaInfo.type = 'string';
+            break;
+          case 'Textarea':
+            fieldSchemaInfo.type = 'string';
+            break;
+          case 'Select':
+          case 'TreeSelect':
+            {
+              var format = componentElement.props.format || componentElement.props.keygen;
+              if (typeof componentElement.props.keygen !== 'boolean') {
+                if (typeof format === 'string') {
+                  var _data$;
+                  itemType = _typeof(data === null || data === void 0 ? void 0 : data[0]) === 'object' ? _typeof(data === null || data === void 0 || (_data$ = data[0]) === null || _data$ === void 0 ? void 0 : _data$[format]) : _typeof(data === null || data === void 0 ? void 0 : data[0]);
+                } else if (typeof format === 'function') {
+                  itemType = _typeof(format(data === null || data === void 0 ? void 0 : data[0]));
+                } else {
+                  itemType = _typeof(data === null || data === void 0 ? void 0 : data[0]);
+                }
+              } else {
+                itemType = _typeof(data === null || data === void 0 ? void 0 : data[0]);
+              }
+              if (componentElement.props.multiple) {
+                fieldSchemaInfo.type = 'array';
+                fieldSchemaInfo.items = {
+                  type: itemType
+                };
+              } else {
+                fieldSchemaInfo.type = itemType;
+              }
+              // props.data格式： [
+              //   { "value": 1, "title": "年假" },
+              //   { "value": 2, "title": "调休" },
+              //   { "value": 3, "title": "事假" },
+              //   { "value": 4, "title": "病假" },
+              //   { "value": 5, "title": "其他" }
+              // ]
+              // 转换为jsonschema中的enum格式：
+              // "enum": {
+              //   "anyOf": [
+              //     { "const": 1, "title": "年假" },
+              //     { "const": 2, "title": "调休" },
+              //     { "const": 3, "title": "事假" },
+              //     { "const": 4, "title": "病假" },
+              //     { "const": 5, "title": "其他" }
+              //   ]
+              // }
+              fieldSchemaInfo.enum = {
+                anyOf: componentElement.props.data.map(function (item) {
+                  return {
+                    const: (item === null || item === void 0 ? void 0 : item[format]) || item,
+                    title: (item === null || item === void 0 ? void 0 : item.title) || item
+                  };
+                })
+              };
+              break;
+            }
+          case 'DatePicker':
+            if (componentElement.props.range) {
+              if (finalFieldId !== null && finalFieldId !== void 0 && finalFieldId.includes(separator || '')) {
+                fieldSchemaInfo.type = 'string';
+                fieldSchemaInfo.format = 'date';
+              } else {
+                fieldSchemaInfo.type = 'array';
+                fieldSchemaInfo.items = {
+                  type: 'string',
+                  format: 'date'
+                };
+              }
+            } else {
+              fieldSchemaInfo.type = 'string';
+              fieldSchemaInfo.format = 'date';
+            }
+            fieldSchemaInfo.description += "\u9ED8\u8BA4\u65F6\u95F4\uFF1A".concat(((_componentElement$pro = componentElement.props.defaultTime) === null || _componentElement$pro === void 0 ? void 0 : _componentElement$pro.toString()) || '', "; \u683C\u5F0F\uFF1A").concat(componentElement.props.format || '', " ");
+            break;
+          case 'Checkbox':
+            fieldSchemaInfo.type = 'array';
+            fieldSchemaInfo.items = {
+              type: 'string'
+            };
+            break;
+          case 'Radio':
+            fieldSchemaInfo.type = 'string';
+            break;
+          case 'Rate':
+            fieldSchemaInfo.type = 'number';
+            break;
+          default:
+            if (Array.isArray(componentElement.props.value) && componentElement.props.value.length === 0) {
+              fieldSchemaInfo.type = 'array';
+              fieldSchemaInfo.items = {
+                type: 'string'
+              };
+            } else {
+              fieldSchemaInfo.type = _typeof(componentElement.props.value);
+            }
+            break;
+        }
+      }
+      return fieldSchemaInfo;
+    }
+
+    // 解析路径字符串，如 'a[0].b1' -> ['a', '[0]', 'b1']
+  }, {
+    key: "parsePath",
+    value: function parsePath(path) {
+      if (!path) return null;
+      var segments = [];
+      var current = '';
+      var inBracket = false;
+      for (var i = 0; i < path.length; i++) {
+        var char = path[i];
+        if (char === '[') {
+          if (current) {
+            segments.push(current);
+            current = '';
+          }
+          current = '[';
+          inBracket = true;
+        } else if (char === ']') {
+          current += ']';
+          segments.push(current);
+          current = '';
+          inBracket = false;
+        } else if (char === '.' && !inBracket) {
+          if (current) {
+            segments.push(current);
+            current = '';
+          }
+        } else {
+          current += char;
+        }
+      }
+      if (current) {
+        segments.push(current);
+      }
+      return segments;
+    }
+
+    // 递归合并 schema
+  }, {
+    key: "mergeSchema",
+    value: function mergeSchema(currentSchema, pathSegments, meta) {
+      if (pathSegments.length === 0) {
+        // 到达叶子节点，应用元数据
+        Object.assign(currentSchema, meta);
+        return;
+      }
+      var _pathSegments = _toArray(pathSegments),
+        currentSegment = _pathSegments[0],
+        remainingSegments = _pathSegments.slice(1);
+      if (currentSegment.startsWith('[') && currentSegment.endsWith(']')) {
+        // 处理数组索引，如 [0]
+        this.handleArraySegment(currentSchema, remainingSegments, meta);
+      } else {
+        // 处理对象属性
+        this.handleObjectProperty(currentSchema, currentSegment, remainingSegments, meta);
+      }
+    }
+  }, {
+    key: "handleArraySegment",
+    value: function handleArraySegment(currentSchema, remainingSegments, meta) {
+      // 当前节点应该是数组类型
+      if (!currentSchema.items) {
+        currentSchema.type = 'array';
+        currentSchema.items = {
+          type: 'object',
+          properties: {}
+        };
+      }
+      this.mergeSchema(currentSchema.items, remainingSegments, meta);
+    }
+  }, {
+    key: "handleObjectProperty",
+    value: function handleObjectProperty(currentSchema, propertyName, remainingSegments, meta) {
+      // 确保当前节点有 properties
+      if (!currentSchema.properties) {
+        currentSchema.properties = {};
+      }
+
+      // 如果属性不存在，创建它
+      if (!currentSchema.properties[propertyName]) {
+        currentSchema.properties[propertyName] = remainingSegments.length > 0 ? {
+          type: 'object'
+        } : {};
+      }
+      if (remainingSegments.length === 0) {
+        // 叶子节点，应用元数据并处理 required
+        var required = meta.required,
+          restMeta = _objectWithoutProperties(meta, _excluded);
+        Object.assign(currentSchema.properties[propertyName], restMeta);
+        if (typeof required === 'boolean') {
+          this.handleRequired(currentSchema, propertyName, required);
+        }
+      } else {
+        // 继续递归
+        this.mergeSchema(currentSchema.properties[propertyName], remainingSegments, meta);
+      }
+    }
+  }, {
+    key: "handleRequired",
+    value: function handleRequired(parentSchema, propertyName, isRequired) {
+      // 如果required是布尔值，转换为数组形式
+      if (typeof parentSchema.required === 'boolean') {
+        return;
+      }
+      if (!parentSchema.required) {
+        parentSchema.required = [];
+      }
+      var requiredIndex = parentSchema.required.indexOf(propertyName);
+      if (isRequired && requiredIndex === -1) {
+        parentSchema.required.push(propertyName);
+      } else if (!isRequired && requiredIndex !== -1) {
+        parentSchema.required.splice(requiredIndex, 1);
+      }
+
+      // 如果 required 数组为空，删除它
+      if (parentSchema.required.length === 0) {
+        delete parentSchema.required;
+      }
+    }
+  }, {
+    key: "getFormSchema",
+    value: function getFormSchema() {
+      return this.schema;
+    }
+  }]);
+  return SchemaBuilder;
+}();

package/cjs/components/use-form/use-form-schema/index.d.ts

@@ -0,0 +1,3 @@
+export { SchemaBuilder } from "./form-schema-builder";
+export type { SchemaProperty } from "./form-schema-builder";
+//# sourceMappingURL=index.d.ts.map

package/cjs/components/use-form/use-form-schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/cjs/components/use-form/use-form-schema/index.js

@@ -0,0 +1,13 @@
+"use strict";
+"use client";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "SchemaBuilder", {
+  enumerable: true,
+  get: function get() {
+    return _formSchemaBuilder.SchemaBuilder;
+  }
+});
+var _formSchemaBuilder = require("./form-schema-builder");

package/cjs/components/use-form/use-form.d.ts

@@ -1,3 +1,4 @@
+import { SchemaBuilder } from './use-form-schema/form-schema-builder';
 import { ProviderProps, UseFormProps, UseFormSlotProps, ValidateFnConfig } from './use-form.type';
 import { ObjectType } from '../../common/type';
 declare const useForm: <T extends ObjectType>(props: UseFormProps<T>) => {
@@ -24,7 +25,9 @@ declare const useForm: <T extends ObjectType>(props: UseFormProps<T>) => {
             insertError: (name: string, index: number, error?: Error) => void;
             spliceError: (name: string, index: number) => void;
             scrollToField: (name: string, scrollIntoViewOptions?: ScrollIntoViewOptions) => void;
+            getFormSchema: () => import("./use-form-schema/form-schema-builder").SchemaProperty | undefined;
         };
+        formSchema: SchemaBuilder | null;
     };
     formFunc: {
         setValue: (vals: {
@@ -44,6 +47,7 @@ declare const useForm: <T extends ObjectType>(props: UseFormProps<T>) => {
         insertError: (name: string, index: number, error?: Error) => void;
         spliceError: (name: string, index: number) => void;
         scrollToField: (name: string, scrollIntoViewOptions?: ScrollIntoViewOptions) => void;
+        getFormSchema: () => import("./use-form-schema/form-schema-builder").SchemaProperty | undefined;
     };
 };
 export default useForm;

package/cjs/components/use-form/use-form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-form.d.ts","sourceRoot":"","sources":["use-form.ts"],"names":[],"mappings":"AA+BA,OAAO,EAEL,aAAa,EACb,YAAY,EACZ,gBAAgB,EAGhB,gBAAgB,EAEjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAe,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAI5D,QAAA,MAAM,OAAO;;;;;;;;;wBAoSC;gBAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;gBAAC,WAAW,CAAC,EAAE,OAAO,CAAA;aAAE;8BArPnB,MAAM;oCAgUD,OAAO,aAAoB,MAAM,IAAI;;6BAf3C,MAAM,KAAK,KAAK,GAAG,SAAS;;oCAdrB,MAAM,EAAE;sCA3RxC,MAAM,GAAG,MAAM,EAAE,WAAU,gBAAgB;qCA8VvB,MAAM,WAAW,gBAAgB;gCAhDzB,MAAM,SAAS,MAAM,UAAU,KAAK;gCAKpC,MAAM,SAAS,MAAM;kCAjJpD,MAAM,0BAAyB,qBAAqB;;;;;;oBA2EjD;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,WAAW,CAAC,EAAE,OAAO,CAAA;SAAE;0BArPnB,MAAM;gCAgUD,OAAO,aAAoB,MAAM,IAAI;;yBAf3C,MAAM,KAAK,KAAK,GAAG,SAAS;;gCAdrB,MAAM,EAAE;kCA3RxC,MAAM,GAAG,MAAM,EAAE,WAAU,gBAAgB;iCA8VvB,MAAM,WAAW,gBAAgB;4BAhDzB,MAAM,SAAS,MAAM,UAAU,KAAK;4BAKpC,MAAM,SAAS,MAAM;8BAjJpD,MAAM,0BAAyB,qBAAqB;;CAqb9D,CAAC;AAEF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"use-form.d.ts","sourceRoot":"","sources":["use-form.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AA2BtE,OAAO,EAEL,aAAa,EACb,YAAY,EACZ,gBAAgB,EAGhB,gBAAgB,EAEjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAe,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAI5D,QAAA,MAAM,OAAO;;;;;;;;;wBAqSC;gBAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;gBAAC,WAAW,CAAC,EAAE,OAAO,CAAA;aAAE;8BArPnB,MAAM;oCAoUD,OAAO,aAAoB,MAAM,IAAI;;6BAf3C,MAAM,KAAK,KAAK,GAAG,SAAS;;oCAdrB,MAAM,EAAE;sCA/RxC,MAAM,GAAG,MAAM,EAAE,WAAU,gBAAgB;qCAkWvB,MAAM,WAAW,gBAAgB;gCAhDzB,MAAM,SAAS,MAAM,UAAU,KAAK;gCAKpC,MAAM,SAAS,MAAM;kCArJpD,MAAM,0BAAyB,qBAAqB;;;;;;;;oBA2EjD;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,WAAW,CAAC,EAAE,OAAO,CAAA;SAAE;0BArPnB,MAAM;gCAoUD,OAAO,aAAoB,MAAM,IAAI;;yBAf3C,MAAM,KAAK,KAAK,GAAG,SAAS;;gCAdrB,MAAM,EAAE;kCA/RxC,MAAM,GAAG,MAAM,EAAE,WAAU,gBAAgB;iCAkWvB,MAAM,WAAW,gBAAgB;4BAhDzB,MAAM,SAAS,MAAM,UAAU,KAAK;4BAKpC,MAAM,SAAS,MAAM;8BArJpD,MAAM,0BAAyB,qBAAqB;;;CA4b9D,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/cjs/components/use-form/use-form.js

@@ -11,6 +11,7 @@ var _usePersistFn = _interopRequireDefault(require("../../common/use-persist-fn"
 var _attribute = require("../../utils/attribute");
 var _flat = require("../../utils/flat");
 var _useDefaultValue = require("../../common/use-default-value");
+var _formSchemaBuilder = require("./use-form-schema/form-schema-builder");
 var _immer = require("../../utils/immer");
 var _utils = require("../../utils");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
@@ -26,6 +27,7 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 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); }
 var globalKey = '__global__&&@@';
+var SUBMIT_TIMEOUT = 10;
 var emptyObj = {};
 var useForm = function useForm(props) {
   var _props$defaultValue = props.defaultValue,
@@ -70,7 +72,8 @@ var useForm = function useForm(props) {
       resetTime: 0,
       mounted: false,
       unmounted: false,
-      removeLock: false
+      removeLock: false,
+      schema: props.name ? new _formSchemaBuilder.SchemaBuilder(props.name) : null
     }),
     context = _React$useRef.current;
   var getValue = (0, _usePersistFn.default)(function (name) {
@@ -229,13 +232,13 @@ var useForm = function useForm(props) {
           _utils.docScroll.top -= scrollToError;
         }
       }
-    });
+    }, SUBMIT_TIMEOUT + 10);
   };
   var onChange = (0, _usePersistFn.default)(function (change) {
     var _props$onChange;
     var newValue = typeof change === 'function' ? (0, _immer.produce)(context.value, change) : change;
     context.value = newValue;
-    (_props$onChange = props.onChange) === null || _props$onChange === void 0 || _props$onChange.call(props, context.value);
+    (_props$onChange = props.onChange) === null || _props$onChange === void 0 || _props$onChange.call(props, newValue);
   });
   var scrollToField = (0, _usePersistFn.default)(function (name) {
     var _document;
@@ -338,6 +341,10 @@ var useForm = function useForm(props) {
     Object.keys(context.defaultValues).forEach(function (df) {
       var latestDefaultValue = getValue(df);
       if (latestDefaultValue === undefined) {
+        // todo: Form组件传了clearToUndefined时，加入这部分判断？
+        // if(context.value.hasOwnProperty(df) && clearToUndefined){
+        //   return;
+        // }
         setValue(_defineProperty({}, df, context.defaultValues[df]), {
           validate: false
         });
@@ -430,7 +437,7 @@ var useForm = function useForm(props) {
         var _other$onSubmit;
         submit();
         other === null || other === void 0 || (_other$onSubmit = other.onSubmit) === null || _other$onSubmit === void 0 || _other$onSubmit.call(other, e);
-      }, 10);
+      }, SUBMIT_TIMEOUT);
     };
   };
   var validateFieldset = function validateFieldset(name, config) {
@@ -523,6 +530,9 @@ var useForm = function useForm(props) {
         context.names.delete(n);
         delete context.defaultValues[n];
       }
+      if (context.errors[n]) {
+        delete context.errors[n];
+      }
       var finalReserveAble = (_props$reserveAble = props.reserveAble) !== null && _props$reserveAble !== void 0 ? _props$reserveAble : reserveAble;
       if (!finalReserveAble && !context.removeLock) {
         addRemove(n);
@@ -576,7 +586,11 @@ var useForm = function useForm(props) {
     validateFieldset: validateFieldset,
     insertError: insertError,
     spliceError: spliceError,
-    scrollToField: scrollToField
+    scrollToField: scrollToField,
+    getFormSchema: function getFormSchema() {
+      var _context$schema;
+      return (_context$schema = context.schema) === null || _context$schema === void 0 ? void 0 : _context$schema.getFormSchema();
+    }
   });
   var formConfig = React.useMemo(function () {
     return {
@@ -614,11 +628,6 @@ var useForm = function useForm(props) {
   // 默认值更新
   React.useEffect(function () {
     context.removeLock = false;
-    // 内部 onChange 改的 value, 不需要更新
-    if (props.value === context.value) {
-      if (!isControl) update();
-      return;
-    }
     if (initValidate && !context.resetTime) {
       var keys = Object.keys(context.validateMap).filter(function (key) {
         var oldValue = (0, _utils.deepGet)(preValue || emptyObj, key);
@@ -628,6 +637,7 @@ var useForm = function useForm(props) {
       validateFields(keys).catch(function () {});
     }
     update();
+    if (!isControl) return;
     // 默认值上位时会提前触发外部的onChange, 导致外部的多次setFormValue不能合并后生效的问题(ReactDOM.render方式渲染)
     setTimeout(updateDefaultValue);
     context.resetTime = 0;
@@ -649,7 +659,8 @@ var useForm = function useForm(props) {
     ProviderProps: {
       formValue: formValue,
       formConfig: formConfig,
-      formFunc: formFunc
+      formFunc: formFunc,
+      formSchema: context.schema
     },
     formFunc: formFunc
   };