@k8slens/lds 0.58.2 → 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/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;
 }
 /**

package/lib/cjs/ProgressBar/ProgressBar.js

@@ -1 +1 @@
-"use strict";var e=require("../_virtual/_tslib.js"),a=require("react"),t=require("./ProgressBar.module.css.js"),r=require("clsx");function s(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}var u=s(a),l=s(r);module.exports=function(a){var r,s=a.value,i=a.type,o=void 0===i?"default":i,c=a.max,n=void 0===c?1:c,d=a.title,m=a.className,v=e.__rest(a,["value","type","max","title","className"]),f=isNaN(s)?0:Math.max(0,s),x=isNaN(n)||n<=0?1:n,N=Math.min(100,Math.round(f/x*100)),p=d||"".concat(N,"%");return u.default.createElement("progress",e.__assign({},v,{className:l.default(t.progressBar,m,(r={},r[t[o]]="default"!==o,r)),value:f,max:x,"aria-valuetext":p,title:d}),p)};
+"use strict";var e=require("../_virtual/_tslib.js"),a=require("react"),t=require("clsx"),r=require("./ProgressBar.module.css.js");function s(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}var u=s(a),l=s(t);module.exports=function(a){var t,s=a.value,i=a.type,o=void 0===i?"default":i,c=a.max,n=void 0===c?1:c,d=a.title,m=a.className,v=e.__rest(a,["value","type","max","title","className"]),f=isNaN(s)?0:Math.max(0,s),x=isNaN(n)||n<=0?1:n,N=Math.min(100,Math.round(f/x*100)),p=d||"".concat(N,"%");return u.default.createElement("progress",e.__assign({},v,{className:l.default(r.progressBar,m,(t={},t[r[o]]="default"!==o,t)),value:f,max:x,"aria-valuetext":p,title:d}),p)};

package/lib/cjs/RadioCard/RadioCard.d.ts

@@ -10,16 +10,33 @@ declare type ItemState = {
     selected?: boolean;
     disabled?: boolean;
 };
+/** Props for the RadioCard component. */
 export interface RadioCardProps<T> {
+    /** HTML `id` attribute for the radio group. */
     id?: string;
+    /** Accessible label for the radio group. */
     "aria-label"?: string;
+    /** Array of options to render as radio cards. */
     options: Array<T>;
+    /** Currently selected option. */
     value: T | undefined;
+    /** Change handler receiving the selected option. */
     onChange(d: T): void;
+    /** Name attribute for the radio group. */
     name: string;
+    /** Optional class name for the radio group container. */
     className?: string;
+    /** Optional class name applied to each radio card item. */
     itemClassName?: string;
+    /**
+     * Whether the entire radio group is disabled.
+     * @default false
+     */
     disabled?: boolean;
+    /**
+     * Whether the radio group is in an invalid state.
+     * @default false
+     */
     invalid?: boolean;
     /**
      * Function to render the content of card item.
@@ -30,9 +47,18 @@ export interface RadioCardProps<T> {
     renderItem?(d: T | undefined, state: ItemState): ReactNode;
 }
 /**
- * A styled radio button component.
+ * A card-based radio group for visual option selection. Renders each option as a styled card with a radio indicator.
  *
  * Usage: `import { RadioCard } from "@k8slens/lds"`
+ *
+ * ```tsx
+ * <RadioCard
+ *   name="plan"
+ *   options={[{ id: "1", label: "Free" }, { id: "2", label: "Pro" }]}
+ *   value={selected}
+ *   onChange={setSelected}
+ * />
+ * ```
  */
 export default function RadioCard<T extends DefaultOption>({ id, "aria-label": ariaLabel, value, options, onChange, name, invalid, disabled, itemClassName, className, renderItem, ...radioGroupProps }: RadioCardProps<T>): React.JSX.Element;
 export {};

package/lib/cjs/Select/MultiOption.d.ts

@@ -1,9 +1,19 @@
 import React, { type ReactNode } from "react";
-declare const MultiOption: React.ForwardRefExoticComponent<{
+/** Props for the MultiOption component. */
+interface MultiOptionProps {
+    /** Display text of the option, used for the accessible label. */
     label: string;
-    className?: string | undefined;
+    /** Optional class name for the multi-option pill. */
+    className?: string;
+    /** Content rendered inside the option pill. */
     children: ReactNode;
+    /** Called when the remove button is clicked or activated via keyboard. */
     onRemove: (e: React.MouseEvent | React.KeyboardEvent) => void;
-    onArrowNavigate?: ((direction: "next" | "prev") => void) | undefined;
-} & React.RefAttributes<HTMLSpanElement>>;
+    /** Called on arrow key press for keyboard navigation between pills. */
+    onArrowNavigate?: (direction: "next" | "prev") => void;
+}
+/**
+ * Removable pill for selected values in a multi-select. Supports keyboard navigation and accessible removal.
+ */
+declare const MultiOption: React.ForwardRefExoticComponent<MultiOptionProps & React.RefAttributes<HTMLSpanElement>>;
 export default MultiOption;