@1money/react-ui 1.15.3 → 1.17.0

package/es/components/Form/FormItem.js

@@ -0,0 +1,165 @@
+import _defineProperty from "@babel/runtime/helpers/esm/defineProperty";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useContext, useMemo } from 'react';
+import { default as classnames, joinCls } from '../../utils/classnames';
+import Typography from '../Typography';
+import { FormContext } from './Form';
+import { CSS_VAR_LABEL_WIDTH, CSS_VAR_WRAPPER_WIDTH, DEFAULT_VALUE_PROP } from './constants';
+import { toPercent, wrapValidate } from './helper';
+import { FormItemContent } from './FormItemContent';
+import { FallbackFormProvider, useFormItemContext } from './useFormItemContext';
+import { useFormItemWatch } from './useFormItemWatch';
+import { useValidationTrigger } from './useValidationTrigger';
+/**
+ * Runtime type guard for render-prop children.
+ */
+var isRenderFnChild = function isRenderFnChild(child) {
+  return typeof child === 'function';
+};
+/**
+ * Form field wrapper that bridges `react-hook-form`'s Controller with the Form
+ * layout system, validation status display, and configurable trigger behavior.
+ *
+ * When a `name` is provided, the field is registered with `react-hook-form` via
+ * a `Controller` and supports validation rules, dependencies, and status feedback.
+ * Without a `name`, it renders as a free wrapper for uncontrolled content.
+ *
+ * Supports two child patterns:
+ * - **React element**: automatically bound via `React.cloneElement` with value/onChange/onBlur.
+ * - **Render-prop function**: receives `{ field, fieldState, form, values }` for full control.
+ *
+ * @template TFieldValues - The shape of the form values.
+ * @param props - {@link FormItemProps}
+ *
+ * @example
+ * ```tsx
+ * // Element child (auto-bound)
+ * <FormItem name="email" label="Email" rules={{ required: true }}>
+ *   <Input placeholder="Enter email" />
+ * </FormItem>
+ *
+ * // Render-prop child
+ * <FormItem name="agree">
+ *   {({ field }) => <Checkbox {...field} />}
+ * </FormItem>
+ * ```
+ */
+function FormItemInner(props) {
+  var name = props.name,
+    label = props.label,
+    required = props.required,
+    rules = props.rules,
+    defaultValue = props.defaultValue,
+    help = props.help,
+    extra = props.extra,
+    validateStatus = props.validateStatus,
+    dependencies = props.dependencies,
+    watchNames = props.watchNames,
+    shouldUpdate = props.shouldUpdate,
+    validateTrigger = props.validateTrigger,
+    validateFirst = props.validateFirst,
+    validateDebounce = props.validateDebounce,
+    noStyle = props.noStyle,
+    _props$valuePropName = props.valuePropName,
+    valuePropName = _props$valuePropName === void 0 ? DEFAULT_VALUE_PROP : _props$valuePropName,
+    className = props.className,
+    labelCol = props.labelCol,
+    wrapperCol = props.wrapperCol,
+    children = props.children;
+  var classes = classnames('form-item');
+  var _useFormItemContext = useFormItemContext(name),
+    ctx = _useFormItemContext.ctx,
+    methods = _useFormItemContext.methods,
+    control = _useFormItemContext.control,
+    trigger = _useFormItemContext.trigger;
+  var _useFormItemWatch = useFormItemWatch({
+      control: control,
+      methods: methods,
+      dependencies: dependencies,
+      watchNames: watchNames,
+      shouldUpdate: shouldUpdate,
+      name: name
+    }),
+    allValues = _useFormItemWatch.allValues,
+    depValues = _useFormItemWatch.depValues,
+    shouldRender = _useFormItemWatch.shouldRender;
+  var _useValidationTrigger = useValidationTrigger({
+      name: name,
+      trigger: trigger,
+      validateTrigger: validateTrigger,
+      validateDebounce: validateDebounce,
+      dependencies: dependencies,
+      depValues: depValues
+    }),
+    withTrigger = _useValidationTrigger.withTrigger;
+  var renderFn = isRenderFnChild(children) ? children : null;
+  var isRequired = required !== null && required !== void 0 ? required : !!(rules === null || rules === void 0 ? void 0 : rules.required);
+  var showRequired = (ctx === null || ctx === void 0 ? void 0 : ctx.requiredMark) !== false;
+  var labelWidth = useMemo(function () {
+    return toPercent(labelCol !== null && labelCol !== void 0 ? labelCol : ctx === null || ctx === void 0 ? void 0 : ctx.labelCol);
+  }, [labelCol, ctx === null || ctx === void 0 ? void 0 : ctx.labelCol]);
+  var wrapperWidth = useMemo(function () {
+    return toPercent(wrapperCol !== null && wrapperCol !== void 0 ? wrapperCol : ctx === null || ctx === void 0 ? void 0 : ctx.wrapperCol);
+  }, [wrapperCol, ctx === null || ctx === void 0 ? void 0 : ctx.wrapperCol]);
+  var mergedRules = useMemo(function () {
+    if (!(rules === null || rules === void 0 ? void 0 : rules.validate) || !validateFirst) return rules;
+    var validate = wrapValidate(rules.validate, validateFirst);
+    if (validate === rules.validate) return rules;
+    return Object.assign(Object.assign({}, rules), {
+      validate: validate
+    });
+  }, [rules, validateFirst]);
+  var contentProps = useMemo(function () {
+    return {
+      name: name,
+      control: control,
+      methods: methods,
+      rules: mergedRules,
+      defaultValue: defaultValue,
+      validateStatus: validateStatus,
+      valuePropName: valuePropName,
+      help: help,
+      extra: extra,
+      ctx: ctx,
+      children: children,
+      renderFn: renderFn,
+      allValues: allValues,
+      shouldUpdate: shouldUpdate,
+      shouldRender: shouldRender,
+      withTrigger: withTrigger
+    };
+  }, [name, control, methods, mergedRules, defaultValue, validateStatus, valuePropName, help, extra, ctx, children, renderFn, allValues, shouldUpdate, shouldRender, withTrigger]);
+  if (noStyle) {
+    return _jsx(FormItemContent, Object.assign({}, contentProps));
+  }
+  var rootStyle = _defineProperty(_defineProperty({}, CSS_VAR_LABEL_WIDTH, labelWidth), CSS_VAR_WRAPPER_WIDTH, wrapperWidth);
+  return _jsxs("div", {
+    className: classes('root', joinCls(className, (ctx === null || ctx === void 0 ? void 0 : ctx.layout) && classes("layout-".concat(ctx.layout)))),
+    "data-form-item-name": name ? String(name) : undefined,
+    style: rootStyle,
+    children: [label && _jsxs("div", {
+      className: classes('label', joinCls(showRequired && isRequired && classes('label-required'))),
+      children: [_jsx(Typography.Label, {
+        size: 's',
+        children: label
+      }), (ctx === null || ctx === void 0 ? void 0 : ctx.colon) && _jsx("span", {
+        className: classes('colon'),
+        children: ":"
+      })]
+    }), _jsx("div", {
+      className: classes('control'),
+      children: _jsx(FormItemContent, Object.assign({}, contentProps))
+    })]
+  });
+}
+export function FormItem(props) {
+  var ctx = useContext(FormContext);
+  if (ctx === null || ctx === void 0 ? void 0 : ctx.methods) {
+    return _jsx(FormItemInner, Object.assign({}, props));
+  }
+  return _jsx(FallbackFormProvider, {
+    children: _jsx(FormItemInner, Object.assign({}, props))
+  });
+}
+export default FormItem;
+//# sourceMappingURL=data:application/json;charset=utf8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbImNvbXBvbmVudHMvRm9ybS9Gb3JtSXRlbS5qcyIsImNvbXBvbmVudHMvc3JjL2NvbXBvbmVudHMvRm9ybS9Gb3JtSXRlbS50c3giXSwibmFtZXMiOlsianN4IiwiX2pzeCIsImpzeHMiLCJfanN4cyIsInVzZUNvbnRleHQiLCJ1c2VNZW1vIiwiZGVmYXVsdCIsImNsYXNzbmFtZXMiLCJqb2luQ2xzIiwiVHlwb2dyYXBoeSIsIkZvcm1Db250ZXh0IiwiQ1NTX1ZBUl9MQUJFTF9XSURUSCIsIkNTU19WQVJfV1JBUFBFUl9XSURUSCIsIkRFRkFVTFRfVkFMVUVfUFJPUCIsInRvUGVyY2VudCIsIndyYXBWYWxpZGF0ZSIsIkZvcm1JdGVtQ29udGVudCIsIkZhbGxiYWNrRm9ybVByb3ZpZGVyIiwidXNlRm9ybUl0ZW1Db250ZXh0IiwidXNlRm9ybUl0ZW1XYXRjaCIsInVzZVZhbGlkYXRpb25UcmlnZ2VyIiwiaXNSZW5kZXJGbkNoaWxkIiwiY2hpbGQiLCJGb3JtSXRlbUlubmVyIiwicHJvcHMiLCJuYW1lIiwibGFiZWwiLCJyZXF1aXJlZCIsInJ1bGVzIiwiZGVmYXVsdFZhbHVlIiwiaGVscCIsImV4dHJhIiwidmFsaWRhdGVTdGF0dXMiLCJkZXBlbmRlbmNpZXMiLCJ3YXRjaE5hbWVzIiwic2hvdWxkVXBkYXRlIiwidmFsaWRhdGVUcmlnZ2VyIiwidmFsaWRhdGVGaXJzdCIsInZhbGlkYXRlRGVib3VuY2UiLCJub1N0eWxlIiwiX3Byb3BzJHZhbHVlUHJvcE5hbWUiLCJ2YWx1ZVByb3BOYW1lIiwiY2xhc3NOYW1lIiwibGFiZWxDb2wiLCJ3cmFwcGVyQ29sIiwiY2hpbGRyZW4iLCJjbGFzc2VzIiwiX3VzZUZvcm1JdGVtQ29udGV4dCIsImN0eCIsIm1ldGhvZHMiLCJjb250cm9sIiwidHJpZ2dlciIsIl91c2VGb3JtSXRlbVdhdGNoIiwiYWxsVmFsdWVzIiwiZGVwVmFsdWVzIiwic2hvdWxkUmVuZGVyIiwiX3VzZVZhbGlkYXRpb25UcmlnZ2VyIiwid2l0aFRyaWdnZXIiLCJyZW5kZXJGbiIsImlzUmVxdWlyZWQiLCJzaG93UmVxdWlyZWQiLCJyZXF1aXJlZE1hcmsiLCJsYWJlbFdpZHRoIiwid3JhcHBlcldpZHRoIiwibWVyZ2VkUnVsZXMiLCJ2YWxpZGF0ZSIsIk9iamVjdCIsImFzc2lnbiIsImNvbnRlbnRQcm9wcyIsInJvb3RTdHlsZSIsIl9kZWZpbmVQcm9wZXJ0eSIsImxheW91dCIsImNvbmNhdCIsIlN0cmluZyIsInVuZGVmaW5lZCIsInN0eWxlIiwiTGFiZWwiLCJzaXplIiwiY29sb24iLCJGb3JtSXRlbSJdLCJtYXBwaW5ncyI6IjtBQUFBLFNBQVNBLEdBQUcsSUFBSUMsSUFBSSxFQUFFQyxJQUFJLElBQUlDLEtBQUssUUFBUSxtQkFBbUI7QUNBOUQsU0FBU0MsVUFBVSxFQUFFQyxPQUFPLFFBQVEsT0FBTztBQUMzQyxTQUFTQyxPQUFPLElBQUlDLFVBQVUsRUFBRUMsT0FBTyxRQUFRLHdCQUF3QjtBQUN2RSxPQUFPQyxVQUFVLE1BQU0sZUFBZTtBQUV0QyxTQUFTQyxXQUFXLFFBQVEsUUFBUTtBQUNwQyxTQUFTQyxtQkFBbUIsRUFBRUMscUJBQXFCLEVBQUVDLGtCQUFrQixRQUFRLGFBQWE7QUFDNUYsU0FBU0MsU0FBUyxFQUFFQyxZQUFZLFFBQVEsVUFBVTtBQUNsRCxTQUFTQyxlQUFlLFFBQVEsbUJBQW1CO0FBQ25ELFNBQVNDLG9CQUFvQixFQUFFQyxrQkFBa0IsUUFBUSxzQkFBc0I7QUFDL0UsU0FBU0MsZ0JBQWdCLFFBQVEsb0JBQW9CO0FBQ3JELFNBQVNDLG9CQUFvQixRQUFRLHdCQUF3QjtBQUc3RDtBRERBO0FBQ0E7QUNHQSxJQUFNQyxlQUFlLEdBQUcsU0FBbEJBLGVBQWVBLENBQ25CQyxLQUE4QztFQUFBLE9BQ0YsT0FBT0EsS0FBSyxLQUFLLFVBQVU7QUFBQTtBQUV6RTtBREpBO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7QUFDQTtB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QUFBLElBQUhBLEdBQUcsS0FBQSxLQUFBLENBQUEsR0FBQSxLQUFBLENBQUEsR0FBSEEsR0FBRyxDQUFFOEIsS0FBSyxLQUFJN0UsSUFBQSxDQUFBLE1BQUEsRUFBQTtRQUFNeUMsU0FBUyxFQUFFSSxPQUFPLENBQUMsT0FBTyxDQUFDO1FBQUFELFFBQUEsRUFBQTtNQUFBLENBQUEsQ0FBVTtJQUFBLENBQUEsQ0FFN0QsRUFDRDVDLElBQUEsQ0FBQSxLQUFBLEVBQUE7TUFBS3lDLFNBQVMsRUFBRUksT0FBTyxDQUFDLFNBQVMsQ0FBQztNQUFBRCxRQUFBLEVBQ2hDNUMsSUFBQSxDQUFDZSxlQUFlLEVBQUFrRCxNQUFBLENBQUFDLE1BQUEsQ0FBQSxDQUFBLENBQUEsRUFBS0MsWUFBWSxDQUFBO0lBQUksQ0FBQSxDQUNqQztFQUFBLENBQUEsQ0FDRjtBQUVWO0FBRUEsT0FBTSxTQUFVVyxRQUFRQSxDQUFpRHZELEtBQWtDLEVBQUE7RUFDekcsSUFBTXdCLEdBQUcsR0FBRzVDLFVBQVUsQ0FBQ00sV0FBVyxDQUFDO0VBRW5DLElBQUlzQyxHQUFHLEtBQUEsSUFBQSxJQUFIQSxHQUFHLEtBQUEsS0FBQSxDQUFBLEdBQUEsS0FBQSxDQUFBLEdBQUhBLEdBQUcsQ0FBRUMsT0FBTyxFQUFFO0lBQ2hCLE9BQU9oRCxJQUFBLENBQUNzQixhQUFhLEVBQUEyQyxNQUFBLENBQUFDLE1BQUEsQ0FBQSxDQUFBLENBQUEsRUFBSzNDLEtBQUssQ0FBQSxDQUFJO0VBQ3JDO0VBRUEsT0FDRXZCLElBQUEsQ0FBQ2dCLG9CQUFvQixFQUFBO0lBQUE0QixRQUFBLEVBQ25CNUMsSUFBQSxDQUFDc0IsYUFBYSxFQUFBMkMsTUFBQSxDQUFBQyxNQUFBLENBQUEsQ0FBQSxDQUFBLEVBQUszQyxLQUFLLENBQUE7RUFBSSxDQUFBLENBQ1A7QUFFM0I7QUFFQSxlQUFldUQsUUFBUSIsImZpbGUiOiJjb21wb25lbnRzL0Zvcm0vRm9ybUl0ZW0uanMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBqc3ggYXMgX2pzeCwganN4cyBhcyBfanN4cyB9IGZyb20gXCJyZWFjdC9qc3gtcnVudGltZVwiO1xuaW1wb3J0IHsgdXNlQ29udGV4dCwgdXNlTWVtbyB9IGZyb20gJ3JlYWN0JztcbmltcG9ydCB7IGRlZmF1bHQgYXMgY2xhc3NuYW1lcywgam9pbkNscyB9IGZyb20gJy4uLy4uL3V0aWxzL2NsYXNzbmFtZXMnO1xuaW1wb3J0IFR5cG9ncmFwaHkgZnJvbSAnLi4vVHlwb2dyYXBoeSc7XG5pbXBvcnQgeyBGb3JtQ29udGV4dCB9IGZyb20gJy4vRm9ybSc7XG5pbXBvcnQgeyBDU1NfVkFSX0xBQkVMX1dJRFRILCBDU1NfVkFSX1dSQVBQRVJfV0lEVEgsIERFRkFVTFRfVkFMVUVfUFJPUCB9IGZyb20gJy4vY29uc3RhbnRzJztcbmltcG9ydCB7IHRvUGVyY2VudCwgd3JhcFZhbGlkYXRlIH0gZnJvbSAnLi9oZWxwZXInO1xuaW1wb3J0IHsgRm9ybUl0ZW1Db250ZW50IH0gZnJvbSAnLi9Gb3JtSXRlbUNvbnRlbnQnO1xuaW1wb3J0IHsgRmFsbGJhY2tGb3JtUHJvdmlkZXIsIHVzZUZvcm1JdGVtQ29udGV4dCB9IGZyb20gJy4vdXNlRm9ybUl0ZW1Db250ZXh0JztcbmltcG9ydCB7IHVzZUZvcm1JdGVtV2F0Y2ggfSBmcm9tICcuL3VzZUZvcm1JdGVtV2F0Y2gnO1xuaW1wb3J0IHsgdXNlVmFsaWRhdGlvblRyaWdnZXIgfSBmcm9tICcuL3VzZVZhbGlkYXRpb25UcmlnZ2VyJztcbi8qKlxuICogUnVudGltZSB0eXBlIGd1YXJkIGZvciByZW5kZXItcHJvcCBjaGlsZHJlbi5cbiAqL1xuY29uc3QgaXNSZW5kZXJGbkNoaWxkID0gKGNoaWxkKSA9PiB0eXBlb2YgY2hpbGQgPT09ICdmdW5jdGlvbic7XG4vKipcbiAqIEZvcm0gZmllbGQgd3JhcHBlciB0aGF0IGJyaWRnZXMgYHJlYWN0LWhvb2stZm9ybWAncyBDb250cm9sbGVyIHdpdGggdGhlIEZvcm1cbiAqIGxheW91dCBzeXN0ZW0sIHZhbGlkYXRpb24gc3RhdHVzIGRpc3BsYXksIGFuZCBjb25maWd1cmFibGUgdHJpZ2dlciBiZWhhdmlvci5cbiAqXG4gKiBXaGVuIGEgYG5hbWVgIGlzIHByb3ZpZGVkLCB0aGUgZmllbGQgaXMgcmVnaXN0ZXJlZCB3aXRoIGByZWFjdC1ob29rLWZvcm1gIHZpYVxuICogYSBgQ29udHJvbGxlcmAgYW5kIHN1cHBvcnRzIHZhbGlkYXRpb24gcnVsZXMsIGRlcGVuZGVuY2llcywgYW5kIHN0YXR1cyBmZWVkYmFjay5cbiAqIFdpdGhvdXQgYSBgbmFtZWAsIGl0IHJlbmRlcnMgYXMgYSBmcmVlIHdyYXBwZXIgZm9yIHVuY29udHJvbGxlZCBjb250ZW50LlxuICpcbiAqIFN1cHBvcnRzIHR3byBjaGlsZCBwYXR0ZXJuczpcbiAqIC0gKipSZWFjdCBlbGVtZW50Kio6IGF1dG9tYXRpY2FsbHkgYm91bmQgdmlhIGBSZWFjdC5jbG9uZUVsZW1lbnRgIHdpdGggdmFsdWUvb25DaGFuZ2Uvb25CbHVyLlxuICogLSAqKlJlbmRlci1wcm9wIGZ1bmN0aW9uKio6IHJlY2VpdmVzIGB7IGZpZWxkLCBmaWVsZFN0YXRlLCBmb3JtLCB2YWx1ZXMgfWAgZm9yIGZ1bGwgY29udHJvbC5cbiAqXG4gKiBAdGVtcGxhdGUgVEZpZWxkVmFsdWVzIC0gVGhlIHNoYXBlIG9mIHRoZSBmb3JtIHZhbHVlcy5cbiAqIEBwYXJhbSBwcm9wcyAtIHtAbGluayBGb3JtSXRlbVByb3BzfVxuICpcbiAqIEBleGFtcGxlXG4gKiBgYGB0c3hcbiAqIC8vIEVsZW1lbnQgY2hpbGQgKGF1dG8tYm91bmQpXG4gKiA8Rm9ybUl0ZW0gbmFtZT1cImVtYWlsXCIgbGFiZWw9XCJFbWFpbFwiIHJ1bGVzPXt7IHJlcXVpcmVkOiB0cnVlIH19PlxuICogICA8SW5wdXQgcGxhY2Vob2xkZXI9XCJFbnRlciBlbWFpbFwiIC8+XG4gKiA8L0Zvcm1JdGVtPlxuICpcbiAqIC8vIFJlbmRlci1wcm9wIGNoaWxkXG4gKiA8Rm9ybUl0ZW0gbmFtZT1cImFncmVlXCI+XG4gKiAgIHsoeyBmaWVsZCB9KSA9PiA8Q2hlY2tib3ggey4uLmZpZWxkfSAvPn1cbiAqIDwvRm9ybUl0ZW0+XG4gKiBgYGBcbiAqL1xuZnVuY3Rpb24gRm9ybUl0ZW1Jbm5lcihwcm9wcykge1xuICAgIGNvbnN0IHsgbmFtZSwgbGFiZWwsIHJlcXVpcmVkLCBydWxlcywgZGVmYXVsdFZhbHVlLCBoZWxwLCBleHRyYSwgdmFsaWRhdGVTdGF0dXMsIGRlcGVuZGVuY2llcywgd2F0Y2hOYW1lcywgc2hvdWxkVXBkYXRlLCB2YWxpZGF0ZVRyaWdnZXIsIHZhbGlkYXRlRmlyc3QsIHZhbGlkYXRlRGVib3VuY2UsIG5vU3R5bGUsIHZhbHVlUHJvcE5hbWUgPSBERUZBVUxUX1ZBTFVFX1BST1AsIGNsYXNzTmFtZSwgbGFiZWxDb2wsIHdyYXBwZXJDb2wsIGNoaWxkcmVuLCB9ID0gcHJvcHM7XG4gICAgY29uc3QgY2xhc3NlcyA9IGNsYXNzbmFtZXMoJ2Zvcm0taXRlbScpO1xuICAgIGNvbnN0IHsgY3R4LCBtZXRob2RzLCBjb250cm9sLCB0cmlnZ2VyIH0gPSB1c2VGb3JtSXRlbUNvbnRleHQobmFtZSk7XG4gICAgY29uc3QgeyBhbGxWYWx1ZXMsIGRlcFZhbHVlcywgc2hvdWxkUmVuZGVyIH0gPSB1c2VGb3JtSXRlbVdhdGNoKHtcbiAgICAgICAgY29udHJvbCxcbiAgICAgICAgbWV0aG9kcyxcbiAgICAgICAgZGVwZW5kZW5jaWVzLFxuICAgICAgICB3YXRjaE5hbWVzLFxuICAgICAgICBzaG91bGRVcGRhdGUsXG4gICAgICAgIG5hbWUsXG4gICAgfSk7XG4gICAgY29uc3QgeyB3aXRoVHJpZ2dlciB9ID0gdXNlVmFsaWRhdGlvblRyaWdnZXIoe1xuICAgICAgICBuYW1lLFxuICAgICAgICB0cmlnZ2VyLFxuICAgICAgICB2YWxpZGF0ZVRyaWdnZXIsXG4gICAgICAgIHZhbGlkYXRlRGVib3VuY2UsXG4gICAgICAgIGRlcGVuZGVuY2llcyxcbiAgICAgICAgZGVwVmFsdWVzLFxuICAgIH0pO1xuICAgIGNvbnN0IHJlbmRlckZuID0gaXNSZW5kZXJGbkNoaWxkKGNoaWxkcmVuKSA/IGNoaWxkcmVuIDogbnVsbDtcbiAgICBjb25zdCBpc1JlcXVpcmVkID0gcmVxdWlyZWQgIT09IG51bGwgJiYgcmVxdWlyZWQgIT09IHZvaWQgMCA/IHJlcXVpcmVkIDogISEocnVsZXMgPT09IG51bGwgfHwgcnVsZXMgPT09IHZvaWQgMCA/IHZvaWQgMCA6IHJ1bGVzLnJlcXVpcmVkKTtcbiAgICBjb25zdCBzaG93UmVxdWlyZWQgPSAoY3R4ID09PSBudWxsIHx8IGN0eCA9PT0gdm9pZCAwID8gdm9pZCAwIDogY3R4LnJlcXVpcmVkTWFyaykgIT09IGZhbHNlO1xuICAgIGNvbnN0IGxhYmVsV2lkdGggPSB1c2VNZW1vKCgpID0+IHRvUGVyY2VudChsYWJlbENvbCAhPT0gbnVsbCAmJiBsYWJlbENvbCAhPT0gdm9pZCAwID8gbGFiZWxDb2wgOiBjdHggPT09IG51bGwgfHwgY3R4ID09PSB2b2lkIDAgPyB2b2lkIDAgOiBjdHgubGFiZWxDb2wpLCBbbGFiZWxDb2wsIGN0eCA9PT0gbnVsbCB8fCBjdHggPT09IHZvaWQgMCA/IHZvaWQgMCA6IGN0eC5sYWJlbENvbF0pO1xuICAgIGNvbnN0IHdyYXBwZXJXaWR0aCA9IHVzZU1lbW8oKCkgPT4gdG9QZXJjZW50KHdyYXBwZXJDb2wgIT09IG51bGwgJiYgd3JhcHBlckNvbCAhPT0gdm9pZCAwID8gd3JhcHBlckNvbCA6IGN0eCA9PT0gbnVsbCB8fCBjdHggPT09IHZvaWQgMCA/IHZvaWQgMCA6IGN0eC53cmFwcGVyQ29sKSwgW3dyYXBwZXJDb2wsIGN0eCA9PT0gbnVsbCB8fCBjdHggPT09IHZvaWQgMCA/IHZvaWQgMCA6IGN0eC53cmFwcGVyQ29sXSk7XG4gICAgY29uc3QgbWVyZ2VkUnVsZXMgPSB1c2VNZW1vKCgpID0+IHtcbiAgICAgICAgaWYgKCEocnVsZXMgPT09IG51bGwgfHwgcnVsZXMgPT09IHZvaWQgMCA/IHZvaWQgMCA6IHJ1bGVzLnZhbGlkYXRlKSB8fCAhdmFsaWRhdGVGaXJzdClcbiAgICAgICAgICAgIHJldHVybiBydWxlcztcbiAgICAgICAgY29uc3QgdmFsaWRhdGUgPSB3cmFwVmFsaWRhdGUocnVsZXMudmFsaWRhdGUsIHZhbGlkYXRlRmlyc3QpO1xuICAgICAgICBpZiAodmFsaWRhdGUgPT09IHJ1bGVzLnZhbGlkYXRlKVxuICAgICAgICAgICAgcmV0dXJuIHJ1bGVzO1xuICAgICAgICByZXR1cm4gT2JqZWN0LmFzc2lnbihPYmplY3QuYXNzaWduKHt9LCBydWxlcyksIHsgdmFsaWRhdGUgfSk7XG4gICAgfSwgW3J1bGVzLCB2YWxpZGF0ZUZpcnN0XSk7XG4gICAgY29uc3QgY29udGVudFByb3BzID0gdXNlTWVtbygoKSA9PiAoe1xuICAgICAgICBuYW1lLFxuICAgICAgICBjb250cm9sLFxuICAgICAgICBtZXRob2RzLFxuICAgICAgICBydWxlczogbWVyZ2VkUnVsZXMsXG4gICAgICAgIGRlZmF1bHRWYWx1ZSxcbiAgICAgICAgdmFsaWRhdGVTdGF0dXMsXG4gICAgICAgIHZhbHVlUHJvcE5hbWUsXG4gICAgICAgIGhlbHAsXG4gICAgICAgIGV4dHJhLFxuICAgICAgICBjdHgsXG4gICAgICAgIGNoaWxkcmVuLFxuICAgICAgICByZW5kZXJGbixcbiAgICAgICAgYWxsVmFsdWVzLFxuICAgICAgICBzaG91bGRVcGRhdGUsXG4gICAgICAgIHNob3VsZFJlbmRlcixcbiAgICAgICAgd2l0aFRyaWdnZXIsXG4gICAgfSksIFtcbiAgICAgICAgbmFtZSwgY29udHJvbCwgbWV0aG9kcywgbWVyZ2VkUnVsZXMsIGRlZmF1bHRWYWx1ZSwgdmFsaWRhdGVTdGF0dXMsXG4gICAgICAgIHZhbHVlUHJvcE5hbWUsIGhlbHAsIGV4dHJhLCBjdHgsIGNoaWxkcmVuLCByZW5kZXJGbiwgYWxsVmFsdWVzLFxuICAgICAgICBzaG91bGRVcGRhdGUsIHNob3VsZFJlbmRlciwgd2l0aFRyaWdnZXIsXG4gICAgXSk7XG4gICAgaWYgKG5vU3R5bGUpIHtcbiAgICAgICAgcmV0dXJuIF9qc3goRm9ybUl0ZW1Db250ZW50LCBPYmplY3QuYXNzaWduKHt9LCBjb250ZW50UHJvcHMpKTtcbiAgICB9XG4gICAgY29uc3Qgcm9vdFN0eWxlID0ge1xuICAgICAgICBbQ1NTX1ZBUl9MQUJFTF9XSURUSF06IGxhYmVsV2lkdGgsXG4gICAgICAgIFtDU1NfVkFSX1dSQVBQRVJfV0lEVEhdOiB3cmFwcGVyV2lkdGgsXG4gICAgfTtcbiAgICByZXR1cm4gKF9qc3hzKFwiZGl2XCIsIHsgY2xhc3NOYW1lOiBjbGFzc2VzKCdyb290Jywgam9pbkNscyhjbGFzc05hbWUsIChjdHggPT09IG51bGwgfHwgY3R4ID09PSB2b2lkIDAgPyB2b2lkIDAgOiBjdHgubGF5b3V0KSAmJiBjbGFzc2VzKGBsYXlvdXQtJHtjdHgubGF5b3V0fWApKSksIFwiZGF0YS1mb3JtLWl0ZW0tbmFtZVwiOiBuYW1lID8gU3RyaW5nKG5hbWUpIDogdW5kZWZpbmVkLCBzdHlsZTogcm9vdFN0eWxlLCBjaGlsZHJlbjogW2xhYmVsICYmIChfanN4cyhcImRpdlwiLCB7IGNsYXNzTmFtZTogY2xhc3NlcygnbGFiZWwnLCBqb2luQ2xzKHNob3dSZXF1aXJlZCAmJiBpc1JlcXVpcmVkICYmIGNsYXNzZXMoJ2xhYmVsLXJlcXVpcmVkJykpKSwgY2hpbGRyZW46IFtfanN4KFR5cG9ncmFwaHkuTGFiZWwsIHsgc2l6ZTogJ3MnLCBjaGlsZHJlbjogbGFiZWwgfSksIChjdHggPT09IG51bGwgfHwgY3R4ID09PSB2b2lkIDAgPyB2b2lkIDAgOiBjdHguY29sb24pICYmIF9qc3goXCJzcGFuXCIsIHsgY2xhc3NOYW1lOiBjbGFzc2VzKCdjb2xvbicpLCBjaGlsZHJlbjogXCI6XCIgfSldIH0pKSwgX2pzeChcImRpdlwiLCB7IGNsYXNzTmFtZTogY2xhc3NlcygnY29udHJvbCcpLCBjaGlsZHJlbjogX2pzeChGb3JtSXRlbUNvbnRlbnQsIE9iamVjdC5hc3NpZ24oe30sIGNvbnRlbnRQcm9wcykpIH0pXSB9KSk7XG59XG5leHBvcnQgZnVuY3Rpb24gRm9ybUl0ZW0ocHJvcHMpIHtcbiAgICBjb25zdCBjdHggPSB1c2VDb250ZXh0KEZvcm1Db250ZXh0KTtcbiAgICBpZiAoY3R4ID09PSBudWxsIHx8IGN0eCA9PT0gdm9pZCAwID8gdm9pZCAwIDogY3R4Lm1ldGhvZHMpIHtcbiAgICAgICAgcmV0dXJuIF9qc3goRm9ybUl0ZW1Jbm5lciwgT2JqZWN0LmFzc2lnbih7fSwgcHJvcHMpKTtcbiAgICB9XG4gICAgcmV0dXJuIChfanN4KEZhbGxiYWNrRm9ybVByb3ZpZGVyLCB7IGNoaWxkcmVuOiBfanN4KEZvcm1JdGVtSW5uZXIsIE9iamVjdC5hc3NpZ24oe30sIHByb3BzKSkgfSkpO1xufVxuZXhwb3J0IGRlZmF1bHQgRm9ybUl0ZW07IixudWxsXSwic291cmNlUm9vdCI6Ii4uLy4uLy4uLy4uLy4uLy4uLy4uLy4uLy4uL3NyYyJ9

package/es/components/Form/FormItemContent.d.ts

@@ -0,0 +1,18 @@
+import type { FieldValues } from 'react-hook-form';
+import type { FormItemContentProps } from './interface';
+/**
+ * Renders the inner content of a `<FormItem>`.
+ *
+ * Handles two branches:
+ * - **Free branch** (no `name`): renders children directly or via a render-prop,
+ *   optionally gated by `shouldUpdate`.
+ * - **Controlled branch** (has `name`): wraps children in a `react-hook-form`
+ *   `Controller`, injecting field bindings and validation-trigger wrappers.
+ *
+ * Both branches render their output inside a {@link MetaWrapper} for consistent
+ * help/error/extra display.
+ *
+ * @template TFieldValues - The shape of the form values.
+ * @param props - {@link FormItemContentProps}
+ */
+export declare function FormItemContent<TFieldValues extends FieldValues = FieldValues>({ name, control, methods, rules, defaultValue, validateStatus, valuePropName, help, extra, ctx, children, renderFn, allValues, shouldUpdate, shouldRender, withTrigger, }: FormItemContentProps<TFieldValues>): import("react/jsx-runtime").JSX.Element;

package/es/components/Form/FormItemContent.js

@@ -0,0 +1,146 @@
+import _defineProperty from "@babel/runtime/helpers/esm/defineProperty";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import { Controller } from 'react-hook-form';
+import { default as classnames, joinCls } from '../../utils/classnames';
+import { STATUS_ERROR, TRIGGER_BLUR, TRIGGER_CHANGE } from './constants';
+import { getStatusProps, resolveStatus } from './helper';
+var classes = classnames('form-item');
+/**
+ * Clones a React element and injects `react-hook-form` Controller bindings
+ * (`value`, `onChange`, `onBlur`, `ref`) while preserving any existing handlers
+ * on the child element.
+ *
+ * For non-DOM (custom) components, status props (`invalid`/`success`) are also spread.
+ *
+ * @template TFieldValues - The shape of the form values.
+ * @param children - The child React node to clone.
+ * @param field - Controller field bindings from `react-hook-form`.
+ * @param status - The resolved validation status.
+ * @param statusProps - Boolean props derived from the status.
+ * @param valuePropName - The prop name used to bind the controlled value.
+ * @param ctx - Form context value for reading the `disabled` state.
+ * @returns The cloned element with injected bindings, or the original node if not a valid element.
+ */
+function cloneChildElement(children, field, status, statusProps, valuePropName, ctx) {
+  var _a, _b, _c;
+  if (! /*#__PURE__*/React.isValidElement(children)) return children;
+  var childElement = children;
+  var isDomElement = typeof childElement.type === 'string';
+  var childOnChange = (_a = childElement.props) === null || _a === void 0 ? void 0 : _a.onChange;
+  var childOnBlur = (_b = childElement.props) === null || _b === void 0 ? void 0 : _b.onBlur;
+  return /*#__PURE__*/React.cloneElement(childElement, Object.assign(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, valuePropName, field.value), "onChange", function onChange() {
+    field.onChange.apply(field, arguments);
+    childOnChange === null || childOnChange === void 0 ? void 0 : childOnChange.apply(void 0, arguments);
+  }), "onBlur", function onBlur() {
+    field.onBlur();
+    childOnBlur === null || childOnBlur === void 0 ? void 0 : childOnBlur.apply(void 0, arguments);
+  }), "disabled", (ctx === null || ctx === void 0 ? void 0 : ctx.disabled) || ((_c = childElement.props) === null || _c === void 0 ? void 0 : _c.disabled)), 'aria-invalid', status === STATUS_ERROR || undefined), "ref", field.ref), isDomElement ? {} : statusProps));
+}
+/**
+ * Wraps field content with help text, error messages, and extra content regions.
+ *
+ * Applies status-based CSS classes to the wrapper and renders the appropriate
+ * feedback messages below the field.
+ */
+function MetaWrapper(_ref) {
+  var content = _ref.content,
+    status = _ref.status,
+    errorMessage = _ref.errorMessage,
+    help = _ref.help,
+    extra = _ref.extra,
+    disabled = _ref.disabled;
+  return _jsxs("div", {
+    className: classes('content', joinCls(status && classes("content-".concat(status)), disabled && classes('content-disabled'))),
+    children: [content, errorMessage && !help && _jsx("div", {
+      className: classes('help', classes('help-error')),
+      children: errorMessage
+    }), help && _jsx("div", {
+      className: classes('help', joinCls(status && classes("help-".concat(status)))),
+      children: help
+    }), extra && _jsx("div", {
+      className: classes('extra'),
+      children: extra
+    })]
+  });
+}
+/**
+ * Renders the inner content of a `<FormItem>`.
+ *
+ * Handles two branches:
+ * - **Free branch** (no `name`): renders children directly or via a render-prop,
+ *   optionally gated by `shouldUpdate`.
+ * - **Controlled branch** (has `name`): wraps children in a `react-hook-form`
+ *   `Controller`, injecting field bindings and validation-trigger wrappers.
+ *
+ * Both branches render their output inside a {@link MetaWrapper} for consistent
+ * help/error/extra display.
+ *
+ * @template TFieldValues - The shape of the form values.
+ * @param props - {@link FormItemContentProps}
+ */
+export function FormItemContent(_ref2) {
+  var name = _ref2.name,
+    control = _ref2.control,
+    methods = _ref2.methods,
+    rules = _ref2.rules,
+    defaultValue = _ref2.defaultValue,
+    validateStatus = _ref2.validateStatus,
+    valuePropName = _ref2.valuePropName,
+    help = _ref2.help,
+    extra = _ref2.extra,
+    ctx = _ref2.ctx,
+    children = _ref2.children,
+    renderFn = _ref2.renderFn,
+    allValues = _ref2.allValues,
+    shouldUpdate = _ref2.shouldUpdate,
+    shouldRender = _ref2.shouldRender,
+    withTrigger = _ref2.withTrigger;
+  // --- Free child branch (no name) ---
+  if (!name) {
+    var freeContent = renderFn ? shouldUpdate && !shouldRender ? null : renderFn({
+      form: methods,
+      values: allValues
+    }) : children;
+    return _jsx(MetaWrapper, {
+      content: freeContent,
+      status: resolveStatus(validateStatus),
+      help: help,
+      extra: extra,
+      disabled: ctx === null || ctx === void 0 ? void 0 : ctx.disabled
+    });
+  }
+  // --- Controlled field branch (has name) ---
+  return _jsx(Controller, {
+    name: name,
+    control: control,
+    rules: rules,
+    defaultValue: defaultValue,
+    render: function render(_ref3) {
+      var field = _ref3.field,
+        fieldState = _ref3.fieldState;
+      var _a;
+      var status = resolveStatus(validateStatus, fieldState);
+      var statusProps = getStatusProps(status);
+      var patchedField = Object.assign(Object.assign(Object.assign({}, field), {
+        onChange: withTrigger(TRIGGER_CHANGE, field.onChange),
+        onBlur: withTrigger(TRIGGER_BLUR, field.onBlur)
+      }), statusProps);
+      var content = renderFn ? renderFn({
+        field: patchedField,
+        fieldState: fieldState,
+        form: methods,
+        values: allValues
+      }) : cloneChildElement(children, patchedField, status, statusProps, valuePropName, ctx);
+      return _jsx(MetaWrapper, {
+        content: content,
+        status: status,
+        errorMessage: (_a = fieldState.error) === null || _a === void 0 ? void 0 : _a.message,
+        help: help,
+        extra: extra,
+        disabled: ctx === null || ctx === void 0 ? void 0 : ctx.disabled
+      });
+    }
+  });
+}
+//# sourceMappingURL=data:application/json;charset=utf8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbImNvbXBvbmVudHMvRm9ybS9Gb3JtSXRlbUNvbnRlbnQuanMiLCJjb21wb25lbnRzL3NyYy9jb21wb25lbnRzL0Zvcm0vRm9ybUl0ZW1Db250ZW50LnRzeCJdLCJuYW1lcyI6WyJqc3giLCJfanN4IiwianN4cyIsIl9qc3hzIiwiUmVhY3QiLCJDb250cm9sbGVyIiwiZGVmYXVsdCIsImNsYXNzbmFtZXMiLCJqb2luQ2xzIiwiU1RBVFVTX0VSUk9SIiwiVFJJR0dFUl9CTFVSIiwiVFJJR0dFUl9DSEFOR0UiLCJnZXRTdGF0dXNQcm9wcyIsInJlc29sdmVTdGF0dXMiLCJjbGFzc2VzIiwiY2xvbmVDaGlsZEVsZW1lbnQiLCJjaGlsZHJlbiIsImZpZWxkIiwic3RhdHVzIiwic3RhdHVzUHJvcHMiLCJ2YWx1ZVByb3BOYW1lIiwiY3R4IiwiX2EiLCJfYiIsIl9jIiwiaXNWYWxpZEVsZW1lbnQiLCJjaGlsZEVsZW1lbnQiLCJpc0RvbUVsZW1lbnQiLCJ0eXBlIiwiY2hpbGRPbkNoYW5nZSIsInByb3BzIiwib25DaGFuZ2UiLCJjaGlsZE9uQmx1ciIsIm9uQmx1ciIsImNsb25lRWxlbWVudCIsIk9iamVjdCIsImFzc2lnbiIsIl9kZWZpbmVQcm9wZXJ0eSIsInZhbHVlIiwiYXBwbHkiLCJhcmd1bWVudHMiLCJkaXNhYmxlZCIsInVuZGVmaW5lZCIsInJlZiIsIk1ldGFXcmFwcGVyIiwiX3JlZiIsImNvbnRlbnQiLCJlcnJvck1lc3NhZ2UiLCJoZWxwIiwiZXh0cmEiLCJjbGFzc05hbWUiLCJjb25jYXQiLCJGb3JtSXRlbUNvbnRlbnQiLCJfcmVmMiIsIm5hbWUiLCJjb250cm9sIiwibWV0aG9kcyIsInJ1bGVzIiwiZGVmYXVsdFZhbHVlIiwidmFsaWRhdGVTdGF0dXMiLCJyZW5kZXJGbiIsImFsbFZhbHVlcyIsInNob3VsZFVwZGF0ZSIsInNob3VsZFJlbmRlciIsIndpdGhUcmlnZ2VyIiwiZnJlZUNvbnRlbnQiLCJmb3JtIiwidmFsdWVzIiwicmVuZGVyIiwiX3Jl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QUFXLENBQUN0RCxZQUFZLEVBQUVPLEtBQUssQ0FBQ2dCLE1BQU07TUFBQyxDQUFBLENBQUEsRUFDNUNkLFdBQVcsQ0FDZjtNQUVELElBQU0yQixPQUFPLEdBQUdjLFFBQVEsR0FDcEJBLFFBQVEsQ0FBQztRQUFFM0MsS0FBSyxFQUFFc0QsWUFBWTtRQUFFRCxVQUFVLEVBQVZBLFVBQVU7UUFBRUosSUFBSSxFQUFFVixPQUFPO1FBQUVXLE1BQU0sRUFBRU47TUFBUyxDQUFFLENBQUMsR0FDL0U5QyxpQkFBaUIsQ0FBQ0MsUUFBMkIsRUFBRXVELFlBQVksRUFBRXJELE1BQU0sRUFBRUMsV0FBVyxFQUFFQyxhQUFhLEVBQUVDLEdBQUcsQ0FBQztNQUV6RyxPQUNFcEIsSUFBQSxDQUFDMkMsV0FBVyxFQUFBO1FBQ1ZFLE9BQU8sRUFBRUEsT0FBTztRQUNoQjVCLE1BQU0sRUFBRUEsTUFBTTtRQUNkNkIsWUFBWSxFQUFFLENBQUF6QixFQUFBLEdBQUFnRCxVQUFVLENBQUNFLEtBQUssTUFBQSxJQUFBLElBQUFsRCxFQUFBLEtBQUEsS0FBQSxDQUFBLEdBQUEsS0FBQSxDQUFBLEdBQUFBLEVBQUEsQ0FBRW1ELE9BQU87UUFDdkN6QixJQUFJLEVBQUVBLElBQUk7UUFDVkMsS0FBSyxFQUFFQSxLQUFLO1FBQ1pSLFFBQVEsRUFBRXBCLEdBQUcsS0FBQSxJQUFBLElBQUhBLEdBQUcsS0FBQSxLQUFBLENBQUEsR0FBQSxLQUFBLENBQUEsR0FBSEEsR0FBRyxDQUFFb0I7TUFBUSxDQUFBLENBQ3ZCO0lBRU47RUFBQyxDQUFBLENBQ0Q7QUFFTiIsImZpbGUiOiJjb21wb25lbnRzL0Zvcm0vRm9ybUl0ZW1Db250ZW50LmpzIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsganN4IGFzIF9qc3gsIGpzeHMgYXMgX2pzeHMgfSBmcm9tIFwicmVhY3QvanN4LXJ1bnRpbWVcIjtcbmltcG9ydCBSZWFjdCBmcm9tICdyZWFjdCc7XG5pbXBvcnQgeyBDb250cm9sbGVyIH0gZnJvbSAncmVhY3QtaG9vay1mb3JtJztcbmltcG9ydCB7IGRlZmF1bHQgYXMgY2xhc3NuYW1lcywgam9pbkNscyB9IGZyb20gJy4uLy4uL3V0aWxzL2NsYXNzbmFtZXMnO1xuaW1wb3J0IHsgU1RBVFVTX0VSUk9SLCBUUklHR0VSX0JMVVIsIFRSSUdHRVJfQ0hBTkdFIH0gZnJvbSAnLi9jb25zdGFudHMnO1xuaW1wb3J0IHsgZ2V0U3RhdHVzUHJvcHMsIHJlc29sdmVTdGF0dXMgfSBmcm9tICcuL2hlbHBlcic7XG5jb25zdCBjbGFzc2VzID0gY2xhc3NuYW1lcygnZm9ybS1pdGVtJyk7XG4vKipcbiAqIENsb25lcyBhIFJlYWN0IGVsZW1lbnQgYW5kIGluamVjdHMgYHJlYWN0LWhvb2stZm9ybWAgQ29udHJvbGxlciBiaW5kaW5nc1xuICogKGB2YWx1ZWAsIGBvbkNoYW5nZWAsIGBvbkJsdXJgLCBgcmVmYCkgd2hpbGUgcHJlc2VydmluZyBhbnkgZXhpc3RpbmcgaGFuZGxlcnNcbiAqIG9uIHRoZSBjaGlsZCBlbGVtZW50LlxuICpcbiAqIEZvciBub24tRE9NIChjdXN0b20pIGNvbXBvbmVudHMsIHN0YXR1cyBwcm9wcyAoYGludmFsaWRgL2BzdWNjZXNzYCkgYXJlIGFsc28gc3ByZWFkLlxuICpcbiAqIEB0ZW1wbGF0ZSBURmllbGRWYWx1ZXMgLSBUaGUgc2hhcGUgb2YgdGhlIGZvcm0gdmFsdWVzLlxuICogQHBhcmFtIGNoaWxkcmVuIC0gVGhlIGNoaWxkIFJlYWN0IG5vZGUgdG8gY2xvbmUuXG4gKiBAcGFyYW0gZmllbGQgLSBDb250cm9sbGVyIGZpZWxkIGJpbmRpbmdzIGZyb20gYHJlYWN0LWhvb2stZm9ybWAuXG4gKiBAcGFyYW0gc3RhdHVzIC0gVGhlIHJlc29sdmVkIHZhbGlkYXRpb24gc3RhdHVzLlxuICogQHBhcmFtIHN0YXR1c1Byb3BzIC0gQm9vbGVhbiBwcm9wcyBkZXJpdmVkIGZyb20gdGhlIHN0YXR1cy5cbiAqIEBwYXJhbSB2YWx1ZVByb3BOYW1lIC0gVGhlIHByb3AgbmFtZSB1c2VkIHRvIGJpbmQgdGhlIGNvbnRyb2xsZWQgdmFsdWUuXG4gKiBAcGFyYW0gY3R4IC0gRm9ybSBjb250ZXh0IHZhbHVlIGZvciByZWFkaW5nIHRoZSBgZGlzYWJsZWRgIHN0YXRlLlxuICogQHJldHVybnMgVGhlIGNsb25lZCBlbGVtZW50IHdpdGggaW5qZWN0ZWQgYmluZGluZ3MsIG9yIHRoZSBvcmlnaW5hbCBub2RlIGlmIG5vdCBhIHZhbGlkIGVsZW1lbnQuXG4gKi9cbmZ1bmN0aW9uIGNsb25lQ2hpbGRFbGVtZW50KGNoaWxkcmVuLCBmaWVsZCwgc3RhdHVzLCBzdGF0dXNQcm9wcywgdmFsdWVQcm9wTmFtZSwgY3R4KSB7XG4gICAgdmFyIF9hLCBfYiwgX2M7XG4gICAgaWYgKCFSZWFjdC5pc1ZhbGlkRWxlbWVudChjaGlsZHJlbikpXG4gICAgICAgIHJldHVybiBjaGlsZHJlbjtcbiAgICBjb25zdCBjaGlsZEVsZW1lbnQgPSBjaGlsZHJlbjtcbiAgICBjb25zdCBpc0RvbUVsZW1lbnQgPSB0eXBlb2YgY2hpbGRFbGVtZW50LnR5cGUgPT09ICdzdHJpbmcnO1xuICAgIGNvbnN0IGNoaWxkT25DaGFuZ2UgPSAoX2EgPSBjaGlsZEVsZW1lbnQucHJvcHMpID09PSBudWxsIHx8IF9hID09PSB2b2lkIDAgPyB2b2lkIDAgOiBfYS5vbkNoYW5nZTtcbiAgICBjb25zdCBjaGlsZE9uQmx1ciA9IChfYiA9IGNoaWxkRWxlbWVudC5wcm9wcykgPT09IG51bGwgfHwgX2IgPT09IHZvaWQgMCA/IHZvaWQgMCA6IF9iLm9uQmx1cjtcbiAgICByZXR1cm4gUmVhY3QuY2xvbmVFbGVtZW50KGNoaWxkRWxlbWVudCwgT2JqZWN0LmFzc2lnbih7IFt2YWx1ZVByb3BOYW1lXTogZmllbGQudmFsdWUsIG9uQ2hhbmdlOiAoLi4uYXJncykgPT4ge1xuICAgICAgICAgICAgZmllbGQub25DaGFuZ2UoLi4uYXJncyk7XG4gICAgICAgICAgICBjaGlsZE9uQ2hhbmdlID09PSBudWxsIHx8IGNoaWxkT25DaGFuZ2UgPT09IHZvaWQgMCA/IHZvaWQgMCA6IGNoaWxkT25DaGFuZ2UoLi4uYXJncyk7XG4gICAgICAgIH0sIG9uQmx1cjogKC4uLmFyZ3MpID0+IHtcbiAgICAgICAgICAgIGZpZWxkLm9uQmx1cigpO1xuICAgICAgICAgICAgY2hpbGRPbkJsdXIgPT09IG51bGwgfHwgY2hpbGRPbkJsdXIgPT09IHZvaWQgMCA/IHZvaWQgMCA6IGNoaWxkT25CbHVyKC4uLmFyZ3MpO1xuICAgICAgICB9LCBkaXNhYmxlZDogKGN0eCA9PT0gbnVsbCB8fCBjdHggPT09IHZvaWQgMCA/IHZvaWQgMCA6IGN0eC5kaXNhYmxlZCkgfHwgKChfYyA9IGNoaWxkRWxlbWVudC5wcm9wcykgPT09IG51bGwgfHwgX2MgPT09IHZvaWQgMCA/IHZvaWQgMCA6IF9jLmRpc2FibGVkKSwgJ2FyaWEtaW52YWxpZCc6IHN0YXR1cyA9PT0gU1RBVFVTX0VSUk9SIHx8IHVuZGVmaW5lZCwgcmVmOiBmaWVsZC5yZWYgfSwgKGlzRG9tRWxlbWVudCA/IHt9IDogc3RhdHVzUHJvcHMpKSk7XG59XG4vKipcbiAqIFdyYXBzIGZpZWxkIGNvbnRlbnQgd2l0aCBoZWxwIHRleHQsIGVycm9yIG1lc3NhZ2VzLCBhbmQgZXh0cmEgY29udGVudCByZWdpb25zLlxuICpcbiAqIEFwcGxpZXMgc3RhdHVzLWJhc2VkIENTUyBjbGFzc2VzIHRvIHRoZSB3cmFwcGVyIGFuZCByZW5kZXJzIHRoZSBhcHByb3ByaWF0ZVxuICogZmVlZGJhY2sgbWVzc2FnZXMgYmVsb3cgdGhlIGZpZWxkLlxuICovXG5mdW5jdGlvbiBNZXRhV3JhcHBlcih7IGNvbnRlbnQsIHN0YXR1cywgZXJyb3JNZXNzYWdlLCBoZWxwLCBleHRyYSwgZGlzYWJsZWQsIH0pIHtcbiAgICByZXR1cm4gKF9qc3hzKFwiZGl2XCIsIHsgY2xhc3NOYW1lOiBjbGFzc2VzKCdjb250ZW50Jywgam9pbkNscyhzdGF0dXMgJiYgY2xhc3NlcyhgY29udGVudC0ke3N0YXR1c31gKSwgZGlzYWJsZWQgJiYgY2xhc3NlcygnY29udGVudC1kaXNhYmxlZCcpKSksIGNoaWxkcmVuOiBbY29udGVudCwgZXJyb3JNZXNzYWdlICYmICFoZWxwICYmIChfanN4KFwiZGl2XCIsIHsgY2xhc3NOYW1lOiBjbGFzc2VzKCdoZWxwJywgY2xhc3NlcygnaGVscC1lcnJvcicpKSwgY2hpbGRyZW46IGVycm9yTWVzc2FnZSB9KSksIGhlbHAgJiYgKF9qc3goXCJkaXZcIiwgeyBjbGFzc05hbWU6IGNsYXNzZXMoJ2hlbHAnLCBqb2luQ2xzKHN0YXR1cyAmJiBjbGFzc2VzKGBoZWxwLSR7c3RhdHVzfWApKSksIGNoaWxkcmVuOiBoZWxwIH0pKSwgZXh0cmEgJiYgX2pzeChcImRpdlwiLCB7IGNsYXNzTmFtZTogY2xhc3NlcygnZXh0cmEnKSwgY2hpbGRyZW46IGV4dHJhIH0pXSB9KSk7XG59XG4vKipcbiAqIFJlbmRlcnMgdGhlIGlubmVyIGNvbnRlbnQgb2YgYSBgPEZvcm1JdGVtPmAuXG4gKlxuICogSGFuZGxlcyB0d28gYnJhbmNoZXM6XG4gKiAtICoqRnJlZSBicmFuY2gqKiAobm8gYG5hbWVgKTogcmVuZGVycyBjaGlsZHJlbiBkaXJlY3RseSBvciB2aWEgYSByZW5kZXItcHJvcCxcbiAqICAgb3B0aW9uYWxseSBnYXRlZCBieSBgc2hvdWxkVXBkYXRlYC5cbiAqIC0gKipDb250cm9sbGVkIGJyYW5jaCoqIChoYXMgYG5hbWVgKTogd3JhcHMgY2hpbGRyZW4gaW4gYSBgcmVhY3QtaG9vay1mb3JtYFxuICogICBgQ29udHJvbGxlcmAsIGluamVjdGluZyBmaWVsZCBiaW5kaW5ncyBhbmQgdmFsaWRhdGlvbi10cmlnZ2VyIHdyYXBwZXJzLlxuICpcbiAqIEJvdGggYnJhbmNoZXMgcmVuZGVyIHRoZWlyIG91dHB1dCBpbnNpZGUgYSB7QGxpbmsgTWV0YVdyYXBwZXJ9IGZvciBjb25zaXN0ZW50XG4gKiBoZWxwL2Vycm9yL2V4dHJhIGRpc3BsYXkuXG4gKlxuICogQHRlbXBsYXRlIFRGaWVsZFZhbHVlcyAtIFRoZSBzaGFwZSBvZiB0aGUgZm9ybSB2YWx1ZXMuXG4gKiBAcGFyYW0gcHJvcHMgLSB7QGxpbmsgRm9ybUl0ZW1Db250ZW50UHJvcHN9XG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBGb3JtSXRlbUNvbnRlbnQoeyBuYW1lLCBjb250cm9sLCBtZXRob2RzLCBydWxlcywgZGVmYXVsdFZhbHVlLCB2YWxpZGF0ZVN0YXR1cywgdmFsdWVQcm9wTmFtZSwgaGVscCwgZXh0cmEsIGN0eCwgY2hpbGRyZW4sIHJlbmRlckZuLCBhbGxWYWx1ZXMsIHNob3VsZFVwZGF0ZSwgc2hvdWxkUmVuZGVyLCB3aXRoVHJpZ2dlciwgfSkge1xuICAgIC8vIC0tLSBGcmVlIGNoaWxkIGJyYW5jaCAobm8gbmFtZSkgLS0tXG4gICAgaWYgKCFuYW1lKSB7XG4gICAgICAgIGNvbnN0IGZyZWVDb250ZW50ID0gcmVuZGVyRm5cbiAgICAgICAgICAgID8gKHNob3VsZFVwZGF0ZSAmJiAhc2hvdWxkUmVuZGVyID8gbnVsbCA6IHJlbmRlckZuKHsgZm9ybTogbWV0aG9kcywgdmFsdWVzOiBhbGxWYWx1ZXMgfSkpXG4gICAgICAgICAgICA6IGNoaWxkcmVuO1xuICAgICAgICByZXR1cm4gKF9qc3goTWV0YVdyYXBwZXIsIHsgY29udGVudDogZnJlZUNvbnRlbnQsIHN0YXR1czogcmVzb2x2ZVN0YXR1cyh2YWxpZGF0ZVN0YXR1cyksIGhlbHA6IGhlbHAsIGV4dHJhOiBleHRyYSwgZGlzYWJsZWQ6IGN0eCA9PT0gbnVsbCB8fCBjdHggPT09IHZvaWQgMCA/IHZvaWQgMCA6IGN0eC5kaXNhYmxlZCB9KSk7XG4gICAgfVxuICAgIC8vIC0tLSBDb250cm9sbGVkIGZpZWxkIGJyYW5jaCAoaGFzIG5hbWUpIC0tLVxuICAgIHJldHVybiAoX2pzeChDb250cm9sbGVyLCB7IG5hbWU6IG5hbWUsIGNvbnRyb2w6IGNvbnRyb2wsIHJ1bGVzOiBydWxlcywgZGVmYXVsdFZhbHVlOiBkZWZhdWx0VmFsdWUsIHJlbmRlcjogKHsgZmllbGQsIGZpZWxkU3RhdGUgfSkgPT4ge1xuICAgICAgICAgICAgdmFyIF9hO1xuICAgICAgICAgICAgY29uc3Qgc3RhdHVzID0gcmVzb2x2ZVN0YXR1cyh2YWxpZGF0ZVN0YXR1cywgZmllbGRTdGF0ZSk7XG4gICAgICAgICAgICBjb25zdCBzdGF0dXNQcm9wcyA9IGdldFN0YXR1c1Byb3BzKHN0YXR1cyk7XG4gICAgICAgICAgICBjb25zdCBwYXRjaGVkRmllbGQgPSBPYmplY3QuYXNzaWduKE9iamVjdC5hc3NpZ24oT2JqZWN0LmFzc2lnbih7fSwgZmllbGQpLCB7IG9uQ2hhbmdlOiB3aXRoVHJpZ2dlcihUUklHR0VSX0NIQU5HRSwgZmllbGQub25DaGFuZ2UpLCBvbkJsdXI6IHdpdGhUcmlnZ2VyKFRSSUdHRVJfQkxVUiwgZmllbGQub25CbHVyKSB9KSwgc3RhdHVzUHJvcHMpO1xuICAgICAgICAgICAgY29uc3QgY29udGVudCA9IHJlbmRlckZuXG4gICAgICAgICAgICAgICAgPyByZW5kZXJGbih7IGZpZWxkOiBwYXRjaGVkRmllbGQsIGZpZWxkU3RhdGUsIGZvcm06IG1ldGhvZHMsIHZhbHVlczogYWxsVmFsdWVzIH0pXG4gICAgICAgICAgICAgICAgOiBjbG9uZUNoaWxkRWxlbWVudChjaGlsZHJlbiwgcGF0Y2hlZEZpZWxkLCBzdGF0dXMsIHN0YXR1c1Byb3BzLCB2YWx1ZVByb3BOYW1lLCBjdHgpO1xuICAgICAgICAgICAgcmV0dXJuIChfanN4KE1ldGFXcmFwcGVyLCB7IGNvbnRlbnQ6IGNvbnRlbnQsIHN0YXR1czogc3RhdHVzLCBlcnJvck1lc3NhZ2U6IChfYSA9IGZpZWxkU3RhdGUuZXJyb3IpID09PSBudWxsIHx8IF9hID09PSB2b2lkIDAgPyB2b2lkIDAgOiBfYS5tZXNzYWdlLCBoZWxwOiBoZWxwLCBleHRyYTogZXh0cmEsIGRpc2FibGVkOiBjdHggPT09IG51bGwgfHwgY3R4ID09PSB2b2lkIDAgPyB2b2lkIDAgOiBjdHguZGlzYWJsZWQgfSkpO1xuICAgICAgICB9IH0pKTtcbn0iLG51bGxdLCJzb3VyY2VSb290IjoiLi4vLi4vLi4vLi4vLi4vLi4vLi4vLi4vLi4vc3JjIn0=

package/es/components/Form/constants.d.ts

@@ -0,0 +1,46 @@
+/** Default form layout direction. */
+export declare const DEFAULT_LAYOUT: "horizontal";
+/** Default label text alignment. */
+export declare const DEFAULT_LABEL_ALIGN: "right";
+/** Default label column span in the 12-column grid. */
+export declare const DEFAULT_LABEL_COL = 3;
+/** Default wrapper/control column span in the 12-column grid. */
+export declare const DEFAULT_WRAPPER_COL = 9;
+/** Default form size variant. */
+export declare const DEFAULT_SIZE: "middle";
+/** Default `scrollIntoView` behavior when scrolling to the first error. */
+export declare const DEFAULT_SCROLL_BEHAVIOR: "smooth";
+/** Default `scrollIntoView` block position. */
+export declare const DEFAULT_SCROLL_BLOCK: "center";
+/** Default `scrollIntoView` inline position. */
+export declare const DEFAULT_SCROLL_INLINE: "nearest";
+/** Standard HTML `name` attribute used for querySelector lookups. */
+export declare const SELECTOR_NAME_ATTR = "name";
+/** Data attribute rendered on FormItem wrappers for querySelector lookups. */
+export declare const SELECTOR_DATA_FORM_ITEM_ATTR = "data-form-item-name";
+/** Minimum allowed grid column value. */
+export declare const GRID_MIN = 0;
+/** Total number of columns in the grid system. */
+export declare const GRID_COLUMNS = 12;
+/** Percentage multiplier for grid-to-percent conversion. */
+export declare const PERCENT = 100;
+/** Minimum debounce threshold in milliseconds (values at or below are treated as immediate). */
+export declare const DEBOUNCE_MIN = 0;
+/** Validation status indicating an async validation is in progress. */
+export declare const STATUS_VALIDATING: "validating";
+/** Validation status indicating a field error. */
+export declare const STATUS_ERROR: "error";
+/** Validation status indicating a field passed validation. */
+export declare const STATUS_SUCCESS: "success";
+/** Sentinel for the parallel `validateFirst` mode. */
+export declare const VALIDATE_PARALLEL: "parallel";
+/** Trigger mode for change events. */
+export declare const TRIGGER_CHANGE: "onChange";
+/** Trigger mode for blur events. */
+export declare const TRIGGER_BLUR: "onBlur";
+/** CSS custom property controlling the label column width. */
+export declare const CSS_VAR_LABEL_WIDTH = "--om-form-label-width";
+/** CSS custom property controlling the wrapper/control column width. */
+export declare const CSS_VAR_WRAPPER_WIDTH = "--om-form-wrapper-width";
+/** Default prop name used to bind a controlled value to a child element. */
+export declare const DEFAULT_VALUE_PROP: "value";

package/es/components/Form/constants.js

@@ -0,0 +1,65 @@
+// ---------------------------------------------------------------------------
+// Form layout defaults
+// ---------------------------------------------------------------------------
+/** Default form layout direction. */
+export var DEFAULT_LAYOUT = 'horizontal';
+/** Default label text alignment. */
+export var DEFAULT_LABEL_ALIGN = 'right';
+/** Default label column span in the 12-column grid. */
+export var DEFAULT_LABEL_COL = 3;
+/** Default wrapper/control column span in the 12-column grid. */
+export var DEFAULT_WRAPPER_COL = 9;
+/** Default form size variant. */
+export var DEFAULT_SIZE = 'middle';
+// ---------------------------------------------------------------------------
+// Scroll-to-error defaults
+// ---------------------------------------------------------------------------
+/** Default `scrollIntoView` behavior when scrolling to the first error. */
+export var DEFAULT_SCROLL_BEHAVIOR = 'smooth';
+/** Default `scrollIntoView` block position. */
+export var DEFAULT_SCROLL_BLOCK = 'center';
+/** Default `scrollIntoView` inline position. */
+export var DEFAULT_SCROLL_INLINE = 'nearest';
+/** Standard HTML `name` attribute used for querySelector lookups. */
+export var SELECTOR_NAME_ATTR = 'name';
+/** Data attribute rendered on FormItem wrappers for querySelector lookups. */
+export var SELECTOR_DATA_FORM_ITEM_ATTR = 'data-form-item-name';
+// ---------------------------------------------------------------------------
+// Grid math helpers (12-column grid)
+// ---------------------------------------------------------------------------
+/** Minimum allowed grid column value. */
+export var GRID_MIN = 0;
+/** Total number of columns in the grid system. */
+export var GRID_COLUMNS = 12;
+/** Percentage multiplier for grid-to-percent conversion. */
+export var PERCENT = 100;
+// ---------------------------------------------------------------------------
+// Validation / trigger helpers
+// ---------------------------------------------------------------------------
+/** Minimum debounce threshold in milliseconds (values at or below are treated as immediate). */
+export var DEBOUNCE_MIN = 0;
+/** Validation status indicating an async validation is in progress. */
+export var STATUS_VALIDATING = 'validating';
+/** Validation status indicating a field error. */
+export var STATUS_ERROR = 'error';
+/** Validation status indicating a field passed validation. */
+export var STATUS_SUCCESS = 'success';
+/** Sentinel for the parallel `validateFirst` mode. */
+export var VALIDATE_PARALLEL = 'parallel';
+/** Trigger mode for change events. */
+export var TRIGGER_CHANGE = 'onChange';
+/** Trigger mode for blur events. */
+export var TRIGGER_BLUR = 'onBlur';
+// ---------------------------------------------------------------------------
+// CSS variable names for layout width
+// ---------------------------------------------------------------------------
+/** CSS custom property controlling the label column width. */
+export var CSS_VAR_LABEL_WIDTH = '--om-form-label-width';
+/** CSS custom property controlling the wrapper/control column width. */
+export var CSS_VAR_WRAPPER_WIDTH = '--om-form-wrapper-width';
+// ---------------------------------------------------------------------------
+// Default prop mapping for controlled inputs
+// ---------------------------------------------------------------------------
+/** Default prop name used to bind a controlled value to a child element. */
+export var DEFAULT_VALUE_PROP = 'value';
+//# sourceMappingURL=data:application/json;charset=utf8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbImNvbXBvbmVudHMvc3JjL2NvbXBvbmVudHMvRm9ybS9jb25zdGFudHMudHMiXSwibmFtZXMiOlsiREVGQVVMVF9MQVlPVVQiLCJERUZBVUxUX0xBQkVMX0FMSUdOIiwiREVGQVVMVF9MQUJFTF9DT0wiLCJERUZBVUxUX1dSQVBQRVJfQ09MIiwiREVGQVVMVF9TSVpFIiwiREVGQVVMVF9TQ1JPTExfQkVIQVZJT1IiLCJERUZBVUxUX1NDUk9MTF9CTE9DSyIsIkRFRkFVTFRfU0NST0xMX0lOTElORSIsIlNFTEVDVE9SX05BTUVfQVRUUiIsIlNFTEVDVE9SX0RBVEFfRk9STV9JVEVNX0FUVFIiLCJHUklEX01JTiIsIkdSSURfQ09MVU1OUyIsIlBFUkNFTlQiLCJERUJPVU5DRV9NSU4iLCJTVEFUVVNfVkFMSURBVElORyIsIlNUQVRVU19FUlJPUiIsIlNUQVRVU19TVUNDRVNTIiwiVkFMSURBVEVfUEFSQUxMRUwiLCJUUklHR0VSX0NIQU5HRSIsIlRSSUdHRVJfQkxVUiIsIkNTU19WQVJfTEFCRUxfV0lEVEgiLCJDU1NfVkFSX1dSQVBQRVJfV0lEVEgiLCJERUZBVUxUX1ZBTFVFX1BST1AiXSwibWFwcGluZ3MiOiJBQUFBO0FBQ0E7QUFDQTtBQUVBO0FBQ0EsT0FBTyxJQUFNQSxjQUFjLEdBQUcsWUFBcUI7QUFFbkQ7QUFDQSxPQUFPLElBQU1DLG1CQUFtQixHQUFHLE9BQWdCO0FBRW5EO0FBQ0EsT0FBTyxJQUFNQyxpQkFBaUIsR0FBRyxDQUFDO0FBRWxDO0FBQ0EsT0FBTyxJQUFNQyxtQkFBbUIsR0FBRyxDQUFDO0FBRXBDO0FBQ0EsT0FBTyxJQUFNQyxZQUFZLEdBQUcsUUFBaUI7QUFFN0M7QUFDQTtBQUNBO0FBRUE7QUFDQSxPQUFPLElBQU1DLHVCQUF1QixHQUFHLFFBQWlCO0FBRXhEO0FBQ0EsT0FBTyxJQUFNQyxvQkFBb0IsR0FBRyxRQUFpQjtBQUVyRDtBQUNBLE9BQU8sSUFBTUMscUJBQXFCLEdBQUcsU0FBa0I7QUFFdkQ7QUFDQSxPQUFPLElBQU1DLGtCQUFrQixHQUFHLE1BQU07QUFFeEM7QUFDQSxPQUFPLElBQU1DLDRCQUE0QixHQUFHLHFCQUFxQjtBQUVqRTtBQUNBO0FBQ0E7QUFFQTtBQUNBLE9BQU8sSUFBTUMsUUFBUSxHQUFHLENBQUM7QUFFekI7QUFDQSxPQUFPLElBQU1DLFlBQVksR0FBRyxFQUFFO0FBRTlCO0FBQ0EsT0FBTyxJQUFNQyxPQUFPLEdBQUcsR0FBRztBQUUxQjtBQUNBO0FBQ0E7QUFFQTtBQUNBLE9BQU8sSUFBTUMsWUFBWSxHQUFHLENBQUM7QUFFN0I7QUFDQSxPQUFPLElBQU1DLGlCQUFpQixHQUFHLFlBQXFCO0FBRXREO0FBQ0EsT0FBTyxJQUFNQyxZQUFZLEdBQUcsT0FBZ0I7QUFFNUM7QUFDQSxPQUFPLElBQU1DLGNBQWMsR0FBRyxTQUFrQjtBQUVoRDtBQUNBLE9BQU8sSUFBTUMsaUJBQWlCLEdBQUcsVUFBbUI7QUFFcEQ7QUFDQSxPQUFPLElBQU1DLGNBQWMsR0FBRyxVQUFtQjtBQUVqRDtBQUNBLE9BQU8sSUFBTUMsWUFBWSxHQUFHLFFBQWlCO0FBRTdDO0FBQ0E7QUFDQTtBQUVBO0FBQ0EsT0FBTyxJQUFNQyxtQkFBbUIsR0FBRyx1QkFBdUI7QUFFMUQ7QUFDQSxPQUFPLElBQU1DLHFCQUFxQixHQUFHLHlCQUF5QjtBQUU5RDtBQUNBO0FBQ0E7QUFFQTtBQUNBLE9BQU8sSUFBTUMsa0JBQWtCLEdBQUcsT0FBZ0IiLCJmaWxlIjoiY29tcG9uZW50cy9Gb3JtL2NvbnN0YW50cy5qcyIsInNvdXJjZXNDb250ZW50IjpbbnVsbF0sInNvdXJjZVJvb3QiOiIuLi8uLi8uLi8uLi8uLi8uLi8uLi8uLi8uLi9zcmMifQ==

package/es/components/Form/helper.d.ts

@@ -0,0 +1,120 @@
+import type { ControllerFieldState, FieldError, FieldErrors, FieldPath, FieldValues, RegisterOptions, ValidateResult } from 'react-hook-form';
+import type { FormItemProps, FormValidateStatus, FormProps } from './interface';
+/**
+ * Converts a 12-column grid span to a CSS percentage width string.
+ *
+ * @param col - Grid column count (0–12). Values are clamped to the valid range.
+ * @returns A CSS percentage string (e.g. `"25%"`), or `undefined` when `col` is `null`/`undefined`.
+ */
+export declare const toPercent: (col?: number) => string | undefined;
+/**
+ * Type guard that narrows an unknown value to a `FieldError`-like object.
+ *
+ * `isFieldError` assumes `react-hook-form` places `type` on leaf errors,
+ * and `getFirstErrorPath` relies on that to stop descending once a leaf is found.
+ * If RHF changes this contract, tighten this predicate (e.g. require `message`/`ref`
+ * or another stricter leaf-shape check) to avoid false positives on nested containers.
+ *
+ * Checks for the presence of `type`, `message`, or `ref` properties which
+ * are characteristic of `react-hook-form` field errors.
+ *
+ * @param value - The value to check.
+ * @returns `true` if the value is a `FieldError`-like object.
+ */
+export declare const isFieldError: (value: unknown) => value is FieldError;
+/**
+ * Walks a nested `FieldErrors` tree (depth-first) and returns the dot-path
+ * of the first error encountered.
+ *
+ * Handles plain objects, arrays (e.g. field arrays), and deeply nested structures.
+ *
+ * @param errors - The `FieldErrors` object from `react-hook-form`.
+ * @returns The dot-separated path (e.g. `"items.0.name"`) or `null` if no error is found.
+ */
+export declare const getFirstErrorPath: (errors: FieldErrors) => string | null;
+/**
+ * Escapes a string for safe use inside a CSS attribute selector.
+ *
+ * Uses `CSS.escape` when available, with a regex fallback for SSR or
+ * environments without native support (e.g. nested field names like `"address.city"`).
+ *
+ * @param value - The raw attribute value to escape.
+ * @returns The escaped string safe for `querySelector`.
+ */
+export declare const escapeAttr: (value: string) => string;
+/**
+ * Scrolls the viewport to the first invalid field identified by `name`.
+ *
+ * Looks up the element using either the standard `name` attribute or the
+ * `data-form-item-name` data attribute. Supports custom scroll behavior
+ * via the `options` parameter.
+ *
+ * @param name - The field name (path) to scroll to.
+ * @param options - Scroll configuration from `FormProps['scrollToFirstError']`.
+ */
+export declare const scrollToField: (name: string, options?: FormProps["scrollToFirstError"]) => void;
+/**
+ * Resolves the effective validation status for a form field.
+ *
+ * An explicit `validateStatus` prop takes priority. Otherwise the status is
+ * derived from the `fieldState` provided by `react-hook-form`'s Controller.
+ *
+ * @param explicit - An explicit status override from props.
+ * @param fieldState - The Controller field state containing `error` and `isValidating`.
+ * @returns The resolved `FormValidateStatus`, or `undefined` if no status applies.
+ */
+export declare const resolveStatus: (explicit?: FormValidateStatus, fieldState?: Pick<ControllerFieldState, "error" | "isValidating">) => FormValidateStatus | undefined;
+/**
+ * Normalizes a `validateTrigger` prop into a consistent array form.
+ *
+ * @param value - A single trigger string, an array, or `undefined`.
+ * @returns An array of trigger modes (e.g. `['onChange', 'onBlur']`), or an empty array.
+ */
+export declare const normalizeValidateTrigger: (value?: FormItemProps<FieldValues>["validateTrigger"]) => ("onBlur" | "onChange")[];
+/**
+ * Maps a `FormValidateStatus` to boolean props suitable for Input-like components.
+ *
+ * @param status - The current validation status.
+ * @returns An object with `invalid: true`, `success: true`, or an empty object.
+ */
+export declare const getStatusProps: (status?: FormValidateStatus) => {
+    invalid: boolean;
+    success?: undefined;
+} | {
+    success: boolean;
+    invalid?: undefined;
+} | {
+    invalid?: undefined;
+    success?: undefined;
+};
+/**
+ * Performs a shallow comparison of two arrays using `Object.is` for each element.
+ *
+ * @param a - First array.
+ * @param b - Second array.
+ * @returns `true` if both arrays have the same length and identical elements by reference.
+ */
+export declare const shallowEqualArray: (a: unknown[], b: unknown[]) => boolean;
+/**
+ * Normalizes a custom `ValidateResult` to be compatible with `react-hook-form`.
+ *
+ * RHF treats `null` as a truthy error value, so this converts `null` to `true` (valid).
+ *
+ * @param result - The raw validation result.
+ * @returns The normalized result (`true` for valid, or an error string/boolean).
+ */
+export declare const normalizeValidateResult: (result: ValidateResult) => ValidateResult;
+/**
+ * Wraps a multi-validator record to honor `validateFirst` sequencing.
+ *
+ * When `mode` is `true`, validators run **sequentially** and stop at the first error.
+ * When `mode` is `'parallel'`, all validators run concurrently and the first error found is returned.
+ * When `mode` is falsy or `validate` is a single function, the original value is returned unchanged.
+ *
+ * @template TValues - The shape of the form values.
+ * @template TName - The field path type.
+ * @param validate - The validator or record of validators from `RegisterOptions`.
+ * @param mode - The `validateFirst` mode.
+ * @returns A wrapped validator function, or the original value when no wrapping is needed.
+ */
+export declare const wrapValidate: <TValues extends FieldValues, TName extends FieldPath<TValues>>(validate: NonNullable<RegisterOptions<TValues, TName>["validate"]>, mode?: FormItemProps<TValues>["validateFirst"]) => NonNullable<RegisterOptions<TValues, TName>["validate"]>;