@backstage/ui 0.13.0-next.1 → 0.13.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
-import { ReactNode, CSSProperties, 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, SelectProps as SelectProps$1, SwitchProps as SwitchProps$1, ToggleButtonProps as ToggleButtonProps$1, ToggleButtonGroupProps as ToggleButtonGroupProps$1 } from 'react-aria-components';
+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 * as react_jsx_runtime from 'react/jsx-runtime';
 import { NavigateOptions } from 'react-router-dom';
 import { SortDescriptor as SortDescriptor$1 } from 'react-stately';
@@ -163,7 +163,7 @@ type GridOwnProps = {
     bg?: Responsive<ProviderBg>;
 };
 /** @public */
-interface GridProps extends SpaceProps, GridOwnProps {
+interface GridProps extends SpaceProps, GridOwnProps, Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
     columns?: Responsive<Columns>;
     gap?: Responsive<Space>;
 }
@@ -175,7 +175,7 @@ type GridItemOwnProps = {
     bg?: Responsive<ProviderBg>;
 };
 /** @public */
-interface GridItemProps extends GridItemOwnProps {
+interface GridItemProps extends GridItemOwnProps, Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
     colSpan?: Responsive<Columns>;
     colEnd?: Responsive<Columns>;
     colStart?: Responsive<Columns>;
@@ -241,7 +241,7 @@ type FlexOwnProps = {
     bg?: Responsive<ProviderBg>;
 };
 /** @public */
-interface FlexProps extends SpaceProps, FlexOwnProps {
+interface FlexProps extends SpaceProps, FlexOwnProps, Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {
     gap?: Responsive<Space>;
     align?: Responsive<'start' | 'center' | 'end' | 'baseline' | 'stretch'>;
     justify?: Responsive<'start' | 'center' | 'end' | 'between'>;
@@ -749,17 +749,56 @@ declare const ButtonDefinition: {
 };
 
 /** @public */
-type CardOwnProps = {
+type CardBaseProps = {
     children?: ReactNode;
     className?: string;
 };
+/** @public */
+type CardButtonVariant = {
+    /** Handler called when the card is pressed. Makes the card interactive as a button. */
+    onPress: NonNullable<ButtonProps$1['onPress']>;
+    href?: never;
+    /** Accessible label announced by screen readers for the interactive card. */
+    label: string;
+    target?: never;
+    rel?: never;
+    download?: never;
+};
+/** @public */
+type CardLinkVariant = {
+    /** URL to navigate to. Makes the card interactive as a link. */
+    href: string;
+    onPress?: never;
+    /** Accessible label announced by screen readers for the interactive card. */
+    label: string;
+    /** Specifies where to open the linked URL (e.g. `_blank` for a new tab). */
+    target?: string;
+    /** Relationship between the current document and the linked URL (e.g. `noopener`). */
+    rel?: string;
+    /** Prompts the user to save the linked URL. Pass `true` for default filename or a string for a custom filename. */
+    download?: boolean | string;
+};
+/** @public */
+type CardStaticVariant = {
+    onPress?: never;
+    href?: never;
+    label?: never;
+    target?: never;
+    rel?: never;
+    download?: never;
+};
 /**
  * Props for the Card component.
  *
  * @public
  */
-interface CardProps extends CardOwnProps, React.HTMLAttributes<HTMLDivElement> {
-}
+type CardProps = CardBaseProps & Omit<React.HTMLAttributes<HTMLDivElement>, 'onClick'> & (CardButtonVariant | CardLinkVariant | CardStaticVariant);
+/**
+ * Flat own-props shape used by the component definition system.
+ * Derived from the Card variant types so it automatically stays in sync with CardProps.
+ * @public
+ */
+type CardOwnProps = Pick<CardBaseProps & (CardButtonVariant | CardLinkVariant | CardStaticVariant), 'children' | 'className' | 'onPress' | 'href' | 'label' | 'target' | 'rel' | 'download'>;
 /** @public */
 type CardHeaderOwnProps = {
     children?: ReactNode;
@@ -832,10 +871,17 @@ declare const CardDefinition: {
     };
     readonly classNames: {
         readonly root: "bui-Card";
+        readonly trigger: "bui-CardTrigger";
     };
     readonly propDefs: {
         readonly children: {};
         readonly className: {};
+        readonly onPress: {};
+        readonly href: {};
+        readonly label: {};
+        readonly target: {};
+        readonly rel: {};
+        readonly download: {};
     };
 };
 /**
@@ -1131,6 +1177,7 @@ type TabOwnProps = {
     matchStrategy?: TabMatchStrategy;
     href?: TabProps$1['href'];
     id?: TabProps$1['id'];
+    noTrack?: boolean;
 };
 /**
  * Props for the Tab component.
@@ -1278,55 +1325,98 @@ declare const PluginHeaderDefinition: {
 };
 
 /**
- * Own props for the HeaderPage component.
+ * Own props for the Header component.
  *
  * @public
  */
-interface HeaderPageOwnProps {
+interface HeaderOwnProps {
     title?: string;
     customActions?: React.ReactNode;
     tabs?: HeaderTab[];
-    breadcrumbs?: HeaderPageBreadcrumb[];
+    breadcrumbs?: HeaderBreadcrumb[];
     className?: string;
 }
 /**
- * Props for the main HeaderPage component.
+ * Props for the Header component.
  *
  * @public
  */
-interface HeaderPageProps extends HeaderPageOwnProps {
+interface HeaderProps extends HeaderOwnProps {
 }
 /**
  * Represents a breadcrumb item in the header.
  *
  * @public
  */
-interface HeaderPageBreadcrumb {
+interface HeaderBreadcrumb {
     label: string;
     href: string;
 }
+/**
+ * @public
+ * @deprecated Use {@link HeaderOwnProps} instead.
+ */
+type HeaderPageOwnProps = HeaderOwnProps;
+/**
+ * @public
+ * @deprecated Use {@link HeaderProps} instead.
+ */
+type HeaderPageProps = HeaderProps;
+/**
+ * @public
+ * @deprecated Use {@link HeaderBreadcrumb} instead.
+ */
+type HeaderPageBreadcrumb = HeaderBreadcrumb;
 
 /**
- * A component that renders a header page.
+ * A secondary header with title, breadcrumbs, tabs, and actions.
  *
  * @public
  */
-declare const HeaderPage: (props: HeaderPageProps) => react_jsx_runtime.JSX.Element;
+declare const Header: (props: HeaderProps) => react_jsx_runtime.JSX.Element;
+/**
+ * @public
+ * @deprecated Use {@link Header} instead.
+ */
+declare const HeaderPage: (props: HeaderProps) => react_jsx_runtime.JSX.Element;
 
 /**
- * Component definition for HeaderPage
+ * Component definition for Header
  * @public
  */
+declare const HeaderDefinition: {
+    readonly styles: {
+        readonly [key: string]: string;
+    };
+    readonly classNames: {
+        readonly root: "bui-Header";
+        readonly content: "bui-HeaderContent";
+        readonly breadcrumbs: "bui-HeaderBreadcrumbs";
+        readonly tabsWrapper: "bui-HeaderTabsWrapper";
+        readonly controls: "bui-HeaderControls";
+    };
+    readonly propDefs: {
+        readonly title: {};
+        readonly customActions: {};
+        readonly tabs: {};
+        readonly breadcrumbs: {};
+        readonly className: {};
+    };
+};
+/**
+ * @public
+ * @deprecated Use {@link HeaderDefinition} instead.
+ */
 declare const HeaderPageDefinition: {
     readonly styles: {
         readonly [key: string]: string;
     };
     readonly classNames: {
-        readonly root: "bui-HeaderPage";
-        readonly content: "bui-HeaderPageContent";
-        readonly breadcrumbs: "bui-HeaderPageBreadcrumbs";
-        readonly tabsWrapper: "bui-HeaderPageTabsWrapper";
-        readonly controls: "bui-HeaderPageControls";
+        readonly root: "bui-Header";
+        readonly content: "bui-HeaderContent";
+        readonly breadcrumbs: "bui-HeaderBreadcrumbs";
+        readonly tabsWrapper: "bui-HeaderTabsWrapper";
+        readonly controls: "bui-HeaderControls";
     };
     readonly propDefs: {
         readonly title: {};
@@ -1389,6 +1479,7 @@ declare const ButtonIconDefinition: {
 
 /** @public */
 type ButtonLinkOwnProps = {
+    noTrack?: boolean;
     size?: Responsive<'small' | 'medium'>;
     variant?: Responsive<'primary' | 'secondary' | 'tertiary'>;
     iconStart?: ReactElement;
@@ -1420,7 +1511,9 @@ declare const ButtonLinkDefinition: {
         readonly content: "bui-ButtonLinkContent";
     };
     readonly bg: "consumer";
+    readonly analytics: true;
     readonly propDefs: {
+        readonly noTrack: {};
         readonly size: {
             readonly dataAttribute: true;
             readonly default: "small";
@@ -1438,9 +1531,7 @@ declare const ButtonLinkDefinition: {
 
 /** @public */
 type CheckboxOwnProps = {
-    selected?: boolean;
-    indeterminate?: boolean;
-    children: React.ReactNode;
+    children?: React.ReactNode;
     className?: string;
 };
 /** @public */
@@ -1463,12 +1554,6 @@ declare const CheckboxDefinition: {
         readonly indicator: "bui-CheckboxIndicator";
     };
     readonly propDefs: {
-        readonly selected: {
-            readonly dataAttribute: true;
-        };
-        readonly indeterminate: {
-            readonly dataAttribute: true;
-        };
         readonly children: {};
         readonly className: {};
     };
@@ -1615,6 +1700,7 @@ interface SortState {
 /** @public */
 type TableRootOwnProps = {
     stale?: boolean;
+    loading?: boolean;
 };
 /** @public */
 interface TableRootProps extends TableRootOwnProps, Omit<TableProps$1, keyof TableRootOwnProps> {
@@ -1637,6 +1723,7 @@ type RowOwnProps<T = object> = {
     columns?: RowProps$1<T>['columns'];
     children?: RowProps$1<T>['children'];
     href?: string;
+    noTrack?: boolean;
 };
 /** @public */
 interface RowProps<T> extends RowOwnProps<T>, Omit<RowProps$1<T>, keyof RowOwnProps> {
@@ -1649,14 +1736,32 @@ type ColumnOwnProps = {
 /** @public */
 interface ColumnProps extends ColumnOwnProps, Omit<ColumnProps$1, keyof ColumnOwnProps> {
 }
-/** @public */
+/**
+ * Own props for the {@link Cell} component.
+ *
+ * @public
+ */
 type CellOwnProps = {
     className?: string;
 };
-/** @public */
+/**
+ * Props for the {@link Cell} component.
+ *
+ * `Cell` is a generic cell wrapper for custom cell content. When rendering
+ * cells via {@link ColumnConfig.cell} or a custom {@link RowRenderFn}, the
+ * returned element **must** be a cell component (`Cell`, `CellText`, or
+ * `CellProfile`) at the top level. Returning bare text or other elements
+ * without a cell wrapper will break the table layout.
+ *
+ * @public
+ */
 interface CellProps extends CellOwnProps, Omit<CellProps$1, keyof CellOwnProps> {
 }
-/** @public */
+/**
+ * Own props for the {@link CellText} component.
+ *
+ * @public
+ */
 type CellTextOwnProps = {
     title: string;
     description?: string;
@@ -1665,10 +1770,23 @@ type CellTextOwnProps = {
     href?: string;
     className?: string;
 };
-/** @public */
+/**
+ * Props for the {@link CellText} component.
+ *
+ * `CellText` renders a table cell with a title and optional description. It
+ * is one of the cell components (`Cell`, `CellText`, `CellProfile`) that
+ * **must** be used as the top-level element returned from
+ * {@link ColumnConfig.cell} or a custom {@link RowRenderFn}.
+ *
+ * @public
+ */
 interface CellTextProps extends CellTextOwnProps, Omit<CellProps$1, keyof CellTextOwnProps> {
 }
-/** @public */
+/**
+ * Own props for the {@link CellProfile} component.
+ *
+ * @public
+ */
 type CellProfileOwnProps = {
     src?: string;
     name?: string;
@@ -1677,7 +1795,16 @@ type CellProfileOwnProps = {
     color?: TextColors;
     className?: string;
 };
-/** @public */
+/**
+ * Props for the {@link CellProfile} component.
+ *
+ * `CellProfile` renders a table cell with an avatar, name, and optional
+ * description. It is one of the cell components (`Cell`, `CellText`,
+ * `CellProfile`) that **must** be used as the top-level element returned
+ * from {@link ColumnConfig.cell} or a custom {@link RowRenderFn}.
+ *
+ * @public
+ */
 interface CellProfileProps extends CellProfileOwnProps, Omit<CellProps$1, keyof CellProfileOwnProps> {
 }
 /** @public */
@@ -1694,10 +1821,27 @@ interface PagePagination extends TablePaginationProps {
 }
 /** @public */
 type TablePaginationType = NoPagination | PagePagination;
-/** @public */
+/**
+ * Configuration for a single table column.
+ *
+ * @public
+ */
 interface ColumnConfig<T extends TableItem> {
     id: string;
     label: string;
+    /**
+     * Renders the cell content for this column.
+     *
+     * **Important:** The returned element **must** be a cell component at the
+     * top level — either `Cell`, `CellText`, or `CellProfile`. Returning bare
+     * text, fragments, or other elements without a cell wrapper will break the
+     * table layout.
+     *
+     * @example
+     * ```tsx
+     * cell: item => <CellText title={item.name} />
+     * ```
+     */
     cell: (item: T) => ReactElement;
     header?: () => ReactElement;
     isSortable?: boolean;
@@ -1714,7 +1858,16 @@ interface RowConfig<T extends TableItem> {
     onClick?: (item: T) => void;
     getIsDisabled?: (item: T) => boolean;
 }
-/** @public */
+/**
+ * Custom render function for table rows.
+ *
+ * When using a custom row render function, each cell rendered inside the row
+ * **must** use a cell component (`Cell`, `CellText`, or `CellProfile`) as
+ * the top-level element. Returning bare text or other elements without a
+ * cell wrapper will break the table layout.
+ *
+ * @public
+ */
 type RowRenderFn<T extends TableItem> = (params: {
     item: T;
     index: number;
@@ -1727,6 +1880,12 @@ interface TableSelection {
     onSelectionChange?: TableProps$1['onSelectionChange'];
 }
 /** @public */
+type VirtualizedProp = boolean | {
+    rowHeight: number;
+} | {
+    estimatedRowHeight: number;
+};
+/** @public */
 interface TableProps<T extends TableItem> {
     columnConfig: readonly ColumnConfig<T>[];
     data: T[] | undefined;
@@ -1740,10 +1899,11 @@ interface TableProps<T extends TableItem> {
     emptyState?: ReactNode;
     className?: string;
     style?: React.CSSProperties;
+    virtualized?: VirtualizedProp;
 }
 
 /** @public */
-declare function Table<T extends TableItem>({ columnConfig, data, loading, isStale, error, pagination, sort, rowConfig, selection, emptyState, className, style, }: TableProps<T>): react_jsx_runtime.JSX.Element;
+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 */
 declare const TableRoot: (props: TableRootProps) => react_jsx_runtime.JSX.Element;
@@ -1885,6 +2045,9 @@ declare const TableDefinition: {
         readonly stale: {
             readonly dataAttribute: true;
         };
+        readonly loading: {
+            readonly dataAttribute: true;
+        };
     };
 };
 
@@ -1923,6 +2086,7 @@ type TagOwnProps = {
     href?: TagProps$1['href'];
     children?: TagProps$1['children'];
     className?: string;
+    noTrack?: boolean;
 };
 /**
  * Props for the Tag component.
@@ -2069,6 +2233,7 @@ declare const TextFieldDefinition: {
         readonly inputIcon: "bui-InputIcon";
         readonly inputAction: "bui-InputAction";
     };
+    readonly bg: "consumer";
     readonly propDefs: {
         readonly size: {
             readonly dataAttribute: true;
@@ -2224,6 +2389,7 @@ type MenuItemOwnProps = {
     children: React.ReactNode;
     color?: 'primary' | 'danger';
     href?: MenuItemProps$1['href'];
+    noTrack?: boolean;
     className?: string;
 };
 /** @public */
@@ -2383,6 +2549,117 @@ declare const PopoverDefinition: {
     };
 };
 
+/** @public */
+type SearchAutocompleteOwnProps = {
+    /**
+     * The current value of the search input (controlled).
+     */
+    inputValue?: string;
+    /**
+     * Handler called when the search input value changes.
+     */
+    onInputChange?: (value: string) => void;
+    /**
+     * The size of the search input.
+     * @defaultValue 'small'
+     */
+    size?: 'small' | 'medium' | Partial<Record<Breakpoint, 'small' | 'medium'>>;
+    /**
+     * Accessible label for the search input.
+     */
+    'aria-label'?: string;
+    /**
+     * ID of the element that labels the search input.
+     */
+    'aria-labelledby'?: string;
+    /**
+     * The placeholder text for the search input.
+     */
+    placeholder?: string;
+    /**
+     * Width of the results popover. Accepts any CSS width value.
+     * When not set, the popover matches the input width.
+     */
+    popoverWidth?: string;
+    /**
+     * Placement of the results popover relative to the input.
+     * @defaultValue 'bottom start'
+     */
+    popoverPlacement?: PopoverProps$1['placement'];
+    /**
+     * The result items to render inside the autocomplete.
+     */
+    children?: ReactNode;
+    /**
+     * Whether results are currently loading.
+     * When true, displays a loading indicator and announces the loading state to screen readers.
+     */
+    isLoading?: boolean;
+    /**
+     * Whether the results popover is open by default.
+     */
+    defaultOpen?: boolean;
+    className?: string;
+    style?: React.CSSProperties;
+};
+/** @public */
+interface SearchAutocompleteProps extends SearchAutocompleteOwnProps {
+}
+/** @public */
+type SearchAutocompleteItemOwnProps = {
+    children: ReactNode;
+    className?: string;
+};
+/** @public */
+interface SearchAutocompleteItemProps extends SearchAutocompleteItemOwnProps, Omit<ListBoxItemProps, keyof SearchAutocompleteItemOwnProps> {
+}
+
+/** @public */
+declare function SearchAutocomplete(props: SearchAutocompleteProps): react_jsx_runtime.JSX.Element;
+/** @public */
+declare function SearchAutocompleteItem(props: SearchAutocompleteItemProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Component definition for SearchAutocomplete.
+ * @public
+ */
+declare const SearchAutocompleteDefinition: {
+    readonly styles: {
+        readonly [key: string]: string;
+    };
+    readonly classNames: {
+        readonly root: "bui-SearchAutocomplete";
+        readonly searchField: "bui-SearchAutocompleteSearchField";
+        readonly searchFieldInput: "bui-SearchAutocompleteInput";
+        readonly searchFieldClear: "bui-SearchAutocompleteClear";
+        readonly popover: "bui-SearchAutocompletePopover";
+        readonly inner: "bui-SearchAutocompleteInner";
+        readonly listBox: "bui-SearchAutocompleteListBox";
+        readonly loadingState: "bui-SearchAutocompleteLoadingState";
+        readonly emptyState: "bui-SearchAutocompleteEmptyState";
+    };
+    readonly propDefs: {
+        readonly 'aria-label': {};
+        readonly 'aria-labelledby': {};
+        readonly size: {
+            readonly dataAttribute: true;
+            readonly default: "small";
+        };
+        readonly placeholder: {
+            readonly default: "Search";
+        };
+        readonly inputValue: {};
+        readonly onInputChange: {};
+        readonly popoverWidth: {};
+        readonly popoverPlacement: {};
+        readonly children: {};
+        readonly isLoading: {};
+        readonly defaultOpen: {};
+        readonly className: {};
+        readonly style: {};
+    };
+};
+
 /** @public */
 type SearchFieldOwnProps = {
     /**
@@ -2429,6 +2706,7 @@ declare const SearchFieldDefinition: {
         readonly input: "bui-SearchFieldInput";
         readonly inputIcon: "bui-SearchFieldInputIcon";
     };
+    readonly bg: "consumer";
     readonly propDefs: {
         readonly startCollapsed: {
             readonly dataAttribute: true;
@@ -2451,6 +2729,7 @@ declare const SearchFieldDefinition: {
 
 /** @public */
 type LinkOwnProps = {
+    noTrack?: boolean;
     variant?: TextVariants | Partial<Record<Breakpoint, TextVariants>>;
     weight?: TextWeights | Partial<Record<Breakpoint, TextWeights>>;
     color?: TextColors | TextColorStatus | Partial<Record<Breakpoint, TextColors | TextColorStatus>>;
@@ -2478,7 +2757,9 @@ declare const LinkDefinition: {
     readonly classNames: {
         readonly root: "bui-Link";
     };
+    readonly analytics: true;
     readonly propDefs: {
+        readonly noTrack: {};
         readonly variant: {
             readonly dataAttribute: true;
             readonly default: "body-medium";
@@ -2503,6 +2784,122 @@ declare const LinkDefinition: {
     };
 };
 
+/**
+ * Own props for the List component.
+ *
+ * @public
+ */
+type ListOwnProps<T = object> = {
+    items?: GridListProps<T>['items'];
+    children?: GridListProps<T>['children'];
+    renderEmptyState?: GridListProps<T>['renderEmptyState'];
+    className?: string;
+};
+/**
+ * Props for the List component.
+ *
+ * @public
+ */
+interface ListProps<T> extends ListOwnProps<T>, Omit<GridListProps<T>, keyof ListOwnProps<T>> {
+}
+/**
+ * Own props for the ListRow component.
+ *
+ * @public
+ */
+type ListRowOwnProps = {
+    /**
+     * The main label content of the row.
+     */
+    children?: React.ReactNode;
+    /**
+     * Optional secondary description text.
+     */
+    description?: string;
+    /**
+     * Optional icon displayed before the label, rendered in a 32×32px box.
+     */
+    icon?: React.ReactElement;
+    /**
+     * Optional menu items rendered inside an automatically managed dropdown menu.
+     * Pass `MenuItem` nodes here and the component will render the trigger button
+     * and menu wrapper for you.
+     */
+    menuItems?: React.ReactNode;
+    /**
+     * Optional actions rendered in a flex row on the right side of the row,
+     * e.g. a set of tags. For a dropdown menu, prefer `menuItems`.
+     */
+    customActions?: React.ReactNode;
+    className?: string;
+};
+/**
+ * Props for the ListRow component.
+ *
+ * @public
+ */
+interface ListRowProps extends ListRowOwnProps, Omit<GridListItemProps, keyof ListRowOwnProps> {
+}
+
+/**
+ * A list displays a list of interactive rows with support for keyboard
+ * navigation, single or multiple selection, and row actions.
+ *
+ * @public
+ */
+declare const List: <T extends object>(props: ListProps<T>) => react_jsx_runtime.JSX.Element;
+/**
+ * A row within a List.
+ *
+ * @public
+ */
+declare const ListRow: (props: ListRowProps) => react_jsx_runtime.JSX.Element;
+
+/**
+ * Component definition for List
+ * @public
+ */
+declare const ListDefinition: {
+    readonly styles: {
+        readonly [key: string]: string;
+    };
+    readonly classNames: {
+        readonly root: "bui-List";
+    };
+    readonly propDefs: {
+        readonly items: {};
+        readonly children: {};
+        readonly renderEmptyState: {};
+        readonly className: {};
+    };
+};
+/**
+ * Component definition for ListRow
+ * @public
+ */
+declare const ListRowDefinition: {
+    readonly styles: {
+        readonly [key: string]: string;
+    };
+    readonly bg: "consumer";
+    readonly classNames: {
+        readonly root: "bui-ListRow";
+        readonly check: "bui-ListRowCheck";
+        readonly icon: "bui-ListRowIcon";
+        readonly label: "bui-ListRowLabel";
+        readonly description: "bui-ListRowDescription";
+        readonly actions: "bui-ListRowActions";
+    };
+    readonly propDefs: {
+        readonly children: {};
+        readonly description: {};
+        readonly icon: {};
+        readonly menuItems: {};
+        readonly customActions: {};
+        readonly className: {};
+    };
+};
+
 /** @public */
 type Option = {
     value: string;
@@ -2829,5 +3226,78 @@ declare function useBgConsumer(): BgContextValue;
  */
 declare function useBgProvider(bg?: Responsive<ProviderBg>): BgContextValue;
 
-export { Accordion, AccordionDefinition, AccordionGroup, AccordionGroupDefinition, AccordionPanel, AccordionPanelDefinition, AccordionTrigger, AccordionTriggerDefinition, Alert, AlertDefinition, Avatar, AvatarDefinition, 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, HeaderPage, HeaderPageDefinition, Link, LinkDefinition, Menu, MenuAutocomplete, MenuAutocompleteListbox, MenuDefinition, MenuItem, MenuListBox, MenuListBoxItem, MenuSection, MenuSeparator, MenuTrigger, PasswordField, PasswordFieldDefinition, PluginHeader, PluginHeaderDefinition, Popover, PopoverDefinition, Radio, RadioDefinition, RadioGroup, RadioGroupDefinition, Row, 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, useBgConsumer, useBgProvider, useBreakpoint, useTable };
-export type { AccordionGroupOwnProps, AccordionGroupProps, AccordionOwnProps, AccordionPanelOwnProps, AccordionPanelProps, AccordionProps, AccordionTriggerOwnProps, AccordionTriggerProps, AlertOwnProps, AlertProps, AlignItems, AvatarOwnProps, AvatarProps, BgContextValue, BgProviderProps, Border, BorderRadius, BoxOwnProps, BoxProps, BoxUtilityProps, Breakpoint, ButtonIconOwnProps, ButtonIconProps, ButtonLinkOwnProps, ButtonLinkProps, ButtonOwnProps, ButtonProps, CardBodyOwnProps, CardBodyProps, CardFooterOwnProps, CardFooterProps, CardHeaderOwnProps, CardHeaderProps, CardOwnProps, CardProps, CellOwnProps, CellProfileOwnProps, CellProfileProps, CellProps, CellTextOwnProps, CellTextProps, CheckboxOwnProps, CheckboxProps, ColumnConfig, ColumnOwnProps, ColumnProps, Columns, 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, HeaderPageBreadcrumb, HeaderPageOwnProps, HeaderPageProps, HeaderTab, JustifyContent, LinkOwnProps, LinkProps, 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, 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, UseTableCompleteOptions, UseTableCursorOptions, UseTableOffsetOptions, UseTableOptions, UseTableResult, UtilityProps, VisuallyHiddenOwnProps, VisuallyHiddenProps };
+/**
+ * Key-value metadata attached to analytics events.
+ * @public
+ */
+type AnalyticsEventAttributes = {
+    [key: string]: string | boolean | number;
+};
+/**
+ * A generic interface for capturing analytics events. Consumers provide
+ * an implementation via `BUIProvider` — this allows `@backstage/ui`
+ * to fire analytics events without depending on any specific analytics
+ * system. The signature intentionally matches Backstage's own
+ * `AnalyticsTracker` so it can be wired through directly.
+ * @public
+ */
+type AnalyticsTracker = {
+    captureEvent: (action: string, subject: string, options?: {
+        value?: number;
+        attributes?: AnalyticsEventAttributes;
+    }) => void;
+};
+/**
+ * A hook function that returns an AnalyticsTracker.
+ * Provided via context by the consumer (e.g. a Backstage app).
+ * @public
+ */
+type UseAnalyticsFn = () => AnalyticsTracker;
+
+/** @public */
+type BUIProviderProps = {
+    useAnalytics?: UseAnalyticsFn;
+    children: ReactNode;
+};
+/**
+ * Provides integration capabilities to all descendant BUI components.
+ *
+ * @example
+ * ```tsx
+ * import { BUIProvider } from '@backstage/ui';
+ * import { useAnalytics as useBackstageAnalytics } from '@backstage/core-plugin-api';
+ *
+ * function App() {
+ *   return (
+ *     <BUIProvider useAnalytics={useBackstageAnalytics}>
+ *       <AppContent />
+ *     </BUIProvider>
+ *   );
+ * }
+ * ```
+ *
+ * @public
+ */
+declare function BUIProvider(props: BUIProviderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Returns an AnalyticsTracker for capturing analytics events.
+ *
+ * By default returns a noop tracker. When a `BUIProvider` is present
+ * in the tree, returns the tracker provided by the consumer's hook.
+ *
+ * @public
+ */
+declare function useAnalytics(): AnalyticsTracker;
+
+/**
+ * Recursively extracts text content from a React node tree.
+ * Returns undefined if no text content is found (e.g. icon-only children
+ * or render functions).
+ *
+ * @public
+ */
+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, 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 };