@fuf-stack/uniform 1.22.8 → 1.22.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. package/dist/Checkboxes/index.cjs +2 -6
  2. package/dist/Checkboxes/index.cjs.map +1 -1
  3. package/dist/Checkboxes/index.d.cts +6 -6
  4. package/dist/Checkboxes/index.d.cts.map +1 -1
  5. package/dist/Checkboxes/index.d.ts +6 -6
  6. package/dist/Checkboxes/index.d.ts.map +1 -1
  7. package/dist/Checkboxes/index.js +2 -6
  8. package/dist/Checkboxes/index.js.map +1 -1
  9. package/dist/DatePicker/index.d.cts +11 -11
  10. package/dist/DatePicker/index.d.ts +11 -11
  11. package/dist/FieldArray/index.d.cts +6 -6
  12. package/dist/FieldArray/index.d.cts.map +1 -1
  13. package/dist/FieldArray/index.d.ts +6 -6
  14. package/dist/FieldArray/index.d.ts.map +1 -1
  15. package/dist/FieldCard/index.d.cts +6 -6
  16. package/dist/FieldCard/index.d.cts.map +1 -1
  17. package/dist/FieldCard/index.d.ts +6 -6
  18. package/dist/FieldCard/index.d.ts.map +1 -1
  19. package/dist/Input/index.d.cts +11 -11
  20. package/dist/Input/index.d.cts.map +1 -1
  21. package/dist/Input/index.d.ts +11 -11
  22. package/dist/Input/index.d.ts.map +1 -1
  23. package/dist/RadioBoxes/index.d.cts +17 -17
  24. package/dist/RadioBoxes/index.d.ts +17 -17
  25. package/dist/RadioTabs/index.d.cts +6 -6
  26. package/dist/RadioTabs/index.d.cts.map +1 -1
  27. package/dist/RadioTabs/index.d.ts +6 -6
  28. package/dist/RadioTabs/index.d.ts.map +1 -1
  29. package/dist/Radios/index.d.cts +11 -11
  30. package/dist/Radios/index.d.ts +11 -11
  31. package/dist/Select/index.cjs +36 -29
  32. package/dist/Select/index.cjs.map +1 -1
  33. package/dist/Select/index.d.cts +23 -23
  34. package/dist/Select/index.d.cts.map +1 -1
  35. package/dist/Select/index.d.ts +23 -23
  36. package/dist/Select/index.d.ts.map +1 -1
  37. package/dist/Select/index.js +36 -29
  38. package/dist/Select/index.js.map +1 -1
  39. package/dist/Slider/index.d.cts +29 -29
  40. package/dist/Slider/index.d.ts +29 -29
  41. package/dist/Switch/index.d.cts +23 -23
  42. package/dist/Switch/index.d.ts +23 -23
  43. package/dist/SwitchBox/index.d.cts +6 -6
  44. package/dist/SwitchBox/index.d.cts.map +1 -1
  45. package/dist/SwitchBox/index.d.ts +6 -6
  46. package/dist/SwitchBox/index.d.ts.map +1 -1
  47. package/dist/TextArea/index.d.cts +11 -11
  48. package/dist/TextArea/index.d.ts +11 -11
  49. package/dist/Time/index.d.cts +17 -17
  50. package/dist/Time/index.d.ts +17 -17
  51. package/dist/helpers/index.cjs +33 -0
  52. package/dist/helpers/index.cjs.map +1 -1
  53. package/dist/helpers/index.d.cts +15 -1
  54. package/dist/helpers/index.d.cts.map +1 -1
  55. package/dist/helpers/index.d.ts +15 -1
  56. package/dist/helpers/index.d.ts.map +1 -1
  57. package/dist/helpers/index.js +33 -1
  58. package/dist/helpers/index.js.map +1 -1
  59. package/dist/hooks/useUniformField/index.cjs +5 -4
  60. package/dist/hooks/useUniformField/index.cjs.map +1 -1
  61. package/dist/hooks/useUniformField/index.d.cts +4 -2
  62. package/dist/hooks/useUniformField/index.d.cts.map +1 -1
  63. package/dist/hooks/useUniformField/index.d.ts +4 -2
  64. package/dist/hooks/useUniformField/index.d.ts.map +1 -1
  65. package/dist/hooks/useUniformField/index.js +6 -5
  66. package/dist/hooks/useUniformField/index.js.map +1 -1
  67. package/dist/hooks/useUniformFieldArray/index.d.cts.map +1 -1
  68. package/dist/hooks/useUniformFieldArray/index.d.ts.map +1 -1
  69. package/package.json +2 -2
@@ -856,11 +856,11 @@ declare const timeVariants: ((props?: ({
856
856
  defaultVariants: {};
857
857
  compoundVariants: ({} & ({
858
858
  class?: (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined) | {
859
- label?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
860
859
  base?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
861
860
  input?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
862
- helperWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
863
861
  inputWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
862
+ label?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
863
+ helperWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
864
864
  innerWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
865
865
  segment?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
866
866
  };
@@ -868,17 +868,17 @@ declare const timeVariants: ((props?: ({
868
868
  } | {
869
869
  class?: never;
870
870
  className?: (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined) | {
871
- label?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
872
871
  base?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
873
872
  input?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
874
- helperWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
875
873
  inputWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
874
+ label?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
875
+ helperWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
876
876
  innerWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
877
877
  segment?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
878
878
  };
879
879
  }))[];
880
880
  compoundSlots: ({
881
- slots: ("label" | "base" | "input" | "helperWrapper" | "inputWrapper" | "innerWrapper" | "segment")[];
881
+ slots: ("base" | "input" | "inputWrapper" | "label" | "helperWrapper" | "innerWrapper" | "segment")[];
882
882
  } & ({} & ({
883
883
  class?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
884
884
  className?: never;
@@ -901,11 +901,11 @@ declare const timeVariants: ((props?: ({
901
901
  variants: {
902
902
  [key: string]: {
903
903
  [key: string]: (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined) | {
904
- label?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
905
904
  base?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
906
905
  input?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
907
- helperWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
908
906
  inputWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
907
+ label?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
908
+ helperWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
909
909
  innerWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
910
910
  segment?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
911
911
  };
@@ -913,11 +913,11 @@ declare const timeVariants: ((props?: ({
913
913
  } | {
914
914
  [x: string]: {
915
915
  [x: string]: (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined) | {
916
- label?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
917
916
  base?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
918
917
  input?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
919
- helperWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
920
918
  inputWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
919
+ label?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
920
+ helperWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
921
921
  innerWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
922
922
  segment?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
923
923
  };
@@ -926,11 +926,11 @@ declare const timeVariants: ((props?: ({
926
926
  defaultVariants: {};
927
927
  compoundVariants: ({} & ({
928
928
  class?: (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined) | {
929
- label?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
930
929
  base?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
931
930
  input?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
932
- helperWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
933
931
  inputWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
932
+ label?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
933
+ helperWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
934
934
  innerWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
935
935
  segment?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
936
936
  };
@@ -938,17 +938,17 @@ declare const timeVariants: ((props?: ({
938
938
  } | {
939
939
  class?: never;
940
940
  className?: (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined) | {
941
- label?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
942
941
  base?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
943
942
  input?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
944
- helperWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
945
943
  inputWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
944
+ label?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
945
+ helperWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
946
946
  innerWrapper?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
947
947
  segment?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
948
948
  };
949
949
  }))[];
950
950
  compoundSlots: (({
951
- slots: ("label" | "base" | "input" | "helperWrapper" | "inputWrapper" | "innerWrapper" | "segment")[];
951
+ slots: ("base" | "input" | "inputWrapper" | "label" | "helperWrapper" | "innerWrapper" | "segment")[];
952
952
  } & ({
953
953
  [x: string]: string | number | (string | number)[] | undefined;
954
954
  } & ({
@@ -958,7 +958,7 @@ declare const timeVariants: ((props?: ({
958
958
  class?: never;
959
959
  className?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
960
960
  }))) | ({
961
- slots: ("label" | "base" | "input" | "helperWrapper" | "inputWrapper" | "innerWrapper" | "segment")[];
961
+ slots: ("base" | "input" | "inputWrapper" | "label" | "helperWrapper" | "innerWrapper" | "segment")[];
962
962
  } & ({
963
963
  [x: string]: string | number | (string | number)[] | undefined;
964
964
  } & ({
@@ -968,7 +968,7 @@ declare const timeVariants: ((props?: ({
968
968
  class?: never;
969
969
  className?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
970
970
  }))) | ({
971
- slots: ("label" | "base" | "input" | "helperWrapper" | "inputWrapper" | "innerWrapper" | "segment")[];
971
+ slots: ("base" | "input" | "inputWrapper" | "label" | "helperWrapper" | "innerWrapper" | "segment")[];
972
972
  } & ({} & ({
973
973
  class?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
974
974
  className?: never;
@@ -976,7 +976,7 @@ declare const timeVariants: ((props?: ({
976
976
  class?: never;
977
977
  className?: string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | readonly (string | false | 0 | 0n | /*elided*/any | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined)[] | null | undefined;
978
978
  }))))[];
979
- variantKeys: never[] | (string | number)[];
979
+ variantKeys: (string | number)[] | never[];
980
980
  };
981
981
  type VariantProps = TVProps<typeof timeVariants>;
982
982
  type ClassName = TVClassName<typeof timeVariants>;
@@ -43,6 +43,38 @@ const createOptionValueConverter = (options) => {
43
43
  };
44
44
  };
45
45
  //#endregion
46
+ //#region src/helpers/flattenFieldErrors/flattenFieldErrors.ts
47
+ /**
48
+ * Narrow an unknown value to a react-hook-form `FieldError`.
49
+ *
50
+ * RHF `FieldError` entries carry metadata like `message` and/or `type`,
51
+ * while container nodes (objects keyed by index, `_errors`, etc.) do not.
52
+ * This guard distinguishes leaf errors from nested wrappers.
53
+ */
54
+ const isFieldError = (error) => {
55
+ return typeof error === "object" && error !== null && ("message" in error || "type" in error);
56
+ };
57
+ /**
58
+ * Normalize RHF validation payloads to a flat `FieldError[]`.
59
+ *
60
+ * Depending on field shape, RHF may return:
61
+ * - a single `FieldError`
62
+ * - an array of `FieldError`
63
+ * - nested objects keyed by array indices
64
+ * - objects containing `_errors` arrays for array/object-level issues
65
+ */
66
+ const flattenFieldErrors = (error) => {
67
+ if (!error) return [];
68
+ if (Array.isArray(error)) return error.flatMap((item) => {
69
+ return flattenFieldErrors(item);
70
+ });
71
+ if (isFieldError(error)) return [error];
72
+ if (typeof error === "object") return Object.values(error).flatMap((item) => {
73
+ return flattenFieldErrors(item);
74
+ });
75
+ return [];
76
+ };
77
+ //#endregion
46
78
  //#region src/helpers/nullishFields/nullishFields.ts
47
79
  /** Key used to wrap flat array elements when converting to form format */
48
80
  const flatArrayKey = "__FLAT__";
@@ -386,6 +418,7 @@ const nameToTestId = (name) => {
386
418
  //#endregion
387
419
  exports.createOptionValueConverter = createOptionValueConverter;
388
420
  exports.flatArrayKey = flatArrayKey;
421
+ exports.flattenFieldErrors = flattenFieldErrors;
389
422
  exports.fromNullishString = fromNullishString;
390
423
  exports.isValueEmpty = isValueEmpty;
391
424
  exports.nameToTestId = nameToTestId;
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","names":["record"],"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 };\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).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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"}
1
+ {"version":3,"file":"index.cjs","names":["record"],"sources":["../../src/helpers/createOptionValueConverter/createOptionValueConverter.ts","../../src/helpers/flattenFieldErrors/flattenFieldErrors.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","/* eslint-disable import-x/prefer-default-export */\n\nimport type { FieldError } from 'react-hook-form';\n\n/**\n * Narrow an unknown value to a react-hook-form `FieldError`.\n *\n * RHF `FieldError` entries carry metadata like `message` and/or `type`,\n * while container nodes (objects keyed by index, `_errors`, etc.) do not.\n * This guard distinguishes leaf errors from nested wrappers.\n */\nconst isFieldError = (error: unknown): error is FieldError => {\n return (\n typeof error === 'object' &&\n error !== null &&\n ('message' in error || 'type' in error)\n );\n};\n\n/**\n * Normalize RHF validation payloads to a flat `FieldError[]`.\n *\n * Depending on field shape, RHF may return:\n * - a single `FieldError`\n * - an array of `FieldError`\n * - nested objects keyed by array indices\n * - objects containing `_errors` arrays for array/object-level issues\n */\nexport const flattenFieldErrors = (error: unknown): FieldError[] => {\n if (!error) {\n return [];\n }\n\n if (Array.isArray(error)) {\n return error.flatMap((item) => {\n return flattenFieldErrors(item);\n });\n }\n\n if (isFieldError(error)) {\n return [error];\n }\n\n if (typeof error === 'object') {\n return Object.values(error as Record<string, unknown>).flatMap((item) => {\n return flattenFieldErrors(item);\n });\n }\n\n return [];\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 };\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).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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"}
@@ -1,3 +1,5 @@
1
+ import { FieldError } from "react-hook-form";
2
+
1
3
  //#region src/helpers/createOptionValueConverter/createOptionValueConverter.d.ts
2
4
  /**
3
5
  * Creates a converter function that preserves the original type (string, number, or boolean)
@@ -20,6 +22,18 @@ declare const createOptionValueConverter: <T extends {
20
22
  numberValueKeys: Set<string>;
21
23
  };
22
24
  //#endregion
25
+ //#region src/helpers/flattenFieldErrors/flattenFieldErrors.d.ts
26
+ /**
27
+ * Normalize RHF validation payloads to a flat `FieldError[]`.
28
+ *
29
+ * Depending on field shape, RHF may return:
30
+ * - a single `FieldError`
31
+ * - an array of `FieldError`
32
+ * - nested objects keyed by array indices
33
+ * - objects containing `_errors` arrays for array/object-level issues
34
+ */
35
+ declare const flattenFieldErrors: (error: unknown) => FieldError[];
36
+ //#endregion
23
37
  //#region src/helpers/nullishFields/nullishFields.d.ts
24
38
  /** Key used to wrap flat array elements when converting to form format */
25
39
  declare const flatArrayKey = "__FLAT__";
@@ -220,5 +234,5 @@ declare const toSubmitFormat: (formState: Record<string, unknown> | null | undef
220
234
  */
221
235
  declare const nameToTestId: (name: string | readonly string[]) => string;
222
236
  //#endregion
223
- export { createOptionValueConverter, flatArrayKey, fromNullishString, isValueEmpty, nameToTestId, toFormFormat, toNullishString, toSubmitFormat, toValidationFormat };
237
+ export { createOptionValueConverter, flatArrayKey, flattenFieldErrors, fromNullishString, isValueEmpty, nameToTestId, toFormFormat, toNullishString, toSubmitFormat, toValidationFormat };
224
238
  //# sourceMappingURL=index.d.cts.map
@@ -1 +1 @@
1
- {"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;;;;AAAyB;AAsCzB;;cAAa,YAAA,GAAgB,KAAc;;AAAA;AA0B3C;cAAa,iBAAA,GAAqB,KAAc;;;AAAA;cAsCnC,eAAA,GAAmB,KAAc;;;;AAAA;AA6E9C;;;;;;;;AAwB6C;AAmD7C;;;;;;;;AAES;AAuKT;;;;;;;;AAES;AA2BT;;;;AAA6D;;;;;;;;;;;;;;;cAjRhD,YAAA,GAAgB,MAAA,EAAQ,MAAA,sBAwBE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAmDhC,kBAAA,GACX,SAAA,EAAW,MAAA,yCACV,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAuKI,cAAA,GACX,SAAA,EAAW,MAAA,yCACV,MAAM;;;;;;;;;;;;;;;;;;;;cA2BI,YAAA,GAAgB,IAAgC"}
1
+ {"version":3,"file":"index.d.cts","names":[],"sources":["../../src/helpers/createOptionValueConverter/createOptionValueConverter.ts","../../src/helpers/flattenFieldErrors/flattenFieldErrors.ts","../../src/helpers/nullishFields/nullishFields.ts"],"mappings":";;;;;;AAeA;;;;;;;;;;cAAa,0BAAA;EACC,KAAA;AAAA,GAEZ,OAAA,EAAS,CAAA;;;;;;;;;AAHX;;;;;;;cCaa,kBAAA,GAAsB,KAAA,cAAiB,UAAU;;;;cCzBjD,YAAA;;AFYb;;;;;;;;;;;;;;;;;;;;;;;ACaA;;;;AAA8D;cCajD,YAAA,GAAgB,KAAc;;;AAtC3C;cAgEa,iBAAA,GAAqB,KAAc;;;AAhEvB;cAsGZ,eAAA,GAAmB,KAAc;;;;AAhEH;AA0B3C;;;;AAAgD;AAsChD;;;;AAA8C;AA6E9C;;;;;;;;AAwB6C;AAmD7C;;;;;;;;AAES;AAuKT;;;;;;;;AAES;AA2BT;;;;AAA6D;;;;;cAjRhD,YAAA,GAAgB,MAAA,EAAQ,MAAA,sBAwBE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAmDhC,kBAAA,GACX,SAAA,EAAW,MAAA,yCACV,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAuKI,cAAA,GACX,SAAA,EAAW,MAAA,yCACV,MAAM;;;;;;;;;;;;;;;;;;;;cA2BI,YAAA,GAAgB,IAAgC"}
@@ -1,3 +1,5 @@
1
+ import { FieldError } from "react-hook-form";
2
+
1
3
  //#region src/helpers/createOptionValueConverter/createOptionValueConverter.d.ts
2
4
  /**
3
5
  * Creates a converter function that preserves the original type (string, number, or boolean)
@@ -20,6 +22,18 @@ declare const createOptionValueConverter: <T extends {
20
22
  numberValueKeys: Set<string>;
21
23
  };
22
24
  //#endregion
25
+ //#region src/helpers/flattenFieldErrors/flattenFieldErrors.d.ts
26
+ /**
27
+ * Normalize RHF validation payloads to a flat `FieldError[]`.
28
+ *
29
+ * Depending on field shape, RHF may return:
30
+ * - a single `FieldError`
31
+ * - an array of `FieldError`
32
+ * - nested objects keyed by array indices
33
+ * - objects containing `_errors` arrays for array/object-level issues
34
+ */
35
+ declare const flattenFieldErrors: (error: unknown) => FieldError[];
36
+ //#endregion
23
37
  //#region src/helpers/nullishFields/nullishFields.d.ts
24
38
  /** Key used to wrap flat array elements when converting to form format */
25
39
  declare const flatArrayKey = "__FLAT__";
@@ -220,5 +234,5 @@ declare const toSubmitFormat: (formState: Record<string, unknown> | null | undef
220
234
  */
221
235
  declare const nameToTestId: (name: string | readonly string[]) => string;
222
236
  //#endregion
223
- export { createOptionValueConverter, flatArrayKey, fromNullishString, isValueEmpty, nameToTestId, toFormFormat, toNullishString, toSubmitFormat, toValidationFormat };
237
+ export { createOptionValueConverter, flatArrayKey, flattenFieldErrors, fromNullishString, isValueEmpty, nameToTestId, toFormFormat, toNullishString, toSubmitFormat, toValidationFormat };
224
238
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"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;;;;AAAyB;AAsCzB;;cAAa,YAAA,GAAgB,KAAc;;AAAA;AA0B3C;cAAa,iBAAA,GAAqB,KAAc;;;AAAA;cAsCnC,eAAA,GAAmB,KAAc;;;;AAAA;AA6E9C;;;;;;;;AAwB6C;AAmD7C;;;;;;;;AAES;AAuKT;;;;;;;;AAES;AA2BT;;;;AAA6D;;;;;;;;;;;;;;;cAjRhD,YAAA,GAAgB,MAAA,EAAQ,MAAA,sBAwBE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAmDhC,kBAAA,GACX,SAAA,EAAW,MAAA,yCACV,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAuKI,cAAA,GACX,SAAA,EAAW,MAAA,yCACV,MAAM;;;;;;;;;;;;;;;;;;;;cA2BI,YAAA,GAAgB,IAAgC"}
1
+ {"version":3,"file":"index.d.ts","names":[],"sources":["../../src/helpers/createOptionValueConverter/createOptionValueConverter.ts","../../src/helpers/flattenFieldErrors/flattenFieldErrors.ts","../../src/helpers/nullishFields/nullishFields.ts"],"mappings":";;;;;;AAeA;;;;;;;;;;cAAa,0BAAA;EACC,KAAA;AAAA,GAEZ,OAAA,EAAS,CAAA;;;;;;;;;AAHX;;;;;;;cCaa,kBAAA,GAAsB,KAAA,cAAiB,UAAU;;;;cCzBjD,YAAA;;AFYb;;;;;;;;;;;;;;;;;;;;;;;ACaA;;;;AAA8D;cCajD,YAAA,GAAgB,KAAc;;;AAtC3C;cAgEa,iBAAA,GAAqB,KAAc;;;AAhEvB;cAsGZ,eAAA,GAAmB,KAAc;;;;AAhEH;AA0B3C;;;;AAAgD;AAsChD;;;;AAA8C;AA6E9C;;;;;;;;AAwB6C;AAmD7C;;;;;;;;AAES;AAuKT;;;;;;;;AAES;AA2BT;;;;AAA6D;;;;;cAjRhD,YAAA,GAAgB,MAAA,EAAQ,MAAA,sBAwBE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAmDhC,kBAAA,GACX,SAAA,EAAW,MAAA,yCACV,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAuKI,cAAA,GACX,SAAA,EAAW,MAAA,yCACV,MAAM;;;;;;;;;;;;;;;;;;;;cA2BI,YAAA,GAAgB,IAAgC"}
@@ -42,6 +42,38 @@ const createOptionValueConverter = (options) => {
42
42
  };
43
43
  };
44
44
  //#endregion
45
+ //#region src/helpers/flattenFieldErrors/flattenFieldErrors.ts
46
+ /**
47
+ * Narrow an unknown value to a react-hook-form `FieldError`.
48
+ *
49
+ * RHF `FieldError` entries carry metadata like `message` and/or `type`,
50
+ * while container nodes (objects keyed by index, `_errors`, etc.) do not.
51
+ * This guard distinguishes leaf errors from nested wrappers.
52
+ */
53
+ const isFieldError = (error) => {
54
+ return typeof error === "object" && error !== null && ("message" in error || "type" in error);
55
+ };
56
+ /**
57
+ * Normalize RHF validation payloads to a flat `FieldError[]`.
58
+ *
59
+ * Depending on field shape, RHF may return:
60
+ * - a single `FieldError`
61
+ * - an array of `FieldError`
62
+ * - nested objects keyed by array indices
63
+ * - objects containing `_errors` arrays for array/object-level issues
64
+ */
65
+ const flattenFieldErrors = (error) => {
66
+ if (!error) return [];
67
+ if (Array.isArray(error)) return error.flatMap((item) => {
68
+ return flattenFieldErrors(item);
69
+ });
70
+ if (isFieldError(error)) return [error];
71
+ if (typeof error === "object") return Object.values(error).flatMap((item) => {
72
+ return flattenFieldErrors(item);
73
+ });
74
+ return [];
75
+ };
76
+ //#endregion
45
77
  //#region src/helpers/nullishFields/nullishFields.ts
46
78
  /** Key used to wrap flat array elements when converting to form format */
47
79
  const flatArrayKey = "__FLAT__";
@@ -383,6 +415,6 @@ const nameToTestId = (name) => {
383
415
  return slugify(cleanName, { replaceDots: true });
384
416
  };
385
417
  //#endregion
386
- export { createOptionValueConverter, flatArrayKey, fromNullishString, isValueEmpty, nameToTestId, toFormFormat, toNullishString, toSubmitFormat, toValidationFormat };
418
+ export { createOptionValueConverter, flatArrayKey, flattenFieldErrors, fromNullishString, isValueEmpty, nameToTestId, toFormFormat, toNullishString, toSubmitFormat, toValidationFormat };
387
419
 
388
420
  //# sourceMappingURL=index.js.map