@allxsmith/bestax-bulma 5.8.0 → 5.8.2

package/dist/types/components/Navbar.d.ts

@@ -2,40 +2,38 @@ import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
 /**
  * Props for the Navbar component.
- *
- * @property {string} [className] - Additional CSS classes for the navbar.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Color for text.
- * @property {'primary'|'link'|'info'|'success'|'warning'|'danger'|'black'|'dark'|'light'|'white'} [color] - Bulma color modifier for the navbar.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color for the navbar.
- * @property {boolean} [transparent] - Whether the navbar is transparent.
- * @property {'top'|'bottom'} [fixed] - Whether the navbar is fixed to the top or bottom.
- * @property {React.ReactNode} [children] - Navbar content.
  */
 export interface NavbarProps extends React.HTMLAttributes<HTMLElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes for the navbar. */
     className?: string;
+    /** Text color for the navbar. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Bulma color modifier for the navbar. */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger' | 'black' | 'dark' | 'light' | 'white';
+    /** Background color for the navbar. */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Renders the navbar with a transparent background. */
     transparent?: boolean;
+    /** Fixes the navbar to the top or bottom of the viewport. */
     fixed?: 'top' | 'bottom';
+    /** Navbar content (compose with subcomponents). */
     children?: React.ReactNode;
 }
 /**
  * Props for the NavbarBrand component.
- *
- * @property {string} [className] - Additional CSS classes.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color for the brand.
- * @property {'primary'|'link'|'info'|'success'|'warning'|'danger'} [color] - Bulma color modifier for the brand.
- * @property {React.ReactNode} [children] - Brand content.
  */
 export interface NavbarBrandProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes. */
     className?: string;
+    /** Text color for the brand. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Bulma color modifier for the brand. */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
+    /** Brand content. */
     children?: React.ReactNode;
 }
 /**
- * Bulma Navbar brand area (usually left side).
+ * For logo and branding (left side)
  *
  * @function
  * @param {NavbarBrandProps} props - Props for the NavbarBrand component.
@@ -44,25 +42,24 @@ export interface NavbarBrandProps extends React.HTMLAttributes<HTMLDivElement>,
 export declare const NavbarBrand: React.FC<NavbarBrandProps>;
 /**
  * Props for the NavbarItem component.
- *
- * @property {string} [className] - Additional CSS classes.
- * @property {React.ElementType} [as] - Render as a custom component (e.g., a router link).
- * @property {boolean} [active] - Whether the item is active.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color for the item.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color for the item.
- * @property {React.ReactNode} [children] - Navbar item content.
  */
 export interface NavbarItemProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'color'>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes. */
     className?: string;
+    /** Render as a custom component (e.g., a router link). */
     as?: React.ElementType;
+    /** Whether the item is active. */
     active?: boolean;
+    /** Text color for the item. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Background color for the item. */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Navbar item content. */
     children?: React.ReactNode;
     [key: string]: unknown;
 }
 /**
- * Bulma Navbar item (link, button, etc).
+ * Navigation links, buttons, or custom content
  *
  * @function
  * @param {NavbarItemProps} props - Props for the NavbarItem component.
@@ -71,28 +68,27 @@ export interface NavbarItemProps extends Omit<React.AnchorHTMLAttributes<HTMLAnc
 export declare const NavbarItem: React.FC<NavbarItemProps>;
 /**
  * Props for the NavbarBurger component.
- *
- * @property {string} [className] - Additional CSS classes.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color for the burger.
- * @property {'primary'|'link'|'info'|'success'|'warning'|'danger'} [color] - Bulma color modifier for the burger.
- * @property {boolean} [active] - Whether the burger is active.
- * @property {React.ReactNode} [children] - Custom content inside the burger.
- * @property {string} ['aria-label'] - Aria label for accessibility.
- * @property {boolean} ['aria-expanded'] - Aria expanded state.
- * @property {React.MouseEventHandler<HTMLButtonElement>} [onClick] - Click handler.
  */
 export interface NavbarBurgerProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes. */
     className?: string;
+    /** Text color for the burger. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Bulma color modifier for the burger. */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
+    /** Whether the burger is active. */
     active?: boolean;
+    /** Custom content inside the burger. */
     children?: React.ReactNode;
+    /** Aria label for accessibility. */
     'aria-label'?: string;
+    /** Aria expanded state. */
     'aria-expanded'?: boolean;
+    /** Click handler. */
     onClick?: React.MouseEventHandler<HTMLButtonElement>;
 }
 /**
- * Bulma Navbar burger (responsive menu toggle).
+ * Responsive menu toggle (mobile)
  *
  * @function
  * @param {NavbarBurgerProps} props - Props for the NavbarBurger component.
@@ -101,22 +97,21 @@ export interface NavbarBurgerProps extends React.ButtonHTMLAttributes<HTMLButton
 export declare const NavbarBurger: React.FC<NavbarBurgerProps>;
 /**
  * Props for the NavbarMenu component.
- *
- * @property {string} [className] - Additional CSS classes.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color for the menu.
- * @property {'primary'|'link'|'info'|'success'|'warning'|'danger'} [color] - Bulma color modifier for the menu.
- * @property {boolean} [active] - Whether the menu is active.
- * @property {React.ReactNode} [children] - Menu content.
  */
 export interface NavbarMenuProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes. */
     className?: string;
+    /** Text color for the menu. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Bulma color modifier for the menu. */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
+    /** Whether the menu is active. */
     active?: boolean;
+    /** Menu content. */
     children?: React.ReactNode;
 }
 /**
- * Bulma Navbar menu area (collapsible content).
+ * Collapsible content (contains `Navbar.Start` and `Navbar.End`)
  *
  * @function
  * @param {NavbarMenuProps} props - Props for the NavbarMenu component.
@@ -125,20 +120,19 @@ export interface NavbarMenuProps extends React.HTMLAttributes<HTMLDivElement>, O
 export declare const NavbarMenu: React.FC<NavbarMenuProps>;
 /**
  * Props for the NavbarStartEnd component.
- *
- * @property {string} [className] - Additional CSS classes.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color.
- * @property {'primary'|'link'|'info'|'success'|'warning'|'danger'} [color] - Bulma color modifier.
- * @property {React.ReactNode} [children] - Content.
  */
 export interface NavbarStartEndProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes. */
     className?: string;
+    /** Text color. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Bulma color modifier. */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
+    /** Content. */
     children?: React.ReactNode;
 }
 /**
- * Bulma Navbar start area (left-aligned).
+ * Left-aligned menu area
  *
  * @function
  * @param {NavbarStartEndProps} props - Props for the NavbarStart component.
@@ -146,7 +140,7 @@ export interface NavbarStartEndProps extends React.HTMLAttributes<HTMLDivElement
  */
 export declare const NavbarStart: React.FC<NavbarStartEndProps>;
 /**
- * Bulma Navbar end area (right-aligned).
+ * Right-aligned menu area
  *
  * @function
  * @param {NavbarStartEndProps} props - Props for the NavbarEnd component.
@@ -155,27 +149,23 @@ export declare const NavbarStart: React.FC<NavbarStartEndProps>;
 export declare const NavbarEnd: React.FC<NavbarStartEndProps>;
 /**
  * Props for the NavbarLink component.
- *
- * @property {string} [className] - Additional CSS classes.
- * @property {React.ElementType} [as] - Render as a custom component (default: 'a').
- * @property {boolean} [arrowless] - Remove the dropdown arrow indicator.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color.
- * @property {React.ReactNode} [children] - Link content.
  */
 export interface NavbarLinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'color'>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes. */
     className?: string;
+    /** Render as a custom component (default: 'a'). */
     as?: React.ElementType;
+    /** Remove the dropdown arrow indicator. */
     arrowless?: boolean;
+    /** Text color. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Background color. */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Link content. */
     children?: React.ReactNode;
 }
 /**
- * Bulma Navbar link — the dropdown trigger inside a `Navbar.Dropdown`.
- *
- * Renders with the `navbar-link` class, which adds a dropdown arrow indicator
- * automatically. Use `arrowless` to remove the arrow.
+ * Dropdown trigger with arrow indicator (use as first child of `Navbar.Dropdown`)
  *
  * @function
  * @param {NavbarLinkProps} props - Props for the NavbarLink component.
@@ -184,24 +174,23 @@ export interface NavbarLinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnc
 export declare const NavbarLink: React.FC<NavbarLinkProps>;
 /**
  * Props for the NavbarDropdown component.
- *
- * @property {string} [className] - Additional CSS classes.
- * @property {boolean} [right] - Dropdown aligned right.
- * @property {boolean} [up] - Dropdown opens upwards.
- * @property {boolean} [hoverable] - Dropdown opens on hover.
- * @property {boolean} [active] - Dropdown is open.
- * @property {React.ReactNode} [children] - Dropdown content.
  */
 export interface NavbarDropdownProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Additional CSS classes. */
     className?: string;
+    /** Dropdown aligned right. */
     right?: boolean;
+    /** Dropdown opens upwards. */
     up?: boolean;
+    /** Dropdown opens on hover. */
     hoverable?: boolean;
+    /** Dropdown is open. */
     active?: boolean;
+    /** Dropdown content. */
     children?: React.ReactNode;
 }
 /**
- * Bulma Navbar dropdown (for nested dropdown menus).
+ * Dropdown parent (with options for hover, up, right, active)
  *
  * @function
  * @param {NavbarDropdownProps} props - Props for the NavbarDropdown component.
@@ -210,20 +199,19 @@ export interface NavbarDropdownProps extends React.HTMLAttributes<HTMLDivElement
 export declare const NavbarDropdown: React.FC<NavbarDropdownProps>;
 /**
  * Props for the NavbarDropdownMenu component.
- *
- * @property {string} [className] - Additional CSS classes.
- * @property {boolean} [right] - Dropdown aligned right.
- * @property {boolean} [up] - Dropdown opens upwards.
- * @property {React.ReactNode} [children] - Dropdown menu content.
  */
 export interface NavbarDropdownMenuProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Additional CSS classes. */
     className?: string;
+    /** Dropdown aligned right. */
     right?: boolean;
+    /** Dropdown opens upwards. */
     up?: boolean;
+    /** Dropdown menu content. */
     children?: React.ReactNode;
 }
 /**
- * Bulma Navbar dropdown menu container.
+ * Dropdown menu container
  *
  * @function
  * @param {NavbarDropdownMenuProps} props - Props for the NavbarDropdownMenu component.
@@ -231,7 +219,7 @@ export interface NavbarDropdownMenuProps extends React.HTMLAttributes<HTMLDivEle
  */
 export declare const NavbarDropdownMenu: React.FC<NavbarDropdownMenuProps>;
 /**
- * Bulma Navbar divider.
+ * Divider in dropdown menus.
  *
  * @function
  * @param {React.HTMLAttributes<HTMLHRElement>} props - Standard hr props.

package/dist/types/components/Pagination.d.ts

@@ -2,46 +2,52 @@ import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
 /**
  * Props for the Pagination component.
- *
- * @property {'primary'|'link'|'info'|'success'|'warning'|'danger'|'black'|'dark'|'light'|'white'} [color] - Bulma color for the pagination.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color for the pagination.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color for the pagination.
- * @property {'small'|'medium'|'large'} [size] - Size modifier for the pagination.
- * @property {'centered'|'right'} [align] - Alignment for the pagination.
- * @property {boolean} [rounded] - Renders pagination with rounded corners.
- * @property {number} [total] - Total number of pages.
- * @property {number} [current] - Current page.
- * @property {(page: number) => void} [onPageChange] - Page change callback.
- * @property {string} [className] - Additional CSS classes.
- * @property {React.ReactNode} [children] - Custom pagination content.
  */
 export interface PaginationProps extends React.HTMLAttributes<HTMLElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /**
+     * Color modifier for the pagination (renders `is-<color>`).
+     *
+     * Bulma ships no pagination color CSS, so this prop has never had a visual
+     * effect for any value. Passing it logs a console warning in development.
+     * Use `textColor` / `bgColor` instead.
+     * @deprecated No `.pagination.is-<color>` CSS exists; the prop renders
+     * unstyled and will be removed in the next major version.
+     */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger' | 'black' | 'dark' | 'light' | 'white';
+    /** Text color helper. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Background color helper. */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Size modifier for the pagination. */
     size?: 'small' | 'medium' | 'large';
+    /** Alignment for the pagination. */
     align?: 'centered' | 'right';
+    /** Renders pagination with rounded corners. */
     rounded?: boolean;
+    /** Total number of pages (for custom implementations). */
     total?: number;
+    /** Current page (for controlled implementations). */
     current?: number;
+    /** Callback when a page is selected. */
     onPageChange?: (page: number) => void;
+    /** Additional CSS classes. */
     className?: string;
+    /** Custom pagination content (usually subcomponents). */
     children?: React.ReactNode;
 }
 /**
  * Props for PaginationPrevious and PaginationNext components.
- *
- * @property {string} [className] - Additional CSS classes.
- * @property {boolean} [disabled] - Whether previous/next is disabled.
- * @property {React.ReactNode} [children] - Button content.
  */
 export interface PaginationPreviousNextProps extends React.AnchorHTMLAttributes<HTMLAnchorElement> {
+    /** Additional CSS classes. */
     className?: string;
+    /** Whether previous/next is disabled. */
     disabled?: boolean;
+    /** Button content. */
     children?: React.ReactNode;
 }
 /**
- * Bulma Pagination previous button.
+ * "Previous" navigation button.
  *
  * @function
  * @param {PaginationPreviousNextProps} props - Props for the PaginationPrevious component.
@@ -49,7 +55,7 @@ export interface PaginationPreviousNextProps extends React.AnchorHTMLAttributes<
  */
 export declare const PaginationPrevious: React.FC<PaginationPreviousNextProps>;
 /**
- * Bulma Pagination next button.
+ * "Next" navigation button.
  *
  * @function
  * @param {PaginationPreviousNextProps} props - Props for the PaginationNext component.
@@ -58,22 +64,21 @@ export declare const PaginationPrevious: React.FC<PaginationPreviousNextProps>;
 export declare const PaginationNext: React.FC<PaginationPreviousNextProps>;
 /**
  * Props for the PaginationList component.
- *
- * @property {string} [className] - Additional CSS classes.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color for the list.
- * @property {'primary'|'link'|'info'|'success'|'warning'|'danger'} [color] - Bulma color modifier for the list.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color for the list.
- * @property {React.ReactNode} [children] - List items.
  */
 export interface PaginationListProps extends React.HTMLAttributes<HTMLUListElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes. */
     className?: string;
+    /** Text color for the list. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Bulma color modifier for the list. */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
+    /** Background color for the list. */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** List items. */
     children?: React.ReactNode;
 }
 /**
- * Bulma Pagination list container.
+ * Container for page links and ellipsis.
  *
  * @function
  * @param {PaginationListProps} props - Props for the PaginationList component.
@@ -82,26 +87,25 @@ export interface PaginationListProps extends React.HTMLAttributes<HTMLUListEleme
 export declare const PaginationList: React.FC<PaginationListProps>;
 /**
  * Props for the PaginationLink component.
- *
- * @property {string} [className] - Additional CSS classes.
- * @property {'primary'|'link'|'info'|'success'|'warning'|'danger'} [color] - Bulma color modifier.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color.
- * @property {boolean} [active] - Whether the link is for the current page.
- * @property {boolean} [disabled] - Whether the link is disabled.
- * @property {React.ReactNode} [children] - Link content.
  */
 export interface PaginationLinkProps extends React.AnchorHTMLAttributes<HTMLAnchorElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Additional CSS classes. */
     className?: string;
+    /** Bulma color modifier. */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
+    /** Text color. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Background color. */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Whether the link is for the current page. */
     active?: boolean;
+    /** Whether the link is disabled. */
     disabled?: boolean;
+    /** Link content. */
     children?: React.ReactNode;
 }
 /**
- * Bulma Pagination link (page number).
+ * Page number or navigation link.
  *
  * @function
  * @param {PaginationLinkProps} props - Props for the PaginationLink component.
@@ -109,7 +113,7 @@ export interface PaginationLinkProps extends React.AnchorHTMLAttributes<HTMLAnch
  */
 export declare const PaginationLink: React.FC<PaginationLinkProps>;
 /**
- * Bulma Pagination ellipsis element.
+ * Ellipsis separator.
  *
  * @function
  * @param {React.LiHTMLAttributes<HTMLLIElement>} props - Standard li props.

package/dist/types/components/Panel.d.ts

@@ -3,46 +3,42 @@ import { BulmaClassesProps } from '../helpers/useBulmaClasses';
 import { IconProps } from '../elements/Icon';
 /**
  * Props for the Panel component.
- *
- * @property {'primary'|'link'|'info'|'success'|'warning'|'danger'|'black'|'dark'|'light'|'white'} [color] - Bulma color modifier for the panel.
- * @property {string} [className] - Additional CSS classes.
- * @property {React.ReactNode} [children] - Panel content.
  */
 export interface PanelProps extends React.HTMLAttributes<HTMLElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Bulma color modifier for the panel. */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger' | 'black' | 'dark' | 'light' | 'white';
+    /** Additional CSS classes. */
     className?: string;
+    /** Panel content (usually includes subcomponents). */
     children?: React.ReactNode;
 }
 /**
  * Props for the PanelHeading component.
- *
- * @property {string} [className] - Additional CSS classes.
- * @property {React.ReactNode} [children] - Heading content.
  */
 export interface PanelHeadingProps extends React.HTMLAttributes<HTMLParagraphElement> {
+    /** Additional CSS classes. */
     className?: string;
+    /** Heading content. */
     children?: React.ReactNode;
 }
 /**
  * Props for the PanelTabs component.
- *
- * @property {string} [className] - Additional CSS classes.
- * @property {React.ReactNode} [children] - Tabs content.
  */
 export interface PanelTabsProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Additional CSS classes. */
     className?: string;
+    /** Tabs content. */
     children?: React.ReactNode;
 }
 /**
  * Props for the PanelBlock component.
- *
- * @property {string} [className] - Additional CSS classes.
- * @property {boolean} [active] - Whether the block is active.
- * @property {React.ReactNode} [children] - Block content.
  */
 export interface PanelBlockProps extends React.AnchorHTMLAttributes<HTMLAnchorElement> {
+    /** Additional CSS classes. */
     className?: string;
+    /** Whether the block is active. */
     active?: boolean;
+    /** Block content. */
     children?: React.ReactNode;
 }
 /**
@@ -52,40 +48,37 @@ export interface PanelBlockProps extends React.AnchorHTMLAttributes<HTMLAnchorEl
 export type PanelIconProps = Omit<IconProps, 'containerClassName'>;
 /**
  * Props for the PanelInputBlock component.
- *
- * @property {string} [value] - Input value.
- * @property {(event: React.ChangeEvent<HTMLInputElement>) => void} [onChange] - Input change handler.
- * @property {string} [placeholder] - Input placeholder.
- * @property {string} [iconClassName] - Icon class for left icon (default 'fas fa-search').
  */
 export interface PanelInputBlockProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Input value. */
     value?: string;
+    /** Input change handler. */
     onChange?: React.ChangeEventHandler<HTMLInputElement>;
+    /** Input placeholder. */
     placeholder?: string;
+    /** Icon class for left icon (default 'fas fa-search'). */
     iconClassName?: string;
 }
 /**
  * Props for the PanelCheckboxBlock component.
- *
- * @property {boolean} [checked] - Whether the checkbox is checked.
- * @property {(event: React.ChangeEvent<HTMLInputElement>) => void} [onChange] - Checkbox change handler.
- * @property {React.ReactNode} [children] - Label/content.
  */
 export interface PanelCheckboxBlockProps extends Omit<React.LabelHTMLAttributes<HTMLLabelElement>, 'onChange'> {
+    /** Whether the checkbox is checked. */
     checked?: boolean;
+    /** Checkbox change handler. */
     onChange?: React.ChangeEventHandler<HTMLInputElement>;
+    /** Label/content. */
     children?: React.ReactNode;
 }
 /**
  * Props for the PanelButtonBlock component.
- *
- * @property {React.ReactNode} [children] - Button content.
  */
 export interface PanelButtonBlockProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Button content. */
     children?: React.ReactNode;
 }
 /**
- * Bulma Panel heading.
+ * Main heading (renders as `<p class="panel-heading">`)
  *
  * @function
  * @param {PanelHeadingProps} props - Props for the PanelHeading component.
@@ -93,7 +86,7 @@ export interface PanelButtonBlockProps extends React.ButtonHTMLAttributes<HTMLBu
  */
 export declare const PanelHeading: React.FC<PanelHeadingProps>;
 /**
- * Bulma Panel tabs.
+ * Panel tabs (renders as `<p class="panel-tabs">`)
  *
  * @function
  * @param {PanelTabsProps} props - Props for the PanelTabs component.
@@ -101,7 +94,7 @@ export declare const PanelHeading: React.FC<PanelHeadingProps>;
  */
 export declare const PanelTabs: React.FC<PanelTabsProps>;
 /**
- * Bulma Panel block.
+ * Individual panel block (renders as `<a class="panel-block">`)
  *
  * @function
  * @param {PanelBlockProps} props - Props for the PanelBlock component.
@@ -109,8 +102,8 @@ export declare const PanelTabs: React.FC<PanelTabsProps>;
  */
 export declare const PanelBlock: React.FC<PanelBlockProps>;
 /**
- * Bulma Panel icon.
- * Wraps the Icon component with 'panel-icon' container class.
+ * Icon wrapper with panel styling (renders as `<span class="panel-icon"><i/></span>`).
+ * Accepts all Icon props (`name`, `variant`, `features`, etc.)
  *
  * @function
  * @param {PanelIconProps} props - Props for the PanelIcon component.
@@ -118,7 +111,7 @@ export declare const PanelBlock: React.FC<PanelBlockProps>;
  */
 export declare const PanelIcon: React.FC<PanelIconProps>;
 /**
- * Bulma Panel input block.
+ * Search input with icon (renders as `<div class="panel-block">`)
  *
  * @function
  * @param {PanelInputBlockProps} props - Props for the PanelInputBlock component.
@@ -126,7 +119,7 @@ export declare const PanelIcon: React.FC<PanelIconProps>;
  */
 export declare const PanelInputBlock: React.FC<PanelInputBlockProps>;
 /**
- * Bulma Panel checkbox block.
+ * Checkbox block (renders as `<label class="panel-block">`)
  *
  * @function
  * @param {PanelCheckboxBlockProps} props - Props for the PanelCheckboxBlock component.
@@ -134,7 +127,7 @@ export declare const PanelInputBlock: React.FC<PanelInputBlockProps>;
  */
 export declare const PanelCheckboxBlock: React.FC<PanelCheckboxBlockProps>;
 /**
- * Bulma Panel button block.
+ * Call-to-action button (renders as `<div class="panel-block"><button /></div>`)
  *
  * @function
  * @param {PanelButtonBlockProps} props - Props for the PanelButtonBlock component.

package/dist/types/components/Reveal.d.ts

@@ -6,36 +6,30 @@ import { BulmaClassesProps } from '../helpers/useBulmaClasses';
 export type RevealAnimation = 'fade' | 'fade-up' | 'fade-down' | 'slide-left' | 'slide-right' | 'zoom' | 'flip';
 /**
  * Props for the Reveal component.
- *
- * @property {RevealAnimation} [animation] - Animation style used when the element enters the viewport. Default: 'fade-up'.
- * @property {number} [delay] - Delay in milliseconds before the animation starts. Default: 0.
- * @property {number} [duration] - Animation duration in milliseconds. Default: 600.
- * @property {number} [threshold] - Fraction (0-1) of the element that must be visible to trigger the reveal. Values are clamped to the 0-1 range and fall back to 0.15 when not a finite number. Default: 0.15.
- * @property {boolean} [once] - Animate only the first time the element enters the viewport; if `false`, it re-animates on every entry/exit. Default: true.
- * @property {React.ElementType} [as] - Element or component to render as. Default: 'div'. When `as` is a plain intrinsic tag (e.g. `'section'`), your `className`, `style`, and Bulma helper classes plus everything in `...rest` all land on that single element. When `as` is a component (e.g. `Section`, `Card`), scroll detection needs a real DOM node with a ref, so `Reveal` wraps it in an observed `div`: `className`/`style`/helper classes go on that wrapper `div`, while `...rest` (`id`, `aria-*`, `data-*`, event handlers) is forwarded to the inner component.
- * @property {boolean} [cascade] - Stagger direct children with an incrementing delay instead of animating this element as a single block.
- * @property {number} [cascadeInterval] - Milliseconds added to each successive child's delay when `cascade` is set. Default: 80.
- * @property {React.ReactNode} [children] - Content to reveal.
+ * @extraProp {string} [className] - Additional CSS classes.
  */
 export interface RevealProps extends Omit<React.HTMLAttributes<HTMLElement>, 'color'>, BulmaClassesProps {
+    /** Animation style applied when the element enters the viewport. */
     animation?: RevealAnimation;
+    /** Delay in milliseconds before the animation starts. Default: 0. */
     delay?: number;
+    /** Animation duration in milliseconds. Default: 600. */
     duration?: number;
+    /** Fraction (0-1) of the element that must be visible to trigger the reveal. Clamped to the 0-1 range; non-finite values fall back to `0.15`. */
     threshold?: number;
+    /** Animate only the first time the element enters the viewport. If `false`, it re-animates on every entry/exit. */
     once?: boolean;
+    /** Element or component to render as. Default: 'div'. When `as` is a plain intrinsic tag (e.g. `'section'`), your `className`, `style`, and Bulma helper classes plus everything in `...rest` all land on that single element. When `as` is a component (e.g. `Section`, `Card`), scroll detection needs a real DOM node with a ref, so `Reveal` wraps it in an observed `div`: `className`/`style`/helper classes go on that wrapper `div`, while `...rest` (`id`, `aria-*`, `data-*`, event handlers) is forwarded to the inner component. */
     as?: React.ElementType;
+    /** Stagger direct children with an incrementing delay instead of animating this element as a single block. */
     cascade?: boolean;
+    /** Milliseconds added to each successive child's delay when `cascade` is set. Default: 80. */
     cascadeInterval?: number;
+    /** Content to reveal. */
     children?: React.ReactNode;
 }
 /**
- * Reveal component that animates its content into view as it scrolls into
- * the viewport, backed by `IntersectionObserver`.
- *
- * Renders in its final, visible state during SSR and on the first client
- * render, so content is never hidden if JavaScript never runs (crawlers,
- * disabled JS). Automatically skips the animation (renders the final state
- * immediately) when the user prefers reduced motion.
+ * The `Reveal` component animates its content into view as it scrolls into the viewport, backed by `IntersectionObserver`.
  *
  * @function
  * @param {RevealProps} props - Props for the Reveal component.