@fpkit/acss 3.0.0 → 3.1.1

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 (119) hide show
  1. package/libs/{chunk-23ANBDCR.js → chunk-4I5MF54P.js} +3 -3
  2. package/libs/chunk-4I5MF54P.js.map +1 -0
  3. package/libs/chunk-5RAWNUVD.js +8 -0
  4. package/libs/chunk-5RAWNUVD.js.map +1 -0
  5. package/libs/{chunk-D2PSO7MU.js → chunk-CWRNJA4P.js} +2 -2
  6. package/libs/{chunk-C622WBGW.cjs → chunk-DYFAUAB7.cjs} +3 -3
  7. package/libs/{chunk-MGPWZRBX.cjs → chunk-EE3ZWSBY.cjs} +3 -3
  8. package/libs/chunk-FMIM3332.js +8 -0
  9. package/libs/chunk-FMIM3332.js.map +1 -0
  10. package/libs/chunk-L6PRDL6F.cjs +31 -0
  11. package/libs/chunk-L6PRDL6F.cjs.map +1 -0
  12. package/libs/chunk-MPTMPBFT.js +9 -0
  13. package/libs/chunk-MPTMPBFT.js.map +1 -0
  14. package/libs/chunk-NWJDAHP6.cjs +17 -0
  15. package/libs/chunk-NWJDAHP6.cjs.map +1 -0
  16. package/libs/{chunk-G55UJ53G.cjs → chunk-NZVSXRTB.cjs} +3 -3
  17. package/libs/chunk-NZVSXRTB.cjs.map +1 -0
  18. package/libs/chunk-TNEJXNZA.cjs +22 -0
  19. package/libs/chunk-TNEJXNZA.cjs.map +1 -0
  20. package/libs/{chunk-QKHPHMG2.js → chunk-TPIB3RQP.js} +2 -2
  21. package/libs/components/breadcrumbs/breadcrumb.cjs +5 -5
  22. package/libs/components/breadcrumbs/breadcrumb.js +2 -2
  23. package/libs/components/dialog/dialog.cjs +4 -4
  24. package/libs/components/dialog/dialog.js +2 -2
  25. package/libs/components/flexbox/flex.css +1 -0
  26. package/libs/components/flexbox/flex.css.map +1 -0
  27. package/libs/components/flexbox/flex.min.css +3 -0
  28. package/libs/components/icons/icon.cjs +3 -3
  29. package/libs/components/icons/icon.js +1 -1
  30. package/libs/components/link/link.cjs +5 -5
  31. package/libs/components/link/link.css +1 -1
  32. package/libs/components/link/link.css.map +1 -1
  33. package/libs/components/link/link.js +1 -1
  34. package/libs/components/link/link.min.css +2 -2
  35. package/libs/components/popover/popover.cjs +4 -4
  36. package/libs/components/popover/popover.d.cts +1 -1
  37. package/libs/components/popover/popover.d.ts +1 -1
  38. package/libs/components/popover/popover.js +1 -1
  39. package/libs/components/tables/table.cjs +4 -4
  40. package/libs/components/tables/table.d.cts +1 -1
  41. package/libs/components/tables/table.d.ts +1 -1
  42. package/libs/components/tables/table.js +1 -1
  43. package/libs/hooks.cjs +3 -3
  44. package/libs/hooks.js +2 -2
  45. package/libs/icons.cjs +2 -2
  46. package/libs/icons.js +1 -1
  47. package/libs/index.cjs +43 -42
  48. package/libs/index.cjs.map +1 -1
  49. package/libs/index.css +1 -1
  50. package/libs/index.css.map +1 -1
  51. package/libs/index.d.cts +243 -52
  52. package/libs/index.d.ts +243 -52
  53. package/libs/index.js +16 -16
  54. package/libs/index.js.map +1 -1
  55. package/package.json +2 -2
  56. package/src/App.tsx +1 -3
  57. package/src/components/breadcrumbs/bc-item.tsx +0 -1
  58. package/src/components/flexbox/README.mdx +996 -0
  59. package/src/components/flexbox/STYLES.mdx +857 -0
  60. package/src/components/flexbox/flex.scss +847 -0
  61. package/src/components/flexbox/flex.stories.tsx +1934 -0
  62. package/src/components/flexbox/flex.test.tsx +689 -0
  63. package/src/components/flexbox/flex.tsx +484 -0
  64. package/src/components/flexbox/flex.types.ts +243 -0
  65. package/src/components/icons/components/arrow-right.tsx +0 -5
  66. package/src/components/kit.tsx +8 -4
  67. package/src/components/link/link.tsx +1 -1
  68. package/src/components/popover/popover.tsx +1 -1
  69. package/src/components/tables/table-elements.tsx +1 -1
  70. package/src/components/tables/table.tsx +2 -2
  71. package/src/components/text-to-speech/TextToSpeech.tsx +0 -4
  72. package/src/components/text-to-speech/useTextToSpeech.tsx +2 -6
  73. package/src/decorators/instructions.tsx +22 -18
  74. package/src/hooks/popover/popover.tsx +1 -1
  75. package/src/index.scss +1 -0
  76. package/src/index.ts +17 -0
  77. package/src/styles/flexbox/flex.css +736 -0
  78. package/src/styles/flexbox/flex.css.map +1 -0
  79. package/src/styles/index.css +735 -1
  80. package/src/styles/index.css.map +1 -1
  81. package/src/styles/link/link.css +1 -1
  82. package/src/types/component-props.ts +1 -0
  83. package/libs/chunk-23ANBDCR.js.map +0 -1
  84. package/libs/chunk-5QD3DWFI.js +0 -9
  85. package/libs/chunk-5QD3DWFI.js.map +0 -1
  86. package/libs/chunk-6WTC4JXH.cjs +0 -31
  87. package/libs/chunk-6WTC4JXH.cjs.map +0 -1
  88. package/libs/chunk-G55UJ53G.cjs.map +0 -1
  89. package/libs/chunk-KG4GHIQJ.js +0 -8
  90. package/libs/chunk-KG4GHIQJ.js.map +0 -1
  91. package/libs/chunk-US2I5GI7.cjs +0 -22
  92. package/libs/chunk-US2I5GI7.cjs.map +0 -1
  93. package/libs/chunk-Y2PFDELK.js +0 -8
  94. package/libs/chunk-Y2PFDELK.js.map +0 -1
  95. package/libs/chunk-ZOBAJTNE.cjs +0 -17
  96. package/libs/chunk-ZOBAJTNE.cjs.map +0 -1
  97. package/libs/components/alert/alert.min.min.css +0 -2
  98. package/libs/components/badge/badge.min.min.css +0 -2
  99. package/libs/components/breadcrumbs/breadcrumb.min.min.css +0 -2
  100. package/libs/components/buttons/button.min.min.css +0 -2
  101. package/libs/components/cards/card-style.min.min.css +0 -2
  102. package/libs/components/cards/card.min.min.css +0 -2
  103. package/libs/components/details/details.min.min.css +0 -2
  104. package/libs/components/dialog/dialog.min.min.css +0 -2
  105. package/libs/components/form/form.min.min.css +0 -2
  106. package/libs/components/icons/icon.min.min.css +0 -2
  107. package/libs/components/images/img.min.min.css +0 -2
  108. package/libs/components/layout/landmarks.min.min.css +0 -2
  109. package/libs/components/link/link.min.min.css +0 -2
  110. package/libs/components/list/list.min.min.css +0 -2
  111. package/libs/components/nav/nav.min.min.css +0 -2
  112. package/libs/components/progress/progress.min.min.css +0 -2
  113. package/libs/components/styles/index.min.min.css +0 -2
  114. package/libs/components/tag/tag.min.min.css +0 -2
  115. package/libs/components/text-to-speech/text-to-speech.min.min.css +0 -2
  116. /package/libs/{chunk-D2PSO7MU.js.map → chunk-CWRNJA4P.js.map} +0 -0
  117. /package/libs/{chunk-C622WBGW.cjs.map → chunk-DYFAUAB7.cjs.map} +0 -0
  118. /package/libs/{chunk-MGPWZRBX.cjs.map → chunk-EE3ZWSBY.cjs.map} +0 -0
  119. /package/libs/{chunk-QKHPHMG2.js.map → chunk-TPIB3RQP.js.map} +0 -0
package/libs/index.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  export { Button, ButtonProps } from './components/button.js';
2
2
  export { Card, Content as CardContent, Footer as CardFooter, CardProps, Title as CardTitle } from './components/card.js';
3
- import React, { ReactNode } from 'react';
3
+ import React$1, { ReactNode } from 'react';
4
4
  import { I as IconProps } from './icons-287fce3a.js';
5
5
  export { a as Icon, b as IconProps } from './icons-287fce3a.js';
6
6
  export { default as Field, FieldProps } from './components/form/fields.js';
@@ -42,7 +42,7 @@ type AlertProps = {
42
42
  /**
43
43
  * The main message content.
44
44
  */
45
- children: React.ReactNode;
45
+ children: React$1.ReactNode;
46
46
  /**
47
47
  * Optional title for the alert.
48
48
  */
@@ -121,7 +121,7 @@ type AlertProps = {
121
121
  * </Alert>
122
122
  * ```
123
123
  */
124
- actions?: React.ReactNode;
124
+ actions?: React$1.ReactNode;
125
125
  /**
126
126
  * Whether to automatically focus the alert when it becomes visible.
127
127
  * Useful for critical alerts that require immediate attention.
@@ -173,8 +173,8 @@ type AlertProps = {
173
173
  * ```
174
174
  */
175
175
  contentType?: "text" | "node";
176
- } & Omit<React.HTMLAttributes<HTMLDivElement>, "title" | "children">;
177
- declare const Alert: React.FC<AlertProps>;
176
+ } & Omit<React$1.HTMLAttributes<HTMLDivElement>, "title" | "children">;
177
+ declare const Alert: React$1.FC<AlertProps>;
178
178
 
179
179
  /**
180
180
  * Props for the Img component.
@@ -221,7 +221,7 @@ declare const Alert: React.FC<AlertProps>;
221
221
  *
222
222
  * @see https://www.w3.org/WAI/WCAG21/Understanding/non-text-content.html
223
223
  */
224
- interface ImgProps extends Omit<React.ImgHTMLAttributes<HTMLImageElement>, 'placeholder'> {
224
+ interface ImgProps extends Omit<React$1.ImgHTMLAttributes<HTMLImageElement>, 'placeholder'> {
225
225
  /**
226
226
  * The image source URL.
227
227
  * @default '//'
@@ -255,7 +255,7 @@ interface ImgProps extends Omit<React.ImgHTMLAttributes<HTMLImageElement>, 'plac
255
255
  /**
256
256
  * Inline styles to apply to the image.
257
257
  */
258
- styles?: React.CSSProperties;
258
+ styles?: React$1.CSSProperties;
259
259
  /**
260
260
  * Loading behavior for the image.
261
261
  * - `"lazy"` (default): Defers loading until near viewport
@@ -355,7 +355,7 @@ interface ImgProps extends Omit<React.ImgHTMLAttributes<HTMLImageElement>, 'plac
355
355
  * />
356
356
  * ```
357
357
  */
358
- onError?: (event: React.SyntheticEvent<HTMLImageElement, Event>) => void;
358
+ onError?: (event: React$1.SyntheticEvent<HTMLImageElement, Event>) => void;
359
359
  /**
360
360
  * Callback fired when the image successfully loads.
361
361
  *
@@ -370,7 +370,7 @@ interface ImgProps extends Omit<React.ImgHTMLAttributes<HTMLImageElement>, 'plac
370
370
  * />
371
371
  * ```
372
372
  */
373
- onLoad?: (event: React.SyntheticEvent<HTMLImageElement, Event>) => void;
373
+ onLoad?: (event: React$1.SyntheticEvent<HTMLImageElement, Event>) => void;
374
374
  }
375
375
 
376
376
  /**
@@ -480,7 +480,7 @@ interface ImgProps extends Omit<React.ImgHTMLAttributes<HTMLImageElement>, 'plac
480
480
  * @see https://www.w3.org/WAI/WCAG21/Understanding/non-text-content.html
481
481
  */
482
482
  declare const Img: {
483
- ({ src, alt, width, height, styles, loading, placeholder, fetchpriority, decoding, srcSet, sizes, onError, onLoad, ...props }: ImgProps): React.JSX.Element;
483
+ ({ src, alt, width, height, styles, loading, placeholder, fetchpriority, decoding, srcSet, sizes, onError, onLoad, ...props }: ImgProps): React$1.JSX.Element;
484
484
  displayName: string;
485
485
  };
486
486
 
@@ -502,7 +502,7 @@ interface TextToSpeechComponentProps {
502
502
  /** The language to be used for speech synthesis. */
503
503
  language?: string;
504
504
  /** Player label */
505
- label?: string | React.ReactNode;
505
+ label?: string | React$1.ReactNode;
506
506
  /** Callback function to be called when speech ends. */
507
507
  onEnd?: () => void;
508
508
  }
@@ -511,22 +511,22 @@ interface TextToSpeechComponentProps {
511
511
  * @param {TextToSpeechComponentProps} props - The props for the component.
512
512
  * @returns {JSX.Element} The rendered TextToSpeechComponent.
513
513
  */
514
- declare const TextToSpeech: React.FC<TextToSpeechComponentProps>;
514
+ declare const TextToSpeech: React$1.FC<TextToSpeechComponentProps>;
515
515
 
516
- type ComponentProps = React.ComponentProps<typeof UI>;
516
+ type ComponentProps = React$1.ComponentProps<typeof UI>;
517
517
  /**
518
518
  * Renders children elements without any wrapping component.
519
519
  * Can be used as a placeholder when no semantic landmark is needed.
520
520
  */
521
521
  declare const Landmarks: {
522
- (children?: React.FC): React.JSX.Element;
522
+ (children?: React$1.FC): React$1.JSX.Element;
523
523
  displayName: string;
524
- Header: ({ id, children, headerBackground, styles, classes, ...props }: HeaderProps) => React.JSX.Element;
525
- Main: ({ id, children, styles, classes, ...props }: ComponentProps) => React.JSX.Element;
526
- Footer: ({ id, classes, children, styles, ...props }: ComponentProps) => React.JSX.Element;
527
- Aside: ({ id, children, styles, classes, ...props }: ComponentProps) => React.JSX.Element;
528
- Section: ({ id, children, styles, classes, ...props }: ComponentProps) => React.JSX.Element;
529
- Article: ({ id, children, styles, classes, ...props }: ComponentProps) => React.JSX.Element;
524
+ Header: ({ id, children, headerBackground, styles, classes, ...props }: HeaderProps) => React$1.JSX.Element;
525
+ Main: ({ id, children, styles, classes, ...props }: ComponentProps) => React$1.JSX.Element;
526
+ Footer: ({ id, classes, children, styles, ...props }: ComponentProps) => React$1.JSX.Element;
527
+ Aside: ({ id, children, styles, classes, ...props }: ComponentProps) => React$1.JSX.Element;
528
+ Section: ({ id, children, styles, classes, ...props }: ComponentProps) => React$1.JSX.Element;
529
+ Article: ({ id, children, styles, classes, ...props }: ComponentProps) => React$1.JSX.Element;
530
530
  };
531
531
  type HeaderProps = {
532
532
  headerBackground?: ReactNode;
@@ -540,7 +540,7 @@ type HeaderProps = {
540
540
  * @param styles - Optional styles object.
541
541
  * @param props - Other props.
542
542
  */
543
- declare const Header: ({ id, children, headerBackground, styles, classes, ...props }: HeaderProps) => React.JSX.Element;
543
+ declare const Header: ({ id, children, headerBackground, styles, classes, ...props }: HeaderProps) => React$1.JSX.Element;
544
544
  /**
545
545
  * Main component.
546
546
  *
@@ -550,7 +550,7 @@ declare const Header: ({ id, children, headerBackground, styles, classes, ...pro
550
550
  * @param styles - Optional styles object.
551
551
  * @param props - Other props.
552
552
  */
553
- declare const Main: ({ id, children, styles, classes, ...props }: ComponentProps) => React.JSX.Element;
553
+ declare const Main: ({ id, children, styles, classes, ...props }: ComponentProps) => React$1.JSX.Element;
554
554
  /**
555
555
  * Footer component that renders a footer element with a section element inside.
556
556
  * @param {ReactNode} children - Child elements to render inside the section element.
@@ -558,8 +558,8 @@ declare const Main: ({ id, children, styles, classes, ...props }: ComponentProps
558
558
  * @param props - Additional props to pass to the footer element.
559
559
  * @returns A React component that renders a footer element with a section element inside.
560
560
  */
561
- declare const Footer: ({ id, classes, children, styles, ...props }: ComponentProps) => React.JSX.Element;
562
- declare const Aside: ({ id, children, styles, classes, ...props }: ComponentProps) => React.JSX.Element;
561
+ declare const Footer: ({ id, classes, children, styles, ...props }: ComponentProps) => React$1.JSX.Element;
562
+ declare const Aside: ({ id, children, styles, classes, ...props }: ComponentProps) => React$1.JSX.Element;
563
563
  /**
564
564
  * Section component that renders a section element.
565
565
  *
@@ -567,7 +567,7 @@ declare const Aside: ({ id, children, styles, classes, ...props }: ComponentProp
567
567
  * @param styles - CSS styles to apply to the section.
568
568
  * @param props - Other props.
569
569
  */
570
- declare const Section: ({ id, children, styles, classes, ...props }: ComponentProps) => React.JSX.Element;
570
+ declare const Section: ({ id, children, styles, classes, ...props }: ComponentProps) => React$1.JSX.Element;
571
571
  /**
572
572
  * Article component renders an HTML <article> element.
573
573
  *
@@ -575,7 +575,198 @@ declare const Section: ({ id, children, styles, classes, ...props }: ComponentPr
575
575
  * @param styles - CSS styles to apply to the article.
576
576
  * @param props - Additional props to pass to the article element.
577
577
  */
578
- declare const Article: ({ id, children, styles, classes, ...props }: ComponentProps) => React.JSX.Element;
578
+ declare const Article: ({ id, children, styles, classes, ...props }: ComponentProps) => React$1.JSX.Element;
579
+
580
+ /**
581
+ * Type definitions for Flex container components
582
+ * Supports responsive flexbox layouts with CSS custom properties
583
+ */
584
+ /**
585
+ * Valid HTML elements for Flex container
586
+ * Restricted to semantic container elements only
587
+ */
588
+ type FlexContainerElement = "div" | "section" | "article" | "aside" | "main" | "header" | "footer" | "nav" | "ul" | "ol" | "dl" | "li" | "form" | "fieldset";
589
+ /**
590
+ * Valid HTML elements for Flex.Item
591
+ * Includes list item elements in addition to container elements
592
+ */
593
+ type FlexItemElement = FlexContainerElement | "li" | "dt" | "dd";
594
+ /**
595
+ * Flex container direction
596
+ */
597
+ type FlexDirection = "row" | "row-reverse" | "column" | "column-reverse";
598
+ /**
599
+ * Flex wrap behavior
600
+ */
601
+ type FlexWrap = "wrap" | "nowrap" | "wrap-reverse";
602
+ /**
603
+ * Flex justify-content alignment
604
+ */
605
+ type FlexJustify = "start" | "end" | "center" | "between" | "around" | "evenly";
606
+ /**
607
+ * Flex align-items alignment
608
+ */
609
+ type FlexAlign = "start" | "end" | "center" | "baseline" | "stretch";
610
+ /**
611
+ * Flex align-content alignment (multi-line)
612
+ */
613
+ type FlexAlignContent = "start" | "end" | "center" | "between" | "around" | "evenly" | "stretch";
614
+ /**
615
+ * Flex align-self alignment (individual items)
616
+ */
617
+ type FlexAlignSelf = "auto" | "start" | "end" | "center" | "baseline" | "stretch";
618
+ /**
619
+ * Gap size options
620
+ */
621
+ type FlexGap = "0" | "xs" | "sm" | "md" | "lg" | "xl";
622
+ /**
623
+ * Preset flex layout variants
624
+ */
625
+ type FlexVariant = "center" | "between" | "around" | "stack" | "spread";
626
+ /**
627
+ * Responsive flex properties for breakpoints
628
+ */
629
+ interface ResponsiveFlexProps {
630
+ /** Flex direction */
631
+ direction?: FlexDirection;
632
+ /** Flex wrap behavior */
633
+ wrap?: FlexWrap;
634
+ /** Gap between flex items */
635
+ gap?: FlexGap;
636
+ /** Row gap (vertical spacing) */
637
+ rowGap?: FlexGap;
638
+ /** Column gap (horizontal spacing) */
639
+ colGap?: FlexGap;
640
+ /** Justify content (main axis alignment) */
641
+ justify?: FlexJustify;
642
+ /** Align items (cross axis alignment) */
643
+ align?: FlexAlign;
644
+ /** Align content (multi-line alignment) */
645
+ alignContent?: FlexAlignContent;
646
+ }
647
+ /**
648
+ * Base Flex component props
649
+ *
650
+ * ## Semantic Elements Only
651
+ * The `as` prop is restricted to semantic container elements to ensure
652
+ * proper HTML structure and accessibility. Use only block-level container
653
+ * elements like div, section, article, or form elements.
654
+ *
655
+ * **Allowed elements**: div, section, article, aside, main, header, footer,
656
+ * nav, ul, ol, dl, form, fieldset
657
+ *
658
+ * **Not allowed**: span, a, button, input, or other inline/interactive elements
659
+ */
660
+ interface FlexProps extends ResponsiveFlexProps, Omit<React.HTMLAttributes<HTMLElement>, "className"> {
661
+ /** Preset layout variant */
662
+ variant?: FlexVariant;
663
+ /** Use inline-flex instead of flex */
664
+ inline?: boolean;
665
+ /**
666
+ * Element type to render as
667
+ * @remarks Restricted to semantic container elements only for proper HTML structure
668
+ */
669
+ as?: FlexContainerElement;
670
+ /** Additional CSS class names */
671
+ className?: string;
672
+ /** Inline styles and CSS custom properties */
673
+ styles?: React.CSSProperties;
674
+ /** Children elements */
675
+ children?: React.ReactNode;
676
+ /** Responsive props for small screens (≥30rem / 480px) */
677
+ sm?: ResponsiveFlexProps;
678
+ /** Responsive props for medium screens (≥48rem / 768px) */
679
+ md?: ResponsiveFlexProps;
680
+ /** Responsive props for large screens (≥62rem / 992px) */
681
+ lg?: ResponsiveFlexProps;
682
+ /** Responsive props for extra large screens (≥80rem / 1280px) */
683
+ xl?: ResponsiveFlexProps;
684
+ }
685
+ /**
686
+ * Flex.Item component props
687
+ *
688
+ * ## Semantic Elements
689
+ * The `as` prop accepts container elements plus list item elements (li, dt, dd)
690
+ * to support semantic list structures within flex containers.
691
+ *
692
+ * **Allowed elements**: div, section, article, aside, main, header, footer,
693
+ * nav, ul, ol, dl, form, fieldset, li, dt, dd
694
+ */
695
+ interface FlexItemProps extends Omit<React.HTMLAttributes<HTMLElement>, "className"> {
696
+ /** Flex grow factor */
697
+ grow?: 0 | 1;
698
+ /** Flex shrink factor */
699
+ shrink?: 0 | 1;
700
+ /** Flex basis */
701
+ basis?: "auto" | "0" | "full";
702
+ /** Flex shorthand: '1' | 'auto' | 'initial' | 'none' */
703
+ flex?: "1" | "auto" | "initial" | "none";
704
+ /** Align self (overrides parent align-items) */
705
+ alignSelf?: FlexAlignSelf;
706
+ /** Order of the flex item */
707
+ order?: "first" | "last" | "none";
708
+ /**
709
+ * Element type to render as
710
+ * @remarks Includes list item elements (li, dt, dd) in addition to container elements
711
+ */
712
+ as?: FlexItemElement;
713
+ /** Additional CSS class names */
714
+ className?: string;
715
+ /** Inline styles and CSS custom properties */
716
+ styles?: React.CSSProperties;
717
+ /** Children elements */
718
+ children?: React.ReactNode;
719
+ /** Responsive props for small screens (≥30rem / 480px) */
720
+ sm?: {
721
+ flex?: "1" | "auto" | "none";
722
+ };
723
+ /** Responsive props for medium screens (≥48rem / 768px) */
724
+ md?: {
725
+ flex?: "1" | "auto" | "none";
726
+ };
727
+ /** Responsive props for large screens (≥62rem / 992px) */
728
+ lg?: {
729
+ flex?: "1" | "auto" | "none";
730
+ };
731
+ /** Responsive props for extra large screens (≥80rem / 1280px) */
732
+ xl?: {
733
+ flex?: "1" | "auto" | "none";
734
+ };
735
+ }
736
+ /**
737
+ * Flex.Spacer component props
738
+ * Creates an auto-expanding spacer element (flex: 1)
739
+ *
740
+ * ## Semantic Elements Only
741
+ * The `as` prop is restricted to container elements. Spacers are purely
742
+ * presentational and should use non-semantic containers like div.
743
+ *
744
+ * **Allowed elements**: div, section, article, aside, main, header, footer,
745
+ * nav, ul, ol, dl, form, fieldset
746
+ */
747
+ interface FlexSpacerProps extends Omit<React.HTMLAttributes<HTMLElement>, "className"> {
748
+ /**
749
+ * Element type to render as
750
+ * @remarks Restricted to container elements. Default is 'div'.
751
+ */
752
+ as?: FlexContainerElement;
753
+ /** Additional CSS class names */
754
+ className?: string;
755
+ /** Inline styles and CSS custom properties */
756
+ styles?: React.CSSProperties;
757
+ }
758
+ /**
759
+ * Combined Flex component type with sub-components
760
+ */
761
+ type FlexComponent = React.ForwardRefExoticComponent<FlexProps & React.RefAttributes<HTMLElement>> & {
762
+ Item: React.ForwardRefExoticComponent<FlexItemProps & React.RefAttributes<HTMLElement>>;
763
+ Spacer: React.ForwardRefExoticComponent<FlexSpacerProps & React.RefAttributes<HTMLElement>>;
764
+ };
765
+
766
+ /**
767
+ * Attach sub-components to Flex using compound component pattern
768
+ */
769
+ declare const Flex: FlexComponent;
579
770
 
580
771
  /**
581
772
  * Props for the Badge component
@@ -592,13 +783,13 @@ type BadgeProps = {
592
783
  /**
593
784
  * Content to display inside the badge (typically numbers or short text)
594
785
  */
595
- children?: React.ReactNode;
786
+ children?: React$1.ReactNode;
596
787
  /**
597
788
  * Visual variant of the badge
598
789
  * - 'rounded': Circular badge style
599
790
  */
600
791
  variant?: 'rounded';
601
- } & React.ComponentProps<typeof UI>;
792
+ } & React$1.ComponentProps<typeof UI>;
602
793
  /**
603
794
  * Badge - A small label component for displaying status, counts, or notifications
604
795
  *
@@ -663,7 +854,7 @@ type BadgeProps = {
663
854
  * <Badge>12</Badge>
664
855
  */
665
856
  declare const Badge: {
666
- ({ id, styles, classes, children, variant, ...props }: BadgeProps): React.JSX.Element;
857
+ ({ id, styles, classes, children, variant, ...props }: BadgeProps): React$1.JSX.Element;
667
858
  displayName: string;
668
859
  };
669
860
 
@@ -743,7 +934,7 @@ type TagProps = {
743
934
  * REQUIRED - Ensures tag has meaningful content for all users including screen reader users
744
935
  * Typically short text, version numbers, or status labels
745
936
  */
746
- children: React.ReactNode;
937
+ children: React$1.ReactNode;
747
938
  /**
748
939
  * Accessible label for screen readers
749
940
  * Provides additional context beyond visible text
@@ -766,7 +957,7 @@ type TagProps = {
766
957
  * - 'assertive': Announces immediately (use sparingly for critical updates)
767
958
  */
768
959
  'aria-live'?: 'off' | 'polite' | 'assertive';
769
- } & Omit<React.ComponentProps<typeof UI>, 'as' | 'aria-label' | 'aria-labelledby' | 'aria-describedby' | 'aria-live'>;
960
+ } & Omit<React$1.ComponentProps<typeof UI>, 'as' | 'aria-label' | 'aria-labelledby' | 'aria-describedby' | 'aria-live'>;
770
961
 
771
962
  /**
772
963
  * Tag - A small inline label component for displaying status, versions, or environment indicators
@@ -860,32 +1051,32 @@ type TagProps = {
860
1051
  * <Tag role="status" variant="stable">v1.0</Tag>
861
1052
  */
862
1053
  declare const Tag: {
863
- ({ elm, role, variant, children, styles, ...props }: TagProps): React.JSX.Element;
1054
+ ({ elm, role, variant, children, styles, ...props }: TagProps): React$1.JSX.Element;
864
1055
  displayName: string;
865
1056
  };
866
1057
 
867
1058
  declare const Caption: {
868
- ({ children, ...props }: ComponentProps$1): React.JSX.Element;
1059
+ ({ children, ...props }: ComponentProps$1): React$1.JSX.Element;
869
1060
  displayName: string;
870
1061
  };
871
1062
  declare const Thead: {
872
- ({ children, ...props }: ComponentProps$1): React.JSX.Element;
1063
+ ({ children, ...props }: ComponentProps$1): React$1.JSX.Element;
873
1064
  displayName: string;
874
1065
  };
875
1066
  declare const Tbody: {
876
- ({ children, ...props }: ComponentProps$1): React.JSX.Element;
1067
+ ({ children, ...props }: ComponentProps$1): React$1.JSX.Element;
877
1068
  displayName: string;
878
1069
  };
879
1070
  declare const Tr: {
880
- ({ children, ...props }: ComponentProps$1): React.JSX.Element;
1071
+ ({ children, ...props }: ComponentProps$1): React$1.JSX.Element;
881
1072
  displayName: string;
882
1073
  };
883
1074
  declare const Td: {
884
- ({ children, ...props }: ComponentProps$1): React.JSX.Element;
1075
+ ({ children, ...props }: ComponentProps$1): React$1.JSX.Element;
885
1076
  displayName: string;
886
1077
  };
887
1078
  declare const Table: {
888
- ({ id, dataStyle, children, ...props }: ComponentProps$1): React.JSX.Element;
1079
+ ({ id, children, ...props }: ComponentProps$1): React$1.JSX.Element;
889
1080
  displayName: string;
890
1081
  };
891
1082
 
@@ -920,7 +1111,7 @@ type DetailsProps = {
920
1111
  * summary={<><Icon /> Shipping Information</>}
921
1112
  * ```
922
1113
  */
923
- summary: React.ReactNode;
1114
+ summary: React$1.ReactNode;
924
1115
  /**
925
1116
  * Optional icon displayed before the summary text.
926
1117
  * Commonly used for chevron/arrow indicators.
@@ -930,7 +1121,7 @@ type DetailsProps = {
930
1121
  * icon={<ChevronDownIcon />}
931
1122
  * ```
932
1123
  */
933
- icon?: React.ReactNode;
1124
+ icon?: React$1.ReactNode;
934
1125
  /**
935
1126
  * Accessible label for screen readers.
936
1127
  * If not provided, the native `<details>` semantic will be used.
@@ -957,7 +1148,7 @@ type DetailsProps = {
957
1148
  * ```
958
1149
  */
959
1150
  name?: string;
960
- } & React.ComponentProps<"details"> & Partial<React.ComponentProps<typeof UI>>;
1151
+ } & React$1.ComponentProps<"details"> & Partial<React$1.ComponentProps<typeof UI>>;
961
1152
 
962
1153
  /**
963
1154
  * Details - A progressive disclosure component using native HTML `<details>` element.
@@ -1008,44 +1199,44 @@ type DetailsProps = {
1008
1199
  * <Details name="faq" summary="Question 3">Answer 3</Details>
1009
1200
  * ```
1010
1201
  */
1011
- declare const Details: React.ForwardRefExoticComponent<Omit<DetailsProps, "ref"> & React.RefAttributes<HTMLDetailsElement>>;
1202
+ declare const Details: React$1.ForwardRefExoticComponent<Omit<DetailsProps, "ref"> & React$1.RefAttributes<HTMLDetailsElement>>;
1012
1203
 
1013
1204
  /**
1014
1205
  * @deprecated This type is deprecated. Use `PolymorphicRef` from './ui.tsx' instead.
1015
1206
  * The UI component provides better type safety and accessibility features.
1016
1207
  */
1017
- type PolymorphicRef<C extends React.ElementType> = React.Ref<React.ElementRef<C>>;
1208
+ type PolymorphicRef<C extends React$1.ElementType> = React$1.Ref<React$1.ElementRef<C>>;
1018
1209
  /**
1019
1210
  * @deprecated This type is deprecated. Use `AsProp` from './ui.tsx' instead.
1020
1211
  * The UI component provides better type safety and accessibility features.
1021
1212
  */
1022
- type AsProp<C extends React.ElementType> = {
1213
+ type AsProp<C extends React$1.ElementType> = {
1023
1214
  as?: C;
1024
1215
  };
1025
1216
  /**
1026
1217
  * @deprecated This type is deprecated. Use `PropsToOmit` from './ui.tsx' instead.
1027
1218
  * The UI component provides better type safety and accessibility features.
1028
1219
  */
1029
- type PropsToOmit<C extends React.ElementType, P> = keyof (AsProp<C> & P);
1220
+ type PropsToOmit<C extends React$1.ElementType, P> = keyof (AsProp<C> & P);
1030
1221
  /**
1031
1222
  * @deprecated This type is deprecated. Use `PolymorphicComponentProp` from './ui.tsx' instead.
1032
1223
  * The UI component provides better type safety and accessibility features.
1033
1224
  */
1034
- type PolymorphicComponentProp<C extends React.ElementType, Props = {}> = React.PropsWithChildren<Props & AsProp<C>> & Omit<React.ComponentPropsWithoutRef<C>, PropsToOmit<C, Props>>;
1225
+ type PolymorphicComponentProp<C extends React$1.ElementType, Props = {}> = React$1.PropsWithChildren<Props & AsProp<C>> & Omit<React$1.ComponentPropsWithoutRef<C>, PropsToOmit<C, Props>>;
1035
1226
  /**
1036
1227
  * @deprecated This type is deprecated. Use `PolymorphicComponentPropWithRef` from './ui.tsx' instead.
1037
1228
  * The UI component provides better type safety and accessibility features.
1038
1229
  */
1039
- type PolymorphicComponentPropWithRef<C extends React.ElementType, Props = {}> = PolymorphicComponentProp<C, Props> & {
1040
- ref?: PolymorphicRef<C> | React.ForwardedRef<React.ElementRef<C>>;
1230
+ type PolymorphicComponentPropWithRef<C extends React$1.ElementType, Props = {}> = PolymorphicComponentProp<C, Props> & {
1231
+ ref?: PolymorphicRef<C> | React$1.ForwardedRef<React$1.ElementRef<C>>;
1041
1232
  };
1042
1233
  /**
1043
1234
  * @deprecated This type is deprecated. Use `UIProps` from './ui.tsx' instead.
1044
1235
  * The UI component provides better type safety and accessibility features.
1045
1236
  */
1046
- type FPProps<C extends React.ElementType> = PolymorphicComponentPropWithRef<C, {
1237
+ type FPProps<C extends React$1.ElementType> = PolymorphicComponentPropWithRef<C, {
1047
1238
  renderStyles?: boolean;
1048
- styles?: React.CSSProperties;
1239
+ styles?: React$1.CSSProperties;
1049
1240
  classes?: string;
1050
1241
  }>;
1051
1242
  /**
@@ -1072,7 +1263,7 @@ type FPProps<C extends React.ElementType> = PolymorphicComponentPropWithRef<C, {
1072
1263
  * ```
1073
1264
  */
1074
1265
  type FPComponent = {
1075
- <C extends React.ElementType = 'span'>(props: FPProps<C>): React.ReactElement | null;
1266
+ <C extends React$1.ElementType = 'span'>(props: FPProps<C>): React$1.ReactElement | null;
1076
1267
  displayName?: string;
1077
1268
  };
1078
1269
  /**
@@ -1111,4 +1302,4 @@ type FPComponent = {
1111
1302
  */
1112
1303
  declare const FP: FPComponent;
1113
1304
 
1114
- export { Alert, AlertProps, Article, Aside, Badge, BadgeProps, FP as Box, Caption, ComponentProps$1 as ComponentProps, Details, FP, Footer, Header, Img, ImgProps, Landmarks, Main, Section, Table, Tag, TagProps, TagVariant, Tbody, Td, TextToSpeech, Thead, Tr, UI };
1305
+ export { Alert, AlertProps, Article, Aside, Badge, BadgeProps, FP as Box, Caption, ComponentProps$1 as ComponentProps, Details, FP, Flex, FlexAlign, FlexAlignContent, FlexAlignSelf, FlexContainerElement, FlexDirection, FlexGap, FlexItemElement, FlexItemProps, FlexJustify, FlexProps, FlexSpacerProps, FlexVariant, FlexWrap, Footer, Header, Img, ImgProps, Landmarks, Main, ResponsiveFlexProps, Section, Table, Tag, TagProps, TagVariant, Tbody, Td, TextToSpeech, Thead, Tr, UI };