@allxsmith/bestax-bulma 5.7.0 → 5.8.0

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 (128) hide show
  1. package/AGENTS.md +28 -0
  2. package/CLAUDE.md +28 -0
  3. package/README.md +4 -0
  4. package/dist/index.cjs.js +3629 -37
  5. package/dist/index.cjs.js.map +1 -1
  6. package/dist/index.esm.js +3629 -37
  7. package/dist/index.esm.js.map +1 -1
  8. package/dist/types/columns/Column.d.ts +43 -0
  9. package/dist/types/columns/Columns.d.ts +38 -0
  10. package/dist/types/components/Avatar.d.ts +37 -0
  11. package/dist/types/components/Avatars.d.ts +13 -0
  12. package/dist/types/components/Badge.d.ts +42 -0
  13. package/dist/types/components/Breadcrumb.d.ts +28 -0
  14. package/dist/types/components/Card.d.ts +62 -0
  15. package/dist/types/components/Carousel.d.ts +70 -0
  16. package/dist/types/components/Collapse.d.ts +53 -0
  17. package/dist/types/components/Dialog.d.ts +94 -0
  18. package/dist/types/components/Dropdown.d.ts +44 -0
  19. package/dist/types/components/Loading.d.ts +55 -0
  20. package/dist/types/components/Menu.d.ts +48 -0
  21. package/dist/types/components/Message.d.ts +23 -0
  22. package/dist/types/components/Modal.d.ts +56 -0
  23. package/dist/types/components/Navbar.d.ts +159 -0
  24. package/dist/types/components/Pagination.d.ts +77 -0
  25. package/dist/types/components/Panel.d.ts +100 -0
  26. package/dist/types/components/Reveal.d.ts +43 -0
  27. package/dist/types/components/Sidebar.d.ts +40 -0
  28. package/dist/types/components/Steps.d.ts +65 -0
  29. package/dist/types/components/Tabs.d.ts +89 -0
  30. package/dist/types/components/Toast.d.ts +109 -0
  31. package/dist/types/components/Tooltip.d.ts +50 -0
  32. package/dist/types/elements/Block.d.ts +20 -0
  33. package/dist/types/elements/Box.d.ts +23 -1
  34. package/dist/types/elements/Button.d.ts +26 -0
  35. package/dist/types/elements/Buttons.d.ts +12 -0
  36. package/dist/types/elements/Code.d.ts +19 -0
  37. package/dist/types/elements/Content.d.ts +21 -0
  38. package/dist/types/elements/Delete.d.ts +22 -0
  39. package/dist/types/elements/Divider.d.ts +16 -0
  40. package/dist/types/elements/Emphasis.d.ts +19 -0
  41. package/dist/types/elements/Figure.d.ts +25 -0
  42. package/dist/types/elements/Icon.d.ts +28 -0
  43. package/dist/types/elements/IconText.d.ts +17 -0
  44. package/dist/types/elements/Image.d.ts +27 -0
  45. package/dist/types/elements/Link.d.ts +24 -0
  46. package/dist/types/elements/LinkButton.d.ts +26 -0
  47. package/dist/types/elements/ListItem.d.ts +20 -0
  48. package/dist/types/elements/Notification.d.ts +101 -0
  49. package/dist/types/elements/OrderedList.d.ts +11 -0
  50. package/dist/types/elements/Paragraph.d.ts +19 -0
  51. package/dist/types/elements/Pre.d.ts +19 -0
  52. package/dist/types/elements/Progress.d.ts +20 -0
  53. package/dist/types/elements/Skeleton.d.ts +31 -0
  54. package/dist/types/elements/Span.d.ts +18 -0
  55. package/dist/types/elements/Strong.d.ts +19 -0
  56. package/dist/types/elements/SubTitle.d.ts +27 -0
  57. package/dist/types/elements/Table.d.ts +15 -0
  58. package/dist/types/elements/Tag.d.ts +28 -0
  59. package/dist/types/elements/Tags.d.ts +8 -0
  60. package/dist/types/elements/Tbody.d.ts +19 -0
  61. package/dist/types/elements/Td.d.ts +24 -0
  62. package/dist/types/elements/Tfoot.d.ts +19 -0
  63. package/dist/types/elements/Th.d.ts +25 -0
  64. package/dist/types/elements/Thead.d.ts +19 -0
  65. package/dist/types/elements/Title.d.ts +28 -0
  66. package/dist/types/elements/Tr.d.ts +21 -0
  67. package/dist/types/elements/UnorderedList.d.ts +8 -0
  68. package/dist/types/form/Autocomplete.d.ts +67 -0
  69. package/dist/types/form/Checkbox.d.ts +44 -0
  70. package/dist/types/form/Checkboxes.d.ts +10 -0
  71. package/dist/types/form/Control.d.ts +36 -0
  72. package/dist/types/form/DateInput.d.ts +44 -0
  73. package/dist/types/form/DateInputBase.d.ts +47 -0
  74. package/dist/types/form/DateTimeInput.d.ts +42 -0
  75. package/dist/types/form/DateTimeInputBase.d.ts +56 -0
  76. package/dist/types/form/Field.d.ts +55 -0
  77. package/dist/types/form/File.d.ts +26 -0
  78. package/dist/types/form/FormContext.d.ts +46 -0
  79. package/dist/types/form/Input.d.ts +49 -0
  80. package/dist/types/form/InputBase.d.ts +22 -0
  81. package/dist/types/form/Numberinput.d.ts +46 -0
  82. package/dist/types/form/Radio.d.ts +44 -0
  83. package/dist/types/form/Radios.d.ts +10 -0
  84. package/dist/types/form/Rate.d.ts +71 -0
  85. package/dist/types/form/Select.d.ts +39 -0
  86. package/dist/types/form/SelectBase.d.ts +25 -0
  87. package/dist/types/form/Slider.d.ts +71 -0
  88. package/dist/types/form/Switch.d.ts +53 -0
  89. package/dist/types/form/Taginput.d.ts +77 -0
  90. package/dist/types/form/TextArea.d.ts +38 -0
  91. package/dist/types/form/TextAreaBase.d.ts +25 -0
  92. package/dist/types/form/TimeInput.d.ts +39 -0
  93. package/dist/types/form/TimeInputBase.d.ts +72 -0
  94. package/dist/types/form/_pickerInternals/Calendar.d.ts +6 -0
  95. package/dist/types/form/_pickerInternals/TimeWheels.d.ts +13 -0
  96. package/dist/types/form/_pickerInternals/audioTick.d.ts +47 -0
  97. package/dist/types/form/_pickerInternals/dateUtils.d.ts +13 -0
  98. package/dist/types/form/_pickerInternals/formatters.d.ts +19 -0
  99. package/dist/types/form/_pickerInternals/haptics.d.ts +23 -0
  100. package/dist/types/form/_pickerInternals/pickerTypes.d.ts +8 -0
  101. package/dist/types/form/_pickerInternals/segmentMap.d.ts +48 -0
  102. package/dist/types/form/_pickerInternals/useNativeMobilePicker.d.ts +1 -0
  103. package/dist/types/form/_pickerInternals/useSegmentedEntry.d.ts +30 -0
  104. package/dist/types/form/fieldProps.d.ts +12 -0
  105. package/dist/types/grid/Cell.d.ts +26 -0
  106. package/dist/types/grid/Grid.d.ts +33 -0
  107. package/dist/types/helpers/Config.d.ts +50 -0
  108. package/dist/types/helpers/Theme.d.ts +66 -0
  109. package/dist/types/helpers/bulmaClassHelpers.d.ts +97 -0
  110. package/dist/types/helpers/classNames.d.ts +50 -0
  111. package/dist/types/helpers/useBulmaClasses.d.ts +22 -0
  112. package/dist/types/helpers/useColorClasses.d.ts +20 -0
  113. package/dist/types/helpers/useFlexboxClasses.d.ts +34 -0
  114. package/dist/types/helpers/useOtherClasses.d.ts +27 -0
  115. package/dist/types/helpers/useSpacingClasses.d.ts +27 -0
  116. package/dist/types/helpers/useTypographyClasses.d.ts +32 -0
  117. package/dist/types/helpers/useVisibilityClasses.d.ts +25 -0
  118. package/dist/types/helpers/withSubComponents.d.ts +13 -0
  119. package/dist/types/layout/Container.d.ts +26 -0
  120. package/dist/types/layout/Footer.d.ts +23 -0
  121. package/dist/types/layout/Hero.d.ts +61 -0
  122. package/dist/types/layout/Level.d.ts +63 -0
  123. package/dist/types/layout/Media.d.ts +60 -0
  124. package/dist/types/layout/Section.d.ts +21 -0
  125. package/dist/types/skill-examples/ExampleMeta.d.ts +5 -0
  126. package/dist/types/skill-examples/ProfileCard.d.ts +13 -0
  127. package/llms.txt +9 -0
  128. package/package.json +13 -11
@@ -1,6 +1,23 @@
1
1
  import React from 'react';
2
2
  import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
3
+ /**
4
+ * Bulma container breakpoints.
5
+ */
3
6
  export type ContainerBreakpoint = 'tablet' | 'desktop' | 'widescreen';
7
+ /**
8
+ * Props for the Container component.
9
+ *
10
+ * @property {string} [className] - Additional CSS classes.
11
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color.
12
+ * @property {'primary'|'link'|'info'|'success'|'warning'|'danger'} [color] - Bulma color modifier.
13
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color.
14
+ * @property {boolean} [fluid] - Full-width container.
15
+ * @property {boolean} [widescreen] - Container is widescreen.
16
+ * @property {boolean} [fullhd] - Container is fullhd.
17
+ * @property {ContainerBreakpoint} [breakpoint] - Responsive breakpoint.
18
+ * @property {boolean} [isMax] - Use is-max-* class for breakpoint.
19
+ * @property {React.ReactNode} [children] - Content inside the container.
20
+ */
4
21
  export interface ContainerProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
5
22
  className?: string;
6
23
  textColor?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -13,5 +30,14 @@ export interface ContainerProps extends React.HTMLAttributes<HTMLDivElement>, Om
13
30
  isMax?: boolean;
14
31
  children?: React.ReactNode;
15
32
  }
33
+ /**
34
+ * Container component for Bulma.
35
+ * Adds optional responsive, fluid, and color support, including is-max-* and breakpoint classes.
36
+ *
37
+ * @function
38
+ * @param {ContainerProps} props - Props for the Container component.
39
+ * @returns {JSX.Element} The rendered container.
40
+ * @see {@link https://bulma.io/documentation/layout/container/ | Bulma Container documentation}
41
+ */
16
42
  export declare const Container: React.FC<ContainerProps>;
17
43
  export default Container;
@@ -1,5 +1,15 @@
1
1
  import React from 'react';
2
2
  import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
3
+ /**
4
+ * Props for the Footer component.
5
+ *
6
+ * @property {'footer'|'div'} [as] - The HTML tag to render as.
7
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [color] - Bulma color modifier.
8
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color.
9
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color.
10
+ * @property {string} [className] - Additional CSS classes.
11
+ * @property {React.ReactNode} [children] - Content inside the footer.
12
+ */
3
13
  export interface FooterProps extends React.HTMLAttributes<HTMLElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
4
14
  as?: 'footer' | 'div';
5
15
  color?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -8,5 +18,18 @@ export interface FooterProps extends React.HTMLAttributes<HTMLElement>, Omit<Bul
8
18
  className?: string;
9
19
  children?: React.ReactNode;
10
20
  }
21
+ /**
22
+ * Bulma Footer component.
23
+ *
24
+ * @function
25
+ * @param {FooterProps} props - Props for the Footer component.
26
+ * @returns {JSX.Element} The rendered footer element.
27
+ * @see {@link https://bulma.io/documentation/layout/footer/ | Bulma Footer documentation}
28
+ *
29
+ * @example
30
+ * <Footer>
31
+ * <div className="content has-text-centered">...</div>
32
+ * </Footer>
33
+ */
11
34
  export declare const Footer: React.FC<FooterProps>;
12
35
  export default Footer;
@@ -1,6 +1,19 @@
1
1
  import React from 'react';
2
2
  import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
3
+ /**
4
+ * Possible values for Bulma hero size.
5
+ */
3
6
  export type HeroSize = 'small' | 'medium' | 'large' | 'fullheight' | 'fullheight-with-navbar';
7
+ /**
8
+ * Props for the Hero component.
9
+ *
10
+ * @property {string} [className] - Additional CSS classes.
11
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [color] - Bulma color modifier.
12
+ * @property {HeroSize} [size] - Hero size.
13
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color.
14
+ * @property {boolean} [fullheightWithNavbar] - Use fullheight with navbar.
15
+ * @property {React.ReactNode} [children] - Content inside the hero.
16
+ */
4
17
  export interface HeroProps extends React.HTMLAttributes<HTMLElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
5
18
  className?: string;
6
19
  color?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -9,6 +22,15 @@ export interface HeroProps extends React.HTMLAttributes<HTMLElement>, Omit<Bulma
9
22
  fullheightWithNavbar?: boolean;
10
23
  children?: React.ReactNode;
11
24
  }
25
+ /**
26
+ * Props for the HeroHead component.
27
+ *
28
+ * @property {string} [className] - Additional CSS classes.
29
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [color] - Bulma color modifier for text.
30
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color.
31
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color.
32
+ * @property {React.ReactNode} [children] - Content.
33
+ */
12
34
  export interface HeroHeadProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
13
35
  className?: string;
14
36
  color?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -16,7 +38,23 @@ export interface HeroHeadProps extends React.HTMLAttributes<HTMLDivElement>, Omi
16
38
  textColor?: (typeof validColors)[number] | 'inherit' | 'current';
17
39
  children?: React.ReactNode;
18
40
  }
41
+ /**
42
+ * Bulma Hero head section.
43
+ *
44
+ * @function
45
+ * @param {HeroHeadProps} props - Props for the HeroHead component.
46
+ * @returns {JSX.Element} The rendered hero head.
47
+ */
19
48
  export declare const HeroHead: React.FC<HeroHeadProps>;
49
+ /**
50
+ * Props for the HeroBody component.
51
+ *
52
+ * @property {string} [className] - Additional CSS classes.
53
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [color] - Bulma color modifier for text.
54
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color.
55
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color.
56
+ * @property {React.ReactNode} [children] - Content.
57
+ */
20
58
  export interface HeroBodyProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
21
59
  className?: string;
22
60
  color?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -24,7 +62,23 @@ export interface HeroBodyProps extends React.HTMLAttributes<HTMLDivElement>, Omi
24
62
  textColor?: (typeof validColors)[number] | 'inherit' | 'current';
25
63
  children?: React.ReactNode;
26
64
  }
65
+ /**
66
+ * Bulma Hero body section.
67
+ *
68
+ * @function
69
+ * @param {HeroBodyProps} props - Props for the HeroBody component.
70
+ * @returns {JSX.Element} The rendered hero body.
71
+ */
27
72
  export declare const HeroBody: React.FC<HeroBodyProps>;
73
+ /**
74
+ * Props for the HeroFoot component.
75
+ *
76
+ * @property {string} [className] - Additional CSS classes.
77
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [color] - Bulma color modifier for text.
78
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color.
79
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color.
80
+ * @property {React.ReactNode} [children] - Content.
81
+ */
28
82
  export interface HeroFootProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
29
83
  className?: string;
30
84
  color?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -32,6 +86,13 @@ export interface HeroFootProps extends React.HTMLAttributes<HTMLDivElement>, Omi
32
86
  textColor?: (typeof validColors)[number] | 'inherit' | 'current';
33
87
  children?: React.ReactNode;
34
88
  }
89
+ /**
90
+ * Bulma Hero foot section.
91
+ *
92
+ * @function
93
+ * @param {HeroFootProps} props - Props for the HeroFoot component.
94
+ * @returns {JSX.Element} The rendered hero foot.
95
+ */
35
96
  export declare const HeroFoot: React.FC<HeroFootProps>;
36
97
  export declare const Hero: React.FC<HeroProps> & {
37
98
  Head: React.FC<HeroHeadProps>;
@@ -1,5 +1,15 @@
1
1
  import React from 'react';
2
2
  import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
3
+ /**
4
+ * Props for the Level component.
5
+ *
6
+ * @property {boolean} [isMobile] - Enable mobile mode.
7
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [color] - Bulma color modifier.
8
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color.
9
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color.
10
+ * @property {string} [className] - Additional CSS classes.
11
+ * @property {React.ReactNode} [children] - Level content.
12
+ */
3
13
  export interface LevelProps extends React.HTMLAttributes<HTMLElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
4
14
  isMobile?: boolean;
5
15
  color?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -8,6 +18,15 @@ export interface LevelProps extends React.HTMLAttributes<HTMLElement>, Omit<Bulm
8
18
  className?: string;
9
19
  children?: React.ReactNode;
10
20
  }
21
+ /**
22
+ * Props for the LevelLeft component.
23
+ *
24
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [color] - Bulma color modifier.
25
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color.
26
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color.
27
+ * @property {string} [className] - Additional CSS classes.
28
+ * @property {React.ReactNode} [children] - Content.
29
+ */
11
30
  export interface LevelLeftProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
12
31
  color?: (typeof validColors)[number] | 'inherit' | 'current';
13
32
  bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -15,7 +34,23 @@ export interface LevelLeftProps extends React.HTMLAttributes<HTMLDivElement>, Om
15
34
  className?: string;
16
35
  children?: React.ReactNode;
17
36
  }
37
+ /**
38
+ * Bulma Level left section.
39
+ *
40
+ * @function
41
+ * @param {LevelLeftProps} props - Props for the LevelLeft component.
42
+ * @returns {JSX.Element} The rendered level left section.
43
+ */
18
44
  export declare const LevelLeft: React.FC<LevelLeftProps>;
45
+ /**
46
+ * Props for the LevelRight component.
47
+ *
48
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [color] - Bulma color modifier.
49
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color.
50
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color.
51
+ * @property {string} [className] - Additional CSS classes.
52
+ * @property {React.ReactNode} [children] - Content.
53
+ */
19
54
  export interface LevelRightProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
20
55
  color?: (typeof validColors)[number] | 'inherit' | 'current';
21
56
  bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -23,7 +58,28 @@ export interface LevelRightProps extends React.HTMLAttributes<HTMLDivElement>, O
23
58
  className?: string;
24
59
  children?: React.ReactNode;
25
60
  }
61
+ /**
62
+ * Bulma Level right section.
63
+ *
64
+ * @function
65
+ * @param {LevelRightProps} props - Props for the LevelRight component.
66
+ * @returns {JSX.Element} The rendered level right section.
67
+ */
26
68
  export declare const LevelRight: React.FC<LevelRightProps>;
69
+ /**
70
+ * Props for the LevelItem component.
71
+ *
72
+ * @property {'div'|'p'|'a'} [as] - Element type to render.
73
+ * @property {boolean} [hasTextCentered] - Center the text in the item.
74
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [color] - Bulma color modifier.
75
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color.
76
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color.
77
+ * @property {string} [className] - Additional CSS classes.
78
+ * @property {React.ReactNode} [children] - Content.
79
+ * @property {string} [href] - Href for "a" tag.
80
+ * @property {string} [target] - Target for "a" tag
81
+ * @property {string} [rel] - Rel for "a" tag
82
+ */
27
83
  export interface LevelItemProps extends React.HTMLAttributes<HTMLDivElement | HTMLParagraphElement | HTMLAnchorElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
28
84
  as?: 'div' | 'p' | 'a';
29
85
  hasTextCentered?: boolean;
@@ -36,6 +92,13 @@ export interface LevelItemProps extends React.HTMLAttributes<HTMLDivElement | HT
36
92
  target?: string;
37
93
  rel?: string;
38
94
  }
95
+ /**
96
+ * Bulma Level item section.
97
+ *
98
+ * @function
99
+ * @param {LevelItemProps} props - Props for the LevelItem component.
100
+ * @returns {JSX.Element} The rendered level item.
101
+ */
39
102
  export declare const LevelItem: React.FC<LevelItemProps>;
40
103
  export declare const Level: React.FC<LevelProps> & {
41
104
  Left: React.FC<LevelLeftProps>;
@@ -1,5 +1,15 @@
1
1
  import React from 'react';
2
2
  import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
3
+ /**
4
+ * Props for the Media component.
5
+ *
6
+ * @property {'article'|'div'} [as] - Element type to render.
7
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [color] - Bulma color modifier.
8
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color.
9
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color.
10
+ * @property {string} [className] - Additional CSS classes.
11
+ * @property {React.ReactNode} [children] - Content.
12
+ */
3
13
  export interface MediaProps extends React.HTMLAttributes<HTMLElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
4
14
  as?: 'article' | 'div';
5
15
  color?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -8,6 +18,16 @@ export interface MediaProps extends React.HTMLAttributes<HTMLElement>, Omit<Bulm
8
18
  className?: string;
9
19
  children?: React.ReactNode;
10
20
  }
21
+ /**
22
+ * Props for the MediaLeft component.
23
+ *
24
+ * @property {'figure'|'div'} [as] - Element type to render.
25
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [color] - Bulma color modifier.
26
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color.
27
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color.
28
+ * @property {string} [className] - Additional CSS classes.
29
+ * @property {React.ReactNode} [children] - Content.
30
+ */
11
31
  export interface MediaLeftProps extends React.HTMLAttributes<HTMLElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
12
32
  as?: 'figure' | 'div';
13
33
  color?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -16,7 +36,23 @@ export interface MediaLeftProps extends React.HTMLAttributes<HTMLElement>, Omit<
16
36
  className?: string;
17
37
  children?: React.ReactNode;
18
38
  }
39
+ /**
40
+ * Bulma Media left section.
41
+ *
42
+ * @function
43
+ * @param {MediaLeftProps} props - Props for the MediaLeft component.
44
+ * @returns {JSX.Element} The rendered media left section.
45
+ */
19
46
  export declare const MediaLeft: React.FC<MediaLeftProps>;
47
+ /**
48
+ * Props for the MediaContent component.
49
+ *
50
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [color] - Bulma color modifier.
51
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color.
52
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color.
53
+ * @property {string} [className] - Additional CSS classes.
54
+ * @property {React.ReactNode} [children] - Content.
55
+ */
20
56
  export interface MediaContentProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
21
57
  color?: (typeof validColors)[number] | 'inherit' | 'current';
22
58
  bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -24,7 +60,23 @@ export interface MediaContentProps extends React.HTMLAttributes<HTMLDivElement>,
24
60
  className?: string;
25
61
  children?: React.ReactNode;
26
62
  }
63
+ /**
64
+ * Bulma Media content section.
65
+ *
66
+ * @function
67
+ * @param {MediaContentProps} props - Props for the MediaContent component.
68
+ * @returns {JSX.Element} The rendered media content section.
69
+ */
27
70
  export declare const MediaContent: React.FC<MediaContentProps>;
71
+ /**
72
+ * Props for the MediaRight component.
73
+ *
74
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [color] - Bulma color modifier.
75
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color.
76
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color.
77
+ * @property {string} [className] - Additional CSS classes.
78
+ * @property {React.ReactNode} [children] - Content.
79
+ */
28
80
  export interface MediaRightProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
29
81
  color?: (typeof validColors)[number] | 'inherit' | 'current';
30
82
  bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -32,7 +84,15 @@ export interface MediaRightProps extends React.HTMLAttributes<HTMLDivElement>, O
32
84
  className?: string;
33
85
  children?: React.ReactNode;
34
86
  }
87
+ /**
88
+ * Bulma Media right section.
89
+ *
90
+ * @function
91
+ * @param {MediaRightProps} props - Props for the MediaRight component.
92
+ * @returns {JSX.Element} The rendered media right section.
93
+ */
35
94
  export declare const MediaRight: React.FC<MediaRightProps>;
95
+ /** Media component with Left, Content, and Right sub-components. */
36
96
  export declare const Media: React.FC<MediaProps> & {
37
97
  Left: React.FC<MediaLeftProps>;
38
98
  Content: React.FC<MediaContentProps>;
@@ -1,6 +1,19 @@
1
1
  import React from 'react';
2
2
  import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
3
+ /**
4
+ * Section size values for Bulma.
5
+ */
3
6
  type SectionSize = 'medium' | 'large';
7
+ /**
8
+ * Props for the Section component.
9
+ *
10
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [color] - Bulma color modifier.
11
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color.
12
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color.
13
+ * @property {'medium'|'large'} [size] - Section size.
14
+ * @property {string} [className] - Additional CSS classes.
15
+ * @property {React.ReactNode} [children] - Section content.
16
+ */
4
17
  export interface SectionProps extends React.HTMLAttributes<HTMLElement>, Omit<BulmaClassesProps, 'backgroundColor' | 'color'> {
5
18
  color?: (typeof validColors)[number] | 'inherit' | 'current';
6
19
  bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -9,5 +22,13 @@ export interface SectionProps extends React.HTMLAttributes<HTMLElement>, Omit<Bu
9
22
  className?: string;
10
23
  children?: React.ReactNode;
11
24
  }
25
+ /**
26
+ * Bulma Section component for general layout.
27
+ *
28
+ * @function
29
+ * @param {SectionProps} props - Props for the Section component.
30
+ * @returns {JSX.Element} The rendered section.
31
+ * @see {@link https://bulma.io/documentation/layout/section/ | Bulma Section documentation}
32
+ */
12
33
  export declare const Section: React.FC<SectionProps>;
13
34
  export {};
@@ -1,9 +1,14 @@
1
1
  import React from 'react';
2
2
  export interface ExampleMetaProps {
3
+ /** Skill slug, e.g. "bestax-custom-component". */
3
4
  skill: string;
5
+ /** Link to the skill's SKILL.md. */
4
6
  skillHref: string;
7
+ /** Natural-language request given to the agent. */
5
8
  prompt: string;
9
+ /** Model that generated the example, e.g. "Claude Opus 4.8". */
6
10
  model: string;
11
+ /** Date generated, e.g. "2026-06-27". */
7
12
  date: string;
8
13
  }
9
14
  export declare const ExampleMeta: React.FC<ExampleMetaProps>;
@@ -1,10 +1,23 @@
1
1
  import React from 'react';
2
2
  import { BulmaClassesProps } from '../helpers/useBulmaClasses';
3
3
  export interface ProfileCardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title' | 'color'>, BulmaClassesProps {
4
+ /** Person's name (rendered as the title). */
4
5
  name: string;
6
+ /** Role / subtitle line under the name. */
5
7
  role?: string;
8
+ /** Avatar image URL. */
6
9
  imageSrc: string;
10
+ /** Alt text for the avatar (defaults to the name). */
7
11
  imageAlt?: string;
8
12
  }
13
+ /**
14
+ * ProfileCard — avatar on top, then name, role, and a description. Composes the
15
+ * existing Image/Title/SubTitle/Content elements.
16
+ *
17
+ * @example
18
+ * <ProfileCard name="Ada Lovelace" role="Mathematician" imageSrc="/ada.jpg">
19
+ * Wrote the first algorithm intended for a machine.
20
+ * </ProfileCard>
21
+ */
9
22
  export declare const ProfileCard: React.ForwardRefExoticComponent<ProfileCardProps & React.RefAttributes<HTMLDivElement>>;
10
23
  export default ProfileCard;
package/llms.txt ADDED
@@ -0,0 +1,9 @@
1
+ # @allxsmith/bestax-bulma
2
+
3
+ React components for Bulma v1.
4
+
5
+ - Docs index: https://bestax.io/llms.txt
6
+ - Full docs (one file): https://bestax.io/llms-full.txt
7
+ - Any docs page as markdown: append .md (e.g. https://bestax.io/docs/api/elements/button.md)
8
+ - LLM guide: https://bestax.io/docs/guides/llms
9
+ - Agent skills: https://bestax.io/docs/skills/intro
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allxsmith/bestax-bulma",
3
- "version": "5.7.0",
3
+ "version": "5.8.0",
4
4
  "description": "A fully-typed React component library for the Bulma CSS framework. Build modern UIs quickly with reusable, accessible, and customizable Bulma-based React components.",
5
5
  "main": "dist/index.cjs.js",
6
6
  "module": "dist/index.esm.js",
@@ -9,7 +9,10 @@
9
9
  "files": [
10
10
  "dist",
11
11
  "src/scss",
12
- "README.md"
12
+ "README.md",
13
+ "AGENTS.md",
14
+ "CLAUDE.md",
15
+ "llms.txt"
13
16
  ],
14
17
  "sideEffects": [
15
18
  "**/*.css",
@@ -34,7 +37,9 @@
34
37
  "release": "npx semantic-release",
35
38
  "test-storybook": "test-storybook",
36
39
  "test-storybook:dark": "STORYBOOK_THEME=dark test-storybook",
37
- "test-storybook:ci": "node scripts/test-storybook-ci.mjs"
40
+ "test-storybook:ci": "node scripts/test-storybook-ci.mjs",
41
+ "prepack": "node scripts/pack-pointer-files.mjs prepack",
42
+ "postpack": "node scripts/pack-pointer-files.mjs postpack"
38
43
  },
39
44
  "devDependencies": {
40
45
  "@faker-js/faker": "^10.5.0",
@@ -111,7 +116,11 @@
111
116
  "react",
112
117
  "bulma",
113
118
  "typescript",
114
- "components"
119
+ "components",
120
+ "ai",
121
+ "llms",
122
+ "agents",
123
+ "agent-skills"
115
124
  ],
116
125
  "exports": {
117
126
  ".": {
@@ -179,13 +188,6 @@
179
188
  "node": ">=16",
180
189
  "npm": ">=7"
181
190
  },
182
- "typesVersions": {
183
- "*": {
184
- "*": [
185
- "dist/types/*"
186
- ]
187
- }
188
- },
189
191
  "author": "Alex Smith",
190
192
  "license": "MIT",
191
193
  "repository": {