@k8slens/lds 0.58.1 → 0.58.3

package/lib/cjs/Avatar/Avatar.d.ts

@@ -1,5 +1,6 @@
 import React, { type HTMLAttributes } from "react";
 import { type Icon } from "@k8slens/lds-icons/lib/es/Icon/Icon";
+/** Props for the Avatar component. */
 export interface AvatarProps extends Pick<HTMLAttributes<HTMLDivElement>, "aria-hidden" | "aria-label"> {
     /**
      * Full name of the user. Initials will be generated from this value and shown if no image is provided.
@@ -14,7 +15,8 @@ export interface AvatarProps extends Pick<HTMLAttributes<HTMLDivElement>, "aria-
      */
     image?: string | Icon | null;
     /**
-     * Size of the avatar. Defaults to "md"
+     * Size of the avatar.
+     * @default "md"
      */
     size?: "sm" | "md" | "xl";
 }

package/lib/cjs/Badge/Badge.d.ts

@@ -1,16 +1,18 @@
 import React, { HTMLAttributes } from "react";
+/** Props for the Badge component. */
 export interface BadgeProps extends Pick<HTMLAttributes<HTMLSpanElement>, "id" | "className" | "title" | "aria-label" | "aria-hidden" | "role"> {
     /**
-     * If no title has not been provided, the badge will be hidden from screen readers.
+     * If no title is provided, the badge will be hidden from screen readers.
      */
     title?: string;
     /**
-     * Defines the color of the lozenge.
-     * @default secondary
+     * Defines the color of the badge.
+     * @default "secondary"
      */
     type?: "primary" | "secondary" | "success" | "error" | "warning";
     /**
-     * @default sm
+     * Size of the badge.
+     * @default "sm"
      */
     size?: "sm" | "md" | "lg";
 }

package/lib/cjs/Button/Button.d.ts

@@ -1,41 +1,65 @@
 import React, { ButtonHTMLAttributes, ReactNode } from "react";
 import { Props } from "./shared";
+/** Props for the Button component. */
 export interface ButtonProps extends Props, Pick<ButtonHTMLAttributes<HTMLButtonElement>, "id" | "className" | "aria-label" | "title"> {
+    /**
+     * The HTML `type` attribute for the underlying `<button>` element.
+     * @default "button"
+     */
     buttonType?: ButtonHTMLAttributes<HTMLButtonElement>["type"];
     /**
-     * Specify the the initial value of the button element, used when the button is inside a form.
+     * Specify the initial value of the button element, used when the button is inside a form.
      */
     buttonValue?: ButtonHTMLAttributes<HTMLButtonElement>["value"];
     /**
-     * Specify the the name of the button element, used when the button is inside a form.
+     * Specify the name of the button element, used when the button is inside a form.
      */
     buttonName?: ButtonHTMLAttributes<HTMLButtonElement>["name"];
+    /**
+     * Whether to show the loading activity indicator.
+     * @default false
+     */
     loading?: boolean;
     /**
-     * When set to true true, if the onClick callback returns a promise,
+     * When set to true, if the onClick callback returns a promise,
      * loading activity indicator will be shown until the promise has been resolved/rejected.
+     * @default false
      */
     loadingStateOnPromise?: boolean;
+    /** Click handler. May return a promise when used with `loadingStateOnPromise`. */
     onClick?(e: React.MouseEvent<HTMLButtonElement, MouseEvent>): Promise<unknown> | unknown;
 }
+/** Props for the Button component when `label` is a ReactNode (requires explicit `aria-label`). */
 export interface ButtonPropsWithLabelNode extends Omit<Props, "label">, Pick<ButtonHTMLAttributes<HTMLButtonElement>, "id" | "className" | "title"> {
+    /**
+     * The HTML `type` attribute for the underlying `<button>` element.
+     * @default "button"
+     */
     buttonType?: ButtonHTMLAttributes<HTMLButtonElement>["type"];
     /**
-     * Specify the the initial value of the button element, used when the button is inside a form.
+     * Specify the initial value of the button element, used when the button is inside a form.
      */
     buttonValue?: ButtonHTMLAttributes<HTMLButtonElement>["value"];
     /**
-     * Specify the the name of the button element, used when the button is inside a form.
+     * Specify the name of the button element, used when the button is inside a form.
      */
     buttonName?: ButtonHTMLAttributes<HTMLButtonElement>["name"];
+    /**
+     * Whether to show the loading activity indicator.
+     * @default false
+     */
     loading?: boolean;
     /**
-     * When set to true true, if the onClick callback returns a promise,
+     * When set to true, if the onClick callback returns a promise,
      * loading activity indicator will be shown until the promise has been resolved/rejected.
+     * @default false
      */
     loadingStateOnPromise?: boolean;
+    /** Required accessible label when `label` is a ReactNode. */
     "aria-label": string;
+    /** Button label content, accepts ReactNode. */
     label: ReactNode;
+    /** Click handler. May return a promise when used with `loadingStateOnPromise`. */
     onClick?(e: React.MouseEvent<HTMLButtonElement, MouseEvent>): Promise<unknown> | unknown;
 }
 /**
@@ -44,6 +68,10 @@ export interface ButtonPropsWithLabelNode extends Omit<Props, "label">, Pick<But
  * from `onClick` will show a loading indicator until the promise has been resolved/rejected.
  *
  * Usage: `import { Button } from "@k8slens/lds"`
+ *
+ * ```tsx
+ * <Button label="Save" type="primary" onClick={handleSave} />
+ * ```
  */
 declare const Button: React.ForwardRefExoticComponent<(ButtonProps | ButtonPropsWithLabelNode) & React.RefAttributes<HTMLButtonElement>>;
 export default Button;

package/lib/cjs/Button/shared.d.ts

@@ -4,17 +4,46 @@ export declare type Type = "default" | "primary" | "ok" | "danger" | "caution";
 export declare type Size = "xxs" | "xs" | "sm" | "md";
 export declare type IconPosition = "right" | "left";
 export declare type TextTransform = "uppercase" | "capitalize";
+/** Shared props for the Button component variants. */
 export interface Props {
+    /** Text label rendered inside the button. */
     label: string;
+    /** Icon component rendered alongside the label. */
     icon?: Icon;
+    /**
+     * Which side of the label the icon is rendered on.
+     * @default "left"
+     */
     iconPosition?: IconPosition;
+    /**
+     * Visual style variant of the button.
+     * @default "default"
+     */
     type?: Type;
+    /**
+     * Size of the button.
+     * @default "md"
+     */
     size?: Size;
+    /**
+     * Shorthand for `type="primary"`.
+     * @deprecated Use `type="primary"` instead.
+     */
     primary?: boolean;
+    /**
+     * Whether the button is disabled.
+     * @default false
+     */
     disabled?: boolean;
+    /** Whether the button uses the discreet (low-emphasis) style. */
     discreet?: boolean;
-    /** @deprecated Use `case: "textTransform"` instead */
+    /**
+     * Text transform applied to the label.
+     * @deprecated Use `textTransform` instead.
+     */
     case?: TextTransform;
+    /** Text transform applied to the label. */
     textTransform?: TextTransform;
+    /** Additional content rendered after the label. */
     children?: React.ReactNode;
 }

package/lib/cjs/ButtonBar/ButtonBar.d.ts

@@ -3,15 +3,32 @@ declare type ExtractIntrinsicElementProps<Element extends keyof JSX.IntrinsicEle
 declare type ExtractComponentProps<TComponentOrTProps> = TComponentOrTProps extends React.ComponentType<infer TProps> ? TProps : TComponentOrTProps;
 declare type ExtractProps<TComponentOrTProps> = TComponentOrTProps extends keyof JSX.IntrinsicElements ? ExtractIntrinsicElementProps<TComponentOrTProps> : ExtractComponentProps<TComponentOrTProps>;
 export declare type Type = "default" | "centered" | "stacked" | "grid";
+/** Props for the ButtonBar component. */
 export declare type ButtonBarProps<ElementType extends JSX.IntrinsicElements | React.ElementType<any>> = Partial<Omit<ExtractProps<ElementType>, "children" | "as" | "type" | "gridSize">> & {
+    /**
+     * Element or component to render as the container.
+     * @default "div"
+     */
     as?: keyof JSX.IntrinsicElements | React.ElementType<any> | undefined;
+    /**
+     * Layout type for the button arrangement.
+     * @default "default"
+     */
     type?: Type;
+    /** Override the grid column count (only used when `type` is `"grid"`). */
     gridSize?: Number;
 };
 /**
  * A container for buttons. Set `type` prop to change the layout of the buttons.
  *
  * Usage: `import { ButtonBar } from "@k8slens/lds"`
+ *
+ * ```tsx
+ * <ButtonBar>
+ *   <Button label="Cancel" />
+ *   <Button label="Save" type="primary" />
+ * </ButtonBar>
+ * ```
  */
 declare function ButtonBar<ElementType extends JSX.IntrinsicElements | React.ElementType<any>>({ as: Component, type, gridSize, children, ...props }: PropsWithChildren<ButtonBarProps<ElementType>>): React.JSX.Element;
 export default ButtonBar;

package/lib/cjs/Checkbox/Checkbox.d.ts

@@ -1,7 +1,14 @@
 import React from "react";
+/** Props for the Checkbox component. */
 export interface CheckboxProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "type" | "onChange" | "value" | "disabled"> {
+    /** Whether the checkbox is checked. */
     value: boolean;
+    /** Change handler receiving the new value and the original event. */
     onChange(value: boolean, evt: React.ChangeEvent<HTMLInputElement>): void;
+    /**
+     * Whether the checkbox is disabled.
+     * @default false
+     */
     disabled?: boolean;
 }
 /**

package/lib/cjs/ConfirmDialog/ConfirmDialog.d.ts

@@ -1,15 +1,31 @@
 import React, { type ReactNode } from "react";
 import { type ButtonProps } from "../Button/Button";
 declare type AllowedButtonProps = Pick<ButtonProps, "type" | "size" | "discreet" | "icon" | "iconPosition" | "textTransform">;
+/** Props for the ConfirmDialog component. */
 export declare type ConfirmDialogProps = {
+    /** Title displayed in the confirm dialog header. */
     title: string;
+    /** Optional message body rendered below the title. */
     message?: string | ReactNode;
+    /**
+     * Label for the confirm button.
+     * @default "Ok"
+     */
     confirmText?: string;
+    /**
+     * Label for the cancel button.
+     * @default "Cancel"
+     */
     cancelLabel?: string;
+    /** Additional Button props forwarded to the confirm button. */
     confirmButtonProps?: Partial<AllowedButtonProps>;
+    /** Additional Button props forwarded to the cancel button. */
     cancelButtonProps?: Partial<AllowedButtonProps>;
+    /** Called when the dialog is dismissed (overlay click or escape key). */
     handleClose: () => void;
+    /** Called when the user clicks the confirm button. */
     handleConfirm: () => void;
+    /** Called when the user clicks the cancel button. */
     handleCancel: () => void;
 };
 /**

package/lib/cjs/ContextMenu/ContextMenu.d.ts

@@ -0,0 +1,40 @@
+import React, { HTMLAttributes, ReactNode } from "react";
+import { type Icon } from "@k8slens/lds-icons/lib/es/Icon/Icon";
+import ContextMenuItem from "./ContextMenuItem";
+export type { ContextMenuItemProps } from "./ContextMenuItem";
+/** Props for the ContextMenu component. */
+export interface ContextMenuProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    /** Menu items rendered inside the dropdown. */
+    children: ReactNode;
+    /**
+     * Icon component for the trigger button.
+     * @default ContextMenuIcon
+     */
+    icon?: Icon;
+    /**
+     * Horizontal alignment of the dropdown relative to the trigger.
+     * @default "right"
+     */
+    position?: "left" | "right";
+    /**
+     * Whether the context menu is disabled.
+     * @default false
+     */
+    disabled?: boolean;
+}
+/**
+ * A dropdown context menu triggered by an icon button.
+ *
+ * Usage: `import { ContextMenu } from "@k8slens/lds"`
+ *
+ * ```tsx
+ * <ContextMenu>
+ *   <ContextMenu.Item onClick={handleEdit}>Edit</ContextMenu.Item>
+ *   <ContextMenu.Item onClick={handleDelete} disabled>Delete</ContextMenu.Item>
+ * </ContextMenu>
+ * ```
+ */
+declare const ContextMenu: (({ children, icon: Icn, position, disabled, className, ...props }: ContextMenuProps) => React.JSX.Element) & {
+    Item: typeof ContextMenuItem;
+};
+export default ContextMenu;

package/lib/cjs/ContextMenu/ContextMenu.js

@@ -0,0 +1 @@
+"use strict";var e=require("../_virtual/_tslib.js"),t=require("react"),a=require("clsx"),n=require("@headlessui/react"),l=require("@k8slens/lds-icons"),r=require("./ContextMenuItem.js"),i=require("./ContextMenu.module.css.js");function s(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}var u=s(t),o=s(a),c=l.navigation.ContextMenuIcon,d=Object.assign((function(t){var a,l=t.children,r=t.icon,s=t.position,d=void 0===s?"right":s,m=t.disabled,f=void 0!==m&&m,b=t.className,v=e.__rest(t,["children","icon","position","disabled","className"]),q=r||c;return u.default.createElement("div",e.__assign({},v,{className:o.default(i.contextMenu,b)}),u.default.createElement(n.Menu,null,u.default.createElement(n.MenuButton,{className:i.trigger,disabled:f,"aria-label":v["aria-label"]||"Context menu"},u.default.createElement(q,null)),u.default.createElement(n.MenuItems,{transition:!0,className:o.default(i.dropdown,(a={},a[i.left]="left"===d,a))},l)))}),{Item:r});module.exports=d;

package/lib/cjs/ContextMenu/ContextMenu.module.css.js

@@ -0,0 +1 @@
+"use strict";module.exports={contextMenu:"lds-context-menu",trigger:"lds-context-menu--trigger",dropdown:"lds-context-menu--dropdown",left:"lds-context-menu--left",item:"lds-context-menu--item",itemIcon:"lds-context-menu--item-icon",itemLabel:"lds-context-menu--item-label"};

package/lib/cjs/ContextMenu/ContextMenuItem.d.ts

@@ -0,0 +1,30 @@
+import React, { ReactNode } from "react";
+import { type Icon } from "@k8slens/lds-icons/lib/es/Icon/Icon";
+/** Props for the ContextMenu.Item sub-component. */
+export interface ContextMenuItemProps {
+    /** Content displayed inside the menu item. */
+    children: ReactNode;
+    /** Optional icon rendered before the content. */
+    icon?: Icon;
+    /** Click handler. */
+    onClick?: (e: React.MouseEvent<HTMLButtonElement>) => void;
+    /**
+     * Whether the item is disabled.
+     * @default false
+     */
+    disabled?: boolean;
+    /** Optional class name. */
+    className?: string;
+}
+/**
+ * A single item inside a ContextMenu dropdown. Renders a button with an optional icon.
+ *
+ * Usage: `import ContextMenu from "@k8slens/lds/ContextMenu"`
+ *
+ * ```tsx
+ * <ContextMenu.Item icon={EditIcon} onClick={handleEdit}>
+ *   Edit
+ * </ContextMenu.Item>
+ * ```
+ */
+export default function ContextMenuItem({ children, icon: Icn, onClick, disabled, className, }: ContextMenuItemProps): React.JSX.Element;

package/lib/cjs/ContextMenu/ContextMenuItem.js

@@ -0,0 +1 @@
+"use strict";var e=require("react"),t=require("clsx"),a=require("@headlessui/react"),l=require("./ContextMenu.module.css.js");function r(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}var u=r(e),n=r(t);module.exports=function(e){var t=e.children,r=e.icon,c=e.onClick,s=e.disabled,i=void 0!==s&&s,d=e.className;return u.default.createElement(a.MenuItem,{disabled:i},u.default.createElement("button",{className:n.default(l.item,d),onClick:c,disabled:i,type:"button"},r&&u.default.createElement(r,{className:l.itemIcon}),u.default.createElement("span",{className:l.itemLabel},t)))};

package/lib/cjs/DrawerTransition/DrawerTransition.d.ts

@@ -1,10 +1,30 @@
 import React, { PropsWithChildren } from "react";
+/** Props for the DrawerTransition component. */
 export interface DrawerTransitionProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Whether the drawer is open. */
     open: boolean;
+    /**
+     * Transition duration in milliseconds.
+     * @default 250
+     */
     duration?: number;
+    /** Callback fired after the enter transition completes. */
     afterEnter?: () => void;
+    /** Callback fired after the exit transition completes. */
     afterExit?: () => void;
+    /** Changes in dependencies trigger re-calculation of the drawer dimensions. */
     deps?: object;
 }
+/**
+ * An animated drawer that expands and collapses content with a height transition.
+ *
+ * Usage: `import { DrawerTransition } from "@k8slens/lds"`
+ *
+ * ```tsx
+ * <DrawerTransition open={isOpen}>
+ *   <p>Collapsible content here</p>
+ * </DrawerTransition>
+ * ```
+ */
 declare const DrawerTransition: React.FC<PropsWithChildren<DrawerTransitionProps>>;
 export default DrawerTransition;

package/lib/cjs/Input/Input.d.ts

@@ -1,15 +1,23 @@
 import React, { HTMLInputTypeAttribute } from "react";
 import { type Icon } from "@k8slens/lds-icons/lib/es/Icon/Icon";
 export declare type InputType = Exclude<HTMLInputTypeAttribute, "button" | "checkbox" | "radio" | "number">;
+/** Props for the Input component. */
 export interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "type"> {
+    /** Icon component displayed on the right side of the input. */
     icon?: Icon;
+    /** HTML input type (excludes button, checkbox, radio, number). */
     type?: InputType;
+    /** Props forwarded to the wrapping `div` element. */
     wrapperProps?: React.HTMLAttributes<HTMLDivElement>;
 }
 /**
  * A simple input component. Set `icon` prop to show an icon on the right side of the input.
  *
  * Usage: `import { Input } from "@k8slens/lds"`
+ *
+ * ```tsx
+ * <Input placeholder="Enter text" onChange={handleChange} />
+ * ```
  */
 declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLInputElement>>;
 export default Input;

package/lib/cjs/LinkButton/LinkButton.d.ts

@@ -1,9 +1,16 @@
 import React, { type AnchorHTMLAttributes } from "react";
 export declare type Size = "sm" | "md";
 export declare type TextTransform = "uppercase" | "capitalize";
+/** Props for the LinkButton component. */
 export interface LinkButtonProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "label"> {
+    /** Text label displayed in the link button. */
     label: string;
+    /**
+     * Size of the link button.
+     * @default "md"
+     */
     size?: Size;
+    /** Text transformation applied to the label. */
     textTransform?: TextTransform;
     /**
      * Leave `href` and `onClick` undefined to disable the button

package/lib/cjs/LoadingIndicator/LoadingIndicator.d.ts

@@ -1,17 +1,23 @@
 import React from "react";
 import { type Props as IconProps } from "@k8slens/lds-icons/lib/es/Icon/Icon.d";
+/** Props for the LoadingIndicator component. */
 export interface LoadingIndicatorProps {
     /**
-     *`IconProps.size`, see [SVGIcon](/?path=/docs/icon-svgicon--default) for details.
+     * `IconProps.size`, see [SVGIcon](/?path=/docs/icon-svgicon--default) for details.
      * @default "md"
      */
     size?: IconProps["size"];
+    /** Optional class name. */
     className?: string;
 }
 /**
- * A loading indicator component.
+ * Animated spinner for loading states. Wraps a SpinnerIcon with configurable size.
  *
  * Usage: `import { LoadingIndicator } from "@k8slens/lds"`
+ *
+ * ```tsx
+ * <LoadingIndicator size="md" />
+ * ```
  */
 declare const LoadingIndicator: React.FC<LoadingIndicatorProps>;
 export default LoadingIndicator;

package/lib/cjs/Lozenge/Lozenge.d.ts

@@ -1,9 +1,10 @@
 import React, { HTMLAttributes } from "react";
 export declare type TextTransform = "uppercase" | "capitalize";
+/** Props for the Lozenge component. */
 export interface LozengeProps extends Omit<HTMLAttributes<HTMLSpanElement>, "type" | "size" | "textTransform"> {
     /**
      * Defines the color of the lozenge.
-     * @default secondary
+     * @default "secondary"
      */
     type?: "primary" | "secondary" | "success" | "error" | "warning";
     /**
@@ -11,7 +12,8 @@ export interface LozengeProps extends Omit<HTMLAttributes<HTMLSpanElement>, "typ
      */
     textTransform?: TextTransform;
     /**
-     * @default sm
+     * Size of the lozenge.
+     * @default "sm"
      */
     size?: "sm" | "md" | "lg";
 }

package/lib/cjs/Modal/Modal.d.ts

@@ -1,16 +1,36 @@
 import React, { PropsWithChildren, ReactNode } from "react";
 import { PanelProps } from "../Panel/Panel";
 import { ButtonBarProps } from "../ButtonBar/ButtonBar";
+/** Props for the Modal component. */
 export interface ModalProps<Component extends keyof JSX.IntrinsicElements | React.ElementType> {
+    /** Title displayed in the modal header. */
     title: string;
+    /** Optional subtitle displayed below the title. */
     subTitle?: string;
+    /** Whether the modal is currently open. */
     isOpen: boolean;
+    /** Called when the modal is dismissed (overlay click or escape key). */
     onClose: () => void;
+    /**
+     * Size of the modal.
+     * @default "md"
+     */
     size: "sm" | "md" | "lg" | "xl";
+    /** Element type or component used as the content wrapper (passed to Panel). */
     contentComponent?: PanelProps<Component>["wrapperComponent"];
+    /** Props forwarded to the content wrapper component. */
     contentProps?: PanelProps<Component>["wrapperProps"];
+    /**
+     * Props forwarded to the footer ButtonBar component.
+     * @default {}
+     */
     buttonBarProps?: Omit<ButtonBarProps<"footer">, "as">;
+    /**
+     * Additional class name for the modal Panel.
+     * @default ""
+     */
     className?: string;
+    /** Content rendered in the modal footer, wrapped by ButtonBar. */
     footer?: ReactNode;
 }
 /**
@@ -24,6 +44,12 @@ export interface ModalProps<Component extends keyof JSX.IntrinsicElements | Reac
  * To pass props to `ButtonBar` use the `buttonBarProps` prop.
  *
  * Usage: `import { Modal } from "@k8slens/lds"`
+ *
+ * ```tsx
+ * <Modal isOpen={open} onClose={close} title="Confirm" size="sm">
+ *   <p>Are you sure?</p>
+ * </Modal>
+ * ```
  */
 declare function Modal<Component extends keyof JSX.IntrinsicElements | React.ElementType>({ children, isOpen, onClose, title, subTitle, size, contentComponent, contentProps: _contentProps, buttonBarProps, className, footer, }: PropsWithChildren<ModalProps<Component>>): React.JSX.Element | null;
 export default Modal;

package/lib/cjs/Notification/Notification.d.ts

@@ -1,22 +1,38 @@
 import React, { ReactNode } from "react";
 export declare type Type = "flash" | "closable" | "inline" | "default";
 export declare type AlertLevel = "info" | "success" | "error" | "warning";
+/** Props for the Notification component. */
 export interface NotificationProps {
+    /** The notification body content. */
     message: string | ReactNode;
+    /** Optional bold heading rendered above the message. */
     title?: string;
+    /**
+     * Behavior type of the notification.
+     * @default "default"
+     */
     type?: Type;
+    /**
+     * Visual severity level of the notification.
+     * @default "info"
+     */
     level?: AlertLevel;
+    /** @deprecated Use `type` prop instead. */
     inline?: false;
+    /** @deprecated Use `type` prop instead. */
     flash?: false;
     /**
-     * Hide after `flashDuration` milliseconds, if type is set to "flash"
+     * Hide after `flashDuration` milliseconds, if type is set to "flash".
+     * @default 5000
      */
     flashDuration?: number;
     /**
-     * Can be set closable if not inline
+     * Can be set closable if not inline.
      */
     closable?: boolean;
+    /** Called after the notification finishes its exit transition. */
     onClose?(): void;
+    /** Additional class name for the notification wrapper. */
     className?: string;
 }
 /**

package/lib/cjs/NumberBadge/NumberBadge.d.ts

@@ -4,7 +4,7 @@ export declare const formatNumber: (n: number) => string;
 interface BaseNumberBadgeProps extends Omit<LozengeProps, "role" | "children" | "title" | "textTransform" | "size"> {
     value: number | null | undefined;
     /**
-     * If no title has not been provided, the badge will be hidden from screen readers.
+     * If no title is provided, the badge will be hidden from screen readers.
      */
     title?: string;
     /**

package/lib/cjs/Panel/Panel.d.ts

@@ -1,17 +1,45 @@
 import React, { Fragment, ReactNode } from "react";
 import type { ExtractProps } from "../types/ExtractProps.d";
+/** Props for the Panel component. */
 export interface PanelProps<WrapperComponent extends keyof JSX.IntrinsicElements | React.ElementType = typeof Fragment, HeaderComponent extends keyof JSX.IntrinsicElements | React.ElementType = "header", ContentComponent extends keyof JSX.IntrinsicElements | React.ElementType = "div", FooterComponent extends keyof JSX.IntrinsicElements | React.ElementType = "footer"> {
+    /** Content rendered in the header section. */
     header?: ReactNode;
+    /** Content rendered in the footer section. */
     footer?: ReactNode;
+    /** Optional class name applied to header, content, and footer elements. */
     className?: string;
+    /**
+     * Component used to wrap the entire panel.
+     * @default Fragment
+     */
     wrapperComponent?: WrapperComponent;
+    /** Props forwarded to the wrapper component. */
     wrapperProps?: ExtractProps<WrapperComponent>;
+    /**
+     * Component used for the header section.
+     * @default "header"
+     */
     headerComponent?: HeaderComponent;
+    /** Props forwarded to the header component. */
     headerProps?: ExtractProps<HeaderComponent>;
+    /**
+     * Component used for the content section.
+     * @default "div"
+     */
     contentComponent?: ContentComponent | undefined;
+    /** Props forwarded to the content component. */
     contentProps?: ExtractProps<ContentComponent>;
+    /**
+     * Component used for the footer section.
+     * @default "footer"
+     */
     footerComponent?: FooterComponent;
+    /** Props forwarded to the footer component. */
     footerProps?: ExtractProps<FooterComponent>;
+    /**
+     * Whether to show a loading indicator overlay.
+     * @default false
+     */
     loading?: boolean;
 }
 /**

package/lib/cjs/ProfileBlock/ProfileBlock.d.ts

@@ -6,10 +6,18 @@ declare type Item = {
     avatar?: AvatarProps["image"];
     avatarTitle: string;
 };
+/** Props for the ProfileBlock component. */
 export declare type ProfileBlockProps = HTMLProps<HTMLDivElement> & {
+    /**
+     * Whether to show a loading indicator instead of text content.
+     * @default false
+     */
     loading?: boolean;
+    /** User data to display (title, subtitle, avatar). */
     item: Item;
+    /** Custom formatter for the title text. */
     formatTitle?: (item: Item) => string | ReactElement;
+    /** Custom formatter for the subtitle text. */
     formatSubtitle?: (item: Item) => string | ReactElement;
 };
 /**

package/lib/cjs/ProgressBar/ProgressBar.d.ts

@@ -1,8 +1,19 @@
 import React from "react";
+/** Props for the ProgressBar component. */
 export interface ProgressBarProps extends React.ProgressHTMLAttributes<HTMLProgressElement> {
+    /** Current progress value. */
     value: number;
+    /**
+     * Maximum value for the progress bar.
+     * @default 1
+     */
     max?: number;
+    /**
+     * Color of the progress bar.
+     * @default "default"
+     */
     type?: "default" | "ok" | "caution" | "danger";
+    /** Accessible title text. Falls back to percentage display if not provided. */
     title?: string;
 }
 /**