@backstage/ui 0.13.2 → 0.14.0-next.1

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode, CSSProperties, HTMLAttributes, ComponentPropsWithoutRef, ReactElement, ElementType, ComponentPropsWithRef, ComponentProps } from 'react';
-import { DisclosureProps, HeadingProps, DisclosurePanelProps, DisclosureGroupProps, ButtonProps as ButtonProps$1, DialogTriggerProps as DialogTriggerProps$1, ModalOverlayProps, TabsProps as TabsProps$1, TabListProps as TabListProps$1, TabProps as TabProps$1, TabPanelProps as TabPanelProps$1, LinkProps as LinkProps$1, CheckboxProps as CheckboxProps$1, RadioGroupProps as RadioGroupProps$1, RadioProps as RadioProps$1, TableProps as TableProps$1, TableHeaderProps as TableHeaderProps$1, TableBodyProps as TableBodyProps$1, ColumnProps as ColumnProps$1, RowProps as RowProps$1, CellProps as CellProps$1, TagListProps, TagGroupProps as TagGroupProps$1, TagProps as TagProps$1, TextFieldProps as TextFieldProps$1, TooltipProps as TooltipProps$1, TooltipTriggerComponentProps, MenuTriggerProps as MenuTriggerProps$1, SubmenuTriggerProps as SubmenuTriggerProps$1, PopoverProps as PopoverProps$1, MenuProps as MenuProps$1, ListBoxProps, MenuItemProps as MenuItemProps$1, ListBoxItemProps, MenuSectionProps as MenuSectionProps$1, SeparatorProps, SearchFieldProps as SearchFieldProps$1, GridListProps, GridListItemProps, SelectProps as SelectProps$1, SwitchProps as SwitchProps$1, ToggleButtonProps as ToggleButtonProps$1, ToggleButtonGroupProps as ToggleButtonGroupProps$1 } from 'react-aria-components';
+import { DisclosureProps, DisclosureGroupProps, DisclosurePanelProps, HeadingProps, ButtonProps as ButtonProps$1, ModalOverlayProps, DialogTriggerProps as DialogTriggerProps$1, TabProps as TabProps$1, TabListProps as TabListProps$1, TabPanelProps as TabPanelProps$1, TabsProps as TabsProps$1, LinkProps as LinkProps$1, CheckboxProps as CheckboxProps$1, RadioProps as RadioProps$1, RadioGroupProps as RadioGroupProps$1, SliderProps as SliderProps$1, CellProps as CellProps$1, ColumnProps as ColumnProps$1, RowProps as RowProps$1, TableProps as TableProps$1, TableBodyProps as TableBodyProps$1, TableHeaderProps as TableHeaderProps$1, TagProps as TagProps$1, TagListProps, TagGroupProps as TagGroupProps$1, TextFieldProps as TextFieldProps$1, TooltipProps as TooltipProps$1, TooltipTriggerComponentProps, PopoverProps as PopoverProps$1, MenuProps as MenuProps$1, ListBoxProps, MenuItemProps as MenuItemProps$1, ListBoxItemProps, MenuSectionProps as MenuSectionProps$1, SeparatorProps, MenuTriggerProps as MenuTriggerProps$1, SubmenuTriggerProps as SubmenuTriggerProps$1, SearchFieldProps as SearchFieldProps$1, GridListProps, GridListItemProps, SelectProps as SelectProps$1, SwitchProps as SwitchProps$1, ToggleButtonProps as ToggleButtonProps$1, ToggleButtonGroupProps as ToggleButtonGroupProps$1 } from 'react-aria-components';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { NavigateOptions } from 'react-router-dom';
 import { SortDescriptor as SortDescriptor$1 } from 'react-stately';
@@ -126,7 +126,11 @@ type BoxUtilityProps = {
 interface BoxProps extends SpaceProps, BoxOwnProps, BoxUtilityProps, Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {
 }
 
-/** @public */
+/**
+ * A general-purpose layout primitive that can render as any HTML element and supports spacing, sizing, and background props.
+ *
+ * @public
+ */
 declare const Box: react.ForwardRefExoticComponent<BoxProps & react.RefAttributes<HTMLDivElement>>;
 
 /**
@@ -248,7 +252,11 @@ interface FlexProps extends SpaceProps, FlexOwnProps, Omit<React.HTMLAttributes<
     direction?: Responsive<'row' | 'column' | 'row-reverse' | 'column-reverse'>;
 }
 
-/** @public */
+/**
+ * A flexbox layout container with props for controlling gap, alignment, justification, and direction.
+ *
+ * @public
+ */
 declare const Flex: react.ForwardRefExoticComponent<FlexProps & react.RefAttributes<HTMLDivElement>>;
 
 /**
@@ -290,7 +298,11 @@ interface ContainerProps extends ContainerOwnProps, Omit<React.ComponentPropsWit
     pt?: SpaceProps['pt'];
 }
 
-/** @public */
+/**
+ * A centered layout wrapper that constrains content to a maximum width and provides consistent page-level padding.
+ *
+ * @public
+ */
 declare const Container: react.ForwardRefExoticComponent<ContainerProps & react.RefAttributes<HTMLDivElement>>;
 
 /**
@@ -415,13 +427,29 @@ type AccordionGroupOwnProps = {
 interface AccordionGroupProps extends Omit<DisclosureGroupProps, 'className'>, AccordionGroupOwnProps {
 }
 
-/** @public */
+/**
+ * A collapsible section that reveals or hides its content when the trigger is activated.
+ *
+ * @public
+ */
 declare const Accordion: react.ForwardRefExoticComponent<AccordionProps & react.RefAttributes<HTMLDivElement>>;
-/** @public */
+/**
+ * The clickable heading that toggles the visibility of an accordion panel.
+ *
+ * @public
+ */
 declare const AccordionTrigger: react.ForwardRefExoticComponent<AccordionTriggerProps & react.RefAttributes<HTMLHeadingElement>>;
-/** @public */
+/**
+ * The content area of an accordion that is revealed when the trigger is activated.
+ *
+ * @public
+ */
 declare const AccordionPanel: react.ForwardRefExoticComponent<AccordionPanelProps & react.RefAttributes<HTMLDivElement>>;
-/** @public */
+/**
+ * A container that groups multiple Accordion items, optionally allowing several panels to be expanded at once.
+ *
+ * @public
+ */
 declare const AccordionGroup: react.ForwardRefExoticComponent<AccordionGroupProps & react.RefAttributes<HTMLDivElement>>;
 
 /**
@@ -631,7 +659,11 @@ type AvatarOwnProps = {
 interface AvatarProps extends Omit<React.ComponentPropsWithoutRef<'div'>, 'children' | 'className'>, AvatarOwnProps {
 }
 
-/** @public */
+/**
+ * Displays a user's profile image with an automatic fallback to their initials when the image fails to load.
+ *
+ * @public
+ */
 declare const Avatar: react.ForwardRefExoticComponent<AvatarProps & react.RefAttributes<HTMLDivElement>>;
 
 /**
@@ -988,15 +1020,35 @@ type DialogFooterOwnProps = {
 interface DialogFooterProps extends DialogFooterOwnProps, Omit<React.ComponentPropsWithoutRef<'div'>, keyof DialogFooterOwnProps> {
 }
 
-/** @public */
+/**
+ * A wrapper that connects a trigger element to a Dialog, controlling its open and close state.
+ *
+ * @public
+ */
 declare const DialogTrigger: (props: DialogTriggerProps) => react_jsx_runtime.JSX.Element;
-/** @public */
+/**
+ * A modal overlay that presents content requiring user interaction or acknowledgment, dismissible by clicking outside or pressing Escape.
+ *
+ * @public
+ */
 declare const Dialog: react.ForwardRefExoticComponent<DialogProps & react.RefAttributes<HTMLDivElement>>;
-/** @public */
+/**
+ * The header section of a Dialog, containing the title and a close button.
+ *
+ * @public
+ */
 declare const DialogHeader: react.ForwardRefExoticComponent<DialogHeaderProps & react.RefAttributes<HTMLDivElement>>;
-/** @public */
+/**
+ * The main scrollable content area of a Dialog.
+ *
+ * @public
+ */
 declare const DialogBody: react.ForwardRefExoticComponent<DialogBodyProps & react.RefAttributes<HTMLDivElement>>;
-/** @public */
+/**
+ * The footer section of a Dialog, typically used to place action buttons.
+ *
+ * @public
+ */
 declare const DialogFooter: react.ForwardRefExoticComponent<DialogFooterProps & react.RefAttributes<HTMLDivElement>>;
 
 /**
@@ -1092,13 +1144,21 @@ type FieldLabelOwnProps = {
      * The id of the text field
      */
     id?: string;
+    /**
+     * The id to apply to the description element for aria-describedby
+     */
+    descriptionId?: string;
     className?: string;
 };
 /** @public */
 interface FieldLabelProps extends FieldLabelOwnProps, Omit<React.ComponentPropsWithoutRef<'div'>, keyof FieldLabelOwnProps> {
 }
 
-/** @public */
+/**
+ * Renders a label for a form field with optional secondary label and description text.
+ *
+ * @public
+ */
 declare const FieldLabel: react.ForwardRefExoticComponent<FieldLabelProps & react.RefAttributes<HTMLDivElement>>;
 
 /**
@@ -1121,6 +1181,7 @@ declare const FieldLabelDefinition: {
         readonly description: {};
         readonly htmlFor: {};
         readonly id: {};
+        readonly descriptionId: {};
         readonly className: {};
     };
 };
@@ -1289,8 +1350,9 @@ declare module 'react-aria-components' {
     }
 }
 /**
- * A component that renders a plugin header with icon, title, custom actions,
- * and navigation tabs.
+ * Renders a plugin header with icon, title, custom actions, and optional tabs.
+ * Always participates in the background context system so descendants (e.g. buttons)
+ * get the correct `data-on-bg` styling inside the toolbar and tabs.
  *
  * @public
  */
@@ -1307,7 +1369,6 @@ declare const PluginHeaderDefinition: {
     readonly classNames: {
         readonly root: "bui-PluginHeader";
         readonly toolbar: "bui-PluginHeaderToolbar";
-        readonly toolbarWrapper: "bui-PluginHeaderToolbarWrapper";
         readonly toolbarContent: "bui-PluginHeaderToolbarContent";
         readonly toolbarControls: "bui-PluginHeaderToolbarControls";
         readonly toolbarIcon: "bui-PluginHeaderToolbarIcon";
@@ -1325,6 +1386,32 @@ declare const PluginHeaderDefinition: {
     };
 };
 
+/**
+ * Represents a single navigation tab in the header.
+ *
+ * @public
+ */
+interface HeaderNavTab {
+    id: string;
+    label: string;
+    href: string;
+}
+/**
+ * Represents a group of navigation tabs rendered as a dropdown menu.
+ *
+ * @public
+ */
+interface HeaderNavTabGroup {
+    id: string;
+    label: string;
+    items: HeaderNavTab[];
+}
+/**
+ * A navigation tab item — either a flat link or a dropdown group.
+ *
+ * @public
+ */
+type HeaderNavTabItem = HeaderNavTab | HeaderNavTabGroup;
 /**
  * Own props for the Header component.
  *
@@ -1333,7 +1420,8 @@ declare const PluginHeaderDefinition: {
 interface HeaderOwnProps {
     title?: string;
     customActions?: React.ReactNode;
-    tabs?: HeaderTab[];
+    tabs?: HeaderNavTabItem[];
+    activeTabId?: string;
     breadcrumbs?: HeaderBreadcrumb[];
     className?: string;
 }
@@ -1400,6 +1488,7 @@ declare const HeaderDefinition: {
         readonly title: {};
         readonly customActions: {};
         readonly tabs: {};
+        readonly activeTabId: {};
         readonly breadcrumbs: {};
         readonly className: {};
     };
@@ -1423,11 +1512,57 @@ declare const HeaderPageDefinition: {
         readonly title: {};
         readonly customActions: {};
         readonly tabs: {};
+        readonly activeTabId: {};
         readonly breadcrumbs: {};
         readonly className: {};
     };
 };
 
+/** @public */
+declare const HeaderNavDefinition: {
+    readonly styles: {
+        readonly [key: string]: string;
+    };
+    readonly classNames: {
+        readonly root: "bui-HeaderNav";
+        readonly list: "bui-HeaderNavList";
+        readonly active: "bui-HeaderNavActive";
+        readonly hovered: "bui-HeaderNavHovered";
+    };
+    readonly analytics: true;
+    readonly propDefs: {
+        readonly noTrack: {};
+        readonly tabs: {};
+        readonly activeTabId: {};
+        readonly children: {};
+        readonly className: {};
+    };
+};
+/** @public */
+declare const HeaderNavItemDefinition: {
+    readonly styles: {
+        readonly [key: string]: string;
+    };
+    readonly classNames: {
+        readonly root: "bui-HeaderNavItem";
+    };
+    readonly propDefs: {
+        readonly className: {};
+    };
+};
+/** @public */
+declare const HeaderNavGroupDefinition: {
+    readonly styles: {
+        readonly [key: string]: string;
+    };
+    readonly classNames: {
+        readonly root: "bui-HeaderNavGroup";
+    };
+    readonly propDefs: {
+        readonly className: {};
+    };
+};
+
 /** @public */
 type ButtonIconOwnProps = {
     size?: Responsive<'small' | 'medium'>;
@@ -1444,7 +1579,11 @@ type ButtonIconOwnProps = {
 interface ButtonIconProps extends Omit<ButtonProps$1, keyof ButtonIconOwnProps>, ButtonIconOwnProps {
 }
 
-/** @public */
+/**
+ * An icon-only button that supports a loading state and requires an accessible label.
+ *
+ * @public
+ */
 declare const ButtonIcon: react.ForwardRefExoticComponent<ButtonIconProps & react.RefAttributes<HTMLButtonElement>>;
 
 /**
@@ -1496,7 +1635,11 @@ type ButtonLinkOwnProps = {
 interface ButtonLinkProps extends Omit<LinkProps$1, keyof ButtonLinkOwnProps>, ButtonLinkOwnProps {
 }
 
-/** @public */
+/**
+ * A button-styled anchor element for navigation, supporting optional start and end icon slots and analytics event tracking.
+ *
+ * @public
+ */
 declare const ButtonLink: react.ForwardRefExoticComponent<ButtonLinkProps & react.RefAttributes<HTMLAnchorElement>>;
 
 /**
@@ -1540,7 +1683,11 @@ type CheckboxOwnProps = {
 interface CheckboxProps extends Omit<CheckboxProps$1, 'children' | 'className'>, CheckboxOwnProps {
 }
 
-/** @public */
+/**
+ * A form checkbox input with support for indeterminate state and accessible labeling.
+ *
+ * @public
+ */
 declare const Checkbox: react.ForwardRefExoticComponent<CheckboxProps & react.RefAttributes<HTMLLabelElement>>;
 
 /**
@@ -1581,9 +1728,17 @@ type RadioOwnProps = {
 interface RadioProps extends RadioOwnProps, Omit<RadioProps$1, keyof RadioOwnProps> {
 }
 
-/** @public */
+/**
+ * A group of radio buttons for selecting a single option from a set, with an integrated label, description, and error display.
+ *
+ * @public
+ */
 declare const RadioGroup: react.ForwardRefExoticComponent<RadioGroupProps & react.RefAttributes<HTMLDivElement>>;
-/** @public */
+/**
+ * A single radio button for use within a RadioGroup.
+ *
+ * @public
+ */
 declare const Radio: react.ForwardRefExoticComponent<RadioProps & react.RefAttributes<HTMLLabelElement>>;
 
 /**
@@ -1623,6 +1778,54 @@ declare const RadioDefinition: {
     };
 };
 
+/** @public */
+interface SliderOwnProps {
+    className?: string;
+    label?: FieldLabelProps['label'];
+    secondaryLabel?: FieldLabelProps['secondaryLabel'];
+    description?: FieldLabelProps['description'];
+    isRequired?: boolean;
+}
+/** @public */
+interface SliderProps<T extends number | number[]> extends Omit<SliderProps$1<T>, 'children' | 'className'>, SliderOwnProps {
+}
+
+/**
+ * A draggable input for selecting a numeric value or range within a defined interval, with an integrated label and value output.
+ *
+ * @public
+ */
+declare const Slider: (<T extends number | number[]>(props: SliderProps<T> & {
+    ref?: React.ForwardedRef<HTMLDivElement>;
+}) => JSX.Element) & {
+    displayName: string;
+};
+
+/**
+ * Component definition for Slider
+ * @public
+ */
+declare const SliderDefinition: {
+    readonly styles: {
+        readonly [key: string]: string;
+    };
+    readonly classNames: {
+        readonly root: "bui-Slider";
+        readonly header: "bui-SliderHeader";
+        readonly track: "bui-SliderTrack";
+        readonly trackFill: "bui-SliderTrackFill";
+        readonly thumb: "bui-SliderThumb";
+        readonly output: "bui-SliderOutput";
+    };
+    readonly propDefs: {
+        readonly className: {};
+        readonly label: {};
+        readonly secondaryLabel: {};
+        readonly description: {};
+        readonly isRequired: {};
+    };
+};
+
 /** @public */
 interface PageSizeOption {
     label: string;
@@ -1908,37 +2111,76 @@ interface TableProps<T extends TableItem> {
     virtualized?: VirtualizedProp;
 }
 
-/** @public */
+/**
+ * A full-featured data table with built-in pagination, sorting, row selection, loading and error states, and optional virtualization.
+ * Pair with `useTable` to manage data fetching and state, or pass `data`, `columnConfig`, and `pagination` directly for manual control.
+ *
+ * @public
+ */
 declare function Table<T extends TableItem>({ columnConfig, data, loading, isStale, error, pagination, sort, rowConfig, selection, emptyState, className, style, virtualized, }: TableProps<T>): react_jsx_runtime.JSX.Element;
 
-/** @public */
+/**
+ * The low-level table root element for building custom table layouts from atomic components.
+ * For most use cases, prefer the `Table` convenience wrapper.
+ *
+ * @public
+ */
 declare const TableRoot: (props: TableRootProps) => react_jsx_runtime.JSX.Element;
 
-/** @public */
+/**
+ * The header row of a table, rendering column labels and an optional select-all checkbox for toggle selection mode.
+ *
+ * @public
+ */
 declare const TableHeader: <T extends object>(props: TableHeaderProps<T>) => react_jsx_runtime.JSX.Element;
 
-/** @public */
+/**
+ * The body section of a table that renders data rows from the provided items collection.
+ *
+ * @public
+ */
 declare const TableBody: <T extends object>(props: TableBodyProps<T>) => react_jsx_runtime.JSX.Element;
 
-/** @public */
+/**
+ * A table column header cell with an optional sort toggle and support for resizable widths.
+ *
+ * @public
+ */
 declare const Column: (props: ColumnProps) => react_jsx_runtime.JSX.Element;
 
-/** @public */
+/**
+ * A table row that can optionally act as a navigation link or trigger an action when clicked, with analytics tracking.
+ *
+ * @public
+ */
 declare function Row<T extends object>(props: RowProps<T>): react_jsx_runtime.JSX.Element;
 
-/** @public */
+/**
+ * A low-level table cell primitive for building custom cell content.
+ * For standard use cases, prefer `CellText` or `CellProfile`.
+ *
+ * @public
+ */
 declare const Cell: {
     (props: CellProps): react_jsx_runtime.JSX.Element;
     displayName: string;
 };
 
-/** @public */
+/**
+ * A table cell that renders a primary text title with an optional secondary description, leading icon, and link.
+ *
+ * @public
+ */
 declare const CellText: {
     (props: CellTextProps): react_jsx_runtime.JSX.Element;
     displayName: string;
 };
 
-/** @public */
+/**
+ * A table cell that renders an avatar image alongside a name, with an optional description and link.
+ *
+ * @public
+ */
 declare const CellProfile: (props: CellProfileProps) => react_jsx_runtime.JSX.Element;
 
 /** @public */
@@ -2037,7 +2279,12 @@ interface UseTableResult<T extends TableItem, TFilter = unknown> {
     search: SearchState;
 }
 
-/** @public */
+/**
+ * A hook that manages table data fetching, pagination, sorting, search, and filtering.
+ * Supports three modes: `complete` for client-side data, `offset` for server-side offset pagination, and `cursor` for server-side cursor pagination.
+ *
+ * @public
+ */
 declare function useTable<T extends TableItem, TFilter = unknown>(options: UseTableCompleteOptions<T, TFilter>): UseTableResult<T, TFilter>;
 /** @public */
 declare function useTable<T extends TableItem, TFilter = unknown>(options: UseTableOffsetOptions<T, TFilter>): UseTableResult<T, TFilter>;
@@ -2155,7 +2402,11 @@ type TextOwnProps = {
 /** @public */
 type TextProps<T extends ElementType = 'span'> = TextOwnProps & Omit<ComponentPropsWithRef<T>, keyof TextOwnProps>;
 
-/** @public */
+/**
+ * A typographic primitive that renders text with design system variants, weights, and colors, and can render as any HTML element.
+ *
+ * @public
+ */
 declare const Text: {
     <T extends ElementType = "p">(props: TextProps<T> & {
         ref?: React.ComponentPropsWithRef<T>["ref"];
@@ -2229,7 +2480,11 @@ interface TextFieldProps extends Omit<TextFieldProps$1, 'className' | 'descripti
     type?: 'text' | 'email' | 'tel' | 'url';
 }
 
-/** @public */
+/**
+ * A single-line text input with an integrated label, optional icon, and inline error display.
+ *
+ * @public
+ */
 declare const TextField: react.ForwardRefExoticComponent<TextFieldProps & react.RefAttributes<HTMLDivElement>>;
 
 /**
@@ -2286,7 +2541,11 @@ type PasswordFieldOwnProps = {
 interface PasswordFieldProps extends Omit<TextFieldProps$1, 'className' | 'description'>, PasswordFieldOwnProps {
 }
 
-/** @public */
+/**
+ * A text input for password entry with a toggleable visibility button, integrated label, and inline error display.
+ *
+ * @public
+ */
 declare const PasswordField: react.ForwardRefExoticComponent<PasswordFieldProps & react.RefAttributes<HTMLDivElement>>;
 
 /**
@@ -2327,9 +2586,17 @@ type TooltipOwnProps = {
 interface TooltipProps extends Omit<TooltipProps$1, 'children' | 'className'>, TooltipOwnProps {
 }
 
-/** @public */
+/**
+ * A wrapper that connects a trigger element to a Tooltip, controlling its show and hide behavior with a configurable delay.
+ *
+ * @public
+ */
 declare const TooltipTrigger: (props: TooltipTriggerComponentProps) => react_jsx_runtime.JSX.Element;
-/** @public */
+/**
+ * A floating label that provides contextual information about an element when it receives hover or focus.
+ *
+ * @public
+ */
 declare const Tooltip: react.ForwardRefExoticComponent<TooltipProps & react.RefAttributes<HTMLDivElement>>;
 
 /**
@@ -2434,7 +2701,11 @@ type MenuSeparatorOwnProps = {
 interface MenuSeparatorProps extends MenuSeparatorOwnProps, Omit<SeparatorProps, keyof MenuSeparatorOwnProps> {
 }
 
-/** @public */
+/**
+ * A wrapper that connects a trigger element to a dropdown menu, controlling its open and close state.
+ *
+ * @public
+ */
 declare const MenuTrigger: (props: MenuTriggerProps) => react_jsx_runtime.JSX.Element;
 /** @public */
 declare const SubmenuTrigger: (props: SubmenuTriggerProps) => react_jsx_runtime.JSX.Element;
@@ -2628,9 +2899,17 @@ type SearchAutocompleteItemOwnProps = {
 interface SearchAutocompleteItemProps extends SearchAutocompleteItemOwnProps, Omit<ListBoxItemProps, keyof SearchAutocompleteItemOwnProps> {
 }
 
-/** @public */
+/**
+ * A search input that shows a dropdown list of suggestions as the user types, with loading and empty states.
+ *
+ * @public
+ */
 declare function SearchAutocomplete(props: SearchAutocompleteProps): react_jsx_runtime.JSX.Element;
-/** @public */
+/**
+ * An individual option item within a SearchAutocomplete dropdown.
+ *
+ * @public
+ */
 declare function SearchAutocompleteItem(props: SearchAutocompleteItemProps): react_jsx_runtime.JSX.Element;
 
 /**
@@ -2703,7 +2982,11 @@ type SearchFieldOwnProps = {
 interface SearchFieldProps extends Omit<SearchFieldProps$1, 'className' | 'description'>, SearchFieldOwnProps {
 }
 
-/** @public */
+/**
+ * A text input optimized for search queries, with a built-in clear button, optional icon, and support for a collapsible mode.
+ *
+ * @public
+ */
 declare const SearchField: react.ForwardRefExoticComponent<SearchFieldProps & react.RefAttributes<HTMLDivElement>>;
 
 /**
@@ -2758,7 +3041,11 @@ type LinkOwnProps = {
 interface LinkProps extends Omit<LinkProps$1, 'children' | 'className'>, LinkOwnProps {
 }
 
-/** @public */
+/**
+ * A styled anchor element that supports analytics event tracking on click.
+ *
+ * @public
+ */
 declare const Link: react.ForwardRefExoticComponent<LinkProps & react.RefAttributes<HTMLAnchorElement>>;
 
 /**
@@ -2964,7 +3251,11 @@ interface SelectProps<T extends 'single' | 'multiple'> extends SelectOwnProps, O
     selectionMode?: T;
 }
 
-/** @public */
+/**
+ * A dropdown picker for selecting one or multiple options from a list, with optional search filtering and inline error display.
+ *
+ * @public
+ */
 declare const Select: react.ForwardRefExoticComponent<SelectProps<"multiple" | "single"> & react.RefAttributes<HTMLDivElement>>;
 
 /**
@@ -3008,7 +3299,11 @@ type SkeletonOwnProps = {
 interface SkeletonProps extends Omit<ComponentProps<'div'>, 'children' | 'className' | 'style'>, SkeletonOwnProps {
 }
 
-/** @public */
+/**
+ * A placeholder shape displayed while content is loading, matching the size and layout of the content it replaces.
+ *
+ * @public
+ */
 declare const Skeleton: (props: SkeletonProps) => react_jsx_runtime.JSX.Element;
 
 /**
@@ -3050,7 +3345,11 @@ type SwitchOwnProps = {
 interface SwitchProps extends Omit<SwitchProps$1, 'className'>, SwitchOwnProps {
 }
 
-/** @public */
+/**
+ * A toggle control for switching between on and off states, with an optional visible label.
+ *
+ * @public
+ */
 declare const Switch: react.ForwardRefExoticComponent<SwitchProps & react.RefAttributes<HTMLLabelElement>>;
 
 /**
@@ -3087,7 +3386,11 @@ type ToggleButtonOwnProps = {
 interface ToggleButtonProps extends Omit<ToggleButtonProps$1, 'children' | 'className'>, ToggleButtonOwnProps {
 }
 
-/** @public */
+/**
+ * A button that maintains a pressed or unpressed state, with optional start and end icon slots.
+ *
+ * @public
+ */
 declare const ToggleButton: react.ForwardRefExoticComponent<ToggleButtonProps & react.RefAttributes<HTMLButtonElement>>;
 
 /**
@@ -3123,7 +3426,11 @@ type ToggleButtonGroupOwnProps = {
 interface ToggleButtonGroupProps extends Omit<ToggleButtonGroupProps$1, 'className' | 'children'>, ToggleButtonGroupOwnProps {
 }
 
-/** @public */
+/**
+ * A container that groups ToggleButton items and manages their collective selection state.
+ *
+ * @public
+ */
 declare const ToggleButtonGroup: react.ForwardRefExoticComponent<ToggleButtonGroupProps & react.RefAttributes<HTMLDivElement>>;
 
 /**
@@ -3316,5 +3623,5 @@ declare function useAnalytics(): AnalyticsTracker;
  */
 declare function getNodeText(node: ReactNode | ((...args: any[]) => ReactNode)): string | undefined;
 
-export { Accordion, AccordionDefinition, AccordionGroup, AccordionGroupDefinition, AccordionPanel, AccordionPanelDefinition, AccordionTrigger, AccordionTriggerDefinition, Alert, AlertDefinition, Avatar, AvatarDefinition, BUIProvider, BgProvider, Box, BoxDefinition, Button, ButtonDefinition, ButtonIcon, ButtonIconDefinition, ButtonLink, ButtonLinkDefinition, Card, CardBody, CardBodyDefinition, CardDefinition, CardFooter, CardFooterDefinition, CardHeader, CardHeaderDefinition, Cell, CellProfile, CellText, Checkbox, CheckboxDefinition, Column, Container, ContainerDefinition, Dialog, DialogBody, DialogBodyDefinition, DialogDefinition, DialogFooter, DialogFooterDefinition, DialogHeader, DialogHeaderDefinition, DialogTrigger, FieldLabel, FieldLabelDefinition, Flex, FlexDefinition, FullPage, FullPageDefinition, Grid, GridDefinition, GridItemDefinition, Header, HeaderDefinition, HeaderPage, HeaderPageDefinition, Link, LinkDefinition, List, ListDefinition, ListRow, ListRowDefinition, Menu, MenuAutocomplete, MenuAutocompleteListbox, MenuDefinition, MenuItem, MenuListBox, MenuListBoxItem, MenuSection, MenuSeparator, MenuTrigger, PasswordField, PasswordFieldDefinition, PluginHeader, PluginHeaderDefinition, Popover, PopoverDefinition, Radio, RadioDefinition, RadioGroup, RadioGroupDefinition, Row, SearchAutocomplete, SearchAutocompleteDefinition, SearchAutocompleteItem, SearchField, SearchFieldDefinition, Select, SelectDefinition, Skeleton, SkeletonDefinition, SubmenuTrigger, Switch, SwitchDefinition, Tab, TabList, TabPanel, Table, TableBody, TableDefinition, TableHeader, TablePagination, TablePaginationDefinition, TableRoot, Tabs, TabsDefinition, Tag, TagGroup, TagGroupDefinition, Text, TextDefinition, TextField, TextFieldDefinition, ToggleButton, ToggleButtonDefinition, ToggleButtonGroup, ToggleButtonGroupDefinition, Tooltip, TooltipDefinition, TooltipTrigger, VisuallyHidden, VisuallyHiddenDefinition, getNodeText, useAnalytics, useBgConsumer, useBgProvider, useBreakpoint, useTable };
-export type { AccordionGroupOwnProps, AccordionGroupProps, AccordionOwnProps, AccordionPanelOwnProps, AccordionPanelProps, AccordionProps, AccordionTriggerOwnProps, AccordionTriggerProps, AlertOwnProps, AlertProps, AlignItems, AnalyticsEventAttributes, AnalyticsTracker, AvatarOwnProps, AvatarProps, BUIProviderProps, BgContextValue, BgProviderProps, Border, BorderRadius, BoxOwnProps, BoxProps, BoxUtilityProps, Breakpoint, ButtonIconOwnProps, ButtonIconProps, ButtonLinkOwnProps, ButtonLinkProps, ButtonOwnProps, ButtonProps, CardBaseProps, CardBodyOwnProps, CardBodyProps, CardButtonVariant, CardFooterOwnProps, CardFooterProps, CardHeaderOwnProps, CardHeaderProps, CardLinkVariant, CardOwnProps, CardProps, CardStaticVariant, CellOwnProps, CellProfileOwnProps, CellProfileProps, CellProps, CellTextOwnProps, CellTextProps, CheckboxOwnProps, CheckboxProps, ColumnConfig, ColumnOwnProps, ColumnProps, Columns, CompletePaginationOptions, ContainerBg, ContainerOwnProps, ContainerProps, CursorParams, CursorResponse, DialogBodyOwnProps, DialogBodyProps, DialogFooterOwnProps, DialogFooterProps, DialogHeaderOwnProps, DialogHeaderProps, DialogOwnProps, DialogProps, DialogTriggerProps, Display, FieldLabelOwnProps, FieldLabelProps, FilterState, FlexDirection, FlexOwnProps, FlexProps, FlexWrap, FullPageOwnProps, FullPageProps, GridItemOwnProps, GridItemProps, GridOwnProps, GridProps, HeaderBreadcrumb, HeaderOwnProps, HeaderPageBreadcrumb, HeaderPageOwnProps, HeaderPageProps, HeaderProps, HeaderTab, JustifyContent, LinkOwnProps, LinkProps, ListOwnProps, ListProps, ListRowOwnProps, ListRowProps, MarginProps, MenuAutocompleteListBoxOwnProps, MenuAutocompleteListBoxProps, MenuAutocompleteOwnProps, MenuAutocompleteProps, MenuItemOwnProps, MenuItemProps, MenuListBoxItemOwnProps, MenuListBoxItemProps, MenuListBoxOwnProps, MenuListBoxProps, MenuOwnProps, MenuPopoverOwnProps, MenuProps, MenuSectionOwnProps, MenuSectionProps, MenuSeparatorOwnProps, MenuSeparatorProps, MenuTriggerProps, NoPagination, OffsetParams, OffsetResponse, Option, PaddingProps, PagePagination, PageSizeOption, PaginationOptions, PasswordFieldOwnProps, PasswordFieldProps, PluginHeaderOwnProps, PluginHeaderProps, PopoverOwnProps, PopoverProps, ProviderBg, QueryOptions, RadioGroupOwnProps, RadioGroupProps, RadioOwnProps, RadioProps, Responsive, RowConfig, RowOwnProps, RowProps, RowRenderFn, SearchAutocompleteItemOwnProps, SearchAutocompleteItemProps, SearchAutocompleteOwnProps, SearchAutocompleteProps, SearchFieldOwnProps, SearchFieldProps, SearchState, SelectOwnProps, SelectProps, SkeletonOwnProps, SkeletonProps, SortDescriptor, SortState, Space, SpaceProps, SubmenuTriggerProps, SwitchOwnProps, SwitchProps, TabListOwnProps, TabListProps, TabMatchStrategy, TabOwnProps, TabPanelOwnProps, TabPanelProps, TabProps, TableBodyOwnProps, TableBodyProps, TableHeaderOwnProps, TableHeaderProps, TableItem, TablePaginationOwnProps, TablePaginationProps, TablePaginationType, TableProps, TableRootOwnProps, TableRootProps, TableSelection, TabsOwnProps, TabsProps, TagGroupOwnProps, TagGroupProps, TagOwnProps, TagProps, TextColorStatus, TextColors, TextFieldOwnProps, TextFieldProps, TextOwnProps, TextProps, TextVariants, TextWeights, ToggleButtonGroupOwnProps, ToggleButtonGroupProps, ToggleButtonOwnProps, ToggleButtonProps, TooltipOwnProps, TooltipProps, UseAnalyticsFn, UseTableCompleteOptions, UseTableCursorOptions, UseTableOffsetOptions, UseTableOptions, UseTableResult, UtilityProps, VirtualizedProp, VisuallyHiddenOwnProps, VisuallyHiddenProps };
+export { Accordion, AccordionDefinition, AccordionGroup, AccordionGroupDefinition, AccordionPanel, AccordionPanelDefinition, AccordionTrigger, AccordionTriggerDefinition, Alert, AlertDefinition, Avatar, AvatarDefinition, BUIProvider, BgProvider, Box, BoxDefinition, Button, ButtonDefinition, ButtonIcon, ButtonIconDefinition, ButtonLink, ButtonLinkDefinition, Card, CardBody, CardBodyDefinition, CardDefinition, CardFooter, CardFooterDefinition, CardHeader, CardHeaderDefinition, Cell, CellProfile, CellText, Checkbox, CheckboxDefinition, Column, Container, ContainerDefinition, Dialog, DialogBody, DialogBodyDefinition, DialogDefinition, DialogFooter, DialogFooterDefinition, DialogHeader, DialogHeaderDefinition, DialogTrigger, FieldLabel, FieldLabelDefinition, Flex, FlexDefinition, FullPage, FullPageDefinition, Grid, GridDefinition, GridItemDefinition, Header, HeaderDefinition, HeaderNavDefinition, HeaderNavGroupDefinition, HeaderNavItemDefinition, HeaderPage, HeaderPageDefinition, Link, LinkDefinition, List, ListDefinition, ListRow, ListRowDefinition, Menu, MenuAutocomplete, MenuAutocompleteListbox, MenuDefinition, MenuItem, MenuListBox, MenuListBoxItem, MenuSection, MenuSeparator, MenuTrigger, PasswordField, PasswordFieldDefinition, PluginHeader, PluginHeaderDefinition, Popover, PopoverDefinition, Radio, RadioDefinition, RadioGroup, RadioGroupDefinition, Row, SearchAutocomplete, SearchAutocompleteDefinition, SearchAutocompleteItem, SearchField, SearchFieldDefinition, Select, SelectDefinition, Skeleton, SkeletonDefinition, Slider, SliderDefinition, SubmenuTrigger, Switch, SwitchDefinition, Tab, TabList, TabPanel, Table, TableBody, TableDefinition, TableHeader, TablePagination, TablePaginationDefinition, TableRoot, Tabs, TabsDefinition, Tag, TagGroup, TagGroupDefinition, Text, TextDefinition, TextField, TextFieldDefinition, ToggleButton, ToggleButtonDefinition, ToggleButtonGroup, ToggleButtonGroupDefinition, Tooltip, TooltipDefinition, TooltipTrigger, VisuallyHidden, VisuallyHiddenDefinition, getNodeText, useAnalytics, useBgConsumer, useBgProvider, useBreakpoint, useTable };
+export type { AccordionGroupOwnProps, AccordionGroupProps, AccordionOwnProps, AccordionPanelOwnProps, AccordionPanelProps, AccordionProps, AccordionTriggerOwnProps, AccordionTriggerProps, AlertOwnProps, AlertProps, AlignItems, AnalyticsEventAttributes, AnalyticsTracker, AvatarOwnProps, AvatarProps, BUIProviderProps, BgContextValue, BgProviderProps, Border, BorderRadius, BoxOwnProps, BoxProps, BoxUtilityProps, Breakpoint, ButtonIconOwnProps, ButtonIconProps, ButtonLinkOwnProps, ButtonLinkProps, ButtonOwnProps, ButtonProps, CardBaseProps, CardBodyOwnProps, CardBodyProps, CardButtonVariant, CardFooterOwnProps, CardFooterProps, CardHeaderOwnProps, CardHeaderProps, CardLinkVariant, CardOwnProps, CardProps, CardStaticVariant, CellOwnProps, CellProfileOwnProps, CellProfileProps, CellProps, CellTextOwnProps, CellTextProps, CheckboxOwnProps, CheckboxProps, ColumnConfig, ColumnOwnProps, ColumnProps, Columns, CompletePaginationOptions, ContainerBg, ContainerOwnProps, ContainerProps, CursorParams, CursorResponse, DialogBodyOwnProps, DialogBodyProps, DialogFooterOwnProps, DialogFooterProps, DialogHeaderOwnProps, DialogHeaderProps, DialogOwnProps, DialogProps, DialogTriggerProps, Display, FieldLabelOwnProps, FieldLabelProps, FilterState, FlexDirection, FlexOwnProps, FlexProps, FlexWrap, FullPageOwnProps, FullPageProps, GridItemOwnProps, GridItemProps, GridOwnProps, GridProps, HeaderBreadcrumb, HeaderNavTab, HeaderNavTabGroup, HeaderNavTabItem, HeaderOwnProps, HeaderPageBreadcrumb, HeaderPageOwnProps, HeaderPageProps, HeaderProps, HeaderTab, JustifyContent, LinkOwnProps, LinkProps, ListOwnProps, ListProps, ListRowOwnProps, ListRowProps, MarginProps, MenuAutocompleteListBoxOwnProps, MenuAutocompleteListBoxProps, MenuAutocompleteOwnProps, MenuAutocompleteProps, MenuItemOwnProps, MenuItemProps, MenuListBoxItemOwnProps, MenuListBoxItemProps, MenuListBoxOwnProps, MenuListBoxProps, MenuOwnProps, MenuPopoverOwnProps, MenuProps, MenuSectionOwnProps, MenuSectionProps, MenuSeparatorOwnProps, MenuSeparatorProps, MenuTriggerProps, NoPagination, OffsetParams, OffsetResponse, Option, PaddingProps, PagePagination, PageSizeOption, PaginationOptions, PasswordFieldOwnProps, PasswordFieldProps, PluginHeaderOwnProps, PluginHeaderProps, PopoverOwnProps, PopoverProps, ProviderBg, QueryOptions, RadioGroupOwnProps, RadioGroupProps, RadioOwnProps, RadioProps, Responsive, RowConfig, RowOwnProps, RowProps, RowRenderFn, SearchAutocompleteItemOwnProps, SearchAutocompleteItemProps, SearchAutocompleteOwnProps, SearchAutocompleteProps, SearchFieldOwnProps, SearchFieldProps, SearchState, SelectOwnProps, SelectProps, SkeletonOwnProps, SkeletonProps, SliderOwnProps, SliderProps, SortDescriptor, SortState, Space, SpaceProps, SubmenuTriggerProps, SwitchOwnProps, SwitchProps, TabListOwnProps, TabListProps, TabMatchStrategy, TabOwnProps, TabPanelOwnProps, TabPanelProps, TabProps, TableBodyOwnProps, TableBodyProps, TableHeaderOwnProps, TableHeaderProps, TableItem, TablePaginationOwnProps, TablePaginationProps, TablePaginationType, TableProps, TableRootOwnProps, TableRootProps, TableSelection, TabsOwnProps, TabsProps, TagGroupOwnProps, TagGroupProps, TagOwnProps, TagProps, TextColorStatus, TextColors, TextFieldOwnProps, TextFieldProps, TextOwnProps, TextProps, TextVariants, TextWeights, ToggleButtonGroupOwnProps, ToggleButtonGroupProps, ToggleButtonOwnProps, ToggleButtonProps, TooltipOwnProps, TooltipProps, UseAnalyticsFn, UseTableCompleteOptions, UseTableCursorOptions, UseTableOffsetOptions, UseTableOptions, UseTableResult, UtilityProps, VirtualizedProp, VisuallyHiddenOwnProps, VisuallyHiddenProps };