@fuf-stack/uniform 1.22.5 → 1.22.6

package/dist/useUniformField-DUW-svZD.d.ts

@@ -1,98 +0,0 @@
-import { t as InputValueTransform } from "./useInputValueTransform-dLfFIYW4.js";
-import { r as useController$1 } from "./useController-CzP0aVFC.js";
-import { n as useFormContext$1 } from "./useFormContext-Bj1gXLt_.js";
-import { t as useInput } from "./useInput-BdH8oftG.js";
-import { ReactNode } from "react";
-import { FieldError, FieldValues, Path } from "react-hook-form";
-
-//#region src/hooks/useUniformField/useUniformField.d.ts
-interface UseUniformFieldParams<TFieldValues extends FieldValues = FieldValues, TDisplay = unknown> {
-  /** Form field name */
-  name: Path<TFieldValues> & string;
-  /** Custom aria-label for accessibility. If not provided, falls back to field name when no visible label exists */
-  ariaLabel?: string;
-  /** Disable the field */
-  disabled?: boolean;
-  /** Optional label content */
-  label?: ReactNode;
-  /** Optional explicit test id used to build stable test ids */
-  testId?: string;
-  /** Optional value transformation between form and display values */
-  transform?: InputValueTransform<TDisplay>;
-  /** Input type for special number handling */
-  type?: 'text' | 'number' | 'password';
-}
-interface UseUniformFieldReturn<TFieldValues extends FieldValues = FieldValues> {
-  /** Computed aria-label fallback (field name) when no visible label exists. Components can override based on their accessibility needs (e.g., if placeholder provides sufficient context) */
-  ariaLabel: string | undefined;
-  /** react-hook-form control instance for advanced integrations */
-  control: ReturnType<typeof useFormContext$1<TFieldValues>>['control'];
-  /** Debug mode from Uniform provider */
-  debugMode: ReturnType<typeof useFormContext$1<TFieldValues>>['debugMode'];
-  /** Current value used to initialize uncontrolled components */
-  defaultValue: unknown;
-  /** Whether the field is currently disabled (from RHF) */
-  disabled: boolean | undefined;
-  /** Validation error(s) for the field */
-  error: FieldError[] | undefined;
-  /** Pre-built errorMessage node to plug into components */
-  errorMessage: ReactNode | null;
-  /** RHF controller field with transformed value/onChange (use this for simple components) */
-  field: ReturnType<typeof useController$1<TFieldValues>>['field'];
-  /** Helper to spread standardized error message props to underlying components */
-  getErrorMessageProps: ReturnType<typeof useInput>['getErrorMessageProps'];
-  /** Helper to spread standardized helper wrapper props (for spacing/animation) */
-  getHelperWrapperProps: ReturnType<typeof useInput>['getHelperWrapperProps'];
-  /** Helper to spread standardized label props to underlying components */
-  getLabelProps: ReturnType<typeof useInput>['getLabelProps'];
-  /** Access current form values (converted to validation-friendly format) */
-  getValues: ReturnType<typeof useFormContext$1<TFieldValues>>['getValues'];
-  /** Whether the field should show invalid state (debounced for smooth animations). True when field is invalid AND (dirty OR touched OR submitted) */
-  invalid: boolean;
-  /** Computed label node including optional test id copy button */
-  label: ReactNode | null;
-  /** onBlur handler from controller */
-  onBlur: ReturnType<typeof useController$1<TFieldValues>>['field']['onBlur'];
-  /** onChange handler from controller (with transform applied) */
-  onChange: ReturnType<typeof useController$1<TFieldValues>>['field']['onChange'];
-  /** Ref to forward to underlying control */
-  ref: ReturnType<typeof useController$1<TFieldValues>>['field']['ref'];
-  /** Whether the field is required according to validation schema */
-  required: boolean;
-  /** Reset a specific field in the form */
-  resetField: ReturnType<typeof useFormContext$1<TFieldValues>>['resetField'];
-  /** Generated HTML data-testid for the field */
-  testId: string;
-}
-/**
- * Combines frequently used form field logic into a single hook.
- *
- * Provides:
- * - Enhanced form context (validation-aware state, `testId`, value transforms)
- * - Controller field with nullish conversion handling
- * - Value transformation via `transform` prop:
- *   • Allows disentangled display and form values (e.g., string ↔ object, boolean ↔ array)
- *   • Automatically applies `toDisplayValue` to field value for components
- *   • Automatically applies `toFormValue` to display value when onChange is called
- *   • Works with `type` prop for automatic number/string conversion
- *   • Examples: storing objects while displaying strings, storing booleans as arrays, enriching values with metadata
- * - Debounced `invalid` state with smart timing:
- *   • `true` (field becomes invalid): applies immediately so errors show right away
- *   • `false` (field becomes valid): delayed 200ms to allow smooth exit animations
- *   • Respects `prefers-reduced-motion` by skipping delays when user prefers reduced motion
- * - Smart `invalid` visibility (via `showInvalid`):
- *   • Shows errors when field is dirty OR touched OR form has been submitted
- *   • Prevents showing errors on pristine/untouched fields for better UX
- *   • Works well for all field types (text inputs, checkboxes, radios, arrays)
- * - Prebuilt `errorMessage` React node using `FieldValidationError`
- * - Computed `label` node which appends a `FieldCopyTestIdButton` in
- *   `debug-testids` mode
- * - `defaultValue` for uncontrolled defaults and all usual field handlers
- * - Access to form utilities: `control`, `getValues`, `resetField`
- * - Presentation helpers: `getLabelProps`, `getErrorMessageProps`,
- *   `getHelperWrapperProps` for consistent wiring to underlying UI components
- */
-declare const useUniformField: <TFieldValues extends FieldValues = FieldValues, TDisplay = unknown>(params: UseUniformFieldParams<TFieldValues, TDisplay>) => UseUniformFieldReturn<TFieldValues>;
-//#endregion
-export { UseUniformFieldReturn as n, useUniformField as r, UseUniformFieldParams as t };
-//# sourceMappingURL=useUniformField-DUW-svZD.d.ts.map

package/dist/useUniformField-DUW-svZD.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useUniformField-DUW-svZD.d.ts","names":[],"sources":["../src/hooks/useUniformField/useUniformField.tsx"],"mappings":";;;;;;;;UAgBiB,qBAAA,sBACM,WAAA,GAAc,WAAA;;EAInC,IAAA,EAAM,IAAA,CAAK,YAAA;EALyB;EAOpC,SAAA;EANqB;EAQrB,QAAA;EAJW;EAMX,KAAA,GAAQ,SAAA;EAAA;EAER,MAAA;EAEY;EAAZ,SAAA,GAAY,mBAAA,CAAoB,QAAA;EAAD;EAE/B,IAAA;AAAA;AAAA,UAGe,qBAAA,sBACM,WAAA,GAAc,WAAA;EAnBnC;EAsBA,SAAA;EAnBM;EAqBN,OAAA,EAAS,UAAA,QAAkB,gBAAA,CAAe,YAAA;EAnB1C;EAqBA,SAAA,EAAW,UAAA,QAAkB,gBAAA,CAAe,YAAA;EAjB5C;EAmBA,YAAA;EAjBA;EAmBA,QAAA;EAjBY;EAmBZ,KAAA,EAAO,UAAA;EAjBP;EAmBA,YAAA,EAAc,SAAA;EAnBV;EAqBJ,KAAA,EAAO,UAAA,QAAkB,eAAA,CAAc,YAAA;EAlBH;EAoBpC,oBAAA,EAAsB,UAAA,QAAkB,QAAA;EAnBnB;EAqBrB,qBAAA,EAAuB,UAAA,QAAkB,QAAA;EAhBC;EAkB1C,aAAA,EAAe,UAAA,QAAkB,QAAA;EAlBxB;EAoBT,SAAA,EAAW,UAAA,QAAkB,gBAAA,CAAe,YAAA;EAlBf;EAoB7B,OAAA;EAdO;EAgBP,KAAA,EAAO,SAAA;EAZgC;EAcvC,MAAA,EAAQ,UAAA,QAAkB,eAAA,CAAc,YAAA;EAdjC;EAgBP,QAAA,EAAU,UAAA,QAAkB,eAAA,CAAc,YAAA;EAdpB;EAgBtB,GAAA,EAAK,UAAA,QAAkB,eAAA,CAAc,YAAA;EAdd;EAgBvB,QAAA;EAde;EAgBf,UAAA,EAAY,UAAA,QAAkB,gBAAA,CAAe,YAAA;EAdhB;EAgB7B,MAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA+BW,eAAA,wBACU,WAAA,GAAc,WAAA,sBAGnC,MAAA,EAAQ,qBAAA,CAAsB,YAAA,EAAc,QAAA,MAC3C,qBAAA,CAAsB,YAAA"}

package/dist/useUniformFieldArray-CdWv1SEk.d.ts

@@ -1,79 +0,0 @@
-import { r as useController$1 } from "./useController-CzP0aVFC.js";
-import { n as useFormContext$1 } from "./useFormContext-Bj1gXLt_.js";
-import { ReactNode } from "react";
-import { ArrayPath, FieldValues } from "react-hook-form";
-
-//#region src/hooks/useUniformFieldArray/useUniformFieldArray.d.ts
-interface UseUniformFieldArrayProps<TFieldValues extends FieldValues = FieldValues> {
-  /** Field name for the array */
-  name: ArrayPath<TFieldValues>;
-  /** Whether this is a flat array (array of primitives) */
-  flat?: boolean;
-  /** Initial value for new array elements */
-  elementInitialValue?: unknown;
-  /** Whether the last element cannot be removed (always maintain at least one element) */
-  lastElementNotRemovable?: boolean;
-  /** Disable the field */
-  disabled?: boolean;
-  /** Optional explicit test id used to build stable test ids */
-  testId?: string;
-  /** Optional label content */
-  label?: ReactNode;
-}
-/**
- * Enhanced useFieldArray hook with initialization and animation logic.
- * Based on React Hook Form's useFieldArray with additional features:
- * - Automatic initialization when lastElementNotRemovable is set
- * - Reset-only normalization for stale empty placeholder rows (via useWatchFormReset)
- * - Animation control (disabled during initialization)
- * - Temporary animation disable during reset normalization collapse
- * - Support for flat arrays (arrays of primitives)
- *
- * Note: Automatic validation triggering on length change is disabled to prevent
- * triggering form-wide validation. Array validation still runs on form submission.
- *
- * @see https://react-hook-form.com/docs/usefieldarray
- */
-declare const useUniformFieldArray: <TFieldValues extends FieldValues = FieldValues>({
-  name,
-  flat,
-  elementInitialValue: _elementInitialValue,
-  lastElementNotRemovable,
-  disabled,
-  testId: explicitTestId,
-  label
-}: UseUniformFieldArrayProps<TFieldValues>) => {
-  ariaLabel: string | undefined;
-  control: import("react-hook-form").Control<TFieldValues, any, TFieldValues>;
-  debugMode: ReturnType<typeof useFormContext$1<TFieldValues_1>>["debugMode"];
-  defaultValue: unknown;
-  disabled: boolean | undefined;
-  error: import("react-hook-form").FieldError[] | undefined;
-  errorMessage: ReactNode | null;
-  field: Omit<import("react-hook-form").ControllerRenderProps<TFieldValues>, "onChange" | "value"> & {
-    onChange: (...event: any[]) => void;
-    value: string;
-  };
-  getErrorMessageProps: ReturnType<typeof import("@heroui/input").useInput>["getErrorMessageProps"];
-  getHelperWrapperProps: ReturnType<typeof import("@heroui/input").useInput>["getHelperWrapperProps"];
-  getLabelProps: ReturnType<typeof import("@heroui/input").useInput>["getLabelProps"];
-  getValues: import("react-hook-form").UseFormGetValues<TFieldValues>;
-  invalid: boolean;
-  label: ReactNode | null;
-  onBlur: ReturnType<typeof useController$1>["field"]["onBlur"];
-  onChange: ReturnType<typeof useController$1>["field"]["onChange"];
-  ref: ReturnType<typeof useController$1>["field"]["ref"];
-  required: boolean;
-  resetField: import("react-hook-form").UseFormResetField<TFieldValues>;
-  testId: string;
-  fields: import("react-hook-form").FieldArrayWithId<TFieldValues, ArrayPath<TFieldValues>, "id">[];
-  append: import("react-hook-form").UseFieldArrayAppend<TFieldValues, ArrayPath<TFieldValues>>;
-  remove: import("react-hook-form").UseFieldArrayRemove;
-  insert: import("react-hook-form").UseFieldArrayInsert<TFieldValues, ArrayPath<TFieldValues>>;
-  move: import("react-hook-form").UseFieldArrayMove;
-  disableAnimation: boolean;
-  elementInitialValue: {};
-};
-//#endregion
-export { useUniformFieldArray as n, UseUniformFieldArrayProps as t };
-//# sourceMappingURL=useUniformFieldArray-CdWv1SEk.d.ts.map

package/dist/useUniformFieldArray-CdWv1SEk.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useUniformFieldArray-CdWv1SEk.d.ts","names":[],"sources":["../src/hooks/useUniformFieldArray/useUniformFieldArray.ts"],"mappings":";;;;;;UAaiB,yBAAA,sBACM,WAAA,GAAc,WAAA;;EAGnC,IAAA,EAAM,SAAA,CAAU,YAAA;;EAEhB,IAAA;EANe;EAQf,mBAAA;EARwC;EAUxC,uBAAA;EATmC;EAWnC,QAAA;EARM;EAUN,MAAA;EAEiB;EAAjB,KAAA,GAAQ,SAAA;AAAA;;;;;;;;;;;;;;AAAS;cAiBN,oBAAA,wBACU,WAAA,GAAc,WAAA;EACnC,IAAA;EAAA,IAAA;EAAA,mBAAA,EAAA,oBAAA;EAAA,uBAAA;EAAA,QAAA;EAAA,MAAA,EAAA,cAAA;EAAA;AAAA,GAQC,yBAAA,CAA0B,YAAA;;;;;;;;;kBAnCR,KAAA;;;;;;;;;UAoEJ,UAAA;YAEuB,UAAA,QAFvB,eAAA;OAK4B,UAAA,QAHL,eAAA"}

package/dist/useUniformFieldArray-kkOHxNFF.d.cts

@@ -1,79 +0,0 @@
-import { r as useController } from "./useController-BT3Fd0IO.cjs";
-import { n as useFormContext } from "./useFormContext-M94eQfHm.cjs";
-import { ReactNode } from "react";
-import { ArrayPath, FieldValues } from "react-hook-form";
-
-//#region src/hooks/useUniformFieldArray/useUniformFieldArray.d.ts
-interface UseUniformFieldArrayProps<TFieldValues extends FieldValues = FieldValues> {
-  /** Field name for the array */
-  name: ArrayPath<TFieldValues>;
-  /** Whether this is a flat array (array of primitives) */
-  flat?: boolean;
-  /** Initial value for new array elements */
-  elementInitialValue?: unknown;
-  /** Whether the last element cannot be removed (always maintain at least one element) */
-  lastElementNotRemovable?: boolean;
-  /** Disable the field */
-  disabled?: boolean;
-  /** Optional explicit test id used to build stable test ids */
-  testId?: string;
-  /** Optional label content */
-  label?: ReactNode;
-}
-/**
- * Enhanced useFieldArray hook with initialization and animation logic.
- * Based on React Hook Form's useFieldArray with additional features:
- * - Automatic initialization when lastElementNotRemovable is set
- * - Reset-only normalization for stale empty placeholder rows (via useWatchFormReset)
- * - Animation control (disabled during initialization)
- * - Temporary animation disable during reset normalization collapse
- * - Support for flat arrays (arrays of primitives)
- *
- * Note: Automatic validation triggering on length change is disabled to prevent
- * triggering form-wide validation. Array validation still runs on form submission.
- *
- * @see https://react-hook-form.com/docs/usefieldarray
- */
-declare const useUniformFieldArray: <TFieldValues extends FieldValues = FieldValues>({
-  name,
-  flat,
-  elementInitialValue: _elementInitialValue,
-  lastElementNotRemovable,
-  disabled,
-  testId: explicitTestId,
-  label
-}: UseUniformFieldArrayProps<TFieldValues>) => {
-  ariaLabel: string | undefined;
-  control: import("react-hook-form").Control<TFieldValues, any, TFieldValues>;
-  debugMode: ReturnType<typeof useFormContext<TFieldValues_1>>["debugMode"];
-  defaultValue: unknown;
-  disabled: boolean | undefined;
-  error: import("react-hook-form").FieldError[] | undefined;
-  errorMessage: ReactNode | null;
-  field: Omit<import("react-hook-form").ControllerRenderProps<TFieldValues>, "onChange" | "value"> & {
-    onChange: (...event: any[]) => void;
-    value: string;
-  };
-  getErrorMessageProps: ReturnType<typeof import("@heroui/input").useInput>["getErrorMessageProps"];
-  getHelperWrapperProps: ReturnType<typeof import("@heroui/input").useInput>["getHelperWrapperProps"];
-  getLabelProps: ReturnType<typeof import("@heroui/input").useInput>["getLabelProps"];
-  getValues: import("react-hook-form").UseFormGetValues<TFieldValues>;
-  invalid: boolean;
-  label: ReactNode | null;
-  onBlur: ReturnType<typeof useController>["field"]["onBlur"];
-  onChange: ReturnType<typeof useController>["field"]["onChange"];
-  ref: ReturnType<typeof useController>["field"]["ref"];
-  required: boolean;
-  resetField: import("react-hook-form").UseFormResetField<TFieldValues>;
-  testId: string;
-  fields: import("react-hook-form").FieldArrayWithId<TFieldValues, ArrayPath<TFieldValues>, "id">[];
-  append: import("react-hook-form").UseFieldArrayAppend<TFieldValues, ArrayPath<TFieldValues>>;
-  remove: import("react-hook-form").UseFieldArrayRemove;
-  insert: import("react-hook-form").UseFieldArrayInsert<TFieldValues, ArrayPath<TFieldValues>>;
-  move: import("react-hook-form").UseFieldArrayMove;
-  disableAnimation: boolean;
-  elementInitialValue: {};
-};
-//#endregion
-export { useUniformFieldArray as n, UseUniformFieldArrayProps as t };
-//# sourceMappingURL=useUniformFieldArray-kkOHxNFF.d.cts.map

package/dist/useUniformFieldArray-kkOHxNFF.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useUniformFieldArray-kkOHxNFF.d.cts","names":[],"sources":["../src/hooks/useUniformFieldArray/useUniformFieldArray.ts"],"mappings":";;;;;;UAaiB,yBAAA,sBACM,WAAA,GAAc,WAAA;;EAGnC,IAAA,EAAM,SAAA,CAAU,YAAA;;EAEhB,IAAA;EANe;EAQf,mBAAA;EARwC;EAUxC,uBAAA;EATmC;EAWnC,QAAA;EARM;EAUN,MAAA;EAEiB;EAAjB,KAAA,GAAQ,SAAA;AAAA;;;;;;;;;;;;;;AAAS;cAiBN,oBAAA,wBACU,WAAA,GAAc,WAAA;EACnC,IAAA;EAAA,IAAA;EAAA,mBAAA,EAAA,oBAAA;EAAA,uBAAA;EAAA,QAAA;EAAA,MAAA,EAAA,cAAA;EAAA;AAAA,GAQC,yBAAA,CAA0B,YAAA;;;;;;;;;kBAnCR,KAAA;;;;;;;;;UAoEJ,UAAA;YAEuB,UAAA,QAFvB,aAAA;OAK4B,UAAA,QAHL,aAAA"}

package/dist/useWatchFormReset-BSd6jMxU.d.cts

@@ -1,38 +0,0 @@
-//#region src/hooks/useWatchFormReset/useWatchFormReset.d.ts
-interface UseWatchFormResetOptions {
-  /**
-   * Callback that runs whenever a programmatic form reset is observed.
-   *
-   * Resets are signalled via the uniform `formReset` pub/sub channel. The event
-   * is emitted by the wrapped `reset()` method in `useFormContext`.
-   *
-   * Current primary use case:
-   * - `useUniformFieldArray` listens for reset events to normalize stale
-   *   placeholder rows left by RHF after reset when array defaults are missing.
-   */
-  onReset: () => void;
-}
-/**
- * Hook that watches for programmatic form reset events.
- *
- * It lets consumers run a callback when a programmatic form reset is triggered
- * through the wrapped `reset()` from `useFormContext`.
- *
- * Why this exists:
- * - Components should not infer "a reset happened" from field values alone.
- *   Value-based heuristics can conflict with valid user interactions.
- * - This hook provides an explicit reset signal so components can run
- *   reset-only logic safely.
- *
- * Current usage:
- * - `useUniformFieldArray` uses this hook to handle resets when no default
- *   array value was provided. In that case, RHF can leave stale empty
- *   placeholder rows. It normalizes only on reset and does not collapse rows
- *   during normal editing.
- */
-declare const useWatchFormReset: ({
-  onReset
-}: UseWatchFormResetOptions) => void;
-//#endregion
-export { useWatchFormReset as n, UseWatchFormResetOptions as t };
-//# sourceMappingURL=useWatchFormReset-BSd6jMxU.d.cts.map

package/dist/useWatchFormReset-BSd6jMxU.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useWatchFormReset-BSd6jMxU.d.cts","names":[],"sources":["../src/hooks/useWatchFormReset/useWatchFormReset.ts"],"mappings":";UAIiB,wBAAA;EAAA;;;;AAWR;AAqBT;;;;;EArBE,OAAO;AAAA;;AAqB8D;;;;;;;;;;;;;;;;;cAA1D,iBAAA;EAAqB;AAAA,GAAa,wBAAwB"}

package/dist/useWatchFormReset-C7YJ-I3N.d.ts

@@ -1,38 +0,0 @@
-//#region src/hooks/useWatchFormReset/useWatchFormReset.d.ts
-interface UseWatchFormResetOptions {
-  /**
-   * Callback that runs whenever a programmatic form reset is observed.
-   *
-   * Resets are signalled via the uniform `formReset` pub/sub channel. The event
-   * is emitted by the wrapped `reset()` method in `useFormContext`.
-   *
-   * Current primary use case:
-   * - `useUniformFieldArray` listens for reset events to normalize stale
-   *   placeholder rows left by RHF after reset when array defaults are missing.
-   */
-  onReset: () => void;
-}
-/**
- * Hook that watches for programmatic form reset events.
- *
- * It lets consumers run a callback when a programmatic form reset is triggered
- * through the wrapped `reset()` from `useFormContext`.
- *
- * Why this exists:
- * - Components should not infer "a reset happened" from field values alone.
- *   Value-based heuristics can conflict with valid user interactions.
- * - This hook provides an explicit reset signal so components can run
- *   reset-only logic safely.
- *
- * Current usage:
- * - `useUniformFieldArray` uses this hook to handle resets when no default
- *   array value was provided. In that case, RHF can leave stale empty
- *   placeholder rows. It normalizes only on reset and does not collapse rows
- *   during normal editing.
- */
-declare const useWatchFormReset: ({
-  onReset
-}: UseWatchFormResetOptions) => void;
-//#endregion
-export { useWatchFormReset as n, UseWatchFormResetOptions as t };
-//# sourceMappingURL=useWatchFormReset-C7YJ-I3N.d.ts.map

package/dist/useWatchFormReset-C7YJ-I3N.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useWatchFormReset-C7YJ-I3N.d.ts","names":[],"sources":["../src/hooks/useWatchFormReset/useWatchFormReset.ts"],"mappings":";UAIiB,wBAAA;EAAA;;;;AAWR;AAqBT;;;;;EArBE,OAAO;AAAA;;AAqB8D;;;;;;;;;;;;;;;;;cAA1D,iBAAA;EAAqB;AAAA,GAAa,wBAAwB"}

package/dist/useWatchUserChange-C1xWHtFG.cjs

@@ -1,90 +0,0 @@
-require("./FormContext-DsmS_mkO.cjs");
-const require_useFormContext = require("./useFormContext-CrXwNYiB.cjs");
-let react = require("react");
-//#region src/hooks/useWatchUserChange/useWatchUserChange.ts
-/**
-* Hook that watches for user changes on a specific form field.
-*
-* Only triggers on manual user input (typing, clicking, selecting),
-* NOT on programmatic changes like form.reset() or form.setValue().
-* Also does NOT trigger when selecting the same value (e.g., clicking
-* an already-selected option in a Select).
-*
-* This hook subscribes to field changes at the source (useController),
-* ensuring immediate and accurate detection of user interactions.
-*
-* Use cases:
-* - Reset dependent fields when parent field changes
-* - Set mode-specific default values when a toggle changes
-* - Clear form sections based on user selections
-* - Trigger side effects only on user interaction
-*
-* Note: To watch multiple fields, call this hook multiple times.
-*
-* @example
-* ```tsx
-* // Reset city and address when user changes country
-* useWatchUserChange({
-*   watch: 'country',
-*   onChange: (value, { resetField }) => {
-*     resetField('city');
-*     resetField('address');
-*   },
-* });
-*
-* // Set defaults when user changes payment method
-* useWatchUserChange({
-*   watch: 'paymentMethod',
-*   onChange: (value, { setValue }) => {
-*     if (value === 'credit') {
-*       setValue('installments', 3);
-*     } else {
-*       setValue('installments', 1);
-*     }
-*   },
-* });
-*
-* // Watch multiple fields by calling the hook multiple times
-* useWatchUserChange({
-*   watch: 'category',
-*   onChange: (value, { resetField }) => {
-*     resetField('productId');
-*   },
-* });
-* useWatchUserChange({
-*   watch: 'brand',
-*   onChange: (value, { resetField }) => {
-*     resetField('productId');
-*   },
-* });
-* ```
-*/
-const useWatchUserChange = ({ watch: watchField, onChange }) => {
-	const { setValue, resetField, reset, userChange } = require_useFormContext.useFormContext();
-	(0, react.useEffect)(() => {
-		const listener = (fieldName, value) => {
-			if (fieldName === watchField) onChange(value, {
-				setValue,
-				resetField,
-				reset
-			});
-		};
-		return userChange.subscribe(listener);
-	}, [
-		watchField,
-		onChange,
-		setValue,
-		resetField,
-		reset,
-		userChange
-	]);
-};
-//#endregion
-Object.defineProperty(exports, "useWatchUserChange", {
-	enumerable: true,
-	get: function() {
-		return useWatchUserChange;
-	}
-});
-
-//# sourceMappingURL=useWatchUserChange-C1xWHtFG.cjs.map

package/dist/useWatchUserChange-C1xWHtFG.cjs.map

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

package/dist/useWatchUserChange-CpyZz2i7.d.ts

@@ -1,80 +0,0 @@
-import { FieldValues, Path, UseFormReset, UseFormResetField, UseFormSetValue } from "react-hook-form";
-
-//#region src/hooks/useWatchUserChange/useWatchUserChange.d.ts
-interface UseWatchUserChangeOptions<TFieldValues extends FieldValues> {
-  /** Field name to watch for user changes */
-  watch: Path<TFieldValues>;
-  /**
-   * Callback when watched field is changed by user input.
-   * Receives the new value and form helpers (setValue, resetField, reset).
-   */
-  onChange: (value: unknown, helpers: {
-    setValue: UseFormSetValue<TFieldValues>;
-    resetField: UseFormResetField<TFieldValues>;
-    reset: UseFormReset<TFieldValues>;
-  }) => void;
-}
-/**
- * Hook that watches for user changes on a specific form field.
- *
- * Only triggers on manual user input (typing, clicking, selecting),
- * NOT on programmatic changes like form.reset() or form.setValue().
- * Also does NOT trigger when selecting the same value (e.g., clicking
- * an already-selected option in a Select).
- *
- * This hook subscribes to field changes at the source (useController),
- * ensuring immediate and accurate detection of user interactions.
- *
- * Use cases:
- * - Reset dependent fields when parent field changes
- * - Set mode-specific default values when a toggle changes
- * - Clear form sections based on user selections
- * - Trigger side effects only on user interaction
- *
- * Note: To watch multiple fields, call this hook multiple times.
- *
- * @example
- * ```tsx
- * // Reset city and address when user changes country
- * useWatchUserChange({
- *   watch: 'country',
- *   onChange: (value, { resetField }) => {
- *     resetField('city');
- *     resetField('address');
- *   },
- * });
- *
- * // Set defaults when user changes payment method
- * useWatchUserChange({
- *   watch: 'paymentMethod',
- *   onChange: (value, { setValue }) => {
- *     if (value === 'credit') {
- *       setValue('installments', 3);
- *     } else {
- *       setValue('installments', 1);
- *     }
- *   },
- * });
- *
- * // Watch multiple fields by calling the hook multiple times
- * useWatchUserChange({
- *   watch: 'category',
- *   onChange: (value, { resetField }) => {
- *     resetField('productId');
- *   },
- * });
- * useWatchUserChange({
- *   watch: 'brand',
- *   onChange: (value, { resetField }) => {
- *     resetField('productId');
- *   },
- * });
- * ```
- */
-declare const useWatchUserChange: <TFieldValues extends FieldValues = FieldValues>({
-  watch: watchField,
-  onChange
-}: UseWatchUserChangeOptions<TFieldValues>) => void;
-//#endregion
-export { useWatchUserChange as n, UseWatchUserChangeOptions as t };
-//# sourceMappingURL=useWatchUserChange-CpyZz2i7.d.ts.map

package/dist/useWatchUserChange-CpyZz2i7.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useWatchUserChange-CpyZz2i7.d.ts","names":[],"sources":["../src/hooks/useWatchUserChange/useWatchUserChange.ts"],"mappings":";;;UAYiB,yBAAA,sBAA+C,WAAA;;EAE9D,KAAA,EAAO,IAAA,CAAK,YAAA;EAF4B;;;;EAOxC,QAAA,GACE,KAAA,WACA,OAAA;IACE,QAAA,EAAU,eAAA,CAAgB,YAAA;IAC1B,UAAA,EAAY,iBAAA,CAAkB,YAAA;IAC9B,KAAA,EAAO,YAAA,CAAa,YAAA;EAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;AACrB;AA6DL;;;;;;;;;;;;;;;;;;;;;AAKyC;;;;;;;;;;;;;;cAL5B,kBAAA,wBACU,WAAA,GAAc,WAAA;EACnC,KAAA,EAAA,UAAA;EAAA;AAAA,GAGC,yBAAA,CAA0B,YAAA"}

package/dist/useWatchUserChange-DSAboNCs.d.cts

@@ -1,80 +0,0 @@
-import { FieldValues, Path, UseFormReset, UseFormResetField, UseFormSetValue } from "react-hook-form";
-
-//#region src/hooks/useWatchUserChange/useWatchUserChange.d.ts
-interface UseWatchUserChangeOptions<TFieldValues extends FieldValues> {
-  /** Field name to watch for user changes */
-  watch: Path<TFieldValues>;
-  /**
-   * Callback when watched field is changed by user input.
-   * Receives the new value and form helpers (setValue, resetField, reset).
-   */
-  onChange: (value: unknown, helpers: {
-    setValue: UseFormSetValue<TFieldValues>;
-    resetField: UseFormResetField<TFieldValues>;
-    reset: UseFormReset<TFieldValues>;
-  }) => void;
-}
-/**
- * Hook that watches for user changes on a specific form field.
- *
- * Only triggers on manual user input (typing, clicking, selecting),
- * NOT on programmatic changes like form.reset() or form.setValue().
- * Also does NOT trigger when selecting the same value (e.g., clicking
- * an already-selected option in a Select).
- *
- * This hook subscribes to field changes at the source (useController),
- * ensuring immediate and accurate detection of user interactions.
- *
- * Use cases:
- * - Reset dependent fields when parent field changes
- * - Set mode-specific default values when a toggle changes
- * - Clear form sections based on user selections
- * - Trigger side effects only on user interaction
- *
- * Note: To watch multiple fields, call this hook multiple times.
- *
- * @example
- * ```tsx
- * // Reset city and address when user changes country
- * useWatchUserChange({
- *   watch: 'country',
- *   onChange: (value, { resetField }) => {
- *     resetField('city');
- *     resetField('address');
- *   },
- * });
- *
- * // Set defaults when user changes payment method
- * useWatchUserChange({
- *   watch: 'paymentMethod',
- *   onChange: (value, { setValue }) => {
- *     if (value === 'credit') {
- *       setValue('installments', 3);
- *     } else {
- *       setValue('installments', 1);
- *     }
- *   },
- * });
- *
- * // Watch multiple fields by calling the hook multiple times
- * useWatchUserChange({
- *   watch: 'category',
- *   onChange: (value, { resetField }) => {
- *     resetField('productId');
- *   },
- * });
- * useWatchUserChange({
- *   watch: 'brand',
- *   onChange: (value, { resetField }) => {
- *     resetField('productId');
- *   },
- * });
- * ```
- */
-declare const useWatchUserChange: <TFieldValues extends FieldValues = FieldValues>({
-  watch: watchField,
-  onChange
-}: UseWatchUserChangeOptions<TFieldValues>) => void;
-//#endregion
-export { useWatchUserChange as n, UseWatchUserChangeOptions as t };
-//# sourceMappingURL=useWatchUserChange-DSAboNCs.d.cts.map

package/dist/useWatchUserChange-DSAboNCs.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useWatchUserChange-DSAboNCs.d.cts","names":[],"sources":["../src/hooks/useWatchUserChange/useWatchUserChange.ts"],"mappings":";;;UAYiB,yBAAA,sBAA+C,WAAA;;EAE9D,KAAA,EAAO,IAAA,CAAK,YAAA;EAF4B;;;;EAOxC,QAAA,GACE,KAAA,WACA,OAAA;IACE,QAAA,EAAU,eAAA,CAAgB,YAAA;IAC1B,UAAA,EAAY,iBAAA,CAAkB,YAAA;IAC9B,KAAA,EAAO,YAAA,CAAa,YAAA;EAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;AACrB;AA6DL;;;;;;;;;;;;;;;;;;;;;AAKyC;;;;;;;;;;;;;;cAL5B,kBAAA,wBACU,WAAA,GAAc,WAAA;EACnC,KAAA,EAAA,UAAA;EAAA;AAAA,GAGC,yBAAA,CAA0B,YAAA"}