@brandsync/wc 1.19.0 → 1.20.1

package/dist/types/components.d.ts

@@ -19,6 +19,7 @@ import { BsButtonSize as BsButtonSize1, BsButtonVariant as BsButtonVariant1 } fr
 import { BsCardSurface } from "./components/bs-card/bs-card";
 import { BsCarouselTracker } from "./components/bs-carousel/bs-carousel";
 import { BsCheckboxSize } from "./components/bs-checkbox/bs-checkbox";
+import { BsCheckboxGroupOrientation } from "./components/bs-checkbox-group/bs-checkbox-group";
 import { BsCheckboxSize as BsCheckboxSize1 } from "./components/bs-checkbox/bs-checkbox";
 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";
@@ -33,15 +34,19 @@ 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 { BsDropdownPlacement } from "./components/bs-dropdown/bs-dropdown";
 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 { BsHeadingAs, BsHeadingLevel, BsHeadingSize, BsHeadingTone } from "./components/bs-heading/bs-heading";
+import { BsIconSize, BsIconTone } from "./components/bs-icon/bs-icon";
 import { BsIconButtonSize, BsIconButtonVariant } from "./components/bs-button/bs-icon-button/bs-icon-button";
 import { BsIconTileIntent as BsIconTileIntent1, BsIconTileSize } from "./components/bs-icon-tile/bs-icon-tile";
 import { BsShortcutGroup } from "./components/bs-keyboard-shortcuts/bs-keyboard-shortcuts";
+import { BsLinkVariant } from "./components/bs-link/bs-link";
 import { BsLogoBackground, BsLogoVariant } from "./components/bs-logo/bs-logo";
 import { BsMegaMenuColumn, BsMegaMenuFeatured, BsMegaMenuItem, BsMegaMenuType } from "./components/bs-mega-menu/bs-mega-menu";
 import { BsMessageRole, BsMessageStatus } from "./components/bs-message/bs-message";
@@ -53,6 +58,8 @@ import { BsProductTourDirection, BsProductTourType } from "./components/bs-produ
 import { BsProgressSize, BsProgressStrokeWidth, BsProgressType } from "./components/bs-progress/bs-progress";
 import { BsProgressLinearSize, BsProgressLinearType } from "./components/bs-progress-linear/bs-progress-linear";
 import { BsQrCodeSize, BsQrCodeState, BsQrCodeType } from "./components/bs-qr-code/bs-qr-code";
+import { BsRadioGroupOrientation } from "./components/bs-radio-group/bs-radio-group";
+import { BsSelectOption } from "./components/bs-select/bs-select";
 import { BsSessionTimeoutAlternative, BsSessionTimeoutType } from "./components/bs-session-timeout/bs-session-timeout";
 import { BsSidePanelSide } from "./components/bs-side-panel/bs-side-panel";
 import { BsSkeletonVariant } from "./components/bs-skeleton/bs-skeleton";
@@ -61,13 +68,20 @@ import { BsSnackbarVariant } from "./components/bs-snackbar/bs-snackbar";
 import { BsSpinnerSize } from "./components/bs-spinner/bs-spinner";
 import { BsSplitPaneOrientation } from "./components/bs-split-pane/bs-split-pane";
 import { BsStackAlign, BsStackDirection, BsStackJustify } from "./components/bs-stack/bs-stack";
+import { BsStatTrend, BsStatTrendIntent } from "./components/bs-stat/bs-stat";
+import { BsCardSurface as BsCardSurface1 } from "./components/bs-card/bs-card";
 import { BsStepperDirection } from "./components/bs-stepper/bs-stepper-step/bs-stepper-step";
 import { BsStepperDirection as BsStepperDirection1, BsStepperStepComputedState } from "./components/bs-stepper/bs-stepper-step/bs-stepper-step";
 import { BsSwitchSize } from "./components/bs-switch/bs-switch";
 import { BsTabIconPosition } from "./components/bs-tab/bs-tab/bs-tab";
+import { BsTocItem } from "./components/bs-table-of-contents/bs-table-of-contents";
 import { BsTabsOrientation, BsTabsType } from "./components/bs-tab/bs-tabs/bs-tabs";
+import { BsTagColor, BsTagSize } from "./components/bs-tag/bs-tag";
+import { BsTextAs, BsTextTone, BsTextVariant } from "./components/bs-text/bs-text";
 import { BsTimepickerChange } from "./components/bs-timepicker/bs-timepicker";
 import { BsToastState } from "./components/bs-toast/bs-toast";
+import { BsToggleButtonMode } from "./components/bs-toggle-button/bs-toggle-button";
+import { BsToolbarOrientation } from "./components/bs-toolbar/bs-toolbar";
 import { BsTooltipTriggerPlacement } from "./components/bs-tooltip-trigger/bs-tooltip-trigger";
 import { BsWhatsNewFilter, BsWhatsNewItem, BsWhatsNewType } from "./components/bs-whats-new/bs-whats-new";
 import { BsWhatsNewEntryTagColor } from "./components/bs-whats-new-entry/bs-whats-new-entry";
@@ -86,6 +100,7 @@ export { BsButtonSize as BsButtonSize1, BsButtonVariant as BsButtonVariant1 } fr
 export { BsCardSurface } from "./components/bs-card/bs-card";
 export { BsCarouselTracker } from "./components/bs-carousel/bs-carousel";
 export { BsCheckboxSize } from "./components/bs-checkbox/bs-checkbox";
+export { BsCheckboxGroupOrientation } from "./components/bs-checkbox-group/bs-checkbox-group";
 export { BsCheckboxSize as BsCheckboxSize1 } from "./components/bs-checkbox/bs-checkbox";
 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";
@@ -100,15 +115,19 @@ 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 { BsDropdownPlacement } from "./components/bs-dropdown/bs-dropdown";
 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 { BsHeadingAs, BsHeadingLevel, BsHeadingSize, BsHeadingTone } from "./components/bs-heading/bs-heading";
+export { BsIconSize, BsIconTone } from "./components/bs-icon/bs-icon";
 export { BsIconButtonSize, BsIconButtonVariant } from "./components/bs-button/bs-icon-button/bs-icon-button";
 export { BsIconTileIntent as BsIconTileIntent1, BsIconTileSize } from "./components/bs-icon-tile/bs-icon-tile";
 export { BsShortcutGroup } from "./components/bs-keyboard-shortcuts/bs-keyboard-shortcuts";
+export { BsLinkVariant } from "./components/bs-link/bs-link";
 export { BsLogoBackground, BsLogoVariant } from "./components/bs-logo/bs-logo";
 export { BsMegaMenuColumn, BsMegaMenuFeatured, BsMegaMenuItem, BsMegaMenuType } from "./components/bs-mega-menu/bs-mega-menu";
 export { BsMessageRole, BsMessageStatus } from "./components/bs-message/bs-message";
@@ -120,6 +139,8 @@ export { BsProductTourDirection, BsProductTourType } from "./components/bs-produ
 export { BsProgressSize, BsProgressStrokeWidth, BsProgressType } from "./components/bs-progress/bs-progress";
 export { BsProgressLinearSize, BsProgressLinearType } from "./components/bs-progress-linear/bs-progress-linear";
 export { BsQrCodeSize, BsQrCodeState, BsQrCodeType } from "./components/bs-qr-code/bs-qr-code";
+export { BsRadioGroupOrientation } from "./components/bs-radio-group/bs-radio-group";
+export { BsSelectOption } from "./components/bs-select/bs-select";
 export { BsSessionTimeoutAlternative, BsSessionTimeoutType } from "./components/bs-session-timeout/bs-session-timeout";
 export { BsSidePanelSide } from "./components/bs-side-panel/bs-side-panel";
 export { BsSkeletonVariant } from "./components/bs-skeleton/bs-skeleton";
@@ -128,13 +149,20 @@ export { BsSnackbarVariant } from "./components/bs-snackbar/bs-snackbar";
 export { BsSpinnerSize } from "./components/bs-spinner/bs-spinner";
 export { BsSplitPaneOrientation } from "./components/bs-split-pane/bs-split-pane";
 export { BsStackAlign, BsStackDirection, BsStackJustify } from "./components/bs-stack/bs-stack";
+export { BsStatTrend, BsStatTrendIntent } from "./components/bs-stat/bs-stat";
+export { BsCardSurface as BsCardSurface1 } from "./components/bs-card/bs-card";
 export { BsStepperDirection } from "./components/bs-stepper/bs-stepper-step/bs-stepper-step";
 export { BsStepperDirection as BsStepperDirection1, BsStepperStepComputedState } from "./components/bs-stepper/bs-stepper-step/bs-stepper-step";
 export { BsSwitchSize } from "./components/bs-switch/bs-switch";
 export { BsTabIconPosition } from "./components/bs-tab/bs-tab/bs-tab";
+export { BsTocItem } from "./components/bs-table-of-contents/bs-table-of-contents";
 export { BsTabsOrientation, BsTabsType } from "./components/bs-tab/bs-tabs/bs-tabs";
+export { BsTagColor, BsTagSize } from "./components/bs-tag/bs-tag";
+export { BsTextAs, BsTextTone, BsTextVariant } from "./components/bs-text/bs-text";
 export { BsTimepickerChange } from "./components/bs-timepicker/bs-timepicker";
 export { BsToastState } from "./components/bs-toast/bs-toast";
+export { BsToggleButtonMode } from "./components/bs-toggle-button/bs-toggle-button";
+export { BsToolbarOrientation } from "./components/bs-toolbar/bs-toolbar";
 export { BsTooltipTriggerPlacement } from "./components/bs-tooltip-trigger/bs-tooltip-trigger";
 export { BsWhatsNewFilter, BsWhatsNewItem, BsWhatsNewType } from "./components/bs-whats-new/bs-whats-new";
 export { BsWhatsNewEntryTagColor } from "./components/bs-whats-new-entry/bs-whats-new-entry";
@@ -855,19 +883,37 @@ export namespace Components {
      * - `error` purely for visual emphasis — it signals a destructive action to the user, so reserve
      *   it for actions that actually delete/revoke/undo something.
      * @prop --bs-button-radius - Corner radius. Aliased to `--bs-border-radius-100` by default.
-     * @prop --bs-button-padding-x-sm - Left/right padding of a label-only button at `size="sm"`. Aliased to `--bs-spacing-300`.
+     * @prop --bs-button-padding-x-sm - Left/right padding of a label-only button at `size="sm"`. Aliased to `--bs-spacing-150` (12px).
+     * @prop --bs-button-padding-x-md - Left/right padding at `size="md"`. Aliased to `--bs-spacing-150` (12px).
+     * @prop --bs-button-padding-x-lg - Left/right padding at `size="lg"`. Aliased to `--bs-spacing-150` (12px).
      * @prop --bs-button-width - Width of the button. `auto` by default (fits its content); set `100%` for a full-width button, e.g. `bs-button { --bs-button-width: 100%; }`.
      * @prop --bs-button-subtle-color - Label/icon colour, `variant="subtle"`. Aliased to `--bs-color-neutral-default`; set it to `var(--bs-text-action)` for a blue text button.
-     * @prop --bs-button-height-sm - Height at `size="sm"`. Aliased to `--bs-spacing-500`.
-     * @prop --bs-button-height-md - Height at `size="md"`. Aliased to `--bs-spacing-600`.
-     * @prop --bs-button-height-lg - Height at `size="lg"`. Aliased to `--bs-spacing-700`.
+     * @prop --bs-button-height-sm - Height at `size="sm"`. Aliased to `--bs-spacing-400` (32px).
+     * @prop --bs-button-height-md - Height at `size="md"`. Aliased to `--bs-spacing-550` (44px).
+     * @prop --bs-button-height-lg - Height at `size="lg"`. Aliased to `--bs-spacing-600` (48px).
+     * @prop --bs-button-outlined-color - Label/icon colour, `variant="outlined"`, default. Aliased to `--bs-color-primary-default`.
      * @prop --bs-button-neutral-border - Border color, `variant="neutral"`, default/disabled. Aliased to `--bs-border-neutral-container`.
      * @prop --bs-button-neutral-border-hover - Border color, `variant="neutral"`, hover. Aliased to `--bs-border-neutral-container-hover`.
      * @prop --bs-button-neutral-border-pressed - Border color, `variant="neutral"`, pressed. Aliased to `--bs-border-neutral-container-pressed`.
-     * @prop --bs-button-padding-x-icon-side - Horizontal padding on an edge that's adjacent to a leading/trailing icon (tighter than the plain text-only edge). Aliased to `--bs-spacing-150`.
-     * @prop --bs-button-padding-x-label-side - Horizontal padding on the opposite edge, when an icon on the other side needs compensating extra space to keep the button optically balanced. Aliased to `--bs-spacing-250`.
+     * @prop --bs-button-padding-x-icon-side - Horizontal padding on an edge that's adjacent to a leading/trailing icon (now equal to the text-only edge). Aliased to `--bs-spacing-150`.
+     * @prop --bs-button-padding-x-label-side - Horizontal padding on the opposite edge, when an icon on the other side needs compensating extra space to keep the button optically balanced. Aliased to `--bs-spacing-150` (no compensation by default).
      */
     interface BsButton {
+        /**
+          * Forwarded to the inner `<button>` as `aria-controls`. Note an id only resolves inside this component's shadow tree, so it can't point at an element in the page's light DOM.
+          * @default null
+         */
+        "ariaControls": string | null;
+        /**
+          * Forwarded to the inner `<button>` as `aria-expanded`, for disclosure/menu buttons.
+          * @default null
+         */
+        "ariaExpanded": 'true' | 'false' | null;
+        /**
+          * Forwarded to the inner `<button>` as `aria-haspopup`.
+          * @default null
+         */
+        "ariaHasPopup": 'true' | 'false' | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog' | null;
         /**
           * Accessible name for the button. Required for icon-only usage (no visible label text via the default slot) so screen readers still announce what the button does. Stencil reflects this camelCase prop to the `aria-label` HTML attribute automatically.
           * @default null
@@ -878,6 +924,10 @@ export namespace Components {
           * @default false
          */
         "disabled": boolean;
+        /**
+          * Makes this a toggle button: sets `aria-pressed` on the inner `<button>` to `true`/`false`. Leave it unset (the default) for a plain action button, which then has no `aria-pressed` at all. The component does not toggle itself; the owner flips this on click.
+         */
+        "pressed"?: boolean;
         /**
           * Sizing scale.
           * @default 'md'
@@ -933,11 +983,37 @@ export namespace Components {
      * - For a dismissible/transient message — use a modal or a dedicated notification component.
      */
     interface BsCard {
+        /**
+          * Makes the whole card a link to this URL (a real `<a>`). Takes precedence over `selectable`.
+         */
+        "href"?: string;
+        /**
+          * Accessible name for the clickable card, used instead of the `header` slot text. Set it when there is no `header` content, or when the header text is not a good name on its own.
+         */
+        "label"?: string;
+        /**
+          * Link `rel`, only used with `href`.
+         */
+        "rel"?: string;
+        /**
+          * Makes the whole card a toggle (a real `<button aria-pressed>`). Ignored when `href` is set.
+          * @default false
+         */
+        "selectable": boolean;
+        /**
+          * Whether a `selectable` card is selected. Mutable and reflected; toggled by the user.
+          * @default false
+         */
+        "selected": boolean;
         /**
           * Maps to the brandsync-tokens `--bs-paper-bg-*` set — Brandsync's tokens don't have a dedicated "card" component yet, so this reuses the existing Paper surface tokens.
           * @default 'raised'
          */
         "surface": BsCardSurface;
+        /**
+          * Link `target`, only used with `href`. With `_blank`, `rel` defaults to `noopener noreferrer`.
+         */
+        "target"?: string;
     }
     /**
      * A carousel that shows a page of slides at a time, with a tracker (dots or numbered blocks) and
@@ -1354,6 +1430,9 @@ export namespace Components {
      * `--bs-color-primary-container-pressed`.
      * @prop --bs-chatbot-suggestion-button-bg-focus - Background when focused. Aliased to
      * `--bs-color-primary-container-hover` (same as hover).
+     * @prop --bs-chatbot-suggestion-button-bg-disabled - Background when disabled. Aliased to `--bs-surface-action-disabled`.
+     * @prop --bs-chatbot-suggestion-button-text-disabled - Text color when disabled. Aliased to `--bs-text-on-disabled`.
+     * @prop --bs-chatbot-suggestion-button-border-color-disabled - Border color when disabled. Aliased to `--bs-border-neutral-disabled`.
      * @prop --bs-chatbot-suggestion-button-text-default - Text color in the default state. Aliased to
      * `--bs-text-action`.
      * @prop --bs-chatbot-suggestion-button-text-hover - Text color on hover, pressed, and focus.
@@ -1425,6 +1504,45 @@ export namespace Components {
          */
         "value": string;
     }
+    /**
+     * A labelled group of `bs-checkbox`es: a `<fieldset>` with a `<legend>`, helper or error text, and
+     * a single `value` array of the checked boxes' values.
+     * Composed from: `bs-checkbox` (slotted by you).
+     * ## When to use
+     * - A set of related, independent options where any number may be chosen ("Notify me by ...").
+     * ## When not to use
+     * - Exactly one choice: use `bs-radio-group`.
+     * - A single yes/no: use one `bs-checkbox`, or `bs-switch` for an immediate setting.
+     */
+    interface BsCheckboxGroup {
+        /**
+          * Helper text under the options. Replaced by `error` while that is set.
+         */
+        "description"?: string;
+        /**
+          * Error message. Sets `aria-invalid`, replaces the helper text, and puts every checkbox in its error style.
+         */
+        "error"?: string;
+        /**
+          * Legend: the visible group label, also its accessible name.
+         */
+        "label"?: string;
+        /**
+          * Layout of the checkboxes.
+          * @default 'vertical'
+         */
+        "orientation": BsCheckboxGroupOrientation;
+        /**
+          * Marks the group as required: shows an asterisk after the label and sets `aria-required`.
+          * @default false
+         */
+        "required": boolean;
+        /**
+          * `value`s of the checked checkboxes. An array, so set it as a JS property, not an attribute. Setting it checks the matching boxes and unchecks the rest.
+          * @default []
+         */
+        "value": string[];
+    }
     /**
      * A shape-matched loading placeholder for `bs-checkbox`, shown while the real label text isn't
      * known yet (e.g. still being fetched from an API). Renders a small square (matching the
@@ -1596,6 +1714,71 @@ export namespace Components {
          */
         "sourceName"?: string;
     }
+    /**
+     * A block of code with an optional filename header and a Copy button, or (with `inline`) styled
+     * inline code. Dependency-free: it does no syntax highlighting itself. Pass plain text with `code`,
+     * or slot pre-highlighted markup (e.g. the output of Shiki or Prism: spans coloured with your own
+     * CSS) as the default slot.
+     * Follows light and dark mode through the surface/text tokens. Long lines scroll horizontally (the
+     * scroll area is keyboard focusable) or, with `wrap`, break onto the next line.
+     * Copying announces the `copiedLabel` text through a polite live region, and the button label
+     * changes to match for a few seconds.
+     * Slotted content: keep it flush against the tags (`<bs-code-block><span>..</span></bs-code-block>`),
+     * since whitespace in a `<pre>`-style block is kept. The line count for `lineNumbers` and the text
+     * that is copied are read from the slotted text.
+     * Composed from: `bs-card` (the surface), `bs-button` and `bs-icon` (the Copy button).
+     * ## When to use
+     * - Showing a snippet, command or config the reader may want to copy.
+     * - `inline` for a short code term inside a sentence.
+     * ## When not to use
+     * - Long files that need folding, search or editing: link to the source instead.
+     * - Pre-formatted prose or tables: use ordinary text and table markup.
+     */
+    interface BsCodeBlock {
+        /**
+          * Plain-text code. When set it is shown (escaped) instead of the default slot, and is what Copy copies.
+         */
+        "code"?: string;
+        /**
+          * Label of the Copy button after copying, and the text announced to assistive tech.
+          * @default 'Copied'
+         */
+        "copiedLabel": string;
+        /**
+          * Label of the Copy button.
+          * @default 'Copy'
+         */
+        "copyLabel": string;
+        /**
+          * Name shown at the left of the header, e.g. `app.config.ts` or `Terminal`. Also names the code region for assistive tech.
+         */
+        "filename"?: string;
+        /**
+          * Remove the Copy button.
+          * @default false
+         */
+        "hideCopy": boolean;
+        /**
+          * Render as inline code (a styled `<code>` inside a sentence): no header, no Copy button, no scrolling.
+          * @default false
+         */
+        "inline": boolean;
+        /**
+          * Show a line number gutter. Line numbers need unwrapped lines, so `wrap` is ignored while this is set.
+          * @default false
+         */
+        "lineNumbers": boolean;
+        /**
+          * Accessible name of the code region when there is no `filename`.
+          * @default 'Code'
+         */
+        "regionLabel": string;
+        /**
+          * Wrap long lines instead of scrolling horizontally.
+          * @default false
+         */
+        "wrap": boolean;
+    }
     /**
      * 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
@@ -2253,6 +2436,12 @@ export namespace Components {
      * ## When not to use
      * - A handful of unrelated key/value pairs — a simple list or card is lighter-weight.
      * - Deeply nested/hierarchical data — this component renders one flat row per record.
+     * ## Rich cells
+     * Without a `cellRenderer`, each cell is a named slot, `cell-{row.id}-{column.key}`, whose fallback
+     * content is the plain-text value. Slot an element into it to put app-owned content (a framework
+     * component, a router link, a badge) in the cell, e.g.
+     * `<a slot="cell-7-name" href="/people/7">Ada</a>`. The slotted element lives in the light DOM, so
+     * it keeps your framework, router and CSP; nothing is parsed as HTML.
      */
     interface BsDataTable {
         /**
@@ -2287,6 +2476,11 @@ export namespace Components {
           * @default 'asc'
          */
         "sortDirection": 'asc' | 'desc';
+        /**
+          * Alternates the row background (even rows use `--bs-data-table-stripe-bg`) so wide tables are easier to scan. Follows dark mode through the token. Row hover still wins.
+          * @default false
+         */
+        "striped": boolean;
     }
     /**
      * An inline calendar for picking a single date, or a start/end date range. Matches the Figma
@@ -2382,6 +2576,68 @@ export namespace Components {
          */
         "yearLabel": string;
     }
+    /**
+     * One term and its detail inside a `bs-description-list` (a label/value pair such as "Owner: Sam Lee").
+     * ## When to use
+     * - As a child of `bs-description-list`, one per key/value pair.
+     * ## When not to use
+     * - Rows of records with media and actions -- use `bs-list-item`.
+     * - Many pairs compared across several records -- use `bs-data-table`.
+     * Each item renders its own `<dl>` containing one `<div>` group with a real `<dt>` and `<dd>`. (A `dl` cannot
+     * span the shadow boundary between a list and its items, so the grouping lives here.)
+     * @prop --bs-description-item-gap - Gap between term and detail when stacked. Aliased to `--bs-spacing-25`.
+     * @prop --bs-description-item-term-width - Width of the term column when `layout="horizontal"`. `12rem`.
+     * @prop --bs-description-item-column-gap - Gap between the term and detail columns when horizontal. Aliased to `--bs-spacing-200`.
+     * @prop --bs-description-item-padding-y - Vertical padding. Aliased to `--bs-spacing-100`.
+     * @prop --bs-description-item-term-color - Aliased to `--bs-text-secondary`.
+     * @prop --bs-description-item-description-color - Aliased to `--bs-text-default`.
+     */
+    interface BsDescriptionItem {
+        /**
+          * The detail (value). The default slot overrides it.
+         */
+        "description"?: string;
+        /**
+          * Set by the parent `bs-description-list`: `stacked` (term above detail) or `horizontal` (side by side).
+          * @default 'stacked'
+         */
+        "layout": 'stacked' | 'horizontal';
+        /**
+          * The term (label).
+         */
+        "term"?: string;
+    }
+    /**
+     * A key/value list of `bs-description-item` pairs (term and detail), for record summaries, settings read-outs
+     * and metadata panels. Terms and details use real `dt`/`dd` semantics.
+     * ## When to use
+     * - A read-only summary of one record: "Owner", "Created", "Status" with their values.
+     * ## When not to use
+     * - A list of records with media and actions -- use `bs-list`.
+     * - Editable fields -- use form components.
+     * - Several records compared across columns -- use `bs-data-table`.
+     * Built from `bs-description-item` children (light DOM; the list never moves nodes). Each item holds its own
+     * `dl`; the list sets the layout on them and draws dividers.
+     * @prop --bs-description-list-divider-color - Divider colour when `dividers` is set. Aliased to `--bs-border-neutral-container`.
+     * @prop --bs-description-list-gap - Gap between items. `0`.
+     */
+    interface BsDescriptionList {
+        /**
+          * Accessible name of the group.
+          * @default null
+         */
+        "ariaLabel": string | null;
+        /**
+          * Draws a 1px separator between items.
+          * @default false
+         */
+        "dividers": boolean;
+        /**
+          * `stacked` puts each term above its detail; `horizontal` puts them side by side in two columns.
+          * @default 'stacked'
+         */
+        "layout": 'stacked' | 'horizontal';
+    }
     /**
      * An overlay dialog that interrupts the current flow for a focused task or confirmation.
      * Closes itself on backdrop click, Escape, or its own close button, and emits `bsClose`.
@@ -2454,6 +2710,33 @@ export namespace Components {
          */
         "variant": BsDividerVariant;
     }
+    /**
+     * A menu trigger: a button (slot `trigger`) that opens a `bs-menu` of `bs-menu-item`s in an anchored,
+     * viewport-aware popup, with the menu keyboard pattern and focus management built in.
+     * Opens on click, Enter, Space (via the trigger button) and ArrowDown. On open focus moves to the
+     * first enabled menu item; Up/Down/Home/End move between items (handled by `bs-menu`). The dropdown
+     * closes on outside click, Escape (focus returns to the trigger), Tab, and after an item is activated.
+     * The trigger gets `aria-haspopup="menu"` and `aria-expanded` kept in sync.
+     * Composed from `bs-popover` (anchor positioning, flipping, outside-click and Escape dismissal, open
+     * motion), `bs-menu` and `bs-menu-item` (slotted by you), and a `bs-button` / `bs-icon-button` trigger.
+     * ## When to use
+     * - A header or toolbar action that reveals a short list of commands ("More", "Account", "Sort by").
+     * ## When not to use
+     * - Free-form popup content such as forms or arbitrary panels (use `bs-popover`).
+     * - Choosing a value for a form field (use `bs-select`).
+     */
+    interface BsDropdown {
+        /**
+          * Whether the menu is shown.
+          * @default false
+         */
+        "open": boolean;
+        /**
+          * Where the menu sits relative to the trigger; flips to stay in the viewport.
+          * @default 'bottom-start'
+         */
+        "placement": BsDropdownPlacement;
+    }
     /**
      * 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.
@@ -2468,6 +2751,7 @@ export namespace Components {
      * @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-size - Aliased to `--bs-font-size-xl` (`--bs-font-size-3xl` at `size="page"`).
      * @prop --bs-empty-state-heading-color - Aliased to `--bs-text-default`.
      * @prop --bs-empty-state-description-color - Aliased to `--bs-text-secondary`.
      */
@@ -2490,6 +2774,11 @@ export namespace Components {
           * @default 'default'
          */
         "intent": BsIconTileIntent;
+        /**
+          * `panel` (default) fits inside a card, table or section. `page` fills a whole view: more padding, a larger heading and a minimum height.
+          * @default 'panel'
+         */
+        "size": 'panel' | 'page';
     }
     /**
      * A full-block page for when the user can't get to what they asked for: page not found (404), a server
@@ -2848,6 +3137,74 @@ export namespace Components {
          */
         "rowGap"?: string;
     }
+    /**
+     * A heading whose rendered element and visual style are chosen separately: `level` (or `as`) picks
+     * the element for the document outline, `size` picks the look. Sizes map to the typography tokens
+     * (`--bs-font-size-*`, `--bs-font-weight-*`, `--bs-line-height-*`, `--bs-typography-font-family-heading`).
+     * Default sizes by level: 1 = 40px, 2 = 32px, 3 = 24px, 4 = 20px, 5 = 18px, 6 = 16px; `display` is 48px.
+     * Composed from: nothing (leaf).
+     * ## When to use
+     * - Any page or section title. Keep levels in order (no jumping from 1 to 4); change `size`, not `level`, to restyle.
+     * ## When not to use
+     * - Body copy, captions and labels: use `bs-text`.
+     * - To make text big without it being a heading: use `bs-text` with `as="p"`.
+     */
+    interface BsHeading {
+        /**
+          * Overrides the rendered element, e.g. `as="p"` for a heading-looking line that is not part of the outline. When set, `level` only drives the default size.
+         */
+        "as"?: BsHeadingAs;
+        /**
+          * Heading level 1-6: chooses the element (`h1`-`h6`) and, unless `size` is set, the visual size.
+          * @default 2
+         */
+        "level": BsHeadingLevel;
+        /**
+          * Visual size, independent of the element: `display` or `1`-`6` (the default sizes of levels 1-6). Defaults to `level`.
+         */
+        "size"?: BsHeadingSize;
+        /**
+          * Text colour from the text tokens. `inherit` uses the surrounding colour.
+          * @default 'default'
+         */
+        "tone": BsHeadingTone;
+    }
+    /**
+     * A sized, coloured icon. Renders inline SVG from a named registry (`name`), or any SVG you slot in.
+     * Built-in names: `menu`, `arrow-right`, `arrow-left`, `check`, `close`, `chevron-down`,
+     * `external-link`, `copy`, `search`, plus Phosphor glyphs `user`, `star`, `star-fill`, `x`,
+     * `paper-plane-right`, `note-pencil`, `clock-counter-clockwise`, `arrows-out-simple` (256x256 filled). Add more with `registerIcons({ name: '<path d="..."/>' })`
+     * (exported from the package entry): each value is the inner markup of a 24x24, `currentColor`
+     * stroke icon, or pass `{ viewBox, body }` for a filled glyph on another grid.
+     * Decorative by default (`aria-hidden`). Set `label` when the icon alone conveys meaning; it is then
+     * exposed as an image with that name. An icon inside a button never needs `label`: name the button.
+     * Composed from: nothing (leaf). Used by `bs-code-block`.
+     * ## When to use
+     * - A glyph beside text or inside a button, sized and coloured from tokens.
+     * ## When not to use
+     * - As a control by itself: wrap it in `bs-icon-button`.
+     * - For a tinted status square: use `bs-icon-tile`.
+     */
+    interface BsIcon {
+        /**
+          * Accessible name. When set the icon is exposed as an image with this name; when empty it is decorative and hidden from assistive tech.
+         */
+        "label"?: string;
+        /**
+          * Registered icon name (see the component description for the built-in set).
+         */
+        "name"?: string;
+        /**
+          * Size: `xs` 12px, `sm` 16px, `md` 24px, `lg` 32px, `xl` 48px.
+          * @default 'md'
+         */
+        "size": BsIconSize;
+        /**
+          * Colour from the icon tokens. `inherit` uses the surrounding text colour (`currentColor`).
+          * @default 'default'
+         */
+        "tone": BsIconTone;
+    }
     /**
      * A clickable, icon-only action element -- the icon-only sibling of `bs-button`, sharing the same
      * 8 visual variants and color language, but ALWAYS rendering just a single icon, never a label.
@@ -2867,6 +3224,21 @@ export namespace Components {
      * accessible name.
      */
     interface BsIconButton {
+        /**
+          * Forwarded to the inner `<button>` as `aria-controls`. Note an id only resolves inside this component's shadow tree, so it can't point at an element in the page's light DOM.
+          * @default null
+         */
+        "ariaControls": string | null;
+        /**
+          * Forwarded to the inner `<button>` as `aria-expanded`, for disclosure/menu buttons.
+          * @default null
+         */
+        "ariaExpanded": 'true' | 'false' | null;
+        /**
+          * Forwarded to the inner `<button>` as `aria-haspopup`.
+          * @default null
+         */
+        "ariaHasPopup": 'true' | 'false' | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog' | null;
         /**
           * Accessible name for the button. Required -- this component is always icon-only, so there's no visible label text for screen readers to fall back on. Stencil reflects this camelCase prop to the `aria-label` HTML attribute automatically.
           * @default null
@@ -2979,7 +3351,9 @@ export namespace Components {
      * range of related "field" shapes (number stepper, password reveal, date, dropdown trigger,
      * select, textarea, chip input, initials, country, and pin) via the `type` prop, since they all
      * share the same label/description/error/icon-slot chrome.
-     * Built from: `bs-menu`/`bs-menu-item` (`type="dropdown"`) and `bs-chip-informative` + `bs-icon-button` (`type="chip"`).
+     * Built from: `bs-menu`/`bs-menu-item` (`type="dropdown"`), `bs-chip-informative` + `bs-icon-button` (`type="chip"`),
+     * and `bs-icon-button` + `bs-spinner` (`type="combobox"` clear button / loading indicator; its listbox is a
+     * hand-built `role="listbox"` because `bs-menu` is `role="menu"` and cannot host `option`s).
      * ## When to use
      * - Collecting a single line of free-text, email, password, or numeric input.
      * - Any of the other supported `type`s (search, date, dropdown, select, textarea, chip, initials,
@@ -2992,16 +3366,31 @@ export namespace Components {
      *   options list at all (freeform chip entry).
      */
     interface BsInput {
+        /**
+          * Accessible name for the control, used only when no visible `label` is set (e.g. a search field with no visible label). Passed to the inner native control, because an `aria-label` on the `<bs-input>` host cannot name an element inside its shadow root.
+          * @default null
+         */
+        "ariaLabel": string | null;
         /**
           * Current chips for `type="chip"`. Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
           * @default []
          */
         "chips": string[];
+        /**
+          * `type="combobox"`: accessible name of the clear button.
+          * @default 'Clear'
+         */
+        "clearLabel": string;
         /**
           * Current selected country code for `type="country"`.
           * @default ''
          */
         "country": string;
+        /**
+          * `type="country"`: accessible name of the country picker (its visible content is just the flag).
+          * @default 'Country'
+         */
+        "countryLabel": string;
         /**
           * Country select options for `type="country"`. Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
           * @default []
@@ -3018,6 +3407,11 @@ export namespace Components {
          */
         "disabled": boolean;
         "error"?: string;
+        /**
+          * `type="combobox"`: when true (default) `options` are filtered client-side by whether the label contains the typed text. Set false when you supply already-filtered results yourself (e.g. from a server) in response to `bsInput`.
+          * @default true
+         */
+        "filterOptions": boolean;
         /**
           * Accessible name of the password toggle while the password is visible.
           * @default 'Hide password'
@@ -3039,6 +3433,16 @@ export namespace Components {
           * @default 4
          */
         "length": number;
+        /**
+          * `type="combobox"`: shows a loading indicator and, while no options match, a loading message in the popup instead of "no results". Use while fetching `options` asynchronously.
+          * @default false
+         */
+        "loading": boolean;
+        /**
+          * `type="combobox"`: text of the popup row shown while `loading` and nothing matches.
+          * @default 'Loading...'
+         */
+        "loadingLabel": string;
         /**
           * Maximum value for `type="number"`'s stepper buttons.
          */
@@ -3052,12 +3456,22 @@ export namespace Components {
          */
         "name"?: string;
         /**
-          * Whether the `type="dropdown"` trigger is open. Reflects to an attribute so consumers can style an open state via CSS. When `options` is non-empty, this also controls whether the `bs-menu` of `bs-menu-item`s is rendered below the field.
+          * `type="combobox"`: text of the popup row shown when no option matches.
+          * @default 'No results'
+         */
+        "noResultsLabel": string;
+        /**
+          * Whether the `type="dropdown"` / `type="combobox"` popup is open. Reflects to an attribute so consumers can style an open state via CSS. When `options` is non-empty, this also controls whether the `bs-menu` of `bs-menu-item`s is rendered below the field.
           * @default false
          */
         "open": boolean;
         /**
-          * Options for `type="select"` (rendered as native `<option>`s) and `type="dropdown"` (rendered as a `bs-menu` of `bs-menu-item`s when `open`). Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
+          * `type="date"`: accessible name of the default calendar button that opens the native picker.
+          * @default 'Open date picker'
+         */
+        "openPickerLabel": string;
+        /**
+          * Options for `type="select"` (rendered as `role="option"` rows of an in-shadow listbox) and `type="dropdown"` (rendered as a `bs-menu` of `bs-menu-item`s when `open`). Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
           * @default []
          */
         "options": { label: string; value: string }[];
@@ -3082,6 +3496,11 @@ export namespace Components {
           * @default 1
          */
         "step": number;
+        /**
+          * `type="initials"`: accessible name of the title picker (its visible text is just the title).
+          * @default 'Title'
+         */
+        "titleLabel": string;
         /**
           * Title select options for `type="initials"` (e.g. `['Mrs.', 'Mr.', 'Dr.']`). Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
           * @default []
@@ -3102,7 +3521,8 @@ export namespace Components {
     | 'chip'
     | 'initials'
     | 'country'
-    | 'pin';
+    | 'pin'
+    | 'combobox';
         /**
           * Current value. Native `input`/`change` events don't cross the Shadow DOM boundary, so this component re-dispatches them as `bsInput`/`bsChange` custom events instead. Mutable so the `number` type's stepper buttons can update it directly.
           * @default ''
@@ -3254,6 +3674,56 @@ export namespace Components {
          */
         "singleKeyLabel": string;
     }
+    /**
+     * A navigation link: either text (inline within a sentence, or standalone with a 44px target) or a
+     * link styled as a primary button. Always renders a real `<a href>`.
+     * Built from: hand-built `<a>` (leaf). `bs-button` renders a `<button>` and has no `href`; nesting a
+     * button in an anchor is invalid HTML, so the `button` variant reuses the primary button's colour
+     * tokens instead. Known gap: add `href` support to `bs-button` and compose it here.
+     * ## When to use
+     * - Navigating to another page or an external resource.
+     * ## When not to use
+     * - Triggering an action on the current page (use `bs-button`).
+     */
+    interface BsLink {
+        /**
+          * Accessible name override (needed on the host, as `aria-label` does not cross the shadow boundary).
+          * @default null
+         */
+        "ariaLabel": string | null;
+        /**
+          * Marks the link as the current page (`aria-current="page"`).
+          * @default false
+         */
+        "current": boolean;
+        /**
+          * Shows the external-link icon (always shown for `target="_blank"`).
+          * @default false
+         */
+        "external": boolean;
+        /**
+          * Visually hidden suffix announced for links that open in a new tab.
+          * @default '(opens in a new tab)'
+         */
+        "externalLabel": string;
+        /**
+          * Destination.
+         */
+        "href"?: string;
+        /**
+          * Link relationship. Defaults to `noopener noreferrer` when `target="_blank"`.
+         */
+        "rel"?: string;
+        /**
+          * Browsing context (e.g. `_blank`). `_blank` implies the external icon.
+         */
+        "target"?: string;
+        /**
+          * `inline` sits in running text; `standalone` has a 44px minimum touch target; `button` is styled as a primary button (also 44px).
+          * @default 'inline'
+         */
+        "variant": BsLinkVariant;
+    }
     /**
      * A vertical list of `bs-list-item` rows, optionally single-select.
      * ## When to use
@@ -3263,6 +3733,9 @@ export namespace Components {
      * - A popup list of actions -- use `bs-menu`.
      * - Navigation between app sections -- use `bs-navigation-drawer`.
      * - Multi-column, sortable or paged data -- use `bs-data-table`.
+     * `variant` switches between a plain list, a bulleted list and a numbered list; `dividers` gives a divided
+     * list. The list keeps real list semantics in every variant (`role="list"` with `listitem` rows); the bullet
+     * or number is drawn by the row and hidden from assistive technology, which announces position itself.
      * Built from `bs-list-item` children (light DOM; the list never moves nodes).
      * @prop --bs-list-gap - Gap between rows. Defaults to `0`.
      * @prop --bs-list-divider-color - Divider colour when `dividers` is set. Aliased to `--bs-border-neutral-container`.
@@ -3288,6 +3761,11 @@ export namespace Components {
           * @default null
          */
         "value": string | null;
+        /**
+          * `plain` (default), `bulleted` (a bullet before each row) or `numbered` (1., 2., 3., ...). Ignored when `selectable`.
+          * @default 'plain'
+         */
+        "variant": 'plain' | 'bulleted' | 'numbered';
     }
     /**
      * A single row of a list: optional leading media (avatar, icon, image), a label, a description and
@@ -3347,6 +3825,11 @@ export namespace Components {
           * @default null
          */
         "label": string | null;
+        /**
+          * Set by the parent `bs-list` for `bulleted` / `numbered` variants: the visual marker. Hidden from assistive technology. Do not set by hand.
+          * @default null
+         */
+        "marker": string | null;
         /**
           * Marks the row as selected. Managed by the parent `bs-list` when it is `selectable`.
           * @default false
@@ -3805,6 +4288,10 @@ export namespace Components {
           * @default false
          */
         "expanded": boolean;
+        /**
+          * Makes a leaf item a real link: renders an `<a part="item" href>` instead of the `<button>`, so open-in-new-tab, copy link address, middle-click and the status-bar URL work. Ignored when `expandable` (groups stay buttons). `bsSelect` still fires on a plain click and is **cancelable**: call `event.preventDefault()` to stop the navigation and route it yourself (an SPA router). Ctrl/cmd/shift/alt-clicks and middle-clicks are left to the browser and do not emit `bsSelect`.
+         */
+        "href"?: string;
         /**
           * Marks this as a child row nested under an `expandable` parent (via `slot="children"`) -- deepens the left indent and stops reserving `icon` slot space entirely (Figma's nested rows never have icons).
           * @default false
@@ -3815,6 +4302,10 @@ export namespace Components {
           * @default false
          */
         "selected": boolean;
+        /**
+          * `target` of the link, when `href` is set.
+         */
+        "target"?: string;
     }
     /**
      * The top-level navigation bar for a page: the BrandSync logo plus two consumer-provided slots
@@ -4486,6 +4977,11 @@ export namespace Components {
      * - An on/off setting that takes effect immediately (no explicit form submission) -- use `bs-switch`.
      */
     interface BsRadio {
+        /**
+          * Accessible name for the radio, set as `aria-label` on the native input. Use it when the radio has no slotted label text (an icon-only choice) or its visible label lives elsewhere. Same as `bs-checkbox` / `bs-switch`.
+          * @default null
+         */
+        "ariaLabel": string | null;
         /**
           * Whether the radio is checked. Mutable so clicking the label/input sets it directly.
           * @default false
@@ -4506,22 +5002,73 @@ export namespace Components {
         "value": string;
     }
     /**
-     * A touch-ripple effect: on pointer press, a circle grows from the press point and fades out.
-     * It is a building block for pressable components (`bs-button`, `bs-icon-button`, ...), not something
-     * to place on a page by itself. Put it inside a positioned, pressable parent; it fills that parent,
-     * follows its corner radius, and listens for `pointerdown` on it. Pointer-events pass through, so the
-     * parent still receives every click.
-     * The motion uses the shared duration and easing tokens. Under `prefers-reduced-motion: reduce` those
-     * durations are `0ms`, and the ripple does not play at all.
+     * A labelled group of `bs-radio`s: a visible label, helper or error text, an accessible
+     * `role="radiogroup"`, and a single `value` for the whole set.
+     * The group gives its radios one shared `name` (its own `name`, or a generated one) so they behave
+     * as one native-style group: arrow keys move the selection (wrapping), only the checked radio is in
+     * the tab order, and checking one unchecks the others. It keeps at most one radio checked (the
+     * first one wins if several start checked).
+     * Composed from: `bs-radio` (slotted by you).
      * ## When to use
-     * - Inside a pressable `bs-*` component, to give press feedback.
+     * - A set of 2-5 mutually exclusive options that should all stay visible, with a shared label.
      * ## When not to use
-     * - As a hover or focus indicator. Those are colour changes on the parent.
-     * - On non-interactive surfaces.
-     * Set the custom properties on the `bs-ripple` element itself. Inside another component that means `::part(ripple)`,
-     * e.g. `bs-button::part(ripple) { --bs-ripple-color: white; }`.
-     * @prop --bs-ripple-color - Ripple colour. `currentColor` by default, so it follows the parent's text colour and works on every variant.
-     * @prop --bs-ripple-opacity - Starting opacity of the ripple. No opacity token fits, so the default is `0.24`.
+     * - Independent yes/no choices: use `bs-checkbox-group`.
+     * - Many options: use a select or `bs-menu`.
+     */
+    interface BsRadioGroup {
+        /**
+          * Helper text under the options. Replaced by `error` while that is set.
+         */
+        "description"?: string;
+        /**
+          * Error message. Sets `aria-invalid`, replaces the helper text and is announced with the group.
+         */
+        "error"?: string;
+        /**
+          * Visible group label, also the accessible name of the group.
+         */
+        "label"?: string;
+        /**
+          * `name` given to every radio in the group. Defaults to a generated, unique name.
+         */
+        "name"?: string;
+        /**
+          * Layout of the radios.
+          * @default 'vertical'
+         */
+        "orientation": BsRadioGroupOrientation;
+        /**
+          * Marks the group as required: sets `aria-required` and shows an asterisk after the label.
+          * @default false
+         */
+        "required": boolean;
+        /**
+          * Check the first enabled radio when none is checked, so a choice is always made. Off by default so a form can start empty.
+          * @default false
+         */
+        "selectFirst": boolean;
+        /**
+          * `value` of the checked radio. Setting it checks the matching radio (and unchecks the rest).
+         */
+        "value"?: string;
+    }
+    /**
+     * A touch-ripple effect: on pointer press, a circle grows from the press point and fades out.
+     * It is a building block for pressable components (`bs-button`, `bs-icon-button`, ...), not something
+     * to place on a page by itself. Put it inside a positioned, pressable parent; it fills that parent,
+     * follows its corner radius, and listens for `pointerdown` on it. Pointer-events pass through, so the
+     * parent still receives every click.
+     * The motion uses the shared duration and easing tokens. Under `prefers-reduced-motion: reduce` those
+     * durations are `0ms`, and the ripple does not play at all.
+     * ## When to use
+     * - Inside a pressable `bs-*` component, to give press feedback.
+     * ## When not to use
+     * - As a hover or focus indicator. Those are colour changes on the parent.
+     * - On non-interactive surfaces.
+     * Set the custom properties on the `bs-ripple` element itself. Inside another component that means `::part(ripple)`,
+     * e.g. `bs-button::part(ripple) { --bs-ripple-color: white; }`.
+     * @prop --bs-ripple-color - Ripple colour. `currentColor` by default, so it follows the parent's text colour and works on every variant.
+     * @prop --bs-ripple-opacity - Starting opacity of the ripple. No opacity token fits, so the default is `0.24`.
      * @prop --bs-ripple-duration - Length of the ripple. Aliased to `--bs-duration-slower`.
      * @prop --bs-ripple-easing - Curve of the ripple. Aliased to `--bs-easing-decelerate`.
      */
@@ -4590,6 +5137,74 @@ export namespace Components {
          */
         "value"?: string;
     }
+    /**
+     * A single-choice select: a field-shaped combobox that opens a scrollable listbox of options. Same
+     * label / helper text / error chrome as `bs-input`.
+     * Follows the WAI-ARIA select-only combobox pattern: focus stays on the combobox and the
+     * highlighted option is exposed through `aria-activedescendant`.
+     * Built from: the field/label/description/error styling language of `bs-input` (same `--bs-input-*`
+     * tokens). The listbox rows are hand-built leaf elements: `bs-menu-item` is a `role="menuitem"`
+     * button and `bs-popover` moves focus into its popup, neither of which fits the combobox/listbox
+     * pattern where focus must stay on the field.
+     * ## When to use
+     * - Choosing exactly one value from a known list of roughly 4-15 options.
+     * ## When not to use
+     * - 2-3 options that should all be visible (use radios or `bs-toggle-button-group`).
+     * - Very long or searchable lists (use `bs-input type="dropdown"` or a search pattern).
+     */
+    interface BsSelect {
+        /**
+          * Accessible name when there is no visible `label`.
+          * @default null
+         */
+        "ariaLabel": string | null;
+        /**
+          * Helper text below the field (replaced by `error` when set).
+         */
+        "description"?: string;
+        /**
+          * Disables the select.
+          * @default false
+         */
+        "disabled": boolean;
+        /**
+          * Error message; puts the field in its error state.
+         */
+        "error"?: string;
+        /**
+          * Visible label.
+         */
+        "label"?: string;
+        /**
+          * Name the value is submitted under in a surrounding `<form>`.
+         */
+        "name"?: string;
+        /**
+          * Whether the listbox is open.
+          * @default false
+         */
+        "open": boolean;
+        /**
+          * The options. Must be set as a JS property, not an attribute.
+          * @default []
+         */
+        "options": BsSelectOption[];
+        /**
+          * Text shown while no option is selected.
+          * @default 'Select'
+         */
+        "placeholder": string;
+        /**
+          * Marks the field required (native form validation + asterisk).
+          * @default false
+         */
+        "required": boolean;
+        /**
+          * The selected option's `value`.
+          * @default ''
+         */
+        "value": string;
+    }
     /**
      * The three moments around an expiring session, as one card. Matches the Figma "Session timeout"
      * component's three types:
@@ -4848,6 +5463,28 @@ export namespace Components {
          */
         "width"?: string;
     }
+    /**
+     * A "skip to main content" link: invisible until it receives keyboard focus, then shown at the top
+     * of the page. Activating it moves focus to the element its `href` points at, so keyboard and
+     * screen-reader users can bypass repeated navigation (WCAG 2.4.1 Bypass Blocks).
+     * Place it as the very first focusable element on the page. Renders a real `<a>`; the focus move is
+     * done explicitly (the target gets a temporary `tabindex="-1"` when it is not natively focusable),
+     * because a fragment navigation alone does not reliably move focus in every browser.
+     * ## When to use
+     * - Once per page, before the header/navigation, pointing at the `<main>` landmark.
+     * - Additionally before large repeated blocks (e.g. a long sidebar) pointing past them.
+     * ## When not to use
+     * - As a general in-page link -- use a plain link or `bs-table-of-contents`.
+     * - When the page has no repeated blocks before its main content.
+     * Composition: a leaf element (a single anchor); no existing `bs-*` component renders a link.
+     */
+    interface BsSkipLink {
+        /**
+          * Target to skip to: a fragment (`#main-content`) naming an element id in the same document or shadow tree, or any URL (then the browser just navigates). Point it at an element that exists -- if the id is not found, activating the link does nothing beyond the native fragment jump.
+          * @default '#main-content'
+         */
+        "href": string;
+    }
     /**
      * A slider for picking a single numeric value (`type="default"`), a value snapped to evenly
      * spaced ticks (`type="segmented"`), or a min/max pair (`type="range"`) from within a bounded
@@ -5164,6 +5801,61 @@ export namespace Components {
          */
         "wrap": boolean;
     }
+    /**
+     * A key figure: a label, a large value and an optional trend (up, down or flat) with a change figure.
+     * ## When to use
+     * - Dashboard KPIs and summary numbers ("Active users 1,284, up 12%").
+     * ## When not to use
+     * - A time series or comparison of many values -- use a chart.
+     * - A progress toward a goal -- use `bs-progress` / `bs-progress-linear`.
+     * - A count on another element -- use `bs-badge`.
+     * **Built from:** `bs-card` (the surface).
+     * The trend is never conveyed by colour or arrow alone: a visually hidden prefix ("Increase of") is
+     * rendered before the change figure. Whether up is good depends on the metric, so the colour comes from
+     * `trendIntent` (default: up is positive, down is negative; set `negative` for e.g. churn going up).
+     */
+    interface BsStat {
+        /**
+          * What the number measures.
+         */
+        "label": string;
+        /**
+          * Surface of the underlying `bs-card`.
+          * @default 'raised'
+         */
+        "surface": BsCardSurface1;
+        /**
+          * Direction of change. Omit to hide the trend.
+         */
+        "trend"?: BsStatTrend;
+        /**
+          * Visually hidden prefix for `trend="down"`.
+          * @default 'Decrease of'
+         */
+        "trendDownLabel": string;
+        /**
+          * Colour of the trend. Defaults from `trend`: up is positive, down is negative, neutral is neutral.
+         */
+        "trendIntent"?: BsStatTrendIntent;
+        /**
+          * Visually hidden text for `trend="neutral"`.
+          * @default 'No change'
+         */
+        "trendNeutralLabel": string;
+        /**
+          * Visually hidden prefix for `trend="up"`.
+          * @default 'Increase of'
+         */
+        "trendUpLabel": string;
+        /**
+          * The change figure shown next to the arrow (e.g. "12%").
+         */
+        "trendValue"?: string;
+        /**
+          * The figure itself, already formatted (e.g. "1,284" or "98.2%").
+         */
+        "value": string;
+    }
     /**
      * A sequence of named steps showing overall progress through a multi-step flow (e.g. a checkout,
      * an onboarding wizard) -- each step reads as enabled (not yet reached), current, done, error, or
@@ -5345,6 +6037,63 @@ export namespace Components {
          */
         "value"?: string;
     }
+    /**
+     * An "On this page" navigation: a nested list of in-page links with a scroll spy that marks the
+     * section currently in view (`aria-current="location"`), optionally sticky beside long content.
+     * Give it entries in either of two ways:
+     * - **`items` property** (a JS array, `{ label, href, children? }`) -- the data-driven way.
+     * - **Slotted anchors** -- `<a href="#intro">Intro</a>`, optionally inside nested `<ul>`/`<li>` or with
+     *   `data-level="2"` for sub-sections. The component reads them and renders its own styled links (the
+     *   slotted markup is not displayed; it is the no-JavaScript fallback). Used when `items` is empty.
+     * The scroll spy uses an `IntersectionObserver` on the elements the links point at. The current section
+     * is the first one (in link order) that intersects the top band of the viewport defined by `rootMargin`;
+     * when none does (between two sections) the previous one stays current. Observers are disconnected when
+     * the element is removed from the DOM and re-created when it is re-attached.
+     * Link targets are looked up by id in the same document (or shadow tree) as the component. Links whose
+     * target does not exist are still shown but never become current.
+     * ## When to use
+     * - Long single-page content (documentation, policies, settings pages) with several headed sections.
+     * ## When not to use
+     * - Navigating between pages -- use `bs-navigation-drawer` or `bs-breadcrumbs`.
+     * - Switching between panels of content that are not all on the page -- use `bs-tabs`.
+     * Composition: leaf element (a nav landmark with anchors); no existing `bs-*` component renders links.
+     */
+    interface BsTableOfContents {
+        /**
+          * The `href` (`#id`) of the current section. Reflected; follows the scroll spy and clicks, and can be set to force a section.
+         */
+        "current"?: string;
+        /**
+          * Hides the visible title; the landmark keeps its accessible name.
+          * @default false
+         */
+        "hideTitle": boolean;
+        /**
+          * Entries as a JS array (set as a property, not an attribute). Takes precedence over slotted anchors.
+          * @default []
+         */
+        "items": BsTocItem[];
+        /**
+          * Accessible name of the `nav` landmark, and the visible title text.
+          * @default 'On this page'
+         */
+        "label": string;
+        /**
+          * `rootMargin` of the spy's `IntersectionObserver`: shrinks the viewport to the band in which a section counts as "current". The default is the top 40% of the viewport. Raise the top value (e.g. `-64px 0px -60% 0px`) when a fixed header covers the top of the page.
+          * @default '0px 0px -60% 0px'
+         */
+        "rootMargin": string;
+        /**
+          * Turns the scroll spy on or off. Off: `current` only changes when a link is clicked or it is set.
+          * @default true
+         */
+        "scrollSpy": boolean;
+        /**
+          * Sticks the table of contents to the top of its scroll container (`position: sticky`) so it stays in view beside long content. Offset with `--bs-toc-sticky-top`.
+          * @default false
+         */
+        "sticky": boolean;
+    }
     /**
      * A tab-group wrapper: owns `role="tablist"` and coordinates selection across its slotted
      * `<bs-tab>` or `<bs-inline-tab>` children, so consumers no longer have to hand-roll this.
@@ -5378,6 +6127,78 @@ export namespace Components {
          */
         "value"?: string;
     }
+    /**
+     * A small label that categorises or annotates an item (a topic, a keyword, a status of a record). It can be
+     * neutral or coloured, optionally removable, and optionally a link.
+     * ## When to use
+     * - Metadata on a record: topics, categories, keywords, owners.
+     * - A removable tag in a list of applied values you edit one by one (`removable`).
+     * - A tag that leads to a filtered view or detail page (`href`).
+     * ## When not to use
+     * - A pure count or notification marker -- use `bs-badge`.
+     * - A read-only status pill with a leading icon -- use `bs-chip-informative`.
+     * - Toggling a filter on and off -- use `bs-chip-filter`; entering free text values -- use `bs-chip-input`.
+     * **Built from:** `bs-icon-button` (the remove control, `size="xs"`).
+     */
+    interface BsTag {
+        /**
+          * Semantic colour. `neutral` is the default.
+          * @default 'neutral'
+         */
+        "color": BsTagColor;
+        /**
+          * Turns the label into a link to this URL.
+         */
+        "href"?: string;
+        /**
+          * Shows a remove button that emits `bsRemove`. The consumer removes the tag.
+          * @default false
+         */
+        "removable": boolean;
+        /**
+          * Prefix of the remove button's accessible name ("Remove {label}").
+          * @default 'Remove'
+         */
+        "removeLabel": string;
+        /**
+          * Sizing scale.
+          * @default 'md'
+         */
+        "size": BsTagSize;
+        /**
+          * Link target, only used with `href`.
+         */
+        "target"?: string;
+    }
+    /**
+     * Body and caption text mapped to the typography tokens, with the element (`as`) chosen separately
+     * from the look (`variant`) and the colour (`tone`).
+     * Variants: `lead` 18px, `body` 16px, `small` 14px, `caption` 12px (`--bs-font-size-*`,
+     * `--bs-typography-font-family-body`).
+     * Composed from: nothing (leaf).
+     * ## When to use
+     * - Paragraphs, helper copy, captions and inline spans that should follow the type scale and theme.
+     * ## When not to use
+     * - Headings: use `bs-heading` so the document outline is right.
+     * - Code: use `bs-code-block`.
+     */
+    interface BsText {
+        /**
+          * The rendered element. `span` (and `small`, `strong`, `em`, `label`) make the host inline.
+          * @default 'p'
+         */
+        "as": BsTextAs;
+        /**
+          * Text colour from the text tokens. `inherit` uses the surrounding colour.
+          * @default 'default'
+         */
+        "tone": BsTextTone;
+        /**
+          * Visual style.
+          * @default 'body'
+         */
+        "variant": BsTextVariant;
+    }
     /**
      * An inline time picker: hour and minute spinners (up/down carets, or the arrow keys on the value),
      * an AM/PM dropdown in 12-hour mode, a 24h switch, and Cancel/Confirm buttons. Matches the Figma
@@ -5481,6 +6302,131 @@ export namespace Components {
          */
         "state": BsToastState;
     }
+    /**
+     * A button that is either pressed or not. Standalone it is a toggle (`aria-pressed`); inside a
+     * `bs-toggle-button-group` the group sets its `mode` (`toggle` for multiple choice, `radio` for
+     * single choice, which switches the semantics to `role="radio"` + `aria-checked`).
+     * Built from: hand-built `<button>` (the segment shape and pressed state differ from `bs-button`) plus
+     * `bs-ripple`.
+     * ## When to use
+     * - A two-state option such as "Bold", or a segment of a `bs-toggle-button-group`.
+     * ## When not to use
+     * - Triggering an action (use `bs-button`) or an on/off setting that applies immediately (use `bs-switch`).
+     */
+    interface BsToggleButton {
+        /**
+          * Accessible name; required for an icon-only button.
+          * @default null
+         */
+        "ariaLabel": string | null;
+        /**
+          * Disables the button.
+          * @default false
+         */
+        "disabled": boolean;
+        /**
+          * Semantics. Normally set by the parent group.
+          * @default 'toggle'
+         */
+        "mode": BsToggleButtonMode;
+        /**
+          * Whether the button is pressed/selected.
+          * @default false
+         */
+        "pressed": boolean;
+        /**
+          * Roving tabindex, set by the parent group (`false` = `tabindex="-1"`). Standalone: always tabbable.
+          * @default true
+         */
+        "tabbable": boolean;
+        /**
+          * Identifies the segment inside a group's `value`/`values`.
+         */
+        "value"?: string;
+    }
+    /**
+     * A segmented control: a row of `bs-toggle-button` segments with single or multiple choice.
+     * Single choice (default) uses radio semantics (`role="radiogroup"` / `role="radio"`) and arrow keys
+     * move focus AND selection. Multiple choice (`multiple`) uses `role="group"` with `aria-pressed`
+     * toggle buttons; arrow keys move focus only, Space/Enter toggles. Focus is roving in both modes
+     * (one tab stop).
+     * Built from: `bs-toggle-button`.
+     * ## When to use
+     * - 2-5 short, related options that should all stay visible (view mode, alignment, filters).
+     * ## When not to use
+     * - Long lists (use `bs-select`) or page-level navigation (use `bs-tabs`).
+     */
+    interface BsToggleButtonGroup {
+        /**
+          * Accessible name of the group. Required.
+          * @default null
+         */
+        "ariaLabel": string | null;
+        /**
+          * Disables every segment.
+          * @default false
+         */
+        "disabled": boolean;
+        /**
+          * Allow several pressed segments.
+          * @default false
+         */
+        "multiple": boolean;
+        /**
+          * Selected segment `value` (single choice).
+         */
+        "value"?: string;
+        /**
+          * Selected segment values (multiple choice). Set as a JS property.
+          * @default []
+         */
+        "values": string[];
+    }
+    /**
+     * A bar of related controls (buttons, toggles, selects) with a left and a right group, grouped
+     * separators, a single tab stop and arrow-key navigation between the controls (WAI-ARIA toolbar
+     * pattern). Optionally, controls that do not fit collapse into a "more" menu.
+     * Keyboard: the toolbar is ONE tab stop. Left/Right arrows (Up/Down when `orientation="vertical"`,
+     * mirrored in RTL) move focus between the controls and wrap; Home/End jump to the first/last. The
+     * control last focused is the one Tab returns to. Disabled controls are skipped.
+     * Direct children of the `left`/`right` slots are the toolbar's controls. A slotted `bs-divider` is a
+     * separator: the toolbar sets its `orientation` perpendicular to its own and skips it when navigating.
+     * ## When to use
+     * - Several related actions that act on the same content (a text editor's formatting row, a table's
+     *   bulk actions, a viewer's zoom controls).
+     * ## When not to use
+     * - Navigating between pages or sections -- use `bs-tabs`, `bs-navigation-header` or a nav.
+     * - A single action or a form's submit row -- place the `bs-button`s directly.
+     * - A menu of actions that opens on demand -- use `bs-popover` with `bs-menu`.
+     * ## Overflow
+     * With `overflow` set (horizontal only), controls from the end of the bar that do not fit are hidden and
+     * listed in a `bs-menu` behind a "more" button; choosing an entry activates the original control. An
+     * entry's text is the control's `data-label`, else its `aria-label`, else its text content, else `title`:
+     * give icon-only controls one of these.
+     * Composition: built from `bs-icon-button`, `bs-popover`, `bs-menu` and `bs-menu-item` (overflow) and
+     * expects `bs-button`, `bs-icon-button`, `bs-divider` etc. as slotted content.
+     */
+    interface BsToolbar {
+        /**
+          * Accessible name of the toolbar (`aria-label`). Required for a good experience, and essential when a page has more than one toolbar -- say what it controls ("Text formatting").
+         */
+        "label"?: string;
+        /**
+          * Direction of the bar. Sets `aria-orientation`, switches which arrow keys navigate, and sets the orientation of slotted `bs-divider`s to the perpendicular one.
+          * @default 'horizontal'
+         */
+        "orientation": BsToolbarOrientation;
+        /**
+          * Collapse controls that do not fit into a "more" menu (see Overflow in the description). Horizontal toolbars only; ignored when `orientation="vertical"`.
+          * @default false
+         */
+        "overflow": boolean;
+        /**
+          * Accessible name and tooltip of the overflow button.
+          * @default 'More actions'
+         */
+        "overflowLabel": string;
+    }
     /**
      * A dark tooltip bubble with a pointer arrow, used to surface a short hint of extra information
      * next to a trigger element.
@@ -5842,6 +6788,14 @@ export interface BsBreadcrumbOverflowCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsBreadcrumbOverflowElement;
 }
+export interface BsBreadcrumbsCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsBreadcrumbsElement;
+}
+export interface BsCardCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsCardElement;
+}
 export interface BsCarouselCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsCarouselElement;
@@ -5870,6 +6824,10 @@ export interface BsCheckboxCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsCheckboxElement;
 }
+export interface BsCheckboxGroupCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsCheckboxGroupElement;
+}
 export interface BsChipFilterCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsChipFilterElement;
@@ -5882,6 +6840,10 @@ export interface BsCitationPreviewCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsCitationPreviewElement;
 }
+export interface BsCodeBlockCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsCodeBlockElement;
+}
 export interface BsCommandPaletteCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsCommandPaletteElement;
@@ -5914,6 +6876,10 @@ export interface BsDialogCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsDialogElement;
 }
+export interface BsDropdownCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsDropdownElement;
+}
 export interface BsErrorPageCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsErrorPageElement;
@@ -5942,6 +6908,10 @@ export interface BsKeyboardShortcutsCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsKeyboardShortcutsElement;
 }
+export interface BsLinkCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsLinkElement;
+}
 export interface BsListCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsListElement;
@@ -6002,10 +6972,18 @@ export interface BsRadioCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsRadioElement;
 }
+export interface BsRadioGroupCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsRadioGroupElement;
+}
 export interface BsSearchItemCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsSearchItemElement;
 }
+export interface BsSelectCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsSelectElement;
+}
 export interface BsSessionTimeoutCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsSessionTimeoutElement;
@@ -6014,6 +6992,10 @@ export interface BsSidePanelCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsSidePanelElement;
 }
+export interface BsSkipLinkCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsSkipLinkElement;
+}
 export interface BsSliderCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsSliderElement;
@@ -6038,10 +7020,18 @@ export interface BsTabCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsTabElement;
 }
+export interface BsTableOfContentsCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsTableOfContentsElement;
+}
 export interface BsTabsCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsTabsElement;
 }
+export interface BsTagCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsTagElement;
+}
 export interface BsTimepickerCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsTimepickerElement;
@@ -6050,6 +7040,14 @@ export interface BsToastCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsToastElement;
 }
+export interface BsToggleButtonCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsToggleButtonElement;
+}
+export interface BsToggleButtonGroupCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsToggleButtonGroupElement;
+}
 export interface BsTreeCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsTreeElement;
@@ -6524,6 +7522,9 @@ declare global {
         prototype: HTMLBsBreadcrumbOverflowElement;
         new (): HTMLBsBreadcrumbOverflowElement;
     };
+    interface HTMLBsBreadcrumbsElementEventMap {
+        "bsNavigate": { href: string };
+    }
     /**
      * A breadcrumb trail container: a real `<nav>` landmark wrapping an `<ol>`, meant to be populated
      * with slotted `<bs-breadcrumb>` (and, where the consumer wants a collapsed-items disclosure,
@@ -6542,6 +7543,14 @@ declare global {
      * - A flat set of unrelated pages with no hierarchy -- breadcrumbs imply ancestry, not just history.
      */
     interface HTMLBsBreadcrumbsElement extends Components.BsBreadcrumbs, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsBreadcrumbsElementEventMap>(type: K, listener: (this: HTMLBsBreadcrumbsElement, ev: BsBreadcrumbsCustomEvent<HTMLBsBreadcrumbsElementEventMap[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 HTMLBsBreadcrumbsElementEventMap>(type: K, listener: (this: HTMLBsBreadcrumbsElement, ev: BsBreadcrumbsCustomEvent<HTMLBsBreadcrumbsElementEventMap[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 HTMLBsBreadcrumbsElement: {
         prototype: HTMLBsBreadcrumbsElement;
@@ -6563,17 +7572,20 @@ declare global {
      * - `error` purely for visual emphasis — it signals a destructive action to the user, so reserve
      *   it for actions that actually delete/revoke/undo something.
      * @prop --bs-button-radius - Corner radius. Aliased to `--bs-border-radius-100` by default.
-     * @prop --bs-button-padding-x-sm - Left/right padding of a label-only button at `size="sm"`. Aliased to `--bs-spacing-300`.
+     * @prop --bs-button-padding-x-sm - Left/right padding of a label-only button at `size="sm"`. Aliased to `--bs-spacing-150` (12px).
+     * @prop --bs-button-padding-x-md - Left/right padding at `size="md"`. Aliased to `--bs-spacing-150` (12px).
+     * @prop --bs-button-padding-x-lg - Left/right padding at `size="lg"`. Aliased to `--bs-spacing-150` (12px).
      * @prop --bs-button-width - Width of the button. `auto` by default (fits its content); set `100%` for a full-width button, e.g. `bs-button { --bs-button-width: 100%; }`.
      * @prop --bs-button-subtle-color - Label/icon colour, `variant="subtle"`. Aliased to `--bs-color-neutral-default`; set it to `var(--bs-text-action)` for a blue text button.
-     * @prop --bs-button-height-sm - Height at `size="sm"`. Aliased to `--bs-spacing-500`.
-     * @prop --bs-button-height-md - Height at `size="md"`. Aliased to `--bs-spacing-600`.
-     * @prop --bs-button-height-lg - Height at `size="lg"`. Aliased to `--bs-spacing-700`.
+     * @prop --bs-button-height-sm - Height at `size="sm"`. Aliased to `--bs-spacing-400` (32px).
+     * @prop --bs-button-height-md - Height at `size="md"`. Aliased to `--bs-spacing-550` (44px).
+     * @prop --bs-button-height-lg - Height at `size="lg"`. Aliased to `--bs-spacing-600` (48px).
+     * @prop --bs-button-outlined-color - Label/icon colour, `variant="outlined"`, default. Aliased to `--bs-color-primary-default`.
      * @prop --bs-button-neutral-border - Border color, `variant="neutral"`, default/disabled. Aliased to `--bs-border-neutral-container`.
      * @prop --bs-button-neutral-border-hover - Border color, `variant="neutral"`, hover. Aliased to `--bs-border-neutral-container-hover`.
      * @prop --bs-button-neutral-border-pressed - Border color, `variant="neutral"`, pressed. Aliased to `--bs-border-neutral-container-pressed`.
-     * @prop --bs-button-padding-x-icon-side - Horizontal padding on an edge that's adjacent to a leading/trailing icon (tighter than the plain text-only edge). Aliased to `--bs-spacing-150`.
-     * @prop --bs-button-padding-x-label-side - Horizontal padding on the opposite edge, when an icon on the other side needs compensating extra space to keep the button optically balanced. Aliased to `--bs-spacing-250`.
+     * @prop --bs-button-padding-x-icon-side - Horizontal padding on an edge that's adjacent to a leading/trailing icon (now equal to the text-only edge). Aliased to `--bs-spacing-150`.
+     * @prop --bs-button-padding-x-label-side - Horizontal padding on the opposite edge, when an icon on the other side needs compensating extra space to keep the button optically balanced. Aliased to `--bs-spacing-150` (no compensation by default).
      */
     interface HTMLBsButtonElement extends Components.BsButton, HTMLStencilElement {
     }
@@ -6604,6 +7616,10 @@ declare global {
         prototype: HTMLBsButtonSkeletonElement;
         new (): HTMLBsButtonSkeletonElement;
     };
+    interface HTMLBsCardElementEventMap {
+        "bsChange": boolean;
+        "bsNavigate": { href: string };
+    }
     /**
      * A bounded surface for grouping related content — a summary, a form section, a list item.
      * ## When to use
@@ -6614,6 +7630,14 @@ declare global {
      * - For a dismissible/transient message — use a modal or a dedicated notification component.
      */
     interface HTMLBsCardElement extends Components.BsCard, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsCardElementEventMap>(type: K, listener: (this: HTMLBsCardElement, ev: BsCardCustomEvent<HTMLBsCardElementEventMap[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 HTMLBsCardElementEventMap>(type: K, listener: (this: HTMLBsCardElement, ev: BsCardCustomEvent<HTMLBsCardElementEventMap[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 HTMLBsCardElement: {
         prototype: HTMLBsCardElement;
@@ -6885,6 +7909,9 @@ declare global {
      * `--bs-color-primary-container-pressed`.
      * @prop --bs-chatbot-suggestion-button-bg-focus - Background when focused. Aliased to
      * `--bs-color-primary-container-hover` (same as hover).
+     * @prop --bs-chatbot-suggestion-button-bg-disabled - Background when disabled. Aliased to `--bs-surface-action-disabled`.
+     * @prop --bs-chatbot-suggestion-button-text-disabled - Text color when disabled. Aliased to `--bs-text-on-disabled`.
+     * @prop --bs-chatbot-suggestion-button-border-color-disabled - Border color when disabled. Aliased to `--bs-border-neutral-disabled`.
      * @prop --bs-chatbot-suggestion-button-text-default - Text color in the default state. Aliased to
      * `--bs-text-action`.
      * @prop --bs-chatbot-suggestion-button-text-hover - Text color on hover, pressed, and focus.
@@ -6934,6 +7961,33 @@ declare global {
         prototype: HTMLBsCheckboxElement;
         new (): HTMLBsCheckboxElement;
     };
+    interface HTMLBsCheckboxGroupElementEventMap {
+        "bsChange": string[];
+    }
+    /**
+     * A labelled group of `bs-checkbox`es: a `<fieldset>` with a `<legend>`, helper or error text, and
+     * a single `value` array of the checked boxes' values.
+     * Composed from: `bs-checkbox` (slotted by you).
+     * ## When to use
+     * - A set of related, independent options where any number may be chosen ("Notify me by ...").
+     * ## When not to use
+     * - Exactly one choice: use `bs-radio-group`.
+     * - A single yes/no: use one `bs-checkbox`, or `bs-switch` for an immediate setting.
+     */
+    interface HTMLBsCheckboxGroupElement extends Components.BsCheckboxGroup, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsCheckboxGroupElementEventMap>(type: K, listener: (this: HTMLBsCheckboxGroupElement, ev: BsCheckboxGroupCustomEvent<HTMLBsCheckboxGroupElementEventMap[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 HTMLBsCheckboxGroupElementEventMap>(type: K, listener: (this: HTMLBsCheckboxGroupElement, ev: BsCheckboxGroupCustomEvent<HTMLBsCheckboxGroupElementEventMap[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 HTMLBsCheckboxGroupElement: {
+        prototype: HTMLBsCheckboxGroupElement;
+        new (): HTMLBsCheckboxGroupElement;
+    };
     /**
      * A shape-matched loading placeholder for `bs-checkbox`, shown while the real label text isn't
      * known yet (e.g. still being fetched from an API). Renders a small square (matching the
@@ -7072,6 +8126,43 @@ declare global {
         prototype: HTMLBsCitationPreviewElement;
         new (): HTMLBsCitationPreviewElement;
     };
+    interface HTMLBsCodeBlockElementEventMap {
+        "bsCopy": string;
+    }
+    /**
+     * A block of code with an optional filename header and a Copy button, or (with `inline`) styled
+     * inline code. Dependency-free: it does no syntax highlighting itself. Pass plain text with `code`,
+     * or slot pre-highlighted markup (e.g. the output of Shiki or Prism: spans coloured with your own
+     * CSS) as the default slot.
+     * Follows light and dark mode through the surface/text tokens. Long lines scroll horizontally (the
+     * scroll area is keyboard focusable) or, with `wrap`, break onto the next line.
+     * Copying announces the `copiedLabel` text through a polite live region, and the button label
+     * changes to match for a few seconds.
+     * Slotted content: keep it flush against the tags (`<bs-code-block><span>..</span></bs-code-block>`),
+     * since whitespace in a `<pre>`-style block is kept. The line count for `lineNumbers` and the text
+     * that is copied are read from the slotted text.
+     * Composed from: `bs-card` (the surface), `bs-button` and `bs-icon` (the Copy button).
+     * ## When to use
+     * - Showing a snippet, command or config the reader may want to copy.
+     * - `inline` for a short code term inside a sentence.
+     * ## When not to use
+     * - Long files that need folding, search or editing: link to the source instead.
+     * - Pre-formatted prose or tables: use ordinary text and table markup.
+     */
+    interface HTMLBsCodeBlockElement extends Components.BsCodeBlock, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsCodeBlockElementEventMap>(type: K, listener: (this: HTMLBsCodeBlockElement, ev: BsCodeBlockCustomEvent<HTMLBsCodeBlockElementEventMap[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 HTMLBsCodeBlockElementEventMap>(type: K, listener: (this: HTMLBsCodeBlockElement, ev: BsCodeBlockCustomEvent<HTMLBsCodeBlockElementEventMap[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 HTMLBsCodeBlockElement: {
+        prototype: HTMLBsCodeBlockElement;
+        new (): HTMLBsCodeBlockElement;
+    };
     interface HTMLBsCommandPaletteElementEventMap {
         "bsInput": BsCommandPaletteInputDetail;
         "bsSelect": BsCommandPaletteSelectDetail;
@@ -7413,6 +8504,12 @@ declare global {
      * ## When not to use
      * - A handful of unrelated key/value pairs — a simple list or card is lighter-weight.
      * - Deeply nested/hierarchical data — this component renders one flat row per record.
+     * ## Rich cells
+     * Without a `cellRenderer`, each cell is a named slot, `cell-{row.id}-{column.key}`, whose fallback
+     * content is the plain-text value. Slot an element into it to put app-owned content (a framework
+     * component, a router link, a badge) in the cell, e.g.
+     * `<a slot="cell-7-name" href="/people/7">Ada</a>`. The slotted element lives in the light DOM, so
+     * it keeps your framework, router and CSP; nothing is parsed as HTML.
      */
     interface HTMLBsDataTableElement extends Components.BsDataTable, HTMLStencilElement {
         addEventListener<K extends keyof HTMLBsDataTableElementEventMap>(type: K, listener: (this: HTMLBsDataTableElement, ev: BsDataTableCustomEvent<HTMLBsDataTableElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -7465,6 +8562,48 @@ declare global {
         prototype: HTMLBsDatepickerElement;
         new (): HTMLBsDatepickerElement;
     };
+    /**
+     * One term and its detail inside a `bs-description-list` (a label/value pair such as "Owner: Sam Lee").
+     * ## When to use
+     * - As a child of `bs-description-list`, one per key/value pair.
+     * ## When not to use
+     * - Rows of records with media and actions -- use `bs-list-item`.
+     * - Many pairs compared across several records -- use `bs-data-table`.
+     * Each item renders its own `<dl>` containing one `<div>` group with a real `<dt>` and `<dd>`. (A `dl` cannot
+     * span the shadow boundary between a list and its items, so the grouping lives here.)
+     * @prop --bs-description-item-gap - Gap between term and detail when stacked. Aliased to `--bs-spacing-25`.
+     * @prop --bs-description-item-term-width - Width of the term column when `layout="horizontal"`. `12rem`.
+     * @prop --bs-description-item-column-gap - Gap between the term and detail columns when horizontal. Aliased to `--bs-spacing-200`.
+     * @prop --bs-description-item-padding-y - Vertical padding. Aliased to `--bs-spacing-100`.
+     * @prop --bs-description-item-term-color - Aliased to `--bs-text-secondary`.
+     * @prop --bs-description-item-description-color - Aliased to `--bs-text-default`.
+     */
+    interface HTMLBsDescriptionItemElement extends Components.BsDescriptionItem, HTMLStencilElement {
+    }
+    var HTMLBsDescriptionItemElement: {
+        prototype: HTMLBsDescriptionItemElement;
+        new (): HTMLBsDescriptionItemElement;
+    };
+    /**
+     * A key/value list of `bs-description-item` pairs (term and detail), for record summaries, settings read-outs
+     * and metadata panels. Terms and details use real `dt`/`dd` semantics.
+     * ## When to use
+     * - A read-only summary of one record: "Owner", "Created", "Status" with their values.
+     * ## When not to use
+     * - A list of records with media and actions -- use `bs-list`.
+     * - Editable fields -- use form components.
+     * - Several records compared across columns -- use `bs-data-table`.
+     * Built from `bs-description-item` children (light DOM; the list never moves nodes). Each item holds its own
+     * `dl`; the list sets the layout on them and draws dividers.
+     * @prop --bs-description-list-divider-color - Divider colour when `dividers` is set. Aliased to `--bs-border-neutral-container`.
+     * @prop --bs-description-list-gap - Gap between items. `0`.
+     */
+    interface HTMLBsDescriptionListElement extends Components.BsDescriptionList, HTMLStencilElement {
+    }
+    var HTMLBsDescriptionListElement: {
+        prototype: HTMLBsDescriptionListElement;
+        new (): HTMLBsDescriptionListElement;
+    };
     interface HTMLBsDialogElementEventMap {
         "bsClose": void;
     }
@@ -7516,6 +8655,39 @@ declare global {
         prototype: HTMLBsDividerElement;
         new (): HTMLBsDividerElement;
     };
+    interface HTMLBsDropdownElementEventMap {
+        "bsOpen": void;
+        "bsClose": void;
+    }
+    /**
+     * A menu trigger: a button (slot `trigger`) that opens a `bs-menu` of `bs-menu-item`s in an anchored,
+     * viewport-aware popup, with the menu keyboard pattern and focus management built in.
+     * Opens on click, Enter, Space (via the trigger button) and ArrowDown. On open focus moves to the
+     * first enabled menu item; Up/Down/Home/End move between items (handled by `bs-menu`). The dropdown
+     * closes on outside click, Escape (focus returns to the trigger), Tab, and after an item is activated.
+     * The trigger gets `aria-haspopup="menu"` and `aria-expanded` kept in sync.
+     * Composed from `bs-popover` (anchor positioning, flipping, outside-click and Escape dismissal, open
+     * motion), `bs-menu` and `bs-menu-item` (slotted by you), and a `bs-button` / `bs-icon-button` trigger.
+     * ## When to use
+     * - A header or toolbar action that reveals a short list of commands ("More", "Account", "Sort by").
+     * ## When not to use
+     * - Free-form popup content such as forms or arbitrary panels (use `bs-popover`).
+     * - Choosing a value for a form field (use `bs-select`).
+     */
+    interface HTMLBsDropdownElement extends Components.BsDropdown, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsDropdownElementEventMap>(type: K, listener: (this: HTMLBsDropdownElement, ev: BsDropdownCustomEvent<HTMLBsDropdownElementEventMap[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 HTMLBsDropdownElementEventMap>(type: K, listener: (this: HTMLBsDropdownElement, ev: BsDropdownCustomEvent<HTMLBsDropdownElementEventMap[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 HTMLBsDropdownElement: {
+        prototype: HTMLBsDropdownElement;
+        new (): HTMLBsDropdownElement;
+    };
     /**
      * 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.
@@ -7530,6 +8702,7 @@ declare global {
      * @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-size - Aliased to `--bs-font-size-xl` (`--bs-font-size-3xl` at `size="page"`).
      * @prop --bs-empty-state-heading-color - Aliased to `--bs-text-default`.
      * @prop --bs-empty-state-description-color - Aliased to `--bs-text-secondary`.
      */
@@ -7707,6 +8880,46 @@ declare global {
         prototype: HTMLBsGridElement;
         new (): HTMLBsGridElement;
     };
+    /**
+     * A heading whose rendered element and visual style are chosen separately: `level` (or `as`) picks
+     * the element for the document outline, `size` picks the look. Sizes map to the typography tokens
+     * (`--bs-font-size-*`, `--bs-font-weight-*`, `--bs-line-height-*`, `--bs-typography-font-family-heading`).
+     * Default sizes by level: 1 = 40px, 2 = 32px, 3 = 24px, 4 = 20px, 5 = 18px, 6 = 16px; `display` is 48px.
+     * Composed from: nothing (leaf).
+     * ## When to use
+     * - Any page or section title. Keep levels in order (no jumping from 1 to 4); change `size`, not `level`, to restyle.
+     * ## When not to use
+     * - Body copy, captions and labels: use `bs-text`.
+     * - To make text big without it being a heading: use `bs-text` with `as="p"`.
+     */
+    interface HTMLBsHeadingElement extends Components.BsHeading, HTMLStencilElement {
+    }
+    var HTMLBsHeadingElement: {
+        prototype: HTMLBsHeadingElement;
+        new (): HTMLBsHeadingElement;
+    };
+    /**
+     * A sized, coloured icon. Renders inline SVG from a named registry (`name`), or any SVG you slot in.
+     * Built-in names: `menu`, `arrow-right`, `arrow-left`, `check`, `close`, `chevron-down`,
+     * `external-link`, `copy`, `search`, plus Phosphor glyphs `user`, `star`, `star-fill`, `x`,
+     * `paper-plane-right`, `note-pencil`, `clock-counter-clockwise`, `arrows-out-simple` (256x256 filled). Add more with `registerIcons({ name: '<path d="..."/>' })`
+     * (exported from the package entry): each value is the inner markup of a 24x24, `currentColor`
+     * stroke icon, or pass `{ viewBox, body }` for a filled glyph on another grid.
+     * Decorative by default (`aria-hidden`). Set `label` when the icon alone conveys meaning; it is then
+     * exposed as an image with that name. An icon inside a button never needs `label`: name the button.
+     * Composed from: nothing (leaf). Used by `bs-code-block`.
+     * ## When to use
+     * - A glyph beside text or inside a button, sized and coloured from tokens.
+     * ## When not to use
+     * - As a control by itself: wrap it in `bs-icon-button`.
+     * - For a tinted status square: use `bs-icon-tile`.
+     */
+    interface HTMLBsIconElement extends Components.BsIcon, HTMLStencilElement {
+    }
+    var HTMLBsIconElement: {
+        prototype: HTMLBsIconElement;
+        new (): HTMLBsIconElement;
+    };
     /**
      * A clickable, icon-only action element -- the icon-only sibling of `bs-button`, sharing the same
      * 8 visual variants and color language, but ALWAYS rendering just a single icon, never a label.
@@ -7794,6 +9007,7 @@ declare global {
         "bsInput": string;
         "bsChange": string;
         "bsOpen": boolean;
+        "bsOptionSelect": { label: string; value: string };
         "bsChipAdd": string;
         "bsChipRemove": string;
         "bsTitleChange": string;
@@ -7804,7 +9018,9 @@ declare global {
      * range of related "field" shapes (number stepper, password reveal, date, dropdown trigger,
      * select, textarea, chip input, initials, country, and pin) via the `type` prop, since they all
      * share the same label/description/error/icon-slot chrome.
-     * Built from: `bs-menu`/`bs-menu-item` (`type="dropdown"`) and `bs-chip-informative` + `bs-icon-button` (`type="chip"`).
+     * Built from: `bs-menu`/`bs-menu-item` (`type="dropdown"`), `bs-chip-informative` + `bs-icon-button` (`type="chip"`),
+     * and `bs-icon-button` + `bs-spinner` (`type="combobox"` clear button / loading indicator; its listbox is a
+     * hand-built `role="listbox"` because `bs-menu` is `role="menu"` and cannot host `option`s).
      * ## When to use
      * - Collecting a single line of free-text, email, password, or numeric input.
      * - Any of the other supported `type`s (search, date, dropdown, select, textarea, chip, initials,
@@ -7913,6 +9129,34 @@ declare global {
         prototype: HTMLBsKeyboardShortcutsElement;
         new (): HTMLBsKeyboardShortcutsElement;
     };
+    interface HTMLBsLinkElementEventMap {
+        "bsNavigate": { href: string };
+    }
+    /**
+     * A navigation link: either text (inline within a sentence, or standalone with a 44px target) or a
+     * link styled as a primary button. Always renders a real `<a href>`.
+     * Built from: hand-built `<a>` (leaf). `bs-button` renders a `<button>` and has no `href`; nesting a
+     * button in an anchor is invalid HTML, so the `button` variant reuses the primary button's colour
+     * tokens instead. Known gap: add `href` support to `bs-button` and compose it here.
+     * ## When to use
+     * - Navigating to another page or an external resource.
+     * ## When not to use
+     * - Triggering an action on the current page (use `bs-button`).
+     */
+    interface HTMLBsLinkElement extends Components.BsLink, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsLinkElementEventMap>(type: K, listener: (this: HTMLBsLinkElement, ev: BsLinkCustomEvent<HTMLBsLinkElementEventMap[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 HTMLBsLinkElementEventMap>(type: K, listener: (this: HTMLBsLinkElement, ev: BsLinkCustomEvent<HTMLBsLinkElementEventMap[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 HTMLBsLinkElement: {
+        prototype: HTMLBsLinkElement;
+        new (): HTMLBsLinkElement;
+    };
     interface HTMLBsListElementEventMap {
         "bsChange": string | null;
     }
@@ -7925,6 +9169,9 @@ declare global {
      * - A popup list of actions -- use `bs-menu`.
      * - Navigation between app sections -- use `bs-navigation-drawer`.
      * - Multi-column, sortable or paged data -- use `bs-data-table`.
+     * `variant` switches between a plain list, a bulleted list and a numbered list; `dividers` gives a divided
+     * list. The list keeps real list semantics in every variant (`role="list"` with `listitem` rows); the bullet
+     * or number is drawn by the row and hidden from assistive technology, which announces position itself.
      * Built from `bs-list-item` children (light DOM; the list never moves nodes).
      * @prop --bs-list-gap - Gap between rows. Defaults to `0`.
      * @prop --bs-list-divider-color - Divider colour when `dividers` is set. Aliased to `--bs-border-neutral-container`.
@@ -8720,6 +9967,37 @@ declare global {
         prototype: HTMLBsRadioElement;
         new (): HTMLBsRadioElement;
     };
+    interface HTMLBsRadioGroupElementEventMap {
+        "bsChange": string;
+    }
+    /**
+     * A labelled group of `bs-radio`s: a visible label, helper or error text, an accessible
+     * `role="radiogroup"`, and a single `value` for the whole set.
+     * The group gives its radios one shared `name` (its own `name`, or a generated one) so they behave
+     * as one native-style group: arrow keys move the selection (wrapping), only the checked radio is in
+     * the tab order, and checking one unchecks the others. It keeps at most one radio checked (the
+     * first one wins if several start checked).
+     * Composed from: `bs-radio` (slotted by you).
+     * ## When to use
+     * - A set of 2-5 mutually exclusive options that should all stay visible, with a shared label.
+     * ## When not to use
+     * - Independent yes/no choices: use `bs-checkbox-group`.
+     * - Many options: use a select or `bs-menu`.
+     */
+    interface HTMLBsRadioGroupElement extends Components.BsRadioGroup, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsRadioGroupElementEventMap>(type: K, listener: (this: HTMLBsRadioGroupElement, ev: BsRadioGroupCustomEvent<HTMLBsRadioGroupElementEventMap[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 HTMLBsRadioGroupElementEventMap>(type: K, listener: (this: HTMLBsRadioGroupElement, ev: BsRadioGroupCustomEvent<HTMLBsRadioGroupElementEventMap[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 HTMLBsRadioGroupElement: {
+        prototype: HTMLBsRadioGroupElement;
+        new (): HTMLBsRadioGroupElement;
+    };
     /**
      * A touch-ripple effect: on pointer press, a circle grows from the press point and fades out.
      * It is a building block for pressable components (`bs-button`, `bs-icon-button`, ...), not something
@@ -8787,6 +10065,38 @@ declare global {
         prototype: HTMLBsSearchItemElement;
         new (): HTMLBsSearchItemElement;
     };
+    interface HTMLBsSelectElementEventMap {
+        "bsChange": string;
+    }
+    /**
+     * A single-choice select: a field-shaped combobox that opens a scrollable listbox of options. Same
+     * label / helper text / error chrome as `bs-input`.
+     * Follows the WAI-ARIA select-only combobox pattern: focus stays on the combobox and the
+     * highlighted option is exposed through `aria-activedescendant`.
+     * Built from: the field/label/description/error styling language of `bs-input` (same `--bs-input-*`
+     * tokens). The listbox rows are hand-built leaf elements: `bs-menu-item` is a `role="menuitem"`
+     * button and `bs-popover` moves focus into its popup, neither of which fits the combobox/listbox
+     * pattern where focus must stay on the field.
+     * ## When to use
+     * - Choosing exactly one value from a known list of roughly 4-15 options.
+     * ## When not to use
+     * - 2-3 options that should all be visible (use radios or `bs-toggle-button-group`).
+     * - Very long or searchable lists (use `bs-input type="dropdown"` or a search pattern).
+     */
+    interface HTMLBsSelectElement extends Components.BsSelect, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsSelectElementEventMap>(type: K, listener: (this: HTMLBsSelectElement, ev: BsSelectCustomEvent<HTMLBsSelectElementEventMap[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 HTMLBsSelectElementEventMap>(type: K, listener: (this: HTMLBsSelectElement, ev: BsSelectCustomEvent<HTMLBsSelectElementEventMap[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 HTMLBsSelectElement: {
+        prototype: HTMLBsSelectElement;
+        new (): HTMLBsSelectElement;
+    };
     interface HTMLBsSessionTimeoutElementEventMap {
         "bsPrimary": { password?: string } | void;
         "bsSecondary": void;
@@ -8917,6 +10227,38 @@ declare global {
         prototype: HTMLBsSkeletonElement;
         new (): HTMLBsSkeletonElement;
     };
+    interface HTMLBsSkipLinkElementEventMap {
+        "bsSkip": { href: string; target: HTMLElement | null };
+    }
+    /**
+     * A "skip to main content" link: invisible until it receives keyboard focus, then shown at the top
+     * of the page. Activating it moves focus to the element its `href` points at, so keyboard and
+     * screen-reader users can bypass repeated navigation (WCAG 2.4.1 Bypass Blocks).
+     * Place it as the very first focusable element on the page. Renders a real `<a>`; the focus move is
+     * done explicitly (the target gets a temporary `tabindex="-1"` when it is not natively focusable),
+     * because a fragment navigation alone does not reliably move focus in every browser.
+     * ## When to use
+     * - Once per page, before the header/navigation, pointing at the `<main>` landmark.
+     * - Additionally before large repeated blocks (e.g. a long sidebar) pointing past them.
+     * ## When not to use
+     * - As a general in-page link -- use a plain link or `bs-table-of-contents`.
+     * - When the page has no repeated blocks before its main content.
+     * Composition: a leaf element (a single anchor); no existing `bs-*` component renders a link.
+     */
+    interface HTMLBsSkipLinkElement extends Components.BsSkipLink, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsSkipLinkElementEventMap>(type: K, listener: (this: HTMLBsSkipLinkElement, ev: BsSkipLinkCustomEvent<HTMLBsSkipLinkElementEventMap[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 HTMLBsSkipLinkElementEventMap>(type: K, listener: (this: HTMLBsSkipLinkElement, ev: BsSkipLinkCustomEvent<HTMLBsSkipLinkElementEventMap[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 HTMLBsSkipLinkElement: {
+        prototype: HTMLBsSkipLinkElement;
+        new (): HTMLBsSkipLinkElement;
+    };
     interface HTMLBsSliderElementEventMap {
         "bsChange": number;
         "bsRangeChange": { start: number; end: number };
@@ -9119,6 +10461,25 @@ declare global {
         prototype: HTMLBsStackElement;
         new (): HTMLBsStackElement;
     };
+    /**
+     * A key figure: a label, a large value and an optional trend (up, down or flat) with a change figure.
+     * ## When to use
+     * - Dashboard KPIs and summary numbers ("Active users 1,284, up 12%").
+     * ## When not to use
+     * - A time series or comparison of many values -- use a chart.
+     * - A progress toward a goal -- use `bs-progress` / `bs-progress-linear`.
+     * - A count on another element -- use `bs-badge`.
+     * **Built from:** `bs-card` (the surface).
+     * The trend is never conveyed by colour or arrow alone: a visually hidden prefix ("Increase of") is
+     * rendered before the change figure. Whether up is good depends on the metric, so the colour comes from
+     * `trendIntent` (default: up is positive, down is negative; set `negative` for e.g. churn going up).
+     */
+    interface HTMLBsStatElement extends Components.BsStat, HTMLStencilElement {
+    }
+    var HTMLBsStatElement: {
+        prototype: HTMLBsStatElement;
+        new (): HTMLBsStatElement;
+    };
     /**
      * A sequence of named steps showing overall progress through a multi-step flow (e.g. a checkout,
      * an onboarding wizard) -- each step reads as enabled (not yet reached), current, done, error, or
@@ -9232,6 +10593,45 @@ declare global {
         prototype: HTMLBsTabElement;
         new (): HTMLBsTabElement;
     };
+    interface HTMLBsTableOfContentsElementEventMap {
+        "bsNavigate": { href: string };
+        "bsChange": string;
+    }
+    /**
+     * An "On this page" navigation: a nested list of in-page links with a scroll spy that marks the
+     * section currently in view (`aria-current="location"`), optionally sticky beside long content.
+     * Give it entries in either of two ways:
+     * - **`items` property** (a JS array, `{ label, href, children? }`) -- the data-driven way.
+     * - **Slotted anchors** -- `<a href="#intro">Intro</a>`, optionally inside nested `<ul>`/`<li>` or with
+     *   `data-level="2"` for sub-sections. The component reads them and renders its own styled links (the
+     *   slotted markup is not displayed; it is the no-JavaScript fallback). Used when `items` is empty.
+     * The scroll spy uses an `IntersectionObserver` on the elements the links point at. The current section
+     * is the first one (in link order) that intersects the top band of the viewport defined by `rootMargin`;
+     * when none does (between two sections) the previous one stays current. Observers are disconnected when
+     * the element is removed from the DOM and re-created when it is re-attached.
+     * Link targets are looked up by id in the same document (or shadow tree) as the component. Links whose
+     * target does not exist are still shown but never become current.
+     * ## When to use
+     * - Long single-page content (documentation, policies, settings pages) with several headed sections.
+     * ## When not to use
+     * - Navigating between pages -- use `bs-navigation-drawer` or `bs-breadcrumbs`.
+     * - Switching between panels of content that are not all on the page -- use `bs-tabs`.
+     * Composition: leaf element (a nav landmark with anchors); no existing `bs-*` component renders links.
+     */
+    interface HTMLBsTableOfContentsElement extends Components.BsTableOfContents, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsTableOfContentsElementEventMap>(type: K, listener: (this: HTMLBsTableOfContentsElement, ev: BsTableOfContentsCustomEvent<HTMLBsTableOfContentsElementEventMap[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 HTMLBsTableOfContentsElementEventMap>(type: K, listener: (this: HTMLBsTableOfContentsElement, ev: BsTableOfContentsCustomEvent<HTMLBsTableOfContentsElementEventMap[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 HTMLBsTableOfContentsElement: {
+        prototype: HTMLBsTableOfContentsElement;
+        new (): HTMLBsTableOfContentsElement;
+    };
     interface HTMLBsTabsElementEventMap {
         "bsChange": { value: string };
     }
@@ -9252,19 +10652,67 @@ declare global {
      * - For a single, standalone tab button not participating in a group -- use `bs-tab`/`bs-inline-tab`
      *   directly.
      */
-    interface HTMLBsTabsElement extends Components.BsTabs, HTMLStencilElement {
-        addEventListener<K extends keyof HTMLBsTabsElementEventMap>(type: K, listener: (this: HTMLBsTabsElement, ev: BsTabsCustomEvent<HTMLBsTabsElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+    interface HTMLBsTabsElement extends Components.BsTabs, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsTabsElementEventMap>(type: K, listener: (this: HTMLBsTabsElement, ev: BsTabsCustomEvent<HTMLBsTabsElementEventMap[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 HTMLBsTabsElementEventMap>(type: K, listener: (this: HTMLBsTabsElement, ev: BsTabsCustomEvent<HTMLBsTabsElementEventMap[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 HTMLBsTabsElement: {
+        prototype: HTMLBsTabsElement;
+        new (): HTMLBsTabsElement;
+    };
+    interface HTMLBsTagElementEventMap {
+        "bsRemove": void;
+    }
+    /**
+     * A small label that categorises or annotates an item (a topic, a keyword, a status of a record). It can be
+     * neutral or coloured, optionally removable, and optionally a link.
+     * ## When to use
+     * - Metadata on a record: topics, categories, keywords, owners.
+     * - A removable tag in a list of applied values you edit one by one (`removable`).
+     * - A tag that leads to a filtered view or detail page (`href`).
+     * ## When not to use
+     * - A pure count or notification marker -- use `bs-badge`.
+     * - A read-only status pill with a leading icon -- use `bs-chip-informative`.
+     * - Toggling a filter on and off -- use `bs-chip-filter`; entering free text values -- use `bs-chip-input`.
+     * **Built from:** `bs-icon-button` (the remove control, `size="xs"`).
+     */
+    interface HTMLBsTagElement extends Components.BsTag, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsTagElementEventMap>(type: K, listener: (this: HTMLBsTagElement, ev: BsTagCustomEvent<HTMLBsTagElementEventMap[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 HTMLBsTabsElementEventMap>(type: K, listener: (this: HTMLBsTabsElement, ev: BsTabsCustomEvent<HTMLBsTabsElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLBsTagElementEventMap>(type: K, listener: (this: HTMLBsTagElement, ev: BsTagCustomEvent<HTMLBsTagElementEventMap[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 HTMLBsTabsElement: {
-        prototype: HTMLBsTabsElement;
-        new (): HTMLBsTabsElement;
+    var HTMLBsTagElement: {
+        prototype: HTMLBsTagElement;
+        new (): HTMLBsTagElement;
+    };
+    /**
+     * Body and caption text mapped to the typography tokens, with the element (`as`) chosen separately
+     * from the look (`variant`) and the colour (`tone`).
+     * Variants: `lead` 18px, `body` 16px, `small` 14px, `caption` 12px (`--bs-font-size-*`,
+     * `--bs-typography-font-family-body`).
+     * Composed from: nothing (leaf).
+     * ## When to use
+     * - Paragraphs, helper copy, captions and inline spans that should follow the type scale and theme.
+     * ## When not to use
+     * - Headings: use `bs-heading` so the document outline is right.
+     * - Code: use `bs-code-block`.
+     */
+    interface HTMLBsTextElement extends Components.BsText, HTMLStencilElement {
+    }
+    var HTMLBsTextElement: {
+        prototype: HTMLBsTextElement;
+        new (): HTMLBsTextElement;
     };
     interface HTMLBsTimepickerElementEventMap {
         "bsChange": BsTimepickerChange;
@@ -9327,6 +10775,93 @@ declare global {
         prototype: HTMLBsToastElement;
         new (): HTMLBsToastElement;
     };
+    interface HTMLBsToggleButtonElementEventMap {
+        "bsChange": boolean;
+    }
+    /**
+     * A button that is either pressed or not. Standalone it is a toggle (`aria-pressed`); inside a
+     * `bs-toggle-button-group` the group sets its `mode` (`toggle` for multiple choice, `radio` for
+     * single choice, which switches the semantics to `role="radio"` + `aria-checked`).
+     * Built from: hand-built `<button>` (the segment shape and pressed state differ from `bs-button`) plus
+     * `bs-ripple`.
+     * ## When to use
+     * - A two-state option such as "Bold", or a segment of a `bs-toggle-button-group`.
+     * ## When not to use
+     * - Triggering an action (use `bs-button`) or an on/off setting that applies immediately (use `bs-switch`).
+     */
+    interface HTMLBsToggleButtonElement extends Components.BsToggleButton, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsToggleButtonElementEventMap>(type: K, listener: (this: HTMLBsToggleButtonElement, ev: BsToggleButtonCustomEvent<HTMLBsToggleButtonElementEventMap[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 HTMLBsToggleButtonElementEventMap>(type: K, listener: (this: HTMLBsToggleButtonElement, ev: BsToggleButtonCustomEvent<HTMLBsToggleButtonElementEventMap[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 HTMLBsToggleButtonElement: {
+        prototype: HTMLBsToggleButtonElement;
+        new (): HTMLBsToggleButtonElement;
+    };
+    interface HTMLBsToggleButtonGroupElementEventMap {
+        "bsChange": string | string[];
+    }
+    /**
+     * A segmented control: a row of `bs-toggle-button` segments with single or multiple choice.
+     * Single choice (default) uses radio semantics (`role="radiogroup"` / `role="radio"`) and arrow keys
+     * move focus AND selection. Multiple choice (`multiple`) uses `role="group"` with `aria-pressed`
+     * toggle buttons; arrow keys move focus only, Space/Enter toggles. Focus is roving in both modes
+     * (one tab stop).
+     * Built from: `bs-toggle-button`.
+     * ## When to use
+     * - 2-5 short, related options that should all stay visible (view mode, alignment, filters).
+     * ## When not to use
+     * - Long lists (use `bs-select`) or page-level navigation (use `bs-tabs`).
+     */
+    interface HTMLBsToggleButtonGroupElement extends Components.BsToggleButtonGroup, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsToggleButtonGroupElementEventMap>(type: K, listener: (this: HTMLBsToggleButtonGroupElement, ev: BsToggleButtonGroupCustomEvent<HTMLBsToggleButtonGroupElementEventMap[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 HTMLBsToggleButtonGroupElementEventMap>(type: K, listener: (this: HTMLBsToggleButtonGroupElement, ev: BsToggleButtonGroupCustomEvent<HTMLBsToggleButtonGroupElementEventMap[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 HTMLBsToggleButtonGroupElement: {
+        prototype: HTMLBsToggleButtonGroupElement;
+        new (): HTMLBsToggleButtonGroupElement;
+    };
+    /**
+     * A bar of related controls (buttons, toggles, selects) with a left and a right group, grouped
+     * separators, a single tab stop and arrow-key navigation between the controls (WAI-ARIA toolbar
+     * pattern). Optionally, controls that do not fit collapse into a "more" menu.
+     * Keyboard: the toolbar is ONE tab stop. Left/Right arrows (Up/Down when `orientation="vertical"`,
+     * mirrored in RTL) move focus between the controls and wrap; Home/End jump to the first/last. The
+     * control last focused is the one Tab returns to. Disabled controls are skipped.
+     * Direct children of the `left`/`right` slots are the toolbar's controls. A slotted `bs-divider` is a
+     * separator: the toolbar sets its `orientation` perpendicular to its own and skips it when navigating.
+     * ## When to use
+     * - Several related actions that act on the same content (a text editor's formatting row, a table's
+     *   bulk actions, a viewer's zoom controls).
+     * ## When not to use
+     * - Navigating between pages or sections -- use `bs-tabs`, `bs-navigation-header` or a nav.
+     * - A single action or a form's submit row -- place the `bs-button`s directly.
+     * - A menu of actions that opens on demand -- use `bs-popover` with `bs-menu`.
+     * ## Overflow
+     * With `overflow` set (horizontal only), controls from the end of the bar that do not fit are hidden and
+     * listed in a `bs-menu` behind a "more" button; choosing an entry activates the original control. An
+     * entry's text is the control's `data-label`, else its `aria-label`, else its text content, else `title`:
+     * give icon-only controls one of these.
+     * Composition: built from `bs-icon-button`, `bs-popover`, `bs-menu` and `bs-menu-item` (overflow) and
+     * expects `bs-button`, `bs-icon-button`, `bs-divider` etc. as slotted content.
+     */
+    interface HTMLBsToolbarElement extends Components.BsToolbar, HTMLStencilElement {
+    }
+    var HTMLBsToolbarElement: {
+        prototype: HTMLBsToolbarElement;
+        new (): HTMLBsToolbarElement;
+    };
     /**
      * A dark tooltip bubble with a pointer arrow, used to surface a short hint of extra information
      * next to a trigger element.
@@ -9533,11 +11068,13 @@ declare global {
         "bs-chatbot-sources-drawer": HTMLBsChatbotSourcesDrawerElement;
         "bs-chatbot-suggestion-button": HTMLBsChatbotSuggestionButtonElement;
         "bs-checkbox": HTMLBsCheckboxElement;
+        "bs-checkbox-group": HTMLBsCheckboxGroupElement;
         "bs-checkbox-skeleton": HTMLBsCheckboxSkeletonElement;
         "bs-chip-filter": HTMLBsChipFilterElement;
         "bs-chip-informative": HTMLBsChipInformativeElement;
         "bs-chip-input": HTMLBsChipInputElement;
         "bs-citation-preview": HTMLBsCitationPreviewElement;
+        "bs-code-block": HTMLBsCodeBlockElement;
         "bs-command-palette": HTMLBsCommandPaletteElement;
         "bs-compact-menu-block": HTMLBsCompactMenuBlockElement;
         "bs-company-switcher": HTMLBsCompanySwitcherElement;
@@ -9547,14 +11084,19 @@ declare global {
         "bs-cookie-consent": HTMLBsCookieConsentElement;
         "bs-data-table": HTMLBsDataTableElement;
         "bs-datepicker": HTMLBsDatepickerElement;
+        "bs-description-item": HTMLBsDescriptionItemElement;
+        "bs-description-list": HTMLBsDescriptionListElement;
         "bs-dialog": HTMLBsDialogElement;
         "bs-divider": HTMLBsDividerElement;
+        "bs-dropdown": HTMLBsDropdownElement;
         "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-heading": HTMLBsHeadingElement;
+        "bs-icon": HTMLBsIconElement;
         "bs-icon-button": HTMLBsIconButtonElement;
         "bs-icon-tile": HTMLBsIconTileElement;
         "bs-inline-tab": HTMLBsInlineTabElement;
@@ -9562,6 +11104,7 @@ declare global {
         "bs-key": HTMLBsKeyElement;
         "bs-key-caps": HTMLBsKeyCapsElement;
         "bs-keyboard-shortcuts": HTMLBsKeyboardShortcutsElement;
+        "bs-link": HTMLBsLinkElement;
         "bs-list": HTMLBsListElement;
         "bs-list-item": HTMLBsListItemElement;
         "bs-logo": HTMLBsLogoElement;
@@ -9584,25 +11127,35 @@ declare global {
         "bs-progress-linear": HTMLBsProgressLinearElement;
         "bs-qr-code": HTMLBsQrCodeElement;
         "bs-radio": HTMLBsRadioElement;
+        "bs-radio-group": HTMLBsRadioGroupElement;
         "bs-ripple": HTMLBsRippleElement;
         "bs-search-item": HTMLBsSearchItemElement;
+        "bs-select": HTMLBsSelectElement;
         "bs-session-timeout": HTMLBsSessionTimeoutElement;
         "bs-shortcut-row": HTMLBsShortcutRowElement;
         "bs-side-panel": HTMLBsSidePanelElement;
         "bs-skeleton": HTMLBsSkeletonElement;
+        "bs-skip-link": HTMLBsSkipLinkElement;
         "bs-slider": HTMLBsSliderElement;
         "bs-snackbar": HTMLBsSnackbarElement;
         "bs-source-link": HTMLBsSourceLinkElement;
         "bs-spinner": HTMLBsSpinnerElement;
         "bs-split-pane": HTMLBsSplitPaneElement;
         "bs-stack": HTMLBsStackElement;
+        "bs-stat": HTMLBsStatElement;
         "bs-stepper": HTMLBsStepperElement;
         "bs-stepper-step": HTMLBsStepperStepElement;
         "bs-switch": HTMLBsSwitchElement;
         "bs-tab": HTMLBsTabElement;
+        "bs-table-of-contents": HTMLBsTableOfContentsElement;
         "bs-tabs": HTMLBsTabsElement;
+        "bs-tag": HTMLBsTagElement;
+        "bs-text": HTMLBsTextElement;
         "bs-timepicker": HTMLBsTimepickerElement;
         "bs-toast": HTMLBsToastElement;
+        "bs-toggle-button": HTMLBsToggleButtonElement;
+        "bs-toggle-button-group": HTMLBsToggleButtonGroupElement;
+        "bs-toolbar": HTMLBsToolbarElement;
         "bs-tooltip": HTMLBsTooltipElement;
         "bs-tooltip-trigger": HTMLBsTooltipTriggerElement;
         "bs-tree": HTMLBsTreeElement;
@@ -10351,6 +11904,10 @@ declare namespace LocalJSX {
           * @default 'Breadcrumb'
          */
         "label"?: string;
+        /**
+          * Fires when a crumb's link (or one in a `bs-breadcrumb-overflow` popup) is clicked, before the browser navigates. **Cancelable**: call `event.preventDefault()` to route it yourself. Detail is `{ href }`. This is the child's own event bubbling up; it is declared here (and never emitted from here) so the framework wrappers expose `onBsNavigate` / `(bsNavigate)` / `@bs-navigate` on `<bs-breadcrumbs>`. `event.target` is the crumb that was clicked.
+         */
+        "onBsNavigate"?: (event: BsBreadcrumbsCustomEvent<{ href: string }>) => void;
         /**
           * Size variant, propagated as a JS property to every slotted `bs-breadcrumb`/ `bs-breadcrumb-overflow` child -- this container has no visual sizing of its own (font/spacing live on the item components, see `bs-breadcrumb.tsx`'s identical `size` prop), so propagation is the only way setting `size` here reaches every crumb. CSS custom properties can't carry an enum that switches rules on their own, which is why this is pushed via JS property instead of CSS inheritance -- same reasoning as `bs-tabs` setting `selected` directly on its slotted `bs-tab`/`bs-inline-tab` children. Re-propagated on `size` changes and whenever the slotted children change (e.g. a crumb added later).
           * @default 'md'
@@ -10373,19 +11930,37 @@ declare namespace LocalJSX {
      * - `error` purely for visual emphasis — it signals a destructive action to the user, so reserve
      *   it for actions that actually delete/revoke/undo something.
      * @prop --bs-button-radius - Corner radius. Aliased to `--bs-border-radius-100` by default.
-     * @prop --bs-button-padding-x-sm - Left/right padding of a label-only button at `size="sm"`. Aliased to `--bs-spacing-300`.
+     * @prop --bs-button-padding-x-sm - Left/right padding of a label-only button at `size="sm"`. Aliased to `--bs-spacing-150` (12px).
+     * @prop --bs-button-padding-x-md - Left/right padding at `size="md"`. Aliased to `--bs-spacing-150` (12px).
+     * @prop --bs-button-padding-x-lg - Left/right padding at `size="lg"`. Aliased to `--bs-spacing-150` (12px).
      * @prop --bs-button-width - Width of the button. `auto` by default (fits its content); set `100%` for a full-width button, e.g. `bs-button { --bs-button-width: 100%; }`.
      * @prop --bs-button-subtle-color - Label/icon colour, `variant="subtle"`. Aliased to `--bs-color-neutral-default`; set it to `var(--bs-text-action)` for a blue text button.
-     * @prop --bs-button-height-sm - Height at `size="sm"`. Aliased to `--bs-spacing-500`.
-     * @prop --bs-button-height-md - Height at `size="md"`. Aliased to `--bs-spacing-600`.
-     * @prop --bs-button-height-lg - Height at `size="lg"`. Aliased to `--bs-spacing-700`.
+     * @prop --bs-button-height-sm - Height at `size="sm"`. Aliased to `--bs-spacing-400` (32px).
+     * @prop --bs-button-height-md - Height at `size="md"`. Aliased to `--bs-spacing-550` (44px).
+     * @prop --bs-button-height-lg - Height at `size="lg"`. Aliased to `--bs-spacing-600` (48px).
+     * @prop --bs-button-outlined-color - Label/icon colour, `variant="outlined"`, default. Aliased to `--bs-color-primary-default`.
      * @prop --bs-button-neutral-border - Border color, `variant="neutral"`, default/disabled. Aliased to `--bs-border-neutral-container`.
      * @prop --bs-button-neutral-border-hover - Border color, `variant="neutral"`, hover. Aliased to `--bs-border-neutral-container-hover`.
      * @prop --bs-button-neutral-border-pressed - Border color, `variant="neutral"`, pressed. Aliased to `--bs-border-neutral-container-pressed`.
-     * @prop --bs-button-padding-x-icon-side - Horizontal padding on an edge that's adjacent to a leading/trailing icon (tighter than the plain text-only edge). Aliased to `--bs-spacing-150`.
-     * @prop --bs-button-padding-x-label-side - Horizontal padding on the opposite edge, when an icon on the other side needs compensating extra space to keep the button optically balanced. Aliased to `--bs-spacing-250`.
+     * @prop --bs-button-padding-x-icon-side - Horizontal padding on an edge that's adjacent to a leading/trailing icon (now equal to the text-only edge). Aliased to `--bs-spacing-150`.
+     * @prop --bs-button-padding-x-label-side - Horizontal padding on the opposite edge, when an icon on the other side needs compensating extra space to keep the button optically balanced. Aliased to `--bs-spacing-150` (no compensation by default).
      */
     interface BsButton {
+        /**
+          * Forwarded to the inner `<button>` as `aria-controls`. Note an id only resolves inside this component's shadow tree, so it can't point at an element in the page's light DOM.
+          * @default null
+         */
+        "ariaControls"?: string | null;
+        /**
+          * Forwarded to the inner `<button>` as `aria-expanded`, for disclosure/menu buttons.
+          * @default null
+         */
+        "ariaExpanded"?: 'true' | 'false' | null;
+        /**
+          * Forwarded to the inner `<button>` as `aria-haspopup`.
+          * @default null
+         */
+        "ariaHasPopup"?: 'true' | 'false' | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog' | null;
         /**
           * Accessible name for the button. Required for icon-only usage (no visible label text via the default slot) so screen readers still announce what the button does. Stencil reflects this camelCase prop to the `aria-label` HTML attribute automatically.
           * @default null
@@ -10404,6 +11979,10 @@ declare namespace LocalJSX {
           * The name of the element, used when submitting an HTML form.
          */
         "name"?: string;
+        /**
+          * Makes this a toggle button: sets `aria-pressed` on the inner `<button>` to `true`/`false`. Leave it unset (the default) for a plain action button, which then has no `aria-pressed` at all. The component does not toggle itself; the owner flips this on click.
+         */
+        "pressed"?: boolean;
         /**
           * Sizing scale.
           * @default 'md'
@@ -10459,11 +12038,45 @@ declare namespace LocalJSX {
      * - For a dismissible/transient message — use a modal or a dedicated notification component.
      */
     interface BsCard {
+        /**
+          * Makes the whole card a link to this URL (a real `<a>`). Takes precedence over `selectable`.
+         */
+        "href"?: string;
+        /**
+          * Accessible name for the clickable card, used instead of the `header` slot text. Set it when there is no `header` content, or when the header text is not a good name on its own.
+         */
+        "label"?: string;
+        /**
+          * Fires when a `selectable` card is toggled by the user, with the new `selected` value.
+         */
+        "onBsChange"?: (event: BsCardCustomEvent<boolean>) => void;
+        /**
+          * Fires when a link card (`href`) is clicked, before the browser navigates. **Cancelable**: `preventDefault()` stops the navigation so you can route it yourself. Detail is `{ href }`. Modified clicks (ctrl/cmd/shift/alt, middle button) are left to the browser.
+         */
+        "onBsNavigate"?: (event: BsCardCustomEvent<{ href: string }>) => void;
+        /**
+          * Link `rel`, only used with `href`.
+         */
+        "rel"?: string;
+        /**
+          * Makes the whole card a toggle (a real `<button aria-pressed>`). Ignored when `href` is set.
+          * @default false
+         */
+        "selectable"?: boolean;
+        /**
+          * Whether a `selectable` card is selected. Mutable and reflected; toggled by the user.
+          * @default false
+         */
+        "selected"?: boolean;
         /**
           * Maps to the brandsync-tokens `--bs-paper-bg-*` set — Brandsync's tokens don't have a dedicated "card" component yet, so this reuses the existing Paper surface tokens.
           * @default 'raised'
          */
         "surface"?: BsCardSurface;
+        /**
+          * Link `target`, only used with `href`. With `_blank`, `rel` defaults to `noopener noreferrer`.
+         */
+        "target"?: string;
     }
     /**
      * A carousel that shows a page of slides at a time, with a tracker (dots or numbered blocks) and
@@ -10952,6 +12565,9 @@ declare namespace LocalJSX {
      * `--bs-color-primary-container-pressed`.
      * @prop --bs-chatbot-suggestion-button-bg-focus - Background when focused. Aliased to
      * `--bs-color-primary-container-hover` (same as hover).
+     * @prop --bs-chatbot-suggestion-button-bg-disabled - Background when disabled. Aliased to `--bs-surface-action-disabled`.
+     * @prop --bs-chatbot-suggestion-button-text-disabled - Text color when disabled. Aliased to `--bs-text-on-disabled`.
+     * @prop --bs-chatbot-suggestion-button-border-color-disabled - Border color when disabled. Aliased to `--bs-border-neutral-disabled`.
      * @prop --bs-chatbot-suggestion-button-text-default - Text color in the default state. Aliased to
      * `--bs-text-action`.
      * @prop --bs-chatbot-suggestion-button-text-hover - Text color on hover, pressed, and focus.
@@ -11035,6 +12651,49 @@ declare namespace LocalJSX {
          */
         "value"?: string;
     }
+    /**
+     * A labelled group of `bs-checkbox`es: a `<fieldset>` with a `<legend>`, helper or error text, and
+     * a single `value` array of the checked boxes' values.
+     * Composed from: `bs-checkbox` (slotted by you).
+     * ## When to use
+     * - A set of related, independent options where any number may be chosen ("Notify me by ...").
+     * ## When not to use
+     * - Exactly one choice: use `bs-radio-group`.
+     * - A single yes/no: use one `bs-checkbox`, or `bs-switch` for an immediate setting.
+     */
+    interface BsCheckboxGroup {
+        /**
+          * Helper text under the options. Replaced by `error` while that is set.
+         */
+        "description"?: string;
+        /**
+          * Error message. Sets `aria-invalid`, replaces the helper text, and puts every checkbox in its error style.
+         */
+        "error"?: string;
+        /**
+          * Legend: the visible group label, also its accessible name.
+         */
+        "label"?: string;
+        /**
+          * Emitted with the new array of checked `value`s when the user toggles a checkbox. Replaces the checkboxes' own `bsChange`, which does not reach listeners outside the group.
+         */
+        "onBsChange"?: (event: BsCheckboxGroupCustomEvent<string[]>) => void;
+        /**
+          * Layout of the checkboxes.
+          * @default 'vertical'
+         */
+        "orientation"?: BsCheckboxGroupOrientation;
+        /**
+          * Marks the group as required: shows an asterisk after the label and sets `aria-required`.
+          * @default false
+         */
+        "required"?: boolean;
+        /**
+          * `value`s of the checked checkboxes. An array, so set it as a JS property, not an attribute. Setting it checks the matching boxes and unchecks the rest.
+          * @default []
+         */
+        "value"?: string[];
+    }
     /**
      * A shape-matched loading placeholder for `bs-checkbox`, shown while the real label text isn't
      * known yet (e.g. still being fetched from an API). Renders a small square (matching the
@@ -11222,6 +12881,75 @@ declare namespace LocalJSX {
          */
         "sourceName"?: string;
     }
+    /**
+     * A block of code with an optional filename header and a Copy button, or (with `inline`) styled
+     * inline code. Dependency-free: it does no syntax highlighting itself. Pass plain text with `code`,
+     * or slot pre-highlighted markup (e.g. the output of Shiki or Prism: spans coloured with your own
+     * CSS) as the default slot.
+     * Follows light and dark mode through the surface/text tokens. Long lines scroll horizontally (the
+     * scroll area is keyboard focusable) or, with `wrap`, break onto the next line.
+     * Copying announces the `copiedLabel` text through a polite live region, and the button label
+     * changes to match for a few seconds.
+     * Slotted content: keep it flush against the tags (`<bs-code-block><span>..</span></bs-code-block>`),
+     * since whitespace in a `<pre>`-style block is kept. The line count for `lineNumbers` and the text
+     * that is copied are read from the slotted text.
+     * Composed from: `bs-card` (the surface), `bs-button` and `bs-icon` (the Copy button).
+     * ## When to use
+     * - Showing a snippet, command or config the reader may want to copy.
+     * - `inline` for a short code term inside a sentence.
+     * ## When not to use
+     * - Long files that need folding, search or editing: link to the source instead.
+     * - Pre-formatted prose or tables: use ordinary text and table markup.
+     */
+    interface BsCodeBlock {
+        /**
+          * Plain-text code. When set it is shown (escaped) instead of the default slot, and is what Copy copies.
+         */
+        "code"?: string;
+        /**
+          * Label of the Copy button after copying, and the text announced to assistive tech.
+          * @default 'Copied'
+         */
+        "copiedLabel"?: string;
+        /**
+          * Label of the Copy button.
+          * @default 'Copy'
+         */
+        "copyLabel"?: string;
+        /**
+          * Name shown at the left of the header, e.g. `app.config.ts` or `Terminal`. Also names the code region for assistive tech.
+         */
+        "filename"?: string;
+        /**
+          * Remove the Copy button.
+          * @default false
+         */
+        "hideCopy"?: boolean;
+        /**
+          * Render as inline code (a styled `<code>` inside a sentence): no header, no Copy button, no scrolling.
+          * @default false
+         */
+        "inline"?: boolean;
+        /**
+          * Show a line number gutter. Line numbers need unwrapped lines, so `wrap` is ignored while this is set.
+          * @default false
+         */
+        "lineNumbers"?: boolean;
+        /**
+          * Emitted with the copied text after it was written to the clipboard.
+         */
+        "onBsCopy"?: (event: BsCodeBlockCustomEvent<string>) => void;
+        /**
+          * Accessible name of the code region when there is no `filename`.
+          * @default 'Code'
+         */
+        "regionLabel"?: string;
+        /**
+          * Wrap long lines instead of scrolling horizontally.
+          * @default false
+         */
+        "wrap"?: boolean;
+    }
     /**
      * 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
@@ -11967,6 +13695,12 @@ declare namespace LocalJSX {
      * ## When not to use
      * - A handful of unrelated key/value pairs — a simple list or card is lighter-weight.
      * - Deeply nested/hierarchical data — this component renders one flat row per record.
+     * ## Rich cells
+     * Without a `cellRenderer`, each cell is a named slot, `cell-{row.id}-{column.key}`, whose fallback
+     * content is the plain-text value. Slot an element into it to put app-owned content (a framework
+     * component, a router link, a badge) in the cell, e.g.
+     * `<a slot="cell-7-name" href="/people/7">Ada</a>`. The slotted element lives in the light DOM, so
+     * it keeps your framework, router and CSP; nothing is parsed as HTML.
      */
     interface BsDataTable {
         /**
@@ -11999,6 +13733,11 @@ declare namespace LocalJSX {
           * @default 'asc'
          */
         "sortDirection"?: 'asc' | 'desc';
+        /**
+          * Alternates the row background (even rows use `--bs-data-table-stripe-bg`) so wide tables are easier to scan. Follows dark mode through the token. Row hover still wins.
+          * @default false
+         */
+        "striped"?: boolean;
     }
     /**
      * An inline calendar for picking a single date, or a start/end date range. Matches the Figma
@@ -12106,6 +13845,68 @@ declare namespace LocalJSX {
          */
         "yearLabel"?: string;
     }
+    /**
+     * One term and its detail inside a `bs-description-list` (a label/value pair such as "Owner: Sam Lee").
+     * ## When to use
+     * - As a child of `bs-description-list`, one per key/value pair.
+     * ## When not to use
+     * - Rows of records with media and actions -- use `bs-list-item`.
+     * - Many pairs compared across several records -- use `bs-data-table`.
+     * Each item renders its own `<dl>` containing one `<div>` group with a real `<dt>` and `<dd>`. (A `dl` cannot
+     * span the shadow boundary between a list and its items, so the grouping lives here.)
+     * @prop --bs-description-item-gap - Gap between term and detail when stacked. Aliased to `--bs-spacing-25`.
+     * @prop --bs-description-item-term-width - Width of the term column when `layout="horizontal"`. `12rem`.
+     * @prop --bs-description-item-column-gap - Gap between the term and detail columns when horizontal. Aliased to `--bs-spacing-200`.
+     * @prop --bs-description-item-padding-y - Vertical padding. Aliased to `--bs-spacing-100`.
+     * @prop --bs-description-item-term-color - Aliased to `--bs-text-secondary`.
+     * @prop --bs-description-item-description-color - Aliased to `--bs-text-default`.
+     */
+    interface BsDescriptionItem {
+        /**
+          * The detail (value). The default slot overrides it.
+         */
+        "description"?: string;
+        /**
+          * Set by the parent `bs-description-list`: `stacked` (term above detail) or `horizontal` (side by side).
+          * @default 'stacked'
+         */
+        "layout"?: 'stacked' | 'horizontal';
+        /**
+          * The term (label).
+         */
+        "term"?: string;
+    }
+    /**
+     * A key/value list of `bs-description-item` pairs (term and detail), for record summaries, settings read-outs
+     * and metadata panels. Terms and details use real `dt`/`dd` semantics.
+     * ## When to use
+     * - A read-only summary of one record: "Owner", "Created", "Status" with their values.
+     * ## When not to use
+     * - A list of records with media and actions -- use `bs-list`.
+     * - Editable fields -- use form components.
+     * - Several records compared across columns -- use `bs-data-table`.
+     * Built from `bs-description-item` children (light DOM; the list never moves nodes). Each item holds its own
+     * `dl`; the list sets the layout on them and draws dividers.
+     * @prop --bs-description-list-divider-color - Divider colour when `dividers` is set. Aliased to `--bs-border-neutral-container`.
+     * @prop --bs-description-list-gap - Gap between items. `0`.
+     */
+    interface BsDescriptionList {
+        /**
+          * Accessible name of the group.
+          * @default null
+         */
+        "ariaLabel"?: string | null;
+        /**
+          * Draws a 1px separator between items.
+          * @default false
+         */
+        "dividers"?: boolean;
+        /**
+          * `stacked` puts each term above its detail; `horizontal` puts them side by side in two columns.
+          * @default 'stacked'
+         */
+        "layout"?: 'stacked' | 'horizontal';
+    }
     /**
      * An overlay dialog that interrupts the current flow for a focused task or confirmation.
      * Closes itself on backdrop click, Escape, or its own close button, and emits `bsClose`.
@@ -12179,6 +13980,41 @@ declare namespace LocalJSX {
          */
         "variant"?: BsDividerVariant;
     }
+    /**
+     * A menu trigger: a button (slot `trigger`) that opens a `bs-menu` of `bs-menu-item`s in an anchored,
+     * viewport-aware popup, with the menu keyboard pattern and focus management built in.
+     * Opens on click, Enter, Space (via the trigger button) and ArrowDown. On open focus moves to the
+     * first enabled menu item; Up/Down/Home/End move between items (handled by `bs-menu`). The dropdown
+     * closes on outside click, Escape (focus returns to the trigger), Tab, and after an item is activated.
+     * The trigger gets `aria-haspopup="menu"` and `aria-expanded` kept in sync.
+     * Composed from `bs-popover` (anchor positioning, flipping, outside-click and Escape dismissal, open
+     * motion), `bs-menu` and `bs-menu-item` (slotted by you), and a `bs-button` / `bs-icon-button` trigger.
+     * ## When to use
+     * - A header or toolbar action that reveals a short list of commands ("More", "Account", "Sort by").
+     * ## When not to use
+     * - Free-form popup content such as forms or arbitrary panels (use `bs-popover`).
+     * - Choosing a value for a form field (use `bs-select`).
+     */
+    interface BsDropdown {
+        /**
+          * Emitted after the menu closes (outside click, Escape, Tab, item activation or `open = false`).
+         */
+        "onBsClose"?: (event: BsDropdownCustomEvent<void>) => void;
+        /**
+          * Emitted after the menu opens.
+         */
+        "onBsOpen"?: (event: BsDropdownCustomEvent<void>) => void;
+        /**
+          * Whether the menu is shown.
+          * @default false
+         */
+        "open"?: boolean;
+        /**
+          * Where the menu sits relative to the trigger; flips to stay in the viewport.
+          * @default 'bottom-start'
+         */
+        "placement"?: BsDropdownPlacement;
+    }
     /**
      * 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.
@@ -12193,6 +14029,7 @@ declare namespace LocalJSX {
      * @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-size - Aliased to `--bs-font-size-xl` (`--bs-font-size-3xl` at `size="page"`).
      * @prop --bs-empty-state-heading-color - Aliased to `--bs-text-default`.
      * @prop --bs-empty-state-description-color - Aliased to `--bs-text-secondary`.
      */
@@ -12215,6 +14052,11 @@ declare namespace LocalJSX {
           * @default 'default'
          */
         "intent"?: BsIconTileIntent;
+        /**
+          * `panel` (default) fits inside a card, table or section. `page` fills a whole view: more padding, a larger heading and a minimum height.
+          * @default 'panel'
+         */
+        "size"?: 'panel' | 'page';
     }
     /**
      * A full-block page for when the user can't get to what they asked for: page not found (404), a server
@@ -12629,6 +14471,74 @@ declare namespace LocalJSX {
          */
         "rowGap"?: string;
     }
+    /**
+     * A heading whose rendered element and visual style are chosen separately: `level` (or `as`) picks
+     * the element for the document outline, `size` picks the look. Sizes map to the typography tokens
+     * (`--bs-font-size-*`, `--bs-font-weight-*`, `--bs-line-height-*`, `--bs-typography-font-family-heading`).
+     * Default sizes by level: 1 = 40px, 2 = 32px, 3 = 24px, 4 = 20px, 5 = 18px, 6 = 16px; `display` is 48px.
+     * Composed from: nothing (leaf).
+     * ## When to use
+     * - Any page or section title. Keep levels in order (no jumping from 1 to 4); change `size`, not `level`, to restyle.
+     * ## When not to use
+     * - Body copy, captions and labels: use `bs-text`.
+     * - To make text big without it being a heading: use `bs-text` with `as="p"`.
+     */
+    interface BsHeading {
+        /**
+          * Overrides the rendered element, e.g. `as="p"` for a heading-looking line that is not part of the outline. When set, `level` only drives the default size.
+         */
+        "as"?: BsHeadingAs;
+        /**
+          * Heading level 1-6: chooses the element (`h1`-`h6`) and, unless `size` is set, the visual size.
+          * @default 2
+         */
+        "level"?: BsHeadingLevel;
+        /**
+          * Visual size, independent of the element: `display` or `1`-`6` (the default sizes of levels 1-6). Defaults to `level`.
+         */
+        "size"?: BsHeadingSize;
+        /**
+          * Text colour from the text tokens. `inherit` uses the surrounding colour.
+          * @default 'default'
+         */
+        "tone"?: BsHeadingTone;
+    }
+    /**
+     * A sized, coloured icon. Renders inline SVG from a named registry (`name`), or any SVG you slot in.
+     * Built-in names: `menu`, `arrow-right`, `arrow-left`, `check`, `close`, `chevron-down`,
+     * `external-link`, `copy`, `search`, plus Phosphor glyphs `user`, `star`, `star-fill`, `x`,
+     * `paper-plane-right`, `note-pencil`, `clock-counter-clockwise`, `arrows-out-simple` (256x256 filled). Add more with `registerIcons({ name: '<path d="..."/>' })`
+     * (exported from the package entry): each value is the inner markup of a 24x24, `currentColor`
+     * stroke icon, or pass `{ viewBox, body }` for a filled glyph on another grid.
+     * Decorative by default (`aria-hidden`). Set `label` when the icon alone conveys meaning; it is then
+     * exposed as an image with that name. An icon inside a button never needs `label`: name the button.
+     * Composed from: nothing (leaf). Used by `bs-code-block`.
+     * ## When to use
+     * - A glyph beside text or inside a button, sized and coloured from tokens.
+     * ## When not to use
+     * - As a control by itself: wrap it in `bs-icon-button`.
+     * - For a tinted status square: use `bs-icon-tile`.
+     */
+    interface BsIcon {
+        /**
+          * Accessible name. When set the icon is exposed as an image with this name; when empty it is decorative and hidden from assistive tech.
+         */
+        "label"?: string;
+        /**
+          * Registered icon name (see the component description for the built-in set).
+         */
+        "name"?: string;
+        /**
+          * Size: `xs` 12px, `sm` 16px, `md` 24px, `lg` 32px, `xl` 48px.
+          * @default 'md'
+         */
+        "size"?: BsIconSize;
+        /**
+          * Colour from the icon tokens. `inherit` uses the surrounding text colour (`currentColor`).
+          * @default 'default'
+         */
+        "tone"?: BsIconTone;
+    }
     /**
      * A clickable, icon-only action element -- the icon-only sibling of `bs-button`, sharing the same
      * 8 visual variants and color language, but ALWAYS rendering just a single icon, never a label.
@@ -12648,6 +14558,21 @@ declare namespace LocalJSX {
      * accessible name.
      */
     interface BsIconButton {
+        /**
+          * Forwarded to the inner `<button>` as `aria-controls`. Note an id only resolves inside this component's shadow tree, so it can't point at an element in the page's light DOM.
+          * @default null
+         */
+        "ariaControls"?: string | null;
+        /**
+          * Forwarded to the inner `<button>` as `aria-expanded`, for disclosure/menu buttons.
+          * @default null
+         */
+        "ariaExpanded"?: 'true' | 'false' | null;
+        /**
+          * Forwarded to the inner `<button>` as `aria-haspopup`.
+          * @default null
+         */
+        "ariaHasPopup"?: 'true' | 'false' | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog' | null;
         /**
           * Accessible name for the button. Required -- this component is always icon-only, so there's no visible label text for screen readers to fall back on. Stencil reflects this camelCase prop to the `aria-label` HTML attribute automatically.
           * @default null
@@ -12772,7 +14697,9 @@ declare namespace LocalJSX {
      * range of related "field" shapes (number stepper, password reveal, date, dropdown trigger,
      * select, textarea, chip input, initials, country, and pin) via the `type` prop, since they all
      * share the same label/description/error/icon-slot chrome.
-     * Built from: `bs-menu`/`bs-menu-item` (`type="dropdown"`) and `bs-chip-informative` + `bs-icon-button` (`type="chip"`).
+     * Built from: `bs-menu`/`bs-menu-item` (`type="dropdown"`), `bs-chip-informative` + `bs-icon-button` (`type="chip"`),
+     * and `bs-icon-button` + `bs-spinner` (`type="combobox"` clear button / loading indicator; its listbox is a
+     * hand-built `role="listbox"` because `bs-menu` is `role="menu"` and cannot host `option`s).
      * ## When to use
      * - Collecting a single line of free-text, email, password, or numeric input.
      * - Any of the other supported `type`s (search, date, dropdown, select, textarea, chip, initials,
@@ -12785,16 +14712,31 @@ declare namespace LocalJSX {
      *   options list at all (freeform chip entry).
      */
     interface BsInput {
+        /**
+          * Accessible name for the control, used only when no visible `label` is set (e.g. a search field with no visible label). Passed to the inner native control, because an `aria-label` on the `<bs-input>` host cannot name an element inside its shadow root.
+          * @default null
+         */
+        "ariaLabel"?: string | null;
         /**
           * Current chips for `type="chip"`. Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
           * @default []
          */
         "chips"?: string[];
+        /**
+          * `type="combobox"`: accessible name of the clear button.
+          * @default 'Clear'
+         */
+        "clearLabel"?: string;
         /**
           * Current selected country code for `type="country"`.
           * @default ''
          */
         "country"?: string;
+        /**
+          * `type="country"`: accessible name of the country picker (its visible content is just the flag).
+          * @default 'Country'
+         */
+        "countryLabel"?: string;
         /**
           * Country select options for `type="country"`. Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
           * @default []
@@ -12811,6 +14753,11 @@ declare namespace LocalJSX {
          */
         "disabled"?: boolean;
         "error"?: string;
+        /**
+          * `type="combobox"`: when true (default) `options` are filtered client-side by whether the label contains the typed text. Set false when you supply already-filtered results yourself (e.g. from a server) in response to `bsInput`.
+          * @default true
+         */
+        "filterOptions"?: boolean;
         /**
           * The `id` of a `<form>` element to associate this element with.
          */
@@ -12836,6 +14783,16 @@ declare namespace LocalJSX {
           * @default 4
          */
         "length"?: number;
+        /**
+          * `type="combobox"`: shows a loading indicator and, while no options match, a loading message in the popup instead of "no results". Use while fetching `options` asynchronously.
+          * @default false
+         */
+        "loading"?: boolean;
+        /**
+          * `type="combobox"`: text of the popup row shown while `loading` and nothing matches.
+          * @default 'Loading...'
+         */
+        "loadingLabel"?: string;
         /**
           * Maximum value for `type="number"`'s stepper buttons.
          */
@@ -12848,17 +14805,19 @@ declare namespace LocalJSX {
           * The `name` the value is submitted under in a surrounding `<form>`'s `FormData`.
          */
         "name"?: string;
-        "onBsChange"?: (event: BsInputCustomEvent<string>) => void;
         /**
-          * Emitted when a chip is committed (Enter pressed in the draft input) for `type="chip"`.
+          * `type="combobox"`: text of the popup row shown when no option matches.
+          * @default 'No results'
          */
+        "noResultsLabel"?: string;
+        "onBsChange"?: (event: BsInputCustomEvent<string>) => void;
         "onBsChipAdd"?: (event: BsInputCustomEvent<string>) => void;
         /**
           * Emitted when a chip's remove button is clicked for `type="chip"`.
          */
         "onBsChipRemove"?: (event: BsInputCustomEvent<string>) => void;
         /**
-          * Emitted when the country `<select>` changes for `type="country"`.
+          * Emitted when a country is chosen from the picker for `type="country"`.
          */
         "onBsCountryChange"?: (event: BsInputCustomEvent<string>) => void;
         "onBsInput"?: (event: BsInputCustomEvent<string>) => void;
@@ -12867,16 +14826,25 @@ declare namespace LocalJSX {
          */
         "onBsOpen"?: (event: BsInputCustomEvent<boolean>) => void;
         /**
-          * Emitted when the title `<select>` changes for `type="initials"`.
+          * Emitted when an option is chosen for `type="combobox"` (click or Enter), with the option's `{ label, value }`. `value` of the component itself becomes the option's label (the text shown).
+         */
+        "onBsOptionSelect"?: (event: BsInputCustomEvent<{ label: string; value: string }>) => void;
+        /**
+          * Emitted when a title is chosen from the picker for `type="initials"`.
          */
         "onBsTitleChange"?: (event: BsInputCustomEvent<string>) => void;
         /**
-          * Whether the `type="dropdown"` trigger is open. Reflects to an attribute so consumers can style an open state via CSS. When `options` is non-empty, this also controls whether the `bs-menu` of `bs-menu-item`s is rendered below the field.
+          * Whether the `type="dropdown"` / `type="combobox"` popup is open. Reflects to an attribute so consumers can style an open state via CSS. When `options` is non-empty, this also controls whether the `bs-menu` of `bs-menu-item`s is rendered below the field.
           * @default false
          */
         "open"?: boolean;
         /**
-          * Options for `type="select"` (rendered as native `<option>`s) and `type="dropdown"` (rendered as a `bs-menu` of `bs-menu-item`s when `open`). Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
+          * `type="date"`: accessible name of the default calendar button that opens the native picker.
+          * @default 'Open date picker'
+         */
+        "openPickerLabel"?: string;
+        /**
+          * Options for `type="select"` (rendered as `role="option"` rows of an in-shadow listbox) and `type="dropdown"` (rendered as a `bs-menu` of `bs-menu-item`s when `open`). Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
           * @default []
          */
         "options"?: { label: string; value: string }[];
@@ -12901,6 +14869,11 @@ declare namespace LocalJSX {
           * @default 1
          */
         "step"?: number;
+        /**
+          * `type="initials"`: accessible name of the title picker (its visible text is just the title).
+          * @default 'Title'
+         */
+        "titleLabel"?: string;
         /**
           * Title select options for `type="initials"` (e.g. `['Mrs.', 'Mr.', 'Dr.']`). Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
           * @default []
@@ -12921,7 +14894,8 @@ declare namespace LocalJSX {
     | 'chip'
     | 'initials'
     | 'country'
-    | 'pin';
+    | 'pin'
+    | 'combobox';
         /**
           * Current value. Native `input`/`change` events don't cross the Shadow DOM boundary, so this component re-dispatches them as `bsInput`/`bsChange` custom events instead. Mutable so the `number` type's stepper buttons can update it directly.
           * @default ''
@@ -13085,6 +15059,60 @@ declare namespace LocalJSX {
          */
         "singleKeyLabel"?: string;
     }
+    /**
+     * A navigation link: either text (inline within a sentence, or standalone with a 44px target) or a
+     * link styled as a primary button. Always renders a real `<a href>`.
+     * Built from: hand-built `<a>` (leaf). `bs-button` renders a `<button>` and has no `href`; nesting a
+     * button in an anchor is invalid HTML, so the `button` variant reuses the primary button's colour
+     * tokens instead. Known gap: add `href` support to `bs-button` and compose it here.
+     * ## When to use
+     * - Navigating to another page or an external resource.
+     * ## When not to use
+     * - Triggering an action on the current page (use `bs-button`).
+     */
+    interface BsLink {
+        /**
+          * Accessible name override (needed on the host, as `aria-label` does not cross the shadow boundary).
+          * @default null
+         */
+        "ariaLabel"?: string | null;
+        /**
+          * Marks the link as the current page (`aria-current="page"`).
+          * @default false
+         */
+        "current"?: boolean;
+        /**
+          * Shows the external-link icon (always shown for `target="_blank"`).
+          * @default false
+         */
+        "external"?: boolean;
+        /**
+          * Visually hidden suffix announced for links that open in a new tab.
+          * @default '(opens in a new tab)'
+         */
+        "externalLabel"?: string;
+        /**
+          * Destination.
+         */
+        "href"?: string;
+        /**
+          * Fires on a plain primary click before the browser navigates. **Cancelable**: call `preventDefault()` to route it yourself (SPA router). Detail is `{ href }`. Ctrl/cmd/shift/alt and middle clicks are left to the browser. Bubbles and is composed.
+         */
+        "onBsNavigate"?: (event: BsLinkCustomEvent<{ href: string }>) => void;
+        /**
+          * Link relationship. Defaults to `noopener noreferrer` when `target="_blank"`.
+         */
+        "rel"?: string;
+        /**
+          * Browsing context (e.g. `_blank`). `_blank` implies the external icon.
+         */
+        "target"?: string;
+        /**
+          * `inline` sits in running text; `standalone` has a 44px minimum touch target; `button` is styled as a primary button (also 44px).
+          * @default 'inline'
+         */
+        "variant"?: BsLinkVariant;
+    }
     /**
      * A vertical list of `bs-list-item` rows, optionally single-select.
      * ## When to use
@@ -13094,6 +15122,9 @@ declare namespace LocalJSX {
      * - A popup list of actions -- use `bs-menu`.
      * - Navigation between app sections -- use `bs-navigation-drawer`.
      * - Multi-column, sortable or paged data -- use `bs-data-table`.
+     * `variant` switches between a plain list, a bulleted list and a numbered list; `dividers` gives a divided
+     * list. The list keeps real list semantics in every variant (`role="list"` with `listitem` rows); the bullet
+     * or number is drawn by the row and hidden from assistive technology, which announces position itself.
      * Built from `bs-list-item` children (light DOM; the list never moves nodes).
      * @prop --bs-list-gap - Gap between rows. Defaults to `0`.
      * @prop --bs-list-divider-color - Divider colour when `dividers` is set. Aliased to `--bs-border-neutral-container`.
@@ -13123,6 +15154,11 @@ declare namespace LocalJSX {
           * @default null
          */
         "value"?: string | null;
+        /**
+          * `plain` (default), `bulleted` (a bullet before each row) or `numbered` (1., 2., 3., ...). Ignored when `selectable`.
+          * @default 'plain'
+         */
+        "variant"?: 'plain' | 'bulleted' | 'numbered';
     }
     /**
      * A single row of a list: optional leading media (avatar, icon, image), a label, a description and
@@ -13182,6 +15218,11 @@ declare namespace LocalJSX {
           * @default null
          */
         "label"?: string | null;
+        /**
+          * Set by the parent `bs-list` for `bulleted` / `numbered` variants: the visual marker. Hidden from assistive technology. Do not set by hand.
+          * @default null
+         */
+        "marker"?: string | null;
         /**
           * Fires on click / Enter / Space when the row is interactive and not disabled. Payload is `value`.
          */
@@ -13668,13 +15709,17 @@ declare namespace LocalJSX {
           * @default false
          */
         "expanded"?: boolean;
+        /**
+          * Makes a leaf item a real link: renders an `<a part="item" href>` instead of the `<button>`, so open-in-new-tab, copy link address, middle-click and the status-bar URL work. Ignored when `expandable` (groups stay buttons). `bsSelect` still fires on a plain click and is **cancelable**: call `event.preventDefault()` to stop the navigation and route it yourself (an SPA router). Ctrl/cmd/shift/alt-clicks and middle-clicks are left to the browser and do not emit `bsSelect`.
+         */
+        "href"?: string;
         /**
           * Marks this as a child row nested under an `expandable` parent (via `slot="children"`) -- deepens the left indent and stops reserving `icon` slot space entirely (Figma's nested rows never have icons).
           * @default false
          */
         "nested"?: boolean;
         /**
-          * Fires on click, only when `expandable` is false. See the class doc above.
+          * Fires on click, only when `expandable` is false. Cancelable when `href` is set (see `href`). See the class doc above.
          */
         "onBsSelect"?: (event: BsNavigationDrawerItemCustomEvent<void>) => void;
         /**
@@ -13686,6 +15731,10 @@ declare namespace LocalJSX {
           * @default false
          */
         "selected"?: boolean;
+        /**
+          * `target` of the link, when `href` is set.
+         */
+        "target"?: string;
     }
     /**
      * The top-level navigation bar for a page: the BrandSync logo plus two consumer-provided slots
@@ -14433,6 +16482,11 @@ declare namespace LocalJSX {
      * - An on/off setting that takes effect immediately (no explicit form submission) -- use `bs-switch`.
      */
     interface BsRadio {
+        /**
+          * Accessible name for the radio, set as `aria-label` on the native input. Use it when the radio has no slotted label text (an icon-only choice) or its visible label lives elsewhere. Same as `bs-checkbox` / `bs-switch`.
+          * @default null
+         */
+        "ariaLabel"?: string | null;
         /**
           * Whether the radio is checked. Mutable so clicking the label/input sets it directly.
           * @default false
@@ -14460,6 +16514,61 @@ declare namespace LocalJSX {
          */
         "value"?: string;
     }
+    /**
+     * A labelled group of `bs-radio`s: a visible label, helper or error text, an accessible
+     * `role="radiogroup"`, and a single `value` for the whole set.
+     * The group gives its radios one shared `name` (its own `name`, or a generated one) so they behave
+     * as one native-style group: arrow keys move the selection (wrapping), only the checked radio is in
+     * the tab order, and checking one unchecks the others. It keeps at most one radio checked (the
+     * first one wins if several start checked).
+     * Composed from: `bs-radio` (slotted by you).
+     * ## When to use
+     * - A set of 2-5 mutually exclusive options that should all stay visible, with a shared label.
+     * ## When not to use
+     * - Independent yes/no choices: use `bs-checkbox-group`.
+     * - Many options: use a select or `bs-menu`.
+     */
+    interface BsRadioGroup {
+        /**
+          * Helper text under the options. Replaced by `error` while that is set.
+         */
+        "description"?: string;
+        /**
+          * Error message. Sets `aria-invalid`, replaces the helper text and is announced with the group.
+         */
+        "error"?: string;
+        /**
+          * Visible group label, also the accessible name of the group.
+         */
+        "label"?: string;
+        /**
+          * `name` given to every radio in the group. Defaults to a generated, unique name.
+         */
+        "name"?: string;
+        /**
+          * Emitted with the new `value` when the user checks a radio. Replaces the radios' own `bsChange`, which does not reach listeners outside the group.
+         */
+        "onBsChange"?: (event: BsRadioGroupCustomEvent<string>) => void;
+        /**
+          * Layout of the radios.
+          * @default 'vertical'
+         */
+        "orientation"?: BsRadioGroupOrientation;
+        /**
+          * Marks the group as required: sets `aria-required` and shows an asterisk after the label.
+          * @default false
+         */
+        "required"?: boolean;
+        /**
+          * Check the first enabled radio when none is checked, so a choice is always made. Off by default so a form can start empty.
+          * @default false
+         */
+        "selectFirst"?: boolean;
+        /**
+          * `value` of the checked radio. Setting it checks the matching radio (and unchecks the rest).
+         */
+        "value"?: string;
+    }
     /**
      * A touch-ripple effect: on pointer press, a circle grows from the press point and fades out.
      * It is a building block for pressable components (`bs-button`, `bs-icon-button`, ...), not something
@@ -14549,6 +16658,82 @@ declare namespace LocalJSX {
          */
         "value"?: string;
     }
+    /**
+     * A single-choice select: a field-shaped combobox that opens a scrollable listbox of options. Same
+     * label / helper text / error chrome as `bs-input`.
+     * Follows the WAI-ARIA select-only combobox pattern: focus stays on the combobox and the
+     * highlighted option is exposed through `aria-activedescendant`.
+     * Built from: the field/label/description/error styling language of `bs-input` (same `--bs-input-*`
+     * tokens). The listbox rows are hand-built leaf elements: `bs-menu-item` is a `role="menuitem"`
+     * button and `bs-popover` moves focus into its popup, neither of which fits the combobox/listbox
+     * pattern where focus must stay on the field.
+     * ## When to use
+     * - Choosing exactly one value from a known list of roughly 4-15 options.
+     * ## When not to use
+     * - 2-3 options that should all be visible (use radios or `bs-toggle-button-group`).
+     * - Very long or searchable lists (use `bs-input type="dropdown"` or a search pattern).
+     */
+    interface BsSelect {
+        /**
+          * Accessible name when there is no visible `label`.
+          * @default null
+         */
+        "ariaLabel"?: string | null;
+        /**
+          * Helper text below the field (replaced by `error` when set).
+         */
+        "description"?: string;
+        /**
+          * Disables the select.
+          * @default false
+         */
+        "disabled"?: boolean;
+        /**
+          * Error message; puts the field in its error state.
+         */
+        "error"?: string;
+        /**
+          * The `id` of a `<form>` element to associate this element with.
+         */
+        "form"?: string;
+        /**
+          * Visible label.
+         */
+        "label"?: string;
+        /**
+          * Name the value is submitted under in a surrounding `<form>`.
+         */
+        "name"?: string;
+        /**
+          * Emitted when the user picks an option, with the new value.
+         */
+        "onBsChange"?: (event: BsSelectCustomEvent<string>) => void;
+        /**
+          * Whether the listbox is open.
+          * @default false
+         */
+        "open"?: boolean;
+        /**
+          * The options. Must be set as a JS property, not an attribute.
+          * @default []
+         */
+        "options"?: BsSelectOption[];
+        /**
+          * Text shown while no option is selected.
+          * @default 'Select'
+         */
+        "placeholder"?: string;
+        /**
+          * Marks the field required (native form validation + asterisk).
+          * @default false
+         */
+        "required"?: boolean;
+        /**
+          * The selected option's `value`.
+          * @default ''
+         */
+        "value"?: string;
+    }
     /**
      * The three moments around an expiring session, as one card. Matches the Figma "Session timeout"
      * component's three types:
@@ -14831,6 +17016,32 @@ declare namespace LocalJSX {
          */
         "width"?: string;
     }
+    /**
+     * A "skip to main content" link: invisible until it receives keyboard focus, then shown at the top
+     * of the page. Activating it moves focus to the element its `href` points at, so keyboard and
+     * screen-reader users can bypass repeated navigation (WCAG 2.4.1 Bypass Blocks).
+     * Place it as the very first focusable element on the page. Renders a real `<a>`; the focus move is
+     * done explicitly (the target gets a temporary `tabindex="-1"` when it is not natively focusable),
+     * because a fragment navigation alone does not reliably move focus in every browser.
+     * ## When to use
+     * - Once per page, before the header/navigation, pointing at the `<main>` landmark.
+     * - Additionally before large repeated blocks (e.g. a long sidebar) pointing past them.
+     * ## When not to use
+     * - As a general in-page link -- use a plain link or `bs-table-of-contents`.
+     * - When the page has no repeated blocks before its main content.
+     * Composition: a leaf element (a single anchor); no existing `bs-*` component renders a link.
+     */
+    interface BsSkipLink {
+        /**
+          * Target to skip to: a fragment (`#main-content`) naming an element id in the same document or shadow tree, or any URL (then the browser just navigates). Point it at an element that exists -- if the id is not found, activating the link does nothing beyond the native fragment jump.
+          * @default '#main-content'
+         */
+        "href"?: string;
+        /**
+          * Fires when the link is activated, before focus moves. **Cancelable**: `preventDefault()` stops both the focus move and the native navigation so you can handle it yourself. Detail is `{ href, target }` (`target` is the resolved element or `null`). Bubbles and is composed.
+         */
+        "onBsSkip"?: (event: BsSkipLinkCustomEvent<{ href: string; target: HTMLElement | null }>) => void;
+    }
     /**
      * A slider for picking a single numeric value (`type="default"`), a value snapped to evenly
      * spaced ticks (`type="segmented"`), or a min/max pair (`type="range"`) from within a bounded
@@ -15175,6 +17386,61 @@ declare namespace LocalJSX {
          */
         "wrap"?: boolean;
     }
+    /**
+     * A key figure: a label, a large value and an optional trend (up, down or flat) with a change figure.
+     * ## When to use
+     * - Dashboard KPIs and summary numbers ("Active users 1,284, up 12%").
+     * ## When not to use
+     * - A time series or comparison of many values -- use a chart.
+     * - A progress toward a goal -- use `bs-progress` / `bs-progress-linear`.
+     * - A count on another element -- use `bs-badge`.
+     * **Built from:** `bs-card` (the surface).
+     * The trend is never conveyed by colour or arrow alone: a visually hidden prefix ("Increase of") is
+     * rendered before the change figure. Whether up is good depends on the metric, so the colour comes from
+     * `trendIntent` (default: up is positive, down is negative; set `negative` for e.g. churn going up).
+     */
+    interface BsStat {
+        /**
+          * What the number measures.
+         */
+        "label": string;
+        /**
+          * Surface of the underlying `bs-card`.
+          * @default 'raised'
+         */
+        "surface"?: BsCardSurface1;
+        /**
+          * Direction of change. Omit to hide the trend.
+         */
+        "trend"?: BsStatTrend;
+        /**
+          * Visually hidden prefix for `trend="down"`.
+          * @default 'Decrease of'
+         */
+        "trendDownLabel"?: string;
+        /**
+          * Colour of the trend. Defaults from `trend`: up is positive, down is negative, neutral is neutral.
+         */
+        "trendIntent"?: BsStatTrendIntent;
+        /**
+          * Visually hidden text for `trend="neutral"`.
+          * @default 'No change'
+         */
+        "trendNeutralLabel"?: string;
+        /**
+          * Visually hidden prefix for `trend="up"`.
+          * @default 'Increase of'
+         */
+        "trendUpLabel"?: string;
+        /**
+          * The change figure shown next to the arrow (e.g. "12%").
+         */
+        "trendValue"?: string;
+        /**
+          * The figure itself, already formatted (e.g. "1,284" or "98.2%").
+         */
+        "value": string;
+    }
     /**
      * A sequence of named steps showing overall progress through a multi-step flow (e.g. a checkout,
      * an onboarding wizard) -- each step reads as enabled (not yet reached), current, done, error, or
@@ -15364,46 +17630,187 @@ declare namespace LocalJSX {
          */
         "tabbable"?: boolean;
         /**
-          * Identifies this tab within a parent `bs-tabs`: the group's `value` is the selected tab's `value`, and `bsChange` reports it. Optional -- a tab without one is identified by its zero-based position in the group (`"0"`, `"1"`...).
+          * Identifies this tab within a parent `bs-tabs`: the group's `value` is the selected tab's `value`, and `bsChange` reports it. Optional -- a tab without one is identified by its zero-based position in the group (`"0"`, `"1"`...).
+         */
+        "value"?: string;
+    }
+    /**
+     * An "On this page" navigation: a nested list of in-page links with a scroll spy that marks the
+     * section currently in view (`aria-current="location"`), optionally sticky beside long content.
+     * Give it entries in either of two ways:
+     * - **`items` property** (a JS array, `{ label, href, children? }`) -- the data-driven way.
+     * - **Slotted anchors** -- `<a href="#intro">Intro</a>`, optionally inside nested `<ul>`/`<li>` or with
+     *   `data-level="2"` for sub-sections. The component reads them and renders its own styled links (the
+     *   slotted markup is not displayed; it is the no-JavaScript fallback). Used when `items` is empty.
+     * The scroll spy uses an `IntersectionObserver` on the elements the links point at. The current section
+     * is the first one (in link order) that intersects the top band of the viewport defined by `rootMargin`;
+     * when none does (between two sections) the previous one stays current. Observers are disconnected when
+     * the element is removed from the DOM and re-created when it is re-attached.
+     * Link targets are looked up by id in the same document (or shadow tree) as the component. Links whose
+     * target does not exist are still shown but never become current.
+     * ## When to use
+     * - Long single-page content (documentation, policies, settings pages) with several headed sections.
+     * ## When not to use
+     * - Navigating between pages -- use `bs-navigation-drawer` or `bs-breadcrumbs`.
+     * - Switching between panels of content that are not all on the page -- use `bs-tabs`.
+     * Composition: leaf element (a nav landmark with anchors); no existing `bs-*` component renders links.
+     */
+    interface BsTableOfContents {
+        /**
+          * The `href` (`#id`) of the current section. Reflected; follows the scroll spy and clicks, and can be set to force a section.
+         */
+        "current"?: string;
+        /**
+          * Hides the visible title; the landmark keeps its accessible name.
+          * @default false
+         */
+        "hideTitle"?: boolean;
+        /**
+          * Entries as a JS array (set as a property, not an attribute). Takes precedence over slotted anchors.
+          * @default []
+         */
+        "items"?: BsTocItem[];
+        /**
+          * Accessible name of the `nav` landmark, and the visible title text.
+          * @default 'On this page'
+         */
+        "label"?: string;
+        /**
+          * Fires when the current section changes (scroll spy or click), with its `href`.
+         */
+        "onBsChange"?: (event: BsTableOfContentsCustomEvent<string>) => void;
+        /**
+          * Fires when a link is clicked, before navigation. **Cancelable**: `preventDefault()` stops the browser jump so you can scroll/route yourself. Detail is `{ href }`. Modified clicks are ignored.
+         */
+        "onBsNavigate"?: (event: BsTableOfContentsCustomEvent<{ href: string }>) => void;
+        /**
+          * `rootMargin` of the spy's `IntersectionObserver`: shrinks the viewport to the band in which a section counts as "current". The default is the top 40% of the viewport. Raise the top value (e.g. `-64px 0px -60% 0px`) when a fixed header covers the top of the page.
+          * @default '0px 0px -60% 0px'
+         */
+        "rootMargin"?: string;
+        /**
+          * Turns the scroll spy on or off. Off: `current` only changes when a link is clicked or it is set.
+          * @default true
+         */
+        "scrollSpy"?: boolean;
+        /**
+          * Sticks the table of contents to the top of its scroll container (`position: sticky`) so it stays in view beside long content. Offset with `--bs-toc-sticky-top`.
+          * @default false
+         */
+        "sticky"?: boolean;
+    }
+    /**
+     * A tab-group wrapper: owns `role="tablist"` and coordinates selection across its slotted
+     * `<bs-tab>` or `<bs-inline-tab>` children, so consumers no longer have to hand-roll this.
+     * `bs-tab.mdx`/`bs-inline-tab.mdx` previously documented this coordination -- listening for
+     * `bsSelect` and setting `selected`/`false` on siblings, plus supplying `role="tablist"` on
+     * whatever element groups the tabs -- as a "Known gap"/manual consumer responsibility. This
+     * component is that wrapper: it renders the `role="tablist"` element and listens for `bsSelect`
+     * itself. Using `<bs-tab>`/`<bs-inline-tab>` standalone, outside a `<bs-tabs>` wrapper, still means
+     * `selected` doesn't self-toggle -- a consumer doing that would still need to coordinate `selected`
+     * manually -- but that's no longer the first recommended path.
+     * ## When to use
+     * - Wrapping a set of `<bs-tab>` (underline style) or `<bs-inline-tab>` (pill style) elements that
+     *   should behave as a single-selection tab bar.
+     * ## When not to use
+     * - For a single, standalone tab button not participating in a group -- use `bs-tab`/`bs-inline-tab`
+     *   directly.
+     */
+    interface BsTabs {
+        /**
+          * Fires when the **selection changes** (click, or arrow/Home/End), with the new `value`. It does not fire when the already-selected tab is clicked again, nor when `value` is set programmatically. To react to every activation, including a click on the already-selected tab (e.g. to sync a URL), listen for `bsSelect` on the tab itself (it bubbles, so one listener on `<bs-tabs>` covers all tabs); it fires on every click.
+         */
+        "onBsChange"?: (event: BsTabsCustomEvent<{ value: string }>) => void;
+        /**
+          * Layout direction of the tab bar itself. Sets `aria-orientation` on the internal wrapper and switches `flex-direction`.
+          * @default 'horizontal'
+         */
+        "orientation"?: BsTabsOrientation;
+        /**
+          * Which tab-button family this group wraps. Governs the wrapper's own visual treatment (gap-only for `bs-tab`, a filled pill bar for `bs-inline-tab`). Not reflected as an attribute -- nothing external needs to target it via CSS attribute selector, it only drives internal class names.
+          * @default 'bs-tab'
+         */
+        "type"?: BsTabsType;
+        /**
+          * The selected tab's `value`. Mutable and reflected: it follows the user's selection, and setting it from outside (attribute or property) selects the matching tab -- without emitting `bsChange`, which only fires for user-driven changes. A tab's value is its own `value` prop, or, for a tab without one, its zero-based position in the group as a string (`"0"`, `"1"`...). If unset, it is read from whichever tab is already `selected` once the group loads.
+         */
+        "value"?: string;
+    }
+    /**
+     * A small label that categorises or annotates an item (a topic, a keyword, a status of a record). It can be
+     * neutral or coloured, optionally removable, and optionally a link.
+     * ## When to use
+     * - Metadata on a record: topics, categories, keywords, owners.
+     * - A removable tag in a list of applied values you edit one by one (`removable`).
+     * - A tag that leads to a filtered view or detail page (`href`).
+     * ## When not to use
+     * - A pure count or notification marker -- use `bs-badge`.
+     * - A read-only status pill with a leading icon -- use `bs-chip-informative`.
+     * - Toggling a filter on and off -- use `bs-chip-filter`; entering free text values -- use `bs-chip-input`.
+     * **Built from:** `bs-icon-button` (the remove control, `size="xs"`).
+     */
+    interface BsTag {
+        /**
+          * Semantic colour. `neutral` is the default.
+          * @default 'neutral'
+         */
+        "color"?: BsTagColor;
+        /**
+          * Turns the label into a link to this URL.
+         */
+        "href"?: string;
+        /**
+          * Fires when the remove button is activated. No payload; the consumer removes the element.
+         */
+        "onBsRemove"?: (event: BsTagCustomEvent<void>) => void;
+        /**
+          * Shows a remove button that emits `bsRemove`. The consumer removes the tag.
+          * @default false
+         */
+        "removable"?: boolean;
+        /**
+          * Prefix of the remove button's accessible name ("Remove {label}").
+          * @default 'Remove'
+         */
+        "removeLabel"?: string;
+        /**
+          * Sizing scale.
+          * @default 'md'
+         */
+        "size"?: BsTagSize;
+        /**
+          * Link target, only used with `href`.
          */
-        "value"?: string;
+        "target"?: string;
     }
     /**
-     * A tab-group wrapper: owns `role="tablist"` and coordinates selection across its slotted
-     * `<bs-tab>` or `<bs-inline-tab>` children, so consumers no longer have to hand-roll this.
-     * `bs-tab.mdx`/`bs-inline-tab.mdx` previously documented this coordination -- listening for
-     * `bsSelect` and setting `selected`/`false` on siblings, plus supplying `role="tablist"` on
-     * whatever element groups the tabs -- as a "Known gap"/manual consumer responsibility. This
-     * component is that wrapper: it renders the `role="tablist"` element and listens for `bsSelect`
-     * itself. Using `<bs-tab>`/`<bs-inline-tab>` standalone, outside a `<bs-tabs>` wrapper, still means
-     * `selected` doesn't self-toggle -- a consumer doing that would still need to coordinate `selected`
-     * manually -- but that's no longer the first recommended path.
+     * Body and caption text mapped to the typography tokens, with the element (`as`) chosen separately
+     * from the look (`variant`) and the colour (`tone`).
+     * Variants: `lead` 18px, `body` 16px, `small` 14px, `caption` 12px (`--bs-font-size-*`,
+     * `--bs-typography-font-family-body`).
+     * Composed from: nothing (leaf).
      * ## When to use
-     * - Wrapping a set of `<bs-tab>` (underline style) or `<bs-inline-tab>` (pill style) elements that
-     *   should behave as a single-selection tab bar.
+     * - Paragraphs, helper copy, captions and inline spans that should follow the type scale and theme.
      * ## When not to use
-     * - For a single, standalone tab button not participating in a group -- use `bs-tab`/`bs-inline-tab`
-     *   directly.
+     * - Headings: use `bs-heading` so the document outline is right.
+     * - Code: use `bs-code-block`.
      */
-    interface BsTabs {
-        /**
-          * Fires when the user selects a different tab (click, or arrow/Home/End), with the new `value`. Does not fire when `value` is set programmatically. `bsSelect` on the individual tab still fires as before.
-         */
-        "onBsChange"?: (event: BsTabsCustomEvent<{ value: string }>) => void;
+    interface BsText {
         /**
-          * Layout direction of the tab bar itself. Sets `aria-orientation` on the internal wrapper and switches `flex-direction`.
-          * @default 'horizontal'
+          * The rendered element. `span` (and `small`, `strong`, `em`, `label`) make the host inline.
+          * @default 'p'
          */
-        "orientation"?: BsTabsOrientation;
+        "as"?: BsTextAs;
         /**
-          * Which tab-button family this group wraps. Governs the wrapper's own visual treatment (gap-only for `bs-tab`, a filled pill bar for `bs-inline-tab`). Not reflected as an attribute -- nothing external needs to target it via CSS attribute selector, it only drives internal class names.
-          * @default 'bs-tab'
+          * Text colour from the text tokens. `inherit` uses the surrounding colour.
+          * @default 'default'
          */
-        "type"?: BsTabsType;
+        "tone"?: BsTextTone;
         /**
-          * The selected tab's `value`. Mutable and reflected: it follows the user's selection, and setting it from outside (attribute or property) selects the matching tab -- without emitting `bsChange`, which only fires for user-driven changes. A tab's value is its own `value` prop, or, for a tab without one, its zero-based position in the group as a string (`"0"`, `"1"`...). If unset, it is read from whichever tab is already `selected` once the group loads.
+          * Visual style.
+          * @default 'body'
          */
-        "value"?: string;
+        "variant"?: BsTextVariant;
     }
     /**
      * An inline time picker: hour and minute spinners (up/down carets, or the arrow keys on the value),
@@ -15528,6 +17935,139 @@ declare namespace LocalJSX {
          */
         "state"?: BsToastState;
     }
+    /**
+     * A button that is either pressed or not. Standalone it is a toggle (`aria-pressed`); inside a
+     * `bs-toggle-button-group` the group sets its `mode` (`toggle` for multiple choice, `radio` for
+     * single choice, which switches the semantics to `role="radio"` + `aria-checked`).
+     * Built from: hand-built `<button>` (the segment shape and pressed state differ from `bs-button`) plus
+     * `bs-ripple`.
+     * ## When to use
+     * - A two-state option such as "Bold", or a segment of a `bs-toggle-button-group`.
+     * ## When not to use
+     * - Triggering an action (use `bs-button`) or an on/off setting that applies immediately (use `bs-switch`).
+     */
+    interface BsToggleButton {
+        /**
+          * Accessible name; required for an icon-only button.
+          * @default null
+         */
+        "ariaLabel"?: string | null;
+        /**
+          * Disables the button.
+          * @default false
+         */
+        "disabled"?: boolean;
+        /**
+          * Semantics. Normally set by the parent group.
+          * @default 'toggle'
+         */
+        "mode"?: BsToggleButtonMode;
+        /**
+          * Emitted on user interaction with the new `pressed` value. A radio-mode button that is already pressed does not emit. Bubbles, so a group can coordinate its segments.
+         */
+        "onBsChange"?: (event: BsToggleButtonCustomEvent<boolean>) => void;
+        /**
+          * Whether the button is pressed/selected.
+          * @default false
+         */
+        "pressed"?: boolean;
+        /**
+          * Roving tabindex, set by the parent group (`false` = `tabindex="-1"`). Standalone: always tabbable.
+          * @default true
+         */
+        "tabbable"?: boolean;
+        /**
+          * Identifies the segment inside a group's `value`/`values`.
+         */
+        "value"?: string;
+    }
+    /**
+     * A segmented control: a row of `bs-toggle-button` segments with single or multiple choice.
+     * Single choice (default) uses radio semantics (`role="radiogroup"` / `role="radio"`) and arrow keys
+     * move focus AND selection. Multiple choice (`multiple`) uses `role="group"` with `aria-pressed`
+     * toggle buttons; arrow keys move focus only, Space/Enter toggles. Focus is roving in both modes
+     * (one tab stop).
+     * Built from: `bs-toggle-button`.
+     * ## When to use
+     * - 2-5 short, related options that should all stay visible (view mode, alignment, filters).
+     * ## When not to use
+     * - Long lists (use `bs-select`) or page-level navigation (use `bs-tabs`).
+     */
+    interface BsToggleButtonGroup {
+        /**
+          * Accessible name of the group. Required.
+          * @default null
+         */
+        "ariaLabel"?: string | null;
+        /**
+          * Disables every segment.
+          * @default false
+         */
+        "disabled"?: boolean;
+        /**
+          * Allow several pressed segments.
+          * @default false
+         */
+        "multiple"?: boolean;
+        /**
+          * Emitted when the user changes the selection: the new `value` (single) or `values` (multiple).
+         */
+        "onBsChange"?: (event: BsToggleButtonGroupCustomEvent<string | string[]>) => void;
+        /**
+          * Selected segment `value` (single choice).
+         */
+        "value"?: string;
+        /**
+          * Selected segment values (multiple choice). Set as a JS property.
+          * @default []
+         */
+        "values"?: string[];
+    }
+    /**
+     * A bar of related controls (buttons, toggles, selects) with a left and a right group, grouped
+     * separators, a single tab stop and arrow-key navigation between the controls (WAI-ARIA toolbar
+     * pattern). Optionally, controls that do not fit collapse into a "more" menu.
+     * Keyboard: the toolbar is ONE tab stop. Left/Right arrows (Up/Down when `orientation="vertical"`,
+     * mirrored in RTL) move focus between the controls and wrap; Home/End jump to the first/last. The
+     * control last focused is the one Tab returns to. Disabled controls are skipped.
+     * Direct children of the `left`/`right` slots are the toolbar's controls. A slotted `bs-divider` is a
+     * separator: the toolbar sets its `orientation` perpendicular to its own and skips it when navigating.
+     * ## When to use
+     * - Several related actions that act on the same content (a text editor's formatting row, a table's
+     *   bulk actions, a viewer's zoom controls).
+     * ## When not to use
+     * - Navigating between pages or sections -- use `bs-tabs`, `bs-navigation-header` or a nav.
+     * - A single action or a form's submit row -- place the `bs-button`s directly.
+     * - A menu of actions that opens on demand -- use `bs-popover` with `bs-menu`.
+     * ## Overflow
+     * With `overflow` set (horizontal only), controls from the end of the bar that do not fit are hidden and
+     * listed in a `bs-menu` behind a "more" button; choosing an entry activates the original control. An
+     * entry's text is the control's `data-label`, else its `aria-label`, else its text content, else `title`:
+     * give icon-only controls one of these.
+     * Composition: built from `bs-icon-button`, `bs-popover`, `bs-menu` and `bs-menu-item` (overflow) and
+     * expects `bs-button`, `bs-icon-button`, `bs-divider` etc. as slotted content.
+     */
+    interface BsToolbar {
+        /**
+          * Accessible name of the toolbar (`aria-label`). Required for a good experience, and essential when a page has more than one toolbar -- say what it controls ("Text formatting").
+         */
+        "label"?: string;
+        /**
+          * Direction of the bar. Sets `aria-orientation`, switches which arrow keys navigate, and sets the orientation of slotted `bs-divider`s to the perpendicular one.
+          * @default 'horizontal'
+         */
+        "orientation"?: BsToolbarOrientation;
+        /**
+          * Collapse controls that do not fit into a "more" menu (see Overflow in the description). Horizontal toolbars only; ignored when `orientation="vertical"`.
+          * @default false
+         */
+        "overflow"?: boolean;
+        /**
+          * Accessible name and tooltip of the overflow button.
+          * @default 'More actions'
+         */
+        "overflowLabel"?: string;
+    }
     /**
      * A dark tooltip bubble with a pointer arrow, used to surface a short hint of extra information
      * next to a trigger element.
@@ -16005,6 +18545,10 @@ declare namespace LocalJSX {
         "disabled": boolean;
         "type": 'button' | 'submit' | 'reset';
         "ariaLabel": string | null;
+        "pressed": boolean;
+        "ariaExpanded": 'true' | 'false' | null;
+        "ariaControls": string | null;
+        "ariaHasPopup": 'true' | 'false' | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog' | null;
     }
     interface BsButtonSkeletonAttributes {
         "size": BsButtonSize;
@@ -16012,6 +18556,12 @@ declare namespace LocalJSX {
     }
     interface BsCardAttributes {
         "surface": BsCardSurface;
+        "href": string;
+        "target": string;
+        "rel": string;
+        "selectable": boolean;
+        "selected": boolean;
+        "label": string;
     }
     interface BsCarouselAttributes {
         "tracker": BsCarouselTracker;
@@ -16087,6 +18637,13 @@ declare namespace LocalJSX {
         "error": boolean;
         "ariaLabel": string | null;
     }
+    interface BsCheckboxGroupAttributes {
+        "label": string;
+        "description": string;
+        "error": string;
+        "orientation": BsCheckboxGroupOrientation;
+        "required": boolean;
+    }
     interface BsCheckboxSkeletonAttributes {
         "size": BsCheckboxSize;
         "loadingLabel": string;
@@ -16115,6 +18672,17 @@ declare namespace LocalJSX {
         "page": string;
         "href": string;
     }
+    interface BsCodeBlockAttributes {
+        "code": string;
+        "filename": string;
+        "lineNumbers": boolean;
+        "wrap": boolean;
+        "inline": boolean;
+        "hideCopy": boolean;
+        "copyLabel": string;
+        "copiedLabel": string;
+        "regionLabel": string;
+    }
     interface BsCommandPaletteAttributes {
         "value": string;
         "open": boolean;
@@ -16218,6 +18786,7 @@ declare namespace LocalJSX {
         "sortDirection": 'asc' | 'desc';
         "selectAllLabel": string;
         "selectable": boolean;
+        "striped": boolean;
     }
     interface BsDatepickerAttributes {
         "name": string;
@@ -16236,6 +18805,16 @@ declare namespace LocalJSX {
         "previousLabel": string;
         "nextLabel": string;
     }
+    interface BsDescriptionItemAttributes {
+        "term": string;
+        "description": string;
+        "layout": 'stacked' | 'horizontal';
+    }
+    interface BsDescriptionListAttributes {
+        "layout": 'stacked' | 'horizontal';
+        "dividers": boolean;
+        "ariaLabel": string | null;
+    }
     interface BsDialogAttributes {
         "open": boolean;
         "heading": string;
@@ -16249,11 +18828,16 @@ declare namespace LocalJSX {
         "inset": BsDividerInset;
         "decorative": boolean;
     }
+    interface BsDropdownAttributes {
+        "open": boolean;
+        "placement": BsDropdownPlacement;
+    }
     interface BsEmptyStateAttributes {
         "heading": string;
         "description": string;
         "intent": BsIconTileIntent;
         "headingLevel": 2 | 3 | 4 | 5 | 6;
+        "size": 'panel' | 'page';
     }
     interface BsErrorPageAttributes {
         "type": BsErrorPageType;
@@ -16321,12 +18905,27 @@ declare namespace LocalJSX {
         "minColumnWidth": string;
         "align": BsGridAlign;
     }
+    interface BsHeadingAttributes {
+        "level": BsHeadingLevel;
+        "as": BsHeadingAs;
+        "size": BsHeadingSize;
+        "tone": BsHeadingTone;
+    }
+    interface BsIconAttributes {
+        "name": string;
+        "size": BsIconSize;
+        "tone": BsIconTone;
+        "label": string;
+    }
     interface BsIconButtonAttributes {
         "variant": BsIconButtonVariant;
         "size": BsIconButtonSize;
         "disabled": boolean;
         "type": 'button' | 'submit' | 'reset';
         "ariaLabel": string | null;
+        "ariaExpanded": 'true' | 'false' | null;
+        "ariaControls": string | null;
+        "ariaHasPopup": 'true' | 'false' | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog' | null;
         "pressed": boolean;
     }
     interface BsIconTileAttributes {
@@ -16360,8 +18959,10 @@ declare namespace LocalJSX {
     | 'chip'
     | 'initials'
     | 'country'
-    | 'pin';
+    | 'pin'
+    | 'combobox';
         "label": string;
+        "ariaLabel": string | null;
         "placeholder": string;
         "description": string;
         "error": string;
@@ -16372,8 +18973,16 @@ declare namespace LocalJSX {
         "max": number;
         "rows": number;
         "initialsTitle": string;
+        "titleLabel": string;
         "country": string;
+        "countryLabel": string;
         "length": number;
+        "loading": boolean;
+        "filterOptions": boolean;
+        "noResultsLabel": string;
+        "loadingLabel": string;
+        "clearLabel": string;
+        "openPickerLabel": string;
         "open": boolean;
     }
     interface BsKeyAttributes {
@@ -16399,9 +19008,20 @@ declare namespace LocalJSX {
         "footerPrefix": string;
         "noResultsText": string;
     }
+    interface BsLinkAttributes {
+        "href": string;
+        "target": string;
+        "rel": string;
+        "variant": BsLinkVariant;
+        "external": boolean;
+        "externalLabel": string;
+        "current": boolean;
+        "ariaLabel": string | null;
+    }
     interface BsListAttributes {
         "selectable": boolean;
         "value": string | null;
+        "variant": 'plain' | 'bulleted' | 'numbered';
         "dividers": boolean;
         "ariaLabel": string | null;
     }
@@ -16415,6 +19035,7 @@ declare namespace LocalJSX {
         "value": string | null;
         "interactive": boolean;
         "selectionRole": 'listitem' | 'option' | null;
+        "marker": string | null;
     }
     interface BsLogoAttributes {
         "variant": BsLogoVariant;
@@ -16467,6 +19088,8 @@ declare namespace LocalJSX {
         "nested": boolean;
         "ariaLabel": string | null;
         "collapsed": boolean;
+        "href": string;
+        "target": string;
     }
     interface BsNavigationHeaderAttributes {
         "alignment": BsNavigationHeaderAlignment;
@@ -16580,9 +19203,20 @@ declare namespace LocalJSX {
     interface BsRadioAttributes {
         "name": string;
         "value": string;
+        "ariaLabel": string | null;
         "checked": boolean;
         "disabled": boolean;
     }
+    interface BsRadioGroupAttributes {
+        "label": string;
+        "description": string;
+        "error": string;
+        "orientation": BsRadioGroupOrientation;
+        "name": string;
+        "value": string;
+        "required": boolean;
+        "selectFirst": boolean;
+    }
     interface BsRippleAttributes {
         "centered": boolean;
         "disabled": boolean;
@@ -16595,6 +19229,18 @@ declare namespace LocalJSX {
         "trailing": string;
         "selectionRole": 'option' | null;
     }
+    interface BsSelectAttributes {
+        "name": string;
+        "value": string;
+        "label": string;
+        "ariaLabel": string | null;
+        "placeholder": string;
+        "description": string;
+        "error": string;
+        "disabled": boolean;
+        "required": boolean;
+        "open": boolean;
+    }
     interface BsSessionTimeoutAttributes {
         "type": BsSessionTimeoutType;
         "heading": string;
@@ -16639,6 +19285,9 @@ declare namespace LocalJSX {
         "animated": boolean;
         "label": string;
     }
+    interface BsSkipLinkAttributes {
+        "href": string;
+    }
     interface BsSliderAttributes {
         "type": BsSliderType;
         "name": string;
@@ -16689,6 +19338,17 @@ declare namespace LocalJSX {
         "wrap": boolean;
         "divider": boolean;
     }
+    interface BsStatAttributes {
+        "label": string;
+        "value": string;
+        "trend": BsStatTrend;
+        "trendValue": string;
+        "trendIntent": BsStatTrendIntent;
+        "trendUpLabel": string;
+        "trendDownLabel": string;
+        "trendNeutralLabel": string;
+        "surface": BsCardSurface;
+    }
     interface BsStepperAttributes {
         "currentStep": number;
         "direction": BsStepperDirection;
@@ -16719,11 +19379,32 @@ declare namespace LocalJSX {
         "value": string;
         "tabbable": boolean;
     }
+    interface BsTableOfContentsAttributes {
+        "label": string;
+        "hideTitle": boolean;
+        "current": string;
+        "scrollSpy": boolean;
+        "rootMargin": string;
+        "sticky": boolean;
+    }
     interface BsTabsAttributes {
         "type": BsTabsType;
         "orientation": BsTabsOrientation;
         "value": string;
     }
+    interface BsTagAttributes {
+        "color": BsTagColor;
+        "size": BsTagSize;
+        "removable": boolean;
+        "href": string;
+        "target": string;
+        "removeLabel": string;
+    }
+    interface BsTextAttributes {
+        "as": BsTextAs;
+        "variant": BsTextVariant;
+        "tone": BsTextTone;
+    }
     interface BsTimepickerAttributes {
         "name": string;
         "value": string;
@@ -16743,6 +19424,26 @@ declare namespace LocalJSX {
         "state": BsToastState;
         "dismissLabel": string;
     }
+    interface BsToggleButtonAttributes {
+        "value": string;
+        "pressed": boolean;
+        "disabled": boolean;
+        "mode": BsToggleButtonMode;
+        "tabbable": boolean;
+        "ariaLabel": string | null;
+    }
+    interface BsToggleButtonGroupAttributes {
+        "value": string;
+        "multiple": boolean;
+        "disabled": boolean;
+        "ariaLabel": string | null;
+    }
+    interface BsToolbarAttributes {
+        "label": string;
+        "orientation": BsToolbarOrientation;
+        "overflow": boolean;
+        "overflowLabel": string;
+    }
     interface BsTooltipAttributes {
         "placement": 'top';
     }
@@ -16827,11 +19528,13 @@ declare namespace LocalJSX {
         "bs-chatbot-sources-drawer": Omit<BsChatbotSourcesDrawer, keyof BsChatbotSourcesDrawerAttributes> & { [K in keyof BsChatbotSourcesDrawer & keyof BsChatbotSourcesDrawerAttributes]?: BsChatbotSourcesDrawer[K] } & { [K in keyof BsChatbotSourcesDrawer & keyof BsChatbotSourcesDrawerAttributes as `attr:${K}`]?: BsChatbotSourcesDrawerAttributes[K] } & { [K in keyof BsChatbotSourcesDrawer & keyof BsChatbotSourcesDrawerAttributes as `prop:${K}`]?: BsChatbotSourcesDrawer[K] };
         "bs-chatbot-suggestion-button": Omit<BsChatbotSuggestionButton, keyof BsChatbotSuggestionButtonAttributes> & { [K in keyof BsChatbotSuggestionButton & keyof BsChatbotSuggestionButtonAttributes]?: BsChatbotSuggestionButton[K] } & { [K in keyof BsChatbotSuggestionButton & keyof BsChatbotSuggestionButtonAttributes as `attr:${K}`]?: BsChatbotSuggestionButtonAttributes[K] } & { [K in keyof BsChatbotSuggestionButton & keyof BsChatbotSuggestionButtonAttributes as `prop:${K}`]?: BsChatbotSuggestionButton[K] };
         "bs-checkbox": Omit<BsCheckbox, keyof BsCheckboxAttributes> & { [K in keyof BsCheckbox & keyof BsCheckboxAttributes]?: BsCheckbox[K] } & { [K in keyof BsCheckbox & keyof BsCheckboxAttributes as `attr:${K}`]?: BsCheckboxAttributes[K] } & { [K in keyof BsCheckbox & keyof BsCheckboxAttributes as `prop:${K}`]?: BsCheckbox[K] };
+        "bs-checkbox-group": Omit<BsCheckboxGroup, keyof BsCheckboxGroupAttributes> & { [K in keyof BsCheckboxGroup & keyof BsCheckboxGroupAttributes]?: BsCheckboxGroup[K] } & { [K in keyof BsCheckboxGroup & keyof BsCheckboxGroupAttributes as `attr:${K}`]?: BsCheckboxGroupAttributes[K] } & { [K in keyof BsCheckboxGroup & keyof BsCheckboxGroupAttributes as `prop:${K}`]?: BsCheckboxGroup[K] };
         "bs-checkbox-skeleton": Omit<BsCheckboxSkeleton, keyof BsCheckboxSkeletonAttributes> & { [K in keyof BsCheckboxSkeleton & keyof BsCheckboxSkeletonAttributes]?: BsCheckboxSkeleton[K] } & { [K in keyof BsCheckboxSkeleton & keyof BsCheckboxSkeletonAttributes as `attr:${K}`]?: BsCheckboxSkeletonAttributes[K] } & { [K in keyof BsCheckboxSkeleton & keyof BsCheckboxSkeletonAttributes as `prop:${K}`]?: BsCheckboxSkeleton[K] };
         "bs-chip-filter": Omit<BsChipFilter, keyof BsChipFilterAttributes> & { [K in keyof BsChipFilter & keyof BsChipFilterAttributes]?: BsChipFilter[K] } & { [K in keyof BsChipFilter & keyof BsChipFilterAttributes as `attr:${K}`]?: BsChipFilterAttributes[K] } & { [K in keyof BsChipFilter & keyof BsChipFilterAttributes as `prop:${K}`]?: BsChipFilter[K] };
         "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-code-block": Omit<BsCodeBlock, keyof BsCodeBlockAttributes> & { [K in keyof BsCodeBlock & keyof BsCodeBlockAttributes]?: BsCodeBlock[K] } & { [K in keyof BsCodeBlock & keyof BsCodeBlockAttributes as `attr:${K}`]?: BsCodeBlockAttributes[K] } & { [K in keyof BsCodeBlock & keyof BsCodeBlockAttributes as `prop:${K}`]?: BsCodeBlock[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-compact-menu-block": Omit<BsCompactMenuBlock, keyof BsCompactMenuBlockAttributes> & { [K in keyof BsCompactMenuBlock & keyof BsCompactMenuBlockAttributes]?: BsCompactMenuBlock[K] } & { [K in keyof BsCompactMenuBlock & keyof BsCompactMenuBlockAttributes as `attr:${K}`]?: BsCompactMenuBlockAttributes[K] } & { [K in keyof BsCompactMenuBlock & keyof BsCompactMenuBlockAttributes as `prop:${K}`]?: BsCompactMenuBlock[K] } & OneOf<"name", BsCompactMenuBlock["name"], BsCompactMenuBlockAttributes["name"]>;
         "bs-company-switcher": Omit<BsCompanySwitcher, keyof BsCompanySwitcherAttributes> & { [K in keyof BsCompanySwitcher & keyof BsCompanySwitcherAttributes]?: BsCompanySwitcher[K] } & { [K in keyof BsCompanySwitcher & keyof BsCompanySwitcherAttributes as `attr:${K}`]?: BsCompanySwitcherAttributes[K] } & { [K in keyof BsCompanySwitcher & keyof BsCompanySwitcherAttributes as `prop:${K}`]?: BsCompanySwitcher[K] };
@@ -16841,14 +19544,19 @@ declare namespace LocalJSX {
         "bs-cookie-consent": Omit<BsCookieConsent, keyof BsCookieConsentAttributes> & { [K in keyof BsCookieConsent & keyof BsCookieConsentAttributes]?: BsCookieConsent[K] } & { [K in keyof BsCookieConsent & keyof BsCookieConsentAttributes as `attr:${K}`]?: BsCookieConsentAttributes[K] } & { [K in keyof BsCookieConsent & keyof BsCookieConsentAttributes as `prop:${K}`]?: BsCookieConsent[K] };
         "bs-data-table": Omit<BsDataTable, keyof BsDataTableAttributes> & { [K in keyof BsDataTable & keyof BsDataTableAttributes]?: BsDataTable[K] } & { [K in keyof BsDataTable & keyof BsDataTableAttributes as `attr:${K}`]?: BsDataTableAttributes[K] } & { [K in keyof BsDataTable & keyof BsDataTableAttributes as `prop:${K}`]?: BsDataTable[K] };
         "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-description-item": Omit<BsDescriptionItem, keyof BsDescriptionItemAttributes> & { [K in keyof BsDescriptionItem & keyof BsDescriptionItemAttributes]?: BsDescriptionItem[K] } & { [K in keyof BsDescriptionItem & keyof BsDescriptionItemAttributes as `attr:${K}`]?: BsDescriptionItemAttributes[K] } & { [K in keyof BsDescriptionItem & keyof BsDescriptionItemAttributes as `prop:${K}`]?: BsDescriptionItem[K] };
+        "bs-description-list": Omit<BsDescriptionList, keyof BsDescriptionListAttributes> & { [K in keyof BsDescriptionList & keyof BsDescriptionListAttributes]?: BsDescriptionList[K] } & { [K in keyof BsDescriptionList & keyof BsDescriptionListAttributes as `attr:${K}`]?: BsDescriptionListAttributes[K] } & { [K in keyof BsDescriptionList & keyof BsDescriptionListAttributes as `prop:${K}`]?: BsDescriptionList[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-dropdown": Omit<BsDropdown, keyof BsDropdownAttributes> & { [K in keyof BsDropdown & keyof BsDropdownAttributes]?: BsDropdown[K] } & { [K in keyof BsDropdown & keyof BsDropdownAttributes as `attr:${K}`]?: BsDropdownAttributes[K] } & { [K in keyof BsDropdown & keyof BsDropdownAttributes as `prop:${K}`]?: BsDropdown[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-heading": Omit<BsHeading, keyof BsHeadingAttributes> & { [K in keyof BsHeading & keyof BsHeadingAttributes]?: BsHeading[K] } & { [K in keyof BsHeading & keyof BsHeadingAttributes as `attr:${K}`]?: BsHeadingAttributes[K] } & { [K in keyof BsHeading & keyof BsHeadingAttributes as `prop:${K}`]?: BsHeading[K] };
+        "bs-icon": Omit<BsIcon, keyof BsIconAttributes> & { [K in keyof BsIcon & keyof BsIconAttributes]?: BsIcon[K] } & { [K in keyof BsIcon & keyof BsIconAttributes as `attr:${K}`]?: BsIconAttributes[K] } & { [K in keyof BsIcon & keyof BsIconAttributes as `prop:${K}`]?: BsIcon[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] };
@@ -16856,6 +19564,7 @@ declare namespace LocalJSX {
         "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-link": Omit<BsLink, keyof BsLinkAttributes> & { [K in keyof BsLink & keyof BsLinkAttributes]?: BsLink[K] } & { [K in keyof BsLink & keyof BsLinkAttributes as `attr:${K}`]?: BsLinkAttributes[K] } & { [K in keyof BsLink & keyof BsLinkAttributes as `prop:${K}`]?: BsLink[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] };
@@ -16878,25 +19587,35 @@ 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-radio-group": Omit<BsRadioGroup, keyof BsRadioGroupAttributes> & { [K in keyof BsRadioGroup & keyof BsRadioGroupAttributes]?: BsRadioGroup[K] } & { [K in keyof BsRadioGroup & keyof BsRadioGroupAttributes as `attr:${K}`]?: BsRadioGroupAttributes[K] } & { [K in keyof BsRadioGroup & keyof BsRadioGroupAttributes as `prop:${K}`]?: BsRadioGroup[K] };
         "bs-ripple": Omit<BsRipple, keyof BsRippleAttributes> & { [K in keyof BsRipple & keyof BsRippleAttributes]?: BsRipple[K] } & { [K in keyof BsRipple & keyof BsRippleAttributes as `attr:${K}`]?: BsRippleAttributes[K] } & { [K in keyof BsRipple & keyof BsRippleAttributes as `prop:${K}`]?: BsRipple[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-select": Omit<BsSelect, keyof BsSelectAttributes> & { [K in keyof BsSelect & keyof BsSelectAttributes]?: BsSelect[K] } & { [K in keyof BsSelect & keyof BsSelectAttributes as `attr:${K}`]?: BsSelectAttributes[K] } & { [K in keyof BsSelect & keyof BsSelectAttributes as `prop:${K}`]?: BsSelect[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-skip-link": Omit<BsSkipLink, keyof BsSkipLinkAttributes> & { [K in keyof BsSkipLink & keyof BsSkipLinkAttributes]?: BsSkipLink[K] } & { [K in keyof BsSkipLink & keyof BsSkipLinkAttributes as `attr:${K}`]?: BsSkipLinkAttributes[K] } & { [K in keyof BsSkipLink & keyof BsSkipLinkAttributes as `prop:${K}`]?: BsSkipLink[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] };
         "bs-snackbar": Omit<BsSnackbar, keyof BsSnackbarAttributes> & { [K in keyof BsSnackbar & keyof BsSnackbarAttributes]?: BsSnackbar[K] } & { [K in keyof BsSnackbar & keyof BsSnackbarAttributes as `attr:${K}`]?: BsSnackbarAttributes[K] } & { [K in keyof BsSnackbar & keyof BsSnackbarAttributes as `prop:${K}`]?: BsSnackbar[K] };
         "bs-source-link": Omit<BsSourceLink, keyof BsSourceLinkAttributes> & { [K in keyof BsSourceLink & keyof BsSourceLinkAttributes]?: BsSourceLink[K] } & { [K in keyof BsSourceLink & keyof BsSourceLinkAttributes as `attr:${K}`]?: BsSourceLinkAttributes[K] } & { [K in keyof BsSourceLink & keyof BsSourceLinkAttributes as `prop:${K}`]?: BsSourceLink[K] };
         "bs-spinner": Omit<BsSpinner, keyof BsSpinnerAttributes> & { [K in keyof BsSpinner & keyof BsSpinnerAttributes]?: BsSpinner[K] } & { [K in keyof BsSpinner & keyof BsSpinnerAttributes as `attr:${K}`]?: BsSpinnerAttributes[K] } & { [K in keyof BsSpinner & keyof BsSpinnerAttributes as `prop:${K}`]?: BsSpinner[K] };
         "bs-split-pane": Omit<BsSplitPane, keyof BsSplitPaneAttributes> & { [K in keyof BsSplitPane & keyof BsSplitPaneAttributes]?: BsSplitPane[K] } & { [K in keyof BsSplitPane & keyof BsSplitPaneAttributes as `attr:${K}`]?: BsSplitPaneAttributes[K] } & { [K in keyof BsSplitPane & keyof BsSplitPaneAttributes as `prop:${K}`]?: BsSplitPane[K] };
         "bs-stack": Omit<BsStack, keyof BsStackAttributes> & { [K in keyof BsStack & keyof BsStackAttributes]?: BsStack[K] } & { [K in keyof BsStack & keyof BsStackAttributes as `attr:${K}`]?: BsStackAttributes[K] } & { [K in keyof BsStack & keyof BsStackAttributes as `prop:${K}`]?: BsStack[K] };
+        "bs-stat": Omit<BsStat, keyof BsStatAttributes> & { [K in keyof BsStat & keyof BsStatAttributes]?: BsStat[K] } & { [K in keyof BsStat & keyof BsStatAttributes as `attr:${K}`]?: BsStatAttributes[K] } & { [K in keyof BsStat & keyof BsStatAttributes as `prop:${K}`]?: BsStat[K] } & OneOf<"label", BsStat["label"], BsStatAttributes["label"]> & OneOf<"value", BsStat["value"], BsStatAttributes["value"]>;
         "bs-stepper": Omit<BsStepper, keyof BsStepperAttributes> & { [K in keyof BsStepper & keyof BsStepperAttributes]?: BsStepper[K] } & { [K in keyof BsStepper & keyof BsStepperAttributes as `attr:${K}`]?: BsStepperAttributes[K] } & { [K in keyof BsStepper & keyof BsStepperAttributes as `prop:${K}`]?: BsStepper[K] };
         "bs-stepper-step": Omit<BsStepperStep, keyof BsStepperStepAttributes> & { [K in keyof BsStepperStep & keyof BsStepperStepAttributes]?: BsStepperStep[K] } & { [K in keyof BsStepperStep & keyof BsStepperStepAttributes as `attr:${K}`]?: BsStepperStepAttributes[K] } & { [K in keyof BsStepperStep & keyof BsStepperStepAttributes as `prop:${K}`]?: BsStepperStep[K] };
         "bs-switch": Omit<BsSwitch, keyof BsSwitchAttributes> & { [K in keyof BsSwitch & keyof BsSwitchAttributes]?: BsSwitch[K] } & { [K in keyof BsSwitch & keyof BsSwitchAttributes as `attr:${K}`]?: BsSwitchAttributes[K] } & { [K in keyof BsSwitch & keyof BsSwitchAttributes as `prop:${K}`]?: BsSwitch[K] };
         "bs-tab": Omit<BsTab, keyof BsTabAttributes> & { [K in keyof BsTab & keyof BsTabAttributes]?: BsTab[K] } & { [K in keyof BsTab & keyof BsTabAttributes as `attr:${K}`]?: BsTabAttributes[K] } & { [K in keyof BsTab & keyof BsTabAttributes as `prop:${K}`]?: BsTab[K] };
+        "bs-table-of-contents": Omit<BsTableOfContents, keyof BsTableOfContentsAttributes> & { [K in keyof BsTableOfContents & keyof BsTableOfContentsAttributes]?: BsTableOfContents[K] } & { [K in keyof BsTableOfContents & keyof BsTableOfContentsAttributes as `attr:${K}`]?: BsTableOfContentsAttributes[K] } & { [K in keyof BsTableOfContents & keyof BsTableOfContentsAttributes as `prop:${K}`]?: BsTableOfContents[K] };
         "bs-tabs": Omit<BsTabs, keyof BsTabsAttributes> & { [K in keyof BsTabs & keyof BsTabsAttributes]?: BsTabs[K] } & { [K in keyof BsTabs & keyof BsTabsAttributes as `attr:${K}`]?: BsTabsAttributes[K] } & { [K in keyof BsTabs & keyof BsTabsAttributes as `prop:${K}`]?: BsTabs[K] };
+        "bs-tag": Omit<BsTag, keyof BsTagAttributes> & { [K in keyof BsTag & keyof BsTagAttributes]?: BsTag[K] } & { [K in keyof BsTag & keyof BsTagAttributes as `attr:${K}`]?: BsTagAttributes[K] } & { [K in keyof BsTag & keyof BsTagAttributes as `prop:${K}`]?: BsTag[K] };
+        "bs-text": Omit<BsText, keyof BsTextAttributes> & { [K in keyof BsText & keyof BsTextAttributes]?: BsText[K] } & { [K in keyof BsText & keyof BsTextAttributes as `attr:${K}`]?: BsTextAttributes[K] } & { [K in keyof BsText & keyof BsTextAttributes as `prop:${K}`]?: BsText[K] };
         "bs-timepicker": Omit<BsTimepicker, keyof BsTimepickerAttributes> & { [K in keyof BsTimepicker & keyof BsTimepickerAttributes]?: BsTimepicker[K] } & { [K in keyof BsTimepicker & keyof BsTimepickerAttributes as `attr:${K}`]?: BsTimepickerAttributes[K] } & { [K in keyof BsTimepicker & keyof BsTimepickerAttributes as `prop:${K}`]?: BsTimepicker[K] };
         "bs-toast": Omit<BsToast, keyof BsToastAttributes> & { [K in keyof BsToast & keyof BsToastAttributes]?: BsToast[K] } & { [K in keyof BsToast & keyof BsToastAttributes as `attr:${K}`]?: BsToastAttributes[K] } & { [K in keyof BsToast & keyof BsToastAttributes as `prop:${K}`]?: BsToast[K] };
+        "bs-toggle-button": Omit<BsToggleButton, keyof BsToggleButtonAttributes> & { [K in keyof BsToggleButton & keyof BsToggleButtonAttributes]?: BsToggleButton[K] } & { [K in keyof BsToggleButton & keyof BsToggleButtonAttributes as `attr:${K}`]?: BsToggleButtonAttributes[K] } & { [K in keyof BsToggleButton & keyof BsToggleButtonAttributes as `prop:${K}`]?: BsToggleButton[K] };
+        "bs-toggle-button-group": Omit<BsToggleButtonGroup, keyof BsToggleButtonGroupAttributes> & { [K in keyof BsToggleButtonGroup & keyof BsToggleButtonGroupAttributes]?: BsToggleButtonGroup[K] } & { [K in keyof BsToggleButtonGroup & keyof BsToggleButtonGroupAttributes as `attr:${K}`]?: BsToggleButtonGroupAttributes[K] } & { [K in keyof BsToggleButtonGroup & keyof BsToggleButtonGroupAttributes as `prop:${K}`]?: BsToggleButtonGroup[K] };
+        "bs-toolbar": Omit<BsToolbar, keyof BsToolbarAttributes> & { [K in keyof BsToolbar & keyof BsToolbarAttributes]?: BsToolbar[K] } & { [K in keyof BsToolbar & keyof BsToolbarAttributes as `attr:${K}`]?: BsToolbarAttributes[K] } & { [K in keyof BsToolbar & keyof BsToolbarAttributes as `prop:${K}`]?: BsToolbar[K] };
         "bs-tooltip": Omit<BsTooltip, keyof BsTooltipAttributes> & { [K in keyof BsTooltip & keyof BsTooltipAttributes]?: BsTooltip[K] } & { [K in keyof BsTooltip & keyof BsTooltipAttributes as `attr:${K}`]?: BsTooltipAttributes[K] } & { [K in keyof BsTooltip & keyof BsTooltipAttributes as `prop:${K}`]?: BsTooltip[K] };
         "bs-tooltip-trigger": Omit<BsTooltipTrigger, keyof BsTooltipTriggerAttributes> & { [K in keyof BsTooltipTrigger & keyof BsTooltipTriggerAttributes]?: BsTooltipTrigger[K] } & { [K in keyof BsTooltipTrigger & keyof BsTooltipTriggerAttributes as `attr:${K}`]?: BsTooltipTriggerAttributes[K] } & { [K in keyof BsTooltipTrigger & keyof BsTooltipTriggerAttributes as `prop:${K}`]?: BsTooltipTrigger[K] };
         "bs-tree": Omit<BsTree, keyof BsTreeAttributes> & { [K in keyof BsTree & keyof BsTreeAttributes]?: BsTree[K] } & { [K in keyof BsTree & keyof BsTreeAttributes as `attr:${K}`]?: BsTreeAttributes[K] } & { [K in keyof BsTree & keyof BsTreeAttributes as `prop:${K}`]?: BsTree[K] };
@@ -17264,17 +19983,20 @@ declare module "@stencil/core" {
              * - `error` purely for visual emphasis — it signals a destructive action to the user, so reserve
              *   it for actions that actually delete/revoke/undo something.
              * @prop --bs-button-radius - Corner radius. Aliased to `--bs-border-radius-100` by default.
-             * @prop --bs-button-padding-x-sm - Left/right padding of a label-only button at `size="sm"`. Aliased to `--bs-spacing-300`.
+             * @prop --bs-button-padding-x-sm - Left/right padding of a label-only button at `size="sm"`. Aliased to `--bs-spacing-150` (12px).
+             * @prop --bs-button-padding-x-md - Left/right padding at `size="md"`. Aliased to `--bs-spacing-150` (12px).
+             * @prop --bs-button-padding-x-lg - Left/right padding at `size="lg"`. Aliased to `--bs-spacing-150` (12px).
              * @prop --bs-button-width - Width of the button. `auto` by default (fits its content); set `100%` for a full-width button, e.g. `bs-button { --bs-button-width: 100%; }`.
              * @prop --bs-button-subtle-color - Label/icon colour, `variant="subtle"`. Aliased to `--bs-color-neutral-default`; set it to `var(--bs-text-action)` for a blue text button.
-             * @prop --bs-button-height-sm - Height at `size="sm"`. Aliased to `--bs-spacing-500`.
-             * @prop --bs-button-height-md - Height at `size="md"`. Aliased to `--bs-spacing-600`.
-             * @prop --bs-button-height-lg - Height at `size="lg"`. Aliased to `--bs-spacing-700`.
+             * @prop --bs-button-height-sm - Height at `size="sm"`. Aliased to `--bs-spacing-400` (32px).
+             * @prop --bs-button-height-md - Height at `size="md"`. Aliased to `--bs-spacing-550` (44px).
+             * @prop --bs-button-height-lg - Height at `size="lg"`. Aliased to `--bs-spacing-600` (48px).
+             * @prop --bs-button-outlined-color - Label/icon colour, `variant="outlined"`, default. Aliased to `--bs-color-primary-default`.
              * @prop --bs-button-neutral-border - Border color, `variant="neutral"`, default/disabled. Aliased to `--bs-border-neutral-container`.
              * @prop --bs-button-neutral-border-hover - Border color, `variant="neutral"`, hover. Aliased to `--bs-border-neutral-container-hover`.
              * @prop --bs-button-neutral-border-pressed - Border color, `variant="neutral"`, pressed. Aliased to `--bs-border-neutral-container-pressed`.
-             * @prop --bs-button-padding-x-icon-side - Horizontal padding on an edge that's adjacent to a leading/trailing icon (tighter than the plain text-only edge). Aliased to `--bs-spacing-150`.
-             * @prop --bs-button-padding-x-label-side - Horizontal padding on the opposite edge, when an icon on the other side needs compensating extra space to keep the button optically balanced. Aliased to `--bs-spacing-250`.
+             * @prop --bs-button-padding-x-icon-side - Horizontal padding on an edge that's adjacent to a leading/trailing icon (now equal to the text-only edge). Aliased to `--bs-spacing-150`.
+             * @prop --bs-button-padding-x-label-side - Horizontal padding on the opposite edge, when an icon on the other side needs compensating extra space to keep the button optically balanced. Aliased to `--bs-spacing-150` (no compensation by default).
              */
             "bs-button": LocalJSX.IntrinsicElements["bs-button"] & JSXBase.HTMLAttributes<HTMLBsButtonElement>;
             /**
@@ -17475,6 +20197,9 @@ declare module "@stencil/core" {
              * `--bs-color-primary-container-pressed`.
              * @prop --bs-chatbot-suggestion-button-bg-focus - Background when focused. Aliased to
              * `--bs-color-primary-container-hover` (same as hover).
+             * @prop --bs-chatbot-suggestion-button-bg-disabled - Background when disabled. Aliased to `--bs-surface-action-disabled`.
+             * @prop --bs-chatbot-suggestion-button-text-disabled - Text color when disabled. Aliased to `--bs-text-on-disabled`.
+             * @prop --bs-chatbot-suggestion-button-border-color-disabled - Border color when disabled. Aliased to `--bs-border-neutral-disabled`.
              * @prop --bs-chatbot-suggestion-button-text-default - Text color in the default state. Aliased to
              * `--bs-text-action`.
              * @prop --bs-chatbot-suggestion-button-text-hover - Text color on hover, pressed, and focus.
@@ -17495,6 +20220,17 @@ declare module "@stencil/core" {
              * - An on/off setting that takes effect immediately (no explicit form submission) -- use `bs-switch`.
              */
             "bs-checkbox": LocalJSX.IntrinsicElements["bs-checkbox"] & JSXBase.HTMLAttributes<HTMLBsCheckboxElement>;
+            /**
+             * A labelled group of `bs-checkbox`es: a `<fieldset>` with a `<legend>`, helper or error text, and
+             * a single `value` array of the checked boxes' values.
+             * Composed from: `bs-checkbox` (slotted by you).
+             * ## When to use
+             * - A set of related, independent options where any number may be chosen ("Notify me by ...").
+             * ## When not to use
+             * - Exactly one choice: use `bs-radio-group`.
+             * - A single yes/no: use one `bs-checkbox`, or `bs-switch` for an immediate setting.
+             */
+            "bs-checkbox-group": LocalJSX.IntrinsicElements["bs-checkbox-group"] & JSXBase.HTMLAttributes<HTMLBsCheckboxGroupElement>;
             /**
              * A shape-matched loading placeholder for `bs-checkbox`, shown while the real label text isn't
              * known yet (e.g. still being fetched from an API). Renders a small square (matching the
@@ -17574,6 +20310,27 @@ 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 block of code with an optional filename header and a Copy button, or (with `inline`) styled
+             * inline code. Dependency-free: it does no syntax highlighting itself. Pass plain text with `code`,
+             * or slot pre-highlighted markup (e.g. the output of Shiki or Prism: spans coloured with your own
+             * CSS) as the default slot.
+             * Follows light and dark mode through the surface/text tokens. Long lines scroll horizontally (the
+             * scroll area is keyboard focusable) or, with `wrap`, break onto the next line.
+             * Copying announces the `copiedLabel` text through a polite live region, and the button label
+             * changes to match for a few seconds.
+             * Slotted content: keep it flush against the tags (`<bs-code-block><span>..</span></bs-code-block>`),
+             * since whitespace in a `<pre>`-style block is kept. The line count for `lineNumbers` and the text
+             * that is copied are read from the slotted text.
+             * Composed from: `bs-card` (the surface), `bs-button` and `bs-icon` (the Copy button).
+             * ## When to use
+             * - Showing a snippet, command or config the reader may want to copy.
+             * - `inline` for a short code term inside a sentence.
+             * ## When not to use
+             * - Long files that need folding, search or editing: link to the source instead.
+             * - Pre-formatted prose or tables: use ordinary text and table markup.
+             */
+            "bs-code-block": LocalJSX.IntrinsicElements["bs-code-block"] & JSXBase.HTMLAttributes<HTMLBsCodeBlockElement>;
             /**
              * 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
@@ -17802,6 +20559,12 @@ declare module "@stencil/core" {
              * ## When not to use
              * - A handful of unrelated key/value pairs — a simple list or card is lighter-weight.
              * - Deeply nested/hierarchical data — this component renders one flat row per record.
+             * ## Rich cells
+             * Without a `cellRenderer`, each cell is a named slot, `cell-{row.id}-{column.key}`, whose fallback
+             * content is the plain-text value. Slot an element into it to put app-owned content (a framework
+             * component, a router link, a badge) in the cell, e.g.
+             * `<a slot="cell-7-name" href="/people/7">Ada</a>`. The slotted element lives in the light DOM, so
+             * it keeps your framework, router and CSP; nothing is parsed as HTML.
              */
             "bs-data-table": LocalJSX.IntrinsicElements["bs-data-table"] & JSXBase.HTMLAttributes<HTMLBsDataTableElement>;
             /**
@@ -17825,6 +20588,38 @@ declare module "@stencil/core" {
              * month (with Shift, by year), Enter/Space select the focused day.
              */
             "bs-datepicker": LocalJSX.IntrinsicElements["bs-datepicker"] & JSXBase.HTMLAttributes<HTMLBsDatepickerElement>;
+            /**
+             * One term and its detail inside a `bs-description-list` (a label/value pair such as "Owner: Sam Lee").
+             * ## When to use
+             * - As a child of `bs-description-list`, one per key/value pair.
+             * ## When not to use
+             * - Rows of records with media and actions -- use `bs-list-item`.
+             * - Many pairs compared across several records -- use `bs-data-table`.
+             * Each item renders its own `<dl>` containing one `<div>` group with a real `<dt>` and `<dd>`. (A `dl` cannot
+             * span the shadow boundary between a list and its items, so the grouping lives here.)
+             * @prop --bs-description-item-gap - Gap between term and detail when stacked. Aliased to `--bs-spacing-25`.
+             * @prop --bs-description-item-term-width - Width of the term column when `layout="horizontal"`. `12rem`.
+             * @prop --bs-description-item-column-gap - Gap between the term and detail columns when horizontal. Aliased to `--bs-spacing-200`.
+             * @prop --bs-description-item-padding-y - Vertical padding. Aliased to `--bs-spacing-100`.
+             * @prop --bs-description-item-term-color - Aliased to `--bs-text-secondary`.
+             * @prop --bs-description-item-description-color - Aliased to `--bs-text-default`.
+             */
+            "bs-description-item": LocalJSX.IntrinsicElements["bs-description-item"] & JSXBase.HTMLAttributes<HTMLBsDescriptionItemElement>;
+            /**
+             * A key/value list of `bs-description-item` pairs (term and detail), for record summaries, settings read-outs
+             * and metadata panels. Terms and details use real `dt`/`dd` semantics.
+             * ## When to use
+             * - A read-only summary of one record: "Owner", "Created", "Status" with their values.
+             * ## When not to use
+             * - A list of records with media and actions -- use `bs-list`.
+             * - Editable fields -- use form components.
+             * - Several records compared across columns -- use `bs-data-table`.
+             * Built from `bs-description-item` children (light DOM; the list never moves nodes). Each item holds its own
+             * `dl`; the list sets the layout on them and draws dividers.
+             * @prop --bs-description-list-divider-color - Divider colour when `dividers` is set. Aliased to `--bs-border-neutral-container`.
+             * @prop --bs-description-list-gap - Gap between items. `0`.
+             */
+            "bs-description-list": LocalJSX.IntrinsicElements["bs-description-list"] & JSXBase.HTMLAttributes<HTMLBsDescriptionListElement>;
             /**
              * An overlay dialog that interrupts the current flow for a focused task or confirmation.
              * Closes itself on backdrop click, Escape, or its own close button, and emits `bsClose`.
@@ -17855,6 +20650,22 @@ 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 menu trigger: a button (slot `trigger`) that opens a `bs-menu` of `bs-menu-item`s in an anchored,
+             * viewport-aware popup, with the menu keyboard pattern and focus management built in.
+             * Opens on click, Enter, Space (via the trigger button) and ArrowDown. On open focus moves to the
+             * first enabled menu item; Up/Down/Home/End move between items (handled by `bs-menu`). The dropdown
+             * closes on outside click, Escape (focus returns to the trigger), Tab, and after an item is activated.
+             * The trigger gets `aria-haspopup="menu"` and `aria-expanded` kept in sync.
+             * Composed from `bs-popover` (anchor positioning, flipping, outside-click and Escape dismissal, open
+             * motion), `bs-menu` and `bs-menu-item` (slotted by you), and a `bs-button` / `bs-icon-button` trigger.
+             * ## When to use
+             * - A header or toolbar action that reveals a short list of commands ("More", "Account", "Sort by").
+             * ## When not to use
+             * - Free-form popup content such as forms or arbitrary panels (use `bs-popover`).
+             * - Choosing a value for a form field (use `bs-select`).
+             */
+            "bs-dropdown": LocalJSX.IntrinsicElements["bs-dropdown"] & JSXBase.HTMLAttributes<HTMLBsDropdownElement>;
             /**
              * 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.
@@ -17869,6 +20680,7 @@ declare module "@stencil/core" {
              * @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-size - Aliased to `--bs-font-size-xl` (`--bs-font-size-3xl` at `size="page"`).
              * @prop --bs-empty-state-heading-color - Aliased to `--bs-text-default`.
              * @prop --bs-empty-state-description-color - Aliased to `--bs-text-secondary`.
              */
@@ -17962,6 +20774,36 @@ declare module "@stencil/core" {
              * @prop --bs-grid-column-gap - Column gap. Overrides `--bs-grid-gap` and the `columnGap` prop's token.
              */
             "bs-grid": LocalJSX.IntrinsicElements["bs-grid"] & JSXBase.HTMLAttributes<HTMLBsGridElement>;
+            /**
+             * A heading whose rendered element and visual style are chosen separately: `level` (or `as`) picks
+             * the element for the document outline, `size` picks the look. Sizes map to the typography tokens
+             * (`--bs-font-size-*`, `--bs-font-weight-*`, `--bs-line-height-*`, `--bs-typography-font-family-heading`).
+             * Default sizes by level: 1 = 40px, 2 = 32px, 3 = 24px, 4 = 20px, 5 = 18px, 6 = 16px; `display` is 48px.
+             * Composed from: nothing (leaf).
+             * ## When to use
+             * - Any page or section title. Keep levels in order (no jumping from 1 to 4); change `size`, not `level`, to restyle.
+             * ## When not to use
+             * - Body copy, captions and labels: use `bs-text`.
+             * - To make text big without it being a heading: use `bs-text` with `as="p"`.
+             */
+            "bs-heading": LocalJSX.IntrinsicElements["bs-heading"] & JSXBase.HTMLAttributes<HTMLBsHeadingElement>;
+            /**
+             * A sized, coloured icon. Renders inline SVG from a named registry (`name`), or any SVG you slot in.
+             * Built-in names: `menu`, `arrow-right`, `arrow-left`, `check`, `close`, `chevron-down`,
+             * `external-link`, `copy`, `search`, plus Phosphor glyphs `user`, `star`, `star-fill`, `x`,
+             * `paper-plane-right`, `note-pencil`, `clock-counter-clockwise`, `arrows-out-simple` (256x256 filled). Add more with `registerIcons({ name: '<path d="..."/>' })`
+             * (exported from the package entry): each value is the inner markup of a 24x24, `currentColor`
+             * stroke icon, or pass `{ viewBox, body }` for a filled glyph on another grid.
+             * Decorative by default (`aria-hidden`). Set `label` when the icon alone conveys meaning; it is then
+             * exposed as an image with that name. An icon inside a button never needs `label`: name the button.
+             * Composed from: nothing (leaf). Used by `bs-code-block`.
+             * ## When to use
+             * - A glyph beside text or inside a button, sized and coloured from tokens.
+             * ## When not to use
+             * - As a control by itself: wrap it in `bs-icon-button`.
+             * - For a tinted status square: use `bs-icon-tile`.
+             */
+            "bs-icon": LocalJSX.IntrinsicElements["bs-icon"] & JSXBase.HTMLAttributes<HTMLBsIconElement>;
             /**
              * A clickable, icon-only action element -- the icon-only sibling of `bs-button`, sharing the same
              * 8 visual variants and color language, but ALWAYS rendering just a single icon, never a label.
@@ -18024,7 +20866,9 @@ declare module "@stencil/core" {
              * range of related "field" shapes (number stepper, password reveal, date, dropdown trigger,
              * select, textarea, chip input, initials, country, and pin) via the `type` prop, since they all
              * share the same label/description/error/icon-slot chrome.
-             * Built from: `bs-menu`/`bs-menu-item` (`type="dropdown"`) and `bs-chip-informative` + `bs-icon-button` (`type="chip"`).
+             * Built from: `bs-menu`/`bs-menu-item` (`type="dropdown"`), `bs-chip-informative` + `bs-icon-button` (`type="chip"`),
+             * and `bs-icon-button` + `bs-spinner` (`type="combobox"` clear button / loading indicator; its listbox is a
+             * hand-built `role="listbox"` because `bs-menu` is `role="menu"` and cannot host `option`s).
              * ## When to use
              * - Collecting a single line of free-text, email, password, or numeric input.
              * - Any of the other supported `type`s (search, date, dropdown, select, textarea, chip, initials,
@@ -18092,6 +20936,18 @@ declare module "@stencil/core" {
              * @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 navigation link: either text (inline within a sentence, or standalone with a 44px target) or a
+             * link styled as a primary button. Always renders a real `<a href>`.
+             * Built from: hand-built `<a>` (leaf). `bs-button` renders a `<button>` and has no `href`; nesting a
+             * button in an anchor is invalid HTML, so the `button` variant reuses the primary button's colour
+             * tokens instead. Known gap: add `href` support to `bs-button` and compose it here.
+             * ## When to use
+             * - Navigating to another page or an external resource.
+             * ## When not to use
+             * - Triggering an action on the current page (use `bs-button`).
+             */
+            "bs-link": LocalJSX.IntrinsicElements["bs-link"] & JSXBase.HTMLAttributes<HTMLBsLinkElement>;
             /**
              * A vertical list of `bs-list-item` rows, optionally single-select.
              * ## When to use
@@ -18101,6 +20957,9 @@ declare module "@stencil/core" {
              * - A popup list of actions -- use `bs-menu`.
              * - Navigation between app sections -- use `bs-navigation-drawer`.
              * - Multi-column, sortable or paged data -- use `bs-data-table`.
+             * `variant` switches between a plain list, a bulleted list and a numbered list; `dividers` gives a divided
+             * list. The list keeps real list semantics in every variant (`role="list"` with `listitem` rows); the bullet
+             * or number is drawn by the row and hidden from assistive technology, which announces position itself.
              * Built from `bs-list-item` children (light DOM; the list never moves nodes).
              * @prop --bs-list-gap - Gap between rows. Defaults to `0`.
              * @prop --bs-list-divider-color - Divider colour when `dividers` is set. Aliased to `--bs-border-neutral-container`.
@@ -18608,6 +21467,21 @@ 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>;
+            /**
+             * A labelled group of `bs-radio`s: a visible label, helper or error text, an accessible
+             * `role="radiogroup"`, and a single `value` for the whole set.
+             * The group gives its radios one shared `name` (its own `name`, or a generated one) so they behave
+             * as one native-style group: arrow keys move the selection (wrapping), only the checked radio is in
+             * the tab order, and checking one unchecks the others. It keeps at most one radio checked (the
+             * first one wins if several start checked).
+             * Composed from: `bs-radio` (slotted by you).
+             * ## When to use
+             * - A set of 2-5 mutually exclusive options that should all stay visible, with a shared label.
+             * ## When not to use
+             * - Independent yes/no choices: use `bs-checkbox-group`.
+             * - Many options: use a select or `bs-menu`.
+             */
+            "bs-radio-group": LocalJSX.IntrinsicElements["bs-radio-group"] & JSXBase.HTMLAttributes<HTMLBsRadioGroupElement>;
             /**
              * A touch-ripple effect: on pointer press, a circle grows from the press point and fades out.
              * It is a building block for pressable components (`bs-button`, `bs-icon-button`, ...), not something
@@ -18654,6 +21528,22 @@ declare module "@stencil/core" {
              * @prop --bs-search-item-icon-color - Aliased to `--bs-icon-default`.
              */
             "bs-search-item": LocalJSX.IntrinsicElements["bs-search-item"] & JSXBase.HTMLAttributes<HTMLBsSearchItemElement>;
+            /**
+             * A single-choice select: a field-shaped combobox that opens a scrollable listbox of options. Same
+             * label / helper text / error chrome as `bs-input`.
+             * Follows the WAI-ARIA select-only combobox pattern: focus stays on the combobox and the
+             * highlighted option is exposed through `aria-activedescendant`.
+             * Built from: the field/label/description/error styling language of `bs-input` (same `--bs-input-*`
+             * tokens). The listbox rows are hand-built leaf elements: `bs-menu-item` is a `role="menuitem"`
+             * button and `bs-popover` moves focus into its popup, neither of which fits the combobox/listbox
+             * pattern where focus must stay on the field.
+             * ## When to use
+             * - Choosing exactly one value from a known list of roughly 4-15 options.
+             * ## When not to use
+             * - 2-3 options that should all be visible (use radios or `bs-toggle-button-group`).
+             * - Very long or searchable lists (use `bs-input type="dropdown"` or a search pattern).
+             */
+            "bs-select": LocalJSX.IntrinsicElements["bs-select"] & JSXBase.HTMLAttributes<HTMLBsSelectElement>;
             /**
              * The three moments around an expiring session, as one card. Matches the Figma "Session timeout"
              * component's three types:
@@ -18738,6 +21628,22 @@ declare module "@stencil/core" {
              * @prop --bs-skeleton-duration - Pulse duration. Defaults to `1.5s`.
              */
             "bs-skeleton": LocalJSX.IntrinsicElements["bs-skeleton"] & JSXBase.HTMLAttributes<HTMLBsSkeletonElement>;
+            /**
+             * A "skip to main content" link: invisible until it receives keyboard focus, then shown at the top
+             * of the page. Activating it moves focus to the element its `href` points at, so keyboard and
+             * screen-reader users can bypass repeated navigation (WCAG 2.4.1 Bypass Blocks).
+             * Place it as the very first focusable element on the page. Renders a real `<a>`; the focus move is
+             * done explicitly (the target gets a temporary `tabindex="-1"` when it is not natively focusable),
+             * because a fragment navigation alone does not reliably move focus in every browser.
+             * ## When to use
+             * - Once per page, before the header/navigation, pointing at the `<main>` landmark.
+             * - Additionally before large repeated blocks (e.g. a long sidebar) pointing past them.
+             * ## When not to use
+             * - As a general in-page link -- use a plain link or `bs-table-of-contents`.
+             * - When the page has no repeated blocks before its main content.
+             * Composition: a leaf element (a single anchor); no existing `bs-*` component renders a link.
+             */
+            "bs-skip-link": LocalJSX.IntrinsicElements["bs-skip-link"] & JSXBase.HTMLAttributes<HTMLBsSkipLinkElement>;
             /**
              * A slider for picking a single numeric value (`type="default"`), a value snapped to evenly
              * spaced ticks (`type="segmented"`), or a min/max pair (`type="range"`) from within a bounded
@@ -18863,6 +21769,20 @@ declare module "@stencil/core" {
              * @prop --bs-stack-gap - Space between items. Defaults from the `gap` prop (`--bs-spacing-<gap>`); may be overridden directly.
              */
             "bs-stack": LocalJSX.IntrinsicElements["bs-stack"] & JSXBase.HTMLAttributes<HTMLBsStackElement>;
+            /**
+             * A key figure: a label, a large value and an optional trend (up, down or flat) with a change figure.
+             * ## When to use
+             * - Dashboard KPIs and summary numbers ("Active users 1,284, up 12%").
+             * ## When not to use
+             * - A time series or comparison of many values -- use a chart.
+             * - A progress toward a goal -- use `bs-progress` / `bs-progress-linear`.
+             * - A count on another element -- use `bs-badge`.
+             * **Built from:** `bs-card` (the surface).
+             * The trend is never conveyed by colour or arrow alone: a visually hidden prefix ("Increase of") is
+             * rendered before the change figure. Whether up is good depends on the metric, so the colour comes from
+             * `trendIntent` (default: up is positive, down is negative; set `negative` for e.g. churn going up).
+             */
+            "bs-stat": LocalJSX.IntrinsicElements["bs-stat"] & JSXBase.HTMLAttributes<HTMLBsStatElement>;
             /**
              * A sequence of named steps showing overall progress through a multi-step flow (e.g. a checkout,
              * an onboarding wizard) -- each step reads as enabled (not yet reached), current, done, error, or
@@ -18934,6 +21854,28 @@ declare module "@stencil/core" {
              * `role="tabpanel"` on the corresponding content panels.
              */
             "bs-tab": LocalJSX.IntrinsicElements["bs-tab"] & JSXBase.HTMLAttributes<HTMLBsTabElement>;
+            /**
+             * An "On this page" navigation: a nested list of in-page links with a scroll spy that marks the
+             * section currently in view (`aria-current="location"`), optionally sticky beside long content.
+             * Give it entries in either of two ways:
+             * - **`items` property** (a JS array, `{ label, href, children? }`) -- the data-driven way.
+             * - **Slotted anchors** -- `<a href="#intro">Intro</a>`, optionally inside nested `<ul>`/`<li>` or with
+             *   `data-level="2"` for sub-sections. The component reads them and renders its own styled links (the
+             *   slotted markup is not displayed; it is the no-JavaScript fallback). Used when `items` is empty.
+             * The scroll spy uses an `IntersectionObserver` on the elements the links point at. The current section
+             * is the first one (in link order) that intersects the top band of the viewport defined by `rootMargin`;
+             * when none does (between two sections) the previous one stays current. Observers are disconnected when
+             * the element is removed from the DOM and re-created when it is re-attached.
+             * Link targets are looked up by id in the same document (or shadow tree) as the component. Links whose
+             * target does not exist are still shown but never become current.
+             * ## When to use
+             * - Long single-page content (documentation, policies, settings pages) with several headed sections.
+             * ## When not to use
+             * - Navigating between pages -- use `bs-navigation-drawer` or `bs-breadcrumbs`.
+             * - Switching between panels of content that are not all on the page -- use `bs-tabs`.
+             * Composition: leaf element (a nav landmark with anchors); no existing `bs-*` component renders links.
+             */
+            "bs-table-of-contents": LocalJSX.IntrinsicElements["bs-table-of-contents"] & JSXBase.HTMLAttributes<HTMLBsTableOfContentsElement>;
             /**
              * A tab-group wrapper: owns `role="tablist"` and coordinates selection across its slotted
              * `<bs-tab>` or `<bs-inline-tab>` children, so consumers no longer have to hand-roll this.
@@ -18952,6 +21894,33 @@ declare module "@stencil/core" {
              *   directly.
              */
             "bs-tabs": LocalJSX.IntrinsicElements["bs-tabs"] & JSXBase.HTMLAttributes<HTMLBsTabsElement>;
+            /**
+             * A small label that categorises or annotates an item (a topic, a keyword, a status of a record). It can be
+             * neutral or coloured, optionally removable, and optionally a link.
+             * ## When to use
+             * - Metadata on a record: topics, categories, keywords, owners.
+             * - A removable tag in a list of applied values you edit one by one (`removable`).
+             * - A tag that leads to a filtered view or detail page (`href`).
+             * ## When not to use
+             * - A pure count or notification marker -- use `bs-badge`.
+             * - A read-only status pill with a leading icon -- use `bs-chip-informative`.
+             * - Toggling a filter on and off -- use `bs-chip-filter`; entering free text values -- use `bs-chip-input`.
+             * **Built from:** `bs-icon-button` (the remove control, `size="xs"`).
+             */
+            "bs-tag": LocalJSX.IntrinsicElements["bs-tag"] & JSXBase.HTMLAttributes<HTMLBsTagElement>;
+            /**
+             * Body and caption text mapped to the typography tokens, with the element (`as`) chosen separately
+             * from the look (`variant`) and the colour (`tone`).
+             * Variants: `lead` 18px, `body` 16px, `small` 14px, `caption` 12px (`--bs-font-size-*`,
+             * `--bs-typography-font-family-body`).
+             * Composed from: nothing (leaf).
+             * ## When to use
+             * - Paragraphs, helper copy, captions and inline spans that should follow the type scale and theme.
+             * ## When not to use
+             * - Headings: use `bs-heading` so the document outline is right.
+             * - Code: use `bs-code-block`.
+             */
+            "bs-text": LocalJSX.IntrinsicElements["bs-text"] & JSXBase.HTMLAttributes<HTMLBsTextElement>;
             /**
              * An inline time picker: hour and minute spinners (up/down carets, or the arrow keys on the value),
              * an AM/PM dropdown in 12-hour mode, a 24h switch, and Cancel/Confirm buttons. Matches the Figma
@@ -18980,6 +21949,56 @@ declare module "@stencil/core" {
              * auto-dismiss timing at all (it's a static visual spec), so this deliberately doesn't invent one.
              */
             "bs-toast": LocalJSX.IntrinsicElements["bs-toast"] & JSXBase.HTMLAttributes<HTMLBsToastElement>;
+            /**
+             * A button that is either pressed or not. Standalone it is a toggle (`aria-pressed`); inside a
+             * `bs-toggle-button-group` the group sets its `mode` (`toggle` for multiple choice, `radio` for
+             * single choice, which switches the semantics to `role="radio"` + `aria-checked`).
+             * Built from: hand-built `<button>` (the segment shape and pressed state differ from `bs-button`) plus
+             * `bs-ripple`.
+             * ## When to use
+             * - A two-state option such as "Bold", or a segment of a `bs-toggle-button-group`.
+             * ## When not to use
+             * - Triggering an action (use `bs-button`) or an on/off setting that applies immediately (use `bs-switch`).
+             */
+            "bs-toggle-button": LocalJSX.IntrinsicElements["bs-toggle-button"] & JSXBase.HTMLAttributes<HTMLBsToggleButtonElement>;
+            /**
+             * A segmented control: a row of `bs-toggle-button` segments with single or multiple choice.
+             * Single choice (default) uses radio semantics (`role="radiogroup"` / `role="radio"`) and arrow keys
+             * move focus AND selection. Multiple choice (`multiple`) uses `role="group"` with `aria-pressed`
+             * toggle buttons; arrow keys move focus only, Space/Enter toggles. Focus is roving in both modes
+             * (one tab stop).
+             * Built from: `bs-toggle-button`.
+             * ## When to use
+             * - 2-5 short, related options that should all stay visible (view mode, alignment, filters).
+             * ## When not to use
+             * - Long lists (use `bs-select`) or page-level navigation (use `bs-tabs`).
+             */
+            "bs-toggle-button-group": LocalJSX.IntrinsicElements["bs-toggle-button-group"] & JSXBase.HTMLAttributes<HTMLBsToggleButtonGroupElement>;
+            /**
+             * A bar of related controls (buttons, toggles, selects) with a left and a right group, grouped
+             * separators, a single tab stop and arrow-key navigation between the controls (WAI-ARIA toolbar
+             * pattern). Optionally, controls that do not fit collapse into a "more" menu.
+             * Keyboard: the toolbar is ONE tab stop. Left/Right arrows (Up/Down when `orientation="vertical"`,
+             * mirrored in RTL) move focus between the controls and wrap; Home/End jump to the first/last. The
+             * control last focused is the one Tab returns to. Disabled controls are skipped.
+             * Direct children of the `left`/`right` slots are the toolbar's controls. A slotted `bs-divider` is a
+             * separator: the toolbar sets its `orientation` perpendicular to its own and skips it when navigating.
+             * ## When to use
+             * - Several related actions that act on the same content (a text editor's formatting row, a table's
+             *   bulk actions, a viewer's zoom controls).
+             * ## When not to use
+             * - Navigating between pages or sections -- use `bs-tabs`, `bs-navigation-header` or a nav.
+             * - A single action or a form's submit row -- place the `bs-button`s directly.
+             * - A menu of actions that opens on demand -- use `bs-popover` with `bs-menu`.
+             * ## Overflow
+             * With `overflow` set (horizontal only), controls from the end of the bar that do not fit are hidden and
+             * listed in a `bs-menu` behind a "more" button; choosing an entry activates the original control. An
+             * entry's text is the control's `data-label`, else its `aria-label`, else its text content, else `title`:
+             * give icon-only controls one of these.
+             * Composition: built from `bs-icon-button`, `bs-popover`, `bs-menu` and `bs-menu-item` (overflow) and
+             * expects `bs-button`, `bs-icon-button`, `bs-divider` etc. as slotted content.
+             */
+            "bs-toolbar": LocalJSX.IntrinsicElements["bs-toolbar"] & JSXBase.HTMLAttributes<HTMLBsToolbarElement>;
             /**
              * A dark tooltip bubble with a pointer arrow, used to surface a short hint of extra information
              * next to a trigger element.