@allxsmith/bestax-bulma 5.8.0 → 5.8.2

package/dist/types/elements/Button.d.ts

@@ -2,53 +2,60 @@ import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
 /**
  * Props for the Button component.
- *
- * @property {'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger' | 'white' | 'light' | 'dark' | 'black' | 'text' | 'ghost'} [color] - Bulma color modifier for the button.
- * @property {'small' | 'normal' | 'medium' | 'large'} [size] - Button size.
- * @property {boolean} [isLight] - Use the light version of the color.
- * @property {boolean} [isRounded] - Button is fully rounded.
- * @property {boolean} [isLoading] - Button shows a loading spinner.
- * @property {boolean} [isStatic] - Button is static and non-interactive.
- * @property {boolean} [isFullWidth] - Button takes the full width of parent.
- * @property {boolean} [isOutlined] - Use outlined button style.
- * @property {boolean} [isInverted] - Use inverted color style.
- * @property {boolean} [isFocused] - Button is styled as focused.
- * @property {boolean} [isActive] - Button is styled as active.
- * @property {boolean} [isHovered] - Button is styled as hovered.
- * @property {boolean} [isDisabled] - Button is disabled.
- * @property {string} [className] - Additional CSS classes to apply.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color (Bulma color, 'inherit', or 'current').
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color (Bulma color, 'inherit', or 'current').
- * @property {React.ElementType} [as] - Render as a `<button>`, `<a>`, or a custom component (e.g. a router `Link`). Defaults to `'button'`; anything else (including `'a'`) uses anchor-style prop handling.
- * @property {string} [href] - Specifies the URL for anchor buttons.
- * @property {React.MouseEventHandler<HTMLButtonElement> | React.MouseEventHandler<HTMLAnchorElement>} [onClick] - Click handler for the button or anchor.
- * @property {string} [target] - Target for anchor element.
- * @property {string} [rel] - Rel attribute for anchor element.
- * @property {React.ReactNode} [children] - Content to be rendered inside the button.
  */
 export interface ButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'color' | 'onClick'>, Omit<BulmaClassesProps, 'color' | 'backgroundColor' | 'size'> {
+    /** Bulma color variant for the button. `ghost` renders a link-like button; `text` renders a minimal text-only button. */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger' | 'white' | 'light' | 'dark' | 'black' | 'text' | 'ghost';
+    /** Size of the button. */
     size?: 'small' | 'normal' | 'medium' | 'large';
+    /** Applies a lighter color variant. */
     isLight?: boolean;
+    /** Makes the button rounded. */
     isRounded?: boolean;
+    /** Displays a loading spinner. */
     isLoading?: boolean;
+    /** Makes the button non-interactive. */
     isStatic?: boolean;
+    /** Makes the button full-width. */
     isFullWidth?: boolean;
+    /** Applies outlined styling (requires color). */
     isOutlined?: boolean;
+    /** Applies inverted styling (requires color). */
     isInverted?: boolean;
+    /** Applies focused styling (visual only). */
     isFocused?: boolean;
+    /** Applies active styling (visual only). */
     isActive?: boolean;
+    /** Applies hovered styling (visual only). */
     isHovered?: boolean;
+    /** Applies disabled styling. */
     isDisabled?: boolean;
+    /** Custom class name. */
     className?: string;
+    /** Text color helper. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Background color helper. */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Render as a `<button>`, `<a>`, or a custom component (e.g. a router `Link`). Defaults to `'button'`; anything else (including `'a'`) uses anchor-style prop handling. */
     as?: React.ElementType;
+    /** Href value (if rendering as `<a>`). */
     href?: string;
+    /** Click event handler. */
     onClick?: React.MouseEventHandler<HTMLButtonElement> | React.MouseEventHandler<HTMLAnchorElement>;
+    /** Anchor tag target. */
     target?: string;
+    /** Anchor tag rel. */
     rel?: string;
+    /** Button content. */
     children?: React.ReactNode;
 }
+/**
+ * The `Button` component provides a flexible and highly customizable button for your Bulma React UI.
+ *
+ * @function
+ * @param {ButtonProps} props - Props for the Button component.
+ * @returns {JSX.Element} The rendered button or anchor element.
+ * @see {@link https://bulma.io/documentation/elements/button/ | Bulma Button documentation}
+ */
 export declare const Button: React.FC<ButtonProps>;
 export default Button;

package/dist/types/elements/Buttons.d.ts

@@ -2,24 +2,28 @@ import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
 /**
  * Props for the Buttons component.
- *
- * @property {string} [className] - Additional CSS classes to apply.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color (Bulma color, 'inherit', or 'current').
- * @property {'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger'} [color] - Bulma color modifier for the buttons group.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color (Bulma color, 'inherit', or 'current').
- * @property {boolean} [isCentered] - Center the group of buttons.
- * @property {boolean} [isRight] - Align the group of buttons to the right.
- * @property {boolean} [hasAddons] - Group buttons together as addons.
- * @property {React.ReactNode} children - The button elements to render inside the group.
  */
 interface ButtonsProps extends React.HTMLAttributes<HTMLDivElement>, BulmaClassesProps {
+    /** Additional CSS classes to apply. */
     className?: string;
+    /** Text color helper for the button group. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /**
+     * Text color alias: renders `has-text-<color>`, exactly like `textColor`.
+     * Not a filled variant (no `.buttons.is-<color>` CSS exists; color the
+     * individual `Button`s instead). Prefer `textColor`, which takes precedence
+     * when both are set; use `bgColor` for a colored surface.
+     */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
+    /** Background color helper for the button group. */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Center the group of buttons. */
     isCentered?: boolean;
+    /** Align the group of buttons to the right. */
     isRight?: boolean;
+    /** Group buttons together as addons (removes spacing between them). */
     hasAddons?: boolean;
+    /** The button elements to render inside the group. */
     children: React.ReactNode;
 }
 export declare const Buttons: React.FC<ButtonsProps> & {

package/dist/types/elements/Code.d.ts

@@ -2,24 +2,19 @@ import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
 /**
  * Props for the Code component.
- *
- * @property {string} [className] - Additional CSS classes to apply.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color (Bulma color, 'inherit', or 'current').
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color (Bulma color, 'inherit', or 'current').
- * @property {React.ReactNode} [children] - Code content to be rendered inside the element.
  */
 export interface CodeProps extends React.HTMLAttributes<HTMLElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes to apply. */
     className?: string;
+    /** Text color helper. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Background color helper. */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Code content to render inside the element. */
     children?: React.ReactNode;
 }
 /**
- * Code component for rendering inline code snippets.
- *
- * A Code wraps the HTML `<code>` element with Bulma helper class integration.
- * Use it for short inline code snippets, variable names, or technical terms.
- * For multi-line code blocks, use the Pre component.
+ * The `Code` component renders a styled `<code>` element with Bulma helper class integration.
  *
  * @function
  * @param {CodeProps} props - Props for the Code component.

package/dist/types/elements/Content.d.ts

@@ -2,27 +2,28 @@ import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
 /**
  * Props for the Content component.
- *
- * @property {string} [className] - Additional CSS classes to apply.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color (Bulma color, 'inherit', or 'current').
- * @property {'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger'} [color] - Bulma color modifier for the content.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color (Bulma color, 'inherit', or 'current').
- * @property {'small' | 'normal' | 'medium' | 'large'} [size] - Size modifier for the content.
- * @property {React.ReactNode} [children] - Content to be rendered inside the block.
  */
 interface ContentProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes to apply. */
     className?: string;
+    /** Text color helper (e.g., `'danger'` for `has-text-danger`). */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /**
+     * Text color alias: renders `has-text-<color>`, exactly like `textColor`.
+     * Not a filled variant (no `.content.is-<color>` CSS exists). Prefer
+     * `textColor`, which takes precedence when both are set; use `bgColor` for
+     * a colored surface.
+     */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
+    /** Background color helper (e.g., `'info'` for `has-background-info`). */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Size modifier for the content. */
     size?: 'small' | 'normal' | 'medium' | 'large';
+    /** Content to be rendered inside the block. */
     children?: React.ReactNode;
 }
 /**
- * Content component for rendering a styled Bulma content block.
- *
- * Applies typographic styles to HTML content (e.g., paragraphs, headings, lists) with Bulma's content class.
- * Supports size modifiers and Bulma helper classes for additional styling.
+ * The `Content` component applies Bulma’s typographic styles to its children, enhancing the appearance of HTML elements like paragraphs, headings, lists, and tables.
  *
  * @function
  * @param {ContentProps} props - Props for the Content component.

package/dist/types/elements/Delete.d.ts

@@ -2,30 +2,32 @@ import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
 /**
  * Props for the Delete component.
- *
- * @property {string} [className] - Additional CSS classes to apply.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color (Bulma color, 'inherit', or 'current').
- * @property {'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger'} [color] - Bulma color modifier for the delete button.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color (Bulma color, 'inherit', or 'current').
- * @property {(event: React.MouseEvent<HTMLButtonElement>) => void} [onClick] - Click handler for the button.
- * @property {'small' | 'medium' | 'large'} [size] - Size modifier for the delete button.
- * @property {string} [ariaLabel='Close'] - ARIA label for accessibility (default: 'Close').
- * @property {boolean} [disabled=false] - Whether the button is disabled (default: false).
  */
 interface DeleteProps extends React.HTMLAttributes<HTMLButtonElement>, BulmaClassesProps {
+    /** Additional CSS classes to apply. */
     className?: string;
+    /** Text color helper. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /**
+     * Text color alias: renders `has-text-<color>`, exactly like `textColor`.
+     * Not a filled variant (no `.delete.is-<color>` CSS exists). Prefer
+     * `textColor`, which takes precedence when both are set; use `bgColor` for
+     * a colored surface.
+     */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
+    /** Background color helper. */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Click handler for the button. */
     onClick?: (event: React.MouseEvent<HTMLButtonElement>) => void;
+    /** Size modifier for the delete button. */
     size?: 'small' | 'medium' | 'large';
+    /** ARIA label for accessibility (default: 'Close'). */
     ariaLabel?: string;
+    /** Whether the button is disabled (default: false). */
     disabled?: boolean;
 }
 /**
- * Delete component for rendering a Bulma-styled delete/close button.
- *
- * Supports Bulma helper classes for styling, color, and size, and includes accessibility and disabled state.
+ * The `Delete` component provides a Bulma-styled close/delete button for dismissing modals, notifications, tags, messages, and more.
  *
  * @function
  * @param {DeleteProps} props - Props for the Delete component.

package/dist/types/elements/Divider.d.ts

@@ -2,19 +2,15 @@ import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
 /**
  * Props for the Divider component.
- *
- * @property {string} [className] - Additional CSS classes to apply.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color (Bulma color, 'inherit', or 'current').
  */
 export interface DividerProps extends React.HTMLAttributes<HTMLHRElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes to apply. */
     className?: string;
+    /** Background color helper. */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
 }
 /**
- * Divider component for rendering a styled horizontal rule element.
- *
- * A Divider wraps the HTML `<hr>` element with Bulma helper class integration.
- * Use it to visually separate content sections with a horizontal line.
+ * The `Divider` component renders a styled horizontal rule (`<hr>`) element with Bulma helper class integration.
  *
  * @function
  * @param {DividerProps} props - Props for the Divider component.

package/dist/types/elements/Emphasis.d.ts

@@ -2,24 +2,19 @@ import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
 /**
  * Props for the Emphasis component.
- *
- * @property {string} [className] - Additional CSS classes to apply.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color (Bulma color, 'inherit', or 'current').
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color (Bulma color, 'inherit', or 'current').
- * @property {React.ReactNode} [children] - Content to be rendered inside the em element.
  */
 export interface EmphasisProps extends React.HTMLAttributes<HTMLElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes to apply. */
     className?: string;
+    /** Text color helper. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Background color helper. */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Content to render inside the em element. */
     children?: React.ReactNode;
 }
 /**
- * Emphasis component for rendering semantically emphasized italic text.
- *
- * An Emphasis wraps the HTML `<em>` element with Bulma helper class integration.
- * Use it for text that has stress emphasis, affecting the meaning of the sentence.
- * For visual-only italic styling without semantic meaning, use CSS font-style: italic.
+ * The `Emphasis` component renders a styled `<em>` element with Bulma helper class integration.
  *
  * @function
  * @param {EmphasisProps} props - Props for the Emphasis component.

package/dist/types/elements/Figure.d.ts

@@ -2,30 +2,28 @@ import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
 /**
  * Props for the FigureCaption component.
- *
- * @property {string} [className] - Additional CSS classes to apply.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color (Bulma color, 'inherit', or 'current').
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color (Bulma color, 'inherit', or 'current').
- * @property {React.ReactNode} [children] - Content to be rendered inside the figcaption.
  */
 export interface FigureCaptionProps extends React.HTMLAttributes<HTMLElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes to apply. */
     className?: string;
+    /** Text color (Bulma color, 'inherit', or 'current'). */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Background color (Bulma color, 'inherit', or 'current'). */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Content to be rendered inside the figcaption. */
     children?: React.ReactNode;
 }
 /**
  * Props for the Figure component.
- *
- * @property {string} [className] - Additional CSS classes to apply.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color (Bulma color, 'inherit', or 'current').
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color (Bulma color, 'inherit', or 'current').
- * @property {React.ReactNode} [children] - Content to be rendered inside the figure.
  */
 export interface FigureProps extends React.HTMLAttributes<HTMLElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes to apply. */
     className?: string;
+    /** Text color helper. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Background color helper. */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Content to render inside the figure. */
     children?: React.ReactNode;
 }
 /**

package/dist/types/elements/Icon.d.ts

@@ -22,42 +22,42 @@ declare module 'react' {
 type IconLibrary = 'fa' | 'mdi' | 'ion' | 'material-icons' | 'material-symbols';
 /**
  * Props for the Icon component.
- *
- * @property {string} [className] - Additional CSS classes to apply.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color (Bulma color, 'inherit', or 'current').
- * @property {'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger'} [color] - Bulma color modifier for the icon.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color (Bulma color, 'inherit', or 'current').
- * @property {string} name - The icon name (without library prefix).
- * @property {IconLibrary} [library] - The icon library to use ('fa' = Font Awesome, 'mdi' = Material Design Icons, 'ion' = Ionicons Web Components, 'material-icons' = Google Material Icons, 'material-symbols' = Google Material Symbols). Defaults to the value set in ConfigProvider or 'fa' if not configured.
- * @property {string} [variant] - Icon style variant. For Font Awesome: 'solid', 'regular', 'brands', etc. For Material Icons: 'filled', 'outlined', 'round', 'sharp'. For Material Symbols: 'outlined', 'rounded', 'sharp'. For Ionicons: 'outline', 'sharp'.
- * @property {string | string[]} [features] - Additional library-specific modifiers. For Font Awesome: 'fa-lg', 'fa-spin', etc. For others: size classes like 'is-size-1', etc.
- * @property {string | string[]} [libraryFeatures] - DEPRECATED: Use 'variant' and 'features' instead. Additional library-specific classes.
- * @property {'small' | 'medium' | 'large'} [size] - Size modifier for the icon.
- * @property {string} [ariaLabel='icon'] - ARIA label for accessibility (default: 'icon').
- * @property {object} [style] - Inline style object.
- * @property {string} [icon] - DEPRECATED: Legacy prop, use `name` instead.
- * @property {string} [containerClassName] - Override the default 'icon' container class (e.g., 'panel-icon').
  */
 export interface IconProps extends React.HTMLAttributes<HTMLSpanElement>, BulmaClassesProps {
+    /** Additional CSS classes to apply. */
     className?: string;
+    /** Text color helper. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Bulma color modifier for the icon. */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
+    /** Background color helper. */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** The icon name, with or without its library prefix (e.g. `'star'` or `'fa-star'`). */
     name: string;
+    /** DEPRECATED: Legacy prop, use `name` instead. */
     icon?: string;
+    /**
+     * The icon library to use ('fa' = Font Awesome, 'mdi' = Material Design Icons, 'ion' = Ionicons Web Components, 'material-icons' = Google Material Icons, 'material-symbols' = Google Material Symbols). Defaults to the value set in ConfigProvider or 'fa' if not configured.
+     * @defaultValue 'fa'
+     */
     library?: IconLibrary;
+    /** Icon style variant (e.g. `'solid'`, `'outlined'`, `'rounded'`). */
     variant?: string;
+    /** Additional modifiers (e.g. `'fa-lg'`, `'fa-spin'`, `'is-size-1'`). */
     features?: string | string[];
+    /** **DEPRECATED:** Use `variant` and `features` instead. */
     libraryFeatures?: string | string[];
+    /** Size modifier for the icon container. */
     size?: 'small' | 'medium' | 'large';
+    /** ARIA label for accessibility (default: 'icon'). */
     ariaLabel?: string;
+    /** Inline style object. */
     style?: React.CSSProperties;
+    /** Override the default `'icon'` container class (e.g., `'panel-icon'`). */
     containerClassName?: string;
 }
 /**
- * Icon component for rendering a Bulma-styled icon container.
- *
- * Supports Bulma helper classes for styling, color, and size, and renders an <i></i> element for the icon itself.
+ * The `Icon` component is a Bulma-styled wrapper for displaying icons from various libraries (Font Awesome, Material Design Icons, Ionicons, Google Material Icons, Material Symbols, etc.).
  *
  * @function
  * @param {IconProps} props - Props for the Icon component.

package/dist/types/elements/IconText.d.ts

@@ -3,32 +3,35 @@ import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
 import { IconProps } from './Icon';
 /**
  * Represents an item for the IconText component, containing icon props and optional text.
- *
- * @property {IconProps} iconProps - Props for the Icon component.
- * @property {string} [text] - Optional text to display next to the icon.
  */
 interface IconTextItem {
+    /** Props for the Icon component. */
     iconProps: IconProps;
+    /** Optional text to display next to the icon. */
     text?: string;
 }
 /**
  * Props for the IconText component.
- *
- * @property {string} [className] - Additional CSS classes to apply.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color (Bulma color, 'inherit', or 'current').
- * @property {'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger'} [color] - Bulma color modifier for the icon text.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color (Bulma color, 'inherit', or 'current').
- * @property {IconProps} [iconProps] - Props for a single Icon component.
- * @property {React.ReactNode} [children] - Text for a single icon.
- * @property {IconTextItem[]} [items] - Array of icon/text pairs for multiple icons.
  */
 interface IconTextProps extends React.HTMLAttributes<HTMLSpanElement>, BulmaClassesProps {
+    /** Additional CSS classes to apply. */
     className?: string;
+    /** Text color helper. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /**
+     * Text color alias: renders `has-text-<color>`, exactly like `textColor`.
+     * Not a filled variant (no `.icon-text.is-<color>` CSS exists). Prefer
+     * `textColor`, which takes precedence when both are set; use `bgColor` for
+     * a colored surface.
+     */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
+    /** Background color helper. */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Props for a single Icon component (for single icon mode). */
     iconProps?: IconProps;
+    /** Text for a single icon (for single icon mode). */
     children?: React.ReactNode;
+    /** Array of icon/text pairs (for multiple icons mode). */
     items?: IconTextItem[];
 }
 export declare const IconText: React.FC<IconTextProps> & {

package/dist/types/elements/Image.d.ts

@@ -2,38 +2,38 @@ import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
 /**
  * Props for the Image component.
- *
- * @property {string} [className] - Additional CSS classes to apply.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color (Bulma color, 'inherit', or 'current').
- * @property {'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger'} [color] - Bulma color modifier for the image container.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color (Bulma color, 'inherit', or 'current').
- * @property {string} [size] - Size or aspect ratio modifier (e.g., '128x128', '16by9', etc.).
- * @property {boolean} [isRounded] - Whether the image should have rounded corners.
- * @property {boolean} [isRetina] - Whether to use retina (2x) image source.
- * @property {string} [src] - Image source URL.
- * @property {string} [alt] - Alternate text for the image.
- * @property {React.ReactNode} [children] - Arbitrary children (e.g., iframe or custom content).
- * @property {'figure' | 'div' | 'p'} [as] - The tag to render. Defaults to 'figure', but can be 'p', 'div', etc.
  */
 export interface ImageProps extends React.HTMLAttributes<HTMLElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes to apply. */
     className?: string;
+    /** Text color helper for the container. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /**
+     * Text color alias: renders `has-text-<color>`, exactly like `textColor`.
+     * Not a filled variant (no `.image.is-<color>` CSS exists). Prefer
+     * `textColor`, which takes precedence when both are set; use `bgColor` for
+     * a colored surface.
+     */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
+    /** Background color helper for the container. */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Fixed size or aspect ratio modifier for the image container. */
     size?: '16x16' | '24x24' | '32x32' | '48x48' | '64x64' | '96x96' | '128x128' | 'square' | '1by1' | '5by4' | '4by3' | '3by2' | '5by3' | '16by9' | '2by1' | '3by1' | '4by5' | '3by4' | '2by3' | '3by5' | '9by16' | '1by2' | '1by3';
+    /** Renders the image with rounded corners. */
     isRounded?: boolean;
+    /** Uses retina (2x) image source. */
     isRetina?: boolean;
+    /** Image source URL. */
     src?: string;
+    /** Alternate text for the image. */
     alt?: string;
+    /** Arbitrary content (e.g., iframe, custom HTML) inside the image container. */
     children?: React.ReactNode;
+    /** Container element tag. Defaults to `'figure'` when using aspect-ratio sizes, `'div'` otherwise. */
     as?: 'figure' | 'div' | 'p';
 }
 /**
- * Image component for rendering a styled Bulma image element.
- *
- * Supports fixed-size containers, aspect ratios, rounded images, retina images, and arbitrary children (e.g., iframe).
- *
- * The "as" prop allows rendering as "figure", "p", or "div" tags etc.
+ * The `Image` component wraps images, iframes, or custom content in a Bulma-styled container, supporting fixed sizes, aspect ratios, rounded corners, retina images, and all Bulma helper props for color and spacing.
  *
  * @function
  * @param {ImageProps} props - Props for the Image component.

package/dist/types/elements/Link.d.ts

@@ -2,30 +2,26 @@ import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
 /**
  * Props for the Link component.
- *
- * @property {string} [className] - Additional CSS classes to apply.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color (Bulma color, 'inherit', or 'current').
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color (Bulma color, 'inherit', or 'current').
- * @property {string} [href] - The URL the link points to.
- * @property {string} [target] - Where to open the linked document.
- * @property {string} [rel] - Relationship between the current and linked document.
- * @property {boolean} [isActive] - Whether the link appears active.
- * @property {React.ElementType} [as] - Render as a custom component (e.g. a router `Link`) instead of `<a>`. Defaults to `'a'`.
- * @property {React.ReactNode} [children] - Content to be rendered inside the link.
+ * @extraProp {string} [href] - The URL the link points to.
+ * @extraProp {'_self' | '_blank' | '_parent' | '_top'} [target] - Where to open the linked document.
+ * @extraProp {string} [rel] - Relationship between current and linked document.
  */
 export interface LinkProps extends React.AnchorHTMLAttributes<HTMLAnchorElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes to apply. */
     className?: string;
+    /** Text color helper. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Background color helper. */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Whether the link appears active. */
     isActive?: boolean;
+    /** Render as a custom component (e.g. a router `Link`) instead of `<a>`. Defaults to `'a'`. */
     as?: React.ElementType;
+    /** Content to render inside the link. */
     children?: React.ReactNode;
 }
 /**
- * Link component for rendering a styled Bulma anchor element.
- *
- * A Link wraps the HTML `<a>` element with Bulma styling support and helper class integration.
- * Supports Bulma helper classes for additional styling like text color, background color, and layout.
+ * The `Link` component renders a styled anchor (`<a>`) element with Bulma helper class integration.
  *
  * @function
  * @param {LinkProps} props - Props for the Link component.

package/dist/types/elements/LinkButton.d.ts

@@ -2,21 +2,15 @@ import React from 'react';
 import { ButtonProps } from './Button';
 /**
  * Props for the LinkButton component.
- *
- * @property {'text' | 'ghost' | 'underline'} [variant] - Display mode. 'text' renders a minimal button without underline; 'ghost' renders a link-like button with default text color; 'underline' renders a text button that underlines on hover/focus. Defaults to 'text'.
- * @property {'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger' | 'white' | 'light' | 'dark' | 'black'} [color] - Text color override.
  */
 export interface LinkButtonProps extends Omit<ButtonProps, 'color' | 'isOutlined' | 'isInverted' | 'isLight'> {
+    /** Display mode. `text` has no underline; `ghost` uses default text color. */
     variant?: 'text' | 'ghost' | 'underline';
+    /** Text color override for the button. */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger' | 'white' | 'light' | 'dark' | 'black';
 }
 /**
- * A button that visually looks like text or a link, for a11y-friendly replacements
- * of `<div onClick>` anti-patterns.
- *
- * Wraps the Button component with `is-text` or `is-ghost` styling, plus CSS overrides
- * to remove the underline (text variant) or link color (ghost variant).
- * The 'underline' variant uses `is-text` styling with an underline that appears on hover/focus.
+ * The `LinkButton` component renders a `<button>` that visually looks like text or a link.
  *
  * @function
  * @param {LinkButtonProps} props - Props for the LinkButton component.

package/dist/types/elements/ListItem.d.ts

@@ -2,25 +2,20 @@ import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
 /**
  * Props for the ListItem component.
- *
- * @property {string} [className] - Additional CSS classes to apply.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color (Bulma color, 'inherit', or 'current').
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color (Bulma color, 'inherit', or 'current').
- * @property {React.ReactNode} [children] - Content to be rendered inside the list item.
+ * @extraProp {number} [value] - Custom value for ordered list items.
  */
 export interface ListItemProps extends React.LiHTMLAttributes<HTMLLIElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes to apply. */
     className?: string;
+    /** Text color helper. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Background color helper. */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Content to render inside the list item. */
     children?: React.ReactNode;
 }
 /**
- * ListItem component for rendering a styled list item element.
- *
- * A ListItem wraps the HTML `<li>` element with Bulma helper class integration.
- * Use it inside UnorderedList or OrderedList components.
- * Supports Bulma helper classes for additional styling like text color, background color,
- * and spacing utilities.
+ * The `ListItem` component renders a styled list item (`<li>`) element with Bulma helper class integration.
  *
  * @function
  * @param {ListItemProps} props - Props for the ListItem component.