@backstage/ui 0.13.0-next.2 → 0.13.0

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, SelectProps as SelectProps$1, SwitchProps as SwitchProps$1, ToggleButtonProps as ToggleButtonProps$1, ToggleButtonGroupProps as ToggleButtonGroupProps$1 } from 'react-aria-components';
+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';
@@ -1389,11 +1389,11 @@ declare const HeaderDefinition: {
         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: {};
@@ -1412,11 +1412,11 @@ declare const HeaderPageDefinition: {
         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: {};
@@ -1531,9 +1531,7 @@ declare const ButtonLinkDefinition: {
 
 /** @public */
 type CheckboxOwnProps = {
-    selected?: boolean;
-    indeterminate?: boolean;
-    children: React.ReactNode;
+    children?: React.ReactNode;
     className?: string;
 };
 /** @public */
@@ -1556,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: {};
     };
@@ -1708,6 +1700,7 @@ interface SortState {
 /** @public */
 type TableRootOwnProps = {
     stale?: boolean;
+    loading?: boolean;
 };
 /** @public */
 interface TableRootProps extends TableRootOwnProps, Omit<TableProps$1, keyof TableRootOwnProps> {
@@ -1743,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;
@@ -1759,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;
@@ -1771,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 */
@@ -1788,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;
@@ -1808,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;
@@ -1821,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;
@@ -1834,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;
@@ -1979,6 +2045,9 @@ declare const TableDefinition: {
         readonly stale: {
             readonly dataAttribute: true;
         };
+        readonly loading: {
+            readonly dataAttribute: true;
+        };
     };
 };
 
@@ -2480,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 = {
     /**
@@ -2604,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;
@@ -2958,16 +3254,6 @@ type AnalyticsTracker = {
  */
 type UseAnalyticsFn = () => AnalyticsTracker;
 
-/**
- * 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;
-
 /** @public */
 type BUIProviderProps = {
     useAnalytics?: UseAnalyticsFn;
@@ -2994,6 +3280,16 @@ type BUIProviderProps = {
  */
 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
@@ -3003,5 +3299,5 @@ declare function BUIProvider(props: BUIProviderProps): react_jsx_runtime.JSX.Ele
  */
 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, 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, 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, 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, UseAnalyticsFn, UseTableCompleteOptions, UseTableCursorOptions, UseTableOffsetOptions, UseTableOptions, UseTableResult, UtilityProps, 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, 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 };

package/dist/index.esm.js

@@ -63,10 +63,14 @@ export { Menu, MenuAutocomplete, MenuAutocompleteListbox, MenuItem, MenuListBox,
 export { MenuDefinition } from './components/Menu/definition.esm.js';
 export { Popover } from './components/Popover/Popover.esm.js';
 export { PopoverDefinition } from './components/Popover/definition.esm.js';
+export { SearchAutocomplete, SearchAutocompleteItem } from './components/SearchAutocomplete/SearchAutocomplete.esm.js';
+export { SearchAutocompleteDefinition } from './components/SearchAutocomplete/definition.esm.js';
 export { SearchField } from './components/SearchField/SearchField.esm.js';
 export { SearchFieldDefinition } from './components/SearchField/definition.esm.js';
 export { Link } from './components/Link/Link.esm.js';
 export { LinkDefinition } from './components/Link/definition.esm.js';
+export { List, ListRow } from './components/List/List.esm.js';
+export { ListDefinition, ListRowDefinition } from './components/List/definition.esm.js';
 export { Select } from './components/Select/Select.esm.js';
 export { SelectDefinition } from './components/Select/definition.esm.js';
 export { Skeleton } from './components/Skeleton/Skeleton.esm.js';
@@ -81,7 +85,7 @@ export { VisuallyHidden } from './components/VisuallyHidden/VisuallyHidden.esm.j
 export { VisuallyHiddenDefinition } from './components/VisuallyHidden/definition.esm.js';
 export { useBreakpoint } from './hooks/useBreakpoint.esm.js';
 export { BgProvider, useBgConsumer, useBgProvider } from './hooks/useBg.esm.js';
+export { BUIProvider } from './provider/BUIProvider.esm.js';
 export { useAnalytics } from './analytics/useAnalytics.esm.js';
-export { BUIProvider } from './analytics/BUIProvider.esm.js';
 export { getNodeText } from './analytics/getNodeText.esm.js';
 //# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/provider/BUIProvider.esm.js

@@ -0,0 +1,28 @@
+import { jsx } from 'react/jsx-runtime';
+import { useMemo } from 'react';
+import { RouterProvider } from 'react-aria-components';
+import { useInRouterContext, useNavigate, useHref } from 'react-router-dom';
+import { createVersionedValueMap } from '@backstage/version-bridge';
+import { BUIContext } from '../analytics/useAnalytics.esm.js';
+
+function BUIProvider(props) {
+  const { useAnalytics, children } = props;
+  const value = useMemo(
+    () => createVersionedValueMap({
+      1: { useAnalytics }
+    }),
+    [useAnalytics]
+  );
+  const content = /* @__PURE__ */ jsx(BUIContext.Provider, { value, children });
+  if (useInRouterContext()) {
+    return /* @__PURE__ */ jsx(RoutedContent, { children: content });
+  }
+  return content;
+}
+function RoutedContent({ children }) {
+  const navigate = useNavigate();
+  return /* @__PURE__ */ jsx(RouterProvider, { navigate, useHref, children });
+}
+
+export { BUIProvider };
+//# sourceMappingURL=BUIProvider.esm.js.map

package/dist/provider/BUIProvider.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BUIProvider.esm.js","sources":["../../src/provider/BUIProvider.tsx"],"sourcesContent":["/*\n * Copyright 2026 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { useMemo, type ReactNode } from 'react';\nimport { RouterProvider } from 'react-aria-components';\nimport { useInRouterContext, useNavigate, useHref } from 'react-router-dom';\nimport { createVersionedValueMap } from '@backstage/version-bridge';\nimport { BUIContext } from '../analytics/useAnalytics';\nimport type { UseAnalyticsFn } from '../analytics/types';\n\n/** @public */\nexport type BUIProviderProps = {\n  useAnalytics?: UseAnalyticsFn;\n  children: ReactNode;\n};\n\n/**\n * Provides integration capabilities to all descendant BUI components.\n *\n * @example\n * ```tsx\n * import { BUIProvider } from '@backstage/ui';\n * import { useAnalytics as useBackstageAnalytics } from '@backstage/core-plugin-api';\n *\n * function App() {\n *   return (\n *     <BUIProvider useAnalytics={useBackstageAnalytics}>\n *       <AppContent />\n *     </BUIProvider>\n *   );\n * }\n * ```\n *\n * @public\n */\nexport function BUIProvider(props: BUIProviderProps) {\n  const { useAnalytics, children } = props;\n  const value = useMemo(\n    () =>\n      createVersionedValueMap({\n        1: { useAnalytics },\n      }),\n    [useAnalytics],\n  );\n\n  const content = (\n    <BUIContext.Provider value={value}>{children}</BUIContext.Provider>\n  );\n\n  if (useInRouterContext()) {\n    return <RoutedContent>{content}</RoutedContent>;\n  }\n\n  return content;\n}\n\nfunction RoutedContent({ children }: { children: ReactNode }) {\n  const navigate = useNavigate();\n  return (\n    <RouterProvider navigate={navigate} useHref={useHref}>\n      {children}\n    </RouterProvider>\n  );\n}\n"],"names":[],"mappings":";;;;;;;AAgDO,SAAS,YAAY,KAAA,EAAyB;AACnD,EAAA,MAAM,EAAE,YAAA,EAAc,QAAA,EAAS,GAAI,KAAA;AACnC,EAAA,MAAM,KAAA,GAAQ,OAAA;AAAA,IACZ,MACE,uBAAA,CAAwB;AAAA,MACtB,CAAA,EAAG,EAAE,YAAA;AAAa,KACnB,CAAA;AAAA,IACH,CAAC,YAAY;AAAA,GACf;AAEA,EAAA,MAAM,0BACJ,GAAA,CAAC,UAAA,CAAW,QAAA,EAAX,EAAoB,OAAe,QAAA,EAAS,CAAA;AAG/C,EAAA,IAAI,oBAAmB,EAAG;AACxB,IAAA,uBAAO,GAAA,CAAC,iBAAe,QAAA,EAAA,OAAA,EAAQ,CAAA;AAAA,EACjC;AAEA,EAAA,OAAO,OAAA;AACT;AAEA,SAAS,aAAA,CAAc,EAAE,QAAA,EAAS,EAA4B;AAC5D,EAAA,MAAM,WAAW,WAAA,EAAY;AAC7B,EAAA,uBACE,GAAA,CAAC,cAAA,EAAA,EAAe,QAAA,EAAoB,OAAA,EACjC,QAAA,EACH,CAAA;AAEJ;;;;"}

package/dist/utils/{isExternalLink.esm.js → linkUtils.esm.js}

@@ -11,6 +11,9 @@ function isExternalLink(href) {
   }
   return false;
 }
+function isInternalLink(href) {
+  return !!href && !isExternalLink(href);
+}
 
-export { isExternalLink };
-//# sourceMappingURL=isExternalLink.esm.js.map
+export { isExternalLink, isInternalLink };
+//# sourceMappingURL=linkUtils.esm.js.map

package/dist/utils/linkUtils.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkUtils.esm.js","sources":["../../src/utils/linkUtils.ts"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Determines if a link is external.\n * @param href - The href of the link.\n * @returns True if the link is external, false otherwise.\n * @internal\n */\nexport function isExternalLink(href?: string): boolean {\n  if (!href) return false;\n\n  // Check if it's an absolute URL with protocol\n  if (href.startsWith('http://') || href.startsWith('https://')) {\n    return true;\n  }\n\n  // Check if it's a protocol-relative URL\n  if (href.startsWith('//')) {\n    return true;\n  }\n\n  // Check if it's a mailto: or tel: link\n  if (href.startsWith('mailto:') || href.startsWith('tel:')) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Checks if an href is an internal link (not external and not empty).\n *\n * @internal\n */\nexport function isInternalLink(href: string | undefined): href is string {\n  return !!href && !isExternalLink(href);\n}\n"],"names":[],"mappings":"AAsBO,SAAS,eAAe,IAAA,EAAwB;AACrD,EAAA,IAAI,CAAC,MAAM,OAAO,KAAA;AAGlB,EAAA,IAAI,KAAK,UAAA,CAAW,SAAS,KAAK,IAAA,CAAK,UAAA,CAAW,UAAU,CAAA,EAAG;AAC7D,IAAA,OAAO,IAAA;AAAA,EACT;AAGA,EAAA,IAAI,IAAA,CAAK,UAAA,CAAW,IAAI,CAAA,EAAG;AACzB,IAAA,OAAO,IAAA;AAAA,EACT;AAGA,EAAA,IAAI,KAAK,UAAA,CAAW,SAAS,KAAK,IAAA,CAAK,UAAA,CAAW,MAAM,CAAA,EAAG;AACzD,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,OAAO,KAAA;AACT;AAOO,SAAS,eAAe,IAAA,EAA0C;AACvE,EAAA,OAAO,CAAC,CAAC,IAAA,IAAQ,CAAC,eAAe,IAAI,CAAA;AACvC;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/ui",
-  "version": "0.13.0-next.2",
+  "version": "0.13.0",
   "backstage": {
     "role": "web-library"
   },
@@ -50,7 +50,7 @@
     "test": "backstage-cli package test"
   },
   "dependencies": {
-    "@backstage/version-bridge": "1.0.12",
+    "@backstage/version-bridge": "^1.0.12",
     "@remixicon/react": "^4.6.0",
     "@tanstack/react-table": "^8.21.3",
     "clsx": "^2.1.1",
@@ -58,13 +58,13 @@
     "use-sync-external-store": "^1.4.0"
   },
   "devDependencies": {
-    "@backstage/cli": "0.36.0-next.2",
+    "@backstage/cli": "^0.36.0",
     "@types/react": "^18.0.0",
     "@types/react-dom": "^18.0.0",
     "@types/use-sync-external-store": "^0.0.6",
     "eslint-plugin-storybook": "^10.3.0-alpha.1",
     "glob": "^11.0.1",
-    "globals": "^15.11.0",
+    "globals": "^17.0.0",
     "react": "^18.0.2",
     "react-dom": "^18.0.2",
     "react-router-dom": "^6.30.2",

package/dist/analytics/BUIProvider.esm.js

@@ -1,18 +0,0 @@
-import { jsx } from 'react/jsx-runtime';
-import { useMemo } from 'react';
-import { createVersionedValueMap } from '@backstage/version-bridge';
-import { BUIContext } from './useAnalytics.esm.js';
-
-function BUIProvider(props) {
-  const { useAnalytics, children } = props;
-  const value = useMemo(
-    () => createVersionedValueMap({
-      1: { useAnalytics }
-    }),
-    [useAnalytics]
-  );
-  return /* @__PURE__ */ jsx(BUIContext.Provider, { value, children });
-}
-
-export { BUIProvider };
-//# sourceMappingURL=BUIProvider.esm.js.map