@allxsmith/bestax-bulma 5.7.0 → 5.8.1

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

@@ -1,12 +1,34 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Props for the Content component.
+ */
 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;
 }
+/**
+ * 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.
+ * @returns {JSX.Element} The rendered content block.
+ * @see {@link https://bulma.io/documentation/elements/content/ | Bulma Content documentation}
+ */
 export declare const Content: React.FC<ContentProps>;
 export default Content;

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

@@ -1,14 +1,38 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Props for the Delete component.
+ */
 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;
 }
+/**
+ * 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.
+ * @returns {JSX.Element} The rendered delete button.
+ * @see {@link https://bulma.io/documentation/elements/delete/ | Bulma Delete documentation}
+ */
 export declare const Delete: React.FC<DeleteProps>;
 export {};

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

@@ -1,7 +1,19 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Props for the Divider component.
+ */
 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';
 }
+/**
+ * The `Divider` component renders a styled horizontal rule (`<hr>`) element with Bulma helper class integration.
+ *
+ * @function
+ * @param {DividerProps} props - Props for the Divider component.
+ * @returns {JSX.Element} The rendered hr element.
+ */
 export declare const Divider: React.FC<DividerProps>;

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

@@ -1,9 +1,23 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Props for the Emphasis component.
+ */
 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;
 }
+/**
+ * The `Emphasis` component renders a styled `<em>` element with Bulma helper class integration.
+ *
+ * @function
+ * @param {EmphasisProps} props - Props for the Emphasis component.
+ * @returns {JSX.Element} The rendered em element.
+ */
 export declare const Emphasis: React.FC<EmphasisProps>;

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

@@ -1,17 +1,40 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Props for the FigureCaption component.
+ */
 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.
+ */
 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;
 }
+/**
+ * Figure component with Caption subcomponent.
+ *
+ * @example
+ * <Figure>
+ *   <img src="image.jpg" alt="Description" />
+ *   <Figure.Caption>Image caption text</Figure.Caption>
+ * </Figure>
+ */
 export declare const Figure: React.FC<FigureProps> & {
     Caption: React.FC<FigureCaptionProps>;
 };

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

@@ -20,21 +20,49 @@ declare module 'react' {
     }
 }
 type IconLibrary = 'fa' | 'mdi' | 'ion' | 'material-icons' | 'material-symbols';
+/**
+ * Props for the Icon component.
+ */
 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;
 }
+/**
+ * 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.
+ * @returns {JSX.Element} The rendered icon element.
+ * @see {@link https://bulma.io/documentation/elements/icon/ | Bulma Icon documentation}
+ */
 export declare const Icon: React.FC<IconProps>;
 export {};

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

@@ -1,17 +1,37 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
 import { IconProps } from './Icon';
+/**
+ * Represents an item for the IconText component, containing icon props and optional text.
+ */
 interface IconTextItem {
+    /** Props for the Icon component. */
     iconProps: IconProps;
+    /** Optional text to display next to the icon. */
     text?: string;
 }
+/**
+ * Props for the IconText component.
+ */
 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

@@ -1,17 +1,44 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Props for the Image component.
+ */
 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';
 }
+/**
+ * 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.
+ * @returns {JSX.Element} The rendered image element.
+ * @see {@link https://bulma.io/documentation/elements/image/ | Bulma Image documentation}
+ */
 export declare const Image: React.FC<ImageProps>;
 export default Image;

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

@@ -1,11 +1,31 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Props for the Link component.
+ * @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;
 }
+/**
+ * The `Link` component renders a styled anchor (`<a>`) element with Bulma helper class integration.
+ *
+ * @function
+ * @param {LinkProps} props - Props for the Link component.
+ * @returns {JSX.Element} The rendered anchor element.
+ * @see {@link https://bulma.io/documentation/elements/content/ | Bulma Content documentation}
+ */
 export declare const Link: React.FC<LinkProps>;

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

@@ -1,8 +1,28 @@
 import React from 'react';
 import { ButtonProps } from './Button';
+/**
+ * Props for the LinkButton component.
+ */
 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';
 }
+/**
+ * The `LinkButton` component renders a `<button>` that visually looks like text or a link.
+ *
+ * @function
+ * @param {LinkButtonProps} props - Props for the LinkButton component.
+ * @returns {JSX.Element} The rendered link-styled button element.
+ *
+ * @example
+ * // Text variant (default)
+ * <LinkButton onClick={handleClick}>Click me</LinkButton>
+ *
+ * @example
+ * // Underline variant with color
+ * <LinkButton variant="underline" color="primary">Learn more</LinkButton>
+ */
 export declare const LinkButton: React.FC<LinkButtonProps>;
 export default LinkButton;

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

@@ -1,9 +1,24 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Props for the ListItem component.
+ * @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;
 }
+/**
+ * The `ListItem` component renders a styled list item (`<li>`) element with Bulma helper class integration.
+ *
+ * @function
+ * @param {ListItemProps} props - Props for the ListItem component.
+ * @returns {JSX.Element} The rendered li element.
+ */
 export declare const ListItem: React.FC<ListItemProps>;

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

@@ -1,41 +1,151 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Props for the Notification component.
+ */
 export interface NotificationProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes to apply. */
     className?: string;
+    /**
+     * Bulma color modifier for the notification (renders `is-<color>`).
+     *
+     * Only `primary`, `link`, `info`, `success`, `warning`, `danger`, `black`,
+     * `white`, `light`, and `dark` have shipped CSS for `.notification`. The
+     * other accepted values (`black-bis`, `black-ter`, `grey-darker`,
+     * `grey-dark`, `grey`, `grey-light`, `grey-lighter`) emit a class no CSS
+     * rule matches, so the notification renders unstyled; they log a console
+     * warning in development and will be removed from this union in the next
+     * major version.
+     */
     color?: (typeof validColors)[number];
+    /** Text color helper. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Use the light color variant. */
     isLight?: boolean;
+    /** Shows a close (delete) button in the notification. */
     hasDelete?: boolean;
+    /** Callback fired when the delete button is clicked. */
     onDelete?: () => void;
+    /** Content inside the notification. */
     children?: React.ReactNode;
 }
+/**
+ * The `Notification` component is a Bulma-styled alert/message area for providing feedback, warnings, or information to users.
+ *
+ * @function
+ * @param {NotificationProps} props - Props for the Notification component.
+ * @returns {JSX.Element} The rendered notification element.
+ * @see {@link https://bulma.io/documentation/elements/notification/ | Bulma Notification documentation}
+ */
 export declare const Notification: React.FC<NotificationProps>;
+/** Screen positions where programmatic notifications can be displayed. */
 export type NotificationPosition = 'top-left' | 'top' | 'top-right' | 'bottom-left' | 'bottom' | 'bottom-right';
+/**
+ * Options for showing a programmatic notification.
+ */
 export interface NotificationOptions {
+    /** The message to display. */
     message: string | React.ReactNode;
+    /**
+     * Bulma color modifier for the notification (renders `is-<color>`).
+     *
+     * Only `primary`, `link`, `info`, `success`, `warning`, `danger`, `black`,
+     * `white`, `light`, and `dark` have shipped CSS for `.notification`. The
+     * other accepted values (`black-bis`, `black-ter`, `grey-darker`,
+     * `grey-dark`, `grey`, `grey-light`, `grey-lighter`) emit a class no CSS
+     * rule matches, so the notification renders unstyled; they log a console
+     * warning in development and will be removed from this union in the next
+     * major version.
+     */
     color?: (typeof validColors)[number];
+    /** Use the light color variant. */
     isLight?: boolean;
+    /** Duration in ms before auto-close. Default 3000. */
     duration?: number;
+    /** Position on the screen. Default 'top-right'. */
     position?: NotificationPosition;
+    /** When true, notifications enter a FIFO queue and display one at a time. Default false. */
     queue?: boolean;
+    /** Show a delete (close) button. Default true. */
     hasDelete?: boolean;
+    /** Stay open until dismissed. */
     indefinite?: boolean;
+    /** Pause auto-close timer on hover. Default true. */
     pauseOnHover?: boolean;
 }
+/**
+ * Internal representation of a notification instance.
+ */
 interface NotificationInstance {
+    /** Unique identifier for this notification. */
     id: string;
+    /** Configuration options for the notification. */
     options: NotificationOptions;
 }
+/**
+ * Programmatic notification API for showing, closing, and managing notifications.
+ *
+ * @example
+ * notification.success('File saved successfully');
+ * notification.danger('Something went wrong', { duration: 5000 });
+ */
 export declare const notification: {
+    /**
+     * Show a notification with the given options.
+     * @param {NotificationOptions} options - Notification configuration.
+     * @returns {string} The unique ID of the created notification.
+     */
     show: (options: NotificationOptions) => string;
+    /**
+     * Show a success notification.
+     * @param {string|React.ReactNode} message - The message to display.
+     * @param {Partial<NotificationOptions>} [options] - Additional options.
+     * @returns {string} The notification ID.
+     */
     success: (message: string | React.ReactNode, options?: Partial<NotificationOptions>) => string;
+    /**
+     * Show a danger notification.
+     * @param {string|React.ReactNode} message - The message to display.
+     * @param {Partial<NotificationOptions>} [options] - Additional options.
+     * @returns {string} The notification ID.
+     */
     danger: (message: string | React.ReactNode, options?: Partial<NotificationOptions>) => string;
+    /**
+     * Show a warning notification.
+     * @param {string|React.ReactNode} message - The message to display.
+     * @param {Partial<NotificationOptions>} [options] - Additional options.
+     * @returns {string} The notification ID.
+     */
     warning: (message: string | React.ReactNode, options?: Partial<NotificationOptions>) => string;
+    /**
+     * Show an info notification.
+     * @param {string|React.ReactNode} message - The message to display.
+     * @param {Partial<NotificationOptions>} [options] - Additional options.
+     * @returns {string} The notification ID.
+     */
     info: (message: string | React.ReactNode, options?: Partial<NotificationOptions>) => string;
+    /**
+     * Close a specific notification by ID.
+     * @param {string} id - The notification ID to close.
+     */
     close: (id: string) => void;
+    /** Close all notifications and clear the queue. */
     closeAll: () => void;
+    /**
+     * Subscribe to notification state changes.
+     * @param {(items: NotificationInstance[]) => void} listener - Callback invoked on changes.
+     * @returns {() => void} Unsubscribe function.
+     */
     subscribe: (listener: (items: NotificationInstance[]) => void) => (() => void);
 };
+/**
+ * Container component for rendering programmatic notifications.
+ * Place once at your app root to enable the notification API.
+ *
+ * @function
+ * @param {{ position?: NotificationPosition }} props - Container props.
+ * @returns {JSX.Element | null} The rendered notification container, or null if empty.
+ */
 export declare const NotificationContainer: React.FC<{
     position?: NotificationPosition;
 }>;

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

@@ -1,9 +1,19 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Props for the OrderedList component.
+ * @extraProp {'1' | 'a' | 'A' | 'i' | 'I'} [type='1'] - The numbering type for the list.
+ * @extraProp {number} [start] - The starting number for the list.
+ * @extraProp {boolean} [reversed] - Whether to reverse the list numbering.
+ */
 export interface OrderedListProps extends React.OlHTMLAttributes<HTMLOListElement>, 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';
+    /** List items to render inside the list. */
     children?: React.ReactNode;
 }
 export declare const OrderedList: React.FC<OrderedListProps> & {

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

@@ -1,9 +1,23 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Props for the Paragraph component.
+ */
 export interface ParagraphProps extends React.HTMLAttributes<HTMLParagraphElement>, 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 paragraph. */
     children?: React.ReactNode;
 }
+/**
+ * The `Paragraph` component renders a styled `<p>` element with Bulma helper class integration.
+ *
+ * @function
+ * @param {ParagraphProps} props - Props for the Paragraph component.
+ * @returns {JSX.Element} The rendered paragraph element.
+ */
 export declare const Paragraph: React.FC<ParagraphProps>;

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

@@ -1,9 +1,23 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Props for the Pre component.
+ */
 export interface PreProps extends React.HTMLAttributes<HTMLPreElement>, 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';
+    /** Preformatted content to render. */
     children?: React.ReactNode;
 }
+/**
+ * The `Pre` component renders a styled `<pre>` element with Bulma helper class integration.
+ *
+ * @function
+ * @param {PreProps} props - Props for the Pre component.
+ * @returns {JSX.Element} The rendered pre element.
+ */
 export declare const Pre: React.FC<PreProps>;

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

@@ -1,11 +1,37 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Props for the Progress component.
+ */
 export interface ProgressProps extends React.ProgressHTMLAttributes<HTMLProgressElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes to apply. */
     className?: string;
+    /**
+     * Bulma color modifier for the progress bar (renders `is-<color>`).
+     *
+     * Only `primary`, `link`, `info`, `success`, `warning`, `danger`, `black`,
+     * `white`, `light`, and `dark` have shipped CSS for `.progress`. The other
+     * accepted values (`black-bis`, `black-ter`, `grey-darker`, `grey-dark`,
+     * `grey`, `grey-light`, `grey-lighter`) emit a class no CSS rule matches, so
+     * the bar renders unstyled; they log a console warning in development and
+     * will be removed from this union in the next major version.
+     */
     color?: (typeof validColors)[number];
+    /** Size modifier for the progress bar. */
     size?: 'small' | 'medium' | 'large';
+    /** Current value of the progress bar. */
     value?: number;
+    /** Maximum value of the progress bar. */
     max?: number;
+    /** Optional custom content inside the progress bar. */
     children?: React.ReactNode;
 }
+/**
+ * The `Progress` component displays a Bulma-styled progress bar.
+ *
+ * @function
+ * @param {ProgressProps} props - Props for the Progress component.
+ * @returns {JSX.Element} The rendered progress bar element.
+ * @see {@link https://bulma.io/documentation/elements/progress/ | Bulma Progress documentation}
+ */
 export declare const Progress: React.FC<ProgressProps>;