@fuf-stack/uniform 1.10.3 → 1.11.0

package/dist/index-DpD4MxGD.d.cts

@@ -0,0 +1,177 @@
+import * as tailwind_variants195 from "tailwind-variants";
+import * as react_jsx_runtime8 from "react/jsx-runtime";
+import { TVClassName, TVProps } from "@fuf-stack/pixel-utils";
+import { ReactNode } from "react";
+
+//#region src/RadioBoxes/RadioBoxes.d.ts
+declare const radioBoxesVariants: tailwind_variants195.TVReturnType<{
+  [key: string]: {
+    [key: string]: tailwind_variants195.ClassValue | {
+      base?: tailwind_variants195.ClassValue;
+      label?: tailwind_variants195.ClassValue;
+      wrapper?: tailwind_variants195.ClassValue;
+      boxBase?: tailwind_variants195.ClassValue;
+      boxControl?: tailwind_variants195.ClassValue;
+      boxDescription?: tailwind_variants195.ClassValue;
+      boxLabel?: tailwind_variants195.ClassValue;
+      boxLabelWrapper?: tailwind_variants195.ClassValue;
+    };
+  };
+} | {
+  [x: string]: {
+    [x: string]: tailwind_variants195.ClassValue | {
+      base?: tailwind_variants195.ClassValue;
+      label?: tailwind_variants195.ClassValue;
+      wrapper?: tailwind_variants195.ClassValue;
+      boxBase?: tailwind_variants195.ClassValue;
+      boxControl?: tailwind_variants195.ClassValue;
+      boxDescription?: tailwind_variants195.ClassValue;
+      boxLabel?: tailwind_variants195.ClassValue;
+      boxLabelWrapper?: tailwind_variants195.ClassValue;
+    };
+  };
+} | {}, {
+  base: string;
+  boxBase: string;
+  boxControl: string;
+  boxDescription: string;
+  boxLabel: string;
+  boxLabelWrapper: string;
+  label: string;
+  wrapper: string;
+}, undefined, {
+  [key: string]: {
+    [key: string]: tailwind_variants195.ClassValue | {
+      base?: tailwind_variants195.ClassValue;
+      label?: tailwind_variants195.ClassValue;
+      wrapper?: tailwind_variants195.ClassValue;
+      boxBase?: tailwind_variants195.ClassValue;
+      boxControl?: tailwind_variants195.ClassValue;
+      boxDescription?: tailwind_variants195.ClassValue;
+      boxLabel?: tailwind_variants195.ClassValue;
+      boxLabelWrapper?: tailwind_variants195.ClassValue;
+    };
+  };
+} | {}, {
+  base: string;
+  boxBase: string;
+  boxControl: string;
+  boxDescription: string;
+  boxLabel: string;
+  boxLabelWrapper: string;
+  label: string;
+  wrapper: string;
+}, tailwind_variants195.TVReturnType<unknown, {
+  base: string;
+  boxBase: string;
+  boxControl: string;
+  boxDescription: string;
+  boxLabel: string;
+  boxLabelWrapper: string;
+  label: string;
+  wrapper: string;
+}, undefined, unknown, unknown, undefined>>;
+type VariantProps = TVProps<typeof radioBoxesVariants>;
+type ClassName = TVClassName<typeof radioBoxesVariants>;
+interface RadioBoxesOption {
+  /** Description of the value. Works with variant radioBox. */
+  description?: ReactNode;
+  /** disables the option */
+  disabled?: boolean;
+  /** option label */
+  label?: ReactNode;
+  /** option icon */
+  icon?: ReactNode;
+  /** HTML data-testid attribute of the option */
+  testId?: string;
+  /** option value */
+  value: string;
+}
+interface RadioBoxesProps extends VariantProps {
+  /** Custom aria-label for accessibility. If not provided, falls back to field name when no visible label exists */
+  ariaLabel?: string;
+  /** CSS class name */
+  className?: ClassName;
+  /** Determines if the Buttons are disabled or not. */
+  disabled?: boolean;
+  /** determines orientation of the Buttons. */
+  inline?: boolean;
+  /** Label displayed next to the RadioButton. */
+  label?: ReactNode;
+  /** Name the RadioButtons are registered at in HTML forms (react-hook-form). */
+  name: string;
+  /** Radio button configuration. */
+  options: RadioBoxesOption[];
+  /** Id to grab element in internal tests. */
+  testId?: string;
+}
+/**
+ * RadioBoxes component based on [HeroUI RadioGroup](https://www.heroui.com//docs/components/radio-group)
+ */
+declare const RadioBoxes: ({
+  className,
+  inline,
+  name,
+  options,
+  ...uniformFieldProps
+}: RadioBoxesProps) => react_jsx_runtime8.JSX.Element;
+//#endregion
+//#region src/RadioBoxes/RadioBox.d.ts
+declare const radioBoxVariants: tailwind_variants195.TVReturnType<{
+  isDisabled: {
+    true: {
+      base: string;
+    };
+  };
+  isInvalid: {
+    true: {
+      base: string;
+    };
+  };
+}, {
+  base: string;
+  control: string;
+  description: string;
+  icon: string;
+  label: string;
+  labelWrapper: string;
+}, undefined, {
+  isDisabled: {
+    true: {
+      base: string;
+    };
+  };
+  isInvalid: {
+    true: {
+      base: string;
+    };
+  };
+}, {
+  base: string;
+  control: string;
+  description: string;
+  icon: string;
+  label: string;
+  labelWrapper: string;
+}, tailwind_variants195.TVReturnType<{
+  isDisabled: {
+    true: {
+      base: string;
+    };
+  };
+  isInvalid: {
+    true: {
+      base: string;
+    };
+  };
+}, {
+  base: string;
+  control: string;
+  description: string;
+  icon: string;
+  label: string;
+  labelWrapper: string;
+}, undefined, unknown, unknown, undefined>>;
+//#endregion
+export { RadioBoxes as n, RadioBoxesProps as r, radioBoxVariants as t };
+//# sourceMappingURL=index-DpD4MxGD.d.cts.map

package/dist/index-DpD4MxGD.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-DpD4MxGD.d.cts","names":[],"sources":["../src/RadioBoxes/RadioBoxes.tsx","../src/RadioBoxes/RadioBox.tsx"],"sourcesContent":[],"mappings":";;;;;;cAYa,yCAAkB;;mBAc7B,oBAAA,CAAA,UAAA;;MAdW,KAAA,CAAA,iCAcX;MAAA,OAAA,CAAA,iCAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAd6B,OAAA,EAAA,MAAA;AAc5B,CAAA,EAAA,SAEE,EAAA;EACA,CAAA,GAAA,EAAA,MAAS,CAAA,EAAA;IAEG,CAAA,GAAA,EAAA,MAAA,CAAA,oCAAgB;MAEjB,IAAA,CAAA,iCAAA;MAIN,KAAA,CAAA,iCAAA;MAED,OAAA,CAAA,iCAAA;MAAS,OAAA,CAAA,iCAAA;MAOD,UAAgB,CAAA,iCAAA;MAInB,cAAA,CAAA,iCAAA;MAMJ,QAAA,CAAA,iCAAA;MAIC,eAAA,CAAA,iCAAA;IAd8B,CAAA;EAAY,CAAA;AAiBpD,CAAA,GAKK,CAAA,CAAA,EAAA;EAAc,IAAA,EAAA,MAAA;EAAA,OAAA,EAAA,MAAA;EAAA,UAAA,EAAA,MAAA;EAAA,cAAA,EAAA,MAAA;EAMjB,QAAA,EAAA,MAAA;EAAe,eAAA,EAAA,MAAA;EA2EjB,KAAA,EAAA,MAAA;;;;EC5IY,OAAA,EAAA,MAAA;;;;;;;;KDmBR,YAAA,GAAe,eAAe;KAC9B,SAAA,GAAY,mBAAmB;UAEnB,gBAAA;;gBAED;;;;UAIN;;SAED;;;;;;UAOQ,eAAA,SAAwB;;;;cAI3B;;;;;;UAMJ;;;;WAIC;;;;;;;cAQL;;;;;;GAMH,oBAAe,kBAAA,CAAA,GAAA,CAAA;;;cCjEL,kBAqBX,oBAAA,CArB2B;;;MDGhB,IAAA,EAAA,MAAA;IAcX,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAd6B;EAAA,IAAA,EAAA,MAAA;EAgB1B,KAAA,EAAA,MAAA;EACA,YAAS,EAAA,MAAA;AAEd,CAAA,ECDE,oBAAA,CAAA,YDC+B,CAAA;EAEjB,UAAA,EAAA;IAIN,IAAA,EAAA;MAED,IAAA,EAAA,MAAA;IAAS,CAAA;EAOD,CAAA;EAIH,SAAA,EAAA;IAMJ,IAAA,EAAA;MAIC,IAAA,EAAA,MAAA;IAd8B,CAAA;EAAY,CAAA;AAiBpD,CAAA,EAAA;EAKmB,IAAA,EAAA,MAAA;EAAA,OAAA,EAAA,MAAA;EAAA,WAAA,EAAA,MAAA;EAAA,IAAA,EAAA,MAAA;EAMjB,KAAA,EAAA,MAAA;EAAe,YAAA,EAAA,MAAA;CA2EjB,EAAA,SAAA,EAAA,OAAA,EAAA,OAAA,EAAA,SAAA,CAAA,CAAA"}

package/dist/index-Drl7euco.d.ts

@@ -0,0 +1,115 @@
+import { t as InputValueTransform } from "./useInputValueTransform-D7LfyYRe.js";
+import { TVClassName, TVProps } from "@fuf-stack/pixel-utils";
+import { ReactNode } from "react";
+import * as react_jsx_runtime12 from "react/jsx-runtime";
+import * as tailwind_variants256 from "tailwind-variants";
+
+//#region src/Input/Input.d.ts
+declare const inputVariants: tailwind_variants256.TVReturnType<{
+  [key: string]: {
+    [key: string]: tailwind_variants256.ClassValue | {
+      base?: tailwind_variants256.ClassValue;
+      input?: tailwind_variants256.ClassValue;
+      inputWrapper?: tailwind_variants256.ClassValue;
+      clearButton?: tailwind_variants256.ClassValue;
+    };
+  };
+} | {
+  [x: string]: {
+    [x: string]: tailwind_variants256.ClassValue | {
+      base?: tailwind_variants256.ClassValue;
+      input?: tailwind_variants256.ClassValue;
+      inputWrapper?: tailwind_variants256.ClassValue;
+      clearButton?: tailwind_variants256.ClassValue;
+    };
+  };
+} | {}, {
+  /** wrapper around the whole input */
+  base: string;
+  /** clear button */
+  clearButton: string;
+  /** actual input element */
+  input: string;
+  /** inner wrapper (HeroUI inputWrapper slot) */
+  inputWrapper: string;
+}, undefined, {
+  [key: string]: {
+    [key: string]: tailwind_variants256.ClassValue | {
+      base?: tailwind_variants256.ClassValue;
+      input?: tailwind_variants256.ClassValue;
+      inputWrapper?: tailwind_variants256.ClassValue;
+      clearButton?: tailwind_variants256.ClassValue;
+    };
+  };
+} | {}, {
+  /** wrapper around the whole input */
+  base: string;
+  /** clear button */
+  clearButton: string;
+  /** actual input element */
+  input: string;
+  /** inner wrapper (HeroUI inputWrapper slot) */
+  inputWrapper: string;
+}, tailwind_variants256.TVReturnType<unknown, {
+  /** wrapper around the whole input */
+  base: string;
+  /** clear button */
+  clearButton: string;
+  /** actual input element */
+  input: string;
+  /** inner wrapper (HeroUI inputWrapper slot) */
+  inputWrapper: string;
+}, undefined, unknown, unknown, undefined>>;
+type VariantProps = TVProps<typeof inputVariants>;
+type ClassName = TVClassName<typeof inputVariants>;
+interface InputProps extends VariantProps {
+  /** Custom aria-label for accessibility. If not provided, falls back to field name when no visible label exists */
+  ariaLabel?: string;
+  /** CSS class name */
+  className?: ClassName;
+  /** shows clear button when input has value */
+  clearable?: boolean;
+  /** debounce delay in milliseconds for form state updates (default: 300ms) */
+  debounceDelay?: number;
+  /** input field is disabled */
+  disabled?: boolean;
+  /** added content to the end of the input Field. */
+  endContent?: ReactNode;
+  /** form field label */
+  label?: ReactNode;
+  /** form field name */
+  name: string;
+  /** callback that is fired when the value is cleared */
+  onClear?: () => void;
+  /** form field placeholder */
+  placeholder?: string;
+  /** size of the input */
+  size?: 'sm' | 'md' | 'lg';
+  /** content added to the start of the input field */
+  startContent?: ReactNode;
+  /** HTML data-testid attribute used in e2e tests */
+  testId?: string;
+  /** allows disentangled display and form values for a field */
+  transform?: InputValueTransform<string>;
+  /** input type */
+  type?: 'number' | 'password';
+}
+/**
+ * Input component based on [HeroUI Input](https://www.heroui.com//docs/components/input)
+ */
+declare const Input: ({
+  className: _className,
+  clearable,
+  debounceDelay,
+  endContent,
+  name,
+  onClear,
+  placeholder,
+  size,
+  startContent,
+  type,
+  ...uniformFieldProps
+}: InputProps) => react_jsx_runtime12.JSX.Element;
+//#endregion
+export { InputProps as n, Input as t };
+//# sourceMappingURL=index-Drl7euco.d.ts.map

package/dist/index-Drl7euco.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-Drl7euco.d.ts","names":[],"sources":["../src/Input/Input.tsx"],"sourcesContent":[],"mappings":";;;;;;;cAca,oCAAa;;mBAWxB,oBAAA,CAAA,UAAA;;MAXW,KAAA,CAAA,iCAWX;MAAA,YAAA,CAAA,iCAAA;;;;;;;;;;;;;;;;;EAXwB,WAAA,EAAA,MAAA;EAarB;EACA,KAAA,EAAA,MAAS;EAEG;EAIH,YAAA,EAAA,MAAA;CAQC,EAAA,SAAA,EAAA;EAEL,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA;IAUO,CAAA,GAAA,EAAA,MAAA,CAAA,oCAAA;MAIH,IAAA,CAAA,iCAAA;MA5BsB,KAAA,CAAA,iCAAA;MAAY,YAAA,CAAA,iCAAA;MAwK/C,WAAA,CAAA,iCAAA;IApIc,CAAA;EAAA,CAAA;CAAA,GAAA,CAAA,CAAA,EAAA;EAAA;EAAA,IAAA,EAAA,MAAA;EAAA;EAAA,WAAA,EAAA,MAAA;EAAA;EAAA,KAAA,EAAA,MAAA;EAAA;EAYZ,YAAA,EAAA,MAAA;CAAU,mCAAA,CAAA,OAAA,EAAA;EAwHZ;;;;;;;;;KA3KI,YAAA,GAAe,eAAe;KAC9B,SAAA,GAAY,mBAAmB;UAEnB,UAAA,SAAmB;;;;cAItB;;;;;;;;eAQC;;UAEL;;;;;;;;;;iBAUO;;;;cAIH;;;;;;;cAQR;aAAS;;;;;;;;;;;GAYZ,eAAU,mBAAA,CAAA,GAAA,CAAA"}

package/dist/index-DzuP5q-2.d.ts

@@ -0,0 +1,181 @@
+import { t as InputValueTransform } from "./useInputValueTransform-D7LfyYRe.js";
+import { TVClassName, TVProps } from "@fuf-stack/pixel-utils";
+import { ReactNode } from "react";
+import * as react_jsx_runtime10 from "react/jsx-runtime";
+import * as tailwind_variants252 from "tailwind-variants";
+
+//#region src/Checkboxes/Checkboxes.d.ts
+declare const checkboxesVariants: tailwind_variants252.TVReturnType<{
+  color: {
+    readonly default: {
+      wrapper: string;
+    };
+    readonly primary: {
+      wrapper: string;
+    };
+    readonly secondary: {
+      wrapper: string;
+    };
+    readonly success: {
+      wrapper: string;
+    };
+    readonly warning: {
+      wrapper: string;
+    };
+    readonly danger: {
+      wrapper: string;
+    };
+    readonly info: {
+      readonly wrapper: "text-info-foreground after:bg-info after:text-info-foreground";
+    };
+  };
+  lineThrough: {
+    true: {
+      optionLabel: string[];
+      optionLabelSubline: string;
+    };
+  };
+}, {
+  base: string;
+  errorMessage: string;
+  label: string;
+  optionBase: string;
+  optionIcon: string;
+  optionLabel: string;
+  optionLabelSubline: string;
+  optionWrapper: string;
+  wrapper: string;
+}, undefined, {
+  color: {
+    readonly default: {
+      wrapper: string;
+    };
+    readonly primary: {
+      wrapper: string;
+    };
+    readonly secondary: {
+      wrapper: string;
+    };
+    readonly success: {
+      wrapper: string;
+    };
+    readonly warning: {
+      wrapper: string;
+    };
+    readonly danger: {
+      wrapper: string;
+    };
+    readonly info: {
+      readonly wrapper: "text-info-foreground after:bg-info after:text-info-foreground";
+    };
+  };
+  lineThrough: {
+    true: {
+      optionLabel: string[];
+      optionLabelSubline: string;
+    };
+  };
+}, {
+  base: string;
+  errorMessage: string;
+  label: string;
+  optionBase: string;
+  optionIcon: string;
+  optionLabel: string;
+  optionLabelSubline: string;
+  optionWrapper: string;
+  wrapper: string;
+}, tailwind_variants252.TVReturnType<{
+  color: {
+    readonly default: {
+      wrapper: string;
+    };
+    readonly primary: {
+      wrapper: string;
+    };
+    readonly secondary: {
+      wrapper: string;
+    };
+    readonly success: {
+      wrapper: string;
+    };
+    readonly warning: {
+      wrapper: string;
+    };
+    readonly danger: {
+      wrapper: string;
+    };
+    readonly info: {
+      readonly wrapper: "text-info-foreground after:bg-info after:text-info-foreground";
+    };
+  };
+  lineThrough: {
+    true: {
+      optionLabel: string[];
+      optionLabelSubline: string;
+    };
+  };
+}, {
+  base: string;
+  errorMessage: string;
+  label: string;
+  optionBase: string;
+  optionIcon: string;
+  optionLabel: string;
+  optionLabelSubline: string;
+  optionWrapper: string;
+  wrapper: string;
+}, undefined, unknown, unknown, undefined>>;
+type VariantProps = TVProps<typeof checkboxesVariants>;
+type ClassName = TVClassName<typeof checkboxesVariants>;
+interface CheckboxOption {
+  /** option label */
+  label?: ReactNode;
+  /** subline displayed below the label */
+  labelSubline?: ReactNode;
+  /** option value */
+  value: string;
+  /** disables the option */
+  disabled?: boolean;
+  /** HTML data-testid attribute of the option */
+  testId?: string;
+}
+interface CheckboxesProps extends VariantProps {
+  /** Custom aria-label for accessibility. If not provided, falls back to field name when no visible label exists */
+  ariaLabel?: string;
+  /** CSS class name */
+  className?: ClassName;
+  /** Color scheme of the checkboxes */
+  color?: VariantProps['color'];
+  /** Sets all checkboxes disabled */
+  disabled?: boolean;
+  /** Orientation of the checkboxes */
+  inline?: boolean;
+  /** Label displayed above the checkboxes */
+  label?: ReactNode;
+  /** Whether the checkboxes label should be crossed out */
+  lineThrough?: boolean;
+  /** Name the Field is registered on the form */
+  name: string;
+  /** Checkboxes that should be displayed. */
+  options: CheckboxOption[];
+  /** HTML data-testid attribute used in e2e tests */
+  testId?: string;
+  /** allows disentangled display and form values for a field */
+  transform?: InputValueTransform<string[]>;
+}
+/**
+ * Checkboxes component based on [HeroUI CheckboxGroup](https://www.heroui.com//docs/components/checkbox-group)
+ */
+declare const Checkboxes: ({
+  className,
+  color,
+  inline,
+  lineThrough,
+  options,
+  name,
+  ...uniformFieldProps
+}: CheckboxesProps) => react_jsx_runtime10.JSX.Element;
+//#endregion
+export { Checkboxes as n, CheckboxesProps as r, CheckboxOption as t };
+//# sourceMappingURL=index-DzuP5q-2.d.ts.map

package/dist/index-DzuP5q-2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-DzuP5q-2.d.ts","names":[],"sources":["../src/Checkboxes/Checkboxes.tsx"],"sourcesContent":[],"mappings":";;;;;;;cAoBa,oBAmCX,oBAAA,CAnC6B;;;;IAAlB,CAAA;IAqCR,SAAA,OAAY,EAAA;MACZ,OAAS,EAAA,MAAA;IAEG,CAAA;IAaA,SAAA,SAAgB,EAAA;MAInB,OAAA,EAAA,MAAA;IAEJ,CAAA;IAMA,SAAA,OAAA,EAAA;MAMC,OAAA,EAAA,MAAA;IAIG,CAAA;IAtB2B,SAAA,OAAA,EAAA;MAAY,OAAA,EAAA,MAAA;IA4B/C,CAAA;IAAc,SAAA,MAAA,EAAA;MAAA,OAAA,EAAA,MAAA;IAAA,CAAA;IAAA,SAAA,IAAA,EAAA;MAAA,SAAA,OAAA,EAAA,+DAAA;IAAA,CAAA;EAQjB,CAAA;EAAe,WAAA,EAAA;IAiHjB,IAAA,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAvKC,oBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAEG,YAAA,GAAe,eAAe;KAC9B,SAAA,GAAY,mBAAmB;UAEnB,cAAA;;UAEP;;iBAEO;;;;;;;;UASA,eAAA,SAAwB;;;;cAI3B;;UAEJ;;;;;;UAMA;;;;;;WAMC;;;;cAIG;;;;;cAMR;;;;;;;;GAQH,oBAAe,mBAAA,CAAA,GAAA,CAAA"}

package/dist/index-G0IgQWoU.d.cts

@@ -0,0 +1,134 @@
+//#region src/helpers/nullishFields/nullishFields.d.ts
+/** Key used to wrap flat array elements when converting to form format */
+declare const flatArrayKey = "__FLAT__";
+/**
+ * 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 { toNullishString as a, toFormFormat as i, fromNullishString as n, toValidationFormat as o, nameToTestId as r, flatArrayKey as t };
+//# sourceMappingURL=index-G0IgQWoU.d.cts.map

package/dist/index-G0IgQWoU.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-G0IgQWoU.d.cts","names":[],"sources":["../src/helpers/nullishFields/nullishFields.ts"],"sourcesContent":[],"mappings":";;AAGa,cAAA,YAAA,GAAY,UAAA;AAYzB;AAsCA;AA6EA;AA2Ea,cA9LA,iBA+LA,EAAA,CAAA,KACV,EAAA,OAAM,EAAA,GAAA,OAAA;AAgGT;;;cA1Pa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA6EA,uBAAwB,4BAwBE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAmD1B,gCACA,+CACV;;;;;;;;;;;;;;;;;;;;cAgGU"}