@sheinx/hooks 3.8.0-beta.9 → 3.8.0

package/esm/components/use-form/use-form-control/use-form-control.js

@@ -48,7 +48,8 @@ export default function useFormControl(props) {
     defaultValue = props.defaultValue,
     rules = props.rules,
     onError = props.onError,
-    getValidateProps = props.getValidateProps;
+    getValidateProps = props.getValidateProps,
+    clearToUndefined = props.clearToUndefined;
   var _useFieldSetConsumer = useFieldSetConsumer({
       name: props.name,
       bind: props.bind
@@ -95,7 +96,9 @@ export default function useFormControl(props) {
     var errors = arguments.length > 1 ? arguments[1] : undefined;
     var severErrors = arguments.length > 2 ? arguments[2] : undefined;
     if (!name) return;
-    if (isArray(name)) {
+    // 加入defaultValue的判断，让其只对 https://github.com/sheinsight/shineout-next/pull/742 的场景生效
+    // 如果不加入defaultValue的判断，会导致 8ea43144-36a5-403a-9147-59d54087a110 的问题
+    if (isArray(name) && defaultValue !== undefined) {
       var _value = getValue(name, formValue);
       var _error = getError(name, errors, severErrors);
       if (_error !== errorState) {
@@ -106,7 +109,11 @@ export default function useFormControl(props) {
       var nextValue = [];
       name.forEach(function (n, index) {
         if (_value[index] === undefined && dv[index] !== undefined) {
-          nextValue[index] = dv[index];
+          if (clearToUndefined) {
+            nextValue[index] = undefined;
+          } else {
+            nextValue[index] = dv[index];
+          }
         } else {
           nextValue[index] = _value[index];
         }
@@ -120,7 +127,11 @@ export default function useFormControl(props) {
       }
       if (!shallowEqual(_value2, latestInfo.valueState)) {
         if (_value2 === undefined && defaultValue !== undefined) {
-          setValueState(defaultValue);
+          if (clearToUndefined) {
+            setValueState(undefined);
+          } else {
+            setValueState(defaultValue);
+          }
         } else {
           setValueState(_value2);
         }
@@ -213,8 +224,27 @@ export default function useFormControl(props) {
     if (onChangePo) onChangePo.apply(void 0, [v].concat(other));
     if (validateFieldSet) validateFieldSet();
   });
+  var initError = usePersistFn(function () {
+    var errors = formFunc === null || formFunc === void 0 ? void 0 : formFunc.getErrors();
+    if (isArray(name)) {
+      for (var i = 0; i < name.length; i++) {
+        var n = name[i];
+        var currentErrorInForm = errors === null || errors === void 0 ? void 0 : errors[n];
+        if (currentErrorInForm) {
+          setErrorState(currentErrorInForm);
+          break;
+        }
+      }
+    } else {
+      var _currentErrorInForm = errors === null || errors === void 0 ? void 0 : errors[name];
+      if (_currentErrorInForm) {
+        setErrorState(_currentErrorInForm);
+      }
+    }
+  });
   useEffect(function () {
     if (inForm && controlFunc) {
+      initError();
       if (isArray(name)) {
         var dv = isArray(defaultValue) ? defaultValue : [];
         name.forEach(function (n, index) {

package/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/components/use-form/use-form-item/form-item-context.js

@@ -3,4 +3,5 @@
 import * as React from 'react';
 export var FormItemContext = /*#__PURE__*/React.createContext({
   updateError: function updateError() {}
-});
+});
+FormItemContext.displayName = 'FormItemContext';

package/esm/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/esm/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/esm/components/use-form/use-form-item/index.js

@@ -1,2 +1,3 @@
 "use client";
-export { default, default as useFormItem } from "./use-form-item";
+export { default, default as useFormItem } from "./use-form-item";
+export { FormItemContext } from "./form-item-context";

package/esm/components/use-form/use-form-item/use-form-item.d.ts

@@ -3,7 +3,7 @@ import type { FormItemContextValueType } from './form-item-context';
 declare const UseFormItem: () => {
     Provider: React.Provider<FormItemContextValueType>;
     ProviderValue: FormItemContextValueType;
-    errors: (Error | undefined)[];
+    errors: Error[];
     labelConfig: import("..").FormCommonConfig;
     attributes: Record<string, string>;
     showError: boolean;

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

@@ -0,0 +1,50 @@
+interface SchemaMeta {
+    type?: string;
+    required?: boolean;
+    title?: string;
+    format?: string;
+    items?: any;
+    enum?: any[] | {
+        anyOf?: any[];
+        oneOf?: 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/esm/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,CAAC,EAAE,GAAG,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC;IAChD,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;IAuLd,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/esm/components/use-form/use-form-schema/form-schema-builder.js

@@ -0,0 +1,371 @@
+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); }
+export var 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') {
+        var componentName = componentElement.type.displayName || componentElement.type.name;
+        var format = componentElement.props.format || componentElement.props.keygen;
+        switch (componentName) {
+          case 'ShineoutInput':
+          case 'ShineoutEditableArea':
+            fieldSchemaInfo.type = 'string';
+            break;
+          case 'ShineoutInputNumber':
+            fieldSchemaInfo.type = 'number';
+            break;
+          case 'ShineoutInputPassword':
+            fieldSchemaInfo.type = 'string';
+            break;
+          case 'ShineoutTextarea':
+            fieldSchemaInfo.type = 'string';
+            break;
+          case 'ShineoutCascader':
+          case 'ShineoutSelect':
+          case 'ShineoutTreeSelect':
+            {
+              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';
+                if (itemType !== 'undefined') {
+                  fieldSchemaInfo.items = {
+                    type: itemType
+                  };
+                }
+              } else {
+                if (itemType !== 'undefined') {
+                  fieldSchemaInfo.type = itemType;
+                }
+              }
+              if (itemType === 'object') {
+                // 对于对象类型，使用 oneOf 而不是 enum
+                if (componentElement.props.multiple) {
+                  fieldSchemaInfo.items.oneOf = componentElement.props.data.map(function (item) {
+                    return {
+                      const: item,
+                      title: (item === null || item === void 0 ? void 0 : item.title) || JSON.stringify(item)
+                    };
+                  });
+                } else {
+                  fieldSchemaInfo.oneOf = componentElement.props.data.map(function (item) {
+                    return {
+                      const: item,
+                      title: (item === null || item === void 0 ? void 0 : item.title) || JSON.stringify(item)
+                    };
+                  });
+                }
+              } else {
+                fieldSchemaInfo.enum = componentElement.props.data.map(function (item) {
+                  return (item === null || item === void 0 ? void 0 : item[format]) || item;
+                });
+              }
+              break;
+            }
+          case 'ShineoutDatePicker':
+            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 'ShineoutCheckbox':
+          case 'ShineoutCheckboxGroup':
+            {
+              if (typeof componentElement.props.keygen !== 'boolean') {
+                if (typeof format === 'string') {
+                  var _data$2;
+                  itemType = _typeof(data === null || data === void 0 ? void 0 : data[0]) === 'object' ? _typeof(data === null || data === void 0 || (_data$2 = data[0]) === null || _data$2 === void 0 ? void 0 : _data$2[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]);
+              }
+              fieldSchemaInfo.type = 'array';
+              fieldSchemaInfo.items = {
+                type: itemType
+              };
+
+              // ShineoutCheckboxGroup 有 data 时（多选的）
+              if (itemType === 'object') {
+                fieldSchemaInfo.items.oneOf = componentElement.props.data.map(function (item) {
+                  return {
+                    const: item,
+                    title: (item === null || item === void 0 ? void 0 : item.title) || JSON.stringify(item)
+                  };
+                });
+              } else {
+                fieldSchemaInfo.items.enum = componentElement.props.data.map(function (item) {
+                  return (item === null || item === void 0 ? void 0 : item[format]) || item;
+                });
+              }
+              break;
+            }
+          case 'ShineoutRadio':
+          case 'ShineoutRadioGroup':
+            {
+              if (typeof componentElement.props.keygen !== 'boolean') {
+                if (typeof format === 'string') {
+                  var _data$3;
+                  itemType = _typeof(data === null || data === void 0 ? void 0 : data[0]) === 'object' ? _typeof(data === null || data === void 0 || (_data$3 = data[0]) === null || _data$3 === void 0 ? void 0 : _data$3[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]);
+              }
+              fieldSchemaInfo.type = itemType;
+
+              // ShineoutRadioGroup 有 data 时（单选的）
+              if (itemType === 'object') {
+                fieldSchemaInfo.oneOf = componentElement.props.data.map(function (item) {
+                  return {
+                    const: item,
+                    title: (item === null || item === void 0 ? void 0 : item.title) || JSON.stringify(item)
+                  };
+                });
+              } else {
+                fieldSchemaInfo.enum = componentElement.props.data.map(function (item) {
+                  return (item === null || item === void 0 ? void 0 : item[format]) || item;
+                });
+              }
+              break;
+            }
+          case 'ShineoutSwitch':
+            fieldSchemaInfo.type = 'boolean';
+            break;
+          case 'ShineoutSlider':
+          case 'ShineoutRate':
+            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/esm/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/esm/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/esm/components/use-form/use-form-schema/index.js

@@ -0,0 +1,2 @@
+"use client";
+export { SchemaBuilder } from "./form-schema-builder";

package/esm/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/esm/components/use-form/use-form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-form.d.ts","sourceRoot":"","sources":["use-form.ts"],"names":[],"mappings":"AAiCA,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;;;;;;;;;wBAySC;gBAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;gBAAC,WAAW,CAAC,EAAE,OAAO,CAAA;aAAE;8BAzPnB,MAAM;oCAwUD,OAAO,aAAoB,MAAM,IAAI;;6BAf3C,MAAM,KAAK,KAAK,GAAG,SAAS;;oCAdrB,MAAM,EAAE;sCAnSxC,MAAM,GAAG,MAAM,EAAE,WAAU,gBAAgB;qCAsWvB,MAAM,WAAW,gBAAgB;gCAhDzB,MAAM,SAAS,MAAM,UAAU,KAAK;gCAKpC,MAAM,SAAS,MAAM;kCAzJpD,MAAM,0BAAyB,qBAAqB;;;;;;;;oBA+EjD;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,WAAW,CAAC,EAAE,OAAO,CAAA;SAAE;0BAzPnB,MAAM;gCAwUD,OAAO,aAAoB,MAAM,IAAI;;yBAf3C,MAAM,KAAK,KAAK,GAAG,SAAS;;gCAdrB,MAAM,EAAE;kCAnSxC,MAAM,GAAG,MAAM,EAAE,WAAU,gBAAgB;iCAsWvB,MAAM,WAAW,gBAAgB;4BAhDzB,MAAM,SAAS,MAAM,UAAU,KAAK;4BAKpC,MAAM,SAAS,MAAM;8BAzJpD,MAAM,0BAAyB,qBAAqB;;;CA4b9D,CAAC;AAEF,eAAe,OAAO,CAAC"}