@fuf-stack/uniform 1.22.4 → 1.22.6

package/dist/hooks/useWatchFormReset/index.d.cts

@@ -1,2 +1,38 @@
-import { n as useWatchFormReset, t as UseWatchFormResetOptions } from "../../useWatchFormReset-BSd6jMxU.cjs";
-export { UseWatchFormResetOptions, useWatchFormReset };
+//#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 { UseWatchFormResetOptions, useWatchFormReset };
+//# sourceMappingURL=index.d.cts.map

package/dist/hooks/useWatchFormReset/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.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/hooks/useWatchFormReset/index.d.ts

@@ -1,2 +1,38 @@
-import { n as useWatchFormReset, t as UseWatchFormResetOptions } from "../../useWatchFormReset-C7YJ-I3N.js";
-export { UseWatchFormResetOptions, useWatchFormReset };
+//#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 { UseWatchFormResetOptions, useWatchFormReset };
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/useWatchFormReset/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.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/hooks/useWatchFormReset/index.js

@@ -1,4 +1,4 @@
-import { n as useFormContext } from "../../useFormContext-CT8H8xIe.js";
+import { n as useFormContext } from "../../useFormContext-BJqa1FoT.js";
 import { useEffect } from "react";
 //#region src/hooks/useWatchFormReset/useWatchFormReset.ts
 /**

package/dist/hooks/useWatchUserChange/index.cjs

@@ -1,8 +1,88 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_useWatchUserChange = require("../../useWatchUserChange-C1xWHtFG.cjs");
+const require_useFormContext = require("../../useFormContext-kUHonwgu.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
 //#region src/hooks/useWatchUserChange/index.ts
 /* v8 ignore stop */
 //#endregion
-exports.useWatchUserChange = require_useWatchUserChange.useWatchUserChange;
+exports.useWatchUserChange = useWatchUserChange;
 
 //# sourceMappingURL=index.cjs.map

package/dist/hooks/useWatchUserChange/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../../src/hooks/useWatchUserChange/index.ts"],"sourcesContent":["/* v8 ignore start */\n\nexport * from './useWatchUserChange';\n\n/* v8 ignore stop */\n"],"mappings":""}
+{"version":3,"file":"index.cjs","names":["useFormContext"],"sources":["../../../src/hooks/useWatchUserChange/useWatchUserChange.ts","../../../src/hooks/useWatchUserChange/index.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","/* v8 ignore start */\n\nexport * from './useWatchUserChange';\n\n/* v8 ignore stop */\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/hooks/useWatchUserChange/index.d.cts

@@ -1,2 +1,80 @@
-import { n as useWatchUserChange, t as UseWatchUserChangeOptions } from "../../useWatchUserChange-DSAboNCs.cjs";
-export { UseWatchUserChangeOptions, useWatchUserChange };
+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 { UseWatchUserChangeOptions, useWatchUserChange };
+//# sourceMappingURL=index.d.cts.map

package/dist/hooks/useWatchUserChange/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.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"}

package/dist/hooks/useWatchUserChange/index.d.ts

@@ -1,2 +1,80 @@
-import { n as useWatchUserChange, t as UseWatchUserChangeOptions } from "../../useWatchUserChange-CpyZz2i7.js";
-export { UseWatchUserChangeOptions, useWatchUserChange };
+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 { UseWatchUserChangeOptions, useWatchUserChange };
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/useWatchUserChange/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.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/hooks/useWatchUserChange/index.js

@@ -1,4 +1,84 @@
-import { t as useWatchUserChange } from "../../useWatchUserChange-DSQGsl1R.js";
+import { n as useFormContext } from "../../useFormContext-BJqa1FoT.js";
+import { useEffect } from "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 } = useFormContext();
+	useEffect(() => {
+		const listener = (fieldName, value) => {
+			if (fieldName === watchField) onChange(value, {
+				setValue,
+				resetField,
+				reset
+			});
+		};
+		return userChange.subscribe(listener);
+	}, [
+		watchField,
+		onChange,
+		setValue,
+		resetField,
+		reset,
+		userChange
+	]);
+};
+//#endregion
 //#region src/hooks/useWatchUserChange/index.ts
 /* v8 ignore stop */
 //#endregion

package/dist/hooks/useWatchUserChange/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/hooks/useWatchUserChange/index.ts"],"sourcesContent":["/* v8 ignore start */\n\nexport * from './useWatchUserChange';\n\n/* v8 ignore stop */\n"],"mappings":""}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/hooks/useWatchUserChange/useWatchUserChange.ts","../../../src/hooks/useWatchUserChange/index.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","/* v8 ignore start */\n\nexport * from './useWatchUserChange';\n\n/* v8 ignore stop */\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsFA,MAAa,sBAEX,EACA,OAAO,YACP,eAC6C;CAC7C,MAAM,EAAE,UAAU,YAAY,OAAO,eACnC,eAA6B;CAE/B,gBAAgB;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/partials/FieldCopyTestIdButton/index.cjs

@@ -2,6 +2,5 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_FieldCopyTestIdButton = require("../../FieldCopyTestIdButton-ptoB1F75.cjs");
-exports.FieldCopyTestIdButton = require_FieldCopyTestIdButton.FieldCopyTestIdButton;
+const require_FieldCopyTestIdButton = require("../../FieldCopyTestIdButton-D3D_LmJh.cjs");
 exports.default = require_FieldCopyTestIdButton.FieldCopyTestIdButton_default;

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

@@ -1,2 +1,14 @@
-import { n as FieldCopyTestIdButtonProps, t as FieldCopyTestIdButton } from "../../index-CXvUaeCL.cjs";
-export { FieldCopyTestIdButton, FieldCopyTestIdButton as default, type FieldCopyTestIdButtonProps };
+//#region src/partials/FieldCopyTestIdButton/FieldCopyTestIdButton.d.ts
+interface FieldCopyTestIdButtonProps {
+  /** CSS class name */
+  className?: string;
+  /** HTML data-testid attribute used in e2e tests */
+  testId: string;
+}
+declare const FieldCopyTestIdButton: ({
+  className,
+  testId
+}: FieldCopyTestIdButtonProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+export { type FieldCopyTestIdButtonProps, FieldCopyTestIdButton as default };
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/partials/FieldCopyTestIdButton/FieldCopyTestIdButton.tsx"],"mappings":";UAKiB,0BAAA;EAAA;EAEf,SAAA;;EAEA,MAAM;AAAA;AAAA,cAGF,qBAAA;EAAyB,SAAA;EAAA;AAAA,GAG5B,0BAAA,iCAA0B,GAAA,CAAA,OAAA"}

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

@@ -1,2 +1,14 @@
-import { n as FieldCopyTestIdButtonProps, t as FieldCopyTestIdButton } from "../../index-CHQKk_fN2.js";
-export { FieldCopyTestIdButton, FieldCopyTestIdButton as default, type FieldCopyTestIdButtonProps };
+//#region src/partials/FieldCopyTestIdButton/FieldCopyTestIdButton.d.ts
+interface FieldCopyTestIdButtonProps {
+  /** CSS class name */
+  className?: string;
+  /** HTML data-testid attribute used in e2e tests */
+  testId: string;
+}
+declare const FieldCopyTestIdButton: ({
+  className,
+  testId
+}: FieldCopyTestIdButtonProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+export { type FieldCopyTestIdButtonProps, FieldCopyTestIdButton as default };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/partials/FieldCopyTestIdButton/FieldCopyTestIdButton.tsx"],"mappings":";UAKiB,0BAAA;EAAA;EAEf,SAAA;;EAEA,MAAM;AAAA;AAAA,cAGF,qBAAA;EAAyB,SAAA;EAAA;AAAA,GAG5B,0BAAA,iCAA0B,GAAA,CAAA,OAAA"}

package/dist/partials/FieldCopyTestIdButton/index.js

@@ -1,2 +1,2 @@
-import { n as FieldCopyTestIdButton, t as FieldCopyTestIdButton_default } from "../../FieldCopyTestIdButton-Dpmo0uBV.js";
-export { FieldCopyTestIdButton, FieldCopyTestIdButton_default as default };
+import { t as FieldCopyTestIdButton_default } from "../../FieldCopyTestIdButton-CRJBix9D.js";
+export { FieldCopyTestIdButton_default as default };

package/dist/partials/FieldValidationError/index.cjs

@@ -2,6 +2,5 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_FieldValidationError = require("../../FieldValidationError-BQcvvU9i.cjs");
-exports.FieldValidationError = require_FieldValidationError.FieldValidationError;
+const require_FieldValidationError = require("../../FieldValidationError-CfYKzl7P.cjs");
 exports.default = require_FieldValidationError.FieldValidationError_default;

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

@@ -1,2 +1,22 @@
-import { n as FieldValidationErrorProps, t as FieldValidationError } from "../../index-P30z4VRT.cjs";
-export { FieldValidationError, FieldValidationError as default, type FieldValidationErrorProps };
+import { FieldError } from "react-hook-form";
+
+//#region src/partials/FieldValidationError/FieldValidationError.d.ts
+interface FieldValidationErrorProps {
+  /** CSS class name */
+  className?: string;
+  /** Field errors */
+  error?: FieldError[];
+  /** HTML data-testid attribute used in e2e tests */
+  testId: string;
+}
+/**
+ * Renders a validation error of a field
+ */
+declare const FieldValidationError: ({
+  className,
+  error,
+  testId
+}: FieldValidationErrorProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+export { type FieldValidationErrorProps, FieldValidationError as default };
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/partials/FieldValidationError/FieldValidationError.tsx"],"mappings":";;;UASiB,yBAAA;;EAEf,SAAA;EAFwC;EAIxC,KAAA,GAAQ,UAAU;EAAA;EAElB,MAAA;AAAA;;;;cAMI,oBAAA;EAAwB,SAAA;EAAA,KAAA;EAAA;AAAA,GAI3B,yBAAA,iCAAyB,GAAA,CAAA,OAAA"}

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

@@ -1,2 +1,22 @@
-import { n as FieldValidationErrorProps, t as FieldValidationError } from "../../index-CEJxjf5R.js";
-export { FieldValidationError, FieldValidationError as default, type FieldValidationErrorProps };
+import { FieldError } from "react-hook-form";
+
+//#region src/partials/FieldValidationError/FieldValidationError.d.ts
+interface FieldValidationErrorProps {
+  /** CSS class name */
+  className?: string;
+  /** Field errors */
+  error?: FieldError[];
+  /** HTML data-testid attribute used in e2e tests */
+  testId: string;
+}
+/**
+ * Renders a validation error of a field
+ */
+declare const FieldValidationError: ({
+  className,
+  error,
+  testId
+}: FieldValidationErrorProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+export { type FieldValidationErrorProps, FieldValidationError as default };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/partials/FieldValidationError/FieldValidationError.tsx"],"mappings":";;;UASiB,yBAAA;;EAEf,SAAA;EAFwC;EAIxC,KAAA,GAAQ,UAAU;EAAA;EAElB,MAAA;AAAA;;;;cAMI,oBAAA;EAAwB,SAAA;EAAA,KAAA;EAAA;AAAA,GAI3B,yBAAA,iCAAyB,GAAA,CAAA,OAAA"}

package/dist/partials/FieldValidationError/index.js

@@ -1,2 +1,2 @@
-import { n as FieldValidationError, t as FieldValidationError_default } from "../../FieldValidationError-ktTyyyip.js";
-export { FieldValidationError, FieldValidationError_default as default };
+import { t as FieldValidationError_default } from "../../FieldValidationError-ByRoIxaM.js";
+export { FieldValidationError_default as default };

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

package/dist/{useController-CzP0aVFC.d.ts.map → useController-CvQqCvFJ.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"useController-CzP0aVFC.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"}
+{"version":3,"file":"useController-CvQqCvFJ.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--lRPWBuD.cjs → useController-Dbe7ADG6.cjs}

@@ -1,4 +1,4 @@
-const require_FormContext = require("./FormContext-DsmS_mkO.cjs");
+const require_FormContext = require("./FormContext-EGH0cVnH.cjs");
 const require_helpers_index = require("./helpers/index.cjs");
 let react = require("react");
 let react_hook_form = require("react-hook-form");
@@ -47,4 +47,4 @@ Object.defineProperty(exports, "useController", {
 	}
 });
 
-//# sourceMappingURL=useController--lRPWBuD.cjs.map
+//# sourceMappingURL=useController-Dbe7ADG6.cjs.map