@fuf-stack/uniform 1.17.0 → 1.18.0

package/dist/{SwitchBox-9KAu4WWd.js.map → SwitchBox-RfkVRDrE.js.map}

@@ -1 +1 @@
-{"version":3,"file":"SwitchBox-9KAu4WWd.js","names":["SwitchBox"],"sources":["../src/SwitchBox/SwitchBox.tsx","../src/SwitchBox/index.ts"],"sourcesContent":["import type { TVClassName } from '@fuf-stack/pixel-utils';\nimport type { SwitchProps as HeroSwitchProps } from '@heroui/switch';\nimport type { ReactNode } from 'react';\n\nimport { useRef } from 'react';\n\nimport { useSwitch } from '@heroui/switch';\nimport { VisuallyHidden } from '@react-aria/visually-hidden';\n\nimport { cn, tv, variantsToClassNames } from '@fuf-stack/pixel-utils';\n\nimport { useUniformField } from '../hooks/useUniformField';\n\nexport const switchBoxVariants = tv({\n  slots: {\n    box: 'group inline-flex w-full cursor-pointer items-center justify-between rounded-lg border-2 border-default hover:bg-content2 data-[selected=true]:border-focus',\n    description: 'text-foreground opacity-70',\n    icon: '',\n    label:\n      'font-medium text-foreground group-data-[required=true]:after:ml-0.5 group-data-[required=true]:after:text-danger group-data-[required=true]:after:content-[\"*\"]',\n    wrapper: '',\n    thumb: '',\n    thumbIcon: '',\n  },\n  variants: {\n    isDisabled: {\n      true: {\n        box: 'pointer-events-none opacity-disabled',\n      },\n    },\n    isInvalid: {\n      true: {\n        box: '!border-danger',\n        label: '!text-danger',\n      },\n    },\n    size: {\n      sm: {\n        box: 'gap-2 p-3',\n        description: 'text-xs',\n        label: 'text-xs',\n      },\n      md: {\n        box: 'gap-4 p-4',\n        description: 'text-small',\n        label: 'text-sm',\n      },\n      lg: {\n        box: 'gap-4 p-5',\n        description: 'text-small',\n        label: 'text-base',\n      },\n    },\n  },\n  defaultVariants: {\n    size: 'md',\n  },\n});\n\ntype ClassName = TVClassName<typeof switchBoxVariants>;\n\nexport interface SwitchBoxProps {\n  /** CSS class name */\n  className?: ClassName;\n  /** Description text displayed below the label */\n  description?: ReactNode;\n  /** whether the switch should be disabled */\n  disabled?: boolean;\n  /** Icon to be displayed in the box */\n  icon?: ReactNode;\n  /** component displayed as the label */\n  label?: ReactNode;\n  /** name the field is registered under */\n  name: string;\n  /** whether the field is required */\n  required?: boolean;\n  /* Size of the switch */\n  size?: 'sm' | 'md' | 'lg';\n  /** HTML data-testid attribute used in e2e tests */\n  testId?: string;\n  /** Icon to be displayed inside the thumb */\n  thumbIcon?: HeroSwitchProps['thumbIcon'];\n}\n\n/**\n * SwitchBox component - A card-like box with a switch control\n */\nconst SwitchBox = ({\n  className = undefined,\n  description = undefined,\n  icon = undefined,\n  name,\n  size = undefined,\n  thumbIcon = undefined,\n  ...uniformFieldProps\n}: SwitchBoxProps) => {\n  const {\n    defaultValue,\n    disabled,\n    errorMessage,\n    field,\n    getErrorMessageProps,\n    getHelperWrapperProps,\n    invalid,\n    label,\n    onBlur,\n    onChange,\n    ref,\n    required,\n    testId,\n  } = useUniformField({\n    name,\n    ...uniformFieldProps,\n  });\n\n  // Ref for the visual switch to forward focus\n  const visualSwitchRef = useRef<HTMLInputElement>(null);\n\n  // Use the useSwitch hook to get access to all the necessary props\n  const {\n    Component,\n    slots,\n    isSelected,\n    getBaseProps,\n    getInputProps,\n    getWrapperProps,\n  } = useSwitch({\n    defaultSelected: !!defaultValue,\n    isDisabled: disabled,\n    isSelected: !!field.value,\n    name: `${name}_switch`,\n    onValueChange: onChange,\n    size,\n    thumbIcon,\n  });\n\n  // classNames from slots\n  const variants = switchBoxVariants({\n    isDisabled: disabled,\n    isInvalid: invalid,\n    size,\n  });\n  const classNames = variantsToClassNames(variants, className, 'box');\n\n  return (\n    <div>\n      <Component\n        {...getBaseProps()}\n        className={classNames.box}\n        data-invalid={invalid}\n        data-required={required}\n        data-testid={testId}\n      >\n        <VisuallyHidden>\n          <input\n            ref={ref}\n            aria-label={typeof label === 'string' ? label : name}\n            checked={!!field.value}\n            name={name}\n            tabIndex={-1}\n            type=\"checkbox\"\n            onChange={(e) => {\n              onChange(e.target.checked);\n            }}\n            onFocus={() => {\n              // When RHF focuses this hidden input (e.g., on validation error),\n              // forward focus to the visual switch to show focus ring\n              visualSwitchRef.current?.focus();\n            }}\n          />\n          {/* Visual switch input for focus ring */}\n          <input\n            ref={visualSwitchRef}\n            {...getInputProps()}\n            onBlur={(e) => {\n              // Call HeroUI's internal onBlur to clear focus state and remove focus ring\n              getInputProps().onBlur?.(e);\n              // Then call RHF's onBlur to mark field as touched\n              onBlur();\n            }}\n          />\n        </VisuallyHidden>\n        {!icon ? (\n          <span\n            {...getWrapperProps()}\n            className={cn(getWrapperProps().className, classNames.wrapper)}\n          >\n            <span className={cn(slots.thumb({ class: classNames.thumb }))}>\n              {thumbIcon && typeof thumbIcon === 'function'\n                ? thumbIcon({\n                    isSelected: !!isSelected,\n                    className: slots.thumbIcon({ class: classNames.thumbIcon }),\n                    width: '1em',\n                    height: '1em',\n                    'data-checked': isSelected ? 'true' : 'false',\n                  })\n                : thumbIcon}\n            </span>\n          </span>\n        ) : null}\n        {icon ? <div className={classNames.icon}>{icon}</div> : null}\n        <div className=\"grow\">\n          {label ? <div className={classNames.label}>{label}</div> : null}\n          {description ? (\n            <div className={classNames.description}>{description}</div>\n          ) : null}\n        </div>\n        {icon ? (\n          <span\n            {...getWrapperProps()}\n            className={cn(getWrapperProps().className, classNames.wrapper)}\n          >\n            <span className={cn(slots.thumb({ class: classNames.thumb }))}>\n              {thumbIcon && typeof thumbIcon === 'function'\n                ? thumbIcon({\n                    isSelected: !!isSelected,\n                    className: slots.thumbIcon({ class: classNames.thumbIcon }),\n                    width: '1em',\n                    height: '1em',\n                    'data-checked': isSelected ? 'true' : 'false',\n                  })\n                : thumbIcon}\n            </span>\n          </span>\n        ) : null}\n      </Component>\n      {invalid ? (\n        <div\n          {...getHelperWrapperProps()}\n          className={cn(\n            getHelperWrapperProps()?.className,\n            // force helper to be visible (for some reason it's hidden by default) and remove margin\n            'ml-0 block',\n          )}\n        >\n          <div {...getErrorMessageProps()}>{errorMessage}</div>\n        </div>\n      ) : null}\n    </div>\n  );\n};\n\nexport default SwitchBox;\n","import SwitchBox from './SwitchBox';\n\nexport type { SwitchBoxProps } from './SwitchBox';\n\nexport { switchBoxVariants } from './SwitchBox';\nexport { SwitchBox };\n\nexport default SwitchBox;\n"],"mappings":"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"}
+{"version":3,"file":"SwitchBox-RfkVRDrE.js","names":["SwitchBox"],"sources":["../src/SwitchBox/SwitchBox.tsx","../src/SwitchBox/index.ts"],"sourcesContent":["import type { TVClassName } from '@fuf-stack/pixel-utils';\nimport type { SwitchProps as HeroSwitchProps } from '@heroui/switch';\nimport type { ReactNode } from 'react';\n\nimport { useRef } from 'react';\n\nimport { useSwitch } from '@heroui/switch';\nimport { VisuallyHidden } from '@react-aria/visually-hidden';\n\nimport { cn, tv, variantsToClassNames } from '@fuf-stack/pixel-utils';\n\nimport { useUniformField } from '../hooks/useUniformField';\n\nexport const switchBoxVariants = tv({\n  slots: {\n    box: 'group inline-flex w-full cursor-pointer items-center justify-between rounded-lg border-2 border-default hover:bg-content2 data-[selected=true]:border-focus',\n    description: 'text-foreground opacity-70',\n    icon: '',\n    label:\n      'font-medium text-foreground group-data-[required=true]:after:ml-0.5 group-data-[required=true]:after:text-danger group-data-[required=true]:after:content-[\"*\"]',\n    wrapper: '',\n    thumb: '',\n    thumbIcon: '',\n  },\n  variants: {\n    isDisabled: {\n      true: {\n        box: 'pointer-events-none opacity-disabled',\n      },\n    },\n    isInvalid: {\n      true: {\n        box: '!border-danger',\n        label: '!text-danger',\n      },\n    },\n    size: {\n      sm: {\n        box: 'gap-2 p-3',\n        description: 'text-xs',\n        label: 'text-xs',\n      },\n      md: {\n        box: 'gap-4 p-4',\n        description: 'text-small',\n        label: 'text-sm',\n      },\n      lg: {\n        box: 'gap-4 p-5',\n        description: 'text-small',\n        label: 'text-base',\n      },\n    },\n  },\n  defaultVariants: {\n    size: 'md',\n  },\n});\n\ntype ClassName = TVClassName<typeof switchBoxVariants>;\n\nexport interface SwitchBoxProps {\n  /** CSS class name */\n  className?: ClassName;\n  /** Description text displayed below the label */\n  description?: ReactNode;\n  /** whether the switch should be disabled */\n  disabled?: boolean;\n  /** Icon to be displayed in the box */\n  icon?: ReactNode;\n  /** component displayed as the label */\n  label?: ReactNode;\n  /** name the field is registered under */\n  name: string;\n  /** whether the field is required */\n  required?: boolean;\n  /* Size of the switch */\n  size?: 'sm' | 'md' | 'lg';\n  /** HTML data-testid attribute used in e2e tests */\n  testId?: string;\n  /** Icon to be displayed inside the thumb */\n  thumbIcon?: HeroSwitchProps['thumbIcon'];\n}\n\n/**\n * SwitchBox component - A card-like box with a switch control\n */\nconst SwitchBox = ({\n  className = undefined,\n  description = undefined,\n  icon = undefined,\n  name,\n  size = undefined,\n  thumbIcon = undefined,\n  ...uniformFieldProps\n}: SwitchBoxProps) => {\n  const {\n    defaultValue,\n    disabled,\n    errorMessage,\n    field,\n    getErrorMessageProps,\n    getHelperWrapperProps,\n    invalid,\n    label,\n    onBlur,\n    onChange,\n    ref,\n    required,\n    testId,\n  } = useUniformField({\n    name,\n    ...uniformFieldProps,\n  });\n\n  // Ref for the visual switch to forward focus\n  const visualSwitchRef = useRef<HTMLInputElement>(null);\n\n  // Use the useSwitch hook to get access to all the necessary props\n  const {\n    Component,\n    slots,\n    isSelected,\n    getBaseProps,\n    getInputProps,\n    getWrapperProps,\n  } = useSwitch({\n    defaultSelected: !!defaultValue,\n    isDisabled: disabled,\n    isSelected: !!field.value,\n    name: `${name}_switch`,\n    onValueChange: onChange,\n    size,\n    thumbIcon,\n  });\n\n  // classNames from slots\n  const variants = switchBoxVariants({\n    isDisabled: disabled,\n    isInvalid: invalid,\n    size,\n  });\n  const classNames = variantsToClassNames(variants, className, 'box');\n\n  return (\n    <div>\n      <Component\n        {...getBaseProps()}\n        className={classNames.box}\n        data-invalid={invalid}\n        data-required={required}\n        data-testid={testId}\n      >\n        <VisuallyHidden>\n          <input\n            ref={ref}\n            aria-label={typeof label === 'string' ? label : name}\n            checked={!!field.value}\n            name={name}\n            tabIndex={-1}\n            type=\"checkbox\"\n            onChange={(e) => {\n              onChange(e.target.checked);\n            }}\n            onFocus={() => {\n              // When RHF focuses this hidden input (e.g., on validation error),\n              // forward focus to the visual switch to show focus ring\n              visualSwitchRef.current?.focus();\n            }}\n          />\n          {/* Visual switch input for focus ring */}\n          <input\n            ref={visualSwitchRef}\n            {...getInputProps()}\n            onBlur={(e) => {\n              // Call HeroUI's internal onBlur to clear focus state and remove focus ring\n              getInputProps().onBlur?.(e);\n              // Then call RHF's onBlur to mark field as touched\n              onBlur();\n            }}\n          />\n        </VisuallyHidden>\n        {!icon ? (\n          <span\n            {...getWrapperProps()}\n            className={cn(getWrapperProps().className, classNames.wrapper)}\n          >\n            <span className={cn(slots.thumb({ class: classNames.thumb }))}>\n              {thumbIcon && typeof thumbIcon === 'function'\n                ? thumbIcon({\n                    isSelected: !!isSelected,\n                    className: slots.thumbIcon({ class: classNames.thumbIcon }),\n                    width: '1em',\n                    height: '1em',\n                    'data-checked': isSelected ? 'true' : 'false',\n                  })\n                : thumbIcon}\n            </span>\n          </span>\n        ) : null}\n        {icon ? <div className={classNames.icon}>{icon}</div> : null}\n        <div className=\"grow\">\n          {label ? <div className={classNames.label}>{label}</div> : null}\n          {description ? (\n            <div className={classNames.description}>{description}</div>\n          ) : null}\n        </div>\n        {icon ? (\n          <span\n            {...getWrapperProps()}\n            className={cn(getWrapperProps().className, classNames.wrapper)}\n          >\n            <span className={cn(slots.thumb({ class: classNames.thumb }))}>\n              {thumbIcon && typeof thumbIcon === 'function'\n                ? thumbIcon({\n                    isSelected: !!isSelected,\n                    className: slots.thumbIcon({ class: classNames.thumbIcon }),\n                    width: '1em',\n                    height: '1em',\n                    'data-checked': isSelected ? 'true' : 'false',\n                  })\n                : thumbIcon}\n            </span>\n          </span>\n        ) : null}\n      </Component>\n      {invalid ? (\n        <div\n          {...getHelperWrapperProps()}\n          className={cn(\n            getHelperWrapperProps()?.className,\n            // force helper to be visible (for some reason it's hidden by default) and remove margin\n            'ml-0 block',\n          )}\n        >\n          <div {...getErrorMessageProps()}>{errorMessage}</div>\n        </div>\n      ) : null}\n    </div>\n  );\n};\n\nexport default SwitchBox;\n","import SwitchBox from './SwitchBox';\n\nexport type { SwitchBoxProps } from './SwitchBox';\n\nexport { switchBoxVariants } from './SwitchBox';\nexport { SwitchBox };\n\nexport default SwitchBox;\n"],"mappings":"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"}

package/dist/TextArea/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, '__esModule', { value: true });
-const require_TextArea = require('../TextArea-DRSFdn5v.cjs');
+const require_TextArea = require('../TextArea-BYEuk4Ng.cjs');
 
 exports.TextArea = require_TextArea.TextArea_default$1;
 exports.default = require_TextArea.TextArea_default;

package/dist/TextArea/index.d.cts

@@ -1,2 +1,2 @@
-import { n as TextAreaProps, t as TextArea } from "../index-Y8XsRdxS.cjs";
+import { n as TextAreaProps, t as TextArea } from "../index-CwtoC1DE.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-B62CWrcm.js";
+import { n as TextAreaProps, t as TextArea } from "../index-CELx_Pr_.js";
 export { TextArea, TextArea as default, TextAreaProps };

package/dist/TextArea/index.js

@@ -1,3 +1,3 @@
-import { n as TextArea_default, t as TextArea_default$1 } from "../TextArea-B0zYpNy-.js";
+import { n as TextArea_default, t as TextArea_default$1 } from "../TextArea-BLkVYmHZ.js";
 
 export { TextArea_default as TextArea, TextArea_default$1 as default };

package/dist/{TextArea-B0zYpNy-.js → TextArea-BLkVYmHZ.js}

@@ -1,5 +1,5 @@
-import { t as useUniformField } from "./useUniformField-C6oSAFa3.js";
-import { t as useInputValueDebounce } from "./useInputValueDebounce-D9wArTKz.js";
+import { t as useUniformField } from "./useUniformField-C-Xyu-8v.js";
+import { t as useInputValueDebounce } from "./useInputValueDebounce-DJO5uzLb.js";
 import { tv, variantsToClassNames } from "@fuf-stack/pixel-utils";
 import { jsx } from "react/jsx-runtime";
 import { Textarea } from "@heroui/input";
@@ -62,4 +62,4 @@ var TextArea_default = TextArea_default$1;
 
 //#endregion
 export { TextArea_default$1 as n, TextArea_default as t };
-//# sourceMappingURL=TextArea-B0zYpNy-.js.map
+//# sourceMappingURL=TextArea-BLkVYmHZ.js.map

package/dist/{TextArea-B0zYpNy-.js.map → TextArea-BLkVYmHZ.js.map}

@@ -1 +1 @@
-{"version":3,"file":"TextArea-B0zYpNy-.js","names":["HeroTextArea","TextArea"],"sources":["../src/TextArea/TextArea.tsx","../src/TextArea/index.ts"],"sourcesContent":["import type { TVClassName, TVProps } from '@fuf-stack/pixel-utils';\nimport type { ReactNode } from 'react';\n\nimport { Textarea as HeroTextArea } from '@heroui/input';\n\nimport { tv, variantsToClassNames } from '@fuf-stack/pixel-utils';\n\nimport { useInputValueDebounce } from '../hooks/useInputValueDebounce';\nimport { useUniformField } from '../hooks/useUniformField';\n\n// input variants\nexport const textAreaVariants = tv({\n  slots: {\n    /** wrapper around the whole input */\n    base: '',\n    /** clear button */\n    clearButton: '',\n    /** actual input element */\n    input: '',\n    /** inner wrapper (HeroUI inputWrapper slot) */\n    inputWrapper: 'bg-content1 group-data-[focus=true]:border-focus',\n  },\n});\n\ntype VariantProps = TVProps<typeof textAreaVariants>;\ntype ClassName = TVClassName<typeof textAreaVariants>;\n\nexport interface TextAreaProps extends VariantProps {\n  /** Custom aria-label for accessibility. If not provided, falls back to field name when no visible label exists */\n  ariaLabel?: string;\n  /** Child components. The content of the textarea. */\n  children?: ReactNode;\n  /** CSS class name */\n  className?: ClassName;\n  /** debounce delay in milliseconds for form state updates (default: 300ms) */\n  debounceDelay?: number;\n  /** Determines if the TextArea is disabled or not. */\n  disabled?: boolean;\n  /** Label displayed above the TextArea. */\n  label?: ReactNode;\n  /** Name the TextArea is registered at in HTML forms (react-hook-form). */\n  name: string;\n  /** placeholder for the textArea content. */\n  placeholder?: string;\n  /** Id to grab element in internal tests. */\n  testId?: string;\n}\n\n/**\n * TextArea component based on [HeroUI TextArea](https://www.heroui.com//docs/components/textarea)\n */\nconst TextArea = ({\n  children = null,\n  className: _className = undefined,\n  debounceDelay = 300,\n  name,\n  placeholder = ' ',\n  ...uniformFieldProps\n}: TextAreaProps) => {\n  const {\n    ariaLabel,\n    disabled,\n    errorMessage,\n    field: {\n      onChange: fieldOnChange,\n      onBlur: fieldOnBlur,\n      value: fieldValue,\n      ref,\n    },\n    invalid,\n    label,\n    required,\n    testId,\n  } = useUniformField({ name, ...uniformFieldProps });\n\n  // Use debounced handlers for form updates\n  const { onChange, onBlur, value } = useInputValueDebounce({\n    debounceDelay,\n    name,\n    onBlur: fieldOnBlur,\n    onChange: fieldOnChange,\n    value: fieldValue,\n  });\n\n  // classNames from slots\n  const variants = textAreaVariants();\n  const classNames = variantsToClassNames(variants, _className, 'base');\n\n  return (\n    <HeroTextArea\n      ref={ref}\n      data-testid={testId}\n      errorMessage={errorMessage}\n      id={testId}\n      isDisabled={disabled}\n      isInvalid={invalid}\n      isRequired={required}\n      label={label}\n      labelPlacement=\"outside\"\n      name={name}\n      onBlur={onBlur}\n      onChange={onChange}\n      placeholder={placeholder}\n      value={value}\n      variant=\"bordered\"\n      // Only add aria-label if there's no meaningful placeholder (HeroUI uses placeholder as aria-label)\n      aria-label={\n        !placeholder || placeholder.trim() === '' ? ariaLabel : undefined\n      }\n      classNames={{\n        base: classNames.base,\n        clearButton: classNames.clearButton,\n        // set padding to 0 for error message exit animation\n        helperWrapper: 'p-0',\n        input: classNames.input,\n        inputWrapper: classNames.inputWrapper,\n      }}\n    >\n      {children}\n    </HeroTextArea>\n  );\n};\n\nexport default TextArea;\n","import TextArea from './TextArea';\n\nexport type { TextAreaProps } from './TextArea';\n\nexport { TextArea };\n\nexport default TextArea;\n"],"mappings":";;;;;;;AAWA,MAAa,mBAAmB,GAAG,EACjC,OAAO;CAEL,MAAM;CAEN,aAAa;CAEb,OAAO;CAEP,cAAc;CACf,EACF,CAAC;;;;AA6BF,MAAM,YAAY,EAChB,WAAW,MACX,WAAW,aAAa,QACxB,gBAAgB,KAChB,MACA,cAAc,KACd,GAAG,wBACgB;CACnB,MAAM,EACJ,WACA,UACA,cACA,OAAO,EACL,UAAU,eACV,QAAQ,aACR,OAAO,YACP,OAEF,SACA,OACA,UACA,WACE,gBAAgB;EAAE;EAAM,GAAG;EAAmB,CAAC;CAGnD,MAAM,EAAE,UAAU,QAAQ,UAAU,sBAAsB;EACxD;EACA;EACA,QAAQ;EACR,UAAU;EACV,OAAO;EACR,CAAC;CAIF,MAAM,aAAa,qBADF,kBAAkB,EACe,YAAY,OAAO;AAErE,QACE,oBAACA;EACM;EACL,eAAa;EACC;EACd,IAAI;EACJ,YAAY;EACZ,WAAW;EACX,YAAY;EACL;EACP,gBAAe;EACT;EACE;EACE;EACG;EACN;EACP,SAAQ;EAER,cACE,CAAC,eAAe,YAAY,MAAM,KAAK,KAAK,YAAY;EAE1D,YAAY;GACV,MAAM,WAAW;GACjB,aAAa,WAAW;GAExB,eAAe;GACf,OAAO,WAAW;GAClB,cAAc,WAAW;GAC1B;EAEA;GACY;;AAInB,yBAAe;;;;ACrHf,uBAAeC"}
+{"version":3,"file":"TextArea-BLkVYmHZ.js","names":["HeroTextArea","TextArea"],"sources":["../src/TextArea/TextArea.tsx","../src/TextArea/index.ts"],"sourcesContent":["import type { TVClassName, TVProps } from '@fuf-stack/pixel-utils';\nimport type { ReactNode } from 'react';\n\nimport { Textarea as HeroTextArea } from '@heroui/input';\n\nimport { tv, variantsToClassNames } from '@fuf-stack/pixel-utils';\n\nimport { useInputValueDebounce } from '../hooks/useInputValueDebounce';\nimport { useUniformField } from '../hooks/useUniformField';\n\n// input variants\nexport const textAreaVariants = tv({\n  slots: {\n    /** wrapper around the whole input */\n    base: '',\n    /** clear button */\n    clearButton: '',\n    /** actual input element */\n    input: '',\n    /** inner wrapper (HeroUI inputWrapper slot) */\n    inputWrapper: 'bg-content1 group-data-[focus=true]:border-focus',\n  },\n});\n\ntype VariantProps = TVProps<typeof textAreaVariants>;\ntype ClassName = TVClassName<typeof textAreaVariants>;\n\nexport interface TextAreaProps extends VariantProps {\n  /** Custom aria-label for accessibility. If not provided, falls back to field name when no visible label exists */\n  ariaLabel?: string;\n  /** Child components. The content of the textarea. */\n  children?: ReactNode;\n  /** CSS class name */\n  className?: ClassName;\n  /** debounce delay in milliseconds for form state updates (default: 300ms) */\n  debounceDelay?: number;\n  /** Determines if the TextArea is disabled or not. */\n  disabled?: boolean;\n  /** Label displayed above the TextArea. */\n  label?: ReactNode;\n  /** Name the TextArea is registered at in HTML forms (react-hook-form). */\n  name: string;\n  /** placeholder for the textArea content. */\n  placeholder?: string;\n  /** Id to grab element in internal tests. */\n  testId?: string;\n}\n\n/**\n * TextArea component based on [HeroUI TextArea](https://www.heroui.com//docs/components/textarea)\n */\nconst TextArea = ({\n  children = null,\n  className: _className = undefined,\n  debounceDelay = 300,\n  name,\n  placeholder = ' ',\n  ...uniformFieldProps\n}: TextAreaProps) => {\n  const {\n    ariaLabel,\n    disabled,\n    errorMessage,\n    field: {\n      onChange: fieldOnChange,\n      onBlur: fieldOnBlur,\n      value: fieldValue,\n      ref,\n    },\n    invalid,\n    label,\n    required,\n    testId,\n  } = useUniformField({ name, ...uniformFieldProps });\n\n  // Use debounced handlers for form updates\n  const { onChange, onBlur, value } = useInputValueDebounce({\n    debounceDelay,\n    name,\n    onBlur: fieldOnBlur,\n    onChange: fieldOnChange,\n    value: fieldValue,\n  });\n\n  // classNames from slots\n  const variants = textAreaVariants();\n  const classNames = variantsToClassNames(variants, _className, 'base');\n\n  return (\n    <HeroTextArea\n      ref={ref}\n      data-testid={testId}\n      errorMessage={errorMessage}\n      id={testId}\n      isDisabled={disabled}\n      isInvalid={invalid}\n      isRequired={required}\n      label={label}\n      labelPlacement=\"outside\"\n      name={name}\n      onBlur={onBlur}\n      onChange={onChange}\n      placeholder={placeholder}\n      value={value}\n      variant=\"bordered\"\n      // Only add aria-label if there's no meaningful placeholder (HeroUI uses placeholder as aria-label)\n      aria-label={\n        !placeholder || placeholder.trim() === '' ? ariaLabel : undefined\n      }\n      classNames={{\n        base: classNames.base,\n        clearButton: classNames.clearButton,\n        // set padding to 0 for error message exit animation\n        helperWrapper: 'p-0',\n        input: classNames.input,\n        inputWrapper: classNames.inputWrapper,\n      }}\n    >\n      {children}\n    </HeroTextArea>\n  );\n};\n\nexport default TextArea;\n","import TextArea from './TextArea';\n\nexport type { TextAreaProps } from './TextArea';\n\nexport { TextArea };\n\nexport default TextArea;\n"],"mappings":";;;;;;;AAWA,MAAa,mBAAmB,GAAG,EACjC,OAAO;CAEL,MAAM;CAEN,aAAa;CAEb,OAAO;CAEP,cAAc;CACf,EACF,CAAC;;;;AA6BF,MAAM,YAAY,EAChB,WAAW,MACX,WAAW,aAAa,QACxB,gBAAgB,KAChB,MACA,cAAc,KACd,GAAG,wBACgB;CACnB,MAAM,EACJ,WACA,UACA,cACA,OAAO,EACL,UAAU,eACV,QAAQ,aACR,OAAO,YACP,OAEF,SACA,OACA,UACA,WACE,gBAAgB;EAAE;EAAM,GAAG;EAAmB,CAAC;CAGnD,MAAM,EAAE,UAAU,QAAQ,UAAU,sBAAsB;EACxD;EACA;EACA,QAAQ;EACR,UAAU;EACV,OAAO;EACR,CAAC;CAIF,MAAM,aAAa,qBADF,kBAAkB,EACe,YAAY,OAAO;AAErE,QACE,oBAACA;EACM;EACL,eAAa;EACC;EACd,IAAI;EACJ,YAAY;EACZ,WAAW;EACX,YAAY;EACL;EACP,gBAAe;EACT;EACE;EACE;EACG;EACN;EACP,SAAQ;EAER,cACE,CAAC,eAAe,YAAY,MAAM,KAAK,KAAK,YAAY;EAE1D,YAAY;GACV,MAAM,WAAW;GACjB,aAAa,WAAW;GAExB,eAAe;GACf,OAAO,WAAW;GAClB,cAAc,WAAW;GAC1B;EAEA;GACY;;AAInB,yBAAe;;;;ACrHf,uBAAeC"}

package/dist/{TextArea-DRSFdn5v.cjs → TextArea-BYEuk4Ng.cjs}

@@ -1,6 +1,6 @@
-const require_FormContext = require('./FormContext-CeFKQmVH.cjs');
-const require_useUniformField = require('./useUniformField-Dd3AnpgE.cjs');
-const require_useInputValueDebounce = require('./useInputValueDebounce-KIKsvSLm.cjs');
+const require_FormContext = require('./FormContext-BSLO2-sO.cjs');
+const require_useUniformField = require('./useUniformField-6c4OCAfb.cjs');
+const require_useInputValueDebounce = require('./useInputValueDebounce-CRaM7HEM.cjs');
 let _fuf_stack_pixel_utils = require("@fuf-stack/pixel-utils");
 let react_jsx_runtime = require("react/jsx-runtime");
 let _heroui_input = require("@heroui/input");
@@ -74,4 +74,4 @@ Object.defineProperty(exports, 'TextArea_default$1', {
     return TextArea_default$1;
   }
 });
-//# sourceMappingURL=TextArea-DRSFdn5v.cjs.map
+//# sourceMappingURL=TextArea-BYEuk4Ng.cjs.map

package/dist/{TextArea-DRSFdn5v.cjs.map → TextArea-BYEuk4Ng.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"TextArea-DRSFdn5v.cjs","names":["useUniformField","useInputValueDebounce","HeroTextArea","TextArea"],"sources":["../src/TextArea/TextArea.tsx","../src/TextArea/index.ts"],"sourcesContent":["import type { TVClassName, TVProps } from '@fuf-stack/pixel-utils';\nimport type { ReactNode } from 'react';\n\nimport { Textarea as HeroTextArea } from '@heroui/input';\n\nimport { tv, variantsToClassNames } from '@fuf-stack/pixel-utils';\n\nimport { useInputValueDebounce } from '../hooks/useInputValueDebounce';\nimport { useUniformField } from '../hooks/useUniformField';\n\n// input variants\nexport const textAreaVariants = tv({\n  slots: {\n    /** wrapper around the whole input */\n    base: '',\n    /** clear button */\n    clearButton: '',\n    /** actual input element */\n    input: '',\n    /** inner wrapper (HeroUI inputWrapper slot) */\n    inputWrapper: 'bg-content1 group-data-[focus=true]:border-focus',\n  },\n});\n\ntype VariantProps = TVProps<typeof textAreaVariants>;\ntype ClassName = TVClassName<typeof textAreaVariants>;\n\nexport interface TextAreaProps extends VariantProps {\n  /** Custom aria-label for accessibility. If not provided, falls back to field name when no visible label exists */\n  ariaLabel?: string;\n  /** Child components. The content of the textarea. */\n  children?: ReactNode;\n  /** CSS class name */\n  className?: ClassName;\n  /** debounce delay in milliseconds for form state updates (default: 300ms) */\n  debounceDelay?: number;\n  /** Determines if the TextArea is disabled or not. */\n  disabled?: boolean;\n  /** Label displayed above the TextArea. */\n  label?: ReactNode;\n  /** Name the TextArea is registered at in HTML forms (react-hook-form). */\n  name: string;\n  /** placeholder for the textArea content. */\n  placeholder?: string;\n  /** Id to grab element in internal tests. */\n  testId?: string;\n}\n\n/**\n * TextArea component based on [HeroUI TextArea](https://www.heroui.com//docs/components/textarea)\n */\nconst TextArea = ({\n  children = null,\n  className: _className = undefined,\n  debounceDelay = 300,\n  name,\n  placeholder = ' ',\n  ...uniformFieldProps\n}: TextAreaProps) => {\n  const {\n    ariaLabel,\n    disabled,\n    errorMessage,\n    field: {\n      onChange: fieldOnChange,\n      onBlur: fieldOnBlur,\n      value: fieldValue,\n      ref,\n    },\n    invalid,\n    label,\n    required,\n    testId,\n  } = useUniformField({ name, ...uniformFieldProps });\n\n  // Use debounced handlers for form updates\n  const { onChange, onBlur, value } = useInputValueDebounce({\n    debounceDelay,\n    name,\n    onBlur: fieldOnBlur,\n    onChange: fieldOnChange,\n    value: fieldValue,\n  });\n\n  // classNames from slots\n  const variants = textAreaVariants();\n  const classNames = variantsToClassNames(variants, _className, 'base');\n\n  return (\n    <HeroTextArea\n      ref={ref}\n      data-testid={testId}\n      errorMessage={errorMessage}\n      id={testId}\n      isDisabled={disabled}\n      isInvalid={invalid}\n      isRequired={required}\n      label={label}\n      labelPlacement=\"outside\"\n      name={name}\n      onBlur={onBlur}\n      onChange={onChange}\n      placeholder={placeholder}\n      value={value}\n      variant=\"bordered\"\n      // Only add aria-label if there's no meaningful placeholder (HeroUI uses placeholder as aria-label)\n      aria-label={\n        !placeholder || placeholder.trim() === '' ? ariaLabel : undefined\n      }\n      classNames={{\n        base: classNames.base,\n        clearButton: classNames.clearButton,\n        // set padding to 0 for error message exit animation\n        helperWrapper: 'p-0',\n        input: classNames.input,\n        inputWrapper: classNames.inputWrapper,\n      }}\n    >\n      {children}\n    </HeroTextArea>\n  );\n};\n\nexport default TextArea;\n","import TextArea from './TextArea';\n\nexport type { TextAreaProps } from './TextArea';\n\nexport { TextArea };\n\nexport default TextArea;\n"],"mappings":";;;;;;;;AAWA,MAAa,kDAAsB,EACjC,OAAO;CAEL,MAAM;CAEN,aAAa;CAEb,OAAO;CAEP,cAAc;CACf,EACF,CAAC;;;;AA6BF,MAAM,YAAY,EAChB,WAAW,MACX,WAAW,aAAa,QACxB,gBAAgB,KAChB,MACA,cAAc,KACd,GAAG,wBACgB;CACnB,MAAM,EACJ,WACA,UACA,cACA,OAAO,EACL,UAAU,eACV,QAAQ,aACR,OAAO,YACP,OAEF,SACA,OACA,UACA,WACEA,wCAAgB;EAAE;EAAM,GAAG;EAAmB,CAAC;CAGnD,MAAM,EAAE,UAAU,QAAQ,UAAUC,oDAAsB;EACxD;EACA;EACA,QAAQ;EACR,UAAU;EACV,OAAO;EACR,CAAC;CAIF,MAAM,8DADW,kBAAkB,EACe,YAAY,OAAO;AAErE,QACE,2CAACC;EACM;EACL,eAAa;EACC;EACd,IAAI;EACJ,YAAY;EACZ,WAAW;EACX,YAAY;EACL;EACP,gBAAe;EACT;EACE;EACE;EACG;EACN;EACP,SAAQ;EAER,cACE,CAAC,eAAe,YAAY,MAAM,KAAK,KAAK,YAAY;EAE1D,YAAY;GACV,MAAM,WAAW;GACjB,aAAa,WAAW;GAExB,eAAe;GACf,OAAO,WAAW;GAClB,cAAc,WAAW;GAC1B;EAEA;GACY;;AAInB,yBAAe;;;;ACrHf,uBAAeC"}
+{"version":3,"file":"TextArea-BYEuk4Ng.cjs","names":["useUniformField","useInputValueDebounce","HeroTextArea","TextArea"],"sources":["../src/TextArea/TextArea.tsx","../src/TextArea/index.ts"],"sourcesContent":["import type { TVClassName, TVProps } from '@fuf-stack/pixel-utils';\nimport type { ReactNode } from 'react';\n\nimport { Textarea as HeroTextArea } from '@heroui/input';\n\nimport { tv, variantsToClassNames } from '@fuf-stack/pixel-utils';\n\nimport { useInputValueDebounce } from '../hooks/useInputValueDebounce';\nimport { useUniformField } from '../hooks/useUniformField';\n\n// input variants\nexport const textAreaVariants = tv({\n  slots: {\n    /** wrapper around the whole input */\n    base: '',\n    /** clear button */\n    clearButton: '',\n    /** actual input element */\n    input: '',\n    /** inner wrapper (HeroUI inputWrapper slot) */\n    inputWrapper: 'bg-content1 group-data-[focus=true]:border-focus',\n  },\n});\n\ntype VariantProps = TVProps<typeof textAreaVariants>;\ntype ClassName = TVClassName<typeof textAreaVariants>;\n\nexport interface TextAreaProps extends VariantProps {\n  /** Custom aria-label for accessibility. If not provided, falls back to field name when no visible label exists */\n  ariaLabel?: string;\n  /** Child components. The content of the textarea. */\n  children?: ReactNode;\n  /** CSS class name */\n  className?: ClassName;\n  /** debounce delay in milliseconds for form state updates (default: 300ms) */\n  debounceDelay?: number;\n  /** Determines if the TextArea is disabled or not. */\n  disabled?: boolean;\n  /** Label displayed above the TextArea. */\n  label?: ReactNode;\n  /** Name the TextArea is registered at in HTML forms (react-hook-form). */\n  name: string;\n  /** placeholder for the textArea content. */\n  placeholder?: string;\n  /** Id to grab element in internal tests. */\n  testId?: string;\n}\n\n/**\n * TextArea component based on [HeroUI TextArea](https://www.heroui.com//docs/components/textarea)\n */\nconst TextArea = ({\n  children = null,\n  className: _className = undefined,\n  debounceDelay = 300,\n  name,\n  placeholder = ' ',\n  ...uniformFieldProps\n}: TextAreaProps) => {\n  const {\n    ariaLabel,\n    disabled,\n    errorMessage,\n    field: {\n      onChange: fieldOnChange,\n      onBlur: fieldOnBlur,\n      value: fieldValue,\n      ref,\n    },\n    invalid,\n    label,\n    required,\n    testId,\n  } = useUniformField({ name, ...uniformFieldProps });\n\n  // Use debounced handlers for form updates\n  const { onChange, onBlur, value } = useInputValueDebounce({\n    debounceDelay,\n    name,\n    onBlur: fieldOnBlur,\n    onChange: fieldOnChange,\n    value: fieldValue,\n  });\n\n  // classNames from slots\n  const variants = textAreaVariants();\n  const classNames = variantsToClassNames(variants, _className, 'base');\n\n  return (\n    <HeroTextArea\n      ref={ref}\n      data-testid={testId}\n      errorMessage={errorMessage}\n      id={testId}\n      isDisabled={disabled}\n      isInvalid={invalid}\n      isRequired={required}\n      label={label}\n      labelPlacement=\"outside\"\n      name={name}\n      onBlur={onBlur}\n      onChange={onChange}\n      placeholder={placeholder}\n      value={value}\n      variant=\"bordered\"\n      // Only add aria-label if there's no meaningful placeholder (HeroUI uses placeholder as aria-label)\n      aria-label={\n        !placeholder || placeholder.trim() === '' ? ariaLabel : undefined\n      }\n      classNames={{\n        base: classNames.base,\n        clearButton: classNames.clearButton,\n        // set padding to 0 for error message exit animation\n        helperWrapper: 'p-0',\n        input: classNames.input,\n        inputWrapper: classNames.inputWrapper,\n      }}\n    >\n      {children}\n    </HeroTextArea>\n  );\n};\n\nexport default TextArea;\n","import TextArea from './TextArea';\n\nexport type { TextAreaProps } from './TextArea';\n\nexport { TextArea };\n\nexport default TextArea;\n"],"mappings":";;;;;;;;AAWA,MAAa,kDAAsB,EACjC,OAAO;CAEL,MAAM;CAEN,aAAa;CAEb,OAAO;CAEP,cAAc;CACf,EACF,CAAC;;;;AA6BF,MAAM,YAAY,EAChB,WAAW,MACX,WAAW,aAAa,QACxB,gBAAgB,KAChB,MACA,cAAc,KACd,GAAG,wBACgB;CACnB,MAAM,EACJ,WACA,UACA,cACA,OAAO,EACL,UAAU,eACV,QAAQ,aACR,OAAO,YACP,OAEF,SACA,OACA,UACA,WACEA,wCAAgB;EAAE;EAAM,GAAG;EAAmB,CAAC;CAGnD,MAAM,EAAE,UAAU,QAAQ,UAAUC,oDAAsB;EACxD;EACA;EACA,QAAQ;EACR,UAAU;EACV,OAAO;EACR,CAAC;CAIF,MAAM,8DADW,kBAAkB,EACe,YAAY,OAAO;AAErE,QACE,2CAACC;EACM;EACL,eAAa;EACC;EACd,IAAI;EACJ,YAAY;EACZ,WAAW;EACX,YAAY;EACL;EACP,gBAAe;EACT;EACE;EACE;EACG;EACN;EACP,SAAQ;EAER,cACE,CAAC,eAAe,YAAY,MAAM,KAAK,KAAK,YAAY;EAE1D,YAAY;GACV,MAAM,WAAW;GACjB,aAAa,WAAW;GAExB,eAAe;GACf,OAAO,WAAW;GAClB,cAAc,WAAW;GAC1B;EAEA;GACY;;AAInB,yBAAe;;;;ACrHf,uBAAeC"}

package/dist/helpers/index.cjs

@@ -1,4 +1,4 @@
-const require_helpers = require('../helpers-CncbgvW_.cjs');
+const require_helpers = require('../helpers-Bd_QpqXg.cjs');
 
 exports.createOptionValueConverter = require_helpers.createOptionValueConverter;
 exports.flatArrayKey = require_helpers.flatArrayKey;
@@ -7,4 +7,5 @@ exports.isValueEmpty = require_helpers.isValueEmpty;
 exports.nameToTestId = require_helpers.nameToTestId;
 exports.toFormFormat = require_helpers.toFormFormat;
 exports.toNullishString = require_helpers.toNullishString;
+exports.toSubmitFormat = require_helpers.toSubmitFormat;
 exports.toValidationFormat = require_helpers.toValidationFormat;

package/dist/helpers/index.d.cts

@@ -161,6 +161,44 @@ declare const toFormFormat: (fields: Record<string, unknown>) => Record<string,
  * }
  */
 declare const toValidationFormat: (formState: Record<string, unknown> | null | undefined) => Record<string, unknown> | null | undefined;
+/**
+ * Converts form state to a format suitable for submission by:
+ * - Applying all transformations from toValidationFormat
+ * - Additionally removing empty objects from the result
+ * - Filtering empty objects from arrays
+ * - Recursively cleaning nested structures
+ *
+ * **Why separate from toValidationFormat?**
+ *
+ * Empty objects must be preserved during validation so that custom refinements
+ * can run. For example, a FieldCard with "at least email or phone required"
+ * validation needs the object to exist (even if empty) for the refine to execute.
+ *
+ * However, for submission, empty objects are meaningless and should be removed
+ * to produce clean data for APIs.
+ *
+ * @example
+ * const formState = {
+ *   name: 'John',
+ *   contact: {},           // Empty FieldCard - will be removed
+ *   tags: [{}, {}, {}],    // All empty - array will be removed
+ *   items: [
+ *     { value: 'a' },
+ *     {},                  // Empty entry - will be filtered out
+ *     { value: 'b' }
+ *   ],
+ *   nested: {
+ *     deep: {}             // Nested empty - will be removed recursively
+ *   }
+ * };
+ *
+ * // Result:
+ * {
+ *   name: 'John',
+ *   items: [{ value: 'a' }, { value: 'b' }]
+ * }
+ */
+declare const toSubmitFormat: (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.
@@ -182,5 +220,5 @@ declare const toValidationFormat: (formState: Record<string, unknown> | null | u
  */
 declare const nameToTestId: (name: string | readonly string[]) => string;
 //#endregion
-export { createOptionValueConverter, flatArrayKey, fromNullishString, isValueEmpty, nameToTestId, toFormFormat, toNullishString, toValidationFormat };
+export { createOptionValueConverter, flatArrayKey, fromNullishString, isValueEmpty, nameToTestId, toFormFormat, toNullishString, toSubmitFormat, toValidationFormat };
 //# sourceMappingURL=index.d.cts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/helpers/createOptionValueConverter/createOptionValueConverter.ts","../../src/helpers/nullishFields/nullishFields.ts"],"mappings":";;AAeA;;;;;;;;;;;;cAAa,0BAAA;EACC,KAAA;AAAA,GAEZ,OAAA,EAAS,CAAA;;;;;;;;cCfE,YAAA;;;;;;;;;;;;;;;;;;;;;;;AAAb;;;;;AAsCA;;cAAa,YAAA,GAAgB,KAAA;;;AA0B7B;cAAa,iBAAA,GAAqB,KAAA;;;;cAsCrB,eAAA,GAAmB,KAAA;;;;;AA6EhC;;;;;;;;;AA2EA;;;;;;;;;AAyKA;;;;;;;;;AA6BA;;;;;;;;;;;;;;;;;;;cAjRa,YAAA,GAAgB,MAAA,EAAQ,MAAA,sBAwBE,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAmD1B,kBAAA,GACX,SAAA,EAAW,MAAA,yCACV,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAuKU,cAAA,GACX,SAAA,EAAW,MAAA,yCACV,MAAA;;;;;;;;;;;;;;;;;;;;cA2BU,YAAA,GAAgB,IAAA"}

package/dist/helpers/index.d.ts

@@ -161,6 +161,44 @@ declare const toFormFormat: (fields: Record<string, unknown>) => Record<string,
  * }
  */
 declare const toValidationFormat: (formState: Record<string, unknown> | null | undefined) => Record<string, unknown> | null | undefined;
+/**
+ * Converts form state to a format suitable for submission by:
+ * - Applying all transformations from toValidationFormat
+ * - Additionally removing empty objects from the result
+ * - Filtering empty objects from arrays
+ * - Recursively cleaning nested structures
+ *
+ * **Why separate from toValidationFormat?**
+ *
+ * Empty objects must be preserved during validation so that custom refinements
+ * can run. For example, a FieldCard with "at least email or phone required"
+ * validation needs the object to exist (even if empty) for the refine to execute.
+ *
+ * However, for submission, empty objects are meaningless and should be removed
+ * to produce clean data for APIs.
+ *
+ * @example
+ * const formState = {
+ *   name: 'John',
+ *   contact: {},           // Empty FieldCard - will be removed
+ *   tags: [{}, {}, {}],    // All empty - array will be removed
+ *   items: [
+ *     { value: 'a' },
+ *     {},                  // Empty entry - will be filtered out
+ *     { value: 'b' }
+ *   ],
+ *   nested: {
+ *     deep: {}             // Nested empty - will be removed recursively
+ *   }
+ * };
+ *
+ * // Result:
+ * {
+ *   name: 'John',
+ *   items: [{ value: 'a' }, { value: 'b' }]
+ * }
+ */
+declare const toSubmitFormat: (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.
@@ -182,5 +220,5 @@ declare const toValidationFormat: (formState: Record<string, unknown> | null | u
  */
 declare const nameToTestId: (name: string | readonly string[]) => string;
 //#endregion
-export { createOptionValueConverter, flatArrayKey, fromNullishString, isValueEmpty, nameToTestId, toFormFormat, toNullishString, toValidationFormat };
+export { createOptionValueConverter, flatArrayKey, fromNullishString, isValueEmpty, nameToTestId, toFormFormat, toNullishString, toSubmitFormat, toValidationFormat };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/helpers/createOptionValueConverter/createOptionValueConverter.ts","../../src/helpers/nullishFields/nullishFields.ts"],"mappings":";;AAeA;;;;;;;;;;;;cAAa,0BAAA;EACC,KAAA;AAAA,GAEZ,OAAA,EAAS,CAAA;;;;;;;;cCfE,YAAA;;;;;;;;;;;;;;;;;;;;;;;AAAb;;;;;AAsCA;;cAAa,YAAA,GAAgB,KAAA;;;AA0B7B;cAAa,iBAAA,GAAqB,KAAA;;;;cAsCrB,eAAA,GAAmB,KAAA;;;;;AA6EhC;;;;;;;;;AA2EA;;;;;;;;;AAyKA;;;;;;;;;AA6BA;;;;;;;;;;;;;;;;;;;cAjRa,YAAA,GAAgB,MAAA,EAAQ,MAAA,sBAwBE,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAmD1B,kBAAA,GACX,SAAA,EAAW,MAAA,yCACV,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAuKU,cAAA,GACX,SAAA,EAAW,MAAA,yCACV,MAAA;;;;;;;;;;;;;;;;;;;;cA2BU,YAAA,GAAgB,IAAA"}

package/dist/helpers/index.js

@@ -1,3 +1,3 @@
-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 "../helpers-D3A5d3M1.js";
+import { a as toFormFormat, c as toValidationFormat, i as nameToTestId, l as createOptionValueConverter, n as fromNullishString, o as toNullishString, r as isValueEmpty, s as toSubmitFormat, t as flatArrayKey } from "../helpers-33jajRcN.js";
 
-export { createOptionValueConverter, flatArrayKey, fromNullishString, isValueEmpty, nameToTestId, toFormFormat, toNullishString, toValidationFormat };
+export { createOptionValueConverter, flatArrayKey, fromNullishString, isValueEmpty, nameToTestId, toFormFormat, toNullishString, toSubmitFormat, toValidationFormat };

package/dist/{helpers-D3A5d3M1.js → helpers-33jajRcN.js}

@@ -287,6 +287,75 @@ const toValidationFormat = (formState) => {
 	return JSON.parse(validationFormatJson);
 };
 /**
+* Helper function to check if a value is an empty object (not an array).
+*/
+const isEmptyObject = (value) => {
+	return value !== null && typeof value === "object" && !Array.isArray(value) && Object.keys(value).length === 0;
+};
+/**
+* Recursively removes empty objects from a data structure.
+* - Filters empty objects from arrays
+* - Removes properties with empty object values
+* - Removes arrays that become empty after filtering
+*/
+const removeEmptyObjects = (obj) => {
+	if (Array.isArray(obj)) return obj.filter((item) => {
+		return !isEmptyObject(item);
+	}).map((item) => {
+		return removeEmptyObjects(item);
+	});
+	if (obj !== null && typeof obj === "object") return Object.fromEntries(Object.entries(obj).map(([key, value]) => {
+		return [key, removeEmptyObjects(value)];
+	}).filter(([_, processed]) => {
+		if (isEmptyObject(processed)) return false;
+		if (Array.isArray(processed) && processed.length === 0) return false;
+		return true;
+	}));
+	return obj;
+};
+/**
+* Converts form state to a format suitable for submission by:
+* - Applying all transformations from toValidationFormat
+* - Additionally removing empty objects from the result
+* - Filtering empty objects from arrays
+* - Recursively cleaning nested structures
+*
+* **Why separate from toValidationFormat?**
+*
+* Empty objects must be preserved during validation so that custom refinements
+* can run. For example, a FieldCard with "at least email or phone required"
+* validation needs the object to exist (even if empty) for the refine to execute.
+*
+* However, for submission, empty objects are meaningless and should be removed
+* to produce clean data for APIs.
+*
+* @example
+* const formState = {
+*   name: 'John',
+*   contact: {},           // Empty FieldCard - will be removed
+*   tags: [{}, {}, {}],    // All empty - array will be removed
+*   items: [
+*     { value: 'a' },
+*     {},                  // Empty entry - will be filtered out
+*     { value: 'b' }
+*   ],
+*   nested: {
+*     deep: {}             // Nested empty - will be removed recursively
+*   }
+* };
+*
+* // Result:
+* {
+*   name: 'John',
+*   items: [{ value: 'a' }, { value: 'b' }]
+* }
+*/
+const toSubmitFormat = (formState) => {
+	const validated = toValidationFormat(formState);
+	if (!validated) return validated;
+	return removeEmptyObjects(validated);
+};
+/**
 * 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.
 *
@@ -317,5 +386,5 @@ const nameToTestId = (name) => {
 };
 
 //#endregion
-export { toFormFormat as a, createOptionValueConverter as c, nameToTestId as i, fromNullishString as n, toNullishString as o, isValueEmpty as r, toValidationFormat as s, flatArrayKey as t };
-//# sourceMappingURL=helpers-D3A5d3M1.js.map
+export { toFormFormat as a, toValidationFormat as c, nameToTestId as i, createOptionValueConverter as l, fromNullishString as n, toNullishString as o, isValueEmpty as r, toSubmitFormat as s, flatArrayKey as t };
+//# sourceMappingURL=helpers-33jajRcN.js.map

package/dist/{helpers-D3A5d3M1.js.map → helpers-33jajRcN.js.map}

@@ -1 +1 @@
-{"version":3,"file":"helpers-D3A5d3M1.js","names":[],"sources":["../src/helpers/createOptionValueConverter/createOptionValueConverter.ts","../src/helpers/nullishFields/nullishFields.ts"],"sourcesContent":["/* eslint-disable import-x/prefer-default-export */\n\n/**\n * Creates a converter function that preserves the original type (string, number, or boolean)\n * of option values when converting from string keys back to their original type.\n *\n * This is useful for radio/select components where the underlying UI library\n * uses string keys internally, but we want to preserve number/boolean values in the form state.\n *\n * @param options - Array of options with a value property that can be string, number, or boolean\n * @returns An object with:\n *   - `convertToOriginalType`: Function to convert a string key back to its original type\n *   - `numberValueKeys`: Set of string representations of number values (for internal use)\n *   - `booleanValueKeys`: Map of string representations to boolean values (for internal use)\n */\nexport const createOptionValueConverter = <\n  T extends { value: string | number | boolean },\n>(\n  options: T[],\n) => {\n  // Create a set of string keys that represent number values\n  const numberValueKeys = new Set(\n    options\n      .filter((option) => {\n        return typeof option.value === 'number';\n      })\n      .map((option) => {\n        return String(option.value);\n      }),\n  );\n\n  // Create a map of string keys to boolean values\n  const booleanValueKeys = new Map(\n    options\n      .filter((option) => {\n        return typeof option.value === 'boolean';\n      })\n      .map((option) => {\n        return [String(option.value), option.value as boolean];\n      }),\n  );\n\n  /**\n   * Converts a string key back to its original type (string, number, or boolean)\n   * based on whether the original option value was a number or boolean\n   */\n  const convertToOriginalType = (\n    key: string | number | boolean,\n  ): string | number | boolean => {\n    const keyStr = String(key);\n    const booleanValue = booleanValueKeys.get(keyStr);\n    if (booleanValue !== undefined) {\n      return booleanValue;\n    }\n    if (numberValueKeys.has(keyStr)) {\n      return Number(keyStr);\n    }\n    return keyStr;\n  };\n\n  return {\n    booleanValueKeys,\n    convertToOriginalType,\n    numberValueKeys,\n  };\n};\n","import { slugify } from '@fuf-stack/pixel-utils';\n\n/** Key used to wrap flat array elements when converting to form format */\nexport const flatArrayKey = '__FLAT__';\n\n/**\n * String markers used to preserve null, false, and 0 values during JSON processing\n */\nconst nullString = '__NULL__';\nconst falseString = '__FALSE__';\nconst zeroString = '__ZERO__';\n\n/**\n * Checks if a value is considered \"empty\" for validation display purposes.\n *\n * Used by useUniformField to determine when to show validation errors.\n * Empty values don't trigger immediate error display (user must interact first).\n *\n * Handles:\n * - Primitives: null, undefined, ''\n * - Marker strings: __NULL__, __FALSE__, __ZERO__ (converted via fromNullishString)\n * - Empty arrays: []\n * - Objects with all empty values: {a: null, b: ''}\n * - Flat array wrappers: {__FLAT__: null} or {__FLAT__: ''}\n *\n * @param value - The value to check (will be converted via fromNullishString first)\n * @returns true if the value is empty\n *\n * @example\n * isValueEmpty(null)                    // true\n * isValueEmpty('')                      // true\n * isValueEmpty('__NULL__')              // true (marker string)\n * isValueEmpty([])                      // true (empty array)\n * isValueEmpty({a: null})               // true (object with all empty values)\n * isValueEmpty({__FLAT__: null})        // true (flat array wrapper with empty value)\n * isValueEmpty({__FLAT__: ''})          // true\n * isValueEmpty('hello')                 // false\n * isValueEmpty([1, 2])                  // false\n * isValueEmpty({a: 'value'})            // false\n * isValueEmpty({__FLAT__: 'value'})     // false\n */\nexport const isValueEmpty = (value: unknown): boolean => {\n  // Convert marker strings first\n  const converted = fromNullishString(value);\n\n  if (converted === undefined || converted === null || converted === '') {\n    return true;\n  }\n  if (Array.isArray(converted)) {\n    return converted.length === 0;\n  }\n  if (typeof converted === 'object' && converted !== null) {\n    const record = converted as Record<string, unknown>;\n    // Handle flat array wrapper: { __FLAT__: innerValue }\n    if (flatArrayKey in record) {\n      return isValueEmpty(record[flatArrayKey]);\n    }\n    // For objects (e.g., FieldCard), check if all values are null/undefined/empty\n    const values = Object.values(record);\n    return values.length === 0 || values.every(isValueEmpty);\n  }\n  return false;\n};\n\n/**\n * Converts marker strings back to their original values when processing arrays\n */\nexport const fromNullishString = (value: unknown): unknown => {\n  // Support arrays: unwrap flat wrappers and convert marker strings per entry\n  if (Array.isArray(value)) {\n    return (value as unknown[]).map((entry) => {\n      if (entry && typeof entry === 'object') {\n        const record = entry as Record<string, unknown>;\n        if (flatArrayKey in record) {\n          const inner = record[flatArrayKey];\n          // For arrays, treat empty string as null (placeholder input)\n          if (inner === '') {\n            return null;\n          }\n          return fromNullishString(inner);\n        }\n      }\n      return fromNullishString(entry);\n    });\n  }\n\n  if (typeof value !== 'string') {\n    return value;\n  }\n\n  switch (value) {\n    case nullString:\n      return null;\n    case falseString:\n      return false;\n    case zeroString:\n      return 0;\n    default:\n      return value;\n  }\n};\n\n/**\n * Converts null/falsy values to marker strings for JSON processing\n */\nexport const toNullishString = (value: unknown): unknown => {\n  if (Array.isArray(value)) {\n    // Only wrap arrays of primitives; leave arrays of objects as-is\n    const isPrimitive = (v: unknown) => {\n      return v === null || ['string', 'number', 'boolean'].includes(typeof v);\n    };\n    const isPrimitiveArray = (value as unknown[]).every(isPrimitive);\n    if (isPrimitiveArray) {\n      return (value as unknown[]).map((v) => {\n        // Store raw primitive; do not convert to marker strings inside the wrapper\n        return { [flatArrayKey]: v } as Record<string, unknown>;\n      });\n    }\n    return value;\n  }\n  if (value === null || value === '') {\n    return nullString;\n  }\n  if (value === false) {\n    return falseString;\n  }\n  if (value === 0) {\n    return zeroString;\n  }\n  return value;\n};\n\n/**\n * Converts field values to a format suitable for forms by:\n * - Wrapping arrays of primitives as objects using the flatArrayKey `__FLAT__`\n *   to satisfy RHF's requirement that array fields contain objects\n * - Removing empty strings and null values from objects\n *\n * This conversion is required because React Hook Form does not support arrays with\n * flat values (string, number, boolean, null). Array fields must contain objects.\n * We work around this by wrapping primitive entries: `{ __FLAT__: <value> }`.\n *\n * @example\n * const fields = {\n *   name: 'John',\n *   scores: [0, null, 75, false],\n *   scoresDetailed: [\n *     { score: 1 },\n *     { score: null },\n *     { score: 0 },\n *     { score: false },\n *     { score: '' },\n *   ],\n *   contact: {\n *     email: '',\n *     phone: null,\n *     address: '123 Main St'\n *   }\n * };\n *\n * // Result:\n * {\n *   name: 'John',\n *   scores: [\n *     { __FLAT__: 0 },\n *     { __FLAT__: null },\n *     { __FLAT__: 75 },\n *     { __FLAT__: false }\n *   ],\n *   // Arrays of objects are left as objects; empty/null properties are removed\n *   scoresDetailed: [\n *     { score: 1 },\n *     {}, // null score removed\n *     { score: 0 },\n *     { score: false },\n *     {}, // empty string removed\n *   ],\n *   contact: {\n *     address: '123 Main St'\n *   }\n * }\n */\nexport const toFormFormat = (fields: Record<string, unknown>) => {\n  const formFormatJson = JSON.stringify(fields, (_, value) => {\n    if (Array.isArray(value)) {\n      // Delegate to toNullishString to ensure consistent handling\n      return toNullishString(value);\n    }\n\n    if (value && typeof value === 'object') {\n      // Preserve flat-array wrappers as-is (do not filter their inner values here)\n      const record = value as Record<string, unknown>;\n      if (flatArrayKey in record) {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n        return value;\n      }\n      return Object.fromEntries(\n        Object.entries(value).filter(([_key, v]) => {\n          return v !== '' && v !== null;\n        }),\n      );\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return value;\n  });\n\n  return JSON.parse(formFormatJson) as Record<string, unknown>;\n};\n\n/**\n * Converts form state to a format suitable for validation by:\n * - Unwrapping flat array wrappers `{ __FLAT__: <value> }` back to primitives\n * - Converting legacy string markers (__NULL__, __FALSE__, __ZERO__) back to their original values\n * - Removing fields whose converted value is empty string or null\n * - Removing empty arrays\n *\n * @example\n * const formState = {\n *   name: 'John',\n *   scores: [\n *     { __FLAT__: 75 },\n *     { __FLAT__: 0 },\n *     { __FLAT__: null },\n *     { __FLAT__: false }\n *   ],\n *   emptyArray: [],\n *   scoresDetailed: [\n *     { score: 1 },\n *     {},\n *     { score: 0 },\n *     { score: false },\n *     {},\n *   ],\n *   contact: {\n *     address: '123 Main St',\n *     fax: null\n *   }\n * };\n *\n * // Result:\n * {\n *   name: 'John',\n *   scores: [75, 0, null, false],\n *   // emptyArray is removed\n *   // Objects inside arrays remain objects; empty entries remain empty objects\n *   scoresDetailed: [\n *     { score: 1 },\n *     {},\n *     { score: 0 },\n *     { score: false },\n *     {},\n *   ],\n *   contact: {\n *     address: '123 Main St'\n *   }\n * }\n */\nexport const toValidationFormat = (\n  formState: Record<string, unknown> | null | undefined,\n): Record<string, unknown> | null | undefined => {\n  // Handle null or undefined input\n  if (formState === undefined || formState === null) {\n    return formState;\n  }\n\n  const validationFormatJson = JSON.stringify(formState, (_, value) => {\n    if (Array.isArray(value)) {\n      return value.map((v) => {\n        // Unwrap new wrapper format { __FLAT__: <value> }\n        if (v && typeof v === 'object') {\n          const record = v as Record<string, unknown>;\n          if (flatArrayKey in record) {\n            const inner = record[flatArrayKey];\n            // Treat empty string from forms as null in validation format\n            if (inner === '') {\n              return null;\n            }\n            return fromNullishString(inner);\n          }\n        }\n        // Backward compatibility for string markers\n        return fromNullishString(v);\n      });\n    }\n\n    if (value && typeof value === 'object') {\n      // Object branch: remove keys that resolve to empty/null after marker conversion\n      // and unwrap flat-array wrappers if present.\n      //\n      // Why this shape?\n      // - Forms may contain objects with placeholder/empty values that should not\n      //   be part of the validation payload (e.g. \"\" or __NULL__ markers).\n      // - Arrays of primitives are stored as wrapper objects { __FLAT__: <value> }\n      //   to satisfy RHF structure constraints. When converting back for\n      //   validation, we need to treat wrappers whose inner value resolves to\n      //   empty/null as removable, and unwrap non-empty wrappers to the primitive.\n      return Object.fromEntries(\n        Object.entries(value)\n          .filter(([_key, v]) => {\n            // If this is a flat-array wrapper, convert the inner value first and\n            // drop the key when the inner resolves to empty string or null.\n            if (v && typeof v === 'object') {\n              const record = v as Record<string, unknown>;\n              if (flatArrayKey in record) {\n                const convertedInner = fromNullishString(record[flatArrayKey]);\n                return convertedInner !== '' && convertedInner !== null;\n              }\n            }\n            // Drop empty arrays\n            if (Array.isArray(v) && v.length === 0) {\n              return false;\n            }\n            // For regular values, convert markers and drop when empty/null.\n            const converted = fromNullishString(v);\n            return converted !== '' && converted !== null;\n          })\n          .map(([k, v]) => {\n            // Unwrap flat-array wrappers to raw primitives after conversion.\n            if (v && typeof v === 'object') {\n              const record = v as Record<string, unknown>;\n              if (flatArrayKey in record) {\n                return [k, fromNullishString(record[flatArrayKey])];\n              }\n            }\n            // For other values, just convert markers.\n            return [k, fromNullishString(v)];\n          }),\n      );\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return value;\n  });\n\n  return JSON.parse(validationFormatJson) as Record<string, unknown>;\n};\n\n/**\n * Converts a field name to a testId by removing flat array key segments and slugifying.\n * Removes all occurrences of `flatArrayKey` from the field name and applies slugify transformation.\n *\n * This is used to generate stable testIds for form fields that don't include\n * the internal `__FLAT__` marker used for flat arrays.\n *\n * @param name - The field name as a string (e.g., 'tags.0.__FLAT__') or array path (e.g., ['tags', '0', '__FLAT__'])\n * @returns The slugified field name with all flat array key segments removed (e.g., 'tags_0')\n *\n * @example\n * ```ts\n * nameToTestId('tags.0.__FLAT__') // => 'tags_0'\n * nameToTestId('array.0.__FLAT__') // => 'array_0'\n * nameToTestId('nested.array.0.__FLAT__.field') // => 'nested_array_0_field'\n * nameToTestId('simple.field') // => 'simple_field'\n * nameToTestId(['tags', '0', '__FLAT__']) // => 'tags_0'\n * ```\n */\nexport const nameToTestId = (name: string | readonly string[]): string => {\n  let cleanName: string;\n\n  // Handle array paths - filter out flatArrayKey and join with dots\n  if (Array.isArray(name)) {\n    cleanName = name\n      .filter((segment: string) => {\n        return segment !== flatArrayKey;\n      })\n      .join('.');\n  } else {\n    // Handle string paths - split by dots and filter out flatArrayKey segments\n    const segments = (name as string).split('.');\n    cleanName = segments\n      .filter((segment: string) => {\n        return segment !== flatArrayKey;\n      })\n      .join('.');\n  }\n\n  // Apply slugify transformation\n  return slugify(cleanName, { replaceDots: true });\n};\n"],"mappings":"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"}
+{"version":3,"file":"helpers-33jajRcN.js","names":[],"sources":["../src/helpers/createOptionValueConverter/createOptionValueConverter.ts","../src/helpers/nullishFields/nullishFields.ts"],"sourcesContent":["/* eslint-disable import-x/prefer-default-export */\n\n/**\n * Creates a converter function that preserves the original type (string, number, or boolean)\n * of option values when converting from string keys back to their original type.\n *\n * This is useful for radio/select components where the underlying UI library\n * uses string keys internally, but we want to preserve number/boolean values in the form state.\n *\n * @param options - Array of options with a value property that can be string, number, or boolean\n * @returns An object with:\n *   - `convertToOriginalType`: Function to convert a string key back to its original type\n *   - `numberValueKeys`: Set of string representations of number values (for internal use)\n *   - `booleanValueKeys`: Map of string representations to boolean values (for internal use)\n */\nexport const createOptionValueConverter = <\n  T extends { value: string | number | boolean },\n>(\n  options: T[],\n) => {\n  // Create a set of string keys that represent number values\n  const numberValueKeys = new Set(\n    options\n      .filter((option) => {\n        return typeof option.value === 'number';\n      })\n      .map((option) => {\n        return String(option.value);\n      }),\n  );\n\n  // Create a map of string keys to boolean values\n  const booleanValueKeys = new Map(\n    options\n      .filter((option) => {\n        return typeof option.value === 'boolean';\n      })\n      .map((option) => {\n        return [String(option.value), option.value as boolean];\n      }),\n  );\n\n  /**\n   * Converts a string key back to its original type (string, number, or boolean)\n   * based on whether the original option value was a number or boolean\n   */\n  const convertToOriginalType = (\n    key: string | number | boolean,\n  ): string | number | boolean => {\n    const keyStr = String(key);\n    const booleanValue = booleanValueKeys.get(keyStr);\n    if (booleanValue !== undefined) {\n      return booleanValue;\n    }\n    if (numberValueKeys.has(keyStr)) {\n      return Number(keyStr);\n    }\n    return keyStr;\n  };\n\n  return {\n    booleanValueKeys,\n    convertToOriginalType,\n    numberValueKeys,\n  };\n};\n","import { slugify } from '@fuf-stack/pixel-utils';\n\n/** Key used to wrap flat array elements when converting to form format */\nexport const flatArrayKey = '__FLAT__';\n\n/**\n * String markers used to preserve null, false, and 0 values during JSON processing\n */\nconst nullString = '__NULL__';\nconst falseString = '__FALSE__';\nconst zeroString = '__ZERO__';\n\n/**\n * Checks if a value is considered \"empty\" for validation display purposes.\n *\n * Used by useUniformField to determine when to show validation errors.\n * Empty values don't trigger immediate error display (user must interact first).\n *\n * Handles:\n * - Primitives: null, undefined, ''\n * - Marker strings: __NULL__, __FALSE__, __ZERO__ (converted via fromNullishString)\n * - Empty arrays: []\n * - Objects with all empty values: {a: null, b: ''}\n * - Flat array wrappers: {__FLAT__: null} or {__FLAT__: ''}\n *\n * @param value - The value to check (will be converted via fromNullishString first)\n * @returns true if the value is empty\n *\n * @example\n * isValueEmpty(null)                    // true\n * isValueEmpty('')                      // true\n * isValueEmpty('__NULL__')              // true (marker string)\n * isValueEmpty([])                      // true (empty array)\n * isValueEmpty({a: null})               // true (object with all empty values)\n * isValueEmpty({__FLAT__: null})        // true (flat array wrapper with empty value)\n * isValueEmpty({__FLAT__: ''})          // true\n * isValueEmpty('hello')                 // false\n * isValueEmpty([1, 2])                  // false\n * isValueEmpty({a: 'value'})            // false\n * isValueEmpty({__FLAT__: 'value'})     // false\n */\nexport const isValueEmpty = (value: unknown): boolean => {\n  // Convert marker strings first\n  const converted = fromNullishString(value);\n\n  if (converted === undefined || converted === null || converted === '') {\n    return true;\n  }\n  if (Array.isArray(converted)) {\n    return converted.length === 0;\n  }\n  if (typeof converted === 'object' && converted !== null) {\n    const record = converted as Record<string, unknown>;\n    // Handle flat array wrapper: { __FLAT__: innerValue }\n    if (flatArrayKey in record) {\n      return isValueEmpty(record[flatArrayKey]);\n    }\n    // For objects (e.g., FieldCard), check if all values are null/undefined/empty\n    const values = Object.values(record);\n    return values.length === 0 || values.every(isValueEmpty);\n  }\n  return false;\n};\n\n/**\n * Converts marker strings back to their original values when processing arrays\n */\nexport const fromNullishString = (value: unknown): unknown => {\n  // Support arrays: unwrap flat wrappers and convert marker strings per entry\n  if (Array.isArray(value)) {\n    return (value as unknown[]).map((entry) => {\n      if (entry && typeof entry === 'object') {\n        const record = entry as Record<string, unknown>;\n        if (flatArrayKey in record) {\n          const inner = record[flatArrayKey];\n          // For arrays, treat empty string as null (placeholder input)\n          if (inner === '') {\n            return null;\n          }\n          return fromNullishString(inner);\n        }\n      }\n      return fromNullishString(entry);\n    });\n  }\n\n  if (typeof value !== 'string') {\n    return value;\n  }\n\n  switch (value) {\n    case nullString:\n      return null;\n    case falseString:\n      return false;\n    case zeroString:\n      return 0;\n    default:\n      return value;\n  }\n};\n\n/**\n * Converts null/falsy values to marker strings for JSON processing\n */\nexport const toNullishString = (value: unknown): unknown => {\n  if (Array.isArray(value)) {\n    // Only wrap arrays of primitives; leave arrays of objects as-is\n    const isPrimitive = (v: unknown) => {\n      return v === null || ['string', 'number', 'boolean'].includes(typeof v);\n    };\n    const isPrimitiveArray = (value as unknown[]).every(isPrimitive);\n    if (isPrimitiveArray) {\n      return (value as unknown[]).map((v) => {\n        // Store raw primitive; do not convert to marker strings inside the wrapper\n        return { [flatArrayKey]: v } as Record<string, unknown>;\n      });\n    }\n    return value;\n  }\n  if (value === null || value === '') {\n    return nullString;\n  }\n  if (value === false) {\n    return falseString;\n  }\n  if (value === 0) {\n    return zeroString;\n  }\n  return value;\n};\n\n/**\n * Converts field values to a format suitable for forms by:\n * - Wrapping arrays of primitives as objects using the flatArrayKey `__FLAT__`\n *   to satisfy RHF's requirement that array fields contain objects\n * - Removing empty strings and null values from objects\n *\n * This conversion is required because React Hook Form does not support arrays with\n * flat values (string, number, boolean, null). Array fields must contain objects.\n * We work around this by wrapping primitive entries: `{ __FLAT__: <value> }`.\n *\n * @example\n * const fields = {\n *   name: 'John',\n *   scores: [0, null, 75, false],\n *   scoresDetailed: [\n *     { score: 1 },\n *     { score: null },\n *     { score: 0 },\n *     { score: false },\n *     { score: '' },\n *   ],\n *   contact: {\n *     email: '',\n *     phone: null,\n *     address: '123 Main St'\n *   }\n * };\n *\n * // Result:\n * {\n *   name: 'John',\n *   scores: [\n *     { __FLAT__: 0 },\n *     { __FLAT__: null },\n *     { __FLAT__: 75 },\n *     { __FLAT__: false }\n *   ],\n *   // Arrays of objects are left as objects; empty/null properties are removed\n *   scoresDetailed: [\n *     { score: 1 },\n *     {}, // null score removed\n *     { score: 0 },\n *     { score: false },\n *     {}, // empty string removed\n *   ],\n *   contact: {\n *     address: '123 Main St'\n *   }\n * }\n */\nexport const toFormFormat = (fields: Record<string, unknown>) => {\n  const formFormatJson = JSON.stringify(fields, (_, value) => {\n    if (Array.isArray(value)) {\n      // Delegate to toNullishString to ensure consistent handling\n      return toNullishString(value);\n    }\n\n    if (value && typeof value === 'object') {\n      // Preserve flat-array wrappers as-is (do not filter their inner values here)\n      const record = value as Record<string, unknown>;\n      if (flatArrayKey in record) {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n        return value;\n      }\n      return Object.fromEntries(\n        Object.entries(value).filter(([_key, v]) => {\n          return v !== '' && v !== null;\n        }),\n      );\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return value;\n  });\n\n  return JSON.parse(formFormatJson) as Record<string, unknown>;\n};\n\n/**\n * Converts form state to a format suitable for validation by:\n * - Unwrapping flat array wrappers `{ __FLAT__: <value> }` back to primitives\n * - Converting legacy string markers (__NULL__, __FALSE__, __ZERO__) back to their original values\n * - Removing fields whose converted value is empty string or null\n * - Removing empty arrays\n *\n * @example\n * const formState = {\n *   name: 'John',\n *   scores: [\n *     { __FLAT__: 75 },\n *     { __FLAT__: 0 },\n *     { __FLAT__: null },\n *     { __FLAT__: false }\n *   ],\n *   emptyArray: [],\n *   scoresDetailed: [\n *     { score: 1 },\n *     {},\n *     { score: 0 },\n *     { score: false },\n *     {},\n *   ],\n *   contact: {\n *     address: '123 Main St',\n *     fax: null\n *   }\n * };\n *\n * // Result:\n * {\n *   name: 'John',\n *   scores: [75, 0, null, false],\n *   // emptyArray is removed\n *   // Objects inside arrays remain objects; empty entries remain empty objects\n *   scoresDetailed: [\n *     { score: 1 },\n *     {},\n *     { score: 0 },\n *     { score: false },\n *     {},\n *   ],\n *   contact: {\n *     address: '123 Main St'\n *   }\n * }\n */\nexport const toValidationFormat = (\n  formState: Record<string, unknown> | null | undefined,\n): Record<string, unknown> | null | undefined => {\n  // Handle null or undefined input\n  if (formState === undefined || formState === null) {\n    return formState;\n  }\n\n  const validationFormatJson = JSON.stringify(formState, (_, value) => {\n    if (Array.isArray(value)) {\n      return value.map((v) => {\n        // Unwrap new wrapper format { __FLAT__: <value> }\n        if (v && typeof v === 'object') {\n          const record = v as Record<string, unknown>;\n          if (flatArrayKey in record) {\n            const inner = record[flatArrayKey];\n            // Treat empty string from forms as null in validation format\n            if (inner === '') {\n              return null;\n            }\n            return fromNullishString(inner);\n          }\n        }\n        // Backward compatibility for string markers\n        return fromNullishString(v);\n      });\n    }\n\n    if (value && typeof value === 'object') {\n      // Object branch: remove keys that resolve to empty/null after marker conversion\n      // and unwrap flat-array wrappers if present.\n      //\n      // Why this shape?\n      // - Forms may contain objects with placeholder/empty values that should not\n      //   be part of the validation payload (e.g. \"\" or __NULL__ markers).\n      // - Arrays of primitives are stored as wrapper objects { __FLAT__: <value> }\n      //   to satisfy RHF structure constraints. When converting back for\n      //   validation, we need to treat wrappers whose inner value resolves to\n      //   empty/null as removable, and unwrap non-empty wrappers to the primitive.\n      return Object.fromEntries(\n        Object.entries(value)\n          .filter(([_key, v]) => {\n            // If this is a flat-array wrapper, convert the inner value first and\n            // drop the key when the inner resolves to empty string or null.\n            if (v && typeof v === 'object') {\n              const record = v as Record<string, unknown>;\n              if (flatArrayKey in record) {\n                const convertedInner = fromNullishString(record[flatArrayKey]);\n                return convertedInner !== '' && convertedInner !== null;\n              }\n            }\n            // Drop empty arrays\n            if (Array.isArray(v) && v.length === 0) {\n              return false;\n            }\n            // For regular values, convert markers and drop when empty/null.\n            const converted = fromNullishString(v);\n            return converted !== '' && converted !== null;\n          })\n          .map(([k, v]) => {\n            // Unwrap flat-array wrappers to raw primitives after conversion.\n            if (v && typeof v === 'object') {\n              const record = v as Record<string, unknown>;\n              if (flatArrayKey in record) {\n                return [k, fromNullishString(record[flatArrayKey])];\n              }\n            }\n            // For other values, just convert markers.\n            return [k, fromNullishString(v)];\n          }),\n      );\n    }\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return value;\n  });\n\n  return JSON.parse(validationFormatJson) as Record<string, unknown>;\n};\n\n/**\n * Helper function to check if a value is an empty object (not an array).\n */\nconst isEmptyObject = (value: unknown): boolean => {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    !Array.isArray(value) &&\n    Object.keys(value as Record<string, unknown>).length === 0\n  );\n};\n\n/**\n * Recursively removes empty objects from a data structure.\n * - Filters empty objects from arrays\n * - Removes properties with empty object values\n * - Removes arrays that become empty after filtering\n */\nconst removeEmptyObjects = (obj: unknown): unknown => {\n  if (Array.isArray(obj)) {\n    // Filter out empty objects from arrays, then recursively process remaining items\n    return obj\n      .filter((item) => {\n        return !isEmptyObject(item);\n      })\n      .map((item) => {\n        return removeEmptyObjects(item);\n      });\n  }\n\n  if (obj !== null && typeof obj === 'object') {\n    return Object.fromEntries(\n      Object.entries(obj)\n        .map(([key, value]) => {\n          return [key, removeEmptyObjects(value)] as [string, unknown];\n        })\n        .filter(([_, processed]) => {\n          // Skip empty objects\n          if (isEmptyObject(processed)) {\n            return false;\n          }\n          // Skip arrays that are now empty after filtering\n          if (Array.isArray(processed) && processed.length === 0) {\n            return false;\n          }\n          return true;\n        }),\n    );\n  }\n\n  return obj;\n};\n\n/**\n * Converts form state to a format suitable for submission by:\n * - Applying all transformations from toValidationFormat\n * - Additionally removing empty objects from the result\n * - Filtering empty objects from arrays\n * - Recursively cleaning nested structures\n *\n * **Why separate from toValidationFormat?**\n *\n * Empty objects must be preserved during validation so that custom refinements\n * can run. For example, a FieldCard with \"at least email or phone required\"\n * validation needs the object to exist (even if empty) for the refine to execute.\n *\n * However, for submission, empty objects are meaningless and should be removed\n * to produce clean data for APIs.\n *\n * @example\n * const formState = {\n *   name: 'John',\n *   contact: {},           // Empty FieldCard - will be removed\n *   tags: [{}, {}, {}],    // All empty - array will be removed\n *   items: [\n *     { value: 'a' },\n *     {},                  // Empty entry - will be filtered out\n *     { value: 'b' }\n *   ],\n *   nested: {\n *     deep: {}             // Nested empty - will be removed recursively\n *   }\n * };\n *\n * // Result:\n * {\n *   name: 'John',\n *   items: [{ value: 'a' }, { value: 'b' }]\n * }\n */\nexport const toSubmitFormat = (\n  formState: Record<string, unknown> | null | undefined,\n): Record<string, unknown> | null | undefined => {\n  const validated = toValidationFormat(formState);\n  if (!validated) {\n    return validated;\n  }\n  return removeEmptyObjects(validated) as Record<string, unknown>;\n};\n\n/**\n * Converts a field name to a testId by removing flat array key segments and slugifying.\n * Removes all occurrences of `flatArrayKey` from the field name and applies slugify transformation.\n *\n * This is used to generate stable testIds for form fields that don't include\n * the internal `__FLAT__` marker used for flat arrays.\n *\n * @param name - The field name as a string (e.g., 'tags.0.__FLAT__') or array path (e.g., ['tags', '0', '__FLAT__'])\n * @returns The slugified field name with all flat array key segments removed (e.g., 'tags_0')\n *\n * @example\n * ```ts\n * nameToTestId('tags.0.__FLAT__') // => 'tags_0'\n * nameToTestId('array.0.__FLAT__') // => 'array_0'\n * nameToTestId('nested.array.0.__FLAT__.field') // => 'nested_array_0_field'\n * nameToTestId('simple.field') // => 'simple_field'\n * nameToTestId(['tags', '0', '__FLAT__']) // => 'tags_0'\n * ```\n */\nexport const nameToTestId = (name: string | readonly string[]): string => {\n  let cleanName: string;\n\n  // Handle array paths - filter out flatArrayKey and join with dots\n  if (Array.isArray(name)) {\n    cleanName = name\n      .filter((segment: string) => {\n        return segment !== flatArrayKey;\n      })\n      .join('.');\n  } else {\n    // Handle string paths - split by dots and filter out flatArrayKey segments\n    const segments = (name as string).split('.');\n    cleanName = segments\n      .filter((segment: string) => {\n        return segment !== flatArrayKey;\n      })\n      .join('.');\n  }\n\n  // Apply slugify transformation\n  return slugify(cleanName, { replaceDots: true });\n};\n"],"mappings":"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"}

package/dist/{helpers-CncbgvW_.cjs → helpers-Bd_QpqXg.cjs}

@@ -1,4 +1,4 @@
-const require_FormContext = require('./FormContext-CeFKQmVH.cjs');
+const require_FormContext = require('./FormContext-BSLO2-sO.cjs');
 let _fuf_stack_pixel_utils = require("@fuf-stack/pixel-utils");
 
 //#region src/helpers/createOptionValueConverter/createOptionValueConverter.ts
@@ -288,6 +288,75 @@ const toValidationFormat = (formState) => {
 	return JSON.parse(validationFormatJson);
 };
 /**
+* Helper function to check if a value is an empty object (not an array).
+*/
+const isEmptyObject = (value) => {
+	return value !== null && typeof value === "object" && !Array.isArray(value) && Object.keys(value).length === 0;
+};
+/**
+* Recursively removes empty objects from a data structure.
+* - Filters empty objects from arrays
+* - Removes properties with empty object values
+* - Removes arrays that become empty after filtering
+*/
+const removeEmptyObjects = (obj) => {
+	if (Array.isArray(obj)) return obj.filter((item) => {
+		return !isEmptyObject(item);
+	}).map((item) => {
+		return removeEmptyObjects(item);
+	});
+	if (obj !== null && typeof obj === "object") return Object.fromEntries(Object.entries(obj).map(([key, value]) => {
+		return [key, removeEmptyObjects(value)];
+	}).filter(([_, processed]) => {
+		if (isEmptyObject(processed)) return false;
+		if (Array.isArray(processed) && processed.length === 0) return false;
+		return true;
+	}));
+	return obj;
+};
+/**
+* Converts form state to a format suitable for submission by:
+* - Applying all transformations from toValidationFormat
+* - Additionally removing empty objects from the result
+* - Filtering empty objects from arrays
+* - Recursively cleaning nested structures
+*
+* **Why separate from toValidationFormat?**
+*
+* Empty objects must be preserved during validation so that custom refinements
+* can run. For example, a FieldCard with "at least email or phone required"
+* validation needs the object to exist (even if empty) for the refine to execute.
+*
+* However, for submission, empty objects are meaningless and should be removed
+* to produce clean data for APIs.
+*
+* @example
+* const formState = {
+*   name: 'John',
+*   contact: {},           // Empty FieldCard - will be removed
+*   tags: [{}, {}, {}],    // All empty - array will be removed
+*   items: [
+*     { value: 'a' },
+*     {},                  // Empty entry - will be filtered out
+*     { value: 'b' }
+*   ],
+*   nested: {
+*     deep: {}             // Nested empty - will be removed recursively
+*   }
+* };
+*
+* // Result:
+* {
+*   name: 'John',
+*   items: [{ value: 'a' }, { value: 'b' }]
+* }
+*/
+const toSubmitFormat = (formState) => {
+	const validated = toValidationFormat(formState);
+	if (!validated) return validated;
+	return removeEmptyObjects(validated);
+};
+/**
 * 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.
 *
@@ -360,10 +429,16 @@ Object.defineProperty(exports, 'toNullishString', {
     return toNullishString;
   }
 });
+Object.defineProperty(exports, 'toSubmitFormat', {
+  enumerable: true,
+  get: function () {
+    return toSubmitFormat;
+  }
+});
 Object.defineProperty(exports, 'toValidationFormat', {
   enumerable: true,
   get: function () {
     return toValidationFormat;
   }
 });
-//# sourceMappingURL=helpers-CncbgvW_.cjs.map
+//# sourceMappingURL=helpers-Bd_QpqXg.cjs.map