@brandsync/wc 1.15.0 → 1.17.0

package/reference.json

@@ -1606,6 +1606,159 @@
       }
     ]
   },
+  "bs-command-palette": {
+    "slots": [
+      {
+        "kind": "slot",
+        "name": "recent",
+        "description": "`bs-search-item`s for the \"Recent\" section."
+      },
+      {
+        "kind": "slot",
+        "name": "suggested",
+        "description": "`bs-search-item`s for the \"Suggested\" section."
+      },
+      {
+        "kind": "slot",
+        "name": "commands",
+        "description": "`bs-search-item`s for the \"Commands\" section."
+      },
+      {
+        "kind": "slot",
+        "name": "navigation",
+        "description": "`bs-search-item`s for the \"Navigation\" section."
+      },
+      {
+        "kind": "slot",
+        "name": "records",
+        "description": "`bs-search-item`s for the \"Records\" section."
+      },
+      {
+        "kind": "slot",
+        "name": "try-instead",
+        "description": "`bs-search-item`s under \"Try instead\" in the no-results view (status `empty`)."
+      }
+    ],
+    "parts": [
+      {
+        "kind": "part",
+        "name": "dialog",
+        "description": "The native `<dialog>`."
+      },
+      {
+        "kind": "part",
+        "name": "panel",
+        "description": "The palette surface."
+      },
+      {
+        "kind": "part",
+        "name": "search",
+        "description": "The search bar row."
+      },
+      {
+        "kind": "part",
+        "name": "input",
+        "description": "The `bs-input`."
+      },
+      {
+        "kind": "part",
+        "name": "results",
+        "description": "The scrolling results area."
+      },
+      {
+        "kind": "part",
+        "name": "section",
+        "description": "One section (header and items)."
+      },
+      {
+        "kind": "part",
+        "name": "section-header",
+        "description": "A section header."
+      },
+      {
+        "kind": "part",
+        "name": "empty",
+        "description": "The no-results message block."
+      },
+      {
+        "kind": "part",
+        "name": "footer",
+        "description": "The footer row."
+      },
+      {
+        "kind": "part",
+        "name": "hint",
+        "description": "One keyboard hint (keycaps and text)."
+      }
+    ],
+    "cssProperties": [
+      {
+        "kind": "prop",
+        "name": "--bs-command-palette-width",
+        "description": "Panel width. Defaults to `640px` (Figma); capped to the viewport."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-command-palette-top",
+        "description": "Distance from the top of the viewport. Defaults to `12vh`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-command-palette-max-height",
+        "description": "Max height of the results area. Defaults to `60vh`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-command-palette-radius",
+        "description": "Aliased to `--bs-border-radius-150`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-command-palette-bg",
+        "description": "Panel background. Aliased to `--bs-surface-base`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-command-palette-shadow",
+        "description": "Figma elevation level 4: `0 8px 16px` in `--bs-elevation-higher` (stronger in dark mode)."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-command-palette-overlay",
+        "description": "Scrim colour. Aliased to `--bs-surface-overlay`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-command-palette-footer-bg",
+        "description": "Aliased to `--bs-surface-container`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-command-palette-divider-color",
+        "description": "Aliased to `--bs-border-default`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-command-palette-header-border-color",
+        "description": "Aliased to `--bs-border-neutral-container`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-command-palette-header-color",
+        "description": "Aliased to `--bs-text-muted`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-command-palette-hint-color",
+        "description": "Aliased to `--bs-text-secondary`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-command-palette-z-index",
+        "description": "Aliased to `--bs-z-index-modal`."
+      }
+    ]
+  },
   "bs-composer": {
     "slots": [
       {
@@ -2197,6 +2350,79 @@
       }
     ]
   },
+  "bs-empty-state": {
+    "slots": [
+      {
+        "kind": "slot",
+        "name": "icon",
+        "description": "The glyph inside the icon tile (24px, `currentColor`). Falls back to the tile's intent glyph."
+      },
+      {
+        "kind": "slot",
+        "name": "(default)",
+        "description": "The description (overrides the `description` prop)."
+      },
+      {
+        "kind": "slot",
+        "name": "action",
+        "description": "An optional action, e.g. `<bs-button variant=\"outlined\">`."
+      }
+    ],
+    "parts": [
+      {
+        "kind": "part",
+        "name": "container",
+        "description": "The centered column."
+      },
+      {
+        "kind": "part",
+        "name": "icon",
+        "description": "The icon tile (`bs-icon-tile`)."
+      },
+      {
+        "kind": "part",
+        "name": "heading",
+        "description": "The heading element."
+      },
+      {
+        "kind": "part",
+        "name": "description",
+        "description": "The description paragraph."
+      },
+      {
+        "kind": "part",
+        "name": "action",
+        "description": "The action wrapper (only rendered while the `action` slot is filled)."
+      }
+    ],
+    "cssProperties": [
+      {
+        "kind": "prop",
+        "name": "--bs-empty-state-padding-y",
+        "description": "Vertical padding. Aliased to `--bs-spacing-700` (56px)."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-empty-state-padding-x",
+        "description": "Horizontal padding. Aliased to `--bs-spacing-300` (24px)."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-empty-state-gap",
+        "description": "Gap between tile, heading, description and action. Aliased to `--bs-spacing-150`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-empty-state-heading-color",
+        "description": "Aliased to `--bs-text-default`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-empty-state-description-color",
+        "description": "Aliased to `--bs-text-secondary`."
+      }
+    ]
+  },
   "bs-error-page": {
     "slots": [
       {
@@ -2338,6 +2564,144 @@
     ],
     "cssProperties": []
   },
+  "bs-global-search": {
+    "slots": [
+      {
+        "kind": "slot",
+        "name": "recent",
+        "description": "`bs-search-item`s for the \"Recent searches\" section (status `default`)."
+      },
+      {
+        "kind": "slot",
+        "name": "jump-to",
+        "description": "`bs-search-item`s for the \"Jump to\" section (status `default`)."
+      },
+      {
+        "kind": "slot",
+        "name": "top-matches",
+        "description": "`bs-search-item`s for the \"Top matches\" section (status `results`)."
+      },
+      {
+        "kind": "slot",
+        "name": "search-in",
+        "description": "`bs-search-item`s for the \"Search in\" section (status `results`)."
+      },
+      {
+        "kind": "slot",
+        "name": "empty",
+        "description": "Replaces the whole empty-state block (status `empty`)."
+      },
+      {
+        "kind": "slot",
+        "name": "error",
+        "description": "Replaces the whole error-state block (status `error`)."
+      }
+    ],
+    "parts": [
+      {
+        "kind": "part",
+        "name": "field",
+        "description": "The combobox wrapper around the search field."
+      },
+      {
+        "kind": "part",
+        "name": "panel",
+        "description": "The dropdown panel."
+      },
+      {
+        "kind": "part",
+        "name": "section",
+        "description": "One section (header and items)."
+      },
+      {
+        "kind": "part",
+        "name": "section-header",
+        "description": "A section header."
+      },
+      {
+        "kind": "part",
+        "name": "empty",
+        "description": "The built-in empty or error state (`bs-empty-state`)."
+      },
+      {
+        "kind": "part",
+        "name": "footer",
+        "description": "The footer row."
+      },
+      {
+        "kind": "part",
+        "name": "hint",
+        "description": "One keyboard hint (keycaps and text)."
+      },
+      {
+        "kind": "part",
+        "name": "clear-recent",
+        "description": "The \"Clear recent\" button wrapper."
+      },
+      {
+        "kind": "part",
+        "name": "see-all",
+        "description": "The \"See all results\" button wrapper."
+      }
+    ],
+    "cssProperties": [
+      {
+        "kind": "prop",
+        "name": "--bs-global-search-width",
+        "description": "Field and panel width. Defaults to `480px` (Figma); capped at 100%."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-global-search-panel-radius",
+        "description": "Aliased to `--bs-border-radius-100`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-global-search-panel-padding",
+        "description": "Aliased to `--bs-spacing-100`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-global-search-gap",
+        "description": "Gap between sections, and between the field and the panel. Aliased to `--bs-spacing-100`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-global-search-panel-bg",
+        "description": "Panel background. Aliased to `--bs-surface-base`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-global-search-shadow",
+        "description": "Panel shadow: Figma elevation level 3 (`0 4px 8px` in `--bs-elevation-high`, 10% black in light mode and 30% in dark mode)."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-global-search-z-index",
+        "description": "Panel stacking. Aliased to `--bs-z-index-dropdown`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-global-search-divider-color",
+        "description": "Footer divider. Aliased to `--bs-border-default`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-global-search-header-border-color",
+        "description": "Section header underline. Aliased to `--bs-border-neutral-container`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-global-search-header-color",
+        "description": "Section header text. Aliased to `--bs-text-muted`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-global-search-hint-color",
+        "description": "Footer hint text. Aliased to `--bs-text-secondary`."
+      }
+    ]
+  },
   "bs-grid": {
     "slots": [
       {
@@ -2406,79 +2770,499 @@
   "bs-input": {
     "slots": [
       {
-        "kind": "slot",
-        "name": "icon",
-        "description": "Optional leading icon, rendered before the native control (e.g. a mail icon for an email field). For `type=\"search\"`, the slot is used if provided, otherwise a default magnifying-glass icon is shown."
+        "kind": "slot",
+        "name": "icon",
+        "description": "Optional leading icon, rendered before the native control (e.g. a mail icon for an email field). For `type=\"search\"`, the slot is used if provided, otherwise a default magnifying-glass icon is shown."
+      },
+      {
+        "kind": "slot",
+        "name": "end-icon",
+        "description": "Optional trailing icon, rendered after the native control (e.g. a chevron for a field that opens a picker). Ignored when `type` is `number` (stepper buttons), `password` (show/hide toggle), or `dropdown` (chevron) -- those types always render their own trailing control there. For `type=\"date\"`, the slot is used if provided, otherwise a default calendar icon is shown."
+      }
+    ],
+    "parts": [
+      {
+        "kind": "part",
+        "name": "field",
+        "description": "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."
+      },
+      {
+        "kind": "part",
+        "name": "menu",
+        "description": "The `bs-menu` rendered below the field for `type=\"dropdown\"` when `open` and `options` is non-empty."
+      },
+      {
+        "kind": "part",
+        "name": "label",
+        "description": "The `<label>` element."
+      },
+      {
+        "kind": "part",
+        "name": "required",
+        "description": "The red `*` rendered after the label text when `required` is set."
+      },
+      {
+        "kind": "part",
+        "name": "icon",
+        "description": "The leading icon wrapper element."
+      },
+      {
+        "kind": "part",
+        "name": "control",
+        "description": "The native control element (`<input>`, `<select>`, or `<textarea>` depending on `type`). Composite types (`initials`, `country`) render this part on more than one element."
+      },
+      {
+        "kind": "part",
+        "name": "end-icon",
+        "description": "The trailing icon wrapper element."
+      },
+      {
+        "kind": "part",
+        "name": "chip",
+        "description": "A single chip pill (a `bs-chip-informative`), when `type=\"chip\"`."
+      },
+      {
+        "kind": "part",
+        "name": "chip-remove",
+        "description": "A chip's remove button (a `bs-icon-button`), when `type=\"chip\"`."
+      },
+      {
+        "kind": "part",
+        "name": "description",
+        "description": "The helper text element (hidden when `error` is set)."
+      },
+      {
+        "kind": "part",
+        "name": "error",
+        "description": "The error message element."
+      },
+      {
+        "kind": "part",
+        "name": "error-icon",
+        "description": "The warning icon shown before the error message. // Note: this component's CSS Custom Properties (--bs-input-*) are documented via @prop comments // in bs-input.css, not here -- Stencil's docs generator only parses @prop out of CSS file // comments (see stencil.js's parseStyleDocs/parseCssComment), not the class-level JSDoc."
+      }
+    ],
+    "cssProperties": []
+  },
+  "bs-key": {
+    "slots": [
+      {
+        "kind": "slot",
+        "name": "(default)",
+        "description": "The key's label text (overrides the `label` prop), e.g. `Ctrl`."
+      },
+      {
+        "kind": "slot",
+        "name": "icon",
+        "description": "An icon shown instead of the label (16px), e.g. a return arrow."
+      }
+    ],
+    "parts": [
+      {
+        "kind": "part",
+        "name": "container",
+        "description": "The `<kbd>` cap."
+      },
+      {
+        "kind": "part",
+        "name": "label",
+        "description": "The label text wrapper (not rendered while the `icon` slot is filled)."
+      },
+      {
+        "kind": "part",
+        "name": "icon",
+        "description": "The icon wrapper (only rendered while the `icon` slot is filled)."
+      }
+    ],
+    "cssProperties": [
+      {
+        "kind": "prop",
+        "name": "--bs-key-bg",
+        "description": "Cap background. Aliased to `--bs-surface-base`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-key-border-color",
+        "description": "Cap border colour. Aliased to `--bs-border-default`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-key-radius",
+        "description": "Cap corner radius. Aliased to `--bs-border-radius-50`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-key-padding-x",
+        "description": "Horizontal padding. Aliased to `--bs-spacing-75`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-key-padding-y",
+        "description": "Vertical padding. Aliased to `--bs-spacing-50`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-key-min-width",
+        "description": "Smallest cap width, so single characters keep a keycap shape. Defaults to `25px` (Figma)."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-key-color",
+        "description": "Label colour. Aliased to `--bs-text-secondary`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-key-font-size",
+        "description": "Label size. Aliased to `--bs-font-size-xs` (12px)."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-key-icon-size",
+        "description": "Icon size. Defaults to `16px` (Figma)."
+      }
+    ]
+  },
+  "bs-key-caps": {
+    "slots": [
+      {
+        "kind": "slot",
+        "name": "(default)",
+        "description": "`bs-key` elements. A \"+\" separator is drawn before every key except the first."
+      }
+    ],
+    "parts": [
+      {
+        "kind": "part",
+        "name": "container",
+        "description": "The group wrapper."
+      }
+    ],
+    "cssProperties": [
+      {
+        "kind": "prop",
+        "name": "--bs-key-caps-gap",
+        "description": "Gap between keys and separators. Aliased to `--bs-spacing-100`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-key-caps-separator-color",
+        "description": "Colour of the \"+\" separators. Aliased to `--bs-text-muted`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-key-caps-disabled-opacity",
+        "description": "Opacity of the whole shortcut while `disabled`. Defaults to `0.38` (Figma)."
+      }
+    ]
+  },
+  "bs-keyboard-shortcuts": {
+    "slots": [
+      {
+        "kind": "slot",
+        "name": "heading",
+        "description": "Replaces the heading text."
+      },
+      {
+        "kind": "slot",
+        "name": "footer",
+        "description": "Replaces the footer hint."
+      }
+    ],
+    "parts": [
+      {
+        "kind": "part",
+        "name": "container",
+        "description": "The panel surface (a `bs-card`)."
+      },
+      {
+        "kind": "part",
+        "name": "head",
+        "description": "The heading row."
+      },
+      {
+        "kind": "part",
+        "name": "heading",
+        "description": "The heading element."
+      },
+      {
+        "kind": "part",
+        "name": "close",
+        "description": "The close button."
+      },
+      {
+        "kind": "part",
+        "name": "search",
+        "description": "The search field."
+      },
+      {
+        "kind": "part",
+        "name": "switch",
+        "description": "The single-key switch row."
+      },
+      {
+        "kind": "part",
+        "name": "groups",
+        "description": "The columns wrapper."
+      },
+      {
+        "kind": "part",
+        "name": "group",
+        "description": "One group."
+      },
+      {
+        "kind": "part",
+        "name": "group-title",
+        "description": "A group title."
+      },
+      {
+        "kind": "part",
+        "name": "row",
+        "description": "A shortcut row (`bs-shortcut-row`)."
+      },
+      {
+        "kind": "part",
+        "name": "empty",
+        "description": "The \"no results\" line."
+      },
+      {
+        "kind": "part",
+        "name": "footer",
+        "description": "The footer hint."
+      }
+    ],
+    "cssProperties": [
+      {
+        "kind": "prop",
+        "name": "--bs-keyboard-shortcuts-width",
+        "description": "Panel width and min-width. Defaults to `720px` (Figma)."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-keyboard-shortcuts-bg",
+        "description": "Panel background. Aliased to `--bs-surface-base`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-keyboard-shortcuts-radius",
+        "description": "Aliased to `--bs-border-radius-150`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-keyboard-shortcuts-padding",
+        "description": "Aliased to `--bs-spacing-200`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-keyboard-shortcuts-gap",
+        "description": "Gap between sections. Aliased to `--bs-spacing-200`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-keyboard-shortcuts-shadow",
+        "description": "Figma elevation level 4 (`0 8px 8px` in `--bs-elevation-higher`, 12% black in light mode and 25% in dark mode)."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-keyboard-shortcuts-column-gap",
+        "description": "Gap between the two columns. Aliased to `--bs-spacing-600`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-keyboard-shortcuts-color",
+        "description": "Main text colour. Aliased to `--bs-text-default`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-keyboard-shortcuts-color-secondary",
+        "description": "Titles, captions, footer. Aliased to `--bs-text-secondary`."
+      }
+    ]
+  },
+  "bs-list": {
+    "slots": [
+      {
+        "kind": "slot",
+        "name": "(default)",
+        "description": "The `bs-list-item` rows."
+      }
+    ],
+    "parts": [
+      {
+        "kind": "part",
+        "name": "list",
+        "description": "The list container."
+      }
+    ],
+    "cssProperties": [
+      {
+        "kind": "prop",
+        "name": "--bs-list-gap",
+        "description": "Gap between rows. Defaults to `0`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-list-divider-color",
+        "description": "Divider colour when `dividers` is set. Aliased to `--bs-border-neutral-container`."
+      }
+    ]
+  },
+  "bs-list-item": {
+    "slots": [
+      {
+        "kind": "slot",
+        "name": "leading",
+        "description": "Leading media: a `bs-avatar size=\"lg\"` (64px), a 32px icon, or a 72x56 `<img>`."
+      },
+      {
+        "kind": "slot",
+        "name": "trailing",
+        "description": "Replaces the default caret. Rendered when `showArrow` is set or the slot has content."
+      },
+      {
+        "kind": "slot",
+        "name": "(default)",
+        "description": "Rich content that replaces `label`, `description` and `supportText` entirely."
+      }
+    ],
+    "parts": [
+      {
+        "kind": "part",
+        "name": "container",
+        "description": "The row."
+      },
+      {
+        "kind": "part",
+        "name": "leading",
+        "description": "Wrapper around the leading slot."
+      },
+      {
+        "kind": "part",
+        "name": "content",
+        "description": "The text column."
+      },
+      {
+        "kind": "part",
+        "name": "label",
+        "description": "The label line."
+      },
+      {
+        "kind": "part",
+        "name": "description",
+        "description": "The description line."
+      },
+      {
+        "kind": "part",
+        "name": "support-text",
+        "description": "The support text line."
+      },
+      {
+        "kind": "part",
+        "name": "trailing",
+        "description": "Wrapper around the trailing slot / caret."
+      }
+    ],
+    "cssProperties": [
+      {
+        "kind": "prop",
+        "name": "--bs-list-item-min-height",
+        "description": "Minimum row height. Aliased to `--bs-spacing-1000`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-list-item-padding-y",
+        "description": "Aliased to `--bs-spacing-150`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-list-item-padding-x",
+        "description": "Aliased to `--bs-spacing-200`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-list-item-gap",
+        "description": "Gap between leading, content and trailing. Aliased to `--bs-spacing-200`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-list-item-content-gap",
+        "description": "Gap between text lines. Aliased to `--bs-spacing-25`."
       },
       {
-        "kind": "slot",
-        "name": "end-icon",
-        "description": "Optional trailing icon, rendered after the native control (e.g. a chevron for a field that opens a picker). Ignored when `type` is `number` (stepper buttons), `password` (show/hide toggle), or `dropdown` (chevron) -- those types always render their own trailing control there. For `type=\"date\"`, the slot is used if provided, otherwise a default calendar icon is shown."
-      }
-    ],
-    "parts": [
+        "kind": "prop",
+        "name": "--bs-list-item-radius",
+        "description": "Aliased to `--bs-border-radius-100`."
+      },
       {
-        "kind": "part",
-        "name": "field",
-        "description": "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."
+        "kind": "prop",
+        "name": "--bs-list-item-bg",
+        "description": "Enabled background. `transparent`."
       },
       {
-        "kind": "part",
-        "name": "menu",
-        "description": "The `bs-menu` rendered below the field for `type=\"dropdown\"` when `open` and `options` is non-empty."
+        "kind": "prop",
+        "name": "--bs-list-item-bg-hover",
+        "description": "Aliased to `--bs-surface-hover`."
       },
       {
-        "kind": "part",
-        "name": "label",
-        "description": "The `<label>` element."
+        "kind": "prop",
+        "name": "--bs-list-item-bg-pressed",
+        "description": "Aliased to `--bs-surface-pressed`."
       },
       {
-        "kind": "part",
-        "name": "required",
-        "description": "The red `*` rendered after the label text when `required` is set."
+        "kind": "prop",
+        "name": "--bs-list-item-bg-focus",
+        "description": "Aliased to `--bs-surface-focus`."
       },
       {
-        "kind": "part",
-        "name": "icon",
-        "description": "The leading icon wrapper element."
+        "kind": "prop",
+        "name": "--bs-list-item-bg-selected",
+        "description": "Aliased to `--bs-surface-selected`."
       },
       {
-        "kind": "part",
-        "name": "control",
-        "description": "The native control element (`<input>`, `<select>`, or `<textarea>` depending on `type`). Composite types (`initials`, `country`) render this part on more than one element."
+        "kind": "prop",
+        "name": "--bs-list-item-bg-selected-hover",
+        "description": "Aliased to `--bs-surface-selected-hover`."
       },
       {
-        "kind": "part",
-        "name": "end-icon",
-        "description": "The trailing icon wrapper element."
+        "kind": "prop",
+        "name": "--bs-list-item-bg-selected-pressed",
+        "description": "Aliased to `--bs-surface-selected-pressed`."
       },
       {
-        "kind": "part",
-        "name": "chip",
-        "description": "A single chip pill (a `bs-chip-informative`), when `type=\"chip\"`."
+        "kind": "prop",
+        "name": "--bs-list-item-bg-selected-focus",
+        "description": "Aliased to `--bs-surface-selected-focus`."
       },
       {
-        "kind": "part",
-        "name": "chip-remove",
-        "description": "A chip's remove button (a `bs-icon-button`), when `type=\"chip\"`."
+        "kind": "prop",
+        "name": "--bs-list-item-bg-disabled",
+        "description": "Aliased to `--bs-surface-action-disabled`."
       },
       {
-        "kind": "part",
-        "name": "description",
-        "description": "The helper text element (hidden when `error` is set)."
+        "kind": "prop",
+        "name": "--bs-list-item-color",
+        "description": "Text colour. Aliased to `--bs-text-default`."
       },
       {
-        "kind": "part",
-        "name": "error",
-        "description": "The error message element."
+        "kind": "prop",
+        "name": "--bs-list-item-color-disabled",
+        "description": "Aliased to `--bs-text-on-disabled`."
       },
       {
-        "kind": "part",
-        "name": "error-icon",
-        "description": "The warning icon shown before the error message. // Note: this component's CSS Custom Properties (--bs-input-*) are documented via @prop comments // in bs-input.css, not here -- Stencil's docs generator only parses @prop out of CSS file // comments (see stencil.js's parseStyleDocs/parseCssComment), not the class-level JSDoc."
+        "kind": "prop",
+        "name": "--bs-list-item-focus-ring",
+        "description": "Focus ring colour. Aliased to `--bs-border-neutral-focus`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-list-item-image-width",
+        "description": "Leading image width. 72px."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-list-item-image-height",
+        "description": "Leading image height. 56px."
       }
-    ],
-    "cssProperties": []
+    ]
   },
   "bs-logo": {
     "slots": [],
@@ -3218,6 +4002,124 @@
     ],
     "cssProperties": []
   },
+  "bs-search-item": {
+    "slots": [
+      {
+        "kind": "slot",
+        "name": "icon",
+        "description": "A leading glyph (24px, `currentColor`)."
+      },
+      {
+        "kind": "slot",
+        "name": "(default)",
+        "description": "The primary text. Wrap the matched part in `<strong>` or `<b>` to show it semibold."
+      },
+      {
+        "kind": "slot",
+        "name": "description",
+        "description": "An optional second line."
+      },
+      {
+        "kind": "slot",
+        "name": "trailing",
+        "description": "Trailing text (overrides the `trailing` prop)."
+      }
+    ],
+    "parts": [
+      {
+        "kind": "part",
+        "name": "container",
+        "description": "The row."
+      },
+      {
+        "kind": "part",
+        "name": "icon",
+        "description": "The icon wrapper."
+      },
+      {
+        "kind": "part",
+        "name": "content",
+        "description": "The text column."
+      },
+      {
+        "kind": "part",
+        "name": "label",
+        "description": "The primary line."
+      },
+      {
+        "kind": "part",
+        "name": "description",
+        "description": "The description line."
+      },
+      {
+        "kind": "part",
+        "name": "trailing",
+        "description": "The trailing text wrapper."
+      }
+    ],
+    "cssProperties": [
+      {
+        "kind": "prop",
+        "name": "--bs-search-item-min-height",
+        "description": "Aliased to `--bs-spacing-600` (48px)."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-search-item-padding-y",
+        "description": "Aliased to `--bs-spacing-100`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-search-item-padding-x",
+        "description": "Aliased to `--bs-spacing-150`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-search-item-gap",
+        "description": "Aliased to `--bs-spacing-100`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-search-item-radius",
+        "description": "Aliased to `--bs-border-radius-100`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-search-item-bg",
+        "description": "Resting background. `transparent`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-search-item-bg-active",
+        "description": "Active (highlighted) and hover background. Aliased to `--bs-surface-hover`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-search-item-bg-pressed",
+        "description": "Aliased to `--bs-surface-pressed`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-search-item-color",
+        "description": "Primary text. Aliased to `--bs-text-default`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-search-item-color-muted",
+        "description": "Description and trailing text. Aliased to `--bs-text-muted`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-search-item-color-disabled",
+        "description": "Aliased to `--bs-text-on-disabled`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-search-item-icon-color",
+        "description": "Aliased to `--bs-icon-default`."
+      }
+    ]
+  },
   "bs-session-timeout": {
     "slots": [
       {
@@ -3305,6 +4207,69 @@
     ],
     "cssProperties": []
   },
+  "bs-shortcut-row": {
+    "slots": [
+      {
+        "kind": "slot",
+        "name": "(default)",
+        "description": "The action label (overrides the `action` prop)."
+      },
+      {
+        "kind": "slot",
+        "name": "keys",
+        "description": "Your own `bs-key-caps` (or custom keys), replacing the generated one."
+      }
+    ],
+    "parts": [
+      {
+        "kind": "part",
+        "name": "container",
+        "description": "The row."
+      },
+      {
+        "kind": "part",
+        "name": "action",
+        "description": "The action label wrapper."
+      },
+      {
+        "kind": "part",
+        "name": "keys",
+        "description": "The wrapper around the key caps."
+      }
+    ],
+    "cssProperties": [
+      {
+        "kind": "prop",
+        "name": "--bs-shortcut-row-height",
+        "description": "Row height. Defaults to `36px` (Figma)."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-shortcut-row-padding-x",
+        "description": "Horizontal padding. Aliased to `--bs-spacing-100`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-shortcut-row-gap",
+        "description": "Gap between label and keys. Aliased to `--bs-spacing-100`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-shortcut-row-radius",
+        "description": "Corner radius. Aliased to `--bs-border-radius-75`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-shortcut-row-color",
+        "description": "Label colour. Aliased to `--bs-text-default`."
+      },
+      {
+        "kind": "prop",
+        "name": "--bs-shortcut-row-color-disabled",
+        "description": "Label colour while `disabled`. Aliased to `--bs-text-on-disabled`."
+      }
+    ]
+  },
   "bs-side-panel": {
     "slots": [
       {
@@ -4169,6 +5134,70 @@
       }
     ]
   },
+  "bs-tree": {
+    "slots": [
+      {
+        "kind": "slot",
+        "name": "(default)",
+        "description": "Default slot: top-level `bs-tree-item` elements (nested ones go inside their parent item)."
+      }
+    ],
+    "parts": [
+      {
+        "kind": "part",
+        "name": "container",
+        "description": "The `role=\"tree\"` wrapper."
+      }
+    ],
+    "cssProperties": []
+  },
+  "bs-tree-item": {
+    "slots": [
+      {
+        "kind": "slot",
+        "name": "(default)",
+        "description": "Default slot: child `bs-tree-item` elements (the subtree). Only rendered, inside a `role=\"group\"` wrapper, while the item is expanded; collapsed children are not accessible."
+      },
+      {
+        "kind": "slot",
+        "name": "label",
+        "description": "Overrides the `label` text."
+      },
+      {
+        "kind": "slot",
+        "name": "icon",
+        "description": "Overrides the default folder / file icon. Only used when `showIcon` is `true`."
+      }
+    ],
+    "parts": [
+      {
+        "kind": "part",
+        "name": "container",
+        "description": "The highlighted row pill (carries the hover / selected / focus states)."
+      },
+      {
+        "kind": "part",
+        "name": "caret",
+        "description": "The expand/collapse caret (parents only)."
+      },
+      {
+        "kind": "part",
+        "name": "icon",
+        "description": "The icon wrapper."
+      },
+      {
+        "kind": "part",
+        "name": "label",
+        "description": "The label wrapper."
+      },
+      {
+        "kind": "part",
+        "name": "group",
+        "description": "The `role=\"group\"` wrapper around the child items (while expanded)."
+      }
+    ],
+    "cssProperties": []
+  },
   "bs-whats-new": {
     "slots": [
       {