@brandsync/wc 1.16.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.
          */
@@ -2309,6 +2671,151 @@ export namespace Components {
          */
         "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;
+        /**
+          * 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
@@ -3297,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:
@@ -3421,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`.
@@ -4538,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;
@@ -4574,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;
@@ -4582,6 +5186,10 @@ 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;
@@ -4630,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;
@@ -5568,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;
@@ -5883,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;
@@ -5973,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
@@ -6120,6 +6860,89 @@ 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;
     }
@@ -6725,19 +7548,60 @@ declare global {
      *   use `bs-checkbox` instead.
      * - An on/off setting that takes effect immediately (no explicit form submission) -- use `bs-switch`.
      */
-    interface HTMLBsRadioElement extends Components.BsRadio, HTMLStencilElement {
-        addEventListener<K extends keyof HTMLBsRadioElementEventMap>(type: K, listener: (this: HTMLBsRadioElement, ev: BsRadioCustomEvent<HTMLBsRadioElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+    interface HTMLBsRadioElement extends Components.BsRadio, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsRadioElementEventMap>(type: K, listener: (this: HTMLBsRadioElement, ev: BsRadioCustomEvent<HTMLBsRadioElementEventMap[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 HTMLBsRadioElementEventMap>(type: K, listener: (this: HTMLBsRadioElement, ev: BsRadioCustomEvent<HTMLBsRadioElementEventMap[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 HTMLBsRadioElement: {
+        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 HTMLBsRadioElementEventMap>(type: K, listener: (this: HTMLBsRadioElement, ev: BsRadioCustomEvent<HTMLBsRadioElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): 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 HTMLBsRadioElement: {
-        prototype: HTMLBsRadioElement;
-        new (): HTMLBsRadioElement;
+    var HTMLBsSearchItemElement: {
+        prototype: HTMLBsSearchItemElement;
+        new (): HTMLBsSearchItemElement;
     };
     interface HTMLBsSessionTimeoutElementEventMap {
         "bsPrimary": { password?: string } | void;
@@ -6786,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;
     }
@@ -7458,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;
@@ -7466,14 +8353,19 @@ 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;
@@ -7492,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;
@@ -8826,6 +9720,180 @@ declare namespace LocalJSX {
          */
         "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;
+        /**
+          * @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;
+        /**
+          * 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
@@ -9440,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
@@ -9511,113 +10616,300 @@ declare namespace LocalJSX {
      */
     interface BsFileUpload {
         /**
-          * Which files are accepted, same syntax as the native `accept` attribute: comma-separated extensions (`.pdf`), MIME types (`image/png`) or wildcards (`image/*`). Applied to the picker and also to dropped files, which the browser does not filter.
+          * Which files are accepted, same syntax as the native `accept` attribute: comma-separated extensions (`.pdf`), MIME types (`image/png`) or wildcards (`image/*`). Applied to the picker and also to dropped files, which the browser does not filter.
+         */
+        "accept"?: string;
+        /**
+          * Label of the browse button. Override for localisation.
+          * @default 'Browse file'
+         */
+        "buttonLabel"?: string;
+        /**
+          * Guidelines under the heading (e.g. "PDF or JPG, up to 8MB").
+         */
+        "description"?: string;
+        /**
+          * Layout: icon beside the text (`horizontal`) or stacked above it, centered (`vertical`).
+          * @default 'horizontal'
+         */
+        "direction"?: BsFileUploadDirection;
+        /**
+          * Disables the browse button and ignores drops.
+          * @default false
+         */
+        "disabled"?: boolean;
+        /**
+          * Whether a file is currently being dragged over the dropzone (the Figma "Drop" state). Set by the component during a drag; mutable and reflected so it can also be set to show the state statically.
+          * @default false
+         */
+        "dragging"?: boolean;
+        /**
+          * Heading text (e.g. "Upload your documents").
+         */
+        "heading"?: string;
+        /**
+          * Allows selecting/dropping more than one file. Without it only the first file is taken.
+          * @default false
+         */
+        "multiple"?: boolean;
+        /**
+          * Fires with files that were not taken: they didn't match `accept`, or were extra files dropped while `multiple` is off.
+         */
+        "onBsFilesReject"?: (event: BsFileUploadCustomEvent<File[]>) => void;
+        /**
+          * Fires with the accepted files, after the picker closes or files are dropped.
+         */
+        "onBsFilesSelect"?: (event: BsFileUploadCustomEvent<File[]>) => void;
+    }
+    /**
+     * One file in an upload list: a thumbnail, the file name and size, a status line (a progress bar
+     * while uploading, or a success / error message) and an action button (cancel while uploading or
+     * after an error, remove once uploaded).
+     * Presentational only -- the consuming app owns the upload and drives `state`, `progress` and
+     * `message` from it. Pair with `bs-file-upload` (the dropzone that picks the files).
+     * ## When to use
+     * - Showing the status of each file the user has added, in a list under a `bs-file-upload`.
+     * ## When not to use
+     * - Attaching files to a chat message -- use `bs-attachment`.
+     */
+    interface BsFileUploadItem {
+        /**
+          * Accessible name of the cancel button (`loading`, `in-progress`, `error`).
+          * @default 'Cancel upload'
+         */
+        "cancelLabel"?: string;
+        /**
+          * The file name.
+          * @default ''
+         */
+        "fileName"?: string;
+        /**
+          * The file size, already formatted (e.g. "8MB").
+         */
+        "fileSize"?: string;
+        /**
+          * The status text. Defaults per state: "Loading..." (`loading`), "{progress}% uploaded" (`in-progress`), "Upload failed" (`error`), "File uploaded successfully" (`success`). Provide your own for localisation or a specific error.
+         */
+        "message"?: string;
+        /**
+          * Fires when the cancel button is clicked (`loading`, `in-progress`, `error`). The consumer stops the upload and removes the item.
+         */
+        "onBsCancel"?: (event: BsFileUploadItemCustomEvent<void>) => void;
+        /**
+          * Fires when the remove button is clicked (`success`). The consumer removes the file.
+         */
+        "onBsRemove"?: (event: BsFileUploadItemCustomEvent<void>) => void;
+        /**
+          * Upload progress, 0-100. Only used when `state="in-progress"`.
+          * @default 0
+         */
+        "progress"?: number;
+        /**
+          * Accessible name of the remove button (`success`).
+          * @default 'Remove file'
+         */
+        "removeLabel"?: string;
+        /**
+          * Where the upload is. `loading` = working with no known percentage (indeterminate bar); `in-progress` = uploading with a known `progress`; `error` and `success` are final.
+          * @default 'loading'
+         */
+        "state"?: BsFileUploadItemState;
+        /**
+          * Alt text for `thumbnailSrc`. Leave empty when the file name already says it all.
+          * @default ''
+         */
+        "thumbnailAlt"?: string;
+        /**
+          * A preview image of the file. Shown instead of the placeholder icon when set.
+         */
+        "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'
          */
-        "accept"?: string;
+        "navigateLabel"?: string;
         /**
-          * Label of the browse button. Override for localisation.
-          * @default 'Browse file'
+          * Fires when "Clear recent" is pressed.
          */
-        "buttonLabel"?: string;
+        "onBsClearRecent"?: (event: BsGlobalSearchCustomEvent<void>) => void;
         /**
-          * Guidelines under the heading (e.g. "PDF or JPG, up to 8MB").
+          * Fires when the empty state's "Clear search" is pressed; the value is also cleared.
          */
-        "description"?: string;
+        "onBsClearSearch"?: (event: BsGlobalSearchCustomEvent<void>) => void;
         /**
-          * Layout: icon beside the text (`horizontal`) or stacked above it, centered (`vertical`).
-          * @default 'horizontal'
+          * Fires on every keystroke with the query. The component filters nothing itself.
          */
-        "direction"?: BsFileUploadDirection;
+        "onBsInput"?: (event: BsGlobalSearchCustomEvent<string>) => void;
         /**
-          * Disables the browse button and ignores drops.
-          * @default false
+          * Fires when the panel opens or closes through user interaction, with the new state.
          */
-        "disabled"?: boolean;
+        "onBsOpenChange"?: (event: BsGlobalSearchCustomEvent<boolean>) => void;
         /**
-          * Whether a file is currently being dragged over the dropzone (the Figma "Drop" state). Set by the component during a drag; mutable and reflected so it can also be set to show the state statically.
-          * @default false
+          * Fires when the error state's "Try again" is pressed.
          */
-        "dragging"?: boolean;
+        "onBsRetry"?: (event: BsGlobalSearchCustomEvent<void>) => void;
         /**
-          * Heading text (e.g. "Upload your documents").
+          * Fires on Enter with no highlighted item, with the query.
          */
-        "heading"?: string;
+        "onBsSearch"?: (event: BsGlobalSearchCustomEvent<string>) => void;
         /**
-          * Allows selecting/dropping more than one file. Without it only the first file is taken.
-          * @default false
+          * Fires when "See all results" is pressed.
          */
-        "multiple"?: boolean;
+        "onBsSeeAll"?: (event: BsGlobalSearchCustomEvent<void>) => void;
         /**
-          * Fires with files that were not taken: they didn't match `accept`, or were extra files dropped while `multiple` is off.
+          * Fires when an item is chosen (click or Enter), with its `value` and section (slot name).
          */
-        "onBsFilesReject"?: (event: BsFileUploadCustomEvent<File[]>) => void;
+        "onBsSelect"?: (event: BsGlobalSearchCustomEvent<BsGlobalSearchSelectDetail>) => void;
         /**
-          * Fires with the accepted files, after the picker closes or files are dropped.
+          * Whether the dropdown panel is open. Opens on focus, click and typing; closes on Escape, outside click and selection.
+          * @default false
          */
-        "onBsFilesSelect"?: (event: BsFileUploadCustomEvent<File[]>) => void;
-    }
-    /**
-     * One file in an upload list: a thumbnail, the file name and size, a status line (a progress bar
-     * while uploading, or a success / error message) and an action button (cancel while uploading or
-     * after an error, remove once uploaded).
-     * Presentational only -- the consuming app owns the upload and drives `state`, `progress` and
-     * `message` from it. Pair with `bs-file-upload` (the dropzone that picks the files).
-     * ## When to use
-     * - Showing the status of each file the user has added, in a list under a `bs-file-upload`.
-     * ## When not to use
-     * - Attaching files to a chat message -- use `bs-attachment`.
-     */
-    interface BsFileUploadItem {
+        "open"?: boolean;
         /**
-          * Accessible name of the cancel button (`loading`, `in-progress`, `error`).
-          * @default 'Cancel upload'
+          * Placeholder of the field (also its accessible name unless `label` is set).
+          * @default 'Search customers, orders, products…'
          */
-        "cancelLabel"?: string;
+        "placeholder"?: string;
         /**
-          * The file name.
-          * @default ''
+          * Header of the `recent` section.
+          * @default 'Recent searches'
          */
-        "fileName"?: string;
+        "recentLabel"?: string;
         /**
-          * The file size, already formatted (e.g. "8MB").
+          * Text of the error state's action.
+          * @default 'Try again'
          */
-        "fileSize"?: string;
+        "retryLabel"?: string;
         /**
-          * The status text. Defaults per state: "Loading..." (`loading`), "{progress}% uploaded" (`in-progress`), "Upload failed" (`error`), "File uploaded successfully" (`success`). Provide your own for localisation or a specific error.
+          * Header of the `search-in` section.
+          * @default 'Search in'
          */
-        "message"?: string;
+        "searchInLabel"?: string;
         /**
-          * Fires when the cancel button is clicked (`loading`, `in-progress`, `error`). The consumer stops the upload and removes the item.
+          * Footer hint text after the Enter key (default view).
+          * @default 'Search'
          */
-        "onBsCancel"?: (event: BsFileUploadItemCustomEvent<void>) => void;
+        "searchLabel"?: string;
         /**
-          * Fires when the remove button is clicked (`success`). The consumer removes the file.
+          * Text of the footer button of the results view, when `totalResults` is not set.
+          * @default 'See all results'
          */
-        "onBsRemove"?: (event: BsFileUploadItemCustomEvent<void>) => void;
+        "seeAllLabel"?: string;
         /**
-          * Upload progress, 0-100. Only used when `state="in-progress"`.
-          * @default 0
+          * Shows the footer (hints and the Clear recent / See all button) for the `default` and `results` views.
+          * @default true
          */
-        "progress"?: number;
+        "showFooter"?: boolean;
         /**
-          * Accessible name of the remove button (`success`).
-          * @default 'Remove file'
+          * Which view the panel shows. You choose it; nothing is inferred from `value`.
+          * @default 'default'
          */
-        "removeLabel"?: string;
+        "status"?: BsGlobalSearchStatus;
         /**
-          * Where the upload is. `loading` = working with no known percentage (indeterminate bar); `in-progress` = uploading with a known `progress`; `error` and `success` are final.
-          * @default 'loading'
+          * Header of the `top-matches` section.
+          * @default 'Top matches'
          */
-        "state"?: BsFileUploadItemState;
+        "topMatchesLabel"?: string;
         /**
-          * Alt text for `thumbnailSrc`. Leave empty when the file name already says it all.
-          * @default ''
+          * Total number of results (status `results`): shown as "See all {n} results" and announced to screen readers.
          */
-        "thumbnailAlt"?: string;
+        "totalResults"?: number;
         /**
-          * A preview image of the file. Shown instead of the placeholder icon when set.
+          * The query. Two-way with the field.
+          * @default ''
          */
-        "thumbnailSrc"?: string;
+        "value"?: string;
     }
     /**
      * A CSS grid layout wrapper. Children are placed in equal-width columns with a token-based gap.
@@ -9738,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.
          */
@@ -9961,6 +11253,163 @@ declare namespace LocalJSX {
          */
         "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
@@ -11053,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:
@@ -11197,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`.
@@ -12532,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;
@@ -12615,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;
@@ -12646,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;
@@ -12708,6 +14312,29 @@ 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;
@@ -12860,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;
@@ -12882,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;
@@ -13087,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] };
@@ -13095,14 +14737,19 @@ 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] };
@@ -13121,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] };
@@ -13718,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
@@ -13914,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
@@ -13953,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
@@ -14047,6 +15776,61 @@ 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
@@ -14430,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:
@@ -14457,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`.