@fuf-stack/uniform 1.22.5 → 1.22.6

package/dist/hooks/useClientValidation/index.js

@@ -1,4 +1,178 @@
-import { n as useClientValidation, t as clientValidationSchemaByName } from "../../useClientValidation-DpLdzIAb.js";
+import "../../helpers/index.js";
+import { n as useFormContext } from "../../useFormContext-BJqa1FoT.js";
+import { useEffect, useId } from "react";
+import { array, objectLoose } from "@fuf-stack/veto";
+//#region src/hooks/useClientValidation/useClientValidation.ts
+/**
+* Hook for adding dynamic client-side validation to forms.
+*
+* Client validation is used for context-dependent validation rules that require external data
+* (e.g., checking if a username already exists). It complements base validation (passed to Form),
+* which handles static rules like "required", min/max length, format, etc.
+*
+* **Typical pattern:**
+* - Base validation: Static, always-on rules (required, format, length constraints)
+* - Client validation: Dynamic rules based on external data (uniqueness, business logic)
+* - Client schemas should use `.nullish()` to allow empty values (base validation handles "required")
+*
+* Automatically manages validation schema lifecycle: sets schema when data is provided,
+* clears schema when data is null/undefined, and cleans up on unmount. When the client
+* validation schema changes, automatically re-validates all touched fields.
+*
+* @param data - Data to create validation schema from (or null/undefined to clear validation)
+* @param schemaFactory - Function that creates a validation schema from the data. Schemas should typically use `.nullish()`.
+* @param options - Optional configuration object
+* @param options.key - Optional custom key for registration. Useful when multiple instances should share validation (e.g., in field arrays)
+*
+* @example
+* ```tsx
+* // Base validation handles "required" and format
+* const baseSchema = veto({ username: vt.string({ min: 3 }) });
+*
+* // Client validation adds dynamic uniqueness check
+* const { data: teamData } = useTeamQuery(teamId);
+* useClientValidation(teamData, (data) =>
+*   vt.objectLoose({
+*     username: vt.string()
+*       .refine(
+*         (value) => !data.existingUsers.includes(value),
+*         { message: 'Username already exists' }
+*       )
+*       .nullish() // Allow empty - base validation handles "required"
+*   })
+* );
+* ```
+*
+* @example
+* ```tsx
+* // Using custom key in a field array to avoid multiple registrations
+* fields.map((field, index) => (
+*   useClientValidation(
+*     userData,
+*     (data) => clientValidationSchemaByName(
+*       `items.${index}.name`,
+*       vt.string()
+*         .refine((val) => !data.forbidden.includes(val), { message: 'Name not allowed' })
+*         .nullish()
+*     ),
+*     { key: 'items-validation' } // All instances share the same key
+*   )
+* ));
+* ```
+*/
+const useClientValidation = (data, schemaFactory, options) => {
+	const { formState: { touchedFields }, validation: { setClientValidationSchema }, trigger } = useFormContext();
+	const autoGeneratedKey = useId();
+	const key = options?.key ?? autoGeneratedKey;
+	useEffect(() => {
+		if (data != null) setClientValidationSchema(key, schemaFactory(data));
+		else setClientValidationSchema(key, null);
+		const touchedFieldNames = Object.keys(touchedFields);
+		if (touchedFieldNames.length > 0) setTimeout(async () => {
+			return trigger(touchedFieldNames);
+		}, 1);
+		return () => {
+			setClientValidationSchema(key, null);
+		};
+	}, [JSON.stringify(data), key]);
+};
+/**
+* Helper function to create a veto looseObject schema for a single field with nested path support.
+*
+* Parses field paths (dot-notation) and creates properly nested loose object schemas with array support.
+* All intermediate objects and arrays are marked as optional to allow partial data structures.
+* Numeric segments in the path are treated as array indices, and the parent field is wrapped in an array schema.
+* Supports flat arrays (arrays of primitives) via the special `__FLAT__` key.
+*
+* **Important:** The fieldSchema should typically use `.nullish()` to allow empty values. This is because:
+* - Base validation (passed to Form) handles "required" constraints
+* - Client validation adds dynamic, context-dependent rules (e.g., "username already exists")
+* - Form data processing converts empty strings in flat arrays to `null` (not `undefined`)
+* - `.nullish()` accepts both `null` and `undefined`, while `.optional()` only accepts `undefined`
+*
+* This pattern ensures client validation only validates non-empty values, while base validation
+* enforces required fields and basic constraints (min length, format, etc.).
+*
+* @param name - The dot-separated path to the field (e.g., 'username', 'user.profile.email', 'items.0.name', 'tags.0.__FLAT__')
+* @param fieldSchema - The veto validation schema for the field. Should typically use `.nullish()` to allow empty values.
+* @returns A nested loose object schema matching the field path structure with proper type inference
+*
+* @example
+* ```tsx
+* // Typical usage: base validation handles "required", client validation adds dynamic rules
+* // Base validation (in Form component)
+* const baseSchema = veto({ username: vt.string({ min: 3 }) }); // Required + min length
+*
+* // Client validation (dynamic check for existing usernames)
+* const { data: userData } = useUserQuery(userId);
+* useClientValidation(userData, (data) =>
+*   clientValidationSchemaByName(
+*     'username',
+*     vt.string()
+*       .refine(
+*         (value) => !data.existingUsernames.includes(value),
+*         { message: 'Username already taken' }
+*       )
+*       .nullish() // Allow empty - base validation handles "required"
+*   )
+* );
+* ```
+*
+* @example
+* ```tsx
+* // Nested field path with dynamic validation
+* clientValidationSchemaByName(
+*   'user.profile.email',
+*   vt.string()
+*     .refine(
+*       (value) => !reservedEmails.includes(value),
+*       { message: 'This email is reserved' }
+*     )
+*     .nullish()
+* )
+* // => objectLoose({ user: objectLoose({ profile: objectLoose({ email: ... }).optional() }).optional() })
+* ```
+*
+* @example
+* ```tsx
+* // Array of objects with dynamic validation
+* clientValidationSchemaByName(
+*   'items.0.tag',
+*   vt.string()
+*     .refine((value) => !forbiddenTags.includes(value), { message: 'Tag not allowed' })
+*     .nullish()
+* )
+* // => objectLoose({ items: array(objectLoose({ tag: ... })).optional() })
+* ```
+*
+* @example
+* ```tsx
+* // Flat array (array of primitives) with dynamic validation
+* clientValidationSchemaByName(
+*   'tags.0.__FLAT__',
+*   vt.string()
+*     .refine((value) => !forbiddenWords.includes(value), { message: 'Word not allowed' })
+*     .nullish()
+* )
+* // => objectLoose({ tags: array(vt.string().refine(...).nullish()).optional() })
+* ```
+*/
+const clientValidationSchemaByName = (name, fieldSchema) => {
+	const segments = name.split(".");
+	let schema = fieldSchema;
+	for (let i = segments.length - 1; i >= 0; i -= 1) {
+		const segment = segments[i];
+		const isNumeric = /^\d+$/.test(segment);
+		if (segment === "__FLAT__") continue;
+		if (isNumeric) schema = array(schema).optional();
+		else {
+			const obj = objectLoose({ [segment]: schema });
+			schema = i > 0 ? obj.optional() : obj;
+		}
+	}
+	return schema;
+};
+//#endregion
 //#region src/hooks/useClientValidation/index.ts
 /* v8 ignore stop */
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/hooks/useClientValidation/index.ts"],"sourcesContent":["/* v8 ignore start */\n\nexport * from './useClientValidation';\n\n/* v8 ignore stop */\n"],"mappings":""}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/hooks/useClientValidation/useClientValidation.ts","../../../src/hooks/useClientValidation/index.ts"],"sourcesContent":["import type { VetoTypeAny } from '@fuf-stack/veto';\n\nimport { useEffect, useId } from 'react';\n\nimport { array, objectLoose } from '@fuf-stack/veto';\n\nimport { flatArrayKey } from '../../helpers';\nimport { useFormContext } from '../useFormContext/useFormContext';\n\n/**\n * Hook for adding dynamic client-side validation to forms.\n *\n * Client validation is used for context-dependent validation rules that require external data\n * (e.g., checking if a username already exists). It complements base validation (passed to Form),\n * which handles static rules like \"required\", min/max length, format, etc.\n *\n * **Typical pattern:**\n * - Base validation: Static, always-on rules (required, format, length constraints)\n * - Client validation: Dynamic rules based on external data (uniqueness, business logic)\n * - Client schemas should use `.nullish()` to allow empty values (base validation handles \"required\")\n *\n * Automatically manages validation schema lifecycle: sets schema when data is provided,\n * clears schema when data is null/undefined, and cleans up on unmount. When the client\n * validation schema changes, automatically re-validates all touched fields.\n *\n * @param data - Data to create validation schema from (or null/undefined to clear validation)\n * @param schemaFactory - Function that creates a validation schema from the data. Schemas should typically use `.nullish()`.\n * @param options - Optional configuration object\n * @param options.key - Optional custom key for registration. Useful when multiple instances should share validation (e.g., in field arrays)\n *\n * @example\n * ```tsx\n * // Base validation handles \"required\" and format\n * const baseSchema = veto({ username: vt.string({ min: 3 }) });\n *\n * // Client validation adds dynamic uniqueness check\n * const { data: teamData } = useTeamQuery(teamId);\n * useClientValidation(teamData, (data) =>\n *   vt.objectLoose({\n *     username: vt.string()\n *       .refine(\n *         (value) => !data.existingUsers.includes(value),\n *         { message: 'Username already exists' }\n *       )\n *       .nullish() // Allow empty - base validation handles \"required\"\n *   })\n * );\n * ```\n *\n * @example\n * ```tsx\n * // Using custom key in a field array to avoid multiple registrations\n * fields.map((field, index) => (\n *   useClientValidation(\n *     userData,\n *     (data) => clientValidationSchemaByName(\n *       `items.${index}.name`,\n *       vt.string()\n *         .refine((val) => !data.forbidden.includes(val), { message: 'Name not allowed' })\n *         .nullish()\n *     ),\n *     { key: 'items-validation' } // All instances share the same key\n *   )\n * ));\n * ```\n */\nexport const useClientValidation = <TData = unknown>(\n  data: TData | null | undefined,\n  schemaFactory: (data: TData) => VetoTypeAny,\n  options?: { key?: string },\n): void => {\n  const {\n    formState: { touchedFields },\n    validation: { setClientValidationSchema },\n    trigger,\n  } = useFormContext();\n\n  // Use provided key or auto-generate unique key\n  const autoGeneratedKey = useId();\n  const key = options?.key ?? autoGeneratedKey;\n\n  // Use data hash instead of object reference to avoid unnecessary re-runs\n  // when data object reference changes but data remains the same\n  const dataHash = JSON.stringify(data);\n\n  // Single effect to manage validation schema lifecycle\n  useEffect(() => {\n    // Set validation schema when data is available\n    if (data != null) {\n      const validationSchema = schemaFactory(data);\n      setClientValidationSchema(key, validationSchema);\n    } else {\n      // Clear validation schema when no data\n      setClientValidationSchema(key, null);\n    }\n\n    // Re-validate all touched fields when client validation schema changes\n    const touchedFieldNames = Object.keys(touchedFields);\n    if (touchedFieldNames.length > 0) {\n      // Use setTimeout to ensure the client validation schema update has propagated\n      // before triggering re-validation (fixes race condition)\n      setTimeout(async () => {\n        return trigger(touchedFieldNames);\n      }, 1);\n    }\n\n    // Cleanup on unmount or when dependencies change\n    return () => {\n      setClientValidationSchema(key, null);\n    };\n    // Only re-run when data (dataHash) or key changes\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [dataHash, key]);\n};\n\n/**\n * Helper function to create a veto looseObject schema for a single field with nested path support.\n *\n * Parses field paths (dot-notation) and creates properly nested loose object schemas with array support.\n * All intermediate objects and arrays are marked as optional to allow partial data structures.\n * Numeric segments in the path are treated as array indices, and the parent field is wrapped in an array schema.\n * Supports flat arrays (arrays of primitives) via the special `__FLAT__` key.\n *\n * **Important:** The fieldSchema should typically use `.nullish()` to allow empty values. This is because:\n * - Base validation (passed to Form) handles \"required\" constraints\n * - Client validation adds dynamic, context-dependent rules (e.g., \"username already exists\")\n * - Form data processing converts empty strings in flat arrays to `null` (not `undefined`)\n * - `.nullish()` accepts both `null` and `undefined`, while `.optional()` only accepts `undefined`\n *\n * This pattern ensures client validation only validates non-empty values, while base validation\n * enforces required fields and basic constraints (min length, format, etc.).\n *\n * @param name - The dot-separated path to the field (e.g., 'username', 'user.profile.email', 'items.0.name', 'tags.0.__FLAT__')\n * @param fieldSchema - The veto validation schema for the field. Should typically use `.nullish()` to allow empty values.\n * @returns A nested loose object schema matching the field path structure with proper type inference\n *\n * @example\n * ```tsx\n * // Typical usage: base validation handles \"required\", client validation adds dynamic rules\n * // Base validation (in Form component)\n * const baseSchema = veto({ username: vt.string({ min: 3 }) }); // Required + min length\n *\n * // Client validation (dynamic check for existing usernames)\n * const { data: userData } = useUserQuery(userId);\n * useClientValidation(userData, (data) =>\n *   clientValidationSchemaByName(\n *     'username',\n *     vt.string()\n *       .refine(\n *         (value) => !data.existingUsernames.includes(value),\n *         { message: 'Username already taken' }\n *       )\n *       .nullish() // Allow empty - base validation handles \"required\"\n *   )\n * );\n * ```\n *\n * @example\n * ```tsx\n * // Nested field path with dynamic validation\n * clientValidationSchemaByName(\n *   'user.profile.email',\n *   vt.string()\n *     .refine(\n *       (value) => !reservedEmails.includes(value),\n *       { message: 'This email is reserved' }\n *     )\n *     .nullish()\n * )\n * // => objectLoose({ user: objectLoose({ profile: objectLoose({ email: ... }).optional() }).optional() })\n * ```\n *\n * @example\n * ```tsx\n * // Array of objects with dynamic validation\n * clientValidationSchemaByName(\n *   'items.0.tag',\n *   vt.string()\n *     .refine((value) => !forbiddenTags.includes(value), { message: 'Tag not allowed' })\n *     .nullish()\n * )\n * // => objectLoose({ items: array(objectLoose({ tag: ... })).optional() })\n * ```\n *\n * @example\n * ```tsx\n * // Flat array (array of primitives) with dynamic validation\n * clientValidationSchemaByName(\n *   'tags.0.__FLAT__',\n *   vt.string()\n *     .refine((value) => !forbiddenWords.includes(value), { message: 'Word not allowed' })\n *     .nullish()\n * )\n * // => objectLoose({ tags: array(vt.string().refine(...).nullish()).optional() })\n * ```\n */\nexport const clientValidationSchemaByName = <T extends VetoTypeAny>(\n  name: string,\n  fieldSchema: T,\n) => {\n  const segments = name.split('.');\n\n  // Build schema from innermost to outermost\n  let schema: VetoTypeAny = fieldSchema;\n\n  // Process segments in reverse order to build nested structure\n  for (let i = segments.length - 1; i >= 0; i -= 1) {\n    const segment = segments[i];\n\n    const isNumeric = /^\\d+$/.test(segment);\n    const isFlatArrayKey = segment === flatArrayKey;\n\n    if (isFlatArrayKey) {\n      // Skip the __FLAT__ key - it's just a marker for flat arrays\n      // The schema is already correct (primitive type), just continue\n      // eslint-disable-next-line no-continue\n      continue;\n    }\n\n    if (isNumeric) {\n      // Current segment is an array index - wrap current schema in optional array\n      schema = array(schema).optional();\n    } else {\n      // Current segment is a field name - wrap in objectLoose\n      // Make it optional if it's an intermediate object (not the root)\n      const obj = objectLoose({\n        [segment]: schema,\n      });\n      schema = i > 0 ? obj.optional() : obj;\n    }\n  }\n\n  return schema;\n};\n","/* v8 ignore start */\n\nexport * from './useClientValidation';\n\n/* v8 ignore stop */\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkEA,MAAa,uBACX,MACA,eACA,YACS;CACT,MAAM,EACJ,WAAW,EAAE,iBACb,YAAY,EAAE,6BACd,YACE,eAAe;CAGnB,MAAM,mBAAmB,MAAM;CAC/B,MAAM,MAAM,SAAS,OAAO;CAO5B,gBAAgB;EAEd,IAAI,QAAQ,MAEV,0BAA0B,KADD,cAAc,IACO,CAAC;OAG/C,0BAA0B,KAAK,IAAI;EAIrC,MAAM,oBAAoB,OAAO,KAAK,aAAa;EACnD,IAAI,kBAAkB,SAAS,GAG7B,WAAW,YAAY;GACrB,OAAO,QAAQ,iBAAiB;EAClC,GAAG,CAAC;EAIN,aAAa;GACX,0BAA0B,KAAK,IAAI;EACrC;CAGF,GAAG,CA7Bc,KAAK,UAAU,IA6BrB,GAAG,GAAG,CAAC;AACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmFA,MAAa,gCACX,MACA,gBACG;CACH,MAAM,WAAW,KAAK,MAAM,GAAG;CAG/B,IAAI,SAAsB;CAG1B,KAAK,IAAI,IAAI,SAAS,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG;EAChD,MAAM,UAAU,SAAS;EAEzB,MAAM,YAAY,QAAQ,KAAK,OAAO;EAGtC,IAFuB,YAAA,YAMrB;EAGF,IAAI,WAEF,SAAS,MAAM,MAAM,EAAE,SAAS;OAC3B;GAGL,MAAM,MAAM,YAAY,GACrB,UAAU,OACb,CAAC;GACD,SAAS,IAAI,IAAI,IAAI,SAAS,IAAI;EACpC;CACF;CAEA,OAAO;AACT"}

package/dist/hooks/useController/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_useController = require("../../useController--lRPWBuD.cjs");
+const require_useController = require("../../useController-Dbe7ADG6.cjs");
 //#region src/hooks/useController/index.ts
 /* v8 ignore stop */
 //#endregion

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

@@ -1,2 +1,2 @@
-import { n as UseControllerReturn, r as useController, t as UseControllerProps } from "../../useController-BT3Fd0IO.cjs";
+import { n as UseControllerReturn, r as useController, t as UseControllerProps } from "../../useController-fblEApv_.cjs";
 export { UseControllerProps, UseControllerReturn, useController };

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

@@ -1,2 +1,2 @@
-import { n as UseControllerReturn, r as useController, t as UseControllerProps } from "../../useController-CzP0aVFC.js";
+import { n as UseControllerReturn, r as useController, t as UseControllerProps } from "../../useController-CvQqCvFJ.js";
 export { UseControllerProps, UseControllerReturn, useController };

package/dist/hooks/useController/index.js

@@ -1,4 +1,4 @@
-import { t as useController } from "../../useController-B287flU_.js";
+import { t as useController } from "../../useController-DxFS0u7c.js";
 //#region src/hooks/useController/index.ts
 /* v8 ignore stop */
 //#endregion

package/dist/hooks/useFormContext/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_useFormContext = require("../../useFormContext-CrXwNYiB.cjs");
+const require_useFormContext = require("../../useFormContext-kUHonwgu.cjs");
 //#region src/hooks/useFormContext/index.ts
 /* v8 ignore stop */
 //#endregion

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

@@ -1,2 +1,2 @@
-import { n as useFormContext, t as checkFieldIsRequired } from "../../useFormContext-M94eQfHm.cjs";
+import { n as useFormContext, t as checkFieldIsRequired } from "../../useFormContext-D5vrT2sg.cjs";
 export { checkFieldIsRequired, useFormContext };

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

@@ -1,2 +1,2 @@
-import { n as useFormContext, t as checkFieldIsRequired } from "../../useFormContext-Bj1gXLt_.js";
+import { n as useFormContext, t as checkFieldIsRequired } from "../../useFormContext-B1-deU4Z.js";
 export { checkFieldIsRequired, useFormContext };

package/dist/hooks/useFormContext/index.js

@@ -1,4 +1,4 @@
-import { n as useFormContext, t as checkFieldIsRequired } from "../../useFormContext-CT8H8xIe.js";
+import { n as useFormContext, t as checkFieldIsRequired } from "../../useFormContext-BJqa1FoT.js";
 //#region src/hooks/useFormContext/index.ts
 /* v8 ignore stop */
 //#endregion

package/dist/hooks/useInput/index.cjs

@@ -1,5 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-require("../../FormContext-DsmS_mkO.cjs");
 let _heroui_input = require("@heroui/input");
 //#region src/hooks/useInput/index.ts
 /* v8 ignore stop */

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

@@ -1,2 +1,2 @@
-import { t as useInput } from "../../useInput-DZOmMKcp.cjs";
+import { t as useInput } from "../../useInput-ClpHDPdr.cjs";
 export { useInput };

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

@@ -1,2 +1,2 @@
-import { t as useInput } from "../../useInput-BdH8oftG.js";
+import { t as useInput } from "../../useInput-ClpHDPdr.js";
 export { useInput };

package/dist/hooks/useInput/index.js

@@ -1,4 +1,4 @@
-import { t as useInput } from "../../useInput-CVm3tP78.js";
+import { t as useInput } from "../../useInput-C0aJaAGe.js";
 //#region src/hooks/useInput/index.ts
 /* v8 ignore stop */
 //#endregion

package/dist/hooks/useInputValueDebounce/index.cjs

@@ -1,6 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-require("../../FormContext-DsmS_mkO.cjs");
-const require_useFormContext = require("../../useFormContext-CrXwNYiB.cjs");
+const require_useFormContext = require("../../useFormContext-kUHonwgu.cjs");
 let react = require("react");
 //#region src/hooks/useInputValueDebounce/useInputValueDebounce.ts
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"index.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,uBAAAA,eAAe;CAGnC,MAAM,CAAC,cAAc,oBAAA,GAAA,MAAA,UAAoC,KAAK;CAE9D,MAAM,cAAA,GAAA,MAAA,QAA2C,IAAI;CAGrD,CAAA,GAAA,MAAA,iBAAgB;EACd,gBAAgB,KAAK;CACvB,GAAG,CAAC,KAAK,CAAC;CAuDV,OAAO;EACL,WAAA,GAAA,MAAA,cAnDC,GAAG,UAAiB;GAEnB,MAAM,WAAY,MAAM,IAAI,QAAQ,SAAS,MAAM;GACnD,gBAAgB,QAAQ;GAGxB,IAAI,WAAW,SACb,aAAa,WAAW,OAAO;GAGjC,MAAM,wBAAwB;IAE5B,IAAI,MAAM,IAAI,QAQZ,SAAS;KANP,GAAG,MAAM;KACT,QAAQ;MACN,GAAG,MAAM,GAAG;MACZ,OAAO;KACT;IAEoB,GAAG,GAAG,MAAM,MAAM,CAAC,CAAC;SAE1C,SAAS,QAAQ;IAInB,QAAQ,IAAI;GACd;GAGA,IAAI,iBAAiB,GACnB,gBAAgB;QAEhB,WAAW,UAAU,WAAW,iBAAiB,aAAa;EAElE,GACA;GAAC;GAAU;GAAe;GAAS;EAAI,CAelB;EACrB,SAAA,GAAA,MAAA,mBAZmC;GAEnC,IAAI,WAAW,SAAS;IACtB,aAAa,WAAW,OAAO;IAC/B,WAAW,UAAU;IACrB,SAAS,YAAY;GACvB;GACA,OAAO;EACT,GAAG;GAAC;GAAU;GAAQ;EAAY,CAIf;EACjB,OAAO;CACT;AACF"}
+{"version":3,"file":"index.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,uBAAAA,eAAe;CAGnC,MAAM,CAAC,cAAc,oBAAA,GAAA,MAAA,UAAoC,KAAK;CAE9D,MAAM,cAAA,GAAA,MAAA,QAA2C,IAAI;CAGrD,CAAA,GAAA,MAAA,iBAAgB;EACd,gBAAgB,KAAK;CACvB,GAAG,CAAC,KAAK,CAAC;CAuDV,OAAO;EACL,WAAA,GAAA,MAAA,cAnDC,GAAG,UAAiB;GAEnB,MAAM,WAAY,MAAM,IAAI,QAAQ,SAAS,MAAM;GACnD,gBAAgB,QAAQ;GAGxB,IAAI,WAAW,SACb,aAAa,WAAW,OAAO;GAGjC,MAAM,wBAAwB;IAE5B,IAAI,MAAM,IAAI,QAQZ,SAAS;KANP,GAAG,MAAM;KACT,QAAQ;MACN,GAAG,MAAM,GAAG;MACZ,OAAO;KACT;IAEoB,GAAG,GAAG,MAAM,MAAM,CAAC,CAAC;SAE1C,SAAS,QAAQ;IAInB,QAAQ,IAAI;GACd;GAGA,IAAI,iBAAiB,GACnB,gBAAgB;QAEhB,WAAW,UAAU,WAAW,iBAAiB,aAAa;EAElE,GACA;GAAC;GAAU;GAAe;GAAS;EAAI,CAelB;EACrB,SAAA,GAAA,MAAA,mBAZmC;GAEnC,IAAI,WAAW,SAAS;IACtB,aAAa,WAAW,OAAO;IAC/B,WAAW,UAAU;IACrB,SAAS,YAAY;GACvB;GACA,OAAO;EACT,GAAG;GAAC;GAAU;GAAQ;EAAY,CAIf;EACjB,OAAO;CACT;AACF"}

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

@@ -1,2 +1,66 @@
-import { n as UseInputValueDebounceReturn, r as useInputValueDebounce, t as UseInputValueDebounceOptions } from "../../useInputValueDebounce-CfQDiomI.cjs";
-export { UseInputValueDebounceOptions, UseInputValueDebounceReturn, useInputValueDebounce };
+//#region src/hooks/useInputValueDebounce/useInputValueDebounce.d.ts
+interface UseInputValueDebounceOptions<TValue = unknown> {
+  /** Debounce delay in milliseconds (default: 300) */
+  debounceDelay?: number;
+  /** Field name for triggering validation after debounced value commits */
+  name: string;
+  /** The onBlur function to call after flushing debounced value */
+  onBlur: () => void;
+  /** The onChange function to call with debounced value */
+  onChange: (...event: any[]) => void;
+  /** The field value */
+  value: TValue;
+}
+interface UseInputValueDebounceReturn<TValue = unknown> {
+  /** Enhanced onChange function with debouncing */
+  onChange: (...event: any[]) => void;
+  /** Enhanced onBlur function that flushes current value immediately */
+  onBlur: () => void;
+  /** The field value that is displayed - updates immediately */
+  value: TValue;
+}
+/**
+ * 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,
+ * });
+ * ```
+ */
+declare const useInputValueDebounce: <TValue = unknown>({
+  debounceDelay,
+  name,
+  onBlur,
+  onChange,
+  value
+}: UseInputValueDebounceOptions<TValue>) => UseInputValueDebounceReturn<TValue>;
+//#endregion
+export { UseInputValueDebounceOptions, UseInputValueDebounceReturn, useInputValueDebounce };
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/hooks/useInputValueDebounce/useInputValueDebounce.ts"],"mappings":";UAIiB,4BAAA;EAAA;EAEf,aAAA;EAF2C;EAI3C,IAAA;EAJ4C;EAM5C,MAAA;EAFA;EAKA,QAAA,MAAc,KAAA;EAAd;EAEA,KAAA,EAAO,MAAM;AAAA;AAAA,UAGE,2BAAA;EAHF;EAMb,QAAA,MAAc,KAAA;EAHC;EAKf,MAAA;EAL0C;EAO1C,KAAA,EAAO,MAAM;AAAA;;;;;;;AAAA;AAsCf;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAAa,qBAAA;EAA2C,aAAA;EAAA,IAAA;EAAA,MAAA;EAAA,QAAA;EAAA;AAAA,GAMrD,4BAAA,CAA6B,MAAA,MAAU,2BAAA,CAA4B,MAAA"}

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

@@ -1,2 +1,66 @@
-import { n as UseInputValueDebounceReturn, r as useInputValueDebounce, t as UseInputValueDebounceOptions } from "../../useInputValueDebounce-DZgzL7GQ.js";
-export { UseInputValueDebounceOptions, UseInputValueDebounceReturn, useInputValueDebounce };
+//#region src/hooks/useInputValueDebounce/useInputValueDebounce.d.ts
+interface UseInputValueDebounceOptions<TValue = unknown> {
+  /** Debounce delay in milliseconds (default: 300) */
+  debounceDelay?: number;
+  /** Field name for triggering validation after debounced value commits */
+  name: string;
+  /** The onBlur function to call after flushing debounced value */
+  onBlur: () => void;
+  /** The onChange function to call with debounced value */
+  onChange: (...event: any[]) => void;
+  /** The field value */
+  value: TValue;
+}
+interface UseInputValueDebounceReturn<TValue = unknown> {
+  /** Enhanced onChange function with debouncing */
+  onChange: (...event: any[]) => void;
+  /** Enhanced onBlur function that flushes current value immediately */
+  onBlur: () => void;
+  /** The field value that is displayed - updates immediately */
+  value: TValue;
+}
+/**
+ * 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,
+ * });
+ * ```
+ */
+declare const useInputValueDebounce: <TValue = unknown>({
+  debounceDelay,
+  name,
+  onBlur,
+  onChange,
+  value
+}: UseInputValueDebounceOptions<TValue>) => UseInputValueDebounceReturn<TValue>;
+//#endregion
+export { UseInputValueDebounceOptions, UseInputValueDebounceReturn, useInputValueDebounce };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/hooks/useInputValueDebounce/useInputValueDebounce.ts"],"mappings":";UAIiB,4BAAA;EAAA;EAEf,aAAA;EAF2C;EAI3C,IAAA;EAJ4C;EAM5C,MAAA;EAFA;EAKA,QAAA,MAAc,KAAA;EAAd;EAEA,KAAA,EAAO,MAAM;AAAA;AAAA,UAGE,2BAAA;EAHF;EAMb,QAAA,MAAc,KAAA;EAHC;EAKf,MAAA;EAL0C;EAO1C,KAAA,EAAO,MAAM;AAAA;;;;;;;AAAA;AAsCf;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAAa,qBAAA;EAA2C,aAAA;EAAA,IAAA;EAAA,MAAA;EAAA,QAAA;EAAA;AAAA,GAMrD,4BAAA,CAA6B,MAAA,MAAU,2BAAA,CAA4B,MAAA"}

package/dist/hooks/useInputValueDebounce/index.js

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

package/dist/hooks/useInputValueTransform/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_useInputValueTransform = require("../../useInputValueTransform-Bm65K8LX.cjs");
+const require_useInputValueTransform = require("../../useInputValueTransform-P62UUZBl.cjs");
 //#region src/hooks/useInputValueTransform/index.ts
 /* v8 ignore stop */
 //#endregion

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

@@ -1,2 +1,2 @@
-import { i as useInputValueTransform, n as UseInputValueTransformOptions, r as UseInputValueTransformReturn, t as InputValueTransform } from "../../useInputValueTransform-CNCBU7a9.cjs";
+import { i as useInputValueTransform, n as UseInputValueTransformOptions, r as UseInputValueTransformReturn, t as InputValueTransform } from "../../useInputValueTransform-DCXXb2Lp.cjs";
 export { InputValueTransform, UseInputValueTransformOptions, UseInputValueTransformReturn, useInputValueTransform };

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

@@ -1,2 +1,2 @@
-import { i as useInputValueTransform, n as UseInputValueTransformOptions, r as UseInputValueTransformReturn, t as InputValueTransform } from "../../useInputValueTransform-dLfFIYW4.js";
+import { i as useInputValueTransform, n as UseInputValueTransformOptions, r as UseInputValueTransformReturn, t as InputValueTransform } from "../../useInputValueTransform-DCXXb2Lp.js";
 export { InputValueTransform, UseInputValueTransformOptions, UseInputValueTransformReturn, useInputValueTransform };

package/dist/hooks/useInputValueTransform/index.js

@@ -1,4 +1,4 @@
-import { t as useInputValueTransform } from "../../useInputValueTransform-CXdmtc0Q.js";
+import { t as useInputValueTransform } from "../../useInputValueTransform-DJ5zkqSy.js";
 //#region src/hooks/useInputValueTransform/index.ts
 /* v8 ignore stop */
 //#endregion

package/dist/hooks/useUniformField/index.cjs

@@ -1,11 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_FormContext = require("../../FormContext-DsmS_mkO.cjs");
+const require_FormContext = require("../../FormContext-EGH0cVnH.cjs");
 const require_helpers_index = require("../../helpers/index.cjs");
-const require_FieldCopyTestIdButton = require("../../FieldCopyTestIdButton-ptoB1F75.cjs");
-const require_FieldValidationError = require("../../FieldValidationError-BQcvvU9i.cjs");
-const require_useController = require("../../useController--lRPWBuD.cjs");
-const require_useFormContext = require("../../useFormContext-CrXwNYiB.cjs");
-const require_useInputValueTransform = require("../../useInputValueTransform-Bm65K8LX.cjs");
+const require_FieldCopyTestIdButton = require("../../FieldCopyTestIdButton-D3D_LmJh.cjs");
+const require_FieldValidationError = require("../../FieldValidationError-CfYKzl7P.cjs");
+const require_useController = require("../../useController-Dbe7ADG6.cjs");
+const require_useFormContext = require("../../useFormContext-kUHonwgu.cjs");
+const require_useInputValueTransform = require("../../useInputValueTransform-P62UUZBl.cjs");
 let react = require("react");
 react = require_FormContext.__toESM(react);
 let _fuf_stack_pixels = require("@fuf-stack/pixels");
@@ -86,8 +86,8 @@ const useUniformField = (params) => {
 	const hasValue = !require_helpers_index.isValueEmpty(fieldValue);
 	const invalid = (0, _fuf_stack_pixels.useDebounce)(rawInvalid && (isDirty && 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, { testId }) : null] }) : null;
-	const errorMessage = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_FieldValidationError.FieldValidationError, {
+	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, { testId }) : null] }) : null;
+	const errorMessage = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_FieldValidationError.FieldValidationError_default, {
 		error,
 		testId
 	});

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

@@ -1 +1 @@
-{"version":3,"file":"index.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    isDirty,\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);\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 user-entered 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: `hasValue` is gated by `isDirty` so invalid initial values do not\n   * show errors just because resolver-backed validation state is available.\n   * Newly added empty array elements can be dirty, but stay hidden until blur\n   * because they do not have a value yet.\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 =\n    rawInvalid && ((isDirty && 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,uBAAAA,eAA6B;CAEjC,MAAM,EACJ,OACA,SAAS,YACT,SACA,WACA,UACA,WACE,cAAc,MAAM,cAAc;CAEtC,MAAM,EAAE,UAAUC,sBAAAA,cAA4B;EAC5C;EACA;EACA;CACF,CAAC;CACD,MAAM,EACJ,UAAU,eACV,OAAO,YACP,UAAU,YACV,QACA,QACE;CAIJ,MAAM,EAAE,gBAAgB,gBAAgBC,+BAAAA,uBAAiC;EACvE;EACA;CACF,CAAC;CAGD,MAAM,mBAAmB,eAAe,UAAU;CAClD,MAAM,uBAAuB,iBAA+C;EAM1E,cADkB,YAFf,cAAsD,QAAQ,SAC/D,YAEoB,CAAC;CACzB;CAEA,MAAM,eAAgB,UAAU,IAC9B;;;;;;;;;;;;;;;;;;;;;;;;;CA6BF,MAAM,WAAW,CAACC,sBAAAA,aAAa,UAAU;CAIzC,MAAM,WAAA,GAAA,kBAAA,aAFJ,eAAgB,WAAW,YAAa,aAAa,cAAc,IAE5B,GAAG;CAM5C,MAAM,uBAAuB,cAAc;CAC3C,MAAM,YACJ,CAAC,CAAC,SAAS,uBACT,iBAAA,GAAA,kBAAA,MAAA,kBAAA,UAAA,EAAA,UAAA,CACG,UAAU,QAAQ,QAAQ,MAC1B,uBACC,iBAAA,GAAA,kBAAA,KAACC,8BAAAA,uBAAD,EAA+B,OAAS,CAAA,IACtC,IACJ,EAAA,CAAA,IACA;CAIN,MAAM,eAAe,iBAAA,GAAA,kBAAA,KAACC,6BAAAA,sBAAD;EAA6B;EAAe;CAAS,CAAA;CAK1E,MAAM,EAAE,sBAAsB,eAAe,2BAAA,GAAA,cAAA,UAClC;EACP;EACA,YAAY,EAEV,eAAe,MACjB;EACA,cAAc,KAAK,UAAU,KAAK;EAClC,WAAW;EACX,YAAY;EACZ;EACA,gBAAgB;CAClB,CAAC;CAQH,OAAO;EACL,WAHA,oBAAoB,OAAO,UAAU,WAAW,QAAQ;EAIxD;EACA;EACA;EACA,UAAU;EACV;EACA;EACA,OAAO;GACL,GAAG;GACH,OAAO;GACP,UAAU;EACZ;EACA;EACA;EACA;EACA;EACA;EACA,OAAO;EACP;EACA,UAAU;EACV;EACA;EACA;EACA;CACF;AACF"}
+{"version":3,"file":"index.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    isDirty,\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);\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 user-entered 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: `hasValue` is gated by `isDirty` so invalid initial values do not\n   * show errors just because resolver-backed validation state is available.\n   * Newly added empty array elements can be dirty, but stay hidden until blur\n   * because they do not have a value yet.\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 =\n    rawInvalid && ((isDirty && 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,uBAAAA,eAA6B;CAEjC,MAAM,EACJ,OACA,SAAS,YACT,SACA,WACA,UACA,WACE,cAAc,MAAM,cAAc;CAEtC,MAAM,EAAE,UAAUC,sBAAAA,cAA4B;EAC5C;EACA;EACA;CACF,CAAC;CACD,MAAM,EACJ,UAAU,eACV,OAAO,YACP,UAAU,YACV,QACA,QACE;CAIJ,MAAM,EAAE,gBAAgB,gBAAgBC,+BAAAA,uBAAiC;EACvE;EACA;CACF,CAAC;CAGD,MAAM,mBAAmB,eAAe,UAAU;CAClD,MAAM,uBAAuB,iBAA+C;EAM1E,cADkB,YAFf,cAAsD,QAAQ,SAC/D,YAEoB,CAAC;CACzB;CAEA,MAAM,eAAgB,UAAU,IAC9B;;;;;;;;;;;;;;;;;;;;;;;;;CA6BF,MAAM,WAAW,CAACC,sBAAAA,aAAa,UAAU;CAIzC,MAAM,WAAA,GAAA,kBAAA,aAFJ,eAAgB,WAAW,YAAa,aAAa,cAAc,IAE5B,GAAG;CAM5C,MAAM,uBAAuB,cAAc;CAC3C,MAAM,YACJ,CAAC,CAAC,SAAS,uBACT,iBAAA,GAAA,kBAAA,MAAA,kBAAA,UAAA,EAAA,UAAA,CACG,UAAU,QAAQ,QAAQ,MAC1B,uBACC,iBAAA,GAAA,kBAAA,KAACC,8BAAAA,+BAAD,EAA+B,OAAS,CAAA,IACtC,IACJ,EAAA,CAAA,IACA;CAIN,MAAM,eAAe,iBAAA,GAAA,kBAAA,KAACC,6BAAAA,8BAAD;EAA6B;EAAe;CAAS,CAAA;CAK1E,MAAM,EAAE,sBAAsB,eAAe,2BAAA,GAAA,cAAA,UAClC;EACP;EACA,YAAY,EAEV,eAAe,MACjB;EACA,cAAc,KAAK,UAAU,KAAK;EAClC,WAAW;EACX,YAAY;EACZ;EACA,gBAAgB;CAClB,CAAC;CAQH,OAAO;EACL,WAHA,oBAAoB,OAAO,UAAU,WAAW,QAAQ;EAIxD;EACA;EACA;EACA,UAAU;EACV;EACA;EACA,OAAO;GACL,GAAG;GACH,OAAO;GACP,UAAU;EACZ;EACA;EACA;EACA;EACA;EACA;EACA,OAAO;EACP;EACA,UAAU;EACV;EACA;EACA;EACA;CACF;AACF"}