@brandsync/wc 1.15.0 → 1.17.0

package/dist/types/components.d.ts

@@ -21,6 +21,7 @@ import { BsCheckboxSize as BsCheckboxSize1 } from "./components/bs-checkbox/bs-c
 import { BsChipFilterSize } from "./components/bs-chip/bs-chip-filter/bs-chip-filter";
 import { BsChipInformativeColor, BsChipInformativeSize } from "./components/bs-chip/bs-chip-informative/bs-chip-informative";
 import { BsChipInputSize } from "./components/bs-chip/bs-chip-input/bs-chip-input";
+import { BsCommandPaletteInputDetail, BsCommandPaletteSelectDetail, BsCommandPaletteStatus } from "./components/bs-command-palette/bs-command-palette";
 import { BsComposerState, BsComposerVariant } from "./components/bs-composer/bs-composer";
 import { BsComposerStatusBannerType } from "./components/bs-composer-status-banner/bs-composer-status-banner";
 import { BsContainerSize } from "./components/bs-container/bs-container";
@@ -29,12 +30,15 @@ import { BsDataTableColumn, BsDataTableRow } from "./components/bs-data-table/bs
 import { BsDatepickerChange } from "./components/bs-datepicker/bs-datepicker";
 import { BsDialogSize } from "./components/bs-dialog/bs-dialog";
 import { BsDividerInset, BsDividerOrientation, BsDividerVariant } from "./components/bs-divider/bs-divider";
+import { BsIconTileIntent } from "./components/bs-icon-tile/bs-icon-tile";
 import { BsErrorPageType } from "./components/bs-error-page/bs-error-page";
 import { BsFileUploadDirection } from "./components/bs-file-upload/bs-file-upload";
 import { BsFileUploadItemState } from "./components/bs-file-upload-item/bs-file-upload-item";
+import { BsGlobalSearchSelectDetail, BsGlobalSearchStatus } from "./components/bs-global-search/bs-global-search";
 import { BsGridAlign } from "./components/bs-grid/bs-grid";
 import { BsIconButtonSize, BsIconButtonVariant } from "./components/bs-button/bs-icon-button/bs-icon-button";
-import { BsIconTileIntent, BsIconTileSize } from "./components/bs-icon-tile/bs-icon-tile";
+import { BsIconTileIntent as BsIconTileIntent1, BsIconTileSize } from "./components/bs-icon-tile/bs-icon-tile";
+import { BsShortcutGroup } from "./components/bs-keyboard-shortcuts/bs-keyboard-shortcuts";
 import { BsLogoBackground, BsLogoVariant } from "./components/bs-logo/bs-logo";
 import { BsMessageRole, BsMessageStatus } from "./components/bs-message/bs-message";
 import { BsNavigationHeaderAlignment } from "./components/ui-shell/bs-navigation-header/bs-navigation-header/bs-navigation-header";
@@ -79,6 +83,7 @@ export { BsCheckboxSize as BsCheckboxSize1 } from "./components/bs-checkbox/bs-c
 export { BsChipFilterSize } from "./components/bs-chip/bs-chip-filter/bs-chip-filter";
 export { BsChipInformativeColor, BsChipInformativeSize } from "./components/bs-chip/bs-chip-informative/bs-chip-informative";
 export { BsChipInputSize } from "./components/bs-chip/bs-chip-input/bs-chip-input";
+export { BsCommandPaletteInputDetail, BsCommandPaletteSelectDetail, BsCommandPaletteStatus } from "./components/bs-command-palette/bs-command-palette";
 export { BsComposerState, BsComposerVariant } from "./components/bs-composer/bs-composer";
 export { BsComposerStatusBannerType } from "./components/bs-composer-status-banner/bs-composer-status-banner";
 export { BsContainerSize } from "./components/bs-container/bs-container";
@@ -87,12 +92,15 @@ export { BsDataTableColumn, BsDataTableRow } from "./components/bs-data-table/bs
 export { BsDatepickerChange } from "./components/bs-datepicker/bs-datepicker";
 export { BsDialogSize } from "./components/bs-dialog/bs-dialog";
 export { BsDividerInset, BsDividerOrientation, BsDividerVariant } from "./components/bs-divider/bs-divider";
+export { BsIconTileIntent } from "./components/bs-icon-tile/bs-icon-tile";
 export { BsErrorPageType } from "./components/bs-error-page/bs-error-page";
 export { BsFileUploadDirection } from "./components/bs-file-upload/bs-file-upload";
 export { BsFileUploadItemState } from "./components/bs-file-upload-item/bs-file-upload-item";
+export { BsGlobalSearchSelectDetail, BsGlobalSearchStatus } from "./components/bs-global-search/bs-global-search";
 export { BsGridAlign } from "./components/bs-grid/bs-grid";
 export { BsIconButtonSize, BsIconButtonVariant } from "./components/bs-button/bs-icon-button/bs-icon-button";
-export { BsIconTileIntent, BsIconTileSize } from "./components/bs-icon-tile/bs-icon-tile";
+export { BsIconTileIntent as BsIconTileIntent1, BsIconTileSize } from "./components/bs-icon-tile/bs-icon-tile";
+export { BsShortcutGroup } from "./components/bs-keyboard-shortcuts/bs-keyboard-shortcuts";
 export { BsLogoBackground, BsLogoVariant } from "./components/bs-logo/bs-logo";
 export { BsMessageRole, BsMessageStatus } from "./components/bs-message/bs-message";
 export { BsNavigationHeaderAlignment } from "./components/ui-shell/bs-navigation-header/bs-navigation-header/bs-navigation-header";
@@ -1307,6 +1315,168 @@ export namespace Components {
          */
         "sourceName"?: string;
     }
+    /**
+     * A Ctrl+K command palette: a modal with a search field, grouped commands, navigation and records, a
+     * no-results view and a keyboard-hint footer. The data, the filtering, the command registry and the
+     * recent-items storage are all yours: you slot `bs-search-item`s into the sections and set `status`.
+     * Built from a native `<dialog>` (opened with `showModal()`, so focus is trapped, the page behind is inert
+     * and the backdrop is the scrim), `bs-input` (type="search"), `bs-search-item`, `bs-key` (footer hints and
+     * the Esc cap), `bs-chip-informative` (the scope chip) and `bs-spinner` (loading). Slot a `bs-key-caps` with
+     * `slot="trailing"` inside an item to show a command's shortcut.
+     * ## When to use
+     * - An app-wide "do anything" entry point opened with a hotkey: run commands, navigate, open records.
+     * ## When not to use
+     * - A plain search box with a dropdown -- use `bs-global-search`.
+     * - A small list of actions on one control -- use `bs-menu`.
+     * A `>` as the first character of the field switches to commands-only mode (`commandsOnly`, reflected as
+     * `commands-only`). The component filters nothing: listen to `bsInput`, swap the slotted items, set `status`.
+     * Nested (sub-command) palettes are a consumer pattern: swap the slotted commands and set `scopeLabel`.
+     * @prop --bs-command-palette-width - Panel width. Defaults to `640px` (Figma); capped to the viewport.
+     * @prop --bs-command-palette-top - Distance from the top of the viewport. Defaults to `12vh`.
+     * @prop --bs-command-palette-max-height - Max height of the results area. Defaults to `60vh`.
+     * @prop --bs-command-palette-radius - Aliased to `--bs-border-radius-150`.
+     * @prop --bs-command-palette-bg - Panel background. Aliased to `--bs-surface-base`.
+     * @prop --bs-command-palette-shadow - Figma elevation level 4: `0 8px 16px` in `--bs-elevation-higher` (stronger in dark mode).
+     * @prop --bs-command-palette-overlay - Scrim colour. Aliased to `--bs-surface-overlay`.
+     * @prop --bs-command-palette-footer-bg - Aliased to `--bs-surface-container`.
+     * @prop --bs-command-palette-divider-color - Aliased to `--bs-border-default`.
+     * @prop --bs-command-palette-header-border-color - Aliased to `--bs-border-neutral-container`.
+     * @prop --bs-command-palette-header-color - Aliased to `--bs-text-muted`.
+     * @prop --bs-command-palette-hint-color - Aliased to `--bs-text-secondary`.
+     * @prop --bs-command-palette-z-index - Aliased to `--bs-z-index-modal`.
+     */
+    interface BsCommandPalette {
+        /**
+          * @default 'All results'
+         */
+        "allResultsLabel": string;
+        /**
+          * Closes the palette and restores focus.
+         */
+        "close": () => Promise<void>;
+        /**
+          * @default 'Close'
+         */
+        "closeLabel": string;
+        /**
+          * @default 'Commands'
+         */
+        "commandsLabel": string;
+        /**
+          * Derived from `value` (it starts with `>`). Read-only; set `value` instead.
+          * @default false
+         */
+        "commandsOnly": boolean;
+        /**
+          * @default 'Commands only'
+         */
+        "commandsOnlyLabel": string;
+        /**
+          * A suggested correction; the "Did you mean" line shows while it is set.
+         */
+        "didYouMean"?: string;
+        /**
+          * @default 'Did you mean'
+         */
+        "didYouMeanLabel": string;
+        /**
+          * @default 'Check the spelling, or search records instead.'
+         */
+        "emptyDescription": string;
+        /**
+          * No-results view copy. Include the query in `emptyHeading` yourself.
+          * @default 'No commands or records'
+         */
+        "emptyHeading": string;
+        /**
+          * Global shortcut that toggles the palette, e.g. `mod+k` (`mod` is Cmd on Mac, Ctrl elsewhere). Empty = off.
+          * @default ''
+         */
+        "hotkey": string;
+        /**
+          * Keep the palette open after an item is chosen.
+          * @default false
+         */
+        "keepOpenOnSelect": boolean;
+        /**
+          * Accessible name of the dialog.
+          * @default 'Command palette'
+         */
+        "label": string;
+        /**
+          * Accessible name of the results listbox.
+          * @default 'Results'
+         */
+        "listLabel": string;
+        /**
+          * Text of the loading row.
+          * @default 'Loading…'
+         */
+        "loadingLabel": string;
+        /**
+          * Footer hint texts.
+          * @default 'Navigate'
+         */
+        "navigateLabel": string;
+        /**
+          * @default 'Navigation'
+         */
+        "navigationLabel": string;
+        /**
+          * Whether the palette is open.
+          * @default false
+         */
+        "open": boolean;
+        /**
+          * @default 'Open'
+         */
+        "openLabel": string;
+        /**
+          * Placeholder of the field.
+          * @default 'Type a command or search…'
+         */
+        "placeholder": string;
+        /**
+          * Section headers.
+          * @default 'Recent'
+         */
+        "recentLabel": string;
+        /**
+          * @default 'Records'
+         */
+        "recordsLabel": string;
+        /**
+          * Nested scope: shows this text as a chip before the field. Backspace on an empty field emits `bsScopeExit`.
+         */
+        "scopeLabel"?: string;
+        /**
+          * Opens the palette.
+         */
+        "show": () => Promise<void>;
+        /**
+          * Shows the footer of keyboard hints.
+          * @default true
+         */
+        "showFooter": boolean;
+        /**
+          * Which view to show. You choose it; nothing is inferred from `value`. `default` and `results` render the same; they differ for screen readers only.
+          * @default 'default'
+         */
+        "status": BsCommandPaletteStatus;
+        /**
+          * @default 'Suggested'
+         */
+        "suggestedLabel": string;
+        /**
+          * @default 'Try instead'
+         */
+        "tryInsteadLabel": string;
+        /**
+          * The field value. Two-way. A leading `>` means commands-only mode.
+          * @default ''
+         */
+        "value": string;
+    }
     /**
      * A chat composer input for Genie AI-style conversational interfaces: a text field
      * plus an attach button, a mic/voice-recording toggle, and a single primary action button whose
@@ -1850,6 +2020,43 @@ export namespace Components {
          */
         "variant": BsDividerVariant;
     }
+    /**
+     * A centered "nothing to show" block: an icon tile, a heading, a description and an optional action.
+     * Used for empty lists, "no results" and error states inside a panel, card or page section.
+     * Built from `bs-icon-tile` (and, in your `action` slot, usually a `bs-button`).
+     * The component has no role. Live regions belong on a wrapper you control (e.g. `role="status"` on the
+     * element that stays in the DOM while this block appears and disappears).
+     * ## When to use
+     * - A list, table or search result that has nothing to show, or failed to load.
+     * ## When not to use
+     * - A full-page error with a status code -- use `bs-error-page`.
+     * - A transient message -- use `bs-toast` or `bs-snackbar`.
+     * @prop --bs-empty-state-padding-y - Vertical padding. Aliased to `--bs-spacing-700` (56px).
+     * @prop --bs-empty-state-padding-x - Horizontal padding. Aliased to `--bs-spacing-300` (24px).
+     * @prop --bs-empty-state-gap - Gap between tile, heading, description and action. Aliased to `--bs-spacing-150`.
+     * @prop --bs-empty-state-heading-color - Aliased to `--bs-text-default`.
+     * @prop --bs-empty-state-description-color - Aliased to `--bs-text-secondary`.
+     */
+    interface BsEmptyState {
+        /**
+          * The description text. The default slot overrides it.
+         */
+        "description"?: string;
+        /**
+          * The heading text.
+         */
+        "heading"?: string;
+        /**
+          * Heading level, 2 to 6 (renders `h2`..`h6`). Pick the one that fits the page outline.
+          * @default 3
+         */
+        "headingLevel": 2 | 3 | 4 | 5 | 6;
+        /**
+          * Colour and default glyph of the icon tile. Use `error` for failures.
+          * @default 'default'
+         */
+        "intent": BsIconTileIntent;
+    }
     /**
      * A full-block page for when the user can't get to what they asked for: page not found (404), a server
      * error (500), no access (403), planned maintenance, or no internet connection. Matches the Figma
@@ -2005,6 +2212,161 @@ export namespace Components {
          */
         "thumbnailSrc"?: string;
     }
+    /**
+     * A global search combobox: a search field with a dropdown panel of suggestions, results, an empty state
+     * or an error state, plus a keyboard-hint footer. The data, the filtering and the recent-search storage
+     * are all yours: you slot `bs-search-item`s into the sections and tell the component which `status` to show.
+     * Built from `bs-input` (type="search"), `bs-search-item`, `bs-empty-state` (and so `bs-icon-tile`),
+     * `bs-button` and `bs-key` (the footer keycaps).
+     * ## When to use
+     * - An app-wide "find anything" field with recent searches, jump-to shortcuts and grouped results.
+     * ## When not to use
+     * - Filtering the list or table that is already on screen -- use `bs-input type="search"`.
+     * - A list of commands or actions -- use `bs-menu`.
+     * - The complete result set -- link to a full search results page ("See all results").
+     * Put `bs-search-item` children in the light DOM with `slot="recent"`, `slot="jump-to"`,
+     * `slot="top-matches"` or `slot="search-in"`. A section (and its header) is only rendered when its slot has
+     * content. Up/Down arrows move a highlight through the visible items; focus never leaves the field.
+     * Known limit: the items are in your light DOM and the combobox in this shadow root, so
+     * `aria-activedescendant` (an id reference) does not resolve across that boundary in every browser; the
+     * highlighted option also gets `aria-selected="true"`.
+     * @prop --bs-global-search-width - Field and panel width. Defaults to `480px` (Figma); capped at 100%.
+     * @prop --bs-global-search-panel-radius - Aliased to `--bs-border-radius-100`.
+     * @prop --bs-global-search-panel-padding - Aliased to `--bs-spacing-100`.
+     * @prop --bs-global-search-gap - Gap between sections, and between the field and the panel. Aliased to `--bs-spacing-100`.
+     * @prop --bs-global-search-panel-bg - Panel background. Aliased to `--bs-surface-base`.
+     * @prop --bs-global-search-shadow - Panel shadow: Figma elevation level 3 (`0 4px 8px` in `--bs-elevation-high`, 10% black in light mode and 30% in dark mode).
+     * @prop --bs-global-search-z-index - Panel stacking. Aliased to `--bs-z-index-dropdown`.
+     * @prop --bs-global-search-divider-color - Footer divider. Aliased to `--bs-border-default`.
+     * @prop --bs-global-search-header-border-color - Section header underline. Aliased to `--bs-border-neutral-container`.
+     * @prop --bs-global-search-header-color - Section header text. Aliased to `--bs-text-muted`.
+     * @prop --bs-global-search-hint-color - Footer hint text. Aliased to `--bs-text-secondary`.
+     */
+    interface BsGlobalSearch {
+        /**
+          * Text of the footer button that clears recent searches.
+          * @default 'Clear recent'
+         */
+        "clearRecentLabel": string;
+        /**
+          * Text of the empty state's action.
+          * @default 'Clear search'
+         */
+        "clearSearchLabel": string;
+        /**
+          * Footer hint text after the Esc key.
+          * @default 'Close'
+         */
+        "closeLabel": string;
+        /**
+          * Disables the field; the panel cannot open.
+          * @default false
+         */
+        "disabled": boolean;
+        /**
+          * Description of the built-in empty state.
+          * @default 'Try a different search.'
+         */
+        "emptyDescription": string;
+        /**
+          * Heading of the built-in empty state.
+          * @default 'No results'
+         */
+        "emptyHeading": string;
+        /**
+          * Description of the built-in error state.
+          * @default 'We couldn’t reach the server. Your query is kept — try again in a moment.'
+         */
+        "errorDescription": string;
+        /**
+          * Heading of the built-in error state.
+          * @default 'Search isn’t available right now'
+         */
+        "errorHeading": string;
+        /**
+          * Footer hint text after the Enter key (results view).
+          * @default 'Full results'
+         */
+        "fullResultsLabel": string;
+        /**
+          * Header of the `jump-to` section.
+          * @default 'Jump to'
+         */
+        "jumpToLabel": string;
+        /**
+          * Accessible name of the search field. Falls back to the placeholder. `bs-input` has no aria-label prop, so this names the combobox wrapper.
+         */
+        "label"?: string;
+        /**
+          * Accessible name of the suggestions listbox.
+          * @default 'Search suggestions'
+         */
+        "listLabel": string;
+        /**
+          * Footer hint text after the arrow keys.
+          * @default 'Navigate'
+         */
+        "navigateLabel": string;
+        /**
+          * Whether the dropdown panel is open. Opens on focus, click and typing; closes on Escape, outside click and selection.
+          * @default false
+         */
+        "open": boolean;
+        /**
+          * Placeholder of the field (also its accessible name unless `label` is set).
+          * @default 'Search customers, orders, products…'
+         */
+        "placeholder": string;
+        /**
+          * Header of the `recent` section.
+          * @default 'Recent searches'
+         */
+        "recentLabel": string;
+        /**
+          * Text of the error state's action.
+          * @default 'Try again'
+         */
+        "retryLabel": string;
+        /**
+          * Header of the `search-in` section.
+          * @default 'Search in'
+         */
+        "searchInLabel": string;
+        /**
+          * Footer hint text after the Enter key (default view).
+          * @default 'Search'
+         */
+        "searchLabel": string;
+        /**
+          * Text of the footer button of the results view, when `totalResults` is not set.
+          * @default 'See all results'
+         */
+        "seeAllLabel": string;
+        /**
+          * Shows the footer (hints and the Clear recent / See all button) for the `default` and `results` views.
+          * @default true
+         */
+        "showFooter": boolean;
+        /**
+          * Which view the panel shows. You choose it; nothing is inferred from `value`.
+          * @default 'default'
+         */
+        "status": BsGlobalSearchStatus;
+        /**
+          * Header of the `top-matches` section.
+          * @default 'Top matches'
+         */
+        "topMatchesLabel": string;
+        /**
+          * Total number of results (status `results`): shown as "See all {n} results" and announced to screen readers.
+         */
+        "totalResults"?: number;
+        /**
+          * The query. Two-way with the field.
+          * @default ''
+         */
+        "value": string;
+    }
     /**
      * A CSS grid layout wrapper. Children are placed in equal-width columns with a token-based gap.
      * `columns` takes either a number (`"3"` becomes `repeat(3, minmax(0, 1fr))`) or any raw
@@ -2116,7 +2478,7 @@ export namespace Components {
           * Colour and default glyph. `brand` uses the brand colours; `information` the info palette.
           * @default 'default'
          */
-        "intent": BsIconTileIntent;
+        "intent": BsIconTileIntent1;
         /**
           * Accessible name. When set, the tile is exposed as an image with this name; when empty it is decorative and hidden from assistive tech.
          */
@@ -2310,107 +2672,371 @@ export namespace Components {
         "value": string;
     }
     /**
-     * The BrandSync brand mark, as its own standalone component -- shared by `bs-navigation-header`
-     * and `bs-navigation-drawer`, which used to each render their own duplicated copy of this SVG
-     * (the drawer's collapsed state even faked an icon-only look by clipping the full wordmark asset
-     * down to a narrowed box, rather than using a real icon-only asset).
+     * One key of a keyboard shortcut, e.g. `Ctrl`, `K` or `Esc` -- rendered as a `<kbd>` keycap.
+     * Shows a text label, or an icon (e.g. a return arrow) via the `icon` slot.
      * ## When to use
-     * - Anywhere the BrandSync logo/icon needs to render: a navigation header, a nav drawer, etc.
+     * - Showing a keyboard shortcut hint next to a control or inside a search field.
+     * - Alone for a single key, or as the children of `bs-key-caps` for a multi-key shortcut.
      * ## When not to use
-     * - The Genie AI chat panel's own brand mark -- that's a different logo (`bs-chatbot-header`'s
-     *   own inline Genie asset), not this one.
-     * `variant` mirrors Figma's "Logo" component set (node 10909:30421) `Device` property
-     * ("Desktop" / "Tab and mobile"), which was originally meant to distinguish the full lockup from
-     * the icon-only mark at different responsive breakpoints -- renamed here to
-     * `variant: 'full' | 'mark'` since that's what it actually controls (how much of the logo
-     * renders), not literally a device/breakpoint switch.
-     * `variant="custom"` is not a Figma variant at all -- it's an escape hatch for a consuming app
-     * that needs to show a DIFFERENT product's logo in the same slot (e.g. a white-labeled deployment,
-     * or a logo fetched at runtime from a service like brand.dev), via `src`/`alt`, instead of the
-     * built-in BrandSync assets. This component deliberately does NOT fetch that image itself --
-     * network calls, loading/error states, and caching are the consuming app's responsibility, same as
-     * every other component in this library (e.g. `bs-attachment` takes `imageSrc` rather than fetching
-     * an image on its own). `background` has no effect on `variant="custom"` -- a consumer's own image
-     * is already designed for whatever surface it's placed on.
+     * - As a button or any clickable control -- a key is a static hint, not interactive.
+     * @prop --bs-key-bg - Cap background. Aliased to `--bs-surface-base`.
+     * @prop --bs-key-border-color - Cap border colour. Aliased to `--bs-border-default`.
+     * @prop --bs-key-radius - Cap corner radius. Aliased to `--bs-border-radius-50`.
+     * @prop --bs-key-padding-x - Horizontal padding. Aliased to `--bs-spacing-75`.
+     * @prop --bs-key-padding-y - Vertical padding. Aliased to `--bs-spacing-50`.
+     * @prop --bs-key-min-width - Smallest cap width, so single characters keep a keycap shape. Defaults to `25px` (Figma).
+     * @prop --bs-key-color - Label colour. Aliased to `--bs-text-secondary`.
+     * @prop --bs-key-font-size - Label size. Aliased to `--bs-font-size-xs` (12px).
+     * @prop --bs-key-icon-size - Icon size. Defaults to `16px` (Figma).
      */
-    interface BsLogo {
-        /**
-          * `variant="custom"` only: accessible alt text for the image -- a product logo is meaningful content (whose brand is this?), not decorative, so set this to something real (e.g. the product/company name). Falls back to `alt=""` (marking the image decorative to assistive tech) when unset, rather than omitting the `alt` attribute entirely -- an `<img>` with no `alt` attribute at all is a harder accessibility failure than one explicitly marked decorative, but an empty fallback is still worse than a real name, so don't rely on it. Ignored for `full`/`mark` (those already carry their own fixed `aria-label="BrandSync"`).
-          * @default null
-         */
-        "alt": string | null;
-        /**
-          * Which pre-built asset to use for `variant="full"` -- Figma ships a genuinely separate, differently-drawn dark-background asset (every wordmark path filled solid white, and the icon's outer shape a single solid-white path instead of the light version's two-path white-fill-plus-border-ring), not a CSS currentColor swap of identical paths.  `"auto"` (default) renders both assets and lets CSS pick one via `--bs-logo-asset-light-display`/`--bs-logo-asset-dark-display` (defined in `src/global/base.css`, flipped by the same `[data-theme="dark"]` attribute every other `--bs-*` token already reacts to) -- so the logo just follows the ambient theme with no wiring needed, the same way a consuming app's own dark mode already re-themes every other part of this library via ordinary CSS custom property inheritance. Set `"light"`/`"dark"` explicitly to pin one regardless of the ambient theme -- e.g. a dark sidebar that isn't otherwise dark-themed.  Has no effect on `variant="mark"`: Figma's component set only has one real designed instance of the icon-only mark (`Device="Tab and mobile"`, `Background="Default"`) -- there's no separate dark version of it, so the mark renders identically regardless of this prop.
-          * @default 'auto'
-         */
-        "background": BsLogoBackground;
-        /**
-          * `variant="custom"` only: the image URL to render (e.g. a URL your app already fetched from a logo API). Ignored for `full`/`mark`.
-          * @default null
-         */
-        "src": string | null;
+    interface BsKey {
         /**
-          * How much of the logo to render. `full` is the icon + "EG BrandSync" wordmark (190.977x44 natural size); `mark` is just the icon (44x44 natural size), no wordmark; `custom` renders a consumer-supplied image via `src`/`alt` instead of a built-in BrandSync asset -- see the class doc above.
-          * @default 'full'
+          * The key's text, e.g. `Ctrl`. The default slot overrides it.
          */
-        "variant": BsLogoVariant;
-    }
-    /**
-     * A generic dropdown/popup menu container: a rounded, elevated list of items (typically
-     * `bs-menu-item` elements).
-     * ## When to use
-     * - A popup list of actions/options triggered by another control (e.g. a "more options" kebab
-     *   button), such as `bs-chatbot-response-action`'s `menu` slot.
-     * ## When not to use
-     * - A persistent, always-visible list of options -- this component is purpose-built as a popup
-     *   surface (rounded corners, elevation shadow), not a plain list.
-     * @prop --bs-menu-bg - Background of the menu box. Aliased to `--bs-surface-raised`.
-     * @prop --bs-menu-radius - Corner radius of the menu box. Aliased to `--bs-border-radius-100`.
-     * @prop --bs-menu-padding-y - Top/bottom padding of the menu box. Aliased to `--bs-spacing-50`.
-     * @prop --bs-menu-gap - Gap between slotted items. Aliased to `--bs-spacing-50`.
-     * @prop --bs-menu-shadow - Elevation shadow of the menu box. Aliased to `--bs-shadow-sm`.
-     */
-    interface BsMenu {
+        "label"?: string;
     }
     /**
-     * A single selectable row inside a `bs-menu`: an optional icon plus a text label, rendered as a
-     * real `<button>` for correct keyboard/click semantics.
+     * A keyboard shortcut of one to four keys joined by "+", e.g. `Ctrl + K`. Give it a `keys` string
+     * (`"Ctrl+Shift+K"`) or array (`['Ctrl', '+']` for a literal plus key), or slot your own `bs-key`
+     * elements -- for example when a key is an icon.
      * ## When to use
-     * - As a child of `bs-menu`, one per selectable action/option.
+     * - A shortcut hint beside a menu item, button or inside a search field.
      * ## When not to use
-     * - Outside of `bs-menu` -- this component's sizing/hover treatment is designed to sit inside the
-     *   menu's rounded, padded list box.
-     * @prop --bs-menu-item-radius - Corner radius of the row. Aliased to `--bs-border-radius-100`.
-     * @prop --bs-menu-item-padding-y - Top/bottom padding. Aliased to `--bs-spacing-100`.
-     * @prop --bs-menu-item-padding-x - Left/right padding. Aliased to `--bs-spacing-150`.
-     * @prop --bs-menu-item-gap - Gap between icon and label. Aliased to `--bs-spacing-100`.
-     * @prop --bs-menu-item-hover - Background on hover. Aliased to `--bs-color-neutral-container-hover`.
-     * @prop --bs-menu-item-pressed - Background when pressed. Aliased to `--bs-color-neutral-container-pressed`.
-     * @prop --bs-menu-item-disabled-bg - Background when `disabled` is set. Aliased to `--bs-surface-action-disabled`.
-     * @prop --bs-menu-item-icon-color - Icon color. Aliased to `--bs-icon-default`.
-     * @prop --bs-menu-item-icon-color-disabled - Icon color when `disabled` is set. Aliased to `--bs-icon-disabled`.
-     * @prop --bs-menu-item-color - Label text color. Aliased to `--bs-text-muted`.
-     * @prop --bs-menu-item-color-disabled - Label text color when `disabled` is set. Aliased to `--bs-text-on-disabled`.
-     * @prop --bs-menu-item-font-size - Aliased to `--bs-font-size-md`.
-     * @prop --bs-menu-item-line-height - Aliased to `--bs-line-height-body-md`.
+     * - Instructions that need prose ("press Enter to submit") -- write a sentence and use a single `bs-key` inline.
+     * - Anything interactive -- keys are static hints.
+     * @prop --bs-key-caps-gap - Gap between keys and separators. Aliased to `--bs-spacing-100`.
+     * @prop --bs-key-caps-separator-color - Colour of the "+" separators. Aliased to `--bs-text-muted`.
+     * @prop --bs-key-caps-disabled-opacity - Opacity of the whole shortcut while `disabled`. Defaults to `0.38` (Figma).
      */
-    interface BsMenuItem {
+    interface BsKeyCaps {
         /**
-          * Disables the item: no hover/pressed/focus styling, no pointer cursor, not reachable by keyboard tabbing, and clicking it does not emit `bsSelect`.
+          * Dims the whole shortcut and marks it `aria-disabled`.
           * @default false
          */
         "disabled": boolean;
+        /**
+          * The keys as text. A string is split on `+` (`"Ctrl+K"`); use an array to include a literal plus key. Ignored when `bs-key` elements are slotted instead. Figma defines one to four keys.
+         */
+        "keys"?: string | string[];
+        /**
+          * Accessible name of the shortcut, e.g. "Control plus K". Defaults to the keys joined with " plus ".
+         */
+        "label"?: string;
     }
     /**
-     * A single chat message bubble. User messages align to the end with a primary-tinted bubble;
-     * assistant messages align to the start on a neutral bubble. The consumer renders the content
-     * (e.g. markdown) into the default slot.
-     * Composed from: `bs-card` (the bubble surface).
+     * A searchable reference panel of keyboard shortcuts: heading and close button, a search field, an
+     * optional single-key on/off switch, shortcut groups in two columns and a footer hint. It is a
+     * surface, not a modal -- place it inside `bs-dialog` or a popover.
+     * Built from `bs-card`, `bs-icon-button`, `bs-input`, `bs-switch`, `bs-shortcut-row` (and so
+     * `bs-key-caps` / `bs-key`).
      * ## When to use
-     * - One entry per turn in a chat transcript, usually inside `bs-message-list`.
+     * - A "press ? to see shortcuts" help overlay for an app with many shortcuts.
      * ## When not to use
-     * - For transient notices or system banners -- use `bs-toast` / `bs-composer-status-banner`.
-     * @prop --bs-message-gap - Gap between avatar and message column. Aliased to `--bs-spacing-100`.
+     * - A long-form help page or documentation -- link to it instead.
+     * - A list of commands the user can run from it -- use `bs-menu`.
+     * @prop --bs-keyboard-shortcuts-width - Panel width and min-width. Defaults to `720px` (Figma).
+     * @prop --bs-keyboard-shortcuts-bg - Panel background. Aliased to `--bs-surface-base`.
+     * @prop --bs-keyboard-shortcuts-radius - Aliased to `--bs-border-radius-150`.
+     * @prop --bs-keyboard-shortcuts-padding - Aliased to `--bs-spacing-200`.
+     * @prop --bs-keyboard-shortcuts-gap - Gap between sections. Aliased to `--bs-spacing-200`.
+     * @prop --bs-keyboard-shortcuts-shadow - Figma elevation level 4 (`0 8px 8px` in `--bs-elevation-higher`, 12% black in light mode and 25% in dark mode).
+     * @prop --bs-keyboard-shortcuts-column-gap - Gap between the two columns. Aliased to `--bs-spacing-600`.
+     * @prop --bs-keyboard-shortcuts-color - Main text colour. Aliased to `--bs-text-default`.
+     * @prop --bs-keyboard-shortcuts-color-secondary - Titles, captions, footer. Aliased to `--bs-text-secondary`.
+     */
+    interface BsKeyboardShortcuts {
+        /**
+          * Accessible name of the close button.
+          * @default 'Close'
+         */
+        "closeLabel": string;
+        /**
+          * The key shown in the footer hint.
+          * @default '?'
+         */
+        "footerKey": string;
+        /**
+          * Text before the footer key.
+          * @default 'Press'
+         */
+        "footerPrefix": string;
+        /**
+          * Footer text after the key.
+          * @default 'anywhere to open this list. On Mac: Cmd instead of Ctrl.'
+         */
+        "footerText": string;
+        /**
+          * Property only: the shortcut groups.
+          * @default []
+         */
+        "groups": BsShortcutGroup[];
+        /**
+          * Heading text. The `heading` slot overrides it.
+          * @default 'Keyboard shortcuts'
+         */
+        "heading": string;
+        /**
+          * Line shown when the query matches nothing.
+          * @default 'No shortcuts match'
+         */
+        "noResultsText": string;
+        /**
+          * Current search text. Filters by action or keys text, case-insensitively.
+          * @default ''
+         */
+        "query": string;
+        /**
+          * Search field placeholder (also its accessible name: `bs-input` has no aria-label prop).
+          * @default 'Search for an action'
+         */
+        "searchPlaceholder": string;
+        /**
+          * Shows the footer hint.
+          * @default true
+         */
+        "showFooterHint": boolean;
+        /**
+          * Shows the single-key switch row.
+          * @default true
+         */
+        "showSingleKeySwitch": boolean;
+        /**
+          * Switch caption.
+          * @default 'Turn off if they clash with a screen reader or other tools.'
+         */
+        "singleKeyDescription": string;
+        /**
+          * Whether single-key shortcuts are on. When off they are shown dimmed.
+          * @default true
+         */
+        "singleKeyEnabled": boolean;
+        /**
+          * Switch title.
+          * @default 'Single-key shortcuts'
+         */
+        "singleKeyLabel": string;
+    }
+    /**
+     * A vertical list of `bs-list-item` rows, optionally single-select.
+     * ## When to use
+     * - Records, people, files or options shown as rows with leading media and descriptions.
+     * - `selectable` for a single-choice list (e.g. a conversation list next to a detail pane).
+     * ## When not to use
+     * - A popup list of actions -- use `bs-menu`.
+     * - Navigation between app sections -- use `bs-navigation-drawer`.
+     * - Multi-column, sortable or paged data -- use `bs-data-table`.
+     * Built from `bs-list-item` children (light DOM; the list never moves nodes).
+     * @prop --bs-list-gap - Gap between rows. Defaults to `0`.
+     * @prop --bs-list-divider-color - Divider colour when `dividers` is set. Aliased to `--bs-border-neutral-container`.
+     */
+    interface BsList {
+        /**
+          * Accessible name of the list.
+          * @default null
+         */
+        "ariaLabel": string | null;
+        /**
+          * Draws a 1px separator between rows.
+          * @default false
+         */
+        "dividers": boolean;
+        /**
+          * Single-selection mode: role="listbox", rows are `option`s with roving tabindex.
+          * @default false
+         */
+        "selectable": boolean;
+        /**
+          * `value` of the selected item (selectable mode).
+          * @default null
+         */
+        "value": string | null;
+    }
+    /**
+     * A single row of a list: optional leading media (avatar, icon, image), a label, a description and
+     * optional support text, and an optional trailing caret or custom trailing content.
+     * ## When to use
+     * - As a child of `bs-list`, one per record, person, file or option.
+     * - Standalone as a plain information row (non-interactive), or with `interactive` as a button-like row.
+     * ## When not to use
+     * - A popup list of actions -- use `bs-menu` / `bs-menu-item`.
+     * - App navigation with an active route -- use `bs-navigation-drawer-item`.
+     * - Tabular data with columns, sorting or paging -- use `bs-data-table`.
+     * Composed from: leading media (`bs-avatar`) and trailing controls (`bs-icon-button`) are supplied by the
+     * consumer through the `leading` and `trailing` slots; the row itself only reserves layout. The default
+     * trailing caret is inline SVG.
+     * Roles are driven by the parent `bs-list` (via `selectionRole`). Standalone, the row has no role
+     * (`listitem` is only valid inside a list) unless `interactive` is set, which makes it a focusable
+     * `role="button"`.
+     * @prop --bs-list-item-min-height - Minimum row height. Aliased to `--bs-spacing-1000`.
+     * @prop --bs-list-item-padding-y - Aliased to `--bs-spacing-150`.
+     * @prop --bs-list-item-padding-x - Aliased to `--bs-spacing-200`.
+     * @prop --bs-list-item-gap - Gap between leading, content and trailing. Aliased to `--bs-spacing-200`.
+     * @prop --bs-list-item-content-gap - Gap between text lines. Aliased to `--bs-spacing-25`.
+     * @prop --bs-list-item-radius - Aliased to `--bs-border-radius-100`.
+     * @prop --bs-list-item-bg - Enabled background. `transparent`.
+     * @prop --bs-list-item-bg-hover - Aliased to `--bs-surface-hover`.
+     * @prop --bs-list-item-bg-pressed - Aliased to `--bs-surface-pressed`.
+     * @prop --bs-list-item-bg-focus - Aliased to `--bs-surface-focus`.
+     * @prop --bs-list-item-bg-selected - Aliased to `--bs-surface-selected`.
+     * @prop --bs-list-item-bg-selected-hover - Aliased to `--bs-surface-selected-hover`.
+     * @prop --bs-list-item-bg-selected-pressed - Aliased to `--bs-surface-selected-pressed`.
+     * @prop --bs-list-item-bg-selected-focus - Aliased to `--bs-surface-selected-focus`.
+     * @prop --bs-list-item-bg-disabled - Aliased to `--bs-surface-action-disabled`.
+     * @prop --bs-list-item-color - Text colour. Aliased to `--bs-text-default`.
+     * @prop --bs-list-item-color-disabled - Aliased to `--bs-text-on-disabled`.
+     * @prop --bs-list-item-focus-ring - Focus ring colour. Aliased to `--bs-border-neutral-focus`.
+     * @prop --bs-list-item-image-width - Leading image width. 72px.
+     * @prop --bs-list-item-image-height - Leading image height. 56px.
+     */
+    interface BsListItem {
+        /**
+          * Second text line (the "paragraph").
+          * @default null
+         */
+        "description": string | null;
+        /**
+          * Disables the row: dimmed, not focusable, no click event.
+          * @default false
+         */
+        "disabled": boolean;
+        /**
+          * Makes a standalone row a focusable `role="button"` that emits `bsItemClick`.
+          * @default false
+         */
+        "interactive": boolean;
+        /**
+          * First text line (semibold).
+          * @default null
+         */
+        "label": string | null;
+        /**
+          * Marks the row as selected. Managed by the parent `bs-list` when it is `selectable`.
+          * @default false
+         */
+        "selected": boolean;
+        /**
+          * Set by the parent `bs-list`: `listitem` (plain list) or `option` (selectable list). Do not set by hand.
+          * @default null
+         */
+        "selectionRole": 'listitem' | 'option' | null;
+        /**
+          * Shows a trailing caret (unless the `trailing` slot has content).
+          * @default false
+         */
+        "showArrow": boolean;
+        /**
+          * Optional third text line.
+          * @default null
+         */
+        "supportText": string | null;
+        /**
+          * Identifies the item; emitted by `bsItemClick` and matched against `bs-list`'s `value`.
+          * @default null
+         */
+        "value": string | null;
+    }
+    /**
+     * The BrandSync brand mark, as its own standalone component -- shared by `bs-navigation-header`
+     * and `bs-navigation-drawer`, which used to each render their own duplicated copy of this SVG
+     * (the drawer's collapsed state even faked an icon-only look by clipping the full wordmark asset
+     * down to a narrowed box, rather than using a real icon-only asset).
+     * ## When to use
+     * - Anywhere the BrandSync logo/icon needs to render: a navigation header, a nav drawer, etc.
+     * ## When not to use
+     * - The Genie AI chat panel's own brand mark -- that's a different logo (`bs-chatbot-header`'s
+     *   own inline Genie asset), not this one.
+     * `variant` mirrors Figma's "Logo" component set (node 10909:30421) `Device` property
+     * ("Desktop" / "Tab and mobile"), which was originally meant to distinguish the full lockup from
+     * the icon-only mark at different responsive breakpoints -- renamed here to
+     * `variant: 'full' | 'mark'` since that's what it actually controls (how much of the logo
+     * renders), not literally a device/breakpoint switch.
+     * `variant="custom"` is not a Figma variant at all -- it's an escape hatch for a consuming app
+     * that needs to show a DIFFERENT product's logo in the same slot (e.g. a white-labeled deployment,
+     * or a logo fetched at runtime from a service like brand.dev), via `src`/`alt`, instead of the
+     * built-in BrandSync assets. This component deliberately does NOT fetch that image itself --
+     * network calls, loading/error states, and caching are the consuming app's responsibility, same as
+     * every other component in this library (e.g. `bs-attachment` takes `imageSrc` rather than fetching
+     * an image on its own). `background` has no effect on `variant="custom"` -- a consumer's own image
+     * is already designed for whatever surface it's placed on.
+     */
+    interface BsLogo {
+        /**
+          * `variant="custom"` only: accessible alt text for the image -- a product logo is meaningful content (whose brand is this?), not decorative, so set this to something real (e.g. the product/company name). Falls back to `alt=""` (marking the image decorative to assistive tech) when unset, rather than omitting the `alt` attribute entirely -- an `<img>` with no `alt` attribute at all is a harder accessibility failure than one explicitly marked decorative, but an empty fallback is still worse than a real name, so don't rely on it. Ignored for `full`/`mark` (those already carry their own fixed `aria-label="BrandSync"`).
+          * @default null
+         */
+        "alt": string | null;
+        /**
+          * Which pre-built asset to use for `variant="full"` -- Figma ships a genuinely separate, differently-drawn dark-background asset (every wordmark path filled solid white, and the icon's outer shape a single solid-white path instead of the light version's two-path white-fill-plus-border-ring), not a CSS currentColor swap of identical paths.  `"auto"` (default) renders both assets and lets CSS pick one via `--bs-logo-asset-light-display`/`--bs-logo-asset-dark-display` (defined in `src/global/base.css`, flipped by the same `[data-theme="dark"]` attribute every other `--bs-*` token already reacts to) -- so the logo just follows the ambient theme with no wiring needed, the same way a consuming app's own dark mode already re-themes every other part of this library via ordinary CSS custom property inheritance. Set `"light"`/`"dark"` explicitly to pin one regardless of the ambient theme -- e.g. a dark sidebar that isn't otherwise dark-themed.  Has no effect on `variant="mark"`: Figma's component set only has one real designed instance of the icon-only mark (`Device="Tab and mobile"`, `Background="Default"`) -- there's no separate dark version of it, so the mark renders identically regardless of this prop.
+          * @default 'auto'
+         */
+        "background": BsLogoBackground;
+        /**
+          * `variant="custom"` only: the image URL to render (e.g. a URL your app already fetched from a logo API). Ignored for `full`/`mark`.
+          * @default null
+         */
+        "src": string | null;
+        /**
+          * How much of the logo to render. `full` is the icon + "EG BrandSync" wordmark (190.977x44 natural size); `mark` is just the icon (44x44 natural size), no wordmark; `custom` renders a consumer-supplied image via `src`/`alt` instead of a built-in BrandSync asset -- see the class doc above.
+          * @default 'full'
+         */
+        "variant": BsLogoVariant;
+    }
+    /**
+     * A generic dropdown/popup menu container: a rounded, elevated list of items (typically
+     * `bs-menu-item` elements).
+     * ## When to use
+     * - A popup list of actions/options triggered by another control (e.g. a "more options" kebab
+     *   button), such as `bs-chatbot-response-action`'s `menu` slot.
+     * ## When not to use
+     * - A persistent, always-visible list of options -- this component is purpose-built as a popup
+     *   surface (rounded corners, elevation shadow), not a plain list.
+     * @prop --bs-menu-bg - Background of the menu box. Aliased to `--bs-surface-raised`.
+     * @prop --bs-menu-radius - Corner radius of the menu box. Aliased to `--bs-border-radius-100`.
+     * @prop --bs-menu-padding-y - Top/bottom padding of the menu box. Aliased to `--bs-spacing-50`.
+     * @prop --bs-menu-gap - Gap between slotted items. Aliased to `--bs-spacing-50`.
+     * @prop --bs-menu-shadow - Elevation shadow of the menu box. Aliased to `--bs-shadow-sm`.
+     */
+    interface BsMenu {
+    }
+    /**
+     * A single selectable row inside a `bs-menu`: an optional icon plus a text label, rendered as a
+     * real `<button>` for correct keyboard/click semantics.
+     * ## When to use
+     * - As a child of `bs-menu`, one per selectable action/option.
+     * ## When not to use
+     * - Outside of `bs-menu` -- this component's sizing/hover treatment is designed to sit inside the
+     *   menu's rounded, padded list box.
+     * @prop --bs-menu-item-radius - Corner radius of the row. Aliased to `--bs-border-radius-100`.
+     * @prop --bs-menu-item-padding-y - Top/bottom padding. Aliased to `--bs-spacing-100`.
+     * @prop --bs-menu-item-padding-x - Left/right padding. Aliased to `--bs-spacing-150`.
+     * @prop --bs-menu-item-gap - Gap between icon and label. Aliased to `--bs-spacing-100`.
+     * @prop --bs-menu-item-hover - Background on hover. Aliased to `--bs-color-neutral-container-hover`.
+     * @prop --bs-menu-item-pressed - Background when pressed. Aliased to `--bs-color-neutral-container-pressed`.
+     * @prop --bs-menu-item-disabled-bg - Background when `disabled` is set. Aliased to `--bs-surface-action-disabled`.
+     * @prop --bs-menu-item-icon-color - Icon color. Aliased to `--bs-icon-default`.
+     * @prop --bs-menu-item-icon-color-disabled - Icon color when `disabled` is set. Aliased to `--bs-icon-disabled`.
+     * @prop --bs-menu-item-color - Label text color. Aliased to `--bs-text-muted`.
+     * @prop --bs-menu-item-color-disabled - Label text color when `disabled` is set. Aliased to `--bs-text-on-disabled`.
+     * @prop --bs-menu-item-font-size - Aliased to `--bs-font-size-md`.
+     * @prop --bs-menu-item-line-height - Aliased to `--bs-line-height-body-md`.
+     */
+    interface BsMenuItem {
+        /**
+          * Disables the item: no hover/pressed/focus styling, no pointer cursor, not reachable by keyboard tabbing, and clicking it does not emit `bsSelect`.
+          * @default false
+         */
+        "disabled": boolean;
+    }
+    /**
+     * A single chat message bubble. User messages align to the end with a primary-tinted bubble;
+     * assistant messages align to the start on a neutral bubble. The consumer renders the content
+     * (e.g. markdown) into the default slot.
+     * Composed from: `bs-card` (the bubble surface).
+     * ## When to use
+     * - One entry per turn in a chat transcript, usually inside `bs-message-list`.
+     * ## When not to use
+     * - For transient notices or system banners -- use `bs-toast` / `bs-composer-status-banner`.
+     * @prop --bs-message-gap - Gap between avatar and message column. Aliased to `--bs-spacing-100`.
      * @prop --bs-message-max-width - Max width of the message column. Defaults to `80%`.
      * @prop --bs-message-padding - Bubble padding. Aliased to `--bs-spacing-150`.
      * @prop --bs-message-radius - Bubble corner radius. Aliased to `--bs-border-radius-150`.
@@ -3178,6 +3804,55 @@ export namespace Components {
          */
         "value": string;
     }
+    /**
+     * One result or suggestion row of a search dropdown: a leading icon, a primary line, an optional
+     * description line and trailing text. Static, not focusable -- focus stays in the search field and the
+     * parent (`bs-global-search`) marks the highlighted row with `active`.
+     * Standalone it has no role. `bs-global-search` sets `selectionRole="option"` (and an `id`) on its rows,
+     * the same pattern as `bs-list-item` and `bs-shortcut-row`.
+     * ## When to use
+     * - A suggestion, recent search or result inside `bs-global-search`.
+     * ## When not to use
+     * - A row in a generic list -- use `bs-list-item`.
+     * - A command in a popup menu -- use `bs-menu-item`.
+     * @prop --bs-search-item-min-height - Aliased to `--bs-spacing-600` (48px).
+     * @prop --bs-search-item-padding-y - Aliased to `--bs-spacing-100`.
+     * @prop --bs-search-item-padding-x - Aliased to `--bs-spacing-150`.
+     * @prop --bs-search-item-gap - Aliased to `--bs-spacing-100`.
+     * @prop --bs-search-item-radius - Aliased to `--bs-border-radius-100`.
+     * @prop --bs-search-item-bg - Resting background. `transparent`.
+     * @prop --bs-search-item-bg-active - Active (highlighted) and hover background. Aliased to `--bs-surface-hover`.
+     * @prop --bs-search-item-bg-pressed - Aliased to `--bs-surface-pressed`.
+     * @prop --bs-search-item-color - Primary text. Aliased to `--bs-text-default`.
+     * @prop --bs-search-item-color-muted - Description and trailing text. Aliased to `--bs-text-muted`.
+     * @prop --bs-search-item-color-disabled - Aliased to `--bs-text-on-disabled`.
+     * @prop --bs-search-item-icon-color - Aliased to `--bs-icon-default`.
+     */
+    interface BsSearchItem {
+        /**
+          * Highlighted row (keyboard or hover). Set by the parent.
+          * @default false
+         */
+        "active": boolean;
+        /**
+          * Dims the row and ignores clicks.
+          * @default false
+         */
+        "disabled": boolean;
+        /**
+          * Set by the parent (`"option"`). Standalone rows have no role.
+          * @default null
+         */
+        "selectionRole": 'option' | null;
+        /**
+          * Trailing text shorthand. The `trailing` slot overrides it.
+         */
+        "trailing"?: string;
+        /**
+          * Identifies the item; emitted by `bsItemSelect`.
+         */
+        "value"?: string;
+    }
     /**
      * The three moments around an expiring session, as one card. Matches the Figma "Session timeout"
      * component's three types:
@@ -3302,6 +3977,46 @@ export namespace Components {
          */
         "type": BsSessionTimeoutType;
     }
+    /**
+     * One row of a shortcut list: an action label on the left and its keyboard shortcut on the right.
+     * Static information, not interactive. Standalone it has no role; `bs-keyboard-shortcuts` sets
+     * `selectionRole="listitem"` on its rows (same pattern as `bs-list-item`).
+     * Built from `bs-key-caps` (and so `bs-key`).
+     * ## When to use
+     * - A line in a keyboard-shortcut reference, usually inside `bs-keyboard-shortcuts`.
+     * ## When not to use
+     * - A clickable command or menu entry -- use `bs-menu-item` (which has its own shortcut slot).
+     * @prop --bs-shortcut-row-height - Row height. Defaults to `36px` (Figma).
+     * @prop --bs-shortcut-row-padding-x - Horizontal padding. Aliased to `--bs-spacing-100`.
+     * @prop --bs-shortcut-row-gap - Gap between label and keys. Aliased to `--bs-spacing-100`.
+     * @prop --bs-shortcut-row-radius - Corner radius. Aliased to `--bs-border-radius-75`.
+     * @prop --bs-shortcut-row-color - Label colour. Aliased to `--bs-text-default`.
+     * @prop --bs-shortcut-row-color-disabled - Label colour while `disabled`. Aliased to `--bs-text-on-disabled`.
+     */
+    interface BsShortcutRow {
+        /**
+          * The action, e.g. "Save". The default slot overrides it.
+         */
+        "action"?: string;
+        /**
+          * Dims the label and the keys.
+          * @default false
+         */
+        "disabled": boolean;
+        /**
+          * The keys, e.g. `"Ctrl+S"`, or an array (`['Ctrl', '+']`) for a literal plus key. See `bs-key-caps`.
+         */
+        "keys"?: string | string[];
+        /**
+          * Accessible name of the key caps, e.g. "Control plus S". Defaults to the keys joined with "plus".
+         */
+        "label"?: string;
+        /**
+          * Set by the parent list (`"listitem"`). Standalone rows have no role.
+          * @default null
+         */
+        "selectionRole": 'listitem' | null;
+    }
     /**
      * A generic slide-in panel (drawer) anchored to the start or end edge, for history, filters, FAQ
      * and similar secondary content. Closes via its close button or Escape and emits `bsClose`.
@@ -4090,31 +4805,112 @@ export namespace Components {
         "text": string;
     }
     /**
-     * A product's "What's new" surface, in three forms matching the Figma component:
-     * - `feed` -- a docked panel: heading, "Mark all as read", filter tabs, the list of updates (each a
-     *   `bs-whats-new-entry`) and a link to the full release notes.
-     * - `announcement` -- one big update, with a hero image, a tag, a heading, a few bullet points, "1 of 3"
-     *   and Remind me later / Next.
-     * - `teaser` -- a small card pointing at the feed: tag, date, heading, a line of text and "Open What's new".
-     * The component only shows what you give it and reports what the user pressed. It doesn't fetch updates,
-     * track which the user has seen, or decide when to appear: your app owns `entries` (with their `unread`
-     * flags) and reacts to the events.
-     * **Built from:** `bs-card` (the surface), `bs-whats-new-entry` (each update), `bs-tabs` (the filters),
-     * `bs-chip-informative` (the tags), `bs-button`, `bs-icon-button`.
-     * ## When to use
-     * - Telling users about changes to the product, in a place they can come back to.
-     * ## When not to use
-     * - Messages about the user's own data or an action they just took -- use `bs-snackbar`, `bs-toast`.
-     * - A guided walk through the interface -- use `bs-product-tour`.
+     * A hierarchical list of `bs-tree-item` rows with single selection, expand/collapse and the
+     * WAI-ARIA tree keyboard pattern.
+     * The tree owns `role="tree"`, the roving `tabindex` (exactly one enabled, visible item is
+     * tabbable: the selected one, otherwise the first), selection (kept in sync with each item's
+     * `selected`) and keyboard navigation over the visible (rendered, non-disabled) items. Items own
+     * their expansion state and emit `bsSelect` / `bsToggle`.
+     * Built from: `bs-tree-item` rows.
      */
-    interface BsWhatsNew {
+    interface BsTree {
         /**
-          * Label of the link (`teaser`).
-          * @default 'Open What’s new'
+          * Accessible name of the tree. Bound onto the internal `role="tree"` element (an `aria-label` on the host would not reach it).
+          * @default null
          */
-        "actionLabel": string;
+        "ariaLabel": string | null;
         /**
-          * Shows a close button.
+          * Collapses every parent item.
+         */
+        "collapseAll": () => Promise<void>;
+        /**
+          * Expands every parent item.
+         */
+        "expandAll": () => Promise<void>;
+        /**
+          * When `false`, rows do not select (clicks and Enter/Space do nothing) but parents still expand and collapse.
+          * @default true
+         */
+        "selectable": boolean;
+        /**
+          * The `value` (or, when empty, the `label`) of the selected item. Two-way synced with each item's `selected` (single selection). Setting it from code does not emit `bsChange`.
+          * @default ''
+         */
+        "value": string;
+    }
+    /**
+     * A single row of a `bs-tree`. An item that contains child `bs-tree-item` elements is a parent
+     * (it gets an expand/collapse caret and a folder icon); an item without children is a leaf (no
+     * caret, file icon).
+     * The host carries `role="treeitem"` and the `aria-*` state; the owning `bs-tree` manages the
+     * roving `tabindex`, selection and keyboard navigation. Nesting depth is computed automatically
+     * from the number of ancestor `bs-tree-item` elements and exposed as `aria-level` -- it is not a
+     * prop. Clicking the row selects it; clicking the caret (or pressing Right/Left in a tree) toggles
+     * expansion -- the two are deliberately separate.
+     * Built from: inline SVG icons only (no existing `bs-*` component covers a tree row).
+     */
+    interface BsTreeItem {
+        /**
+          * Disables the row: not focusable, ignores clicks, dimmed. Reflected.
+          * @default false
+         */
+        "disabled": boolean;
+        /**
+          * Whether the child items are shown. Only meaningful for parents. Mutable: the caret, the keyboard and the owning tree toggle it. Reflected.
+          * @default false
+         */
+        "expanded": boolean;
+        /**
+          * The row's text. Use the `label` slot for rich content.
+          * @default ''
+         */
+        "label": string;
+        /**
+          * Marks the row as selected. Owned by the tree (single selection, synced with its `value`). Reflected.
+          * @default false
+         */
+        "selected": boolean;
+        /**
+          * Sets `expanded` as a user action: updates the prop and emits `bsToggle`. No-op for leaves, disabled items, or when the value would not change.
+         */
+        "setExpanded": (next: boolean) => Promise<void>;
+        /**
+          * Shows the leading icon (default folder / file, or the `icon` slot).
+          * @default true
+         */
+        "showIcon": boolean;
+        /**
+          * Identifier used in events and for the tree's `value`. Falls back to `label` when empty.
+          * @default ''
+         */
+        "value": string;
+    }
+    /**
+     * A product's "What's new" surface, in three forms matching the Figma component:
+     * - `feed` -- a docked panel: heading, "Mark all as read", filter tabs, the list of updates (each a
+     *   `bs-whats-new-entry`) and a link to the full release notes.
+     * - `announcement` -- one big update, with a hero image, a tag, a heading, a few bullet points, "1 of 3"
+     *   and Remind me later / Next.
+     * - `teaser` -- a small card pointing at the feed: tag, date, heading, a line of text and "Open What's new".
+     * The component only shows what you give it and reports what the user pressed. It doesn't fetch updates,
+     * track which the user has seen, or decide when to appear: your app owns `entries` (with their `unread`
+     * flags) and reacts to the events.
+     * **Built from:** `bs-card` (the surface), `bs-whats-new-entry` (each update), `bs-tabs` (the filters),
+     * `bs-chip-informative` (the tags), `bs-button`, `bs-icon-button`.
+     * ## When to use
+     * - Telling users about changes to the product, in a place they can come back to.
+     * ## When not to use
+     * - Messages about the user's own data or an action they just took -- use `bs-snackbar`, `bs-toast`.
+     * - A guided walk through the interface -- use `bs-product-tour`.
+     */
+    interface BsWhatsNew {
+        /**
+          * Label of the link (`teaser`).
+          * @default 'Open What’s new'
+         */
+        "actionLabel": string;
+        /**
+          * Shows a close button.
           * @default false
          */
         "closable": boolean;
@@ -4338,6 +5134,10 @@ export interface BsCitationPreviewCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsCitationPreviewElement;
 }
+export interface BsCommandPaletteCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsCommandPaletteElement;
+}
 export interface BsComposerCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsComposerElement;
@@ -4374,6 +5174,10 @@ export interface BsFileUploadItemCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsFileUploadItemElement;
 }
+export interface BsGlobalSearchCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsGlobalSearchElement;
+}
 export interface BsInlineTabCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsInlineTabElement;
@@ -4382,6 +5186,18 @@ export interface BsInputCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsInputElement;
 }
+export interface BsKeyboardShortcutsCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsKeyboardShortcutsElement;
+}
+export interface BsListCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsListElement;
+}
+export interface BsListItemCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsListItemElement;
+}
 export interface BsMenuItemCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsMenuItemElement;
@@ -4422,6 +5238,10 @@ export interface BsRadioCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsRadioElement;
 }
+export interface BsSearchItemCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsSearchItemElement;
+}
 export interface BsSessionTimeoutCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsSessionTimeoutElement;
@@ -4466,6 +5286,14 @@ export interface BsToastCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsToastElement;
 }
+export interface BsTreeCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsTreeElement;
+}
+export interface BsTreeItemCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsTreeItemElement;
+}
 export interface BsWhatsNewCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsWhatsNewElement;
@@ -5352,6 +6180,57 @@ declare global {
         prototype: HTMLBsCitationPreviewElement;
         new (): HTMLBsCitationPreviewElement;
     };
+    interface HTMLBsCommandPaletteElementEventMap {
+        "bsInput": BsCommandPaletteInputDetail;
+        "bsSelect": BsCommandPaletteSelectDetail;
+        "bsSuggestion": string;
+        "bsOpenChange": boolean;
+        "bsScopeExit": void;
+    }
+    /**
+     * A Ctrl+K command palette: a modal with a search field, grouped commands, navigation and records, a
+     * no-results view and a keyboard-hint footer. The data, the filtering, the command registry and the
+     * recent-items storage are all yours: you slot `bs-search-item`s into the sections and set `status`.
+     * Built from a native `<dialog>` (opened with `showModal()`, so focus is trapped, the page behind is inert
+     * and the backdrop is the scrim), `bs-input` (type="search"), `bs-search-item`, `bs-key` (footer hints and
+     * the Esc cap), `bs-chip-informative` (the scope chip) and `bs-spinner` (loading). Slot a `bs-key-caps` with
+     * `slot="trailing"` inside an item to show a command's shortcut.
+     * ## When to use
+     * - An app-wide "do anything" entry point opened with a hotkey: run commands, navigate, open records.
+     * ## When not to use
+     * - A plain search box with a dropdown -- use `bs-global-search`.
+     * - A small list of actions on one control -- use `bs-menu`.
+     * A `>` as the first character of the field switches to commands-only mode (`commandsOnly`, reflected as
+     * `commands-only`). The component filters nothing: listen to `bsInput`, swap the slotted items, set `status`.
+     * Nested (sub-command) palettes are a consumer pattern: swap the slotted commands and set `scopeLabel`.
+     * @prop --bs-command-palette-width - Panel width. Defaults to `640px` (Figma); capped to the viewport.
+     * @prop --bs-command-palette-top - Distance from the top of the viewport. Defaults to `12vh`.
+     * @prop --bs-command-palette-max-height - Max height of the results area. Defaults to `60vh`.
+     * @prop --bs-command-palette-radius - Aliased to `--bs-border-radius-150`.
+     * @prop --bs-command-palette-bg - Panel background. Aliased to `--bs-surface-base`.
+     * @prop --bs-command-palette-shadow - Figma elevation level 4: `0 8px 16px` in `--bs-elevation-higher` (stronger in dark mode).
+     * @prop --bs-command-palette-overlay - Scrim colour. Aliased to `--bs-surface-overlay`.
+     * @prop --bs-command-palette-footer-bg - Aliased to `--bs-surface-container`.
+     * @prop --bs-command-palette-divider-color - Aliased to `--bs-border-default`.
+     * @prop --bs-command-palette-header-border-color - Aliased to `--bs-border-neutral-container`.
+     * @prop --bs-command-palette-header-color - Aliased to `--bs-text-muted`.
+     * @prop --bs-command-palette-hint-color - Aliased to `--bs-text-secondary`.
+     * @prop --bs-command-palette-z-index - Aliased to `--bs-z-index-modal`.
+     */
+    interface HTMLBsCommandPaletteElement extends Components.BsCommandPalette, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsCommandPaletteElementEventMap>(type: K, listener: (this: HTMLBsCommandPaletteElement, ev: BsCommandPaletteCustomEvent<HTMLBsCommandPaletteElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLBsCommandPaletteElementEventMap>(type: K, listener: (this: HTMLBsCommandPaletteElement, ev: BsCommandPaletteCustomEvent<HTMLBsCommandPaletteElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLBsCommandPaletteElement: {
+        prototype: HTMLBsCommandPaletteElement;
+        new (): HTMLBsCommandPaletteElement;
+    };
     interface HTMLBsComposerElementEventMap {
         "bsInput": string;
         "bsSubmit": void;
@@ -5667,6 +6546,29 @@ declare global {
         prototype: HTMLBsDividerElement;
         new (): HTMLBsDividerElement;
     };
+    /**
+     * A centered "nothing to show" block: an icon tile, a heading, a description and an optional action.
+     * Used for empty lists, "no results" and error states inside a panel, card or page section.
+     * Built from `bs-icon-tile` (and, in your `action` slot, usually a `bs-button`).
+     * The component has no role. Live regions belong on a wrapper you control (e.g. `role="status"` on the
+     * element that stays in the DOM while this block appears and disappears).
+     * ## When to use
+     * - A list, table or search result that has nothing to show, or failed to load.
+     * ## When not to use
+     * - A full-page error with a status code -- use `bs-error-page`.
+     * - A transient message -- use `bs-toast` or `bs-snackbar`.
+     * @prop --bs-empty-state-padding-y - Vertical padding. Aliased to `--bs-spacing-700` (56px).
+     * @prop --bs-empty-state-padding-x - Horizontal padding. Aliased to `--bs-spacing-300` (24px).
+     * @prop --bs-empty-state-gap - Gap between tile, heading, description and action. Aliased to `--bs-spacing-150`.
+     * @prop --bs-empty-state-heading-color - Aliased to `--bs-text-default`.
+     * @prop --bs-empty-state-description-color - Aliased to `--bs-text-secondary`.
+     */
+    interface HTMLBsEmptyStateElement extends Components.BsEmptyState, HTMLStencilElement {
+    }
+    var HTMLBsEmptyStateElement: {
+        prototype: HTMLBsEmptyStateElement;
+        new (): HTMLBsEmptyStateElement;
+    };
     interface HTMLBsErrorPageElementEventMap {
         "bsPrimary": void;
         "bsSecondary": void;
@@ -5757,6 +6659,60 @@ declare global {
         prototype: HTMLBsFileUploadItemElement;
         new (): HTMLBsFileUploadItemElement;
     };
+    interface HTMLBsGlobalSearchElementEventMap {
+        "bsInput": string;
+        "bsSearch": string;
+        "bsSelect": BsGlobalSearchSelectDetail;
+        "bsOpenChange": boolean;
+        "bsClearRecent": void;
+        "bsClearSearch": void;
+        "bsSeeAll": void;
+        "bsRetry": void;
+    }
+    /**
+     * A global search combobox: a search field with a dropdown panel of suggestions, results, an empty state
+     * or an error state, plus a keyboard-hint footer. The data, the filtering and the recent-search storage
+     * are all yours: you slot `bs-search-item`s into the sections and tell the component which `status` to show.
+     * Built from `bs-input` (type="search"), `bs-search-item`, `bs-empty-state` (and so `bs-icon-tile`),
+     * `bs-button` and `bs-key` (the footer keycaps).
+     * ## When to use
+     * - An app-wide "find anything" field with recent searches, jump-to shortcuts and grouped results.
+     * ## When not to use
+     * - Filtering the list or table that is already on screen -- use `bs-input type="search"`.
+     * - A list of commands or actions -- use `bs-menu`.
+     * - The complete result set -- link to a full search results page ("See all results").
+     * Put `bs-search-item` children in the light DOM with `slot="recent"`, `slot="jump-to"`,
+     * `slot="top-matches"` or `slot="search-in"`. A section (and its header) is only rendered when its slot has
+     * content. Up/Down arrows move a highlight through the visible items; focus never leaves the field.
+     * Known limit: the items are in your light DOM and the combobox in this shadow root, so
+     * `aria-activedescendant` (an id reference) does not resolve across that boundary in every browser; the
+     * highlighted option also gets `aria-selected="true"`.
+     * @prop --bs-global-search-width - Field and panel width. Defaults to `480px` (Figma); capped at 100%.
+     * @prop --bs-global-search-panel-radius - Aliased to `--bs-border-radius-100`.
+     * @prop --bs-global-search-panel-padding - Aliased to `--bs-spacing-100`.
+     * @prop --bs-global-search-gap - Gap between sections, and between the field and the panel. Aliased to `--bs-spacing-100`.
+     * @prop --bs-global-search-panel-bg - Panel background. Aliased to `--bs-surface-base`.
+     * @prop --bs-global-search-shadow - Panel shadow: Figma elevation level 3 (`0 4px 8px` in `--bs-elevation-high`, 10% black in light mode and 30% in dark mode).
+     * @prop --bs-global-search-z-index - Panel stacking. Aliased to `--bs-z-index-dropdown`.
+     * @prop --bs-global-search-divider-color - Footer divider. Aliased to `--bs-border-default`.
+     * @prop --bs-global-search-header-border-color - Section header underline. Aliased to `--bs-border-neutral-container`.
+     * @prop --bs-global-search-header-color - Section header text. Aliased to `--bs-text-muted`.
+     * @prop --bs-global-search-hint-color - Footer hint text. Aliased to `--bs-text-secondary`.
+     */
+    interface HTMLBsGlobalSearchElement extends Components.BsGlobalSearch, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsGlobalSearchElementEventMap>(type: K, listener: (this: HTMLBsGlobalSearchElement, ev: BsGlobalSearchCustomEvent<HTMLBsGlobalSearchElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLBsGlobalSearchElementEventMap>(type: K, listener: (this: HTMLBsGlobalSearchElement, ev: BsGlobalSearchCustomEvent<HTMLBsGlobalSearchElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLBsGlobalSearchElement: {
+        prototype: HTMLBsGlobalSearchElement;
+        new (): HTMLBsGlobalSearchElement;
+    };
     /**
      * A CSS grid layout wrapper. Children are placed in equal-width columns with a token-based gap.
      * `columns` takes either a number (`"3"` becomes `repeat(3, minmax(0, 1fr))`) or any raw
@@ -5904,6 +6860,173 @@ declare global {
         prototype: HTMLBsInputElement;
         new (): HTMLBsInputElement;
     };
+    /**
+     * One key of a keyboard shortcut, e.g. `Ctrl`, `K` or `Esc` -- rendered as a `<kbd>` keycap.
+     * Shows a text label, or an icon (e.g. a return arrow) via the `icon` slot.
+     * ## When to use
+     * - Showing a keyboard shortcut hint next to a control or inside a search field.
+     * - Alone for a single key, or as the children of `bs-key-caps` for a multi-key shortcut.
+     * ## When not to use
+     * - As a button or any clickable control -- a key is a static hint, not interactive.
+     * @prop --bs-key-bg - Cap background. Aliased to `--bs-surface-base`.
+     * @prop --bs-key-border-color - Cap border colour. Aliased to `--bs-border-default`.
+     * @prop --bs-key-radius - Cap corner radius. Aliased to `--bs-border-radius-50`.
+     * @prop --bs-key-padding-x - Horizontal padding. Aliased to `--bs-spacing-75`.
+     * @prop --bs-key-padding-y - Vertical padding. Aliased to `--bs-spacing-50`.
+     * @prop --bs-key-min-width - Smallest cap width, so single characters keep a keycap shape. Defaults to `25px` (Figma).
+     * @prop --bs-key-color - Label colour. Aliased to `--bs-text-secondary`.
+     * @prop --bs-key-font-size - Label size. Aliased to `--bs-font-size-xs` (12px).
+     * @prop --bs-key-icon-size - Icon size. Defaults to `16px` (Figma).
+     */
+    interface HTMLBsKeyElement extends Components.BsKey, HTMLStencilElement {
+    }
+    var HTMLBsKeyElement: {
+        prototype: HTMLBsKeyElement;
+        new (): HTMLBsKeyElement;
+    };
+    /**
+     * A keyboard shortcut of one to four keys joined by "+", e.g. `Ctrl + K`. Give it a `keys` string
+     * (`"Ctrl+Shift+K"`) or array (`['Ctrl', '+']` for a literal plus key), or slot your own `bs-key`
+     * elements -- for example when a key is an icon.
+     * ## When to use
+     * - A shortcut hint beside a menu item, button or inside a search field.
+     * ## When not to use
+     * - Instructions that need prose ("press Enter to submit") -- write a sentence and use a single `bs-key` inline.
+     * - Anything interactive -- keys are static hints.
+     * @prop --bs-key-caps-gap - Gap between keys and separators. Aliased to `--bs-spacing-100`.
+     * @prop --bs-key-caps-separator-color - Colour of the "+" separators. Aliased to `--bs-text-muted`.
+     * @prop --bs-key-caps-disabled-opacity - Opacity of the whole shortcut while `disabled`. Defaults to `0.38` (Figma).
+     */
+    interface HTMLBsKeyCapsElement extends Components.BsKeyCaps, HTMLStencilElement {
+    }
+    var HTMLBsKeyCapsElement: {
+        prototype: HTMLBsKeyCapsElement;
+        new (): HTMLBsKeyCapsElement;
+    };
+    interface HTMLBsKeyboardShortcutsElementEventMap {
+        "bsClose": void;
+        "bsQueryChange": string;
+        "bsSingleKeyChange": boolean;
+    }
+    /**
+     * A searchable reference panel of keyboard shortcuts: heading and close button, a search field, an
+     * optional single-key on/off switch, shortcut groups in two columns and a footer hint. It is a
+     * surface, not a modal -- place it inside `bs-dialog` or a popover.
+     * Built from `bs-card`, `bs-icon-button`, `bs-input`, `bs-switch`, `bs-shortcut-row` (and so
+     * `bs-key-caps` / `bs-key`).
+     * ## When to use
+     * - A "press ? to see shortcuts" help overlay for an app with many shortcuts.
+     * ## When not to use
+     * - A long-form help page or documentation -- link to it instead.
+     * - A list of commands the user can run from it -- use `bs-menu`.
+     * @prop --bs-keyboard-shortcuts-width - Panel width and min-width. Defaults to `720px` (Figma).
+     * @prop --bs-keyboard-shortcuts-bg - Panel background. Aliased to `--bs-surface-base`.
+     * @prop --bs-keyboard-shortcuts-radius - Aliased to `--bs-border-radius-150`.
+     * @prop --bs-keyboard-shortcuts-padding - Aliased to `--bs-spacing-200`.
+     * @prop --bs-keyboard-shortcuts-gap - Gap between sections. Aliased to `--bs-spacing-200`.
+     * @prop --bs-keyboard-shortcuts-shadow - Figma elevation level 4 (`0 8px 8px` in `--bs-elevation-higher`, 12% black in light mode and 25% in dark mode).
+     * @prop --bs-keyboard-shortcuts-column-gap - Gap between the two columns. Aliased to `--bs-spacing-600`.
+     * @prop --bs-keyboard-shortcuts-color - Main text colour. Aliased to `--bs-text-default`.
+     * @prop --bs-keyboard-shortcuts-color-secondary - Titles, captions, footer. Aliased to `--bs-text-secondary`.
+     */
+    interface HTMLBsKeyboardShortcutsElement extends Components.BsKeyboardShortcuts, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsKeyboardShortcutsElementEventMap>(type: K, listener: (this: HTMLBsKeyboardShortcutsElement, ev: BsKeyboardShortcutsCustomEvent<HTMLBsKeyboardShortcutsElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLBsKeyboardShortcutsElementEventMap>(type: K, listener: (this: HTMLBsKeyboardShortcutsElement, ev: BsKeyboardShortcutsCustomEvent<HTMLBsKeyboardShortcutsElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLBsKeyboardShortcutsElement: {
+        prototype: HTMLBsKeyboardShortcutsElement;
+        new (): HTMLBsKeyboardShortcutsElement;
+    };
+    interface HTMLBsListElementEventMap {
+        "bsChange": string | null;
+    }
+    /**
+     * A vertical list of `bs-list-item` rows, optionally single-select.
+     * ## When to use
+     * - Records, people, files or options shown as rows with leading media and descriptions.
+     * - `selectable` for a single-choice list (e.g. a conversation list next to a detail pane).
+     * ## When not to use
+     * - A popup list of actions -- use `bs-menu`.
+     * - Navigation between app sections -- use `bs-navigation-drawer`.
+     * - Multi-column, sortable or paged data -- use `bs-data-table`.
+     * Built from `bs-list-item` children (light DOM; the list never moves nodes).
+     * @prop --bs-list-gap - Gap between rows. Defaults to `0`.
+     * @prop --bs-list-divider-color - Divider colour when `dividers` is set. Aliased to `--bs-border-neutral-container`.
+     */
+    interface HTMLBsListElement extends Components.BsList, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsListElementEventMap>(type: K, listener: (this: HTMLBsListElement, ev: BsListCustomEvent<HTMLBsListElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLBsListElementEventMap>(type: K, listener: (this: HTMLBsListElement, ev: BsListCustomEvent<HTMLBsListElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLBsListElement: {
+        prototype: HTMLBsListElement;
+        new (): HTMLBsListElement;
+    };
+    interface HTMLBsListItemElementEventMap {
+        "bsItemClick": string | null;
+    }
+    /**
+     * A single row of a list: optional leading media (avatar, icon, image), a label, a description and
+     * optional support text, and an optional trailing caret or custom trailing content.
+     * ## When to use
+     * - As a child of `bs-list`, one per record, person, file or option.
+     * - Standalone as a plain information row (non-interactive), or with `interactive` as a button-like row.
+     * ## When not to use
+     * - A popup list of actions -- use `bs-menu` / `bs-menu-item`.
+     * - App navigation with an active route -- use `bs-navigation-drawer-item`.
+     * - Tabular data with columns, sorting or paging -- use `bs-data-table`.
+     * Composed from: leading media (`bs-avatar`) and trailing controls (`bs-icon-button`) are supplied by the
+     * consumer through the `leading` and `trailing` slots; the row itself only reserves layout. The default
+     * trailing caret is inline SVG.
+     * Roles are driven by the parent `bs-list` (via `selectionRole`). Standalone, the row has no role
+     * (`listitem` is only valid inside a list) unless `interactive` is set, which makes it a focusable
+     * `role="button"`.
+     * @prop --bs-list-item-min-height - Minimum row height. Aliased to `--bs-spacing-1000`.
+     * @prop --bs-list-item-padding-y - Aliased to `--bs-spacing-150`.
+     * @prop --bs-list-item-padding-x - Aliased to `--bs-spacing-200`.
+     * @prop --bs-list-item-gap - Gap between leading, content and trailing. Aliased to `--bs-spacing-200`.
+     * @prop --bs-list-item-content-gap - Gap between text lines. Aliased to `--bs-spacing-25`.
+     * @prop --bs-list-item-radius - Aliased to `--bs-border-radius-100`.
+     * @prop --bs-list-item-bg - Enabled background. `transparent`.
+     * @prop --bs-list-item-bg-hover - Aliased to `--bs-surface-hover`.
+     * @prop --bs-list-item-bg-pressed - Aliased to `--bs-surface-pressed`.
+     * @prop --bs-list-item-bg-focus - Aliased to `--bs-surface-focus`.
+     * @prop --bs-list-item-bg-selected - Aliased to `--bs-surface-selected`.
+     * @prop --bs-list-item-bg-selected-hover - Aliased to `--bs-surface-selected-hover`.
+     * @prop --bs-list-item-bg-selected-pressed - Aliased to `--bs-surface-selected-pressed`.
+     * @prop --bs-list-item-bg-selected-focus - Aliased to `--bs-surface-selected-focus`.
+     * @prop --bs-list-item-bg-disabled - Aliased to `--bs-surface-action-disabled`.
+     * @prop --bs-list-item-color - Text colour. Aliased to `--bs-text-default`.
+     * @prop --bs-list-item-color-disabled - Aliased to `--bs-text-on-disabled`.
+     * @prop --bs-list-item-focus-ring - Focus ring colour. Aliased to `--bs-border-neutral-focus`.
+     * @prop --bs-list-item-image-width - Leading image width. 72px.
+     * @prop --bs-list-item-image-height - Leading image height. 56px.
+     */
+    interface HTMLBsListItemElement extends Components.BsListItem, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsListItemElementEventMap>(type: K, listener: (this: HTMLBsListItemElement, ev: BsListItemCustomEvent<HTMLBsListItemElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLBsListItemElementEventMap>(type: K, listener: (this: HTMLBsListItemElement, ev: BsListItemCustomEvent<HTMLBsListItemElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLBsListItemElement: {
+        prototype: HTMLBsListItemElement;
+        new (): HTMLBsListItemElement;
+    };
     /**
      * The BrandSync brand mark, as its own standalone component -- shared by `bs-navigation-header`
      * and `bs-navigation-drawer`, which used to each render their own duplicated copy of this SVG
@@ -6439,6 +7562,47 @@ declare global {
         prototype: HTMLBsRadioElement;
         new (): HTMLBsRadioElement;
     };
+    interface HTMLBsSearchItemElementEventMap {
+        "bsItemSelect": string | undefined;
+    }
+    /**
+     * One result or suggestion row of a search dropdown: a leading icon, a primary line, an optional
+     * description line and trailing text. Static, not focusable -- focus stays in the search field and the
+     * parent (`bs-global-search`) marks the highlighted row with `active`.
+     * Standalone it has no role. `bs-global-search` sets `selectionRole="option"` (and an `id`) on its rows,
+     * the same pattern as `bs-list-item` and `bs-shortcut-row`.
+     * ## When to use
+     * - A suggestion, recent search or result inside `bs-global-search`.
+     * ## When not to use
+     * - A row in a generic list -- use `bs-list-item`.
+     * - A command in a popup menu -- use `bs-menu-item`.
+     * @prop --bs-search-item-min-height - Aliased to `--bs-spacing-600` (48px).
+     * @prop --bs-search-item-padding-y - Aliased to `--bs-spacing-100`.
+     * @prop --bs-search-item-padding-x - Aliased to `--bs-spacing-150`.
+     * @prop --bs-search-item-gap - Aliased to `--bs-spacing-100`.
+     * @prop --bs-search-item-radius - Aliased to `--bs-border-radius-100`.
+     * @prop --bs-search-item-bg - Resting background. `transparent`.
+     * @prop --bs-search-item-bg-active - Active (highlighted) and hover background. Aliased to `--bs-surface-hover`.
+     * @prop --bs-search-item-bg-pressed - Aliased to `--bs-surface-pressed`.
+     * @prop --bs-search-item-color - Primary text. Aliased to `--bs-text-default`.
+     * @prop --bs-search-item-color-muted - Description and trailing text. Aliased to `--bs-text-muted`.
+     * @prop --bs-search-item-color-disabled - Aliased to `--bs-text-on-disabled`.
+     * @prop --bs-search-item-icon-color - Aliased to `--bs-icon-default`.
+     */
+    interface HTMLBsSearchItemElement extends Components.BsSearchItem, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsSearchItemElementEventMap>(type: K, listener: (this: HTMLBsSearchItemElement, ev: BsSearchItemCustomEvent<HTMLBsSearchItemElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLBsSearchItemElementEventMap>(type: K, listener: (this: HTMLBsSearchItemElement, ev: BsSearchItemCustomEvent<HTMLBsSearchItemElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLBsSearchItemElement: {
+        prototype: HTMLBsSearchItemElement;
+        new (): HTMLBsSearchItemElement;
+    };
     interface HTMLBsSessionTimeoutElementEventMap {
         "bsPrimary": { password?: string } | void;
         "bsSecondary": void;
@@ -6486,6 +7650,28 @@ declare global {
         prototype: HTMLBsSessionTimeoutElement;
         new (): HTMLBsSessionTimeoutElement;
     };
+    /**
+     * One row of a shortcut list: an action label on the left and its keyboard shortcut on the right.
+     * Static information, not interactive. Standalone it has no role; `bs-keyboard-shortcuts` sets
+     * `selectionRole="listitem"` on its rows (same pattern as `bs-list-item`).
+     * Built from `bs-key-caps` (and so `bs-key`).
+     * ## When to use
+     * - A line in a keyboard-shortcut reference, usually inside `bs-keyboard-shortcuts`.
+     * ## When not to use
+     * - A clickable command or menu entry -- use `bs-menu-item` (which has its own shortcut slot).
+     * @prop --bs-shortcut-row-height - Row height. Defaults to `36px` (Figma).
+     * @prop --bs-shortcut-row-padding-x - Horizontal padding. Aliased to `--bs-spacing-100`.
+     * @prop --bs-shortcut-row-gap - Gap between label and keys. Aliased to `--bs-spacing-100`.
+     * @prop --bs-shortcut-row-radius - Corner radius. Aliased to `--bs-border-radius-75`.
+     * @prop --bs-shortcut-row-color - Label colour. Aliased to `--bs-text-default`.
+     * @prop --bs-shortcut-row-color-disabled - Label colour while `disabled`. Aliased to `--bs-text-on-disabled`.
+     */
+    interface HTMLBsShortcutRowElement extends Components.BsShortcutRow, HTMLStencilElement {
+    }
+    var HTMLBsShortcutRowElement: {
+        prototype: HTMLBsShortcutRowElement;
+        new (): HTMLBsShortcutRowElement;
+    };
     interface HTMLBsSidePanelElementEventMap {
         "bsClose": void;
     }
@@ -7005,6 +8191,61 @@ declare global {
         prototype: HTMLBsTooltipTriggerElement;
         new (): HTMLBsTooltipTriggerElement;
     };
+    interface HTMLBsTreeElementEventMap {
+        "bsChange": string;
+    }
+    /**
+     * A hierarchical list of `bs-tree-item` rows with single selection, expand/collapse and the
+     * WAI-ARIA tree keyboard pattern.
+     * The tree owns `role="tree"`, the roving `tabindex` (exactly one enabled, visible item is
+     * tabbable: the selected one, otherwise the first), selection (kept in sync with each item's
+     * `selected`) and keyboard navigation over the visible (rendered, non-disabled) items. Items own
+     * their expansion state and emit `bsSelect` / `bsToggle`.
+     * Built from: `bs-tree-item` rows.
+     */
+    interface HTMLBsTreeElement extends Components.BsTree, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsTreeElementEventMap>(type: K, listener: (this: HTMLBsTreeElement, ev: BsTreeCustomEvent<HTMLBsTreeElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLBsTreeElementEventMap>(type: K, listener: (this: HTMLBsTreeElement, ev: BsTreeCustomEvent<HTMLBsTreeElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLBsTreeElement: {
+        prototype: HTMLBsTreeElement;
+        new (): HTMLBsTreeElement;
+    };
+    interface HTMLBsTreeItemElementEventMap {
+        "bsToggle": boolean;
+        "bsSelect": string;
+    }
+    /**
+     * A single row of a `bs-tree`. An item that contains child `bs-tree-item` elements is a parent
+     * (it gets an expand/collapse caret and a folder icon); an item without children is a leaf (no
+     * caret, file icon).
+     * The host carries `role="treeitem"` and the `aria-*` state; the owning `bs-tree` manages the
+     * roving `tabindex`, selection and keyboard navigation. Nesting depth is computed automatically
+     * from the number of ancestor `bs-tree-item` elements and exposed as `aria-level` -- it is not a
+     * prop. Clicking the row selects it; clicking the caret (or pressing Right/Left in a tree) toggles
+     * expansion -- the two are deliberately separate.
+     * Built from: inline SVG icons only (no existing `bs-*` component covers a tree row).
+     */
+    interface HTMLBsTreeItemElement extends Components.BsTreeItem, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsTreeItemElementEventMap>(type: K, listener: (this: HTMLBsTreeItemElement, ev: BsTreeItemCustomEvent<HTMLBsTreeItemElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLBsTreeItemElementEventMap>(type: K, listener: (this: HTMLBsTreeItemElement, ev: BsTreeItemCustomEvent<HTMLBsTreeItemElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLBsTreeItemElement: {
+        prototype: HTMLBsTreeItemElement;
+        new (): HTMLBsTreeItemElement;
+    };
     interface HTMLBsWhatsNewElementEventMap {
         "bsMarkAllRead": void;
         "bsEntryAction": { id: string };
@@ -7103,6 +8344,7 @@ declare global {
         "bs-chip-informative": HTMLBsChipInformativeElement;
         "bs-chip-input": HTMLBsChipInputElement;
         "bs-citation-preview": HTMLBsCitationPreviewElement;
+        "bs-command-palette": HTMLBsCommandPaletteElement;
         "bs-composer": HTMLBsComposerElement;
         "bs-composer-status-banner": HTMLBsComposerStatusBannerElement;
         "bs-container": HTMLBsContainerElement;
@@ -7111,14 +8353,21 @@ declare global {
         "bs-datepicker": HTMLBsDatepickerElement;
         "bs-dialog": HTMLBsDialogElement;
         "bs-divider": HTMLBsDividerElement;
+        "bs-empty-state": HTMLBsEmptyStateElement;
         "bs-error-page": HTMLBsErrorPageElement;
         "bs-file-upload": HTMLBsFileUploadElement;
         "bs-file-upload-item": HTMLBsFileUploadItemElement;
+        "bs-global-search": HTMLBsGlobalSearchElement;
         "bs-grid": HTMLBsGridElement;
         "bs-icon-button": HTMLBsIconButtonElement;
         "bs-icon-tile": HTMLBsIconTileElement;
         "bs-inline-tab": HTMLBsInlineTabElement;
         "bs-input": HTMLBsInputElement;
+        "bs-key": HTMLBsKeyElement;
+        "bs-key-caps": HTMLBsKeyCapsElement;
+        "bs-keyboard-shortcuts": HTMLBsKeyboardShortcutsElement;
+        "bs-list": HTMLBsListElement;
+        "bs-list-item": HTMLBsListItemElement;
         "bs-logo": HTMLBsLogoElement;
         "bs-menu": HTMLBsMenuElement;
         "bs-menu-item": HTMLBsMenuItemElement;
@@ -7135,7 +8384,9 @@ declare global {
         "bs-progress-linear": HTMLBsProgressLinearElement;
         "bs-qr-code": HTMLBsQrCodeElement;
         "bs-radio": HTMLBsRadioElement;
+        "bs-search-item": HTMLBsSearchItemElement;
         "bs-session-timeout": HTMLBsSessionTimeoutElement;
+        "bs-shortcut-row": HTMLBsShortcutRowElement;
         "bs-side-panel": HTMLBsSidePanelElement;
         "bs-skeleton": HTMLBsSkeletonElement;
         "bs-slider": HTMLBsSliderElement;
@@ -7153,6 +8404,8 @@ declare global {
         "bs-toast": HTMLBsToastElement;
         "bs-tooltip": HTMLBsTooltipElement;
         "bs-tooltip-trigger": HTMLBsTooltipTriggerElement;
+        "bs-tree": HTMLBsTreeElement;
+        "bs-tree-item": HTMLBsTreeItemElement;
         "bs-whats-new": HTMLBsWhatsNewElement;
         "bs-whats-new-entry": HTMLBsWhatsNewEntryElement;
     }
@@ -8468,56 +9721,230 @@ declare namespace LocalJSX {
         "sourceName"?: string;
     }
     /**
-     * A chat composer input for Genie AI-style conversational interfaces: a text field
-     * plus an attach button, a mic/voice-recording toggle, and a single primary action button whose
-     * icon and behavior change with `state` (send, stop generating, or confirm a voice recording).
+     * A Ctrl+K command palette: a modal with a search field, grouped commands, navigation and records, a
+     * no-results view and a keyboard-hint footer. The data, the filtering, the command registry and the
+     * recent-items storage are all yours: you slot `bs-search-item`s into the sections and set `status`.
+     * Built from a native `<dialog>` (opened with `showModal()`, so focus is trapped, the page behind is inert
+     * and the backdrop is the scrim), `bs-input` (type="search"), `bs-search-item`, `bs-key` (footer hints and
+     * the Esc cap), `bs-chip-informative` (the scope chip) and `bs-spinner` (loading). Slot a `bs-key-caps` with
+     * `slot="trailing"` inside an item to show a command's shortcut.
      * ## When to use
-     * - The message-entry bar for an AI chat/assistant or human support conversation.
+     * - An app-wide "do anything" entry point opened with a hotkey: run commands, navigate, open records.
      * ## When not to use
-     * - A general-purpose text field — use `bs-input` instead; this component's layout and states are
-     *   purpose-built for a chat composer, not a generic form field.
-     * ## Focus
-     * Uses `shadow: { delegatesFocus: true }`, so calling `.focus()` on the `<bs-composer>` host
-     * element itself (not just its internal `<input>`) moves focus into the shadow-DOM text field --
-     * useful for e.g. focusing the composer after a parent view mounts, without reaching into its
-     * shadow root.
-     * @prop --bs-composer-radius - Corner radius of the container. Aliased to `--bs-border-radius-150`.
-     * @prop --bs-composer-button-radius - Corner radius of the attach/mic/action buttons. Aliased to `--bs-border-radius-100`.
-     * @prop --bs-composer-button-size - Width/height of the attach/mic/action buttons. Aliased to `--bs-spacing-600`.
-     * @prop --bs-composer-bg - Background of the pill container. Aliased to `--bs-input-bg-default`.
-     * @prop --bs-composer-border - Border color of the pill container. Aliased to `--bs-input-border-default`.
-     * @prop --bs-composer-border-focus - Border color when the text field has focus. Aliased to `--bs-input-border-focus`.
-     * @prop --bs-composer-action-bg - Background of the primary action button. Aliased to `--bs-color-primary-default`.
-     * @prop --bs-composer-action-bg-hover - Aliased to `--bs-color-primary-hover`.
-     * @prop --bs-composer-action-bg-pressed - Aliased to `--bs-color-primary-pressed`.
-     * @prop --bs-composer-action-bg-disabled - Aliased to `--bs-surface-action-disabled`.
-     * @prop --bs-composer-action-icon - Icon color on the primary action button. Aliased to `--bs-text-on-action`.
-     * @prop --bs-composer-action-icon-disabled - Aliased to `--bs-text-on-disabled`.
-     * @prop --bs-composer-attach-icon - Icon color of the attach button. Aliased to `--bs-icon-default`.
-     * @prop --bs-composer-mic-icon - Icon color of the mic/stop-recording button. Aliased to `--bs-icon-default`.
-     * @prop --bs-composer-mic-icon-disabled - Aliased to `--bs-icon-disabled`.
-     * @prop --bs-composer-subtle-hover - Background of the attach/mic buttons on hover (subtle-button treatment, same as `bs-button`'s `subtle` variant). Aliased to `--bs-color-neutral-container`.
-     * @prop --bs-composer-subtle-pressed - Background of the attach/mic buttons when pressed. Aliased to `--bs-color-neutral-container-pressed`.
-     * @prop --bs-composer-input-max-lines - How many lines the text field grows to before scrolling internally instead of growing further. Aliased to `10`.
+     * - A plain search box with a dropdown -- use `bs-global-search`.
+     * - A small list of actions on one control -- use `bs-menu`.
+     * A `>` as the first character of the field switches to commands-only mode (`commandsOnly`, reflected as
+     * `commands-only`). The component filters nothing: listen to `bsInput`, swap the slotted items, set `status`.
+     * Nested (sub-command) palettes are a consumer pattern: swap the slotted commands and set `scopeLabel`.
+     * @prop --bs-command-palette-width - Panel width. Defaults to `640px` (Figma); capped to the viewport.
+     * @prop --bs-command-palette-top - Distance from the top of the viewport. Defaults to `12vh`.
+     * @prop --bs-command-palette-max-height - Max height of the results area. Defaults to `60vh`.
+     * @prop --bs-command-palette-radius - Aliased to `--bs-border-radius-150`.
+     * @prop --bs-command-palette-bg - Panel background. Aliased to `--bs-surface-base`.
+     * @prop --bs-command-palette-shadow - Figma elevation level 4: `0 8px 16px` in `--bs-elevation-higher` (stronger in dark mode).
+     * @prop --bs-command-palette-overlay - Scrim colour. Aliased to `--bs-surface-overlay`.
+     * @prop --bs-command-palette-footer-bg - Aliased to `--bs-surface-container`.
+     * @prop --bs-command-palette-divider-color - Aliased to `--bs-border-default`.
+     * @prop --bs-command-palette-header-border-color - Aliased to `--bs-border-neutral-container`.
+     * @prop --bs-command-palette-header-color - Aliased to `--bs-text-muted`.
+     * @prop --bs-command-palette-hint-color - Aliased to `--bs-text-secondary`.
+     * @prop --bs-command-palette-z-index - Aliased to `--bs-z-index-modal`.
      */
-    interface BsComposer {
+    interface BsCommandPalette {
         /**
-          * Accessible name for the text field. This component has no visible `<label>` (chat composers don't show one in the design), so `ariaLabel` is the only way a consumer gives the textbox an accessible name -- set it in every real usage.
-          * @default null
+          * @default 'All results'
          */
-        "ariaLabel"?: string | null;
+        "allResultsLabel"?: string;
         /**
-          * Accessible name of the attach button.
-          * @default 'Attach'
+          * @default 'Close'
          */
-        "attachLabel"?: string;
+        "closeLabel"?: string;
         /**
-          * Accessible name of the primary action button while `state="recording"`.
-          * @default 'Confirm'
+          * @default 'Commands'
          */
-        "confirmLabel"?: string;
+        "commandsLabel"?: string;
         /**
-          * Removes the attach ("+") button from the DOM.
+          * Derived from `value` (it starts with `>`). Read-only; set `value` instead.
+          * @default false
+         */
+        "commandsOnly"?: boolean;
+        /**
+          * @default 'Commands only'
+         */
+        "commandsOnlyLabel"?: string;
+        /**
+          * A suggested correction; the "Did you mean" line shows while it is set.
+         */
+        "didYouMean"?: string;
+        /**
+          * @default 'Did you mean'
+         */
+        "didYouMeanLabel"?: string;
+        /**
+          * @default 'Check the spelling, or search records instead.'
+         */
+        "emptyDescription"?: string;
+        /**
+          * No-results view copy. Include the query in `emptyHeading` yourself.
+          * @default 'No commands or records'
+         */
+        "emptyHeading"?: string;
+        /**
+          * Global shortcut that toggles the palette, e.g. `mod+k` (`mod` is Cmd on Mac, Ctrl elsewhere). Empty = off.
+          * @default ''
+         */
+        "hotkey"?: string;
+        /**
+          * Keep the palette open after an item is chosen.
+          * @default false
+         */
+        "keepOpenOnSelect"?: boolean;
+        /**
+          * Accessible name of the dialog.
+          * @default 'Command palette'
+         */
+        "label"?: string;
+        /**
+          * Accessible name of the results listbox.
+          * @default 'Results'
+         */
+        "listLabel"?: string;
+        /**
+          * Text of the loading row.
+          * @default 'Loading…'
+         */
+        "loadingLabel"?: string;
+        /**
+          * Footer hint texts.
+          * @default 'Navigate'
+         */
+        "navigateLabel"?: string;
+        /**
+          * @default 'Navigation'
+         */
+        "navigationLabel"?: string;
+        /**
+          * Fires on every keystroke with `{ value, query, commandsOnly }`.
+         */
+        "onBsInput"?: (event: BsCommandPaletteCustomEvent<BsCommandPaletteInputDetail>) => void;
+        /**
+          * Fires when the palette opens or closes through user interaction (hotkey, Esc, scrim, selection).
+         */
+        "onBsOpenChange"?: (event: BsCommandPaletteCustomEvent<boolean>) => void;
+        /**
+          * Fires on Backspace in an empty field while `scopeLabel` is set.
+         */
+        "onBsScopeExit"?: (event: BsCommandPaletteCustomEvent<void>) => void;
+        /**
+          * Fires when an item is chosen (click or Enter) with `{ value, section, commandsOnly }`.
+         */
+        "onBsSelect"?: (event: BsCommandPaletteCustomEvent<BsCommandPaletteSelectDetail>) => void;
+        /**
+          * Fires when the "Did you mean" suggestion is pressed, with its text.
+         */
+        "onBsSuggestion"?: (event: BsCommandPaletteCustomEvent<string>) => void;
+        /**
+          * Whether the palette is open.
+          * @default false
+         */
+        "open"?: boolean;
+        /**
+          * @default 'Open'
+         */
+        "openLabel"?: string;
+        /**
+          * Placeholder of the field.
+          * @default 'Type a command or search…'
+         */
+        "placeholder"?: string;
+        /**
+          * Section headers.
+          * @default 'Recent'
+         */
+        "recentLabel"?: string;
+        /**
+          * @default 'Records'
+         */
+        "recordsLabel"?: string;
+        /**
+          * Nested scope: shows this text as a chip before the field. Backspace on an empty field emits `bsScopeExit`.
+         */
+        "scopeLabel"?: string;
+        /**
+          * Shows the footer of keyboard hints.
+          * @default true
+         */
+        "showFooter"?: boolean;
+        /**
+          * Which view to show. You choose it; nothing is inferred from `value`. `default` and `results` render the same; they differ for screen readers only.
+          * @default 'default'
+         */
+        "status"?: BsCommandPaletteStatus;
+        /**
+          * @default 'Suggested'
+         */
+        "suggestedLabel"?: string;
+        /**
+          * @default 'Try instead'
+         */
+        "tryInsteadLabel"?: string;
+        /**
+          * The field value. Two-way. A leading `>` means commands-only mode.
+          * @default ''
+         */
+        "value"?: string;
+    }
+    /**
+     * A chat composer input for Genie AI-style conversational interfaces: a text field
+     * plus an attach button, a mic/voice-recording toggle, and a single primary action button whose
+     * icon and behavior change with `state` (send, stop generating, or confirm a voice recording).
+     * ## When to use
+     * - The message-entry bar for an AI chat/assistant or human support conversation.
+     * ## When not to use
+     * - A general-purpose text field — use `bs-input` instead; this component's layout and states are
+     *   purpose-built for a chat composer, not a generic form field.
+     * ## Focus
+     * Uses `shadow: { delegatesFocus: true }`, so calling `.focus()` on the `<bs-composer>` host
+     * element itself (not just its internal `<input>`) moves focus into the shadow-DOM text field --
+     * useful for e.g. focusing the composer after a parent view mounts, without reaching into its
+     * shadow root.
+     * @prop --bs-composer-radius - Corner radius of the container. Aliased to `--bs-border-radius-150`.
+     * @prop --bs-composer-button-radius - Corner radius of the attach/mic/action buttons. Aliased to `--bs-border-radius-100`.
+     * @prop --bs-composer-button-size - Width/height of the attach/mic/action buttons. Aliased to `--bs-spacing-600`.
+     * @prop --bs-composer-bg - Background of the pill container. Aliased to `--bs-input-bg-default`.
+     * @prop --bs-composer-border - Border color of the pill container. Aliased to `--bs-input-border-default`.
+     * @prop --bs-composer-border-focus - Border color when the text field has focus. Aliased to `--bs-input-border-focus`.
+     * @prop --bs-composer-action-bg - Background of the primary action button. Aliased to `--bs-color-primary-default`.
+     * @prop --bs-composer-action-bg-hover - Aliased to `--bs-color-primary-hover`.
+     * @prop --bs-composer-action-bg-pressed - Aliased to `--bs-color-primary-pressed`.
+     * @prop --bs-composer-action-bg-disabled - Aliased to `--bs-surface-action-disabled`.
+     * @prop --bs-composer-action-icon - Icon color on the primary action button. Aliased to `--bs-text-on-action`.
+     * @prop --bs-composer-action-icon-disabled - Aliased to `--bs-text-on-disabled`.
+     * @prop --bs-composer-attach-icon - Icon color of the attach button. Aliased to `--bs-icon-default`.
+     * @prop --bs-composer-mic-icon - Icon color of the mic/stop-recording button. Aliased to `--bs-icon-default`.
+     * @prop --bs-composer-mic-icon-disabled - Aliased to `--bs-icon-disabled`.
+     * @prop --bs-composer-subtle-hover - Background of the attach/mic buttons on hover (subtle-button treatment, same as `bs-button`'s `subtle` variant). Aliased to `--bs-color-neutral-container`.
+     * @prop --bs-composer-subtle-pressed - Background of the attach/mic buttons when pressed. Aliased to `--bs-color-neutral-container-pressed`.
+     * @prop --bs-composer-input-max-lines - How many lines the text field grows to before scrolling internally instead of growing further. Aliased to `10`.
+     */
+    interface BsComposer {
+        /**
+          * Accessible name for the text field. This component has no visible `<label>` (chat composers don't show one in the design), so `ariaLabel` is the only way a consumer gives the textbox an accessible name -- set it in every real usage.
+          * @default null
+         */
+        "ariaLabel"?: string | null;
+        /**
+          * Accessible name of the attach button.
+          * @default 'Attach'
+         */
+        "attachLabel"?: string;
+        /**
+          * Accessible name of the primary action button while `state="recording"`.
+          * @default 'Confirm'
+         */
+        "confirmLabel"?: string;
+        /**
+          * Removes the attach ("+") button from the DOM.
           * @default false
          */
         "hideAttach"?: boolean;
@@ -9081,6 +10508,43 @@ declare namespace LocalJSX {
          */
         "variant"?: BsDividerVariant;
     }
+    /**
+     * A centered "nothing to show" block: an icon tile, a heading, a description and an optional action.
+     * Used for empty lists, "no results" and error states inside a panel, card or page section.
+     * Built from `bs-icon-tile` (and, in your `action` slot, usually a `bs-button`).
+     * The component has no role. Live regions belong on a wrapper you control (e.g. `role="status"` on the
+     * element that stays in the DOM while this block appears and disappears).
+     * ## When to use
+     * - A list, table or search result that has nothing to show, or failed to load.
+     * ## When not to use
+     * - A full-page error with a status code -- use `bs-error-page`.
+     * - A transient message -- use `bs-toast` or `bs-snackbar`.
+     * @prop --bs-empty-state-padding-y - Vertical padding. Aliased to `--bs-spacing-700` (56px).
+     * @prop --bs-empty-state-padding-x - Horizontal padding. Aliased to `--bs-spacing-300` (24px).
+     * @prop --bs-empty-state-gap - Gap between tile, heading, description and action. Aliased to `--bs-spacing-150`.
+     * @prop --bs-empty-state-heading-color - Aliased to `--bs-text-default`.
+     * @prop --bs-empty-state-description-color - Aliased to `--bs-text-secondary`.
+     */
+    interface BsEmptyState {
+        /**
+          * The description text. The default slot overrides it.
+         */
+        "description"?: string;
+        /**
+          * The heading text.
+         */
+        "heading"?: string;
+        /**
+          * Heading level, 2 to 6 (renders `h2`..`h6`). Pick the one that fits the page outline.
+          * @default 3
+         */
+        "headingLevel"?: 2 | 3 | 4 | 5 | 6;
+        /**
+          * Colour and default glyph of the icon tile. Use `error` for failures.
+          * @default 'default'
+         */
+        "intent"?: BsIconTileIntent;
+    }
     /**
      * A full-block page for when the user can't get to what they asked for: page not found (404), a server
      * error (500), no access (403), planned maintenance, or no internet connection. Matches the Figma
@@ -9260,6 +10724,193 @@ declare namespace LocalJSX {
          */
         "thumbnailSrc"?: string;
     }
+    /**
+     * A global search combobox: a search field with a dropdown panel of suggestions, results, an empty state
+     * or an error state, plus a keyboard-hint footer. The data, the filtering and the recent-search storage
+     * are all yours: you slot `bs-search-item`s into the sections and tell the component which `status` to show.
+     * Built from `bs-input` (type="search"), `bs-search-item`, `bs-empty-state` (and so `bs-icon-tile`),
+     * `bs-button` and `bs-key` (the footer keycaps).
+     * ## When to use
+     * - An app-wide "find anything" field with recent searches, jump-to shortcuts and grouped results.
+     * ## When not to use
+     * - Filtering the list or table that is already on screen -- use `bs-input type="search"`.
+     * - A list of commands or actions -- use `bs-menu`.
+     * - The complete result set -- link to a full search results page ("See all results").
+     * Put `bs-search-item` children in the light DOM with `slot="recent"`, `slot="jump-to"`,
+     * `slot="top-matches"` or `slot="search-in"`. A section (and its header) is only rendered when its slot has
+     * content. Up/Down arrows move a highlight through the visible items; focus never leaves the field.
+     * Known limit: the items are in your light DOM and the combobox in this shadow root, so
+     * `aria-activedescendant` (an id reference) does not resolve across that boundary in every browser; the
+     * highlighted option also gets `aria-selected="true"`.
+     * @prop --bs-global-search-width - Field and panel width. Defaults to `480px` (Figma); capped at 100%.
+     * @prop --bs-global-search-panel-radius - Aliased to `--bs-border-radius-100`.
+     * @prop --bs-global-search-panel-padding - Aliased to `--bs-spacing-100`.
+     * @prop --bs-global-search-gap - Gap between sections, and between the field and the panel. Aliased to `--bs-spacing-100`.
+     * @prop --bs-global-search-panel-bg - Panel background. Aliased to `--bs-surface-base`.
+     * @prop --bs-global-search-shadow - Panel shadow: Figma elevation level 3 (`0 4px 8px` in `--bs-elevation-high`, 10% black in light mode and 30% in dark mode).
+     * @prop --bs-global-search-z-index - Panel stacking. Aliased to `--bs-z-index-dropdown`.
+     * @prop --bs-global-search-divider-color - Footer divider. Aliased to `--bs-border-default`.
+     * @prop --bs-global-search-header-border-color - Section header underline. Aliased to `--bs-border-neutral-container`.
+     * @prop --bs-global-search-header-color - Section header text. Aliased to `--bs-text-muted`.
+     * @prop --bs-global-search-hint-color - Footer hint text. Aliased to `--bs-text-secondary`.
+     */
+    interface BsGlobalSearch {
+        /**
+          * Text of the footer button that clears recent searches.
+          * @default 'Clear recent'
+         */
+        "clearRecentLabel"?: string;
+        /**
+          * Text of the empty state's action.
+          * @default 'Clear search'
+         */
+        "clearSearchLabel"?: string;
+        /**
+          * Footer hint text after the Esc key.
+          * @default 'Close'
+         */
+        "closeLabel"?: string;
+        /**
+          * Disables the field; the panel cannot open.
+          * @default false
+         */
+        "disabled"?: boolean;
+        /**
+          * Description of the built-in empty state.
+          * @default 'Try a different search.'
+         */
+        "emptyDescription"?: string;
+        /**
+          * Heading of the built-in empty state.
+          * @default 'No results'
+         */
+        "emptyHeading"?: string;
+        /**
+          * Description of the built-in error state.
+          * @default 'We couldn’t reach the server. Your query is kept — try again in a moment.'
+         */
+        "errorDescription"?: string;
+        /**
+          * Heading of the built-in error state.
+          * @default 'Search isn’t available right now'
+         */
+        "errorHeading"?: string;
+        /**
+          * Footer hint text after the Enter key (results view).
+          * @default 'Full results'
+         */
+        "fullResultsLabel"?: string;
+        /**
+          * Header of the `jump-to` section.
+          * @default 'Jump to'
+         */
+        "jumpToLabel"?: string;
+        /**
+          * Accessible name of the search field. Falls back to the placeholder. `bs-input` has no aria-label prop, so this names the combobox wrapper.
+         */
+        "label"?: string;
+        /**
+          * Accessible name of the suggestions listbox.
+          * @default 'Search suggestions'
+         */
+        "listLabel"?: string;
+        /**
+          * Footer hint text after the arrow keys.
+          * @default 'Navigate'
+         */
+        "navigateLabel"?: string;
+        /**
+          * Fires when "Clear recent" is pressed.
+         */
+        "onBsClearRecent"?: (event: BsGlobalSearchCustomEvent<void>) => void;
+        /**
+          * Fires when the empty state's "Clear search" is pressed; the value is also cleared.
+         */
+        "onBsClearSearch"?: (event: BsGlobalSearchCustomEvent<void>) => void;
+        /**
+          * Fires on every keystroke with the query. The component filters nothing itself.
+         */
+        "onBsInput"?: (event: BsGlobalSearchCustomEvent<string>) => void;
+        /**
+          * Fires when the panel opens or closes through user interaction, with the new state.
+         */
+        "onBsOpenChange"?: (event: BsGlobalSearchCustomEvent<boolean>) => void;
+        /**
+          * Fires when the error state's "Try again" is pressed.
+         */
+        "onBsRetry"?: (event: BsGlobalSearchCustomEvent<void>) => void;
+        /**
+          * Fires on Enter with no highlighted item, with the query.
+         */
+        "onBsSearch"?: (event: BsGlobalSearchCustomEvent<string>) => void;
+        /**
+          * Fires when "See all results" is pressed.
+         */
+        "onBsSeeAll"?: (event: BsGlobalSearchCustomEvent<void>) => void;
+        /**
+          * Fires when an item is chosen (click or Enter), with its `value` and section (slot name).
+         */
+        "onBsSelect"?: (event: BsGlobalSearchCustomEvent<BsGlobalSearchSelectDetail>) => void;
+        /**
+          * Whether the dropdown panel is open. Opens on focus, click and typing; closes on Escape, outside click and selection.
+          * @default false
+         */
+        "open"?: boolean;
+        /**
+          * Placeholder of the field (also its accessible name unless `label` is set).
+          * @default 'Search customers, orders, products…'
+         */
+        "placeholder"?: string;
+        /**
+          * Header of the `recent` section.
+          * @default 'Recent searches'
+         */
+        "recentLabel"?: string;
+        /**
+          * Text of the error state's action.
+          * @default 'Try again'
+         */
+        "retryLabel"?: string;
+        /**
+          * Header of the `search-in` section.
+          * @default 'Search in'
+         */
+        "searchInLabel"?: string;
+        /**
+          * Footer hint text after the Enter key (default view).
+          * @default 'Search'
+         */
+        "searchLabel"?: string;
+        /**
+          * Text of the footer button of the results view, when `totalResults` is not set.
+          * @default 'See all results'
+         */
+        "seeAllLabel"?: string;
+        /**
+          * Shows the footer (hints and the Clear recent / See all button) for the `default` and `results` views.
+          * @default true
+         */
+        "showFooter"?: boolean;
+        /**
+          * Which view the panel shows. You choose it; nothing is inferred from `value`.
+          * @default 'default'
+         */
+        "status"?: BsGlobalSearchStatus;
+        /**
+          * Header of the `top-matches` section.
+          * @default 'Top matches'
+         */
+        "topMatchesLabel"?: string;
+        /**
+          * Total number of results (status `results`): shown as "See all {n} results" and announced to screen readers.
+         */
+        "totalResults"?: number;
+        /**
+          * The query. Two-way with the field.
+          * @default ''
+         */
+        "value"?: string;
+    }
     /**
      * A CSS grid layout wrapper. Children are placed in equal-width columns with a token-based gap.
      * `columns` takes either a number (`"3"` becomes `repeat(3, minmax(0, 1fr))`) or any raw
@@ -9379,7 +11030,7 @@ declare namespace LocalJSX {
           * Colour and default glyph. `brand` uses the brand colours; `information` the info palette.
           * @default 'default'
          */
-        "intent"?: BsIconTileIntent;
+        "intent"?: BsIconTileIntent1;
         /**
           * Accessible name. When set, the tile is exposed as an image with this name; when empty it is decorative and hidden from assistive tech.
          */
@@ -9521,86 +11172,370 @@ declare namespace LocalJSX {
         /**
           * The `name` the value is submitted under in a surrounding `<form>`'s `FormData`.
          */
-        "name"?: string;
-        "onBsChange"?: (event: BsInputCustomEvent<string>) => void;
+        "name"?: string;
+        "onBsChange"?: (event: BsInputCustomEvent<string>) => void;
+        /**
+          * Emitted when a chip is committed (Enter pressed in the draft input) for `type="chip"`.
+         */
+        "onBsChipAdd"?: (event: BsInputCustomEvent<string>) => void;
+        /**
+          * Emitted when a chip's remove button is clicked for `type="chip"`.
+         */
+        "onBsChipRemove"?: (event: BsInputCustomEvent<string>) => void;
+        /**
+          * Emitted when the country `<select>` changes for `type="country"`.
+         */
+        "onBsCountryChange"?: (event: BsInputCustomEvent<string>) => void;
+        "onBsInput"?: (event: BsInputCustomEvent<string>) => void;
+        /**
+          * Emitted when `type="dropdown"`'s trigger is toggled. See `open`'s doc comment for this type's shell-only limitation.
+         */
+        "onBsOpen"?: (event: BsInputCustomEvent<boolean>) => void;
+        /**
+          * Emitted when the title `<select>` changes for `type="initials"`.
+         */
+        "onBsTitleChange"?: (event: BsInputCustomEvent<string>) => void;
+        /**
+          * Whether the `type="dropdown"` trigger is open. Reflects to an attribute so consumers can style an open state via CSS. When `options` is non-empty, this also controls whether the `bs-menu` of `bs-menu-item`s is rendered below the field.
+          * @default false
+         */
+        "open"?: boolean;
+        /**
+          * Options for `type="select"` (rendered as native `<option>`s) and `type="dropdown"` (rendered as a `bs-menu` of `bs-menu-item`s when `open`). Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
+          * @default []
+         */
+        "options"?: { label: string; value: string }[];
+        "placeholder"?: string;
+        /**
+          * Marks the field as required: renders a red `*` after the label and sets `aria-required="true"` on the control. Applies regardless of `type`.
+          * @default false
+         */
+        "required"?: boolean;
+        /**
+          * Number of visible rows for `type="textarea"`.
+          * @default 3
+         */
+        "rows"?: number;
+        /**
+          * Accessible name of the password toggle while the password is hidden.
+          * @default 'Show password'
+         */
+        "showPasswordLabel"?: string;
+        /**
+          * Step size for `type="number"`'s increment/decrement stepper buttons.
+          * @default 1
+         */
+        "step"?: number;
+        /**
+          * Title select options for `type="initials"` (e.g. `['Mrs.', 'Mr.', 'Dr.']`). Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
+          * @default []
+         */
+        "titleOptions"?: string[];
+        /**
+          * @default 'text'
+         */
+        "type"?: | 'text'
+    | 'email'
+    | 'password'
+    | 'number'
+    | 'search'
+    | 'date'
+    | 'dropdown'
+    | 'select'
+    | 'textarea'
+    | 'chip'
+    | 'initials'
+    | 'country'
+    | 'pin';
+        /**
+          * Current value. Native `input`/`change` events don't cross the Shadow DOM boundary, so this component re-dispatches them as `bsInput`/`bsChange` custom events instead. Mutable so the `number` type's stepper buttons can update it directly.
+          * @default ''
+         */
+        "value"?: string;
+    }
+    /**
+     * One key of a keyboard shortcut, e.g. `Ctrl`, `K` or `Esc` -- rendered as a `<kbd>` keycap.
+     * Shows a text label, or an icon (e.g. a return arrow) via the `icon` slot.
+     * ## When to use
+     * - Showing a keyboard shortcut hint next to a control or inside a search field.
+     * - Alone for a single key, or as the children of `bs-key-caps` for a multi-key shortcut.
+     * ## When not to use
+     * - As a button or any clickable control -- a key is a static hint, not interactive.
+     * @prop --bs-key-bg - Cap background. Aliased to `--bs-surface-base`.
+     * @prop --bs-key-border-color - Cap border colour. Aliased to `--bs-border-default`.
+     * @prop --bs-key-radius - Cap corner radius. Aliased to `--bs-border-radius-50`.
+     * @prop --bs-key-padding-x - Horizontal padding. Aliased to `--bs-spacing-75`.
+     * @prop --bs-key-padding-y - Vertical padding. Aliased to `--bs-spacing-50`.
+     * @prop --bs-key-min-width - Smallest cap width, so single characters keep a keycap shape. Defaults to `25px` (Figma).
+     * @prop --bs-key-color - Label colour. Aliased to `--bs-text-secondary`.
+     * @prop --bs-key-font-size - Label size. Aliased to `--bs-font-size-xs` (12px).
+     * @prop --bs-key-icon-size - Icon size. Defaults to `16px` (Figma).
+     */
+    interface BsKey {
+        /**
+          * The key's text, e.g. `Ctrl`. The default slot overrides it.
+         */
+        "label"?: string;
+    }
+    /**
+     * A keyboard shortcut of one to four keys joined by "+", e.g. `Ctrl + K`. Give it a `keys` string
+     * (`"Ctrl+Shift+K"`) or array (`['Ctrl', '+']` for a literal plus key), or slot your own `bs-key`
+     * elements -- for example when a key is an icon.
+     * ## When to use
+     * - A shortcut hint beside a menu item, button or inside a search field.
+     * ## When not to use
+     * - Instructions that need prose ("press Enter to submit") -- write a sentence and use a single `bs-key` inline.
+     * - Anything interactive -- keys are static hints.
+     * @prop --bs-key-caps-gap - Gap between keys and separators. Aliased to `--bs-spacing-100`.
+     * @prop --bs-key-caps-separator-color - Colour of the "+" separators. Aliased to `--bs-text-muted`.
+     * @prop --bs-key-caps-disabled-opacity - Opacity of the whole shortcut while `disabled`. Defaults to `0.38` (Figma).
+     */
+    interface BsKeyCaps {
+        /**
+          * Dims the whole shortcut and marks it `aria-disabled`.
+          * @default false
+         */
+        "disabled"?: boolean;
+        /**
+          * The keys as text. A string is split on `+` (`"Ctrl+K"`); use an array to include a literal plus key. Ignored when `bs-key` elements are slotted instead. Figma defines one to four keys.
+         */
+        "keys"?: string | string[];
+        /**
+          * Accessible name of the shortcut, e.g. "Control plus K". Defaults to the keys joined with " plus ".
+         */
+        "label"?: string;
+    }
+    /**
+     * A searchable reference panel of keyboard shortcuts: heading and close button, a search field, an
+     * optional single-key on/off switch, shortcut groups in two columns and a footer hint. It is a
+     * surface, not a modal -- place it inside `bs-dialog` or a popover.
+     * Built from `bs-card`, `bs-icon-button`, `bs-input`, `bs-switch`, `bs-shortcut-row` (and so
+     * `bs-key-caps` / `bs-key`).
+     * ## When to use
+     * - A "press ? to see shortcuts" help overlay for an app with many shortcuts.
+     * ## When not to use
+     * - A long-form help page or documentation -- link to it instead.
+     * - A list of commands the user can run from it -- use `bs-menu`.
+     * @prop --bs-keyboard-shortcuts-width - Panel width and min-width. Defaults to `720px` (Figma).
+     * @prop --bs-keyboard-shortcuts-bg - Panel background. Aliased to `--bs-surface-base`.
+     * @prop --bs-keyboard-shortcuts-radius - Aliased to `--bs-border-radius-150`.
+     * @prop --bs-keyboard-shortcuts-padding - Aliased to `--bs-spacing-200`.
+     * @prop --bs-keyboard-shortcuts-gap - Gap between sections. Aliased to `--bs-spacing-200`.
+     * @prop --bs-keyboard-shortcuts-shadow - Figma elevation level 4 (`0 8px 8px` in `--bs-elevation-higher`, 12% black in light mode and 25% in dark mode).
+     * @prop --bs-keyboard-shortcuts-column-gap - Gap between the two columns. Aliased to `--bs-spacing-600`.
+     * @prop --bs-keyboard-shortcuts-color - Main text colour. Aliased to `--bs-text-default`.
+     * @prop --bs-keyboard-shortcuts-color-secondary - Titles, captions, footer. Aliased to `--bs-text-secondary`.
+     */
+    interface BsKeyboardShortcuts {
+        /**
+          * Accessible name of the close button.
+          * @default 'Close'
+         */
+        "closeLabel"?: string;
+        /**
+          * The key shown in the footer hint.
+          * @default '?'
+         */
+        "footerKey"?: string;
+        /**
+          * Text before the footer key.
+          * @default 'Press'
+         */
+        "footerPrefix"?: string;
+        /**
+          * Footer text after the key.
+          * @default 'anywhere to open this list. On Mac: Cmd instead of Ctrl.'
+         */
+        "footerText"?: string;
+        /**
+          * Property only: the shortcut groups.
+          * @default []
+         */
+        "groups"?: BsShortcutGroup[];
+        /**
+          * Heading text. The `heading` slot overrides it.
+          * @default 'Keyboard shortcuts'
+         */
+        "heading"?: string;
+        /**
+          * Line shown when the query matches nothing.
+          * @default 'No shortcuts match'
+         */
+        "noResultsText"?: string;
+        /**
+          * Emitted by the close button and by Escape.
+         */
+        "onBsClose"?: (event: BsKeyboardShortcutsCustomEvent<void>) => void;
+        /**
+          * Emitted when the search text changes, with the new text.
+         */
+        "onBsQueryChange"?: (event: BsKeyboardShortcutsCustomEvent<string>) => void;
+        /**
+          * Emitted when the single-key switch changes, with the new value.
+         */
+        "onBsSingleKeyChange"?: (event: BsKeyboardShortcutsCustomEvent<boolean>) => void;
+        /**
+          * Current search text. Filters by action or keys text, case-insensitively.
+          * @default ''
+         */
+        "query"?: string;
+        /**
+          * Search field placeholder (also its accessible name: `bs-input` has no aria-label prop).
+          * @default 'Search for an action'
+         */
+        "searchPlaceholder"?: string;
+        /**
+          * Shows the footer hint.
+          * @default true
+         */
+        "showFooterHint"?: boolean;
+        /**
+          * Shows the single-key switch row.
+          * @default true
+         */
+        "showSingleKeySwitch"?: boolean;
+        /**
+          * Switch caption.
+          * @default 'Turn off if they clash with a screen reader or other tools.'
+         */
+        "singleKeyDescription"?: string;
+        /**
+          * Whether single-key shortcuts are on. When off they are shown dimmed.
+          * @default true
+         */
+        "singleKeyEnabled"?: boolean;
+        /**
+          * Switch title.
+          * @default 'Single-key shortcuts'
+         */
+        "singleKeyLabel"?: string;
+    }
+    /**
+     * A vertical list of `bs-list-item` rows, optionally single-select.
+     * ## When to use
+     * - Records, people, files or options shown as rows with leading media and descriptions.
+     * - `selectable` for a single-choice list (e.g. a conversation list next to a detail pane).
+     * ## When not to use
+     * - A popup list of actions -- use `bs-menu`.
+     * - Navigation between app sections -- use `bs-navigation-drawer`.
+     * - Multi-column, sortable or paged data -- use `bs-data-table`.
+     * Built from `bs-list-item` children (light DOM; the list never moves nodes).
+     * @prop --bs-list-gap - Gap between rows. Defaults to `0`.
+     * @prop --bs-list-divider-color - Divider colour when `dividers` is set. Aliased to `--bs-border-neutral-container`.
+     */
+    interface BsList {
+        /**
+          * Accessible name of the list.
+          * @default null
+         */
+        "ariaLabel"?: string | null;
         /**
-          * Emitted when a chip is committed (Enter pressed in the draft input) for `type="chip"`.
+          * Draws a 1px separator between rows.
+          * @default false
          */
-        "onBsChipAdd"?: (event: BsInputCustomEvent<string>) => void;
+        "dividers"?: boolean;
         /**
-          * Emitted when a chip's remove button is clicked for `type="chip"`.
+          * Fires with the new `value` when the user changes the selection.
          */
-        "onBsChipRemove"?: (event: BsInputCustomEvent<string>) => void;
+        "onBsChange"?: (event: BsListCustomEvent<string | null>) => void;
         /**
-          * Emitted when the country `<select>` changes for `type="country"`.
+          * Single-selection mode: role="listbox", rows are `option`s with roving tabindex.
+          * @default false
          */
-        "onBsCountryChange"?: (event: BsInputCustomEvent<string>) => void;
-        "onBsInput"?: (event: BsInputCustomEvent<string>) => void;
+        "selectable"?: boolean;
         /**
-          * Emitted when `type="dropdown"`'s trigger is toggled. See `open`'s doc comment for this type's shell-only limitation.
+          * `value` of the selected item (selectable mode).
+          * @default null
          */
-        "onBsOpen"?: (event: BsInputCustomEvent<boolean>) => void;
+        "value"?: string | null;
+    }
+    /**
+     * A single row of a list: optional leading media (avatar, icon, image), a label, a description and
+     * optional support text, and an optional trailing caret or custom trailing content.
+     * ## When to use
+     * - As a child of `bs-list`, one per record, person, file or option.
+     * - Standalone as a plain information row (non-interactive), or with `interactive` as a button-like row.
+     * ## When not to use
+     * - A popup list of actions -- use `bs-menu` / `bs-menu-item`.
+     * - App navigation with an active route -- use `bs-navigation-drawer-item`.
+     * - Tabular data with columns, sorting or paging -- use `bs-data-table`.
+     * Composed from: leading media (`bs-avatar`) and trailing controls (`bs-icon-button`) are supplied by the
+     * consumer through the `leading` and `trailing` slots; the row itself only reserves layout. The default
+     * trailing caret is inline SVG.
+     * Roles are driven by the parent `bs-list` (via `selectionRole`). Standalone, the row has no role
+     * (`listitem` is only valid inside a list) unless `interactive` is set, which makes it a focusable
+     * `role="button"`.
+     * @prop --bs-list-item-min-height - Minimum row height. Aliased to `--bs-spacing-1000`.
+     * @prop --bs-list-item-padding-y - Aliased to `--bs-spacing-150`.
+     * @prop --bs-list-item-padding-x - Aliased to `--bs-spacing-200`.
+     * @prop --bs-list-item-gap - Gap between leading, content and trailing. Aliased to `--bs-spacing-200`.
+     * @prop --bs-list-item-content-gap - Gap between text lines. Aliased to `--bs-spacing-25`.
+     * @prop --bs-list-item-radius - Aliased to `--bs-border-radius-100`.
+     * @prop --bs-list-item-bg - Enabled background. `transparent`.
+     * @prop --bs-list-item-bg-hover - Aliased to `--bs-surface-hover`.
+     * @prop --bs-list-item-bg-pressed - Aliased to `--bs-surface-pressed`.
+     * @prop --bs-list-item-bg-focus - Aliased to `--bs-surface-focus`.
+     * @prop --bs-list-item-bg-selected - Aliased to `--bs-surface-selected`.
+     * @prop --bs-list-item-bg-selected-hover - Aliased to `--bs-surface-selected-hover`.
+     * @prop --bs-list-item-bg-selected-pressed - Aliased to `--bs-surface-selected-pressed`.
+     * @prop --bs-list-item-bg-selected-focus - Aliased to `--bs-surface-selected-focus`.
+     * @prop --bs-list-item-bg-disabled - Aliased to `--bs-surface-action-disabled`.
+     * @prop --bs-list-item-color - Text colour. Aliased to `--bs-text-default`.
+     * @prop --bs-list-item-color-disabled - Aliased to `--bs-text-on-disabled`.
+     * @prop --bs-list-item-focus-ring - Focus ring colour. Aliased to `--bs-border-neutral-focus`.
+     * @prop --bs-list-item-image-width - Leading image width. 72px.
+     * @prop --bs-list-item-image-height - Leading image height. 56px.
+     */
+    interface BsListItem {
         /**
-          * Emitted when the title `<select>` changes for `type="initials"`.
+          * Second text line (the "paragraph").
+          * @default null
          */
-        "onBsTitleChange"?: (event: BsInputCustomEvent<string>) => void;
+        "description"?: string | null;
         /**
-          * Whether the `type="dropdown"` trigger is open. Reflects to an attribute so consumers can style an open state via CSS. When `options` is non-empty, this also controls whether the `bs-menu` of `bs-menu-item`s is rendered below the field.
+          * Disables the row: dimmed, not focusable, no click event.
           * @default false
          */
-        "open"?: boolean;
+        "disabled"?: boolean;
         /**
-          * Options for `type="select"` (rendered as native `<option>`s) and `type="dropdown"` (rendered as a `bs-menu` of `bs-menu-item`s when `open`). Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
-          * @default []
+          * Makes a standalone row a focusable `role="button"` that emits `bsItemClick`.
+          * @default false
          */
-        "options"?: { label: string; value: string }[];
-        "placeholder"?: string;
+        "interactive"?: boolean;
         /**
-          * Marks the field as required: renders a red `*` after the label and sets `aria-required="true"` on the control. Applies regardless of `type`.
-          * @default false
+          * First text line (semibold).
+          * @default null
          */
-        "required"?: boolean;
+        "label"?: string | null;
         /**
-          * Number of visible rows for `type="textarea"`.
-          * @default 3
+          * Fires on click / Enter / Space when the row is interactive and not disabled. Payload is `value`.
          */
-        "rows"?: number;
+        "onBsItemClick"?: (event: BsListItemCustomEvent<string | null>) => void;
         /**
-          * Accessible name of the password toggle while the password is hidden.
-          * @default 'Show password'
+          * Marks the row as selected. Managed by the parent `bs-list` when it is `selectable`.
+          * @default false
          */
-        "showPasswordLabel"?: string;
+        "selected"?: boolean;
         /**
-          * Step size for `type="number"`'s increment/decrement stepper buttons.
-          * @default 1
+          * Set by the parent `bs-list`: `listitem` (plain list) or `option` (selectable list). Do not set by hand.
+          * @default null
          */
-        "step"?: number;
+        "selectionRole"?: 'listitem' | 'option' | null;
         /**
-          * Title select options for `type="initials"` (e.g. `['Mrs.', 'Mr.', 'Dr.']`). Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
-          * @default []
+          * Shows a trailing caret (unless the `trailing` slot has content).
+          * @default false
          */
-        "titleOptions"?: string[];
+        "showArrow"?: boolean;
         /**
-          * @default 'text'
+          * Optional third text line.
+          * @default null
          */
-        "type"?: | 'text'
-    | 'email'
-    | 'password'
-    | 'number'
-    | 'search'
-    | 'date'
-    | 'dropdown'
-    | 'select'
-    | 'textarea'
-    | 'chip'
-    | 'initials'
-    | 'country'
-    | 'pin';
+        "supportText"?: string | null;
         /**
-          * Current value. Native `input`/`change` events don't cross the Shadow DOM boundary, so this component re-dispatches them as `bsInput`/`bsChange` custom events instead. Mutable so the `number` type's stepper buttons can update it directly.
-          * @default ''
+          * Identifies the item; emitted by `bsItemClick` and matched against `bs-list`'s `value`.
+          * @default null
          */
-        "value"?: string;
+        "value"?: string | null;
     }
     /**
      * The BrandSync brand mark, as its own standalone component -- shared by `bs-navigation-header`
@@ -10567,6 +12502,59 @@ declare namespace LocalJSX {
          */
         "value"?: string;
     }
+    /**
+     * One result or suggestion row of a search dropdown: a leading icon, a primary line, an optional
+     * description line and trailing text. Static, not focusable -- focus stays in the search field and the
+     * parent (`bs-global-search`) marks the highlighted row with `active`.
+     * Standalone it has no role. `bs-global-search` sets `selectionRole="option"` (and an `id`) on its rows,
+     * the same pattern as `bs-list-item` and `bs-shortcut-row`.
+     * ## When to use
+     * - A suggestion, recent search or result inside `bs-global-search`.
+     * ## When not to use
+     * - A row in a generic list -- use `bs-list-item`.
+     * - A command in a popup menu -- use `bs-menu-item`.
+     * @prop --bs-search-item-min-height - Aliased to `--bs-spacing-600` (48px).
+     * @prop --bs-search-item-padding-y - Aliased to `--bs-spacing-100`.
+     * @prop --bs-search-item-padding-x - Aliased to `--bs-spacing-150`.
+     * @prop --bs-search-item-gap - Aliased to `--bs-spacing-100`.
+     * @prop --bs-search-item-radius - Aliased to `--bs-border-radius-100`.
+     * @prop --bs-search-item-bg - Resting background. `transparent`.
+     * @prop --bs-search-item-bg-active - Active (highlighted) and hover background. Aliased to `--bs-surface-hover`.
+     * @prop --bs-search-item-bg-pressed - Aliased to `--bs-surface-pressed`.
+     * @prop --bs-search-item-color - Primary text. Aliased to `--bs-text-default`.
+     * @prop --bs-search-item-color-muted - Description and trailing text. Aliased to `--bs-text-muted`.
+     * @prop --bs-search-item-color-disabled - Aliased to `--bs-text-on-disabled`.
+     * @prop --bs-search-item-icon-color - Aliased to `--bs-icon-default`.
+     */
+    interface BsSearchItem {
+        /**
+          * Highlighted row (keyboard or hover). Set by the parent.
+          * @default false
+         */
+        "active"?: boolean;
+        /**
+          * Dims the row and ignores clicks.
+          * @default false
+         */
+        "disabled"?: boolean;
+        /**
+          * Fires with `value` when the row is clicked, or when the parent selects it with Enter.
+         */
+        "onBsItemSelect"?: (event: BsSearchItemCustomEvent<string | undefined>) => void;
+        /**
+          * Set by the parent (`"option"`). Standalone rows have no role.
+          * @default null
+         */
+        "selectionRole"?: 'option' | null;
+        /**
+          * Trailing text shorthand. The `trailing` slot overrides it.
+         */
+        "trailing"?: string;
+        /**
+          * Identifies the item; emitted by `bsItemSelect`.
+         */
+        "value"?: string;
+    }
     /**
      * The three moments around an expiring session, as one card. Matches the Figma "Session timeout"
      * component's three types:
@@ -10711,6 +12699,46 @@ declare namespace LocalJSX {
          */
         "type"?: BsSessionTimeoutType;
     }
+    /**
+     * One row of a shortcut list: an action label on the left and its keyboard shortcut on the right.
+     * Static information, not interactive. Standalone it has no role; `bs-keyboard-shortcuts` sets
+     * `selectionRole="listitem"` on its rows (same pattern as `bs-list-item`).
+     * Built from `bs-key-caps` (and so `bs-key`).
+     * ## When to use
+     * - A line in a keyboard-shortcut reference, usually inside `bs-keyboard-shortcuts`.
+     * ## When not to use
+     * - A clickable command or menu entry -- use `bs-menu-item` (which has its own shortcut slot).
+     * @prop --bs-shortcut-row-height - Row height. Defaults to `36px` (Figma).
+     * @prop --bs-shortcut-row-padding-x - Horizontal padding. Aliased to `--bs-spacing-100`.
+     * @prop --bs-shortcut-row-gap - Gap between label and keys. Aliased to `--bs-spacing-100`.
+     * @prop --bs-shortcut-row-radius - Corner radius. Aliased to `--bs-border-radius-75`.
+     * @prop --bs-shortcut-row-color - Label colour. Aliased to `--bs-text-default`.
+     * @prop --bs-shortcut-row-color-disabled - Label colour while `disabled`. Aliased to `--bs-text-on-disabled`.
+     */
+    interface BsShortcutRow {
+        /**
+          * The action, e.g. "Save". The default slot overrides it.
+         */
+        "action"?: string;
+        /**
+          * Dims the label and the keys.
+          * @default false
+         */
+        "disabled"?: boolean;
+        /**
+          * The keys, e.g. `"Ctrl+S"`, or an array (`['Ctrl', '+']`) for a literal plus key. See `bs-key-caps`.
+         */
+        "keys"?: string | string[];
+        /**
+          * Accessible name of the key caps, e.g. "Control plus S". Defaults to the keys joined with "plus".
+         */
+        "label"?: string;
+        /**
+          * Set by the parent list (`"listitem"`). Standalone rows have no role.
+          * @default null
+         */
+        "selectionRole"?: 'listitem' | null;
+    }
     /**
      * A generic slide-in panel (drawer) anchored to the start or end edge, for history, filters, FAQ
      * and similar secondary content. Closes via its close button or Escape and emits `bsClose`.
@@ -11566,6 +13594,87 @@ declare namespace LocalJSX {
          */
         "text"?: string;
     }
+    /**
+     * A hierarchical list of `bs-tree-item` rows with single selection, expand/collapse and the
+     * WAI-ARIA tree keyboard pattern.
+     * The tree owns `role="tree"`, the roving `tabindex` (exactly one enabled, visible item is
+     * tabbable: the selected one, otherwise the first), selection (kept in sync with each item's
+     * `selected`) and keyboard navigation over the visible (rendered, non-disabled) items. Items own
+     * their expansion state and emit `bsSelect` / `bsToggle`.
+     * Built from: `bs-tree-item` rows.
+     */
+    interface BsTree {
+        /**
+          * Accessible name of the tree. Bound onto the internal `role="tree"` element (an `aria-label` on the host would not reach it).
+          * @default null
+         */
+        "ariaLabel"?: string | null;
+        /**
+          * Emitted when the user changes the selection (click, Enter/Space), with the new value. Not emitted when `value` is set from code.
+         */
+        "onBsChange"?: (event: BsTreeCustomEvent<string>) => void;
+        /**
+          * When `false`, rows do not select (clicks and Enter/Space do nothing) but parents still expand and collapse.
+          * @default true
+         */
+        "selectable"?: boolean;
+        /**
+          * The `value` (or, when empty, the `label`) of the selected item. Two-way synced with each item's `selected` (single selection). Setting it from code does not emit `bsChange`.
+          * @default ''
+         */
+        "value"?: string;
+    }
+    /**
+     * A single row of a `bs-tree`. An item that contains child `bs-tree-item` elements is a parent
+     * (it gets an expand/collapse caret and a folder icon); an item without children is a leaf (no
+     * caret, file icon).
+     * The host carries `role="treeitem"` and the `aria-*` state; the owning `bs-tree` manages the
+     * roving `tabindex`, selection and keyboard navigation. Nesting depth is computed automatically
+     * from the number of ancestor `bs-tree-item` elements and exposed as `aria-level` -- it is not a
+     * prop. Clicking the row selects it; clicking the caret (or pressing Right/Left in a tree) toggles
+     * expansion -- the two are deliberately separate.
+     * Built from: inline SVG icons only (no existing `bs-*` component covers a tree row).
+     */
+    interface BsTreeItem {
+        /**
+          * Disables the row: not focusable, ignores clicks, dimmed. Reflected.
+          * @default false
+         */
+        "disabled"?: boolean;
+        /**
+          * Whether the child items are shown. Only meaningful for parents. Mutable: the caret, the keyboard and the owning tree toggle it. Reflected.
+          * @default false
+         */
+        "expanded"?: boolean;
+        /**
+          * The row's text. Use the `label` slot for rich content.
+          * @default ''
+         */
+        "label"?: string;
+        /**
+          * Emitted (bubbling, composed) when the user activates the row, with the item's value. The owning `bs-tree` listens and updates the selection.
+         */
+        "onBsSelect"?: (event: BsTreeItemCustomEvent<string>) => void;
+        /**
+          * Emitted when the user toggles expansion (caret click or keyboard), with the new `expanded` value. Not emitted when `expanded` is set from code.
+         */
+        "onBsToggle"?: (event: BsTreeItemCustomEvent<boolean>) => void;
+        /**
+          * Marks the row as selected. Owned by the tree (single selection, synced with its `value`). Reflected.
+          * @default false
+         */
+        "selected"?: boolean;
+        /**
+          * Shows the leading icon (default folder / file, or the `icon` slot).
+          * @default true
+         */
+        "showIcon"?: boolean;
+        /**
+          * Identifier used in events and for the tree's `value`. Falls back to `label` when empty.
+          * @default ''
+         */
+        "value"?: string;
+    }
     /**
      * A product's "What's new" surface, in three forms matching the Figma component:
      * - `feed` -- a docked panel: heading, "Mark all as read", filter tabs, the list of updates (each a
@@ -11965,6 +14074,35 @@ declare namespace LocalJSX {
         "page": string;
         "href": string;
     }
+    interface BsCommandPaletteAttributes {
+        "value": string;
+        "open": boolean;
+        "commandsOnly": boolean;
+        "status": BsCommandPaletteStatus;
+        "label": string;
+        "placeholder": string;
+        "keepOpenOnSelect": boolean;
+        "showFooter": boolean;
+        "hotkey": string;
+        "scopeLabel": string;
+        "recentLabel": string;
+        "suggestedLabel": string;
+        "commandsLabel": string;
+        "navigationLabel": string;
+        "recordsLabel": string;
+        "tryInsteadLabel": string;
+        "navigateLabel": string;
+        "openLabel": string;
+        "closeLabel": string;
+        "commandsOnlyLabel": string;
+        "allResultsLabel": string;
+        "emptyHeading": string;
+        "emptyDescription": string;
+        "didYouMean": string;
+        "didYouMeanLabel": string;
+        "loadingLabel": string;
+        "listLabel": string;
+    }
     interface BsComposerAttributes {
         "variant": BsComposerVariant;
         "placeholder": string;
@@ -12048,6 +14186,12 @@ declare namespace LocalJSX {
         "inset": BsDividerInset;
         "decorative": boolean;
     }
+    interface BsEmptyStateAttributes {
+        "heading": string;
+        "description": string;
+        "intent": BsIconTileIntent;
+        "headingLevel": 2 | 3 | 4 | 5 | 6;
+    }
     interface BsErrorPageAttributes {
         "type": BsErrorPageType;
         "code": string;
@@ -12079,6 +14223,33 @@ declare namespace LocalJSX {
         "cancelLabel": string;
         "removeLabel": string;
     }
+    interface BsGlobalSearchAttributes {
+        "value": string;
+        "placeholder": string;
+        "label": string;
+        "disabled": boolean;
+        "open": boolean;
+        "status": BsGlobalSearchStatus;
+        "totalResults": number;
+        "showFooter": boolean;
+        "listLabel": string;
+        "recentLabel": string;
+        "jumpToLabel": string;
+        "topMatchesLabel": string;
+        "searchInLabel": string;
+        "navigateLabel": string;
+        "searchLabel": string;
+        "closeLabel": string;
+        "fullResultsLabel": string;
+        "clearRecentLabel": string;
+        "seeAllLabel": string;
+        "emptyHeading": string;
+        "emptyDescription": string;
+        "clearSearchLabel": string;
+        "errorHeading": string;
+        "errorDescription": string;
+        "retryLabel": string;
+    }
     interface BsGridAttributes {
         "columns": string;
         "gap": string;
@@ -12141,6 +14312,46 @@ declare namespace LocalJSX {
         "length": number;
         "open": boolean;
     }
+    interface BsKeyAttributes {
+        "label": string;
+    }
+    interface BsKeyCapsAttributes {
+        "keys": string | string[];
+        "disabled": boolean;
+        "label": string;
+    }
+    interface BsKeyboardShortcutsAttributes {
+        "heading": string;
+        "closeLabel": string;
+        "searchPlaceholder": string;
+        "query": string;
+        "showSingleKeySwitch": boolean;
+        "singleKeyEnabled": boolean;
+        "singleKeyLabel": string;
+        "singleKeyDescription": string;
+        "showFooterHint": boolean;
+        "footerKey": string;
+        "footerText": string;
+        "footerPrefix": string;
+        "noResultsText": string;
+    }
+    interface BsListAttributes {
+        "selectable": boolean;
+        "value": string | null;
+        "dividers": boolean;
+        "ariaLabel": string | null;
+    }
+    interface BsListItemAttributes {
+        "label": string | null;
+        "description": string | null;
+        "supportText": string | null;
+        "selected": boolean;
+        "disabled": boolean;
+        "showArrow": boolean;
+        "value": string | null;
+        "interactive": boolean;
+        "selectionRole": 'listitem' | 'option' | null;
+    }
     interface BsLogoAttributes {
         "variant": BsLogoVariant;
         "background": BsLogoBackground;
@@ -12276,6 +14487,13 @@ declare namespace LocalJSX {
         "checked": boolean;
         "disabled": boolean;
     }
+    interface BsSearchItemAttributes {
+        "value": string;
+        "active": boolean;
+        "disabled": boolean;
+        "trailing": string;
+        "selectionRole": 'option' | null;
+    }
     interface BsSessionTimeoutAttributes {
         "type": BsSessionTimeoutType;
         "heading": string;
@@ -12298,6 +14516,13 @@ declare namespace LocalJSX {
         "dividerLabel": string;
         "cancelLabel": string;
     }
+    interface BsShortcutRowAttributes {
+        "action": string;
+        "keys": string | string[];
+        "label": string;
+        "disabled": boolean;
+        "selectionRole": 'listitem' | null;
+    }
     interface BsSidePanelAttributes {
         "open": boolean;
         "heading": string;
@@ -12425,6 +14650,19 @@ declare namespace LocalJSX {
         "delay": number;
         "placement": BsTooltipTriggerPlacement;
     }
+    interface BsTreeAttributes {
+        "ariaLabel": string | null;
+        "value": string;
+        "selectable": boolean;
+    }
+    interface BsTreeItemAttributes {
+        "label": string;
+        "expanded": boolean;
+        "selected": boolean;
+        "disabled": boolean;
+        "showIcon": boolean;
+        "value": string;
+    }
     interface BsWhatsNewAttributes {
         "type": BsWhatsNewType;
         "heading": string;
@@ -12490,6 +14728,7 @@ declare namespace LocalJSX {
         "bs-chip-informative": Omit<BsChipInformative, keyof BsChipInformativeAttributes> & { [K in keyof BsChipInformative & keyof BsChipInformativeAttributes]?: BsChipInformative[K] } & { [K in keyof BsChipInformative & keyof BsChipInformativeAttributes as `attr:${K}`]?: BsChipInformativeAttributes[K] } & { [K in keyof BsChipInformative & keyof BsChipInformativeAttributes as `prop:${K}`]?: BsChipInformative[K] };
         "bs-chip-input": Omit<BsChipInput, keyof BsChipInputAttributes> & { [K in keyof BsChipInput & keyof BsChipInputAttributes]?: BsChipInput[K] } & { [K in keyof BsChipInput & keyof BsChipInputAttributes as `attr:${K}`]?: BsChipInputAttributes[K] } & { [K in keyof BsChipInput & keyof BsChipInputAttributes as `prop:${K}`]?: BsChipInput[K] };
         "bs-citation-preview": Omit<BsCitationPreview, keyof BsCitationPreviewAttributes> & { [K in keyof BsCitationPreview & keyof BsCitationPreviewAttributes]?: BsCitationPreview[K] } & { [K in keyof BsCitationPreview & keyof BsCitationPreviewAttributes as `attr:${K}`]?: BsCitationPreviewAttributes[K] } & { [K in keyof BsCitationPreview & keyof BsCitationPreviewAttributes as `prop:${K}`]?: BsCitationPreview[K] };
+        "bs-command-palette": Omit<BsCommandPalette, keyof BsCommandPaletteAttributes> & { [K in keyof BsCommandPalette & keyof BsCommandPaletteAttributes]?: BsCommandPalette[K] } & { [K in keyof BsCommandPalette & keyof BsCommandPaletteAttributes as `attr:${K}`]?: BsCommandPaletteAttributes[K] } & { [K in keyof BsCommandPalette & keyof BsCommandPaletteAttributes as `prop:${K}`]?: BsCommandPalette[K] };
         "bs-composer": Omit<BsComposer, keyof BsComposerAttributes> & { [K in keyof BsComposer & keyof BsComposerAttributes]?: BsComposer[K] } & { [K in keyof BsComposer & keyof BsComposerAttributes as `attr:${K}`]?: BsComposerAttributes[K] } & { [K in keyof BsComposer & keyof BsComposerAttributes as `prop:${K}`]?: BsComposer[K] };
         "bs-composer-status-banner": Omit<BsComposerStatusBanner, keyof BsComposerStatusBannerAttributes> & { [K in keyof BsComposerStatusBanner & keyof BsComposerStatusBannerAttributes]?: BsComposerStatusBanner[K] } & { [K in keyof BsComposerStatusBanner & keyof BsComposerStatusBannerAttributes as `attr:${K}`]?: BsComposerStatusBannerAttributes[K] } & { [K in keyof BsComposerStatusBanner & keyof BsComposerStatusBannerAttributes as `prop:${K}`]?: BsComposerStatusBanner[K] };
         "bs-container": Omit<BsContainer, keyof BsContainerAttributes> & { [K in keyof BsContainer & keyof BsContainerAttributes]?: BsContainer[K] } & { [K in keyof BsContainer & keyof BsContainerAttributes as `attr:${K}`]?: BsContainerAttributes[K] } & { [K in keyof BsContainer & keyof BsContainerAttributes as `prop:${K}`]?: BsContainer[K] };
@@ -12498,14 +14737,21 @@ declare namespace LocalJSX {
         "bs-datepicker": Omit<BsDatepicker, keyof BsDatepickerAttributes> & { [K in keyof BsDatepicker & keyof BsDatepickerAttributes]?: BsDatepicker[K] } & { [K in keyof BsDatepicker & keyof BsDatepickerAttributes as `attr:${K}`]?: BsDatepickerAttributes[K] } & { [K in keyof BsDatepicker & keyof BsDatepickerAttributes as `prop:${K}`]?: BsDatepicker[K] };
         "bs-dialog": Omit<BsDialog, keyof BsDialogAttributes> & { [K in keyof BsDialog & keyof BsDialogAttributes]?: BsDialog[K] } & { [K in keyof BsDialog & keyof BsDialogAttributes as `attr:${K}`]?: BsDialogAttributes[K] } & { [K in keyof BsDialog & keyof BsDialogAttributes as `prop:${K}`]?: BsDialog[K] };
         "bs-divider": Omit<BsDivider, keyof BsDividerAttributes> & { [K in keyof BsDivider & keyof BsDividerAttributes]?: BsDivider[K] } & { [K in keyof BsDivider & keyof BsDividerAttributes as `attr:${K}`]?: BsDividerAttributes[K] } & { [K in keyof BsDivider & keyof BsDividerAttributes as `prop:${K}`]?: BsDivider[K] };
+        "bs-empty-state": Omit<BsEmptyState, keyof BsEmptyStateAttributes> & { [K in keyof BsEmptyState & keyof BsEmptyStateAttributes]?: BsEmptyState[K] } & { [K in keyof BsEmptyState & keyof BsEmptyStateAttributes as `attr:${K}`]?: BsEmptyStateAttributes[K] } & { [K in keyof BsEmptyState & keyof BsEmptyStateAttributes as `prop:${K}`]?: BsEmptyState[K] };
         "bs-error-page": Omit<BsErrorPage, keyof BsErrorPageAttributes> & { [K in keyof BsErrorPage & keyof BsErrorPageAttributes]?: BsErrorPage[K] } & { [K in keyof BsErrorPage & keyof BsErrorPageAttributes as `attr:${K}`]?: BsErrorPageAttributes[K] } & { [K in keyof BsErrorPage & keyof BsErrorPageAttributes as `prop:${K}`]?: BsErrorPage[K] };
         "bs-file-upload": Omit<BsFileUpload, keyof BsFileUploadAttributes> & { [K in keyof BsFileUpload & keyof BsFileUploadAttributes]?: BsFileUpload[K] } & { [K in keyof BsFileUpload & keyof BsFileUploadAttributes as `attr:${K}`]?: BsFileUploadAttributes[K] } & { [K in keyof BsFileUpload & keyof BsFileUploadAttributes as `prop:${K}`]?: BsFileUpload[K] };
         "bs-file-upload-item": Omit<BsFileUploadItem, keyof BsFileUploadItemAttributes> & { [K in keyof BsFileUploadItem & keyof BsFileUploadItemAttributes]?: BsFileUploadItem[K] } & { [K in keyof BsFileUploadItem & keyof BsFileUploadItemAttributes as `attr:${K}`]?: BsFileUploadItemAttributes[K] } & { [K in keyof BsFileUploadItem & keyof BsFileUploadItemAttributes as `prop:${K}`]?: BsFileUploadItem[K] };
+        "bs-global-search": Omit<BsGlobalSearch, keyof BsGlobalSearchAttributes> & { [K in keyof BsGlobalSearch & keyof BsGlobalSearchAttributes]?: BsGlobalSearch[K] } & { [K in keyof BsGlobalSearch & keyof BsGlobalSearchAttributes as `attr:${K}`]?: BsGlobalSearchAttributes[K] } & { [K in keyof BsGlobalSearch & keyof BsGlobalSearchAttributes as `prop:${K}`]?: BsGlobalSearch[K] };
         "bs-grid": Omit<BsGrid, keyof BsGridAttributes> & { [K in keyof BsGrid & keyof BsGridAttributes]?: BsGrid[K] } & { [K in keyof BsGrid & keyof BsGridAttributes as `attr:${K}`]?: BsGridAttributes[K] } & { [K in keyof BsGrid & keyof BsGridAttributes as `prop:${K}`]?: BsGrid[K] };
         "bs-icon-button": Omit<BsIconButton, keyof BsIconButtonAttributes> & { [K in keyof BsIconButton & keyof BsIconButtonAttributes]?: BsIconButton[K] } & { [K in keyof BsIconButton & keyof BsIconButtonAttributes as `attr:${K}`]?: BsIconButtonAttributes[K] } & { [K in keyof BsIconButton & keyof BsIconButtonAttributes as `prop:${K}`]?: BsIconButton[K] };
         "bs-icon-tile": Omit<BsIconTile, keyof BsIconTileAttributes> & { [K in keyof BsIconTile & keyof BsIconTileAttributes]?: BsIconTile[K] } & { [K in keyof BsIconTile & keyof BsIconTileAttributes as `attr:${K}`]?: BsIconTileAttributes[K] } & { [K in keyof BsIconTile & keyof BsIconTileAttributes as `prop:${K}`]?: BsIconTile[K] };
         "bs-inline-tab": Omit<BsInlineTab, keyof BsInlineTabAttributes> & { [K in keyof BsInlineTab & keyof BsInlineTabAttributes]?: BsInlineTab[K] } & { [K in keyof BsInlineTab & keyof BsInlineTabAttributes as `attr:${K}`]?: BsInlineTabAttributes[K] } & { [K in keyof BsInlineTab & keyof BsInlineTabAttributes as `prop:${K}`]?: BsInlineTab[K] };
         "bs-input": Omit<BsInput, keyof BsInputAttributes> & { [K in keyof BsInput & keyof BsInputAttributes]?: BsInput[K] } & { [K in keyof BsInput & keyof BsInputAttributes as `attr:${K}`]?: BsInputAttributes[K] } & { [K in keyof BsInput & keyof BsInputAttributes as `prop:${K}`]?: BsInput[K] };
+        "bs-key": Omit<BsKey, keyof BsKeyAttributes> & { [K in keyof BsKey & keyof BsKeyAttributes]?: BsKey[K] } & { [K in keyof BsKey & keyof BsKeyAttributes as `attr:${K}`]?: BsKeyAttributes[K] } & { [K in keyof BsKey & keyof BsKeyAttributes as `prop:${K}`]?: BsKey[K] };
+        "bs-key-caps": Omit<BsKeyCaps, keyof BsKeyCapsAttributes> & { [K in keyof BsKeyCaps & keyof BsKeyCapsAttributes]?: BsKeyCaps[K] } & { [K in keyof BsKeyCaps & keyof BsKeyCapsAttributes as `attr:${K}`]?: BsKeyCapsAttributes[K] } & { [K in keyof BsKeyCaps & keyof BsKeyCapsAttributes as `prop:${K}`]?: BsKeyCaps[K] };
+        "bs-keyboard-shortcuts": Omit<BsKeyboardShortcuts, keyof BsKeyboardShortcutsAttributes> & { [K in keyof BsKeyboardShortcuts & keyof BsKeyboardShortcutsAttributes]?: BsKeyboardShortcuts[K] } & { [K in keyof BsKeyboardShortcuts & keyof BsKeyboardShortcutsAttributes as `attr:${K}`]?: BsKeyboardShortcutsAttributes[K] } & { [K in keyof BsKeyboardShortcuts & keyof BsKeyboardShortcutsAttributes as `prop:${K}`]?: BsKeyboardShortcuts[K] };
+        "bs-list": Omit<BsList, keyof BsListAttributes> & { [K in keyof BsList & keyof BsListAttributes]?: BsList[K] } & { [K in keyof BsList & keyof BsListAttributes as `attr:${K}`]?: BsListAttributes[K] } & { [K in keyof BsList & keyof BsListAttributes as `prop:${K}`]?: BsList[K] };
+        "bs-list-item": Omit<BsListItem, keyof BsListItemAttributes> & { [K in keyof BsListItem & keyof BsListItemAttributes]?: BsListItem[K] } & { [K in keyof BsListItem & keyof BsListItemAttributes as `attr:${K}`]?: BsListItemAttributes[K] } & { [K in keyof BsListItem & keyof BsListItemAttributes as `prop:${K}`]?: BsListItem[K] };
         "bs-logo": Omit<BsLogo, keyof BsLogoAttributes> & { [K in keyof BsLogo & keyof BsLogoAttributes]?: BsLogo[K] } & { [K in keyof BsLogo & keyof BsLogoAttributes as `attr:${K}`]?: BsLogoAttributes[K] } & { [K in keyof BsLogo & keyof BsLogoAttributes as `prop:${K}`]?: BsLogo[K] };
         "bs-menu": BsMenu;
         "bs-menu-item": Omit<BsMenuItem, keyof BsMenuItemAttributes> & { [K in keyof BsMenuItem & keyof BsMenuItemAttributes]?: BsMenuItem[K] } & { [K in keyof BsMenuItem & keyof BsMenuItemAttributes as `attr:${K}`]?: BsMenuItemAttributes[K] } & { [K in keyof BsMenuItem & keyof BsMenuItemAttributes as `prop:${K}`]?: BsMenuItem[K] };
@@ -12522,7 +14768,9 @@ declare namespace LocalJSX {
         "bs-progress-linear": Omit<BsProgressLinear, keyof BsProgressLinearAttributes> & { [K in keyof BsProgressLinear & keyof BsProgressLinearAttributes]?: BsProgressLinear[K] } & { [K in keyof BsProgressLinear & keyof BsProgressLinearAttributes as `attr:${K}`]?: BsProgressLinearAttributes[K] } & { [K in keyof BsProgressLinear & keyof BsProgressLinearAttributes as `prop:${K}`]?: BsProgressLinear[K] };
         "bs-qr-code": Omit<BsQrCode, keyof BsQrCodeAttributes> & { [K in keyof BsQrCode & keyof BsQrCodeAttributes]?: BsQrCode[K] } & { [K in keyof BsQrCode & keyof BsQrCodeAttributes as `attr:${K}`]?: BsQrCodeAttributes[K] } & { [K in keyof BsQrCode & keyof BsQrCodeAttributes as `prop:${K}`]?: BsQrCode[K] };
         "bs-radio": Omit<BsRadio, keyof BsRadioAttributes> & { [K in keyof BsRadio & keyof BsRadioAttributes]?: BsRadio[K] } & { [K in keyof BsRadio & keyof BsRadioAttributes as `attr:${K}`]?: BsRadioAttributes[K] } & { [K in keyof BsRadio & keyof BsRadioAttributes as `prop:${K}`]?: BsRadio[K] };
+        "bs-search-item": Omit<BsSearchItem, keyof BsSearchItemAttributes> & { [K in keyof BsSearchItem & keyof BsSearchItemAttributes]?: BsSearchItem[K] } & { [K in keyof BsSearchItem & keyof BsSearchItemAttributes as `attr:${K}`]?: BsSearchItemAttributes[K] } & { [K in keyof BsSearchItem & keyof BsSearchItemAttributes as `prop:${K}`]?: BsSearchItem[K] };
         "bs-session-timeout": Omit<BsSessionTimeout, keyof BsSessionTimeoutAttributes> & { [K in keyof BsSessionTimeout & keyof BsSessionTimeoutAttributes]?: BsSessionTimeout[K] } & { [K in keyof BsSessionTimeout & keyof BsSessionTimeoutAttributes as `attr:${K}`]?: BsSessionTimeoutAttributes[K] } & { [K in keyof BsSessionTimeout & keyof BsSessionTimeoutAttributes as `prop:${K}`]?: BsSessionTimeout[K] };
+        "bs-shortcut-row": Omit<BsShortcutRow, keyof BsShortcutRowAttributes> & { [K in keyof BsShortcutRow & keyof BsShortcutRowAttributes]?: BsShortcutRow[K] } & { [K in keyof BsShortcutRow & keyof BsShortcutRowAttributes as `attr:${K}`]?: BsShortcutRowAttributes[K] } & { [K in keyof BsShortcutRow & keyof BsShortcutRowAttributes as `prop:${K}`]?: BsShortcutRow[K] };
         "bs-side-panel": Omit<BsSidePanel, keyof BsSidePanelAttributes> & { [K in keyof BsSidePanel & keyof BsSidePanelAttributes]?: BsSidePanel[K] } & { [K in keyof BsSidePanel & keyof BsSidePanelAttributes as `attr:${K}`]?: BsSidePanelAttributes[K] } & { [K in keyof BsSidePanel & keyof BsSidePanelAttributes as `prop:${K}`]?: BsSidePanel[K] };
         "bs-skeleton": Omit<BsSkeleton, keyof BsSkeletonAttributes> & { [K in keyof BsSkeleton & keyof BsSkeletonAttributes]?: BsSkeleton[K] } & { [K in keyof BsSkeleton & keyof BsSkeletonAttributes as `attr:${K}`]?: BsSkeletonAttributes[K] } & { [K in keyof BsSkeleton & keyof BsSkeletonAttributes as `prop:${K}`]?: BsSkeleton[K] };
         "bs-slider": Omit<BsSlider, keyof BsSliderAttributes> & { [K in keyof BsSlider & keyof BsSliderAttributes]?: BsSlider[K] } & { [K in keyof BsSlider & keyof BsSliderAttributes as `attr:${K}`]?: BsSliderAttributes[K] } & { [K in keyof BsSlider & keyof BsSliderAttributes as `prop:${K}`]?: BsSlider[K] };
@@ -12540,6 +14788,8 @@ declare namespace LocalJSX {
         "bs-toast": Omit<BsToast, keyof BsToastAttributes> & { [K in keyof BsToast & keyof BsToastAttributes]?: BsToast[K] } & { [K in keyof BsToast & keyof BsToastAttributes as `attr:${K}`]?: BsToastAttributes[K] } & { [K in keyof BsToast & keyof BsToastAttributes as `prop:${K}`]?: BsToast[K] };
         "bs-tooltip": Omit<BsTooltip, keyof BsTooltipAttributes> & { [K in keyof BsTooltip & keyof BsTooltipAttributes]?: BsTooltip[K] } & { [K in keyof BsTooltip & keyof BsTooltipAttributes as `attr:${K}`]?: BsTooltipAttributes[K] } & { [K in keyof BsTooltip & keyof BsTooltipAttributes as `prop:${K}`]?: BsTooltip[K] };
         "bs-tooltip-trigger": Omit<BsTooltipTrigger, keyof BsTooltipTriggerAttributes> & { [K in keyof BsTooltipTrigger & keyof BsTooltipTriggerAttributes]?: BsTooltipTrigger[K] } & { [K in keyof BsTooltipTrigger & keyof BsTooltipTriggerAttributes as `attr:${K}`]?: BsTooltipTriggerAttributes[K] } & { [K in keyof BsTooltipTrigger & keyof BsTooltipTriggerAttributes as `prop:${K}`]?: BsTooltipTrigger[K] };
+        "bs-tree": Omit<BsTree, keyof BsTreeAttributes> & { [K in keyof BsTree & keyof BsTreeAttributes]?: BsTree[K] } & { [K in keyof BsTree & keyof BsTreeAttributes as `attr:${K}`]?: BsTreeAttributes[K] } & { [K in keyof BsTree & keyof BsTreeAttributes as `prop:${K}`]?: BsTree[K] };
+        "bs-tree-item": Omit<BsTreeItem, keyof BsTreeItemAttributes> & { [K in keyof BsTreeItem & keyof BsTreeItemAttributes]?: BsTreeItem[K] } & { [K in keyof BsTreeItem & keyof BsTreeItemAttributes as `attr:${K}`]?: BsTreeItemAttributes[K] } & { [K in keyof BsTreeItem & keyof BsTreeItemAttributes as `prop:${K}`]?: BsTreeItem[K] };
         "bs-whats-new": Omit<BsWhatsNew, keyof BsWhatsNewAttributes> & { [K in keyof BsWhatsNew & keyof BsWhatsNewAttributes]?: BsWhatsNew[K] } & { [K in keyof BsWhatsNew & keyof BsWhatsNewAttributes as `attr:${K}`]?: BsWhatsNewAttributes[K] } & { [K in keyof BsWhatsNew & keyof BsWhatsNewAttributes as `prop:${K}`]?: BsWhatsNew[K] };
         "bs-whats-new-entry": Omit<BsWhatsNewEntry, keyof BsWhatsNewEntryAttributes> & { [K in keyof BsWhatsNewEntry & keyof BsWhatsNewEntryAttributes]?: BsWhatsNewEntry[K] } & { [K in keyof BsWhatsNewEntry & keyof BsWhatsNewEntryAttributes as `attr:${K}`]?: BsWhatsNewEntryAttributes[K] } & { [K in keyof BsWhatsNewEntry & keyof BsWhatsNewEntryAttributes as `prop:${K}`]?: BsWhatsNewEntry[K] };
     }
@@ -13117,6 +15367,37 @@ declare module "@stencil/core" {
              * @prop --bs-citation-preview-page-color - Page label color. Aliased to `--bs-text-secondary`.
              */
             "bs-citation-preview": LocalJSX.IntrinsicElements["bs-citation-preview"] & JSXBase.HTMLAttributes<HTMLBsCitationPreviewElement>;
+            /**
+             * A Ctrl+K command palette: a modal with a search field, grouped commands, navigation and records, a
+             * no-results view and a keyboard-hint footer. The data, the filtering, the command registry and the
+             * recent-items storage are all yours: you slot `bs-search-item`s into the sections and set `status`.
+             * Built from a native `<dialog>` (opened with `showModal()`, so focus is trapped, the page behind is inert
+             * and the backdrop is the scrim), `bs-input` (type="search"), `bs-search-item`, `bs-key` (footer hints and
+             * the Esc cap), `bs-chip-informative` (the scope chip) and `bs-spinner` (loading). Slot a `bs-key-caps` with
+             * `slot="trailing"` inside an item to show a command's shortcut.
+             * ## When to use
+             * - An app-wide "do anything" entry point opened with a hotkey: run commands, navigate, open records.
+             * ## When not to use
+             * - A plain search box with a dropdown -- use `bs-global-search`.
+             * - A small list of actions on one control -- use `bs-menu`.
+             * A `>` as the first character of the field switches to commands-only mode (`commandsOnly`, reflected as
+             * `commands-only`). The component filters nothing: listen to `bsInput`, swap the slotted items, set `status`.
+             * Nested (sub-command) palettes are a consumer pattern: swap the slotted commands and set `scopeLabel`.
+             * @prop --bs-command-palette-width - Panel width. Defaults to `640px` (Figma); capped to the viewport.
+             * @prop --bs-command-palette-top - Distance from the top of the viewport. Defaults to `12vh`.
+             * @prop --bs-command-palette-max-height - Max height of the results area. Defaults to `60vh`.
+             * @prop --bs-command-palette-radius - Aliased to `--bs-border-radius-150`.
+             * @prop --bs-command-palette-bg - Panel background. Aliased to `--bs-surface-base`.
+             * @prop --bs-command-palette-shadow - Figma elevation level 4: `0 8px 16px` in `--bs-elevation-higher` (stronger in dark mode).
+             * @prop --bs-command-palette-overlay - Scrim colour. Aliased to `--bs-surface-overlay`.
+             * @prop --bs-command-palette-footer-bg - Aliased to `--bs-surface-container`.
+             * @prop --bs-command-palette-divider-color - Aliased to `--bs-border-default`.
+             * @prop --bs-command-palette-header-border-color - Aliased to `--bs-border-neutral-container`.
+             * @prop --bs-command-palette-header-color - Aliased to `--bs-text-muted`.
+             * @prop --bs-command-palette-hint-color - Aliased to `--bs-text-secondary`.
+             * @prop --bs-command-palette-z-index - Aliased to `--bs-z-index-modal`.
+             */
+            "bs-command-palette": LocalJSX.IntrinsicElements["bs-command-palette"] & JSXBase.HTMLAttributes<HTMLBsCommandPaletteElement>;
             /**
              * A chat composer input for Genie AI-style conversational interfaces: a text field
              * plus an attach button, a mic/voice-recording toggle, and a single primary action button whose
@@ -13313,6 +15594,24 @@ declare module "@stencil/core" {
              * @prop --bs-divider-inset - Indent applied by `inset`. Aliased to `--bs-spacing-300`.
              */
             "bs-divider": LocalJSX.IntrinsicElements["bs-divider"] & JSXBase.HTMLAttributes<HTMLBsDividerElement>;
+            /**
+             * A centered "nothing to show" block: an icon tile, a heading, a description and an optional action.
+             * Used for empty lists, "no results" and error states inside a panel, card or page section.
+             * Built from `bs-icon-tile` (and, in your `action` slot, usually a `bs-button`).
+             * The component has no role. Live regions belong on a wrapper you control (e.g. `role="status"` on the
+             * element that stays in the DOM while this block appears and disappears).
+             * ## When to use
+             * - A list, table or search result that has nothing to show, or failed to load.
+             * ## When not to use
+             * - A full-page error with a status code -- use `bs-error-page`.
+             * - A transient message -- use `bs-toast` or `bs-snackbar`.
+             * @prop --bs-empty-state-padding-y - Vertical padding. Aliased to `--bs-spacing-700` (56px).
+             * @prop --bs-empty-state-padding-x - Horizontal padding. Aliased to `--bs-spacing-300` (24px).
+             * @prop --bs-empty-state-gap - Gap between tile, heading, description and action. Aliased to `--bs-spacing-150`.
+             * @prop --bs-empty-state-heading-color - Aliased to `--bs-text-default`.
+             * @prop --bs-empty-state-description-color - Aliased to `--bs-text-secondary`.
+             */
+            "bs-empty-state": LocalJSX.IntrinsicElements["bs-empty-state"] & JSXBase.HTMLAttributes<HTMLBsEmptyStateElement>;
             /**
              * A full-block page for when the user can't get to what they asked for: page not found (404), a server
              * error (500), no access (403), planned maintenance, or no internet connection. Matches the Figma
@@ -13352,6 +15651,37 @@ declare module "@stencil/core" {
              * - Attaching files to a chat message -- use `bs-attachment`.
              */
             "bs-file-upload-item": LocalJSX.IntrinsicElements["bs-file-upload-item"] & JSXBase.HTMLAttributes<HTMLBsFileUploadItemElement>;
+            /**
+             * A global search combobox: a search field with a dropdown panel of suggestions, results, an empty state
+             * or an error state, plus a keyboard-hint footer. The data, the filtering and the recent-search storage
+             * are all yours: you slot `bs-search-item`s into the sections and tell the component which `status` to show.
+             * Built from `bs-input` (type="search"), `bs-search-item`, `bs-empty-state` (and so `bs-icon-tile`),
+             * `bs-button` and `bs-key` (the footer keycaps).
+             * ## When to use
+             * - An app-wide "find anything" field with recent searches, jump-to shortcuts and grouped results.
+             * ## When not to use
+             * - Filtering the list or table that is already on screen -- use `bs-input type="search"`.
+             * - A list of commands or actions -- use `bs-menu`.
+             * - The complete result set -- link to a full search results page ("See all results").
+             * Put `bs-search-item` children in the light DOM with `slot="recent"`, `slot="jump-to"`,
+             * `slot="top-matches"` or `slot="search-in"`. A section (and its header) is only rendered when its slot has
+             * content. Up/Down arrows move a highlight through the visible items; focus never leaves the field.
+             * Known limit: the items are in your light DOM and the combobox in this shadow root, so
+             * `aria-activedescendant` (an id reference) does not resolve across that boundary in every browser; the
+             * highlighted option also gets `aria-selected="true"`.
+             * @prop --bs-global-search-width - Field and panel width. Defaults to `480px` (Figma); capped at 100%.
+             * @prop --bs-global-search-panel-radius - Aliased to `--bs-border-radius-100`.
+             * @prop --bs-global-search-panel-padding - Aliased to `--bs-spacing-100`.
+             * @prop --bs-global-search-gap - Gap between sections, and between the field and the panel. Aliased to `--bs-spacing-100`.
+             * @prop --bs-global-search-panel-bg - Panel background. Aliased to `--bs-surface-base`.
+             * @prop --bs-global-search-shadow - Panel shadow: Figma elevation level 3 (`0 4px 8px` in `--bs-elevation-high`, 10% black in light mode and 30% in dark mode).
+             * @prop --bs-global-search-z-index - Panel stacking. Aliased to `--bs-z-index-dropdown`.
+             * @prop --bs-global-search-divider-color - Footer divider. Aliased to `--bs-border-default`.
+             * @prop --bs-global-search-header-border-color - Section header underline. Aliased to `--bs-border-neutral-container`.
+             * @prop --bs-global-search-header-color - Section header text. Aliased to `--bs-text-muted`.
+             * @prop --bs-global-search-hint-color - Footer hint text. Aliased to `--bs-text-secondary`.
+             */
+            "bs-global-search": LocalJSX.IntrinsicElements["bs-global-search"] & JSXBase.HTMLAttributes<HTMLBsGlobalSearchElement>;
             /**
              * A CSS grid layout wrapper. Children are placed in equal-width columns with a token-based gap.
              * `columns` takes either a number (`"3"` becomes `repeat(3, minmax(0, 1fr))`) or any raw
@@ -13446,6 +15776,113 @@ declare module "@stencil/core" {
              *   options list at all (freeform chip entry).
              */
             "bs-input": LocalJSX.IntrinsicElements["bs-input"] & JSXBase.HTMLAttributes<HTMLBsInputElement>;
+            /**
+             * One key of a keyboard shortcut, e.g. `Ctrl`, `K` or `Esc` -- rendered as a `<kbd>` keycap.
+             * Shows a text label, or an icon (e.g. a return arrow) via the `icon` slot.
+             * ## When to use
+             * - Showing a keyboard shortcut hint next to a control or inside a search field.
+             * - Alone for a single key, or as the children of `bs-key-caps` for a multi-key shortcut.
+             * ## When not to use
+             * - As a button or any clickable control -- a key is a static hint, not interactive.
+             * @prop --bs-key-bg - Cap background. Aliased to `--bs-surface-base`.
+             * @prop --bs-key-border-color - Cap border colour. Aliased to `--bs-border-default`.
+             * @prop --bs-key-radius - Cap corner radius. Aliased to `--bs-border-radius-50`.
+             * @prop --bs-key-padding-x - Horizontal padding. Aliased to `--bs-spacing-75`.
+             * @prop --bs-key-padding-y - Vertical padding. Aliased to `--bs-spacing-50`.
+             * @prop --bs-key-min-width - Smallest cap width, so single characters keep a keycap shape. Defaults to `25px` (Figma).
+             * @prop --bs-key-color - Label colour. Aliased to `--bs-text-secondary`.
+             * @prop --bs-key-font-size - Label size. Aliased to `--bs-font-size-xs` (12px).
+             * @prop --bs-key-icon-size - Icon size. Defaults to `16px` (Figma).
+             */
+            "bs-key": LocalJSX.IntrinsicElements["bs-key"] & JSXBase.HTMLAttributes<HTMLBsKeyElement>;
+            /**
+             * A keyboard shortcut of one to four keys joined by "+", e.g. `Ctrl + K`. Give it a `keys` string
+             * (`"Ctrl+Shift+K"`) or array (`['Ctrl', '+']` for a literal plus key), or slot your own `bs-key`
+             * elements -- for example when a key is an icon.
+             * ## When to use
+             * - A shortcut hint beside a menu item, button or inside a search field.
+             * ## When not to use
+             * - Instructions that need prose ("press Enter to submit") -- write a sentence and use a single `bs-key` inline.
+             * - Anything interactive -- keys are static hints.
+             * @prop --bs-key-caps-gap - Gap between keys and separators. Aliased to `--bs-spacing-100`.
+             * @prop --bs-key-caps-separator-color - Colour of the "+" separators. Aliased to `--bs-text-muted`.
+             * @prop --bs-key-caps-disabled-opacity - Opacity of the whole shortcut while `disabled`. Defaults to `0.38` (Figma).
+             */
+            "bs-key-caps": LocalJSX.IntrinsicElements["bs-key-caps"] & JSXBase.HTMLAttributes<HTMLBsKeyCapsElement>;
+            /**
+             * A searchable reference panel of keyboard shortcuts: heading and close button, a search field, an
+             * optional single-key on/off switch, shortcut groups in two columns and a footer hint. It is a
+             * surface, not a modal -- place it inside `bs-dialog` or a popover.
+             * Built from `bs-card`, `bs-icon-button`, `bs-input`, `bs-switch`, `bs-shortcut-row` (and so
+             * `bs-key-caps` / `bs-key`).
+             * ## When to use
+             * - A "press ? to see shortcuts" help overlay for an app with many shortcuts.
+             * ## When not to use
+             * - A long-form help page or documentation -- link to it instead.
+             * - A list of commands the user can run from it -- use `bs-menu`.
+             * @prop --bs-keyboard-shortcuts-width - Panel width and min-width. Defaults to `720px` (Figma).
+             * @prop --bs-keyboard-shortcuts-bg - Panel background. Aliased to `--bs-surface-base`.
+             * @prop --bs-keyboard-shortcuts-radius - Aliased to `--bs-border-radius-150`.
+             * @prop --bs-keyboard-shortcuts-padding - Aliased to `--bs-spacing-200`.
+             * @prop --bs-keyboard-shortcuts-gap - Gap between sections. Aliased to `--bs-spacing-200`.
+             * @prop --bs-keyboard-shortcuts-shadow - Figma elevation level 4 (`0 8px 8px` in `--bs-elevation-higher`, 12% black in light mode and 25% in dark mode).
+             * @prop --bs-keyboard-shortcuts-column-gap - Gap between the two columns. Aliased to `--bs-spacing-600`.
+             * @prop --bs-keyboard-shortcuts-color - Main text colour. Aliased to `--bs-text-default`.
+             * @prop --bs-keyboard-shortcuts-color-secondary - Titles, captions, footer. Aliased to `--bs-text-secondary`.
+             */
+            "bs-keyboard-shortcuts": LocalJSX.IntrinsicElements["bs-keyboard-shortcuts"] & JSXBase.HTMLAttributes<HTMLBsKeyboardShortcutsElement>;
+            /**
+             * A vertical list of `bs-list-item` rows, optionally single-select.
+             * ## When to use
+             * - Records, people, files or options shown as rows with leading media and descriptions.
+             * - `selectable` for a single-choice list (e.g. a conversation list next to a detail pane).
+             * ## When not to use
+             * - A popup list of actions -- use `bs-menu`.
+             * - Navigation between app sections -- use `bs-navigation-drawer`.
+             * - Multi-column, sortable or paged data -- use `bs-data-table`.
+             * Built from `bs-list-item` children (light DOM; the list never moves nodes).
+             * @prop --bs-list-gap - Gap between rows. Defaults to `0`.
+             * @prop --bs-list-divider-color - Divider colour when `dividers` is set. Aliased to `--bs-border-neutral-container`.
+             */
+            "bs-list": LocalJSX.IntrinsicElements["bs-list"] & JSXBase.HTMLAttributes<HTMLBsListElement>;
+            /**
+             * A single row of a list: optional leading media (avatar, icon, image), a label, a description and
+             * optional support text, and an optional trailing caret or custom trailing content.
+             * ## When to use
+             * - As a child of `bs-list`, one per record, person, file or option.
+             * - Standalone as a plain information row (non-interactive), or with `interactive` as a button-like row.
+             * ## When not to use
+             * - A popup list of actions -- use `bs-menu` / `bs-menu-item`.
+             * - App navigation with an active route -- use `bs-navigation-drawer-item`.
+             * - Tabular data with columns, sorting or paging -- use `bs-data-table`.
+             * Composed from: leading media (`bs-avatar`) and trailing controls (`bs-icon-button`) are supplied by the
+             * consumer through the `leading` and `trailing` slots; the row itself only reserves layout. The default
+             * trailing caret is inline SVG.
+             * Roles are driven by the parent `bs-list` (via `selectionRole`). Standalone, the row has no role
+             * (`listitem` is only valid inside a list) unless `interactive` is set, which makes it a focusable
+             * `role="button"`.
+             * @prop --bs-list-item-min-height - Minimum row height. Aliased to `--bs-spacing-1000`.
+             * @prop --bs-list-item-padding-y - Aliased to `--bs-spacing-150`.
+             * @prop --bs-list-item-padding-x - Aliased to `--bs-spacing-200`.
+             * @prop --bs-list-item-gap - Gap between leading, content and trailing. Aliased to `--bs-spacing-200`.
+             * @prop --bs-list-item-content-gap - Gap between text lines. Aliased to `--bs-spacing-25`.
+             * @prop --bs-list-item-radius - Aliased to `--bs-border-radius-100`.
+             * @prop --bs-list-item-bg - Enabled background. `transparent`.
+             * @prop --bs-list-item-bg-hover - Aliased to `--bs-surface-hover`.
+             * @prop --bs-list-item-bg-pressed - Aliased to `--bs-surface-pressed`.
+             * @prop --bs-list-item-bg-focus - Aliased to `--bs-surface-focus`.
+             * @prop --bs-list-item-bg-selected - Aliased to `--bs-surface-selected`.
+             * @prop --bs-list-item-bg-selected-hover - Aliased to `--bs-surface-selected-hover`.
+             * @prop --bs-list-item-bg-selected-pressed - Aliased to `--bs-surface-selected-pressed`.
+             * @prop --bs-list-item-bg-selected-focus - Aliased to `--bs-surface-selected-focus`.
+             * @prop --bs-list-item-bg-disabled - Aliased to `--bs-surface-action-disabled`.
+             * @prop --bs-list-item-color - Text colour. Aliased to `--bs-text-default`.
+             * @prop --bs-list-item-color-disabled - Aliased to `--bs-text-on-disabled`.
+             * @prop --bs-list-item-focus-ring - Focus ring colour. Aliased to `--bs-border-neutral-focus`.
+             * @prop --bs-list-item-image-width - Leading image width. 72px.
+             * @prop --bs-list-item-image-height - Leading image height. 56px.
+             */
+            "bs-list-item": LocalJSX.IntrinsicElements["bs-list-item"] & JSXBase.HTMLAttributes<HTMLBsListItemElement>;
             /**
              * The BrandSync brand mark, as its own standalone component -- shared by `bs-navigation-header`
              * and `bs-navigation-drawer`, which used to each render their own duplicated copy of this SVG
@@ -13777,6 +16214,31 @@ declare module "@stencil/core" {
              * - An on/off setting that takes effect immediately (no explicit form submission) -- use `bs-switch`.
              */
             "bs-radio": LocalJSX.IntrinsicElements["bs-radio"] & JSXBase.HTMLAttributes<HTMLBsRadioElement>;
+            /**
+             * One result or suggestion row of a search dropdown: a leading icon, a primary line, an optional
+             * description line and trailing text. Static, not focusable -- focus stays in the search field and the
+             * parent (`bs-global-search`) marks the highlighted row with `active`.
+             * Standalone it has no role. `bs-global-search` sets `selectionRole="option"` (and an `id`) on its rows,
+             * the same pattern as `bs-list-item` and `bs-shortcut-row`.
+             * ## When to use
+             * - A suggestion, recent search or result inside `bs-global-search`.
+             * ## When not to use
+             * - A row in a generic list -- use `bs-list-item`.
+             * - A command in a popup menu -- use `bs-menu-item`.
+             * @prop --bs-search-item-min-height - Aliased to `--bs-spacing-600` (48px).
+             * @prop --bs-search-item-padding-y - Aliased to `--bs-spacing-100`.
+             * @prop --bs-search-item-padding-x - Aliased to `--bs-spacing-150`.
+             * @prop --bs-search-item-gap - Aliased to `--bs-spacing-100`.
+             * @prop --bs-search-item-radius - Aliased to `--bs-border-radius-100`.
+             * @prop --bs-search-item-bg - Resting background. `transparent`.
+             * @prop --bs-search-item-bg-active - Active (highlighted) and hover background. Aliased to `--bs-surface-hover`.
+             * @prop --bs-search-item-bg-pressed - Aliased to `--bs-surface-pressed`.
+             * @prop --bs-search-item-color - Primary text. Aliased to `--bs-text-default`.
+             * @prop --bs-search-item-color-muted - Description and trailing text. Aliased to `--bs-text-muted`.
+             * @prop --bs-search-item-color-disabled - Aliased to `--bs-text-on-disabled`.
+             * @prop --bs-search-item-icon-color - Aliased to `--bs-icon-default`.
+             */
+            "bs-search-item": LocalJSX.IntrinsicElements["bs-search-item"] & JSXBase.HTMLAttributes<HTMLBsSearchItemElement>;
             /**
              * The three moments around an expiring session, as one card. Matches the Figma "Session timeout"
              * component's three types:
@@ -13804,6 +16266,23 @@ declare module "@stencil/core" {
              * (`bs-dialog`) if the warning must trap focus.
              */
             "bs-session-timeout": LocalJSX.IntrinsicElements["bs-session-timeout"] & JSXBase.HTMLAttributes<HTMLBsSessionTimeoutElement>;
+            /**
+             * One row of a shortcut list: an action label on the left and its keyboard shortcut on the right.
+             * Static information, not interactive. Standalone it has no role; `bs-keyboard-shortcuts` sets
+             * `selectionRole="listitem"` on its rows (same pattern as `bs-list-item`).
+             * Built from `bs-key-caps` (and so `bs-key`).
+             * ## When to use
+             * - A line in a keyboard-shortcut reference, usually inside `bs-keyboard-shortcuts`.
+             * ## When not to use
+             * - A clickable command or menu entry -- use `bs-menu-item` (which has its own shortcut slot).
+             * @prop --bs-shortcut-row-height - Row height. Defaults to `36px` (Figma).
+             * @prop --bs-shortcut-row-padding-x - Horizontal padding. Aliased to `--bs-spacing-100`.
+             * @prop --bs-shortcut-row-gap - Gap between label and keys. Aliased to `--bs-spacing-100`.
+             * @prop --bs-shortcut-row-radius - Corner radius. Aliased to `--bs-border-radius-75`.
+             * @prop --bs-shortcut-row-color - Label colour. Aliased to `--bs-text-default`.
+             * @prop --bs-shortcut-row-color-disabled - Label colour while `disabled`. Aliased to `--bs-text-on-disabled`.
+             */
+            "bs-shortcut-row": LocalJSX.IntrinsicElements["bs-shortcut-row"] & JSXBase.HTMLAttributes<HTMLBsShortcutRowElement>;
             /**
              * A generic slide-in panel (drawer) anchored to the start or end edge, for history, filters, FAQ
              * and similar secondary content. Closes via its close button or Escape and emits `bsClose`.
@@ -14124,6 +16603,28 @@ declare module "@stencil/core" {
              * @prop --bs-tooltip-trigger-z-index - Stacking order. Aliased to `--bs-z-index-popover`.
              */
             "bs-tooltip-trigger": LocalJSX.IntrinsicElements["bs-tooltip-trigger"] & JSXBase.HTMLAttributes<HTMLBsTooltipTriggerElement>;
+            /**
+             * A hierarchical list of `bs-tree-item` rows with single selection, expand/collapse and the
+             * WAI-ARIA tree keyboard pattern.
+             * The tree owns `role="tree"`, the roving `tabindex` (exactly one enabled, visible item is
+             * tabbable: the selected one, otherwise the first), selection (kept in sync with each item's
+             * `selected`) and keyboard navigation over the visible (rendered, non-disabled) items. Items own
+             * their expansion state and emit `bsSelect` / `bsToggle`.
+             * Built from: `bs-tree-item` rows.
+             */
+            "bs-tree": LocalJSX.IntrinsicElements["bs-tree"] & JSXBase.HTMLAttributes<HTMLBsTreeElement>;
+            /**
+             * A single row of a `bs-tree`. An item that contains child `bs-tree-item` elements is a parent
+             * (it gets an expand/collapse caret and a folder icon); an item without children is a leaf (no
+             * caret, file icon).
+             * The host carries `role="treeitem"` and the `aria-*` state; the owning `bs-tree` manages the
+             * roving `tabindex`, selection and keyboard navigation. Nesting depth is computed automatically
+             * from the number of ancestor `bs-tree-item` elements and exposed as `aria-level` -- it is not a
+             * prop. Clicking the row selects it; clicking the caret (or pressing Right/Left in a tree) toggles
+             * expansion -- the two are deliberately separate.
+             * Built from: inline SVG icons only (no existing `bs-*` component covers a tree row).
+             */
+            "bs-tree-item": LocalJSX.IntrinsicElements["bs-tree-item"] & JSXBase.HTMLAttributes<HTMLBsTreeItemElement>;
             /**
              * A product's "What's new" surface, in three forms matching the Figma component:
              * - `feed` -- a docked panel: heading, "Mark all as read", filter tabs, the list of updates (each a