@fuf-stack/uniform 1.17.1 → 1.18.1

package/dist/{useUniformFieldArray-4MOU0xac.d.ts.map → useUniformFieldArray-14B50iH3.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"useUniformFieldArray-4MOU0xac.d.ts","names":[],"sources":["../src/hooks/useUniformFieldArray/useUniformFieldArray.ts"],"mappings":";;;;;;;;UAYiB,yBAAA,sBACM,WAAA,GAAc,WAAA;;EAGnC,IAAA,EAAM,SAAA,CAAU,YAAA;;EAEhB,IAAA;EANe;EAQf,mBAAA;EARwC;EAUxC,uBAAA;EATmC;EAWnC,QAAA;EARM;EAUN,MAAA;EAEiB;EAAjB,KAAA,GAAQ,SAAA;AAAA;;;;;;;;;;;;;cAeG,oBAAA,wBACU,WAAA,GAAc,WAAA;EACnC,IAAA;EAAA,IAAA;EAAA,mBAAA,EAAA,oBAAA;EAAA,uBAAA;EAAA,QAAA;EAAA,MAAA,EAAA,cAAA;EAAA;AAAA,GAQC,yBAAA,CAA0B,YAAA;;;;;;;;;kBAhC+B,KAAA;;;;;;;;;UAqExB,UAAA;YAEX,UAAA,QAFW,eAAA;OAKzB,UAAA,QAHc,eAAA"}
+{"version":3,"file":"useUniformFieldArray-14B50iH3.d.ts","names":[],"sources":["../src/hooks/useUniformFieldArray/useUniformFieldArray.ts"],"mappings":";;;;;;;;UAYiB,yBAAA,sBACM,WAAA,GAAc,WAAA;;EAGnC,IAAA,EAAM,SAAA,CAAU,YAAA;;EAEhB,IAAA;EANe;EAQf,mBAAA;EARwC;EAUxC,uBAAA;EATmC;EAWnC,QAAA;EARM;EAUN,MAAA;EAEiB;EAAjB,KAAA,GAAQ,SAAA;AAAA;;;;;;;;;;;;;cAeG,oBAAA,wBACU,WAAA,GAAc,WAAA;EACnC,IAAA;EAAA,IAAA;EAAA,mBAAA,EAAA,oBAAA;EAAA,uBAAA;EAAA,QAAA;EAAA,MAAA,EAAA,cAAA;EAAA;AAAA,GAQC,yBAAA,CAA0B,YAAA;;;;;;;;;kBAhC+B,KAAA;;;;;;;;;UAqExB,UAAA;YAEX,UAAA,QAFW,eAAA;OAKzB,UAAA,QAHc,eAAA"}

package/dist/{useUniformFieldArray-CPBQciJw.js → useUniformFieldArray-BKvA0FQW.js}

@@ -1,6 +1,6 @@
-import { t as flatArrayKey } from "./helpers-B6Iozj-0.js";
-import { n as useFormContext$1 } from "./useFormContext-yC0bzokU.js";
-import { t as useUniformField } from "./useUniformField-DIdjVLj3.js";
+import { t as flatArrayKey } from "./helpers-33jajRcN.js";
+import { n as useFormContext$1 } from "./useFormContext-Di67HIf7.js";
+import { t as useUniformField } from "./useUniformField-C-Xyu-8v.js";
 import { useEffect, useMemo, useRef, useState } from "react";
 import { useReducedMotion } from "@fuf-stack/pixel-motion";
 import { useFieldArray } from "react-hook-form";
@@ -81,4 +81,4 @@ const useUniformFieldArray = ({ name, flat = false, elementInitialValue: _elemen
 
 //#endregion
 export { useUniformFieldArray as t };
-//# sourceMappingURL=useUniformFieldArray-CPBQciJw.js.map
+//# sourceMappingURL=useUniformFieldArray-BKvA0FQW.js.map

package/dist/{useUniformFieldArray-CPBQciJw.js.map → useUniformFieldArray-BKvA0FQW.js.map}

@@ -1 +1 @@
-{"version":3,"file":"useUniformFieldArray-CPBQciJw.js","names":["useRHFFieldArray","useFormContext"],"sources":["../src/hooks/useUniformFieldArray/useUniformFieldArray.ts","../src/hooks/useUniformFieldArray/index.ts"],"sourcesContent":["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';\nimport { useUniformField } from '../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 */\n  label?: ReactNode;\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  // This ensures min/max errors appear instantly when user adds/removes items.\n  // Note: Child field validation also runs, but new empty fields won't show as invalid\n  // because useFormContext only sets invalid=true for touched fields or after form submission.\n  // Skip validation during initialization/re-initialization to avoid showing errors prematurely.\n  useEffect(() => {\n    if (hasInitialized.current) {\n      setTimeout(() => {\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","/* v8 ignore start */\n\nexport * from './useUniformFieldArray';\n\n/* v8 ignore stop */\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA2CA,MAAa,wBAEX,EACA,MACA,OAAO,OACP,qBAAqB,uBAAuB,MAC5C,0BAA0B,OAC1B,UACA,QAAQ,gBACR,YAC6C;CAE7C,MAAM,eAAe,gBAA8B;EAC3C;EACN;EACA,QAAQ;EACR;EACD,CAAC;CAEF,MAAM,EAAE,YAAY;CAEpB,MAAM,EAAE,QAAQ,QAAQ,QAAQ,QAAQ,SAASA,cAAiB;EAChE;EACA;EACD,CAAC;CAEF,MAAM,EAAE,SAAS,aAAaC,kBAA8B;CAQ5D,MAAM,kBAAkB,cAAc;AACpC,SAAO,2BAA2B,OAAO,WAAW;IACnD,CAAC,yBAAyB,OAAO,OAAO,CAAC;CAS5C,MAAM,iBAAiB,OAAO,CAAC,gBAAgB;AAK/C,iBAAgB;AACd,MAAI,gBACF,gBAAe,UAAU;IAE1B,CAAC,gBAAgB,CAAC;AAOrB,iBAAgB;AACd,MAAI,eAAe,QACjB,kBAAiB;AACf,WAAQ,KAA2B;KAClC,IAAI;IAGR,CAAC,OAAO,OAAO,CAAC;CAInB,MAAM,CAAC,kBAAkB,uBAAuB,SAAS,KAAK;CAI9D,MAAM,uBAAuB,kBAAkB;AAC/C,iBAAgB;AACd,MAAI,eAAe,QACjB,qBAAoB,CAAC,CAAC,qBAAqB;IAE5C,CAAC,qBAAqB,CAAC;CAK1B,MAAM,sBAAsB,cAAc;AACxC,SAAO,OACH,GAAG,eAAe,wBAAwB,MAAM,GAC/C,wBAAwB,EAAE;IAC9B,CAAC,MAAM,qBAAqB,CAAC;AAUhC,iBACQ;AACJ,MAAI,iBAAiB;AAGnB,YAAS,MAA4B,CAAC,oBAAoB,EAAS;IACjE,aAAa;IACb,aAAa;IACd,CAAC;AAGF,kBAAe,UAAU;AAKzB,OAAI,CAAC,wBAAwB,iBAC3B,kBAAiB;AACf,wBAAoB,MAAM;MACzB,EAAE;;IAUX,CAAC,gBAAgB,CAClB;AAED,QAAO;EAEL;EACA;EACA;EACA;EACA;EACA;EACA;EAEA,GAAG;EACJ"}
+{"version":3,"file":"useUniformFieldArray-BKvA0FQW.js","names":["useRHFFieldArray","useFormContext"],"sources":["../src/hooks/useUniformFieldArray/useUniformFieldArray.ts","../src/hooks/useUniformFieldArray/index.ts"],"sourcesContent":["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';\nimport { useUniformField } from '../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 */\n  label?: ReactNode;\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  // This ensures min/max errors appear instantly when user adds/removes items.\n  // Note: Child field validation also runs, but new empty fields won't show as invalid\n  // because useFormContext only sets invalid=true for touched fields or after form submission.\n  // Skip validation during initialization/re-initialization to avoid showing errors prematurely.\n  useEffect(() => {\n    if (hasInitialized.current) {\n      setTimeout(() => {\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","/* v8 ignore start */\n\nexport * from './useUniformFieldArray';\n\n/* v8 ignore stop */\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA2CA,MAAa,wBAEX,EACA,MACA,OAAO,OACP,qBAAqB,uBAAuB,MAC5C,0BAA0B,OAC1B,UACA,QAAQ,gBACR,YAC6C;CAE7C,MAAM,eAAe,gBAA8B;EAC3C;EACN;EACA,QAAQ;EACR;EACD,CAAC;CAEF,MAAM,EAAE,YAAY;CAEpB,MAAM,EAAE,QAAQ,QAAQ,QAAQ,QAAQ,SAASA,cAAiB;EAChE;EACA;EACD,CAAC;CAEF,MAAM,EAAE,SAAS,aAAaC,kBAA8B;CAQ5D,MAAM,kBAAkB,cAAc;AACpC,SAAO,2BAA2B,OAAO,WAAW;IACnD,CAAC,yBAAyB,OAAO,OAAO,CAAC;CAS5C,MAAM,iBAAiB,OAAO,CAAC,gBAAgB;AAK/C,iBAAgB;AACd,MAAI,gBACF,gBAAe,UAAU;IAE1B,CAAC,gBAAgB,CAAC;AAOrB,iBAAgB;AACd,MAAI,eAAe,QACjB,kBAAiB;AACf,WAAQ,KAA2B;KAClC,IAAI;IAGR,CAAC,OAAO,OAAO,CAAC;CAInB,MAAM,CAAC,kBAAkB,uBAAuB,SAAS,KAAK;CAI9D,MAAM,uBAAuB,kBAAkB;AAC/C,iBAAgB;AACd,MAAI,eAAe,QACjB,qBAAoB,CAAC,CAAC,qBAAqB;IAE5C,CAAC,qBAAqB,CAAC;CAK1B,MAAM,sBAAsB,cAAc;AACxC,SAAO,OACH,GAAG,eAAe,wBAAwB,MAAM,GAC/C,wBAAwB,EAAE;IAC9B,CAAC,MAAM,qBAAqB,CAAC;AAUhC,iBACQ;AACJ,MAAI,iBAAiB;AAGnB,YAAS,MAA4B,CAAC,oBAAoB,EAAS;IACjE,aAAa;IACb,aAAa;IACd,CAAC;AAGF,kBAAe,UAAU;AAKzB,OAAI,CAAC,wBAAwB,iBAC3B,kBAAiB;AACf,wBAAoB,MAAM;MACzB,EAAE;;IAUX,CAAC,gBAAgB,CAClB;AAED,QAAO;EAEL;EACA;EACA;EACA;EACA;EACA;EACA;EAEA,GAAG;EACJ"}

package/dist/{useUniformFieldArray-CXdW_Teb.cjs → useUniformFieldArray-CRCbV1J2.cjs}

@@ -1,7 +1,7 @@
-const require_FormContext = require('./FormContext-CeFKQmVH.cjs');
-const require_helpers = require('./helpers-CncbgvW_.cjs');
-const require_useFormContext = require('./useFormContext-DJiJlfGJ.cjs');
-const require_useUniformField = require('./useUniformField-hjd0F3HI.cjs');
+const require_FormContext = require('./FormContext-BSLO2-sO.cjs');
+const require_helpers = require('./helpers-Bd_QpqXg.cjs');
+const require_useFormContext = require('./useFormContext-vdeeDsAs.cjs');
+const require_useUniformField = require('./useUniformField-6c4OCAfb.cjs');
 let react = require("react");
 let _fuf_stack_pixel_motion = require("@fuf-stack/pixel-motion");
 let react_hook_form = require("react-hook-form");
@@ -87,4 +87,4 @@ Object.defineProperty(exports, 'useUniformFieldArray', {
     return useUniformFieldArray;
   }
 });
-//# sourceMappingURL=useUniformFieldArray-CXdW_Teb.cjs.map
+//# sourceMappingURL=useUniformFieldArray-CRCbV1J2.cjs.map

package/dist/{useUniformFieldArray-CXdW_Teb.cjs.map → useUniformFieldArray-CRCbV1J2.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"useUniformFieldArray-CXdW_Teb.cjs","names":["useUniformField","useFormContext","flatArrayKey"],"sources":["../src/hooks/useUniformFieldArray/useUniformFieldArray.ts","../src/hooks/useUniformFieldArray/index.ts"],"sourcesContent":["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';\nimport { useUniformField } from '../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 */\n  label?: ReactNode;\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  // This ensures min/max errors appear instantly when user adds/removes items.\n  // Note: Child field validation also runs, but new empty fields won't show as invalid\n  // because useFormContext only sets invalid=true for touched fields or after form submission.\n  // Skip validation during initialization/re-initialization to avoid showing errors prematurely.\n  useEffect(() => {\n    if (hasInitialized.current) {\n      setTimeout(() => {\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","/* v8 ignore start */\n\nexport * from './useUniformFieldArray';\n\n/* v8 ignore stop */\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA2CA,MAAa,wBAEX,EACA,MACA,OAAO,OACP,qBAAqB,uBAAuB,MAC5C,0BAA0B,OAC1B,UACA,QAAQ,gBACR,YAC6C;CAE7C,MAAM,eAAeA,wCAA8B;EAC3C;EACN;EACA,QAAQ;EACR;EACD,CAAC;CAEF,MAAM,EAAE,YAAY;CAEpB,MAAM,EAAE,QAAQ,QAAQ,QAAQ,QAAQ,4CAA0B;EAChE;EACA;EACD,CAAC;CAEF,MAAM,EAAE,SAAS,aAAaC,uCAA8B;CAQ5D,MAAM,2CAAgC;AACpC,SAAO,2BAA2B,OAAO,WAAW;IACnD,CAAC,yBAAyB,OAAO,OAAO,CAAC;CAS5C,MAAM,mCAAwB,CAAC,gBAAgB;AAK/C,4BAAgB;AACd,MAAI,gBACF,gBAAe,UAAU;IAE1B,CAAC,gBAAgB,CAAC;AAOrB,4BAAgB;AACd,MAAI,eAAe,QACjB,kBAAiB;AACf,WAAQ,KAA2B;KAClC,IAAI;IAGR,CAAC,OAAO,OAAO,CAAC;CAInB,MAAM,CAAC,kBAAkB,2CAAgC,KAAK;CAI9D,MAAM,sEAAyC;AAC/C,4BAAgB;AACd,MAAI,eAAe,QACjB,qBAAoB,CAAC,CAAC,qBAAqB;IAE5C,CAAC,qBAAqB,CAAC;CAK1B,MAAM,+CAAoC;AACxC,SAAO,OACH,GAAGC,+BAAe,wBAAwB,MAAM,GAC/C,wBAAwB,EAAE;IAC9B,CAAC,MAAM,qBAAqB,CAAC;AAUhC,4BACQ;AACJ,MAAI,iBAAiB;AAGnB,YAAS,MAA4B,CAAC,oBAAoB,EAAS;IACjE,aAAa;IACb,aAAa;IACd,CAAC;AAGF,kBAAe,UAAU;AAKzB,OAAI,CAAC,wBAAwB,iBAC3B,kBAAiB;AACf,wBAAoB,MAAM;MACzB,EAAE;;IAUX,CAAC,gBAAgB,CAClB;AAED,QAAO;EAEL;EACA;EACA;EACA;EACA;EACA;EACA;EAEA,GAAG;EACJ"}
+{"version":3,"file":"useUniformFieldArray-CRCbV1J2.cjs","names":["useUniformField","useFormContext","flatArrayKey"],"sources":["../src/hooks/useUniformFieldArray/useUniformFieldArray.ts","../src/hooks/useUniformFieldArray/index.ts"],"sourcesContent":["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';\nimport { useUniformField } from '../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 */\n  label?: ReactNode;\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  // This ensures min/max errors appear instantly when user adds/removes items.\n  // Note: Child field validation also runs, but new empty fields won't show as invalid\n  // because useFormContext only sets invalid=true for touched fields or after form submission.\n  // Skip validation during initialization/re-initialization to avoid showing errors prematurely.\n  useEffect(() => {\n    if (hasInitialized.current) {\n      setTimeout(() => {\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","/* v8 ignore start */\n\nexport * from './useUniformFieldArray';\n\n/* v8 ignore stop */\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA2CA,MAAa,wBAEX,EACA,MACA,OAAO,OACP,qBAAqB,uBAAuB,MAC5C,0BAA0B,OAC1B,UACA,QAAQ,gBACR,YAC6C;CAE7C,MAAM,eAAeA,wCAA8B;EAC3C;EACN;EACA,QAAQ;EACR;EACD,CAAC;CAEF,MAAM,EAAE,YAAY;CAEpB,MAAM,EAAE,QAAQ,QAAQ,QAAQ,QAAQ,4CAA0B;EAChE;EACA;EACD,CAAC;CAEF,MAAM,EAAE,SAAS,aAAaC,uCAA8B;CAQ5D,MAAM,2CAAgC;AACpC,SAAO,2BAA2B,OAAO,WAAW;IACnD,CAAC,yBAAyB,OAAO,OAAO,CAAC;CAS5C,MAAM,mCAAwB,CAAC,gBAAgB;AAK/C,4BAAgB;AACd,MAAI,gBACF,gBAAe,UAAU;IAE1B,CAAC,gBAAgB,CAAC;AAOrB,4BAAgB;AACd,MAAI,eAAe,QACjB,kBAAiB;AACf,WAAQ,KAA2B;KAClC,IAAI;IAGR,CAAC,OAAO,OAAO,CAAC;CAInB,MAAM,CAAC,kBAAkB,2CAAgC,KAAK;CAI9D,MAAM,sEAAyC;AAC/C,4BAAgB;AACd,MAAI,eAAe,QACjB,qBAAoB,CAAC,CAAC,qBAAqB;IAE5C,CAAC,qBAAqB,CAAC;CAK1B,MAAM,+CAAoC;AACxC,SAAO,OACH,GAAGC,+BAAe,wBAAwB,MAAM,GAC/C,wBAAwB,EAAE;IAC9B,CAAC,MAAM,qBAAqB,CAAC;AAUhC,4BACQ;AACJ,MAAI,iBAAiB;AAGnB,YAAS,MAA4B,CAAC,oBAAoB,EAAS;IACjE,aAAa;IACb,aAAa;IACd,CAAC;AAGF,kBAAe,UAAU;AAKzB,OAAI,CAAC,wBAAwB,iBAC3B,kBAAiB;AACf,wBAAoB,MAAM;MACzB,EAAE;;IAUX,CAAC,gBAAgB,CAClB;AAED,QAAO;EAEL;EACA;EACA;EACA;EACA;EACA;EACA;EAEA,GAAG;EACJ"}

package/dist/{useUniformFieldArray-BChcZvc5.d.cts → useUniformFieldArray-CeMjX0vf.d.cts}

@@ -1,5 +1,5 @@
 import { r as useController } from "./useController-CvPWE2Sy.cjs";
-import { n as useFormContext } from "./useFormContext-Dh97YG47.cjs";
+import { n as useFormContext } from "./useFormContext-Da-czmbI.cjs";
 import { ReactNode } from "react";
 import * as react_hook_form14 from "react-hook-form";
 import { ArrayPath, FieldValues } from "react-hook-form";
@@ -76,4 +76,4 @@ declare const useUniformFieldArray: <TFieldValues extends FieldValues = FieldVal
 };
 //#endregion
 export { useUniformFieldArray as n, UseUniformFieldArrayProps as t };
-//# sourceMappingURL=useUniformFieldArray-BChcZvc5.d.cts.map
+//# sourceMappingURL=useUniformFieldArray-CeMjX0vf.d.cts.map

package/dist/{useUniformFieldArray-BChcZvc5.d.cts.map → useUniformFieldArray-CeMjX0vf.d.cts.map}

@@ -1 +1 @@
-{"version":3,"file":"useUniformFieldArray-BChcZvc5.d.cts","names":[],"sources":["../src/hooks/useUniformFieldArray/useUniformFieldArray.ts"],"mappings":";;;;;;;;UAYiB,yBAAA,sBACM,WAAA,GAAc,WAAA;;EAGnC,IAAA,EAAM,SAAA,CAAU,YAAA;;EAEhB,IAAA;EANe;EAQf,mBAAA;EARwC;EAUxC,uBAAA;EATmC;EAWnC,QAAA;EARM;EAUN,MAAA;EAEiB;EAAjB,KAAA,GAAQ,SAAA;AAAA;;;;;;;;;;;;;cAeG,oBAAA,wBACU,WAAA,GAAc,WAAA;EACnC,IAAA;EAAA,IAAA;EAAA,mBAAA,EAAA,oBAAA;EAAA,uBAAA;EAAA,QAAA;EAAA,MAAA,EAAA,cAAA;EAAA;AAAA,GAQC,yBAAA,CAA0B,YAAA;;;;;;;;;kBAhC+B,KAAA;;;;;;;;;UAqExB,UAAA;YAEX,UAAA,QAFW,aAAA;OAKzB,UAAA,QAHc,aAAA"}
+{"version":3,"file":"useUniformFieldArray-CeMjX0vf.d.cts","names":[],"sources":["../src/hooks/useUniformFieldArray/useUniformFieldArray.ts"],"mappings":";;;;;;;;UAYiB,yBAAA,sBACM,WAAA,GAAc,WAAA;;EAGnC,IAAA,EAAM,SAAA,CAAU,YAAA;;EAEhB,IAAA;EANe;EAQf,mBAAA;EARwC;EAUxC,uBAAA;EATmC;EAWnC,QAAA;EARM;EAUN,MAAA;EAEiB;EAAjB,KAAA,GAAQ,SAAA;AAAA;;;;;;;;;;;;;cAeG,oBAAA,wBACU,WAAA,GAAc,WAAA;EACnC,IAAA;EAAA,IAAA;EAAA,mBAAA,EAAA,oBAAA;EAAA,uBAAA;EAAA,QAAA;EAAA,MAAA,EAAA,cAAA;EAAA;AAAA,GAQC,yBAAA,CAA0B,YAAA;;;;;;;;;kBAhC+B,KAAA;;;;;;;;;UAqExB,UAAA;YAEX,UAAA,QAFW,aAAA;OAKzB,UAAA,QAHc,aAAA"}

package/dist/{useWatchUserChange-jivI5KIB.cjs → useWatchUserChange-C1Kluht2.cjs}

@@ -1,5 +1,5 @@
-const require_FormContext = require('./FormContext-CeFKQmVH.cjs');
-const require_useFormContext = require('./useFormContext-DJiJlfGJ.cjs');
+const require_FormContext = require('./FormContext-BSLO2-sO.cjs');
+const require_useFormContext = require('./useFormContext-vdeeDsAs.cjs');
 let react = require("react");
 
 //#region src/hooks/useWatchUserChange/useWatchUserChange.ts
@@ -88,4 +88,4 @@ Object.defineProperty(exports, 'useWatchUserChange', {
     return useWatchUserChange;
   }
 });
-//# sourceMappingURL=useWatchUserChange-jivI5KIB.cjs.map
+//# sourceMappingURL=useWatchUserChange-C1Kluht2.cjs.map

package/dist/{useWatchUserChange-jivI5KIB.cjs.map → useWatchUserChange-C1Kluht2.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"useWatchUserChange-jivI5KIB.cjs","names":["useFormContext"],"sources":["../src/hooks/useWatchUserChange/useWatchUserChange.ts"],"sourcesContent":["import type {\n  FieldValues,\n  Path,\n  UseFormReset,\n  UseFormResetField,\n  UseFormSetValue,\n} from 'react-hook-form';\n\nimport { useEffect } from 'react';\n\nimport { useFormContext } from '../useFormContext/useFormContext';\n\nexport interface UseWatchUserChangeOptions<TFieldValues extends FieldValues> {\n  /** Field name to watch for user changes */\n  watch: Path<TFieldValues>;\n  /**\n   * Callback when watched field is changed by user input.\n   * Receives the new value and form helpers (setValue, resetField, reset).\n   */\n  onChange: (\n    value: unknown,\n    helpers: {\n      setValue: UseFormSetValue<TFieldValues>;\n      resetField: UseFormResetField<TFieldValues>;\n      reset: UseFormReset<TFieldValues>;\n    },\n  ) => void;\n}\n\n/**\n * Hook that watches for user changes on a specific form field.\n *\n * Only triggers on manual user input (typing, clicking, selecting),\n * NOT on programmatic changes like form.reset() or form.setValue().\n * Also does NOT trigger when selecting the same value (e.g., clicking\n * an already-selected option in a Select).\n *\n * This hook subscribes to field changes at the source (useController),\n * ensuring immediate and accurate detection of user interactions.\n *\n * Use cases:\n * - Reset dependent fields when parent field changes\n * - Set mode-specific default values when a toggle changes\n * - Clear form sections based on user selections\n * - Trigger side effects only on user interaction\n *\n * Note: To watch multiple fields, call this hook multiple times.\n *\n * @example\n * ```tsx\n * // Reset city and address when user changes country\n * useWatchUserChange({\n *   watch: 'country',\n *   onChange: (value, { resetField }) => {\n *     resetField('city');\n *     resetField('address');\n *   },\n * });\n *\n * // Set defaults when user changes payment method\n * useWatchUserChange({\n *   watch: 'paymentMethod',\n *   onChange: (value, { setValue }) => {\n *     if (value === 'credit') {\n *       setValue('installments', 3);\n *     } else {\n *       setValue('installments', 1);\n *     }\n *   },\n * });\n *\n * // Watch multiple fields by calling the hook multiple times\n * useWatchUserChange({\n *   watch: 'category',\n *   onChange: (value, { resetField }) => {\n *     resetField('productId');\n *   },\n * });\n * useWatchUserChange({\n *   watch: 'brand',\n *   onChange: (value, { resetField }) => {\n *     resetField('productId');\n *   },\n * });\n * ```\n */\nexport const useWatchUserChange = <\n  TFieldValues extends FieldValues = FieldValues,\n>({\n  watch: watchField,\n  onChange,\n}: UseWatchUserChangeOptions<TFieldValues>) => {\n  const { setValue, resetField, reset, userChange } =\n    useFormContext<TFieldValues>();\n\n  useEffect(() => {\n    // Create listener that checks if changed field is the one we're watching\n    const listener = (fieldName: Path<TFieldValues>, value: unknown) => {\n      // Check if this is the field we're watching\n      if (fieldName === watchField) {\n        // Call the onChange callback with helpers\n        onChange(value, { setValue, resetField, reset });\n      }\n    };\n\n    // Subscribe to user changes\n    const unsubscribe = userChange.subscribe(listener);\n\n    // Cleanup on unmount\n    return unsubscribe;\n  }, [watchField, onChange, setValue, resetField, reset, userChange]);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsFA,MAAa,sBAEX,EACA,OAAO,YACP,eAC6C;CAC7C,MAAM,EAAE,UAAU,YAAY,OAAO,eACnCA,uCAA8B;AAEhC,4BAAgB;EAEd,MAAM,YAAY,WAA+B,UAAmB;AAElE,OAAI,cAAc,WAEhB,UAAS,OAAO;IAAE;IAAU;IAAY;IAAO,CAAC;;AAQpD,SAHoB,WAAW,UAAU,SAAS;IAIjD;EAAC;EAAY;EAAU;EAAU;EAAY;EAAO;EAAW,CAAC"}
+{"version":3,"file":"useWatchUserChange-C1Kluht2.cjs","names":["useFormContext"],"sources":["../src/hooks/useWatchUserChange/useWatchUserChange.ts"],"sourcesContent":["import type {\n  FieldValues,\n  Path,\n  UseFormReset,\n  UseFormResetField,\n  UseFormSetValue,\n} from 'react-hook-form';\n\nimport { useEffect } from 'react';\n\nimport { useFormContext } from '../useFormContext/useFormContext';\n\nexport interface UseWatchUserChangeOptions<TFieldValues extends FieldValues> {\n  /** Field name to watch for user changes */\n  watch: Path<TFieldValues>;\n  /**\n   * Callback when watched field is changed by user input.\n   * Receives the new value and form helpers (setValue, resetField, reset).\n   */\n  onChange: (\n    value: unknown,\n    helpers: {\n      setValue: UseFormSetValue<TFieldValues>;\n      resetField: UseFormResetField<TFieldValues>;\n      reset: UseFormReset<TFieldValues>;\n    },\n  ) => void;\n}\n\n/**\n * Hook that watches for user changes on a specific form field.\n *\n * Only triggers on manual user input (typing, clicking, selecting),\n * NOT on programmatic changes like form.reset() or form.setValue().\n * Also does NOT trigger when selecting the same value (e.g., clicking\n * an already-selected option in a Select).\n *\n * This hook subscribes to field changes at the source (useController),\n * ensuring immediate and accurate detection of user interactions.\n *\n * Use cases:\n * - Reset dependent fields when parent field changes\n * - Set mode-specific default values when a toggle changes\n * - Clear form sections based on user selections\n * - Trigger side effects only on user interaction\n *\n * Note: To watch multiple fields, call this hook multiple times.\n *\n * @example\n * ```tsx\n * // Reset city and address when user changes country\n * useWatchUserChange({\n *   watch: 'country',\n *   onChange: (value, { resetField }) => {\n *     resetField('city');\n *     resetField('address');\n *   },\n * });\n *\n * // Set defaults when user changes payment method\n * useWatchUserChange({\n *   watch: 'paymentMethod',\n *   onChange: (value, { setValue }) => {\n *     if (value === 'credit') {\n *       setValue('installments', 3);\n *     } else {\n *       setValue('installments', 1);\n *     }\n *   },\n * });\n *\n * // Watch multiple fields by calling the hook multiple times\n * useWatchUserChange({\n *   watch: 'category',\n *   onChange: (value, { resetField }) => {\n *     resetField('productId');\n *   },\n * });\n * useWatchUserChange({\n *   watch: 'brand',\n *   onChange: (value, { resetField }) => {\n *     resetField('productId');\n *   },\n * });\n * ```\n */\nexport const useWatchUserChange = <\n  TFieldValues extends FieldValues = FieldValues,\n>({\n  watch: watchField,\n  onChange,\n}: UseWatchUserChangeOptions<TFieldValues>) => {\n  const { setValue, resetField, reset, userChange } =\n    useFormContext<TFieldValues>();\n\n  useEffect(() => {\n    // Create listener that checks if changed field is the one we're watching\n    const listener = (fieldName: Path<TFieldValues>, value: unknown) => {\n      // Check if this is the field we're watching\n      if (fieldName === watchField) {\n        // Call the onChange callback with helpers\n        onChange(value, { setValue, resetField, reset });\n      }\n    };\n\n    // Subscribe to user changes\n    const unsubscribe = userChange.subscribe(listener);\n\n    // Cleanup on unmount\n    return unsubscribe;\n  }, [watchField, onChange, setValue, resetField, reset, userChange]);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsFA,MAAa,sBAEX,EACA,OAAO,YACP,eAC6C;CAC7C,MAAM,EAAE,UAAU,YAAY,OAAO,eACnCA,uCAA8B;AAEhC,4BAAgB;EAEd,MAAM,YAAY,WAA+B,UAAmB;AAElE,OAAI,cAAc,WAEhB,UAAS,OAAO;IAAE;IAAU;IAAY;IAAO,CAAC;;AAQpD,SAHoB,WAAW,UAAU,SAAS;IAIjD;EAAC;EAAY;EAAU;EAAU;EAAY;EAAO;EAAW,CAAC"}

package/dist/{useWatchUserChange-BtqaujL4.js → useWatchUserChange-Dj9Imxfi.js}

@@ -1,4 +1,4 @@
-import { n as useFormContext } from "./useFormContext-yC0bzokU.js";
+import { n as useFormContext } from "./useFormContext-Di67HIf7.js";
 import { useEffect } from "react";
 
 //#region src/hooks/useWatchUserChange/useWatchUserChange.ts
@@ -82,4 +82,4 @@ const useWatchUserChange = ({ watch: watchField, onChange }) => {
 
 //#endregion
 export { useWatchUserChange as t };
-//# sourceMappingURL=useWatchUserChange-BtqaujL4.js.map
+//# sourceMappingURL=useWatchUserChange-Dj9Imxfi.js.map

package/dist/{useWatchUserChange-BtqaujL4.js.map → useWatchUserChange-Dj9Imxfi.js.map}

@@ -1 +1 @@
-{"version":3,"file":"useWatchUserChange-BtqaujL4.js","names":[],"sources":["../src/hooks/useWatchUserChange/useWatchUserChange.ts"],"sourcesContent":["import type {\n  FieldValues,\n  Path,\n  UseFormReset,\n  UseFormResetField,\n  UseFormSetValue,\n} from 'react-hook-form';\n\nimport { useEffect } from 'react';\n\nimport { useFormContext } from '../useFormContext/useFormContext';\n\nexport interface UseWatchUserChangeOptions<TFieldValues extends FieldValues> {\n  /** Field name to watch for user changes */\n  watch: Path<TFieldValues>;\n  /**\n   * Callback when watched field is changed by user input.\n   * Receives the new value and form helpers (setValue, resetField, reset).\n   */\n  onChange: (\n    value: unknown,\n    helpers: {\n      setValue: UseFormSetValue<TFieldValues>;\n      resetField: UseFormResetField<TFieldValues>;\n      reset: UseFormReset<TFieldValues>;\n    },\n  ) => void;\n}\n\n/**\n * Hook that watches for user changes on a specific form field.\n *\n * Only triggers on manual user input (typing, clicking, selecting),\n * NOT on programmatic changes like form.reset() or form.setValue().\n * Also does NOT trigger when selecting the same value (e.g., clicking\n * an already-selected option in a Select).\n *\n * This hook subscribes to field changes at the source (useController),\n * ensuring immediate and accurate detection of user interactions.\n *\n * Use cases:\n * - Reset dependent fields when parent field changes\n * - Set mode-specific default values when a toggle changes\n * - Clear form sections based on user selections\n * - Trigger side effects only on user interaction\n *\n * Note: To watch multiple fields, call this hook multiple times.\n *\n * @example\n * ```tsx\n * // Reset city and address when user changes country\n * useWatchUserChange({\n *   watch: 'country',\n *   onChange: (value, { resetField }) => {\n *     resetField('city');\n *     resetField('address');\n *   },\n * });\n *\n * // Set defaults when user changes payment method\n * useWatchUserChange({\n *   watch: 'paymentMethod',\n *   onChange: (value, { setValue }) => {\n *     if (value === 'credit') {\n *       setValue('installments', 3);\n *     } else {\n *       setValue('installments', 1);\n *     }\n *   },\n * });\n *\n * // Watch multiple fields by calling the hook multiple times\n * useWatchUserChange({\n *   watch: 'category',\n *   onChange: (value, { resetField }) => {\n *     resetField('productId');\n *   },\n * });\n * useWatchUserChange({\n *   watch: 'brand',\n *   onChange: (value, { resetField }) => {\n *     resetField('productId');\n *   },\n * });\n * ```\n */\nexport const useWatchUserChange = <\n  TFieldValues extends FieldValues = FieldValues,\n>({\n  watch: watchField,\n  onChange,\n}: UseWatchUserChangeOptions<TFieldValues>) => {\n  const { setValue, resetField, reset, userChange } =\n    useFormContext<TFieldValues>();\n\n  useEffect(() => {\n    // Create listener that checks if changed field is the one we're watching\n    const listener = (fieldName: Path<TFieldValues>, value: unknown) => {\n      // Check if this is the field we're watching\n      if (fieldName === watchField) {\n        // Call the onChange callback with helpers\n        onChange(value, { setValue, resetField, reset });\n      }\n    };\n\n    // Subscribe to user changes\n    const unsubscribe = userChange.subscribe(listener);\n\n    // Cleanup on unmount\n    return unsubscribe;\n  }, [watchField, onChange, setValue, resetField, reset, userChange]);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsFA,MAAa,sBAEX,EACA,OAAO,YACP,eAC6C;CAC7C,MAAM,EAAE,UAAU,YAAY,OAAO,eACnC,gBAA8B;AAEhC,iBAAgB;EAEd,MAAM,YAAY,WAA+B,UAAmB;AAElE,OAAI,cAAc,WAEhB,UAAS,OAAO;IAAE;IAAU;IAAY;IAAO,CAAC;;AAQpD,SAHoB,WAAW,UAAU,SAAS;IAIjD;EAAC;EAAY;EAAU;EAAU;EAAY;EAAO;EAAW,CAAC"}
+{"version":3,"file":"useWatchUserChange-Dj9Imxfi.js","names":[],"sources":["../src/hooks/useWatchUserChange/useWatchUserChange.ts"],"sourcesContent":["import type {\n  FieldValues,\n  Path,\n  UseFormReset,\n  UseFormResetField,\n  UseFormSetValue,\n} from 'react-hook-form';\n\nimport { useEffect } from 'react';\n\nimport { useFormContext } from '../useFormContext/useFormContext';\n\nexport interface UseWatchUserChangeOptions<TFieldValues extends FieldValues> {\n  /** Field name to watch for user changes */\n  watch: Path<TFieldValues>;\n  /**\n   * Callback when watched field is changed by user input.\n   * Receives the new value and form helpers (setValue, resetField, reset).\n   */\n  onChange: (\n    value: unknown,\n    helpers: {\n      setValue: UseFormSetValue<TFieldValues>;\n      resetField: UseFormResetField<TFieldValues>;\n      reset: UseFormReset<TFieldValues>;\n    },\n  ) => void;\n}\n\n/**\n * Hook that watches for user changes on a specific form field.\n *\n * Only triggers on manual user input (typing, clicking, selecting),\n * NOT on programmatic changes like form.reset() or form.setValue().\n * Also does NOT trigger when selecting the same value (e.g., clicking\n * an already-selected option in a Select).\n *\n * This hook subscribes to field changes at the source (useController),\n * ensuring immediate and accurate detection of user interactions.\n *\n * Use cases:\n * - Reset dependent fields when parent field changes\n * - Set mode-specific default values when a toggle changes\n * - Clear form sections based on user selections\n * - Trigger side effects only on user interaction\n *\n * Note: To watch multiple fields, call this hook multiple times.\n *\n * @example\n * ```tsx\n * // Reset city and address when user changes country\n * useWatchUserChange({\n *   watch: 'country',\n *   onChange: (value, { resetField }) => {\n *     resetField('city');\n *     resetField('address');\n *   },\n * });\n *\n * // Set defaults when user changes payment method\n * useWatchUserChange({\n *   watch: 'paymentMethod',\n *   onChange: (value, { setValue }) => {\n *     if (value === 'credit') {\n *       setValue('installments', 3);\n *     } else {\n *       setValue('installments', 1);\n *     }\n *   },\n * });\n *\n * // Watch multiple fields by calling the hook multiple times\n * useWatchUserChange({\n *   watch: 'category',\n *   onChange: (value, { resetField }) => {\n *     resetField('productId');\n *   },\n * });\n * useWatchUserChange({\n *   watch: 'brand',\n *   onChange: (value, { resetField }) => {\n *     resetField('productId');\n *   },\n * });\n * ```\n */\nexport const useWatchUserChange = <\n  TFieldValues extends FieldValues = FieldValues,\n>({\n  watch: watchField,\n  onChange,\n}: UseWatchUserChangeOptions<TFieldValues>) => {\n  const { setValue, resetField, reset, userChange } =\n    useFormContext<TFieldValues>();\n\n  useEffect(() => {\n    // Create listener that checks if changed field is the one we're watching\n    const listener = (fieldName: Path<TFieldValues>, value: unknown) => {\n      // Check if this is the field we're watching\n      if (fieldName === watchField) {\n        // Call the onChange callback with helpers\n        onChange(value, { setValue, resetField, reset });\n      }\n    };\n\n    // Subscribe to user changes\n    const unsubscribe = userChange.subscribe(listener);\n\n    // Cleanup on unmount\n    return unsubscribe;\n  }, [watchField, onChange, setValue, resetField, reset, userChange]);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsFA,MAAa,sBAEX,EACA,OAAO,YACP,eAC6C;CAC7C,MAAM,EAAE,UAAU,YAAY,OAAO,eACnC,gBAA8B;AAEhC,iBAAgB;EAEd,MAAM,YAAY,WAA+B,UAAmB;AAElE,OAAI,cAAc,WAEhB,UAAS,OAAO;IAAE;IAAU;IAAY;IAAO,CAAC;;AAQpD,SAHoB,WAAW,UAAU,SAAS;IAIjD;EAAC;EAAY;EAAU;EAAU;EAAY;EAAO;EAAW,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuf-stack/uniform",
-  "version": "1.17.1",
+  "version": "1.18.1",
   "description": "fuf react form library",
   "author": "Fröhlich ∧ Frei",
   "homepage": "https://github.com/fuf-stack/pixels#readme",
@@ -153,9 +153,9 @@
     "@dnd-kit/modifiers": "9.0.0",
     "@dnd-kit/sortable": "10.0.0",
     "@dnd-kit/utilities": "3.2.2",
-    "@fuf-stack/pixel-motion": "1.1.3",
+    "@fuf-stack/pixel-motion": "1.1.4",
     "@fuf-stack/pixel-utils": "1.1.1",
-    "@fuf-stack/pixels": "1.7.3",
+    "@fuf-stack/pixels": "1.8.0",
     "@fuf-stack/veto": "0.13.2",
     "@heroui/button": "2.2.24",
     "@heroui/checkbox": "2.3.24",
@@ -169,17 +169,17 @@
     "@heroui/theme": "2.4.20",
     "@react-aria/visually-hidden": "3.8.29",
     "debug": "4.4.3",
-    "framer-motion": "12.27.5",
+    "framer-motion": "12.29.0",
     "react-hook-form": "7.71.1",
     "react-icons": "5.5.0",
     "react-select": "5.10.2"
   },
   "devDependencies": {
     "@types/debug": "4.1.12",
-    "@types/react": "19.2.9",
+    "@types/react": "19.2.10",
     "@types/react-dom": "19.2.3",
-    "react": "19.2.3",
-    "react-dom": "19.2.3"
+    "react": "19.2.4",
+    "react-dom": "19.2.4"
   },
-  "gitHead": "c0e4cb595596d21b06e0d04d2403114d09e0c11e"
+  "gitHead": "f7d55704ba58fa6b8355432d25e02cbc944ba1d7"
 }

package/dist/FormContext-B_3BaWao.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"FormContext-B_3BaWao.js","names":["FormProvider","HookFormProvider"],"sources":["../src/Form/subcomponents/FormResolver.ts","../src/Form/subcomponents/FormContext.tsx"],"sourcesContent":["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","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"],"mappings":"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"}

package/dist/FormContext-CeFKQmVH.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"FormContext-CeFKQmVH.cjs","names":["toValidationFormat","debug","React","toFormFormat","toValidationFormat","HookFormProvider"],"sources":["../src/Form/subcomponents/FormResolver.ts","../src/Form/subcomponents/FormContext.tsx"],"sourcesContent":["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","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"],"mappings":"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"}