@fuf-stack/uniform 1.16.1 → 1.17.0

package/dist/Checkboxes/index.d.cts

@@ -1,2 +1,2 @@
-import { n as Checkboxes, r as CheckboxesProps, t as CheckboxOption } from "../index-C8e2kOHz.cjs";
+import { n as Checkboxes, r as CheckboxesProps, t as CheckboxOption } from "../index-DTURD6sl.cjs";
 export { CheckboxOption, Checkboxes, Checkboxes as default, CheckboxesProps };

package/dist/Checkboxes/index.d.ts

@@ -1,2 +1,2 @@
-import { n as Checkboxes, r as CheckboxesProps, t as CheckboxOption } from "../index-C6YO7fVN.js";
+import { n as Checkboxes, r as CheckboxesProps, t as CheckboxOption } from "../index-Dy0m4FQj.js";
 export { CheckboxOption, Checkboxes, Checkboxes as default, CheckboxesProps };

package/dist/FieldArray/index.d.cts

@@ -1,2 +1,2 @@
-import { i as FieldArrayProps, n as FieldArrayChildrenRenderFn, r as FieldArrayFeatures, t as FieldArray } from "../index-uLhUKJjx.cjs";
+import { i as FieldArrayProps, n as FieldArrayChildrenRenderFn, r as FieldArrayFeatures, t as FieldArray } from "../index-CUy2EDqc.cjs";
 export { FieldArray, FieldArray as default, FieldArrayChildrenRenderFn, FieldArrayFeatures, FieldArrayProps };

package/dist/FieldArray/index.d.ts

@@ -1,2 +1,2 @@
-import { i as FieldArrayProps, n as FieldArrayChildrenRenderFn, r as FieldArrayFeatures, t as FieldArray } from "../index-C-t8ET2t.js";
+import { i as FieldArrayProps, n as FieldArrayChildrenRenderFn, r as FieldArrayFeatures, t as FieldArray } from "../index-BV_YDI6g.js";
 export { FieldArray, FieldArray as default, FieldArrayChildrenRenderFn, FieldArrayFeatures, FieldArrayProps };

package/dist/FieldCard/index.cjs

@@ -1,4 +1,4 @@
-const require_FieldCard = require('../FieldCard-BMmp6vcn.cjs');
+const require_FieldCard = require('../FieldCard-38ZBBWyE.cjs');
 
 exports.FieldCard = require_FieldCard.FieldCard_default;
 exports.fieldCardVariants = require_FieldCard.fieldCardVariants;

package/dist/FieldCard/index.d.cts

@@ -1,2 +1,2 @@
-import { n as FieldCardProps, r as fieldCardVariants, t as FieldCard } from "../index-CK4iUXtY.cjs";
+import { n as FieldCardProps, r as fieldCardVariants, t as FieldCard } from "../index-DxfiwbJb.cjs";
 export { FieldCard, FieldCardProps, fieldCardVariants };

package/dist/FieldCard/index.d.ts

@@ -1,2 +1,2 @@
-import { n as FieldCardProps, r as fieldCardVariants, t as FieldCard } from "../index-Ct6a8Dxz.js";
+import { n as FieldCardProps, r as fieldCardVariants, t as FieldCard } from "../index-gWYaaO6O.js";
 export { FieldCard, FieldCardProps, fieldCardVariants };

package/dist/FieldCard/index.js

@@ -1,3 +1,3 @@
-import { n as fieldCardVariants, t as FieldCard_default } from "../FieldCard-DAtdvKrE.js";
+import { n as fieldCardVariants, t as FieldCard_default } from "../FieldCard-7XiCb6jZ.js";
 
 export { FieldCard_default as FieldCard, fieldCardVariants };

package/dist/{FieldCard-BMmp6vcn.cjs → FieldCard-38ZBBWyE.cjs}

@@ -61,6 +61,38 @@ var FieldCardValidationError_default = FieldCardValidationError;
 //#endregion
 //#region src/FieldCard/FieldCard.tsx
 /**
+* Recursively checks if any child field has an error (regardless of touched state).
+* Returns true if at least one child has an error.
+*/
+const hasAnyChildErrors = (errors) => {
+	if (!errors) return false;
+	return Object.keys(errors).filter((key) => {
+		return key !== "_errors";
+	}).some((key) => {
+		const errorValue = errors[key];
+		if (errorValue === void 0) return false;
+		if (Array.isArray(errorValue)) return true;
+		if (typeof errorValue === "object" && errorValue !== null) return hasAnyChildErrors(errorValue);
+		return false;
+	});
+};
+/**
+* Recursively checks if any child field is touched.
+* Returns true if at least one child is touched.
+*/
+const hasAnyChildTouched = (touched) => {
+	if (!touched) return false;
+	return Object.keys(touched).filter((key) => {
+		return key !== "_errors";
+	}).some((key) => {
+		const touchedValue = touched[key];
+		if (touchedValue === void 0) return false;
+		if (touchedValue === true) return true;
+		if (typeof touchedValue === "object" && touchedValue !== null) return hasAnyChildTouched(touchedValue);
+		return false;
+	});
+};
+/**
 * Recursively checks if any child field with an error is also touched.
 * Returns true if at least one touched child has an error.
 */
@@ -151,11 +183,10 @@ const FieldCard = ({ children, className: _className = void 0, name, ...uniformF
 	};
 	const fieldTouched = getNestedValue(touchedFields, name);
 	const hasObjectErrors = !!error?._errors;
-	const hasAnyChildTouched = fieldTouched && Object.keys(fieldTouched).some((key) => {
-		return key !== "_errors";
-	});
-	const hasVisibleChildren = submitCount > 0 || hasVisibleChildErrors(error, fieldTouched);
-	const className = (0, _fuf_stack_pixel_utils.variantsToClassNames)(fieldCardVariants({ invalid: hasObjectErrors && (submitCount > 0 || !!hasAnyChildTouched) || hasVisibleChildren }), _className, "base");
+	const errorRecord = error;
+	const hasChildErrors = hasAnyChildErrors(errorRecord);
+	const isAnyChildTouched = hasAnyChildTouched(fieldTouched);
+	const className = (0, _fuf_stack_pixel_utils.variantsToClassNames)(fieldCardVariants({ invalid: hasChildErrors && (hasVisibleChildErrors(errorRecord, fieldTouched) || submitCount > 0) || hasObjectErrors && !hasChildErrors && (isAnyChildTouched || submitCount > 0) }), _className, "base");
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: className.base,
 		children: [
@@ -198,4 +229,4 @@ Object.defineProperty(exports, 'fieldCardVariants', {
     return fieldCardVariants;
   }
 });
-//# sourceMappingURL=FieldCard-BMmp6vcn.cjs.map
+//# sourceMappingURL=FieldCard-38ZBBWyE.cjs.map

package/dist/FieldCard-38ZBBWyE.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldCard-38ZBBWyE.cjs","names":["useUniformField","AnimatePresence","motion","FieldValidationError","useUniformField","useFormContext","checkFieldIsRequired","FieldCardValidationError"],"sources":["../src/FieldCard/subcomponents/FieldCardValidationError.tsx","../src/FieldCard/FieldCard.tsx"],"sourcesContent":["import type { FieldError } from 'react-hook-form';\n\nimport {\n  AnimatePresence,\n  motion,\n  useReducedMotion,\n} from '@fuf-stack/pixel-motion';\nimport { cn } from '@fuf-stack/pixel-utils';\n\nimport { useUniformField } from '../../hooks/useUniformField';\nimport FieldValidationError from '../../partials/FieldValidationError/FieldValidationError';\n\nexport interface FieldCardValidationErrorProps {\n  /** CSS class name for the error footer wrapper */\n  className?: string;\n  /** Error object from parent FieldCard (passed directly to avoid duplicate hook calls) */\n  error?: FieldError[] | undefined;\n  /** CSS class name for the error text (controls color based on invalid state) */\n  errorTextClassName?: string;\n  /** Field name */\n  name: string;\n}\n\n/**\n * Renders validation errors in the footer of a FieldCard component.\n *\n * This component handles displaying field-level validation errors with proper\n * accessibility attributes and animates them in/out using Framer Motion.\n *\n * Note: Object-level errors (_errors) are always shown when they exist,\n * but the danger styling is controlled by the parent FieldCard based on\n * whether child fields have been touched.\n */\nconst FieldCardValidationError = ({\n  className = undefined,\n  error = undefined,\n  errorTextClassName = undefined,\n  name,\n}: FieldCardValidationErrorProps) => {\n  const { getErrorMessageProps, getHelperWrapperProps, testId } =\n    useUniformField({\n      name,\n    });\n\n  // disable all animation if user prefers reduced motion\n  const disableAnimation = useReducedMotion();\n\n  // Always show object-level errors (_errors) when they exist\n  // @ts-expect-error - error._errors exists but not typed\n  const hasErrors = !!error?._errors;\n\n  return (\n    <AnimatePresence initial={!disableAnimation}>\n      {hasErrors ? (\n        <motion.div\n          key=\"field-card-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.4, ease: 'circOut' }}\n          animate={\n            disableAnimation ? undefined : { opacity: 1, height: 'auto' }\n          }\n        >\n          <div\n            {...getHelperWrapperProps()}\n            className={cn(getHelperWrapperProps()?.className, className)}\n          >\n            <div\n              {...getErrorMessageProps()}\n              className={cn(\n                getErrorMessageProps()?.className,\n                errorTextClassName,\n              )}\n            >\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 FieldCardValidationError;\n","import type { TVClassName } from '@fuf-stack/pixel-utils';\nimport type { ReactNode } from 'react';\n\nimport { tv, variantsToClassNames } from '@fuf-stack/pixel-utils';\n\nimport { checkFieldIsRequired, useFormContext } from '../hooks/useFormContext';\nimport { useUniformField } from '../hooks/useUniformField';\nimport FieldCardValidationError from './subcomponents/FieldCardValidationError';\n\n/**\n * Recursively checks if any child field has an error (regardless of touched state).\n * Returns true if at least one child has an error.\n */\nexport const hasAnyChildErrors = (\n  errors: Record<string, unknown> | undefined,\n): boolean => {\n  if (!errors) {\n    return false;\n  }\n\n  return Object.keys(errors)\n    .filter((key) => {\n      return key !== '_errors';\n    })\n    .some((key) => {\n      const errorValue = errors[key];\n      if (errorValue === undefined) {\n        return false;\n      }\n      // If errorValue is an array, it's a leaf field error\n      if (Array.isArray(errorValue)) {\n        return true;\n      }\n      // Recursively check nested objects\n      if (typeof errorValue === 'object' && errorValue !== null) {\n        return hasAnyChildErrors(errorValue as Record<string, unknown>);\n      }\n      return false;\n    });\n};\n\n/**\n * Recursively checks if any child field is touched.\n * Returns true if at least one child is touched.\n */\nexport const hasAnyChildTouched = (\n  touched: Record<string, unknown> | undefined,\n): boolean => {\n  if (!touched) {\n    return false;\n  }\n\n  return Object.keys(touched)\n    .filter((key) => {\n      return key !== '_errors';\n    })\n    .some((key) => {\n      const touchedValue = touched[key];\n      if (touchedValue === undefined) {\n        return false;\n      }\n      // If touchedValue is truthy (boolean true), field is touched\n      if (touchedValue === true) {\n        return true;\n      }\n      // Recursively check nested objects\n      if (typeof touchedValue === 'object' && touchedValue !== null) {\n        return hasAnyChildTouched(touchedValue as Record<string, unknown>);\n      }\n      return false;\n    });\n};\n\n/**\n * Recursively checks if any child field with an error is also touched.\n * Returns true if at least one touched child has an error.\n */\nexport const hasVisibleChildErrors = (\n  errors: Record<string, unknown> | undefined,\n  touched: Record<string, unknown> | undefined,\n): boolean => {\n  if (!errors || !touched) {\n    return false;\n  }\n\n  return Object.keys(errors)\n    .filter((key) => {\n      // Skip object-level errors (_errors) - those are handled separately\n      return key !== '_errors';\n    })\n    .some((key) => {\n      const errorValue = errors[key];\n      const touchedValue = touched[key];\n\n      // If this key doesn't exist in both errors and touched, skip\n      if (errorValue === undefined || touchedValue === undefined) {\n        return false;\n      }\n\n      // If errorValue is an array, it's a leaf field error\n      if (Array.isArray(errorValue)) {\n        // touchedValue being truthy means the field is touched\n        return !!touchedValue;\n      }\n\n      // Recursively check nested objects\n      if (typeof errorValue === 'object' && errorValue !== null) {\n        return hasVisibleChildErrors(\n          errorValue as Record<string, unknown>,\n          touchedValue as Record<string, unknown>,\n        );\n      }\n\n      return false;\n    });\n};\n\nexport const fieldCardVariants = tv({\n  slots: {\n    /** base class for the field card wrapper */\n    base: [\n      // base styles\n      'overflow-hidden rounded-small border bg-content1',\n      // animate border color change, respect reduced motion\n      'transition-colors duration-150 motion-reduce:transition-none',\n    ],\n    /** class for the label/header */\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) for proper header size\n      'rounded-t-small border-b p-3 font-semibold text-medium',\n      // animate border and text color change, respect reduced motion\n      'transition-colors duration-150 motion-reduce:transition-none',\n    ],\n    /** class for the content */\n    content: [\n      // same as p-3 of Card component\n      'p-3',\n      // default grid for form components (see Grid component)\n      'grid gap-4',\n    ],\n    /** class for the error footer wrapper */\n    errorFooter: [\n      'border-t',\n      // force helper to be visible and add padding (pt-1 to compensate for inner content's top padding)\n      'block px-3 pb-2 pt-1',\n      // animate border color change, respect reduced motion\n      'transition-colors duration-150 motion-reduce:transition-none',\n    ],\n    /** class for the error text (empty base, color controlled by variant) */\n    errorText: [],\n  },\n  variants: {\n    invalid: {\n      true: {\n        base: 'border-danger-200',\n        label: 'border-danger-200 text-danger',\n        errorFooter: 'border-danger-200',\n        errorText: '!text-danger text-tiny',\n      },\n      false: {\n        base: 'border-divider',\n        label: 'border-divider text-foreground',\n        errorFooter: 'border-divider',\n        errorText: '!text-foreground-500 text-tiny',\n      },\n    },\n  },\n  defaultVariants: {\n    invalid: false,\n  },\n});\n\ntype ClassName = TVClassName<typeof fieldCardVariants>;\n\nexport interface FieldCardProps {\n  /** Content to render inside the card */\n  children: ReactNode;\n  /** CSS class name */\n  className?: ClassName;\n  /** Label content for the card header */\n  label: ReactNode;\n  /** Field name for validation */\n  name: string;\n  /** HTML data-testid attribute used in e2e tests */\n  testId?: string;\n}\n\n/**\n * FieldCard component - A card-styled container with label header and error footer\n *\n * Displays form field content in a card layout with:\n * - Label/title in the header\n * - Content in the body\n * - Validation errors in the footer\n * - Danger outline when validation errors exist\n */\nconst FieldCard = ({\n  children,\n  className: _className = undefined,\n  name,\n  ...uniformFieldProps\n}: FieldCardProps) => {\n  const { error, getLabelProps, label } = useUniformField({\n    name,\n    ...uniformFieldProps,\n  });\n\n  const {\n    control,\n    formState: { touchedFields, submitCount },\n    validation,\n  } = useFormContext();\n\n  // Check if any registered child field is required\n  const validationInstance = validation?.baseInstance ?? validation?.instance;\n  const registeredFields: string[] = Array.from(\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (control as any)._names?.mount ?? [],\n  );\n  const childFieldPrefix = `${name}.`;\n  const isRequired = validationInstance\n    ? registeredFields\n        .filter((f) => {\n          return f.startsWith(childFieldPrefix);\n        })\n        .some((f) => {\n          return checkFieldIsRequired(\n            validationInstance,\n            f.split('.').filter((k) => {\n              return k !== '';\n            }),\n          );\n        })\n    : false;\n\n  // Get touched state for this field's children by traversing the path\n  const getNestedValue = (\n    obj: Record<string, unknown> | undefined,\n    path: string,\n  ): Record<string, unknown> | undefined => {\n    if (!obj) {\n      return undefined;\n    }\n    const keys = path.split('.');\n    let current: unknown = obj;\n    keys.every((key) => {\n      if (current && typeof current === 'object') {\n        current = (current as Record<string, unknown>)[key];\n        return true;\n      }\n      current = undefined;\n      return false;\n    });\n    return current as Record<string, unknown> | undefined;\n  };\n\n  const fieldTouched = getNestedValue(\n    touchedFields as Record<string, unknown>,\n    name,\n  );\n\n  // Check for object-level errors (_errors)\n  // @ts-expect-error - error._errors exists but not typed\n  const hasObjectErrors = !!error?._errors;\n\n  const errorRecord = error as unknown as Record<string, unknown>;\n\n  // Check if any child field has errors (regardless of touched state)\n  const hasChildErrors = hasAnyChildErrors(errorRecord);\n  // Check if any child field is touched\n  const isAnyChildTouched = hasAnyChildTouched(fieldTouched);\n\n  // Show invalid styling (danger border/header/error text) when:\n  // 1. Any child field has an error AND (it's touched OR form was submitted), OR\n  // 2. Object-level _errors exists AND no child errors AND (any child touched OR submitted)\n  const showInvalid =\n    (hasChildErrors &&\n      (hasVisibleChildErrors(errorRecord, fieldTouched) || submitCount > 0)) ||\n    (hasObjectErrors &&\n      !hasChildErrors &&\n      (isAnyChildTouched || submitCount > 0));\n\n  // className from slots\n  const variants = fieldCardVariants({ invalid: showInvalid });\n  const className = variantsToClassNames(variants, _className, 'base');\n\n  return (\n    <div className={className.base}>\n      {/* card header with label */}\n      {label ? (\n        <div\n          {...getLabelProps()}\n          aria-level={3}\n          // Override getLabelProps className to use our own invalid styling based on hasErrors,\n          // not HeroUI's which is based on any child field being invalid\n          className={className.label}\n          role=\"heading\"\n        >\n          {label}\n          {/* Manual asterisk: getLabelProps uses schema-required for the object itself,\n              but FieldCard needs asterisk based on whether any CHILD field is required */}\n          {isRequired ? (\n            <span aria-hidden=\"true\" className=\"ml-0.5 text-danger\">\n              *\n            </span>\n          ) : null}\n        </div>\n      ) : null}\n\n      {/* card content */}\n      <div className={className.content}>{children}</div>\n\n      {/* card footer with validation errors - always show _errors, but danger styling controlled by showInvalid */}\n      <FieldCardValidationError\n        className={className.errorFooter}\n        error={error}\n        errorTextClassName={className.errorText}\n        name={name}\n      />\n    </div>\n  );\n};\n\nexport default FieldCard;\n"],"mappings":"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"}

package/dist/{FieldCard-DAtdvKrE.js → FieldCard-7XiCb6jZ.js}

@@ -60,6 +60,38 @@ var FieldCardValidationError_default = FieldCardValidationError;
 //#endregion
 //#region src/FieldCard/FieldCard.tsx
 /**
+* Recursively checks if any child field has an error (regardless of touched state).
+* Returns true if at least one child has an error.
+*/
+const hasAnyChildErrors = (errors) => {
+	if (!errors) return false;
+	return Object.keys(errors).filter((key) => {
+		return key !== "_errors";
+	}).some((key) => {
+		const errorValue = errors[key];
+		if (errorValue === void 0) return false;
+		if (Array.isArray(errorValue)) return true;
+		if (typeof errorValue === "object" && errorValue !== null) return hasAnyChildErrors(errorValue);
+		return false;
+	});
+};
+/**
+* Recursively checks if any child field is touched.
+* Returns true if at least one child is touched.
+*/
+const hasAnyChildTouched = (touched) => {
+	if (!touched) return false;
+	return Object.keys(touched).filter((key) => {
+		return key !== "_errors";
+	}).some((key) => {
+		const touchedValue = touched[key];
+		if (touchedValue === void 0) return false;
+		if (touchedValue === true) return true;
+		if (typeof touchedValue === "object" && touchedValue !== null) return hasAnyChildTouched(touchedValue);
+		return false;
+	});
+};
+/**
 * Recursively checks if any child field with an error is also touched.
 * Returns true if at least one touched child has an error.
 */
@@ -150,11 +182,10 @@ const FieldCard = ({ children, className: _className = void 0, name, ...uniformF
 	};
 	const fieldTouched = getNestedValue(touchedFields, name);
 	const hasObjectErrors = !!error?._errors;
-	const hasAnyChildTouched = fieldTouched && Object.keys(fieldTouched).some((key) => {
-		return key !== "_errors";
-	});
-	const hasVisibleChildren = submitCount > 0 || hasVisibleChildErrors(error, fieldTouched);
-	const className = variantsToClassNames(fieldCardVariants({ invalid: hasObjectErrors && (submitCount > 0 || !!hasAnyChildTouched) || hasVisibleChildren }), _className, "base");
+	const errorRecord = error;
+	const hasChildErrors = hasAnyChildErrors(errorRecord);
+	const isAnyChildTouched = hasAnyChildTouched(fieldTouched);
+	const className = variantsToClassNames(fieldCardVariants({ invalid: hasChildErrors && (hasVisibleChildErrors(errorRecord, fieldTouched) || submitCount > 0) || hasObjectErrors && !hasChildErrors && (isAnyChildTouched || submitCount > 0) }), _className, "base");
 	return /* @__PURE__ */ jsxs("div", {
 		className: className.base,
 		children: [
@@ -186,4 +217,4 @@ var FieldCard_default = FieldCard;
 
 //#endregion
 export { fieldCardVariants as n, FieldCard_default as t };
-//# sourceMappingURL=FieldCard-DAtdvKrE.js.map
+//# sourceMappingURL=FieldCard-7XiCb6jZ.js.map

package/dist/FieldCard-7XiCb6jZ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldCard-7XiCb6jZ.js","names":["FieldValidationError","FieldCardValidationError"],"sources":["../src/FieldCard/subcomponents/FieldCardValidationError.tsx","../src/FieldCard/FieldCard.tsx"],"sourcesContent":["import type { FieldError } from 'react-hook-form';\n\nimport {\n  AnimatePresence,\n  motion,\n  useReducedMotion,\n} from '@fuf-stack/pixel-motion';\nimport { cn } from '@fuf-stack/pixel-utils';\n\nimport { useUniformField } from '../../hooks/useUniformField';\nimport FieldValidationError from '../../partials/FieldValidationError/FieldValidationError';\n\nexport interface FieldCardValidationErrorProps {\n  /** CSS class name for the error footer wrapper */\n  className?: string;\n  /** Error object from parent FieldCard (passed directly to avoid duplicate hook calls) */\n  error?: FieldError[] | undefined;\n  /** CSS class name for the error text (controls color based on invalid state) */\n  errorTextClassName?: string;\n  /** Field name */\n  name: string;\n}\n\n/**\n * Renders validation errors in the footer of a FieldCard component.\n *\n * This component handles displaying field-level validation errors with proper\n * accessibility attributes and animates them in/out using Framer Motion.\n *\n * Note: Object-level errors (_errors) are always shown when they exist,\n * but the danger styling is controlled by the parent FieldCard based on\n * whether child fields have been touched.\n */\nconst FieldCardValidationError = ({\n  className = undefined,\n  error = undefined,\n  errorTextClassName = undefined,\n  name,\n}: FieldCardValidationErrorProps) => {\n  const { getErrorMessageProps, getHelperWrapperProps, testId } =\n    useUniformField({\n      name,\n    });\n\n  // disable all animation if user prefers reduced motion\n  const disableAnimation = useReducedMotion();\n\n  // Always show object-level errors (_errors) when they exist\n  // @ts-expect-error - error._errors exists but not typed\n  const hasErrors = !!error?._errors;\n\n  return (\n    <AnimatePresence initial={!disableAnimation}>\n      {hasErrors ? (\n        <motion.div\n          key=\"field-card-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.4, ease: 'circOut' }}\n          animate={\n            disableAnimation ? undefined : { opacity: 1, height: 'auto' }\n          }\n        >\n          <div\n            {...getHelperWrapperProps()}\n            className={cn(getHelperWrapperProps()?.className, className)}\n          >\n            <div\n              {...getErrorMessageProps()}\n              className={cn(\n                getErrorMessageProps()?.className,\n                errorTextClassName,\n              )}\n            >\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 FieldCardValidationError;\n","import type { TVClassName } from '@fuf-stack/pixel-utils';\nimport type { ReactNode } from 'react';\n\nimport { tv, variantsToClassNames } from '@fuf-stack/pixel-utils';\n\nimport { checkFieldIsRequired, useFormContext } from '../hooks/useFormContext';\nimport { useUniformField } from '../hooks/useUniformField';\nimport FieldCardValidationError from './subcomponents/FieldCardValidationError';\n\n/**\n * Recursively checks if any child field has an error (regardless of touched state).\n * Returns true if at least one child has an error.\n */\nexport const hasAnyChildErrors = (\n  errors: Record<string, unknown> | undefined,\n): boolean => {\n  if (!errors) {\n    return false;\n  }\n\n  return Object.keys(errors)\n    .filter((key) => {\n      return key !== '_errors';\n    })\n    .some((key) => {\n      const errorValue = errors[key];\n      if (errorValue === undefined) {\n        return false;\n      }\n      // If errorValue is an array, it's a leaf field error\n      if (Array.isArray(errorValue)) {\n        return true;\n      }\n      // Recursively check nested objects\n      if (typeof errorValue === 'object' && errorValue !== null) {\n        return hasAnyChildErrors(errorValue as Record<string, unknown>);\n      }\n      return false;\n    });\n};\n\n/**\n * Recursively checks if any child field is touched.\n * Returns true if at least one child is touched.\n */\nexport const hasAnyChildTouched = (\n  touched: Record<string, unknown> | undefined,\n): boolean => {\n  if (!touched) {\n    return false;\n  }\n\n  return Object.keys(touched)\n    .filter((key) => {\n      return key !== '_errors';\n    })\n    .some((key) => {\n      const touchedValue = touched[key];\n      if (touchedValue === undefined) {\n        return false;\n      }\n      // If touchedValue is truthy (boolean true), field is touched\n      if (touchedValue === true) {\n        return true;\n      }\n      // Recursively check nested objects\n      if (typeof touchedValue === 'object' && touchedValue !== null) {\n        return hasAnyChildTouched(touchedValue as Record<string, unknown>);\n      }\n      return false;\n    });\n};\n\n/**\n * Recursively checks if any child field with an error is also touched.\n * Returns true if at least one touched child has an error.\n */\nexport const hasVisibleChildErrors = (\n  errors: Record<string, unknown> | undefined,\n  touched: Record<string, unknown> | undefined,\n): boolean => {\n  if (!errors || !touched) {\n    return false;\n  }\n\n  return Object.keys(errors)\n    .filter((key) => {\n      // Skip object-level errors (_errors) - those are handled separately\n      return key !== '_errors';\n    })\n    .some((key) => {\n      const errorValue = errors[key];\n      const touchedValue = touched[key];\n\n      // If this key doesn't exist in both errors and touched, skip\n      if (errorValue === undefined || touchedValue === undefined) {\n        return false;\n      }\n\n      // If errorValue is an array, it's a leaf field error\n      if (Array.isArray(errorValue)) {\n        // touchedValue being truthy means the field is touched\n        return !!touchedValue;\n      }\n\n      // Recursively check nested objects\n      if (typeof errorValue === 'object' && errorValue !== null) {\n        return hasVisibleChildErrors(\n          errorValue as Record<string, unknown>,\n          touchedValue as Record<string, unknown>,\n        );\n      }\n\n      return false;\n    });\n};\n\nexport const fieldCardVariants = tv({\n  slots: {\n    /** base class for the field card wrapper */\n    base: [\n      // base styles\n      'overflow-hidden rounded-small border bg-content1',\n      // animate border color change, respect reduced motion\n      'transition-colors duration-150 motion-reduce:transition-none',\n    ],\n    /** class for the label/header */\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) for proper header size\n      'rounded-t-small border-b p-3 font-semibold text-medium',\n      // animate border and text color change, respect reduced motion\n      'transition-colors duration-150 motion-reduce:transition-none',\n    ],\n    /** class for the content */\n    content: [\n      // same as p-3 of Card component\n      'p-3',\n      // default grid for form components (see Grid component)\n      'grid gap-4',\n    ],\n    /** class for the error footer wrapper */\n    errorFooter: [\n      'border-t',\n      // force helper to be visible and add padding (pt-1 to compensate for inner content's top padding)\n      'block px-3 pb-2 pt-1',\n      // animate border color change, respect reduced motion\n      'transition-colors duration-150 motion-reduce:transition-none',\n    ],\n    /** class for the error text (empty base, color controlled by variant) */\n    errorText: [],\n  },\n  variants: {\n    invalid: {\n      true: {\n        base: 'border-danger-200',\n        label: 'border-danger-200 text-danger',\n        errorFooter: 'border-danger-200',\n        errorText: '!text-danger text-tiny',\n      },\n      false: {\n        base: 'border-divider',\n        label: 'border-divider text-foreground',\n        errorFooter: 'border-divider',\n        errorText: '!text-foreground-500 text-tiny',\n      },\n    },\n  },\n  defaultVariants: {\n    invalid: false,\n  },\n});\n\ntype ClassName = TVClassName<typeof fieldCardVariants>;\n\nexport interface FieldCardProps {\n  /** Content to render inside the card */\n  children: ReactNode;\n  /** CSS class name */\n  className?: ClassName;\n  /** Label content for the card header */\n  label: ReactNode;\n  /** Field name for validation */\n  name: string;\n  /** HTML data-testid attribute used in e2e tests */\n  testId?: string;\n}\n\n/**\n * FieldCard component - A card-styled container with label header and error footer\n *\n * Displays form field content in a card layout with:\n * - Label/title in the header\n * - Content in the body\n * - Validation errors in the footer\n * - Danger outline when validation errors exist\n */\nconst FieldCard = ({\n  children,\n  className: _className = undefined,\n  name,\n  ...uniformFieldProps\n}: FieldCardProps) => {\n  const { error, getLabelProps, label } = useUniformField({\n    name,\n    ...uniformFieldProps,\n  });\n\n  const {\n    control,\n    formState: { touchedFields, submitCount },\n    validation,\n  } = useFormContext();\n\n  // Check if any registered child field is required\n  const validationInstance = validation?.baseInstance ?? validation?.instance;\n  const registeredFields: string[] = Array.from(\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (control as any)._names?.mount ?? [],\n  );\n  const childFieldPrefix = `${name}.`;\n  const isRequired = validationInstance\n    ? registeredFields\n        .filter((f) => {\n          return f.startsWith(childFieldPrefix);\n        })\n        .some((f) => {\n          return checkFieldIsRequired(\n            validationInstance,\n            f.split('.').filter((k) => {\n              return k !== '';\n            }),\n          );\n        })\n    : false;\n\n  // Get touched state for this field's children by traversing the path\n  const getNestedValue = (\n    obj: Record<string, unknown> | undefined,\n    path: string,\n  ): Record<string, unknown> | undefined => {\n    if (!obj) {\n      return undefined;\n    }\n    const keys = path.split('.');\n    let current: unknown = obj;\n    keys.every((key) => {\n      if (current && typeof current === 'object') {\n        current = (current as Record<string, unknown>)[key];\n        return true;\n      }\n      current = undefined;\n      return false;\n    });\n    return current as Record<string, unknown> | undefined;\n  };\n\n  const fieldTouched = getNestedValue(\n    touchedFields as Record<string, unknown>,\n    name,\n  );\n\n  // Check for object-level errors (_errors)\n  // @ts-expect-error - error._errors exists but not typed\n  const hasObjectErrors = !!error?._errors;\n\n  const errorRecord = error as unknown as Record<string, unknown>;\n\n  // Check if any child field has errors (regardless of touched state)\n  const hasChildErrors = hasAnyChildErrors(errorRecord);\n  // Check if any child field is touched\n  const isAnyChildTouched = hasAnyChildTouched(fieldTouched);\n\n  // Show invalid styling (danger border/header/error text) when:\n  // 1. Any child field has an error AND (it's touched OR form was submitted), OR\n  // 2. Object-level _errors exists AND no child errors AND (any child touched OR submitted)\n  const showInvalid =\n    (hasChildErrors &&\n      (hasVisibleChildErrors(errorRecord, fieldTouched) || submitCount > 0)) ||\n    (hasObjectErrors &&\n      !hasChildErrors &&\n      (isAnyChildTouched || submitCount > 0));\n\n  // className from slots\n  const variants = fieldCardVariants({ invalid: showInvalid });\n  const className = variantsToClassNames(variants, _className, 'base');\n\n  return (\n    <div className={className.base}>\n      {/* card header with label */}\n      {label ? (\n        <div\n          {...getLabelProps()}\n          aria-level={3}\n          // Override getLabelProps className to use our own invalid styling based on hasErrors,\n          // not HeroUI's which is based on any child field being invalid\n          className={className.label}\n          role=\"heading\"\n        >\n          {label}\n          {/* Manual asterisk: getLabelProps uses schema-required for the object itself,\n              but FieldCard needs asterisk based on whether any CHILD field is required */}\n          {isRequired ? (\n            <span aria-hidden=\"true\" className=\"ml-0.5 text-danger\">\n              *\n            </span>\n          ) : null}\n        </div>\n      ) : null}\n\n      {/* card content */}\n      <div className={className.content}>{children}</div>\n\n      {/* card footer with validation errors - always show _errors, but danger styling controlled by showInvalid */}\n      <FieldCardValidationError\n        className={className.errorFooter}\n        error={error}\n        errorTextClassName={className.errorText}\n        name={name}\n      />\n    </div>\n  );\n};\n\nexport default FieldCard;\n"],"mappings":";;;;;;;;;;;;;;;;;;AAiCA,MAAM,4BAA4B,EAChC,YAAY,QACZ,QAAQ,QACR,qBAAqB,QACrB,WACmC;CACnC,MAAM,EAAE,sBAAsB,uBAAuB,WACnD,gBAAgB,EACd,MACD,CAAC;CAGJ,MAAM,mBAAmB,kBAAkB;CAI3C,MAAM,YAAY,CAAC,CAAC,OAAO;AAE3B,QACE,oBAAC;EAAgB,SAAS,CAAC;YACxB,YACC,oBAAC,OAAO;GAEN,MAAM,mBAAmB,SAAY;IAAE,SAAS;IAAG,QAAQ;IAAG;GAC9D,SAAS,mBAAmB,QAAQ;IAAE,QAAQ;IAAG,SAAS;IAAG;GAC7D,OAAO,EAAE,UAAU,UAAU;GAC7B,YAAY;IAAE,UAAU;IAAK,MAAM;IAAW;GAC9C,SACE,mBAAmB,SAAY;IAAE,SAAS;IAAG,QAAQ;IAAQ;aAG/D,oBAAC;IACC,GAAI,uBAAuB;IAC3B,WAAW,GAAG,uBAAuB,EAAE,WAAW,UAAU;cAE5D,oBAAC;KACC,GAAI,sBAAsB;KAC1B,WAAW,GACT,sBAAsB,EAAE,WACxB,mBACD;eAED,oBAACA;MAEC,OAAO,MAAM;MACL;OACR;MACE;KACF;KA1BF,oBA2BO,GACX;GACY;;AAItB,uCAAe;;;;;;;;AC3Ef,MAAa,qBACX,WACY;AACZ,KAAI,CAAC,OACH,QAAO;AAGT,QAAO,OAAO,KAAK,OAAO,CACvB,QAAQ,QAAQ;AACf,SAAO,QAAQ;GACf,CACD,MAAM,QAAQ;EACb,MAAM,aAAa,OAAO;AAC1B,MAAI,eAAe,OACjB,QAAO;AAGT,MAAI,MAAM,QAAQ,WAAW,CAC3B,QAAO;AAGT,MAAI,OAAO,eAAe,YAAY,eAAe,KACnD,QAAO,kBAAkB,WAAsC;AAEjE,SAAO;GACP;;;;;;AAON,MAAa,sBACX,YACY;AACZ,KAAI,CAAC,QACH,QAAO;AAGT,QAAO,OAAO,KAAK,QAAQ,CACxB,QAAQ,QAAQ;AACf,SAAO,QAAQ;GACf,CACD,MAAM,QAAQ;EACb,MAAM,eAAe,QAAQ;AAC7B,MAAI,iBAAiB,OACnB,QAAO;AAGT,MAAI,iBAAiB,KACnB,QAAO;AAGT,MAAI,OAAO,iBAAiB,YAAY,iBAAiB,KACvD,QAAO,mBAAmB,aAAwC;AAEpE,SAAO;GACP;;;;;;AAON,MAAa,yBACX,QACA,YACY;AACZ,KAAI,CAAC,UAAU,CAAC,QACd,QAAO;AAGT,QAAO,OAAO,KAAK,OAAO,CACvB,QAAQ,QAAQ;AAEf,SAAO,QAAQ;GACf,CACD,MAAM,QAAQ;EACb,MAAM,aAAa,OAAO;EAC1B,MAAM,eAAe,QAAQ;AAG7B,MAAI,eAAe,UAAa,iBAAiB,OAC/C,QAAO;AAIT,MAAI,MAAM,QAAQ,WAAW,CAE3B,QAAO,CAAC,CAAC;AAIX,MAAI,OAAO,eAAe,YAAY,eAAe,KACnD,QAAO,sBACL,YACA,aACD;AAGH,SAAO;GACP;;AAGN,MAAa,oBAAoB,GAAG;CAClC,OAAO;EAEL,MAAM,CAEJ,oDAEA,+DACD;EAED,OAAO;GAEL;GAEA;GAEA;GAEA;GACD;EAED,SAAS,CAEP,OAEA,aACD;EAED,aAAa;GACX;GAEA;GAEA;GACD;EAED,WAAW,EAAE;EACd;CACD,UAAU,EACR,SAAS;EACP,MAAM;GACJ,MAAM;GACN,OAAO;GACP,aAAa;GACb,WAAW;GACZ;EACD,OAAO;GACL,MAAM;GACN,OAAO;GACP,aAAa;GACb,WAAW;GACZ;EACF,EACF;CACD,iBAAiB,EACf,SAAS,OACV;CACF,CAAC;;;;;;;;;;AA0BF,MAAM,aAAa,EACjB,UACA,WAAW,aAAa,QACxB,MACA,GAAG,wBACiB;CACpB,MAAM,EAAE,OAAO,eAAe,UAAU,gBAAgB;EACtD;EACA,GAAG;EACJ,CAAC;CAEF,MAAM,EACJ,SACA,WAAW,EAAE,eAAe,eAC5B,eACE,gBAAgB;CAGpB,MAAM,qBAAqB,YAAY,gBAAgB,YAAY;CACnE,MAAM,mBAA6B,MAAM,KAEtC,QAAgB,QAAQ,SAAS,EAAE,CACrC;CACD,MAAM,mBAAmB,GAAG,KAAK;CACjC,MAAM,aAAa,qBACf,iBACG,QAAQ,MAAM;AACb,SAAO,EAAE,WAAW,iBAAiB;GACrC,CACD,MAAM,MAAM;AACX,SAAO,qBACL,oBACA,EAAE,MAAM,IAAI,CAAC,QAAQ,MAAM;AACzB,UAAO,MAAM;IACb,CACH;GACD,GACJ;CAGJ,MAAM,kBACJ,KACA,SACwC;AACxC,MAAI,CAAC,IACH;EAEF,MAAM,OAAO,KAAK,MAAM,IAAI;EAC5B,IAAI,UAAmB;AACvB,OAAK,OAAO,QAAQ;AAClB,OAAI,WAAW,OAAO,YAAY,UAAU;AAC1C,cAAW,QAAoC;AAC/C,WAAO;;AAET,aAAU;AACV,UAAO;IACP;AACF,SAAO;;CAGT,MAAM,eAAe,eACnB,eACA,KACD;CAID,MAAM,kBAAkB,CAAC,CAAC,OAAO;CAEjC,MAAM,cAAc;CAGpB,MAAM,iBAAiB,kBAAkB,YAAY;CAErD,MAAM,oBAAoB,mBAAmB,aAAa;CAc1D,MAAM,YAAY,qBADD,kBAAkB,EAAE,SAPlC,mBACE,sBAAsB,aAAa,aAAa,IAAI,cAAc,MACpE,mBACC,CAAC,mBACA,qBAAqB,cAAc,IAGmB,CAAC,EACX,YAAY,OAAO;AAEpE,QACE,qBAAC;EAAI,WAAW,UAAU;;GAEvB,QACC,qBAAC;IACC,GAAI,eAAe;IACnB,cAAY;IAGZ,WAAW,UAAU;IACrB,MAAK;eAEJ,OAGA,aACC,oBAAC;KAAK,eAAY;KAAO,WAAU;eAAqB;MAEjD,GACL;KACA,GACJ;GAGJ,oBAAC;IAAI,WAAW,UAAU;IAAU;KAAe;GAGnD,oBAACC;IACC,WAAW,UAAU;IACd;IACP,oBAAoB,UAAU;IACxB;KACN;;GACE;;AAIV,wBAAe"}

package/dist/Form/index.d.cts

@@ -1,2 +1,2 @@
-import { n as FormProps, t as Form } from "../index-CMQe-K8d.cjs";
+import { n as FormProps, t as Form } from "../index-Bo79xzb4.cjs";
 export { Form, Form as default, FormProps };

package/dist/Form/index.d.ts

@@ -1,3 +1,3 @@
 import "../FormContext-C2_WMi_v.js";
-import { n as FormProps, t as Form } from "../index-D4jPNNjM.js";
+import { n as FormProps, t as Form } from "../index-aHcGnXHf.js";
 export { Form, Form as default, FormProps };

package/dist/Grid/index.d.cts

@@ -1,2 +1,2 @@
-import { n as GridProps, t as Grid } from "../index-ByDAUZR8.cjs";
+import { n as GridProps, t as Grid } from "../index-BW9EUWZE.cjs";
 export { Grid, Grid as default, GridProps };

package/dist/Grid/index.d.ts

@@ -1,2 +1,2 @@
-import { n as GridProps, t as Grid } from "../index-DzGaqagC.js";
+import { n as GridProps, t as Grid } from "../index-BFLKkqA3.js";
 export { Grid, Grid as default, GridProps };

package/dist/Input/index.d.cts

@@ -1,2 +1,2 @@
-import { n as InputProps, t as Input } from "../index-BYag2YM-.cjs";
+import { n as InputProps, t as Input } from "../index-DAeb_8Q4.cjs";
 export { Input, Input as default, InputProps };

package/dist/Input/index.d.ts

@@ -1,2 +1,2 @@
-import { n as InputProps, t as Input } from "../index-BPupl-39.js";
+import { n as InputProps, t as Input } from "../index-CB00FCyi.js";
 export { Input, Input as default, InputProps };

package/dist/RadioBoxes/index.d.cts

@@ -1,2 +1,2 @@
-import { n as RadioBoxes, r as RadioBoxesProps, t as radioBoxVariants } from "../index-BtRhfPlX.cjs";
+import { n as RadioBoxes, r as RadioBoxesProps, t as radioBoxVariants } from "../index-nVYabHcT.cjs";
 export { RadioBoxes, RadioBoxes as default, RadioBoxesProps, radioBoxVariants };

package/dist/RadioBoxes/index.d.ts

@@ -1,2 +1,2 @@
-import { n as RadioBoxes, r as RadioBoxesProps, t as radioBoxVariants } from "../index-WKgD5_vg.js";
+import { n as RadioBoxes, r as RadioBoxesProps, t as radioBoxVariants } from "../index-Cj-PU3Ck.js";
 export { RadioBoxes, RadioBoxes as default, RadioBoxesProps, radioBoxVariants };

package/dist/RadioTabs/index.d.cts

@@ -1,2 +1,2 @@
-import { n as RadioTabsProps, t as RadioTabs } from "../index-PdZaOKs9.cjs";
+import { n as RadioTabsProps, t as RadioTabs } from "../index-Cj5CLBt2.cjs";
 export { RadioTabs, RadioTabs as default, RadioTabsProps };

package/dist/RadioTabs/index.d.ts

@@ -1,2 +1,2 @@
-import { n as RadioTabsProps, t as RadioTabs } from "../index-CuACo6jI.js";
+import { n as RadioTabsProps, t as RadioTabs } from "../index-C3CvgmJw.js";
 export { RadioTabs, RadioTabs as default, RadioTabsProps };

package/dist/Radios/index.d.cts

@@ -1,2 +1,2 @@
-import { n as RadiosProps, t as Radios } from "../index-dhcztpfB.cjs";
+import { n as RadiosProps, t as Radios } from "../index-BgXr1v45.cjs";
 export { Radios, Radios as default, RadiosProps };

package/dist/Radios/index.d.ts

@@ -1,2 +1,2 @@
-import { n as RadiosProps, t as Radios } from "../index-BXm2Nvuc.js";
+import { n as RadiosProps, t as Radios } from "../index-796vjEop.js";
 export { Radios, Radios as default, RadiosProps };

package/dist/Select/index.d.cts

@@ -1,2 +1,2 @@
-import { n as SelectProps, t as Select } from "../index-Dbn5MHgv.cjs";
+import { n as SelectProps, t as Select } from "../index-DfGCI-K_.cjs";
 export { Select, Select as default, SelectProps };

package/dist/Select/index.d.ts

@@ -1,2 +1,2 @@
-import { n as SelectProps, t as Select } from "../index-D_VcH_gn.js";
+import { n as SelectProps, t as Select } from "../index-COwP53Gx.js";
 export { Select, Select as default, SelectProps };

package/dist/Slider/index.d.cts

@@ -1,2 +1,2 @@
-import { n as SliderProps, t as Slider } from "../index-5SxIjw6Y.cjs";
+import { n as SliderProps, t as Slider } from "../index-CrxSEKKb.cjs";
 export { Slider, Slider as default, SliderProps };

package/dist/Slider/index.d.ts

@@ -1,2 +1,2 @@
-import { n as SliderProps, t as Slider } from "../index-B5oUKlIo.js";
+import { n as SliderProps, t as Slider } from "../index-DebErIUS.js";
 export { Slider, Slider as default, SliderProps };

package/dist/SubmitButton/index.d.cts

@@ -1,2 +1,2 @@
-import { n as SubmitButtonProps, t as SubmitButton } from "../index-ChtlWBjc.cjs";
+import { n as SubmitButtonProps, t as SubmitButton } from "../index-CbAh0Kfo.cjs";
 export { SubmitButton, SubmitButton as default, SubmitButtonProps };

package/dist/SubmitButton/index.d.ts

@@ -1,2 +1,2 @@
-import { n as SubmitButtonProps, t as SubmitButton } from "../index-BL0DnIzh.js";
+import { n as SubmitButtonProps, t as SubmitButton } from "../index-pE9osud2.js";
 export { SubmitButton, SubmitButton as default, SubmitButtonProps };

package/dist/Switch/index.d.cts

@@ -1,2 +1,2 @@
-import { n as SwitchProps, t as Switch } from "../index-BbWEFpRz.cjs";
+import { n as SwitchProps, t as Switch } from "../index-D3RMbKbP.cjs";
 export { Switch, Switch as default, SwitchProps };

package/dist/Switch/index.d.ts

@@ -1,2 +1,2 @@
-import { n as SwitchProps, t as Switch } from "../index-CGnr_e53.js";
+import { n as SwitchProps, t as Switch } from "../index-DjDR6FpI.js";
 export { Switch, Switch as default, SwitchProps };

package/dist/SwitchBox/index.d.cts

@@ -1,2 +1,2 @@
-import { n as SwitchBoxProps, r as switchBoxVariants, t as SwitchBox } from "../index-Nrdyx_72.cjs";
+import { n as SwitchBoxProps, r as switchBoxVariants, t as SwitchBox } from "../index-BD9y--o2.cjs";
 export { SwitchBox, SwitchBox as default, SwitchBoxProps, switchBoxVariants };

package/dist/SwitchBox/index.d.ts

@@ -1,2 +1,2 @@
-import { n as SwitchBoxProps, r as switchBoxVariants, t as SwitchBox } from "../index-DmMenZfj.js";
+import { n as SwitchBoxProps, r as switchBoxVariants, t as SwitchBox } from "../index-B_1td56I.js";
 export { SwitchBox, SwitchBox as default, SwitchBoxProps, switchBoxVariants };

package/dist/TextArea/index.d.cts

@@ -1,2 +1,2 @@
-import { n as TextAreaProps, t as TextArea } from "../index-D4S6YQwi.cjs";
+import { n as TextAreaProps, t as TextArea } from "../index-Y8XsRdxS.cjs";
 export { TextArea, TextArea as default, TextAreaProps };

package/dist/TextArea/index.d.ts

@@ -1,2 +1,2 @@
-import { n as TextAreaProps, t as TextArea } from "../index-DJyRJr0I.js";
+import { n as TextAreaProps, t as TextArea } from "../index-B62CWrcm.js";
 export { TextArea, TextArea as default, TextAreaProps };

package/dist/helpers/index.d.cts

@@ -1,2 +1,186 @@
-import { a as toFormFormat, c as createOptionValueConverter, i as nameToTestId, n as fromNullishString, o as toNullishString, r as isValueEmpty, s as toValidationFormat, t as flatArrayKey } from "../index-BTr_gid3.cjs";
-export { createOptionValueConverter, flatArrayKey, fromNullishString, isValueEmpty, nameToTestId, toFormFormat, toNullishString, toValidationFormat };
+//#region src/helpers/createOptionValueConverter/createOptionValueConverter.d.ts
+/**
+ * Creates a converter function that preserves the original type (string, number, or boolean)
+ * of option values when converting from string keys back to their original type.
+ *
+ * This is useful for radio/select components where the underlying UI library
+ * uses string keys internally, but we want to preserve number/boolean values in the form state.
+ *
+ * @param options - Array of options with a value property that can be string, number, or boolean
+ * @returns An object with:
+ *   - `convertToOriginalType`: Function to convert a string key back to its original type
+ *   - `numberValueKeys`: Set of string representations of number values (for internal use)
+ *   - `booleanValueKeys`: Map of string representations to boolean values (for internal use)
+ */
+declare const createOptionValueConverter: <T extends {
+  value: string | number | boolean;
+}>(options: T[]) => {
+  booleanValueKeys: Map<string, boolean>;
+  convertToOriginalType: (key: string | number | boolean) => string | number | boolean;
+  numberValueKeys: Set<string>;
+};
+//#endregion
+//#region src/helpers/nullishFields/nullishFields.d.ts
+/** Key used to wrap flat array elements when converting to form format */
+declare const flatArrayKey = "__FLAT__";
+/**
+ * Checks if a value is considered "empty" for validation display purposes.
+ *
+ * Used by useUniformField to determine when to show validation errors.
+ * Empty values don't trigger immediate error display (user must interact first).
+ *
+ * Handles:
+ * - Primitives: null, undefined, ''
+ * - Marker strings: __NULL__, __FALSE__, __ZERO__ (converted via fromNullishString)
+ * - Empty arrays: []
+ * - Objects with all empty values: {a: null, b: ''}
+ * - Flat array wrappers: {__FLAT__: null} or {__FLAT__: ''}
+ *
+ * @param value - The value to check (will be converted via fromNullishString first)
+ * @returns true if the value is empty
+ *
+ * @example
+ * isValueEmpty(null)                    // true
+ * isValueEmpty('')                      // true
+ * isValueEmpty('__NULL__')              // true (marker string)
+ * isValueEmpty([])                      // true (empty array)
+ * isValueEmpty({a: null})               // true (object with all empty values)
+ * isValueEmpty({__FLAT__: null})        // true (flat array wrapper with empty value)
+ * isValueEmpty({__FLAT__: ''})          // true
+ * isValueEmpty('hello')                 // false
+ * isValueEmpty([1, 2])                  // false
+ * isValueEmpty({a: 'value'})            // false
+ * isValueEmpty({__FLAT__: 'value'})     // false
+ */
+declare const isValueEmpty: (value: unknown) => boolean;
+/**
+ * Converts marker strings back to their original values when processing arrays
+ */
+declare const fromNullishString: (value: unknown) => unknown;
+/**
+ * Converts null/falsy values to marker strings for JSON processing
+ */
+declare const toNullishString: (value: unknown) => unknown;
+/**
+ * Converts field values to a format suitable for forms by:
+ * - Wrapping arrays of primitives as objects using the flatArrayKey `__FLAT__`
+ *   to satisfy RHF's requirement that array fields contain objects
+ * - Removing empty strings and null values from objects
+ *
+ * This conversion is required because React Hook Form does not support arrays with
+ * flat values (string, number, boolean, null). Array fields must contain objects.
+ * We work around this by wrapping primitive entries: `{ __FLAT__: <value> }`.
+ *
+ * @example
+ * const fields = {
+ *   name: 'John',
+ *   scores: [0, null, 75, false],
+ *   scoresDetailed: [
+ *     { score: 1 },
+ *     { score: null },
+ *     { score: 0 },
+ *     { score: false },
+ *     { score: '' },
+ *   ],
+ *   contact: {
+ *     email: '',
+ *     phone: null,
+ *     address: '123 Main St'
+ *   }
+ * };
+ *
+ * // Result:
+ * {
+ *   name: 'John',
+ *   scores: [
+ *     { __FLAT__: 0 },
+ *     { __FLAT__: null },
+ *     { __FLAT__: 75 },
+ *     { __FLAT__: false }
+ *   ],
+ *   // Arrays of objects are left as objects; empty/null properties are removed
+ *   scoresDetailed: [
+ *     { score: 1 },
+ *     {}, // null score removed
+ *     { score: 0 },
+ *     { score: false },
+ *     {}, // empty string removed
+ *   ],
+ *   contact: {
+ *     address: '123 Main St'
+ *   }
+ * }
+ */
+declare const toFormFormat: (fields: Record<string, unknown>) => Record<string, unknown>;
+/**
+ * Converts form state to a format suitable for validation by:
+ * - Unwrapping flat array wrappers `{ __FLAT__: <value> }` back to primitives
+ * - Converting legacy string markers (__NULL__, __FALSE__, __ZERO__) back to their original values
+ * - Removing fields whose converted value is empty string or null
+ * - Removing empty arrays
+ *
+ * @example
+ * const formState = {
+ *   name: 'John',
+ *   scores: [
+ *     { __FLAT__: 75 },
+ *     { __FLAT__: 0 },
+ *     { __FLAT__: null },
+ *     { __FLAT__: false }
+ *   ],
+ *   emptyArray: [],
+ *   scoresDetailed: [
+ *     { score: 1 },
+ *     {},
+ *     { score: 0 },
+ *     { score: false },
+ *     {},
+ *   ],
+ *   contact: {
+ *     address: '123 Main St',
+ *     fax: null
+ *   }
+ * };
+ *
+ * // Result:
+ * {
+ *   name: 'John',
+ *   scores: [75, 0, null, false],
+ *   // emptyArray is removed
+ *   // Objects inside arrays remain objects; empty entries remain empty objects
+ *   scoresDetailed: [
+ *     { score: 1 },
+ *     {},
+ *     { score: 0 },
+ *     { score: false },
+ *     {},
+ *   ],
+ *   contact: {
+ *     address: '123 Main St'
+ *   }
+ * }
+ */
+declare const toValidationFormat: (formState: Record<string, unknown> | null | undefined) => Record<string, unknown> | null | undefined;
+/**
+ * Converts a field name to a testId by removing flat array key segments and slugifying.
+ * Removes all occurrences of `flatArrayKey` from the field name and applies slugify transformation.
+ *
+ * This is used to generate stable testIds for form fields that don't include
+ * the internal `__FLAT__` marker used for flat arrays.
+ *
+ * @param name - The field name as a string (e.g., 'tags.0.__FLAT__') or array path (e.g., ['tags', '0', '__FLAT__'])
+ * @returns The slugified field name with all flat array key segments removed (e.g., 'tags_0')
+ *
+ * @example
+ * ```ts
+ * nameToTestId('tags.0.__FLAT__') // => 'tags_0'
+ * nameToTestId('array.0.__FLAT__') // => 'array_0'
+ * nameToTestId('nested.array.0.__FLAT__.field') // => 'nested_array_0_field'
+ * nameToTestId('simple.field') // => 'simple_field'
+ * nameToTestId(['tags', '0', '__FLAT__']) // => 'tags_0'
+ * ```
+ */
+declare const nameToTestId: (name: string | readonly string[]) => string;
+//#endregion
+export { createOptionValueConverter, flatArrayKey, fromNullishString, isValueEmpty, nameToTestId, toFormFormat, toNullishString, toValidationFormat };
+//# sourceMappingURL=index.d.cts.map

package/dist/helpers/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/helpers/createOptionValueConverter/createOptionValueConverter.ts","../../src/helpers/nullishFields/nullishFields.ts"],"sourcesContent":[],"mappings":";;AAeA;;;;;;;;ACZA;AAsCA;AA0BA;AAsCA;AA6Ea,cDvKA,0BC+LgC,EAAA,CAAA,UAAA;EAmDhC,KAAA,EAAA,MAAA,GAAA,MA6EZ,GAAA,OAAA;AAqBD,CAAA,CAAA,CAAA,OAAa,EDjVF,CCiVE,EAAA,EAAA,GAsBZ;;;;;;;;AD1WY,cCZA,YAAA,GD8DZ,UAAA;;;;;;;;AC9DD;AAsCA;AA0BA;AAsCA;AA6EA;AA2EA;AAkGA;;;;;;;;;;;;;;;;cA1Ta;;;;cA0BA;;;;cAsCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA6EA,uBAAwB,4BAwBE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAmD1B,gCACA,+CACV;;;;;;;;;;;;;;;;;;;;cAgGU"}