@fuf-stack/uniform 1.22.5 → 1.22.7

package/dist/useWatchUserChange-DSQGsl1R.js

@@ -1,84 +0,0 @@
-import { n as useFormContext } from "./useFormContext-CT8H8xIe.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
-export { useWatchUserChange as t };
-
-//# sourceMappingURL=useWatchUserChange-DSQGsl1R.js.map

package/dist/useWatchUserChange-DSQGsl1R.js.map

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