@fuf-stack/uniform 1.8.9 → 1.9.0

package/dist/chunk-THCIT66I.cjs

@@ -0,0 +1,217 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkYCCBMAN2cjs = require('./chunk-YCCBMAN2.cjs');
+
+
+
+
+var _chunk555JRYCScjs = require('./chunk-555JRYCS.cjs');
+
+// src/RadioBoxes/RadioBoxes.tsx
+var _radio = require('@heroui/radio');
+var _pixelutils = require('@fuf-stack/pixel-utils');
+
+// src/RadioBoxes/RadioBox.tsx
+
+var _visuallyhidden = require('@react-aria/visually-hidden');
+
+var _jsxruntime = require('react/jsx-runtime');
+var radioBoxVariants = _pixelutils.tv.call(void 0, {
+  slots: {
+    base: "group inline-flex flex-auto cursor-pointer items-center justify-between gap-4 rounded-lg border-2 border-default p-4 hover:bg-content2 data-[selected=true]:border-focus",
+    control: "",
+    description: "text-foreground opacity-70 text-small",
+    icon: "",
+    label: "",
+    labelWrapper: "grow"
+  },
+  variants: {
+    isDisabled: {
+      true: {
+        base: "pointer-events-none opacity-disabled"
+      }
+    },
+    isInvalid: {
+      true: {
+        base: "!border-danger"
+      }
+    }
+  }
+});
+var RadioBox = (_a) => {
+  var _b = _a, {
+    classNames: _classNames = void 0,
+    icon = void 0,
+    isInvalid = false
+  } = _b, props = _chunk555JRYCScjs.__objRest.call(void 0, _b, [
+    "classNames",
+    "icon",
+    "isInvalid"
+  ]);
+  const {
+    children,
+    Component,
+    description,
+    getBaseProps,
+    getControlProps,
+    getInputProps,
+    getLabelProps,
+    getLabelWrapperProps,
+    getWrapperProps,
+    isDisabled
+  } = _radio.useRadio.call(void 0, props);
+  const variants = radioBoxVariants({
+    isDisabled,
+    isInvalid
+  });
+  const classNames = _pixelutils.variantsToClassNames.call(void 0, 
+    variants,
+    // @ts-expect-error not sure here, but it works
+    _classNames,
+    "base"
+  );
+  return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, Component, _chunk555JRYCScjs.__spreadProps.call(void 0, _chunk555JRYCScjs.__spreadValues.call(void 0, {}, getBaseProps()), { className: classNames.base, children: [
+    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _visuallyhidden.VisuallyHidden, { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "input", _chunk555JRYCScjs.__spreadValues.call(void 0, {}, getInputProps())) }),
+    !icon ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", _chunk555JRYCScjs.__spreadProps.call(void 0, _chunk555JRYCScjs.__spreadValues.call(void 0, {}, getWrapperProps()), { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      "span",
+      _chunk555JRYCScjs.__spreadProps.call(void 0, _chunk555JRYCScjs.__spreadValues.call(void 0, {}, getControlProps()), {
+        className: _pixelutils.cn.call(void 0, getControlProps().className, classNames.control)
+      })
+    ) })) : null,
+    icon ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: classNames.icon, children: icon }) : null,
+    /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
+      "div",
+      _chunk555JRYCScjs.__spreadProps.call(void 0, _chunk555JRYCScjs.__spreadValues.call(void 0, {}, getLabelWrapperProps()), {
+        className: _pixelutils.cn.call(void 0, 
+          getLabelWrapperProps().className,
+          classNames.labelWrapper
+        ),
+        children: [
+          children ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+            "span",
+            _chunk555JRYCScjs.__spreadProps.call(void 0, _chunk555JRYCScjs.__spreadValues.call(void 0, {}, getLabelProps()), {
+              className: _pixelutils.cn.call(void 0, getLabelProps().className, classNames.label),
+              children
+            })
+          ) : null,
+          description ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: classNames.description, children: description }) : null
+        ]
+      })
+    ),
+    icon ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", _chunk555JRYCScjs.__spreadProps.call(void 0, _chunk555JRYCScjs.__spreadValues.call(void 0, {}, getWrapperProps()), { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      "span",
+      _chunk555JRYCScjs.__spreadProps.call(void 0, _chunk555JRYCScjs.__spreadValues.call(void 0, {}, getControlProps()), {
+        className: _pixelutils.cn.call(void 0, getControlProps().className, classNames.control)
+      })
+    ) })) : null
+  ] }));
+};
+
+// src/RadioBoxes/RadioBoxes.tsx
+
+var radioBoxesVariants = _pixelutils.tv.call(void 0, {
+  slots: {
+    base: "group gap-0",
+    // Needs group for group-data condition
+    boxBase: "",
+    boxControl: "",
+    boxDescription: "",
+    boxLabel: "",
+    boxLabelWrapper: "",
+    // see HeroUI styles for group-data condition,
+    // e.g.: https://github.com/heroui-inc/heroui/blob/main/packages/core/theme/src/components/select.ts
+    label: "mb-2 inline-flex text-sm text-foreground subpixel-antialiased group-data-[invalid=true]:text-danger",
+    wrapper: ""
+  }
+});
+var RadioBoxes = (_a) => {
+  var _b = _a, {
+    className = void 0,
+    inline = false,
+    name,
+    options
+  } = _b, uniformFieldProps = _chunk555JRYCScjs.__objRest.call(void 0, _b, [
+    "className",
+    "inline",
+    "name",
+    "options"
+  ]);
+  const {
+    defaultValue,
+    errorMessage,
+    invalid,
+    disabled,
+    label,
+    onBlur,
+    onChange,
+    ref,
+    required,
+    testId
+  } = _chunkYCCBMAN2cjs.useUniformField.call(void 0, _chunk555JRYCScjs.__spreadValues.call(void 0, {
+    name
+  }, uniformFieldProps));
+  const variants = radioBoxesVariants();
+  const classNames = _pixelutils.variantsToClassNames.call(void 0, variants, className, "base");
+  const boxClassNames = {
+    base: classNames.boxBase,
+    control: classNames.boxControl,
+    description: classNames.boxDescription,
+    label: classNames.boxLabel,
+    labelWrapper: classNames.boxLabelWrapper
+  };
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+    _radio.RadioGroup,
+    {
+      ref,
+      classNames,
+      "data-invalid": invalid,
+      "data-required": required,
+      "data-testid": testId,
+      defaultValue,
+      errorMessage,
+      isDisabled: disabled,
+      isInvalid: invalid,
+      isRequired: required,
+      label: label ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "legend", { children: label }) : null,
+      name,
+      onBlur,
+      onValueChange: onChange,
+      orientation: inline ? "horizontal" : "vertical",
+      children: options.map((option) => {
+        var _a2, _b2;
+        if ("value" in option) {
+          const optionTestId = _pixelutils.slugify.call(void 0, 
+            `${testId}_option_${(_a2 = option.testId) != null ? _a2 : option.value}`,
+            { replaceDots: true }
+          );
+          return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+            RadioBox,
+            {
+              classNames: boxClassNames,
+              "data-testid": optionTestId,
+              description: option.description,
+              icon: option.icon,
+              isDisabled: !!disabled || option.disabled,
+              isInvalid: invalid,
+              value: option.value,
+              children: (_b2 = option.label) != null ? _b2 : option.value
+            },
+            option.value
+          );
+        }
+        return null;
+      })
+    }
+  );
+};
+var RadioBoxes_default = RadioBoxes;
+
+// src/RadioBoxes/index.ts
+var RadioBoxes_default2 = RadioBoxes_default;
+
+
+
+
+
+exports.radioBoxVariants = radioBoxVariants; exports.RadioBoxes_default = RadioBoxes_default; exports.RadioBoxes_default2 = RadioBoxes_default2;
+//# sourceMappingURL=chunk-THCIT66I.cjs.map

package/dist/chunk-THCIT66I.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-THCIT66I.cjs","../src/RadioBoxes/RadioBoxes.tsx","../src/RadioBoxes/RadioBox.tsx","../src/RadioBoxes/index.ts"],"names":["tv","variantsToClassNames","jsx","_a","_b","RadioBoxes_default"],"mappings":"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","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-THCIT66I.cjs","sourcesContent":[null,"import type { TVClassName, TVProps } from '@fuf-stack/pixel-utils';\nimport type { ReactNode } from 'react';\n//\nimport type { RadioBoxProps } from './RadioBox';\n\nimport { RadioGroup as HeroRadioGroup } from '@heroui/radio';\n\nimport { slugify, tv, variantsToClassNames } from '@fuf-stack/pixel-utils';\n\nimport { useUniformField } from '../hooks';\nimport { RadioBox } from './RadioBox';\n\nexport const radioBoxesVariants = tv({\n  slots: {\n    base: 'group gap-0', // Needs group for group-data condition\n    boxBase: '',\n    boxControl: '',\n    boxDescription: '',\n    boxLabel: '',\n    boxLabelWrapper: '',\n    // see HeroUI styles for group-data condition,\n    // e.g.: https://github.com/heroui-inc/heroui/blob/main/packages/core/theme/src/components/select.ts\n    label:\n      'mb-2 inline-flex text-sm text-foreground subpixel-antialiased group-data-[invalid=true]:text-danger',\n    wrapper: '',\n  },\n});\n\ntype VariantProps = TVProps<typeof radioBoxesVariants>;\ntype ClassName = TVClassName<typeof radioBoxesVariants>;\n\nexport interface RadioBoxesOption {\n  /** Description of the value. Works with variant radioBox. */\n  description?: ReactNode;\n  /** disables the option */\n  disabled?: boolean;\n  /** option label */\n  label?: ReactNode;\n  /** option icon */\n  icon?: ReactNode;\n  /** HTML data-testid attribute of the option */\n  testId?: string;\n  /** option value */\n  value: string;\n}\n\nexport interface RadioBoxesProps extends VariantProps {\n  /** CSS class name */\n  className?: ClassName;\n  /** Determines if the Buttons are disabled or not. */\n  disabled?: boolean;\n  /** determines orientation of the Buttons. */\n  inline?: boolean;\n  /** Label displayed next to the RadioButton. */\n  label?: ReactNode;\n  /** Name the RadioButtons are registered at in HTML forms (react-hook-form). */\n  name: string;\n  /** Radio button configuration. */\n  options: RadioBoxesOption[];\n  /** Id to grab element in internal tests. */\n  testId?: string;\n}\n\n/**\n * RadioBoxes component based on [HeroUI RadioGroup](https://www.heroui.com//docs/components/radio-group)\n */\nconst RadioBoxes = ({\n  className = undefined,\n  inline = false,\n  name,\n  options,\n  ...uniformFieldProps\n}: RadioBoxesProps) => {\n  const {\n    defaultValue,\n    errorMessage,\n    invalid,\n    disabled,\n    label,\n    onBlur,\n    onChange,\n    ref,\n    required,\n    testId,\n  } = useUniformField({\n    name,\n    ...uniformFieldProps,\n  });\n\n  // classNames from slots\n  const variants = radioBoxesVariants();\n  const classNames = variantsToClassNames(variants, className, 'base');\n  const boxClassNames: RadioBoxProps['classNames'] = {\n    base: classNames.boxBase,\n    control: classNames.boxControl,\n    description: classNames.boxDescription,\n    label: classNames.boxLabel,\n    labelWrapper: classNames.boxLabelWrapper,\n  };\n\n  return (\n    <HeroRadioGroup\n      ref={ref}\n      classNames={classNames}\n      // see HeroUI styles for group-data condition (data-invalid),\n      // e.g.: https://github.com/heroui-inc/heroui/blob/main/packages/components/select/src/use-select.ts\n      data-invalid={invalid}\n      data-required={required}\n      data-testid={testId}\n      defaultValue={defaultValue as string}\n      errorMessage={errorMessage}\n      isDisabled={disabled}\n      isInvalid={invalid}\n      isRequired={required}\n      label={label ? <legend>{label}</legend> : null}\n      name={name}\n      onBlur={onBlur}\n      onValueChange={onChange}\n      orientation={inline ? 'horizontal' : 'vertical'}\n    >\n      {options.map((option) => {\n        if ('value' in option) {\n          const optionTestId = slugify(\n            `${testId}_option_${option.testId ?? option.value}`,\n            { replaceDots: true },\n          );\n          return (\n            <RadioBox\n              key={option.value}\n              classNames={boxClassNames}\n              data-testid={optionTestId}\n              description={option.description}\n              icon={option.icon}\n              isDisabled={!!disabled || option.disabled}\n              isInvalid={invalid}\n              value={option.value}\n            >\n              {option.label ?? option.value}\n            </RadioBox>\n          );\n        }\n        return null;\n      })}\n    </HeroRadioGroup>\n  );\n};\n\nexport default RadioBoxes;\n","import type { TVClassName } from '@fuf-stack/pixel-utils';\nimport type { RadioProps as HeroRadioProps } from '@heroui/radio';\nimport type { ReactNode } from 'react';\n\nimport { useRadio } from '@heroui/radio';\nimport { VisuallyHidden } from '@react-aria/visually-hidden';\n\nimport { cn, tv, variantsToClassNames } from '@fuf-stack/pixel-utils';\n\nexport const radioBoxVariants = tv({\n  slots: {\n    base: 'group inline-flex flex-auto cursor-pointer items-center justify-between gap-4 rounded-lg border-2 border-default p-4 hover:bg-content2 data-[selected=true]:border-focus',\n    control: '',\n    description: 'text-foreground opacity-70 text-small',\n    icon: '',\n    label: '',\n    labelWrapper: 'grow',\n  },\n  variants: {\n    isDisabled: {\n      true: {\n        base: 'pointer-events-none opacity-disabled',\n      },\n    },\n    isInvalid: {\n      true: {\n        base: '!border-danger',\n      },\n    },\n  },\n});\n\ntype ClassName = TVClassName<typeof radioBoxVariants>;\n\nexport interface RadioBoxProps extends Omit<HeroRadioProps, 'className'> {\n  /** CSS class name */\n  className?: ClassName;\n  /** icon for the option */\n  icon?: ReactNode;\n  /** whether the radio is invalid */\n  isInvalid?: boolean;\n}\n\nexport const RadioBox = ({\n  classNames: _classNames = undefined,\n  icon = undefined,\n  isInvalid = false,\n  ...props\n}: RadioBoxProps) => {\n  const {\n    children,\n    Component,\n    description,\n    getBaseProps,\n    getControlProps,\n    getInputProps,\n    getLabelProps,\n    getLabelWrapperProps,\n    getWrapperProps,\n    isDisabled,\n  } = useRadio(props as HeroRadioProps);\n\n  // classNames from slots\n  const variants = radioBoxVariants({\n    isDisabled,\n    isInvalid,\n  });\n  const classNames = variantsToClassNames(\n    variants,\n    // @ts-expect-error not sure here, but it works\n    _classNames,\n    'base',\n  );\n\n  return (\n    <Component {...getBaseProps()} className={classNames.base}>\n      <VisuallyHidden>\n        <input {...getInputProps()} />\n      </VisuallyHidden>\n      {!icon ? (\n        <span {...getWrapperProps()}>\n          <span\n            {...getControlProps()}\n            className={cn(getControlProps().className, classNames.control)}\n          />\n        </span>\n      ) : null}\n      {icon ? <div className={classNames.icon}>{icon}</div> : null}\n      <div\n        {...getLabelWrapperProps()}\n        className={cn(\n          getLabelWrapperProps().className,\n          classNames.labelWrapper,\n        )}\n      >\n        {children ? (\n          <span\n            {...getLabelProps()}\n            className={cn(getLabelProps().className, classNames.label)}\n          >\n            {children}\n          </span>\n        ) : null}\n        {description ? (\n          <div className={classNames.description}>{description}</div>\n        ) : null}\n      </div>\n      {icon ? (\n        <span {...getWrapperProps()}>\n          <span\n            {...getControlProps()}\n            className={cn(getControlProps().className, classNames.control)}\n          />\n        </span>\n      ) : null}\n    </Component>\n  );\n};\n\nexport default RadioBox;\n","import RadioBoxes from './RadioBoxes';\n\nexport type { RadioBoxesProps } from './RadioBoxes';\nexport { radioBoxVariants } from './RadioBox';\n\nexport { RadioBoxes };\n\nexport default RadioBoxes;\n"]}

package/dist/{chunk-OKJWLH7T.cjs → chunk-TKICOKNS.cjs}

@@ -1,4 +1,9 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/helpers/nullishFields/nullishFields.ts
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/helpers/isTestEnvironment/isTestEnvironment.ts
+var isTestEnvironment = () => {
+  return typeof process !== "undefined" && (process.env.NODE_ENV === "test" || process.env.VITEST === "true");
+};
+
+// src/helpers/nullishFields/nullishFields.ts
 var _pixelutils = require('@fuf-stack/pixel-utils');
 var flatArrayKey = "__FLAT__";
 var nullString = "__NULL__";
@@ -150,5 +155,6 @@ var nameToTestId = (name) => {
 
 
 
-exports.flatArrayKey = flatArrayKey; exports.fromNullishString = fromNullishString; exports.toNullishString = toNullishString; exports.toFormFormat = toFormFormat; exports.toValidationFormat = toValidationFormat; exports.nameToTestId = nameToTestId;
-//# sourceMappingURL=chunk-OKJWLH7T.cjs.map
+
+exports.isTestEnvironment = isTestEnvironment; exports.flatArrayKey = flatArrayKey; exports.fromNullishString = fromNullishString; exports.toNullishString = toNullishString; exports.toFormFormat = toFormFormat; exports.toValidationFormat = toValidationFormat; exports.nameToTestId = nameToTestId;
+//# sourceMappingURL=chunk-TKICOKNS.cjs.map

package/dist/chunk-TKICOKNS.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-TKICOKNS.cjs","../src/helpers/isTestEnvironment/isTestEnvironment.ts","../src/helpers/nullishFields/nullishFields.ts"],"names":[],"mappings":"AAAA;ACwBO,IAAM,kBAAA,EAAoB,CAAA,EAAA,GAAe;AAG9C,EAAA,OACE,OAAO,QAAA,IAAY,YAAA,GAAA,CAClB,OAAA,CAAQ,GAAA,CAAI,SAAA,IAAa,OAAA,GAAU,OAAA,CAAQ,GAAA,CAAI,OAAA,IAAW,MAAA,CAAA;AAE/D,CAAA;AD3BA;AACA;AELA,oDAAwB;AAGjB,IAAM,aAAA,EAAe,UAAA;AAK5B,IAAM,WAAA,EAAa,UAAA;AACnB,IAAM,YAAA,EAAc,WAAA;AACpB,IAAM,WAAA,EAAa,UAAA;AAKZ,IAAM,kBAAA,EAAoB,CAAC,KAAA,EAAA,GAA4B;AAE5D,EAAA,GAAA,CAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AACxB,IAAA,OAAQ,KAAA,CAAoB,GAAA,CAAI,CAAC,KAAA,EAAA,GAAU;AACzC,MAAA,GAAA,CAAI,MAAA,GAAS,OAAO,MAAA,IAAU,QAAA,EAAU;AACtC,QAAA,MAAM,OAAA,EAAS,KAAA;AACf,QAAA,GAAA,CAAI,aAAA,GAAgB,MAAA,EAAQ;AAC1B,UAAA,MAAM,MAAA,EAAQ,MAAA,CAAO,YAAY,CAAA;AAEjC,UAAA,GAAA,CAAI,MAAA,IAAU,EAAA,EAAI;AAChB,YAAA,OAAO,IAAA;AAAA,UACT;AACA,UAAA,OAAO,iBAAA,CAAkB,KAAK,CAAA;AAAA,QAChC;AAAA,MACF;AACA,MAAA,OAAO,iBAAA,CAAkB,KAAK,CAAA;AAAA,IAChC,CAAC,CAAA;AAAA,EACH;AAEA,EAAA,GAAA,CAAI,OAAO,MAAA,IAAU,QAAA,EAAU;AAC7B,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,OAAA,CAAQ,KAAA,EAAO;AAAA,IACb,KAAK,UAAA;AACH,MAAA,OAAO,IAAA;AAAA,IACT,KAAK,WAAA;AACH,MAAA,OAAO,KAAA;AAAA,IACT,KAAK,UAAA;AACH,MAAA,OAAO,CAAA;AAAA,IACT,OAAA;AACE,MAAA,OAAO,KAAA;AAAA,EACX;AACF,CAAA;AAKO,IAAM,gBAAA,EAAkB,CAAC,KAAA,EAAA,GAA4B;AAC1D,EAAA,GAAA,CAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AAExB,IAAA,MAAM,YAAA,EAAc,CAAC,CAAA,EAAA,GAAe;AAClC,MAAA,OAAO,EAAA,IAAM,KAAA,GAAQ,CAAC,QAAA,EAAU,QAAA,EAAU,SAAS,CAAA,CAAE,QAAA,CAAS,OAAO,CAAC,CAAA;AAAA,IACxE,CAAA;AACA,IAAA,MAAM,iBAAA,EAAoB,KAAA,CAAoB,KAAA,CAAM,WAAW,CAAA;AAC/D,IAAA,GAAA,CAAI,gBAAA,EAAkB;AACpB,MAAA,OAAQ,KAAA,CAAoB,GAAA,CAAI,CAAC,CAAA,EAAA,GAAM;AAErC,QAAA,OAAO,EAAE,CAAC,YAAY,CAAA,EAAG,EAAE,CAAA;AAAA,MAC7B,CAAC,CAAA;AAAA,IACH;AACA,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,GAAA,CAAI,MAAA,IAAU,KAAA,GAAQ,MAAA,IAAU,EAAA,EAAI;AAClC,IAAA,OAAO,UAAA;AAAA,EACT;AACA,EAAA,GAAA,CAAI,MAAA,IAAU,KAAA,EAAO;AACnB,IAAA,OAAO,WAAA;AAAA,EACT;AACA,EAAA,GAAA,CAAI,MAAA,IAAU,CAAA,EAAG;AACf,IAAA,OAAO,UAAA;AAAA,EACT;AACA,EAAA,OAAO,KAAA;AACT,CAAA;AAoDO,IAAM,aAAA,EAAe,CAAC,MAAA,EAAA,GAAoC;AAC/D,EAAA,MAAM,eAAA,EAAiB,IAAA,CAAK,SAAA,CAAU,MAAA,EAAQ,CAAC,CAAA,EAAG,KAAA,EAAA,GAAU;AAC1D,IAAA,GAAA,CAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AAExB,MAAA,OAAO,eAAA,CAAgB,KAAK,CAAA;AAAA,IAC9B;AAEA,IAAA,GAAA,CAAI,MAAA,GAAS,OAAO,MAAA,IAAU,QAAA,EAAU;AAEtC,MAAA,MAAM,OAAA,EAAS,KAAA;AACf,MAAA,GAAA,CAAI,aAAA,GAAgB,MAAA,EAAQ;AAE1B,QAAA,OAAO,KAAA;AAAA,MACT;AACA,MAAA,OAAO,MAAA,CAAO,WAAA;AAAA,QACZ,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,CAAE,MAAA,CAAO,CAAC,CAAC,IAAA,EAAM,CAAC,CAAA,EAAA,GAAM;AAC1C,UAAA,OAAO,EAAA,IAAM,GAAA,GAAM,EAAA,IAAM,IAAA;AAAA,QAC3B,CAAC;AAAA,MACH,CAAA;AAAA,IACF;AAEA,IAAA,OAAO,KAAA;AAAA,EACT,CAAC,CAAA;AAED,EAAA,OAAO,IAAA,CAAK,KAAA,CAAM,cAAc,CAAA;AAClC,CAAA;AAkDO,IAAM,mBAAA,EAAqB,CAChC,SAAA,EAAA,GAC+C;AAE/C,EAAA,GAAA,CAAI,UAAA,IAAc,KAAA,EAAA,GAAa,UAAA,IAAc,IAAA,EAAM;AACjD,IAAA,OAAO,SAAA;AAAA,EACT;AAEA,EAAA,MAAM,qBAAA,EAAuB,IAAA,CAAK,SAAA,CAAU,SAAA,EAAW,CAAC,CAAA,EAAG,KAAA,EAAA,GAAU;AACnE,IAAA,GAAA,CAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AACxB,MAAA,OAAO,KAAA,CAAM,GAAA,CAAI,CAAC,CAAA,EAAA,GAAM;AAEtB,QAAA,GAAA,CAAI,EAAA,GAAK,OAAO,EAAA,IAAM,QAAA,EAAU;AAC9B,UAAA,MAAM,OAAA,EAAS,CAAA;AACf,UAAA,GAAA,CAAI,aAAA,GAAgB,MAAA,EAAQ;AAC1B,YAAA,MAAM,MAAA,EAAQ,MAAA,CAAO,YAAY,CAAA;AAEjC,YAAA,GAAA,CAAI,MAAA,IAAU,EAAA,EAAI;AAChB,cAAA,OAAO,IAAA;AAAA,YACT;AACA,YAAA,OAAO,iBAAA,CAAkB,KAAK,CAAA;AAAA,UAChC;AAAA,QACF;AAEA,QAAA,OAAO,iBAAA,CAAkB,CAAC,CAAA;AAAA,MAC5B,CAAC,CAAA;AAAA,IACH;AAEA,IAAA,GAAA,CAAI,MAAA,GAAS,OAAO,MAAA,IAAU,QAAA,EAAU;AAWtC,MAAA,OAAO,MAAA,CAAO,WAAA;AAAA,QACZ,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,CACjB,MAAA,CAAO,CAAC,CAAC,IAAA,EAAM,CAAC,CAAA,EAAA,GAAM;AAGrB,UAAA,GAAA,CAAI,EAAA,GAAK,OAAO,EAAA,IAAM,QAAA,EAAU;AAC9B,YAAA,MAAM,OAAA,EAAS,CAAA;AACf,YAAA,GAAA,CAAI,aAAA,GAAgB,MAAA,EAAQ;AAC1B,cAAA,MAAM,eAAA,EAAiB,iBAAA,CAAkB,MAAA,CAAO,YAAY,CAAC,CAAA;AAC7D,cAAA,OAAO,eAAA,IAAmB,GAAA,GAAM,eAAA,IAAmB,IAAA;AAAA,YACrD;AAAA,UACF;AAEA,UAAA,GAAA,CAAI,KAAA,CAAM,OAAA,CAAQ,CAAC,EAAA,GAAK,CAAA,CAAE,OAAA,IAAW,CAAA,EAAG;AACtC,YAAA,OAAO,KAAA;AAAA,UACT;AAEA,UAAA,MAAM,UAAA,EAAY,iBAAA,CAAkB,CAAC,CAAA;AACrC,UAAA,OAAO,UAAA,IAAc,GAAA,GAAM,UAAA,IAAc,IAAA;AAAA,QAC3C,CAAC,CAAA,CACA,GAAA,CAAI,CAAC,CAAC,CAAA,EAAG,CAAC,CAAA,EAAA,GAAM;AAEf,UAAA,GAAA,CAAI,EAAA,GAAK,OAAO,EAAA,IAAM,QAAA,EAAU;AAC9B,YAAA,MAAM,OAAA,EAAS,CAAA;AACf,YAAA,GAAA,CAAI,aAAA,GAAgB,MAAA,EAAQ;AAC1B,cAAA,OAAO,CAAC,CAAA,EAAG,iBAAA,CAAkB,MAAA,CAAO,YAAY,CAAC,CAAC,CAAA;AAAA,YACpD;AAAA,UACF;AAEA,UAAA,OAAO,CAAC,CAAA,EAAG,iBAAA,CAAkB,CAAC,CAAC,CAAA;AAAA,QACjC,CAAC;AAAA,MACL,CAAA;AAAA,IACF;AAEA,IAAA,OAAO,KAAA;AAAA,EACT,CAAC,CAAA;AAED,EAAA,OAAO,IAAA,CAAK,KAAA,CAAM,oBAAoB,CAAA;AACxC,CAAA;AAqBO,IAAM,aAAA,EAAe,CAAC,IAAA,EAAA,GAA6C;AACxE,EAAA,IAAI,SAAA;AAGJ,EAAA,GAAA,CAAI,KAAA,CAAM,OAAA,CAAQ,IAAI,CAAA,EAAG;AACvB,IAAA,UAAA,EAAY,IAAA,CACT,MAAA,CAAO,CAAC,OAAA,EAAA,GAAoB;AAC3B,MAAA,OAAO,QAAA,IAAY,YAAA;AAAA,IACrB,CAAC,CAAA,CACA,IAAA,CAAK,GAAG,CAAA;AAAA,EACb,EAAA,KAAO;AAEL,IAAA,MAAM,SAAA,EAAY,IAAA,CAAgB,KAAA,CAAM,GAAG,CAAA;AAC3C,IAAA,UAAA,EAAY,QAAA,CACT,MAAA,CAAO,CAAC,OAAA,EAAA,GAAoB;AAC3B,MAAA,OAAO,QAAA,IAAY,YAAA;AAAA,IACrB,CAAC,CAAA,CACA,IAAA,CAAK,GAAG,CAAA;AAAA,EACb;AAGA,EAAA,OAAO,iCAAA,SAAQ,EAAW,EAAE,WAAA,EAAa,KAAK,CAAC,CAAA;AACjD,CAAA;AFhLA;AACA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wSAAC","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-TKICOKNS.cjs","sourcesContent":[null,"/* eslint-disable import-x/prefer-default-export */\n\n/**\n * Checks if the code is running in a test environment.\n *\n * This helper safely detects test environments by checking:\n * - Node.js: `process.env.NODE_ENV === 'test'` or `process.env.VITEST === 'true'`\n * - Browser: Always returns `false` (production code)\n *\n * The check is safe for both Node.js and browser environments by verifying\n * that `process` exists before accessing its properties.\n *\n * @returns `true` if running in a test environment, `false` otherwise\n *\n * @example\n * ```ts\n * if (isTestEnvironment()) {\n *   // Skip debouncing in tests for immediate snapshots\n *   return value;\n * }\n * // Normal production behavior with debouncing\n * return debouncedValue;\n * ```\n */\nexport const isTestEnvironment = (): boolean => {\n  // Safe check: only access process if it exists (Node.js environment)\n  // In browsers, process is undefined, so this returns false\n  return (\n    typeof process !== 'undefined' &&\n    (process.env.NODE_ENV === 'test' || process.env.VITEST === 'true')\n  );\n};\n","import { slugify } from '@fuf-stack/pixel-utils';\n\n/** Key used to wrap flat array elements when converting to form format */\nexport const flatArrayKey = '__FLAT__';\n\n/**\n * String markers used to preserve null, false, and 0 values during JSON processing\n */\nconst nullString = '__NULL__';\nconst falseString = '__FALSE__';\nconst zeroString = '__ZERO__';\n\n/**\n * Converts marker strings back to their original values when processing arrays\n */\nexport const fromNullishString = (value: unknown): unknown => {\n  // Support arrays: unwrap flat wrappers and convert marker strings per entry\n  if (Array.isArray(value)) {\n    return (value as unknown[]).map((entry) => {\n      if (entry && typeof entry === 'object') {\n        const record = entry as Record<string, unknown>;\n        if (flatArrayKey in record) {\n          const inner = record[flatArrayKey];\n          // For arrays, treat empty string as null (placeholder input)\n          if (inner === '') {\n            return null;\n          }\n          return fromNullishString(inner);\n        }\n      }\n      return fromNullishString(entry);\n    });\n  }\n\n  if (typeof value !== 'string') {\n    return value;\n  }\n\n  switch (value) {\n    case nullString:\n      return null;\n    case falseString:\n      return false;\n    case zeroString:\n      return 0;\n    default:\n      return value;\n  }\n};\n\n/**\n * Converts null/falsy values to marker strings for JSON processing\n */\nexport const toNullishString = (value: unknown): unknown => {\n  if (Array.isArray(value)) {\n    // Only wrap arrays of primitives; leave arrays of objects as-is\n    const isPrimitive = (v: unknown) => {\n      return v === null || ['string', 'number', 'boolean'].includes(typeof v);\n    };\n    const isPrimitiveArray = (value as unknown[]).every(isPrimitive);\n    if (isPrimitiveArray) {\n      return (value as unknown[]).map((v) => {\n        // Store raw primitive; do not convert to marker strings inside the wrapper\n        return { [flatArrayKey]: v } as Record<string, unknown>;\n      });\n    }\n    return value;\n  }\n  if (value === null || value === '') {\n    return nullString;\n  }\n  if (value === false) {\n    return falseString;\n  }\n  if (value === 0) {\n    return zeroString;\n  }\n  return value;\n};\n\n/**\n * Converts field values to a format suitable for forms by:\n * - Wrapping arrays of primitives as objects using the flatArrayKey `__FLAT__`\n *   to satisfy RHF's requirement that array fields contain objects\n * - Removing empty strings and null values from objects\n *\n * This conversion is required because React Hook Form does not support arrays with\n * flat values (string, number, boolean, null). Array fields must contain objects.\n * We work around this by wrapping primitive entries: `{ __FLAT__: <value> }`.\n *\n * @example\n * const fields = {\n *   name: 'John',\n *   scores: [0, null, 75, false],\n *   scoresDetailed: [\n *     { score: 1 },\n *     { score: null },\n *     { score: 0 },\n *     { score: false },\n *     { score: '' },\n *   ],\n *   contact: {\n *     email: '',\n *     phone: null,\n *     address: '123 Main St'\n *   }\n * };\n *\n * // Result:\n * {\n *   name: 'John',\n *   scores: [\n *     { __FLAT__: 0 },\n *     { __FLAT__: null },\n *     { __FLAT__: 75 },\n *     { __FLAT__: false }\n *   ],\n *   // Arrays of objects are left as objects; empty/null properties are removed\n *   scoresDetailed: [\n *     { score: 1 },\n *     {}, // null score removed\n *     { score: 0 },\n *     { score: false },\n *     {}, // empty string removed\n *   ],\n *   contact: {\n *     address: '123 Main St'\n *   }\n * }\n */\nexport const toFormFormat = (fields: Record<string, unknown>) => {\n  const formFormatJson = JSON.stringify(fields, (_, value) => {\n    if (Array.isArray(value)) {\n      // Delegate to toNullishString to ensure consistent handling\n      return toNullishString(value);\n    }\n\n    if (value && typeof value === 'object') {\n      // Preserve flat-array wrappers as-is (do not filter their inner values here)\n      const record = value as Record<string, unknown>;\n      if (flatArrayKey in record) {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n        return value;\n      }\n      return Object.fromEntries(\n        Object.entries(value).filter(([_key, v]) => {\n          return v !== '' && v !== null;\n        }),\n      );\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return value;\n  });\n\n  return JSON.parse(formFormatJson) as Record<string, unknown>;\n};\n\n/**\n * Converts form state to a format suitable for validation by:\n * - Unwrapping flat array wrappers `{ __FLAT__: <value> }` back to primitives\n * - Converting legacy string markers (__NULL__, __FALSE__, __ZERO__) back to their original values\n * - Removing fields whose converted value is empty string or null\n * - Removing empty arrays\n *\n * @example\n * const formState = {\n *   name: 'John',\n *   scores: [\n *     { __FLAT__: 75 },\n *     { __FLAT__: 0 },\n *     { __FLAT__: null },\n *     { __FLAT__: false }\n *   ],\n *   emptyArray: [],\n *   scoresDetailed: [\n *     { score: 1 },\n *     {},\n *     { score: 0 },\n *     { score: false },\n *     {},\n *   ],\n *   contact: {\n *     address: '123 Main St',\n *     fax: null\n *   }\n * };\n *\n * // Result:\n * {\n *   name: 'John',\n *   scores: [75, 0, null, false],\n *   // emptyArray is removed\n *   // Objects inside arrays remain objects; empty entries remain empty objects\n *   scoresDetailed: [\n *     { score: 1 },\n *     {},\n *     { score: 0 },\n *     { score: false },\n *     {},\n *   ],\n *   contact: {\n *     address: '123 Main St'\n *   }\n * }\n */\nexport const toValidationFormat = (\n  formState: Record<string, unknown> | null | undefined,\n): Record<string, unknown> | null | undefined => {\n  // Handle null or undefined input\n  if (formState === undefined || formState === null) {\n    return formState;\n  }\n\n  const validationFormatJson = JSON.stringify(formState, (_, value) => {\n    if (Array.isArray(value)) {\n      return value.map((v) => {\n        // Unwrap new wrapper format { __FLAT__: <value> }\n        if (v && typeof v === 'object') {\n          const record = v as Record<string, unknown>;\n          if (flatArrayKey in record) {\n            const inner = record[flatArrayKey];\n            // Treat empty string from forms as null in validation format\n            if (inner === '') {\n              return null;\n            }\n            return fromNullishString(inner);\n          }\n        }\n        // Backward compatibility for string markers\n        return fromNullishString(v);\n      });\n    }\n\n    if (value && typeof value === 'object') {\n      // Object branch: remove keys that resolve to empty/null after marker conversion\n      // and unwrap flat-array wrappers if present.\n      //\n      // Why this shape?\n      // - Forms may contain objects with placeholder/empty values that should not\n      //   be part of the validation payload (e.g. \"\" or __NULL__ markers).\n      // - Arrays of primitives are stored as wrapper objects { __FLAT__: <value> }\n      //   to satisfy RHF structure constraints. When converting back for\n      //   validation, we need to treat wrappers whose inner value resolves to\n      //   empty/null as removable, and unwrap non-empty wrappers to the primitive.\n      return Object.fromEntries(\n        Object.entries(value)\n          .filter(([_key, v]) => {\n            // If this is a flat-array wrapper, convert the inner value first and\n            // drop the key when the inner resolves to empty string or null.\n            if (v && typeof v === 'object') {\n              const record = v as Record<string, unknown>;\n              if (flatArrayKey in record) {\n                const convertedInner = fromNullishString(record[flatArrayKey]);\n                return convertedInner !== '' && convertedInner !== null;\n              }\n            }\n            // Drop empty arrays\n            if (Array.isArray(v) && v.length === 0) {\n              return false;\n            }\n            // For regular values, convert markers and drop when empty/null.\n            const converted = fromNullishString(v);\n            return converted !== '' && converted !== null;\n          })\n          .map(([k, v]) => {\n            // Unwrap flat-array wrappers to raw primitives after conversion.\n            if (v && typeof v === 'object') {\n              const record = v as Record<string, unknown>;\n              if (flatArrayKey in record) {\n                return [k, fromNullishString(record[flatArrayKey])];\n              }\n            }\n            // For other values, just convert markers.\n            return [k, fromNullishString(v)];\n          }),\n      );\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return value;\n  });\n\n  return JSON.parse(validationFormatJson) as Record<string, unknown>;\n};\n\n/**\n * Converts a field name to a testId by removing flat array key segments and slugifying.\n * Removes all occurrences of `flatArrayKey` from the field name and applies slugify transformation.\n *\n * This is used to generate stable testIds for form fields that don't include\n * the internal `__FLAT__` marker used for flat arrays.\n *\n * @param name - The field name as a string (e.g., 'tags.0.__FLAT__') or array path (e.g., ['tags', '0', '__FLAT__'])\n * @returns The slugified field name with all flat array key segments removed (e.g., 'tags_0')\n *\n * @example\n * ```ts\n * nameToTestId('tags.0.__FLAT__') // => 'tags_0'\n * nameToTestId('array.0.__FLAT__') // => 'array_0'\n * nameToTestId('nested.array.0.__FLAT__.field') // => 'nested_array_0_field'\n * nameToTestId('simple.field') // => 'simple_field'\n * nameToTestId(['tags', '0', '__FLAT__']) // => 'tags_0'\n * ```\n */\nexport const nameToTestId = (name: string | readonly string[]): string => {\n  let cleanName: string;\n\n  // Handle array paths - filter out flatArrayKey and join with dots\n  if (Array.isArray(name)) {\n    cleanName = name\n      .filter((segment: string) => {\n        return segment !== flatArrayKey;\n      })\n      .join('.');\n  } else {\n    // Handle string paths - split by dots and filter out flatArrayKey segments\n    const segments = (name as string).split('.');\n    cleanName = segments\n      .filter((segment: string) => {\n        return segment !== flatArrayKey;\n      })\n      .join('.');\n  }\n\n  // Apply slugify transformation\n  return slugify(cleanName, { replaceDots: true });\n};\n"]}

package/dist/{chunk-IV45K4WU.js → chunk-TUIK3MER.js}

@@ -1,7 +1,7 @@
 import {
   toFormFormat,
   toValidationFormat
-} from "./chunk-O2XJNQQK.js";
+} from "./chunk-BOCYHTFE.js";
 import {
   __async,
   __objRest,
@@ -274,4 +274,4 @@ export {
   UniformContext,
   FormContext_default
 };
-//# sourceMappingURL=chunk-IV45K4WU.js.map
+//# sourceMappingURL=chunk-TUIK3MER.js.map

package/dist/{chunk-AQJLKHAE.cjs → chunk-UBLASN6D.cjs}

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
 
-var _chunkOKJWLH7Tcjs = require('./chunk-OKJWLH7T.cjs');
+var _chunkTKICOKNScjs = require('./chunk-TKICOKNS.cjs');
 
 
 
@@ -93,7 +93,7 @@ var useFormResolver = (extendedValidation) => {
     }
     return (values) => _chunk555JRYCScjs.__async.call(void 0, null, null, function* () {
       var _a, _b, _c, _d;
-      const validationValues = (_a = _chunkOKJWLH7Tcjs.toValidationFormat.call(void 0, values)) != null ? _a : {};
+      const validationValues = (_a = _chunkTKICOKNScjs.toValidationFormat.call(void 0, values)) != null ? _a : {};
       const result = yield extendedValidation.validateAsync(validationValues);
       validationErrors.current = (_b = result.errors) != null ? _b : void 0;
       return {
@@ -174,7 +174,7 @@ var FormProvider = ({
   const { extendedValidation, setClientValidationSchema } = useExtendedValidation(baseValidation);
   const { resolver, validationErrors, validationErrorsHash } = useFormResolver(extendedValidation);
   const methods = _reacthookform.useForm.call(void 0, {
-    defaultValues: initialValues ? _chunkOKJWLH7Tcjs.toFormFormat.call(void 0, initialValues) : initialValues,
+    defaultValues: initialValues ? _chunkTKICOKNScjs.toFormFormat.call(void 0, initialValues) : initialValues,
     // set rhf mode
     // see: https://react-hook-form.com/docs/useform#mode
     mode: validationTrigger,
@@ -226,7 +226,7 @@ var FormProvider = ({
     });
     const wrappedOnSubmit = (data, event) => {
       var _a2;
-      const submitData = (_a2 = _chunkOKJWLH7Tcjs.toValidationFormat.call(void 0, data)) != null ? _a2 : {};
+      const submitData = (_a2 = _chunkTKICOKNScjs.toValidationFormat.call(void 0, data)) != null ? _a2 : {};
       debug("onSubmit callback called", { submitData });
       return onSubmit(submitData, event);
     };
@@ -274,4 +274,4 @@ var FormContext_default = FormProvider;
 
 
 exports.UniformContext = UniformContext; exports.FormContext_default = FormContext_default;
-//# sourceMappingURL=chunk-AQJLKHAE.cjs.map
+//# sourceMappingURL=chunk-UBLASN6D.cjs.map

package/dist/{chunk-AQJLKHAE.cjs.map → chunk-UBLASN6D.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-AQJLKHAE.cjs","../src/Form/subcomponents/FormContext.tsx","../src/Form/subcomponents/FormResolver.ts"],"names":["useState","useRef","_a","useMemo"],"mappings":"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","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-AQJLKHAE.cjs","sourcesContent":[null,"import type {\n  VetoFormattedError,\n  VetoInstance,\n  VetoTypeAny,\n} from '@fuf-stack/veto';\nimport type { BaseSyntheticEvent, ReactNode } from 'react';\nimport type { FieldValues, Path, SubmitHandler } from 'react-hook-form';\n\nimport React, { useCallback, useMemo, useRef, useState } from 'react';\nimport { FormProvider as HookFormProvider, useForm } from 'react-hook-form';\n\nimport createDebug from 'debug';\n\nimport { useLocalStorage } from '@fuf-stack/pixels';\n\nimport { toFormFormat, toValidationFormat } from '../../helpers';\nimport { useExtendedValidation, useFormResolver } from './FormResolver';\n\nconst debug = createDebug('uniform:FormContext');\n\ntype DebugMode = 'debug' | 'debug-testids' | 'off' | 'disabled';\n\nexport interface DebugModeSettings {\n  /** disable form debug completely */\n  disable?: boolean;\n  /** custom localStorage key to save debug mode state */\n  localStorageKey?: string;\n}\n\n/**\n * Listener function that gets called when a field changes due to user input\n */\nexport type UserChangeListener<TFieldValues extends object = object> = (\n  fieldName: Path<TFieldValues>,\n  value: unknown,\n) => void;\n\nconst DEBUG_MODE_LOCAL_STORAGE_KEY_DEFAULT = 'uniform:debug-mode';\n\n/**\n * The `UniformContext` provides control over the form's submission behavior and may optionally include\n * a Veto validation schema for form validation.\n *\n * Specifically, this context offers:\n * 1. **Form Submission Control**: The `preventSubmit` function allows components to enable or disable\n *    form submissions.\n * 2. **Optional Validation Schema**: The `validation` property may hold a Veto validation schema instance\n *    that can be used to validate form fields and handle validation logic.\n * 3. **Client Validation**: The `setClientValidationSchema` function allows setting dynamic client-side\n *    validation schemas that complement the base Veto validation.\n * 4. **User Change Tracking**: The `userChange` property provides a pub/sub system for tracking\n *    user-initiated field changes (typing, clicking, selecting) - NOT programmatic changes like\n *    form.reset() or form.setValue(). Used by the `useWatchUserChange` hook to enable reactive\n *    field dependencies.\n *\n * This context is useful for components that need to interact with or control the form submission state,\n * or access the validation schema for managing form validation logic.\n *\n * IMPORTANT: Context Singleton Pattern for HMR (Hot Module Replacement)\n * =====================================================================\n *\n * We use a global window variable to ensure only ONE context instance exists across\n * hot module reloads during development. This is critical because:\n *\n * **The Problem:**\n * When using Vite/Storybook with Fast Refresh (HMR), editing this file causes it to\n * be re-evaluated. Each re-evaluation runs `React.createContext()` again, creating a\n * NEW context instance. This leads to \"context instance mismatch\":\n *\n *   1. FormProvider (provider) loads and uses context instance A\n *   2. File is edited, HMR triggers\n *   3. SubmitButton (consumer) hot-reloads and imports context instance B\n *   4. Provider writes to instance A, Consumer reads from instance B\n *   5. Result: Consumer sees default values (triggerSubmit = () => undefined)\n *   6. Clicking submit does nothing because it calls the empty default function\n *\n * **The Solution:**\n * By storing the context in `window.__UNIFORM_CONTEXT__`, we ensure:\n *   - First load: Create context and store in window\n *   - Subsequent HMRs: Reuse the same context from window\n *   - All components always reference the SAME context instance\n *   - Provider and consumers can properly communicate\n *\n * **Why This Is Safe:**\n * - Only affects development (production has no HMR)\n * - Context type never changes (same interface)\n * - React handles cleanup on unmount normally\n * - No memory leaks (context is lightweight)\n *\n * Without this pattern, you'd need to restart the dev server after every edit\n * to FormContext.tsx to ensure all components use the same context instance.\n */\n\n// Define the context type\ninterface UniformContextType {\n  /** Form debug mode enabled or not */\n  debugMode: DebugMode;\n  /** settings for from debug mode */\n  debugModeSettings?: DebugModeSettings;\n  /** Function to update if the form can currently be submitted */\n  preventSubmit: (prevent: boolean) => void;\n  /** Setter to enable or disable form debug mode */\n  setDebugMode: (debugMode: DebugMode) => void;\n  /** Function to trigger form submit programmatically */\n  triggerSubmit: (e?: BaseSyntheticEvent) => Promise<void> | void;\n  /** User change tracking (user input only, not programmatic changes) */\n  userChange: {\n    /**\n     * Subscribe to user field changes.\n     * Returns an unsubscribe function.\n     */\n    subscribe: (listener: UserChangeListener) => () => void;\n    /**\n     * Notify all subscribers about a user field change.\n     * Called from useController when user interacts with a field.\n     */\n    notify: (fieldName: string, value: unknown) => void;\n  };\n  /** Form validation configuration */\n  validation: {\n    /** Base validation schema instance (without client validation) */\n    baseInstance?: VetoInstance;\n    /** Veto validation schema instance for form validation */\n    instance?: VetoInstance;\n    /** Current validation errors in form */\n    errors?: VetoFormattedError;\n    /** Function to set client validation schema for a specific key */\n    setClientValidationSchema: (\n      key: string,\n      schema: VetoTypeAny | null,\n    ) => void;\n  };\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nif (!(window as any).__UNIFORM_CONTEXT__) {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  (window as any).__UNIFORM_CONTEXT__ = React.createContext<UniformContextType>(\n    {\n      debugMode: 'off',\n      preventSubmit: () => {\n        return undefined;\n      },\n      setDebugMode: () => {\n        return undefined;\n      },\n      triggerSubmit: () => {\n        return undefined;\n      },\n      userChange: {\n        subscribe: () => {\n          return () => {\n            return undefined;\n          };\n        },\n        notify: () => {\n          return undefined;\n        },\n      },\n      validation: {\n        setClientValidationSchema: () => {\n          return undefined;\n        },\n      },\n    },\n  );\n  debug('Creating new UniformContext instance');\n} else {\n  debug(\n    'Reusing existing UniformContext instance from window.__UNIFORM_CONTEXT__',\n  );\n}\n\n// Export the singleton context instance from window\n// This ensures all imports get the same context, even after HMR\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const UniformContext = (window as any)\n  .__UNIFORM_CONTEXT__ as React.Context<UniformContextType>;\n\ndebug('UniformContext exported', {\n  contextExists: !!UniformContext,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  windowContextExists: !!(window as any).__UNIFORM_CONTEXT__,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  contextsMatch: UniformContext === (window as any).__UNIFORM_CONTEXT__,\n});\n\n// Define props for the FormProvider component, extending HookForm's props\ninterface FormProviderProps {\n  /** children form render function */\n  children: (childProps: {\n    handleSubmit: (e?: BaseSyntheticEvent) => Promise<void>;\n    isValid: boolean;\n  }) => ReactNode;\n  /** settings for from debug mode */\n  debugModeSettings?: DebugModeSettings;\n  /** initial form values */\n  initialValues?: FieldValues;\n  /** form submit handler */\n  onSubmit: SubmitHandler<FieldValues>;\n  /** Veto validation schema instance */\n  validation?: VetoInstance;\n  /** when the validation should be triggered */\n  validationTrigger: 'onChange' | 'onBlur' | 'onSubmit' | 'onTouched' | 'all';\n}\n\n/**\n * FormProvider component provides:\n * - Veto validation schema context\n * - Client validation schema management\n * - Submit handler with automatic data conversion and submission control with preventSubmit\n * - Form Debug Mode state\n * - React Hook Form context\n */\nconst FormProvider: React.FC<FormProviderProps> = ({\n  children,\n  debugModeSettings = undefined,\n  initialValues = undefined,\n  onSubmit,\n  validation: baseValidation = undefined,\n  validationTrigger,\n}) => {\n  // Form Debug mode state is handled in the form context\n  const [debugMode, setDebugMode] = useLocalStorage<DebugMode>(\n    debugModeSettings?.localStorageKey ?? DEBUG_MODE_LOCAL_STORAGE_KEY_DEFAULT,\n    'off',\n  );\n\n  // Create extended validation combining base + client validations\n  const { extendedValidation, setClientValidationSchema } =\n    useExtendedValidation(baseValidation);\n\n  // Create resolver from extended validation + get current validation errors\n  const { resolver, validationErrors, validationErrorsHash } =\n    useFormResolver(extendedValidation);\n\n  // Initialize react hook form with the resolver\n  const methods = useForm({\n    defaultValues: initialValues ? toFormFormat(initialValues) : initialValues,\n    // set rhf mode\n    // see: https://react-hook-form.com/docs/useform#mode\n    mode: validationTrigger,\n    resolver,\n  });\n\n  // Get isValid from React Hook Form's formState\n  const isValid = methods.formState?.isValid;\n\n  // Control if the form can currently be submitted\n  const [preventSubmit, setPreventSubmit] = useState(false);\n\n  // User change listener registry (stored in ref to avoid re-renders)\n  const userChangeListenersRef = useRef<Set<UserChangeListener>>(new Set());\n\n  // Subscribe to user changes\n  const subscribeUserChange = useCallback(\n    (listener: UserChangeListener): (() => void) => {\n      userChangeListenersRef.current.add(listener);\n      // Return cleanup function to unsubscribe\n      return () => {\n        userChangeListenersRef.current.delete(listener);\n      };\n    },\n    [],\n  );\n\n  // Notify all subscribers about user change\n  const notifyUserChange = useCallback(\n    (fieldName: string, value: unknown): void => {\n      // Notify all registered listeners\n      userChangeListenersRef.current.forEach((listener) => {\n        listener(fieldName as Path<object>, value);\n      });\n    },\n    [],\n  );\n\n  // Create submit handler with automatic data conversion\n  // eslint-disable-next-line consistent-return\n  const handleSubmit = async (e?: React.BaseSyntheticEvent) => {\n    debug('handleSubmit called', {\n      preventSubmit,\n      formStateIsValid: methods.formState.isValid,\n      validationErrors: methods.formState.errors,\n      validationTrigger,\n      formValues: methods.getValues(),\n    });\n\n    // only prevent submit when form state is valid, because otherwise\n    // submit will only trigger validation and add errors / focus invalid fields\n    if (methods.formState.isValid && preventSubmit) {\n      debug('⛔ Form submit PREVENTED', {\n        formStateIsValid: methods.formState.isValid,\n        preventSubmit,\n      });\n      console.warn(\n        '[FormProvider] form submit was prevented because preventSubmit is true...',\n      );\n      e?.preventDefault();\n      return Promise.resolve();\n    }\n\n    debug('✓ Form submit ALLOWED', {\n      formStateIsValid: methods.formState.isValid,\n      preventSubmit,\n      reason: !methods.formState.isValid\n        ? 'Form is invalid (will trigger validation and show errors)'\n        : 'Form is valid and preventSubmit is false',\n    });\n\n    // Convert nullish strings and filter out empty values before submission\n    const wrappedOnSubmit = (data: FieldValues, event?: BaseSyntheticEvent) => {\n      const submitData = toValidationFormat(data) ?? {};\n      debug('onSubmit callback called', { submitData });\n      return onSubmit(submitData, event);\n    };\n\n    await methods.handleSubmit(wrappedOnSubmit)(e);\n\n    debug('handleSubmit completed');\n  };\n\n  // Memoize the context value to prevent re-renders\n  const contextValue = useMemo(\n    () => {\n      return {\n        // set debugMode to disabled when debugModeSettings.disable is true\n        // otherwise use current debug mode from localStorage\n        debugMode: debugModeSettings?.disable ? 'disabled' : debugMode,\n        preventSubmit: (prevent: boolean) => {\n          debug('preventSubmit called', {\n            previousValue: preventSubmit,\n            newValue: prevent,\n            formStateIsValid: methods.formState.isValid,\n            validationErrors: methods.formState.errors,\n          });\n          setPreventSubmit(prevent);\n        },\n        setClientValidationSchema,\n        setDebugMode,\n        triggerSubmit: handleSubmit,\n        userChange: {\n          subscribe: subscribeUserChange,\n          notify: notifyUserChange,\n        },\n        validation: {\n          baseInstance: baseValidation,\n          instance: extendedValidation,\n          errors: validationErrors,\n          setClientValidationSchema,\n        },\n      };\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [debugMode, debugModeSettings?.disable, validationErrorsHash],\n  );\n\n  return (\n    <UniformContext.Provider value={contextValue}>\n      {/* Spread all hook form props into HookFormProvider */}\n      <HookFormProvider {...methods}>\n        {children({ handleSubmit, isValid })}\n      </HookFormProvider>\n    </UniformContext.Provider>\n  );\n};\n\nexport default FormProvider;\n","import type {\n  VetoFormattedError,\n  VetoInstance,\n  VetoTypeAny,\n} from '@fuf-stack/veto';\nimport type { FieldValues } from 'react-hook-form';\n\nimport { useMemo, useRef, useState } from 'react';\n\nimport { and, veto } from '@fuf-stack/veto';\n\nimport { toValidationFormat } from '../../helpers';\n\n/**\n * Hook that manages client validation schemas state.\n *\n * Provides a centralized way to add/remove dynamic validation schemas\n * that can be combined with base form validation.\n *\n * @returns Object with client validation state and memoized setter function\n */\nexport const useClientValidationManager = () => {\n  // Client validation schemas state\n  const [clientValidationSchemas, setClientValidationSchemas] = useState<\n    Record<string, VetoTypeAny>\n  >({});\n\n  // Memoized function to set/clear client validation schema\n  const setClientValidationSchema = useMemo(() => {\n    return (key: string, schema: VetoTypeAny | null) => {\n      // update client validation schemas\n      setClientValidationSchemas((prev) => {\n        // if no schema and no existing client validation schema for this key, do nothing\n        if (!prev[key] && !schema) {\n          return prev;\n        }\n        // if no schema, remove the client validation schema for this key\n        if (!schema) {\n          const { [key]: _removed, ...rest } = prev;\n          return rest;\n        }\n        // if schema, add or update the client validation schema for this key\n        return { ...prev, [key]: schema };\n      });\n    };\n  }, []);\n\n  return {\n    clientValidationSchemas,\n    setClientValidationSchema,\n  };\n};\n\n/**\n * Hook that creates an extended validation instance combining base Veto validation with dynamic client validation.\n *\n * @param baseValidation - Optional base Veto validation schema\n * @returns Combined validation instance and client schema setter\n */\nexport const useExtendedValidation = (baseValidation?: VetoInstance) => {\n  // Setup client validation schemas\n  const { clientValidationSchemas, setClientValidationSchema } =\n    useClientValidationManager();\n\n  // Create a stable dependency array from the client validation schemas\n  const clientSchemaValues = useMemo(\n    () => {\n      const keys = Object.keys(clientValidationSchemas).sort();\n      return keys\n        .map((key) => {\n          return clientValidationSchemas[key];\n        })\n        .filter(Boolean);\n    },\n    // Include the object identity to react to schema instance updates with same shape\n    [clientValidationSchemas],\n  );\n\n  // Memoized extended validation instance\n  const extendedValidation = useMemo(\n    () => {\n      const hasBaseValidation = !!baseValidation;\n      const hasClientSchemas = clientSchemaValues.length > 0;\n\n      // If no base validation and no client schemas, return undefined\n      if (!hasBaseValidation && !hasClientSchemas) {\n        return undefined;\n      }\n\n      // If no client schemas, return base validation\n      if (!hasClientSchemas) {\n        return baseValidation;\n      }\n\n      // Combine client validation schemas\n      const clientSchemasCombined = clientSchemaValues.reduce(\n        // @ts-expect-error is ok, because initially it is null\n        (combined, clientSchema) => {\n          return combined ? and(combined, clientSchema) : clientSchema;\n        },\n        null,\n      );\n\n      // return combined validation\n      if (hasBaseValidation && clientSchemasCombined) {\n        return veto(and(baseValidation.schema, clientSchemasCombined));\n      }\n\n      // If we only have client schemas, return them as a veto instance\n      if (clientSchemasCombined) {\n        return veto(clientSchemasCombined);\n      }\n\n      // This should not happen due to the conditions above, but just in case\n      return baseValidation;\n    },\n    // Recompute when validation schema instances change\n    [baseValidation, clientSchemaValues],\n  );\n\n  return {\n    extendedValidation,\n    setClientValidationSchema,\n  };\n};\n\n/**\n * Hook that creates a React Hook Form resolver from an extended validation instance.\n *\n * @param extendedValidation - Extended validation instance from useExtendedValidation\n * @returns Object containing resolver function, current validation errors, and optimization hash\n */\nexport const useFormResolver = (extendedValidation?: VetoInstance) => {\n  // Use ref to store validation errors without triggering re-renders\n  const validationErrors = useRef<VetoFormattedError>(undefined);\n\n  // Memoized resolver function for React Hook Form\n  const resolver = useMemo(() => {\n    if (!extendedValidation) {\n      return undefined;\n    }\n\n    return async (values: FieldValues) => {\n      const validationValues = toValidationFormat(values) ?? {};\n      const result = await extendedValidation.validateAsync(validationValues);\n      validationErrors.current = result.errors ?? undefined;\n\n      // Transform veto result to React Hook Form format\n      return {\n        values: result.data ?? {},\n        errors: result.errors ?? {},\n      };\n    };\n  }, [extendedValidation]);\n\n  // Hash for memo dependency optimization in consuming components\n  const validationErrorsHash = JSON.stringify(validationErrors.current);\n\n  return {\n    resolver,\n    validationErrors: validationErrors.current,\n    validationErrorsHash,\n  };\n};\n"]}
+{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-UBLASN6D.cjs","../src/Form/subcomponents/FormContext.tsx","../src/Form/subcomponents/FormResolver.ts"],"names":["useState","useRef","_a","useMemo"],"mappings":"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","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-UBLASN6D.cjs","sourcesContent":[null,"import type {\n  VetoFormattedError,\n  VetoInstance,\n  VetoTypeAny,\n} from '@fuf-stack/veto';\nimport type { BaseSyntheticEvent, ReactNode } from 'react';\nimport type { FieldValues, Path, SubmitHandler } from 'react-hook-form';\n\nimport React, { useCallback, useMemo, useRef, useState } from 'react';\nimport { FormProvider as HookFormProvider, useForm } from 'react-hook-form';\n\nimport createDebug from 'debug';\n\nimport { useLocalStorage } from '@fuf-stack/pixels';\n\nimport { toFormFormat, toValidationFormat } from '../../helpers';\nimport { useExtendedValidation, useFormResolver } from './FormResolver';\n\nconst debug = createDebug('uniform:FormContext');\n\ntype DebugMode = 'debug' | 'debug-testids' | 'off' | 'disabled';\n\nexport interface DebugModeSettings {\n  /** disable form debug completely */\n  disable?: boolean;\n  /** custom localStorage key to save debug mode state */\n  localStorageKey?: string;\n}\n\n/**\n * Listener function that gets called when a field changes due to user input\n */\nexport type UserChangeListener<TFieldValues extends object = object> = (\n  fieldName: Path<TFieldValues>,\n  value: unknown,\n) => void;\n\nconst DEBUG_MODE_LOCAL_STORAGE_KEY_DEFAULT = 'uniform:debug-mode';\n\n/**\n * The `UniformContext` provides control over the form's submission behavior and may optionally include\n * a Veto validation schema for form validation.\n *\n * Specifically, this context offers:\n * 1. **Form Submission Control**: The `preventSubmit` function allows components to enable or disable\n *    form submissions.\n * 2. **Optional Validation Schema**: The `validation` property may hold a Veto validation schema instance\n *    that can be used to validate form fields and handle validation logic.\n * 3. **Client Validation**: The `setClientValidationSchema` function allows setting dynamic client-side\n *    validation schemas that complement the base Veto validation.\n * 4. **User Change Tracking**: The `userChange` property provides a pub/sub system for tracking\n *    user-initiated field changes (typing, clicking, selecting) - NOT programmatic changes like\n *    form.reset() or form.setValue(). Used by the `useWatchUserChange` hook to enable reactive\n *    field dependencies.\n *\n * This context is useful for components that need to interact with or control the form submission state,\n * or access the validation schema for managing form validation logic.\n *\n * IMPORTANT: Context Singleton Pattern for HMR (Hot Module Replacement)\n * =====================================================================\n *\n * We use a global window variable to ensure only ONE context instance exists across\n * hot module reloads during development. This is critical because:\n *\n * **The Problem:**\n * When using Vite/Storybook with Fast Refresh (HMR), editing this file causes it to\n * be re-evaluated. Each re-evaluation runs `React.createContext()` again, creating a\n * NEW context instance. This leads to \"context instance mismatch\":\n *\n *   1. FormProvider (provider) loads and uses context instance A\n *   2. File is edited, HMR triggers\n *   3. SubmitButton (consumer) hot-reloads and imports context instance B\n *   4. Provider writes to instance A, Consumer reads from instance B\n *   5. Result: Consumer sees default values (triggerSubmit = () => undefined)\n *   6. Clicking submit does nothing because it calls the empty default function\n *\n * **The Solution:**\n * By storing the context in `window.__UNIFORM_CONTEXT__`, we ensure:\n *   - First load: Create context and store in window\n *   - Subsequent HMRs: Reuse the same context from window\n *   - All components always reference the SAME context instance\n *   - Provider and consumers can properly communicate\n *\n * **Why This Is Safe:**\n * - Only affects development (production has no HMR)\n * - Context type never changes (same interface)\n * - React handles cleanup on unmount normally\n * - No memory leaks (context is lightweight)\n *\n * Without this pattern, you'd need to restart the dev server after every edit\n * to FormContext.tsx to ensure all components use the same context instance.\n */\n\n// Define the context type\ninterface UniformContextType {\n  /** Form debug mode enabled or not */\n  debugMode: DebugMode;\n  /** settings for from debug mode */\n  debugModeSettings?: DebugModeSettings;\n  /** Function to update if the form can currently be submitted */\n  preventSubmit: (prevent: boolean) => void;\n  /** Setter to enable or disable form debug mode */\n  setDebugMode: (debugMode: DebugMode) => void;\n  /** Function to trigger form submit programmatically */\n  triggerSubmit: (e?: BaseSyntheticEvent) => Promise<void> | void;\n  /** User change tracking (user input only, not programmatic changes) */\n  userChange: {\n    /**\n     * Subscribe to user field changes.\n     * Returns an unsubscribe function.\n     */\n    subscribe: (listener: UserChangeListener) => () => void;\n    /**\n     * Notify all subscribers about a user field change.\n     * Called from useController when user interacts with a field.\n     */\n    notify: (fieldName: string, value: unknown) => void;\n  };\n  /** Form validation configuration */\n  validation: {\n    /** Base validation schema instance (without client validation) */\n    baseInstance?: VetoInstance;\n    /** Veto validation schema instance for form validation */\n    instance?: VetoInstance;\n    /** Current validation errors in form */\n    errors?: VetoFormattedError;\n    /** Function to set client validation schema for a specific key */\n    setClientValidationSchema: (\n      key: string,\n      schema: VetoTypeAny | null,\n    ) => void;\n  };\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nif (!(window as any).__UNIFORM_CONTEXT__) {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  (window as any).__UNIFORM_CONTEXT__ = React.createContext<UniformContextType>(\n    {\n      debugMode: 'off',\n      preventSubmit: () => {\n        return undefined;\n      },\n      setDebugMode: () => {\n        return undefined;\n      },\n      triggerSubmit: () => {\n        return undefined;\n      },\n      userChange: {\n        subscribe: () => {\n          return () => {\n            return undefined;\n          };\n        },\n        notify: () => {\n          return undefined;\n        },\n      },\n      validation: {\n        setClientValidationSchema: () => {\n          return undefined;\n        },\n      },\n    },\n  );\n  debug('Creating new UniformContext instance');\n} else {\n  debug(\n    'Reusing existing UniformContext instance from window.__UNIFORM_CONTEXT__',\n  );\n}\n\n// Export the singleton context instance from window\n// This ensures all imports get the same context, even after HMR\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const UniformContext = (window as any)\n  .__UNIFORM_CONTEXT__ as React.Context<UniformContextType>;\n\ndebug('UniformContext exported', {\n  contextExists: !!UniformContext,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  windowContextExists: !!(window as any).__UNIFORM_CONTEXT__,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  contextsMatch: UniformContext === (window as any).__UNIFORM_CONTEXT__,\n});\n\n// Define props for the FormProvider component, extending HookForm's props\ninterface FormProviderProps {\n  /** children form render function */\n  children: (childProps: {\n    handleSubmit: (e?: BaseSyntheticEvent) => Promise<void>;\n    isValid: boolean;\n  }) => ReactNode;\n  /** settings for from debug mode */\n  debugModeSettings?: DebugModeSettings;\n  /** initial form values */\n  initialValues?: FieldValues;\n  /** form submit handler */\n  onSubmit: SubmitHandler<FieldValues>;\n  /** Veto validation schema instance */\n  validation?: VetoInstance;\n  /** when the validation should be triggered */\n  validationTrigger: 'onChange' | 'onBlur' | 'onSubmit' | 'onTouched' | 'all';\n}\n\n/**\n * FormProvider component provides:\n * - Veto validation schema context\n * - Client validation schema management\n * - Submit handler with automatic data conversion and submission control with preventSubmit\n * - Form Debug Mode state\n * - React Hook Form context\n */\nconst FormProvider: React.FC<FormProviderProps> = ({\n  children,\n  debugModeSettings = undefined,\n  initialValues = undefined,\n  onSubmit,\n  validation: baseValidation = undefined,\n  validationTrigger,\n}) => {\n  // Form Debug mode state is handled in the form context\n  const [debugMode, setDebugMode] = useLocalStorage<DebugMode>(\n    debugModeSettings?.localStorageKey ?? DEBUG_MODE_LOCAL_STORAGE_KEY_DEFAULT,\n    'off',\n  );\n\n  // Create extended validation combining base + client validations\n  const { extendedValidation, setClientValidationSchema } =\n    useExtendedValidation(baseValidation);\n\n  // Create resolver from extended validation + get current validation errors\n  const { resolver, validationErrors, validationErrorsHash } =\n    useFormResolver(extendedValidation);\n\n  // Initialize react hook form with the resolver\n  const methods = useForm({\n    defaultValues: initialValues ? toFormFormat(initialValues) : initialValues,\n    // set rhf mode\n    // see: https://react-hook-form.com/docs/useform#mode\n    mode: validationTrigger,\n    resolver,\n  });\n\n  // Get isValid from React Hook Form's formState\n  const isValid = methods.formState?.isValid;\n\n  // Control if the form can currently be submitted\n  const [preventSubmit, setPreventSubmit] = useState(false);\n\n  // User change listener registry (stored in ref to avoid re-renders)\n  const userChangeListenersRef = useRef<Set<UserChangeListener>>(new Set());\n\n  // Subscribe to user changes\n  const subscribeUserChange = useCallback(\n    (listener: UserChangeListener): (() => void) => {\n      userChangeListenersRef.current.add(listener);\n      // Return cleanup function to unsubscribe\n      return () => {\n        userChangeListenersRef.current.delete(listener);\n      };\n    },\n    [],\n  );\n\n  // Notify all subscribers about user change\n  const notifyUserChange = useCallback(\n    (fieldName: string, value: unknown): void => {\n      // Notify all registered listeners\n      userChangeListenersRef.current.forEach((listener) => {\n        listener(fieldName as Path<object>, value);\n      });\n    },\n    [],\n  );\n\n  // Create submit handler with automatic data conversion\n  // eslint-disable-next-line consistent-return\n  const handleSubmit = async (e?: React.BaseSyntheticEvent) => {\n    debug('handleSubmit called', {\n      preventSubmit,\n      formStateIsValid: methods.formState.isValid,\n      validationErrors: methods.formState.errors,\n      validationTrigger,\n      formValues: methods.getValues(),\n    });\n\n    // only prevent submit when form state is valid, because otherwise\n    // submit will only trigger validation and add errors / focus invalid fields\n    if (methods.formState.isValid && preventSubmit) {\n      debug('⛔ Form submit PREVENTED', {\n        formStateIsValid: methods.formState.isValid,\n        preventSubmit,\n      });\n      console.warn(\n        '[FormProvider] form submit was prevented because preventSubmit is true...',\n      );\n      e?.preventDefault();\n      return Promise.resolve();\n    }\n\n    debug('✓ Form submit ALLOWED', {\n      formStateIsValid: methods.formState.isValid,\n      preventSubmit,\n      reason: !methods.formState.isValid\n        ? 'Form is invalid (will trigger validation and show errors)'\n        : 'Form is valid and preventSubmit is false',\n    });\n\n    // Convert nullish strings and filter out empty values before submission\n    const wrappedOnSubmit = (data: FieldValues, event?: BaseSyntheticEvent) => {\n      const submitData = toValidationFormat(data) ?? {};\n      debug('onSubmit callback called', { submitData });\n      return onSubmit(submitData, event);\n    };\n\n    await methods.handleSubmit(wrappedOnSubmit)(e);\n\n    debug('handleSubmit completed');\n  };\n\n  // Memoize the context value to prevent re-renders\n  const contextValue = useMemo(\n    () => {\n      return {\n        // set debugMode to disabled when debugModeSettings.disable is true\n        // otherwise use current debug mode from localStorage\n        debugMode: debugModeSettings?.disable ? 'disabled' : debugMode,\n        preventSubmit: (prevent: boolean) => {\n          debug('preventSubmit called', {\n            previousValue: preventSubmit,\n            newValue: prevent,\n            formStateIsValid: methods.formState.isValid,\n            validationErrors: methods.formState.errors,\n          });\n          setPreventSubmit(prevent);\n        },\n        setClientValidationSchema,\n        setDebugMode,\n        triggerSubmit: handleSubmit,\n        userChange: {\n          subscribe: subscribeUserChange,\n          notify: notifyUserChange,\n        },\n        validation: {\n          baseInstance: baseValidation,\n          instance: extendedValidation,\n          errors: validationErrors,\n          setClientValidationSchema,\n        },\n      };\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [debugMode, debugModeSettings?.disable, validationErrorsHash],\n  );\n\n  return (\n    <UniformContext.Provider value={contextValue}>\n      {/* Spread all hook form props into HookFormProvider */}\n      <HookFormProvider {...methods}>\n        {children({ handleSubmit, isValid })}\n      </HookFormProvider>\n    </UniformContext.Provider>\n  );\n};\n\nexport default FormProvider;\n","import type {\n  VetoFormattedError,\n  VetoInstance,\n  VetoTypeAny,\n} from '@fuf-stack/veto';\nimport type { FieldValues } from 'react-hook-form';\n\nimport { useMemo, useRef, useState } from 'react';\n\nimport { and, veto } from '@fuf-stack/veto';\n\nimport { toValidationFormat } from '../../helpers';\n\n/**\n * Hook that manages client validation schemas state.\n *\n * Provides a centralized way to add/remove dynamic validation schemas\n * that can be combined with base form validation.\n *\n * @returns Object with client validation state and memoized setter function\n */\nexport const useClientValidationManager = () => {\n  // Client validation schemas state\n  const [clientValidationSchemas, setClientValidationSchemas] = useState<\n    Record<string, VetoTypeAny>\n  >({});\n\n  // Memoized function to set/clear client validation schema\n  const setClientValidationSchema = useMemo(() => {\n    return (key: string, schema: VetoTypeAny | null) => {\n      // update client validation schemas\n      setClientValidationSchemas((prev) => {\n        // if no schema and no existing client validation schema for this key, do nothing\n        if (!prev[key] && !schema) {\n          return prev;\n        }\n        // if no schema, remove the client validation schema for this key\n        if (!schema) {\n          const { [key]: _removed, ...rest } = prev;\n          return rest;\n        }\n        // if schema, add or update the client validation schema for this key\n        return { ...prev, [key]: schema };\n      });\n    };\n  }, []);\n\n  return {\n    clientValidationSchemas,\n    setClientValidationSchema,\n  };\n};\n\n/**\n * Hook that creates an extended validation instance combining base Veto validation with dynamic client validation.\n *\n * @param baseValidation - Optional base Veto validation schema\n * @returns Combined validation instance and client schema setter\n */\nexport const useExtendedValidation = (baseValidation?: VetoInstance) => {\n  // Setup client validation schemas\n  const { clientValidationSchemas, setClientValidationSchema } =\n    useClientValidationManager();\n\n  // Create a stable dependency array from the client validation schemas\n  const clientSchemaValues = useMemo(\n    () => {\n      const keys = Object.keys(clientValidationSchemas).sort();\n      return keys\n        .map((key) => {\n          return clientValidationSchemas[key];\n        })\n        .filter(Boolean);\n    },\n    // Include the object identity to react to schema instance updates with same shape\n    [clientValidationSchemas],\n  );\n\n  // Memoized extended validation instance\n  const extendedValidation = useMemo(\n    () => {\n      const hasBaseValidation = !!baseValidation;\n      const hasClientSchemas = clientSchemaValues.length > 0;\n\n      // If no base validation and no client schemas, return undefined\n      if (!hasBaseValidation && !hasClientSchemas) {\n        return undefined;\n      }\n\n      // If no client schemas, return base validation\n      if (!hasClientSchemas) {\n        return baseValidation;\n      }\n\n      // Combine client validation schemas\n      const clientSchemasCombined = clientSchemaValues.reduce(\n        // @ts-expect-error is ok, because initially it is null\n        (combined, clientSchema) => {\n          return combined ? and(combined, clientSchema) : clientSchema;\n        },\n        null,\n      );\n\n      // return combined validation\n      if (hasBaseValidation && clientSchemasCombined) {\n        return veto(and(baseValidation.schema, clientSchemasCombined));\n      }\n\n      // If we only have client schemas, return them as a veto instance\n      if (clientSchemasCombined) {\n        return veto(clientSchemasCombined);\n      }\n\n      // This should not happen due to the conditions above, but just in case\n      return baseValidation;\n    },\n    // Recompute when validation schema instances change\n    [baseValidation, clientSchemaValues],\n  );\n\n  return {\n    extendedValidation,\n    setClientValidationSchema,\n  };\n};\n\n/**\n * Hook that creates a React Hook Form resolver from an extended validation instance.\n *\n * @param extendedValidation - Extended validation instance from useExtendedValidation\n * @returns Object containing resolver function, current validation errors, and optimization hash\n */\nexport const useFormResolver = (extendedValidation?: VetoInstance) => {\n  // Use ref to store validation errors without triggering re-renders\n  const validationErrors = useRef<VetoFormattedError>(undefined);\n\n  // Memoized resolver function for React Hook Form\n  const resolver = useMemo(() => {\n    if (!extendedValidation) {\n      return undefined;\n    }\n\n    return async (values: FieldValues) => {\n      const validationValues = toValidationFormat(values) ?? {};\n      const result = await extendedValidation.validateAsync(validationValues);\n      validationErrors.current = result.errors ?? undefined;\n\n      // Transform veto result to React Hook Form format\n      return {\n        values: result.data ?? {},\n        errors: result.errors ?? {},\n      };\n    };\n  }, [extendedValidation]);\n\n  // Hash for memo dependency optimization in consuming components\n  const validationErrorsHash = JSON.stringify(validationErrors.current);\n\n  return {\n    resolver,\n    validationErrors: validationErrors.current,\n    validationErrorsHash,\n  };\n};\n"]}