@fuf-stack/uniform 1.19.3 → 1.20.0

package/dist/index-eEJp36Ma.d.cts

@@ -0,0 +1,167 @@
+import { TVClassName, TVProps } from "@fuf-stack/pixel-utils";
+import { ReactNode } from "react";
+
+//#region src/Slider/Slider.d.ts
+declare const sliderVariants: import("tailwind-variants").TVReturnType<{
+  [key: string]: {
+    [key: string]: import("tailwind-merge").ClassNameValue | {
+      label?: import("tailwind-merge").ClassNameValue;
+      value?: import("tailwind-merge").ClassNameValue;
+      errorMessage?: import("tailwind-merge").ClassNameValue;
+      base?: import("tailwind-merge").ClassNameValue;
+      mark?: import("tailwind-merge").ClassNameValue;
+      track?: import("tailwind-merge").ClassNameValue;
+      step?: import("tailwind-merge").ClassNameValue;
+      endContent?: import("tailwind-merge").ClassNameValue;
+      startContent?: import("tailwind-merge").ClassNameValue;
+      thumb?: import("tailwind-merge").ClassNameValue;
+      filler?: import("tailwind-merge").ClassNameValue;
+      labelWrapper?: import("tailwind-merge").ClassNameValue;
+      trackWrapper?: import("tailwind-merge").ClassNameValue;
+    };
+  };
+} | {
+  [x: string]: {
+    [x: string]: import("tailwind-merge").ClassNameValue | {
+      label?: import("tailwind-merge").ClassNameValue;
+      value?: import("tailwind-merge").ClassNameValue;
+      errorMessage?: import("tailwind-merge").ClassNameValue;
+      base?: import("tailwind-merge").ClassNameValue;
+      mark?: import("tailwind-merge").ClassNameValue;
+      track?: import("tailwind-merge").ClassNameValue;
+      step?: import("tailwind-merge").ClassNameValue;
+      endContent?: import("tailwind-merge").ClassNameValue;
+      startContent?: import("tailwind-merge").ClassNameValue;
+      thumb?: import("tailwind-merge").ClassNameValue;
+      filler?: import("tailwind-merge").ClassNameValue;
+      labelWrapper?: import("tailwind-merge").ClassNameValue;
+      trackWrapper?: import("tailwind-merge").ClassNameValue;
+    };
+  };
+} | {}, {
+  base: string;
+  endContent: string;
+  errorMessage: string;
+  filler: string;
+  label: string;
+  labelWrapper: string;
+  mark: string;
+  startContent: string;
+  step: string;
+  thumb: string;
+  track: string;
+  trackWrapper: string;
+  value: string;
+}, undefined, {
+  [key: string]: {
+    [key: string]: import("tailwind-merge").ClassNameValue | {
+      label?: import("tailwind-merge").ClassNameValue;
+      value?: import("tailwind-merge").ClassNameValue;
+      errorMessage?: import("tailwind-merge").ClassNameValue;
+      base?: import("tailwind-merge").ClassNameValue;
+      mark?: import("tailwind-merge").ClassNameValue;
+      track?: import("tailwind-merge").ClassNameValue;
+      step?: import("tailwind-merge").ClassNameValue;
+      endContent?: import("tailwind-merge").ClassNameValue;
+      startContent?: import("tailwind-merge").ClassNameValue;
+      thumb?: import("tailwind-merge").ClassNameValue;
+      filler?: import("tailwind-merge").ClassNameValue;
+      labelWrapper?: import("tailwind-merge").ClassNameValue;
+      trackWrapper?: import("tailwind-merge").ClassNameValue;
+    };
+  };
+} | {}, {
+  base: string;
+  endContent: string;
+  errorMessage: string;
+  filler: string;
+  label: string;
+  labelWrapper: string;
+  mark: string;
+  startContent: string;
+  step: string;
+  thumb: string;
+  track: string;
+  trackWrapper: string;
+  value: string;
+}, import("tailwind-variants").TVReturnType<unknown, {
+  base: string;
+  endContent: string;
+  errorMessage: string;
+  filler: string;
+  label: string;
+  labelWrapper: string;
+  mark: string;
+  startContent: string;
+  step: string;
+  thumb: string;
+  track: string;
+  trackWrapper: string;
+  value: string;
+}, undefined, unknown, unknown, undefined>>;
+type VariantProps = TVProps<typeof sliderVariants>;
+type ClassName = TVClassName<typeof sliderVariants>;
+interface SliderProps extends VariantProps {
+  /** Custom aria-label for accessibility. If not provided, falls back to field name when no visible label exists */
+  ariaLabel?: string;
+  /** CSS class name */
+  className?: ClassName;
+  /** input field is disabled */
+  disabled?: boolean;
+  /** Content to display at the end of the slider */
+  endContent?: ReactNode;
+  /** The offset from where the fill should start */
+  fillOffset?: number;
+  /** form field label */
+  label?: string;
+  /** form field name */
+  name: string;
+  /**
+   * Whether to show step dots on the slider
+   * @default false
+   */
+  showSteps?: boolean;
+  /**
+   * The size of the slider
+   * @default "md"
+   */
+  size?: 'sm' | 'md' | 'lg';
+  /** Content to display at the start of the slider */
+  startContent?: ReactNode;
+  /**
+   * The step value of the slider
+   * @default 1
+   */
+  step?: number;
+  /** HTML data-testid attribute used in e2e tests */
+  testId?: string;
+  /**
+   * The minimum value of the slider
+   * @default 0
+   */
+  minValue?: number;
+  /**
+   * The maximum value of the slider
+   * @default 100
+   */
+  maxValue?: number;
+}
+/**
+ * Slider component based on [HeroUI Slider](https://www.heroui.com//docs/components/slider)
+ */
+declare const Slider: ({
+  className,
+  endContent,
+  fillOffset,
+  name,
+  showSteps,
+  size,
+  startContent,
+  step,
+  minValue,
+  maxValue,
+  ...uniformFieldProps
+}: SliderProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+export { SliderProps as n, Slider as t };
+//# sourceMappingURL=index-eEJp36Ma.d.cts.map

package/dist/index-eEJp36Ma.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-eEJp36Ma.d.cts","names":[],"sources":["../src/Slider/Slider.tsx"],"mappings":";;;;cAYa,cAAA,8BAAc,YAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAqBtB,YAAA,GAAe,OAAO,QAAQ,cAAA;AAAA,KAC9B,SAAA,GAAY,WAAW,QAAQ,cAAA;AAAA,UAEnB,WAAA,SAAoB,YAAA;;EAEnC,SAAA;;EAEA,SAAA,GAAY,SAAA;;EAEZ,QAAA;;EAEA,UAAA,GAAa,SAAA;;EAEb,UAAA;;EAEA,KAAA;;EAEA,IAAA;;;;;EAKA,SAAA;;;;;EAKA,IAAA;;EAEA,YAAA,GAAe,SAAA;;;;;EAKf,IAAA;;EAEA,MAAA;;;;AAtCC;EA2CD,QAAA;;;AAzC+C;AAAA;EA8C/C,QAAA;AAAA;;AA7CgD;AAElD;cAiDM,MAAA;EAAU,SAAA;EAAA,UAAA;EAAA,UAAA;EAAA,IAAA;EAAA,SAAA;EAAA,IAAA;EAAA,YAAA;EAAA,IAAA;EAAA,QAAA;EAAA,QAAA;EAAA,GAAA;AAAA,GAYb,WAAA,iCAAW,GAAA,CAAA,OAAA"}

package/dist/{index-DD_RPe91.d.ts → index-jIVsGNsl.d.ts}

@@ -1,10 +1,9 @@
-import { t as TVReturnType } from "./index-DwqOejxR.js";
 import { TVClassName, TVProps } from "@fuf-stack/pixel-utils";
 import { ReactElement, ReactNode } from "react";
 import { TabsProps } from "@fuf-stack/pixels";
 
 //#region src/RadioTabs/RadioTabs.d.ts
-declare const radioTabsVariants: TVReturnType<{
+declare const radioTabsVariants: import("tailwind-variants").TVReturnType<{
   hasContent: {
     true: {
       base: string;
@@ -62,7 +61,7 @@ declare const radioTabsVariants: TVReturnType<{
   tabPanel: string;
   tabWrapper: string;
   wrapper: string;
-}, TVReturnType<{
+}, import("tailwind-variants").TVReturnType<{
   hasContent: {
     true: {
       base: string;
@@ -145,4 +144,4 @@ declare const RadioTabs: ({
 }: RadioTabsProps) => ReactElement;
 //#endregion
 export { RadioTabsProps as n, RadioTabs as t };
-//# sourceMappingURL=index-DD_RPe91.d.ts.map
+//# sourceMappingURL=index-jIVsGNsl.d.ts.map

package/dist/index-jIVsGNsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-jIVsGNsl.d.ts","names":[],"sources":["../src/RadioTabs/RadioTabs.tsx"],"mappings":";;;;;cAgBa,iBAAA,8BAAiB,YAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAwCzB,YAAA,GAAe,OAAO,QAAQ,iBAAA;AAAA,KAC9B,SAAA,GAAY,WAAW,QAAQ,iBAAA;AAAA,UAEnB,eAAA;EAEf;EAAA,OAAA,GAAU,SAAA;EAEV;EAAA,QAAA;EAEQ;EAAR,KAAA,GAAQ,SAAA;EAED;EAAP,IAAA,GAAO,SAAA;EAIP;EAFA,MAAA;EAEK;EAAL,KAAA;AAAA;AAAA,UAGe,cAAA,SAAuB,IAAA,CAAK,YAAA;EAAA;EAE3C,SAAA;EAUQ;EARR,SAAA,GAAY,SAAA;EAgBF;EAdV,QAAA;EAN0C;EAQ1C,SAAA;EARsC;EAUtC,MAAA;EARA;EAUA,KAAA,GAAQ,SAAA;EARI;EAUZ,IAAA;EANA;EAQA,OAAA,EAAS,eAAA;EAJT;EAMA,MAAA;EAJA;EAMA,OAAA,GAAU,SAAA;AAAA;;;;;cAON,SAAA;EAAa,SAAA;EAAA,SAAA;EAAA,MAAA;EAAA,IAAA;EAAA,OAAA;EAAA,OAAA;EAAA,GAAA;AAAA,GAQhB,cAAA,KAAiB,YAAA"}

package/dist/{index-CY2Mpaz3.d.cts → index-o0UcZG4n.d.cts}

@@ -1,10 +1,9 @@
-import { t as TVReturnType } from "./index-DsC0y6kU.cjs";
 import { TVClassName, TVProps } from "@fuf-stack/pixel-utils";
 import { ReactElement, ReactNode } from "react";
 import { TabsProps } from "@fuf-stack/pixels";
 
 //#region src/RadioTabs/RadioTabs.d.ts
-declare const radioTabsVariants: TVReturnType<{
+declare const radioTabsVariants: import("tailwind-variants").TVReturnType<{
   hasContent: {
     true: {
       base: string;
@@ -62,7 +61,7 @@ declare const radioTabsVariants: TVReturnType<{
   tabPanel: string;
   tabWrapper: string;
   wrapper: string;
-}, TVReturnType<{
+}, import("tailwind-variants").TVReturnType<{
   hasContent: {
     true: {
       base: string;
@@ -145,4 +144,4 @@ declare const RadioTabs: ({
 }: RadioTabsProps) => ReactElement;
 //#endregion
 export { RadioTabsProps as n, RadioTabs as t };
-//# sourceMappingURL=index-CY2Mpaz3.d.cts.map
+//# sourceMappingURL=index-o0UcZG4n.d.cts.map

package/dist/index-o0UcZG4n.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-o0UcZG4n.d.cts","names":[],"sources":["../src/RadioTabs/RadioTabs.tsx"],"mappings":";;;;;cAgBa,iBAAA,8BAAiB,YAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAwCzB,YAAA,GAAe,OAAO,QAAQ,iBAAA;AAAA,KAC9B,SAAA,GAAY,WAAW,QAAQ,iBAAA;AAAA,UAEnB,eAAA;EAEf;EAAA,OAAA,GAAU,SAAA;EAEV;EAAA,QAAA;EAEQ;EAAR,KAAA,GAAQ,SAAA;EAED;EAAP,IAAA,GAAO,SAAA;EAIP;EAFA,MAAA;EAEK;EAAL,KAAA;AAAA;AAAA,UAGe,cAAA,SAAuB,IAAA,CAAK,YAAA;EAAA;EAE3C,SAAA;EAUQ;EARR,SAAA,GAAY,SAAA;EAgBF;EAdV,QAAA;EAN0C;EAQ1C,SAAA;EARsC;EAUtC,MAAA;EARA;EAUA,KAAA,GAAQ,SAAA;EARI;EAUZ,IAAA;EANA;EAQA,OAAA,EAAS,eAAA;EAJT;EAMA,MAAA;EAJA;EAMA,OAAA,GAAU,SAAA;AAAA;;;;;cAON,SAAA;EAAa,SAAA;EAAA,SAAA;EAAA,MAAA;EAAA,IAAA;EAAA,OAAA;EAAA,OAAA;EAAA,GAAA;AAAA,GAQhB,cAAA,KAAiB,YAAA"}

package/dist/index.d.cts

@@ -1,28 +1,28 @@
-import { i as useInputValueTransform, n as UseInputValueTransformOptions, r as UseInputValueTransformReturn, t as InputValueTransform } from "./useInputValueTransform-BwAfw8Xb.cjs";
-import { n as Checkboxes, r as CheckboxesProps, t as CheckboxOption } from "./index-BdYKQ59a.cjs";
-import { i as FieldArrayProps, n as FieldArrayChildrenRenderFn, r as FieldArrayFeatures, t as FieldArray } from "./index-D6XwSwTP.cjs";
-import { n as FieldCardProps, r as fieldCardVariants, t as FieldCard } from "./index-C-DiLZRu.cjs";
-import { n as FormProps, t as Form } from "./index-NjKV8LJD.cjs";
-import { n as GridProps, t as Grid } from "./index-BV1VKQdy.cjs";
-import { n as InputProps, t as Input } from "./index-B2tIMFYh.cjs";
-import { n as RadioBoxes, r as RadioBoxesProps, t as radioBoxVariants } from "./index-1Gzrph8R.cjs";
-import { n as RadioTabsProps, t as RadioTabs } from "./index-CY2Mpaz3.cjs";
-import { n as RadiosProps, t as Radios } from "./index-CKJumX37.cjs";
-import { n as SelectProps, t as Select } from "./index-2Xp98tj6.cjs";
-import { n as SliderProps, t as Slider } from "./index-B_ypeYXK.cjs";
-import { n as SubmitButtonProps, t as SubmitButton } from "./index-DkiQkdCW.cjs";
-import { n as SwitchProps, t as Switch } from "./index-DzWt2C-B.cjs";
-import { n as SwitchBoxProps, r as switchBoxVariants, t as SwitchBox } from "./index-pwXVq8hR.cjs";
-import { n as TextAreaProps, t as TextArea } from "./index-DZzfeV4O.cjs";
+import { i as useInputValueTransform, n as UseInputValueTransformOptions, r as UseInputValueTransformReturn, t as InputValueTransform } from "./useInputValueTransform-CNCBU7a9.cjs";
+import { n as Checkboxes, r as CheckboxesProps, t as CheckboxOption } from "./index-DRg0anjB.cjs";
+import { i as FieldArrayProps, n as FieldArrayChildrenRenderFn, r as FieldArrayFeatures, t as FieldArray } from "./index-3gVUFqgo.cjs";
+import { n as FieldCardProps, r as fieldCardVariants, t as FieldCard } from "./index-E28aP0vt.cjs";
+import { n as FormProps, t as Form } from "./index-BeP-RWud.cjs";
+import { n as GridProps, t as Grid } from "./index-CDcnRyum.cjs";
+import { n as InputProps, t as Input } from "./index-A8Jhitar.cjs";
+import { n as RadioBoxes, r as RadioBoxesProps, t as radioBoxVariants } from "./index-Dz1C3MeK.cjs";
+import { n as RadioTabsProps, t as RadioTabs } from "./index-o0UcZG4n.cjs";
+import { n as RadiosProps, t as Radios } from "./index-C_3x4Vph.cjs";
+import { n as SelectProps, t as Select } from "./index-KbsTT3uf.cjs";
+import { n as SliderProps, t as Slider } from "./index-eEJp36Ma.cjs";
+import { n as SubmitButtonProps, t as SubmitButton } from "./index-GP_4Xvec.cjs";
+import { n as SwitchProps, t as Switch } from "./index-CD9w4hqS.cjs";
+import { n as SwitchBoxProps, r as switchBoxVariants, t as SwitchBox } from "./index-Ck9lrzur.cjs";
+import { n as TextAreaProps, t as TextArea } from "./index-A88y8cpH.cjs";
 import { createOptionValueConverter, flatArrayKey, fromNullishString, isValueEmpty, nameToTestId, toFormFormat, toNullishString, toSubmitFormat, toValidationFormat } from "./helpers/index.cjs";
-import { n as useClientValidation, t as clientValidationSchemaByName } from "./useClientValidation-DtnfCE5T.cjs";
-import { n as UseControllerReturn, r as useController, t as UseControllerProps } from "./useController-CNiqy_2D.cjs";
-import { n as useFormContext, t as checkFieldIsRequired } from "./useFormContext-Dey5DbWr.cjs";
-import { t as useInput } from "./useInput-93TCCrkB.cjs";
-import { n as UseInputValueDebounceReturn, r as useInputValueDebounce, t as UseInputValueDebounceOptions } from "./useInputValueDebounce-puGRVJ6t.cjs";
-import { n as UseUniformFieldReturn, r as useUniformField, t as UseUniformFieldParams } from "./useUniformField-DB8jF52F.cjs";
-import { n as useUniformFieldArray, t as UseUniformFieldArrayProps } from "./useUniformFieldArray-okvikMJp.cjs";
-import { n as useWatchUserChange, t as UseWatchUserChangeOptions } from "./useWatchUserChange-CZu_ZZ38.cjs";
-import { n as FieldCopyTestIdButtonProps, t as FieldCopyTestIdButton } from "./index-jCfJAgDc.cjs";
-import { n as FieldValidationErrorProps, t as FieldValidationError } from "./index-Dld6NP_K.cjs";
-export { CheckboxOption, Checkboxes, CheckboxesProps, FieldArray, FieldArrayChildrenRenderFn, FieldArrayFeatures, FieldArrayProps, FieldCard, FieldCardProps, FieldCopyTestIdButton, FieldCopyTestIdButtonProps, FieldValidationError, FieldValidationErrorProps, Form, FormProps, Grid, GridProps, Input, InputProps, InputValueTransform, RadioBoxes, RadioBoxesProps, RadioTabs, RadioTabsProps, Radios, RadiosProps, Select, SelectProps, Slider, SliderProps, SubmitButton, SubmitButtonProps, Switch, SwitchBox, SwitchBoxProps, SwitchProps, TextArea, TextAreaProps, UseControllerProps, UseControllerReturn, UseInputValueDebounceOptions, UseInputValueDebounceReturn, UseInputValueTransformOptions, UseInputValueTransformReturn, UseUniformFieldArrayProps, UseUniformFieldParams, UseUniformFieldReturn, UseWatchUserChangeOptions, checkFieldIsRequired, clientValidationSchemaByName, createOptionValueConverter, fieldCardVariants, flatArrayKey, fromNullishString, isValueEmpty, nameToTestId, radioBoxVariants, switchBoxVariants, toFormFormat, toNullishString, toSubmitFormat, toValidationFormat, useClientValidation, useController, useFormContext, useInput, useInputValueDebounce, useInputValueTransform, useUniformField, useUniformFieldArray, useWatchUserChange };
+import { n as useClientValidation, t as clientValidationSchemaByName } from "./useClientValidation-BMzOi3DZ.cjs";
+import { n as UseControllerReturn, r as useController, t as UseControllerProps } from "./useController-kxcnnsXy.cjs";
+import { n as useFormContext, t as checkFieldIsRequired } from "./useFormContext-JE8dwbCT.cjs";
+import { t as useInput } from "./useInput-8kDcm77k.cjs";
+import { n as UseInputValueDebounceReturn, r as useInputValueDebounce, t as UseInputValueDebounceOptions } from "./useInputValueDebounce-nHt1AHRm.cjs";
+import { n as UseUniformFieldReturn, r as useUniformField, t as UseUniformFieldParams } from "./useUniformField-BWKBsUEX.cjs";
+import { n as useUniformFieldArray, t as UseUniformFieldArrayProps } from "./useUniformFieldArray-RvOYml8h.cjs";
+import { n as useWatchUserChange, t as UseWatchUserChangeOptions } from "./useWatchUserChange-26IF7Ikq.cjs";
+import { n as FieldCopyTestIdButtonProps, t as FieldCopyTestIdButton } from "./index-BqiVSpJW.cjs";
+import { n as FieldValidationErrorProps, t as FieldValidationError } from "./index-CqyMqRhI.cjs";
+export { type CheckboxOption, Checkboxes, type CheckboxesProps, FieldArray, type FieldArrayChildrenRenderFn, type FieldArrayFeatures, type FieldArrayProps, FieldCard, type FieldCardProps, FieldCopyTestIdButton, type FieldCopyTestIdButtonProps, FieldValidationError, type FieldValidationErrorProps, Form, type FormProps, Grid, type GridProps, Input, type InputProps, InputValueTransform, RadioBoxes, type RadioBoxesProps, RadioTabs, type RadioTabsProps, Radios, type RadiosProps, Select, type SelectProps, Slider, type SliderProps, SubmitButton, type SubmitButtonProps, Switch, SwitchBox, type SwitchBoxProps, type SwitchProps, TextArea, type TextAreaProps, UseControllerProps, UseControllerReturn, UseInputValueDebounceOptions, UseInputValueDebounceReturn, UseInputValueTransformOptions, UseInputValueTransformReturn, UseUniformFieldArrayProps, UseUniformFieldParams, UseUniformFieldReturn, UseWatchUserChangeOptions, checkFieldIsRequired, clientValidationSchemaByName, createOptionValueConverter, fieldCardVariants, flatArrayKey, fromNullishString, isValueEmpty, nameToTestId, radioBoxVariants, switchBoxVariants, toFormFormat, toNullishString, toSubmitFormat, toValidationFormat, useClientValidation, useController, useFormContext, useInput, useInputValueDebounce, useInputValueTransform, useUniformField, useUniformFieldArray, useWatchUserChange };

package/dist/index.d.ts

@@ -1,28 +1,28 @@
-import { i as useInputValueTransform, n as UseInputValueTransformOptions, r as UseInputValueTransformReturn, t as InputValueTransform } from "./useInputValueTransform-CdoaxNyD.js";
-import { n as Checkboxes, r as CheckboxesProps, t as CheckboxOption } from "./index-CE0aQlFw.js";
-import { i as FieldArrayProps, n as FieldArrayChildrenRenderFn, r as FieldArrayFeatures, t as FieldArray } from "./index-fgARdsoB.js";
-import { n as FieldCardProps, r as fieldCardVariants, t as FieldCard } from "./index-BwAI1VFS.js";
-import { n as FormProps, t as Form } from "./index-Dj3NDj0T.js";
-import { n as GridProps, t as Grid } from "./index-Cv4ERj3i.js";
-import { n as InputProps, t as Input } from "./index-BExpqT81.js";
-import { n as RadioBoxes, r as RadioBoxesProps, t as radioBoxVariants } from "./index-DJe_1ZdK.js";
-import { n as RadioTabsProps, t as RadioTabs } from "./index-DD_RPe91.js";
-import { n as RadiosProps, t as Radios } from "./index-DpNf55K6.js";
-import { n as SelectProps, t as Select } from "./index-1PiP0cNG.js";
-import { n as SliderProps, t as Slider } from "./index-Buvn5zuQ.js";
-import { n as SubmitButtonProps, t as SubmitButton } from "./index-DFWSHdua.js";
-import { n as SwitchProps, t as Switch } from "./index-CgDykuQk.js";
-import { n as SwitchBoxProps, r as switchBoxVariants, t as SwitchBox } from "./index-wV1E_PkS.js";
-import { n as TextAreaProps, t as TextArea } from "./index-CZJ_lWQ0.js";
+import { i as useInputValueTransform, n as UseInputValueTransformOptions, r as UseInputValueTransformReturn, t as InputValueTransform } from "./useInputValueTransform-C51LmUxi.js";
+import { n as Checkboxes, r as CheckboxesProps, t as CheckboxOption } from "./index-DdqwwvOD.js";
+import { i as FieldArrayProps, n as FieldArrayChildrenRenderFn, r as FieldArrayFeatures, t as FieldArray } from "./index-D7qJy705.js";
+import { n as FieldCardProps, r as fieldCardVariants, t as FieldCard } from "./index-S4bOYm9e.js";
+import { n as FormProps, t as Form } from "./index-BFpoR6oH.js";
+import { n as GridProps, t as Grid } from "./index-DqTdG65C.js";
+import { n as InputProps, t as Input } from "./index-5_7F4o-d.js";
+import { n as RadioBoxes, r as RadioBoxesProps, t as radioBoxVariants } from "./index-D-UGVdC1.js";
+import { n as RadioTabsProps, t as RadioTabs } from "./index-jIVsGNsl.js";
+import { n as RadiosProps, t as Radios } from "./index-D6QbkuWC.js";
+import { n as SelectProps, t as Select } from "./index-C3yAZbR3.js";
+import { n as SliderProps, t as Slider } from "./index-DTwIpIWh.js";
+import { n as SubmitButtonProps, t as SubmitButton } from "./index-BIefvGtf.js";
+import { n as SwitchProps, t as Switch } from "./index-RCXYx5Yp.js";
+import { n as SwitchBoxProps, r as switchBoxVariants, t as SwitchBox } from "./index-DjPJAUOM.js";
+import { n as TextAreaProps, t as TextArea } from "./index-Cj3P2Pmf.js";
 import { createOptionValueConverter, flatArrayKey, fromNullishString, isValueEmpty, nameToTestId, toFormFormat, toNullishString, toSubmitFormat, toValidationFormat } from "./helpers/index.js";
-import { n as useClientValidation, t as clientValidationSchemaByName } from "./useClientValidation-BWElhQ91.js";
-import { n as UseControllerReturn, r as useController, t as UseControllerProps } from "./useController-Cc0UNQMm.js";
-import { n as useFormContext, t as checkFieldIsRequired } from "./useFormContext-DEMm-bsc.js";
-import { t as useInput } from "./useInput-C_fY--wx.js";
-import { n as UseInputValueDebounceReturn, r as useInputValueDebounce, t as UseInputValueDebounceOptions } from "./useInputValueDebounce-sFOlecIQ.js";
-import { n as UseUniformFieldReturn, r as useUniformField, t as UseUniformFieldParams } from "./useUniformField-iHk8xYXN.js";
-import { n as useUniformFieldArray, t as UseUniformFieldArrayProps } from "./useUniformFieldArray-B0SPtHeT.js";
-import { n as useWatchUserChange, t as UseWatchUserChangeOptions } from "./useWatchUserChange-CH4x16_r.js";
-import { n as FieldCopyTestIdButtonProps, t as FieldCopyTestIdButton } from "./index-B6WwxkLx2.js";
-import { n as FieldValidationErrorProps, t as FieldValidationError } from "./index-DkxqHE_P2.js";
-export { CheckboxOption, Checkboxes, CheckboxesProps, FieldArray, FieldArrayChildrenRenderFn, FieldArrayFeatures, FieldArrayProps, FieldCard, FieldCardProps, FieldCopyTestIdButton, FieldCopyTestIdButtonProps, FieldValidationError, FieldValidationErrorProps, Form, FormProps, Grid, GridProps, Input, InputProps, InputValueTransform, RadioBoxes, RadioBoxesProps, RadioTabs, RadioTabsProps, Radios, RadiosProps, Select, SelectProps, Slider, SliderProps, SubmitButton, SubmitButtonProps, Switch, SwitchBox, SwitchBoxProps, SwitchProps, TextArea, TextAreaProps, UseControllerProps, UseControllerReturn, UseInputValueDebounceOptions, UseInputValueDebounceReturn, UseInputValueTransformOptions, UseInputValueTransformReturn, UseUniformFieldArrayProps, UseUniformFieldParams, UseUniformFieldReturn, UseWatchUserChangeOptions, checkFieldIsRequired, clientValidationSchemaByName, createOptionValueConverter, fieldCardVariants, flatArrayKey, fromNullishString, isValueEmpty, nameToTestId, radioBoxVariants, switchBoxVariants, toFormFormat, toNullishString, toSubmitFormat, toValidationFormat, useClientValidation, useController, useFormContext, useInput, useInputValueDebounce, useInputValueTransform, useUniformField, useUniformFieldArray, useWatchUserChange };
+import { n as useClientValidation, t as clientValidationSchemaByName } from "./useClientValidation-BTbGUViN.js";
+import { n as UseControllerReturn, r as useController, t as UseControllerProps } from "./useController-BK2AeY9L.js";
+import { n as useFormContext, t as checkFieldIsRequired } from "./useFormContext-BYnHt6-m.js";
+import { t as useInput } from "./useInput-Che-4SjF.js";
+import { n as UseInputValueDebounceReturn, r as useInputValueDebounce, t as UseInputValueDebounceOptions } from "./useInputValueDebounce-D03GnJO4.js";
+import { n as UseUniformFieldReturn, r as useUniformField, t as UseUniformFieldParams } from "./useUniformField-B3Dj8K5J.js";
+import { n as useUniformFieldArray, t as UseUniformFieldArrayProps } from "./useUniformFieldArray-C0U3eBr7.js";
+import { n as useWatchUserChange, t as UseWatchUserChangeOptions } from "./useWatchUserChange-BjRKMix1.js";
+import { n as FieldCopyTestIdButtonProps, t as FieldCopyTestIdButton } from "./index-ZRXr-4Rb2.js";
+import { n as FieldValidationErrorProps, t as FieldValidationError } from "./index-K42ASvjk2.js";
+export { type CheckboxOption, Checkboxes, type CheckboxesProps, FieldArray, type FieldArrayChildrenRenderFn, type FieldArrayFeatures, type FieldArrayProps, FieldCard, type FieldCardProps, FieldCopyTestIdButton, type FieldCopyTestIdButtonProps, FieldValidationError, type FieldValidationErrorProps, Form, type FormProps, Grid, type GridProps, Input, type InputProps, InputValueTransform, RadioBoxes, type RadioBoxesProps, RadioTabs, type RadioTabsProps, Radios, type RadiosProps, Select, type SelectProps, Slider, type SliderProps, SubmitButton, type SubmitButtonProps, Switch, SwitchBox, type SwitchBoxProps, type SwitchProps, TextArea, type TextAreaProps, UseControllerProps, UseControllerReturn, UseInputValueDebounceOptions, UseInputValueDebounceReturn, UseInputValueTransformOptions, UseInputValueTransformReturn, UseUniformFieldArrayProps, UseUniformFieldParams, UseUniformFieldReturn, UseWatchUserChangeOptions, checkFieldIsRequired, clientValidationSchemaByName, createOptionValueConverter, fieldCardVariants, flatArrayKey, fromNullishString, isValueEmpty, nameToTestId, radioBoxVariants, switchBoxVariants, toFormFormat, toNullishString, toSubmitFormat, toValidationFormat, useClientValidation, useController, useFormContext, useInput, useInputValueDebounce, useInputValueTransform, useUniformField, useUniformFieldArray, useWatchUserChange };

package/dist/partials/FieldCopyTestIdButton/index.d.cts

@@ -1,2 +1,2 @@
-import { n as FieldCopyTestIdButtonProps, t as FieldCopyTestIdButton } from "../../index-jCfJAgDc.cjs";
-export { FieldCopyTestIdButton, FieldCopyTestIdButton as default, FieldCopyTestIdButtonProps };
+import { n as FieldCopyTestIdButtonProps, t as FieldCopyTestIdButton } from "../../index-BqiVSpJW.cjs";
+export { FieldCopyTestIdButton, FieldCopyTestIdButton as default, type FieldCopyTestIdButtonProps };

package/dist/partials/FieldCopyTestIdButton/index.d.ts

@@ -1,2 +1,2 @@
-import { n as FieldCopyTestIdButtonProps, t as FieldCopyTestIdButton } from "../../index-B6WwxkLx2.js";
-export { FieldCopyTestIdButton, FieldCopyTestIdButton as default, FieldCopyTestIdButtonProps };
+import { n as FieldCopyTestIdButtonProps, t as FieldCopyTestIdButton } from "../../index-ZRXr-4Rb2.js";
+export { FieldCopyTestIdButton, FieldCopyTestIdButton as default, type FieldCopyTestIdButtonProps };

package/dist/partials/FieldValidationError/index.d.cts

@@ -1,2 +1,2 @@
-import { n as FieldValidationErrorProps, t as FieldValidationError } from "../../index-Dld6NP_K.cjs";
-export { FieldValidationError, FieldValidationError as default, FieldValidationErrorProps };
+import { n as FieldValidationErrorProps, t as FieldValidationError } from "../../index-CqyMqRhI.cjs";
+export { FieldValidationError, FieldValidationError as default, type FieldValidationErrorProps };

package/dist/partials/FieldValidationError/index.d.ts

@@ -1,2 +1,2 @@
-import { n as FieldValidationErrorProps, t as FieldValidationError } from "../../index-DkxqHE_P2.js";
-export { FieldValidationError, FieldValidationError as default, FieldValidationErrorProps };
+import { n as FieldValidationErrorProps, t as FieldValidationError } from "../../index-K42ASvjk2.js";
+export { FieldValidationError, FieldValidationError as default, type FieldValidationErrorProps };

package/dist/{useClientValidation-DtnfCE5T.d.cts → useClientValidation-BMzOi3DZ.d.cts}

@@ -145,4 +145,4 @@ declare const useClientValidation: <TData = unknown>(data: TData | null | undefi
 declare const clientValidationSchemaByName: <T extends VetoTypeAny>(name: string, fieldSchema: T) => VetoTypeAny;
 //#endregion
 export { useClientValidation as n, clientValidationSchemaByName as t };
-//# sourceMappingURL=useClientValidation-DtnfCE5T.d.cts.map
+//# sourceMappingURL=useClientValidation-BMzOi3DZ.d.cts.map

package/dist/useClientValidation-BMzOi3DZ.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClientValidation-BMzOi3DZ.d.cts","names":[],"sources":["../src/hooks/useClientValidation/useClientValidation.ts"],"mappings":";;;;;AAkEA;;;;;;;;;;;;;;;;;;AAG4B;AA+H5B;;;;;;;;;;;;;;;AAqCC;;;;;;;;;;;;;;;;;;;;;cAvKY,mBAAA,oBACX,IAAA,EAAM,KAAA,qBACN,aAAA,GAAgB,IAAA,EAAM,KAAA,KAAU,WAAA,EAChC,OAAA;EAAY,GAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA+HD,4BAAA,aAA0C,WAAA,EACrD,IAAA,UACA,WAAA,EAAa,CAAA,KAAC,WAAA"}

package/dist/{useClientValidation-BWElhQ91.d.ts → useClientValidation-BTbGUViN.d.ts}

@@ -145,4 +145,4 @@ declare const useClientValidation: <TData = unknown>(data: TData | null | undefi
 declare const clientValidationSchemaByName: <T extends VetoTypeAny>(name: string, fieldSchema: T) => VetoTypeAny;
 //#endregion
 export { useClientValidation as n, clientValidationSchemaByName as t };
-//# sourceMappingURL=useClientValidation-BWElhQ91.d.ts.map
+//# sourceMappingURL=useClientValidation-BTbGUViN.d.ts.map

package/dist/useClientValidation-BTbGUViN.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClientValidation-BTbGUViN.d.ts","names":[],"sources":["../src/hooks/useClientValidation/useClientValidation.ts"],"mappings":";;;;;AAkEA;;;;;;;;;;;;;;;;;;AAG4B;AA+H5B;;;;;;;;;;;;;;;AAqCC;;;;;;;;;;;;;;;;;;;;;cAvKY,mBAAA,oBACX,IAAA,EAAM,KAAA,qBACN,aAAA,GAAgB,IAAA,EAAM,KAAA,KAAU,WAAA,EAChC,OAAA;EAAY,GAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA+HD,4BAAA,aAA0C,WAAA,EACrD,IAAA,UACA,WAAA,EAAa,CAAA,KAAC,WAAA"}

package/dist/useClientValidation-Dn_kJkE5.js.map

@@ -1 +1 @@
-{"version":3,"file":"useClientValidation-Dn_kJkE5.js","names":[],"sources":["../src/hooks/useClientValidation/useClientValidation.ts"],"sourcesContent":["import type { VetoTypeAny } from '@fuf-stack/veto';\n\nimport { useEffect, useId } from 'react';\n\nimport { array, objectLoose } from '@fuf-stack/veto';\n\nimport { flatArrayKey } from '../../helpers';\nimport { useFormContext } from '../useFormContext/useFormContext';\n\n/**\n * Hook for adding dynamic client-side validation to forms.\n *\n * Client validation is used for context-dependent validation rules that require external data\n * (e.g., checking if a username already exists). It complements base validation (passed to Form),\n * which handles static rules like \"required\", min/max length, format, etc.\n *\n * **Typical pattern:**\n * - Base validation: Static, always-on rules (required, format, length constraints)\n * - Client validation: Dynamic rules based on external data (uniqueness, business logic)\n * - Client schemas should use `.nullish()` to allow empty values (base validation handles \"required\")\n *\n * Automatically manages validation schema lifecycle: sets schema when data is provided,\n * clears schema when data is null/undefined, and cleans up on unmount. When the client\n * validation schema changes, automatically re-validates all touched fields.\n *\n * @param data - Data to create validation schema from (or null/undefined to clear validation)\n * @param schemaFactory - Function that creates a validation schema from the data. Schemas should typically use `.nullish()`.\n * @param options - Optional configuration object\n * @param options.key - Optional custom key for registration. Useful when multiple instances should share validation (e.g., in field arrays)\n *\n * @example\n * ```tsx\n * // Base validation handles \"required\" and format\n * const baseSchema = veto({ username: vt.string({ min: 3 }) });\n *\n * // Client validation adds dynamic uniqueness check\n * const { data: teamData } = useTeamQuery(teamId);\n * useClientValidation(teamData, (data) =>\n *   vt.objectLoose({\n *     username: vt.string()\n *       .refine(\n *         (value) => !data.existingUsers.includes(value),\n *         { message: 'Username already exists' }\n *       )\n *       .nullish() // Allow empty - base validation handles \"required\"\n *   })\n * );\n * ```\n *\n * @example\n * ```tsx\n * // Using custom key in a field array to avoid multiple registrations\n * fields.map((field, index) => (\n *   useClientValidation(\n *     userData,\n *     (data) => clientValidationSchemaByName(\n *       `items.${index}.name`,\n *       vt.string()\n *         .refine((val) => !data.forbidden.includes(val), { message: 'Name not allowed' })\n *         .nullish()\n *     ),\n *     { key: 'items-validation' } // All instances share the same key\n *   )\n * ));\n * ```\n */\nexport const useClientValidation = <TData = unknown>(\n  data: TData | null | undefined,\n  schemaFactory: (data: TData) => VetoTypeAny,\n  options?: { key?: string },\n): void => {\n  const {\n    formState: { touchedFields },\n    validation: { setClientValidationSchema },\n    trigger,\n  } = useFormContext();\n\n  // Use provided key or auto-generate unique key\n  const autoGeneratedKey = useId();\n  const key = options?.key ?? autoGeneratedKey;\n\n  // Use data hash instead of object reference to avoid unnecessary re-runs\n  // when data object reference changes but data remains the same\n  const dataHash = JSON.stringify(data);\n\n  // Single effect to manage validation schema lifecycle\n  useEffect(() => {\n    // Set validation schema when data is available\n    if (data != null) {\n      const validationSchema = schemaFactory(data);\n      setClientValidationSchema(key, validationSchema);\n    } else {\n      // Clear validation schema when no data\n      setClientValidationSchema(key, null);\n    }\n\n    // Re-validate all touched fields when client validation schema changes\n    const touchedFieldNames = Object.keys(touchedFields);\n    if (touchedFieldNames.length > 0) {\n      // Use setTimeout to ensure the client validation schema update has propagated\n      // before triggering re-validation (fixes race condition)\n      setTimeout(async () => {\n        return trigger(touchedFieldNames);\n      }, 1);\n    }\n\n    // Cleanup on unmount or when dependencies change\n    return () => {\n      setClientValidationSchema(key, null);\n    };\n    // Only re-run when data (dataHash) or key changes\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [dataHash, key]);\n};\n\n/**\n * Helper function to create a veto looseObject schema for a single field with nested path support.\n *\n * Parses field paths (dot-notation) and creates properly nested loose object schemas with array support.\n * All intermediate objects and arrays are marked as optional to allow partial data structures.\n * Numeric segments in the path are treated as array indices, and the parent field is wrapped in an array schema.\n * Supports flat arrays (arrays of primitives) via the special `__FLAT__` key.\n *\n * **Important:** The fieldSchema should typically use `.nullish()` to allow empty values. This is because:\n * - Base validation (passed to Form) handles \"required\" constraints\n * - Client validation adds dynamic, context-dependent rules (e.g., \"username already exists\")\n * - Form data processing converts empty strings in flat arrays to `null` (not `undefined`)\n * - `.nullish()` accepts both `null` and `undefined`, while `.optional()` only accepts `undefined`\n *\n * This pattern ensures client validation only validates non-empty values, while base validation\n * enforces required fields and basic constraints (min length, format, etc.).\n *\n * @param name - The dot-separated path to the field (e.g., 'username', 'user.profile.email', 'items.0.name', 'tags.0.__FLAT__')\n * @param fieldSchema - The veto validation schema for the field. Should typically use `.nullish()` to allow empty values.\n * @returns A nested loose object schema matching the field path structure with proper type inference\n *\n * @example\n * ```tsx\n * // Typical usage: base validation handles \"required\", client validation adds dynamic rules\n * // Base validation (in Form component)\n * const baseSchema = veto({ username: vt.string({ min: 3 }) }); // Required + min length\n *\n * // Client validation (dynamic check for existing usernames)\n * const { data: userData } = useUserQuery(userId);\n * useClientValidation(userData, (data) =>\n *   clientValidationSchemaByName(\n *     'username',\n *     vt.string()\n *       .refine(\n *         (value) => !data.existingUsernames.includes(value),\n *         { message: 'Username already taken' }\n *       )\n *       .nullish() // Allow empty - base validation handles \"required\"\n *   )\n * );\n * ```\n *\n * @example\n * ```tsx\n * // Nested field path with dynamic validation\n * clientValidationSchemaByName(\n *   'user.profile.email',\n *   vt.string()\n *     .refine(\n *       (value) => !reservedEmails.includes(value),\n *       { message: 'This email is reserved' }\n *     )\n *     .nullish()\n * )\n * // => objectLoose({ user: objectLoose({ profile: objectLoose({ email: ... }).optional() }).optional() })\n * ```\n *\n * @example\n * ```tsx\n * // Array of objects with dynamic validation\n * clientValidationSchemaByName(\n *   'items.0.tag',\n *   vt.string()\n *     .refine((value) => !forbiddenTags.includes(value), { message: 'Tag not allowed' })\n *     .nullish()\n * )\n * // => objectLoose({ items: array(objectLoose({ tag: ... })).optional() })\n * ```\n *\n * @example\n * ```tsx\n * // Flat array (array of primitives) with dynamic validation\n * clientValidationSchemaByName(\n *   'tags.0.__FLAT__',\n *   vt.string()\n *     .refine((value) => !forbiddenWords.includes(value), { message: 'Word not allowed' })\n *     .nullish()\n * )\n * // => objectLoose({ tags: array(vt.string().refine(...).nullish()).optional() })\n * ```\n */\nexport const clientValidationSchemaByName = <T extends VetoTypeAny>(\n  name: string,\n  fieldSchema: T,\n) => {\n  const segments = name.split('.');\n\n  // Build schema from innermost to outermost\n  let schema: VetoTypeAny = fieldSchema;\n\n  // Process segments in reverse order to build nested structure\n  for (let i = segments.length - 1; i >= 0; i -= 1) {\n    const segment = segments[i];\n\n    const isNumeric = /^\\d+$/.test(segment);\n    const isFlatArrayKey = segment === flatArrayKey;\n\n    if (isFlatArrayKey) {\n      // Skip the __FLAT__ key - it's just a marker for flat arrays\n      // The schema is already correct (primitive type), just continue\n      // eslint-disable-next-line no-continue\n      continue;\n    }\n\n    if (isNumeric) {\n      // Current segment is an array index - wrap current schema in optional array\n      schema = array(schema).optional();\n    } else {\n      // Current segment is a field name - wrap in objectLoose\n      // Make it optional if it's an intermediate object (not the root)\n      const obj = objectLoose({\n        [segment]: schema,\n      });\n      schema = i > 0 ? obj.optional() : obj;\n    }\n  }\n\n  return schema;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkEA,MAAa,uBACX,MACA,eACA,YACS;CACT,MAAM,EACJ,WAAW,EAAE,iBACb,YAAY,EAAE,6BACd,YACE,gBAAgB;CAGpB,MAAM,mBAAmB,OAAO;CAChC,MAAM,MAAM,SAAS,OAAO;AAO5B,iBAAgB;AAEd,MAAI,QAAQ,KAEV,2BAA0B,KADD,cAAc,KACQ,CAAC;MAGhD,2BAA0B,KAAK,KAAK;EAItC,MAAM,oBAAoB,OAAO,KAAK,cAAc;AACpD,MAAI,kBAAkB,SAAS,EAG7B,YAAW,YAAY;AACrB,UAAO,QAAQ,kBAAkB;KAChC,EAAE;AAIP,eAAa;AACX,6BAA0B,KAAK,KAAK;;IAIrC,CA7Bc,KAAK,UAAU,KA6BpB,EAAE,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoFrB,MAAa,gCACX,MACA,gBACG;CACH,MAAM,WAAW,KAAK,MAAM,IAAI;CAGhC,IAAI,SAAsB;AAG1B,MAAK,IAAI,IAAI,SAAS,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG;EAChD,MAAM,UAAU,SAAS;EAEzB,MAAM,YAAY,QAAQ,KAAK,QAAQ;AAGvC,MAFuB,YAAA,WAMrB;AAGF,MAAI,UAEF,UAAS,MAAM,OAAO,CAAC,UAAU;OAC5B;GAGL,MAAM,MAAM,YAAY,GACrB,UAAU,QACZ,CAAC;AACF,YAAS,IAAI,IAAI,IAAI,UAAU,GAAG;;;AAItC,QAAO"}
+{"version":3,"file":"useClientValidation-Dn_kJkE5.js","names":[],"sources":["../src/hooks/useClientValidation/useClientValidation.ts"],"sourcesContent":["import type { VetoTypeAny } from '@fuf-stack/veto';\n\nimport { useEffect, useId } from 'react';\n\nimport { array, objectLoose } from '@fuf-stack/veto';\n\nimport { flatArrayKey } from '../../helpers';\nimport { useFormContext } from '../useFormContext/useFormContext';\n\n/**\n * Hook for adding dynamic client-side validation to forms.\n *\n * Client validation is used for context-dependent validation rules that require external data\n * (e.g., checking if a username already exists). It complements base validation (passed to Form),\n * which handles static rules like \"required\", min/max length, format, etc.\n *\n * **Typical pattern:**\n * - Base validation: Static, always-on rules (required, format, length constraints)\n * - Client validation: Dynamic rules based on external data (uniqueness, business logic)\n * - Client schemas should use `.nullish()` to allow empty values (base validation handles \"required\")\n *\n * Automatically manages validation schema lifecycle: sets schema when data is provided,\n * clears schema when data is null/undefined, and cleans up on unmount. When the client\n * validation schema changes, automatically re-validates all touched fields.\n *\n * @param data - Data to create validation schema from (or null/undefined to clear validation)\n * @param schemaFactory - Function that creates a validation schema from the data. Schemas should typically use `.nullish()`.\n * @param options - Optional configuration object\n * @param options.key - Optional custom key for registration. Useful when multiple instances should share validation (e.g., in field arrays)\n *\n * @example\n * ```tsx\n * // Base validation handles \"required\" and format\n * const baseSchema = veto({ username: vt.string({ min: 3 }) });\n *\n * // Client validation adds dynamic uniqueness check\n * const { data: teamData } = useTeamQuery(teamId);\n * useClientValidation(teamData, (data) =>\n *   vt.objectLoose({\n *     username: vt.string()\n *       .refine(\n *         (value) => !data.existingUsers.includes(value),\n *         { message: 'Username already exists' }\n *       )\n *       .nullish() // Allow empty - base validation handles \"required\"\n *   })\n * );\n * ```\n *\n * @example\n * ```tsx\n * // Using custom key in a field array to avoid multiple registrations\n * fields.map((field, index) => (\n *   useClientValidation(\n *     userData,\n *     (data) => clientValidationSchemaByName(\n *       `items.${index}.name`,\n *       vt.string()\n *         .refine((val) => !data.forbidden.includes(val), { message: 'Name not allowed' })\n *         .nullish()\n *     ),\n *     { key: 'items-validation' } // All instances share the same key\n *   )\n * ));\n * ```\n */\nexport const useClientValidation = <TData = unknown>(\n  data: TData | null | undefined,\n  schemaFactory: (data: TData) => VetoTypeAny,\n  options?: { key?: string },\n): void => {\n  const {\n    formState: { touchedFields },\n    validation: { setClientValidationSchema },\n    trigger,\n  } = useFormContext();\n\n  // Use provided key or auto-generate unique key\n  const autoGeneratedKey = useId();\n  const key = options?.key ?? autoGeneratedKey;\n\n  // Use data hash instead of object reference to avoid unnecessary re-runs\n  // when data object reference changes but data remains the same\n  const dataHash = JSON.stringify(data);\n\n  // Single effect to manage validation schema lifecycle\n  useEffect(() => {\n    // Set validation schema when data is available\n    if (data != null) {\n      const validationSchema = schemaFactory(data);\n      setClientValidationSchema(key, validationSchema);\n    } else {\n      // Clear validation schema when no data\n      setClientValidationSchema(key, null);\n    }\n\n    // Re-validate all touched fields when client validation schema changes\n    const touchedFieldNames = Object.keys(touchedFields);\n    if (touchedFieldNames.length > 0) {\n      // Use setTimeout to ensure the client validation schema update has propagated\n      // before triggering re-validation (fixes race condition)\n      setTimeout(async () => {\n        return trigger(touchedFieldNames);\n      }, 1);\n    }\n\n    // Cleanup on unmount or when dependencies change\n    return () => {\n      setClientValidationSchema(key, null);\n    };\n    // Only re-run when data (dataHash) or key changes\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [dataHash, key]);\n};\n\n/**\n * Helper function to create a veto looseObject schema for a single field with nested path support.\n *\n * Parses field paths (dot-notation) and creates properly nested loose object schemas with array support.\n * All intermediate objects and arrays are marked as optional to allow partial data structures.\n * Numeric segments in the path are treated as array indices, and the parent field is wrapped in an array schema.\n * Supports flat arrays (arrays of primitives) via the special `__FLAT__` key.\n *\n * **Important:** The fieldSchema should typically use `.nullish()` to allow empty values. This is because:\n * - Base validation (passed to Form) handles \"required\" constraints\n * - Client validation adds dynamic, context-dependent rules (e.g., \"username already exists\")\n * - Form data processing converts empty strings in flat arrays to `null` (not `undefined`)\n * - `.nullish()` accepts both `null` and `undefined`, while `.optional()` only accepts `undefined`\n *\n * This pattern ensures client validation only validates non-empty values, while base validation\n * enforces required fields and basic constraints (min length, format, etc.).\n *\n * @param name - The dot-separated path to the field (e.g., 'username', 'user.profile.email', 'items.0.name', 'tags.0.__FLAT__')\n * @param fieldSchema - The veto validation schema for the field. Should typically use `.nullish()` to allow empty values.\n * @returns A nested loose object schema matching the field path structure with proper type inference\n *\n * @example\n * ```tsx\n * // Typical usage: base validation handles \"required\", client validation adds dynamic rules\n * // Base validation (in Form component)\n * const baseSchema = veto({ username: vt.string({ min: 3 }) }); // Required + min length\n *\n * // Client validation (dynamic check for existing usernames)\n * const { data: userData } = useUserQuery(userId);\n * useClientValidation(userData, (data) =>\n *   clientValidationSchemaByName(\n *     'username',\n *     vt.string()\n *       .refine(\n *         (value) => !data.existingUsernames.includes(value),\n *         { message: 'Username already taken' }\n *       )\n *       .nullish() // Allow empty - base validation handles \"required\"\n *   )\n * );\n * ```\n *\n * @example\n * ```tsx\n * // Nested field path with dynamic validation\n * clientValidationSchemaByName(\n *   'user.profile.email',\n *   vt.string()\n *     .refine(\n *       (value) => !reservedEmails.includes(value),\n *       { message: 'This email is reserved' }\n *     )\n *     .nullish()\n * )\n * // => objectLoose({ user: objectLoose({ profile: objectLoose({ email: ... }).optional() }).optional() })\n * ```\n *\n * @example\n * ```tsx\n * // Array of objects with dynamic validation\n * clientValidationSchemaByName(\n *   'items.0.tag',\n *   vt.string()\n *     .refine((value) => !forbiddenTags.includes(value), { message: 'Tag not allowed' })\n *     .nullish()\n * )\n * // => objectLoose({ items: array(objectLoose({ tag: ... })).optional() })\n * ```\n *\n * @example\n * ```tsx\n * // Flat array (array of primitives) with dynamic validation\n * clientValidationSchemaByName(\n *   'tags.0.__FLAT__',\n *   vt.string()\n *     .refine((value) => !forbiddenWords.includes(value), { message: 'Word not allowed' })\n *     .nullish()\n * )\n * // => objectLoose({ tags: array(vt.string().refine(...).nullish()).optional() })\n * ```\n */\nexport const clientValidationSchemaByName = <T extends VetoTypeAny>(\n  name: string,\n  fieldSchema: T,\n) => {\n  const segments = name.split('.');\n\n  // Build schema from innermost to outermost\n  let schema: VetoTypeAny = fieldSchema;\n\n  // Process segments in reverse order to build nested structure\n  for (let i = segments.length - 1; i >= 0; i -= 1) {\n    const segment = segments[i];\n\n    const isNumeric = /^\\d+$/.test(segment);\n    const isFlatArrayKey = segment === flatArrayKey;\n\n    if (isFlatArrayKey) {\n      // Skip the __FLAT__ key - it's just a marker for flat arrays\n      // The schema is already correct (primitive type), just continue\n      // eslint-disable-next-line no-continue\n      continue;\n    }\n\n    if (isNumeric) {\n      // Current segment is an array index - wrap current schema in optional array\n      schema = array(schema).optional();\n    } else {\n      // Current segment is a field name - wrap in objectLoose\n      // Make it optional if it's an intermediate object (not the root)\n      const obj = objectLoose({\n        [segment]: schema,\n      });\n      schema = i > 0 ? obj.optional() : obj;\n    }\n  }\n\n  return schema;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkEA,MAAa,uBACX,MACA,eACA,YACS;CACT,MAAM,EACJ,WAAW,EAAE,iBACb,YAAY,EAAE,6BACd,YACE,eAAe;CAGnB,MAAM,mBAAmB,MAAM;CAC/B,MAAM,MAAM,SAAS,OAAO;CAO5B,gBAAgB;EAEd,IAAI,QAAQ,MAEV,0BAA0B,KADD,cAAc,IACO,CAAC;OAG/C,0BAA0B,KAAK,IAAI;EAIrC,MAAM,oBAAoB,OAAO,KAAK,aAAa;EACnD,IAAI,kBAAkB,SAAS,GAG7B,WAAW,YAAY;GACrB,OAAO,QAAQ,iBAAiB;EAClC,GAAG,CAAC;EAIN,aAAa;GACX,0BAA0B,KAAK,IAAI;EACrC;CAGF,GAAG,CA7Bc,KAAK,UAAU,IA6BrB,GAAG,GAAG,CAAC;AACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmFA,MAAa,gCACX,MACA,gBACG;CACH,MAAM,WAAW,KAAK,MAAM,GAAG;CAG/B,IAAI,SAAsB;CAG1B,KAAK,IAAI,IAAI,SAAS,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG;EAChD,MAAM,UAAU,SAAS;EAEzB,MAAM,YAAY,QAAQ,KAAK,OAAO;EAGtC,IAFuB,YAAA,YAMrB;EAGF,IAAI,WAEF,SAAS,MAAM,MAAM,EAAE,SAAS;OAC3B;GAGL,MAAM,MAAM,YAAY,GACrB,UAAU,OACb,CAAC;GACD,SAAS,IAAI,IAAI,IAAI,SAAS,IAAI;EACpC;CACF;CAEA,OAAO;AACT"}

package/dist/useClientValidation-NKOuXuHV.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useClientValidation-NKOuXuHV.cjs","names":["useFormContext"],"sources":["../src/hooks/useClientValidation/useClientValidation.ts"],"sourcesContent":["import type { VetoTypeAny } from '@fuf-stack/veto';\n\nimport { useEffect, useId } from 'react';\n\nimport { array, objectLoose } from '@fuf-stack/veto';\n\nimport { flatArrayKey } from '../../helpers';\nimport { useFormContext } from '../useFormContext/useFormContext';\n\n/**\n * Hook for adding dynamic client-side validation to forms.\n *\n * Client validation is used for context-dependent validation rules that require external data\n * (e.g., checking if a username already exists). It complements base validation (passed to Form),\n * which handles static rules like \"required\", min/max length, format, etc.\n *\n * **Typical pattern:**\n * - Base validation: Static, always-on rules (required, format, length constraints)\n * - Client validation: Dynamic rules based on external data (uniqueness, business logic)\n * - Client schemas should use `.nullish()` to allow empty values (base validation handles \"required\")\n *\n * Automatically manages validation schema lifecycle: sets schema when data is provided,\n * clears schema when data is null/undefined, and cleans up on unmount. When the client\n * validation schema changes, automatically re-validates all touched fields.\n *\n * @param data - Data to create validation schema from (or null/undefined to clear validation)\n * @param schemaFactory - Function that creates a validation schema from the data. Schemas should typically use `.nullish()`.\n * @param options - Optional configuration object\n * @param options.key - Optional custom key for registration. Useful when multiple instances should share validation (e.g., in field arrays)\n *\n * @example\n * ```tsx\n * // Base validation handles \"required\" and format\n * const baseSchema = veto({ username: vt.string({ min: 3 }) });\n *\n * // Client validation adds dynamic uniqueness check\n * const { data: teamData } = useTeamQuery(teamId);\n * useClientValidation(teamData, (data) =>\n *   vt.objectLoose({\n *     username: vt.string()\n *       .refine(\n *         (value) => !data.existingUsers.includes(value),\n *         { message: 'Username already exists' }\n *       )\n *       .nullish() // Allow empty - base validation handles \"required\"\n *   })\n * );\n * ```\n *\n * @example\n * ```tsx\n * // Using custom key in a field array to avoid multiple registrations\n * fields.map((field, index) => (\n *   useClientValidation(\n *     userData,\n *     (data) => clientValidationSchemaByName(\n *       `items.${index}.name`,\n *       vt.string()\n *         .refine((val) => !data.forbidden.includes(val), { message: 'Name not allowed' })\n *         .nullish()\n *     ),\n *     { key: 'items-validation' } // All instances share the same key\n *   )\n * ));\n * ```\n */\nexport const useClientValidation = <TData = unknown>(\n  data: TData | null | undefined,\n  schemaFactory: (data: TData) => VetoTypeAny,\n  options?: { key?: string },\n): void => {\n  const {\n    formState: { touchedFields },\n    validation: { setClientValidationSchema },\n    trigger,\n  } = useFormContext();\n\n  // Use provided key or auto-generate unique key\n  const autoGeneratedKey = useId();\n  const key = options?.key ?? autoGeneratedKey;\n\n  // Use data hash instead of object reference to avoid unnecessary re-runs\n  // when data object reference changes but data remains the same\n  const dataHash = JSON.stringify(data);\n\n  // Single effect to manage validation schema lifecycle\n  useEffect(() => {\n    // Set validation schema when data is available\n    if (data != null) {\n      const validationSchema = schemaFactory(data);\n      setClientValidationSchema(key, validationSchema);\n    } else {\n      // Clear validation schema when no data\n      setClientValidationSchema(key, null);\n    }\n\n    // Re-validate all touched fields when client validation schema changes\n    const touchedFieldNames = Object.keys(touchedFields);\n    if (touchedFieldNames.length > 0) {\n      // Use setTimeout to ensure the client validation schema update has propagated\n      // before triggering re-validation (fixes race condition)\n      setTimeout(async () => {\n        return trigger(touchedFieldNames);\n      }, 1);\n    }\n\n    // Cleanup on unmount or when dependencies change\n    return () => {\n      setClientValidationSchema(key, null);\n    };\n    // Only re-run when data (dataHash) or key changes\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [dataHash, key]);\n};\n\n/**\n * Helper function to create a veto looseObject schema for a single field with nested path support.\n *\n * Parses field paths (dot-notation) and creates properly nested loose object schemas with array support.\n * All intermediate objects and arrays are marked as optional to allow partial data structures.\n * Numeric segments in the path are treated as array indices, and the parent field is wrapped in an array schema.\n * Supports flat arrays (arrays of primitives) via the special `__FLAT__` key.\n *\n * **Important:** The fieldSchema should typically use `.nullish()` to allow empty values. This is because:\n * - Base validation (passed to Form) handles \"required\" constraints\n * - Client validation adds dynamic, context-dependent rules (e.g., \"username already exists\")\n * - Form data processing converts empty strings in flat arrays to `null` (not `undefined`)\n * - `.nullish()` accepts both `null` and `undefined`, while `.optional()` only accepts `undefined`\n *\n * This pattern ensures client validation only validates non-empty values, while base validation\n * enforces required fields and basic constraints (min length, format, etc.).\n *\n * @param name - The dot-separated path to the field (e.g., 'username', 'user.profile.email', 'items.0.name', 'tags.0.__FLAT__')\n * @param fieldSchema - The veto validation schema for the field. Should typically use `.nullish()` to allow empty values.\n * @returns A nested loose object schema matching the field path structure with proper type inference\n *\n * @example\n * ```tsx\n * // Typical usage: base validation handles \"required\", client validation adds dynamic rules\n * // Base validation (in Form component)\n * const baseSchema = veto({ username: vt.string({ min: 3 }) }); // Required + min length\n *\n * // Client validation (dynamic check for existing usernames)\n * const { data: userData } = useUserQuery(userId);\n * useClientValidation(userData, (data) =>\n *   clientValidationSchemaByName(\n *     'username',\n *     vt.string()\n *       .refine(\n *         (value) => !data.existingUsernames.includes(value),\n *         { message: 'Username already taken' }\n *       )\n *       .nullish() // Allow empty - base validation handles \"required\"\n *   )\n * );\n * ```\n *\n * @example\n * ```tsx\n * // Nested field path with dynamic validation\n * clientValidationSchemaByName(\n *   'user.profile.email',\n *   vt.string()\n *     .refine(\n *       (value) => !reservedEmails.includes(value),\n *       { message: 'This email is reserved' }\n *     )\n *     .nullish()\n * )\n * // => objectLoose({ user: objectLoose({ profile: objectLoose({ email: ... }).optional() }).optional() })\n * ```\n *\n * @example\n * ```tsx\n * // Array of objects with dynamic validation\n * clientValidationSchemaByName(\n *   'items.0.tag',\n *   vt.string()\n *     .refine((value) => !forbiddenTags.includes(value), { message: 'Tag not allowed' })\n *     .nullish()\n * )\n * // => objectLoose({ items: array(objectLoose({ tag: ... })).optional() })\n * ```\n *\n * @example\n * ```tsx\n * // Flat array (array of primitives) with dynamic validation\n * clientValidationSchemaByName(\n *   'tags.0.__FLAT__',\n *   vt.string()\n *     .refine((value) => !forbiddenWords.includes(value), { message: 'Word not allowed' })\n *     .nullish()\n * )\n * // => objectLoose({ tags: array(vt.string().refine(...).nullish()).optional() })\n * ```\n */\nexport const clientValidationSchemaByName = <T extends VetoTypeAny>(\n  name: string,\n  fieldSchema: T,\n) => {\n  const segments = name.split('.');\n\n  // Build schema from innermost to outermost\n  let schema: VetoTypeAny = fieldSchema;\n\n  // Process segments in reverse order to build nested structure\n  for (let i = segments.length - 1; i >= 0; i -= 1) {\n    const segment = segments[i];\n\n    const isNumeric = /^\\d+$/.test(segment);\n    const isFlatArrayKey = segment === flatArrayKey;\n\n    if (isFlatArrayKey) {\n      // Skip the __FLAT__ key - it's just a marker for flat arrays\n      // The schema is already correct (primitive type), just continue\n      // eslint-disable-next-line no-continue\n      continue;\n    }\n\n    if (isNumeric) {\n      // Current segment is an array index - wrap current schema in optional array\n      schema = array(schema).optional();\n    } else {\n      // Current segment is a field name - wrap in objectLoose\n      // Make it optional if it's an intermediate object (not the root)\n      const obj = objectLoose({\n        [segment]: schema,\n      });\n      schema = i > 0 ? obj.optional() : obj;\n    }\n  }\n\n  return schema;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkEA,MAAa,uBACX,MACA,eACA,YACS;CACT,MAAM,EACJ,WAAW,EAAE,iBACb,YAAY,EAAE,6BACd,YACEA,uBAAAA,gBAAgB;CAGpB,MAAM,oBAAA,GAAA,MAAA,QAA0B;CAChC,MAAM,MAAM,SAAS,OAAO;AAO5B,EAAA,GAAA,MAAA,iBAAgB;AAEd,MAAI,QAAQ,KAEV,2BAA0B,KADD,cAAc,KACQ,CAAC;MAGhD,2BAA0B,KAAK,KAAK;EAItC,MAAM,oBAAoB,OAAO,KAAK,cAAc;AACpD,MAAI,kBAAkB,SAAS,EAG7B,YAAW,YAAY;AACrB,UAAO,QAAQ,kBAAkB;KAChC,EAAE;AAIP,eAAa;AACX,6BAA0B,KAAK,KAAK;;IAIrC,CA7Bc,KAAK,UAAU,KA6BpB,EAAE,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoFrB,MAAa,gCACX,MACA,gBACG;CACH,MAAM,WAAW,KAAK,MAAM,IAAI;CAGhC,IAAI,SAAsB;AAG1B,MAAK,IAAI,IAAI,SAAS,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG;EAChD,MAAM,UAAU,SAAS;EAEzB,MAAM,YAAY,QAAQ,KAAK,QAAQ;AAGvC,MAFuB,YAAA,WAMrB;AAGF,MAAI,UAEF,WAAA,GAAA,gBAAA,OAAe,OAAO,CAAC,UAAU;OAC5B;GAGL,MAAM,OAAA,GAAA,gBAAA,aAAkB,GACrB,UAAU,QACZ,CAAC;AACF,YAAS,IAAI,IAAI,IAAI,UAAU,GAAG;;;AAItC,QAAO"}
+{"version":3,"file":"useClientValidation-NKOuXuHV.cjs","names":["useFormContext"],"sources":["../src/hooks/useClientValidation/useClientValidation.ts"],"sourcesContent":["import type { VetoTypeAny } from '@fuf-stack/veto';\n\nimport { useEffect, useId } from 'react';\n\nimport { array, objectLoose } from '@fuf-stack/veto';\n\nimport { flatArrayKey } from '../../helpers';\nimport { useFormContext } from '../useFormContext/useFormContext';\n\n/**\n * Hook for adding dynamic client-side validation to forms.\n *\n * Client validation is used for context-dependent validation rules that require external data\n * (e.g., checking if a username already exists). It complements base validation (passed to Form),\n * which handles static rules like \"required\", min/max length, format, etc.\n *\n * **Typical pattern:**\n * - Base validation: Static, always-on rules (required, format, length constraints)\n * - Client validation: Dynamic rules based on external data (uniqueness, business logic)\n * - Client schemas should use `.nullish()` to allow empty values (base validation handles \"required\")\n *\n * Automatically manages validation schema lifecycle: sets schema when data is provided,\n * clears schema when data is null/undefined, and cleans up on unmount. When the client\n * validation schema changes, automatically re-validates all touched fields.\n *\n * @param data - Data to create validation schema from (or null/undefined to clear validation)\n * @param schemaFactory - Function that creates a validation schema from the data. Schemas should typically use `.nullish()`.\n * @param options - Optional configuration object\n * @param options.key - Optional custom key for registration. Useful when multiple instances should share validation (e.g., in field arrays)\n *\n * @example\n * ```tsx\n * // Base validation handles \"required\" and format\n * const baseSchema = veto({ username: vt.string({ min: 3 }) });\n *\n * // Client validation adds dynamic uniqueness check\n * const { data: teamData } = useTeamQuery(teamId);\n * useClientValidation(teamData, (data) =>\n *   vt.objectLoose({\n *     username: vt.string()\n *       .refine(\n *         (value) => !data.existingUsers.includes(value),\n *         { message: 'Username already exists' }\n *       )\n *       .nullish() // Allow empty - base validation handles \"required\"\n *   })\n * );\n * ```\n *\n * @example\n * ```tsx\n * // Using custom key in a field array to avoid multiple registrations\n * fields.map((field, index) => (\n *   useClientValidation(\n *     userData,\n *     (data) => clientValidationSchemaByName(\n *       `items.${index}.name`,\n *       vt.string()\n *         .refine((val) => !data.forbidden.includes(val), { message: 'Name not allowed' })\n *         .nullish()\n *     ),\n *     { key: 'items-validation' } // All instances share the same key\n *   )\n * ));\n * ```\n */\nexport const useClientValidation = <TData = unknown>(\n  data: TData | null | undefined,\n  schemaFactory: (data: TData) => VetoTypeAny,\n  options?: { key?: string },\n): void => {\n  const {\n    formState: { touchedFields },\n    validation: { setClientValidationSchema },\n    trigger,\n  } = useFormContext();\n\n  // Use provided key or auto-generate unique key\n  const autoGeneratedKey = useId();\n  const key = options?.key ?? autoGeneratedKey;\n\n  // Use data hash instead of object reference to avoid unnecessary re-runs\n  // when data object reference changes but data remains the same\n  const dataHash = JSON.stringify(data);\n\n  // Single effect to manage validation schema lifecycle\n  useEffect(() => {\n    // Set validation schema when data is available\n    if (data != null) {\n      const validationSchema = schemaFactory(data);\n      setClientValidationSchema(key, validationSchema);\n    } else {\n      // Clear validation schema when no data\n      setClientValidationSchema(key, null);\n    }\n\n    // Re-validate all touched fields when client validation schema changes\n    const touchedFieldNames = Object.keys(touchedFields);\n    if (touchedFieldNames.length > 0) {\n      // Use setTimeout to ensure the client validation schema update has propagated\n      // before triggering re-validation (fixes race condition)\n      setTimeout(async () => {\n        return trigger(touchedFieldNames);\n      }, 1);\n    }\n\n    // Cleanup on unmount or when dependencies change\n    return () => {\n      setClientValidationSchema(key, null);\n    };\n    // Only re-run when data (dataHash) or key changes\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [dataHash, key]);\n};\n\n/**\n * Helper function to create a veto looseObject schema for a single field with nested path support.\n *\n * Parses field paths (dot-notation) and creates properly nested loose object schemas with array support.\n * All intermediate objects and arrays are marked as optional to allow partial data structures.\n * Numeric segments in the path are treated as array indices, and the parent field is wrapped in an array schema.\n * Supports flat arrays (arrays of primitives) via the special `__FLAT__` key.\n *\n * **Important:** The fieldSchema should typically use `.nullish()` to allow empty values. This is because:\n * - Base validation (passed to Form) handles \"required\" constraints\n * - Client validation adds dynamic, context-dependent rules (e.g., \"username already exists\")\n * - Form data processing converts empty strings in flat arrays to `null` (not `undefined`)\n * - `.nullish()` accepts both `null` and `undefined`, while `.optional()` only accepts `undefined`\n *\n * This pattern ensures client validation only validates non-empty values, while base validation\n * enforces required fields and basic constraints (min length, format, etc.).\n *\n * @param name - The dot-separated path to the field (e.g., 'username', 'user.profile.email', 'items.0.name', 'tags.0.__FLAT__')\n * @param fieldSchema - The veto validation schema for the field. Should typically use `.nullish()` to allow empty values.\n * @returns A nested loose object schema matching the field path structure with proper type inference\n *\n * @example\n * ```tsx\n * // Typical usage: base validation handles \"required\", client validation adds dynamic rules\n * // Base validation (in Form component)\n * const baseSchema = veto({ username: vt.string({ min: 3 }) }); // Required + min length\n *\n * // Client validation (dynamic check for existing usernames)\n * const { data: userData } = useUserQuery(userId);\n * useClientValidation(userData, (data) =>\n *   clientValidationSchemaByName(\n *     'username',\n *     vt.string()\n *       .refine(\n *         (value) => !data.existingUsernames.includes(value),\n *         { message: 'Username already taken' }\n *       )\n *       .nullish() // Allow empty - base validation handles \"required\"\n *   )\n * );\n * ```\n *\n * @example\n * ```tsx\n * // Nested field path with dynamic validation\n * clientValidationSchemaByName(\n *   'user.profile.email',\n *   vt.string()\n *     .refine(\n *       (value) => !reservedEmails.includes(value),\n *       { message: 'This email is reserved' }\n *     )\n *     .nullish()\n * )\n * // => objectLoose({ user: objectLoose({ profile: objectLoose({ email: ... }).optional() }).optional() })\n * ```\n *\n * @example\n * ```tsx\n * // Array of objects with dynamic validation\n * clientValidationSchemaByName(\n *   'items.0.tag',\n *   vt.string()\n *     .refine((value) => !forbiddenTags.includes(value), { message: 'Tag not allowed' })\n *     .nullish()\n * )\n * // => objectLoose({ items: array(objectLoose({ tag: ... })).optional() })\n * ```\n *\n * @example\n * ```tsx\n * // Flat array (array of primitives) with dynamic validation\n * clientValidationSchemaByName(\n *   'tags.0.__FLAT__',\n *   vt.string()\n *     .refine((value) => !forbiddenWords.includes(value), { message: 'Word not allowed' })\n *     .nullish()\n * )\n * // => objectLoose({ tags: array(vt.string().refine(...).nullish()).optional() })\n * ```\n */\nexport const clientValidationSchemaByName = <T extends VetoTypeAny>(\n  name: string,\n  fieldSchema: T,\n) => {\n  const segments = name.split('.');\n\n  // Build schema from innermost to outermost\n  let schema: VetoTypeAny = fieldSchema;\n\n  // Process segments in reverse order to build nested structure\n  for (let i = segments.length - 1; i >= 0; i -= 1) {\n    const segment = segments[i];\n\n    const isNumeric = /^\\d+$/.test(segment);\n    const isFlatArrayKey = segment === flatArrayKey;\n\n    if (isFlatArrayKey) {\n      // Skip the __FLAT__ key - it's just a marker for flat arrays\n      // The schema is already correct (primitive type), just continue\n      // eslint-disable-next-line no-continue\n      continue;\n    }\n\n    if (isNumeric) {\n      // Current segment is an array index - wrap current schema in optional array\n      schema = array(schema).optional();\n    } else {\n      // Current segment is a field name - wrap in objectLoose\n      // Make it optional if it's an intermediate object (not the root)\n      const obj = objectLoose({\n        [segment]: schema,\n      });\n      schema = i > 0 ? obj.optional() : obj;\n    }\n  }\n\n  return schema;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkEA,MAAa,uBACX,MACA,eACA,YACS;CACT,MAAM,EACJ,WAAW,EAAE,iBACb,YAAY,EAAE,6BACd,YACEA,uBAAAA,eAAe;CAGnB,MAAM,oBAAA,GAAA,MAAA,OAAyB;CAC/B,MAAM,MAAM,SAAS,OAAO;CAO5B,CAAA,GAAA,MAAA,iBAAgB;EAEd,IAAI,QAAQ,MAEV,0BAA0B,KADD,cAAc,IACO,CAAC;OAG/C,0BAA0B,KAAK,IAAI;EAIrC,MAAM,oBAAoB,OAAO,KAAK,aAAa;EACnD,IAAI,kBAAkB,SAAS,GAG7B,WAAW,YAAY;GACrB,OAAO,QAAQ,iBAAiB;EAClC,GAAG,CAAC;EAIN,aAAa;GACX,0BAA0B,KAAK,IAAI;EACrC;CAGF,GAAG,CA7Bc,KAAK,UAAU,IA6BrB,GAAG,GAAG,CAAC;AACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmFA,MAAa,gCACX,MACA,gBACG;CACH,MAAM,WAAW,KAAK,MAAM,GAAG;CAG/B,IAAI,SAAsB;CAG1B,KAAK,IAAI,IAAI,SAAS,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG;EAChD,MAAM,UAAU,SAAS;EAEzB,MAAM,YAAY,QAAQ,KAAK,OAAO;EAGtC,IAFuB,YAAA,YAMrB;EAGF,IAAI,WAEF,UAAA,GAAA,gBAAA,OAAe,MAAM,EAAE,SAAS;OAC3B;GAGL,MAAM,OAAA,GAAA,gBAAA,aAAkB,GACrB,UAAU,OACb,CAAC;GACD,SAAS,IAAI,IAAI,IAAI,SAAS,IAAI;EACpC;CACF;CAEA,OAAO;AACT"}

package/dist/useController-B-6PzFna.js.map

@@ -1 +1 @@
-{"version":3,"file":"useController-B-6PzFna.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-B-6PzFna.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,KAAK;CAC/D,MAAM,EAAE,eAAe,WAAW,cAAc;CAEhD,OAAO;EACL,OAAO;GACL,GAAG;GAGH,WAAW,GAAG,UAAiB;IAC7B,MAAM,QAAQ,MAAM,IAAI,QAAQ,SAAS,MAAM;IAC/C,MAAM,iBAAiB,UAAU,KAAK,KAAK,gBAAgB,KAAK;IAKhE,IAAI,mBAAmB,MAAM,OAC3B;IAIF,MAAM,SAAS,cAAc;IAQ7B,YAAY,OAAO,MAAM,MAAM,KAAK;GACtC;GAEA,OAAO,kBAAkB,MAAM,KAAK;EACtC;EACA;EACA;CACF;AACF"}

package/dist/{useController-Cc0UNQMm.d.ts → useController-BK2AeY9L.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-Cc0UNQMm.d.ts.map
+//# sourceMappingURL=useController-BK2AeY9L.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useController-BK2AeY9L.d.ts","names":[],"sources":["../src/hooks/useController/useController.ts"],"mappings":";;;KAaY,oBAAA,yCACV,kBAAqB,CAAC,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;;AAVsB;AAEpC;;;;;;;;;;;;;;;cA4Ba,eAAA,yCACX,KAAA,EAAO,oBAAA,CAAmB,YAAA,MACzB,mBAAA,CAAoB,YAAA"}

package/dist/useController-DVRh86Zy.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useController-DVRh86Zy.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,gBAAA,GAAA,gBAAA,eAAgC,MAAM;CAChE,MAAM,EAAE,gBAAA,GAAA,MAAA,YAA0BA,oBAAAA,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,KAAKC,sBAAAA,gBAAgB,MAAM;AAKjE,QAAI,mBAAmB,MAAM,MAC3B;AAIF,UAAM,SAAS,eAAe;AAQ9B,gBAAY,OAAO,MAAM,MAAM,MAAM;;GAGvC,OAAOC,sBAAAA,kBAAkB,MAAM,MAAM;GACtC;EACD;EACA;EACD"}
+{"version":3,"file":"useController-DVRh86Zy.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,gBAAA,GAAA,gBAAA,eAAgC,KAAK;CAC/D,MAAM,EAAE,gBAAA,GAAA,MAAA,YAA0BA,oBAAAA,cAAc;CAEhD,OAAO;EACL,OAAO;GACL,GAAG;GAGH,WAAW,GAAG,UAAiB;IAC7B,MAAM,QAAQ,MAAM,IAAI,QAAQ,SAAS,MAAM;IAC/C,MAAM,iBAAiB,UAAU,KAAK,KAAKC,sBAAAA,gBAAgB,KAAK;IAKhE,IAAI,mBAAmB,MAAM,OAC3B;IAIF,MAAM,SAAS,cAAc;IAQ7B,YAAY,OAAO,MAAM,MAAM,KAAK;GACtC;GAEA,OAAOC,sBAAAA,kBAAkB,MAAM,KAAK;EACtC;EACA;EACA;CACF;AACF"}

package/dist/{useController-CNiqy_2D.d.cts → useController-kxcnnsXy.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-CNiqy_2D.d.cts.map
+//# sourceMappingURL=useController-kxcnnsXy.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useController-kxcnnsXy.d.cts","names":[],"sources":["../src/hooks/useController/useController.ts"],"mappings":";;;KAaY,oBAAA,yCACV,kBAAqB,CAAC,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;;AAVsB;AAEpC;;;;;;;;;;;;;;;cA4Ba,aAAA,yCACX,KAAA,EAAO,oBAAA,CAAmB,YAAA,MACzB,mBAAA,CAAoB,YAAA"}