@fuf-stack/uniform 1.22.4 → 1.22.6

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

@@ -1,2 +1,98 @@
-import { n as UseUniformFieldReturn, r as useUniformField, t as UseUniformFieldParams } from "../../useUniformField-CmAYcGER.cjs";
-export { UseUniformFieldParams, UseUniformFieldReturn, useUniformField };
+import { t as InputValueTransform } from "../../useInputValueTransform-DCXXb2Lp.cjs";
+import { r as useController } from "../../useController-fblEApv_.cjs";
+import { n as useFormContext } from "../../useFormContext-D5vrT2sg.cjs";
+import { t as useInput } from "../../useInput-ClpHDPdr.cjs";
+import { ReactNode } from "react";
+import { FieldError, FieldValues, Path } from "react-hook-form";
+
+//#region src/hooks/useUniformField/useUniformField.d.ts
+interface UseUniformFieldParams<TFieldValues extends FieldValues = FieldValues, TDisplay = unknown> {
+  /** Form field name */
+  name: Path<TFieldValues> & string;
+  /** Custom aria-label for accessibility. If not provided, falls back to field name when no visible label exists */
+  ariaLabel?: string;
+  /** Disable the field */
+  disabled?: boolean;
+  /** Optional label content */
+  label?: ReactNode;
+  /** Optional explicit test id used to build stable test ids */
+  testId?: string;
+  /** Optional value transformation between form and display values */
+  transform?: InputValueTransform<TDisplay>;
+  /** Input type for special number handling */
+  type?: 'text' | 'number' | 'password';
+}
+interface UseUniformFieldReturn<TFieldValues extends FieldValues = FieldValues> {
+  /** Computed aria-label fallback (field name) when no visible label exists. Components can override based on their accessibility needs (e.g., if placeholder provides sufficient context) */
+  ariaLabel: string | undefined;
+  /** react-hook-form control instance for advanced integrations */
+  control: ReturnType<typeof useFormContext<TFieldValues>>['control'];
+  /** Debug mode from Uniform provider */
+  debugMode: ReturnType<typeof useFormContext<TFieldValues>>['debugMode'];
+  /** Current value used to initialize uncontrolled components */
+  defaultValue: unknown;
+  /** Whether the field is currently disabled (from RHF) */
+  disabled: boolean | undefined;
+  /** Validation error(s) for the field */
+  error: FieldError[] | undefined;
+  /** Pre-built errorMessage node to plug into components */
+  errorMessage: ReactNode | null;
+  /** RHF controller field with transformed value/onChange (use this for simple components) */
+  field: ReturnType<typeof useController<TFieldValues>>['field'];
+  /** Helper to spread standardized error message props to underlying components */
+  getErrorMessageProps: ReturnType<typeof useInput>['getErrorMessageProps'];
+  /** Helper to spread standardized helper wrapper props (for spacing/animation) */
+  getHelperWrapperProps: ReturnType<typeof useInput>['getHelperWrapperProps'];
+  /** Helper to spread standardized label props to underlying components */
+  getLabelProps: ReturnType<typeof useInput>['getLabelProps'];
+  /** Access current form values (converted to validation-friendly format) */
+  getValues: ReturnType<typeof useFormContext<TFieldValues>>['getValues'];
+  /** Whether the field should show invalid state (debounced for smooth animations). True when field is invalid AND (dirty OR touched OR submitted) */
+  invalid: boolean;
+  /** Computed label node including optional test id copy button */
+  label: ReactNode | null;
+  /** onBlur handler from controller */
+  onBlur: ReturnType<typeof useController<TFieldValues>>['field']['onBlur'];
+  /** onChange handler from controller (with transform applied) */
+  onChange: ReturnType<typeof useController<TFieldValues>>['field']['onChange'];
+  /** Ref to forward to underlying control */
+  ref: ReturnType<typeof useController<TFieldValues>>['field']['ref'];
+  /** Whether the field is required according to validation schema */
+  required: boolean;
+  /** Reset a specific field in the form */
+  resetField: ReturnType<typeof useFormContext<TFieldValues>>['resetField'];
+  /** Generated HTML data-testid for the field */
+  testId: string;
+}
+/**
+ * Combines frequently used form field logic into a single hook.
+ *
+ * Provides:
+ * - Enhanced form context (validation-aware state, `testId`, value transforms)
+ * - Controller field with nullish conversion handling
+ * - Value transformation via `transform` prop:
+ *   • Allows disentangled display and form values (e.g., string ↔ object, boolean ↔ array)
+ *   • Automatically applies `toDisplayValue` to field value for components
+ *   • Automatically applies `toFormValue` to display value when onChange is called
+ *   • Works with `type` prop for automatic number/string conversion
+ *   • Examples: storing objects while displaying strings, storing booleans as arrays, enriching values with metadata
+ * - Debounced `invalid` state with smart timing:
+ *   • `true` (field becomes invalid): applies immediately so errors show right away
+ *   • `false` (field becomes valid): delayed 200ms to allow smooth exit animations
+ *   • Respects `prefers-reduced-motion` by skipping delays when user prefers reduced motion
+ * - Smart `invalid` visibility (via `showInvalid`):
+ *   • Shows errors when field is dirty OR touched OR form has been submitted
+ *   • Prevents showing errors on pristine/untouched fields for better UX
+ *   • Works well for all field types (text inputs, checkboxes, radios, arrays)
+ * - Prebuilt `errorMessage` React node using `FieldValidationError`
+ * - Computed `label` node which appends a `FieldCopyTestIdButton` in
+ *   `debug-testids` mode
+ * - `defaultValue` for uncontrolled defaults and all usual field handlers
+ * - Access to form utilities: `control`, `getValues`, `resetField`
+ * - Presentation helpers: `getLabelProps`, `getErrorMessageProps`,
+ *   `getHelperWrapperProps` for consistent wiring to underlying UI components
+ */
+declare const useUniformField: <TFieldValues extends FieldValues = FieldValues, TDisplay = unknown>(params: UseUniformFieldParams<TFieldValues, TDisplay>) => UseUniformFieldReturn<TFieldValues>;
+//#endregion
+export { UseUniformFieldParams, UseUniformFieldReturn, useUniformField };
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/hooks/useUniformField/useUniformField.tsx"],"mappings":";;;;;;;;UAgBiB,qBAAA,sBACM,WAAA,GAAc,WAAA;;EAInC,IAAA,EAAM,IAAA,CAAK,YAAA;EALyB;EAOpC,SAAA;EANqB;EAQrB,QAAA;EAJW;EAMX,KAAA,GAAQ,SAAA;EAAA;EAER,MAAA;EAEY;EAAZ,SAAA,GAAY,mBAAA,CAAoB,QAAA;EAAD;EAE/B,IAAA;AAAA;AAAA,UAGe,qBAAA,sBACM,WAAA,GAAc,WAAA;EAnBnC;EAsBA,SAAA;EAnBM;EAqBN,OAAA,EAAS,UAAA,QAAkB,cAAA,CAAe,YAAA;EAnB1C;EAqBA,SAAA,EAAW,UAAA,QAAkB,cAAA,CAAe,YAAA;EAjB5C;EAmBA,YAAA;EAjBA;EAmBA,QAAA;EAjBY;EAmBZ,KAAA,EAAO,UAAA;EAjBP;EAmBA,YAAA,EAAc,SAAA;EAnBV;EAqBJ,KAAA,EAAO,UAAA,QAAkB,aAAA,CAAc,YAAA;EAlBH;EAoBpC,oBAAA,EAAsB,UAAA,QAAkB,QAAA;EAnBnB;EAqBrB,qBAAA,EAAuB,UAAA,QAAkB,QAAA;EAhBC;EAkB1C,aAAA,EAAe,UAAA,QAAkB,QAAA;EAlBxB;EAoBT,SAAA,EAAW,UAAA,QAAkB,cAAA,CAAe,YAAA;EAlBf;EAoB7B,OAAA;EAdO;EAgBP,KAAA,EAAO,SAAA;EAZgC;EAcvC,MAAA,EAAQ,UAAA,QAAkB,aAAA,CAAc,YAAA;EAdjC;EAgBP,QAAA,EAAU,UAAA,QAAkB,aAAA,CAAc,YAAA;EAdpB;EAgBtB,GAAA,EAAK,UAAA,QAAkB,aAAA,CAAc,YAAA;EAdd;EAgBvB,QAAA;EAde;EAgBf,UAAA,EAAY,UAAA,QAAkB,cAAA,CAAe,YAAA;EAdhB;EAgB7B,MAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA+BW,eAAA,wBACU,WAAA,GAAc,WAAA,sBAGnC,MAAA,EAAQ,qBAAA,CAAsB,YAAA,EAAc,QAAA,MAC3C,qBAAA,CAAsB,YAAA"}

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

@@ -1,2 +1,98 @@
-import { n as UseUniformFieldReturn, r as useUniformField, t as UseUniformFieldParams } from "../../useUniformField-DJDpQzRo.js";
-export { UseUniformFieldParams, UseUniformFieldReturn, useUniformField };
+import { t as InputValueTransform } from "../../useInputValueTransform-DCXXb2Lp.js";
+import { r as useController$1 } from "../../useController-CvQqCvFJ.js";
+import { n as useFormContext$1 } from "../../useFormContext-B1-deU4Z.js";
+import { t as useInput } from "../../useInput-ClpHDPdr.js";
+import { ReactNode } from "react";
+import { FieldError, FieldValues, Path } from "react-hook-form";
+
+//#region src/hooks/useUniformField/useUniformField.d.ts
+interface UseUniformFieldParams<TFieldValues extends FieldValues = FieldValues, TDisplay = unknown> {
+  /** Form field name */
+  name: Path<TFieldValues> & string;
+  /** Custom aria-label for accessibility. If not provided, falls back to field name when no visible label exists */
+  ariaLabel?: string;
+  /** Disable the field */
+  disabled?: boolean;
+  /** Optional label content */
+  label?: ReactNode;
+  /** Optional explicit test id used to build stable test ids */
+  testId?: string;
+  /** Optional value transformation between form and display values */
+  transform?: InputValueTransform<TDisplay>;
+  /** Input type for special number handling */
+  type?: 'text' | 'number' | 'password';
+}
+interface UseUniformFieldReturn<TFieldValues extends FieldValues = FieldValues> {
+  /** Computed aria-label fallback (field name) when no visible label exists. Components can override based on their accessibility needs (e.g., if placeholder provides sufficient context) */
+  ariaLabel: string | undefined;
+  /** react-hook-form control instance for advanced integrations */
+  control: ReturnType<typeof useFormContext$1<TFieldValues>>['control'];
+  /** Debug mode from Uniform provider */
+  debugMode: ReturnType<typeof useFormContext$1<TFieldValues>>['debugMode'];
+  /** Current value used to initialize uncontrolled components */
+  defaultValue: unknown;
+  /** Whether the field is currently disabled (from RHF) */
+  disabled: boolean | undefined;
+  /** Validation error(s) for the field */
+  error: FieldError[] | undefined;
+  /** Pre-built errorMessage node to plug into components */
+  errorMessage: ReactNode | null;
+  /** RHF controller field with transformed value/onChange (use this for simple components) */
+  field: ReturnType<typeof useController$1<TFieldValues>>['field'];
+  /** Helper to spread standardized error message props to underlying components */
+  getErrorMessageProps: ReturnType<typeof useInput>['getErrorMessageProps'];
+  /** Helper to spread standardized helper wrapper props (for spacing/animation) */
+  getHelperWrapperProps: ReturnType<typeof useInput>['getHelperWrapperProps'];
+  /** Helper to spread standardized label props to underlying components */
+  getLabelProps: ReturnType<typeof useInput>['getLabelProps'];
+  /** Access current form values (converted to validation-friendly format) */
+  getValues: ReturnType<typeof useFormContext$1<TFieldValues>>['getValues'];
+  /** Whether the field should show invalid state (debounced for smooth animations). True when field is invalid AND (dirty OR touched OR submitted) */
+  invalid: boolean;
+  /** Computed label node including optional test id copy button */
+  label: ReactNode | null;
+  /** onBlur handler from controller */
+  onBlur: ReturnType<typeof useController$1<TFieldValues>>['field']['onBlur'];
+  /** onChange handler from controller (with transform applied) */
+  onChange: ReturnType<typeof useController$1<TFieldValues>>['field']['onChange'];
+  /** Ref to forward to underlying control */
+  ref: ReturnType<typeof useController$1<TFieldValues>>['field']['ref'];
+  /** Whether the field is required according to validation schema */
+  required: boolean;
+  /** Reset a specific field in the form */
+  resetField: ReturnType<typeof useFormContext$1<TFieldValues>>['resetField'];
+  /** Generated HTML data-testid for the field */
+  testId: string;
+}
+/**
+ * Combines frequently used form field logic into a single hook.
+ *
+ * Provides:
+ * - Enhanced form context (validation-aware state, `testId`, value transforms)
+ * - Controller field with nullish conversion handling
+ * - Value transformation via `transform` prop:
+ *   • Allows disentangled display and form values (e.g., string ↔ object, boolean ↔ array)
+ *   • Automatically applies `toDisplayValue` to field value for components
+ *   • Automatically applies `toFormValue` to display value when onChange is called
+ *   • Works with `type` prop for automatic number/string conversion
+ *   • Examples: storing objects while displaying strings, storing booleans as arrays, enriching values with metadata
+ * - Debounced `invalid` state with smart timing:
+ *   • `true` (field becomes invalid): applies immediately so errors show right away
+ *   • `false` (field becomes valid): delayed 200ms to allow smooth exit animations
+ *   • Respects `prefers-reduced-motion` by skipping delays when user prefers reduced motion
+ * - Smart `invalid` visibility (via `showInvalid`):
+ *   • Shows errors when field is dirty OR touched OR form has been submitted
+ *   • Prevents showing errors on pristine/untouched fields for better UX
+ *   • Works well for all field types (text inputs, checkboxes, radios, arrays)
+ * - Prebuilt `errorMessage` React node using `FieldValidationError`
+ * - Computed `label` node which appends a `FieldCopyTestIdButton` in
+ *   `debug-testids` mode
+ * - `defaultValue` for uncontrolled defaults and all usual field handlers
+ * - Access to form utilities: `control`, `getValues`, `resetField`
+ * - Presentation helpers: `getLabelProps`, `getErrorMessageProps`,
+ *   `getHelperWrapperProps` for consistent wiring to underlying UI components
+ */
+declare const useUniformField: <TFieldValues extends FieldValues = FieldValues, TDisplay = unknown>(params: UseUniformFieldParams<TFieldValues, TDisplay>) => UseUniformFieldReturn<TFieldValues>;
+//#endregion
+export { UseUniformFieldParams, UseUniformFieldReturn, useUniformField };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/hooks/useUniformField/useUniformField.tsx"],"mappings":";;;;;;;;UAgBiB,qBAAA,sBACM,WAAA,GAAc,WAAA;;EAInC,IAAA,EAAM,IAAA,CAAK,YAAA;EALyB;EAOpC,SAAA;EANqB;EAQrB,QAAA;EAJW;EAMX,KAAA,GAAQ,SAAA;EAAA;EAER,MAAA;EAEY;EAAZ,SAAA,GAAY,mBAAA,CAAoB,QAAA;EAAD;EAE/B,IAAA;AAAA;AAAA,UAGe,qBAAA,sBACM,WAAA,GAAc,WAAA;EAnBnC;EAsBA,SAAA;EAnBM;EAqBN,OAAA,EAAS,UAAA,QAAkB,gBAAA,CAAe,YAAA;EAnB1C;EAqBA,SAAA,EAAW,UAAA,QAAkB,gBAAA,CAAe,YAAA;EAjB5C;EAmBA,YAAA;EAjBA;EAmBA,QAAA;EAjBY;EAmBZ,KAAA,EAAO,UAAA;EAjBP;EAmBA,YAAA,EAAc,SAAA;EAnBV;EAqBJ,KAAA,EAAO,UAAA,QAAkB,eAAA,CAAc,YAAA;EAlBH;EAoBpC,oBAAA,EAAsB,UAAA,QAAkB,QAAA;EAnBnB;EAqBrB,qBAAA,EAAuB,UAAA,QAAkB,QAAA;EAhBC;EAkB1C,aAAA,EAAe,UAAA,QAAkB,QAAA;EAlBxB;EAoBT,SAAA,EAAW,UAAA,QAAkB,gBAAA,CAAe,YAAA;EAlBf;EAoB7B,OAAA;EAdO;EAgBP,KAAA,EAAO,SAAA;EAZgC;EAcvC,MAAA,EAAQ,UAAA,QAAkB,eAAA,CAAc,YAAA;EAdjC;EAgBP,QAAA,EAAU,UAAA,QAAkB,eAAA,CAAc,YAAA;EAdpB;EAgBtB,GAAA,EAAK,UAAA,QAAkB,eAAA,CAAc,YAAA;EAdd;EAgBvB,QAAA;EAde;EAgBf,UAAA,EAAY,UAAA,QAAkB,gBAAA,CAAe,YAAA;EAdhB;EAgB7B,MAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA+BW,eAAA,wBACU,WAAA,GAAc,WAAA,sBAGnC,MAAA,EAAQ,qBAAA,CAAsB,YAAA,EAAc,QAAA,MAC3C,qBAAA,CAAsB,YAAA"}

package/dist/hooks/useUniformField/index.js

@@ -1,10 +1,10 @@
 import { isValueEmpty } from "../../helpers/index.js";
-import { n as FieldCopyTestIdButton } from "../../FieldCopyTestIdButton-Dpmo0uBV.js";
-import { n as FieldValidationError } from "../../FieldValidationError-ktTyyyip.js";
-import { t as useController } from "../../useController-B287flU_.js";
-import { n as useFormContext } from "../../useFormContext-CT8H8xIe.js";
-import { t as useInput } from "../../useInput-CVm3tP78.js";
-import { t as useInputValueTransform } from "../../useInputValueTransform-CXdmtc0Q.js";
+import { t as FieldCopyTestIdButton_default } from "../../FieldCopyTestIdButton-CRJBix9D.js";
+import { t as FieldValidationError_default } from "../../FieldValidationError-ByRoIxaM.js";
+import { t as useController } from "../../useController-DxFS0u7c.js";
+import { n as useFormContext } from "../../useFormContext-BJqa1FoT.js";
+import { t as useInput } from "../../useInput-C0aJaAGe.js";
+import { t as useInputValueTransform } from "../../useInputValueTransform-DJ5zkqSy.js";
 import "react";
 import { useDebounce } from "@fuf-stack/pixels";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
@@ -83,8 +83,8 @@ const useUniformField = (params) => {
 	const hasValue = !isValueEmpty(fieldValue);
 	const invalid = useDebounce(rawInvalid && (isDirty && hasValue || isTouched || submitCount > 0), 200);
 	const showTestIdCopyButton = debugMode === "debug-testids";
-	const labelNode = !!label || showTestIdCopyButton ? /* @__PURE__ */ jsxs(Fragment, { children: [label !== false ? label : null, showTestIdCopyButton ? /* @__PURE__ */ jsx(FieldCopyTestIdButton, { testId }) : null] }) : null;
-	const errorMessage = /* @__PURE__ */ jsx(FieldValidationError, {
+	const labelNode = !!label || showTestIdCopyButton ? /* @__PURE__ */ jsxs(Fragment, { children: [label !== false ? label : null, showTestIdCopyButton ? /* @__PURE__ */ jsx(FieldCopyTestIdButton_default, { testId }) : null] }) : null;
+	const errorMessage = /* @__PURE__ */ jsx(FieldValidationError_default, {
 		error,
 		testId
 	});

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

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

package/dist/hooks/useUniformFieldArray/index.cjs

@@ -1,7 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-require("../../FormContext-DsmS_mkO.cjs");
 const require_helpers_index = require("../../helpers/index.cjs");
-const require_useFormContext = require("../../useFormContext-CrXwNYiB.cjs");
+const require_useFormContext = require("../../useFormContext-kUHonwgu.cjs");
 const require_hooks_useUniformField_index = require("../useUniformField/index.cjs");
 const require_hooks_useWatchFormReset_index = require("../useWatchFormReset/index.cjs");
 let react = require("react");

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

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["useUniformField","useFormContext","flatArrayKey","isValueEmpty"],"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, isValueEmpty } from '../../helpers';\nimport { useFormContext } from '../useFormContext';\nimport { useUniformField } from '../useUniformField';\nimport { useWatchFormReset } from '../useWatchFormReset';\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 * - Reset-only normalization for stale empty placeholder rows (via useWatchFormReset)\n * - Animation control (disabled during initialization)\n * - Temporary animation disable during reset normalization collapse\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, replace } = useRHFFieldArray({\n    control,\n    name,\n  });\n\n  const { trigger, setValue, getValues } = useFormContext<TFieldValues>();\n\n  // Determine if initialization is needed (initially or after reset).\n  // lastElementNotRemovable is purely a minimum-count guarantee: when there are\n  // no rows, add one. This handles both:\n  // - Initial mount: fields.length starts at 0\n  // - Form reset to an empty array: fields.length becomes 0 again\n  // It intentionally does NOT inspect row contents, so manually added empty rows\n  // are never collapsed.\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  // Reset normalization:\n  // Run ONLY when an actual form reset is emitted (via useWatchFormReset), not\n  // on regular field edits. This does not collapse rows users add manually.\n  //\n  // Why this exists:\n  // RHF can keep stale field-array rows after reset when array defaults are\n  // missing (e.g. value becomes undefined or [null, null] while UI still has\n  // multiple rows). We normalize this reset-only state to:\n  // - one row when lastElementNotRemovable is enabled\n  // - zero rows otherwise\n  useWatchFormReset({\n    onReset: () => {\n      const currentValue = getValues(name as Path<TFieldValues>) as unknown;\n      const valueIsArray = Array.isArray(currentValue);\n      const arrayValue = valueIsArray ? (currentValue as unknown[]) : [];\n      const normalizedLength = lastElementNotRemovable ? 1 : 0;\n      const alreadyNormalized =\n        valueIsArray && arrayValue.length === normalizedLength;\n\n      // Treat these as \"effectively empty after reset\":\n      // - value missing/not-array\n      // - empty array\n      // - array where all entries are empty placeholders\n      const isEffectivelyEmptyAfterReset =\n        !valueIsArray ||\n        arrayValue.length === 0 ||\n        arrayValue.every((entry) => {\n          return isValueEmpty(entry);\n        });\n\n      // Nothing to fix when the reset restored real values (e.g. from defaults).\n      if (!isEffectivelyEmptyAfterReset) {\n        return;\n      }\n\n      // Already normalized to the target row count.\n      if (alreadyNormalized) {\n        return;\n      }\n\n      // Avoid collapse animation flicker during reset normalization.\n      setDisableAnimation(true);\n\n      // use replace so the RHF field-array length actually matches the target.\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      replace((lastElementNotRemovable ? [elementInitialValue] : []) as any);\n\n      // Restore normal animation state right after normalization.\n      if (!prefersReducedMotion) {\n        setTimeout(() => {\n          setDisableAnimation(false);\n        }, 1);\n      }\n    },\n  });\n\n  // Initialization/Re-initialization: add one element only when array length is 0.\n  // This is the min-count behavior for lastElementNotRemovable and is intentionally\n  // separate from reset normalization above.\n  //\n  // Reset behavior in this hook is split into two phases:\n  // 1) Reset normalization (useWatchFormReset): collapse stale placeholder rows\n  //    left by reset edge cases.\n  // 2) Length-based initialization (this effect): ensure a min-one array when\n  //    the field array is truly empty.\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":";;;;;;;;;;;;;;;;;;;;;;;;AA8CA,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;CACF,CAAC;CAED,MAAM,EAAE,YAAY;CAEpB,MAAM,EAAE,QAAQ,QAAQ,QAAQ,QAAQ,MAAM,aAAA,GAAA,gBAAA,eAA6B;EACzE;EACA;CACF,CAAC;CAED,MAAM,EAAE,SAAS,UAAU,cAAcC,uBAAAA,eAA6B;CAStE,MAAM,mBAAA,GAAA,MAAA,eAAgC;EACpC,OAAO,2BAA2B,OAAO,WAAW;CACtD,GAAG,CAAC,yBAAyB,OAAO,MAAM,CAAC;CAS3C,MAAM,kBAAA,GAAA,MAAA,QAAwB,CAAC,eAAe;CAK9C,CAAA,GAAA,MAAA,iBAAgB;EACd,IAAI,iBACF,eAAe,UAAU;CAE7B,GAAG,CAAC,eAAe,CAAC;CAOpB,CAAA,GAAA,MAAA,iBAAgB;EACd,IAAI,eAAe,SACjB,iBAAiB;GACf,QAAQ,IAA0B;EACpC,GAAG,GAAG;CAGV,GAAG,CAAC,OAAO,MAAM,CAAC;CAIlB,MAAM,CAAC,kBAAkB,wBAAA,GAAA,MAAA,UAAgC,IAAI;CAI7D,MAAM,wBAAA,GAAA,wBAAA,kBAAwC;CAC9C,CAAA,GAAA,MAAA,iBAAgB;EACd,IAAI,eAAe,SACjB,oBAAoB,CAAC,CAAC,oBAAoB;CAE9C,GAAG,CAAC,oBAAoB,CAAC;CAKzB,MAAM,uBAAA,GAAA,MAAA,eAAoC;EACxC,OAAO,OACH,GAAGC,sBAAAA,eAAe,wBAAwB,KAAK,IAC9C,wBAAwB,CAAC;CAChC,GAAG,CAAC,MAAM,oBAAoB,CAAC;CAY/B,sCAAA,kBAAkB,EAChB,eAAe;EACb,MAAM,eAAe,UAAU,IAA0B;EACzD,MAAM,eAAe,MAAM,QAAQ,YAAY;EAC/C,MAAM,aAAa,eAAgB,eAA6B,CAAC;EACjE,MAAM,mBAAmB,0BAA0B,IAAI;EACvD,MAAM,oBACJ,gBAAgB,WAAW,WAAW;EAcxC,IAAI,EAPF,CAAC,gBACD,WAAW,WAAW,KACtB,WAAW,OAAO,UAAU;GAC1B,OAAOC,sBAAAA,aAAa,KAAK;EAC3B,CAAC,IAID;EAIF,IAAI,mBACF;EAIF,oBAAoB,IAAI;EAIxB,QAAS,0BAA0B,CAAC,mBAAmB,IAAI,CAAC,CAAS;EAGrE,IAAI,CAAC,sBACH,iBAAiB;GACf,oBAAoB,KAAK;EAC3B,GAAG,CAAC;CAER,EACF,CAAC;CAiBD,CAAA,GAAA,MAAA,iBACQ;EACJ,IAAI,iBAAiB;GAGnB,SAAS,MAA4B,CAAC,mBAAmB,GAAU;IACjE,aAAa;IACb,aAAa;GACf,CAAC;GAGD,eAAe,UAAU;GAKzB,IAAI,CAAC,wBAAwB,kBAC3B,iBAAiB;IACf,oBAAoB,KAAK;GAC3B,GAAG,CAAC;EAER;CACF,GAOA,CAAC,eAAe,CAClB;CAEA,OAAO;EAEL;EACA;EACA;EACA;EACA;EACA;EACA;EAEA,GAAG;CACL;AACF"}
+{"version":3,"file":"index.cjs","names":["useUniformField","useFormContext","flatArrayKey","isValueEmpty"],"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, isValueEmpty } from '../../helpers';\nimport { useFormContext } from '../useFormContext';\nimport { useUniformField } from '../useUniformField';\nimport { useWatchFormReset } from '../useWatchFormReset';\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 * - Reset-only normalization for stale empty placeholder rows (via useWatchFormReset)\n * - Animation control (disabled during initialization)\n * - Temporary animation disable during reset normalization collapse\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, replace } = useRHFFieldArray({\n    control,\n    name,\n  });\n\n  const { trigger, setValue, getValues } = useFormContext<TFieldValues>();\n\n  // Determine if initialization is needed (initially or after reset).\n  // lastElementNotRemovable is purely a minimum-count guarantee: when there are\n  // no rows, add one. This handles both:\n  // - Initial mount: fields.length starts at 0\n  // - Form reset to an empty array: fields.length becomes 0 again\n  // It intentionally does NOT inspect row contents, so manually added empty rows\n  // are never collapsed.\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  // Reset normalization:\n  // Run ONLY when an actual form reset is emitted (via useWatchFormReset), not\n  // on regular field edits. This does not collapse rows users add manually.\n  //\n  // Why this exists:\n  // RHF can keep stale field-array rows after reset when array defaults are\n  // missing (e.g. value becomes undefined or [null, null] while UI still has\n  // multiple rows). We normalize this reset-only state to:\n  // - one row when lastElementNotRemovable is enabled\n  // - zero rows otherwise\n  useWatchFormReset({\n    onReset: () => {\n      const currentValue = getValues(name as Path<TFieldValues>) as unknown;\n      const valueIsArray = Array.isArray(currentValue);\n      const arrayValue = valueIsArray ? (currentValue as unknown[]) : [];\n      const normalizedLength = lastElementNotRemovable ? 1 : 0;\n      const alreadyNormalized =\n        valueIsArray && arrayValue.length === normalizedLength;\n\n      // Treat these as \"effectively empty after reset\":\n      // - value missing/not-array\n      // - empty array\n      // - array where all entries are empty placeholders\n      const isEffectivelyEmptyAfterReset =\n        !valueIsArray ||\n        arrayValue.length === 0 ||\n        arrayValue.every((entry) => {\n          return isValueEmpty(entry);\n        });\n\n      // Nothing to fix when the reset restored real values (e.g. from defaults).\n      if (!isEffectivelyEmptyAfterReset) {\n        return;\n      }\n\n      // Already normalized to the target row count.\n      if (alreadyNormalized) {\n        return;\n      }\n\n      // Avoid collapse animation flicker during reset normalization.\n      setDisableAnimation(true);\n\n      // use replace so the RHF field-array length actually matches the target.\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      replace((lastElementNotRemovable ? [elementInitialValue] : []) as any);\n\n      // Restore normal animation state right after normalization.\n      if (!prefersReducedMotion) {\n        setTimeout(() => {\n          setDisableAnimation(false);\n        }, 1);\n      }\n    },\n  });\n\n  // Initialization/Re-initialization: add one element only when array length is 0.\n  // This is the min-count behavior for lastElementNotRemovable and is intentionally\n  // separate from reset normalization above.\n  //\n  // Reset behavior in this hook is split into two phases:\n  // 1) Reset normalization (useWatchFormReset): collapse stale placeholder rows\n  //    left by reset edge cases.\n  // 2) Length-based initialization (this effect): ensure a min-one array when\n  //    the field array is truly empty.\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":";;;;;;;;;;;;;;;;;;;;;;;AA8CA,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;CACF,CAAC;CAED,MAAM,EAAE,YAAY;CAEpB,MAAM,EAAE,QAAQ,QAAQ,QAAQ,QAAQ,MAAM,aAAA,GAAA,gBAAA,eAA6B;EACzE;EACA;CACF,CAAC;CAED,MAAM,EAAE,SAAS,UAAU,cAAcC,uBAAAA,eAA6B;CAStE,MAAM,mBAAA,GAAA,MAAA,eAAgC;EACpC,OAAO,2BAA2B,OAAO,WAAW;CACtD,GAAG,CAAC,yBAAyB,OAAO,MAAM,CAAC;CAS3C,MAAM,kBAAA,GAAA,MAAA,QAAwB,CAAC,eAAe;CAK9C,CAAA,GAAA,MAAA,iBAAgB;EACd,IAAI,iBACF,eAAe,UAAU;CAE7B,GAAG,CAAC,eAAe,CAAC;CAOpB,CAAA,GAAA,MAAA,iBAAgB;EACd,IAAI,eAAe,SACjB,iBAAiB;GACf,QAAQ,IAA0B;EACpC,GAAG,GAAG;CAGV,GAAG,CAAC,OAAO,MAAM,CAAC;CAIlB,MAAM,CAAC,kBAAkB,wBAAA,GAAA,MAAA,UAAgC,IAAI;CAI7D,MAAM,wBAAA,GAAA,wBAAA,kBAAwC;CAC9C,CAAA,GAAA,MAAA,iBAAgB;EACd,IAAI,eAAe,SACjB,oBAAoB,CAAC,CAAC,oBAAoB;CAE9C,GAAG,CAAC,oBAAoB,CAAC;CAKzB,MAAM,uBAAA,GAAA,MAAA,eAAoC;EACxC,OAAO,OACH,GAAGC,sBAAAA,eAAe,wBAAwB,KAAK,IAC9C,wBAAwB,CAAC;CAChC,GAAG,CAAC,MAAM,oBAAoB,CAAC;CAY/B,sCAAA,kBAAkB,EAChB,eAAe;EACb,MAAM,eAAe,UAAU,IAA0B;EACzD,MAAM,eAAe,MAAM,QAAQ,YAAY;EAC/C,MAAM,aAAa,eAAgB,eAA6B,CAAC;EACjE,MAAM,mBAAmB,0BAA0B,IAAI;EACvD,MAAM,oBACJ,gBAAgB,WAAW,WAAW;EAcxC,IAAI,EAPF,CAAC,gBACD,WAAW,WAAW,KACtB,WAAW,OAAO,UAAU;GAC1B,OAAOC,sBAAAA,aAAa,KAAK;EAC3B,CAAC,IAID;EAIF,IAAI,mBACF;EAIF,oBAAoB,IAAI;EAIxB,QAAS,0BAA0B,CAAC,mBAAmB,IAAI,CAAC,CAAS;EAGrE,IAAI,CAAC,sBACH,iBAAiB;GACf,oBAAoB,KAAK;EAC3B,GAAG,CAAC;CAER,EACF,CAAC;CAiBD,CAAA,GAAA,MAAA,iBACQ;EACJ,IAAI,iBAAiB;GAGnB,SAAS,MAA4B,CAAC,mBAAmB,GAAU;IACjE,aAAa;IACb,aAAa;GACf,CAAC;GAGD,eAAe,UAAU;GAKzB,IAAI,CAAC,wBAAwB,kBAC3B,iBAAiB;IACf,oBAAoB,KAAK;GAC3B,GAAG,CAAC;EAER;CACF,GAOA,CAAC,eAAe,CAClB;CAEA,OAAO;EAEL;EACA;EACA;EACA;EACA;EACA;EACA;EAEA,GAAG;CACL;AACF"}

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

@@ -1,2 +1,79 @@
-import { n as useUniformFieldArray, t as UseUniformFieldArrayProps } from "../../useUniformFieldArray-D3fdzwzD.cjs";
-export { UseUniformFieldArrayProps, useUniformFieldArray };
+import { r as useController } from "../../useController-fblEApv_.cjs";
+import { n as useFormContext } from "../../useFormContext-D5vrT2sg.cjs";
+import { ReactNode } from "react";
+import { ArrayPath, FieldValues } from "react-hook-form";
+
+//#region src/hooks/useUniformFieldArray/useUniformFieldArray.d.ts
+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 */
+  label?: ReactNode;
+}
+/**
+ * Enhanced useFieldArray hook with initialization and animation logic.
+ * Based on React Hook Form's useFieldArray with additional features:
+ * - Automatic initialization when lastElementNotRemovable is set
+ * - Reset-only normalization for stale empty placeholder rows (via useWatchFormReset)
+ * - Animation control (disabled during initialization)
+ * - Temporary animation disable during reset normalization collapse
+ * - 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
+ */
+declare const useUniformFieldArray: <TFieldValues extends FieldValues = FieldValues>({
+  name,
+  flat,
+  elementInitialValue: _elementInitialValue,
+  lastElementNotRemovable,
+  disabled,
+  testId: explicitTestId,
+  label
+}: UseUniformFieldArrayProps<TFieldValues>) => {
+  ariaLabel: string | undefined;
+  control: import("react-hook-form").Control<TFieldValues, any, TFieldValues>;
+  debugMode: ReturnType<typeof useFormContext<TFieldValues_1>>["debugMode"];
+  defaultValue: unknown;
+  disabled: boolean | undefined;
+  error: import("react-hook-form").FieldError[] | undefined;
+  errorMessage: ReactNode | null;
+  field: Omit<import("react-hook-form").ControllerRenderProps<TFieldValues>, "onChange" | "value"> & {
+    onChange: (...event: any[]) => void;
+    value: string;
+  };
+  getErrorMessageProps: ReturnType<typeof import("@heroui/input").useInput>["getErrorMessageProps"];
+  getHelperWrapperProps: ReturnType<typeof import("@heroui/input").useInput>["getHelperWrapperProps"];
+  getLabelProps: ReturnType<typeof import("@heroui/input").useInput>["getLabelProps"];
+  getValues: import("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: import("react-hook-form").UseFormResetField<TFieldValues>;
+  testId: string;
+  fields: import("react-hook-form").FieldArrayWithId<TFieldValues, ArrayPath<TFieldValues>, "id">[];
+  append: import("react-hook-form").UseFieldArrayAppend<TFieldValues, ArrayPath<TFieldValues>>;
+  remove: import("react-hook-form").UseFieldArrayRemove;
+  insert: import("react-hook-form").UseFieldArrayInsert<TFieldValues, ArrayPath<TFieldValues>>;
+  move: import("react-hook-form").UseFieldArrayMove;
+  disableAnimation: boolean;
+  elementInitialValue: {};
+};
+//#endregion
+export { UseUniformFieldArrayProps, useUniformFieldArray };
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/hooks/useUniformFieldArray/useUniformFieldArray.ts"],"mappings":";;;;;;UAaiB,yBAAA,sBACM,WAAA,GAAc,WAAA;;EAGnC,IAAA,EAAM,SAAA,CAAU,YAAA;;EAEhB,IAAA;EANe;EAQf,mBAAA;EARwC;EAUxC,uBAAA;EATmC;EAWnC,QAAA;EARM;EAUN,MAAA;EAEiB;EAAjB,KAAA,GAAQ,SAAA;AAAA;;;;;;;;;;;;;;AAAS;cAiBN,oBAAA,wBACU,WAAA,GAAc,WAAA;EACnC,IAAA;EAAA,IAAA;EAAA,mBAAA,EAAA,oBAAA;EAAA,uBAAA;EAAA,QAAA;EAAA,MAAA,EAAA,cAAA;EAAA;AAAA,GAQC,yBAAA,CAA0B,YAAA;;;;;;;;;kBAnCR,KAAA;;;;;;;;;UAoEZ,UAAA;YAEuB,UAAA,QAFvB,aAAA;OAK4B,UAAA,QAHL,aAAA"}

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

@@ -1,2 +1,79 @@
-import { n as useUniformFieldArray, t as UseUniformFieldArrayProps } from "../../useUniformFieldArray-zGcIhwhF.js";
-export { UseUniformFieldArrayProps, useUniformFieldArray };
+import { r as useController$1 } from "../../useController-CvQqCvFJ.js";
+import { n as useFormContext$1 } from "../../useFormContext-B1-deU4Z.js";
+import { ReactNode } from "react";
+import { ArrayPath, FieldValues } from "react-hook-form";
+
+//#region src/hooks/useUniformFieldArray/useUniformFieldArray.d.ts
+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 */
+  label?: ReactNode;
+}
+/**
+ * Enhanced useFieldArray hook with initialization and animation logic.
+ * Based on React Hook Form's useFieldArray with additional features:
+ * - Automatic initialization when lastElementNotRemovable is set
+ * - Reset-only normalization for stale empty placeholder rows (via useWatchFormReset)
+ * - Animation control (disabled during initialization)
+ * - Temporary animation disable during reset normalization collapse
+ * - 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
+ */
+declare const useUniformFieldArray: <TFieldValues extends FieldValues = FieldValues>({
+  name,
+  flat,
+  elementInitialValue: _elementInitialValue,
+  lastElementNotRemovable,
+  disabled,
+  testId: explicitTestId,
+  label
+}: UseUniformFieldArrayProps<TFieldValues>) => {
+  ariaLabel: string | undefined;
+  control: import("react-hook-form").Control<TFieldValues, any, TFieldValues>;
+  debugMode: ReturnType<typeof useFormContext$1<TFieldValues_1>>["debugMode"];
+  defaultValue: unknown;
+  disabled: boolean | undefined;
+  error: import("react-hook-form").FieldError[] | undefined;
+  errorMessage: ReactNode | null;
+  field: Omit<import("react-hook-form").ControllerRenderProps<TFieldValues>, "onChange" | "value"> & {
+    onChange: (...event: any[]) => void;
+    value: string;
+  };
+  getErrorMessageProps: ReturnType<typeof import("@heroui/input").useInput>["getErrorMessageProps"];
+  getHelperWrapperProps: ReturnType<typeof import("@heroui/input").useInput>["getHelperWrapperProps"];
+  getLabelProps: ReturnType<typeof import("@heroui/input").useInput>["getLabelProps"];
+  getValues: import("react-hook-form").UseFormGetValues<TFieldValues>;
+  invalid: boolean;
+  label: ReactNode | null;
+  onBlur: ReturnType<typeof useController$1>["field"]["onBlur"];
+  onChange: ReturnType<typeof useController$1>["field"]["onChange"];
+  ref: ReturnType<typeof useController$1>["field"]["ref"];
+  required: boolean;
+  resetField: import("react-hook-form").UseFormResetField<TFieldValues>;
+  testId: string;
+  fields: import("react-hook-form").FieldArrayWithId<TFieldValues, ArrayPath<TFieldValues>, "id">[];
+  append: import("react-hook-form").UseFieldArrayAppend<TFieldValues, ArrayPath<TFieldValues>>;
+  remove: import("react-hook-form").UseFieldArrayRemove;
+  insert: import("react-hook-form").UseFieldArrayInsert<TFieldValues, ArrayPath<TFieldValues>>;
+  move: import("react-hook-form").UseFieldArrayMove;
+  disableAnimation: boolean;
+  elementInitialValue: {};
+};
+//#endregion
+export { UseUniformFieldArrayProps, useUniformFieldArray };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/hooks/useUniformFieldArray/useUniformFieldArray.ts"],"mappings":";;;;;;UAaiB,yBAAA,sBACM,WAAA,GAAc,WAAA;;EAGnC,IAAA,EAAM,SAAA,CAAU,YAAA;;EAEhB,IAAA;EANe;EAQf,mBAAA;EARwC;EAUxC,uBAAA;EATmC;EAWnC,QAAA;EARM;EAUN,MAAA;EAEiB;EAAjB,KAAA,GAAQ,SAAA;AAAA;;;;;;;;;;;;;;AAAS;cAiBN,oBAAA,wBACU,WAAA,GAAc,WAAA;EACnC,IAAA;EAAA,IAAA;EAAA,mBAAA,EAAA,oBAAA;EAAA,uBAAA;EAAA,QAAA;EAAA,MAAA,EAAA,cAAA;EAAA;AAAA,GAQC,yBAAA,CAA0B,YAAA;;;;;;;;;kBAnCR,KAAA;;;;;;;;;UAoEZ,UAAA;YAEuB,UAAA,QAFvB,eAAA;OAK4B,UAAA,QAHL,eAAA"}

package/dist/hooks/useUniformFieldArray/index.js

@@ -1,5 +1,5 @@
 import { flatArrayKey, isValueEmpty } from "../../helpers/index.js";
-import { n as useFormContext$1 } from "../../useFormContext-CT8H8xIe.js";
+import { n as useFormContext$1 } from "../../useFormContext-BJqa1FoT.js";
 import { useUniformField } from "../useUniformField/index.js";
 import { useWatchFormReset } from "../useWatchFormReset/index.js";
 import { useEffect, useMemo, useRef, useState } from "react";

package/dist/hooks/useWatchFormReset/index.cjs

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["useFormContext"],"sources":["../../../src/hooks/useWatchFormReset/useWatchFormReset.ts","../../../src/hooks/useWatchFormReset/index.ts"],"sourcesContent":["import { useEffect } from 'react';\n\nimport { useFormContext } from '../useFormContext/useFormContext';\n\nexport interface UseWatchFormResetOptions {\n  /**\n   * Callback that runs whenever a programmatic form reset is observed.\n   *\n   * Resets are signalled via the uniform `formReset` pub/sub channel. The event\n   * is emitted by the wrapped `reset()` method in `useFormContext`.\n   *\n   * Current primary use case:\n   * - `useUniformFieldArray` listens for reset events to normalize stale\n   *   placeholder rows left by RHF after reset when array defaults are missing.\n   */\n  onReset: () => void;\n}\n\n/**\n * Hook that watches for programmatic form reset events.\n *\n * It lets consumers run a callback when a programmatic form reset is triggered\n * through the wrapped `reset()` from `useFormContext`.\n *\n * Why this exists:\n * - Components should not infer \"a reset happened\" from field values alone.\n *   Value-based heuristics can conflict with valid user interactions.\n * - This hook provides an explicit reset signal so components can run\n *   reset-only logic safely.\n *\n * Current usage:\n * - `useUniformFieldArray` uses this hook to handle resets when no default\n *   array value was provided. In that case, RHF can leave stale empty\n *   placeholder rows. It normalizes only on reset and does not collapse rows\n *   during normal editing.\n */\nexport const useWatchFormReset = ({ onReset }: UseWatchFormResetOptions) => {\n  const { formReset } = useFormContext();\n\n  useEffect(() => {\n    const listener = () => {\n      onReset();\n    };\n\n    const unsubscribe = formReset.subscribe(listener);\n    return unsubscribe;\n  }, [formReset, onReset]);\n};\n","/* v8 ignore start */\n\nexport * from './useWatchFormReset';\n\n/* v8 ignore stop */\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAoCA,MAAa,qBAAqB,EAAE,cAAwC;CAC1E,MAAM,EAAE,cAAcA,uBAAAA,eAAe;CAErC,CAAA,GAAA,MAAA,iBAAgB;EACd,MAAM,iBAAiB;GACrB,QAAQ;EACV;EAGA,OADoB,UAAU,UAAU,QACvB;CACnB,GAAG,CAAC,WAAW,OAAO,CAAC;AACzB"}
+{"version":3,"file":"index.cjs","names":["useFormContext"],"sources":["../../../src/hooks/useWatchFormReset/useWatchFormReset.ts","../../../src/hooks/useWatchFormReset/index.ts"],"sourcesContent":["import { useEffect } from 'react';\n\nimport { useFormContext } from '../useFormContext/useFormContext';\n\nexport interface UseWatchFormResetOptions {\n  /**\n   * Callback that runs whenever a programmatic form reset is observed.\n   *\n   * Resets are signalled via the uniform `formReset` pub/sub channel. The event\n   * is emitted by the wrapped `reset()` method in `useFormContext`.\n   *\n   * Current primary use case:\n   * - `useUniformFieldArray` listens for reset events to normalize stale\n   *   placeholder rows left by RHF after reset when array defaults are missing.\n   */\n  onReset: () => void;\n}\n\n/**\n * Hook that watches for programmatic form reset events.\n *\n * It lets consumers run a callback when a programmatic form reset is triggered\n * through the wrapped `reset()` from `useFormContext`.\n *\n * Why this exists:\n * - Components should not infer \"a reset happened\" from field values alone.\n *   Value-based heuristics can conflict with valid user interactions.\n * - This hook provides an explicit reset signal so components can run\n *   reset-only logic safely.\n *\n * Current usage:\n * - `useUniformFieldArray` uses this hook to handle resets when no default\n *   array value was provided. In that case, RHF can leave stale empty\n *   placeholder rows. It normalizes only on reset and does not collapse rows\n *   during normal editing.\n */\nexport const useWatchFormReset = ({ onReset }: UseWatchFormResetOptions) => {\n  const { formReset } = useFormContext();\n\n  useEffect(() => {\n    const listener = () => {\n      onReset();\n    };\n\n    const unsubscribe = formReset.subscribe(listener);\n    return unsubscribe;\n  }, [formReset, onReset]);\n};\n","/* v8 ignore start */\n\nexport * from './useWatchFormReset';\n\n/* v8 ignore stop */\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAoCA,MAAa,qBAAqB,EAAE,cAAwC;CAC1E,MAAM,EAAE,cAAcA,uBAAAA,eAAe;CAErC,CAAA,GAAA,MAAA,iBAAgB;EACd,MAAM,iBAAiB;GACrB,QAAQ;EACV;EAGA,OADoB,UAAU,UAAU,QACvB;CACnB,GAAG,CAAC,WAAW,OAAO,CAAC;AACzB"}