@brandsync/wc 1.18.0 → 1.20.0

package/REFERENCE.md

@@ -19,6 +19,11 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `caret` — The trailing caret wrapper.
 - `content` — The body content wrapper.
 
+### CSS custom properties
+
+- `--bs-accordion-duration` — Length of the expand/collapse motion. Aliased to `--bs-duration-default`.
+- `--bs-accordion-easing` — Curve of the expand/collapse motion. Aliased to `--bs-easing-standard`. Expanding and collapsing animate the body's height and rotate the caret. Under `prefers-reduced-motion: reduce` the duration token is `0ms`, so the body snaps.
+
 ## `<bs-accordion-group>`
 
 ### Slots
@@ -296,12 +301,13 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 
 ### Slots
 
-- `(default)` — Default slot: the button's label content.
+- `(default)` — Default slot: the button's label content. Built from: `bs-ripple` (press feedback).
 - `icon` — Optional leading icon, rendered before the label.
 - `end-icon` — Optional trailing icon, rendered after the label.
 
 ### Parts (`::part()`)
 
+- `ripple` — The press-ripple layer (a `bs-ripple`). Tune it with `bs-button::part(ripple) { --bs-ripple-color: ...; }` (also `--bs-ripple-opacity`, `--bs-ripple-duration`).
 - `icon` — The icon wrapper element.
 - `label` — The text label element.
 - `end-icon` — The trailing icon wrapper element.
@@ -309,17 +315,20 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 ### CSS custom properties
 
 - `--bs-button-radius` — Corner radius. Aliased to `--bs-border-radius-100` by default.
-- `--bs-button-padding-x-sm` — Left/right padding of a label-only button at `size="sm"`. Aliased to `--bs-spacing-300`.
+- `--bs-button-padding-x-sm` — Left/right padding of a label-only button at `size="sm"`. Aliased to `--bs-spacing-150` (12px).
+- `--bs-button-padding-x-md` — Left/right padding at `size="md"`. Aliased to `--bs-spacing-150` (12px).
+- `--bs-button-padding-x-lg` — Left/right padding at `size="lg"`. Aliased to `--bs-spacing-150` (12px).
 - `--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%; }`.
 - `--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.
-- `--bs-button-height-sm` — Height at `size="sm"`. Aliased to `--bs-spacing-500`.
-- `--bs-button-height-md` — Height at `size="md"`. Aliased to `--bs-spacing-600`.
-- `--bs-button-height-lg` — Height at `size="lg"`. Aliased to `--bs-spacing-700`.
+- `--bs-button-height-sm` — Height at `size="sm"`. Aliased to `--bs-spacing-400` (32px).
+- `--bs-button-height-md` — Height at `size="md"`. Aliased to `--bs-spacing-550` (44px).
+- `--bs-button-height-lg` — Height at `size="lg"`. Aliased to `--bs-spacing-600` (48px).
+- `--bs-button-outlined-color` — Label/icon colour, `variant="outlined"`, default. Aliased to `--bs-color-primary-default`.
 - `--bs-button-neutral-border` — Border color, `variant="neutral"`, default/disabled. Aliased to `--bs-border-neutral-container`.
 - `--bs-button-neutral-border-hover` — Border color, `variant="neutral"`, hover. Aliased to `--bs-border-neutral-container-hover`.
 - `--bs-button-neutral-border-pressed` — Border color, `variant="neutral"`, pressed. Aliased to `--bs-border-neutral-container-pressed`.
-- `--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`.
-- `--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`.
+- `--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`.
+- `--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-icon-button>`
 
@@ -329,7 +338,8 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 
 ### Parts (`::part()`)
 
-- `icon` — The icon wrapper element. // Note: this component's CSS Custom Properties (--bs-icon-button-*) are documented via @prop // comments in bs-icon-button.css, not here -- Stencil's docs generator only parses @prop out of // CSS file comments, not the class-level JSDoc (see bs-tab.css's/bs-inline-tab.css's equivalent note).
+- `icon` — The icon wrapper element.
+- `ripple` — The press-ripple layer (a `bs-ripple`). Tune it with `::part(ripple) { --bs-ripple-color: ...; }`. // Note: this component's CSS Custom Properties (--bs-icon-button-*) are documented via @prop // comments in bs-icon-button.css, not here -- Stencil's docs generator only parses @prop out of // CSS file comments, not the class-level JSDoc (see bs-tab.css's/bs-inline-tab.css's equivalent note).
 
 ## `<bs-button-skeleton>`
 
@@ -349,13 +359,14 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 ### Slots
 
 - `image` — Optional hero image across the top of the card, flush with its edges and clipped to its top corners. Presence of assigned content is what shows it -- doesn't affect layout when empty.
-- `header` — Optional heading content above the body.
+- `header` — Optional heading content above the body. ## Clickable and selectable cards Set `href` to make the whole card a link, or `selectable` to make it a toggle (`selected`, `aria-pressed`). The card stays a plain container with ONE real `<a>`/`<button>` (the "stretched link" pattern): the `header` slot is rendered inside it, so the header text is the accessible name (or set `label`), and it is stretched over the whole card, so the card is one tab stop and no interactive element is nested inside another. Controls in the `body`/`footer` slots stay individually clickable and focusable as long as they are *direct* children of the slot (`bs-button`, `a`, `button`, form controls); everything else in those slots passes clicks through to the card.
 - `(default)` — Default slot: the card's main body content.
 - `footer` — Optional actions/content below the body (e.g. a button).
 
 ### Parts (`::part()`)
 
 - `container` — The outer surface element.
+- `action` — The `<a>`/`<button>` that makes the card clickable (only when `href` or `selectable` is set).
 - `image` — The hero image wrapper (only visible when the `image` slot has content).
 - `header` — The header wrapper.
 - `body` — The body wrapper.
@@ -470,6 +481,7 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `regenerate` — The "Regenerate" icon button.
 - `menu` — The "More options" icon button.
 - `sources` — The "N sources" button (only rendered when `sourcesCount` is set).
+- `ripple` — The press-ripple layer (a `bs-ripple`). Tune it with `::part(ripple) { --bs-ripple-color: ...; }`.
 
 ### CSS custom properties
 
@@ -526,6 +538,7 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 ### Parts (`::part()`)
 
 - `button` — The button element.
+- `ripple` — The press-ripple layer (a `bs-ripple`). Tune it with `::part(ripple) { --bs-ripple-color: ...; }`.
 
 ### CSS custom properties
 
@@ -535,6 +548,9 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `--bs-chatbot-suggestion-button-bg-hover` — Background on hover. Aliased to `--bs-color-primary-container-hover`.
 - `--bs-chatbot-suggestion-button-bg-pressed` — Background when pressed. Aliased to `--bs-color-primary-container-pressed`.
 - `--bs-chatbot-suggestion-button-bg-focus` — Background when focused. Aliased to `--bs-color-primary-container-hover` (same as hover).
+- `--bs-chatbot-suggestion-button-bg-disabled` — Background when disabled. Aliased to `--bs-surface-action-disabled`.
+- `--bs-chatbot-suggestion-button-text-disabled` — Text color when disabled. Aliased to `--bs-text-on-disabled`.
+- `--bs-chatbot-suggestion-button-border-color-disabled` — Border color when disabled. Aliased to `--bs-border-neutral-disabled`.
 - `--bs-chatbot-suggestion-button-text-default` — Text color in the default state. Aliased to `--bs-text-action`.
 - `--bs-chatbot-suggestion-button-text-hover` — Text color on hover, pressed, and focus. Aliased to `--bs-text-action-hover`.
 - `--bs-chatbot-suggestion-button-focus-ring-color` — Focus ring color. Aliased to `--bs-border-primary-focus`.
@@ -565,7 +581,22 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 
 - `box` — The visual checkbox square.
 - `icon` — The check/minus icon shown inside the box when `checked` or `indeterminate`.
-- `label` — The label text wrapper. // Note: this component's CSS Custom Properties (--bs-checkbox-*) are documented via @prop comments // in bs-checkbox.css, not here -- Stencil's docs generator only parses @prop out of CSS file // comments, not the class-level JSDoc (see bs-input.tsx's equivalent note).
+- `label` — The label text wrapper.
+- `ripple` — The press-ripple halo (a `bs-ripple`). Tune it with `::part(ripple) { --bs-ripple-color: ...; }`. // Note: this component's CSS Custom Properties (--bs-checkbox-*) are documented via @prop comments // in bs-checkbox.css, not here -- Stencil's docs generator only parses @prop out of CSS file // comments, not the class-level JSDoc (see bs-input.tsx's equivalent note).
+
+## `<bs-checkbox-group>`
+
+### Slots
+
+- `(default)` — The `bs-checkbox` elements. Give each a `value`.
+
+### Parts (`::part()`)
+
+- `group` — The `fieldset`.
+- `label` — The `legend`.
+- `options` — The wrapper laying out the checkboxes (column, or row when `orientation="horizontal"`).
+- `description` — The helper text (hidden while `error` is set).
+- `error` — The error message.
 
 ## `<bs-chip-filter>`
 
@@ -579,6 +610,7 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `icon` — The icon wrapper element.
 - `label` — The text label element.
 - `caret` — The dropdown caret wrapper element, when `dropdown` is set.
+- `ripple` — The press-ripple layer (a `bs-ripple`). Tune it with `::part(ripple) { --bs-ripple-color: ...; }`.
 
 ## `<bs-chip-informative>`
 
@@ -605,6 +637,7 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `icon` — The icon wrapper element.
 - `label` — The text label element.
 - `remove` — The trailing remove button.
+- `ripple` — The press-ripple layer (a `bs-ripple`). Tune it with `::part(ripple) { --bs-ripple-color: ...; }`.
 
 ## `<bs-citation-preview>`
 
@@ -628,6 +661,22 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `--bs-citation-preview-snippet-radius` — Snippet corner radius. Aliased to `--bs-border-radius-100`.
 - `--bs-citation-preview-page-color` — Page label color. Aliased to `--bs-text-secondary`.
 
+## `<bs-code-block>`
+
+### Slots
+
+- `(default)` — Pre-highlighted code (any markup). Ignored when `code` is set.
+
+### Parts (`::part()`)
+
+- `container` — The `bs-card` surface (block mode).
+- `header` — The header row holding the filename and the Copy button.
+- `filename` — The filename text.
+- `copy-button` — The Copy `bs-button`.
+- `body` — The scrollable code area.
+- `line-numbers` — The line number gutter (when `lineNumbers` is set).
+- `code` — The `code` element (block and inline).
+
 ## `<bs-command-palette>`
 
 ### Slots
@@ -831,6 +880,10 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 
 ## `<bs-data-table>`
 
+### Slots
+
+- `cell-{row.id}-{column.key}` — Content for one cell (see "Rich cells"). Falls back to the text value.
+
 ### Parts (`::part()`)
 
 - `table` — The `<table>` element.
@@ -859,6 +912,43 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `outside` — A day from the previous/next month, in addition to `day`.
 - `today` — Today's day button, in addition to `day`.
 
+## `<bs-description-item>`
+
+### Slots
+
+- `term` — Rich content for the term (replaces `term`).
+- `(default)` — Rich content for the detail (replaces `description`).
+
+### Parts (`::part()`)
+
+- `container` — The `dl`.
+- `term` — The `dt`.
+- `description` — The `dd`.
+
+### CSS custom properties
+
+- `--bs-description-item-gap` — Gap between term and detail when stacked. Aliased to `--bs-spacing-25`.
+- `--bs-description-item-term-width` — Width of the term column when `layout="horizontal"`. `12rem`.
+- `--bs-description-item-column-gap` — Gap between the term and detail columns when horizontal. Aliased to `--bs-spacing-200`.
+- `--bs-description-item-padding-y` — Vertical padding. Aliased to `--bs-spacing-100`.
+- `--bs-description-item-term-color` — Aliased to `--bs-text-secondary`.
+- `--bs-description-item-description-color` — Aliased to `--bs-text-default`.
+
+## `<bs-description-list>`
+
+### Slots
+
+- `(default)` — The `bs-description-item` children.
+
+### Parts (`::part()`)
+
+- `list` — The list container (`role="group"`).
+
+### CSS custom properties
+
+- `--bs-description-list-divider-color` — Divider colour when `dividers` is set. Aliased to `--bs-border-neutral-container`.
+- `--bs-description-list-gap` — Gap between items. `0`.
+
 ## `<bs-dialog>`
 
 ### Slots
@@ -877,7 +967,7 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `header` — The header row (heading + close button, when the close button isn't floating).
 - `close` — The close button (inline in the header, or floating -- see the class doc above).
 - `body` — The body content wrapper.
-- `footer` — The footer wrapper (only visible when the footer slot has content).
+- `footer` — The footer wrapper (only visible when the footer slot has content). Opening fades the backdrop in and lifts the dialog into place; closing plays the same motion in reverse before the dialog is removed. Length, curve and travel are `--bs-dialog-duration`, `--bs-dialog-easing` and `--bs-dialog-distance`. Under `prefers-reduced-motion: reduce` it is instant.
 
 ## `<bs-divider>`
 
@@ -891,10 +981,22 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `--bs-divider-color` — Line colour. Aliased to `--bs-border-neutral-container` (`default`) or `--bs-neutral-100` (`subtle`).
 - `--bs-divider-inset` — Indent applied by `inset`. Aliased to `--bs-spacing-300`.
 
+## `<bs-dropdown>`
+
+### Slots
+
+- `trigger` — The control that toggles the menu (a `bs-button` or `bs-icon-button`).
+- `(default)` — Default slot: a `bs-menu` containing `bs-menu-item`s.
+
+### Parts (`::part()`)
+
+- `popover` — The underlying `bs-popover`; tune the popup with `::part(popover) { --bs-popover-min-width: ...; }`.
+
 ## `<bs-empty-state>`
 
 ### Slots
 
+- `illustration` — A larger illustration or image that replaces the icon tile (use with `size="page"`).
 - `icon` — The glyph inside the icon tile (24px, `currentColor`). Falls back to the tile's intent glyph.
 - `(default)` — The description (overrides the `description` prop).
 - `action` — An optional action, e.g. `<bs-button variant="outlined">`.
@@ -902,6 +1004,7 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 ### Parts (`::part()`)
 
 - `container` — The centered column.
+- `illustration` — The illustration wrapper (only rendered while the `illustration` slot is filled).
 - `icon` — The icon tile (`bs-icon-tile`).
 - `heading` — The heading element.
 - `description` — The description paragraph.
@@ -912,6 +1015,7 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `--bs-empty-state-padding-y` — Vertical padding. Aliased to `--bs-spacing-700` (56px).
 - `--bs-empty-state-padding-x` — Horizontal padding. Aliased to `--bs-spacing-300` (24px).
 - `--bs-empty-state-gap` — Gap between tile, heading, description and action. Aliased to `--bs-spacing-150`.
+- `--bs-empty-state-heading-size` — Aliased to `--bs-font-size-xl` (`--bs-font-size-3xl` at `size="page"`).
 - `--bs-empty-state-heading-color` — Aliased to `--bs-text-default`.
 - `--bs-empty-state-description-color` — Aliased to `--bs-text-secondary`.
 
@@ -1016,6 +1120,26 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `--bs-grid-row-gap` — Row gap. Overrides `--bs-grid-gap` and the `rowGap` prop's token.
 - `--bs-grid-column-gap` — Column gap. Overrides `--bs-grid-gap` and the `columnGap` prop's token.
 
+## `<bs-heading>`
+
+### Slots
+
+- `(default)` — The heading text.
+
+### Parts (`::part()`)
+
+- `heading` — The rendered heading element.
+
+## `<bs-icon>`
+
+### Slots
+
+- `(default)` — Optional SVG (or `img`) shown when `name` is not set or not registered. Sized to the icon; draw with `currentColor` to follow `tone`.
+
+### Parts (`::part()`)
+
+- `icon` — The wrapper around the glyph.
+
 ## `<bs-icon-tile>`
 
 ### Slots
@@ -1038,8 +1162,10 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 
 ### Parts (`::part()`)
 
-- `field` — The bordered field wrapper containing the icon(s) and native control(s). `type="initials"` renders this part on TWO separate elements instead of one (the title `<select>`'s own small box, and the name `<input>`'s own box) -- Figma specs these as two genuinely independent bordered containers with a gap between them, not one shared field the way every other composite type (`country` included) renders, so `::part(field)` reaches whichever of the two a given selector context matches, same "multiple elements, one shared part name" convention as `bs-attachment`'s own `star` part.
-- `menu` — The `bs-menu` rendered below the field for `type="dropdown"` when `open` and `options` is non-empty.
+- `field` — The bordered field wrapper containing the icon(s) and native control(s). `type="initials"` renders this part on TWO separate elements instead of one (the title picker's own small box, and the name `<input>`'s own box) -- Figma specs these as two genuinely independent bordered containers with a gap between them, not one shared field the way every other composite type renders, so `::part(field)` reaches whichever of the two a given selector context matches, same "multiple elements, one shared part name" convention as `bs-attachment`'s own `star` part.
+- `menu` — The `bs-menu` rendered below the field for `type="dropdown"` when `open` and `options` is non-empty; for `type="combobox"` the popup (listbox + status message) while `open`.
+- `option` — A single `role="option"` row of the `type="combobox"` listbox.
+- `clear` — The clear button (`bs-icon-button`) of `type="combobox"`.
 - `label` — The `<label>` element.
 - `required` — The red `*` rendered after the label text when `required` is set.
 - `icon` — The leading icon wrapper element.
@@ -1126,6 +1252,18 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `--bs-keyboard-shortcuts-color` — Main text colour. Aliased to `--bs-text-default`.
 - `--bs-keyboard-shortcuts-color-secondary` — Titles, captions, footer. Aliased to `--bs-text-secondary`.
 
+## `<bs-link>`
+
+### Slots
+
+- `(default)` — Default slot: the link text.
+
+### Parts (`::part()`)
+
+- `link` — The anchor element.
+- `label` — The text wrapper.
+- `icon` — The external-link icon. // Note: CSS Custom Properties (--bs-link-*) are documented via @prop comments in bs-link.css.
+
 ## `<bs-list>`
 
 ### Slots
@@ -1152,12 +1290,14 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 ### Parts (`::part()`)
 
 - `container` — The row.
+- `marker` — The bullet or number drawn by a bulleted / numbered `bs-list`.
 - `leading` — Wrapper around the leading slot.
 - `content` — The text column.
 - `label` — The label line.
 - `description` — The description line.
 - `support-text` — The support text line.
 - `trailing` — Wrapper around the trailing slot / caret.
+- `ripple` — The press-ripple layer (a `bs-ripple`). Tune it with `::part(ripple) { --bs-ripple-color: ...; }`.
 
 ### CSS custom properties
 
@@ -1222,6 +1362,9 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `--bs-mega-menu-heading-color` — Column headings. Aliased to `--bs-text-muted`.
 - `--bs-mega-menu-text-color` — Featured title. Aliased to `--bs-text-default`.
 - `--bs-mega-menu-muted-color` — Featured description and footer text. Aliased to `--bs-text-secondary`.
+- `--bs-mega-menu-duration` — Length of the open/close motion (`open` only). Aliased to `--bs-duration-default`.
+- `--bs-mega-menu-easing` — Curve of the open/close motion. Aliased to `--bs-easing-standard`.
+- `--bs-mega-menu-distance` — How far the panel drops while it fades. Aliased to `--bs-spacing-100`. Under `prefers-reduced-motion: reduce` (or a duration of `0ms`) setting `open` shows and hides the panel instantly.
 
 ## `<bs-menu>`
 
@@ -1281,6 +1424,7 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `item` — The button element.
 - `icon` — The icon wrapper.
 - `label` — The label wrapper.
+- `ripple` — The press-ripple layer (a `bs-ripple`). Tune it with `::part(ripple) { --bs-ripple-color: ...; }`.
 
 ### CSS custom properties
 
@@ -1423,6 +1567,7 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `page` — Each page-number button.
 - `current` — The current page's button (in addition to `page`).
 - `ellipsis` — Each collapsed-range indicator.
+- `ripple` — The press-ripple layer (a `bs-ripple`). Tune it with `::part(ripple) { --bs-ripple-color: ...; }`.
 
 ## `<bs-popover>`
 
@@ -1444,6 +1589,26 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `--bs-popover-offset` — Gap between trigger and popup. Aliased to `--bs-spacing-100`.
 - `--bs-popover-min-width` — Minimum popup width. Aliased to `--bs-scale-1600`.
 - `--bs-popover-z-index` — Popup stacking order. Aliased to `--bs-z-index-popover`.
+- `--bs-popover-duration` — Length of the open/close motion. Aliased to `--bs-duration-fast`.
+- `--bs-popover-easing` — Curve of the open/close motion. Aliased to `--bs-easing-standard`.
+- `--bs-popover-distance` — How far the popup nudges while it fades. Aliased to `--bs-spacing-50`. The popup fades and nudges toward its trigger when it opens and closes. Length, curve and travel are `--bs-popover-duration`, `--bs-popover-easing` and `--bs-popover-distance`; under `prefers-reduced-motion: reduce` it is instant.
+
+## `<bs-presence>`
+
+### Slots
+
+- `(default)` — The content to show and hide.
+
+### Parts (`::part()`)
+
+- `content` — The element that transitions. Style it with `::part(content)`.
+
+### CSS custom properties
+
+- `--bs-presence-duration` — Transition length. Set from the `duration` prop to a `--bs-duration-*` token.
+- `--bs-presence-easing` — Transition curve. Set from the `easing` prop to a `--bs-easing-*` token.
+- `--bs-presence-distance` — Travel distance for `slide-up` and `slide-down`. Aliased to `--bs-spacing-400`.
+- `--bs-presence-scale` — Closed scale for `scale`. No unitless scale token exists, so the default is `0.96`.
 
 ## `<bs-product-tour>`
 
@@ -1522,7 +1687,35 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 
 - `circle` — The visual radio ring.
 - `dot` — The center fill shown inside the ring when `checked`.
-- `label` — The label text wrapper. // Note: this component's CSS Custom Properties (--bs-radio-*) are documented via @prop comments // in bs-radio.css, not here -- Stencil's docs generator only parses @prop out of CSS file // comments, not the class-level JSDoc (see bs-checkbox.tsx's equivalent note).
+- `label` — The label text wrapper.
+- `ripple` — The press-ripple halo (a `bs-ripple`). Tune it with `::part(ripple) { --bs-ripple-color: ...; }`. // Note: this component's CSS Custom Properties (--bs-radio-*) are documented via @prop comments // in bs-radio.css, not here -- Stencil's docs generator only parses @prop out of CSS file // comments, not the class-level JSDoc (see bs-checkbox.tsx's equivalent note).
+
+## `<bs-radio-group>`
+
+### Slots
+
+- `(default)` — The `bs-radio` elements.
+
+### Parts (`::part()`)
+
+- `group` — The `role="radiogroup"` element.
+- `label` — The visible label.
+- `options` — The wrapper laying out the radios (column, or row when `orientation="horizontal"`).
+- `description` — The helper text (hidden while `error` is set).
+- `error` — The error message.
+
+## `<bs-ripple>`
+
+### Parts (`::part()`)
+
+- `surface` — The clipping layer the ripple circles are drawn in.
+
+### CSS custom properties
+
+- `--bs-ripple-color` — Ripple colour. `currentColor` by default, so it follows the parent's text colour and works on every variant.
+- `--bs-ripple-opacity` — Starting opacity of the ripple. No opacity token fits, so the default is `0.24`.
+- `--bs-ripple-duration` — Length of the ripple. Aliased to `--bs-duration-slower`.
+- `--bs-ripple-easing` — Curve of the ripple. Aliased to `--bs-easing-decelerate`.
 
 ## `<bs-search-item>`
 
@@ -1541,6 +1734,7 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `label` — The primary line.
 - `description` — The description line.
 - `trailing` — The trailing text wrapper.
+- `ripple` — The press-ripple layer (a `bs-ripple`). Tune it with `::part(ripple) { --bs-ripple-color: ...; }`.
 
 ### CSS custom properties
 
@@ -1557,6 +1751,19 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `--bs-search-item-color-disabled` — Aliased to `--bs-text-on-disabled`.
 - `--bs-search-item-icon-color` — Aliased to `--bs-icon-default`.
 
+## `<bs-select>`
+
+### Parts (`::part()`)
+
+- `label` — The label element.
+- `field` — The bordered combobox element.
+- `value` — The selected label (or placeholder).
+- `icon` — The chevron.
+- `listbox` — The popup listbox.
+- `option` — A single option row.
+- `description` — Helper text (hidden when `error` is set).
+- `error` — Error message. // Note: CSS Custom Properties (--bs-select-*) are documented via @prop comments in bs-select.css.
+
 ## `<bs-session-timeout>`
 
 ### Slots
@@ -1629,6 +1836,8 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `--bs-side-panel-overlay-bg` — Backdrop color. Aliased to `--bs-surface-overlay`.
 - `--bs-side-panel-color` — Text color. Aliased to `--bs-text-default`.
 - `--bs-side-panel-z-index` — Stacking order. Aliased to `--bs-z-index-modal`.
+- `--bs-side-panel-duration` — Length of the slide in/out. Aliased to `--bs-duration-slow`.
+- `--bs-side-panel-easing` — Curve of the slide in/out. Aliased to `--bs-easing-standard`.
 
 ## `<bs-skeleton>`
 
@@ -1647,6 +1856,16 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `--bs-skeleton-gap` — Gap between text lines. Aliased to `--bs-spacing-100`.
 - `--bs-skeleton-duration` — Pulse duration. Defaults to `1.5s`.
 
+## `<bs-skip-link>`
+
+### Slots
+
+- `(default)` — Default slot: the link text. Falls back to "Skip to main content".
+
+### Parts (`::part()`)
+
+- `link` — The anchor element. // Note: CSS Custom Properties (--bs-skip-link-*) are documented via @prop comments in bs-skip-link.css.
+
 ## `<bs-slider>`
 
 ### Parts (`::part()`)
@@ -1686,6 +1905,7 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `source` — The source system name.
 - `version` — The version label.
 - `arrow` — The trailing "open" arrow icon.
+- `ripple` — The press-ripple layer (a `bs-ripple`). Tune it with `::part(ripple) { --bs-ripple-color: ...; }`.
 
 ### CSS custom properties
 
@@ -1762,6 +1982,21 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 
 - `--bs-stack-gap` — Space between items. Defaults from the `gap` prop (`--bs-spacing-<gap>`); may be overridden directly.
 
+## `<bs-stat>`
+
+### Slots
+
+- `icon` — Optional leading icon next to the label.
+- `(default)` — Extra content below the value, e.g. a caption or a sparkline.
+
+### Parts (`::part()`)
+
+- `container` — The card surface (`bs-card`).
+- `label` — The label.
+- `value` — The value.
+- `trend` — The trend row (arrow and change figure).
+- `trend-icon` — The trend arrow.
+
 ## `<bs-stepper>`
 
 ### Slots
@@ -1792,7 +2027,8 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 
 - `track` — The visual pill-shaped track.
 - `knob` — The sliding circular knob.
-- `label` — The label text wrapper. // Note: this component's CSS Custom Properties are documented via @prop comments in // bs-switch.css, not here.
+- `label` — The label text wrapper.
+- `ripple` — The press-ripple halo (a `bs-ripple`). Tune it with `::part(ripple) { --bs-ripple-color: ...; }`. // Note: this component's CSS Custom Properties are documented via @prop comments in // bs-switch.css, not here.
 
 ## `<bs-inline-tab>`
 
@@ -1805,7 +2041,8 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 
 - `tab` — The button element.
 - `icon` — The icon wrapper.
-- `label` — The label wrapper. // Note: this component's CSS Custom Properties (--bs-inline-tab-*) are documented via @prop // comments in bs-inline-tab.css, not here -- Stencil's docs generator only parses @prop out of CSS // file comments, not the class-level JSDoc (see bs-tab.tsx's equivalent note).
+- `label` — The label wrapper.
+- `ripple` — The press-ripple layer (a `bs-ripple`). Tune it with `::part(ripple) { --bs-ripple-color: ...; }`. // Note: this component's CSS Custom Properties (--bs-inline-tab-*) are documented via @prop // comments in bs-inline-tab.css, not here -- Stencil's docs generator only parses @prop out of CSS // file comments, not the class-level JSDoc (see bs-tab.tsx's equivalent note).
 
 ## `<bs-tab>`
 
@@ -1821,7 +2058,8 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `icon` — The icon wrapper.
 - `label` — The label wrapper.
 - `badge` — The badge wrapper.
-- `indicator` — The selection/hover underline indicator. // Note: this component's CSS Custom Properties (--bs-tab-*) are documented via @prop comments in // bs-tab.css, not here -- Stencil's docs generator only parses @prop out of CSS file comments, not // the class-level JSDoc (see bs-checkbox.tsx's/bs-radio.tsx's equivalent note).
+- `indicator` — The selection/hover underline indicator.
+- `ripple` — The press-ripple layer (a `bs-ripple`). Tune it with `::part(ripple) { --bs-ripple-color: ...; }`. // Note: this component's CSS Custom Properties (--bs-tab-*) are documented via @prop comments in // bs-tab.css, not here -- Stencil's docs generator only parses @prop out of CSS file comments, not // the class-level JSDoc (see bs-checkbox.tsx's/bs-radio.tsx's equivalent note).
 
 ## `<bs-tabs>`
 
@@ -1833,6 +2071,44 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 
 - `tablist` — The wrapping element carrying `role="tablist"`. // Note: this component's CSS Custom Properties (--bs-tabs-*) are documented via @prop comments in // bs-tabs.css, not here -- Stencil's docs generator only parses @prop out of CSS file comments, not // the class-level JSDoc (see bs-tab.tsx's equivalent note).
 
+## `<bs-table-of-contents>`
+
+### Slots
+
+- `(default)` — Default slot: anchors (`<a href="#id">`) used as entries when `items` is empty. Not displayed.
+
+### Parts (`::part()`)
+
+- `container` — The `<nav>` landmark.
+- `title` — The visible heading (unless `hideTitle`).
+- `list` — Every `<ul>` (top level and nested).
+- `item` — Every `<li>`.
+- `link` — Every anchor. The current one also matches `[aria-current]`. // Note: CSS Custom Properties (--bs-toc-*) are documented via @prop comments in bs-table-of-contents.css.
+
+## `<bs-tag>`
+
+### Slots
+
+- `(default)` — The tag label.
+- `icon` — Optional leading icon (16px).
+
+### Parts (`::part()`)
+
+- `container` — The tag surface.
+- `icon` — The icon wrapper.
+- `label` — The label (a link when `href` is set).
+- `remove` — The remove button (`bs-icon-button`), only when `removable`.
+
+## `<bs-text>`
+
+### Slots
+
+- `(default)` — The text.
+
+### Parts (`::part()`)
+
+- `text` — The rendered text element.
+
 ## `<bs-timepicker>`
 
 ### Parts (`::part()`)
@@ -1864,6 +2140,44 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `message` — The message text wrapper.
 - `close` — The close button.
 
+## `<bs-toggle-button>`
+
+### Slots
+
+- `icon` — Optional leading icon (24x24). With no default-slot text the button is icon-only and needs `ariaLabel`.
+- `(default)` — Default slot: the label text.
+
+### Parts (`::part()`)
+
+- `button` — The native button.
+- `icon` — The icon wrapper.
+- `label` — The label wrapper.
+- `ripple` — The press-ripple (a `bs-ripple`). // Note: CSS Custom Properties (--bs-toggle-button-*) are documented via @prop comments in the css file.
+
+## `<bs-toggle-button-group>`
+
+### Slots
+
+- `(default)` — `bs-toggle-button` segments.
+
+### Parts (`::part()`)
+
+- `group` — The segmented container. // Note: segment styling is `bs-toggle-button`'s own --bs-toggle-button-* custom properties.
+
+## `<bs-toolbar>`
+
+### Slots
+
+- `left` — The left (leading) group of controls.
+- `right` — The right (trailing) group of controls; pushed to the far end of the bar.
+
+### Parts (`::part()`)
+
+- `container` — The element carrying `role="toolbar"`.
+- `left` — The wrapper around the `left` slot.
+- `right` — The wrapper around the `right` slot.
+- `overflow` — The overflow `bs-popover` (only rendered when `overflow` is set). // Note: CSS Custom Properties (--bs-toolbar-*) are documented via @prop comments in bs-toolbar.css.
+
 ## `<bs-tooltip>`
 
 ### Slots
@@ -1902,6 +2216,9 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 
 - `--bs-tooltip-trigger-offset` — Gap between trigger and tooltip. Aliased to `--bs-spacing-100`.
 - `--bs-tooltip-trigger-z-index` — Stacking order. Aliased to `--bs-z-index-popover`.
+- `--bs-tooltip-trigger-duration` — Length of the show/hide motion. Aliased to `--bs-duration-fast`.
+- `--bs-tooltip-trigger-easing` — Curve of the show/hide motion. Aliased to `--bs-easing-standard`.
+- `--bs-tooltip-trigger-distance` — How far the tooltip nudges while it fades. Aliased to `--bs-spacing-50`. The tooltip fades in while drifting a few pixels away from the trigger into place, and fades back out toward it. Under `prefers-reduced-motion: reduce` (or a duration of `0ms`) it appears and disappears instantly.
 
 ## `<bs-tree>`
 
@@ -1928,6 +2245,7 @@ Generated from component JSDoc by `scripts/generate-reference.mjs`. Do not edit
 - `icon` — The icon wrapper.
 - `label` — The label wrapper.
 - `group` — The `role="group"` wrapper around the child items (while expanded).
+- `ripple` — The press-ripple layer (a `bs-ripple`). Tune it with `::part(ripple) { --bs-ripple-color: ...; }`.
 
 ## `<bs-whats-new>`