@fuf-stack/uniform 1.17.0 → 1.18.0

package/dist/{useController-oCYPeezC.cjs → useController-B_SSp5Z5.cjs}

@@ -1,5 +1,5 @@
-const require_FormContext = require('./FormContext-CeFKQmVH.cjs');
-const require_helpers = require('./helpers-CncbgvW_.cjs');
+const require_FormContext = require('./FormContext-BSLO2-sO.cjs');
+const require_helpers = require('./helpers-Bd_QpqXg.cjs');
 let react = require("react");
 let react_hook_form = require("react-hook-form");
 
@@ -48,4 +48,4 @@ Object.defineProperty(exports, 'useController', {
     return useController;
   }
 });
-//# sourceMappingURL=useController-oCYPeezC.cjs.map
+//# sourceMappingURL=useController-B_SSp5Z5.cjs.map

package/dist/{useController-oCYPeezC.cjs.map → useController-B_SSp5Z5.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"useController-oCYPeezC.cjs","names":["UniformContext","toNullishString","fromNullishString"],"sources":["../src/hooks/useController/useController.ts"],"sourcesContent":["import type {\n  ControllerFieldState,\n  ControllerRenderProps,\n  UseControllerProps as RHFUseControllerProps,\n  UseFormStateReturn,\n} from 'react-hook-form';\n\nimport { useContext } from 'react';\nimport { useController as useRHFController } from 'react-hook-form';\n\nimport { UniformContext } from '../../Form/subcomponents/FormContext';\nimport { fromNullishString, toNullishString } from '../../helpers';\n\nexport type UseControllerProps<TFieldValues extends object = object> =\n  RHFUseControllerProps<TFieldValues>;\n\nexport interface UseControllerReturn<TFieldValues extends object = object> {\n  field: Omit<ControllerRenderProps<TFieldValues>, 'onChange' | 'value'> & {\n    // Using any[] to support both direct value changes and React synthetic events\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    onChange: (...event: any[]) => void;\n    value: string;\n  };\n  formState: UseFormStateReturn<TFieldValues>;\n  fieldState: ControllerFieldState;\n}\n\n/**\n * A wrapper around react-hook-form's useController that transparently handles nullish string conversions.\n *\n * Key features:\n * 1. Empty strings ('') in the UI are stored as null in form state\n * 2. Null/undefined values in form state are displayed as empty strings in the UI\n * 3. Handles both direct value changes and React synthetic events\n * 4. Maintains the same API as react-hook-form's useController\n * 5. Notifies UniformContext's userChange listeners on field changes (enables useWatchUserChange hook)\n * 6. No-op when value unchanged: onChange is ignored if the new value equals the current value\n *    (prevents unnecessary re-renders and spurious useWatchUserChange triggers)\n *\n * This enables consistent handling of empty/null values while keeping a clean API\n * for form inputs that expect string values.\n *\n * @see https://react-hook-form.com/docs/usecontroller\n */\nexport const useController = <TFieldValues extends object = object>(\n  props: UseControllerProps<TFieldValues>,\n): UseControllerReturn<TFieldValues> => {\n  const { field, formState, fieldState } = useRHFController(props);\n  const { userChange } = useContext(UniformContext);\n\n  return {\n    field: {\n      ...field,\n      // Handles both direct values (onChange(\"value\")) and events (onChange(event))\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      onChange: (...event: any[]) => {\n        const value = event[0]?.target?.value ?? event[0];\n        const formattedValue = value === '' ? '' : toNullishString(value);\n\n        // Skip if value hasn't changed (e.g., user re-selects same option)\n        // We compare formattedValue (the new value after nullish conversion) with\n        // field.value (the current stored value, also in nullish format)\n        if (formattedValue === field.value) {\n          return;\n        }\n\n        // Update form state first\n        field.onChange(formattedValue);\n\n        // Then notify userChange listeners (for useWatchUserChange hook)\n        // This ensures getValues() in listeners returns the updated value\n        // Guard against undefined userChange (when used outside FormProvider)\n        // NOTE: We notify with the original value (not formattedValue) so that\n        // listeners receive the actual value (false, 0, null) instead of marker\n        // strings like '__FALSE__', '__ZERO__', '__NULL__'\n        userChange?.notify(field.name, value);\n      },\n      // Convert null/undefined to empty string for UI display\n      value: fromNullishString(field.value) as string,\n    },\n    formState,\n    fieldState,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA4CA,MAAa,iBACX,UACsC;CACtC,MAAM,EAAE,OAAO,WAAW,kDAAgC,MAAM;CAChE,MAAM,EAAE,qCAA0BA,mCAAe;AAEjD,QAAO;EACL,OAAO;GACL,GAAG;GAGH,WAAW,GAAG,UAAiB;IAC7B,MAAM,QAAQ,MAAM,IAAI,QAAQ,SAAS,MAAM;IAC/C,MAAM,iBAAiB,UAAU,KAAK,KAAKC,gCAAgB,MAAM;AAKjE,QAAI,mBAAmB,MAAM,MAC3B;AAIF,UAAM,SAAS,eAAe;AAQ9B,gBAAY,OAAO,MAAM,MAAM,MAAM;;GAGvC,OAAOC,kCAAkB,MAAM,MAAM;GACtC;EACD;EACA;EACD"}
+{"version":3,"file":"useController-B_SSp5Z5.cjs","names":["UniformContext","toNullishString","fromNullishString"],"sources":["../src/hooks/useController/useController.ts"],"sourcesContent":["import type {\n  ControllerFieldState,\n  ControllerRenderProps,\n  UseControllerProps as RHFUseControllerProps,\n  UseFormStateReturn,\n} from 'react-hook-form';\n\nimport { useContext } from 'react';\nimport { useController as useRHFController } from 'react-hook-form';\n\nimport { UniformContext } from '../../Form/subcomponents/FormContext';\nimport { fromNullishString, toNullishString } from '../../helpers';\n\nexport type UseControllerProps<TFieldValues extends object = object> =\n  RHFUseControllerProps<TFieldValues>;\n\nexport interface UseControllerReturn<TFieldValues extends object = object> {\n  field: Omit<ControllerRenderProps<TFieldValues>, 'onChange' | 'value'> & {\n    // Using any[] to support both direct value changes and React synthetic events\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    onChange: (...event: any[]) => void;\n    value: string;\n  };\n  formState: UseFormStateReturn<TFieldValues>;\n  fieldState: ControllerFieldState;\n}\n\n/**\n * A wrapper around react-hook-form's useController that transparently handles nullish string conversions.\n *\n * Key features:\n * 1. Empty strings ('') in the UI are stored as null in form state\n * 2. Null/undefined values in form state are displayed as empty strings in the UI\n * 3. Handles both direct value changes and React synthetic events\n * 4. Maintains the same API as react-hook-form's useController\n * 5. Notifies UniformContext's userChange listeners on field changes (enables useWatchUserChange hook)\n * 6. No-op when value unchanged: onChange is ignored if the new value equals the current value\n *    (prevents unnecessary re-renders and spurious useWatchUserChange triggers)\n *\n * This enables consistent handling of empty/null values while keeping a clean API\n * for form inputs that expect string values.\n *\n * @see https://react-hook-form.com/docs/usecontroller\n */\nexport const useController = <TFieldValues extends object = object>(\n  props: UseControllerProps<TFieldValues>,\n): UseControllerReturn<TFieldValues> => {\n  const { field, formState, fieldState } = useRHFController(props);\n  const { userChange } = useContext(UniformContext);\n\n  return {\n    field: {\n      ...field,\n      // Handles both direct values (onChange(\"value\")) and events (onChange(event))\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      onChange: (...event: any[]) => {\n        const value = event[0]?.target?.value ?? event[0];\n        const formattedValue = value === '' ? '' : toNullishString(value);\n\n        // Skip if value hasn't changed (e.g., user re-selects same option)\n        // We compare formattedValue (the new value after nullish conversion) with\n        // field.value (the current stored value, also in nullish format)\n        if (formattedValue === field.value) {\n          return;\n        }\n\n        // Update form state first\n        field.onChange(formattedValue);\n\n        // Then notify userChange listeners (for useWatchUserChange hook)\n        // This ensures getValues() in listeners returns the updated value\n        // Guard against undefined userChange (when used outside FormProvider)\n        // NOTE: We notify with the original value (not formattedValue) so that\n        // listeners receive the actual value (false, 0, null) instead of marker\n        // strings like '__FALSE__', '__ZERO__', '__NULL__'\n        userChange?.notify(field.name, value);\n      },\n      // Convert null/undefined to empty string for UI display\n      value: fromNullishString(field.value) as string,\n    },\n    formState,\n    fieldState,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA4CA,MAAa,iBACX,UACsC;CACtC,MAAM,EAAE,OAAO,WAAW,kDAAgC,MAAM;CAChE,MAAM,EAAE,qCAA0BA,mCAAe;AAEjD,QAAO;EACL,OAAO;GACL,GAAG;GAGH,WAAW,GAAG,UAAiB;IAC7B,MAAM,QAAQ,MAAM,IAAI,QAAQ,SAAS,MAAM;IAC/C,MAAM,iBAAiB,UAAU,KAAK,KAAKC,gCAAgB,MAAM;AAKjE,QAAI,mBAAmB,MAAM,MAC3B;AAIF,UAAM,SAAS,eAAe;AAQ9B,gBAAY,OAAO,MAAM,MAAM,MAAM;;GAGvC,OAAOC,kCAAkB,MAAM,MAAM;GACtC;EACD;EACA;EACD"}

package/dist/{useController-C6Pg9T_3.d.cts → useController-CvPWE2Sy.d.cts}

@@ -30,4 +30,4 @@ interface UseControllerReturn<TFieldValues extends object = object> {
 declare const useController: <TFieldValues extends object = object>(props: UseControllerProps$1<TFieldValues>) => UseControllerReturn<TFieldValues>;
 //#endregion
 export { UseControllerReturn as n, useController as r, UseControllerProps$1 as t };
-//# sourceMappingURL=useController-C6Pg9T_3.d.cts.map
+//# sourceMappingURL=useController-CvPWE2Sy.d.cts.map

package/dist/useController-CvPWE2Sy.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useController-CvPWE2Sy.d.cts","names":[],"sources":["../src/hooks/useController/useController.ts"],"mappings":";;;KAaY,oBAAA,yCACV,kBAAA,CAAsB,YAAA;AAAA,UAEP,mBAAA;EACf,KAAA,EAAO,IAAA,CAAK,qBAAA,CAAsB,YAAA;IAGhC,QAAA,MAAc,KAAA;IACd,KAAA;EAAA;EAEF,SAAA,EAAW,kBAAA,CAAmB,YAAA;EAC9B,UAAA,EAAY,oBAAA;AAAA;;;AARd;;;;;;;;;;;;;;;cA4Ba,aAAA,yCACX,KAAA,EAAO,oBAAA,CAAmB,YAAA,MACzB,mBAAA,CAAoB,YAAA"}

package/dist/{useController-BJ2SBdky.d.ts → useController-DfiNbuEz.d.ts}

@@ -30,4 +30,4 @@ interface UseControllerReturn<TFieldValues extends object = object> {
 declare const useController$1: <TFieldValues extends object = object>(props: UseControllerProps$1<TFieldValues>) => UseControllerReturn<TFieldValues>;
 //#endregion
 export { UseControllerReturn as n, useController$1 as r, UseControllerProps$1 as t };
-//# sourceMappingURL=useController-BJ2SBdky.d.ts.map
+//# sourceMappingURL=useController-DfiNbuEz.d.ts.map

package/dist/useController-DfiNbuEz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useController-DfiNbuEz.d.ts","names":[],"sources":["../src/hooks/useController/useController.ts"],"mappings":";;;KAaY,oBAAA,yCACV,kBAAA,CAAsB,YAAA;AAAA,UAEP,mBAAA;EACf,KAAA,EAAO,IAAA,CAAK,qBAAA,CAAsB,YAAA;IAGhC,QAAA,MAAc,KAAA;IACd,KAAA;EAAA;EAEF,SAAA,EAAW,kBAAA,CAAmB,YAAA;EAC9B,UAAA,EAAY,oBAAA;AAAA;;;AARd;;;;;;;;;;;;;;;cA4Ba,eAAA,yCACX,KAAA,EAAO,oBAAA,CAAmB,YAAA,MACzB,mBAAA,CAAoB,YAAA"}

package/dist/{useController-QcOl0O0v.js → useController-NjuthTyL.js}

@@ -1,5 +1,5 @@
-import { n as fromNullishString, o as toNullishString } from "./helpers-D3A5d3M1.js";
-import { n as UniformContext } from "./FormContext-DHYlCZ2u.js";
+import { n as fromNullishString, o as toNullishString } from "./helpers-33jajRcN.js";
+import { n as UniformContext } from "./FormContext-kE3YKhp_.js";
 import { useContext } from "react";
 import { useController } from "react-hook-form";
 
@@ -43,4 +43,4 @@ const useController$1 = (props) => {
 
 //#endregion
 export { useController$1 as t };
-//# sourceMappingURL=useController-QcOl0O0v.js.map
+//# sourceMappingURL=useController-NjuthTyL.js.map

package/dist/{useController-QcOl0O0v.js.map → useController-NjuthTyL.js.map}

@@ -1 +1 @@
-{"version":3,"file":"useController-QcOl0O0v.js","names":["useController","useRHFController"],"sources":["../src/hooks/useController/useController.ts"],"sourcesContent":["import type {\n  ControllerFieldState,\n  ControllerRenderProps,\n  UseControllerProps as RHFUseControllerProps,\n  UseFormStateReturn,\n} from 'react-hook-form';\n\nimport { useContext } from 'react';\nimport { useController as useRHFController } from 'react-hook-form';\n\nimport { UniformContext } from '../../Form/subcomponents/FormContext';\nimport { fromNullishString, toNullishString } from '../../helpers';\n\nexport type UseControllerProps<TFieldValues extends object = object> =\n  RHFUseControllerProps<TFieldValues>;\n\nexport interface UseControllerReturn<TFieldValues extends object = object> {\n  field: Omit<ControllerRenderProps<TFieldValues>, 'onChange' | 'value'> & {\n    // Using any[] to support both direct value changes and React synthetic events\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    onChange: (...event: any[]) => void;\n    value: string;\n  };\n  formState: UseFormStateReturn<TFieldValues>;\n  fieldState: ControllerFieldState;\n}\n\n/**\n * A wrapper around react-hook-form's useController that transparently handles nullish string conversions.\n *\n * Key features:\n * 1. Empty strings ('') in the UI are stored as null in form state\n * 2. Null/undefined values in form state are displayed as empty strings in the UI\n * 3. Handles both direct value changes and React synthetic events\n * 4. Maintains the same API as react-hook-form's useController\n * 5. Notifies UniformContext's userChange listeners on field changes (enables useWatchUserChange hook)\n * 6. No-op when value unchanged: onChange is ignored if the new value equals the current value\n *    (prevents unnecessary re-renders and spurious useWatchUserChange triggers)\n *\n * This enables consistent handling of empty/null values while keeping a clean API\n * for form inputs that expect string values.\n *\n * @see https://react-hook-form.com/docs/usecontroller\n */\nexport const useController = <TFieldValues extends object = object>(\n  props: UseControllerProps<TFieldValues>,\n): UseControllerReturn<TFieldValues> => {\n  const { field, formState, fieldState } = useRHFController(props);\n  const { userChange } = useContext(UniformContext);\n\n  return {\n    field: {\n      ...field,\n      // Handles both direct values (onChange(\"value\")) and events (onChange(event))\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      onChange: (...event: any[]) => {\n        const value = event[0]?.target?.value ?? event[0];\n        const formattedValue = value === '' ? '' : toNullishString(value);\n\n        // Skip if value hasn't changed (e.g., user re-selects same option)\n        // We compare formattedValue (the new value after nullish conversion) with\n        // field.value (the current stored value, also in nullish format)\n        if (formattedValue === field.value) {\n          return;\n        }\n\n        // Update form state first\n        field.onChange(formattedValue);\n\n        // Then notify userChange listeners (for useWatchUserChange hook)\n        // This ensures getValues() in listeners returns the updated value\n        // Guard against undefined userChange (when used outside FormProvider)\n        // NOTE: We notify with the original value (not formattedValue) so that\n        // listeners receive the actual value (false, 0, null) instead of marker\n        // strings like '__FALSE__', '__ZERO__', '__NULL__'\n        userChange?.notify(field.name, value);\n      },\n      // Convert null/undefined to empty string for UI display\n      value: fromNullishString(field.value) as string,\n    },\n    formState,\n    fieldState,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA4CA,MAAaA,mBACX,UACsC;CACtC,MAAM,EAAE,OAAO,WAAW,eAAeC,cAAiB,MAAM;CAChE,MAAM,EAAE,eAAe,WAAW,eAAe;AAEjD,QAAO;EACL,OAAO;GACL,GAAG;GAGH,WAAW,GAAG,UAAiB;IAC7B,MAAM,QAAQ,MAAM,IAAI,QAAQ,SAAS,MAAM;IAC/C,MAAM,iBAAiB,UAAU,KAAK,KAAK,gBAAgB,MAAM;AAKjE,QAAI,mBAAmB,MAAM,MAC3B;AAIF,UAAM,SAAS,eAAe;AAQ9B,gBAAY,OAAO,MAAM,MAAM,MAAM;;GAGvC,OAAO,kBAAkB,MAAM,MAAM;GACtC;EACD;EACA;EACD"}
+{"version":3,"file":"useController-NjuthTyL.js","names":["useController","useRHFController"],"sources":["../src/hooks/useController/useController.ts"],"sourcesContent":["import type {\n  ControllerFieldState,\n  ControllerRenderProps,\n  UseControllerProps as RHFUseControllerProps,\n  UseFormStateReturn,\n} from 'react-hook-form';\n\nimport { useContext } from 'react';\nimport { useController as useRHFController } from 'react-hook-form';\n\nimport { UniformContext } from '../../Form/subcomponents/FormContext';\nimport { fromNullishString, toNullishString } from '../../helpers';\n\nexport type UseControllerProps<TFieldValues extends object = object> =\n  RHFUseControllerProps<TFieldValues>;\n\nexport interface UseControllerReturn<TFieldValues extends object = object> {\n  field: Omit<ControllerRenderProps<TFieldValues>, 'onChange' | 'value'> & {\n    // Using any[] to support both direct value changes and React synthetic events\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    onChange: (...event: any[]) => void;\n    value: string;\n  };\n  formState: UseFormStateReturn<TFieldValues>;\n  fieldState: ControllerFieldState;\n}\n\n/**\n * A wrapper around react-hook-form's useController that transparently handles nullish string conversions.\n *\n * Key features:\n * 1. Empty strings ('') in the UI are stored as null in form state\n * 2. Null/undefined values in form state are displayed as empty strings in the UI\n * 3. Handles both direct value changes and React synthetic events\n * 4. Maintains the same API as react-hook-form's useController\n * 5. Notifies UniformContext's userChange listeners on field changes (enables useWatchUserChange hook)\n * 6. No-op when value unchanged: onChange is ignored if the new value equals the current value\n *    (prevents unnecessary re-renders and spurious useWatchUserChange triggers)\n *\n * This enables consistent handling of empty/null values while keeping a clean API\n * for form inputs that expect string values.\n *\n * @see https://react-hook-form.com/docs/usecontroller\n */\nexport const useController = <TFieldValues extends object = object>(\n  props: UseControllerProps<TFieldValues>,\n): UseControllerReturn<TFieldValues> => {\n  const { field, formState, fieldState } = useRHFController(props);\n  const { userChange } = useContext(UniformContext);\n\n  return {\n    field: {\n      ...field,\n      // Handles both direct values (onChange(\"value\")) and events (onChange(event))\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      onChange: (...event: any[]) => {\n        const value = event[0]?.target?.value ?? event[0];\n        const formattedValue = value === '' ? '' : toNullishString(value);\n\n        // Skip if value hasn't changed (e.g., user re-selects same option)\n        // We compare formattedValue (the new value after nullish conversion) with\n        // field.value (the current stored value, also in nullish format)\n        if (formattedValue === field.value) {\n          return;\n        }\n\n        // Update form state first\n        field.onChange(formattedValue);\n\n        // Then notify userChange listeners (for useWatchUserChange hook)\n        // This ensures getValues() in listeners returns the updated value\n        // Guard against undefined userChange (when used outside FormProvider)\n        // NOTE: We notify with the original value (not formattedValue) so that\n        // listeners receive the actual value (false, 0, null) instead of marker\n        // strings like '__FALSE__', '__ZERO__', '__NULL__'\n        userChange?.notify(field.name, value);\n      },\n      // Convert null/undefined to empty string for UI display\n      value: fromNullishString(field.value) as string,\n    },\n    formState,\n    fieldState,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA4CA,MAAaA,mBACX,UACsC;CACtC,MAAM,EAAE,OAAO,WAAW,eAAeC,cAAiB,MAAM;CAChE,MAAM,EAAE,eAAe,WAAW,eAAe;AAEjD,QAAO;EACL,OAAO;GACL,GAAG;GAGH,WAAW,GAAG,UAAiB;IAC7B,MAAM,QAAQ,MAAM,IAAI,QAAQ,SAAS,MAAM;IAC/C,MAAM,iBAAiB,UAAU,KAAK,KAAK,gBAAgB,MAAM;AAKjE,QAAI,mBAAmB,MAAM,MAC3B;AAIF,UAAM,SAAS,eAAe;AAQ9B,gBAAY,OAAO,MAAM,MAAM,MAAM;;GAGvC,OAAO,kBAAkB,MAAM,MAAM;GACtC;EACD;EACA;EACD"}

package/dist/{useFormContext-B2TS6xq0.d.ts → useFormContext-C6OOtqZ5.d.ts}

@@ -1,6 +1,6 @@
-import { n as UserChangeListener, t as DebugModeSettings } from "./FormContext-C2_WMi_v.js";
+import { n as UserChangeListener, t as DebugModeSettings } from "./FormContext-CCe8drkp.js";
 import * as react0 from "react";
-import * as react_hook_form9 from "react-hook-form";
+import * as react_hook_form0 from "react-hook-form";
 import { FieldError, FieldValues, Path } from "react-hook-form";
 import * as _fuf_stack_veto0 from "@fuf-stack/veto";
 import { VetoFormattedError, VetoInstance } from "@fuf-stack/veto";
@@ -19,7 +19,7 @@ declare const checkFieldIsRequired: (validation: VetoInstance, path: string[]) =
  *   - Filters out empty/null values
  */
 declare const useFormContext$1: <TFieldValues extends FieldValues = FieldValues, TContext = any, TTransformedValues = TFieldValues>() => {
-  formState: react_hook_form9.FormState<TFieldValues>;
+  formState: react_hook_form0.FormState<TFieldValues>;
   getFieldState: (name: Path<TFieldValues>, testId?: string) => {
     error: FieldError[] | undefined;
     invalid: boolean;
@@ -29,9 +29,9 @@ declare const useFormContext$1: <TFieldValues extends FieldValues = FieldValues,
     isTouched: boolean;
     isValidating: boolean;
   };
-  getValues: react_hook_form9.UseFormGetValues<TFieldValues>;
-  subscribe: react_hook_form9.UseFormSubscribe<TFieldValues>;
-  watch: react_hook_form9.UseFormWatch<TFieldValues>;
+  getValues: react_hook_form0.UseFormGetValues<TFieldValues>;
+  subscribe: react_hook_form0.UseFormSubscribe<TFieldValues>;
+  watch: react_hook_form0.UseFormWatch<TFieldValues>;
   debugMode: "disabled" | "debug" | "debug-testids" | "off";
   debugModeSettings?: DebugModeSettings;
   preventSubmit: (prevent: boolean) => void;
@@ -47,18 +47,18 @@ declare const useFormContext$1: <TFieldValues extends FieldValues = FieldValues,
     errors?: VetoFormattedError;
     setClientValidationSchema: (key: string, schema: _fuf_stack_veto0.VetoTypeAny | null) => void;
   };
-  setError: react_hook_form9.UseFormSetError<TFieldValues>;
-  clearErrors: react_hook_form9.UseFormClearErrors<TFieldValues>;
-  setValue: react_hook_form9.UseFormSetValue<TFieldValues>;
-  trigger: react_hook_form9.UseFormTrigger<TFieldValues>;
-  resetField: react_hook_form9.UseFormResetField<TFieldValues>;
-  reset: react_hook_form9.UseFormReset<TFieldValues>;
-  handleSubmit: react_hook_form9.UseFormHandleSubmit<TFieldValues, TTransformedValues>;
-  unregister: react_hook_form9.UseFormUnregister<TFieldValues>;
-  control: react_hook_form9.Control<TFieldValues, TContext, TTransformedValues>;
-  register: react_hook_form9.UseFormRegister<TFieldValues>;
-  setFocus: react_hook_form9.UseFormSetFocus<TFieldValues>;
+  setError: react_hook_form0.UseFormSetError<TFieldValues>;
+  clearErrors: react_hook_form0.UseFormClearErrors<TFieldValues>;
+  setValue: react_hook_form0.UseFormSetValue<TFieldValues>;
+  trigger: react_hook_form0.UseFormTrigger<TFieldValues>;
+  resetField: react_hook_form0.UseFormResetField<TFieldValues>;
+  reset: react_hook_form0.UseFormReset<TFieldValues>;
+  handleSubmit: react_hook_form0.UseFormHandleSubmit<TFieldValues, TTransformedValues>;
+  unregister: react_hook_form0.UseFormUnregister<TFieldValues>;
+  control: react_hook_form0.Control<TFieldValues, TContext, TTransformedValues>;
+  register: react_hook_form0.UseFormRegister<TFieldValues>;
+  setFocus: react_hook_form0.UseFormSetFocus<TFieldValues>;
 };
 //#endregion
 export { useFormContext$1 as n, checkFieldIsRequired as t };
-//# sourceMappingURL=useFormContext-B2TS6xq0.d.ts.map
+//# sourceMappingURL=useFormContext-C6OOtqZ5.d.ts.map

package/dist/useFormContext-C6OOtqZ5.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormContext-C6OOtqZ5.d.ts","names":[],"sources":["../src/hooks/useFormContext/useFormContext.ts"],"mappings":";;;;;;;;;cAYa,oBAAA,GACX,UAAA,EAAY,YAAA,EACZ,IAAA;;;;;AAFF;;;;;;cAqEa,gBAAA,wBACU,WAAA,GAAc,WAAA,uCAEd,YAAA;;wBAwBQ,IAAA,CAAK,YAAA,GAAa,MAAA;;;;;;;;;;;;;;;;6BAWf,kBAAA,KAAA,OAAA;;0BAAA,kBAAA;;;;mBAwB/B,YAAA;eAEoB,YAAA;aAAwE,kBAAA;qDAAA,gBAAA,CAAA,WAAA;EAAA"}

package/dist/{useFormContext-356X5XAY.js → useFormContext-CLymm_7t.js}

@@ -3,4 +3,4 @@
 
 //#endregion
 export {  };
-//# sourceMappingURL=useFormContext-356X5XAY.js.map
+//# sourceMappingURL=useFormContext-CLymm_7t.js.map

package/dist/{useFormContext-356X5XAY.js.map → useFormContext-CLymm_7t.js.map}

@@ -1 +1 @@
-{"version":3,"file":"useFormContext-356X5XAY.js","names":[],"sources":["../src/hooks/useFormContext/index.ts"],"sourcesContent":["/* v8 ignore start */\n\nexport * from './useFormContext';\n\n/* v8 ignore stop */\n"],"mappings":""}
+{"version":3,"file":"useFormContext-CLymm_7t.js","names":[],"sources":["../src/hooks/useFormContext/index.ts"],"sourcesContent":["/* v8 ignore start */\n\nexport * from './useFormContext';\n\n/* v8 ignore stop */\n"],"mappings":""}

package/dist/{useFormContext-n3WYgGkW.d.cts → useFormContext-Dh97YG47.d.cts}

@@ -1,8 +1,8 @@
-import { n as UserChangeListener, t as DebugModeSettings } from "./FormContext-Dl7KL_wl.cjs";
+import { n as UserChangeListener, t as DebugModeSettings } from "./FormContext-RSA21aDt.cjs";
 import * as react0 from "react";
 import * as _fuf_stack_veto0 from "@fuf-stack/veto";
 import { VetoFormattedError, VetoInstance } from "@fuf-stack/veto";
-import * as react_hook_form9 from "react-hook-form";
+import * as react_hook_form0 from "react-hook-form";
 import { FieldError, FieldValues, Path } from "react-hook-form";
 
 //#region src/hooks/useFormContext/useFormContext.d.ts
@@ -19,7 +19,7 @@ declare const checkFieldIsRequired: (validation: VetoInstance, path: string[]) =
  *   - Filters out empty/null values
  */
 declare const useFormContext: <TFieldValues extends FieldValues = FieldValues, TContext = any, TTransformedValues = TFieldValues>() => {
-  formState: react_hook_form9.FormState<TFieldValues>;
+  formState: react_hook_form0.FormState<TFieldValues>;
   getFieldState: (name: Path<TFieldValues>, testId?: string) => {
     error: FieldError[] | undefined;
     invalid: boolean;
@@ -29,9 +29,9 @@ declare const useFormContext: <TFieldValues extends FieldValues = FieldValues, T
     isTouched: boolean;
     isValidating: boolean;
   };
-  getValues: react_hook_form9.UseFormGetValues<TFieldValues>;
-  subscribe: react_hook_form9.UseFormSubscribe<TFieldValues>;
-  watch: react_hook_form9.UseFormWatch<TFieldValues>;
+  getValues: react_hook_form0.UseFormGetValues<TFieldValues>;
+  subscribe: react_hook_form0.UseFormSubscribe<TFieldValues>;
+  watch: react_hook_form0.UseFormWatch<TFieldValues>;
   debugMode: "disabled" | "debug" | "debug-testids" | "off";
   debugModeSettings?: DebugModeSettings;
   preventSubmit: (prevent: boolean) => void;
@@ -47,18 +47,18 @@ declare const useFormContext: <TFieldValues extends FieldValues = FieldValues, T
     errors?: VetoFormattedError;
     setClientValidationSchema: (key: string, schema: _fuf_stack_veto0.VetoTypeAny | null) => void;
   };
-  setError: react_hook_form9.UseFormSetError<TFieldValues>;
-  clearErrors: react_hook_form9.UseFormClearErrors<TFieldValues>;
-  setValue: react_hook_form9.UseFormSetValue<TFieldValues>;
-  trigger: react_hook_form9.UseFormTrigger<TFieldValues>;
-  resetField: react_hook_form9.UseFormResetField<TFieldValues>;
-  reset: react_hook_form9.UseFormReset<TFieldValues>;
-  handleSubmit: react_hook_form9.UseFormHandleSubmit<TFieldValues, TTransformedValues>;
-  unregister: react_hook_form9.UseFormUnregister<TFieldValues>;
-  control: react_hook_form9.Control<TFieldValues, TContext, TTransformedValues>;
-  register: react_hook_form9.UseFormRegister<TFieldValues>;
-  setFocus: react_hook_form9.UseFormSetFocus<TFieldValues>;
+  setError: react_hook_form0.UseFormSetError<TFieldValues>;
+  clearErrors: react_hook_form0.UseFormClearErrors<TFieldValues>;
+  setValue: react_hook_form0.UseFormSetValue<TFieldValues>;
+  trigger: react_hook_form0.UseFormTrigger<TFieldValues>;
+  resetField: react_hook_form0.UseFormResetField<TFieldValues>;
+  reset: react_hook_form0.UseFormReset<TFieldValues>;
+  handleSubmit: react_hook_form0.UseFormHandleSubmit<TFieldValues, TTransformedValues>;
+  unregister: react_hook_form0.UseFormUnregister<TFieldValues>;
+  control: react_hook_form0.Control<TFieldValues, TContext, TTransformedValues>;
+  register: react_hook_form0.UseFormRegister<TFieldValues>;
+  setFocus: react_hook_form0.UseFormSetFocus<TFieldValues>;
 };
 //#endregion
 export { useFormContext as n, checkFieldIsRequired as t };
-//# sourceMappingURL=useFormContext-n3WYgGkW.d.cts.map
+//# sourceMappingURL=useFormContext-Dh97YG47.d.cts.map

package/dist/useFormContext-Dh97YG47.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormContext-Dh97YG47.d.cts","names":[],"sources":["../src/hooks/useFormContext/useFormContext.ts"],"mappings":";;;;;;;;;cAYa,oBAAA,GACX,UAAA,EAAY,YAAA,EACZ,IAAA;;;;;AAFF;;;;;;cAqEa,cAAA,wBACU,WAAA,GAAc,WAAA,uCAEd,YAAA;;wBAwBQ,IAAA,CAAK,YAAA,GAAa,MAAA;;;;;;;;;;;;;;;;6BAWf,kBAAA,KAAA,OAAA;;0BAAA,kBAAA;;;;mBAwB/B,YAAA;eAEoB,YAAA;aAAwE,kBAAA;qDAAA,gBAAA,CAAA,WAAA;EAAA"}

package/dist/{useFormContext-UFBqUfOr.js → useFormContext-Di67HIf7.js}

@@ -1,5 +1,5 @@
-import { i as nameToTestId, s as toValidationFormat, t as flatArrayKey } from "./helpers-D3A5d3M1.js";
-import { n as UniformContext } from "./FormContext-DHYlCZ2u.js";
+import { c as toValidationFormat, i as nameToTestId, t as flatArrayKey } from "./helpers-33jajRcN.js";
+import { n as UniformContext } from "./FormContext-kE3YKhp_.js";
 import { useContext } from "react";
 import { useFormContext } from "react-hook-form";
 
@@ -120,4 +120,4 @@ const useFormContext$1 = () => {
 
 //#endregion
 export { useFormContext$1 as n, checkFieldIsRequired as t };
-//# sourceMappingURL=useFormContext-UFBqUfOr.js.map
+//# sourceMappingURL=useFormContext-Di67HIf7.js.map

package/dist/{useFormContext-UFBqUfOr.js.map → useFormContext-Di67HIf7.js.map}

@@ -1 +1 @@
-{"version":3,"file":"useFormContext-UFBqUfOr.js","names":["useFormContext","useHookFormContext"],"sources":["../src/hooks/useFormContext/useFormContext.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport type { VetoFormattedError, VetoInstance } from '@fuf-stack/veto';\nimport type { FieldError, FieldValues, Path } from 'react-hook-form';\n\nimport { useContext } from 'react';\nimport { useFormContext as useHookFormContext } from 'react-hook-form';\n\nimport { UniformContext } from '../../Form/subcomponents/FormContext';\nimport { flatArrayKey, nameToTestId, toValidationFormat } from '../../helpers';\n\n/** Schema check whether a field is required or optional */\nexport const checkFieldIsRequired = (\n  validation: VetoInstance,\n  path: string[],\n): boolean => {\n  // Handle flat array paths: strip the flatArrayKey to check the array element schema\n  // e.g., ['arrayField', '0', '__FLAT__'] -> check schema at ['arrayField', '0']\n  const checkPath =\n    path[path.length - 1] === flatArrayKey ? path.slice(0, -1) : path;\n\n  const checkRequired = (schema: any) => {\n    // arrays ...\n    if (schema.type === 'array') {\n      // ... if array is optional or nullable it is not required\n      if (schema.isOptional || schema.isNullable) {\n        return false;\n      }\n      // ... otherwise arrays are required (display logic wise -> no asterisk in the label)\n      return true;\n    }\n\n    // all other fields are required if they are\n    // not optional and not nullable\n    return !schema.isOptional && !schema.isNullable;\n  };\n\n  return validation.checkSchemaPath(checkRequired, checkPath);\n};\n\n/**\n * Resolve validation errors for a given field path.\n *\n * Traverses a nested `VetoFormattedError` structure using a dotted path\n * (for example: \"user.address.0.street\") and returns the matching\n * `FieldError[]` if present. If no error exists at the path, returns\n * `undefined`.\n *\n * @param errors - The formatted validation errors from Uniform's context\n * @param name - The dotted field path to resolve\n * @returns An array of `FieldError` entries for the field, or `undefined`\n */\nconst getValidationErrorsByName = (\n  errors: VetoFormattedError,\n  name: string,\n) => {\n  // Traverse nested error structure; ignore flat array wrapper key\n  const keys = name.split('.').filter((k) => {\n    return k !== flatArrayKey;\n  });\n  let current: unknown = errors as unknown;\n  keys.forEach((key) => {\n    if (current && typeof current === 'object') {\n      current = (current as Record<string, unknown>)[key];\n    } else {\n      current = undefined;\n    }\n  });\n  return current as FieldError[] | undefined;\n};\n\n/**\n * Custom hook that extends react-hook-form's useFormContext to add validation and state management.\n *\n * Key features:\n * - Enhanced `getFieldState` that includes validation schema-based \"required\" status and testId generation\n * - Automatic conversion of form values via `getValues`, `watch`, and `subscribe`:\n *   - Unwraps flat array wrappers (`{ __FLAT__: value }` → `value`)\n *   - Converts nullish string markers (`__NULL__` → `null`, `__FALSE__` → `false`, `__ZERO__` → `0`)\n *   - Filters out empty/null values\n */\nexport const useFormContext = <\n  TFieldValues extends FieldValues = FieldValues,\n  TContext = any,\n  TTransformedValues = TFieldValues,\n>() => {\n  const {\n    formState,\n    // some methods that will be enhanced below\n    getFieldState: getFieldStateOrig,\n    getValues: getValuesOrig,\n    watch: watchOrig,\n    subscribe: subscribeOrig,\n    // the rest of the methods pass through unchanged\n    ...otherMethods\n  } = useHookFormContext<TFieldValues, TContext, TTransformedValues>();\n\n  const uniformContext = useContext(UniformContext);\n\n  /**\n   * Updated getFieldState method which returns:\n   * - Whether the field is required by checking the validation schema\n   * - Existing field state information (errors, etc.)\n   * - A testId generated from the field name (with flat array keys removed and slugified)\n   *\n   * @param name - The field path (string or array)\n   * @param testId - Optional explicit testId. If provided, will be slugified. If not provided, generated from name.\n   */\n  const getFieldState = (name: Path<TFieldValues>, testId?: string) => {\n    const fieldPath =\n      typeof name === 'string' ? name.replace(/\\[\\d+\\]/g, '').split('.') : name;\n\n    // Use base validation instance for checking \"required\" status\n    // Client validation often uses .nullish() which would incorrectly mark fields as optional\n    const validationInstance =\n      uniformContext?.validation.baseInstance ??\n      uniformContext?.validation.instance;\n\n    // Check if the field is required using the validation schema\n    const required = validationInstance\n      ? checkFieldIsRequired(validationInstance, fieldPath)\n      : false;\n\n    const error = getValidationErrorsByName(\n      uniformContext?.validation.errors ?? {},\n      name,\n    ) as unknown as FieldError[] | undefined;\n\n    // Get everything but the error from the original field state\n    const fieldState = getFieldStateOrig(name, formState);\n\n    return {\n      ...fieldState,\n      error,\n      invalid: !!error,\n      required,\n      testId: nameToTestId(testId ?? name),\n    };\n  };\n\n  /**\n   * Wrap form value accessor methods to automatically convert from internal storage format\n   * to component-friendly format:\n   *\n   * - Unwrap flat array wrappers: `{ __FLAT__: value }` → `value`\n   * - Convert nullish string markers: `__NULL__` → `null`, `__FALSE__` → `false`, `__ZERO__` → `0`\n   * - Filter out empty/null values: fields with converted null/empty values are removed entirely\n   *\n   * This ensures components receive clean, predictable data without needing to handle\n   * the internal nullish string conversion system or flat array wrapping manually.\n   */\n  const getValues = ((...args: any[]) => {\n    const result = (getValuesOrig as any)(...args);\n    return toValidationFormat(result);\n  }) as typeof getValuesOrig;\n\n  const watch = ((...args: any[]) => {\n    const result = (watchOrig as any)(...args);\n    return toValidationFormat(result);\n  }) as typeof watchOrig;\n\n  const subscribe = ((...args: any[]) => {\n    // For subscribe, we need to wrap the callback to convert the values property\n    const [options] = args;\n    if (options?.callback) {\n      const originalCallback = options.callback;\n      const wrappedOptions = {\n        ...options,\n        callback: (subscribeFormState: any) => {\n          // Convert the values property if it exists\n          const convertedFormState = {\n            ...subscribeFormState,\n            ...(subscribeFormState.values && {\n              values: toValidationFormat(subscribeFormState.values),\n            }),\n          };\n          // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n          return originalCallback(convertedFormState);\n        },\n      };\n      return subscribeOrig(wrappedOptions);\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return (subscribeOrig as any)(...args);\n  }) as typeof subscribeOrig;\n\n  return {\n    ...otherMethods,\n    ...uniformContext,\n    formState,\n    getFieldState,\n    getValues,\n    subscribe,\n    watch,\n  };\n};\n"],"mappings":";;;;;;;AAYA,MAAa,wBACX,YACA,SACY;CAGZ,MAAM,YACJ,KAAK,KAAK,SAAS,OAAO,eAAe,KAAK,MAAM,GAAG,GAAG,GAAG;CAE/D,MAAM,iBAAiB,WAAgB;AAErC,MAAI,OAAO,SAAS,SAAS;AAE3B,OAAI,OAAO,cAAc,OAAO,WAC9B,QAAO;AAGT,UAAO;;AAKT,SAAO,CAAC,OAAO,cAAc,CAAC,OAAO;;AAGvC,QAAO,WAAW,gBAAgB,eAAe,UAAU;;;;;;;;;;;;;;AAe7D,MAAM,6BACJ,QACA,SACG;CAEH,MAAM,OAAO,KAAK,MAAM,IAAI,CAAC,QAAQ,MAAM;AACzC,SAAO,MAAM;GACb;CACF,IAAI,UAAmB;AACvB,MAAK,SAAS,QAAQ;AACpB,MAAI,WAAW,OAAO,YAAY,SAChC,WAAW,QAAoC;MAE/C,WAAU;GAEZ;AACF,QAAO;;;;;;;;;;;;AAaT,MAAaA,yBAIN;CACL,MAAM,EACJ,WAEA,eAAe,mBACf,WAAW,eACX,OAAO,WACP,WAAW,eAEX,GAAG,iBACDC,gBAAgE;CAEpE,MAAM,iBAAiB,WAAW,eAAe;;;;;;;;;;CAWjD,MAAM,iBAAiB,MAA0B,WAAoB;EACnE,MAAM,YACJ,OAAO,SAAS,WAAW,KAAK,QAAQ,YAAY,GAAG,CAAC,MAAM,IAAI,GAAG;EAIvE,MAAM,qBACJ,gBAAgB,WAAW,gBAC3B,gBAAgB,WAAW;EAG7B,MAAM,WAAW,qBACb,qBAAqB,oBAAoB,UAAU,GACnD;EAEJ,MAAM,QAAQ,0BACZ,gBAAgB,WAAW,UAAU,EAAE,EACvC,KACD;AAKD,SAAO;GACL,GAHiB,kBAAkB,MAAM,UAAU;GAInD;GACA,SAAS,CAAC,CAAC;GACX;GACA,QAAQ,aAAa,UAAU,KAAK;GACrC;;;;;;;;;;;;;CAcH,MAAM,cAAc,GAAG,SAAgB;AAErC,SAAO,mBADS,cAAsB,GAAG,KAAK,CACb;;CAGnC,MAAM,UAAU,GAAG,SAAgB;AAEjC,SAAO,mBADS,UAAkB,GAAG,KAAK,CACT;;CAGnC,MAAM,cAAc,GAAG,SAAgB;EAErC,MAAM,CAAC,WAAW;AAClB,MAAI,SAAS,UAAU;GACrB,MAAM,mBAAmB,QAAQ;AAejC,UAAO,cAdgB;IACrB,GAAG;IACH,WAAW,uBAA4B;AASrC,YAAO,iBAPoB;MACzB,GAAG;MACH,GAAI,mBAAmB,UAAU,EAC/B,QAAQ,mBAAmB,mBAAmB,OAAO,EACtD;MACF,CAE0C;;IAE9C,CACmC;;AAGtC,SAAQ,cAAsB,GAAG,KAAK;;AAGxC,QAAO;EACL,GAAG;EACH,GAAG;EACH;EACA;EACA;EACA;EACA;EACD"}
+{"version":3,"file":"useFormContext-Di67HIf7.js","names":["useFormContext","useHookFormContext"],"sources":["../src/hooks/useFormContext/useFormContext.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport type { VetoFormattedError, VetoInstance } from '@fuf-stack/veto';\nimport type { FieldError, FieldValues, Path } from 'react-hook-form';\n\nimport { useContext } from 'react';\nimport { useFormContext as useHookFormContext } from 'react-hook-form';\n\nimport { UniformContext } from '../../Form/subcomponents/FormContext';\nimport { flatArrayKey, nameToTestId, toValidationFormat } from '../../helpers';\n\n/** Schema check whether a field is required or optional */\nexport const checkFieldIsRequired = (\n  validation: VetoInstance,\n  path: string[],\n): boolean => {\n  // Handle flat array paths: strip the flatArrayKey to check the array element schema\n  // e.g., ['arrayField', '0', '__FLAT__'] -> check schema at ['arrayField', '0']\n  const checkPath =\n    path[path.length - 1] === flatArrayKey ? path.slice(0, -1) : path;\n\n  const checkRequired = (schema: any) => {\n    // arrays ...\n    if (schema.type === 'array') {\n      // ... if array is optional or nullable it is not required\n      if (schema.isOptional || schema.isNullable) {\n        return false;\n      }\n      // ... otherwise arrays are required (display logic wise -> no asterisk in the label)\n      return true;\n    }\n\n    // all other fields are required if they are\n    // not optional and not nullable\n    return !schema.isOptional && !schema.isNullable;\n  };\n\n  return validation.checkSchemaPath(checkRequired, checkPath);\n};\n\n/**\n * Resolve validation errors for a given field path.\n *\n * Traverses a nested `VetoFormattedError` structure using a dotted path\n * (for example: \"user.address.0.street\") and returns the matching\n * `FieldError[]` if present. If no error exists at the path, returns\n * `undefined`.\n *\n * @param errors - The formatted validation errors from Uniform's context\n * @param name - The dotted field path to resolve\n * @returns An array of `FieldError` entries for the field, or `undefined`\n */\nconst getValidationErrorsByName = (\n  errors: VetoFormattedError,\n  name: string,\n) => {\n  // Traverse nested error structure; ignore flat array wrapper key\n  const keys = name.split('.').filter((k) => {\n    return k !== flatArrayKey;\n  });\n  let current: unknown = errors as unknown;\n  keys.forEach((key) => {\n    if (current && typeof current === 'object') {\n      current = (current as Record<string, unknown>)[key];\n    } else {\n      current = undefined;\n    }\n  });\n  return current as FieldError[] | undefined;\n};\n\n/**\n * Custom hook that extends react-hook-form's useFormContext to add validation and state management.\n *\n * Key features:\n * - Enhanced `getFieldState` that includes validation schema-based \"required\" status and testId generation\n * - Automatic conversion of form values via `getValues`, `watch`, and `subscribe`:\n *   - Unwraps flat array wrappers (`{ __FLAT__: value }` → `value`)\n *   - Converts nullish string markers (`__NULL__` → `null`, `__FALSE__` → `false`, `__ZERO__` → `0`)\n *   - Filters out empty/null values\n */\nexport const useFormContext = <\n  TFieldValues extends FieldValues = FieldValues,\n  TContext = any,\n  TTransformedValues = TFieldValues,\n>() => {\n  const {\n    formState,\n    // some methods that will be enhanced below\n    getFieldState: getFieldStateOrig,\n    getValues: getValuesOrig,\n    watch: watchOrig,\n    subscribe: subscribeOrig,\n    // the rest of the methods pass through unchanged\n    ...otherMethods\n  } = useHookFormContext<TFieldValues, TContext, TTransformedValues>();\n\n  const uniformContext = useContext(UniformContext);\n\n  /**\n   * Updated getFieldState method which returns:\n   * - Whether the field is required by checking the validation schema\n   * - Existing field state information (errors, etc.)\n   * - A testId generated from the field name (with flat array keys removed and slugified)\n   *\n   * @param name - The field path (string or array)\n   * @param testId - Optional explicit testId. If provided, will be slugified. If not provided, generated from name.\n   */\n  const getFieldState = (name: Path<TFieldValues>, testId?: string) => {\n    const fieldPath =\n      typeof name === 'string' ? name.replace(/\\[\\d+\\]/g, '').split('.') : name;\n\n    // Use base validation instance for checking \"required\" status\n    // Client validation often uses .nullish() which would incorrectly mark fields as optional\n    const validationInstance =\n      uniformContext?.validation.baseInstance ??\n      uniformContext?.validation.instance;\n\n    // Check if the field is required using the validation schema\n    const required = validationInstance\n      ? checkFieldIsRequired(validationInstance, fieldPath)\n      : false;\n\n    const error = getValidationErrorsByName(\n      uniformContext?.validation.errors ?? {},\n      name,\n    ) as unknown as FieldError[] | undefined;\n\n    // Get everything but the error from the original field state\n    const fieldState = getFieldStateOrig(name, formState);\n\n    return {\n      ...fieldState,\n      error,\n      invalid: !!error,\n      required,\n      testId: nameToTestId(testId ?? name),\n    };\n  };\n\n  /**\n   * Wrap form value accessor methods to automatically convert from internal storage format\n   * to component-friendly format:\n   *\n   * - Unwrap flat array wrappers: `{ __FLAT__: value }` → `value`\n   * - Convert nullish string markers: `__NULL__` → `null`, `__FALSE__` → `false`, `__ZERO__` → `0`\n   * - Filter out empty/null values: fields with converted null/empty values are removed entirely\n   *\n   * This ensures components receive clean, predictable data without needing to handle\n   * the internal nullish string conversion system or flat array wrapping manually.\n   */\n  const getValues = ((...args: any[]) => {\n    const result = (getValuesOrig as any)(...args);\n    return toValidationFormat(result);\n  }) as typeof getValuesOrig;\n\n  const watch = ((...args: any[]) => {\n    const result = (watchOrig as any)(...args);\n    return toValidationFormat(result);\n  }) as typeof watchOrig;\n\n  const subscribe = ((...args: any[]) => {\n    // For subscribe, we need to wrap the callback to convert the values property\n    const [options] = args;\n    if (options?.callback) {\n      const originalCallback = options.callback;\n      const wrappedOptions = {\n        ...options,\n        callback: (subscribeFormState: any) => {\n          // Convert the values property if it exists\n          const convertedFormState = {\n            ...subscribeFormState,\n            ...(subscribeFormState.values && {\n              values: toValidationFormat(subscribeFormState.values),\n            }),\n          };\n          // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n          return originalCallback(convertedFormState);\n        },\n      };\n      return subscribeOrig(wrappedOptions);\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return (subscribeOrig as any)(...args);\n  }) as typeof subscribeOrig;\n\n  return {\n    ...otherMethods,\n    ...uniformContext,\n    formState,\n    getFieldState,\n    getValues,\n    subscribe,\n    watch,\n  };\n};\n"],"mappings":";;;;;;;AAYA,MAAa,wBACX,YACA,SACY;CAGZ,MAAM,YACJ,KAAK,KAAK,SAAS,OAAO,eAAe,KAAK,MAAM,GAAG,GAAG,GAAG;CAE/D,MAAM,iBAAiB,WAAgB;AAErC,MAAI,OAAO,SAAS,SAAS;AAE3B,OAAI,OAAO,cAAc,OAAO,WAC9B,QAAO;AAGT,UAAO;;AAKT,SAAO,CAAC,OAAO,cAAc,CAAC,OAAO;;AAGvC,QAAO,WAAW,gBAAgB,eAAe,UAAU;;;;;;;;;;;;;;AAe7D,MAAM,6BACJ,QACA,SACG;CAEH,MAAM,OAAO,KAAK,MAAM,IAAI,CAAC,QAAQ,MAAM;AACzC,SAAO,MAAM;GACb;CACF,IAAI,UAAmB;AACvB,MAAK,SAAS,QAAQ;AACpB,MAAI,WAAW,OAAO,YAAY,SAChC,WAAW,QAAoC;MAE/C,WAAU;GAEZ;AACF,QAAO;;;;;;;;;;;;AAaT,MAAaA,yBAIN;CACL,MAAM,EACJ,WAEA,eAAe,mBACf,WAAW,eACX,OAAO,WACP,WAAW,eAEX,GAAG,iBACDC,gBAAgE;CAEpE,MAAM,iBAAiB,WAAW,eAAe;;;;;;;;;;CAWjD,MAAM,iBAAiB,MAA0B,WAAoB;EACnE,MAAM,YACJ,OAAO,SAAS,WAAW,KAAK,QAAQ,YAAY,GAAG,CAAC,MAAM,IAAI,GAAG;EAIvE,MAAM,qBACJ,gBAAgB,WAAW,gBAC3B,gBAAgB,WAAW;EAG7B,MAAM,WAAW,qBACb,qBAAqB,oBAAoB,UAAU,GACnD;EAEJ,MAAM,QAAQ,0BACZ,gBAAgB,WAAW,UAAU,EAAE,EACvC,KACD;AAKD,SAAO;GACL,GAHiB,kBAAkB,MAAM,UAAU;GAInD;GACA,SAAS,CAAC,CAAC;GACX;GACA,QAAQ,aAAa,UAAU,KAAK;GACrC;;;;;;;;;;;;;CAcH,MAAM,cAAc,GAAG,SAAgB;AAErC,SAAO,mBADS,cAAsB,GAAG,KAAK,CACb;;CAGnC,MAAM,UAAU,GAAG,SAAgB;AAEjC,SAAO,mBADS,UAAkB,GAAG,KAAK,CACT;;CAGnC,MAAM,cAAc,GAAG,SAAgB;EAErC,MAAM,CAAC,WAAW;AAClB,MAAI,SAAS,UAAU;GACrB,MAAM,mBAAmB,QAAQ;AAejC,UAAO,cAdgB;IACrB,GAAG;IACH,WAAW,uBAA4B;AASrC,YAAO,iBAPoB;MACzB,GAAG;MACH,GAAI,mBAAmB,UAAU,EAC/B,QAAQ,mBAAmB,mBAAmB,OAAO,EACtD;MACF,CAE0C;;IAE9C,CACmC;;AAGtC,SAAQ,cAAsB,GAAG,KAAK;;AAGxC,QAAO;EACL,GAAG;EACH,GAAG;EACH;EACA;EACA;EACA;EACA;EACD"}

package/dist/{useFormContext-DJiJlfGJ.cjs → useFormContext-vdeeDsAs.cjs}

@@ -1,5 +1,5 @@
-const require_FormContext = require('./FormContext-CeFKQmVH.cjs');
-const require_helpers = require('./helpers-CncbgvW_.cjs');
+const require_FormContext = require('./FormContext-BSLO2-sO.cjs');
+const require_helpers = require('./helpers-Bd_QpqXg.cjs');
 let react = require("react");
 let react_hook_form = require("react-hook-form");
 
@@ -131,4 +131,4 @@ Object.defineProperty(exports, 'useFormContext', {
     return useFormContext;
   }
 });
-//# sourceMappingURL=useFormContext-DJiJlfGJ.cjs.map
+//# sourceMappingURL=useFormContext-vdeeDsAs.cjs.map

package/dist/{useFormContext-DJiJlfGJ.cjs.map → useFormContext-vdeeDsAs.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"useFormContext-DJiJlfGJ.cjs","names":["flatArrayKey","UniformContext","nameToTestId","toValidationFormat"],"sources":["../src/hooks/useFormContext/useFormContext.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport type { VetoFormattedError, VetoInstance } from '@fuf-stack/veto';\nimport type { FieldError, FieldValues, Path } from 'react-hook-form';\n\nimport { useContext } from 'react';\nimport { useFormContext as useHookFormContext } from 'react-hook-form';\n\nimport { UniformContext } from '../../Form/subcomponents/FormContext';\nimport { flatArrayKey, nameToTestId, toValidationFormat } from '../../helpers';\n\n/** Schema check whether a field is required or optional */\nexport const checkFieldIsRequired = (\n  validation: VetoInstance,\n  path: string[],\n): boolean => {\n  // Handle flat array paths: strip the flatArrayKey to check the array element schema\n  // e.g., ['arrayField', '0', '__FLAT__'] -> check schema at ['arrayField', '0']\n  const checkPath =\n    path[path.length - 1] === flatArrayKey ? path.slice(0, -1) : path;\n\n  const checkRequired = (schema: any) => {\n    // arrays ...\n    if (schema.type === 'array') {\n      // ... if array is optional or nullable it is not required\n      if (schema.isOptional || schema.isNullable) {\n        return false;\n      }\n      // ... otherwise arrays are required (display logic wise -> no asterisk in the label)\n      return true;\n    }\n\n    // all other fields are required if they are\n    // not optional and not nullable\n    return !schema.isOptional && !schema.isNullable;\n  };\n\n  return validation.checkSchemaPath(checkRequired, checkPath);\n};\n\n/**\n * Resolve validation errors for a given field path.\n *\n * Traverses a nested `VetoFormattedError` structure using a dotted path\n * (for example: \"user.address.0.street\") and returns the matching\n * `FieldError[]` if present. If no error exists at the path, returns\n * `undefined`.\n *\n * @param errors - The formatted validation errors from Uniform's context\n * @param name - The dotted field path to resolve\n * @returns An array of `FieldError` entries for the field, or `undefined`\n */\nconst getValidationErrorsByName = (\n  errors: VetoFormattedError,\n  name: string,\n) => {\n  // Traverse nested error structure; ignore flat array wrapper key\n  const keys = name.split('.').filter((k) => {\n    return k !== flatArrayKey;\n  });\n  let current: unknown = errors as unknown;\n  keys.forEach((key) => {\n    if (current && typeof current === 'object') {\n      current = (current as Record<string, unknown>)[key];\n    } else {\n      current = undefined;\n    }\n  });\n  return current as FieldError[] | undefined;\n};\n\n/**\n * Custom hook that extends react-hook-form's useFormContext to add validation and state management.\n *\n * Key features:\n * - Enhanced `getFieldState` that includes validation schema-based \"required\" status and testId generation\n * - Automatic conversion of form values via `getValues`, `watch`, and `subscribe`:\n *   - Unwraps flat array wrappers (`{ __FLAT__: value }` → `value`)\n *   - Converts nullish string markers (`__NULL__` → `null`, `__FALSE__` → `false`, `__ZERO__` → `0`)\n *   - Filters out empty/null values\n */\nexport const useFormContext = <\n  TFieldValues extends FieldValues = FieldValues,\n  TContext = any,\n  TTransformedValues = TFieldValues,\n>() => {\n  const {\n    formState,\n    // some methods that will be enhanced below\n    getFieldState: getFieldStateOrig,\n    getValues: getValuesOrig,\n    watch: watchOrig,\n    subscribe: subscribeOrig,\n    // the rest of the methods pass through unchanged\n    ...otherMethods\n  } = useHookFormContext<TFieldValues, TContext, TTransformedValues>();\n\n  const uniformContext = useContext(UniformContext);\n\n  /**\n   * Updated getFieldState method which returns:\n   * - Whether the field is required by checking the validation schema\n   * - Existing field state information (errors, etc.)\n   * - A testId generated from the field name (with flat array keys removed and slugified)\n   *\n   * @param name - The field path (string or array)\n   * @param testId - Optional explicit testId. If provided, will be slugified. If not provided, generated from name.\n   */\n  const getFieldState = (name: Path<TFieldValues>, testId?: string) => {\n    const fieldPath =\n      typeof name === 'string' ? name.replace(/\\[\\d+\\]/g, '').split('.') : name;\n\n    // Use base validation instance for checking \"required\" status\n    // Client validation often uses .nullish() which would incorrectly mark fields as optional\n    const validationInstance =\n      uniformContext?.validation.baseInstance ??\n      uniformContext?.validation.instance;\n\n    // Check if the field is required using the validation schema\n    const required = validationInstance\n      ? checkFieldIsRequired(validationInstance, fieldPath)\n      : false;\n\n    const error = getValidationErrorsByName(\n      uniformContext?.validation.errors ?? {},\n      name,\n    ) as unknown as FieldError[] | undefined;\n\n    // Get everything but the error from the original field state\n    const fieldState = getFieldStateOrig(name, formState);\n\n    return {\n      ...fieldState,\n      error,\n      invalid: !!error,\n      required,\n      testId: nameToTestId(testId ?? name),\n    };\n  };\n\n  /**\n   * Wrap form value accessor methods to automatically convert from internal storage format\n   * to component-friendly format:\n   *\n   * - Unwrap flat array wrappers: `{ __FLAT__: value }` → `value`\n   * - Convert nullish string markers: `__NULL__` → `null`, `__FALSE__` → `false`, `__ZERO__` → `0`\n   * - Filter out empty/null values: fields with converted null/empty values are removed entirely\n   *\n   * This ensures components receive clean, predictable data without needing to handle\n   * the internal nullish string conversion system or flat array wrapping manually.\n   */\n  const getValues = ((...args: any[]) => {\n    const result = (getValuesOrig as any)(...args);\n    return toValidationFormat(result);\n  }) as typeof getValuesOrig;\n\n  const watch = ((...args: any[]) => {\n    const result = (watchOrig as any)(...args);\n    return toValidationFormat(result);\n  }) as typeof watchOrig;\n\n  const subscribe = ((...args: any[]) => {\n    // For subscribe, we need to wrap the callback to convert the values property\n    const [options] = args;\n    if (options?.callback) {\n      const originalCallback = options.callback;\n      const wrappedOptions = {\n        ...options,\n        callback: (subscribeFormState: any) => {\n          // Convert the values property if it exists\n          const convertedFormState = {\n            ...subscribeFormState,\n            ...(subscribeFormState.values && {\n              values: toValidationFormat(subscribeFormState.values),\n            }),\n          };\n          // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n          return originalCallback(convertedFormState);\n        },\n      };\n      return subscribeOrig(wrappedOptions);\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return (subscribeOrig as any)(...args);\n  }) as typeof subscribeOrig;\n\n  return {\n    ...otherMethods,\n    ...uniformContext,\n    formState,\n    getFieldState,\n    getValues,\n    subscribe,\n    watch,\n  };\n};\n"],"mappings":";;;;;;;AAYA,MAAa,wBACX,YACA,SACY;CAGZ,MAAM,YACJ,KAAK,KAAK,SAAS,OAAOA,+BAAe,KAAK,MAAM,GAAG,GAAG,GAAG;CAE/D,MAAM,iBAAiB,WAAgB;AAErC,MAAI,OAAO,SAAS,SAAS;AAE3B,OAAI,OAAO,cAAc,OAAO,WAC9B,QAAO;AAGT,UAAO;;AAKT,SAAO,CAAC,OAAO,cAAc,CAAC,OAAO;;AAGvC,QAAO,WAAW,gBAAgB,eAAe,UAAU;;;;;;;;;;;;;;AAe7D,MAAM,6BACJ,QACA,SACG;CAEH,MAAM,OAAO,KAAK,MAAM,IAAI,CAAC,QAAQ,MAAM;AACzC,SAAO,MAAMA;GACb;CACF,IAAI,UAAmB;AACvB,MAAK,SAAS,QAAQ;AACpB,MAAI,WAAW,OAAO,YAAY,SAChC,WAAW,QAAoC;MAE/C,WAAU;GAEZ;AACF,QAAO;;;;;;;;;;;;AAaT,MAAa,uBAIN;CACL,MAAM,EACJ,WAEA,eAAe,mBACf,WAAW,eACX,OAAO,WACP,WAAW,eAEX,GAAG,sDAC+D;CAEpE,MAAM,uCAA4BC,mCAAe;;;;;;;;;;CAWjD,MAAM,iBAAiB,MAA0B,WAAoB;EACnE,MAAM,YACJ,OAAO,SAAS,WAAW,KAAK,QAAQ,YAAY,GAAG,CAAC,MAAM,IAAI,GAAG;EAIvE,MAAM,qBACJ,gBAAgB,WAAW,gBAC3B,gBAAgB,WAAW;EAG7B,MAAM,WAAW,qBACb,qBAAqB,oBAAoB,UAAU,GACnD;EAEJ,MAAM,QAAQ,0BACZ,gBAAgB,WAAW,UAAU,EAAE,EACvC,KACD;AAKD,SAAO;GACL,GAHiB,kBAAkB,MAAM,UAAU;GAInD;GACA,SAAS,CAAC,CAAC;GACX;GACA,QAAQC,6BAAa,UAAU,KAAK;GACrC;;;;;;;;;;;;;CAcH,MAAM,cAAc,GAAG,SAAgB;AAErC,SAAOC,mCADS,cAAsB,GAAG,KAAK,CACb;;CAGnC,MAAM,UAAU,GAAG,SAAgB;AAEjC,SAAOA,mCADS,UAAkB,GAAG,KAAK,CACT;;CAGnC,MAAM,cAAc,GAAG,SAAgB;EAErC,MAAM,CAAC,WAAW;AAClB,MAAI,SAAS,UAAU;GACrB,MAAM,mBAAmB,QAAQ;AAejC,UAAO,cAdgB;IACrB,GAAG;IACH,WAAW,uBAA4B;AASrC,YAAO,iBAPoB;MACzB,GAAG;MACH,GAAI,mBAAmB,UAAU,EAC/B,QAAQA,mCAAmB,mBAAmB,OAAO,EACtD;MACF,CAE0C;;IAE9C,CACmC;;AAGtC,SAAQ,cAAsB,GAAG,KAAK;;AAGxC,QAAO;EACL,GAAG;EACH,GAAG;EACH;EACA;EACA;EACA;EACA;EACD"}
+{"version":3,"file":"useFormContext-vdeeDsAs.cjs","names":["flatArrayKey","UniformContext","nameToTestId","toValidationFormat"],"sources":["../src/hooks/useFormContext/useFormContext.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport type { VetoFormattedError, VetoInstance } from '@fuf-stack/veto';\nimport type { FieldError, FieldValues, Path } from 'react-hook-form';\n\nimport { useContext } from 'react';\nimport { useFormContext as useHookFormContext } from 'react-hook-form';\n\nimport { UniformContext } from '../../Form/subcomponents/FormContext';\nimport { flatArrayKey, nameToTestId, toValidationFormat } from '../../helpers';\n\n/** Schema check whether a field is required or optional */\nexport const checkFieldIsRequired = (\n  validation: VetoInstance,\n  path: string[],\n): boolean => {\n  // Handle flat array paths: strip the flatArrayKey to check the array element schema\n  // e.g., ['arrayField', '0', '__FLAT__'] -> check schema at ['arrayField', '0']\n  const checkPath =\n    path[path.length - 1] === flatArrayKey ? path.slice(0, -1) : path;\n\n  const checkRequired = (schema: any) => {\n    // arrays ...\n    if (schema.type === 'array') {\n      // ... if array is optional or nullable it is not required\n      if (schema.isOptional || schema.isNullable) {\n        return false;\n      }\n      // ... otherwise arrays are required (display logic wise -> no asterisk in the label)\n      return true;\n    }\n\n    // all other fields are required if they are\n    // not optional and not nullable\n    return !schema.isOptional && !schema.isNullable;\n  };\n\n  return validation.checkSchemaPath(checkRequired, checkPath);\n};\n\n/**\n * Resolve validation errors for a given field path.\n *\n * Traverses a nested `VetoFormattedError` structure using a dotted path\n * (for example: \"user.address.0.street\") and returns the matching\n * `FieldError[]` if present. If no error exists at the path, returns\n * `undefined`.\n *\n * @param errors - The formatted validation errors from Uniform's context\n * @param name - The dotted field path to resolve\n * @returns An array of `FieldError` entries for the field, or `undefined`\n */\nconst getValidationErrorsByName = (\n  errors: VetoFormattedError,\n  name: string,\n) => {\n  // Traverse nested error structure; ignore flat array wrapper key\n  const keys = name.split('.').filter((k) => {\n    return k !== flatArrayKey;\n  });\n  let current: unknown = errors as unknown;\n  keys.forEach((key) => {\n    if (current && typeof current === 'object') {\n      current = (current as Record<string, unknown>)[key];\n    } else {\n      current = undefined;\n    }\n  });\n  return current as FieldError[] | undefined;\n};\n\n/**\n * Custom hook that extends react-hook-form's useFormContext to add validation and state management.\n *\n * Key features:\n * - Enhanced `getFieldState` that includes validation schema-based \"required\" status and testId generation\n * - Automatic conversion of form values via `getValues`, `watch`, and `subscribe`:\n *   - Unwraps flat array wrappers (`{ __FLAT__: value }` → `value`)\n *   - Converts nullish string markers (`__NULL__` → `null`, `__FALSE__` → `false`, `__ZERO__` → `0`)\n *   - Filters out empty/null values\n */\nexport const useFormContext = <\n  TFieldValues extends FieldValues = FieldValues,\n  TContext = any,\n  TTransformedValues = TFieldValues,\n>() => {\n  const {\n    formState,\n    // some methods that will be enhanced below\n    getFieldState: getFieldStateOrig,\n    getValues: getValuesOrig,\n    watch: watchOrig,\n    subscribe: subscribeOrig,\n    // the rest of the methods pass through unchanged\n    ...otherMethods\n  } = useHookFormContext<TFieldValues, TContext, TTransformedValues>();\n\n  const uniformContext = useContext(UniformContext);\n\n  /**\n   * Updated getFieldState method which returns:\n   * - Whether the field is required by checking the validation schema\n   * - Existing field state information (errors, etc.)\n   * - A testId generated from the field name (with flat array keys removed and slugified)\n   *\n   * @param name - The field path (string or array)\n   * @param testId - Optional explicit testId. If provided, will be slugified. If not provided, generated from name.\n   */\n  const getFieldState = (name: Path<TFieldValues>, testId?: string) => {\n    const fieldPath =\n      typeof name === 'string' ? name.replace(/\\[\\d+\\]/g, '').split('.') : name;\n\n    // Use base validation instance for checking \"required\" status\n    // Client validation often uses .nullish() which would incorrectly mark fields as optional\n    const validationInstance =\n      uniformContext?.validation.baseInstance ??\n      uniformContext?.validation.instance;\n\n    // Check if the field is required using the validation schema\n    const required = validationInstance\n      ? checkFieldIsRequired(validationInstance, fieldPath)\n      : false;\n\n    const error = getValidationErrorsByName(\n      uniformContext?.validation.errors ?? {},\n      name,\n    ) as unknown as FieldError[] | undefined;\n\n    // Get everything but the error from the original field state\n    const fieldState = getFieldStateOrig(name, formState);\n\n    return {\n      ...fieldState,\n      error,\n      invalid: !!error,\n      required,\n      testId: nameToTestId(testId ?? name),\n    };\n  };\n\n  /**\n   * Wrap form value accessor methods to automatically convert from internal storage format\n   * to component-friendly format:\n   *\n   * - Unwrap flat array wrappers: `{ __FLAT__: value }` → `value`\n   * - Convert nullish string markers: `__NULL__` → `null`, `__FALSE__` → `false`, `__ZERO__` → `0`\n   * - Filter out empty/null values: fields with converted null/empty values are removed entirely\n   *\n   * This ensures components receive clean, predictable data without needing to handle\n   * the internal nullish string conversion system or flat array wrapping manually.\n   */\n  const getValues = ((...args: any[]) => {\n    const result = (getValuesOrig as any)(...args);\n    return toValidationFormat(result);\n  }) as typeof getValuesOrig;\n\n  const watch = ((...args: any[]) => {\n    const result = (watchOrig as any)(...args);\n    return toValidationFormat(result);\n  }) as typeof watchOrig;\n\n  const subscribe = ((...args: any[]) => {\n    // For subscribe, we need to wrap the callback to convert the values property\n    const [options] = args;\n    if (options?.callback) {\n      const originalCallback = options.callback;\n      const wrappedOptions = {\n        ...options,\n        callback: (subscribeFormState: any) => {\n          // Convert the values property if it exists\n          const convertedFormState = {\n            ...subscribeFormState,\n            ...(subscribeFormState.values && {\n              values: toValidationFormat(subscribeFormState.values),\n            }),\n          };\n          // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n          return originalCallback(convertedFormState);\n        },\n      };\n      return subscribeOrig(wrappedOptions);\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return (subscribeOrig as any)(...args);\n  }) as typeof subscribeOrig;\n\n  return {\n    ...otherMethods,\n    ...uniformContext,\n    formState,\n    getFieldState,\n    getValues,\n    subscribe,\n    watch,\n  };\n};\n"],"mappings":";;;;;;;AAYA,MAAa,wBACX,YACA,SACY;CAGZ,MAAM,YACJ,KAAK,KAAK,SAAS,OAAOA,+BAAe,KAAK,MAAM,GAAG,GAAG,GAAG;CAE/D,MAAM,iBAAiB,WAAgB;AAErC,MAAI,OAAO,SAAS,SAAS;AAE3B,OAAI,OAAO,cAAc,OAAO,WAC9B,QAAO;AAGT,UAAO;;AAKT,SAAO,CAAC,OAAO,cAAc,CAAC,OAAO;;AAGvC,QAAO,WAAW,gBAAgB,eAAe,UAAU;;;;;;;;;;;;;;AAe7D,MAAM,6BACJ,QACA,SACG;CAEH,MAAM,OAAO,KAAK,MAAM,IAAI,CAAC,QAAQ,MAAM;AACzC,SAAO,MAAMA;GACb;CACF,IAAI,UAAmB;AACvB,MAAK,SAAS,QAAQ;AACpB,MAAI,WAAW,OAAO,YAAY,SAChC,WAAW,QAAoC;MAE/C,WAAU;GAEZ;AACF,QAAO;;;;;;;;;;;;AAaT,MAAa,uBAIN;CACL,MAAM,EACJ,WAEA,eAAe,mBACf,WAAW,eACX,OAAO,WACP,WAAW,eAEX,GAAG,sDAC+D;CAEpE,MAAM,uCAA4BC,mCAAe;;;;;;;;;;CAWjD,MAAM,iBAAiB,MAA0B,WAAoB;EACnE,MAAM,YACJ,OAAO,SAAS,WAAW,KAAK,QAAQ,YAAY,GAAG,CAAC,MAAM,IAAI,GAAG;EAIvE,MAAM,qBACJ,gBAAgB,WAAW,gBAC3B,gBAAgB,WAAW;EAG7B,MAAM,WAAW,qBACb,qBAAqB,oBAAoB,UAAU,GACnD;EAEJ,MAAM,QAAQ,0BACZ,gBAAgB,WAAW,UAAU,EAAE,EACvC,KACD;AAKD,SAAO;GACL,GAHiB,kBAAkB,MAAM,UAAU;GAInD;GACA,SAAS,CAAC,CAAC;GACX;GACA,QAAQC,6BAAa,UAAU,KAAK;GACrC;;;;;;;;;;;;;CAcH,MAAM,cAAc,GAAG,SAAgB;AAErC,SAAOC,mCADS,cAAsB,GAAG,KAAK,CACb;;CAGnC,MAAM,UAAU,GAAG,SAAgB;AAEjC,SAAOA,mCADS,UAAkB,GAAG,KAAK,CACT;;CAGnC,MAAM,cAAc,GAAG,SAAgB;EAErC,MAAM,CAAC,WAAW;AAClB,MAAI,SAAS,UAAU;GACrB,MAAM,mBAAmB,QAAQ;AAejC,UAAO,cAdgB;IACrB,GAAG;IACH,WAAW,uBAA4B;AASrC,YAAO,iBAPoB;MACzB,GAAG;MACH,GAAI,mBAAmB,UAAU,EAC/B,QAAQA,mCAAmB,mBAAmB,OAAO,EACtD;MACF,CAE0C;;IAE9C,CACmC;;AAGtC,SAAQ,cAAsB,GAAG,KAAK;;AAGxC,QAAO;EACL,GAAG;EACH,GAAG;EACH;EACA;EACA;EACA;EACA;EACD"}

package/dist/{useInputValueDebounce-KIKsvSLm.cjs → useInputValueDebounce-CRaM7HEM.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/useInputValueDebounce/useInputValueDebounce.ts
@@ -96,4 +96,4 @@ Object.defineProperty(exports, 'useInputValueDebounce', {
     return useInputValueDebounce;
   }
 });
-//# sourceMappingURL=useInputValueDebounce-KIKsvSLm.cjs.map
+//# sourceMappingURL=useInputValueDebounce-CRaM7HEM.cjs.map

package/dist/{useInputValueDebounce-KIKsvSLm.cjs.map → useInputValueDebounce-CRaM7HEM.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"useInputValueDebounce-KIKsvSLm.cjs","names":["useFormContext"],"sources":["../src/hooks/useInputValueDebounce/useInputValueDebounce.ts","../src/hooks/useInputValueDebounce/index.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\n\nimport { useFormContext } from '../useFormContext';\n\nexport interface UseInputValueDebounceOptions<TValue = unknown> {\n  /** Debounce delay in milliseconds (default: 300) */\n  debounceDelay?: number;\n  /** Field name for triggering validation after debounced value commits */\n  name: string;\n  /** The onBlur function to call after flushing debounced value */\n  onBlur: () => void;\n  /** The onChange function to call with debounced value */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  onChange: (...event: any[]) => void;\n  /** The field value */\n  value: TValue;\n}\n\nexport interface UseInputValueDebounceReturn<TValue = unknown> {\n  /** Enhanced onChange function with debouncing */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  onChange: (...event: any[]) => void;\n  /** Enhanced onBlur function that flushes current value immediately */\n  onBlur: () => void;\n  /** The field value that is displayed - updates immediately */\n  value: TValue;\n}\n\n/**\n * Custom hook for debouncing value changes with immediate blur support.\n *\n * Provides immediate visual feedback by updating the value instantly,\n * while debouncing the actual onChange calls. When focus is lost,\n * any pending debounced changes are immediately flushed.\n *\n * **Key Features:**\n * - **Debouncing**: Delays onChange calls until user stops typing\n * - **Generic type support**: Works with any data type (strings, numbers, arrays, objects)\n * - **Immediate value updates**: UI stays responsive during debouncing\n * - **Blur flushing**: Immediately applies pending changes on blur\n *\n * **Note:** Value transformations should be handled at the `useUniformField` level,\n * not in this hook. This hook only handles debouncing timing.\n *\n * @param options Configuration for debounced value handling\n * @param options.debounceDelay Delay in milliseconds (default: 300)\n * @param options.onBlur Function to call after flushing debounced value\n * @param options.onChange Function to call with debounced value\n * @param options.value The field value\n * @returns Object containing enhanced onChange, onBlur, and immediate value\n *\n * @example\n * Basic usage with debouncing:\n * ```tsx\n * const { onChange, onBlur, value } = useInputValueDebounce({\n *   debounceDelay: 300,\n *   name: 'fieldName',\n *   onBlur: field.onBlur,\n *   onChange: field.onChange,\n *   value: field.value,\n * });\n * ```\n */\nexport const useInputValueDebounce = <TValue = unknown>({\n  debounceDelay = 300,\n  name,\n  onBlur,\n  onChange,\n  value,\n}: UseInputValueDebounceOptions<TValue>): UseInputValueDebounceReturn<TValue> => {\n  const { trigger } = useFormContext();\n\n  // Track value for synchronous updates\n  const [currentValue, setCurrentValue] = useState<TValue>(value);\n\n  const timeoutRef = useRef<NodeJS.Timeout | null>(null);\n\n  // Sync with external value changes\n  useEffect(() => {\n    setCurrentValue(value);\n  }, [value]);\n\n  // Enhanced onChange handler with debouncing\n  const handleChange = useCallback(\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (...event: any[]) => {\n      // Extract the raw value\n      const newValue = (event[0]?.target?.value ?? event[0]) as TValue;\n      setCurrentValue(newValue);\n\n      // Clear existing timeout\n      if (timeoutRef.current) {\n        clearTimeout(timeoutRef.current);\n      }\n\n      const executeOnChange = () => {\n        // Preserve event structure if original was an event\n        if (event[0]?.target) {\n          const convertedEvent = {\n            ...event[0],\n            target: {\n              ...event[0].target,\n              value: newValue,\n            },\n          };\n          onChange(convertedEvent, ...event.slice(1));\n        } else {\n          onChange(newValue);\n        }\n        // Trigger validation after debounced value commits\n        // This ensures errors are updated immediately when field becomes valid\n        trigger(name);\n      };\n\n      // Execute immediately or after delay\n      if (debounceDelay <= 0) {\n        executeOnChange();\n      } else {\n        timeoutRef.current = setTimeout(executeOnChange, debounceDelay);\n      }\n    },\n    [onChange, debounceDelay, trigger, name],\n  );\n\n  // Enhanced blur handler\n  const handleBlur = useCallback(() => {\n    // Flush pending changes\n    if (timeoutRef.current) {\n      clearTimeout(timeoutRef.current);\n      timeoutRef.current = null;\n      onChange(currentValue);\n    }\n    onBlur();\n  }, [onChange, onBlur, currentValue]);\n\n  return {\n    onChange: handleChange,\n    onBlur: handleBlur,\n    value: currentValue,\n  };\n};\n","/* v8 ignore start */\n\nexport * from './useInputValueDebounce';\n\n/* v8 ignore stop */\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+DA,MAAa,yBAA2C,EACtD,gBAAgB,KAChB,MACA,QACA,UACA,YAC+E;CAC/E,MAAM,EAAE,YAAYA,uCAAgB;CAGpC,MAAM,CAAC,cAAc,uCAAoC,MAAM;CAE/D,MAAM,+BAA2C,KAAK;AAGtD,4BAAgB;AACd,kBAAgB,MAAM;IACrB,CAAC,MAAM,CAAC;AAuDX,QAAO;EACL,kCAnDC,GAAG,UAAiB;GAEnB,MAAM,WAAY,MAAM,IAAI,QAAQ,SAAS,MAAM;AACnD,mBAAgB,SAAS;AAGzB,OAAI,WAAW,QACb,cAAa,WAAW,QAAQ;GAGlC,MAAM,wBAAwB;AAE5B,QAAI,MAAM,IAAI,OAQZ,UAPuB;KACrB,GAAG,MAAM;KACT,QAAQ;MACN,GAAG,MAAM,GAAG;MACZ,OAAO;MACR;KACF,EACwB,GAAG,MAAM,MAAM,EAAE,CAAC;QAE3C,UAAS,SAAS;AAIpB,YAAQ,KAAK;;AAIf,OAAI,iBAAiB,EACnB,kBAAiB;OAEjB,YAAW,UAAU,WAAW,iBAAiB,cAAc;KAGnE;GAAC;GAAU;GAAe;GAAS;GAAK,CACzC;EAeC,qCAZmC;AAEnC,OAAI,WAAW,SAAS;AACtB,iBAAa,WAAW,QAAQ;AAChC,eAAW,UAAU;AACrB,aAAS,aAAa;;AAExB,WAAQ;KACP;GAAC;GAAU;GAAQ;GAAa,CAAC;EAKlC,OAAO;EACR"}
+{"version":3,"file":"useInputValueDebounce-CRaM7HEM.cjs","names":["useFormContext"],"sources":["../src/hooks/useInputValueDebounce/useInputValueDebounce.ts","../src/hooks/useInputValueDebounce/index.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\n\nimport { useFormContext } from '../useFormContext';\n\nexport interface UseInputValueDebounceOptions<TValue = unknown> {\n  /** Debounce delay in milliseconds (default: 300) */\n  debounceDelay?: number;\n  /** Field name for triggering validation after debounced value commits */\n  name: string;\n  /** The onBlur function to call after flushing debounced value */\n  onBlur: () => void;\n  /** The onChange function to call with debounced value */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  onChange: (...event: any[]) => void;\n  /** The field value */\n  value: TValue;\n}\n\nexport interface UseInputValueDebounceReturn<TValue = unknown> {\n  /** Enhanced onChange function with debouncing */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  onChange: (...event: any[]) => void;\n  /** Enhanced onBlur function that flushes current value immediately */\n  onBlur: () => void;\n  /** The field value that is displayed - updates immediately */\n  value: TValue;\n}\n\n/**\n * Custom hook for debouncing value changes with immediate blur support.\n *\n * Provides immediate visual feedback by updating the value instantly,\n * while debouncing the actual onChange calls. When focus is lost,\n * any pending debounced changes are immediately flushed.\n *\n * **Key Features:**\n * - **Debouncing**: Delays onChange calls until user stops typing\n * - **Generic type support**: Works with any data type (strings, numbers, arrays, objects)\n * - **Immediate value updates**: UI stays responsive during debouncing\n * - **Blur flushing**: Immediately applies pending changes on blur\n *\n * **Note:** Value transformations should be handled at the `useUniformField` level,\n * not in this hook. This hook only handles debouncing timing.\n *\n * @param options Configuration for debounced value handling\n * @param options.debounceDelay Delay in milliseconds (default: 300)\n * @param options.onBlur Function to call after flushing debounced value\n * @param options.onChange Function to call with debounced value\n * @param options.value The field value\n * @returns Object containing enhanced onChange, onBlur, and immediate value\n *\n * @example\n * Basic usage with debouncing:\n * ```tsx\n * const { onChange, onBlur, value } = useInputValueDebounce({\n *   debounceDelay: 300,\n *   name: 'fieldName',\n *   onBlur: field.onBlur,\n *   onChange: field.onChange,\n *   value: field.value,\n * });\n * ```\n */\nexport const useInputValueDebounce = <TValue = unknown>({\n  debounceDelay = 300,\n  name,\n  onBlur,\n  onChange,\n  value,\n}: UseInputValueDebounceOptions<TValue>): UseInputValueDebounceReturn<TValue> => {\n  const { trigger } = useFormContext();\n\n  // Track value for synchronous updates\n  const [currentValue, setCurrentValue] = useState<TValue>(value);\n\n  const timeoutRef = useRef<NodeJS.Timeout | null>(null);\n\n  // Sync with external value changes\n  useEffect(() => {\n    setCurrentValue(value);\n  }, [value]);\n\n  // Enhanced onChange handler with debouncing\n  const handleChange = useCallback(\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (...event: any[]) => {\n      // Extract the raw value\n      const newValue = (event[0]?.target?.value ?? event[0]) as TValue;\n      setCurrentValue(newValue);\n\n      // Clear existing timeout\n      if (timeoutRef.current) {\n        clearTimeout(timeoutRef.current);\n      }\n\n      const executeOnChange = () => {\n        // Preserve event structure if original was an event\n        if (event[0]?.target) {\n          const convertedEvent = {\n            ...event[0],\n            target: {\n              ...event[0].target,\n              value: newValue,\n            },\n          };\n          onChange(convertedEvent, ...event.slice(1));\n        } else {\n          onChange(newValue);\n        }\n        // Trigger validation after debounced value commits\n        // This ensures errors are updated immediately when field becomes valid\n        trigger(name);\n      };\n\n      // Execute immediately or after delay\n      if (debounceDelay <= 0) {\n        executeOnChange();\n      } else {\n        timeoutRef.current = setTimeout(executeOnChange, debounceDelay);\n      }\n    },\n    [onChange, debounceDelay, trigger, name],\n  );\n\n  // Enhanced blur handler\n  const handleBlur = useCallback(() => {\n    // Flush pending changes\n    if (timeoutRef.current) {\n      clearTimeout(timeoutRef.current);\n      timeoutRef.current = null;\n      onChange(currentValue);\n    }\n    onBlur();\n  }, [onChange, onBlur, currentValue]);\n\n  return {\n    onChange: handleChange,\n    onBlur: handleBlur,\n    value: currentValue,\n  };\n};\n","/* v8 ignore start */\n\nexport * from './useInputValueDebounce';\n\n/* v8 ignore stop */\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+DA,MAAa,yBAA2C,EACtD,gBAAgB,KAChB,MACA,QACA,UACA,YAC+E;CAC/E,MAAM,EAAE,YAAYA,uCAAgB;CAGpC,MAAM,CAAC,cAAc,uCAAoC,MAAM;CAE/D,MAAM,+BAA2C,KAAK;AAGtD,4BAAgB;AACd,kBAAgB,MAAM;IACrB,CAAC,MAAM,CAAC;AAuDX,QAAO;EACL,kCAnDC,GAAG,UAAiB;GAEnB,MAAM,WAAY,MAAM,IAAI,QAAQ,SAAS,MAAM;AACnD,mBAAgB,SAAS;AAGzB,OAAI,WAAW,QACb,cAAa,WAAW,QAAQ;GAGlC,MAAM,wBAAwB;AAE5B,QAAI,MAAM,IAAI,OAQZ,UAPuB;KACrB,GAAG,MAAM;KACT,QAAQ;MACN,GAAG,MAAM,GAAG;MACZ,OAAO;MACR;KACF,EACwB,GAAG,MAAM,MAAM,EAAE,CAAC;QAE3C,UAAS,SAAS;AAIpB,YAAQ,KAAK;;AAIf,OAAI,iBAAiB,EACnB,kBAAiB;OAEjB,YAAW,UAAU,WAAW,iBAAiB,cAAc;KAGnE;GAAC;GAAU;GAAe;GAAS;GAAK,CACzC;EAeC,qCAZmC;AAEnC,OAAI,WAAW,SAAS;AACtB,iBAAa,WAAW,QAAQ;AAChC,eAAW,UAAU;AACrB,aAAS,aAAa;;AAExB,WAAQ;KACP;GAAC;GAAU;GAAQ;GAAa,CAAC;EAKlC,OAAO;EACR"}

package/dist/{useInputValueDebounce-D9wArTKz.js → useInputValueDebounce-DJO5uzLb.js}

@@ -1,4 +1,4 @@
-import { n as useFormContext } from "./useFormContext-UFBqUfOr.js";
+import { n as useFormContext } from "./useFormContext-Di67HIf7.js";
 import { useCallback, useEffect, useRef, useState } from "react";
 
 //#region src/hooks/useInputValueDebounce/useInputValueDebounce.ts
@@ -90,4 +90,4 @@ const useInputValueDebounce = ({ debounceDelay = 300, name, onBlur, onChange, va
 
 //#endregion
 export { useInputValueDebounce as t };
-//# sourceMappingURL=useInputValueDebounce-D9wArTKz.js.map
+//# sourceMappingURL=useInputValueDebounce-DJO5uzLb.js.map

package/dist/{useInputValueDebounce-D9wArTKz.js.map → useInputValueDebounce-DJO5uzLb.js.map}

@@ -1 +1 @@
-{"version":3,"file":"useInputValueDebounce-D9wArTKz.js","names":[],"sources":["../src/hooks/useInputValueDebounce/useInputValueDebounce.ts","../src/hooks/useInputValueDebounce/index.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\n\nimport { useFormContext } from '../useFormContext';\n\nexport interface UseInputValueDebounceOptions<TValue = unknown> {\n  /** Debounce delay in milliseconds (default: 300) */\n  debounceDelay?: number;\n  /** Field name for triggering validation after debounced value commits */\n  name: string;\n  /** The onBlur function to call after flushing debounced value */\n  onBlur: () => void;\n  /** The onChange function to call with debounced value */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  onChange: (...event: any[]) => void;\n  /** The field value */\n  value: TValue;\n}\n\nexport interface UseInputValueDebounceReturn<TValue = unknown> {\n  /** Enhanced onChange function with debouncing */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  onChange: (...event: any[]) => void;\n  /** Enhanced onBlur function that flushes current value immediately */\n  onBlur: () => void;\n  /** The field value that is displayed - updates immediately */\n  value: TValue;\n}\n\n/**\n * Custom hook for debouncing value changes with immediate blur support.\n *\n * Provides immediate visual feedback by updating the value instantly,\n * while debouncing the actual onChange calls. When focus is lost,\n * any pending debounced changes are immediately flushed.\n *\n * **Key Features:**\n * - **Debouncing**: Delays onChange calls until user stops typing\n * - **Generic type support**: Works with any data type (strings, numbers, arrays, objects)\n * - **Immediate value updates**: UI stays responsive during debouncing\n * - **Blur flushing**: Immediately applies pending changes on blur\n *\n * **Note:** Value transformations should be handled at the `useUniformField` level,\n * not in this hook. This hook only handles debouncing timing.\n *\n * @param options Configuration for debounced value handling\n * @param options.debounceDelay Delay in milliseconds (default: 300)\n * @param options.onBlur Function to call after flushing debounced value\n * @param options.onChange Function to call with debounced value\n * @param options.value The field value\n * @returns Object containing enhanced onChange, onBlur, and immediate value\n *\n * @example\n * Basic usage with debouncing:\n * ```tsx\n * const { onChange, onBlur, value } = useInputValueDebounce({\n *   debounceDelay: 300,\n *   name: 'fieldName',\n *   onBlur: field.onBlur,\n *   onChange: field.onChange,\n *   value: field.value,\n * });\n * ```\n */\nexport const useInputValueDebounce = <TValue = unknown>({\n  debounceDelay = 300,\n  name,\n  onBlur,\n  onChange,\n  value,\n}: UseInputValueDebounceOptions<TValue>): UseInputValueDebounceReturn<TValue> => {\n  const { trigger } = useFormContext();\n\n  // Track value for synchronous updates\n  const [currentValue, setCurrentValue] = useState<TValue>(value);\n\n  const timeoutRef = useRef<NodeJS.Timeout | null>(null);\n\n  // Sync with external value changes\n  useEffect(() => {\n    setCurrentValue(value);\n  }, [value]);\n\n  // Enhanced onChange handler with debouncing\n  const handleChange = useCallback(\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (...event: any[]) => {\n      // Extract the raw value\n      const newValue = (event[0]?.target?.value ?? event[0]) as TValue;\n      setCurrentValue(newValue);\n\n      // Clear existing timeout\n      if (timeoutRef.current) {\n        clearTimeout(timeoutRef.current);\n      }\n\n      const executeOnChange = () => {\n        // Preserve event structure if original was an event\n        if (event[0]?.target) {\n          const convertedEvent = {\n            ...event[0],\n            target: {\n              ...event[0].target,\n              value: newValue,\n            },\n          };\n          onChange(convertedEvent, ...event.slice(1));\n        } else {\n          onChange(newValue);\n        }\n        // Trigger validation after debounced value commits\n        // This ensures errors are updated immediately when field becomes valid\n        trigger(name);\n      };\n\n      // Execute immediately or after delay\n      if (debounceDelay <= 0) {\n        executeOnChange();\n      } else {\n        timeoutRef.current = setTimeout(executeOnChange, debounceDelay);\n      }\n    },\n    [onChange, debounceDelay, trigger, name],\n  );\n\n  // Enhanced blur handler\n  const handleBlur = useCallback(() => {\n    // Flush pending changes\n    if (timeoutRef.current) {\n      clearTimeout(timeoutRef.current);\n      timeoutRef.current = null;\n      onChange(currentValue);\n    }\n    onBlur();\n  }, [onChange, onBlur, currentValue]);\n\n  return {\n    onChange: handleChange,\n    onBlur: handleBlur,\n    value: currentValue,\n  };\n};\n","/* v8 ignore start */\n\nexport * from './useInputValueDebounce';\n\n/* v8 ignore stop */\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+DA,MAAa,yBAA2C,EACtD,gBAAgB,KAChB,MACA,QACA,UACA,YAC+E;CAC/E,MAAM,EAAE,YAAY,gBAAgB;CAGpC,MAAM,CAAC,cAAc,mBAAmB,SAAiB,MAAM;CAE/D,MAAM,aAAa,OAA8B,KAAK;AAGtD,iBAAgB;AACd,kBAAgB,MAAM;IACrB,CAAC,MAAM,CAAC;AAuDX,QAAO;EACL,UArDmB,aAElB,GAAG,UAAiB;GAEnB,MAAM,WAAY,MAAM,IAAI,QAAQ,SAAS,MAAM;AACnD,mBAAgB,SAAS;AAGzB,OAAI,WAAW,QACb,cAAa,WAAW,QAAQ;GAGlC,MAAM,wBAAwB;AAE5B,QAAI,MAAM,IAAI,OAQZ,UAPuB;KACrB,GAAG,MAAM;KACT,QAAQ;MACN,GAAG,MAAM,GAAG;MACZ,OAAO;MACR;KACF,EACwB,GAAG,MAAM,MAAM,EAAE,CAAC;QAE3C,UAAS,SAAS;AAIpB,YAAQ,KAAK;;AAIf,OAAI,iBAAiB,EACnB,kBAAiB;OAEjB,YAAW,UAAU,WAAW,iBAAiB,cAAc;KAGnE;GAAC;GAAU;GAAe;GAAS;GAAK,CACzC;EAeC,QAZiB,kBAAkB;AAEnC,OAAI,WAAW,SAAS;AACtB,iBAAa,WAAW,QAAQ;AAChC,eAAW,UAAU;AACrB,aAAS,aAAa;;AAExB,WAAQ;KACP;GAAC;GAAU;GAAQ;GAAa,CAAC;EAKlC,OAAO;EACR"}
+{"version":3,"file":"useInputValueDebounce-DJO5uzLb.js","names":[],"sources":["../src/hooks/useInputValueDebounce/useInputValueDebounce.ts","../src/hooks/useInputValueDebounce/index.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\n\nimport { useFormContext } from '../useFormContext';\n\nexport interface UseInputValueDebounceOptions<TValue = unknown> {\n  /** Debounce delay in milliseconds (default: 300) */\n  debounceDelay?: number;\n  /** Field name for triggering validation after debounced value commits */\n  name: string;\n  /** The onBlur function to call after flushing debounced value */\n  onBlur: () => void;\n  /** The onChange function to call with debounced value */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  onChange: (...event: any[]) => void;\n  /** The field value */\n  value: TValue;\n}\n\nexport interface UseInputValueDebounceReturn<TValue = unknown> {\n  /** Enhanced onChange function with debouncing */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  onChange: (...event: any[]) => void;\n  /** Enhanced onBlur function that flushes current value immediately */\n  onBlur: () => void;\n  /** The field value that is displayed - updates immediately */\n  value: TValue;\n}\n\n/**\n * Custom hook for debouncing value changes with immediate blur support.\n *\n * Provides immediate visual feedback by updating the value instantly,\n * while debouncing the actual onChange calls. When focus is lost,\n * any pending debounced changes are immediately flushed.\n *\n * **Key Features:**\n * - **Debouncing**: Delays onChange calls until user stops typing\n * - **Generic type support**: Works with any data type (strings, numbers, arrays, objects)\n * - **Immediate value updates**: UI stays responsive during debouncing\n * - **Blur flushing**: Immediately applies pending changes on blur\n *\n * **Note:** Value transformations should be handled at the `useUniformField` level,\n * not in this hook. This hook only handles debouncing timing.\n *\n * @param options Configuration for debounced value handling\n * @param options.debounceDelay Delay in milliseconds (default: 300)\n * @param options.onBlur Function to call after flushing debounced value\n * @param options.onChange Function to call with debounced value\n * @param options.value The field value\n * @returns Object containing enhanced onChange, onBlur, and immediate value\n *\n * @example\n * Basic usage with debouncing:\n * ```tsx\n * const { onChange, onBlur, value } = useInputValueDebounce({\n *   debounceDelay: 300,\n *   name: 'fieldName',\n *   onBlur: field.onBlur,\n *   onChange: field.onChange,\n *   value: field.value,\n * });\n * ```\n */\nexport const useInputValueDebounce = <TValue = unknown>({\n  debounceDelay = 300,\n  name,\n  onBlur,\n  onChange,\n  value,\n}: UseInputValueDebounceOptions<TValue>): UseInputValueDebounceReturn<TValue> => {\n  const { trigger } = useFormContext();\n\n  // Track value for synchronous updates\n  const [currentValue, setCurrentValue] = useState<TValue>(value);\n\n  const timeoutRef = useRef<NodeJS.Timeout | null>(null);\n\n  // Sync with external value changes\n  useEffect(() => {\n    setCurrentValue(value);\n  }, [value]);\n\n  // Enhanced onChange handler with debouncing\n  const handleChange = useCallback(\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (...event: any[]) => {\n      // Extract the raw value\n      const newValue = (event[0]?.target?.value ?? event[0]) as TValue;\n      setCurrentValue(newValue);\n\n      // Clear existing timeout\n      if (timeoutRef.current) {\n        clearTimeout(timeoutRef.current);\n      }\n\n      const executeOnChange = () => {\n        // Preserve event structure if original was an event\n        if (event[0]?.target) {\n          const convertedEvent = {\n            ...event[0],\n            target: {\n              ...event[0].target,\n              value: newValue,\n            },\n          };\n          onChange(convertedEvent, ...event.slice(1));\n        } else {\n          onChange(newValue);\n        }\n        // Trigger validation after debounced value commits\n        // This ensures errors are updated immediately when field becomes valid\n        trigger(name);\n      };\n\n      // Execute immediately or after delay\n      if (debounceDelay <= 0) {\n        executeOnChange();\n      } else {\n        timeoutRef.current = setTimeout(executeOnChange, debounceDelay);\n      }\n    },\n    [onChange, debounceDelay, trigger, name],\n  );\n\n  // Enhanced blur handler\n  const handleBlur = useCallback(() => {\n    // Flush pending changes\n    if (timeoutRef.current) {\n      clearTimeout(timeoutRef.current);\n      timeoutRef.current = null;\n      onChange(currentValue);\n    }\n    onBlur();\n  }, [onChange, onBlur, currentValue]);\n\n  return {\n    onChange: handleChange,\n    onBlur: handleBlur,\n    value: currentValue,\n  };\n};\n","/* v8 ignore start */\n\nexport * from './useInputValueDebounce';\n\n/* v8 ignore stop */\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+DA,MAAa,yBAA2C,EACtD,gBAAgB,KAChB,MACA,QACA,UACA,YAC+E;CAC/E,MAAM,EAAE,YAAY,gBAAgB;CAGpC,MAAM,CAAC,cAAc,mBAAmB,SAAiB,MAAM;CAE/D,MAAM,aAAa,OAA8B,KAAK;AAGtD,iBAAgB;AACd,kBAAgB,MAAM;IACrB,CAAC,MAAM,CAAC;AAuDX,QAAO;EACL,UArDmB,aAElB,GAAG,UAAiB;GAEnB,MAAM,WAAY,MAAM,IAAI,QAAQ,SAAS,MAAM;AACnD,mBAAgB,SAAS;AAGzB,OAAI,WAAW,QACb,cAAa,WAAW,QAAQ;GAGlC,MAAM,wBAAwB;AAE5B,QAAI,MAAM,IAAI,OAQZ,UAPuB;KACrB,GAAG,MAAM;KACT,QAAQ;MACN,GAAG,MAAM,GAAG;MACZ,OAAO;MACR;KACF,EACwB,GAAG,MAAM,MAAM,EAAE,CAAC;QAE3C,UAAS,SAAS;AAIpB,YAAQ,KAAK;;AAIf,OAAI,iBAAiB,EACnB,kBAAiB;OAEjB,YAAW,UAAU,WAAW,iBAAiB,cAAc;KAGnE;GAAC;GAAU;GAAe;GAAS;GAAK,CACzC;EAeC,QAZiB,kBAAkB;AAEnC,OAAI,WAAW,SAAS;AACtB,iBAAa,WAAW,QAAQ;AAChC,eAAW,UAAU;AACrB,aAAS,aAAa;;AAExB,WAAQ;KACP;GAAC;GAAU;GAAQ;GAAa,CAAC;EAKlC,OAAO;EACR"}

package/dist/{useInputValueDebounce-fhmVn1aO.d.ts → useInputValueDebounce-Dhlv1NUY.d.ts}

@@ -63,4 +63,4 @@ declare const useInputValueDebounce: <TValue = unknown>({
 }: UseInputValueDebounceOptions<TValue>) => UseInputValueDebounceReturn<TValue>;
 //#endregion
 export { UseInputValueDebounceReturn as n, useInputValueDebounce as r, UseInputValueDebounceOptions as t };
-//# sourceMappingURL=useInputValueDebounce-fhmVn1aO.d.ts.map
+//# sourceMappingURL=useInputValueDebounce-Dhlv1NUY.d.ts.map

package/dist/useInputValueDebounce-Dhlv1NUY.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInputValueDebounce-Dhlv1NUY.d.ts","names":[],"sources":["../src/hooks/useInputValueDebounce/useInputValueDebounce.ts"],"mappings":";UAIiB,4BAAA;EAAA;EAEf,aAAA;EAF2C;EAI3C,IAAA;EAJ4C;EAM5C,MAAA;EAFA;EAKA,QAAA,MAAc,KAAA;EAAd;EAEA,KAAA,EAAO,MAAA;AAAA;AAAA,UAGQ,2BAAA;EAHF;EAMb,QAAA,MAAc,KAAA;EAHC;EAKf,MAAA;EAL0C;EAO1C,KAAA,EAAO,MAAA;AAAA;;;;;;;;AAsCT;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAAa,qBAAA;EAA2C,aAAA;EAAA,IAAA;EAAA,MAAA;EAAA,QAAA;EAAA;AAAA,GAMrD,4BAAA,CAA6B,MAAA,MAAU,2BAAA,CAA4B,MAAA"}

package/dist/{useInputValueDebounce-DI1C6oaU.d.cts → useInputValueDebounce-ZLyAmuXV.d.cts}

@@ -63,4 +63,4 @@ declare const useInputValueDebounce: <TValue = unknown>({
 }: UseInputValueDebounceOptions<TValue>) => UseInputValueDebounceReturn<TValue>;
 //#endregion
 export { UseInputValueDebounceReturn as n, useInputValueDebounce as r, UseInputValueDebounceOptions as t };
-//# sourceMappingURL=useInputValueDebounce-DI1C6oaU.d.cts.map
+//# sourceMappingURL=useInputValueDebounce-ZLyAmuXV.d.cts.map

package/dist/useInputValueDebounce-ZLyAmuXV.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInputValueDebounce-ZLyAmuXV.d.cts","names":[],"sources":["../src/hooks/useInputValueDebounce/useInputValueDebounce.ts"],"mappings":";UAIiB,4BAAA;EAAA;EAEf,aAAA;EAF2C;EAI3C,IAAA;EAJ4C;EAM5C,MAAA;EAFA;EAKA,QAAA,MAAc,KAAA;EAAd;EAEA,KAAA,EAAO,MAAA;AAAA;AAAA,UAGQ,2BAAA;EAHF;EAMb,QAAA,MAAc,KAAA;EAHC;EAKf,MAAA;EAL0C;EAO1C,KAAA,EAAO,MAAA;AAAA;;;;;;;;AAsCT;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAAa,qBAAA;EAA2C,aAAA;EAAA,IAAA;EAAA,MAAA;EAAA,QAAA;EAAA;AAAA,GAMrD,4BAAA,CAA6B,MAAA,MAAU,2BAAA,CAA4B,MAAA"}

package/dist/{useInputValueTransform-DuhPVE4L.cjs → useInputValueTransform-BBRvvhDe.cjs}

@@ -1,4 +1,4 @@
-const require_FormContext = require('./FormContext-CeFKQmVH.cjs');
+const require_FormContext = require('./FormContext-BSLO2-sO.cjs');
 let react = require("react");
 
 //#region src/hooks/useInputValueTransform/useInputValueTransform.ts
@@ -114,4 +114,4 @@ Object.defineProperty(exports, 'useInputValueTransform', {
     return useInputValueTransform;
   }
 });
-//# sourceMappingURL=useInputValueTransform-DuhPVE4L.cjs.map
+//# sourceMappingURL=useInputValueTransform-BBRvvhDe.cjs.map

package/dist/{useInputValueTransform-DuhPVE4L.cjs.map → useInputValueTransform-BBRvvhDe.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"useInputValueTransform-DuhPVE4L.cjs","names":[],"sources":["../src/hooks/useInputValueTransform/useInputValueTransform.ts"],"sourcesContent":["import { useCallback } from 'react';\n\nexport interface InputValueTransform<TDisplay = unknown> {\n  /** Transforms the form value to display value (e.g., 1000 → \"$1,000\" or 'a' → ['a']) */\n  toDisplayValue: (value: unknown) => TDisplay;\n  /** Transforms the display value to form value (e.g., \"$1,000\" → 1000 or ['a'] → 'a') */\n  toFormValue: (value: TDisplay) => unknown;\n}\n\nexport interface UseInputValueTransformOptions<TDisplay = unknown> {\n  /** Input type for special number handling */\n  type?: 'text' | 'number' | 'password';\n  /** Value transformation functions */\n  transform?: InputValueTransform<TDisplay>;\n}\n\nexport interface UseInputValueTransformReturn<TDisplay = unknown> {\n  /** Converts any form value to display value */\n  toDisplayValue: (formValue: unknown) => TDisplay;\n  /** Converts any display value to form value */\n  toFormValue: (displayValue: TDisplay) => unknown;\n}\n\n/**\n * Custom hook providing utility functions for value transformations between display and form values.\n *\n * This hook provides pure conversion functions without any state management. It's useful for:\n * - Currency formatting ($1,000 display vs 1000 stored)\n * - Number inputs with special handling\n * - Date formatting (MM/DD/YYYY display vs ISO date stored)\n * - Phone number formatting ((555) 123-4567 display vs 5551234567 stored)\n * - Array/Object transformations (single value ↔ array, nested structures)\n *\n * **Key Features:**\n * - Pure conversion functions (no state)\n * - Generic support for any data type (strings, numbers, arrays, objects)\n * - Special number input handling (empty string preservation)\n * - Bidirectional value transformations\n * - Memoized functions for performance\n *\n * @param options Configuration for value transformation\n * @returns Pure conversion utility functions\n *\n * @example\n * ```tsx\n * // Currency formatting\n * const currencyTransform = {\n *   toDisplayValue: (val) => val ? `$${Number(val).toLocaleString()}` : '',\n *   toFormValue: (val) => parseFloat(val.replace(/[$,]/g, '')) || 0\n * };\n *\n * const { toDisplayValue, toFormValue } = useInputValueTransform({\n *   transform: currencyTransform\n * });\n *\n * const displayVal = toDisplayValue(1000); // \"$1,000\"\n * const formVal = toFormValue(\"$1,500\"); // 1500\n * ```\n *\n * @example\n * ```tsx\n * // Number input (no transforms needed)\n * const { toDisplayValue, toFormValue } = useInputValueTransform({\n *   type: 'number'\n * });\n *\n * // Handles empty string → empty string (not NaN)\n * // Handles \"123\" → 123 (string to number conversion)\n * ```\n *\n * @example\n * ```tsx\n * // Array to single value (for single checkbox)\n * const singleValueTransform = {\n *   toDisplayValue: (val: string[]) => val?.[0] || '',\n *   toFormValue: (val: string) => val ? [val] : []\n * };\n *\n * const { toDisplayValue, toFormValue } = useInputValueTransform({\n *   transform: singleValueTransform\n * });\n *\n * const displayVal = toDisplayValue(['option1']); // \"option1\"\n * const formVal = toFormValue(\"option2\"); // [\"option2\"]\n * ```\n *\n * @example\n * ```tsx\n * // Integration with debouncing\n * const MyInput = ({ field, transform }) => {\n *   const transform = useInputValueTransform({ transform });\n *\n *   const { onChange, onBlur, value } = useInputValueDebounce({\n *     ...transform,\n *     debounceDelay: 300,\n *     name: 'fieldName',\n *     onBlur: field.onBlur,\n *     onChange: field.onChange,\n *     value: field.value,\n *   });\n *\n *   return <input value={value} onChange={onChange} onBlur={onBlur} />;\n * };\n * ```\n */\nexport const useInputValueTransform = <TDisplay = unknown>({\n  type,\n  transform,\n}: UseInputValueTransformOptions<TDisplay>): UseInputValueTransformReturn<TDisplay> => {\n  /**\n   * Converts any form value to display value\n   */\n  const toDisplayValue = useCallback(\n    (formValue: unknown): TDisplay => {\n      if (transform?.toDisplayValue) {\n        return transform.toDisplayValue(formValue);\n      }\n\n      // For number type, convert valid strings to numbers for display\n      if (type === 'number') {\n        if (formValue === '') {\n          return '' as TDisplay;\n        }\n        const numValue = Number(formValue);\n        return (Number.isNaN(numValue) ? formValue : numValue) as TDisplay;\n      }\n\n      // Default: pass through (handles primitives, arrays, objects, etc.)\n      return (formValue ?? '') as TDisplay;\n    },\n    [type, transform],\n  );\n\n  /**\n   * Converts any display value to form value\n   */\n  const toFormValue = useCallback(\n    (displayValue: TDisplay): unknown => {\n      if (transform?.toFormValue) {\n        return transform.toFormValue(displayValue);\n      }\n\n      // For number type, convert strings to numbers\n      if (type === 'number') {\n        if (displayValue === '') {\n          return '';\n        }\n        const numValue = Number(displayValue);\n        return Number.isNaN(numValue) ? displayValue : numValue;\n      }\n\n      // Default: pass through (handles primitives, arrays, objects, etc.)\n      return displayValue;\n    },\n    [type, transform],\n  );\n\n  return {\n    toDisplayValue,\n    toFormValue,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyGA,MAAa,0BAA8C,EACzD,MACA,gBACqF;AAiDrF,QAAO;EACL,wCA7CC,cAAiC;AAChC,OAAI,WAAW,eACb,QAAO,UAAU,eAAe,UAAU;AAI5C,OAAI,SAAS,UAAU;AACrB,QAAI,cAAc,GAChB,QAAO;IAET,MAAM,WAAW,OAAO,UAAU;AAClC,WAAQ,OAAO,MAAM,SAAS,GAAG,YAAY;;AAI/C,UAAQ,aAAa;KAEvB,CAAC,MAAM,UAAU,CAClB;EA4BC,qCAtBC,iBAAoC;AACnC,OAAI,WAAW,YACb,QAAO,UAAU,YAAY,aAAa;AAI5C,OAAI,SAAS,UAAU;AACrB,QAAI,iBAAiB,GACnB,QAAO;IAET,MAAM,WAAW,OAAO,aAAa;AACrC,WAAO,OAAO,MAAM,SAAS,GAAG,eAAe;;AAIjD,UAAO;KAET,CAAC,MAAM,UAAU,CAClB;EAKA"}
+{"version":3,"file":"useInputValueTransform-BBRvvhDe.cjs","names":[],"sources":["../src/hooks/useInputValueTransform/useInputValueTransform.ts"],"sourcesContent":["import { useCallback } from 'react';\n\nexport interface InputValueTransform<TDisplay = unknown> {\n  /** Transforms the form value to display value (e.g., 1000 → \"$1,000\" or 'a' → ['a']) */\n  toDisplayValue: (value: unknown) => TDisplay;\n  /** Transforms the display value to form value (e.g., \"$1,000\" → 1000 or ['a'] → 'a') */\n  toFormValue: (value: TDisplay) => unknown;\n}\n\nexport interface UseInputValueTransformOptions<TDisplay = unknown> {\n  /** Input type for special number handling */\n  type?: 'text' | 'number' | 'password';\n  /** Value transformation functions */\n  transform?: InputValueTransform<TDisplay>;\n}\n\nexport interface UseInputValueTransformReturn<TDisplay = unknown> {\n  /** Converts any form value to display value */\n  toDisplayValue: (formValue: unknown) => TDisplay;\n  /** Converts any display value to form value */\n  toFormValue: (displayValue: TDisplay) => unknown;\n}\n\n/**\n * Custom hook providing utility functions for value transformations between display and form values.\n *\n * This hook provides pure conversion functions without any state management. It's useful for:\n * - Currency formatting ($1,000 display vs 1000 stored)\n * - Number inputs with special handling\n * - Date formatting (MM/DD/YYYY display vs ISO date stored)\n * - Phone number formatting ((555) 123-4567 display vs 5551234567 stored)\n * - Array/Object transformations (single value ↔ array, nested structures)\n *\n * **Key Features:**\n * - Pure conversion functions (no state)\n * - Generic support for any data type (strings, numbers, arrays, objects)\n * - Special number input handling (empty string preservation)\n * - Bidirectional value transformations\n * - Memoized functions for performance\n *\n * @param options Configuration for value transformation\n * @returns Pure conversion utility functions\n *\n * @example\n * ```tsx\n * // Currency formatting\n * const currencyTransform = {\n *   toDisplayValue: (val) => val ? `$${Number(val).toLocaleString()}` : '',\n *   toFormValue: (val) => parseFloat(val.replace(/[$,]/g, '')) || 0\n * };\n *\n * const { toDisplayValue, toFormValue } = useInputValueTransform({\n *   transform: currencyTransform\n * });\n *\n * const displayVal = toDisplayValue(1000); // \"$1,000\"\n * const formVal = toFormValue(\"$1,500\"); // 1500\n * ```\n *\n * @example\n * ```tsx\n * // Number input (no transforms needed)\n * const { toDisplayValue, toFormValue } = useInputValueTransform({\n *   type: 'number'\n * });\n *\n * // Handles empty string → empty string (not NaN)\n * // Handles \"123\" → 123 (string to number conversion)\n * ```\n *\n * @example\n * ```tsx\n * // Array to single value (for single checkbox)\n * const singleValueTransform = {\n *   toDisplayValue: (val: string[]) => val?.[0] || '',\n *   toFormValue: (val: string) => val ? [val] : []\n * };\n *\n * const { toDisplayValue, toFormValue } = useInputValueTransform({\n *   transform: singleValueTransform\n * });\n *\n * const displayVal = toDisplayValue(['option1']); // \"option1\"\n * const formVal = toFormValue(\"option2\"); // [\"option2\"]\n * ```\n *\n * @example\n * ```tsx\n * // Integration with debouncing\n * const MyInput = ({ field, transform }) => {\n *   const transform = useInputValueTransform({ transform });\n *\n *   const { onChange, onBlur, value } = useInputValueDebounce({\n *     ...transform,\n *     debounceDelay: 300,\n *     name: 'fieldName',\n *     onBlur: field.onBlur,\n *     onChange: field.onChange,\n *     value: field.value,\n *   });\n *\n *   return <input value={value} onChange={onChange} onBlur={onBlur} />;\n * };\n * ```\n */\nexport const useInputValueTransform = <TDisplay = unknown>({\n  type,\n  transform,\n}: UseInputValueTransformOptions<TDisplay>): UseInputValueTransformReturn<TDisplay> => {\n  /**\n   * Converts any form value to display value\n   */\n  const toDisplayValue = useCallback(\n    (formValue: unknown): TDisplay => {\n      if (transform?.toDisplayValue) {\n        return transform.toDisplayValue(formValue);\n      }\n\n      // For number type, convert valid strings to numbers for display\n      if (type === 'number') {\n        if (formValue === '') {\n          return '' as TDisplay;\n        }\n        const numValue = Number(formValue);\n        return (Number.isNaN(numValue) ? formValue : numValue) as TDisplay;\n      }\n\n      // Default: pass through (handles primitives, arrays, objects, etc.)\n      return (formValue ?? '') as TDisplay;\n    },\n    [type, transform],\n  );\n\n  /**\n   * Converts any display value to form value\n   */\n  const toFormValue = useCallback(\n    (displayValue: TDisplay): unknown => {\n      if (transform?.toFormValue) {\n        return transform.toFormValue(displayValue);\n      }\n\n      // For number type, convert strings to numbers\n      if (type === 'number') {\n        if (displayValue === '') {\n          return '';\n        }\n        const numValue = Number(displayValue);\n        return Number.isNaN(numValue) ? displayValue : numValue;\n      }\n\n      // Default: pass through (handles primitives, arrays, objects, etc.)\n      return displayValue;\n    },\n    [type, transform],\n  );\n\n  return {\n    toDisplayValue,\n    toFormValue,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyGA,MAAa,0BAA8C,EACzD,MACA,gBACqF;AAiDrF,QAAO;EACL,wCA7CC,cAAiC;AAChC,OAAI,WAAW,eACb,QAAO,UAAU,eAAe,UAAU;AAI5C,OAAI,SAAS,UAAU;AACrB,QAAI,cAAc,GAChB,QAAO;IAET,MAAM,WAAW,OAAO,UAAU;AAClC,WAAQ,OAAO,MAAM,SAAS,GAAG,YAAY;;AAI/C,UAAQ,aAAa;KAEvB,CAAC,MAAM,UAAU,CAClB;EA4BC,qCAtBC,iBAAoC;AACnC,OAAI,WAAW,YACb,QAAO,UAAU,YAAY,aAAa;AAI5C,OAAI,SAAS,UAAU;AACrB,QAAI,iBAAiB,GACnB,QAAO;IAET,MAAM,WAAW,OAAO,aAAa;AACrC,WAAO,OAAO,MAAM,SAAS,GAAG,eAAe;;AAIjD,UAAO;KAET,CAAC,MAAM,UAAU,CAClB;EAKA"}

package/dist/{useInputValueTransform-CMNC21vX.js → useInputValueTransform-C-fmz3ke.js}

@@ -108,4 +108,4 @@ const useInputValueTransform = ({ type, transform }) => {
 
 //#endregion
 export { useInputValueTransform as t };
-//# sourceMappingURL=useInputValueTransform-CMNC21vX.js.map
+//# sourceMappingURL=useInputValueTransform-C-fmz3ke.js.map

package/dist/{useInputValueTransform-CMNC21vX.js.map → useInputValueTransform-C-fmz3ke.js.map}

@@ -1 +1 @@
-{"version":3,"file":"useInputValueTransform-CMNC21vX.js","names":[],"sources":["../src/hooks/useInputValueTransform/useInputValueTransform.ts"],"sourcesContent":["import { useCallback } from 'react';\n\nexport interface InputValueTransform<TDisplay = unknown> {\n  /** Transforms the form value to display value (e.g., 1000 → \"$1,000\" or 'a' → ['a']) */\n  toDisplayValue: (value: unknown) => TDisplay;\n  /** Transforms the display value to form value (e.g., \"$1,000\" → 1000 or ['a'] → 'a') */\n  toFormValue: (value: TDisplay) => unknown;\n}\n\nexport interface UseInputValueTransformOptions<TDisplay = unknown> {\n  /** Input type for special number handling */\n  type?: 'text' | 'number' | 'password';\n  /** Value transformation functions */\n  transform?: InputValueTransform<TDisplay>;\n}\n\nexport interface UseInputValueTransformReturn<TDisplay = unknown> {\n  /** Converts any form value to display value */\n  toDisplayValue: (formValue: unknown) => TDisplay;\n  /** Converts any display value to form value */\n  toFormValue: (displayValue: TDisplay) => unknown;\n}\n\n/**\n * Custom hook providing utility functions for value transformations between display and form values.\n *\n * This hook provides pure conversion functions without any state management. It's useful for:\n * - Currency formatting ($1,000 display vs 1000 stored)\n * - Number inputs with special handling\n * - Date formatting (MM/DD/YYYY display vs ISO date stored)\n * - Phone number formatting ((555) 123-4567 display vs 5551234567 stored)\n * - Array/Object transformations (single value ↔ array, nested structures)\n *\n * **Key Features:**\n * - Pure conversion functions (no state)\n * - Generic support for any data type (strings, numbers, arrays, objects)\n * - Special number input handling (empty string preservation)\n * - Bidirectional value transformations\n * - Memoized functions for performance\n *\n * @param options Configuration for value transformation\n * @returns Pure conversion utility functions\n *\n * @example\n * ```tsx\n * // Currency formatting\n * const currencyTransform = {\n *   toDisplayValue: (val) => val ? `$${Number(val).toLocaleString()}` : '',\n *   toFormValue: (val) => parseFloat(val.replace(/[$,]/g, '')) || 0\n * };\n *\n * const { toDisplayValue, toFormValue } = useInputValueTransform({\n *   transform: currencyTransform\n * });\n *\n * const displayVal = toDisplayValue(1000); // \"$1,000\"\n * const formVal = toFormValue(\"$1,500\"); // 1500\n * ```\n *\n * @example\n * ```tsx\n * // Number input (no transforms needed)\n * const { toDisplayValue, toFormValue } = useInputValueTransform({\n *   type: 'number'\n * });\n *\n * // Handles empty string → empty string (not NaN)\n * // Handles \"123\" → 123 (string to number conversion)\n * ```\n *\n * @example\n * ```tsx\n * // Array to single value (for single checkbox)\n * const singleValueTransform = {\n *   toDisplayValue: (val: string[]) => val?.[0] || '',\n *   toFormValue: (val: string) => val ? [val] : []\n * };\n *\n * const { toDisplayValue, toFormValue } = useInputValueTransform({\n *   transform: singleValueTransform\n * });\n *\n * const displayVal = toDisplayValue(['option1']); // \"option1\"\n * const formVal = toFormValue(\"option2\"); // [\"option2\"]\n * ```\n *\n * @example\n * ```tsx\n * // Integration with debouncing\n * const MyInput = ({ field, transform }) => {\n *   const transform = useInputValueTransform({ transform });\n *\n *   const { onChange, onBlur, value } = useInputValueDebounce({\n *     ...transform,\n *     debounceDelay: 300,\n *     name: 'fieldName',\n *     onBlur: field.onBlur,\n *     onChange: field.onChange,\n *     value: field.value,\n *   });\n *\n *   return <input value={value} onChange={onChange} onBlur={onBlur} />;\n * };\n * ```\n */\nexport const useInputValueTransform = <TDisplay = unknown>({\n  type,\n  transform,\n}: UseInputValueTransformOptions<TDisplay>): UseInputValueTransformReturn<TDisplay> => {\n  /**\n   * Converts any form value to display value\n   */\n  const toDisplayValue = useCallback(\n    (formValue: unknown): TDisplay => {\n      if (transform?.toDisplayValue) {\n        return transform.toDisplayValue(formValue);\n      }\n\n      // For number type, convert valid strings to numbers for display\n      if (type === 'number') {\n        if (formValue === '') {\n          return '' as TDisplay;\n        }\n        const numValue = Number(formValue);\n        return (Number.isNaN(numValue) ? formValue : numValue) as TDisplay;\n      }\n\n      // Default: pass through (handles primitives, arrays, objects, etc.)\n      return (formValue ?? '') as TDisplay;\n    },\n    [type, transform],\n  );\n\n  /**\n   * Converts any display value to form value\n   */\n  const toFormValue = useCallback(\n    (displayValue: TDisplay): unknown => {\n      if (transform?.toFormValue) {\n        return transform.toFormValue(displayValue);\n      }\n\n      // For number type, convert strings to numbers\n      if (type === 'number') {\n        if (displayValue === '') {\n          return '';\n        }\n        const numValue = Number(displayValue);\n        return Number.isNaN(numValue) ? displayValue : numValue;\n      }\n\n      // Default: pass through (handles primitives, arrays, objects, etc.)\n      return displayValue;\n    },\n    [type, transform],\n  );\n\n  return {\n    toDisplayValue,\n    toFormValue,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyGA,MAAa,0BAA8C,EACzD,MACA,gBACqF;AAiDrF,QAAO;EACL,gBA9CqB,aACpB,cAAiC;AAChC,OAAI,WAAW,eACb,QAAO,UAAU,eAAe,UAAU;AAI5C,OAAI,SAAS,UAAU;AACrB,QAAI,cAAc,GAChB,QAAO;IAET,MAAM,WAAW,OAAO,UAAU;AAClC,WAAQ,OAAO,MAAM,SAAS,GAAG,YAAY;;AAI/C,UAAQ,aAAa;KAEvB,CAAC,MAAM,UAAU,CAClB;EA4BC,aAvBkB,aACjB,iBAAoC;AACnC,OAAI,WAAW,YACb,QAAO,UAAU,YAAY,aAAa;AAI5C,OAAI,SAAS,UAAU;AACrB,QAAI,iBAAiB,GACnB,QAAO;IAET,MAAM,WAAW,OAAO,aAAa;AACrC,WAAO,OAAO,MAAM,SAAS,GAAG,eAAe;;AAIjD,UAAO;KAET,CAAC,MAAM,UAAU,CAClB;EAKA"}
+{"version":3,"file":"useInputValueTransform-C-fmz3ke.js","names":[],"sources":["../src/hooks/useInputValueTransform/useInputValueTransform.ts"],"sourcesContent":["import { useCallback } from 'react';\n\nexport interface InputValueTransform<TDisplay = unknown> {\n  /** Transforms the form value to display value (e.g., 1000 → \"$1,000\" or 'a' → ['a']) */\n  toDisplayValue: (value: unknown) => TDisplay;\n  /** Transforms the display value to form value (e.g., \"$1,000\" → 1000 or ['a'] → 'a') */\n  toFormValue: (value: TDisplay) => unknown;\n}\n\nexport interface UseInputValueTransformOptions<TDisplay = unknown> {\n  /** Input type for special number handling */\n  type?: 'text' | 'number' | 'password';\n  /** Value transformation functions */\n  transform?: InputValueTransform<TDisplay>;\n}\n\nexport interface UseInputValueTransformReturn<TDisplay = unknown> {\n  /** Converts any form value to display value */\n  toDisplayValue: (formValue: unknown) => TDisplay;\n  /** Converts any display value to form value */\n  toFormValue: (displayValue: TDisplay) => unknown;\n}\n\n/**\n * Custom hook providing utility functions for value transformations between display and form values.\n *\n * This hook provides pure conversion functions without any state management. It's useful for:\n * - Currency formatting ($1,000 display vs 1000 stored)\n * - Number inputs with special handling\n * - Date formatting (MM/DD/YYYY display vs ISO date stored)\n * - Phone number formatting ((555) 123-4567 display vs 5551234567 stored)\n * - Array/Object transformations (single value ↔ array, nested structures)\n *\n * **Key Features:**\n * - Pure conversion functions (no state)\n * - Generic support for any data type (strings, numbers, arrays, objects)\n * - Special number input handling (empty string preservation)\n * - Bidirectional value transformations\n * - Memoized functions for performance\n *\n * @param options Configuration for value transformation\n * @returns Pure conversion utility functions\n *\n * @example\n * ```tsx\n * // Currency formatting\n * const currencyTransform = {\n *   toDisplayValue: (val) => val ? `$${Number(val).toLocaleString()}` : '',\n *   toFormValue: (val) => parseFloat(val.replace(/[$,]/g, '')) || 0\n * };\n *\n * const { toDisplayValue, toFormValue } = useInputValueTransform({\n *   transform: currencyTransform\n * });\n *\n * const displayVal = toDisplayValue(1000); // \"$1,000\"\n * const formVal = toFormValue(\"$1,500\"); // 1500\n * ```\n *\n * @example\n * ```tsx\n * // Number input (no transforms needed)\n * const { toDisplayValue, toFormValue } = useInputValueTransform({\n *   type: 'number'\n * });\n *\n * // Handles empty string → empty string (not NaN)\n * // Handles \"123\" → 123 (string to number conversion)\n * ```\n *\n * @example\n * ```tsx\n * // Array to single value (for single checkbox)\n * const singleValueTransform = {\n *   toDisplayValue: (val: string[]) => val?.[0] || '',\n *   toFormValue: (val: string) => val ? [val] : []\n * };\n *\n * const { toDisplayValue, toFormValue } = useInputValueTransform({\n *   transform: singleValueTransform\n * });\n *\n * const displayVal = toDisplayValue(['option1']); // \"option1\"\n * const formVal = toFormValue(\"option2\"); // [\"option2\"]\n * ```\n *\n * @example\n * ```tsx\n * // Integration with debouncing\n * const MyInput = ({ field, transform }) => {\n *   const transform = useInputValueTransform({ transform });\n *\n *   const { onChange, onBlur, value } = useInputValueDebounce({\n *     ...transform,\n *     debounceDelay: 300,\n *     name: 'fieldName',\n *     onBlur: field.onBlur,\n *     onChange: field.onChange,\n *     value: field.value,\n *   });\n *\n *   return <input value={value} onChange={onChange} onBlur={onBlur} />;\n * };\n * ```\n */\nexport const useInputValueTransform = <TDisplay = unknown>({\n  type,\n  transform,\n}: UseInputValueTransformOptions<TDisplay>): UseInputValueTransformReturn<TDisplay> => {\n  /**\n   * Converts any form value to display value\n   */\n  const toDisplayValue = useCallback(\n    (formValue: unknown): TDisplay => {\n      if (transform?.toDisplayValue) {\n        return transform.toDisplayValue(formValue);\n      }\n\n      // For number type, convert valid strings to numbers for display\n      if (type === 'number') {\n        if (formValue === '') {\n          return '' as TDisplay;\n        }\n        const numValue = Number(formValue);\n        return (Number.isNaN(numValue) ? formValue : numValue) as TDisplay;\n      }\n\n      // Default: pass through (handles primitives, arrays, objects, etc.)\n      return (formValue ?? '') as TDisplay;\n    },\n    [type, transform],\n  );\n\n  /**\n   * Converts any display value to form value\n   */\n  const toFormValue = useCallback(\n    (displayValue: TDisplay): unknown => {\n      if (transform?.toFormValue) {\n        return transform.toFormValue(displayValue);\n      }\n\n      // For number type, convert strings to numbers\n      if (type === 'number') {\n        if (displayValue === '') {\n          return '';\n        }\n        const numValue = Number(displayValue);\n        return Number.isNaN(numValue) ? displayValue : numValue;\n      }\n\n      // Default: pass through (handles primitives, arrays, objects, etc.)\n      return displayValue;\n    },\n    [type, transform],\n  );\n\n  return {\n    toDisplayValue,\n    toFormValue,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyGA,MAAa,0BAA8C,EACzD,MACA,gBACqF;AAiDrF,QAAO;EACL,gBA9CqB,aACpB,cAAiC;AAChC,OAAI,WAAW,eACb,QAAO,UAAU,eAAe,UAAU;AAI5C,OAAI,SAAS,UAAU;AACrB,QAAI,cAAc,GAChB,QAAO;IAET,MAAM,WAAW,OAAO,UAAU;AAClC,WAAQ,OAAO,MAAM,SAAS,GAAG,YAAY;;AAI/C,UAAQ,aAAa;KAEvB,CAAC,MAAM,UAAU,CAClB;EA4BC,aAvBkB,aACjB,iBAAoC;AACnC,OAAI,WAAW,YACb,QAAO,UAAU,YAAY,aAAa;AAI5C,OAAI,SAAS,UAAU;AACrB,QAAI,iBAAiB,GACnB,QAAO;IAET,MAAM,WAAW,OAAO,aAAa;AACrC,WAAO,OAAO,MAAM,SAAS,GAAG,eAAe;;AAIjD,UAAO;KAET,CAAC,MAAM,UAAU,CAClB;EAKA"}

package/dist/{useInputValueTransform-BV8o0PMI.d.cts → useInputValueTransform-CNCBU7a9.d.cts}

@@ -105,4 +105,4 @@ declare const useInputValueTransform: <TDisplay = unknown>({
 }: UseInputValueTransformOptions<TDisplay>) => UseInputValueTransformReturn<TDisplay>;
 //#endregion
 export { useInputValueTransform as i, UseInputValueTransformOptions as n, UseInputValueTransformReturn as r, InputValueTransform as t };
-//# sourceMappingURL=useInputValueTransform-BV8o0PMI.d.cts.map
+//# sourceMappingURL=useInputValueTransform-CNCBU7a9.d.cts.map

package/dist/useInputValueTransform-CNCBU7a9.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInputValueTransform-CNCBU7a9.d.cts","names":[],"sources":["../src/hooks/useInputValueTransform/useInputValueTransform.ts"],"mappings":";UAEiB,mBAAA;EAAA;EAEf,cAAA,GAAiB,KAAA,cAAmB,QAAA;EAFF;EAIlC,WAAA,GAAc,KAAA,EAAO,QAAA;AAAA;AAAA,UAGN,6BAAA;EALE;EAOjB,IAAA;EALA;EAOA,SAAA,GAAY,mBAAA,CAAoB,QAAA;AAAA;AAAA,UAGjB,4BAAA;EAVc;EAY7B,cAAA,GAAiB,SAAA,cAAuB,QAAA;EATI;EAW5C,WAAA,GAAc,YAAA,EAAc,QAAA;AAAA;;;;;;;;AAJ9B;;;;;;;;;;;;;AAyFA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAAa,sBAAA;EAA8C,IAAA;EAAA;AAAA,GAGxD,6BAAA,CAA8B,QAAA,MAAY,4BAAA,CAA6B,QAAA"}