@fuf-stack/uniform 1.18.3 → 1.19.1

package/dist/useInputValueDebounce-CRaM7HEM.cjs

@@ -1,99 +0,0 @@
-const require_FormContext = require('./FormContext-BSLO2-sO.cjs');
-const require_useFormContext = require('./useFormContext-vdeeDsAs.cjs');
-let react = require("react");
-
-//#region src/hooks/useInputValueDebounce/useInputValueDebounce.ts
-/**
-* Custom hook for debouncing value changes with immediate blur support.
-*
-* Provides immediate visual feedback by updating the value instantly,
-* while debouncing the actual onChange calls. When focus is lost,
-* any pending debounced changes are immediately flushed.
-*
-* **Key Features:**
-* - **Debouncing**: Delays onChange calls until user stops typing
-* - **Generic type support**: Works with any data type (strings, numbers, arrays, objects)
-* - **Immediate value updates**: UI stays responsive during debouncing
-* - **Blur flushing**: Immediately applies pending changes on blur
-*
-* **Note:** Value transformations should be handled at the `useUniformField` level,
-* not in this hook. This hook only handles debouncing timing.
-*
-* @param options Configuration for debounced value handling
-* @param options.debounceDelay Delay in milliseconds (default: 300)
-* @param options.onBlur Function to call after flushing debounced value
-* @param options.onChange Function to call with debounced value
-* @param options.value The field value
-* @returns Object containing enhanced onChange, onBlur, and immediate value
-*
-* @example
-* Basic usage with debouncing:
-* ```tsx
-* const { onChange, onBlur, value } = useInputValueDebounce({
-*   debounceDelay: 300,
-*   name: 'fieldName',
-*   onBlur: field.onBlur,
-*   onChange: field.onChange,
-*   value: field.value,
-* });
-* ```
-*/
-const useInputValueDebounce = ({ debounceDelay = 300, name, onBlur, onChange, value }) => {
-	const { trigger } = require_useFormContext.useFormContext();
-	const [currentValue, setCurrentValue] = (0, react.useState)(value);
-	const timeoutRef = (0, react.useRef)(null);
-	(0, react.useEffect)(() => {
-		setCurrentValue(value);
-	}, [value]);
-	return {
-		onChange: (0, react.useCallback)((...event) => {
-			const newValue = event[0]?.target?.value ?? event[0];
-			setCurrentValue(newValue);
-			if (timeoutRef.current) clearTimeout(timeoutRef.current);
-			const executeOnChange = () => {
-				if (event[0]?.target) onChange({
-					...event[0],
-					target: {
-						...event[0].target,
-						value: newValue
-					}
-				}, ...event.slice(1));
-				else onChange(newValue);
-				trigger(name);
-			};
-			if (debounceDelay <= 0) executeOnChange();
-			else timeoutRef.current = setTimeout(executeOnChange, debounceDelay);
-		}, [
-			onChange,
-			debounceDelay,
-			trigger,
-			name
-		]),
-		onBlur: (0, react.useCallback)(() => {
-			if (timeoutRef.current) {
-				clearTimeout(timeoutRef.current);
-				timeoutRef.current = null;
-				onChange(currentValue);
-			}
-			onBlur();
-		}, [
-			onChange,
-			onBlur,
-			currentValue
-		]),
-		value: currentValue
-	};
-};
-
-//#endregion
-//#region src/hooks/useInputValueDebounce/index.ts
-/* v8 ignore stop */
-
-//#endregion
-Object.defineProperty(exports, 'useInputValueDebounce', {
-  enumerable: true,
-  get: function () {
-    return useInputValueDebounce;
-  }
-});
-//# sourceMappingURL=useInputValueDebounce-CRaM7HEM.cjs.map

package/dist/useInputValueDebounce-CRaM7HEM.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"useInputValueDebounce-CRaM7HEM.cjs","names":["useFormContext"],"sources":["../src/hooks/useInputValueDebounce/useInputValueDebounce.ts","../src/hooks/useInputValueDebounce/index.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\n\nimport { useFormContext } from '../useFormContext';\n\nexport interface UseInputValueDebounceOptions<TValue = unknown> {\n  /** Debounce delay in milliseconds (default: 300) */\n  debounceDelay?: number;\n  /** Field name for triggering validation after debounced value commits */\n  name: string;\n  /** The onBlur function to call after flushing debounced value */\n  onBlur: () => void;\n  /** The onChange function to call with debounced value */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  onChange: (...event: any[]) => void;\n  /** The field value */\n  value: TValue;\n}\n\nexport interface UseInputValueDebounceReturn<TValue = unknown> {\n  /** Enhanced onChange function with debouncing */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  onChange: (...event: any[]) => void;\n  /** Enhanced onBlur function that flushes current value immediately */\n  onBlur: () => void;\n  /** The field value that is displayed - updates immediately */\n  value: TValue;\n}\n\n/**\n * Custom hook for debouncing value changes with immediate blur support.\n *\n * Provides immediate visual feedback by updating the value instantly,\n * while debouncing the actual onChange calls. When focus is lost,\n * any pending debounced changes are immediately flushed.\n *\n * **Key Features:**\n * - **Debouncing**: Delays onChange calls until user stops typing\n * - **Generic type support**: Works with any data type (strings, numbers, arrays, objects)\n * - **Immediate value updates**: UI stays responsive during debouncing\n * - **Blur flushing**: Immediately applies pending changes on blur\n *\n * **Note:** Value transformations should be handled at the `useUniformField` level,\n * not in this hook. This hook only handles debouncing timing.\n *\n * @param options Configuration for debounced value handling\n * @param options.debounceDelay Delay in milliseconds (default: 300)\n * @param options.onBlur Function to call after flushing debounced value\n * @param options.onChange Function to call with debounced value\n * @param options.value The field value\n * @returns Object containing enhanced onChange, onBlur, and immediate value\n *\n * @example\n * Basic usage with debouncing:\n * ```tsx\n * const { onChange, onBlur, value } = useInputValueDebounce({\n *   debounceDelay: 300,\n *   name: 'fieldName',\n *   onBlur: field.onBlur,\n *   onChange: field.onChange,\n *   value: field.value,\n * });\n * ```\n */\nexport const useInputValueDebounce = <TValue = unknown>({\n  debounceDelay = 300,\n  name,\n  onBlur,\n  onChange,\n  value,\n}: UseInputValueDebounceOptions<TValue>): UseInputValueDebounceReturn<TValue> => {\n  const { trigger } = useFormContext();\n\n  // Track value for synchronous updates\n  const [currentValue, setCurrentValue] = useState<TValue>(value);\n\n  const timeoutRef = useRef<NodeJS.Timeout | null>(null);\n\n  // Sync with external value changes\n  useEffect(() => {\n    setCurrentValue(value);\n  }, [value]);\n\n  // Enhanced onChange handler with debouncing\n  const handleChange = useCallback(\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (...event: any[]) => {\n      // Extract the raw value\n      const newValue = (event[0]?.target?.value ?? event[0]) as TValue;\n      setCurrentValue(newValue);\n\n      // Clear existing timeout\n      if (timeoutRef.current) {\n        clearTimeout(timeoutRef.current);\n      }\n\n      const executeOnChange = () => {\n        // Preserve event structure if original was an event\n        if (event[0]?.target) {\n          const convertedEvent = {\n            ...event[0],\n            target: {\n              ...event[0].target,\n              value: newValue,\n            },\n          };\n          onChange(convertedEvent, ...event.slice(1));\n        } else {\n          onChange(newValue);\n        }\n        // Trigger validation after debounced value commits\n        // This ensures errors are updated immediately when field becomes valid\n        trigger(name);\n      };\n\n      // Execute immediately or after delay\n      if (debounceDelay <= 0) {\n        executeOnChange();\n      } else {\n        timeoutRef.current = setTimeout(executeOnChange, debounceDelay);\n      }\n    },\n    [onChange, debounceDelay, trigger, name],\n  );\n\n  // Enhanced blur handler\n  const handleBlur = useCallback(() => {\n    // Flush pending changes\n    if (timeoutRef.current) {\n      clearTimeout(timeoutRef.current);\n      timeoutRef.current = null;\n      onChange(currentValue);\n    }\n    onBlur();\n  }, [onChange, onBlur, currentValue]);\n\n  return {\n    onChange: handleChange,\n    onBlur: handleBlur,\n    value: currentValue,\n  };\n};\n","/* v8 ignore start */\n\nexport * from './useInputValueDebounce';\n\n/* v8 ignore stop */\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+DA,MAAa,yBAA2C,EACtD,gBAAgB,KAChB,MACA,QACA,UACA,YAC+E;CAC/E,MAAM,EAAE,YAAYA,uCAAgB;CAGpC,MAAM,CAAC,cAAc,uCAAoC,MAAM;CAE/D,MAAM,+BAA2C,KAAK;AAGtD,4BAAgB;AACd,kBAAgB,MAAM;IACrB,CAAC,MAAM,CAAC;AAuDX,QAAO;EACL,kCAnDC,GAAG,UAAiB;GAEnB,MAAM,WAAY,MAAM,IAAI,QAAQ,SAAS,MAAM;AACnD,mBAAgB,SAAS;AAGzB,OAAI,WAAW,QACb,cAAa,WAAW,QAAQ;GAGlC,MAAM,wBAAwB;AAE5B,QAAI,MAAM,IAAI,OAQZ,UAPuB;KACrB,GAAG,MAAM;KACT,QAAQ;MACN,GAAG,MAAM,GAAG;MACZ,OAAO;MACR;KACF,EACwB,GAAG,MAAM,MAAM,EAAE,CAAC;QAE3C,UAAS,SAAS;AAIpB,YAAQ,KAAK;;AAIf,OAAI,iBAAiB,EACnB,kBAAiB;OAEjB,YAAW,UAAU,WAAW,iBAAiB,cAAc;KAGnE;GAAC;GAAU;GAAe;GAAS;GAAK,CACzC;EAeC,qCAZmC;AAEnC,OAAI,WAAW,SAAS;AACtB,iBAAa,WAAW,QAAQ;AAChC,eAAW,UAAU;AACrB,aAAS,aAAa;;AAExB,WAAQ;KACP;GAAC;GAAU;GAAQ;GAAa,CAAC;EAKlC,OAAO;EACR"}

package/dist/useInputValueDebounce-DJO5uzLb.js

@@ -1,93 +0,0 @@
-import { n as useFormContext } from "./useFormContext-Di67HIf7.js";
-import { useCallback, useEffect, useRef, useState } from "react";
-
-//#region src/hooks/useInputValueDebounce/useInputValueDebounce.ts
-/**
-* Custom hook for debouncing value changes with immediate blur support.
-*
-* Provides immediate visual feedback by updating the value instantly,
-* while debouncing the actual onChange calls. When focus is lost,
-* any pending debounced changes are immediately flushed.
-*
-* **Key Features:**
-* - **Debouncing**: Delays onChange calls until user stops typing
-* - **Generic type support**: Works with any data type (strings, numbers, arrays, objects)
-* - **Immediate value updates**: UI stays responsive during debouncing
-* - **Blur flushing**: Immediately applies pending changes on blur
-*
-* **Note:** Value transformations should be handled at the `useUniformField` level,
-* not in this hook. This hook only handles debouncing timing.
-*
-* @param options Configuration for debounced value handling
-* @param options.debounceDelay Delay in milliseconds (default: 300)
-* @param options.onBlur Function to call after flushing debounced value
-* @param options.onChange Function to call with debounced value
-* @param options.value The field value
-* @returns Object containing enhanced onChange, onBlur, and immediate value
-*
-* @example
-* Basic usage with debouncing:
-* ```tsx
-* const { onChange, onBlur, value } = useInputValueDebounce({
-*   debounceDelay: 300,
-*   name: 'fieldName',
-*   onBlur: field.onBlur,
-*   onChange: field.onChange,
-*   value: field.value,
-* });
-* ```
-*/
-const useInputValueDebounce = ({ debounceDelay = 300, name, onBlur, onChange, value }) => {
-	const { trigger } = useFormContext();
-	const [currentValue, setCurrentValue] = useState(value);
-	const timeoutRef = useRef(null);
-	useEffect(() => {
-		setCurrentValue(value);
-	}, [value]);
-	return {
-		onChange: useCallback((...event) => {
-			const newValue = event[0]?.target?.value ?? event[0];
-			setCurrentValue(newValue);
-			if (timeoutRef.current) clearTimeout(timeoutRef.current);
-			const executeOnChange = () => {
-				if (event[0]?.target) onChange({
-					...event[0],
-					target: {
-						...event[0].target,
-						value: newValue
-					}
-				}, ...event.slice(1));
-				else onChange(newValue);
-				trigger(name);
-			};
-			if (debounceDelay <= 0) executeOnChange();
-			else timeoutRef.current = setTimeout(executeOnChange, debounceDelay);
-		}, [
-			onChange,
-			debounceDelay,
-			trigger,
-			name
-		]),
-		onBlur: useCallback(() => {
-			if (timeoutRef.current) {
-				clearTimeout(timeoutRef.current);
-				timeoutRef.current = null;
-				onChange(currentValue);
-			}
-			onBlur();
-		}, [
-			onChange,
-			onBlur,
-			currentValue
-		]),
-		value: currentValue
-	};
-};
-
-//#endregion
-//#region src/hooks/useInputValueDebounce/index.ts
-/* v8 ignore stop */
-
-//#endregion
-export { useInputValueDebounce as t };
-//# sourceMappingURL=useInputValueDebounce-DJO5uzLb.js.map

package/dist/useInputValueDebounce-DJO5uzLb.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useInputValueDebounce-DJO5uzLb.js","names":[],"sources":["../src/hooks/useInputValueDebounce/useInputValueDebounce.ts","../src/hooks/useInputValueDebounce/index.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\n\nimport { useFormContext } from '../useFormContext';\n\nexport interface UseInputValueDebounceOptions<TValue = unknown> {\n  /** Debounce delay in milliseconds (default: 300) */\n  debounceDelay?: number;\n  /** Field name for triggering validation after debounced value commits */\n  name: string;\n  /** The onBlur function to call after flushing debounced value */\n  onBlur: () => void;\n  /** The onChange function to call with debounced value */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  onChange: (...event: any[]) => void;\n  /** The field value */\n  value: TValue;\n}\n\nexport interface UseInputValueDebounceReturn<TValue = unknown> {\n  /** Enhanced onChange function with debouncing */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  onChange: (...event: any[]) => void;\n  /** Enhanced onBlur function that flushes current value immediately */\n  onBlur: () => void;\n  /** The field value that is displayed - updates immediately */\n  value: TValue;\n}\n\n/**\n * Custom hook for debouncing value changes with immediate blur support.\n *\n * Provides immediate visual feedback by updating the value instantly,\n * while debouncing the actual onChange calls. When focus is lost,\n * any pending debounced changes are immediately flushed.\n *\n * **Key Features:**\n * - **Debouncing**: Delays onChange calls until user stops typing\n * - **Generic type support**: Works with any data type (strings, numbers, arrays, objects)\n * - **Immediate value updates**: UI stays responsive during debouncing\n * - **Blur flushing**: Immediately applies pending changes on blur\n *\n * **Note:** Value transformations should be handled at the `useUniformField` level,\n * not in this hook. This hook only handles debouncing timing.\n *\n * @param options Configuration for debounced value handling\n * @param options.debounceDelay Delay in milliseconds (default: 300)\n * @param options.onBlur Function to call after flushing debounced value\n * @param options.onChange Function to call with debounced value\n * @param options.value The field value\n * @returns Object containing enhanced onChange, onBlur, and immediate value\n *\n * @example\n * Basic usage with debouncing:\n * ```tsx\n * const { onChange, onBlur, value } = useInputValueDebounce({\n *   debounceDelay: 300,\n *   name: 'fieldName',\n *   onBlur: field.onBlur,\n *   onChange: field.onChange,\n *   value: field.value,\n * });\n * ```\n */\nexport const useInputValueDebounce = <TValue = unknown>({\n  debounceDelay = 300,\n  name,\n  onBlur,\n  onChange,\n  value,\n}: UseInputValueDebounceOptions<TValue>): UseInputValueDebounceReturn<TValue> => {\n  const { trigger } = useFormContext();\n\n  // Track value for synchronous updates\n  const [currentValue, setCurrentValue] = useState<TValue>(value);\n\n  const timeoutRef = useRef<NodeJS.Timeout | null>(null);\n\n  // Sync with external value changes\n  useEffect(() => {\n    setCurrentValue(value);\n  }, [value]);\n\n  // Enhanced onChange handler with debouncing\n  const handleChange = useCallback(\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (...event: any[]) => {\n      // Extract the raw value\n      const newValue = (event[0]?.target?.value ?? event[0]) as TValue;\n      setCurrentValue(newValue);\n\n      // Clear existing timeout\n      if (timeoutRef.current) {\n        clearTimeout(timeoutRef.current);\n      }\n\n      const executeOnChange = () => {\n        // Preserve event structure if original was an event\n        if (event[0]?.target) {\n          const convertedEvent = {\n            ...event[0],\n            target: {\n              ...event[0].target,\n              value: newValue,\n            },\n          };\n          onChange(convertedEvent, ...event.slice(1));\n        } else {\n          onChange(newValue);\n        }\n        // Trigger validation after debounced value commits\n        // This ensures errors are updated immediately when field becomes valid\n        trigger(name);\n      };\n\n      // Execute immediately or after delay\n      if (debounceDelay <= 0) {\n        executeOnChange();\n      } else {\n        timeoutRef.current = setTimeout(executeOnChange, debounceDelay);\n      }\n    },\n    [onChange, debounceDelay, trigger, name],\n  );\n\n  // Enhanced blur handler\n  const handleBlur = useCallback(() => {\n    // Flush pending changes\n    if (timeoutRef.current) {\n      clearTimeout(timeoutRef.current);\n      timeoutRef.current = null;\n      onChange(currentValue);\n    }\n    onBlur();\n  }, [onChange, onBlur, currentValue]);\n\n  return {\n    onChange: handleChange,\n    onBlur: handleBlur,\n    value: currentValue,\n  };\n};\n","/* v8 ignore start */\n\nexport * from './useInputValueDebounce';\n\n/* v8 ignore stop */\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+DA,MAAa,yBAA2C,EACtD,gBAAgB,KAChB,MACA,QACA,UACA,YAC+E;CAC/E,MAAM,EAAE,YAAY,gBAAgB;CAGpC,MAAM,CAAC,cAAc,mBAAmB,SAAiB,MAAM;CAE/D,MAAM,aAAa,OAA8B,KAAK;AAGtD,iBAAgB;AACd,kBAAgB,MAAM;IACrB,CAAC,MAAM,CAAC;AAuDX,QAAO;EACL,UArDmB,aAElB,GAAG,UAAiB;GAEnB,MAAM,WAAY,MAAM,IAAI,QAAQ,SAAS,MAAM;AACnD,mBAAgB,SAAS;AAGzB,OAAI,WAAW,QACb,cAAa,WAAW,QAAQ;GAGlC,MAAM,wBAAwB;AAE5B,QAAI,MAAM,IAAI,OAQZ,UAPuB;KACrB,GAAG,MAAM;KACT,QAAQ;MACN,GAAG,MAAM,GAAG;MACZ,OAAO;MACR;KACF,EACwB,GAAG,MAAM,MAAM,EAAE,CAAC;QAE3C,UAAS,SAAS;AAIpB,YAAQ,KAAK;;AAIf,OAAI,iBAAiB,EACnB,kBAAiB;OAEjB,YAAW,UAAU,WAAW,iBAAiB,cAAc;KAGnE;GAAC;GAAU;GAAe;GAAS;GAAK,CACzC;EAeC,QAZiB,kBAAkB;AAEnC,OAAI,WAAW,SAAS;AACtB,iBAAa,WAAW,QAAQ;AAChC,eAAW,UAAU;AACrB,aAAS,aAAa;;AAExB,WAAQ;KACP;GAAC;GAAU;GAAQ;GAAa,CAAC;EAKlC,OAAO;EACR"}

package/dist/useUniformField-6c4OCAfb.cjs

@@ -1,142 +0,0 @@
-const require_FormContext = require('./FormContext-BSLO2-sO.cjs');
-const require_helpers = require('./helpers-Bd_QpqXg.cjs');
-const require_FieldCopyTestIdButton = require('./FieldCopyTestIdButton-4uupFq1U.cjs');
-const require_FieldValidationError = require('./FieldValidationError-Br6iopZj.cjs');
-const require_useController = require('./useController-B_SSp5Z5.cjs');
-const require_useFormContext = require('./useFormContext-vdeeDsAs.cjs');
-const require_useInputValueTransform = require('./useInputValueTransform-BBRvvhDe.cjs');
-let react = require("react");
-react = require_FormContext.__toESM(react);
-let _fuf_stack_pixels = require("@fuf-stack/pixels");
-let react_jsx_runtime = require("react/jsx-runtime");
-let _heroui_input = require("@heroui/input");
-
-//#region src/hooks/useUniformField/useUniformField.tsx
-/**
-* 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
-*/
-const useUniformField = (params) => {
-	const { name, ariaLabel: customAriaLabel, disabled = false, testId: explicitTestId, label, type, transform } = params;
-	const { control, debugMode, formState: { submitCount }, getFieldState, getValues, resetField } = require_useFormContext.useFormContext();
-	const { error, invalid: rawInvalid, isTouched, required, testId } = getFieldState(name, explicitTestId);
-	const { field } = require_useController.useController({
-		control,
-		disabled,
-		name
-	});
-	const { onChange: fieldOnChange, value: fieldValue, disabled: isDisabled, onBlur, ref } = field;
-	const { toDisplayValue, toFormValue } = require_useInputValueTransform.useInputValueTransform({
-		type,
-		transform
-	});
-	const transformedValue = toDisplayValue(fieldValue);
-	const transformedOnChange = (eventOrValue) => {
-		fieldOnChange(toFormValue(eventOrValue?.target?.value ?? eventOrValue));
-	};
-	const defaultValue = getValues()?.[name];
-	/**
-	* Determine when to show the invalid state to the user.
-	*
-	* Show errors when the field is invalid AND any of these conditions are met:
-	*   - Field has a value (show validation errors like format/length while typing)
-	*   - Field is touched (focused and blurred) - good for text inputs
-	*   - Form has been submitted - shows all errors after submit attempt
-	*
-	* Note: We intentionally don't use isDirty because:
-	*   - Newly added array elements are marked "dirty" by RHF, causing immediate errors
-	*   - Field Cards with empty initial values show errors immediately
-	*   - hasValue + isTouched covers the same use cases more reliably
-	*
-	* This prevents showing errors on pristine/untouched/empty fields for better UX.
-	* Examples:
-	*   - Text input: User loads form with empty required field → no error shown yet
-	*   - Text input: User types invalid content → error shows immediately (has value)
-	*   - Text input: User focuses and blurs without typing → error shows (via isTouched)
-	*   - Checkbox/radio: User selects option → error shows immediately (has value)
-	*   - Field array: User adds element → no error yet; after blur → error shows
-	*   - Any field: User submits form → all errors show (via submitCount)
-	*
-	* The entire condition is debounced to prevent flickering and allow smooth animations.
-	*/
-	const hasValue = !require_helpers.isValueEmpty(fieldValue);
-	const invalid = (0, _fuf_stack_pixels.useDebounce)(rawInvalid && (hasValue || isTouched || submitCount > 0), 200);
-	const showTestIdCopyButton = debugMode === "debug-testids";
-	const labelNode = !!label || showTestIdCopyButton ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [label !== false ? label : null, showTestIdCopyButton ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_FieldCopyTestIdButton.FieldCopyTestIdButton_default$1, { testId }) : null] }) : null;
-	const errorMessage = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_FieldValidationError.FieldValidationError_default$1, {
-		error,
-		testId
-	});
-	const { getErrorMessageProps, getLabelProps, getHelperWrapperProps } = (0, _heroui_input.useInput)({
-		ref,
-		classNames: { helperWrapper: "p-0" },
-		errorMessage: JSON.stringify(error),
-		isInvalid: invalid,
-		isRequired: required,
-		label,
-		labelPlacement: "outside"
-	});
-	return {
-		ariaLabel: customAriaLabel ?? (typeof label === "string" ? label : name),
-		control,
-		debugMode,
-		defaultValue,
-		disabled: isDisabled,
-		error,
-		errorMessage,
-		field: {
-			...field,
-			value: transformedValue,
-			onChange: transformedOnChange
-		},
-		getErrorMessageProps,
-		getHelperWrapperProps,
-		getLabelProps,
-		getValues,
-		invalid,
-		label: labelNode,
-		onBlur,
-		onChange: transformedOnChange,
-		ref,
-		required,
-		resetField,
-		testId
-	};
-};
-
-//#endregion
-//#region src/hooks/useUniformField/index.ts
-/* v8 ignore stop */
-
-//#endregion
-Object.defineProperty(exports, 'useUniformField', {
-  enumerable: true,
-  get: function () {
-    return useUniformField;
-  }
-});
-//# sourceMappingURL=useUniformField-6c4OCAfb.cjs.map

package/dist/useUniformField-6c4OCAfb.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"useUniformField-6c4OCAfb.cjs","names":["useFormContext","useController","useInputValueTransform","isValueEmpty","FieldCopyTestIdButton","FieldValidationError"],"sources":["../src/hooks/useUniformField/useUniformField.tsx","../src/hooks/useUniformField/index.ts"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type { FieldError, FieldValues, Path } from 'react-hook-form';\nimport type { InputValueTransform } from '../useInputValueTransform/useInputValueTransform';\n\nimport React from 'react';\n\nimport { useDebounce } from '@fuf-stack/pixels';\n\nimport { isValueEmpty } from '../../helpers';\nimport { FieldCopyTestIdButton } from '../../partials/FieldCopyTestIdButton';\nimport { FieldValidationError } from '../../partials/FieldValidationError';\nimport { useController } from '../useController/useController';\nimport { useFormContext } from '../useFormContext/useFormContext';\nimport { useInput } from '../useInput/useInput';\nimport { useInputValueTransform } from '../useInputValueTransform/useInputValueTransform';\n\nexport interface UseUniformFieldParams<\n  TFieldValues extends FieldValues = FieldValues,\n  TDisplay = unknown,\n> {\n  /** Form field name */\n  name: Path<TFieldValues> & string;\n  /** Custom aria-label for accessibility. If not provided, falls back to field name when no visible label exists */\n  ariaLabel?: string;\n  /** Disable the field */\n  disabled?: boolean;\n  /** Optional label content */\n  label?: ReactNode;\n  /** Optional explicit test id used to build stable test ids */\n  testId?: string;\n  /** Optional value transformation between form and display values */\n  transform?: InputValueTransform<TDisplay>;\n  /** Input type for special number handling */\n  type?: 'text' | 'number' | 'password';\n}\n\nexport interface UseUniformFieldReturn<\n  TFieldValues extends FieldValues = FieldValues,\n> {\n  /** 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) */\n  ariaLabel: string | undefined;\n  /** react-hook-form control instance for advanced integrations */\n  control: ReturnType<typeof useFormContext<TFieldValues>>['control'];\n  /** Debug mode from Uniform provider */\n  debugMode: ReturnType<typeof useFormContext<TFieldValues>>['debugMode'];\n  /** Current value used to initialize uncontrolled components */\n  defaultValue: unknown;\n  /** Whether the field is currently disabled (from RHF) */\n  disabled: boolean | undefined;\n  /** Validation error(s) for the field */\n  error: FieldError[] | undefined;\n  /** Pre-built errorMessage node to plug into components */\n  errorMessage: ReactNode | null;\n  /** RHF controller field with transformed value/onChange (use this for simple components) */\n  field: ReturnType<typeof useController<TFieldValues>>['field'];\n  /** Helper to spread standardized error message props to underlying components */\n  getErrorMessageProps: ReturnType<typeof useInput>['getErrorMessageProps'];\n  /** Helper to spread standardized helper wrapper props (for spacing/animation) */\n  getHelperWrapperProps: ReturnType<typeof useInput>['getHelperWrapperProps'];\n  /** Helper to spread standardized label props to underlying components */\n  getLabelProps: ReturnType<typeof useInput>['getLabelProps'];\n  /** Access current form values (converted to validation-friendly format) */\n  getValues: ReturnType<typeof useFormContext<TFieldValues>>['getValues'];\n  /** Whether the field should show invalid state (debounced for smooth animations). True when field is invalid AND (dirty OR touched OR submitted) */\n  invalid: boolean;\n  /** Computed label node including optional test id copy button */\n  label: ReactNode | null;\n  /** onBlur handler from controller */\n  onBlur: ReturnType<typeof useController<TFieldValues>>['field']['onBlur'];\n  /** onChange handler from controller (with transform applied) */\n  onChange: ReturnType<typeof useController<TFieldValues>>['field']['onChange'];\n  /** Ref to forward to underlying control */\n  ref: ReturnType<typeof useController<TFieldValues>>['field']['ref'];\n  /** Whether the field is required according to validation schema */\n  required: boolean;\n  /** Reset a specific field in the form */\n  resetField: ReturnType<typeof useFormContext<TFieldValues>>['resetField'];\n  /** Generated HTML data-testid for the field */\n  testId: string;\n}\n\n/**\n * Combines frequently used form field logic into a single hook.\n *\n * Provides:\n * - Enhanced form context (validation-aware state, `testId`, value transforms)\n * - Controller field with nullish conversion handling\n * - Value transformation via `transform` prop:\n *   • Allows disentangled display and form values (e.g., string ↔ object, boolean ↔ array)\n *   • Automatically applies `toDisplayValue` to field value for components\n *   • Automatically applies `toFormValue` to display value when onChange is called\n *   • Works with `type` prop for automatic number/string conversion\n *   • Examples: storing objects while displaying strings, storing booleans as arrays, enriching values with metadata\n * - Debounced `invalid` state with smart timing:\n *   • `true` (field becomes invalid): applies immediately so errors show right away\n *   • `false` (field becomes valid): delayed 200ms to allow smooth exit animations\n *   • Respects `prefers-reduced-motion` by skipping delays when user prefers reduced motion\n * - Smart `invalid` visibility (via `showInvalid`):\n *   • Shows errors when field is dirty OR touched OR form has been submitted\n *   • Prevents showing errors on pristine/untouched fields for better UX\n *   • Works well for all field types (text inputs, checkboxes, radios, arrays)\n * - Prebuilt `errorMessage` React node using `FieldValidationError`\n * - Computed `label` node which appends a `FieldCopyTestIdButton` in\n *   `debug-testids` mode\n * - `defaultValue` for uncontrolled defaults and all usual field handlers\n * - Access to form utilities: `control`, `getValues`, `resetField`\n * - Presentation helpers: `getLabelProps`, `getErrorMessageProps`,\n *   `getHelperWrapperProps` for consistent wiring to underlying UI components\n */\nexport const useUniformField = <\n  TFieldValues extends FieldValues = FieldValues,\n  TDisplay = unknown,\n>(\n  params: UseUniformFieldParams<TFieldValues, TDisplay>,\n): UseUniformFieldReturn<TFieldValues> => {\n  const {\n    name,\n    ariaLabel: customAriaLabel,\n    disabled = false,\n    testId: explicitTestId,\n    label,\n    type,\n    transform,\n  } = params;\n\n  const {\n    control,\n    debugMode,\n    formState: { submitCount },\n    getFieldState,\n    getValues,\n    resetField,\n  } = useFormContext<TFieldValues>();\n\n  const {\n    error,\n    invalid: rawInvalid,\n    isTouched,\n    required,\n    testId,\n  } = getFieldState(name, explicitTestId);\n\n  const { field } = useController<TFieldValues>({\n    control,\n    disabled,\n    name,\n  });\n  const {\n    onChange: fieldOnChange,\n    value: fieldValue,\n    disabled: isDisabled,\n    onBlur,\n    ref,\n  } = field;\n\n  // Get transform utilities (but don't apply them automatically)\n  // Components can choose how to use them (directly or via useInputValueDebounce)\n  const { toDisplayValue, toFormValue } = useInputValueTransform<TDisplay>({\n    type,\n    transform,\n  });\n\n  // For components without special needs: apply transform to value and onChange\n  const transformedValue = toDisplayValue(fieldValue);\n  const transformedOnChange = (eventOrValue: TDisplay | React.ChangeEvent) => {\n    // Extract value from event or use value directly\n    const displayValue =\n      (eventOrValue as React.ChangeEvent<HTMLInputElement>)?.target?.value ??\n      eventOrValue;\n    const formValue = toFormValue(displayValue as TDisplay);\n    fieldOnChange(formValue as typeof fieldValue);\n  };\n\n  const defaultValue = (getValues() as Record<string, unknown>)?.[\n    name as string\n  ];\n\n  /**\n   * Determine when to show the invalid state to the user.\n   *\n   * Show errors when the field is invalid AND any of these conditions are met:\n   *   - Field has a value (show validation errors like format/length while typing)\n   *   - Field is touched (focused and blurred) - good for text inputs\n   *   - Form has been submitted - shows all errors after submit attempt\n   *\n   * Note: We intentionally don't use isDirty because:\n   *   - Newly added array elements are marked \"dirty\" by RHF, causing immediate errors\n   *   - Field Cards with empty initial values show errors immediately\n   *   - hasValue + isTouched covers the same use cases more reliably\n   *\n   * This prevents showing errors on pristine/untouched/empty fields for better UX.\n   * Examples:\n   *   - Text input: User loads form with empty required field → no error shown yet\n   *   - Text input: User types invalid content → error shows immediately (has value)\n   *   - Text input: User focuses and blurs without typing → error shows (via isTouched)\n   *   - Checkbox/radio: User selects option → error shows immediately (has value)\n   *   - Field array: User adds element → no error yet; after blur → error shows\n   *   - Any field: User submits form → all errors show (via submitCount)\n   *\n   * The entire condition is debounced to prevent flickering and allow smooth animations.\n   */\n\n  // isValueEmpty handles marker strings, flat array wrappers, empty arrays, and empty objects\n  const hasValue = !isValueEmpty(fieldValue);\n  const showInvalid = rawInvalid && (hasValue || isTouched || submitCount > 0);\n  // Debounce to prevent flickering during rapid state changes\n  const invalid = useDebounce(showInvalid, 200);\n\n  // Build a label node that:\n  // - shows the provided label (unless explicitly set to false)\n  // - appends a copy-to-clipboard button for the test id in `debug-testids` mode\n  // Consumers can pass this directly to component `label` props\n  const showTestIdCopyButton = debugMode === 'debug-testids';\n  const labelNode: ReactNode | null =\n    !!label || showTestIdCopyButton ? (\n      <>\n        {label !== false ? label : null}\n        {showTestIdCopyButton ? (\n          <FieldCopyTestIdButton testId={testId} />\n        ) : null}\n      </>\n    ) : null;\n\n  // Ready-to-render error message; consumers can drop this into their\n  // component `errorMessage` prop without repeating mapping/markup\n  const errorMessage = <FieldValidationError error={error} testId={testId} />;\n\n  // Generate standardized props for label, helper wrapper and error message\n  // so consumers can spread them directly into UI components (e.g. HeroUI),\n  // keeping animations/spacing consistent across fields\n  const { getErrorMessageProps, getLabelProps, getHelperWrapperProps } =\n    useInput({\n      ref,\n      classNames: {\n        // set padding to 0 for error message exit animation\n        helperWrapper: 'p-0',\n      },\n      errorMessage: JSON.stringify(error),\n      isInvalid: invalid,\n      isRequired: required,\n      label,\n      labelPlacement: 'outside',\n    });\n\n  // Compute aria-label: prefer custom prop, then use string label if available, otherwise field name\n  // Components can further override this based on their specific accessibility needs\n  // (e.g., Input/TextArea may skip this if they have a meaningful placeholder)\n  const ariaLabel =\n    customAriaLabel ?? (typeof label === 'string' ? label : name);\n\n  return {\n    ariaLabel,\n    control,\n    debugMode,\n    defaultValue,\n    disabled: isDisabled,\n    error,\n    errorMessage,\n    field: {\n      ...field,\n      value: transformedValue as typeof field.value,\n      onChange: transformedOnChange as typeof field.onChange,\n    },\n    getErrorMessageProps,\n    getHelperWrapperProps,\n    getLabelProps,\n    getValues,\n    invalid,\n    label: labelNode,\n    onBlur,\n    onChange: transformedOnChange as typeof field.onChange,\n    ref,\n    required,\n    resetField,\n    testId,\n  };\n};\n","/* v8 ignore start */\n\nexport * from './useUniformField';\n\n/* v8 ignore stop */\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6GA,MAAa,mBAIX,WACwC;CACxC,MAAM,EACJ,MACA,WAAW,iBACX,WAAW,OACX,QAAQ,gBACR,OACA,MACA,cACE;CAEJ,MAAM,EACJ,SACA,WACA,WAAW,EAAE,eACb,eACA,WACA,eACEA,uCAA8B;CAElC,MAAM,EACJ,OACA,SAAS,YACT,WACA,UACA,WACE,cAAc,MAAM,eAAe;CAEvC,MAAM,EAAE,UAAUC,oCAA4B;EAC5C;EACA;EACA;EACD,CAAC;CACF,MAAM,EACJ,UAAU,eACV,OAAO,YACP,UAAU,YACV,QACA,QACE;CAIJ,MAAM,EAAE,gBAAgB,gBAAgBC,sDAAiC;EACvE;EACA;EACD,CAAC;CAGF,MAAM,mBAAmB,eAAe,WAAW;CACnD,MAAM,uBAAuB,iBAA+C;AAM1E,gBADkB,YAFf,cAAsD,QAAQ,SAC/D,aACqD,CACV;;CAG/C,MAAM,eAAgB,WAAW,GAC/B;;;;;;;;;;;;;;;;;;;;;;;;;CA6BF,MAAM,WAAW,CAACC,6BAAa,WAAW;CAG1C,MAAM,6CAFc,eAAe,YAAY,aAAa,cAAc,IAEjC,IAAI;CAM7C,MAAM,uBAAuB,cAAc;CAC3C,MAAM,YACJ,CAAC,CAAC,SAAS,uBACT,qFACG,UAAU,QAAQ,QAAQ,MAC1B,uBACC,2CAACC,iEAA8B,SAAU,GACvC,QACH,GACD;CAIN,MAAM,eAAe,2CAACC;EAA4B;EAAe;GAAU;CAK3E,MAAM,EAAE,sBAAsB,eAAe,sDAClC;EACP;EACA,YAAY,EAEV,eAAe,OAChB;EACD,cAAc,KAAK,UAAU,MAAM;EACnC,WAAW;EACX,YAAY;EACZ;EACA,gBAAgB;EACjB,CAAC;AAQJ,QAAO;EACL,WAHA,oBAAoB,OAAO,UAAU,WAAW,QAAQ;EAIxD;EACA;EACA;EACA,UAAU;EACV;EACA;EACA,OAAO;GACL,GAAG;GACH,OAAO;GACP,UAAU;GACX;EACD;EACA;EACA;EACA;EACA;EACA,OAAO;EACP;EACA,UAAU;EACV;EACA;EACA;EACA;EACD"}

package/dist/useUniformField-C-Xyu-8v.js

@@ -1,135 +0,0 @@
-import { r as isValueEmpty } from "./helpers-33jajRcN.js";
-import { n as FieldCopyTestIdButton_default } from "./FieldCopyTestIdButton-BoEdlzLs.js";
-import { n as FieldValidationError_default } from "./FieldValidationError-XQaViV52.js";
-import { t as useController } from "./useController-NjuthTyL.js";
-import { n as useFormContext } from "./useFormContext-Di67HIf7.js";
-import { t as useInput } from "./useInput-BWzvIUpW.js";
-import { t as useInputValueTransform } from "./useInputValueTransform-C-fmz3ke.js";
-import React from "react";
-import { useDebounce } from "@fuf-stack/pixels";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-
-//#region src/hooks/useUniformField/useUniformField.tsx
-/**
-* 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
-*/
-const useUniformField = (params) => {
-	const { name, ariaLabel: customAriaLabel, disabled = false, testId: explicitTestId, label, type, transform } = params;
-	const { control, debugMode, formState: { submitCount }, getFieldState, getValues, resetField } = useFormContext();
-	const { error, invalid: rawInvalid, isTouched, required, testId } = getFieldState(name, explicitTestId);
-	const { field } = useController({
-		control,
-		disabled,
-		name
-	});
-	const { onChange: fieldOnChange, value: fieldValue, disabled: isDisabled, onBlur, ref } = field;
-	const { toDisplayValue, toFormValue } = useInputValueTransform({
-		type,
-		transform
-	});
-	const transformedValue = toDisplayValue(fieldValue);
-	const transformedOnChange = (eventOrValue) => {
-		fieldOnChange(toFormValue(eventOrValue?.target?.value ?? eventOrValue));
-	};
-	const defaultValue = getValues()?.[name];
-	/**
-	* Determine when to show the invalid state to the user.
-	*
-	* Show errors when the field is invalid AND any of these conditions are met:
-	*   - Field has a value (show validation errors like format/length while typing)
-	*   - Field is touched (focused and blurred) - good for text inputs
-	*   - Form has been submitted - shows all errors after submit attempt
-	*
-	* Note: We intentionally don't use isDirty because:
-	*   - Newly added array elements are marked "dirty" by RHF, causing immediate errors
-	*   - Field Cards with empty initial values show errors immediately
-	*   - hasValue + isTouched covers the same use cases more reliably
-	*
-	* This prevents showing errors on pristine/untouched/empty fields for better UX.
-	* Examples:
-	*   - Text input: User loads form with empty required field → no error shown yet
-	*   - Text input: User types invalid content → error shows immediately (has value)
-	*   - Text input: User focuses and blurs without typing → error shows (via isTouched)
-	*   - Checkbox/radio: User selects option → error shows immediately (has value)
-	*   - Field array: User adds element → no error yet; after blur → error shows
-	*   - Any field: User submits form → all errors show (via submitCount)
-	*
-	* The entire condition is debounced to prevent flickering and allow smooth animations.
-	*/
-	const hasValue = !isValueEmpty(fieldValue);
-	const invalid = useDebounce(rawInvalid && (hasValue || isTouched || submitCount > 0), 200);
-	const showTestIdCopyButton = debugMode === "debug-testids";
-	const labelNode = !!label || showTestIdCopyButton ? /* @__PURE__ */ jsxs(Fragment, { children: [label !== false ? label : null, showTestIdCopyButton ? /* @__PURE__ */ jsx(FieldCopyTestIdButton_default, { testId }) : null] }) : null;
-	const errorMessage = /* @__PURE__ */ jsx(FieldValidationError_default, {
-		error,
-		testId
-	});
-	const { getErrorMessageProps, getLabelProps, getHelperWrapperProps } = useInput({
-		ref,
-		classNames: { helperWrapper: "p-0" },
-		errorMessage: JSON.stringify(error),
-		isInvalid: invalid,
-		isRequired: required,
-		label,
-		labelPlacement: "outside"
-	});
-	return {
-		ariaLabel: customAriaLabel ?? (typeof label === "string" ? label : name),
-		control,
-		debugMode,
-		defaultValue,
-		disabled: isDisabled,
-		error,
-		errorMessage,
-		field: {
-			...field,
-			value: transformedValue,
-			onChange: transformedOnChange
-		},
-		getErrorMessageProps,
-		getHelperWrapperProps,
-		getLabelProps,
-		getValues,
-		invalid,
-		label: labelNode,
-		onBlur,
-		onChange: transformedOnChange,
-		ref,
-		required,
-		resetField,
-		testId
-	};
-};
-
-//#endregion
-//#region src/hooks/useUniformField/index.ts
-/* v8 ignore stop */
-
-//#endregion
-export { useUniformField as t };
-//# sourceMappingURL=useUniformField-C-Xyu-8v.js.map

package/dist/useUniformField-C-Xyu-8v.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useUniformField-C-Xyu-8v.js","names":["FieldCopyTestIdButton","FieldValidationError"],"sources":["../src/hooks/useUniformField/useUniformField.tsx","../src/hooks/useUniformField/index.ts"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type { FieldError, FieldValues, Path } from 'react-hook-form';\nimport type { InputValueTransform } from '../useInputValueTransform/useInputValueTransform';\n\nimport React from 'react';\n\nimport { useDebounce } from '@fuf-stack/pixels';\n\nimport { isValueEmpty } from '../../helpers';\nimport { FieldCopyTestIdButton } from '../../partials/FieldCopyTestIdButton';\nimport { FieldValidationError } from '../../partials/FieldValidationError';\nimport { useController } from '../useController/useController';\nimport { useFormContext } from '../useFormContext/useFormContext';\nimport { useInput } from '../useInput/useInput';\nimport { useInputValueTransform } from '../useInputValueTransform/useInputValueTransform';\n\nexport interface UseUniformFieldParams<\n  TFieldValues extends FieldValues = FieldValues,\n  TDisplay = unknown,\n> {\n  /** Form field name */\n  name: Path<TFieldValues> & string;\n  /** Custom aria-label for accessibility. If not provided, falls back to field name when no visible label exists */\n  ariaLabel?: string;\n  /** Disable the field */\n  disabled?: boolean;\n  /** Optional label content */\n  label?: ReactNode;\n  /** Optional explicit test id used to build stable test ids */\n  testId?: string;\n  /** Optional value transformation between form and display values */\n  transform?: InputValueTransform<TDisplay>;\n  /** Input type for special number handling */\n  type?: 'text' | 'number' | 'password';\n}\n\nexport interface UseUniformFieldReturn<\n  TFieldValues extends FieldValues = FieldValues,\n> {\n  /** 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) */\n  ariaLabel: string | undefined;\n  /** react-hook-form control instance for advanced integrations */\n  control: ReturnType<typeof useFormContext<TFieldValues>>['control'];\n  /** Debug mode from Uniform provider */\n  debugMode: ReturnType<typeof useFormContext<TFieldValues>>['debugMode'];\n  /** Current value used to initialize uncontrolled components */\n  defaultValue: unknown;\n  /** Whether the field is currently disabled (from RHF) */\n  disabled: boolean | undefined;\n  /** Validation error(s) for the field */\n  error: FieldError[] | undefined;\n  /** Pre-built errorMessage node to plug into components */\n  errorMessage: ReactNode | null;\n  /** RHF controller field with transformed value/onChange (use this for simple components) */\n  field: ReturnType<typeof useController<TFieldValues>>['field'];\n  /** Helper to spread standardized error message props to underlying components */\n  getErrorMessageProps: ReturnType<typeof useInput>['getErrorMessageProps'];\n  /** Helper to spread standardized helper wrapper props (for spacing/animation) */\n  getHelperWrapperProps: ReturnType<typeof useInput>['getHelperWrapperProps'];\n  /** Helper to spread standardized label props to underlying components */\n  getLabelProps: ReturnType<typeof useInput>['getLabelProps'];\n  /** Access current form values (converted to validation-friendly format) */\n  getValues: ReturnType<typeof useFormContext<TFieldValues>>['getValues'];\n  /** Whether the field should show invalid state (debounced for smooth animations). True when field is invalid AND (dirty OR touched OR submitted) */\n  invalid: boolean;\n  /** Computed label node including optional test id copy button */\n  label: ReactNode | null;\n  /** onBlur handler from controller */\n  onBlur: ReturnType<typeof useController<TFieldValues>>['field']['onBlur'];\n  /** onChange handler from controller (with transform applied) */\n  onChange: ReturnType<typeof useController<TFieldValues>>['field']['onChange'];\n  /** Ref to forward to underlying control */\n  ref: ReturnType<typeof useController<TFieldValues>>['field']['ref'];\n  /** Whether the field is required according to validation schema */\n  required: boolean;\n  /** Reset a specific field in the form */\n  resetField: ReturnType<typeof useFormContext<TFieldValues>>['resetField'];\n  /** Generated HTML data-testid for the field */\n  testId: string;\n}\n\n/**\n * Combines frequently used form field logic into a single hook.\n *\n * Provides:\n * - Enhanced form context (validation-aware state, `testId`, value transforms)\n * - Controller field with nullish conversion handling\n * - Value transformation via `transform` prop:\n *   • Allows disentangled display and form values (e.g., string ↔ object, boolean ↔ array)\n *   • Automatically applies `toDisplayValue` to field value for components\n *   • Automatically applies `toFormValue` to display value when onChange is called\n *   • Works with `type` prop for automatic number/string conversion\n *   • Examples: storing objects while displaying strings, storing booleans as arrays, enriching values with metadata\n * - Debounced `invalid` state with smart timing:\n *   • `true` (field becomes invalid): applies immediately so errors show right away\n *   • `false` (field becomes valid): delayed 200ms to allow smooth exit animations\n *   • Respects `prefers-reduced-motion` by skipping delays when user prefers reduced motion\n * - Smart `invalid` visibility (via `showInvalid`):\n *   • Shows errors when field is dirty OR touched OR form has been submitted\n *   • Prevents showing errors on pristine/untouched fields for better UX\n *   • Works well for all field types (text inputs, checkboxes, radios, arrays)\n * - Prebuilt `errorMessage` React node using `FieldValidationError`\n * - Computed `label` node which appends a `FieldCopyTestIdButton` in\n *   `debug-testids` mode\n * - `defaultValue` for uncontrolled defaults and all usual field handlers\n * - Access to form utilities: `control`, `getValues`, `resetField`\n * - Presentation helpers: `getLabelProps`, `getErrorMessageProps`,\n *   `getHelperWrapperProps` for consistent wiring to underlying UI components\n */\nexport const useUniformField = <\n  TFieldValues extends FieldValues = FieldValues,\n  TDisplay = unknown,\n>(\n  params: UseUniformFieldParams<TFieldValues, TDisplay>,\n): UseUniformFieldReturn<TFieldValues> => {\n  const {\n    name,\n    ariaLabel: customAriaLabel,\n    disabled = false,\n    testId: explicitTestId,\n    label,\n    type,\n    transform,\n  } = params;\n\n  const {\n    control,\n    debugMode,\n    formState: { submitCount },\n    getFieldState,\n    getValues,\n    resetField,\n  } = useFormContext<TFieldValues>();\n\n  const {\n    error,\n    invalid: rawInvalid,\n    isTouched,\n    required,\n    testId,\n  } = getFieldState(name, explicitTestId);\n\n  const { field } = useController<TFieldValues>({\n    control,\n    disabled,\n    name,\n  });\n  const {\n    onChange: fieldOnChange,\n    value: fieldValue,\n    disabled: isDisabled,\n    onBlur,\n    ref,\n  } = field;\n\n  // Get transform utilities (but don't apply them automatically)\n  // Components can choose how to use them (directly or via useInputValueDebounce)\n  const { toDisplayValue, toFormValue } = useInputValueTransform<TDisplay>({\n    type,\n    transform,\n  });\n\n  // For components without special needs: apply transform to value and onChange\n  const transformedValue = toDisplayValue(fieldValue);\n  const transformedOnChange = (eventOrValue: TDisplay | React.ChangeEvent) => {\n    // Extract value from event or use value directly\n    const displayValue =\n      (eventOrValue as React.ChangeEvent<HTMLInputElement>)?.target?.value ??\n      eventOrValue;\n    const formValue = toFormValue(displayValue as TDisplay);\n    fieldOnChange(formValue as typeof fieldValue);\n  };\n\n  const defaultValue = (getValues() as Record<string, unknown>)?.[\n    name as string\n  ];\n\n  /**\n   * Determine when to show the invalid state to the user.\n   *\n   * Show errors when the field is invalid AND any of these conditions are met:\n   *   - Field has a value (show validation errors like format/length while typing)\n   *   - Field is touched (focused and blurred) - good for text inputs\n   *   - Form has been submitted - shows all errors after submit attempt\n   *\n   * Note: We intentionally don't use isDirty because:\n   *   - Newly added array elements are marked \"dirty\" by RHF, causing immediate errors\n   *   - Field Cards with empty initial values show errors immediately\n   *   - hasValue + isTouched covers the same use cases more reliably\n   *\n   * This prevents showing errors on pristine/untouched/empty fields for better UX.\n   * Examples:\n   *   - Text input: User loads form with empty required field → no error shown yet\n   *   - Text input: User types invalid content → error shows immediately (has value)\n   *   - Text input: User focuses and blurs without typing → error shows (via isTouched)\n   *   - Checkbox/radio: User selects option → error shows immediately (has value)\n   *   - Field array: User adds element → no error yet; after blur → error shows\n   *   - Any field: User submits form → all errors show (via submitCount)\n   *\n   * The entire condition is debounced to prevent flickering and allow smooth animations.\n   */\n\n  // isValueEmpty handles marker strings, flat array wrappers, empty arrays, and empty objects\n  const hasValue = !isValueEmpty(fieldValue);\n  const showInvalid = rawInvalid && (hasValue || isTouched || submitCount > 0);\n  // Debounce to prevent flickering during rapid state changes\n  const invalid = useDebounce(showInvalid, 200);\n\n  // Build a label node that:\n  // - shows the provided label (unless explicitly set to false)\n  // - appends a copy-to-clipboard button for the test id in `debug-testids` mode\n  // Consumers can pass this directly to component `label` props\n  const showTestIdCopyButton = debugMode === 'debug-testids';\n  const labelNode: ReactNode | null =\n    !!label || showTestIdCopyButton ? (\n      <>\n        {label !== false ? label : null}\n        {showTestIdCopyButton ? (\n          <FieldCopyTestIdButton testId={testId} />\n        ) : null}\n      </>\n    ) : null;\n\n  // Ready-to-render error message; consumers can drop this into their\n  // component `errorMessage` prop without repeating mapping/markup\n  const errorMessage = <FieldValidationError error={error} testId={testId} />;\n\n  // Generate standardized props for label, helper wrapper and error message\n  // so consumers can spread them directly into UI components (e.g. HeroUI),\n  // keeping animations/spacing consistent across fields\n  const { getErrorMessageProps, getLabelProps, getHelperWrapperProps } =\n    useInput({\n      ref,\n      classNames: {\n        // set padding to 0 for error message exit animation\n        helperWrapper: 'p-0',\n      },\n      errorMessage: JSON.stringify(error),\n      isInvalid: invalid,\n      isRequired: required,\n      label,\n      labelPlacement: 'outside',\n    });\n\n  // Compute aria-label: prefer custom prop, then use string label if available, otherwise field name\n  // Components can further override this based on their specific accessibility needs\n  // (e.g., Input/TextArea may skip this if they have a meaningful placeholder)\n  const ariaLabel =\n    customAriaLabel ?? (typeof label === 'string' ? label : name);\n\n  return {\n    ariaLabel,\n    control,\n    debugMode,\n    defaultValue,\n    disabled: isDisabled,\n    error,\n    errorMessage,\n    field: {\n      ...field,\n      value: transformedValue as typeof field.value,\n      onChange: transformedOnChange as typeof field.onChange,\n    },\n    getErrorMessageProps,\n    getHelperWrapperProps,\n    getLabelProps,\n    getValues,\n    invalid,\n    label: labelNode,\n    onBlur,\n    onChange: transformedOnChange as typeof field.onChange,\n    ref,\n    required,\n    resetField,\n    testId,\n  };\n};\n","/* v8 ignore start */\n\nexport * from './useUniformField';\n\n/* v8 ignore stop */\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6GA,MAAa,mBAIX,WACwC;CACxC,MAAM,EACJ,MACA,WAAW,iBACX,WAAW,OACX,QAAQ,gBACR,OACA,MACA,cACE;CAEJ,MAAM,EACJ,SACA,WACA,WAAW,EAAE,eACb,eACA,WACA,eACE,gBAA8B;CAElC,MAAM,EACJ,OACA,SAAS,YACT,WACA,UACA,WACE,cAAc,MAAM,eAAe;CAEvC,MAAM,EAAE,UAAU,cAA4B;EAC5C;EACA;EACA;EACD,CAAC;CACF,MAAM,EACJ,UAAU,eACV,OAAO,YACP,UAAU,YACV,QACA,QACE;CAIJ,MAAM,EAAE,gBAAgB,gBAAgB,uBAAiC;EACvE;EACA;EACD,CAAC;CAGF,MAAM,mBAAmB,eAAe,WAAW;CACnD,MAAM,uBAAuB,iBAA+C;AAM1E,gBADkB,YAFf,cAAsD,QAAQ,SAC/D,aACqD,CACV;;CAG/C,MAAM,eAAgB,WAAW,GAC/B;;;;;;;;;;;;;;;;;;;;;;;;;CA6BF,MAAM,WAAW,CAAC,aAAa,WAAW;CAG1C,MAAM,UAAU,YAFI,eAAe,YAAY,aAAa,cAAc,IAEjC,IAAI;CAM7C,MAAM,uBAAuB,cAAc;CAC3C,MAAM,YACJ,CAAC,CAAC,SAAS,uBACT,4CACG,UAAU,QAAQ,QAAQ,MAC1B,uBACC,oBAACA,iCAA8B,SAAU,GACvC,QACH,GACD;CAIN,MAAM,eAAe,oBAACC;EAA4B;EAAe;GAAU;CAK3E,MAAM,EAAE,sBAAsB,eAAe,0BAC3C,SAAS;EACP;EACA,YAAY,EAEV,eAAe,OAChB;EACD,cAAc,KAAK,UAAU,MAAM;EACnC,WAAW;EACX,YAAY;EACZ;EACA,gBAAgB;EACjB,CAAC;AAQJ,QAAO;EACL,WAHA,oBAAoB,OAAO,UAAU,WAAW,QAAQ;EAIxD;EACA;EACA;EACA,UAAU;EACV;EACA;EACA,OAAO;GACL,GAAG;GACH,OAAO;GACP,UAAU;GACX;EACD;EACA;EACA;EACA;EACA;EACA,OAAO;EACP;EACA,UAAU;EACV;EACA;EACA;EACA;EACD"}

package/dist/useUniformFieldArray-BKvA0FQW.js

@@ -1,84 +0,0 @@
-import { t as flatArrayKey } from "./helpers-33jajRcN.js";
-import { n as useFormContext$1 } from "./useFormContext-Di67HIf7.js";
-import { t as useUniformField } from "./useUniformField-C-Xyu-8v.js";
-import { useEffect, useMemo, useRef, useState } from "react";
-import { useReducedMotion } from "@fuf-stack/pixel-motion";
-import { useFieldArray } from "react-hook-form";
-
-//#region src/hooks/useUniformFieldArray/useUniformFieldArray.ts
-/**
-* Enhanced useFieldArray hook with initialization and animation logic.
-* Based on React Hook Form's useFieldArray with additional features:
-* - Automatic initialization when lastElementNotRemovable is set
-* - Animation control (disabled during initialization)
-* - 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
-*/
-const useUniformFieldArray = ({ name, flat = false, elementInitialValue: _elementInitialValue = null, lastElementNotRemovable = false, disabled, testId: explicitTestId, label }) => {
-	const uniformField = useUniformField({
-		name,
-		disabled,
-		testId: explicitTestId,
-		label
-	});
-	const { control } = uniformField;
-	const { fields, append, remove, insert, move } = useFieldArray({
-		control,
-		name
-	});
-	const { trigger, setValue } = useFormContext$1();
-	const needsInitialize = useMemo(() => {
-		return lastElementNotRemovable && fields.length === 0;
-	}, [lastElementNotRemovable, fields.length]);
-	const hasInitialized = useRef(!needsInitialize);
-	useEffect(() => {
-		if (needsInitialize) hasInitialized.current = false;
-	}, [needsInitialize]);
-	useEffect(() => {
-		if (hasInitialized.current) setTimeout(() => {
-			trigger(name);
-		}, 200);
-	}, [fields.length]);
-	const [disableAnimation, setDisableAnimation] = useState(true);
-	const prefersReducedMotion = useReducedMotion();
-	useEffect(() => {
-		if (hasInitialized.current) setDisableAnimation(!!prefersReducedMotion);
-	}, [prefersReducedMotion]);
-	const elementInitialValue = useMemo(() => {
-		return flat ? { [flatArrayKey]: _elementInitialValue ?? null } : _elementInitialValue ?? {};
-	}, [flat, _elementInitialValue]);
-	useEffect(() => {
-		if (needsInitialize) {
-			setValue(name, [elementInitialValue], {
-				shouldDirty: false,
-				shouldTouch: false
-			});
-			hasInitialized.current = true;
-			if (!prefersReducedMotion && disableAnimation) setTimeout(() => {
-				setDisableAnimation(false);
-			}, 1);
-		}
-	}, [needsInitialize]);
-	return {
-		fields,
-		append,
-		remove,
-		insert,
-		move,
-		disableAnimation,
-		elementInitialValue,
-		...uniformField
-	};
-};
-
-//#endregion
-//#region src/hooks/useUniformFieldArray/index.ts
-/* v8 ignore stop */
-
-//#endregion
-export { useUniformFieldArray as t };
-//# sourceMappingURL=useUniformFieldArray-BKvA0FQW.js.map