@fuf-stack/uniform 1.14.0 → 1.16.0

package/dist/index-jeFGTign.d.cts

@@ -1,264 +0,0 @@
-import * as tailwind_variants182 from "tailwind-variants";
-import * as react_jsx_runtime13 from "react/jsx-runtime";
-import { TVClassName, TVProps } from "@fuf-stack/pixel-utils";
-import { ReactNode } from "react";
-import { Props } from "react-select";
-
-//#region src/Select/Select.d.ts
-declare const selectVariants: tailwind_variants182.TVReturnType<{
-  [key: string]: {
-    [key: string]: tailwind_variants182.ClassValue | {
-      base?: tailwind_variants182.ClassValue;
-      clearIndicator?: tailwind_variants182.ClassValue;
-      control?: tailwind_variants182.ClassValue;
-      control_focused?: tailwind_variants182.ClassValue;
-      crossIcon?: tailwind_variants182.ClassValue;
-      downChevron?: tailwind_variants182.ClassValue;
-      dropdownIndicator?: tailwind_variants182.ClassValue;
-      group?: tailwind_variants182.ClassValue;
-      groupHeading?: tailwind_variants182.ClassValue;
-      indicatorsContainer?: tailwind_variants182.ClassValue;
-      indicatorSeparator?: tailwind_variants182.ClassValue;
-      input?: tailwind_variants182.ClassValue;
-      label?: tailwind_variants182.ClassValue;
-      loadingIndicator?: tailwind_variants182.ClassValue;
-      loadingMessage?: tailwind_variants182.ClassValue;
-      menu?: tailwind_variants182.ClassValue;
-      menuList?: tailwind_variants182.ClassValue;
-      menuPortal?: tailwind_variants182.ClassValue;
-      multiValue?: tailwind_variants182.ClassValue;
-      multiValueContainer?: tailwind_variants182.ClassValue;
-      multiValueLabel?: tailwind_variants182.ClassValue;
-      multiValueRemove?: tailwind_variants182.ClassValue;
-      noOptionsMessage?: tailwind_variants182.ClassValue;
-      option_focused?: tailwind_variants182.ClassValue;
-      option_selected?: tailwind_variants182.ClassValue;
-      option?: tailwind_variants182.ClassValue;
-      placeholder?: tailwind_variants182.ClassValue;
-      selectContainer?: tailwind_variants182.ClassValue;
-      singleValue?: tailwind_variants182.ClassValue;
-      valueContainer?: tailwind_variants182.ClassValue;
-    };
-  };
-} | {
-  [x: string]: {
-    [x: string]: tailwind_variants182.ClassValue | {
-      base?: tailwind_variants182.ClassValue;
-      clearIndicator?: tailwind_variants182.ClassValue;
-      control?: tailwind_variants182.ClassValue;
-      control_focused?: tailwind_variants182.ClassValue;
-      crossIcon?: tailwind_variants182.ClassValue;
-      downChevron?: tailwind_variants182.ClassValue;
-      dropdownIndicator?: tailwind_variants182.ClassValue;
-      group?: tailwind_variants182.ClassValue;
-      groupHeading?: tailwind_variants182.ClassValue;
-      indicatorsContainer?: tailwind_variants182.ClassValue;
-      indicatorSeparator?: tailwind_variants182.ClassValue;
-      input?: tailwind_variants182.ClassValue;
-      label?: tailwind_variants182.ClassValue;
-      loadingIndicator?: tailwind_variants182.ClassValue;
-      loadingMessage?: tailwind_variants182.ClassValue;
-      menu?: tailwind_variants182.ClassValue;
-      menuList?: tailwind_variants182.ClassValue;
-      menuPortal?: tailwind_variants182.ClassValue;
-      multiValue?: tailwind_variants182.ClassValue;
-      multiValueContainer?: tailwind_variants182.ClassValue;
-      multiValueLabel?: tailwind_variants182.ClassValue;
-      multiValueRemove?: tailwind_variants182.ClassValue;
-      noOptionsMessage?: tailwind_variants182.ClassValue;
-      option_focused?: tailwind_variants182.ClassValue;
-      option_selected?: tailwind_variants182.ClassValue;
-      option?: tailwind_variants182.ClassValue;
-      placeholder?: tailwind_variants182.ClassValue;
-      selectContainer?: tailwind_variants182.ClassValue;
-      singleValue?: tailwind_variants182.ClassValue;
-      valueContainer?: tailwind_variants182.ClassValue;
-    };
-  };
-} | {}, {
-  base: string;
-  clearIndicator: string;
-  control: string;
-  control_focused: string;
-  crossIcon: string;
-  downChevron: string;
-  dropdownIndicator: string;
-  group: string;
-  groupHeading: string;
-  indicatorsContainer: string;
-  indicatorSeparator: string;
-  input: string;
-  label: string;
-  loadingIndicator: string;
-  loadingMessage: string;
-  menu: string;
-  menuList: string;
-  menuPortal: string;
-  multiValue: string;
-  multiValueContainer: string;
-  multiValueLabel: string;
-  multiValueRemove: string;
-  noOptionsMessage: string;
-  option_focused: string;
-  option_selected: string;
-  option: string;
-  placeholder: string;
-  selectContainer: string;
-  singleValue: string;
-  valueContainer: string;
-}, undefined, {
-  [key: string]: {
-    [key: string]: tailwind_variants182.ClassValue | {
-      base?: tailwind_variants182.ClassValue;
-      clearIndicator?: tailwind_variants182.ClassValue;
-      control?: tailwind_variants182.ClassValue;
-      control_focused?: tailwind_variants182.ClassValue;
-      crossIcon?: tailwind_variants182.ClassValue;
-      downChevron?: tailwind_variants182.ClassValue;
-      dropdownIndicator?: tailwind_variants182.ClassValue;
-      group?: tailwind_variants182.ClassValue;
-      groupHeading?: tailwind_variants182.ClassValue;
-      indicatorsContainer?: tailwind_variants182.ClassValue;
-      indicatorSeparator?: tailwind_variants182.ClassValue;
-      input?: tailwind_variants182.ClassValue;
-      label?: tailwind_variants182.ClassValue;
-      loadingIndicator?: tailwind_variants182.ClassValue;
-      loadingMessage?: tailwind_variants182.ClassValue;
-      menu?: tailwind_variants182.ClassValue;
-      menuList?: tailwind_variants182.ClassValue;
-      menuPortal?: tailwind_variants182.ClassValue;
-      multiValue?: tailwind_variants182.ClassValue;
-      multiValueContainer?: tailwind_variants182.ClassValue;
-      multiValueLabel?: tailwind_variants182.ClassValue;
-      multiValueRemove?: tailwind_variants182.ClassValue;
-      noOptionsMessage?: tailwind_variants182.ClassValue;
-      option_focused?: tailwind_variants182.ClassValue;
-      option_selected?: tailwind_variants182.ClassValue;
-      option?: tailwind_variants182.ClassValue;
-      placeholder?: tailwind_variants182.ClassValue;
-      selectContainer?: tailwind_variants182.ClassValue;
-      singleValue?: tailwind_variants182.ClassValue;
-      valueContainer?: tailwind_variants182.ClassValue;
-    };
-  };
-} | {}, {
-  base: string;
-  clearIndicator: string;
-  control: string;
-  control_focused: string;
-  crossIcon: string;
-  downChevron: string;
-  dropdownIndicator: string;
-  group: string;
-  groupHeading: string;
-  indicatorsContainer: string;
-  indicatorSeparator: string;
-  input: string;
-  label: string;
-  loadingIndicator: string;
-  loadingMessage: string;
-  menu: string;
-  menuList: string;
-  menuPortal: string;
-  multiValue: string;
-  multiValueContainer: string;
-  multiValueLabel: string;
-  multiValueRemove: string;
-  noOptionsMessage: string;
-  option_focused: string;
-  option_selected: string;
-  option: string;
-  placeholder: string;
-  selectContainer: string;
-  singleValue: string;
-  valueContainer: string;
-}, tailwind_variants182.TVReturnType<unknown, {
-  base: string;
-  clearIndicator: string;
-  control: string;
-  control_focused: string;
-  crossIcon: string;
-  downChevron: string;
-  dropdownIndicator: string;
-  group: string;
-  groupHeading: string;
-  indicatorsContainer: string;
-  indicatorSeparator: string;
-  input: string;
-  label: string;
-  loadingIndicator: string;
-  loadingMessage: string;
-  menu: string;
-  menuList: string;
-  menuPortal: string;
-  multiValue: string;
-  multiValueContainer: string;
-  multiValueLabel: string;
-  multiValueRemove: string;
-  noOptionsMessage: string;
-  option_focused: string;
-  option_selected: string;
-  option: string;
-  placeholder: string;
-  selectContainer: string;
-  singleValue: string;
-  valueContainer: string;
-}, undefined, unknown, unknown, undefined>>;
-interface SelectOption {
-  /** option label */
-  label?: ReactNode;
-  /** option value */
-  value: string | number;
-}
-type VariantProps = TVProps<typeof selectVariants>;
-type ClassName = TVClassName<typeof selectVariants>;
-interface SelectProps 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;
-  /** Determine if the  */
-  clearable?: boolean;
-  /** Set the select to disabled state. */
-  disabled?: boolean;
-  /** Filter Select Options */
-  filterOption?: undefined | ((option?: SelectOption, inputValue?: string) => boolean);
-  /** Format the label of the option */
-  renderOptionLabel?: undefined | Props['formatOptionLabel'];
-  /** The value of the search input */
-  inputValue?: string;
-  /** Label that should be associated with the select. */
-  label?: ReactNode;
-  /** Set the select to a loading state. */
-  loading?: boolean;
-  /** switch between single and multi select mode. */
-  multiSelect?: boolean;
-  /** The name for the Select component, used by react-hook-form */
-  name: string;
-  /** Placeholder that is displayed when nothing is selected */
-  placeholder?: string;
-  /** The options for the Select component */
-  options: SelectOption[];
-  /** Handle change events on the input */
-  onInputChange?: Props['onInputChange'];
-  /** HTML data-testid attribute used in e2e tests */
-  testId?: string;
-}
-/** Select component based on [HeroUI Select](https://www.heroui.com//docs/components/select) and [React-Select](https://react-select.com/home) */
-declare const Select: ({
-  className,
-  clearable,
-  filterOption,
-  renderOptionLabel,
-  inputValue,
-  loading,
-  multiSelect,
-  name,
-  onInputChange,
-  options,
-  placeholder,
-  ...uniformFieldProps
-}: SelectProps) => react_jsx_runtime13.JSX.Element;
-//#endregion
-export { SelectProps as n, Select as t };
-//# sourceMappingURL=index-jeFGTign.d.cts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index-jeFGTign.d.cts","names":[],"sources":["../src/Select/Select.tsx"],"sourcesContent":[],"mappings":";;;;;;;cAea,qCAAc;;mBA0CzB,oBAAA,CAAA,UAAA;;MA1CW,cA0CX,CAAA,iCAAA;MAAA,OAAA,CAAA,iCAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA1CyB;EAAA,cAAA,EAAA,MAAA;AA0CxB,CAAA,EAAA,SAEO,EAAA;EAOL,CAAA,GAAA,EAAA,MAAA,CAAA,EAAY;IACZ,CAAA,GAAA,EAAA,MAAS,CAAA,oCAAc;MAEX,IAAA,CAAA,iCAAY;MAIf,cAAA,CAAA,iCAAA;MAQG,OAAA,CAAA,iCAAA;MAEiB,eAAA,CAAA,iCAAA;MAIxB,SAAA,CAAA,iCAAA;MAUC,WAAA,CAAA,iCAAA;MAEO,iBAAA,CAAA,iCAAA;MA9BmB,KAAA,CAAA,iCAAA;MAAY,YAAA,CAAA,iCAAA;MAkF3C,mBA4PL,CAAA,iCAAA;MA5Pe,kBAAA,CAAA,iCAAA;MAAA,KAAA,CAAA,iCAAA;MAAA,KAAA,CAAA,iCAAA;MAAA,gBAAA,CAAA,iCAAA;MAAA,cAAA,CAAA,iCAAA;MAAA,IAAA,CAAA,iCAAA;MAAA,QAAA,CAAA,iCAAA;MAAA,UAAA,CAAA,iCAAA;MAAA,UAAA,CAAA,iCAAA;MAAA,mBAAA,CAAA,iCAAA;MAAA,eAAA,CAAA,iCAAA;MAab,gBAAA,CAAA,iCAAA;MAAW,gBAAA,CAAA,iCAAA;MA+Ob,cAAA,CAAA,iCAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAxVS,YAAA;;UAEA;;;;KAKL,YAAA,GAAe,eAAe;KAC9B,SAAA,GAAY,mBAAmB;UAEnB,WAAA,SAAoB;;;;cAIvB;;;;;;wCAQG;;kCAEiB;;;;UAIxB;;;;;;;;;;WAUC;;kBAEO;;;;;cAoDZ;;;;;;;;;;;;;GAaH,gBAAW,mBAAA,CAAA,GAAA,CAAA"}

package/dist/useController-BySgDIes.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"useController-BySgDIes.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 *\n * This enables consistent handling of empty/null values while keeping a clean API\n * for form inputs that expect string values.\n *\n * @see https://react-hook-form.com/docs/usecontroller\n */\nexport const useController = <TFieldValues extends object = object>(\n  props: UseControllerProps<TFieldValues>,\n): UseControllerReturn<TFieldValues> => {\n  const { field, formState, fieldState } = useRHFController(props);\n  const { userChange } = useContext(UniformContext);\n\n  return {\n    field: {\n      ...field,\n      // Handles both direct values (onChange(\"value\")) and events (onChange(event))\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      onChange: (...event: any[]) => {\n        const value = event[0]?.target?.value ?? event[0];\n        const formattedValue = value === '' ? '' : toNullishString(value);\n\n        // Update form state first\n        field.onChange(formattedValue);\n\n        // Then notify userChange listeners (for useWatchUserChange hook)\n        // This ensures getValues() in listeners returns the updated value\n        // 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":";;;;;;;;;;;;;;;;;;;;;AA0CA,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;AAGjE,UAAM,SAAS,eAAe;AAQ9B,gBAAY,OAAO,MAAM,MAAM,MAAM;;GAGvC,OAAOC,kCAAkB,MAAM,MAAM;GACtC;EACD;EACA;EACD"}

package/dist/useController-Dleq15tG.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useController-Dleq15tG.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 *\n * This enables consistent handling of empty/null values while keeping a clean API\n * for form inputs that expect string values.\n *\n * @see https://react-hook-form.com/docs/usecontroller\n */\nexport const useController = <TFieldValues extends object = object>(\n  props: UseControllerProps<TFieldValues>,\n): UseControllerReturn<TFieldValues> => {\n  const { field, formState, fieldState } = useRHFController(props);\n  const { userChange } = useContext(UniformContext);\n\n  return {\n    field: {\n      ...field,\n      // Handles both direct values (onChange(\"value\")) and events (onChange(event))\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      onChange: (...event: any[]) => {\n        const value = event[0]?.target?.value ?? event[0];\n        const formattedValue = value === '' ? '' : toNullishString(value);\n\n        // Update form state first\n        field.onChange(formattedValue);\n\n        // Then notify userChange listeners (for useWatchUserChange hook)\n        // This ensures getValues() in listeners returns the updated value\n        // 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":";;;;;;;;;;;;;;;;;;;;;AA0CA,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;AAGjE,UAAM,SAAS,eAAe;AAQ9B,gBAAY,OAAO,MAAM,MAAM,MAAM;;GAGvC,OAAO,kBAAkB,MAAM,MAAM;GACtC;EACD;EACA;EACD"}

package/dist/useWatchUserChange-1ELFYX_F.js.map

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

package/dist/useWatchUserChange-C1zOvSSU.cjs.map

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