@allxsmith/bestax-bulma 5.6.2 → 5.8.0

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

@@ -1,9 +1,27 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Props for the Span 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 span.
+ */
 export interface SpanProps extends React.HTMLAttributes<HTMLSpanElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
     className?: string;
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
     children?: React.ReactNode;
 }
+/**
+ * Span component for rendering a styled inline element.
+ *
+ * A Span wraps the HTML `<span>` element with Bulma helper class integration.
+ * Useful for styling inline text with Bulma's color, typography, and spacing utilities.
+ *
+ * @function
+ * @param {SpanProps} props - Props for the Span component.
+ * @returns {JSX.Element} The rendered span element.
+ */
 export declare const Span: React.FC<SpanProps>;

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

@@ -1,9 +1,28 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Props for the Strong 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 strong element.
+ */
 export interface StrongProps 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;
 }
+/**
+ * Strong component for rendering semantically important bold text.
+ *
+ * A Strong wraps the HTML `<strong>` element with Bulma helper class integration.
+ * Use it for text that has strong importance, seriousness, or urgency.
+ * For visual-only bold styling without semantic meaning, use Span with textWeight="bold".
+ *
+ * @function
+ * @param {StrongProps} props - Props for the Strong component.
+ * @returns {JSX.Element} The rendered strong element.
+ */
 export declare const Strong: React.FC<StrongProps>;

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

@@ -1,9 +1,26 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
 declare const validSubTitleSizes: readonly ["1", "2", "3", "4", "5", "6"];
+/**
+ * Valid size values for the SubTitle component (Bulma subtitle sizes).
+ */
 export type SubTitleSize = (typeof validSubTitleSizes)[number];
 declare const validSubTitleElements: readonly ["h1", "h2", "h3", "h4", "h5", "h6", "p"];
+/**
+ * Valid HTML elements for the SubTitle component.
+ */
 export type SubTitleElement = (typeof validSubTitleElements)[number];
+/**
+ * Props for the SubTitle component.
+ *
+ * @property {string} [className] - Additional CSS classes to apply.
+ * @property {SubTitleSize} [size] - Size of the subtitle (1-6).
+ * @property {SubTitleElement} [as='h1'] - HTML element to render as (h1-h6 or p).
+ * @property {boolean} [hasSkeleton] - Adds the has-skeleton CSS class.
+ * @property {React.ReactNode} [children] - Subtitle content.
+ * @property {string} [textColor] - Text color class (maps to Bulma's color helper).
+ * @property {string} [bgColor] - Background color class (maps to Bulma's backgroundColor helper).
+ */
 export interface SubTitleProps extends Omit<React.HTMLAttributes<HTMLHeadingElement | HTMLParagraphElement>, 'color'>, Omit<BulmaClassesProps, 'backgroundColor' | 'color'> {
     className?: string;
     size?: SubTitleSize;
@@ -13,5 +30,15 @@ export interface SubTitleProps extends Omit<React.HTMLAttributes<HTMLHeadingElem
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
 }
+/**
+ * SubTitle component for rendering a styled Bulma subtitle.
+ *
+ * Supports Bulma subtitle sizes and rendering as different HTML elements (h1-h6, p).
+ *
+ * @function
+ * @param {SubTitleProps} props - Props for the SubTitle component.
+ * @returns {JSX.Element} The rendered subtitle element.
+ * @see {@link https://bulma.io/documentation/elements/title/#subtitle | Bulma Subtitle documentation}
+ */
 export declare const SubTitle: React.FC<SubTitleProps>;
 export default SubTitle;

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

@@ -1,5 +1,20 @@
+/**
+ * @group Table
+ */
 import React from 'react';
 import { BulmaClassesProps } from '../helpers/useBulmaClasses';
+/**
+ * Props for the Table component.
+ *
+ * @property {string} [className] - Additional CSS classes to apply.
+ * @property {boolean} [isBordered] - Adds borders to all the cells.
+ * @property {boolean} [isStriped] - Adds zebra-striping to rows.
+ * @property {boolean} [isNarrow] - Makes the table more compact by cutting cell padding in half.
+ * @property {boolean} [isHoverable] - Adds a hover effect on rows.
+ * @property {boolean} [isFullwidth] - Makes the table span the full width of its parent.
+ * @property {boolean} [isResponsive] - Makes the table horizontally scrollable on small screens.
+ * @property {React.ReactNode} [children] - Table content.
+ */
 export interface TableProps extends Omit<React.TableHTMLAttributes<HTMLTableElement>, 'color'>, Omit<BulmaClassesProps, 'backgroundColor'> {
     className?: string;
     isBordered?: boolean;
@@ -10,4 +25,11 @@ export interface TableProps extends Omit<React.TableHTMLAttributes<HTMLTableElem
     isResponsive?: boolean;
     children?: React.ReactNode;
 }
-export declare const Table: React.FC<TableProps>;
+export declare const Table: React.FC<TableProps> & {
+    Thead: React.FC<import("./Thead").TheadProps>;
+    Tbody: React.FC<import("./Tbody").TbodyProps>;
+    Tfoot: React.FC<import("./Tfoot").TfootProps>;
+    Tr: React.FC<import("./Tr").TrProps>;
+    Th: React.FC<import("./Th").ThProps>;
+    Td: React.FC<import("./Td").TdProps>;
+};

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

@@ -1,9 +1,27 @@
 import React from 'react';
 import { BulmaClassesProps } from '../helpers/useBulmaClasses';
 declare const validTagColors: readonly ["primary", "link", "info", "success", "warning", "danger", "black", "dark", "light", "white"];
+/**
+ * Valid color values for the Tag component (Bulma tag colors).
+ */
 export type TagColor = (typeof validTagColors)[number];
 declare const validTagSizes: readonly ["normal", "medium", "large"];
+/**
+ * Valid size values for the Tag component (Bulma tag sizes).
+ */
 export type TagSize = (typeof validTagSizes)[number];
+/**
+ * Props for the Tag component.
+ *
+ * @property {string} [className] - Additional CSS classes to apply.
+ * @property {TagColor} [color] - Bulma color modifier for the tag.
+ * @property {TagSize} [size] - Size modifier for the tag.
+ * @property {boolean} [isRounded] - Whether the tag should have rounded corners.
+ * @property {boolean} [isDelete] - Whether the tag is a delete button.
+ * @property {boolean} [isHoverable] - Whether the tag is hoverable.
+ * @property {() => void} [onDelete] - Callback fired when the delete button is clicked.
+ * @property {React.ReactNode} [children] - Tag content.
+ */
 export interface TagProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'color'>, Omit<BulmaClassesProps, 'color'> {
     className?: string;
     color?: TagColor;
@@ -14,5 +32,15 @@ export interface TagProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'c
     onDelete?: () => void;
     children?: React.ReactNode;
 }
+/**
+ * Tag component for rendering a styled Bulma tag.
+ *
+ * Supports colors, sizes, rounded, delete, and hoverable variants.
+ *
+ * @function
+ * @param {TagProps} props - Props for the Tag component.
+ * @returns {JSX.Element} The rendered tag element.
+ * @see {@link https://bulma.io/documentation/elements/tag/ | Bulma Tag documentation}
+ */
 export declare const Tag: React.FC<TagProps>;
 export {};

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

@@ -1,9 +1,19 @@
 import React from 'react';
 import { BulmaClassesProps } from '../helpers/useBulmaClasses';
+/**
+ * Props for the Tags component.
+ *
+ * @property {string} [className] - Additional CSS classes to apply.
+ * @property {boolean} [hasAddons] - Group tags together as addons.
+ * @property {boolean} [isMultiline] - Allow tags to wrap onto multiple lines.
+ * @property {React.ReactNode} [children] - Tag elements to render inside the container.
+ */
 export interface TagsProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'color'>, Omit<BulmaClassesProps, 'backgroundColor' | 'color'> {
     className?: string;
     hasAddons?: boolean;
     isMultiline?: boolean;
     children?: React.ReactNode;
 }
-export declare const Tags: React.FC<TagsProps>;
+export declare const Tags: React.FC<TagsProps> & {
+    Tag: React.FC<import("./Tag").TagProps>;
+};

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

@@ -1,7 +1,26 @@
+/**
+ * @group Table
+ */
 import React from 'react';
 import { BulmaClassesProps } from '../helpers/useBulmaClasses';
+/**
+ * Props for the Tbody component.
+ *
+ * @property {string} [className] - Additional CSS classes to apply.
+ * @property {React.ReactNode} [children] - Table body content (rows).
+ */
 export interface TbodyProps extends Omit<React.HTMLAttributes<HTMLTableSectionElement>, 'color'>, Omit<BulmaClassesProps, 'backgroundColor'> {
     className?: string;
     children?: React.ReactNode;
 }
+/**
+ * Tbody component for rendering a styled Bulma table body.
+ *
+ * Supports Bulma helper classes for additional styling.
+ *
+ * @function
+ * @param {TbodyProps} props - Props for the Tbody component.
+ * @returns {JSX.Element} The rendered table body element.
+ * @see {@link https://bulma.io/documentation/elements/table/#table-body | Bulma Table documentation}
+ */
 export declare const Tbody: React.FC<TbodyProps>;

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

@@ -1,10 +1,34 @@
+/**
+ * @group Table
+ */
 import React from 'react';
 import { BulmaClassesProps } from '../helpers/useBulmaClasses';
+/** Valid Bulma color values for table cells. */
 export declare const validTableColors: readonly ["primary", "link", "info", "success", "warning", "danger", "black", "dark", "light", "white"];
+/**
+ * Valid color values for the Td component (Bulma table cell colors).
+ */
 export type TableColor = (typeof validTableColors)[number];
+/**
+ * Props for the Td component.
+ *
+ * @property {string} [className] - Additional CSS classes to apply.
+ * @property {TableColor} [color] - Bulma color modifier for the table cell.
+ * @property {React.ReactNode} [children] - Table cell content.
+ */
 export interface TdProps extends Omit<React.TdHTMLAttributes<HTMLTableCellElement>, 'color'>, Omit<BulmaClassesProps, 'backgroundColor' | 'color'> {
     className?: string;
     color?: TableColor;
     children?: React.ReactNode;
 }
+/**
+ * Td component for rendering a styled Bulma table cell.
+ *
+ * Supports Bulma color modifiers and helper classes for additional styling.
+ *
+ * @function
+ * @param {TdProps} props - Props for the Td component.
+ * @returns {JSX.Element} The rendered table cell element.
+ * @see {@link https://bulma.io/documentation/elements/table/#table-body | Bulma Table documentation}
+ */
 export declare const Td: React.FC<TdProps>;

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

@@ -1,7 +1,26 @@
+/**
+ * @group Table
+ */
 import React from 'react';
 import { BulmaClassesProps } from '../helpers/useBulmaClasses';
+/**
+ * Props for the Tfoot component.
+ *
+ * @property {string} [className] - Additional CSS classes to apply.
+ * @property {React.ReactNode} [children] - Table footer content (rows).
+ */
 export interface TfootProps extends Omit<React.HTMLAttributes<HTMLTableSectionElement>, 'color'>, Omit<BulmaClassesProps, 'backgroundColor'> {
     className?: string;
     children?: React.ReactNode;
 }
+/**
+ * Tfoot component for rendering a styled Bulma table footer.
+ *
+ * Supports Bulma helper classes for additional styling.
+ *
+ * @function
+ * @param {TfootProps} props - Props for the Tfoot component.
+ * @returns {JSX.Element} The rendered table footer element.
+ * @see {@link https://bulma.io/documentation/elements/table/#table-footer | Bulma Table documentation}
+ */
 export declare const Tfoot: React.FC<TfootProps>;

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

@@ -1,8 +1,23 @@
+/**
+ * @group Table
+ */
 import React from 'react';
 import { BulmaClassesProps } from '../helpers/useBulmaClasses';
 import { TableColor } from './Td';
 declare const validAlignments: readonly ["left", "right", "centered"];
+/**
+ * Valid alignment values for the Th component.
+ */
 type TableAlignment = (typeof validAlignments)[number];
+/**
+ * Props for the Th component.
+ *
+ * @property {string} [className] - Additional CSS classes to apply.
+ * @property {TableAlignment} [isAligned] - Text alignment for the header cell ('left', 'right', 'centered').
+ * @property {string|number} [width] - Width of the header cell (e.g., '100px' or 100).
+ * @property {TableColor} [color] - Bulma color modifier for the header cell.
+ * @property {React.ReactNode} [children] - Table header cell content.
+ */
 export interface ThProps extends Omit<React.ThHTMLAttributes<HTMLTableCellElement>, 'color'>, Omit<BulmaClassesProps, 'backgroundColor' | 'color'> {
     className?: string;
     isAligned?: TableAlignment;
@@ -10,5 +25,15 @@ export interface ThProps extends Omit<React.ThHTMLAttributes<HTMLTableCellElemen
     color?: TableColor;
     children?: React.ReactNode;
 }
+/**
+ * Th component for rendering a styled Bulma table header cell.
+ *
+ * Supports alignment, width, and color modifiers.
+ *
+ * @function
+ * @param {ThProps} props - Props for the Th component.
+ * @returns {JSX.Element} The rendered table header cell element.
+ * @see {@link https://bulma.io/documentation/elements/table/#table-head | Bulma Table documentation}
+ */
 export declare const Th: React.FC<ThProps>;
 export {};

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

@@ -1,7 +1,26 @@
+/**
+ * @group Table
+ */
 import React from 'react';
 import { BulmaClassesProps } from '../helpers/useBulmaClasses';
+/**
+ * Props for the Thead component.
+ *
+ * @property {string} [className] - Additional CSS classes to apply.
+ * @property {React.ReactNode} [children] - Table header content (rows).
+ */
 export interface TheadProps extends Omit<React.HTMLAttributes<HTMLTableSectionElement>, 'color'>, Omit<BulmaClassesProps, 'backgroundColor'> {
     className?: string;
     children?: React.ReactNode;
 }
+/**
+ * Thead component for rendering a styled Bulma table header.
+ *
+ * Supports Bulma helper classes for additional styling.
+ *
+ * @function
+ * @param {TheadProps} props - Props for the Thead component.
+ * @returns {JSX.Element} The rendered table header element.
+ * @see {@link https://bulma.io/documentation/elements/table/#table-head | Bulma Table documentation}
+ */
 export declare const Thead: React.FC<TheadProps>;

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

@@ -1,9 +1,27 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
 declare const validTitleSizes: readonly ["1", "2", "3", "4", "5", "6"];
+/**
+ * Valid size values for the Title component (Bulma title sizes).
+ */
 export type TitleSize = (typeof validTitleSizes)[number];
 declare const validTitleElements: readonly ["h1", "h2", "h3", "h4", "h5", "h6", "p"];
+/**
+ * Valid HTML elements for the Title component.
+ */
 export type TitleElement = (typeof validTitleElements)[number];
+/**
+ * Props for the Title component.
+ *
+ * @property {string} [className] - Additional CSS classes to apply.
+ * @property {TitleSize} [size] - Size of the title (1-6).
+ * @property {boolean} [isSpaced] - Adds margin below the title.
+ * @property {TitleElement} [as='h1'] - HTML element to render as (h1-h6 or p).
+ * @property {boolean} [hasSkeleton] - Adds the has-skeleton CSS class.
+ * @property {React.ReactNode} [children] - Title content.
+ * @property {string} [textColor] - Text color class (maps to Bulma's color helper).
+ * @property {string} [bgColor] - Background color class (maps to Bulma's backgroundColor helper).
+ */
 export interface TitleProps extends Omit<React.HTMLAttributes<HTMLHeadingElement | HTMLParagraphElement>, 'color'>, Omit<BulmaClassesProps, 'backgroundColor' | 'color'> {
     className?: string;
     size?: TitleSize;
@@ -14,5 +32,15 @@ export interface TitleProps extends Omit<React.HTMLAttributes<HTMLHeadingElement
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
 }
+/**
+ * Title component for rendering a styled Bulma title.
+ *
+ * Supports sizes, spacing, and rendering as different HTML elements.
+ *
+ * @function
+ * @param {TitleProps} props - Props for the Title component.
+ * @returns {JSX.Element} The rendered title element.
+ * @see {@link https://bulma.io/documentation/elements/title/ | Bulma Title documentation}
+ */
 export declare const Title: React.FC<TitleProps>;
 export default Title;

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

@@ -1,10 +1,31 @@
+/**
+ * @group Table
+ */
 import React from 'react';
 import { BulmaClassesProps } from '../helpers/useBulmaClasses';
 import { TableColor } from './Td';
+/**
+ * Props for the Tr component.
+ *
+ * @property {string} [className] - Additional CSS classes to apply.
+ * @property {boolean} [isSelected] - Whether the row is selected (adds Bulma's is-selected class).
+ * @property {TableColor} [color] - Bulma color modifier for the table row.
+ * @property {React.ReactNode} [children] - Table row content (cells).
+ */
 export interface TrProps extends Omit<React.HTMLAttributes<HTMLTableRowElement>, 'color'>, Omit<BulmaClassesProps, 'backgroundColor' | 'color'> {
     className?: string;
     isSelected?: boolean;
     color?: TableColor;
     children?: React.ReactNode;
 }
+/**
+ * Tr component for rendering a styled Bulma table row.
+ *
+ * Supports the is-selected modifier and color modifiers.
+ *
+ * @function
+ * @param {TrProps} props - Props for the Tr component.
+ * @returns {JSX.Element} The rendered table row element.
+ * @see {@link https://bulma.io/documentation/elements/table/#table-row | Bulma Table documentation}
+ */
 export declare const Tr: React.FC<TrProps>;

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

@@ -1,9 +1,19 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Props for the UnorderedList 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] - List items to be rendered inside the list.
+ */
 export interface UnorderedListProps extends React.HTMLAttributes<HTMLUListElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
     className?: string;
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
     children?: React.ReactNode;
 }
-export declare const UnorderedList: React.FC<UnorderedListProps>;
+export declare const UnorderedList: React.FC<UnorderedListProps> & {
+    Item: React.FC<import("./ListItem").ListItemProps>;
+};

package/dist/types/form/Autocomplete.d.ts

@@ -1,12 +1,52 @@
 import React from 'react';
 import { BulmaClassesProps } from '../helpers/useBulmaClasses';
 import { FormFieldProps } from './fieldProps';
+/**
+ * An item in the Autocomplete dropdown list.
+ *
+ * @property {string} value - The value used for filtering and selection.
+ * @property {string} [label] - Display label (falls back to value if omitted).
+ * @property {boolean} [disabled] - Whether the item is disabled and unselectable.
+ */
 export interface AutocompleteItem {
     value: string;
     label?: string;
     disabled?: boolean;
     [key: string]: unknown;
 }
+/**
+ * Props for the Autocomplete component.
+ *
+ * @property {AutocompleteItem[] | string[]} data - The options data to display.
+ * @property {string} [value] - The current input value (controlled).
+ * @property {AutocompleteItem | string | null} [selected] - The selected item (controlled).
+ * @property {string} [placeholder] - Placeholder text for the input.
+ * @property {string} [field] - Object property to use as the display field.
+ * @property {boolean} [clearable] - Whether to show a clear button.
+ * @property {boolean} [openOnFocus] - Open dropdown when input is focused.
+ * @property {boolean} [keepFirst] - Keep first option highlighted.
+ * @property {boolean} [keepOpen] - Keep dropdown open after selection.
+ * @property {boolean} [selectOnClickOutside] - Select highlighted item on click outside.
+ * @property {number} [maxHeight] - Maximum dropdown height in pixels.
+ * @property {boolean} [dropdown] - Render as dropdown style.
+ * @property {boolean} [loading] - Show loading state.
+ * @property {boolean} [disabled] - Whether the input is disabled.
+ * @property {boolean} [checkInfiniteScroll] - Enable infinite scroll detection.
+ * @property {number} [infiniteScrollDistance] - Distance threshold for infinite scroll.
+ * @property {(value: string) => void} [onInput] - Callback when input value changes.
+ * @property {(item: AutocompleteItem | string | null) => void} [onSelect] - Callback when item is selected.
+ * @property {(active: boolean) => void} [onActiveChange] - Callback when dropdown active state changes.
+ * @property {() => void} [onInfiniteScroll] - Callback when scrolled to bottom (infinite scroll).
+ * @property {(item: AutocompleteItem | string) => React.ReactNode} [itemTemplate] - Custom render for items.
+ * @property {React.ReactNode} [header] - Custom header in dropdown.
+ * @property {React.ReactNode} [footer] - Custom footer in dropdown.
+ * @property {React.ReactNode} [empty] - Content to show when no results.
+ * @property {'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger'} [color] - Bulma color modifier for the input.
+ * @property {'small' | 'medium' | 'large'} [size] - Size modifier for the input.
+ * @property {string} [name] - Form field name; forwarded to the inner input so the typed/selected value submits with the surrounding form.
+ * @property {string} [form] - The id of the form the input belongs to.
+ * @property {boolean} [required] - Whether the input is required.
+ */
 export interface AutocompleteProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onSelect' | 'onInput'>, Omit<BulmaClassesProps, 'color'>, FormFieldProps {
     data: AutocompleteItem[] | string[];
     value?: string;
@@ -38,5 +78,32 @@ export interface AutocompleteProps extends Omit<React.HTMLAttributes<HTMLDivElem
     footer?: React.ReactNode;
     empty?: React.ReactNode;
 }
+/**
+ * Autocomplete component with dropdown suggestions.
+ *
+ * Provides an input field with a dropdown of suggestions that filter
+ * based on user input.
+ *
+ * @function
+ * @param {AutocompleteProps} props - Props for the Autocomplete component.
+ * @param {React.Ref<HTMLInputElement>} ref - Forwarded ref to the input element.
+ * @returns {JSX.Element} The rendered autocomplete component.
+ *
+ * @example
+ * // Basic usage with string array
+ * <Autocomplete
+ *   data={['Apple', 'Banana', 'Cherry']}
+ *   placeholder="Search fruit..."
+ *   onSelect={(item) => console.log(item)}
+ * />
+ *
+ * @example
+ * // With object data
+ * <Autocomplete
+ *   data={[{ value: '1', label: 'Option 1' }, { value: '2', label: 'Option 2' }]}
+ *   field="label"
+ *   onSelect={(item) => console.log(item)}
+ * />
+ */
 export declare const Autocomplete: React.ForwardRefExoticComponent<AutocompleteProps & React.RefAttributes<HTMLInputElement>>;
 export default Autocomplete;

package/dist/types/form/Checkbox.d.ts

@@ -1,7 +1,24 @@
 import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
+/**
+ * Valid colors for the Checkbox component.
+ */
 export declare const checkboxColors: readonly ["primary", "link", "info", "success", "warning", "danger"];
+/**
+ * Valid sizes for the Checkbox component.
+ */
 export declare const checkboxSizes: readonly ["small", "normal", "medium", "large"];
+/**
+ * Props for the Checkbox component.
+ *
+ * @property {(typeof checkboxColors)[number]} [color] - Color variant for the checkbox.
+ * @property {(typeof checkboxSizes)[number]} [size] - Size of the checkbox.
+ * @property {boolean} [disabled] - Whether the checkbox is disabled.
+ * @property {string} [className] - Additional CSS classes to apply.
+ * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color.
+ * @property {React.ReactNode} [children] - The label/content for the checkbox.
+ * @see Bulma Checkbox documentation: https://bulma.io/documentation/form/checkbox/
+ */
 export interface CheckboxProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size' | 'type' | 'color'>, Omit<BulmaClassesProps, 'color' | 'backgroundColor' | 'size'> {
     color?: (typeof checkboxColors)[number];
     size?: (typeof checkboxSizes)[number];
@@ -10,5 +27,32 @@ export interface CheckboxProps extends Omit<React.InputHTMLAttributes<HTMLInputE
     className?: string;
     children?: React.ReactNode;
 }
+/**
+ * Bulma Checkbox component with themed styling support.
+ *
+ * Renders a custom-styled checkbox with a visual check indicator,
+ * supporting colors, sizes, and various states. Inside a `<Checkboxes>`
+ * group, Checkbox inherits `name` and (when the group is in controlled or
+ * uncontrolled mode) derives its `checked` state from membership in the
+ * group's `value` array. On click, dispatches the new array via the group's
+ * `onChange`.
+ *
+ * Local props always win over group context.
+ *
+ * @function
+ * @param {CheckboxProps} props - Props for the Checkbox component.
+ * @returns {JSX.Element} The rendered checkbox element.
+ *
+ * @example
+ * // Basic checkbox
+ * <Checkbox>Accept terms</Checkbox>
+ *
+ * @example
+ * // Inside a group
+ * <Checkboxes name="tags" defaultValue={['react']}>
+ *   <Checkbox value="react">React</Checkbox>
+ *   <Checkbox value="vue">Vue</Checkbox>
+ * </Checkboxes>
+ */
 export declare const Checkbox: React.ForwardRefExoticComponent<CheckboxProps & React.RefAttributes<HTMLInputElement>>;
 export default Checkbox;

package/dist/types/form/Checkboxes.d.ts

@@ -1,6 +1,16 @@
 import React from 'react';
 import { BulmaClassesProps } from '../helpers/useBulmaClasses';
 import { FormFieldProps } from './fieldProps';
+/**
+ * Props for the Checkboxes component.
+ *
+ * @property {string} [className] - Additional CSS classes to apply.
+ * @property {string} [name] - Form field name shared by every Checkbox in the group.
+ * @property {string[]} [value] - Currently-selected values (controlled mode).
+ * @property {string[]} [defaultValue] - Initial selected values (uncontrolled mode).
+ * @property {(values: string[]) => void} [onChange] - Fired when the selection changes. Receives the new array of selected values.
+ * @property {React.ReactNode} [children] - Checkbox elements to render in the group.
+ */
 export interface CheckboxesProps extends Omit<BulmaClassesProps, 'color'>, FormFieldProps {
     className?: string;
     name?: string;
@@ -9,5 +19,7 @@ export interface CheckboxesProps extends Omit<BulmaClassesProps, 'color'>, FormF
     onChange?: (values: string[]) => void;
     children?: React.ReactNode;
 }
-export declare const Checkboxes: React.FC<CheckboxesProps>;
+export declare const Checkboxes: React.FC<CheckboxesProps> & {
+    Checkbox: React.ForwardRefExoticComponent<import("./Checkbox").CheckboxProps & React.RefAttributes<HTMLInputElement>>;
+};
 export default Checkboxes;