@allxsmith/bestax-bulma 5.6.2 → 5.8.0

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

@@ -1,5 +1,17 @@
 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 {
     className?: string;
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -10,5 +22,15 @@ interface DeleteProps extends React.HTMLAttributes<HTMLButtonElement>, BulmaClas
     ariaLabel?: string;
     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.
+ *
+ * @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,23 @@
 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'> {
     className?: string;
     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.
+ *
+ * @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,28 @@
 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'> {
     className?: string;
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
     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.
+ *
+ * @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,42 @@
 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'> {
     className?: string;
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
     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'> {
     className?: string;
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
     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,6 +20,24 @@ 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 {
     className?: string;
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -36,5 +54,15 @@ export interface IconProps extends React.HTMLAttributes<HTMLSpanElement>, BulmaC
     style?: React.CSSProperties;
     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.
+ *
+ * @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,10 +1,27 @@
 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.
+ *
+ * @property {IconProps} iconProps - Props for the Icon component.
+ * @property {string} [text] - Optional text to display next to the icon.
+ */
 interface IconTextItem {
     iconProps: IconProps;
     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 {
     className?: string;
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -14,5 +31,7 @@ interface IconTextProps extends React.HTMLAttributes<HTMLSpanElement>, BulmaClas
     children?: React.ReactNode;
     items?: IconTextItem[];
 }
-export declare const IconText: React.FC<IconTextProps>;
+export declare const IconText: React.FC<IconTextProps> & {
+    Icon: React.FC<IconProps>;
+};
 export {};

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

@@ -1,5 +1,20 @@
 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'> {
     className?: string;
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -13,5 +28,17 @@ export interface ImageProps extends React.HTMLAttributes<HTMLElement>, Omit<Bulm
     children?: React.ReactNode;
     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.
+ *
+ * @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,5 +1,18 @@
 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.
+ */
 export interface LinkProps extends React.AnchorHTMLAttributes<HTMLAnchorElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
     className?: string;
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -8,4 +21,15 @@ export interface LinkProps extends React.AnchorHTMLAttributes<HTMLAnchorElement>
     as?: React.ElementType;
     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.
+ *
+ * @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,34 @@
 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'> {
     variant?: 'text' | 'ghost' | 'underline';
     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.
+ *
+ * @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,29 @@
 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.
+ */
 export interface ListItemProps extends React.LiHTMLAttributes<HTMLLIElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
     className?: string;
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
     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.
+ *
+ * @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,5 +1,16 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Props for the Notification component.
+ *
+ * @property {string} [className] - Additional CSS classes to apply.
+ * @property {(typeof validColors)[number]} [color] - Bulma color modifier for the notification.
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color (Bulma color, 'inherit', or 'current').
+ * @property {boolean} [isLight] - Use the light color variant.
+ * @property {boolean} [hasDelete] - Show a delete (close) button.
+ * @property {() => void} [onDelete] - Callback fired when the delete button is clicked.
+ * @property {React.ReactNode} [children] - Content to be rendered inside the notification.
+ */
 export interface NotificationProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
     className?: string;
     color?: (typeof validColors)[number];
@@ -9,33 +20,123 @@ export interface NotificationProps extends React.HTMLAttributes<HTMLDivElement>,
     onDelete?: () => void;
     children?: React.ReactNode;
 }
+/**
+ * Notification component for rendering a styled Bulma notification.
+ *
+ * Supports colors, light variants, a delete button, and arbitrary content.
+ *
+ * @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.
+ *
+ * @property {string|React.ReactNode} message - The message to display.
+ * @property {(typeof validColors)[number]} [color] - Bulma color modifier.
+ * @property {boolean} [isLight] - Use the light color variant.
+ * @property {number} [duration] - Duration in ms before auto-close. Default: 3000.
+ * @property {NotificationPosition} [position] - Position on the screen. Default: 'top-right'.
+ * @property {boolean} [queue] - Display notifications one at a time in FIFO order.
+ * @property {boolean} [hasDelete] - Show a delete (close) button. Default: true.
+ * @property {boolean} [indefinite] - Stay open until dismissed.
+ * @property {boolean} [pauseOnHover] - Pause auto-close timer on hover. Default: true.
+ */
 export interface NotificationOptions {
     message: string | React.ReactNode;
     color?: (typeof validColors)[number];
     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.
+ *
+ * @property {string} id - Unique identifier for this notification.
+ * @property {NotificationOptions} options - Configuration options for the notification.
+ */
 interface NotificationInstance {
     id: string;
     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,22 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Props for the OrderedList 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 {'1' | 'a' | 'A' | 'i' | 'I'} [type] - The numbering type for the list.
+ * @property {number} [start] - The starting number for the list.
+ * @property {boolean} [reversed] - Whether to reverse the list numbering.
+ * @property {React.ReactNode} [children] - List items to be rendered inside the list.
+ */
 export interface OrderedListProps extends React.OlHTMLAttributes<HTMLOListElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
     className?: string;
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
     children?: React.ReactNode;
 }
-export declare const OrderedList: React.FC<OrderedListProps>;
+export declare const OrderedList: React.FC<OrderedListProps> & {
+    Item: React.FC<import("./ListItem").ListItemProps>;
+};

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

@@ -1,9 +1,28 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Props for the Paragraph 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 paragraph.
+ */
 export interface ParagraphProps extends React.HTMLAttributes<HTMLParagraphElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
     className?: string;
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
     children?: React.ReactNode;
 }
+/**
+ * Paragraph component for rendering a styled paragraph element.
+ *
+ * A Paragraph wraps the HTML `<p>` element with Bulma helper class integration.
+ * Supports Bulma helper classes for additional styling like text color, background color,
+ * typography, and spacing utilities.
+ *
+ * @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,28 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Props for the Pre 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] - Preformatted content to be rendered inside the element.
+ */
 export interface PreProps extends React.HTMLAttributes<HTMLPreElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
     className?: string;
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
     children?: React.ReactNode;
 }
+/**
+ * Pre component for rendering preformatted text blocks.
+ *
+ * A Pre wraps the HTML `<pre>` element with Bulma helper class integration.
+ * Use it for multi-line code blocks, ASCII art, or any content where whitespace
+ * formatting must be preserved. Often used together with the Code component.
+ *
+ * @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,5 +1,15 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Props for the Progress component.
+ *
+ * @property {string} [className] - Additional CSS classes to apply.
+ * @property {(typeof validColors)[number]} [color] - Bulma color modifier for the progress bar.
+ * @property {'small' | 'medium' | 'large'} [size] - Size modifier for the progress bar.
+ * @property {number} [value] - Current value of the progress bar.
+ * @property {number} [max] - Maximum value of the progress bar.
+ * @property {React.ReactNode} [children] - Optional custom content inside the progress element.
+ */
 export interface ProgressProps extends React.ProgressHTMLAttributes<HTMLProgressElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
     className?: string;
     color?: (typeof validColors)[number];
@@ -8,4 +18,14 @@ export interface ProgressProps extends React.ProgressHTMLAttributes<HTMLProgress
     max?: number;
     children?: React.ReactNode;
 }
+/**
+ * Progress component for rendering a styled Bulma progress bar.
+ *
+ * Supports Bulma color and size modifiers, value/max attributes, and optional custom content.
+ *
+ * @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>;

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

@@ -1,8 +1,39 @@
 import React from 'react';
+/**
+ * Props for the Skeleton component.
+ *
+ * @property {string} [className] - Additional CSS classes to apply.
+ * @property {'block' | 'lines'} [variant] - Variant of skeleton: 'block' (default) or 'lines'.
+ * @property {number} [lines] - Number of lines (only used if variant="lines").
+ * @property {React.ReactNode} [children] - Render content inside the skeleton (block variant only).
+ * @see {@link https://bulma.io/documentation/features/skeletons/ | Bulma Skeletons documentation}
+ */
 export interface SkeletonProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Additional CSS classes to apply */
     className?: string;
+    /** Variant of skeleton: 'block' (default) or 'lines' */
     variant?: 'block' | 'lines';
+    /** Number of lines (only used if variant="lines") */
     lines?: number;
+    /** Render content inside the skeleton (block variant only) */
     children?: React.ReactNode;
 }
+/**
+ * Skeleton component for rendering a styled Bulma skeleton element.
+ *
+ * Renders an animated placeholder that indicates content is loading.
+ * Supports block and multi-line variants.
+ *
+ * @function
+ * @param {SkeletonProps} props - Props for the Skeleton component.
+ * @returns {JSX.Element} The rendered skeleton element.
+ *
+ * @example
+ * // Block skeleton
+ * <Skeleton />
+ *
+ * @example
+ * // Multi-line skeleton
+ * <Skeleton variant="lines" lines={5} />
+ */
 export declare const Skeleton: React.FC<SkeletonProps>;