@allxsmith/bestax-bulma 5.6.2 → 5.8.0

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

@@ -1,5 +1,16 @@
 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'> {
     className?: string;
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -9,25 +20,38 @@ export interface NavbarProps extends React.HTMLAttributes<HTMLElement>, Omit<Bul
     fixed?: 'top' | 'bottom';
     children?: React.ReactNode;
 }
-export declare const Navbar: React.FC<NavbarProps> & {
-    Brand: typeof NavbarBrand;
-    Item: typeof NavbarItem;
-    Link: typeof NavbarLink;
-    Burger: typeof NavbarBurger;
-    Menu: typeof NavbarMenu;
-    Start: typeof NavbarStart;
-    End: typeof NavbarEnd;
-    Dropdown: typeof NavbarDropdown;
-    DropdownMenu: typeof NavbarDropdownMenu;
-    Divider: typeof NavbarDivider;
-};
+/**
+ * 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'> {
     className?: string;
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
     children?: React.ReactNode;
 }
+/**
+ * Bulma Navbar brand area (usually left side).
+ *
+ * @function
+ * @param {NavbarBrandProps} props - Props for the NavbarBrand component.
+ * @returns {JSX.Element} The rendered brand area.
+ */
 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'> {
     className?: string;
     as?: React.ElementType;
@@ -37,7 +61,26 @@ export interface NavbarItemProps extends Omit<React.AnchorHTMLAttributes<HTMLAnc
     children?: React.ReactNode;
     [key: string]: unknown;
 }
+/**
+ * Bulma Navbar item (link, button, etc).
+ *
+ * @function
+ * @param {NavbarItemProps} props - Props for the NavbarItem component.
+ * @returns {JSX.Element} The rendered item.
+ */
 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'> {
     className?: string;
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -48,7 +91,23 @@ export interface NavbarBurgerProps extends React.ButtonHTMLAttributes<HTMLButton
     'aria-expanded'?: boolean;
     onClick?: React.MouseEventHandler<HTMLButtonElement>;
 }
+/**
+ * Bulma Navbar burger (responsive menu toggle).
+ *
+ * @function
+ * @param {NavbarBurgerProps} props - Props for the NavbarBurger component.
+ * @returns {JSX.Element} The rendered burger.
+ */
 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'> {
     className?: string;
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -56,15 +115,54 @@ export interface NavbarMenuProps extends React.HTMLAttributes<HTMLDivElement>, O
     active?: boolean;
     children?: React.ReactNode;
 }
+/**
+ * Bulma Navbar menu area (collapsible content).
+ *
+ * @function
+ * @param {NavbarMenuProps} props - Props for the NavbarMenu component.
+ * @returns {JSX.Element} The rendered menu.
+ */
 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'> {
     className?: string;
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
     children?: React.ReactNode;
 }
+/**
+ * Bulma Navbar start area (left-aligned).
+ *
+ * @function
+ * @param {NavbarStartEndProps} props - Props for the NavbarStart component.
+ * @returns {JSX.Element} The rendered start area.
+ */
 export declare const NavbarStart: React.FC<NavbarStartEndProps>;
+/**
+ * Bulma Navbar end area (right-aligned).
+ *
+ * @function
+ * @param {NavbarStartEndProps} props - Props for the NavbarEnd component.
+ * @returns {JSX.Element} The rendered end area.
+ */
 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'> {
     className?: string;
     as?: React.ElementType;
@@ -73,7 +171,27 @@ export interface NavbarLinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnc
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
     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.
+ *
+ * @function
+ * @param {NavbarLinkProps} props - Props for the NavbarLink component.
+ * @returns {JSX.Element} The rendered navbar link.
+ */
 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> {
     className?: string;
     right?: boolean;
@@ -82,13 +200,54 @@ export interface NavbarDropdownProps extends React.HTMLAttributes<HTMLDivElement
     active?: boolean;
     children?: React.ReactNode;
 }
+/**
+ * Bulma Navbar dropdown (for nested dropdown menus).
+ *
+ * @function
+ * @param {NavbarDropdownProps} props - Props for the NavbarDropdown component.
+ * @returns {JSX.Element} The rendered dropdown.
+ */
 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> {
     className?: string;
     right?: boolean;
     up?: boolean;
     children?: React.ReactNode;
 }
+/**
+ * Bulma Navbar dropdown menu container.
+ *
+ * @function
+ * @param {NavbarDropdownMenuProps} props - Props for the NavbarDropdownMenu component.
+ * @returns {JSX.Element} The rendered dropdown menu.
+ */
 export declare const NavbarDropdownMenu: React.FC<NavbarDropdownMenuProps>;
+/**
+ * Bulma Navbar divider.
+ *
+ * @function
+ * @param {React.HTMLAttributes<HTMLHRElement>} props - Standard hr props.
+ * @returns {JSX.Element} The rendered divider.
+ */
 export declare const NavbarDivider: React.FC<React.HTMLAttributes<HTMLHRElement>>;
+export declare const Navbar: React.FC<NavbarProps> & {
+    Brand: React.FC<NavbarBrandProps>;
+    Item: React.FC<NavbarItemProps>;
+    Link: React.FC<NavbarLinkProps>;
+    Burger: React.FC<NavbarBurgerProps>;
+    Menu: React.FC<NavbarMenuProps>;
+    Start: React.FC<NavbarStartEndProps>;
+    End: React.FC<NavbarStartEndProps>;
+    Dropdown: React.FC<NavbarDropdownProps>;
+    DropdownMenu: React.FC<NavbarDropdownMenuProps>;
+    Divider: React.FC<React.HTMLAttributes<HTMLHRElement>>;
+};
 export default Navbar;

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

@@ -1,5 +1,20 @@
 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?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger' | 'black' | 'dark' | 'light' | 'white';
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -13,20 +28,43 @@ export interface PaginationProps extends React.HTMLAttributes<HTMLElement>, Omit
     className?: string;
     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> {
     className?: string;
     disabled?: boolean;
     children?: React.ReactNode;
 }
+/**
+ * Bulma Pagination previous button.
+ *
+ * @function
+ * @param {PaginationPreviousNextProps} props - Props for the PaginationPrevious component.
+ * @returns {JSX.Element} The rendered previous button.
+ */
 export declare const PaginationPrevious: React.FC<PaginationPreviousNextProps>;
+/**
+ * Bulma Pagination next button.
+ *
+ * @function
+ * @param {PaginationPreviousNextProps} props - Props for the PaginationNext component.
+ * @returns {JSX.Element} The rendered next button.
+ */
 export declare const PaginationNext: React.FC<PaginationPreviousNextProps>;
-export declare const Pagination: React.FC<PaginationProps> & {
-    Link: typeof PaginationLink;
-    List: typeof PaginationList;
-    Ellipsis: typeof PaginationEllipsis;
-    Previous: typeof PaginationPrevious;
-    Next: typeof PaginationNext;
-};
+/**
+ * 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'> {
     className?: string;
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
@@ -34,7 +72,25 @@ export interface PaginationListProps extends React.HTMLAttributes<HTMLUListEleme
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
     children?: React.ReactNode;
 }
+/**
+ * Bulma Pagination list container.
+ *
+ * @function
+ * @param {PaginationListProps} props - Props for the PaginationList component.
+ * @returns {JSX.Element} The rendered pagination list.
+ */
 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'> {
     className?: string;
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
@@ -44,6 +100,27 @@ export interface PaginationLinkProps extends React.AnchorHTMLAttributes<HTMLAnch
     disabled?: boolean;
     children?: React.ReactNode;
 }
+/**
+ * Bulma Pagination link (page number).
+ *
+ * @function
+ * @param {PaginationLinkProps} props - Props for the PaginationLink component.
+ * @returns {JSX.Element} The rendered pagination link.
+ */
 export declare const PaginationLink: React.FC<PaginationLinkProps>;
+/**
+ * Bulma Pagination ellipsis element.
+ *
+ * @function
+ * @param {React.LiHTMLAttributes<HTMLLIElement>} props - Standard li props.
+ * @returns {JSX.Element} The rendered ellipsis.
+ */
 export declare const PaginationEllipsis: React.FC<React.LiHTMLAttributes<HTMLLIElement>>;
+export declare const Pagination: React.FC<PaginationProps> & {
+    Link: React.FC<PaginationLinkProps>;
+    List: React.FC<PaginationListProps>;
+    Ellipsis: React.FC<React.LiHTMLAttributes<HTMLLIElement>>;
+    Previous: React.FC<PaginationPreviousNextProps>;
+    Next: React.FC<PaginationPreviousNextProps>;
+};
 export default Pagination;

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

@@ -1,53 +1,153 @@
 import React from 'react';
 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'> {
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger' | 'black' | 'dark' | 'light' | 'white';
     className?: string;
     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> {
     className?: string;
     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> {
     className?: string;
     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> {
     className?: string;
     active?: boolean;
     children?: React.ReactNode;
 }
+/**
+ * Props for the PanelIcon component.
+ * Extends IconProps but uses 'panel-icon' as the container class.
+ */
 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> {
     value?: string;
     onChange?: React.ChangeEventHandler<HTMLInputElement>;
     placeholder?: string;
     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'> {
     checked?: boolean;
     onChange?: React.ChangeEventHandler<HTMLInputElement>;
     children?: React.ReactNode;
 }
+/**
+ * Props for the PanelButtonBlock component.
+ *
+ * @property {React.ReactNode} [children] - Button content.
+ */
 export interface PanelButtonBlockProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     children?: React.ReactNode;
 }
-export declare const Panel: React.FC<PanelProps> & {
-    Heading: typeof PanelHeading;
-    Tabs: typeof PanelTabs;
-    Block: typeof PanelBlock;
-    Icon: typeof PanelIcon;
-    InputBlock: typeof PanelInputBlock;
-    CheckboxBlock: typeof PanelCheckboxBlock;
-    ButtonBlock: typeof PanelButtonBlock;
-};
+/**
+ * Bulma Panel heading.
+ *
+ * @function
+ * @param {PanelHeadingProps} props - Props for the PanelHeading component.
+ * @returns {JSX.Element} The rendered panel heading.
+ */
 export declare const PanelHeading: React.FC<PanelHeadingProps>;
+/**
+ * Bulma Panel tabs.
+ *
+ * @function
+ * @param {PanelTabsProps} props - Props for the PanelTabs component.
+ * @returns {JSX.Element} The rendered panel tabs.
+ */
 export declare const PanelTabs: React.FC<PanelTabsProps>;
+/**
+ * Bulma Panel block.
+ *
+ * @function
+ * @param {PanelBlockProps} props - Props for the PanelBlock component.
+ * @returns {JSX.Element} The rendered panel block.
+ */
 export declare const PanelBlock: React.FC<PanelBlockProps>;
+/**
+ * Bulma Panel icon.
+ * Wraps the Icon component with 'panel-icon' container class.
+ *
+ * @function
+ * @param {PanelIconProps} props - Props for the PanelIcon component.
+ * @returns {JSX.Element} The rendered panel icon.
+ */
 export declare const PanelIcon: React.FC<PanelIconProps>;
+/**
+ * Bulma Panel input block.
+ *
+ * @function
+ * @param {PanelInputBlockProps} props - Props for the PanelInputBlock component.
+ * @returns {JSX.Element} The rendered panel input block.
+ */
 export declare const PanelInputBlock: React.FC<PanelInputBlockProps>;
+/**
+ * Bulma Panel checkbox block.
+ *
+ * @function
+ * @param {PanelCheckboxBlockProps} props - Props for the PanelCheckboxBlock component.
+ * @returns {JSX.Element} The rendered panel checkbox block.
+ */
 export declare const PanelCheckboxBlock: React.FC<PanelCheckboxBlockProps>;
+/**
+ * Bulma Panel button block.
+ *
+ * @function
+ * @param {PanelButtonBlockProps} props - Props for the PanelButtonBlock component.
+ * @returns {JSX.Element} The rendered panel button block.
+ */
 export declare const PanelButtonBlock: React.FC<PanelButtonBlockProps>;
+export declare const Panel: React.FC<PanelProps> & {
+    Heading: React.FC<PanelHeadingProps>;
+    Tabs: React.FC<PanelTabsProps>;
+    Block: React.FC<PanelBlockProps>;
+    Icon: React.FC<PanelIconProps>;
+    InputBlock: React.FC<PanelInputBlockProps>;
+    CheckboxBlock: React.FC<PanelCheckboxBlockProps>;
+    ButtonBlock: React.FC<PanelButtonBlockProps>;
+};
 export default Panel;

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

@@ -1,6 +1,22 @@
 import React from 'react';
 import { BulmaClassesProps } from '../helpers/useBulmaClasses';
+/**
+ * Animation styles available for the Reveal component.
+ */
 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.
+ */
 export interface RevealProps extends Omit<React.HTMLAttributes<HTMLElement>, 'color'>, BulmaClassesProps {
     animation?: RevealAnimation;
     delay?: number;
@@ -12,5 +28,32 @@ export interface RevealProps extends Omit<React.HTMLAttributes<HTMLElement>, 'co
     cascadeInterval?: number;
     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.
+ *
+ * @function
+ * @param {RevealProps} props - Props for the Reveal component.
+ * @returns {JSX.Element} The rendered reveal wrapper.
+ *
+ * @example
+ * // Fade a section up into view
+ * <Reveal animation="fade-up" as={Section}>
+ *   <Title>Why Grass Doctor</Title>
+ * </Reveal>
+ *
+ * @example
+ * // Stagger a set of cards as they enter the viewport
+ * <Reveal animation="fade-up" cascade cascadeInterval={80}>
+ *   {services.map(service => (
+ *     <Card key={service.name}>{service.name}</Card>
+ *   ))}
+ * </Reveal>
+ */
 export declare const Reveal: React.FC<RevealProps>;
 export default Reveal;

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

@@ -1,6 +1,21 @@
 import React from 'react';
 import { BulmaClassesProps } from '../helpers/useBulmaClasses';
+/** Position of the sidebar relative to the viewport. */
 export type SidebarPosition = 'left' | 'right';
+/**
+ * Props for the Sidebar component.
+ *
+ * @property {boolean} isOpen - Whether the sidebar is open.
+ * @property {() => void} [onClose] - Callback when sidebar should close.
+ * @property {SidebarPosition} [position] - Which side the sidebar appears from. Default: 'left'.
+ * @property {string} [width] - Custom width. Default: '260px'.
+ * @property {boolean} [fullWidth] - Sidebar takes full width (mobile-style).
+ * @property {boolean} [overlay] - Show overlay behind sidebar. Default: true.
+ * @property {boolean} [overlayClose] - Close sidebar when overlay is clicked. Default: true.
+ * @property {boolean} [escapeClose] - Close sidebar on Escape key. Default: true.
+ * @property {boolean} [canCancel] - Allow closing the sidebar. Default: true.
+ * @property {React.ReactNode} [children] - Content to display in the sidebar.
+ */
 export interface SidebarProps extends Omit<React.HTMLAttributes<HTMLElement>, 'children' | 'color'>, BulmaClassesProps {
     isOpen: boolean;
     onClose?: () => void;
@@ -12,18 +27,43 @@ export interface SidebarProps extends Omit<React.HTMLAttributes<HTMLElement>, 'c
     escapeClose?: boolean;
     canCancel?: boolean;
     children?: React.ReactNode;
+    /** Render without portal. Default false. */
     inline?: boolean;
 }
+/**
+ * Props for the SidebarHeader component.
+ *
+ * @property {React.ReactNode} [children] - Header content.
+ */
 interface SidebarHeaderProps extends React.HTMLAttributes<HTMLDivElement> {
     children?: React.ReactNode;
 }
+/**
+ * Props for the SidebarTitle component.
+ *
+ * @property {React.ReactNode} [children] - Title content.
+ */
 interface SidebarTitleProps extends React.HTMLAttributes<HTMLParagraphElement> {
     children?: React.ReactNode;
 }
+/**
+ * Props for the SidebarClose component.
+ * Extends standard button attributes.
+ */
 type SidebarCloseProps = React.ButtonHTMLAttributes<HTMLButtonElement>;
+/**
+ * Props for the SidebarBody component.
+ *
+ * @property {React.ReactNode} [children] - Body content.
+ */
 interface SidebarBodyProps extends React.HTMLAttributes<HTMLDivElement> {
     children?: React.ReactNode;
 }
+/**
+ * Props for the SidebarFooter component.
+ *
+ * @property {React.ReactNode} [children] - Footer content.
+ */
 interface SidebarFooterProps extends React.HTMLAttributes<HTMLDivElement> {
     children?: React.ReactNode;
 }