@fuf-stack/uniform 1.6.5 → 1.8.0

package/dist/{chunk-4RIJJ5AV.js → chunk-GEJUMUTH.js}

@@ -1,16 +1,18 @@
 import {
   useInputValueDebounce
-} from "./chunk-MODD3TFE.js";
+} from "./chunk-ZJDU5EPE.js";
 import {
   useUniformField
-} from "./chunk-D3JYMGTB.js";
+} from "./chunk-EGFB5WEK.js";
 import {
   __objRest,
+  __spreadProps,
   __spreadValues
 } from "./chunk-K2V4ULA2.js";
 
 // src/Input/Input.tsx
 import { Input as HeroInput } from "@heroui/input";
+import { NumberInput as HeroNumberInput } from "@heroui/number-input";
 import { tv, variantsToClassNames } from "@fuf-stack/pixel-utils";
 import { jsx } from "react/jsx-runtime";
 var inputVariants = tv({
@@ -36,7 +38,6 @@ var Input = (_a) => {
     placeholder = " ",
     size = void 0,
     startContent = void 0,
-    transform = void 0,
     type = void 0
   } = _b, uniformFieldProps = __objRest(_b, [
     "className",
@@ -48,7 +49,6 @@ var Input = (_a) => {
     "placeholder",
     "size",
     "startContent",
-    "transform",
     "type"
   ]);
   const {
@@ -65,13 +65,11 @@ var Input = (_a) => {
     required,
     testId,
     resetField
-  } = useUniformField(__spreadValues({ name }, uniformFieldProps));
+  } = useUniformField(__spreadValues({ name, type }, uniformFieldProps));
   const { onChange, onBlur, value } = useInputValueDebounce({
     debounceDelay,
     onBlur: fieldOnBlur,
     onChange: fieldOnChange,
-    transform,
-    type,
     value: fieldValue
   });
   const clearableProps = clearable ? {
@@ -85,39 +83,55 @@ var Input = (_a) => {
   } : {};
   const variants = inputVariants();
   const classNames = variantsToClassNames(variants, _className, "base");
-  return /* @__PURE__ */ jsx(
-    HeroInput,
-    __spreadValues({
-      ref,
-      "data-testid": testId,
-      endContent,
-      errorMessage,
-      id: testId,
-      isDisabled: disabled,
-      isInvalid: invalid,
-      isRequired: required,
-      label,
-      labelPlacement: "outside",
-      name,
-      onBlur,
-      onChange,
-      placeholder,
-      radius: "sm",
-      size,
-      startContent,
-      type,
-      value,
-      variant: "bordered",
-      classNames: {
-        base: classNames.base,
-        clearButton: classNames.clearButton,
-        // set padding to 0 for error message exit animation
-        helperWrapper: "p-0",
-        input: classNames.input,
-        inputWrapper: classNames.inputWrapper
-      }
-    }, clearableProps)
-  );
+  const commonProps = __spreadValues({
+    ref,
+    classNames: {
+      base: classNames.base,
+      clearButton: classNames.clearButton,
+      // set padding to 0 for error message exit animation
+      helperWrapper: "p-0",
+      input: classNames.input,
+      inputWrapper: classNames.inputWrapper
+    },
+    "data-testid": testId,
+    endContent,
+    errorMessage,
+    id: testId,
+    isDisabled: disabled,
+    isInvalid: invalid,
+    isRequired: required,
+    label,
+    labelPlacement: "outside",
+    name,
+    onBlur,
+    placeholder,
+    radius: "sm",
+    size,
+    startContent,
+    variant: "bordered"
+  }, clearableProps);
+  if (type === "number") {
+    const numberValue = value !== "" && value != null && !Number.isNaN(Number(value)) ? Number(value) : void 0;
+    return /* @__PURE__ */ jsx(
+      HeroNumberInput,
+      __spreadProps(__spreadValues({}, commonProps), {
+        value: numberValue,
+        formatOptions: {
+          useGrouping: false
+        },
+        onChange: (e) => {
+          if (typeof e === "number") {
+            onChange({
+              target: { value: String(e) }
+            });
+          } else {
+            onChange(e);
+          }
+        }
+      })
+    );
+  }
+  return /* @__PURE__ */ jsx(HeroInput, __spreadProps(__spreadValues({}, commonProps), { onChange, type, value }));
 };
 var Input_default = Input;
 
@@ -128,4 +142,4 @@ export {
   Input_default,
   Input_default2
 };
-//# sourceMappingURL=chunk-4RIJJ5AV.js.map
+//# sourceMappingURL=chunk-GEJUMUTH.js.map

package/dist/chunk-GEJUMUTH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/Input/Input.tsx","../src/Input/index.ts"],"sourcesContent":["import type { TVClassName, TVProps } from '@fuf-stack/pixel-utils';\nimport type { InputProps as HeroInputProps } from '@heroui/input';\nimport type { ReactNode } from 'react';\nimport type { InputValueTransform } from '../hooks';\n\nimport { Input as HeroInput } from '@heroui/input';\n// eslint-disable-next-line import-x/no-unresolved\nimport { NumberInput as HeroNumberInput } from '@heroui/number-input';\n\nimport { tv, variantsToClassNames } from '@fuf-stack/pixel-utils';\n\nimport { useInputValueDebounce, useUniformField } from '../hooks';\n\n// input variants\nexport const inputVariants = tv({\n  slots: {\n    /** wrapper around the whole input */\n    base: '',\n    /** clear button */\n    clearButton: '',\n    /** actual input element */\n    input: '',\n    /** inner wrapper (HeroUI inputWrapper slot) */\n    inputWrapper: 'bg-content1 group-data-[focus=true]:border-focus',\n  },\n});\n\ntype VariantProps = TVProps<typeof inputVariants>;\ntype ClassName = TVClassName<typeof inputVariants>;\n\nexport interface InputProps extends VariantProps {\n  /** CSS class name */\n  className?: ClassName;\n  /** shows clear button when input has value */\n  clearable?: boolean;\n  /** debounce delay in milliseconds for form state updates (default: 300ms) */\n  debounceDelay?: number;\n  /** input field is disabled */\n  disabled?: boolean;\n  /** added content to the end of the input Field. */\n  endContent?: ReactNode;\n  /** form field label (set to false to disable label) */\n  label?: string | false;\n  /** form field name */\n  name: string;\n  /** callback that is fired when the value is cleared */\n  onClear?: () => void;\n  /** form field placeholder */\n  placeholder?: string;\n  /** size of the input */\n  size?: 'sm' | 'md' | 'lg';\n  /** content added to the start of the input field */\n  startContent?: ReactNode;\n  /** HTML data-testid attribute used in e2e tests */\n  testId?: string;\n  /** allows disentangled display and form values for a field */\n  transform?: InputValueTransform<string>;\n  /** input type */\n  type?: 'number' | 'password';\n}\n\n/**\n * Input component based on [HeroUI Input](https://www.heroui.com//docs/components/input)\n */\nconst Input = ({\n  className: _className = undefined,\n  clearable = false,\n  debounceDelay = 300,\n  endContent = undefined,\n  name,\n  onClear = undefined,\n  placeholder = ' ',\n  size = undefined,\n  startContent = undefined,\n  type = undefined,\n  ...uniformFieldProps\n}: InputProps) => {\n  const {\n    disabled,\n    field: {\n      onChange: fieldOnChange,\n      onBlur: fieldOnBlur,\n      value: fieldValue,\n      ref,\n    },\n    errorMessage,\n    invalid,\n    label,\n    required,\n    testId,\n    resetField,\n  } = useUniformField({ name, type, ...uniformFieldProps });\n\n  // Use hook that provides debounced onChange and enhanced blur handling\n  const { onChange, onBlur, value } = useInputValueDebounce({\n    debounceDelay,\n    onBlur: fieldOnBlur,\n    onChange: fieldOnChange,\n    value: fieldValue,\n  });\n\n  // If input is clearable add props for clearing input value\n  const clearableProps: Pick<HeroInputProps, 'isClearable' | 'onClear'> =\n    clearable\n      ? {\n          isClearable: true,\n          onClear: () => {\n            // if field had initial value we do not reset it\n            // to that value, but clear it instead\n            resetField(name, { defaultValue: null });\n            // if onClear cb provided we call it\n            if (onClear) {\n              onClear();\n            }\n          },\n        }\n      : {};\n\n  // classNames from slots\n  const variants = inputVariants();\n  const classNames = variantsToClassNames(variants, _className, 'base');\n\n  // Common props for both Input and NumberInput\n  const commonProps = {\n    ref,\n    classNames: {\n      base: classNames.base,\n      clearButton: classNames.clearButton,\n      // set padding to 0 for error message exit animation\n      helperWrapper: 'p-0',\n      input: classNames.input,\n      inputWrapper: classNames.inputWrapper,\n    },\n    'data-testid': testId,\n    endContent,\n    errorMessage,\n    id: testId,\n    isDisabled: disabled,\n    isInvalid: invalid,\n    isRequired: required,\n    label,\n    labelPlacement: 'outside' as const,\n    name,\n    onBlur,\n    placeholder,\n    radius: 'sm' as const,\n    size,\n    startContent,\n    variant: 'bordered' as const,\n    ...clearableProps,\n  };\n\n  // Render NumberInput for number type\n  if (type === 'number') {\n    // Parse the string value to number - use undefined for empty/cleared state\n    const numberValue =\n      value !== '' && value != null && !Number.isNaN(Number(value))\n        ? Number(value)\n        : undefined;\n\n    return (\n      <HeroNumberInput\n        {...commonProps}\n        value={numberValue}\n        // Disable thousands separator to avoid parsing issues\n        formatOptions={{\n          useGrouping: false,\n        }}\n        // NumberInput onChange receives either an event or a number\n        onChange={(e: React.ChangeEvent<HTMLInputElement> | number) => {\n          if (typeof e === 'number') {\n            // Convert number to synthetic event and pass through debounced onChange\n            onChange({\n              target: { value: String(e) },\n            } as React.ChangeEvent<HTMLInputElement>);\n          } else {\n            // Pass event through debounced onChange\n            onChange(e);\n          }\n        }}\n      />\n    );\n  }\n\n  // Render regular Input for text/password\n  return (\n    <HeroInput {...commonProps} onChange={onChange} type={type} value={value} />\n  );\n};\n\nexport default Input;\n","import Input from './Input';\n\nexport type { InputProps } from './Input';\n\nexport { Input };\n\nexport default Input;\n"],"mappings":";;;;;;;;;;;;;AAKA,SAAS,SAAS,iBAAiB;AAEnC,SAAS,eAAe,uBAAuB;AAE/C,SAAS,IAAI,4BAA4B;AAwJnC;AAnJC,IAAM,gBAAgB,GAAG;AAAA,EAC9B,OAAO;AAAA;AAAA,IAEL,MAAM;AAAA;AAAA,IAEN,aAAa;AAAA;AAAA,IAEb,OAAO;AAAA;AAAA,IAEP,cAAc;AAAA,EAChB;AACF,CAAC;AAuCD,IAAM,QAAQ,CAAC,OAYG;AAZH,eACb;AAAA,eAAW,aAAa;AAAA,IACxB,YAAY;AAAA,IACZ,gBAAgB;AAAA,IAChB,aAAa;AAAA,IACb;AAAA,IACA,UAAU;AAAA,IACV,cAAc;AAAA,IACd,OAAO;AAAA,IACP,eAAe;AAAA,IACf,OAAO;AAAA,EA1ET,IAgEe,IAWV,8BAXU,IAWV;AAAA,IAVH;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA;AAGA,QAAM;AAAA,IACJ;AAAA,IACA,OAAO;AAAA,MACL,UAAU;AAAA,MACV,QAAQ;AAAA,MACR,OAAO;AAAA,MACP;AAAA,IACF;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI,gBAAgB,iBAAE,MAAM,QAAS,kBAAmB;AAGxD,QAAM,EAAE,UAAU,QAAQ,MAAM,IAAI,sBAAsB;AAAA,IACxD;AAAA,IACA,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,OAAO;AAAA,EACT,CAAC;AAGD,QAAM,iBACJ,YACI;AAAA,IACE,aAAa;AAAA,IACb,SAAS,MAAM;AAGb,iBAAW,MAAM,EAAE,cAAc,KAAK,CAAC;AAEvC,UAAI,SAAS;AACX,gBAAQ;AAAA,MACV;AAAA,IACF;AAAA,EACF,IACA,CAAC;AAGP,QAAM,WAAW,cAAc;AAC/B,QAAM,aAAa,qBAAqB,UAAU,YAAY,MAAM;AAGpE,QAAM,cAAc;AAAA,IAClB;AAAA,IACA,YAAY;AAAA,MACV,MAAM,WAAW;AAAA,MACjB,aAAa,WAAW;AAAA;AAAA,MAExB,eAAe;AAAA,MACf,OAAO,WAAW;AAAA,MAClB,cAAc,WAAW;AAAA,IAC3B;AAAA,IACA,eAAe;AAAA,IACf;AAAA,IACA;AAAA,IACA,IAAI;AAAA,IACJ,YAAY;AAAA,IACZ,WAAW;AAAA,IACX,YAAY;AAAA,IACZ;AAAA,IACA,gBAAgB;AAAA,IAChB;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,IACA,SAAS;AAAA,KACN;AAIL,MAAI,SAAS,UAAU;AAErB,UAAM,cACJ,UAAU,MAAM,SAAS,QAAQ,CAAC,OAAO,MAAM,OAAO,KAAK,CAAC,IACxD,OAAO,KAAK,IACZ;AAEN,WACE;AAAA,MAAC;AAAA,uCACK,cADL;AAAA,QAEC,OAAO;AAAA,QAEP,eAAe;AAAA,UACb,aAAa;AAAA,QACf;AAAA,QAEA,UAAU,CAAC,MAAoD;AAC7D,cAAI,OAAO,MAAM,UAAU;AAEzB,qBAAS;AAAA,cACP,QAAQ,EAAE,OAAO,OAAO,CAAC,EAAE;AAAA,YAC7B,CAAwC;AAAA,UAC1C,OAAO;AAEL,qBAAS,CAAC;AAAA,UACZ;AAAA,QACF;AAAA;AAAA,IACF;AAAA,EAEJ;AAGA,SACE,oBAAC,4CAAc,cAAd,EAA2B,UAAoB,MAAY,QAAc;AAE9E;AAEA,IAAO,gBAAQ;;;ACxLf,IAAOA,iBAAQ;","names":["Input_default"]}

package/dist/{chunk-CK362NWK.js → chunk-GKP3ONKO.js}

@@ -1,3 +1,6 @@
+import {
+  UniformContext
+} from "./chunk-LKR6D3RL.js";
 import {
   fromNullishString,
   toNullishString
@@ -8,9 +11,11 @@ import {
 } from "./chunk-K2V4ULA2.js";
 
 // src/hooks/useController/useController.ts
+import { useContext } from "react";
 import { useController as useRHFController } from "react-hook-form";
 var useController = (props) => {
   const { field, formState, fieldState } = useRHFController(props);
+  const { userChange } = useContext(UniformContext);
   return {
     field: __spreadProps(__spreadValues({}, field), {
       // Handles both direct values (onChange("value")) and events (onChange(event))
@@ -18,7 +23,9 @@ var useController = (props) => {
       onChange: (...event) => {
         var _a, _b, _c;
         const value = (_c = (_b = (_a = event[0]) == null ? void 0 : _a.target) == null ? void 0 : _b.value) != null ? _c : event[0];
-        field.onChange(value === "" ? "" : toNullishString(value));
+        const formattedValue = value === "" ? "" : toNullishString(value);
+        field.onChange(formattedValue);
+        userChange.notify(field.name, formattedValue);
       },
       // Convert null/undefined to empty string for UI display
       value: fromNullishString(field.value)
@@ -31,4 +38,4 @@ var useController = (props) => {
 export {
   useController
 };
-//# sourceMappingURL=chunk-CK362NWK.js.map
+//# sourceMappingURL=chunk-GKP3ONKO.js.map

package/dist/chunk-GKP3ONKO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useController/useController.ts"],"sourcesContent":["import type {\n  ControllerFieldState,\n  ControllerRenderProps,\n  UseControllerProps as RHFUseControllerProps,\n  UseFormStateReturn,\n} from 'react-hook-form';\n\nimport { useContext } from 'react';\nimport { useController as useRHFController } from 'react-hook-form';\n\nimport { UniformContext } from '../../Form/subcomponents/FormContext';\nimport { fromNullishString, toNullishString } from '../../helpers';\n\nexport type UseControllerProps<TFieldValues extends object = object> =\n  RHFUseControllerProps<TFieldValues>;\n\nexport interface UseControllerReturn<TFieldValues extends object = object> {\n  field: Omit<ControllerRenderProps<TFieldValues>, 'onChange' | 'value'> & {\n    // Using any[] to support both direct value changes and React synthetic events\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    onChange: (...event: any[]) => void;\n    value: string;\n  };\n  formState: UseFormStateReturn<TFieldValues>;\n  fieldState: ControllerFieldState;\n}\n\n/**\n * A wrapper around react-hook-form's useController that transparently handles nullish string conversions.\n *\n * Key features:\n * 1. Empty strings ('') in the UI are stored as null in form state\n * 2. Null/undefined values in form state are displayed as empty strings in the UI\n * 3. Handles both direct value changes and React synthetic events\n * 4. Maintains the same API as react-hook-form's useController\n * 5. Notifies UniformContext's userChange listeners on field changes (enables useWatchUserChange hook)\n *\n * This enables consistent handling of empty/null values while keeping a clean API\n * for form inputs that expect string values.\n *\n * @see https://react-hook-form.com/docs/usecontroller\n */\nexport const useController = <TFieldValues extends object = object>(\n  props: UseControllerProps<TFieldValues>,\n): UseControllerReturn<TFieldValues> => {\n  const { field, formState, fieldState } = useRHFController(props);\n  const { userChange } = useContext(UniformContext);\n\n  return {\n    field: {\n      ...field,\n      // Handles both direct values (onChange(\"value\")) and events (onChange(event))\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      onChange: (...event: any[]) => {\n        const value = event[0]?.target?.value ?? event[0];\n        const formattedValue = value === '' ? '' : toNullishString(value);\n\n        // Update form state first\n        field.onChange(formattedValue);\n\n        // Then notify userChange listeners (for useWatchUserChange hook)\n        // This ensures getValues() in listeners returns the updated value\n        userChange.notify(field.name, formattedValue);\n      },\n      // Convert null/undefined to empty string for UI display\n      value: fromNullishString(field.value) as string,\n    },\n    formState,\n    fieldState,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;AAOA,SAAS,kBAAkB;AAC3B,SAAS,iBAAiB,wBAAwB;AAkC3C,IAAM,gBAAgB,CAC3B,UACsC;AACtC,QAAM,EAAE,OAAO,WAAW,WAAW,IAAI,iBAAiB,KAAK;AAC/D,QAAM,EAAE,WAAW,IAAI,WAAW,cAAc;AAEhD,SAAO;AAAA,IACL,OAAO,iCACF,QADE;AAAA;AAAA;AAAA,MAIL,UAAU,IAAI,UAAiB;AArDrC;AAsDQ,cAAM,SAAQ,uBAAM,CAAC,MAAP,mBAAU,WAAV,mBAAkB,UAAlB,YAA2B,MAAM,CAAC;AAChD,cAAM,iBAAiB,UAAU,KAAK,KAAK,gBAAgB,KAAK;AAGhE,cAAM,SAAS,cAAc;AAI7B,mBAAW,OAAO,MAAM,MAAM,cAAc;AAAA,MAC9C;AAAA;AAAA,MAEA,OAAO,kBAAkB,MAAM,KAAK;AAAA,IACtC;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/{chunk-VDTYZM6N.cjs → chunk-IFBKJ5UZ.cjs}

@@ -1,9 +1,9 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkSOQ6GCN3cjs = require('./chunk-SOQ6GCN3.cjs');
+var _chunkOQUTHTOKcjs = require('./chunk-OQUTHTOK.cjs');
 
 
-var _chunk42NCLEX4cjs = require('./chunk-42NCLEX4.cjs');
+var _chunk6LQ2O6SCcjs = require('./chunk-6LQ2O6SC.cjs');
 
 
 var _chunkZ353BLWIcjs = require('./chunk-Z353BLWI.cjs');
@@ -24,7 +24,7 @@ var useUniformFieldArray = ({
   testId: explicitTestId,
   label
 }) => {
-  const uniformField = _chunkSOQ6GCN3cjs.useUniformField.call(void 0, {
+  const uniformField = _chunkOQUTHTOKcjs.useUniformField.call(void 0, {
     name,
     disabled,
     testId: explicitTestId,
@@ -35,7 +35,7 @@ var useUniformFieldArray = ({
     control,
     name
   });
-  const { trigger, setValue } = _chunk42NCLEX4cjs.useFormContext.call(void 0, );
+  const { trigger, setValue } = _chunk6LQ2O6SCcjs.useFormContext.call(void 0, );
   const needsInitialize = _react.useMemo.call(void 0, () => {
     return lastElementNotRemovable && fields.length === 0;
   }, [lastElementNotRemovable, fields.length]);
@@ -65,15 +65,12 @@ var useUniformFieldArray = ({
   _react.useEffect.call(void 0, 
     () => {
       if (needsInitialize) {
-        if (!disableAnimation) {
-          setDisableAnimation(true);
-        }
         setValue(name, [elementInitialValue], {
           shouldDirty: false,
           shouldTouch: false
         });
         hasInitialized.current = true;
-        if (!prefersReducedMotion) {
+        if (!prefersReducedMotion && disableAnimation) {
           setTimeout(() => {
             setDisableAnimation(false);
           }, 1);
@@ -103,4 +100,4 @@ var useUniformFieldArray = ({
 
 
 exports.useUniformFieldArray = useUniformFieldArray;
-//# sourceMappingURL=chunk-VDTYZM6N.cjs.map
+//# sourceMappingURL=chunk-IFBKJ5UZ.cjs.map

package/dist/chunk-IFBKJ5UZ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-IFBKJ5UZ.cjs","../src/hooks/useUniformFieldArray/useUniformFieldArray.ts"],"names":[],"mappings":"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","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-IFBKJ5UZ.cjs","sourcesContent":[null,"import type { ReactNode } from 'react';\nimport type { ArrayPath, FieldValues, Path } from 'react-hook-form';\n\nimport { useEffect, useMemo, useRef, useState } from 'react';\nimport { useFieldArray as useRHFFieldArray } from 'react-hook-form';\n\nimport { useReducedMotion } from '@fuf-stack/pixel-motion';\n\nimport { flatArrayKey } from '../../helpers';\nimport { useFormContext } from '../useFormContext/useFormContext';\nimport { useUniformField } from '../useUniformField/useUniformField';\n\nexport interface UseUniformFieldArrayProps<\n  TFieldValues extends FieldValues = FieldValues,\n> {\n  /** Field name for the array */\n  name: ArrayPath<TFieldValues>;\n  /** Whether this is a flat array (array of primitives) */\n  flat?: boolean;\n  /** Initial value for new array elements */\n  elementInitialValue?: unknown;\n  /** Whether the last element cannot be removed (always maintain at least one element) */\n  lastElementNotRemovable?: boolean;\n  /** Disable the field */\n  disabled?: boolean;\n  /** Optional explicit test id used to build stable test ids */\n  testId?: string;\n  /** Optional label content; pass false to suppress label entirely */\n  label?: ReactNode | false;\n}\n\n/**\n * Enhanced useFieldArray hook with initialization and animation logic.\n * Based on React Hook Form's useFieldArray with additional features:\n * - Automatic initialization when lastElementNotRemovable is set\n * - Animation control (disabled during initialization)\n * - Support for flat arrays (arrays of primitives)\n *\n * Note: Automatic validation triggering on length change is disabled to prevent\n * triggering form-wide validation. Array validation still runs on form submission.\n *\n * @see https://react-hook-form.com/docs/usefieldarray\n */\nexport const useUniformFieldArray = <\n  TFieldValues extends FieldValues = FieldValues,\n>({\n  name,\n  flat = false,\n  elementInitialValue: _elementInitialValue = null,\n  lastElementNotRemovable = false,\n  disabled,\n  testId: explicitTestId,\n  label,\n}: UseUniformFieldArrayProps<TFieldValues>) => {\n  // Get uniform field state and utilities\n  const uniformField = useUniformField<TFieldValues>({\n    name: name as Path<TFieldValues> & string,\n    disabled,\n    testId: explicitTestId,\n    label,\n  });\n\n  const { control } = uniformField;\n\n  const { fields, append, remove, insert, move } = useRHFFieldArray({\n    control,\n    name,\n  });\n\n  const { trigger, setValue } = useFormContext<TFieldValues>();\n\n  // Determine if initialization is needed (initially or after reset).\n  // This flag automatically handles both scenarios:\n  // - Initial mount: fields.length starts at 0\n  // - Form reset: fields.length becomes 0 again\n  // Additional initialization conditions can be added here later (e.g., minElements > 0)\n  // Using useMemo ensures this value is properly tracked by React and effects can depend on it\n  const needsInitialize = useMemo(() => {\n    return lastElementNotRemovable && fields.length === 0;\n  }, [lastElementNotRemovable, fields.length]);\n\n  // Track whether initialization has completed. Initialized contextually:\n  // - If initialization IS needed (needsInitialize = true): starts as false, set to true after init\n  // - If initialization is NOT needed (needsInitialize = false): starts as true (already initialized)\n  // This ref is used to:\n  // 1. Skip validation during initialization/re-initialization\n  // 2. Gate animation enabling until after initialization\n  // 3. Gate motion preference effect until after initialization\n  const hasInitialized = useRef(!needsInitialize);\n\n  // Reset initialization flag when needsInitialize changes to true.\n  // This handles form reset: when fields become empty (needsInitialize becomes true),\n  // hasInitialized is reset to false, triggering re-initialization in the effect below.\n  useEffect(() => {\n    if (needsInitialize) {\n      hasInitialized.current = false;\n    }\n  }, [needsInitialize]);\n\n  // Validate array-level constraints (min/max items) when length changes.\n  // Skip validation during initialization/re-initialization to avoid showing errors prematurely.\n  useEffect(() => {\n    if (hasInitialized.current) {\n      setTimeout(() => {\n        // Trigger validation so min/max errors appear instantly when user adds/removes items\n        trigger(name as Path<TFieldValues>);\n      }, 200);\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [fields.length]);\n\n  // Animation control: Start with animations disabled to prevent animating in initial elements.\n  // Will be enabled after initialization completes (unless user prefers reduced motion).\n  const [disableAnimation, setDisableAnimation] = useState(true);\n\n  // Respond to user's motion preference changes (after initialization).\n  // During initialization, animations stay disabled regardless of preference.\n  const prefersReducedMotion = useReducedMotion();\n  useEffect(() => {\n    if (hasInitialized.current) {\n      setDisableAnimation(!!prefersReducedMotion);\n    }\n  }, [prefersReducedMotion]);\n\n  // Prepare initial element value based on mode\n  // - flat=true: arrays of primitives → object with flatArrayKey and null value by default\n  // - flat=false: arrays of objects → empty object by default\n  const elementInitialValue = useMemo(() => {\n    return flat\n      ? { [flatArrayKey]: _elementInitialValue ?? null }\n      : (_elementInitialValue ?? {});\n  }, [flat, _elementInitialValue]);\n\n  // Initialization/Re-initialization: Add initial element when needed.\n  // This handles both initial mount and form reset scenarios by reacting to needsInitialize.\n  // CRITICAL: This effect MUST be the LAST hook in this component.\n  // It sets hasInitialized.current = true, which acts as a gate for other effects.\n  // If this runs before other effects, hasInitialized will be true during their first run,\n  // causing them to execute logic meant only for post-initialization (e.g., validation,\n  // animation enabling). By placing this last, all other effects run first with\n  // hasInitialized = false, allowing them to skip initialization-phase logic.\n  useEffect(\n    () => {\n      if (needsInitialize) {\n        // use setValue instead of append to avoid focusing the added element\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        setValue(name as Path<TFieldValues>, [elementInitialValue] as any, {\n          shouldDirty: false,\n          shouldTouch: false,\n        });\n\n        // Mark initialization as complete\n        hasInitialized.current = true;\n\n        // Enable animations after a brief delay (unless user prefers reduced motion or animations are already enabled).\n        // This only runs on initial mount when animations start disabled.\n        // On reset, disableAnimation is typically false, so this setTimeout won't run and animations stay enabled.\n        if (!prefersReducedMotion && disableAnimation) {\n          setTimeout(() => {\n            setDisableAnimation(false);\n          }, 1);\n        }\n      }\n    },\n    // Run when needsInitialize changes (initial mount or reset)\n    // needsInitialize is memoized based on fields.length and lastElementNotRemovable\n    // Other dependencies are intentionally omitted:\n    // - append, setValue, trigger, setDisableAnimation are stable refs/functions\n    // - elementInitialValue, name, flat, prefersReducedMotion, disableAnimation are props/stable values\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [needsInitialize],\n  );\n\n  return {\n    // Field array methods and state\n    fields,\n    append,\n    remove,\n    insert,\n    move,\n    disableAnimation,\n    elementInitialValue,\n    // Uniform field state and utilities (spread all)\n    ...uniformField,\n  };\n};\n"]}

package/dist/{chunk-IK5IWKUC.js → chunk-K33E67GR.js}

@@ -1,18 +1,18 @@
+import {
+  FieldCopyTestIdButton_default
+} from "./chunk-NTDKZW4E.js";
 import {
   FieldValidationError_default
 } from "./chunk-ELYGQTXB.js";
 import {
   useController
-} from "./chunk-CK362NWK.js";
+} from "./chunk-GKP3ONKO.js";
 import {
   useInput
 } from "./chunk-AHJJIANM.js";
-import {
-  FieldCopyTestIdButton_default
-} from "./chunk-NTDKZW4E.js";
 import {
   useFormContext
-} from "./chunk-NZ54JBSR.js";
+} from "./chunk-U45RW4FC.js";
 import {
   __spreadProps,
   __spreadValues
@@ -102,4 +102,4 @@ export {
   Switch_default,
   Switch_default2
 };
-//# sourceMappingURL=chunk-IK5IWKUC.js.map
+//# sourceMappingURL=chunk-K33E67GR.js.map

package/dist/{chunk-R6IWQWZ6.js → chunk-KGN5JQGG.js}

@@ -1,7 +1,9 @@
 import {
-  FormContext_default,
   useFormContext
-} from "./chunk-NZ54JBSR.js";
+} from "./chunk-U45RW4FC.js";
+import {
+  FormContext_default
+} from "./chunk-LKR6D3RL.js";
 
 // src/Form/Form.tsx
 import { cn as cn2, slugify } from "@fuf-stack/pixel-utils";
@@ -167,4 +169,4 @@ export {
   Form_default,
   Form_default2
 };
-//# sourceMappingURL=chunk-R6IWQWZ6.js.map
+//# sourceMappingURL=chunk-KGN5JQGG.js.map

package/dist/{chunk-R6IWQWZ6.js.map → chunk-KGN5JQGG.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/Form/Form.tsx","../src/Form/subcomponents/FormDebugViewer.tsx","../src/Form/index.ts"],"sourcesContent":["import type { VetoInstance } from '@fuf-stack/veto';\nimport type { ReactNode } from 'react';\nimport type { FieldValues, SubmitHandler } from 'react-hook-form';\nimport type { DebugModeSettings } from './subcomponents/FormContext';\n\nimport { cn, slugify } from '@fuf-stack/pixel-utils';\n\nimport FormProvider from './subcomponents/FormContext';\nimport FormDebugViewer from './subcomponents/FormDebugViewer';\n\nconst IS_TEST = process.env.NODE_ENV === 'test';\n\nexport interface FormProps {\n  /** form children */\n  children: ReactNode | ReactNode[];\n  /** CSS class name */\n  className?: string | string[];\n  /** settings for from debug mode */\n  debug?: DebugModeSettings;\n  /** initial form values */\n  initialValues?: FieldValues;\n  /** name of the form */\n  name?: string;\n  /** form submit handler */\n  onSubmit: SubmitHandler<FieldValues>;\n  /** HTML data-testid attribute used in e2e tests */\n  testId?: string;\n  /** veto validation schema */\n  validation?: VetoInstance;\n  /** when the validation should be triggered */\n  validationTrigger?: 'onChange' | 'onBlur' | 'onSubmit' | 'onTouched' | 'all';\n}\n\n/**\n * Form component that has to wrap every uniform\n */\nconst Form = ({\n  children,\n  className = undefined,\n  debug = undefined,\n  initialValues = undefined,\n  name = undefined,\n  onSubmit,\n  testId = undefined,\n  validation = undefined,\n  validationTrigger = 'all',\n}: FormProps) => {\n  return (\n    <FormProvider\n      debugModeSettings={debug}\n      initialValues={initialValues}\n      onSubmit={onSubmit}\n      validation={validation}\n      validationTrigger={validationTrigger}\n    >\n      {({ handleSubmit, isValid }) => {\n        return (\n          <div className=\"flex w-full flex-row justify-between gap-6\">\n            <form\n              className={cn('grow', className)}\n              data-form-is-valid={isValid}\n              data-testid={slugify(testId ?? name ?? '')}\n              name={name}\n              onSubmit={handleSubmit}\n            >\n              {children}\n            </form>\n            {/* render debug viewer when not in test environment and debug not disabled */}\n            {!IS_TEST && !debug?.disable && (\n              <FormDebugViewer className=\"w-96 shrink\" />\n            )}\n          </div>\n        );\n      }}\n    </FormProvider>\n  );\n};\n\nexport default Form;\n","import { useEffect, useState } from 'react';\nimport { FaTimes } from 'react-icons/fa';\nimport { FaBug, FaBullseye } from 'react-icons/fa6';\n\nimport { cn } from '@fuf-stack/pixel-utils';\nimport { Button } from '@fuf-stack/pixels/Button';\nimport { Card } from '@fuf-stack/pixels/Card';\nimport { Json } from '@fuf-stack/pixels/Json';\n\nimport { useFormContext } from '../../hooks';\n\n// import Json css (theme)\nimport '@fuf-stack/pixels/Json.css';\n\ninterface FormDebugViewerProps {\n  /** CSS class name */\n  className?: string;\n}\n\n/** Renders a form debug panel with information about the current form state */\nconst FormDebugViewer = ({ className = undefined }: FormDebugViewerProps) => {\n  const {\n    debugMode,\n    formState: { isValid, isSubmitting, submitCount, isSubmitSuccessful },\n    getValues,\n    setDebugMode,\n    validation: { errors },\n    subscribe,\n  } = useFormContext();\n\n  const showDebugButton = debugMode === 'off';\n  const showDebugCard = debugMode === 'debug' || debugMode === 'debug-testids';\n  const showDebugTestIds = debugMode === 'debug-testids';\n\n  // Use subscribe instead of watch() to avoid triggering re-renders on parent components.\n  // This component manages its own state and only updates itself when form values change.\n  const [values, setValues] = useState<Record<string, unknown>>({});\n\n  useEffect(() => {\n    // Only subscribe when debug card is visible\n    if (!showDebugCard) {\n      return undefined;\n    }\n\n    // Initialize with current values when debug card is opened\n    setValues(getValues() ?? {});\n\n    const subscription = subscribe({\n      formState: { values: true },\n      callback: (state) => {\n        setValues(state.values ?? {});\n      },\n    });\n\n    return () => {\n      subscription();\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [showDebugCard]);\n\n  if (showDebugButton) {\n    return (\n      <Button\n        ariaLabel=\"Enable form debug mode\"\n        className=\"fixed bottom-2.5 right-2.5 w-5 text-default-400\"\n        icon={<FaBug />}\n        variant=\"light\"\n        onClick={() => {\n          setDebugMode('debug');\n        }}\n      />\n    );\n  }\n\n  // do not show card\n  if (!showDebugCard) {\n    return null;\n  }\n\n  return (\n    <Card\n      className={cn(className)}\n      header={\n        <div className=\"flex w-full flex-row justify-between\">\n          <span className=\"text-lg\">Debug Mode</span>\n          <Button\n            color=\"danger\"\n            icon={<FaTimes />}\n            size=\"sm\"\n            variant=\"light\"\n            onClick={() => {\n              setDebugMode('off');\n            }}\n          />\n        </div>\n      }\n    >\n      <Button\n        className=\"mb-4 ml-auto mr-auto\"\n        icon={<FaBullseye />}\n        variant={showDebugTestIds ? 'solid' : 'light'}\n        onClick={() => {\n          setDebugMode(debugMode === 'debug' ? 'debug-testids' : 'debug');\n        }}\n      >\n        {showDebugTestIds ? 'Hide CopyButton' : 'Show CopyButton'}\n      </Button>\n      <Json\n        value={{\n          values,\n          errors: errors ?? null,\n          submit: {\n            isValid,\n            isSubmitting,\n            isSubmitSuccessful,\n            submitCount,\n          },\n        }}\n      />\n    </Card>\n  );\n};\n\nexport default FormDebugViewer;\n","import Form from './Form';\n\nexport type { FormProps } from './Form';\n\nexport { Form };\n\nexport default Form;\n"],"mappings":"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","names":["cn","_a","jsx","jsxs","cn","Form_default"]}
+{"version":3,"sources":["../src/Form/Form.tsx","../src/Form/subcomponents/FormDebugViewer.tsx","../src/Form/index.ts"],"sourcesContent":["import type { VetoInstance } from '@fuf-stack/veto';\nimport type { ReactNode } from 'react';\nimport type { FieldValues, SubmitHandler } from 'react-hook-form';\nimport type { DebugModeSettings } from './subcomponents/FormContext';\n\nimport { cn, slugify } from '@fuf-stack/pixel-utils';\n\nimport FormProvider from './subcomponents/FormContext';\nimport FormDebugViewer from './subcomponents/FormDebugViewer';\n\nconst IS_TEST = process.env.NODE_ENV === 'test';\n\nexport interface FormProps {\n  /** form children */\n  children: ReactNode | ReactNode[];\n  /** CSS class name */\n  className?: string | string[];\n  /** settings for from debug mode */\n  debug?: DebugModeSettings;\n  /** initial form values */\n  initialValues?: FieldValues;\n  /** name of the form */\n  name?: string;\n  /** form submit handler */\n  onSubmit: SubmitHandler<FieldValues>;\n  /** HTML data-testid attribute used in e2e tests */\n  testId?: string;\n  /** veto validation schema */\n  validation?: VetoInstance;\n  /** when the validation should be triggered */\n  validationTrigger?: 'onChange' | 'onBlur' | 'onSubmit' | 'onTouched' | 'all';\n}\n\n/**\n * Form component that has to wrap every uniform\n */\nconst Form = ({\n  children,\n  className = undefined,\n  debug = undefined,\n  initialValues = undefined,\n  name = undefined,\n  onSubmit,\n  testId = undefined,\n  validation = undefined,\n  validationTrigger = 'all',\n}: FormProps) => {\n  return (\n    <FormProvider\n      debugModeSettings={debug}\n      initialValues={initialValues}\n      onSubmit={onSubmit}\n      validation={validation}\n      validationTrigger={validationTrigger}\n    >\n      {({ handleSubmit, isValid }) => {\n        return (\n          <div className=\"flex w-full flex-row justify-between gap-6\">\n            <form\n              className={cn('grow', className)}\n              data-form-is-valid={isValid}\n              data-testid={slugify(testId ?? name ?? '')}\n              name={name}\n              onSubmit={handleSubmit}\n            >\n              {children}\n            </form>\n            {/* render debug viewer when not in test environment and debug not disabled */}\n            {!IS_TEST && !debug?.disable && (\n              <FormDebugViewer className=\"w-96 shrink\" />\n            )}\n          </div>\n        );\n      }}\n    </FormProvider>\n  );\n};\n\nexport default Form;\n","import { useEffect, useState } from 'react';\nimport { FaTimes } from 'react-icons/fa';\nimport { FaBug, FaBullseye } from 'react-icons/fa6';\n\nimport { cn } from '@fuf-stack/pixel-utils';\nimport { Button } from '@fuf-stack/pixels/Button';\nimport { Card } from '@fuf-stack/pixels/Card';\nimport { Json } from '@fuf-stack/pixels/Json';\n\nimport { useFormContext } from '../../hooks';\n\n// import Json css (theme)\nimport '@fuf-stack/pixels/Json.css';\n\ninterface FormDebugViewerProps {\n  /** CSS class name */\n  className?: string;\n}\n\n/** Renders a form debug panel with information about the current form state */\nconst FormDebugViewer = ({ className = undefined }: FormDebugViewerProps) => {\n  const {\n    debugMode,\n    formState: { isValid, isSubmitting, submitCount, isSubmitSuccessful },\n    getValues,\n    setDebugMode,\n    validation: { errors },\n    subscribe,\n  } = useFormContext();\n\n  const showDebugButton = debugMode === 'off';\n  const showDebugCard = debugMode === 'debug' || debugMode === 'debug-testids';\n  const showDebugTestIds = debugMode === 'debug-testids';\n\n  // Use subscribe instead of watch() to avoid triggering re-renders on parent components.\n  // This component manages its own state and only updates itself when form values change.\n  const [values, setValues] = useState<Record<string, unknown>>({});\n\n  useEffect(() => {\n    // Only subscribe when debug card is visible\n    if (!showDebugCard) {\n      return undefined;\n    }\n\n    // Initialize with current values when debug card is opened\n    setValues(getValues() ?? {});\n\n    const subscription = subscribe({\n      formState: { values: true },\n      callback: (state) => {\n        setValues(state.values ?? {});\n      },\n    });\n\n    return () => {\n      subscription();\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [showDebugCard]);\n\n  if (showDebugButton) {\n    return (\n      <Button\n        ariaLabel=\"Enable form debug mode\"\n        className=\"fixed bottom-2.5 right-2.5 w-5 text-default-400\"\n        icon={<FaBug />}\n        variant=\"light\"\n        onClick={() => {\n          setDebugMode('debug');\n        }}\n      />\n    );\n  }\n\n  // do not show card\n  if (!showDebugCard) {\n    return null;\n  }\n\n  return (\n    <Card\n      className={cn(className)}\n      header={\n        <div className=\"flex w-full flex-row justify-between\">\n          <span className=\"text-lg\">Debug Mode</span>\n          <Button\n            color=\"danger\"\n            icon={<FaTimes />}\n            size=\"sm\"\n            variant=\"light\"\n            onClick={() => {\n              setDebugMode('off');\n            }}\n          />\n        </div>\n      }\n    >\n      <Button\n        className=\"mb-4 ml-auto mr-auto\"\n        icon={<FaBullseye />}\n        variant={showDebugTestIds ? 'solid' : 'light'}\n        onClick={() => {\n          setDebugMode(debugMode === 'debug' ? 'debug-testids' : 'debug');\n        }}\n      >\n        {showDebugTestIds ? 'Hide CopyButton' : 'Show CopyButton'}\n      </Button>\n      <Json\n        value={{\n          values,\n          errors: errors ?? null,\n          submit: {\n            isValid,\n            isSubmitting,\n            isSubmitSuccessful,\n            submitCount,\n          },\n        }}\n      />\n    </Card>\n  );\n};\n\nexport default FormDebugViewer;\n","import Form from './Form';\n\nexport type { FormProps } from './Form';\n\nexport { Form };\n\nexport default Form;\n"],"mappings":"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","names":["cn","_a","jsx","jsxs","cn","Form_default"]}

package/dist/{chunk-M7TOCXYB.js → chunk-KQQAESO7.js}

@@ -3,10 +3,10 @@ import {
 } from "./chunk-B62HKKMS.js";
 import {
   useUniformFieldArray
-} from "./chunk-X37C4SVI.js";
+} from "./chunk-FND5Z5BW.js";
 import {
   useUniformField
-} from "./chunk-D3JYMGTB.js";
+} from "./chunk-EGFB5WEK.js";
 import {
   FieldValidationError_default
 } from "./chunk-ELYGQTXB.js";
@@ -696,4 +696,4 @@ export {
   FieldArray_default,
   FieldArray_default2
 };
-//# sourceMappingURL=chunk-M7TOCXYB.js.map
+//# sourceMappingURL=chunk-KQQAESO7.js.map

package/dist/chunk-KWJMKX5J.cjs

@@ -0,0 +1 @@
+"use strict";//# sourceMappingURL=chunk-KWJMKX5J.cjs.map

package/dist/{chunk-LTKRK3OS.cjs.map → chunk-KWJMKX5J.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-LTKRK3OS.cjs"],"names":[],"mappings":"AAAA","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-LTKRK3OS.cjs"}
+{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-KWJMKX5J.cjs"],"names":[],"mappings":"AAAA","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/chunk-KWJMKX5J.cjs"}

package/dist/{chunk-NZ54JBSR.js → chunk-LKR6D3RL.js}

@@ -1,5 +1,4 @@
 import {
-  flatArrayKey,
   toFormFormat,
   toValidationFormat
 } from "./chunk-76KOVUDN.js";
@@ -11,13 +10,8 @@ import {
   __spreadValues
 } from "./chunk-K2V4ULA2.js";
 
-// src/hooks/useFormContext/useFormContext.ts
-import { useContext } from "react";
-import { useFormContext as useHookFormContext } from "react-hook-form";
-import { slugify } from "@fuf-stack/pixel-utils";
-
 // src/Form/subcomponents/FormContext.tsx
-import React, { useMemo as useMemo2, useState as useState2 } from "react";
+import React, { useCallback, useMemo as useMemo2, useRef as useRef2, useState as useState2 } from "react";
 import { FormProvider as HookFormProvider, useForm } from "react-hook-form";
 import { useLocalStorage } from "@fuf-stack/pixels";
 
@@ -131,6 +125,16 @@ if (!window.__UNIFORM_CONTEXT__) {
       triggerSubmit: () => {
         return void 0;
       },
+      userChange: {
+        subscribe: () => {
+          return () => {
+            return void 0;
+          };
+        },
+        notify: () => {
+          return void 0;
+        }
+      },
       validation: {
         setClientValidationSchema: () => {
           return void 0;
@@ -164,6 +168,24 @@ var FormProvider = ({
   });
   const isValid = (_b = methods.formState) == null ? void 0 : _b.isValid;
   const [preventSubmit, setPreventSubmit] = useState2(false);
+  const userChangeListenersRef = useRef2(/* @__PURE__ */ new Set());
+  const subscribeUserChange = useCallback(
+    (listener) => {
+      userChangeListenersRef.current.add(listener);
+      return () => {
+        userChangeListenersRef.current.delete(listener);
+      };
+    },
+    []
+  );
+  const notifyUserChange = useCallback(
+    (fieldName, value) => {
+      userChangeListenersRef.current.forEach((listener) => {
+        listener(fieldName, value);
+      });
+    },
+    []
+  );
   const handleSubmit = (e) => __async(null, null, function* () {
     if (methods.formState.isValid && preventSubmit) {
       console.warn(
@@ -191,6 +213,10 @@ var FormProvider = ({
         setClientValidationSchema,
         setDebugMode,
         triggerSubmit: handleSubmit,
+        userChange: {
+          subscribe: subscribeUserChange,
+          notify: notifyUserChange
+        },
         validation: {
           baseInstance: baseValidation,
           instance: extendedValidation,
@@ -206,103 +232,8 @@ var FormProvider = ({
 };
 var FormContext_default = FormProvider;
 
-// src/hooks/useFormContext/useFormContext.ts
-var checkFieldIsRequired = (validation, path) => {
-  const checkPath = path[path.length - 1] === flatArrayKey ? path.slice(0, -1) : path;
-  const checkRequired = (schema) => {
-    if (schema.type === "array") {
-      if (schema.isOptional || schema.isNullable) {
-        return false;
-      }
-      return true;
-    }
-    return !schema.isOptional && !schema.isNullable;
-  };
-  return validation.checkSchemaPath(checkRequired, checkPath);
-};
-var getValidationErrorsByName = (errors, name) => {
-  const keys = name.split(".").filter((k) => {
-    return k !== flatArrayKey;
-  });
-  let current = errors;
-  keys.forEach((key) => {
-    if (current && typeof current === "object") {
-      current = current[key];
-    } else {
-      current = void 0;
-    }
-  });
-  return current;
-};
-var useFormContext = () => {
-  const _a = useHookFormContext(), {
-    formState,
-    getFieldState: getFieldStateOrig,
-    getValues: getValuesOrig,
-    watch: watchOrig,
-    subscribe: subscribeOrig
-  } = _a, otherMethods = __objRest(_a, [
-    "formState",
-    // some methods that will be enhanced below
-    "getFieldState",
-    "getValues",
-    "watch",
-    "subscribe"
-  ]);
-  const uniformContext = useContext(UniformContext);
-  const getFieldState = (name, testId) => {
-    var _a2, _b;
-    const fieldPath = typeof name === "string" ? name.replace(/\[\d+\]/g, "").split(".") : name;
-    const validationInstance = (_a2 = uniformContext == null ? void 0 : uniformContext.validation.baseInstance) != null ? _a2 : uniformContext == null ? void 0 : uniformContext.validation.instance;
-    const required = validationInstance ? checkFieldIsRequired(validationInstance, fieldPath) : false;
-    const error = getValidationErrorsByName(
-      (_b = uniformContext == null ? void 0 : uniformContext.validation.errors) != null ? _b : {},
-      name
-    );
-    const fieldState = getFieldStateOrig(name, formState);
-    return __spreadProps(__spreadValues({}, fieldState), {
-      error,
-      invalid: !!error,
-      required,
-      testId: slugify(testId != null ? testId : name, { replaceDots: true })
-    });
-  };
-  const getValues = ((...args) => {
-    const result = getValuesOrig(...args);
-    return toValidationFormat(result);
-  });
-  const watch = ((...args) => {
-    const result = watchOrig(...args);
-    return toValidationFormat(result);
-  });
-  const subscribe = ((...args) => {
-    const [options] = args;
-    if (options == null ? void 0 : options.callback) {
-      const originalCallback = options.callback;
-      const wrappedOptions = __spreadProps(__spreadValues({}, options), {
-        callback: (subscribeFormState) => {
-          const convertedFormState = __spreadValues(__spreadValues({}, subscribeFormState), subscribeFormState.values && {
-            values: toValidationFormat(subscribeFormState.values)
-          });
-          return originalCallback(convertedFormState);
-        }
-      });
-      return subscribeOrig(wrappedOptions);
-    }
-    return subscribeOrig(...args);
-  });
-  return __spreadProps(__spreadValues(__spreadValues({}, otherMethods), uniformContext), {
-    formState,
-    getFieldState,
-    getValues,
-    subscribe,
-    watch
-  });
-};
-
 export {
-  FormContext_default,
-  checkFieldIsRequired,
-  useFormContext
+  UniformContext,
+  FormContext_default
 };
-//# sourceMappingURL=chunk-NZ54JBSR.js.map
+//# sourceMappingURL=chunk-LKR6D3RL.js.map

package/dist/chunk-LKR6D3RL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/Form/subcomponents/FormContext.tsx","../src/Form/subcomponents/FormResolver.ts"],"sourcesContent":["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 { useLocalStorage } from '@fuf-stack/pixels';\n\nimport { toFormFormat, toValidationFormat } from '../../helpers';\nimport { useExtendedValidation, useFormResolver } from './FormResolver';\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}\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\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    // 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      console.warn(\n        '[FormProvider] form submit was prevented because preventSubmit is true...',\n      );\n      e?.preventDefault();\n      return Promise.resolve();\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      return onSubmit(submitData, event);\n    };\n\n    await methods.handleSubmit(wrappedOnSubmit)(e);\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          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"],"mappings":"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","names":["useMemo","useRef","useState","useState","useRef","_a","useMemo"]}