@fuf-stack/uniform 1.5.3 → 1.5.5

package/dist/{chunk-CROGVLLB.js → chunk-ZQQUG4OK.js}

@@ -2,10 +2,9 @@ import {
   Grid_default
 } from "./chunk-B62HKKMS.js";
 import {
-  useFieldArray,
-  useFormContext,
-  useUniformField
-} from "./chunk-Y6NHIZ2M.js";
+  useUniformField,
+  useUniformFieldArray
+} from "./chunk-WVTLXBTO.js";
 import {
   FieldValidationError_default
 } from "./chunk-ELYGQTXB.js";
@@ -19,8 +18,6 @@ import {
 } from "./chunk-K2V4ULA2.js";
 
 // src/FieldArray/FieldArray.tsx
-import { useEffect, useRef } from "react";
-import { useReducedMotion as useReducedMotion2 } from "@fuf-stack/pixel-motion";
 import { cn as cn8, tv, variantsToClassNames } from "@fuf-stack/pixel-utils";
 
 // src/FieldArray/subcomponents/ElementAppendButton.tsx
@@ -56,7 +53,7 @@ var ElementAppendButton_default = ElementAppendButton;
 import { useState } from "react";
 import { useSortable as useSortable2 } from "@dnd-kit/sortable";
 import { CSS } from "@dnd-kit/utilities";
-import { AnimatePresence, motion } from "@fuf-stack/pixel-motion";
+import { AnimatePresence, motion as motion2 } from "@fuf-stack/pixel-motion";
 import { cn as cn5 } from "@fuf-stack/pixel-utils";
 
 // src/FieldArray/subcomponents/ElementActionsMenu.tsx
@@ -132,15 +129,17 @@ var ElementActionsMenu_default = ElementActionsMenu;
 
 // src/FieldArray/subcomponents/ElementRemoveButton.tsx
 import { FaTimes as FaTimes2 } from "react-icons/fa";
+import { motion } from "@fuf-stack/pixel-motion";
 import { cn as cn3 } from "@fuf-stack/pixel-utils";
 import { Button as Button2 } from "@fuf-stack/pixels";
 import { jsx as jsx3 } from "react/jsx-runtime";
 var ElementRemoveButton = ({
   className = void 0,
+  disableAnimation = false,
   onClick,
   testId = void 0
 }) => {
-  return /* @__PURE__ */ jsx3(
+  const button = /* @__PURE__ */ jsx3(
     Button2,
     {
       ariaLabel: "remove element",
@@ -153,6 +152,20 @@ var ElementRemoveButton = ({
       variant: "light"
     }
   );
+  if (disableAnimation) {
+    return button;
+  }
+  return /* @__PURE__ */ jsx3(
+    motion.div,
+    {
+      animate: { opacity: 1, width: "auto" },
+      className: "flex",
+      exit: { opacity: 0, width: 0 },
+      initial: { opacity: 0, width: 0 },
+      transition: { duration: 0.2 },
+      children: button
+    }
+  );
 };
 var ElementRemoveButton_default = ElementRemoveButton;
 
@@ -231,7 +244,7 @@ var FieldArrayElement = ({
         methods.remove();
       },
       children: isVisible ? /* @__PURE__ */ jsx5(
-        motion.li,
+        motion2.li,
         {
           ref: setNodeRef,
           animate: disableAnimation ? void 0 : "visible",
@@ -277,10 +290,11 @@ var FieldArrayElement = ({
                   }
                 })
               }
-            ) : /* @__PURE__ */ jsx5(Fragment, { children: lastNotDeletable && fields.length === 1 ? null : /* @__PURE__ */ jsx5(
+            ) : /* @__PURE__ */ jsx5(Fragment, { children: /* @__PURE__ */ jsx5(AnimatePresence, { initial: false, children: lastNotDeletable && fields.length === 1 ? null : /* @__PURE__ */ jsx5(
               ElementRemoveButton_default,
               {
                 className: className.removeButton,
+                disableAnimation,
                 testId: `${testId}_remove_button`,
                 onClick: () => {
                   if (disableAnimation) {
@@ -289,8 +303,9 @@ var FieldArrayElement = ({
                     setIsVisible(false);
                   }
                 }
-              }
-            ) })
+              },
+              "remove-button"
+            ) }) })
           ] })
         },
         id
@@ -336,7 +351,7 @@ var FieldArrayLabel_default = FieldArrayLabel;
 // src/FieldArray/subcomponents/FieldArrayValidationError.tsx
 import {
   AnimatePresence as AnimatePresence2,
-  motion as motion2,
+  motion as motion3,
   useReducedMotion
 } from "@fuf-stack/pixel-motion";
 import { cn as cn7 } from "@fuf-stack/pixel-utils";
@@ -358,7 +373,7 @@ var FieldArrayValidationError = ({
   const disableAnimation = useReducedMotion();
   const hasErrors = invalid && (error == null ? void 0 : error._errors);
   return /* @__PURE__ */ jsx7(AnimatePresence2, { initial: !disableAnimation, children: hasErrors ? /* @__PURE__ */ jsx7(
-    motion2.div,
+    motion3.div,
     {
       exit: disableAnimation ? void 0 : { opacity: 0, height: 0 },
       initial: disableAnimation ? false : { height: 0, opacity: 0 },
@@ -370,8 +385,8 @@ var FieldArrayValidationError = ({
         __spreadProps(__spreadValues({}, getHelperWrapperProps()), {
           className: cn7(
             (_a = getHelperWrapperProps()) == null ? void 0 : _a.className,
-            // force helper to be visible (for some reason it's hidden by default) and add padding/rounded corners
-            "block rounded-b-small px-3 py-2"
+            // force helper to be visible (for some reason it's hidden by default) and add padding
+            "block px-3 py-2"
           ),
           children: /* @__PURE__ */ jsx7("div", __spreadProps(__spreadValues({}, getErrorMessageProps()), { children: /* @__PURE__ */ jsx7(
             FieldValidationError_default,
@@ -389,7 +404,7 @@ var FieldArrayValidationError = ({
 var FieldArrayValidationError_default = FieldArrayValidationError;
 
 // src/FieldArray/subcomponents/SortContext.tsx
-import { useFormContext as useFormContext2 } from "react-hook-form";
+import { useFormContext } from "react-hook-form";
 import {
   closestCenter,
   DndContext,
@@ -414,7 +429,7 @@ var SortContext = ({
   name,
   sortable
 }) => {
-  const { trigger } = useFormContext2();
+  const { trigger } = useFormContext();
   const sensors = useSensors(
     useSensor(PointerSensor),
     useSensor(KeyboardSensor)
@@ -480,7 +495,7 @@ var fieldArrayVariants = tv({
     /** class for the append button */
     appendButton: [
       // base styles
-      "w-full rounded-b-small rounded-t-none",
+      "w-full justify-start rounded-b-small rounded-t-none font-semibold",
       // match label height (p-3 = 12px vertical padding + text-base line height)
       "!h-[48px] !min-h-0",
       // focus styles - inset ring with rounded bottom corners to match container
@@ -573,38 +588,23 @@ var FieldArray = (_a) => {
     "name",
     "sortable"
   ]);
-  const { control, error, getValues, invalid, testId } = useUniformField(__spreadValues({
+  const {
+    fields,
+    append,
+    remove,
+    insert,
+    move,
+    disableAnimation,
+    elementInitialValue,
+    getValues,
+    testId
+  } = useUniformFieldArray(__spreadValues({
     name,
+    flat,
+    elementInitialValue: _elementInitialValue,
+    lastElementNotRemovable,
     showInvalidWhen: "immediate"
   }, uniformFieldProps));
-  const { fields, append, remove, insert, move } = useFieldArray({
-    control,
-    name
-  });
-  const { trigger, setValue } = useFormContext();
-  useEffect(() => {
-    setTimeout(() => {
-      trigger(name);
-    }, 200);
-  }, [fields.length]);
-  const elementInitialValue = flat ? { [flatArrayKey]: _elementInitialValue != null ? _elementInitialValue : null } : _elementInitialValue != null ? _elementInitialValue : {};
-  useEffect(
-    () => {
-      if (lastElementNotRemovable && fields.length === 0) {
-        setValue(name, [elementInitialValue]);
-      }
-    },
-    // only run once when the component mounts
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    []
-  );
-  const prefersReducedMotion = useReducedMotion2();
-  const disableAnimationRef = useRef(true);
-  useEffect(() => {
-    if (!prefersReducedMotion) {
-      disableAnimationRef.current = false;
-    }
-  }, [prefersReducedMotion]);
   const variants = fieldArrayVariants({ hasLabel: !!uniformFieldProps.label });
   const className = variantsToClassNames(variants, _className, "base");
   return /* @__PURE__ */ jsxs3("div", { className: className.base, children: [
@@ -649,7 +649,7 @@ var FieldArray = (_a) => {
               FieldArrayElement_default,
               {
                 className,
-                disableAnimation: disableAnimationRef.current,
+                disableAnimation,
                 duplicate,
                 elementMarginBottom,
                 fields,
@@ -674,23 +674,18 @@ var FieldArray = (_a) => {
         }
       ) })
     ) : null,
+    /* @__PURE__ */ jsx9(FieldArrayValidationError_default, { name }),
     /* @__PURE__ */ jsx9(
       ElementAppendButton_default,
       {
         appendButtonText,
+        className: className.appendButton,
         testId: `${testId}_append_button`,
-        className: cn8(
-          className.appendButton,
-          // only round bottom corners if there are no errors below
-          // @ts-expect-error - error._errors exists but not typed
-          { "rounded-none": invalid && (error == null ? void 0 : error._errors) }
-        ),
         onClick: () => {
           append(elementInitialValue);
         }
       }
-    ),
-    /* @__PURE__ */ jsx9(FieldArrayValidationError_default, { name })
+    )
   ] });
 };
 var FieldArray_default = FieldArray;
@@ -702,4 +697,4 @@ export {
   FieldArray_default,
   FieldArray_default2
 };
-//# sourceMappingURL=chunk-CROGVLLB.js.map
+//# sourceMappingURL=chunk-ZQQUG4OK.js.map

package/dist/chunk-ZQQUG4OK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/FieldArray/FieldArray.tsx","../src/FieldArray/subcomponents/ElementAppendButton.tsx","../src/FieldArray/subcomponents/FieldArrayElement.tsx","../src/FieldArray/subcomponents/ElementActionsMenu.tsx","../src/FieldArray/subcomponents/ElementRemoveButton.tsx","../src/FieldArray/subcomponents/SortDragHandle.tsx","../src/FieldArray/subcomponents/FieldArrayLabel.tsx","../src/FieldArray/subcomponents/FieldArrayValidationError.tsx","../src/FieldArray/subcomponents/SortContext.tsx","../src/FieldArray/index.ts"],"sourcesContent":["import type { FieldArrayElementMethods } from './subcomponents/FieldArrayElement';\nimport type { FieldArrayProps } from './types';\n\nimport { cn, tv, variantsToClassNames } from '@fuf-stack/pixel-utils';\n\nimport { flatArrayKey } from '../helpers';\nimport { useUniformFieldArray } from '../hooks/useUniformFieldArray/useUniformFieldArray';\nimport ElementAppendButton from './subcomponents/ElementAppendButton';\nimport FieldArrayElement from './subcomponents/FieldArrayElement';\nimport FieldArrayLabel from './subcomponents/FieldArrayLabel';\nimport FieldArrayValidationError from './subcomponents/FieldArrayValidationError';\nimport SortContext from './subcomponents/SortContext';\n\nexport const fieldArrayVariants = tv({\n  slots: {\n    /** base class for the field array wrapper */\n    base: [\n      // base styles\n      'overflow-hidden rounded-small border border-divider bg-content1',\n      // divider between items\n      'divide-y divide-divider',\n    ],\n    /** class for the actions menu button */\n    actionsMenuButton: [\n      // base styles\n      'flex items-center justify-center text-default-600',\n      // fixed height/no round corners/center align\n      'h-full rounded-none',\n      // focus styles - inset ring\n      'outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-focus',\n    ],\n    /** class for the append button */\n    appendButton: [\n      // base styles\n      'w-full justify-start rounded-b-small rounded-t-none font-semibold',\n      // match label height (p-3 = 12px vertical padding + text-base line height)\n      '!h-[48px] !min-h-0',\n      // focus styles - inset ring with rounded bottom corners to match container\n      'outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-focus',\n    ],\n    /** class for the element fields grid */\n    elementFieldsGrid: ['w-full grow p-3'],\n    /** class for the label */\n    label: [\n      // override HeroUI label positioning and display\n      'pointer-events-auto! static! z-auto! block! w-full!',\n      // reset any transforms or translations\n      'translate-x-0! translate-y-0! transform-none!',\n      // card header styling - use text-medium (16px) instead of text-base for correct 48px height\n      'rounded-t-small p-3 font-semibold text-medium',\n    ],\n    /** class for the list */\n    list: ['overflow-hidden'],\n    /** class for the list wrapper */\n    listWrapper: ['overflow-hidden'],\n    /** class for the list item (performs motion animations) */\n    listItem: [\n      // base styles\n      'group relative flex flex-row',\n      // overlap borders by shifting first item up 1px (similar to how last item overlaps with append button)\n      'first:-mt-px',\n    ],\n    /** class for the list item inner */\n    listItemInner: [\n      // base styles\n      'flex w-full flex-row items-stretch divide-divider bg-content1',\n      // x division and borders\n      'divide-x divide-solid border-b border-t border-divider',\n    ],\n    /** class for the remove button */\n    removeButton: [\n      // base styles\n      'flex items-center justify-center',\n      // fixed height/no round corners\n      '!h-full !min-h-0 !rounded-none px-3',\n      // focus styles - inset ring\n      'outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-focus',\n    ],\n    /** class for the sort drag handle */\n    sortDragHandle: [\n      // base styles\n      'flex cursor-grab items-center justify-center px-2 text-default-600 transition-colors',\n      // hover and  dragging state\n      'hover:bg-default-100 active:cursor-grabbing group-data-[dragging=true]:bg-default-100',\n      // focus styles - inset ring\n      'outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-focus',\n    ],\n  },\n  variants: {\n    hasLabel: {\n      false: {\n        // focus styles - when there is no label, the first item actions menu button should have rounded top right corners\n        actionsMenuButton:\n          'group-[:first-child]:!rounded-tr-small group-[:first-child]:group-data-[dragging=true]:!rounded-tr-none',\n        // focus styles - when there is no label, the first item remove button focus ring should have rounded top right corners\n        removeButton:\n          'group-[:first-child]:!rounded-tr-small group-[:first-child]:group-data-[dragging=true]:!rounded-tr-none',\n        // focus styles - when there is no label, the first item sort drag handle focus ring should have rounded top left corners\n        sortDragHandle:\n          'group-[:first-child]:rounded-tl-small group-[:first-child]:group-data-[dragging=true]:rounded-tl-none',\n      },\n    },\n  },\n});\n\n/**\n * FieldArray component based in [RHF useFieldArray](https://react-hook-form.com/docs/usefieldarray)\n */\nconst FieldArray = ({\n  appendButtonText = 'Add Element',\n  children,\n  className: _className = undefined,\n  duplicate = false,\n  elementInitialValue: _elementInitialValue = null,\n  elementMarginBottom = undefined,\n  flat = false,\n  insertAfter = false,\n  lastElementNotRemovable = false,\n  name,\n  sortable = false,\n  ...uniformFieldProps\n}: FieldArrayProps) => {\n  const {\n    fields,\n    append,\n    remove,\n    insert,\n    move,\n    disableAnimation,\n    elementInitialValue,\n    getValues,\n    testId,\n  } = useUniformFieldArray({\n    name,\n    flat,\n    elementInitialValue: _elementInitialValue,\n    lastElementNotRemovable,\n    showInvalidWhen: 'immediate',\n    ...uniformFieldProps,\n  });\n\n  // className from slots\n  const variants = fieldArrayVariants({ hasLabel: !!uniformFieldProps.label });\n  const className = variantsToClassNames(variants, _className, 'base');\n\n  return (\n    <div className={className.base}>\n      {/* field array label */}\n      <FieldArrayLabel\n        className={className.label}\n        label={uniformFieldProps.label}\n        name={name}\n      />\n\n      {fields.length ? (\n        /* list wrapper */\n        <div className={cn(className.listWrapper)}>\n          {/* sortable context */}\n          <SortContext\n            fields={fields}\n            move={move}\n            name={name}\n            sortable={sortable}\n          >\n            {/* list container */}\n            <ul className={className.list} data-testid={testId}>\n              {/* fields / list elements  */}\n              {fields.map((field, index) => {\n                const elementName = flat\n                  ? `${name}.${index}.${flatArrayKey}`\n                  : `${name}.${index}`;\n                const elementTestId = `${testId}_${index}`;\n\n                // create methods for element\n                const elementMethods: FieldArrayElementMethods = {\n                  append: () => {\n                    append(elementInitialValue);\n                  },\n                  duplicate: () => {\n                    const values = getValues(name);\n                    const currentValue = (values as unknown[])[index];\n                    const nextValue = flat\n                      ? { [flatArrayKey]: currentValue }\n                      : currentValue;\n                    insert(index + 1, nextValue);\n                  },\n                  insert: () => {\n                    insert(index + 1, elementInitialValue);\n                  },\n                  remove: () => {\n                    remove(index);\n                  },\n                };\n\n                return (\n                  <FieldArrayElement\n                    key={field.id}\n                    className={className}\n                    disableAnimation={disableAnimation}\n                    duplicate={duplicate}\n                    elementMarginBottom={elementMarginBottom}\n                    fields={fields}\n                    id={field.id}\n                    index={index}\n                    insertAfter={insertAfter}\n                    lastNotDeletable={lastElementNotRemovable}\n                    methods={elementMethods}\n                    sortable={sortable}\n                    testId={elementTestId}\n                  >\n                    {children({\n                      index,\n                      length: fields.length,\n                      methods: elementMethods,\n                      name: elementName,\n                      testId: elementTestId,\n                    })}\n                  </FieldArrayElement>\n                );\n              })}\n            </ul>\n          </SortContext>\n        </div>\n      ) : null}\n\n      {/* top level field array errors */}\n      <FieldArrayValidationError name={name} />\n\n      {/* append elements button */}\n      <ElementAppendButton\n        appendButtonText={appendButtonText}\n        className={className.appendButton}\n        testId={`${testId}_append_button`}\n        onClick={() => {\n          append(elementInitialValue);\n        }}\n      />\n    </div>\n  );\n};\n\nexport default FieldArray;\n","import type { ClassValue } from '@fuf-stack/pixel-utils';\n\nimport { FaPlus } from 'react-icons/fa';\n\nimport { cn } from '@fuf-stack/pixel-utils';\nimport { Button } from '@fuf-stack/pixels';\n\ninterface ElementAppendButtonProps {\n  /** text of the append element button */\n  appendButtonText?: string;\n  /** CSS class name */\n  className?: ClassValue;\n  /** click handler */\n  onClick: () => void;\n  /** HTML data-testid attribute used in e2e tests */\n  testId?: string;\n}\n\nconst ElementAppendButton = ({\n  appendButtonText = 'Add Element',\n  className = undefined,\n  onClick,\n  testId = undefined,\n}: ElementAppendButtonProps) => {\n  return (\n    <Button\n      disableAnimation\n      className={cn(className)}\n      onClick={onClick}\n      size=\"sm\"\n      testId={testId}\n      variant=\"light\"\n    >\n      <FaPlus />\n      <span>{appendButtonText}</span>\n    </Button>\n  );\n};\n\nexport default ElementAppendButton;\n","import type { Variants as MotionVariants } from '@fuf-stack/pixel-motion';\nimport type { ClassValue } from '@fuf-stack/pixel-utils';\nimport type { FieldArrayFeatures } from '../types';\n\nimport { useState } from 'react';\n\nimport { useSortable } from '@dnd-kit/sortable';\nimport { CSS } from '@dnd-kit/utilities';\n\nimport { AnimatePresence, motion } from '@fuf-stack/pixel-motion';\nimport { cn } from '@fuf-stack/pixel-utils';\n\nimport { Grid } from '../../Grid';\nimport ElementActionsMenu from './ElementActionsMenu';\nimport ElementRemoveButton from './ElementRemoveButton';\nimport SortDragHandle from './SortDragHandle';\n\nexport interface FieldArrayElementMethods {\n  /** Add new element at end */\n  append: () => void;\n  /** Clone current element */\n  duplicate: () => void;\n  /** Add new element after current */\n  insert: () => void;\n  /** Remove current element */\n  remove: () => void;\n}\n\ninterface FieldArrayElementProps extends FieldArrayFeatures {\n  /** Form elements to render inside array element */\n  children: React.ReactNode;\n  /** CSS class names for component parts */\n  className: {\n    /** Class of wrapper grid inside the li that wraps the rendered element fields directly */\n    elementFieldsGrid?: ClassValue;\n    /** Class for the li (performs motion animations) */\n    listItem?: ClassValue;\n    /** Class for the li inner div (wraps the rendered element fields) */\n    listItemInner?: ClassValue;\n    /** Class for the actions menu button */\n    actionsMenuButton?: ClassValue;\n    /** Class for the remove element button (when menu is not used) */\n    removeButton?: ClassValue;\n    /** Class for the drag handle when sorting enabled */\n    sortDragHandle?: ClassValue;\n  };\n  /** Globally disable animations for this item (used for first render or prefers-reduced-motion) */\n  disableAnimation?: boolean;\n  /** Bottom margin for elements (for backwards compatibility) */\n  elementMarginBottom?: React.CSSProperties['marginBottom'];\n  /** All fields in the form array */\n  fields: Record<'id', string>[];\n  /** Unique identifier for drag/drop */\n  id: string | number;\n  /** Field index in array */\n  index: number;\n  /** Prevent deletion of last remaining element */\n  lastNotDeletable?: boolean;\n  /** Field array operation methods */\n  methods: FieldArrayElementMethods;\n  /** HTML data-testid of the element */\n  testId?: string;\n}\n\n/**\n * Form array element component using react-hook-form with drag-drop sorting\n * and validation capabilities. Animations when elements are added or removed\n * improve the user experience and provide a better visual feedback.\n */\nconst FieldArrayElement = ({\n  children,\n  className,\n  disableAnimation = false,\n  duplicate = false,\n  elementMarginBottom: _elementMarginBottom = undefined,\n  fields,\n  id,\n  index: _index,\n  insertAfter = false,\n  lastNotDeletable = true,\n  methods,\n  sortable = false,\n  testId = undefined,\n}: FieldArrayElementProps) => {\n  // Apply transform styles when sortable is enabled for smooth drag animations\n  // transform: handles the item's position during drag\n  // transition: controls the animation timing when dropping\n  const { setNodeRef, transform, transition, isDragging } = useSortable({ id });\n  const sortingStyle = sortable\n    ? {\n        transform: CSS.Translate.toString(transform),\n        transition,\n        zIndex: isDragging ? 50 : undefined,\n      }\n    : undefined;\n\n  // Local visibility to allow exit animation before removing from RHF state\n  const [isVisible, setIsVisible] = useState(true);\n\n  // Motion variants for the list item\n  const listItemMotionVariants: MotionVariants = {\n    hidden: { opacity: 0, height: 0, marginBottom: 0 },\n    visible: {\n      opacity: 1,\n      height: 'auto',\n      transition: { duration: 0.2, ease: 'circOut' },\n      // push last visible item down to overlap with append button (hide double border)\n      marginBottom: '-1px',\n    },\n    exit: {\n      opacity: 0,\n      height: 0,\n      marginBottom: 0,\n      transition: {\n        // on exit first fade out, then shrink\n        opacity: { duration: 0.1, ease: 'circOut' },\n        height: { delay: 0.1, duration: 0.2, ease: 'circOut' },\n      },\n    },\n  };\n\n  // Height animation handled on <motion.li> using overflow hidden\n  return (\n    <AnimatePresence\n      mode=\"wait\"\n      // remove from RHF state after exit animation\n      onExitComplete={() => {\n        methods.remove();\n      }}\n    >\n      {isVisible ? (\n        <motion.li\n          key={id}\n          ref={setNodeRef}\n          animate={disableAnimation ? undefined : 'visible'}\n          className={cn(className.listItem)}\n          data-dragging={isDragging}\n          data-testid={`${testId}_element`}\n          exit={disableAnimation ? undefined : 'exit'}\n          initial={disableAnimation ? false : 'hidden'}\n          style={sortingStyle}\n          variants={disableAnimation ? undefined : listItemMotionVariants}\n        >\n          <div className={cn(className.listItemInner)}>\n            {/** sorting drag handle */}\n            {sortable ? (\n              <SortDragHandle\n                className={className.sortDragHandle}\n                id={id}\n                testId={`${testId}_sort_drag_handle`}\n              />\n            ) : null}\n\n            {/** render element fields in Grid component */}\n            <Grid\n              className={cn(className.elementFieldsGrid)}\n              testId={`${testId}_element_fields_grid`}\n            >\n              {/* render actual fields */}\n              {children}\n            </Grid>\n\n            {/** actions menu when duplicate or insertAfter is enabled */}\n            {duplicate || insertAfter ? (\n              <ElementActionsMenu\n                className={className.actionsMenuButton}\n                duplicate={duplicate}\n                insertAfter={insertAfter}\n                showRemove={!(lastNotDeletable && fields.length === 1)}\n                testId={`${testId}_actions_menu`}\n                methods={{\n                  ...methods,\n                  remove: () => {\n                    if (disableAnimation) {\n                      methods.remove();\n                    } else {\n                      setIsVisible(false);\n                    }\n                  },\n                }}\n              />\n            ) : (\n              <>\n                {/** remove element button (when menu is not used) */}\n                <AnimatePresence initial={false}>\n                  {lastNotDeletable && fields.length === 1 ? null : (\n                    <ElementRemoveButton\n                      key=\"remove-button\"\n                      className={className.removeButton}\n                      disableAnimation={disableAnimation}\n                      testId={`${testId}_remove_button`}\n                      onClick={() => {\n                        if (disableAnimation) {\n                          methods.remove();\n                        } else {\n                          setIsVisible(false);\n                        }\n                      }}\n                    />\n                  )}\n                </AnimatePresence>\n              </>\n            )}\n          </div>\n        </motion.li>\n      ) : null}\n    </AnimatePresence>\n  );\n};\n\nexport default FieldArrayElement;\n","import type { ClassValue } from '@fuf-stack/pixel-utils';\nimport type { MenuItem } from '@fuf-stack/pixels';\nimport type { Key } from 'react';\nimport type { FieldArrayElementMethods } from './FieldArrayElement';\n\nimport { FaCopy, FaTimes } from 'react-icons/fa';\nimport { VscInsert } from 'react-icons/vsc';\n\nimport { cn } from '@fuf-stack/pixel-utils';\nimport { Menu } from '@fuf-stack/pixels';\n\nexport interface ElementActionsMenuProps {\n  /** CSS class name */\n  className?: ClassValue;\n  /** Whether duplicate action is available */\n  duplicate?: boolean;\n  /** Whether insert after action is available */\n  insertAfter?: boolean;\n  /** Whether to show remove button (false when last element is not deletable) */\n  showRemove?: boolean;\n  /** Field array operation methods */\n  methods: FieldArrayElementMethods;\n  /** HTML data-testid attribute used in e2e tests */\n  testId?: string;\n}\n\n/**\n * Menu component for field array element actions (remove, duplicate, insert after)\n */\nconst ElementActionsMenu = ({\n  className = undefined,\n  duplicate = false,\n  insertAfter = false,\n  showRemove = true,\n  methods,\n  testId = undefined,\n}: ElementActionsMenuProps) => {\n  const handleAction = (key: Key) => {\n    switch (key) {\n      case 'remove':\n        methods.remove();\n        break;\n      case 'duplicate':\n        methods.duplicate();\n        break;\n      case 'insertAfter':\n        methods.insert();\n        break;\n      default:\n        break;\n    }\n  };\n\n  // Build menu items based on available actions\n  const menuItems: MenuItem[] = [];\n\n  if (duplicate) {\n    menuItems.push({\n      key: 'duplicate',\n      label: 'Duplicate',\n      icon: <FaCopy />,\n    });\n  }\n\n  if (insertAfter) {\n    menuItems.push({\n      key: 'insertAfter',\n      label: 'Insert After',\n      icon: <VscInsert />,\n    });\n  }\n\n  if (showRemove) {\n    menuItems.push({\n      key: 'remove',\n      className: 'text-danger',\n      label: 'Remove',\n      icon: <FaTimes />,\n    });\n  }\n\n  return (\n    <Menu\n      ariaLabel=\"Element actions\"\n      items={menuItems}\n      onAction={handleAction}\n      placement=\"right\"\n      testId={testId}\n      triggerButtonProps={{\n        className: cn(className),\n        disableRipple: true,\n        size: 'md',\n        variant: 'light',\n      }}\n    />\n  );\n};\n\nexport default ElementActionsMenu;\n","import type { ClassValue } from '@fuf-stack/pixel-utils';\n\nimport { FaTimes } from 'react-icons/fa';\n\nimport { motion } from '@fuf-stack/pixel-motion';\nimport { cn } from '@fuf-stack/pixel-utils';\nimport { Button } from '@fuf-stack/pixels';\n\ninterface ElementRemoveButtonProps {\n  /** CSS class name */\n  className?: ClassValue;\n  /** Globally disable animations (used for first render or prefers-reduced-motion) */\n  disableAnimation?: boolean;\n  /** click handler */\n  onClick: () => void;\n  /** HTML data-testid attribute used in e2e tests */\n  testId?: string;\n}\n\nconst ElementRemoveButton = ({\n  className = undefined,\n  disableAnimation = false,\n  onClick,\n  testId = undefined,\n}: ElementRemoveButtonProps) => {\n  const button = (\n    <Button\n      ariaLabel=\"remove element\"\n      className={cn(className)}\n      color=\"danger\"\n      icon={<FaTimes />}\n      onClick={onClick}\n      size=\"sm\"\n      testId={testId}\n      variant=\"light\"\n    />\n  );\n\n  if (disableAnimation) {\n    return button;\n  }\n\n  return (\n    <motion.div\n      animate={{ opacity: 1, width: 'auto' }}\n      className=\"flex\"\n      exit={{ opacity: 0, width: 0 }}\n      initial={{ opacity: 0, width: 0 }}\n      transition={{ duration: 0.2 }}\n    >\n      {button}\n    </motion.div>\n  );\n};\n\nexport default ElementRemoveButton;\n","import type { ClassValue } from '@fuf-stack/pixel-utils';\n\nimport { FaGripVertical } from 'react-icons/fa';\n\nimport { useSortable } from '@dnd-kit/sortable';\n\nimport { cn } from '@fuf-stack/pixel-utils';\n\ninterface SortDragHandleProps {\n  /** Optional CSS class name */\n  className?: ClassValue;\n  /** Unique identifier for sortable item */\n  id: string | number;\n  /** HTML data-testid attribute used in e2e tests */\n  testId?: string;\n}\n\n/**\n * Drag handle component that integrates with dnd-kit sortable functionality.\n * Renders a vertical grip icon that can be used to reorder items.\n */\nconst SortDragHandle = ({\n  className = undefined,\n  id,\n  testId = undefined,\n}: SortDragHandleProps) => {\n  // Get dnd-kit sortable attributes and listeners\n  const { attributes, listeners } = useSortable({ id });\n\n  return (\n    <div\n      className={cn(className)}\n      data-testid={testId}\n      {...attributes}\n      {...listeners}\n    >\n      <FaGripVertical />\n    </div>\n  );\n};\n\nexport default SortDragHandle;\n","import type { ReactNode } from 'react';\n\nimport { cn } from '@fuf-stack/pixel-utils';\n\nimport { useUniformField } from '../../hooks';\n\nexport interface FieldArrayLabelProps {\n  /** CSS class name */\n  className?: string;\n  /** Label content */\n  label: ReactNode;\n  /** Field name */\n  name: string;\n}\n\n/**\n * Renders the label for a FieldArray component.\n *\n * This component handles displaying the array label with proper accessibility\n * attributes using the label props from useUniformField.\n */\nconst FieldArrayLabel = ({\n  className = undefined,\n  label: _label,\n  name,\n}: FieldArrayLabelProps) => {\n  const { error, getLabelProps, invalid, label } = useUniformField({\n    name,\n    showInvalidWhen: 'immediate',\n    label: _label,\n  });\n\n  // when no label is provided, don't render anything\n  if (!_label) {\n    return null;\n  }\n\n  // @ts-expect-error - error._errors exists but not typed\n  const hasErrors = invalid && error?._errors;\n\n  return (\n    <div\n      {...getLabelProps()}\n      aria-level={3}\n      role=\"heading\"\n      className={cn(getLabelProps()?.className, className, {\n        // when there are no array level errors, the label should have foreground color\n        'text-foreground!': !hasErrors,\n      })}\n    >\n      {label}\n    </div>\n  );\n};\n\nexport default FieldArrayLabel;\n","import {\n  AnimatePresence,\n  motion,\n  useReducedMotion,\n} from '@fuf-stack/pixel-motion';\nimport { cn } from '@fuf-stack/pixel-utils';\n\nimport { useUniformField } from '../../hooks';\nimport FieldValidationError from '../../partials/FieldValidationError/FieldValidationError';\n\nexport interface FieldArrayValidationErrorProps {\n  /** Field name */\n  name: string;\n}\n\n/**\n * Renders array-level validation errors for FieldArray.\n *\n * This component handles validation errors that apply to the entire array\n * (e.g., \"Array must contain at least 3 elements\", \"Array elements are not unique\"),\n * as opposed to field-level errors which apply to individual array elements.\n *\n * The component wraps errors in the proper accessibility markup and animates\n * them in/out using Framer Motion when they appear or are resolved.\n */\nconst FieldArrayValidationError = ({\n  name,\n}: FieldArrayValidationErrorProps) => {\n  const {\n    error,\n    getErrorMessageProps,\n    getHelperWrapperProps,\n    invalid,\n    testId,\n  } = useUniformField({\n    name,\n    showInvalidWhen: 'immediate',\n  });\n\n  // disable all animation if user prefers reduced motion\n  const disableAnimation = useReducedMotion();\n\n  // @ts-expect-error - error._errors exists but not typed\n  const hasErrors = invalid && error?._errors;\n\n  return (\n    <AnimatePresence initial={!disableAnimation}>\n      {hasErrors ? (\n        <motion.div\n          key=\"field-array-errors\"\n          exit={disableAnimation ? undefined : { opacity: 0, height: 0 }}\n          initial={disableAnimation ? false : { height: 0, opacity: 0 }}\n          style={{ overflow: 'hidden' }}\n          transition={{ duration: 0.2, ease: 'circOut' }}\n          animate={\n            disableAnimation ? undefined : { opacity: 1, height: 'auto' }\n          }\n        >\n          <div\n            {...getHelperWrapperProps()}\n            className={cn(\n              getHelperWrapperProps()?.className,\n              // force helper to be visible (for some reason it's hidden by default) and add padding\n              'block px-3 py-2',\n            )}\n          >\n            <div {...getErrorMessageProps()}>\n              <FieldValidationError\n                // @ts-expect-error - error._errors exists but not typed\n                error={error._errors}\n                testId={testId}\n              />\n            </div>\n          </div>\n        </motion.div>\n      ) : null}\n    </AnimatePresence>\n  );\n};\n\nexport default FieldArrayValidationError;\n","import type { DragEndEvent } from '@dnd-kit/core';\nimport type { ReactNode } from 'react';\nimport type { UseFieldArrayMove } from 'react-hook-form';\n\nimport { useFormContext } from 'react-hook-form';\n\nimport {\n  closestCenter,\n  DndContext,\n  KeyboardSensor,\n  PointerSensor,\n  useSensor,\n  useSensors,\n} from '@dnd-kit/core';\nimport {\n  restrictToVerticalAxis,\n  restrictToWindowEdges,\n} from '@dnd-kit/modifiers';\nimport {\n  SortableContext,\n  verticalListSortingStrategy,\n} from '@dnd-kit/sortable';\n\ninterface SortContextProps {\n  /** child components */\n  children: ReactNode;\n  /** Array of objects containing unique IDs for sortable items */\n  fields: Record<'id', string>[];\n  /** name of the field array */\n  name: string;\n  /** react-hook-form's move function to update field array indices */\n  move: UseFieldArrayMove;\n  /** enable/disable sorting functionality */\n  sortable: boolean;\n}\n\n/**\n * A wrapper component that provides drag-and-drop sorting functionality for field arrays\n * using dnd-kit and react-hook-form.\n *\n * This component integrates with react-hook-form's field arrays to enable vertical\n * drag-and-drop reordering of form fields. It supports both pointer (mouse/touch)\n * and keyboard interactions for accessibility.\n */\nconst SortContext = ({\n  children,\n  fields,\n  move,\n  name,\n  sortable,\n}: SortContextProps): ReactNode => {\n  const { trigger } = useFormContext();\n\n  // Initialize sensors for both pointer (mouse/touch) and keyboard interactions\n  const sensors = useSensors(\n    useSensor(PointerSensor),\n    useSensor(KeyboardSensor),\n  );\n\n  // Early return if sorting is disabled\n  if (!sortable) {\n    return children;\n  }\n\n  /**\n   * Handles the end of a drag operation by updating field positions\n   * @param event - The drag end event containing active and over elements\n   */\n  const handleDragEnd = (event: DragEndEvent) => {\n    const { active, over } = event;\n\n    // Only move if dropping over a different item\n    if (active.id !== over?.id) {\n      // Find the indices of the dragged item and drop target\n      const oldIndex = fields.findIndex((field) => {\n        return field.id === active.id;\n      });\n      const newIndex = fields.findIndex((field) => {\n        return field.id === over?.id;\n      });\n      // Update the field array order using react-hook-form's move function\n      move(oldIndex, newIndex);\n\n      // Finally trigger validation for the array field,\n      // so validation errors are updated for the new order\n      trigger(name);\n    }\n  };\n\n  return (\n    <DndContext\n      collisionDetection={closestCenter}\n      modifiers={[restrictToVerticalAxis, restrictToWindowEdges]}\n      onDragEnd={handleDragEnd}\n      sensors={sensors}\n    >\n      <SortableContext\n        strategy={verticalListSortingStrategy}\n        items={fields.map((field) => {\n          return field.id;\n        })}\n      >\n        {children}\n      </SortableContext>\n    </DndContext>\n  );\n};\n\nexport default SortContext;\n","import FieldArray from './FieldArray';\n\nexport type * from './types';\n\nexport { FieldArray };\n\nexport default FieldArray;\n"],"mappings":"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","names":["cn","useSortable","motion","cn","cn","jsx","FaTimes","cn","Button","jsx","cn","jsx","cn","jsx","jsxs","useSortable","motion","cn","cn","jsx","cn","AnimatePresence","motion","cn","jsx","AnimatePresence","motion","cn","jsx","jsx","jsxs","cn","FieldArray_default"]}

package/dist/hooks/index.cjs

@@ -6,7 +6,7 @@
 
 
 
-var _chunkO3DDOJTBcjs = require('../chunk-O3DDOJTB.cjs');
+var _chunkHI677N7Gcjs = require('../chunk-HI677N7G.cjs');
 require('../chunk-OE5BOGGX.cjs');
 require('../chunk-NHEZXA4H.cjs');
 require('../chunk-Z353BLWI.cjs');
@@ -27,5 +27,5 @@ require('../chunk-555JRYCS.cjs');
 
 
 
-exports.checkFieldIsRequired = _chunkO3DDOJTBcjs.checkFieldIsRequired; exports.useClientValidation = _chunkO3DDOJTBcjs.useClientValidation; exports.useController = _chunkO3DDOJTBcjs.useController; exports.useFieldArray = _chunkO3DDOJTBcjs.useFieldArray; exports.useFormContext = _chunkO3DDOJTBcjs.useFormContext; exports.useInput = _chunkO3DDOJTBcjs.useInput; exports.useInputValueDebounce = _chunkBZ5OMN4Ycjs.useInputValueDebounce; exports.useInputValueTransform = _chunk4WYC2RBEcjs.useInputValueTransform; exports.useUniformField = _chunkO3DDOJTBcjs.useUniformField;
+exports.checkFieldIsRequired = _chunkHI677N7Gcjs.checkFieldIsRequired; exports.useClientValidation = _chunkHI677N7Gcjs.useClientValidation; exports.useController = _chunkHI677N7Gcjs.useController; exports.useFormContext = _chunkHI677N7Gcjs.useFormContext; exports.useInput = _chunkHI677N7Gcjs.useInput; exports.useInputValueDebounce = _chunkBZ5OMN4Ycjs.useInputValueDebounce; exports.useInputValueTransform = _chunk4WYC2RBEcjs.useInputValueTransform; exports.useUniformField = _chunkHI677N7Gcjs.useUniformField; exports.useUniformFieldArray = _chunkHI677N7Gcjs.useUniformFieldArray;
 //# sourceMappingURL=index.cjs.map

package/dist/hooks/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wjBAAC","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/index.cjs"}
+{"version":3,"sources":["/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B;AACE;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,skBAAC","file":"/home/runner/work/pixels/pixels/packages/uniform/dist/hooks/index.cjs"}

package/dist/hooks/index.d.cts

@@ -1,13 +1,13 @@
 import * as _fuf_stack_veto from '@fuf-stack/veto';
 import { VetoTypeAny, VetoInstance, VetoFormattedError } from '@fuf-stack/veto';
 import * as react_hook_form from 'react-hook-form';
-import { UseControllerProps as UseControllerProps$1, ControllerRenderProps, UseFormStateReturn, ControllerFieldState, FieldValues, Path, FieldError } from 'react-hook-form';
-export { useFieldArray } from 'react-hook-form';
+import { UseControllerProps as UseControllerProps$1, ControllerRenderProps, UseFormStateReturn, ControllerFieldState, FieldValues, Path, FieldError, ArrayPath } from 'react-hook-form';
+import * as _heroui_input from '@heroui/input';
+import { useInput } from '@heroui/input';
+export { useInput } from '@heroui/input';
 import * as React from 'react';
 import { ReactNode } from 'react';
 import { D as DebugModeSettings } from '../FormContext-LRho0tno.cjs';
-import { useInput } from '@heroui/input';
-export { useInput } from '@heroui/input';
 export { UseInputValueDebounceOptions, UseInputValueDebounceReturn, useInputValueDebounce } from './useInputValueDebounce/index.cjs';
 export { InputValueTransform, UseInputValueTransformOptions, UseInputValueTransformReturn, useInputValueTransform } from './useInputValueTransform/index.cjs';
 
@@ -106,6 +106,70 @@ declare const useFormContext: <TFieldValues extends FieldValues = FieldValues, T
     setFocus: react_hook_form.UseFormSetFocus<TFieldValues>;
 };
 
+interface UseUniformFieldArrayProps<TFieldValues extends FieldValues = FieldValues> {
+    /** Field name for the array */
+    name: ArrayPath<TFieldValues>;
+    /** Whether this is a flat array (array of primitives) */
+    flat?: boolean;
+    /** Initial value for new array elements */
+    elementInitialValue?: unknown;
+    /** Whether the last element cannot be removed (always maintain at least one element) */
+    lastElementNotRemovable?: boolean;
+    /** Disable the field */
+    disabled?: boolean;
+    /** Optional explicit test id used to build stable test ids */
+    testId?: string;
+    /** Optional label content; pass false to suppress label entirely */
+    label?: ReactNode | false;
+    /**
+     * When to show the invalid state to users.
+     * - 'touched': Only show errors after field is touched or form is submitted (default, good for text inputs)
+     * - 'immediate': Show errors as soon as they occur (good for checkboxes, radios, arrays)
+     */
+    showInvalidWhen?: 'touched' | 'immediate';
+}
+/**
+ * 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)
+ * - Automatic validation triggering
+ * - Support for flat arrays (arrays of primitives)
+ *
+ * @see https://react-hook-form.com/docs/usefieldarray
+ */
+declare const useUniformFieldArray: <TFieldValues extends FieldValues = FieldValues>({ name, flat, elementInitialValue: _elementInitialValue, lastElementNotRemovable, disabled, testId: explicitTestId, label, showInvalidWhen, }: UseUniformFieldArrayProps<TFieldValues>) => {
+    control: react_hook_form.Control<TFieldValues, any, TFieldValues>;
+    debugMode: ReturnType<typeof useFormContext<TFieldValues_1>>["debugMode"];
+    defaultValue: unknown;
+    disabled: boolean | undefined;
+    error: react_hook_form.FieldError[] | undefined;
+    errorMessage: ReactNode | null;
+    field: Omit<react_hook_form.ControllerRenderProps<TFieldValues>, "value" | "onChange"> & {
+        onChange: (... /** Initial value for new array elements */event: any[]) => void;
+        value: string;
+    };
+    getErrorMessageProps: ReturnType<typeof _heroui_input.useInput>["getErrorMessageProps"];
+    getHelperWrapperProps: ReturnType<typeof _heroui_input.useInput>["getHelperWrapperProps"];
+    getLabelProps: ReturnType<typeof _heroui_input.useInput>["getLabelProps"];
+    getValues: react_hook_form.UseFormGetValues<TFieldValues>;
+    invalid: boolean;
+    label: ReactNode | null;
+    onBlur: ReturnType<typeof useController>["field"]["onBlur"];
+    onChange: ReturnType<typeof useController>["field"]["onChange"];
+    ref: ReturnType<typeof useController>["field"]["ref"];
+    required: boolean;
+    resetField: react_hook_form.UseFormResetField<TFieldValues>;
+    testId: string;
+    fields: react_hook_form.FieldArrayWithId<TFieldValues, ArrayPath<TFieldValues>, "id">[];
+    append: react_hook_form.UseFieldArrayAppend<TFieldValues, ArrayPath<TFieldValues>>;
+    remove: react_hook_form.UseFieldArrayRemove;
+    insert: react_hook_form.UseFieldArrayInsert<TFieldValues, ArrayPath<TFieldValues>>;
+    move: react_hook_form.UseFieldArrayMove;
+    disableAnimation: boolean;
+    elementInitialValue: {};
+};
+
 interface UseUniformFieldParams<TFieldValues extends FieldValues = FieldValues> {
     /** Form field name */
     name: Path<TFieldValues> & string;
@@ -186,4 +250,4 @@ interface UseUniformFieldReturn<TFieldValues extends FieldValues = FieldValues>
  */
 declare function useUniformField<TFieldValues extends FieldValues = FieldValues>(params: UseUniformFieldParams<TFieldValues>): UseUniformFieldReturn<TFieldValues>;
 
-export { type UseControllerProps, type UseControllerReturn, type UseUniformFieldParams, type UseUniformFieldReturn, checkFieldIsRequired, useClientValidation, useController, useFormContext, useUniformField };
+export { type UseControllerProps, type UseControllerReturn, type UseUniformFieldArrayProps, type UseUniformFieldParams, type UseUniformFieldReturn, checkFieldIsRequired, useClientValidation, useController, useFormContext, useUniformField, useUniformFieldArray };

package/dist/hooks/index.d.ts

@@ -1,13 +1,13 @@
 import * as _fuf_stack_veto from '@fuf-stack/veto';
 import { VetoTypeAny, VetoInstance, VetoFormattedError } from '@fuf-stack/veto';
 import * as react_hook_form from 'react-hook-form';
-import { UseControllerProps as UseControllerProps$1, ControllerRenderProps, UseFormStateReturn, ControllerFieldState, FieldValues, Path, FieldError } from 'react-hook-form';
-export { useFieldArray } from 'react-hook-form';
+import { UseControllerProps as UseControllerProps$1, ControllerRenderProps, UseFormStateReturn, ControllerFieldState, FieldValues, Path, FieldError, ArrayPath } from 'react-hook-form';
+import * as _heroui_input from '@heroui/input';
+import { useInput } from '@heroui/input';
+export { useInput } from '@heroui/input';
 import * as React from 'react';
 import { ReactNode } from 'react';
 import { D as DebugModeSettings } from '../FormContext-LRho0tno.js';
-import { useInput } from '@heroui/input';
-export { useInput } from '@heroui/input';
 export { UseInputValueDebounceOptions, UseInputValueDebounceReturn, useInputValueDebounce } from './useInputValueDebounce/index.js';
 export { InputValueTransform, UseInputValueTransformOptions, UseInputValueTransformReturn, useInputValueTransform } from './useInputValueTransform/index.js';
 
@@ -106,6 +106,70 @@ declare const useFormContext: <TFieldValues extends FieldValues = FieldValues, T
     setFocus: react_hook_form.UseFormSetFocus<TFieldValues>;
 };
 
+interface UseUniformFieldArrayProps<TFieldValues extends FieldValues = FieldValues> {
+    /** Field name for the array */
+    name: ArrayPath<TFieldValues>;
+    /** Whether this is a flat array (array of primitives) */
+    flat?: boolean;
+    /** Initial value for new array elements */
+    elementInitialValue?: unknown;
+    /** Whether the last element cannot be removed (always maintain at least one element) */
+    lastElementNotRemovable?: boolean;
+    /** Disable the field */
+    disabled?: boolean;
+    /** Optional explicit test id used to build stable test ids */
+    testId?: string;
+    /** Optional label content; pass false to suppress label entirely */
+    label?: ReactNode | false;
+    /**
+     * When to show the invalid state to users.
+     * - 'touched': Only show errors after field is touched or form is submitted (default, good for text inputs)
+     * - 'immediate': Show errors as soon as they occur (good for checkboxes, radios, arrays)
+     */
+    showInvalidWhen?: 'touched' | 'immediate';
+}
+/**
+ * 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)
+ * - Automatic validation triggering
+ * - Support for flat arrays (arrays of primitives)
+ *
+ * @see https://react-hook-form.com/docs/usefieldarray
+ */
+declare const useUniformFieldArray: <TFieldValues extends FieldValues = FieldValues>({ name, flat, elementInitialValue: _elementInitialValue, lastElementNotRemovable, disabled, testId: explicitTestId, label, showInvalidWhen, }: UseUniformFieldArrayProps<TFieldValues>) => {
+    control: react_hook_form.Control<TFieldValues, any, TFieldValues>;
+    debugMode: ReturnType<typeof useFormContext<TFieldValues_1>>["debugMode"];
+    defaultValue: unknown;
+    disabled: boolean | undefined;
+    error: react_hook_form.FieldError[] | undefined;
+    errorMessage: ReactNode | null;
+    field: Omit<react_hook_form.ControllerRenderProps<TFieldValues>, "value" | "onChange"> & {
+        onChange: (... /** Initial value for new array elements */event: any[]) => void;
+        value: string;
+    };
+    getErrorMessageProps: ReturnType<typeof _heroui_input.useInput>["getErrorMessageProps"];
+    getHelperWrapperProps: ReturnType<typeof _heroui_input.useInput>["getHelperWrapperProps"];
+    getLabelProps: ReturnType<typeof _heroui_input.useInput>["getLabelProps"];
+    getValues: react_hook_form.UseFormGetValues<TFieldValues>;
+    invalid: boolean;
+    label: ReactNode | null;
+    onBlur: ReturnType<typeof useController>["field"]["onBlur"];
+    onChange: ReturnType<typeof useController>["field"]["onChange"];
+    ref: ReturnType<typeof useController>["field"]["ref"];
+    required: boolean;
+    resetField: react_hook_form.UseFormResetField<TFieldValues>;
+    testId: string;
+    fields: react_hook_form.FieldArrayWithId<TFieldValues, ArrayPath<TFieldValues>, "id">[];
+    append: react_hook_form.UseFieldArrayAppend<TFieldValues, ArrayPath<TFieldValues>>;
+    remove: react_hook_form.UseFieldArrayRemove;
+    insert: react_hook_form.UseFieldArrayInsert<TFieldValues, ArrayPath<TFieldValues>>;
+    move: react_hook_form.UseFieldArrayMove;
+    disableAnimation: boolean;
+    elementInitialValue: {};
+};
+
 interface UseUniformFieldParams<TFieldValues extends FieldValues = FieldValues> {
     /** Form field name */
     name: Path<TFieldValues> & string;
@@ -186,4 +250,4 @@ interface UseUniformFieldReturn<TFieldValues extends FieldValues = FieldValues>
  */
 declare function useUniformField<TFieldValues extends FieldValues = FieldValues>(params: UseUniformFieldParams<TFieldValues>): UseUniformFieldReturn<TFieldValues>;
 
-export { type UseControllerProps, type UseControllerReturn, type UseUniformFieldParams, type UseUniformFieldReturn, checkFieldIsRequired, useClientValidation, useController, useFormContext, useUniformField };
+export { type UseControllerProps, type UseControllerReturn, type UseUniformFieldArrayProps, type UseUniformFieldParams, type UseUniformFieldReturn, checkFieldIsRequired, useClientValidation, useController, useFormContext, useUniformField, useUniformFieldArray };

package/dist/hooks/index.js

@@ -2,11 +2,11 @@ import {
   checkFieldIsRequired,
   useClientValidation,
   useController,
-  useFieldArray,
   useFormContext,
   useInput,
-  useUniformField
-} from "../chunk-Y6NHIZ2M.js";
+  useUniformField,
+  useUniformFieldArray
+} from "../chunk-WVTLXBTO.js";
 import "../chunk-NTDKZW4E.js";
 import "../chunk-ELYGQTXB.js";
 import "../chunk-76KOVUDN.js";
@@ -21,11 +21,11 @@ export {
   checkFieldIsRequired,
   useClientValidation,
   useController,
-  useFieldArray,
   useFormContext,
   useInput,
   useInputValueDebounce,
   useInputValueTransform,
-  useUniformField
+  useUniformField,
+  useUniformFieldArray
 };
 //# sourceMappingURL=index.js.map