@brandsync/wc 1.14.0 → 1.16.0

package/custom-elements.json

@@ -513,6 +513,99 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-app-shell/bs-app-shell.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-app-shell",
+          "name": "BsAppShell",
+          "description": "The page frame: a header across the top, and below it a navigation | main | aside row, laid out\nwith CSS grid. The main column scrolls independently of the header and the side columns.\n\nLayout only. Compose it from the existing shell components: put a `bs-navigation-header`\n(usually `alignment=\"with-navigation-drawer\"`) in `header` and a `bs-navigation-drawer` in\n`navigation`. The drawer sizes itself (expanded or collapsed rail); the shell reserves an `auto`\ntrack for it, so there is no `navigationWidth` prop. `bs-navigation-header` has no `collapsed`\nprop, so there is no collapse state to mirror and the shell does not listen to `bsCollapse`: the\nauto track follows the drawer's width on its own.\n\nThe shell creates no landmarks besides `<main>`; the slotted header and drawer bring their own\n`banner` and `navigation` roles.\n\n## When to use\n- The outer frame of an application page with a header and side navigation.\n\n## When not to use\n- Content layout inside the page (use `bs-grid`) or resizable panes (use `bs-split-pane`).\n- Pages that already have their own `<main>`; the shell would add a duplicate landmark.",
+          "attributes": [
+            {
+              "name": "full-height",
+              "description": "When true the host is `height: 100%`; when false it is content-sized with `min-height: 100vh`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "fieldName": "fullHeight"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "fullHeight",
+              "description": "When true the host is `height: 100%`; when false it is content-sized with `min-height: 100vh`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "attribute": "full-height",
+              "reflects": true
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "The main content, rendered inside `<main>`; scrolls independently."
+            },
+            {
+              "name": "aside",
+              "description": "Optional right column."
+            },
+            {
+              "name": "header",
+              "description": "A `bs-navigation-header`, spanning the full width."
+            },
+            {
+              "name": "navigation",
+              "description": "A `bs-navigation-drawer`."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "aside",
+              "description": "Wrapper around the aside slot."
+            },
+            {
+              "name": "container",
+              "description": "The grid element."
+            },
+            {
+              "name": "header",
+              "description": "Wrapper around the header slot."
+            },
+            {
+              "name": "main",
+              "description": "The `<main>` element."
+            },
+            {
+              "name": "navigation",
+              "description": "Wrapper around the navigation slot."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsAppShell",
+          "declaration": {
+            "name": "BsAppShell"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-app-shell",
+          "declaration": {
+            "name": "BsAppShell"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/bs-attachment/bs-attachment.tsx",
@@ -5447,6 +5540,94 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-container/bs-container.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-container",
+          "name": "BsContainer",
+          "description": "A centred wrapper that limits content width to a breakpoint and adds horizontal padding.\n\n## When to use\n- Constraining page or section content to a readable, consistent maximum width.\n\n## When not to use\n- Arranging children relative to each other (use `bs-stack`).\n- Full-bleed regions such as hero backgrounds (use `size=\"fluid\"` or no container).",
+          "attributes": [
+            {
+              "name": "padding",
+              "description": "Spacing token name for horizontal padding (e.g. `300` => `--bs-spacing-300`). Invalid values fall back to `300`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'300'",
+              "fieldName": "padding"
+            },
+            {
+              "name": "size",
+              "description": "Maximum width, taken from the breakpoint tokens. `fluid` removes the limit.",
+              "type": {
+                "text": "\"2xl\" | \"fluid\" | \"lg\" | \"md\" | \"sm\" | \"xl\"",
+                "references": [
+                  {
+                    "name": "BsContainerSize"
+                  }
+                ]
+              },
+              "default": "'xl'",
+              "fieldName": "size"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "padding",
+              "description": "Spacing token name for horizontal padding (e.g. `300` => `--bs-spacing-300`). Invalid values fall back to `300`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'300'",
+              "attribute": "padding"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "description": "Maximum width, taken from the breakpoint tokens. `fluid` removes the limit.",
+              "type": {
+                "text": "\"2xl\" | \"fluid\" | \"lg\" | \"md\" | \"sm\" | \"xl\"",
+                "references": [
+                  {
+                    "name": "BsContainerSize"
+                  }
+                ]
+              },
+              "default": "'xl'",
+              "attribute": "size",
+              "reflects": true
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Content to constrain."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsContainer",
+          "declaration": {
+            "name": "BsContainer"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-container",
+          "declaration": {
+            "name": "BsContainer"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/bs-cookie-consent/bs-cookie-consent.tsx",
@@ -6847,6 +7028,155 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-divider/bs-divider.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-divider",
+          "name": "BsDivider",
+          "description": "A thin line that separates content, horizontally or vertically.\n\n## When to use\n- Separating groups of related content in a list, menu, toolbar or card.\n\n## When not to use\n- Adding vertical space between blocks (use `bs-stack` gap or spacing tokens).\n- Drawing a border around a surface (use `bs-card`).",
+          "attributes": [
+            {
+              "name": "decorative",
+              "description": "Purely visual: hides the divider from assistive technology instead of exposing a separator.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "decorative"
+            },
+            {
+              "name": "inset",
+              "description": "Indents the line from its start edge, or from both edges.",
+              "type": {
+                "text": "\"both\" | \"none\" | \"start\"",
+                "references": [
+                  {
+                    "name": "BsDividerInset"
+                  }
+                ]
+              },
+              "default": "'none'",
+              "fieldName": "inset"
+            },
+            {
+              "name": "orientation",
+              "description": "Direction of the line. A vertical divider stretches to the height of its container.",
+              "type": {
+                "text": "\"horizontal\" | \"vertical\"",
+                "references": [
+                  {
+                    "name": "BsDividerOrientation"
+                  }
+                ]
+              },
+              "default": "'horizontal'",
+              "fieldName": "orientation"
+            },
+            {
+              "name": "variant",
+              "description": "Visual weight of the line.",
+              "type": {
+                "text": "\"default\" | \"subtle\"",
+                "references": [
+                  {
+                    "name": "BsDividerVariant"
+                  }
+                ]
+              },
+              "default": "'default'",
+              "fieldName": "variant"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "decorative",
+              "description": "Purely visual: hides the divider from assistive technology instead of exposing a separator.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "decorative",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "inset",
+              "description": "Indents the line from its start edge, or from both edges.",
+              "type": {
+                "text": "\"both\" | \"none\" | \"start\"",
+                "references": [
+                  {
+                    "name": "BsDividerInset"
+                  }
+                ]
+              },
+              "default": "'none'",
+              "attribute": "inset",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "orientation",
+              "description": "Direction of the line. A vertical divider stretches to the height of its container.",
+              "type": {
+                "text": "\"horizontal\" | \"vertical\"",
+                "references": [
+                  {
+                    "name": "BsDividerOrientation"
+                  }
+                ]
+              },
+              "default": "'horizontal'",
+              "attribute": "orientation",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "variant",
+              "description": "Visual weight of the line.",
+              "type": {
+                "text": "\"default\" | \"subtle\"",
+                "references": [
+                  {
+                    "name": "BsDividerVariant"
+                  }
+                ]
+              },
+              "default": "'default'",
+              "attribute": "variant",
+              "reflects": true
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "line",
+              "description": "The visible line element."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsDivider",
+          "declaration": {
+            "name": "BsDivider"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-divider",
+          "declaration": {
+            "name": "BsDivider"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/bs-error-page/bs-error-page.tsx",
@@ -7788,29 +8118,198 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/bs-button/bs-icon-button/bs-icon-button.tsx",
+      "path": "src/components/bs-grid/bs-grid.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bs-icon-button",
-          "name": "BsIconButton",
-          "description": "A clickable, icon-only action element -- the icon-only sibling of `bs-button`, sharing the same\n8 visual variants and color language, but ALWAYS rendering just a single icon, never a label.\n\n## When to use\n- A compact action where the icon alone is unambiguous (e.g. a close/dismiss control, a toolbar\n  action) and adding a text label would take up more space than the context allows.\n- The same variant guidance as `bs-button` applies: `primary` for the single most important\n  action, `neutral`/`subtle`/`outlined` for lower-emphasis alternatives, `error` reserved for\n  destructive/irreversible actions (never `neutral`, per BrandSync guidance), `success`/\n  `warning`/`info` only when the action's own outcome is predictable and clearly communicated.\n\n## When not to use\n- When the action isn't self-evident from the icon alone -- use `bs-button` with a visible label\n  instead, don't rely on a tooltip to compensate for an unclear icon.\n- For navigation between pages -- use a link/nav component instead.\n\nBecause this component is always icon-only, `ariaLabel` is required for every real usage (not\njust conditionally, unlike `bs-button`) -- there's no visible label text to fall back on for an\naccessible name.",
+          "tagName": "bs-grid",
+          "name": "BsGrid",
+          "description": "A CSS grid layout wrapper. Children are placed in equal-width columns with a token-based gap.\n\n`columns` takes either a number (`\"3\"` becomes `repeat(3, minmax(0, 1fr))`) or any raw\n`grid-template-columns` value (`\"200px 1fr\"`). `minColumnWidth` is the responsive mechanism: it\nswitches to `repeat(auto-fit, minmax(min(100%, X), 1fr))`, so the column count adapts to the\ncontainer width and `columns` is ignored. There are deliberately no per-breakpoint props in v1.\n\n`gap`, `rowGap` and `columnGap` take spacing token names (`\"200\"` maps to `var(--bs-spacing-200)`);\nunknown names fall back to `100`.\n\n## When to use\n- Card grids, form field grids and dashboards where items share equal column tracks.\n- Responsive galleries via `minColumnWidth`.\n\n## When not to use\n- A single row or column of items with no wrapping (plain flex).\n- Resizable multi-pane layouts (use `bs-split-pane`) or the page frame (use `bs-app-shell`).",
           "attributes": [
             {
-              "name": "aria-label",
-              "description": "Accessible name for the button. Required -- this component is always icon-only, so there's\nno visible label text for screen readers to fall back on. Stencil reflects this camelCase\nprop to the `aria-label` HTML attribute automatically.",
+              "name": "align",
+              "description": "Block-axis alignment of items within their cell.",
               "type": {
-                "text": "string"
+                "text": "\"center\" | \"end\" | \"start\" | \"stretch\"",
+                "references": [
+                  {
+                    "name": "BsGridAlign"
+                  }
+                ]
               },
-              "default": "null",
-              "fieldName": "ariaLabel"
+              "default": "'stretch'",
+              "fieldName": "align"
             },
             {
-              "name": "disabled",
-              "description": "Disables the button and applies the disabled token set.",
+              "name": "column-gap",
+              "description": "Spacing token name for the column gap; overrides `gap` for columns.",
               "type": {
-                "text": "boolean"
+                "text": "string"
+              },
+              "fieldName": "columnGap"
+            },
+            {
+              "name": "columns",
+              "description": "A number of equal columns (`\"3\"`), or a raw `grid-template-columns` value. Ignored when `minColumnWidth` is set.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'1'",
+              "fieldName": "columns"
+            },
+            {
+              "name": "gap",
+              "description": "Spacing token name for the gap on both axes, e.g. `\"200\"` for `--bs-spacing-200`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'100'",
+              "fieldName": "gap"
+            },
+            {
+              "name": "min-column-width",
+              "description": "CSS length (e.g. `240px`). Switches to auto-fit columns at least this wide and overrides `columns`.",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "minColumnWidth"
+            },
+            {
+              "name": "row-gap",
+              "description": "Spacing token name for the row gap; overrides `gap` for rows.",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "rowGap"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "align",
+              "description": "Block-axis alignment of items within their cell.",
+              "type": {
+                "text": "\"center\" | \"end\" | \"start\" | \"stretch\"",
+                "references": [
+                  {
+                    "name": "BsGridAlign"
+                  }
+                ]
+              },
+              "default": "'stretch'",
+              "attribute": "align",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "columnGap",
+              "description": "Spacing token name for the column gap; overrides `gap` for columns.",
+              "type": {
+                "text": "string"
+              },
+              "attribute": "column-gap",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "columns",
+              "description": "A number of equal columns (`\"3\"`), or a raw `grid-template-columns` value. Ignored when `minColumnWidth` is set.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'1'",
+              "attribute": "columns",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "gap",
+              "description": "Spacing token name for the gap on both axes, e.g. `\"200\"` for `--bs-spacing-200`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'100'",
+              "attribute": "gap",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "minColumnWidth",
+              "description": "CSS length (e.g. `240px`). Switches to auto-fit columns at least this wide and overrides `columns`.",
+              "type": {
+                "text": "string"
+              },
+              "attribute": "min-column-width",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "rowGap",
+              "description": "Spacing token name for the row gap; overrides `gap` for rows.",
+              "type": {
+                "text": "string"
+              },
+              "attribute": "row-gap",
+              "reflects": true
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "The grid items."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "container",
+              "description": "The grid element that holds the slotted items."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsGrid",
+          "declaration": {
+            "name": "BsGrid"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-grid",
+          "declaration": {
+            "name": "BsGrid"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-button/bs-icon-button/bs-icon-button.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-icon-button",
+          "name": "BsIconButton",
+          "description": "A clickable, icon-only action element -- the icon-only sibling of `bs-button`, sharing the same\n8 visual variants and color language, but ALWAYS rendering just a single icon, never a label.\n\n## When to use\n- A compact action where the icon alone is unambiguous (e.g. a close/dismiss control, a toolbar\n  action) and adding a text label would take up more space than the context allows.\n- The same variant guidance as `bs-button` applies: `primary` for the single most important\n  action, `neutral`/`subtle`/`outlined` for lower-emphasis alternatives, `error` reserved for\n  destructive/irreversible actions (never `neutral`, per BrandSync guidance), `success`/\n  `warning`/`info` only when the action's own outcome is predictable and clearly communicated.\n\n## When not to use\n- When the action isn't self-evident from the icon alone -- use `bs-button` with a visible label\n  instead, don't rely on a tooltip to compensate for an unclear icon.\n- For navigation between pages -- use a link/nav component instead.\n\nBecause this component is always icon-only, `ariaLabel` is required for every real usage (not\njust conditionally, unlike `bs-button`) -- there's no visible label text to fall back on for an\naccessible name.",
+          "attributes": [
+            {
+              "name": "aria-label",
+              "description": "Accessible name for the button. Required -- this component is always icon-only, so there's\nno visible label text for screen readers to fall back on. Stencil reflects this camelCase\nprop to the `aria-label` HTML attribute automatically.",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "fieldName": "ariaLabel"
+            },
+            {
+              "name": "disabled",
+              "description": "Disables the button and applies the disabled token set.",
+              "type": {
+                "text": "boolean"
               },
               "default": "false",
               "fieldName": "disabled"
@@ -9235,148 +9734,115 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/bs-logo/bs-logo.tsx",
+      "path": "src/components/bs-list/bs-list.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bs-logo",
-          "name": "BsLogo",
-          "description": "The BrandSync brand mark, as its own standalone component -- shared by `bs-navigation-header`\nand `bs-navigation-drawer`, which used to each render their own duplicated copy of this SVG\n(the drawer's collapsed state even faked an icon-only look by clipping the full wordmark asset\ndown to a narrowed box, rather than using a real icon-only asset).\n\n## When to use\n- Anywhere the BrandSync logo/icon needs to render: a navigation header, a nav drawer, etc.\n\n## When not to use\n- The Genie AI chat panel's own brand mark -- that's a different logo (`bs-chatbot-header`'s\n  own inline Genie asset), not this one.\n\n`variant` mirrors Figma's \"Logo\" component set (node 10909:30421) `Device` property\n(\"Desktop\" / \"Tab and mobile\"), which was originally meant to distinguish the full lockup from\nthe icon-only mark at different responsive breakpoints -- renamed here to\n`variant: 'full' | 'mark'` since that's what it actually controls (how much of the logo\nrenders), not literally a device/breakpoint switch.\n\n`variant=\"custom\"` is not a Figma variant at all -- it's an escape hatch for a consuming app\nthat needs to show a DIFFERENT product's logo in the same slot (e.g. a white-labeled deployment,\nor a logo fetched at runtime from a service like brand.dev), via `src`/`alt`, instead of the\nbuilt-in BrandSync assets. This component deliberately does NOT fetch that image itself --\nnetwork calls, loading/error states, and caching are the consuming app's responsibility, same as\nevery other component in this library (e.g. `bs-attachment` takes `imageSrc` rather than fetching\nan image on its own). `background` has no effect on `variant=\"custom\"` -- a consumer's own image\nis already designed for whatever surface it's placed on.",
+          "tagName": "bs-list",
+          "name": "BsList",
+          "description": "A vertical list of `bs-list-item` rows, optionally single-select.\n\n## When to use\n- Records, people, files or options shown as rows with leading media and descriptions.\n- `selectable` for a single-choice list (e.g. a conversation list next to a detail pane).\n\n## When not to use\n- A popup list of actions -- use `bs-menu`.\n- Navigation between app sections -- use `bs-navigation-drawer`.\n- Multi-column, sortable or paged data -- use `bs-data-table`.\n\nBuilt from `bs-list-item` children (light DOM; the list never moves nodes).",
           "attributes": [
             {
-              "name": "alt",
-              "description": "`variant=\"custom\"` only: accessible alt text for the image -- a product logo is meaningful\ncontent (whose brand is this?), not decorative, so set this to something real (e.g. the\nproduct/company name). Falls back to `alt=\"\"` (marking the image decorative to assistive\ntech) when unset, rather than omitting the `alt` attribute entirely -- an `<img>` with no\n`alt` attribute at all is a harder accessibility failure than one explicitly marked\ndecorative, but an empty fallback is still worse than a real name, so don't rely on it.\nIgnored for `full`/`mark` (those already carry their own fixed `aria-label=\"BrandSync\"`).",
+              "name": "aria-label",
+              "description": "Accessible name of the list.",
               "type": {
                 "text": "string"
               },
               "default": "null",
-              "fieldName": "alt"
+              "fieldName": "ariaLabel"
             },
             {
-              "name": "background",
-              "description": "Which pre-built asset to use for `variant=\"full\"` -- Figma ships a genuinely separate,\ndifferently-drawn dark-background asset (every wordmark path filled solid white, and the\nicon's outer shape a single solid-white path instead of the light version's two-path\nwhite-fill-plus-border-ring), not a CSS currentColor swap of identical paths.\n\n`\"auto\"` (default) renders both assets and lets CSS pick one via\n`--bs-logo-asset-light-display`/`--bs-logo-asset-dark-display` (defined in\n`src/global/base.css`, flipped by the same `[data-theme=\"dark\"]` attribute every other\n`--bs-*` token already reacts to) -- so the logo just follows the ambient theme with no wiring\nneeded, the same way a consuming app's own dark mode already re-themes every other part of\nthis library via ordinary CSS custom property inheritance. Set `\"light\"`/`\"dark\"` explicitly\nto pin one regardless of the ambient theme -- e.g. a dark sidebar that isn't otherwise\ndark-themed.\n\nHas no effect on `variant=\"mark\"`: Figma's component set only has one real designed instance\nof the icon-only mark (`Device=\"Tab and mobile\"`, `Background=\"Default\"`) -- there's no\nseparate dark version of it, so the mark renders identically regardless of this prop.",
+              "name": "dividers",
+              "description": "Draws a 1px separator between rows.",
               "type": {
-                "text": "\"auto\" | \"dark\" | \"light\"",
-                "references": [
-                  {
-                    "name": "BsLogoBackground"
-                  }
-                ]
+                "text": "boolean"
               },
-              "default": "'auto'",
-              "fieldName": "background"
+              "default": "false",
+              "fieldName": "dividers"
             },
             {
-              "name": "src",
-              "description": "`variant=\"custom\"` only: the image URL to render (e.g. a URL your app already fetched from a\nlogo API). Ignored for `full`/`mark`.",
+              "name": "selectable",
+              "description": "Single-selection mode: role=\"listbox\", rows are `option`s with roving tabindex.",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "null",
-              "fieldName": "src"
+              "default": "false",
+              "fieldName": "selectable"
             },
             {
-              "name": "variant",
-              "description": "How much of the logo to render. `full` is the icon + \"EG BrandSync\" wordmark (190.977x44\nnatural size); `mark` is just the icon (44x44 natural size), no wordmark; `custom` renders a\nconsumer-supplied image via `src`/`alt` instead of a built-in BrandSync asset -- see the class\ndoc above.",
+              "name": "value",
+              "description": "`value` of the selected item (selectable mode).",
               "type": {
-                "text": "\"custom\" | \"full\" | \"mark\"",
-                "references": [
-                  {
-                    "name": "BsLogoVariant"
-                  }
-                ]
+                "text": "string"
               },
-              "default": "'full'",
-              "fieldName": "variant"
+              "default": "null",
+              "fieldName": "value"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "alt",
-              "description": "`variant=\"custom\"` only: accessible alt text for the image -- a product logo is meaningful\ncontent (whose brand is this?), not decorative, so set this to something real (e.g. the\nproduct/company name). Falls back to `alt=\"\"` (marking the image decorative to assistive\ntech) when unset, rather than omitting the `alt` attribute entirely -- an `<img>` with no\n`alt` attribute at all is a harder accessibility failure than one explicitly marked\ndecorative, but an empty fallback is still worse than a real name, so don't rely on it.\nIgnored for `full`/`mark` (those already carry their own fixed `aria-label=\"BrandSync\"`).",
+              "name": "ariaLabel",
+              "description": "Accessible name of the list.",
               "type": {
                 "text": "string"
               },
               "default": "null",
-              "attribute": "alt"
+              "attribute": "aria-label"
             },
             {
               "kind": "field",
-              "name": "background",
-              "description": "Which pre-built asset to use for `variant=\"full\"` -- Figma ships a genuinely separate,\ndifferently-drawn dark-background asset (every wordmark path filled solid white, and the\nicon's outer shape a single solid-white path instead of the light version's two-path\nwhite-fill-plus-border-ring), not a CSS currentColor swap of identical paths.\n\n`\"auto\"` (default) renders both assets and lets CSS pick one via\n`--bs-logo-asset-light-display`/`--bs-logo-asset-dark-display` (defined in\n`src/global/base.css`, flipped by the same `[data-theme=\"dark\"]` attribute every other\n`--bs-*` token already reacts to) -- so the logo just follows the ambient theme with no wiring\nneeded, the same way a consuming app's own dark mode already re-themes every other part of\nthis library via ordinary CSS custom property inheritance. Set `\"light\"`/`\"dark\"` explicitly\nto pin one regardless of the ambient theme -- e.g. a dark sidebar that isn't otherwise\ndark-themed.\n\nHas no effect on `variant=\"mark\"`: Figma's component set only has one real designed instance\nof the icon-only mark (`Device=\"Tab and mobile\"`, `Background=\"Default\"`) -- there's no\nseparate dark version of it, so the mark renders identically regardless of this prop.",
+              "name": "dividers",
+              "description": "Draws a 1px separator between rows.",
               "type": {
-                "text": "\"auto\" | \"dark\" | \"light\"",
-                "references": [
-                  {
-                    "name": "BsLogoBackground"
-                  }
-                ]
+                "text": "boolean"
               },
-              "default": "'auto'",
-              "attribute": "background"
+              "default": "false",
+              "attribute": "dividers",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "src",
-              "description": "`variant=\"custom\"` only: the image URL to render (e.g. a URL your app already fetched from a\nlogo API). Ignored for `full`/`mark`.",
+              "name": "selectable",
+              "description": "Single-selection mode: role=\"listbox\", rows are `option`s with roving tabindex.",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "null",
-              "attribute": "src"
+              "default": "false",
+              "attribute": "selectable"
             },
             {
               "kind": "field",
-              "name": "variant",
-              "description": "How much of the logo to render. `full` is the icon + \"EG BrandSync\" wordmark (190.977x44\nnatural size); `mark` is just the icon (44x44 natural size), no wordmark; `custom` renders a\nconsumer-supplied image via `src`/`alt` instead of a built-in BrandSync asset -- see the class\ndoc above.",
+              "name": "value",
+              "description": "`value` of the selected item (selectable mode).",
               "type": {
-                "text": "\"custom\" | \"full\" | \"mark\"",
-                "references": [
-                  {
-                    "name": "BsLogoVariant"
-                  }
-                ]
+                "text": "string"
               },
-              "default": "'full'",
-              "attribute": "variant"
+              "default": "null",
+              "attribute": "value",
+              "reflects": true
             }
           ],
-          "cssParts": [
+          "events": [
             {
-              "name": "logo",
-              "description": "The rendered SVG/image's wrapper."
+              "name": "bsChange",
+              "description": "Fires with the new `value` when the user changes the selection.",
+              "type": {
+                "text": "CustomEvent<string>"
+              }
             }
           ],
-          "cssProperties": [
-            {
-              "name": "--bs-logo-asset-dark-display",
-              "description": "The background=\"auto\" counterpart to --bs-logo-asset-light-display above -- see that entry."
-            },
-            {
-              "name": "--bs-logo-asset-light-display",
-              "description": "Only read when background=\"auto\" (the default). Defined in src/global/base.css, not here -- that's this library's own bridge from the ambient [data-theme=\"dark\"] attribute to which full-wordmark asset shows, not a per-component override point most consumers need to touch directly."
-            },
-            {
-              "name": "--bs-logo-height-custom",
-              "description": "Height of the rendered image when variant=\"custom\". Width is `auto` (not a fixed custom property) so a consumer's own logo keeps its natural aspect ratio -- only the height is constrained, matching `full`/`mark`'s shared 44px height. Defaults to 44px."
-            },
-            {
-              "name": "--bs-logo-height-full",
-              "description": "Height of the rendered logo when variant=\"full\". 44px."
-            },
-            {
-              "name": "--bs-logo-height-mark",
-              "description": "Height of the rendered logo when variant=\"mark\". 44px."
-            },
+          "slots": [
             {
-              "name": "--bs-logo-width-full",
-              "description": "Width of the rendered logo when variant=\"full\". 190.977px -- the light asset's natural width after its icon-to-wordmark gap was tightened from Figma's own exported spacing (see brandsync-logo-full-light.ts) -- a literal size, not a brandsync-tokens alias, since this is a fixed asset's natural dimensions rather than a themeable design token."
-            },
+              "name": "",
+              "description": "The `bs-list-item` rows."
+            }
+          ],
+          "cssParts": [
             {
-              "name": "--bs-logo-width-mark",
-              "description": "Width of the rendered logo when variant=\"mark\". 44px."
+              "name": "list",
+              "description": "The list container."
             }
           ]
         }
@@ -9384,30 +9850,455 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BsLogo",
+          "name": "BsList",
           "declaration": {
-            "name": "BsLogo"
+            "name": "BsList"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bs-logo",
+          "name": "bs-list",
           "declaration": {
-            "name": "BsLogo"
+            "name": "BsList"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/bs-menu/bs-menu.tsx",
+      "path": "src/components/bs-list-item/bs-list-item.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bs-menu",
-          "name": "BsMenu",
-          "description": "A generic dropdown/popup menu container: a rounded, elevated list of items (typically\n`bs-menu-item` elements).\n\n## When to use\n- A popup list of actions/options triggered by another control (e.g. a \"more options\" kebab\n  button), such as `bs-chatbot-response-action`'s `menu` slot.\n\n## When not to use\n- A persistent, always-visible list of options -- this component is purpose-built as a popup\n  surface (rounded corners, elevation shadow), not a plain list.",
+          "tagName": "bs-list-item",
+          "name": "BsListItem",
+          "description": "A single row of a list: optional leading media (avatar, icon, image), a label, a description and\noptional support text, and an optional trailing caret or custom trailing content.\n\n## When to use\n- As a child of `bs-list`, one per record, person, file or option.\n- Standalone as a plain information row (non-interactive), or with `interactive` as a button-like row.\n\n## When not to use\n- A popup list of actions -- use `bs-menu` / `bs-menu-item`.\n- App navigation with an active route -- use `bs-navigation-drawer-item`.\n- Tabular data with columns, sorting or paging -- use `bs-data-table`.\n\nComposed from: leading media (`bs-avatar`) and trailing controls (`bs-icon-button`) are supplied by the\nconsumer through the `leading` and `trailing` slots; the row itself only reserves layout. The default\ntrailing caret is inline SVG.\n\nRoles are driven by the parent `bs-list` (via `selectionRole`). Standalone, the row has no role\n(`listitem` is only valid inside a list) unless `interactive` is set, which makes it a focusable\n`role=\"button\"`.",
+          "attributes": [
+            {
+              "name": "description",
+              "description": "Second text line (the \"paragraph\").",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "fieldName": "description"
+            },
+            {
+              "name": "disabled",
+              "description": "Disables the row: dimmed, not focusable, no click event.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "interactive",
+              "description": "Makes a standalone row a focusable `role=\"button\"` that emits `bsItemClick`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "interactive"
+            },
+            {
+              "name": "label",
+              "description": "First text line (semibold).",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "fieldName": "label"
+            },
+            {
+              "name": "selected",
+              "description": "Marks the row as selected. Managed by the parent `bs-list` when it is `selectable`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "selected"
+            },
+            {
+              "name": "selection-role",
+              "description": "Set by the parent `bs-list`: `listitem` (plain list) or `option` (selectable list). Do not set by hand.",
+              "type": {
+                "text": "\"listitem\" | \"option\""
+              },
+              "default": "null",
+              "fieldName": "selectionRole"
+            },
+            {
+              "name": "show-arrow",
+              "description": "Shows a trailing caret (unless the `trailing` slot has content).",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "showArrow"
+            },
+            {
+              "name": "support-text",
+              "description": "Optional third text line.",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "fieldName": "supportText"
+            },
+            {
+              "name": "value",
+              "description": "Identifies the item; emitted by `bsItemClick` and matched against `bs-list`'s `value`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "fieldName": "value"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "description",
+              "description": "Second text line (the \"paragraph\").",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "attribute": "description"
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "description": "Disables the row: dimmed, not focusable, no click event.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "interactive",
+              "description": "Makes a standalone row a focusable `role=\"button\"` that emits `bsItemClick`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "interactive",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "description": "First text line (semibold).",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "selected",
+              "description": "Marks the row as selected. Managed by the parent `bs-list` when it is `selectable`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "selected",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "selectionRole",
+              "description": "Set by the parent `bs-list`: `listitem` (plain list) or `option` (selectable list). Do not set by hand.",
+              "type": {
+                "text": "\"listitem\" | \"option\""
+              },
+              "default": "null",
+              "attribute": "selection-role"
+            },
+            {
+              "kind": "field",
+              "name": "showArrow",
+              "description": "Shows a trailing caret (unless the `trailing` slot has content).",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "show-arrow"
+            },
+            {
+              "kind": "field",
+              "name": "supportText",
+              "description": "Optional third text line.",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "attribute": "support-text"
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "description": "Identifies the item; emitted by `bsItemClick` and matched against `bs-list`'s `value`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "attribute": "value"
+            }
+          ],
+          "events": [
+            {
+              "name": "bsItemClick",
+              "description": "Fires on click / Enter / Space when the row is interactive and not disabled. Payload is `value`.",
+              "type": {
+                "text": "CustomEvent<string>"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Rich content that replaces `label`, `description` and `supportText` entirely."
+            },
+            {
+              "name": "leading",
+              "description": "Leading media: a `bs-avatar size=\"lg\"` (64px), a 32px icon, or a 72x56 `<img>`."
+            },
+            {
+              "name": "trailing",
+              "description": "Replaces the default caret. Rendered when `showArrow` is set or the slot has content."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "container",
+              "description": "The row."
+            },
+            {
+              "name": "content",
+              "description": "The text column."
+            },
+            {
+              "name": "description",
+              "description": "The description line."
+            },
+            {
+              "name": "label",
+              "description": "The label line."
+            },
+            {
+              "name": "leading",
+              "description": "Wrapper around the leading slot."
+            },
+            {
+              "name": "support-text",
+              "description": "The support text line."
+            },
+            {
+              "name": "trailing",
+              "description": "Wrapper around the trailing slot / caret."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsListItem",
+          "declaration": {
+            "name": "BsListItem"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-list-item",
+          "declaration": {
+            "name": "BsListItem"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-logo/bs-logo.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-logo",
+          "name": "BsLogo",
+          "description": "The BrandSync brand mark, as its own standalone component -- shared by `bs-navigation-header`\nand `bs-navigation-drawer`, which used to each render their own duplicated copy of this SVG\n(the drawer's collapsed state even faked an icon-only look by clipping the full wordmark asset\ndown to a narrowed box, rather than using a real icon-only asset).\n\n## When to use\n- Anywhere the BrandSync logo/icon needs to render: a navigation header, a nav drawer, etc.\n\n## When not to use\n- The Genie AI chat panel's own brand mark -- that's a different logo (`bs-chatbot-header`'s\n  own inline Genie asset), not this one.\n\n`variant` mirrors Figma's \"Logo\" component set (node 10909:30421) `Device` property\n(\"Desktop\" / \"Tab and mobile\"), which was originally meant to distinguish the full lockup from\nthe icon-only mark at different responsive breakpoints -- renamed here to\n`variant: 'full' | 'mark'` since that's what it actually controls (how much of the logo\nrenders), not literally a device/breakpoint switch.\n\n`variant=\"custom\"` is not a Figma variant at all -- it's an escape hatch for a consuming app\nthat needs to show a DIFFERENT product's logo in the same slot (e.g. a white-labeled deployment,\nor a logo fetched at runtime from a service like brand.dev), via `src`/`alt`, instead of the\nbuilt-in BrandSync assets. This component deliberately does NOT fetch that image itself --\nnetwork calls, loading/error states, and caching are the consuming app's responsibility, same as\nevery other component in this library (e.g. `bs-attachment` takes `imageSrc` rather than fetching\nan image on its own). `background` has no effect on `variant=\"custom\"` -- a consumer's own image\nis already designed for whatever surface it's placed on.",
+          "attributes": [
+            {
+              "name": "alt",
+              "description": "`variant=\"custom\"` only: accessible alt text for the image -- a product logo is meaningful\ncontent (whose brand is this?), not decorative, so set this to something real (e.g. the\nproduct/company name). Falls back to `alt=\"\"` (marking the image decorative to assistive\ntech) when unset, rather than omitting the `alt` attribute entirely -- an `<img>` with no\n`alt` attribute at all is a harder accessibility failure than one explicitly marked\ndecorative, but an empty fallback is still worse than a real name, so don't rely on it.\nIgnored for `full`/`mark` (those already carry their own fixed `aria-label=\"BrandSync\"`).",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "fieldName": "alt"
+            },
+            {
+              "name": "background",
+              "description": "Which pre-built asset to use for `variant=\"full\"` -- Figma ships a genuinely separate,\ndifferently-drawn dark-background asset (every wordmark path filled solid white, and the\nicon's outer shape a single solid-white path instead of the light version's two-path\nwhite-fill-plus-border-ring), not a CSS currentColor swap of identical paths.\n\n`\"auto\"` (default) renders both assets and lets CSS pick one via\n`--bs-logo-asset-light-display`/`--bs-logo-asset-dark-display` (defined in\n`src/global/base.css`, flipped by the same `[data-theme=\"dark\"]` attribute every other\n`--bs-*` token already reacts to) -- so the logo just follows the ambient theme with no wiring\nneeded, the same way a consuming app's own dark mode already re-themes every other part of\nthis library via ordinary CSS custom property inheritance. Set `\"light\"`/`\"dark\"` explicitly\nto pin one regardless of the ambient theme -- e.g. a dark sidebar that isn't otherwise\ndark-themed.\n\nHas no effect on `variant=\"mark\"`: Figma's component set only has one real designed instance\nof the icon-only mark (`Device=\"Tab and mobile\"`, `Background=\"Default\"`) -- there's no\nseparate dark version of it, so the mark renders identically regardless of this prop.",
+              "type": {
+                "text": "\"auto\" | \"dark\" | \"light\"",
+                "references": [
+                  {
+                    "name": "BsLogoBackground"
+                  }
+                ]
+              },
+              "default": "'auto'",
+              "fieldName": "background"
+            },
+            {
+              "name": "src",
+              "description": "`variant=\"custom\"` only: the image URL to render (e.g. a URL your app already fetched from a\nlogo API). Ignored for `full`/`mark`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "fieldName": "src"
+            },
+            {
+              "name": "variant",
+              "description": "How much of the logo to render. `full` is the icon + \"EG BrandSync\" wordmark (190.977x44\nnatural size); `mark` is just the icon (44x44 natural size), no wordmark; `custom` renders a\nconsumer-supplied image via `src`/`alt` instead of a built-in BrandSync asset -- see the class\ndoc above.",
+              "type": {
+                "text": "\"custom\" | \"full\" | \"mark\"",
+                "references": [
+                  {
+                    "name": "BsLogoVariant"
+                  }
+                ]
+              },
+              "default": "'full'",
+              "fieldName": "variant"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "alt",
+              "description": "`variant=\"custom\"` only: accessible alt text for the image -- a product logo is meaningful\ncontent (whose brand is this?), not decorative, so set this to something real (e.g. the\nproduct/company name). Falls back to `alt=\"\"` (marking the image decorative to assistive\ntech) when unset, rather than omitting the `alt` attribute entirely -- an `<img>` with no\n`alt` attribute at all is a harder accessibility failure than one explicitly marked\ndecorative, but an empty fallback is still worse than a real name, so don't rely on it.\nIgnored for `full`/`mark` (those already carry their own fixed `aria-label=\"BrandSync\"`).",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "attribute": "alt"
+            },
+            {
+              "kind": "field",
+              "name": "background",
+              "description": "Which pre-built asset to use for `variant=\"full\"` -- Figma ships a genuinely separate,\ndifferently-drawn dark-background asset (every wordmark path filled solid white, and the\nicon's outer shape a single solid-white path instead of the light version's two-path\nwhite-fill-plus-border-ring), not a CSS currentColor swap of identical paths.\n\n`\"auto\"` (default) renders both assets and lets CSS pick one via\n`--bs-logo-asset-light-display`/`--bs-logo-asset-dark-display` (defined in\n`src/global/base.css`, flipped by the same `[data-theme=\"dark\"]` attribute every other\n`--bs-*` token already reacts to) -- so the logo just follows the ambient theme with no wiring\nneeded, the same way a consuming app's own dark mode already re-themes every other part of\nthis library via ordinary CSS custom property inheritance. Set `\"light\"`/`\"dark\"` explicitly\nto pin one regardless of the ambient theme -- e.g. a dark sidebar that isn't otherwise\ndark-themed.\n\nHas no effect on `variant=\"mark\"`: Figma's component set only has one real designed instance\nof the icon-only mark (`Device=\"Tab and mobile\"`, `Background=\"Default\"`) -- there's no\nseparate dark version of it, so the mark renders identically regardless of this prop.",
+              "type": {
+                "text": "\"auto\" | \"dark\" | \"light\"",
+                "references": [
+                  {
+                    "name": "BsLogoBackground"
+                  }
+                ]
+              },
+              "default": "'auto'",
+              "attribute": "background"
+            },
+            {
+              "kind": "field",
+              "name": "src",
+              "description": "`variant=\"custom\"` only: the image URL to render (e.g. a URL your app already fetched from a\nlogo API). Ignored for `full`/`mark`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "attribute": "src"
+            },
+            {
+              "kind": "field",
+              "name": "variant",
+              "description": "How much of the logo to render. `full` is the icon + \"EG BrandSync\" wordmark (190.977x44\nnatural size); `mark` is just the icon (44x44 natural size), no wordmark; `custom` renders a\nconsumer-supplied image via `src`/`alt` instead of a built-in BrandSync asset -- see the class\ndoc above.",
+              "type": {
+                "text": "\"custom\" | \"full\" | \"mark\"",
+                "references": [
+                  {
+                    "name": "BsLogoVariant"
+                  }
+                ]
+              },
+              "default": "'full'",
+              "attribute": "variant"
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "logo",
+              "description": "The rendered SVG/image's wrapper."
+            }
+          ],
+          "cssProperties": [
+            {
+              "name": "--bs-logo-asset-dark-display",
+              "description": "The background=\"auto\" counterpart to --bs-logo-asset-light-display above -- see that entry."
+            },
+            {
+              "name": "--bs-logo-asset-light-display",
+              "description": "Only read when background=\"auto\" (the default). Defined in src/global/base.css, not here -- that's this library's own bridge from the ambient [data-theme=\"dark\"] attribute to which full-wordmark asset shows, not a per-component override point most consumers need to touch directly."
+            },
+            {
+              "name": "--bs-logo-height-custom",
+              "description": "Height of the rendered image when variant=\"custom\". Width is `auto` (not a fixed custom property) so a consumer's own logo keeps its natural aspect ratio -- only the height is constrained, matching `full`/`mark`'s shared 44px height. Defaults to 44px."
+            },
+            {
+              "name": "--bs-logo-height-full",
+              "description": "Height of the rendered logo when variant=\"full\". 44px."
+            },
+            {
+              "name": "--bs-logo-height-mark",
+              "description": "Height of the rendered logo when variant=\"mark\". 44px."
+            },
+            {
+              "name": "--bs-logo-width-full",
+              "description": "Width of the rendered logo when variant=\"full\". 190.977px -- the light asset's natural width after its icon-to-wordmark gap was tightened from Figma's own exported spacing (see brandsync-logo-full-light.ts) -- a literal size, not a brandsync-tokens alias, since this is a fixed asset's natural dimensions rather than a themeable design token."
+            },
+            {
+              "name": "--bs-logo-width-mark",
+              "description": "Width of the rendered logo when variant=\"mark\". 44px."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsLogo",
+          "declaration": {
+            "name": "BsLogo"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-logo",
+          "declaration": {
+            "name": "BsLogo"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-menu/bs-menu.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-menu",
+          "name": "BsMenu",
+          "description": "A generic dropdown/popup menu container: a rounded, elevated list of items (typically\n`bs-menu-item` elements).\n\n## When to use\n- A popup list of actions/options triggered by another control (e.g. a \"more options\" kebab\n  button), such as `bs-chatbot-response-action`'s `menu` slot.\n\n## When not to use\n- A persistent, always-visible list of options -- this component is purpose-built as a popup\n  surface (rounded corners, elevation shadow), not a plain list.",
           "slots": [
             {
               "name": "",
@@ -15410,26 +16301,220 @@
               "description": "The second pane."
             },
             {
-              "name": "pane-3",
-              "description": "Optional third pane."
+              "name": "pane-3",
+              "description": "Optional third pane."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "container",
+              "description": "The flex wrapper around all panes and dividers."
+            },
+            {
+              "name": "divider",
+              "description": "Every divider (the focusable `role=\"separator\"` element)."
+            },
+            {
+              "name": "divider-thumb",
+              "description": "The visible thumb on a divider."
+            },
+            {
+              "name": "pane",
+              "description": "Every pane wrapper (`pane-1`, `pane-2`, `pane-3` are also exposed as separate parts)."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsSplitPane",
+          "declaration": {
+            "name": "BsSplitPane"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-split-pane",
+          "declaration": {
+            "name": "BsSplitPane"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-stack/bs-stack.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-stack",
+          "name": "BsStack",
+          "description": "A flex layout that arranges its children in a row or column with a token-based gap, optionally\ndrawing a divider between children.\n\nBuilt from: `bs-divider` (when `divider` is set).\n\nWith `divider`, each child is given a generated `slot=\"bs-stack-item-N\"` attribute (plus a\n`data-bs-stack-item` marker) so a divider can be rendered between the named slots. Light-DOM\nnodes are never moved; the attributes are removed again when `divider` is turned off.\n\n## When to use\n- Spacing and aligning a short run of siblings (form fields, button rows, card content).\n\n## When not to use\n- Two-dimensional grids (use CSS grid).\n- Resizable panes (use `bs-split-pane`).",
+          "attributes": [
+            {
+              "name": "align",
+              "description": "Cross-axis alignment.",
+              "type": {
+                "text": "\"baseline\" | \"center\" | \"end\" | \"start\" | \"stretch\"",
+                "references": [
+                  {
+                    "name": "BsStackAlign"
+                  }
+                ]
+              },
+              "default": "'stretch'",
+              "fieldName": "align"
+            },
+            {
+              "name": "direction",
+              "description": "Main axis: `vertical` stacks children in a column, `horizontal` in a row.",
+              "type": {
+                "text": "\"horizontal\" | \"vertical\"",
+                "references": [
+                  {
+                    "name": "BsStackDirection"
+                  }
+                ]
+              },
+              "default": "'vertical'",
+              "fieldName": "direction"
+            },
+            {
+              "name": "divider",
+              "description": "Renders a decorative `bs-divider` between each child.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "divider"
+            },
+            {
+              "name": "gap",
+              "description": "Spacing token name (e.g. `200` => `--bs-spacing-200`). Invalid values fall back to `100`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'100'",
+              "fieldName": "gap"
+            },
+            {
+              "name": "justify",
+              "description": "Main-axis distribution.",
+              "type": {
+                "text": "\"around\" | \"between\" | \"center\" | \"end\" | \"start\"",
+                "references": [
+                  {
+                    "name": "BsStackJustify"
+                  }
+                ]
+              },
+              "default": "'start'",
+              "fieldName": "justify"
+            },
+            {
+              "name": "wrap",
+              "description": "Lets items wrap onto further lines.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "wrap"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "align",
+              "description": "Cross-axis alignment.",
+              "type": {
+                "text": "\"baseline\" | \"center\" | \"end\" | \"start\" | \"stretch\"",
+                "references": [
+                  {
+                    "name": "BsStackAlign"
+                  }
+                ]
+              },
+              "default": "'stretch'",
+              "attribute": "align",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "direction",
+              "description": "Main axis: `vertical` stacks children in a column, `horizontal` in a row.",
+              "type": {
+                "text": "\"horizontal\" | \"vertical\"",
+                "references": [
+                  {
+                    "name": "BsStackDirection"
+                  }
+                ]
+              },
+              "default": "'vertical'",
+              "attribute": "direction",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "divider",
+              "description": "Renders a decorative `bs-divider` between each child.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "divider",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "gap",
+              "description": "Spacing token name (e.g. `200` => `--bs-spacing-200`). Invalid values fall back to `100`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'100'",
+              "attribute": "gap"
+            },
+            {
+              "kind": "field",
+              "name": "justify",
+              "description": "Main-axis distribution.",
+              "type": {
+                "text": "\"around\" | \"between\" | \"center\" | \"end\" | \"start\"",
+                "references": [
+                  {
+                    "name": "BsStackJustify"
+                  }
+                ]
+              },
+              "default": "'start'",
+              "attribute": "justify",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "wrap",
+              "description": "Lets items wrap onto further lines.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "wrap",
+              "reflects": true
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "The items to arrange."
             }
           ],
           "cssParts": [
-            {
-              "name": "container",
-              "description": "The flex wrapper around all panes and dividers."
-            },
             {
               "name": "divider",
-              "description": "Every divider (the focusable `role=\"separator\"` element)."
-            },
-            {
-              "name": "divider-thumb",
-              "description": "The visible thumb on a divider."
-            },
-            {
-              "name": "pane",
-              "description": "Every pane wrapper (`pane-1`, `pane-2`, `pane-3` are also exposed as separate parts)."
+              "description": "Each generated `bs-divider` (only with `divider`)."
             }
           ]
         }
@@ -15437,16 +16522,16 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BsSplitPane",
+          "name": "BsStack",
           "declaration": {
-            "name": "BsSplitPane"
+            "name": "BsStack"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bs-split-pane",
+          "name": "bs-stack",
           "declaration": {
-            "name": "BsSplitPane"
+            "name": "BsStack"
           }
         }
       ]
@@ -17224,32 +18309,293 @@
               "fieldName": "placement"
             }
           ],
-          "members": [
+          "members": [
+            {
+              "kind": "field",
+              "name": "placement",
+              "description": "Which edge of the bubble the arrow points from, and therefore which side of a trigger the\nbubble should be placed on. `'top'` is the only value implemented -- it is the only variant\nconfirmed from the Figma \"EG Tooltip\" component (arrow at the top of the bubble, pointing\nup). Bottom/left/right variants aren't implemented pending further Figma design confirmation.",
+              "type": {
+                "text": "\"top\""
+              },
+              "default": "'top'",
+              "attribute": "placement"
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Default slot: the tooltip's message content."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "arrow",
+              "description": "The triangular pointer arrow."
+            },
+            {
+              "name": "bubble",
+              "description": "The dark rounded box containing the slotted content."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsTooltip",
+          "declaration": {
+            "name": "BsTooltip"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-tooltip",
+          "declaration": {
+            "name": "BsTooltip"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-tooltip-trigger/bs-tooltip-trigger.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-tooltip-trigger",
+          "name": "BsTooltipTrigger",
+          "description": "Wraps a trigger element and shows a `bs-tooltip` on hover or keyboard focus, after an optional\ndelay. Escape dismisses it. The tooltip is linked to the trigger with `aria-describedby`.\n\nComposed from `bs-tooltip`.\n\n## When to use\n- A short hint for an icon button or truncated label.\n\n## When not to use\n- Interactive content or long text (use `bs-popover`).",
+          "attributes": [
+            {
+              "name": "delay",
+              "description": "Milliseconds to wait before showing the tooltip.",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "fieldName": "delay"
+            },
+            {
+              "name": "placement",
+              "description": "Side of the trigger the tooltip appears on. The bs-tooltip arrow is only drawn for 'bottom'.",
+              "type": {
+                "text": "\"bottom\" | \"end\" | \"start\" | \"top\"",
+                "references": [
+                  {
+                    "name": "BsTooltipTriggerPlacement"
+                  }
+                ]
+              },
+              "default": "'bottom'",
+              "fieldName": "placement"
+            },
+            {
+              "name": "text",
+              "description": "Tooltip message.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "text"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "delay",
+              "description": "Milliseconds to wait before showing the tooltip.",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "attribute": "delay"
+            },
+            {
+              "kind": "field",
+              "name": "placement",
+              "description": "Side of the trigger the tooltip appears on. The bs-tooltip arrow is only drawn for 'bottom'.",
+              "type": {
+                "text": "\"bottom\" | \"end\" | \"start\" | \"top\"",
+                "references": [
+                  {
+                    "name": "BsTooltipTriggerPlacement"
+                  }
+                ]
+              },
+              "default": "'bottom'",
+              "attribute": "placement",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "text",
+              "description": "Tooltip message.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "text"
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Default slot: the trigger element."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "tooltip",
+              "description": "The positioned tooltip wrapper (role=\"tooltip\")."
+            },
+            {
+              "name": "trigger",
+              "description": "The wrapper around the trigger; carries aria-describedby."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsTooltipTrigger",
+          "declaration": {
+            "name": "BsTooltipTrigger"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-tooltip-trigger",
+          "declaration": {
+            "name": "BsTooltipTrigger"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-tree/bs-tree.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-tree",
+          "name": "BsTree",
+          "description": "A hierarchical list of `bs-tree-item` rows with single selection, expand/collapse and the\nWAI-ARIA tree keyboard pattern.\n\nThe tree owns `role=\"tree\"`, the roving `tabindex` (exactly one enabled, visible item is\ntabbable: the selected one, otherwise the first), selection (kept in sync with each item's\n`selected`) and keyboard navigation over the visible (rendered, non-disabled) items. Items own\ntheir expansion state and emit `bsSelect` / `bsToggle`.\n\nBuilt from: `bs-tree-item` rows.",
+          "attributes": [
+            {
+              "name": "aria-label",
+              "description": "Accessible name of the tree. Bound onto the internal `role=\"tree\"` element (an `aria-label`\non the host would not reach it).",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "fieldName": "ariaLabel"
+            },
+            {
+              "name": "selectable",
+              "description": "When `false`, rows do not select (clicks and Enter/Space do nothing) but parents still\nexpand and collapse.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "fieldName": "selectable"
+            },
+            {
+              "name": "value",
+              "description": "The `value` (or, when empty, the `label`) of the selected item. Two-way synced with each\nitem's `selected` (single selection). Setting it from code does not emit `bsChange`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "value"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "description": "Accessible name of the tree. Bound onto the internal `role=\"tree\"` element (an `aria-label`\non the host would not reach it).",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "attribute": "aria-label"
+            },
+            {
+              "kind": "field",
+              "name": "selectable",
+              "description": "When `false`, rows do not select (clicks and Enter/Space do nothing) but parents still\nexpand and collapse.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "attribute": "selectable"
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "description": "The `value` (or, when empty, the `label`) of the selected item. Two-way synced with each\nitem's `selected` (single selection). Setting it from code does not emit `bsChange`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "value",
+              "reflects": true
+            },
+            {
+              "kind": "method",
+              "name": "collapseAll",
+              "description": "Collapses every parent item.",
+              "return": {
+                "type": {
+                  "text": "Promise<void>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "expandAll",
+              "description": "Expands every parent item.",
+              "return": {
+                "type": {
+                  "text": "Promise<void>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
+            }
+          ],
+          "events": [
             {
-              "kind": "field",
-              "name": "placement",
-              "description": "Which edge of the bubble the arrow points from, and therefore which side of a trigger the\nbubble should be placed on. `'top'` is the only value implemented -- it is the only variant\nconfirmed from the Figma \"EG Tooltip\" component (arrow at the top of the bubble, pointing\nup). Bottom/left/right variants aren't implemented pending further Figma design confirmation.",
+              "name": "bsChange",
+              "description": "Emitted when the user changes the selection (click, Enter/Space), with the new value. Not\nemitted when `value` is set from code.",
               "type": {
-                "text": "\"top\""
-              },
-              "default": "'top'",
-              "attribute": "placement"
+                "text": "CustomEvent<string>"
+              }
             }
           ],
           "slots": [
             {
               "name": "",
-              "description": "Default slot: the tooltip's message content."
+              "description": "Default slot: top-level `bs-tree-item` elements (nested ones go inside their parent item)."
             }
           ],
           "cssParts": [
             {
-              "name": "arrow",
-              "description": "The triangular pointer arrow."
-            },
-            {
-              "name": "bubble",
-              "description": "The dark rounded box containing the slotted content."
+              "name": "container",
+              "description": "The `role=\"tree\"` wrapper."
             }
           ]
         }
@@ -17257,116 +18603,313 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BsTooltip",
+          "name": "BsTree",
           "declaration": {
-            "name": "BsTooltip"
+            "name": "BsTree"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bs-tooltip",
+          "name": "bs-tree",
           "declaration": {
-            "name": "BsTooltip"
+            "name": "BsTree"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/bs-tooltip-trigger/bs-tooltip-trigger.tsx",
+      "path": "src/components/bs-tree-item/bs-tree-item.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bs-tooltip-trigger",
-          "name": "BsTooltipTrigger",
-          "description": "Wraps a trigger element and shows a `bs-tooltip` on hover or keyboard focus, after an optional\ndelay. Escape dismisses it. The tooltip is linked to the trigger with `aria-describedby`.\n\nComposed from `bs-tooltip`.\n\n## When to use\n- A short hint for an icon button or truncated label.\n\n## When not to use\n- Interactive content or long text (use `bs-popover`).",
+          "tagName": "bs-tree-item",
+          "name": "BsTreeItem",
+          "description": "A single row of a `bs-tree`. An item that contains child `bs-tree-item` elements is a parent\n(it gets an expand/collapse caret and a folder icon); an item without children is a leaf (no\ncaret, file icon).\n\nThe host carries `role=\"treeitem\"` and the `aria-*` state; the owning `bs-tree` manages the\nroving `tabindex`, selection and keyboard navigation. Nesting depth is computed automatically\nfrom the number of ancestor `bs-tree-item` elements and exposed as `aria-level` -- it is not a\nprop. Clicking the row selects it; clicking the caret (or pressing Right/Left in a tree) toggles\nexpansion -- the two are deliberately separate.\n\nBuilt from: inline SVG icons only (no existing `bs-*` component covers a tree row).",
           "attributes": [
             {
-              "name": "delay",
-              "description": "Milliseconds to wait before showing the tooltip.",
+              "name": "disabled",
+              "description": "Disables the row: not focusable, ignores clicks, dimmed. Reflected.",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "default": "0",
-              "fieldName": "delay"
+              "default": "false",
+              "fieldName": "disabled"
             },
             {
-              "name": "placement",
-              "description": "Side of the trigger the tooltip appears on. The bs-tooltip arrow is only drawn for 'bottom'.",
+              "name": "expanded",
+              "description": "Whether the child items are shown. Only meaningful for parents. Mutable: the caret, the\nkeyboard and the owning tree toggle it. Reflected.",
               "type": {
-                "text": "\"bottom\" | \"end\" | \"start\" | \"top\"",
-                "references": [
-                  {
-                    "name": "BsTooltipTriggerPlacement"
-                  }
-                ]
+                "text": "boolean"
               },
-              "default": "'bottom'",
-              "fieldName": "placement"
+              "default": "false",
+              "fieldName": "expanded"
             },
             {
-              "name": "text",
-              "description": "Tooltip message.",
+              "name": "label",
+              "description": "The row's text. Use the `label` slot for rich content.",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "text"
+              "fieldName": "label"
+            },
+            {
+              "name": "selected",
+              "description": "Marks the row as selected. Owned by the tree (single selection, synced with its `value`).\nReflected.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "selected"
+            },
+            {
+              "name": "show-icon",
+              "description": "Shows the leading icon (default folder / file, or the `icon` slot).",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "fieldName": "showIcon"
+            },
+            {
+              "name": "value",
+              "description": "Identifier used in events and for the tree's `value`. Falls back to `label` when empty.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "value"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "delay",
-              "description": "Milliseconds to wait before showing the tooltip.",
+              "name": "disabled",
+              "description": "Disables the row: not focusable, ignores clicks, dimmed. Reflected.",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "default": "0",
-              "attribute": "delay"
+              "default": "false",
+              "attribute": "disabled",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "placement",
-              "description": "Side of the trigger the tooltip appears on. The bs-tooltip arrow is only drawn for 'bottom'.",
+              "name": "expanded",
+              "description": "Whether the child items are shown. Only meaningful for parents. Mutable: the caret, the\nkeyboard and the owning tree toggle it. Reflected.",
               "type": {
-                "text": "\"bottom\" | \"end\" | \"start\" | \"top\"",
-                "references": [
-                  {
-                    "name": "BsTooltipTriggerPlacement"
-                  }
-                ]
+                "text": "boolean"
               },
-              "default": "'bottom'",
-              "attribute": "placement",
+              "default": "false",
+              "attribute": "expanded",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "text",
-              "description": "Tooltip message.",
+              "name": "label",
+              "description": "The row's text. Use the `label` slot for rich content.",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "attribute": "text"
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "selected",
+              "description": "Marks the row as selected. Owned by the tree (single selection, synced with its `value`).\nReflected.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "selected",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "showIcon",
+              "description": "Shows the leading icon (default folder / file, or the `icon` slot).",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "attribute": "show-icon"
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "description": "Identifier used in events and for the tree's `value`. Falls back to `label` when empty.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "value"
+            },
+            {
+              "kind": "method",
+              "name": "setExpanded",
+              "description": "Sets `expanded` as a user action: updates the prop and emits `bsToggle`. No-op for leaves,\ndisabled items, or when the value would not change.",
+              "parameters": [
+                {
+                  "name": "next",
+                  "type": {
+                    "text": "boolean",
+                    "references": [
+                      {
+                        "name": "Promise",
+                        "package": "global:"
+                      }
+                    ]
+                  }
+                }
+              ],
+              "return": {
+                "type": {
+                  "text": "Promise<void>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
+            }
+          ],
+          "events": [
+            {
+              "name": "bsSelect",
+              "description": "Emitted (bubbling, composed) when the user activates the row, with the item's value. The\nowning `bs-tree` listens and updates the selection.",
+              "type": {
+                "text": "CustomEvent<string>"
+              }
+            },
+            {
+              "name": "bsToggle",
+              "description": "Emitted when the user toggles expansion (caret click or keyboard), with the new `expanded`\nvalue. Not emitted when `expanded` is set from code.",
+              "type": {
+                "text": "CustomEvent<boolean>"
+              }
             }
           ],
           "slots": [
             {
               "name": "",
-              "description": "Default slot: the trigger element."
+              "description": "Default slot: child `bs-tree-item` elements (the subtree). Only rendered, inside a\n`role=\"group\"` wrapper, while the item is expanded; collapsed children are not accessible."
+            },
+            {
+              "name": "icon",
+              "description": "Overrides the default folder / file icon. Only used when `showIcon` is `true`."
+            },
+            {
+              "name": "label",
+              "description": "Overrides the `label` text."
             }
           ],
           "cssParts": [
             {
-              "name": "tooltip",
-              "description": "The positioned tooltip wrapper (role=\"tooltip\")."
+              "name": "caret",
+              "description": "The expand/collapse caret (parents only)."
             },
             {
-              "name": "trigger",
-              "description": "The wrapper around the trigger; carries aria-describedby."
+              "name": "container",
+              "description": "The highlighted row pill (carries the hover / selected / focus states)."
+            },
+            {
+              "name": "group",
+              "description": "The `role=\"group\"` wrapper around the child items (while expanded)."
+            },
+            {
+              "name": "icon",
+              "description": "The icon wrapper."
+            },
+            {
+              "name": "label",
+              "description": "The label wrapper."
+            }
+          ],
+          "cssProperties": [
+            {
+              "name": "--bs-tree-item-bg-focus",
+              "description": "Pill background, keyboard-focused. Aliased to --bs-surface-focus."
+            },
+            {
+              "name": "--bs-tree-item-bg-hover",
+              "description": "Pill background, hovered. Aliased to --bs-surface-hover."
+            },
+            {
+              "name": "--bs-tree-item-bg-pressed",
+              "description": "Pill background, pressed. Aliased to --bs-surface-pressed."
+            },
+            {
+              "name": "--bs-tree-item-bg-selected",
+              "description": "Pill background, selected. Aliased to --bs-surface-selected."
+            },
+            {
+              "name": "--bs-tree-item-bg-selected-focus",
+              "description": "Pill background, selected and keyboard-focused. Aliased to --bs-surface-selected-focus."
+            },
+            {
+              "name": "--bs-tree-item-bg-selected-hover",
+              "description": "Pill background, selected and hovered. Aliased to --bs-surface-selected-hover."
+            },
+            {
+              "name": "--bs-tree-item-bg-selected-pressed",
+              "description": "Pill background, selected and pressed. Aliased to --bs-surface-selected-pressed."
+            },
+            {
+              "name": "--bs-tree-item-caret-gap",
+              "description": "Gap between the caret and the icon/label group. Aliased to --bs-spacing-150."
+            },
+            {
+              "name": "--bs-tree-item-content-gap",
+              "description": "Gap between the icon and the label. Aliased to --bs-spacing-100."
+            },
+            {
+              "name": "--bs-tree-item-focus-ring",
+              "description": "Focus ring colour. Aliased to --bs-border-primary-hover."
+            },
+            {
+              "name": "--bs-tree-item-font-size",
+              "description": "Label font size. Aliased to --bs-font-size-md."
+            },
+            {
+              "name": "--bs-tree-item-height",
+              "description": "Row height (48px). Aliased to --bs-spacing-600."
+            },
+            {
+              "name": "--bs-tree-item-icon",
+              "description": "Icon and caret colour. Aliased to --bs-icon-default."
+            },
+            {
+              "name": "--bs-tree-item-icon-disabled",
+              "description": "Icon and caret colour, disabled. Aliased to --bs-icon-disabled."
+            },
+            {
+              "name": "--bs-tree-item-indent",
+              "description": "Extra indent per nesting level. Set directly in px (no 40px spacing token), matching Figma."
+            },
+            {
+              "name": "--bs-tree-item-line-height",
+              "description": "Label line height (unitless px number). Aliased to --bs-line-height-body-md."
+            },
+            {
+              "name": "--bs-tree-item-padding-x",
+              "description": "Pill horizontal padding. Aliased to --bs-spacing-50."
+            },
+            {
+              "name": "--bs-tree-item-radius",
+              "description": "Pill corner radius. Aliased to --bs-border-radius-100."
+            },
+            {
+              "name": "--bs-tree-item-text",
+              "description": "Label colour. Aliased to --bs-text-default."
+            },
+            {
+              "name": "--bs-tree-item-text-disabled",
+              "description": "Label colour, disabled. Aliased to --bs-text-on-disabled."
             }
           ]
         }
@@ -17374,16 +18917,16 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BsTooltipTrigger",
+          "name": "BsTreeItem",
           "declaration": {
-            "name": "BsTooltipTrigger"
+            "name": "BsTreeItem"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bs-tooltip-trigger",
+          "name": "bs-tree-item",
           "declaration": {
-            "name": "BsTooltipTrigger"
+            "name": "BsTreeItem"
           }
         }
       ]