@fuf-stack/uniform 1.22.4 → 1.22.6

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"}

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"}