@fuf-stack/uniform 1.18.2 → 1.19.0

package/dist/hooks/useUniformFieldArray/index.cjs

@@ -1,3 +1,84 @@
-const require_useUniformFieldArray = require('../../useUniformFieldArray-CRCbV1J2.cjs');
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../FormContext-3GzWxXSS.cjs");
+const require_helpers_index = require("../../helpers/index.cjs");
+const require_useFormContext = require("../../useFormContext-BQeGmV8j.cjs");
+const require_hooks_useUniformField_index = require("../useUniformField/index.cjs");
+let react = require("react");
+let _fuf_stack_pixel_motion = require("@fuf-stack/pixel-motion");
+let react_hook_form = require("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 = require_hooks_useUniformField_index.useUniformField({
+		name,
+		disabled,
+		testId: explicitTestId,
+		label
+	});
+	const { control } = uniformField;
+	const { fields, append, remove, insert, move } = (0, react_hook_form.useFieldArray)({
+		control,
+		name
+	});
+	const { trigger, setValue } = require_useFormContext.useFormContext();
+	const needsInitialize = (0, react.useMemo)(() => {
+		return lastElementNotRemovable && fields.length === 0;
+	}, [lastElementNotRemovable, fields.length]);
+	const hasInitialized = (0, react.useRef)(!needsInitialize);
+	(0, react.useEffect)(() => {
+		if (needsInitialize) hasInitialized.current = false;
+	}, [needsInitialize]);
+	(0, react.useEffect)(() => {
+		if (hasInitialized.current) setTimeout(() => {
+			trigger(name);
+		}, 200);
+	}, [fields.length]);
+	const [disableAnimation, setDisableAnimation] = (0, react.useState)(true);
+	const prefersReducedMotion = (0, _fuf_stack_pixel_motion.useReducedMotion)();
+	(0, react.useEffect)(() => {
+		if (hasInitialized.current) setDisableAnimation(!!prefersReducedMotion);
+	}, [prefersReducedMotion]);
+	const elementInitialValue = (0, react.useMemo)(() => {
+		return flat ? { [require_helpers_index.flatArrayKey]: _elementInitialValue ?? null } : _elementInitialValue ?? {};
+	}, [flat, _elementInitialValue]);
+	(0, react.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
+exports.useUniformFieldArray = useUniformFieldArray;
 
-exports.useUniformFieldArray = require_useUniformFieldArray.useUniformFieldArray;
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["useUniformField","useFormContext","flatArrayKey"],"sources":["../../../src/hooks/useUniformFieldArray/useUniformFieldArray.ts","../../../src/hooks/useUniformFieldArray/index.ts"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type { ArrayPath, FieldValues, Path } from 'react-hook-form';\n\nimport { useEffect, useMemo, useRef, useState } from 'react';\nimport { useFieldArray as useRHFFieldArray } from 'react-hook-form';\n\nimport { useReducedMotion } from '@fuf-stack/pixel-motion';\n\nimport { flatArrayKey } from '../../helpers';\nimport { useFormContext } from '../useFormContext';\nimport { useUniformField } from '../useUniformField';\n\nexport interface UseUniformFieldArrayProps<\n  TFieldValues extends FieldValues = FieldValues,\n> {\n  /** Field name for the array */\n  name: ArrayPath<TFieldValues>;\n  /** Whether this is a flat array (array of primitives) */\n  flat?: boolean;\n  /** Initial value for new array elements */\n  elementInitialValue?: unknown;\n  /** Whether the last element cannot be removed (always maintain at least one element) */\n  lastElementNotRemovable?: boolean;\n  /** Disable the field */\n  disabled?: boolean;\n  /** Optional explicit test id used to build stable test ids */\n  testId?: string;\n  /** Optional label content */\n  label?: ReactNode;\n}\n\n/**\n * Enhanced useFieldArray hook with initialization and animation logic.\n * Based on React Hook Form's useFieldArray with additional features:\n * - Automatic initialization when lastElementNotRemovable is set\n * - Animation control (disabled during initialization)\n * - Support for flat arrays (arrays of primitives)\n *\n * Note: Automatic validation triggering on length change is disabled to prevent\n * triggering form-wide validation. Array validation still runs on form submission.\n *\n * @see https://react-hook-form.com/docs/usefieldarray\n */\nexport const useUniformFieldArray = <\n  TFieldValues extends FieldValues = FieldValues,\n>({\n  name,\n  flat = false,\n  elementInitialValue: _elementInitialValue = null,\n  lastElementNotRemovable = false,\n  disabled,\n  testId: explicitTestId,\n  label,\n}: UseUniformFieldArrayProps<TFieldValues>) => {\n  // Get uniform field state and utilities\n  const uniformField = useUniformField<TFieldValues>({\n    name: name as Path<TFieldValues> & string,\n    disabled,\n    testId: explicitTestId,\n    label,\n  });\n\n  const { control } = uniformField;\n\n  const { fields, append, remove, insert, move } = useRHFFieldArray({\n    control,\n    name,\n  });\n\n  const { trigger, setValue } = useFormContext<TFieldValues>();\n\n  // Determine if initialization is needed (initially or after reset).\n  // This flag automatically handles both scenarios:\n  // - Initial mount: fields.length starts at 0\n  // - Form reset: fields.length becomes 0 again\n  // Additional initialization conditions can be added here later (e.g., minElements > 0)\n  // Using useMemo ensures this value is properly tracked by React and effects can depend on it\n  const needsInitialize = useMemo(() => {\n    return lastElementNotRemovable && fields.length === 0;\n  }, [lastElementNotRemovable, fields.length]);\n\n  // Track whether initialization has completed. Initialized contextually:\n  // - If initialization IS needed (needsInitialize = true): starts as false, set to true after init\n  // - If initialization is NOT needed (needsInitialize = false): starts as true (already initialized)\n  // This ref is used to:\n  // 1. Skip validation during initialization/re-initialization\n  // 2. Gate animation enabling until after initialization\n  // 3. Gate motion preference effect until after initialization\n  const hasInitialized = useRef(!needsInitialize);\n\n  // Reset initialization flag when needsInitialize changes to true.\n  // This handles form reset: when fields become empty (needsInitialize becomes true),\n  // hasInitialized is reset to false, triggering re-initialization in the effect below.\n  useEffect(() => {\n    if (needsInitialize) {\n      hasInitialized.current = false;\n    }\n  }, [needsInitialize]);\n\n  // Validate array-level constraints (min/max items) when length changes.\n  // This ensures min/max errors appear instantly when user adds/removes items.\n  // Note: Child field validation also runs, but new empty fields won't show as invalid\n  // because useFormContext only sets invalid=true for touched fields or after form submission.\n  // Skip validation during initialization/re-initialization to avoid showing errors prematurely.\n  useEffect(() => {\n    if (hasInitialized.current) {\n      setTimeout(() => {\n        trigger(name as Path<TFieldValues>);\n      }, 200);\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [fields.length]);\n\n  // Animation control: Start with animations disabled to prevent animating in initial elements.\n  // Will be enabled after initialization completes (unless user prefers reduced motion).\n  const [disableAnimation, setDisableAnimation] = useState(true);\n\n  // Respond to user's motion preference changes (after initialization).\n  // During initialization, animations stay disabled regardless of preference.\n  const prefersReducedMotion = useReducedMotion();\n  useEffect(() => {\n    if (hasInitialized.current) {\n      setDisableAnimation(!!prefersReducedMotion);\n    }\n  }, [prefersReducedMotion]);\n\n  // Prepare initial element value based on mode\n  // - flat=true: arrays of primitives → object with flatArrayKey and null value by default\n  // - flat=false: arrays of objects → empty object by default\n  const elementInitialValue = useMemo(() => {\n    return flat\n      ? { [flatArrayKey]: _elementInitialValue ?? null }\n      : (_elementInitialValue ?? {});\n  }, [flat, _elementInitialValue]);\n\n  // Initialization/Re-initialization: Add initial element when needed.\n  // This handles both initial mount and form reset scenarios by reacting to needsInitialize.\n  // CRITICAL: This effect MUST be the LAST hook in this component.\n  // It sets hasInitialized.current = true, which acts as a gate for other effects.\n  // If this runs before other effects, hasInitialized will be true during their first run,\n  // causing them to execute logic meant only for post-initialization (e.g., validation,\n  // animation enabling). By placing this last, all other effects run first with\n  // hasInitialized = false, allowing them to skip initialization-phase logic.\n  useEffect(\n    () => {\n      if (needsInitialize) {\n        // use setValue instead of append to avoid focusing the added element\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        setValue(name as Path<TFieldValues>, [elementInitialValue] as any, {\n          shouldDirty: false,\n          shouldTouch: false,\n        });\n\n        // Mark initialization as complete\n        hasInitialized.current = true;\n\n        // Enable animations after a brief delay (unless user prefers reduced motion or animations are already enabled).\n        // This only runs on initial mount when animations start disabled.\n        // On reset, disableAnimation is typically false, so this setTimeout won't run and animations stay enabled.\n        if (!prefersReducedMotion && disableAnimation) {\n          setTimeout(() => {\n            setDisableAnimation(false);\n          }, 1);\n        }\n      }\n    },\n    // Run when needsInitialize changes (initial mount or reset)\n    // needsInitialize is memoized based on fields.length and lastElementNotRemovable\n    // Other dependencies are intentionally omitted:\n    // - append, setValue, trigger, setDisableAnimation are stable refs/functions\n    // - elementInitialValue, name, flat, prefersReducedMotion, disableAnimation are props/stable values\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [needsInitialize],\n  );\n\n  return {\n    // Field array methods and state\n    fields,\n    append,\n    remove,\n    insert,\n    move,\n    disableAnimation,\n    elementInitialValue,\n    // Uniform field state and utilities (spread all)\n    ...uniformField,\n  };\n};\n","/* v8 ignore start */\n\nexport * from './useUniformFieldArray';\n\n/* v8 ignore stop */\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA2CA,MAAa,wBAEX,EACA,MACA,OAAO,OACP,qBAAqB,uBAAuB,MAC5C,0BAA0B,OAC1B,UACA,QAAQ,gBACR,YAC6C;CAE7C,MAAM,eAAeA,oCAAAA,gBAA8B;EAC3C;EACN;EACA,QAAQ;EACR;EACD,CAAC;CAEF,MAAM,EAAE,YAAY;CAEpB,MAAM,EAAE,QAAQ,QAAQ,QAAQ,QAAQ,UAAA,GAAA,gBAAA,eAA0B;EAChE;EACA;EACD,CAAC;CAEF,MAAM,EAAE,SAAS,aAAaC,uBAAAA,gBAA8B;CAQ5D,MAAM,mBAAA,GAAA,MAAA,eAAgC;AACpC,SAAO,2BAA2B,OAAO,WAAW;IACnD,CAAC,yBAAyB,OAAO,OAAO,CAAC;CAS5C,MAAM,kBAAA,GAAA,MAAA,QAAwB,CAAC,gBAAgB;AAK/C,EAAA,GAAA,MAAA,iBAAgB;AACd,MAAI,gBACF,gBAAe,UAAU;IAE1B,CAAC,gBAAgB,CAAC;AAOrB,EAAA,GAAA,MAAA,iBAAgB;AACd,MAAI,eAAe,QACjB,kBAAiB;AACf,WAAQ,KAA2B;KAClC,IAAI;IAGR,CAAC,OAAO,OAAO,CAAC;CAInB,MAAM,CAAC,kBAAkB,wBAAA,GAAA,MAAA,UAAgC,KAAK;CAI9D,MAAM,wBAAA,GAAA,wBAAA,mBAAyC;AAC/C,EAAA,GAAA,MAAA,iBAAgB;AACd,MAAI,eAAe,QACjB,qBAAoB,CAAC,CAAC,qBAAqB;IAE5C,CAAC,qBAAqB,CAAC;CAK1B,MAAM,uBAAA,GAAA,MAAA,eAAoC;AACxC,SAAO,OACH,GAAGC,sBAAAA,eAAe,wBAAwB,MAAM,GAC/C,wBAAwB,EAAE;IAC9B,CAAC,MAAM,qBAAqB,CAAC;AAUhC,EAAA,GAAA,MAAA,iBACQ;AACJ,MAAI,iBAAiB;AAGnB,YAAS,MAA4B,CAAC,oBAAoB,EAAS;IACjE,aAAa;IACb,aAAa;IACd,CAAC;AAGF,kBAAe,UAAU;AAKzB,OAAI,CAAC,wBAAwB,iBAC3B,kBAAiB;AACf,wBAAoB,MAAM;MACzB,EAAE;;IAUX,CAAC,gBAAgB,CAClB;AAED,QAAO;EAEL;EACA;EACA;EACA;EACA;EACA;EACA;EAEA,GAAG;EACJ"}

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

@@ -1,2 +1,2 @@
-import { n as useUniformFieldArray, t as UseUniformFieldArrayProps } from "../../useUniformFieldArray-BChcZvc5.cjs";
+import { n as useUniformFieldArray, t as UseUniformFieldArrayProps } from "../../useUniformFieldArray-CDEagafl.cjs";
 export { UseUniformFieldArrayProps, useUniformFieldArray };

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

@@ -1,7 +1,2 @@
-import "../../FormContext-CCe8drkp.js";
-import "../../useController-DfiNbuEz.js";
-import "../../index-hIBrhvnj.js";
-import "../../useFormContext-C6OOtqZ5.js";
-import "../../index-BMCcWGYS.js";
-import { n as useUniformFieldArray, t as UseUniformFieldArrayProps } from "../../useUniformFieldArray-4MOU0xac.js";
+import { n as useUniformFieldArray, t as UseUniformFieldArrayProps } from "../../useUniformFieldArray-CMHoo4o3.js";
 export { UseUniformFieldArrayProps, useUniformFieldArray };

package/dist/hooks/useUniformFieldArray/index.js

@@ -1,3 +1,82 @@
-import { t as useUniformFieldArray } from "../../useUniformFieldArray-BKvA0FQW.js";
+import { flatArrayKey } from "../../helpers/index.js";
+import { n as useFormContext$1 } from "../../useFormContext-Bzpyonu6.js";
+import { useUniformField } from "../useUniformField/index.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 };
 
-export { useUniformFieldArray };
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["useRHFFieldArray","useFormContext"],"sources":["../../../src/hooks/useUniformFieldArray/useUniformFieldArray.ts","../../../src/hooks/useUniformFieldArray/index.ts"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type { ArrayPath, FieldValues, Path } from 'react-hook-form';\n\nimport { useEffect, useMemo, useRef, useState } from 'react';\nimport { useFieldArray as useRHFFieldArray } from 'react-hook-form';\n\nimport { useReducedMotion } from '@fuf-stack/pixel-motion';\n\nimport { flatArrayKey } from '../../helpers';\nimport { useFormContext } from '../useFormContext';\nimport { useUniformField } from '../useUniformField';\n\nexport interface UseUniformFieldArrayProps<\n  TFieldValues extends FieldValues = FieldValues,\n> {\n  /** Field name for the array */\n  name: ArrayPath<TFieldValues>;\n  /** Whether this is a flat array (array of primitives) */\n  flat?: boolean;\n  /** Initial value for new array elements */\n  elementInitialValue?: unknown;\n  /** Whether the last element cannot be removed (always maintain at least one element) */\n  lastElementNotRemovable?: boolean;\n  /** Disable the field */\n  disabled?: boolean;\n  /** Optional explicit test id used to build stable test ids */\n  testId?: string;\n  /** Optional label content */\n  label?: ReactNode;\n}\n\n/**\n * Enhanced useFieldArray hook with initialization and animation logic.\n * Based on React Hook Form's useFieldArray with additional features:\n * - Automatic initialization when lastElementNotRemovable is set\n * - Animation control (disabled during initialization)\n * - Support for flat arrays (arrays of primitives)\n *\n * Note: Automatic validation triggering on length change is disabled to prevent\n * triggering form-wide validation. Array validation still runs on form submission.\n *\n * @see https://react-hook-form.com/docs/usefieldarray\n */\nexport const useUniformFieldArray = <\n  TFieldValues extends FieldValues = FieldValues,\n>({\n  name,\n  flat = false,\n  elementInitialValue: _elementInitialValue = null,\n  lastElementNotRemovable = false,\n  disabled,\n  testId: explicitTestId,\n  label,\n}: UseUniformFieldArrayProps<TFieldValues>) => {\n  // Get uniform field state and utilities\n  const uniformField = useUniformField<TFieldValues>({\n    name: name as Path<TFieldValues> & string,\n    disabled,\n    testId: explicitTestId,\n    label,\n  });\n\n  const { control } = uniformField;\n\n  const { fields, append, remove, insert, move } = useRHFFieldArray({\n    control,\n    name,\n  });\n\n  const { trigger, setValue } = useFormContext<TFieldValues>();\n\n  // Determine if initialization is needed (initially or after reset).\n  // This flag automatically handles both scenarios:\n  // - Initial mount: fields.length starts at 0\n  // - Form reset: fields.length becomes 0 again\n  // Additional initialization conditions can be added here later (e.g., minElements > 0)\n  // Using useMemo ensures this value is properly tracked by React and effects can depend on it\n  const needsInitialize = useMemo(() => {\n    return lastElementNotRemovable && fields.length === 0;\n  }, [lastElementNotRemovable, fields.length]);\n\n  // Track whether initialization has completed. Initialized contextually:\n  // - If initialization IS needed (needsInitialize = true): starts as false, set to true after init\n  // - If initialization is NOT needed (needsInitialize = false): starts as true (already initialized)\n  // This ref is used to:\n  // 1. Skip validation during initialization/re-initialization\n  // 2. Gate animation enabling until after initialization\n  // 3. Gate motion preference effect until after initialization\n  const hasInitialized = useRef(!needsInitialize);\n\n  // Reset initialization flag when needsInitialize changes to true.\n  // This handles form reset: when fields become empty (needsInitialize becomes true),\n  // hasInitialized is reset to false, triggering re-initialization in the effect below.\n  useEffect(() => {\n    if (needsInitialize) {\n      hasInitialized.current = false;\n    }\n  }, [needsInitialize]);\n\n  // Validate array-level constraints (min/max items) when length changes.\n  // This ensures min/max errors appear instantly when user adds/removes items.\n  // Note: Child field validation also runs, but new empty fields won't show as invalid\n  // because useFormContext only sets invalid=true for touched fields or after form submission.\n  // Skip validation during initialization/re-initialization to avoid showing errors prematurely.\n  useEffect(() => {\n    if (hasInitialized.current) {\n      setTimeout(() => {\n        trigger(name as Path<TFieldValues>);\n      }, 200);\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [fields.length]);\n\n  // Animation control: Start with animations disabled to prevent animating in initial elements.\n  // Will be enabled after initialization completes (unless user prefers reduced motion).\n  const [disableAnimation, setDisableAnimation] = useState(true);\n\n  // Respond to user's motion preference changes (after initialization).\n  // During initialization, animations stay disabled regardless of preference.\n  const prefersReducedMotion = useReducedMotion();\n  useEffect(() => {\n    if (hasInitialized.current) {\n      setDisableAnimation(!!prefersReducedMotion);\n    }\n  }, [prefersReducedMotion]);\n\n  // Prepare initial element value based on mode\n  // - flat=true: arrays of primitives → object with flatArrayKey and null value by default\n  // - flat=false: arrays of objects → empty object by default\n  const elementInitialValue = useMemo(() => {\n    return flat\n      ? { [flatArrayKey]: _elementInitialValue ?? null }\n      : (_elementInitialValue ?? {});\n  }, [flat, _elementInitialValue]);\n\n  // Initialization/Re-initialization: Add initial element when needed.\n  // This handles both initial mount and form reset scenarios by reacting to needsInitialize.\n  // CRITICAL: This effect MUST be the LAST hook in this component.\n  // It sets hasInitialized.current = true, which acts as a gate for other effects.\n  // If this runs before other effects, hasInitialized will be true during their first run,\n  // causing them to execute logic meant only for post-initialization (e.g., validation,\n  // animation enabling). By placing this last, all other effects run first with\n  // hasInitialized = false, allowing them to skip initialization-phase logic.\n  useEffect(\n    () => {\n      if (needsInitialize) {\n        // use setValue instead of append to avoid focusing the added element\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        setValue(name as Path<TFieldValues>, [elementInitialValue] as any, {\n          shouldDirty: false,\n          shouldTouch: false,\n        });\n\n        // Mark initialization as complete\n        hasInitialized.current = true;\n\n        // Enable animations after a brief delay (unless user prefers reduced motion or animations are already enabled).\n        // This only runs on initial mount when animations start disabled.\n        // On reset, disableAnimation is typically false, so this setTimeout won't run and animations stay enabled.\n        if (!prefersReducedMotion && disableAnimation) {\n          setTimeout(() => {\n            setDisableAnimation(false);\n          }, 1);\n        }\n      }\n    },\n    // Run when needsInitialize changes (initial mount or reset)\n    // needsInitialize is memoized based on fields.length and lastElementNotRemovable\n    // Other dependencies are intentionally omitted:\n    // - append, setValue, trigger, setDisableAnimation are stable refs/functions\n    // - elementInitialValue, name, flat, prefersReducedMotion, disableAnimation are props/stable values\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [needsInitialize],\n  );\n\n  return {\n    // Field array methods and state\n    fields,\n    append,\n    remove,\n    insert,\n    move,\n    disableAnimation,\n    elementInitialValue,\n    // Uniform field state and utilities (spread all)\n    ...uniformField,\n  };\n};\n","/* v8 ignore start */\n\nexport * from './useUniformFieldArray';\n\n/* v8 ignore stop */\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA2CA,MAAa,wBAEX,EACA,MACA,OAAO,OACP,qBAAqB,uBAAuB,MAC5C,0BAA0B,OAC1B,UACA,QAAQ,gBACR,YAC6C;CAE7C,MAAM,eAAe,gBAA8B;EAC3C;EACN;EACA,QAAQ;EACR;EACD,CAAC;CAEF,MAAM,EAAE,YAAY;CAEpB,MAAM,EAAE,QAAQ,QAAQ,QAAQ,QAAQ,SAASA,cAAiB;EAChE;EACA;EACD,CAAC;CAEF,MAAM,EAAE,SAAS,aAAaC,kBAA8B;CAQ5D,MAAM,kBAAkB,cAAc;AACpC,SAAO,2BAA2B,OAAO,WAAW;IACnD,CAAC,yBAAyB,OAAO,OAAO,CAAC;CAS5C,MAAM,iBAAiB,OAAO,CAAC,gBAAgB;AAK/C,iBAAgB;AACd,MAAI,gBACF,gBAAe,UAAU;IAE1B,CAAC,gBAAgB,CAAC;AAOrB,iBAAgB;AACd,MAAI,eAAe,QACjB,kBAAiB;AACf,WAAQ,KAA2B;KAClC,IAAI;IAGR,CAAC,OAAO,OAAO,CAAC;CAInB,MAAM,CAAC,kBAAkB,uBAAuB,SAAS,KAAK;CAI9D,MAAM,uBAAuB,kBAAkB;AAC/C,iBAAgB;AACd,MAAI,eAAe,QACjB,qBAAoB,CAAC,CAAC,qBAAqB;IAE5C,CAAC,qBAAqB,CAAC;CAK1B,MAAM,sBAAsB,cAAc;AACxC,SAAO,OACH,GAAG,eAAe,wBAAwB,MAAM,GAC/C,wBAAwB,EAAE;IAC9B,CAAC,MAAM,qBAAqB,CAAC;AAUhC,iBACQ;AACJ,MAAI,iBAAiB;AAGnB,YAAS,MAA4B,CAAC,oBAAoB,EAAS;IACjE,aAAa;IACb,aAAa;IACd,CAAC;AAGF,kBAAe,UAAU;AAKzB,OAAI,CAAC,wBAAwB,iBAC3B,kBAAiB;AACf,wBAAoB,MAAM;MACzB,EAAE;;IAUX,CAAC,gBAAgB,CAClB;AAED,QAAO;EAEL;EACA;EACA;EACA;EACA;EACA;EACA;EAEA,GAAG;EACJ"}

package/dist/hooks/useWatchUserChange/index.cjs

@@ -1,8 +1,8 @@
-const require_useWatchUserChange = require('../../useWatchUserChange-C1Kluht2.cjs');
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_useWatchUserChange = require("../../useWatchUserChange-DkZ0Vqv3.cjs");
 //#region src/hooks/useWatchUserChange/index.ts
 /* v8 ignore stop */
-
 //#endregion
 exports.useWatchUserChange = require_useWatchUserChange.useWatchUserChange;
+
 //# sourceMappingURL=index.cjs.map

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

@@ -1,2 +1,2 @@
-import { n as useWatchUserChange, t as UseWatchUserChangeOptions } from "../../useWatchUserChange-DedTNvGV.cjs";
+import { n as useWatchUserChange, t as UseWatchUserChangeOptions } from "../../useWatchUserChange-CZu_ZZ38.cjs";
 export { UseWatchUserChangeOptions, useWatchUserChange };

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

@@ -1,2 +1,2 @@
-import { n as useWatchUserChange, t as UseWatchUserChangeOptions } from "../../useWatchUserChange-CYd_8zeN.js";
+import { n as useWatchUserChange, t as UseWatchUserChangeOptions } from "../../useWatchUserChange-CH4x16_r.js";
 export { UseWatchUserChangeOptions, useWatchUserChange };

package/dist/hooks/useWatchUserChange/index.js

@@ -1,8 +1,7 @@
-import { t as useWatchUserChange } from "../../useWatchUserChange-Dj9Imxfi.js";
-
+import { t as useWatchUserChange } from "../../useWatchUserChange-CLgLc5W4.js";
 //#region src/hooks/useWatchUserChange/index.ts
 /* v8 ignore stop */
-
 //#endregion
 export { useWatchUserChange };
+
 //# sourceMappingURL=index.js.map

package/dist/{index-C6iTO4TR.d.cts → index-1Gzrph8R.d.cts}

@@ -1,33 +1,32 @@
-import * as tailwind_variants170 from "tailwind-variants";
-import * as react_jsx_runtime13 from "react/jsx-runtime";
+import { n as ClassNameValue, t as TVReturnType } from "./index-DsC0y6kU.cjs";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 import { TVClassName, TVProps } from "@fuf-stack/pixel-utils";
 import { ReactNode } from "react";
-
 //#region src/RadioBoxes/RadioBoxes.d.ts
-declare const radioBoxesVariants: tailwind_variants170.TVReturnType<{
+declare const radioBoxesVariants: TVReturnType<{
   [key: string]: {
-    [key: string]: tailwind_variants170.ClassValue | {
-      base?: tailwind_variants170.ClassValue;
-      label?: tailwind_variants170.ClassValue;
-      wrapper?: tailwind_variants170.ClassValue;
-      boxBase?: tailwind_variants170.ClassValue;
-      boxControl?: tailwind_variants170.ClassValue;
-      boxDescription?: tailwind_variants170.ClassValue;
-      boxLabel?: tailwind_variants170.ClassValue;
-      boxLabelWrapper?: tailwind_variants170.ClassValue;
+    [key: string]: ClassNameValue | {
+      base?: ClassNameValue;
+      label?: ClassNameValue;
+      wrapper?: ClassNameValue;
+      boxBase?: ClassNameValue;
+      boxControl?: ClassNameValue;
+      boxDescription?: ClassNameValue;
+      boxLabel?: ClassNameValue;
+      boxLabelWrapper?: ClassNameValue;
     };
   };
 } | {
   [x: string]: {
-    [x: string]: tailwind_variants170.ClassValue | {
-      base?: tailwind_variants170.ClassValue;
-      label?: tailwind_variants170.ClassValue;
-      wrapper?: tailwind_variants170.ClassValue;
-      boxBase?: tailwind_variants170.ClassValue;
-      boxControl?: tailwind_variants170.ClassValue;
-      boxDescription?: tailwind_variants170.ClassValue;
-      boxLabel?: tailwind_variants170.ClassValue;
-      boxLabelWrapper?: tailwind_variants170.ClassValue;
+    [x: string]: ClassNameValue | {
+      base?: ClassNameValue;
+      label?: ClassNameValue;
+      wrapper?: ClassNameValue;
+      boxBase?: ClassNameValue;
+      boxControl?: ClassNameValue;
+      boxDescription?: ClassNameValue;
+      boxLabel?: ClassNameValue;
+      boxLabelWrapper?: ClassNameValue;
     };
   };
 } | {}, {
@@ -41,15 +40,15 @@ declare const radioBoxesVariants: tailwind_variants170.TVReturnType<{
   wrapper: string;
 }, undefined, {
   [key: string]: {
-    [key: string]: tailwind_variants170.ClassValue | {
-      base?: tailwind_variants170.ClassValue;
-      label?: tailwind_variants170.ClassValue;
-      wrapper?: tailwind_variants170.ClassValue;
-      boxBase?: tailwind_variants170.ClassValue;
-      boxControl?: tailwind_variants170.ClassValue;
-      boxDescription?: tailwind_variants170.ClassValue;
-      boxLabel?: tailwind_variants170.ClassValue;
-      boxLabelWrapper?: tailwind_variants170.ClassValue;
+    [key: string]: ClassNameValue | {
+      base?: ClassNameValue;
+      label?: ClassNameValue;
+      wrapper?: ClassNameValue;
+      boxBase?: ClassNameValue;
+      boxControl?: ClassNameValue;
+      boxDescription?: ClassNameValue;
+      boxLabel?: ClassNameValue;
+      boxLabelWrapper?: ClassNameValue;
     };
   };
 } | {}, {
@@ -61,7 +60,7 @@ declare const radioBoxesVariants: tailwind_variants170.TVReturnType<{
   boxLabelWrapper: string;
   label: string;
   wrapper: string;
-}, tailwind_variants170.TVReturnType<unknown, {
+}, TVReturnType<unknown, {
   base: string;
   boxBase: string;
   boxControl: string;
@@ -114,10 +113,10 @@ declare const RadioBoxes: ({
   name,
   options,
   ...uniformFieldProps
-}: RadioBoxesProps) => react_jsx_runtime13.JSX.Element;
+}: RadioBoxesProps) => _$react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/RadioBoxes/RadioBox.d.ts
-declare const radioBoxVariants: tailwind_variants170.TVReturnType<{
+declare const radioBoxVariants: TVReturnType<{
   isDisabled: {
     true: {
       base: string;
@@ -153,7 +152,7 @@ declare const radioBoxVariants: tailwind_variants170.TVReturnType<{
   icon: string;
   label: string;
   labelWrapper: string;
-}, tailwind_variants170.TVReturnType<{
+}, TVReturnType<{
   isDisabled: {
     true: {
       base: string;
@@ -174,4 +173,4 @@ declare const radioBoxVariants: tailwind_variants170.TVReturnType<{
 }, undefined, unknown, unknown, undefined>>;
 //#endregion
 export { RadioBoxes as n, RadioBoxesProps as r, radioBoxVariants as t };
-//# sourceMappingURL=index-C6iTO4TR.d.cts.map
+//# sourceMappingURL=index-1Gzrph8R.d.cts.map

package/dist/index-1Gzrph8R.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-1Gzrph8R.d.cts","names":[],"sources":["../src/RadioBoxes/RadioBoxes.tsx","../src/RadioBoxes/RadioBox.tsx"],"mappings":";;;;;cAaa,kBAAA;;mBAcX,cAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAEG,YAAA,GAAe,OAAA,QAAe,kBAAA;AAAA,KAC9B,SAAA,GAAY,WAAA,QAAmB,kBAAA;AAAA,UAEnB,gBAAA;;EAEf,WAAA,GAAc,SAAA;;EAEd,QAAA;;EAEA,KAAA,GAAQ,SAAA;;EAER,IAAA,GAAO,SAAA;;EAEP,MAAA;;EAEA,KAAA;AAAA;AAAA,UAGe,eAAA,SAAwB,YAAA;;EAEvC,SAAA;;EAEA,SAAA,GAAY,SAAA;;EAEZ,QAAA;;EAEA,MAAA;;EAEA,KAAA,GAAQ,SAAA;;EAER,IAAA;;EAEA,OAAA,EAAS,gBAAA;;EAET,MAAA;AAAA;;;;cAMI,UAAA;EAAc,SAAA;EAAA,MAAA;EAAA,IAAA;EAAA,OAAA;EAAA,GAAA;AAAA,GAMjB,eAAA,KAAe,oBAAA,CAAA,GAAA,CAAA,OAAA;;;cClEL,gBAAA,EAqBX,YAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAA,YAAA"}

package/dist/index-B0Fw1BAy.d.cts

@@ -0,0 +1,278 @@
+import { n as ClassNameValue, t as TVReturnType } from "./index-DsC0y6kU.cjs";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+import { TVClassName, TVProps } from "@fuf-stack/pixel-utils";
+import { ReactNode } from "react";
+import { Props } from "react-select";
+
+//#region src/Select/Select.d.ts
+declare const selectVariants: TVReturnType<{
+  [key: string]: {
+    [key: string]: ClassNameValue | {
+      base?: ClassNameValue;
+      label?: ClassNameValue;
+      control?: ClassNameValue;
+      input?: ClassNameValue;
+      placeholder?: ClassNameValue;
+      menu?: ClassNameValue;
+      option?: ClassNameValue;
+      group?: ClassNameValue;
+      clearIndicator?: ClassNameValue;
+      control_focused?: ClassNameValue;
+      crossIcon?: ClassNameValue;
+      downChevron?: ClassNameValue;
+      dropdownIndicator?: ClassNameValue;
+      groupHeading?: ClassNameValue;
+      indicatorsContainer?: ClassNameValue;
+      indicatorSeparator?: ClassNameValue;
+      loadingIndicator?: ClassNameValue;
+      loadingMessage?: ClassNameValue;
+      menuList?: ClassNameValue;
+      menuPortal?: ClassNameValue;
+      multiValue?: ClassNameValue;
+      multiValueContainer?: ClassNameValue;
+      multiValueLabel?: ClassNameValue;
+      multiValueRemove?: ClassNameValue;
+      noOptionsMessage?: ClassNameValue;
+      option_focused?: ClassNameValue;
+      option_selected?: ClassNameValue;
+      selectContainer?: ClassNameValue;
+      singleValue?: ClassNameValue;
+      valueContainer?: ClassNameValue;
+    };
+  };
+} | {
+  [x: string]: {
+    [x: string]: ClassNameValue | {
+      base?: ClassNameValue;
+      label?: ClassNameValue;
+      control?: ClassNameValue;
+      input?: ClassNameValue;
+      placeholder?: ClassNameValue;
+      menu?: ClassNameValue;
+      option?: ClassNameValue;
+      group?: ClassNameValue;
+      clearIndicator?: ClassNameValue;
+      control_focused?: ClassNameValue;
+      crossIcon?: ClassNameValue;
+      downChevron?: ClassNameValue;
+      dropdownIndicator?: ClassNameValue;
+      groupHeading?: ClassNameValue;
+      indicatorsContainer?: ClassNameValue;
+      indicatorSeparator?: ClassNameValue;
+      loadingIndicator?: ClassNameValue;
+      loadingMessage?: ClassNameValue;
+      menuList?: ClassNameValue;
+      menuPortal?: ClassNameValue;
+      multiValue?: ClassNameValue;
+      multiValueContainer?: ClassNameValue;
+      multiValueLabel?: ClassNameValue;
+      multiValueRemove?: ClassNameValue;
+      noOptionsMessage?: ClassNameValue;
+      option_focused?: ClassNameValue;
+      option_selected?: ClassNameValue;
+      selectContainer?: ClassNameValue;
+      singleValue?: ClassNameValue;
+      valueContainer?: ClassNameValue;
+    };
+  };
+} | {}, {
+  base: string;
+  clearIndicator: string;
+  control: string;
+  control_focused: string;
+  crossIcon: string;
+  downChevron: string;
+  dropdownIndicator: string;
+  group: string;
+  groupHeading: string;
+  indicatorsContainer: string;
+  indicatorSeparator: string;
+  input: string;
+  label: string;
+  loadingIndicator: string;
+  loadingMessage: string;
+  menu: string;
+  menuList: string;
+  menuPortal: string;
+  multiValue: string;
+  multiValueContainer: string;
+  multiValueLabel: string;
+  multiValueRemove: string;
+  noOptionsMessage: string;
+  option_focused: string;
+  option_selected: string;
+  option: string;
+  placeholder: string;
+  selectContainer: string;
+  singleValue: string;
+  valueContainer: string;
+}, undefined, {
+  [key: string]: {
+    [key: string]: ClassNameValue | {
+      base?: ClassNameValue;
+      label?: ClassNameValue;
+      control?: ClassNameValue;
+      input?: ClassNameValue;
+      placeholder?: ClassNameValue;
+      menu?: ClassNameValue;
+      option?: ClassNameValue;
+      group?: ClassNameValue;
+      clearIndicator?: ClassNameValue;
+      control_focused?: ClassNameValue;
+      crossIcon?: ClassNameValue;
+      downChevron?: ClassNameValue;
+      dropdownIndicator?: ClassNameValue;
+      groupHeading?: ClassNameValue;
+      indicatorsContainer?: ClassNameValue;
+      indicatorSeparator?: ClassNameValue;
+      loadingIndicator?: ClassNameValue;
+      loadingMessage?: ClassNameValue;
+      menuList?: ClassNameValue;
+      menuPortal?: ClassNameValue;
+      multiValue?: ClassNameValue;
+      multiValueContainer?: ClassNameValue;
+      multiValueLabel?: ClassNameValue;
+      multiValueRemove?: ClassNameValue;
+      noOptionsMessage?: ClassNameValue;
+      option_focused?: ClassNameValue;
+      option_selected?: ClassNameValue;
+      selectContainer?: ClassNameValue;
+      singleValue?: ClassNameValue;
+      valueContainer?: ClassNameValue;
+    };
+  };
+} | {}, {
+  base: string;
+  clearIndicator: string;
+  control: string;
+  control_focused: string;
+  crossIcon: string;
+  downChevron: string;
+  dropdownIndicator: string;
+  group: string;
+  groupHeading: string;
+  indicatorsContainer: string;
+  indicatorSeparator: string;
+  input: string;
+  label: string;
+  loadingIndicator: string;
+  loadingMessage: string;
+  menu: string;
+  menuList: string;
+  menuPortal: string;
+  multiValue: string;
+  multiValueContainer: string;
+  multiValueLabel: string;
+  multiValueRemove: string;
+  noOptionsMessage: string;
+  option_focused: string;
+  option_selected: string;
+  option: string;
+  placeholder: string;
+  selectContainer: string;
+  singleValue: string;
+  valueContainer: string;
+}, TVReturnType<unknown, {
+  base: string;
+  clearIndicator: string;
+  control: string;
+  control_focused: string;
+  crossIcon: string;
+  downChevron: string;
+  dropdownIndicator: string;
+  group: string;
+  groupHeading: string;
+  indicatorsContainer: string;
+  indicatorSeparator: string;
+  input: string;
+  label: string;
+  loadingIndicator: string;
+  loadingMessage: string;
+  menu: string;
+  menuList: string;
+  menuPortal: string;
+  multiValue: string;
+  multiValueContainer: string;
+  multiValueLabel: string;
+  multiValueRemove: string;
+  noOptionsMessage: string;
+  option_focused: string;
+  option_selected: string;
+  option: string;
+  placeholder: string;
+  selectContainer: string;
+  singleValue: string;
+  valueContainer: string;
+}, undefined, unknown, unknown, undefined>>;
+interface SelectOption {
+  /**
+   * True when option was auto-generated because the value wasn't found in options.
+   * Use in renderOptionLabel to render a component that fetches the real label.
+   */
+  isFallback?: boolean;
+  /** option label */
+  label?: ReactNode;
+  /** option value */
+  value: string | number;
+}
+type VariantProps = TVProps<typeof selectVariants>;
+type ClassName = TVClassName<typeof selectVariants>;
+interface SelectProps extends VariantProps {
+  /** Custom aria-label for accessibility. If not provided, falls back to field name when no visible label exists */
+  ariaLabel?: string;
+  /** CSS class name */
+  className?: ClassName;
+  /** Determine if the  */
+  clearable?: boolean;
+  /** Set the select to disabled state. */
+  disabled?: boolean;
+  /** Filter Select Options */
+  filterOption?: undefined | ((option?: SelectOption, inputValue?: string) => boolean);
+  /** Format the label of the option */
+  renderOptionLabel?: undefined | Props['formatOptionLabel'];
+  /** The value of the search input */
+  inputValue?: string;
+  /** Label that should be associated with the select. */
+  label?: ReactNode;
+  /** Set the select to a loading state. */
+  loading?: boolean;
+  /** switch between single and multi select mode. */
+  multiSelect?: boolean;
+  /** The name for the Select component, used by react-hook-form */
+  name: string;
+  /** Placeholder that is displayed when nothing is selected */
+  placeholder?: string;
+  /** The options for the Select component */
+  options: SelectOption[];
+  /** Handle change events on the input */
+  onInputChange?: Props['onInputChange'];
+  /**
+   * Fallback option(s) for async selects when value isn't in current options.
+   * Use when the selected value may not be in the options list (e.g., after
+   * search results change). Used only if value not found in options.
+   * For single select: pass the option object or undefined
+   * For multi-select: pass an array of option objects
+   */
+  selectedOptionFallback?: SelectOption | SelectOption[];
+  /** HTML data-testid attribute used in e2e tests */
+  testId?: string;
+}
+/** Select component based on [HeroUI Select](https://www.heroui.com//docs/components/select) and [React-Select](https://react-select.com/home) */
+declare const Select: ({
+  className,
+  clearable,
+  filterOption,
+  renderOptionLabel,
+  inputValue,
+  loading,
+  multiSelect,
+  name,
+  onInputChange,
+  options,
+  placeholder,
+  selectedOptionFallback,
+  ...uniformFieldProps
+}: SelectProps) => _$react_jsx_runtime0.JSX.Element;
+//#endregion
+export { SelectProps as n, Select as t };
+//# sourceMappingURL=index-B0Fw1BAy.d.cts.map