@sheinx/hooks 3.8.0-beta.4 → 3.8.0-beta.41

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

@@ -1 +1 @@
-{"version":3,"file":"use-form-context.d.ts","sourceRoot":"","sources":["use-form-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,eAAO,MAAM,WAAW,oBAA+B,CAAC;AAExD,wBAAgB,UAAU,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAQ7E;AAED,wBAAgB,eAAe,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAG/C"}
+{"version":3,"file":"use-form-context.d.ts","sourceRoot":"","sources":["use-form-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,eAAO,MAAM,WAAW,oBAA+B,CAAC;AAExD,wBAAgB,UAAU,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAG7E;AAED,wBAAgB,eAAe,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAG/C"}

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

@@ -8,13 +8,19 @@ exports.useFormInstance = useFormInstance;
 exports.useFormRef = useFormRef;
 var _react = _interopRequireDefault(require("react"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _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 _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 var FormContext = exports.FormContext = /*#__PURE__*/_react.default.createContext({});
 function useFormRef() {
-  var ref = _react.default.useRef({});
-  var setFormRef = function setFormRef(formRef) {
-    ref.current = formRef;
-  };
-  return [ref.current, setFormRef];
+  var _React$useState = _react.default.useState({}),
+    _React$useState2 = _slicedToArray(_React$useState, 2),
+    formRef = _React$useState2[0],
+    setFormRef = _React$useState2[1];
+  return [formRef, setFormRef];
 }
 function useFormInstance() {
   var formCtx = _react.default.useContext(FormContext);

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

@@ -1,3 +1,4 @@
+import { SchemaProperty } from './use-form-schema/form-schema-builder';
 export interface FormRef<Value = any> {
     /**
      * @en return form value
@@ -51,5 +52,10 @@ export interface FormRef<Value = any> {
      * @cn 滚动到指定字段
      */
     scrollToField: (name: string, scrollIntoViewOptions?: ScrollIntoViewOptions) => void;
+    /**
+     * @en get form schema
+     * @cn 获取表单的 schema
+     */
+    getFormSchema: () => SchemaProperty | undefined;
 }
 //# sourceMappingURL=use-form-context.type.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-form-context.type.d.ts","sourceRoot":"","sources":["use-form-context.type.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,OAAO,CAAC,KAAK,GAAG,GAAG;IAClC;;;OAGG;IACH,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,GAAG,GAAG,KAAK,CAAC;IACzC;;;OAGG;IACH,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IACzD;;;OAGG;IACH,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5D;;;OAGG;IACH,uBAAuB,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IACtE;;;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,KAAK,IAAI,CAAC;IAC7C;;;OAGG;IACH,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,qBAAqB,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACtF"}
+{"version":3,"file":"use-form-context.type.d.ts","sourceRoot":"","sources":["use-form-context.type.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAEvE,MAAM,WAAW,OAAO,CAAC,KAAK,GAAG,GAAG;IAClC;;;OAGG;IACH,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,GAAG,GAAG,KAAK,CAAC;IACzC;;;OAGG;IACH,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IACzD;;;OAGG;IACH,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5D;;;OAGG;IACH,uBAAuB,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IACtE;;;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,KAAK,IAAI,CAAC;IAC7C;;;OAGG;IACH,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,qBAAqB,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAErF;;;OAGG;IACH,aAAa,EAAE,MAAM,cAAc,GAAG,SAAS,CAAC;CACjD"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-form-control.d.ts","sourceRoot":"","sources":["use-form-control.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,oBAAoB,EAAsB,MAAM,yBAAyB,CAAC;AA4BnF,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC;;kBAiJpC,CAAC,YAAY,GAAG,EAAE;;;;;EA4DrD"}
+{"version":3,"file":"use-form-control.d.ts","sourceRoot":"","sources":["use-form-control.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,oBAAoB,EAAsB,MAAM,yBAAyB,CAAC;AA4BnF,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC;;kBA0JpC,CAAC,YAAY,GAAG,EAAE;;;;;EA4DrD"}

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

@@ -57,7 +57,8 @@ function useFormControl(props) {
     defaultValue = props.defaultValue,
     rules = props.rules,
     onError = props.onError,
-    getValidateProps = props.getValidateProps;
+    getValidateProps = props.getValidateProps,
+    clearToUndefined = props.clearToUndefined;
   var _useFieldSetConsumer = (0, _fieldsetContext.useFieldSetConsumer)({
       name: props.name,
       bind: props.bind
@@ -115,7 +116,11 @@ 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];
         }
@@ -129,7 +134,11 @@ function useFormControl(props) {
       }
       if (!(0, _shallowEqual.shallowEqual)(_value2, latestInfo.valueState)) {
         if (_value2 === undefined && defaultValue !== undefined) {
-          setValueState(defaultValue);
+          if (clearToUndefined) {
+            setValueState(undefined);
+          } else {
+            setValueState(defaultValue);
+          }
         } else {
           setValueState(_value2);
         }

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-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/cjs/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/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,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;IAmLd,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,373 @@
+"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') {
+        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';
+                fieldSchemaInfo.items = {
+                  type: itemType
+                };
+              } else {
+                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/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