@brandsync/wc 0.0.10 → 0.0.12

package/custom-elements.json

@@ -195,7 +195,7 @@
           "customElement": true,
           "tagName": "bs-attachment",
           "name": "BsAttachment",
-          "description": "A single file attachment preview for `bs-composer` -- an image thumbnail, or a filename card\nwith a colored file-type badge (PDF/Document), with an optional upload-in-progress spinner and\na hover/focus-revealed remove button.\n\n## When to use\n- Rendered by the consuming app for each file a user has attached to a Genie AI chat message,\n  typically alongside or inside `bs-composer`.\n\n## When not to use\n- A generic file-upload control -- this is a preview-only presentational component. The\n  consuming app owns the actual file picker/upload logic and drives `loading` from that state.",
+          "description": "A single file attachment preview for `bs-composer` -- an image thumbnail, or a filename card\nwith a colored file-type badge (PDF/Document), with an optional upload-in-progress spinner and\na hover/focus-revealed remove button (a `bs-icon-button` with `size=\"xs\"` `variant=\"neutral\"` --\nthe same 16x16px compact tier `bs-icon-button` documents as meant for exactly this kind of\nchip/tag \"remove\" control).\n\n## When to use\n- Rendered by the consuming app for each file a user has attached to a Genie AI chat message,\n  typically alongside or inside `bs-composer`.\n\n## When not to use\n- A generic file-upload control -- this is a preview-only presentational component. The\n  consuming app owns the actual file picker/upload logic and drives `loading` from that state.",
           "attributes": [
             {
               "name": "file-name",
@@ -524,7 +524,7 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/bs-button/bs-button.tsx",
+      "path": "src/components/bs-button/bs-button/bs-button.tsx",
       "declarations": [
         {
           "kind": "class",
@@ -722,7 +722,7 @@
                 "references": [
                   {
                     "name": "BsButtonSize",
-                    "module": "../bs-button/bs-button"
+                    "module": "../bs-button/bs-button/bs-button"
                   }
                 ]
               },
@@ -740,7 +740,7 @@
                 "references": [
                   {
                     "name": "BsButtonSize",
-                    "module": "../bs-button/bs-button"
+                    "module": "../bs-button/bs-button/bs-button"
                   }
                 ]
               },
@@ -1568,6 +1568,312 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-checkbox/bs-checkbox.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-checkbox",
+          "name": "BsCheckbox",
+          "description": "A single checkbox with its label, for a binary choice or one item within a group of independent\nchoices.\n\n## When to use\n- A single standalone binary setting (e.g. \"Remember me\", \"I agree to the terms\").\n- One item within a set of independent, non-exclusive choices (a checkbox group/list).\n- `indeterminate` for a \"select all\" checkbox representing a partially-selected group.\n\n## When not to use\n- A single mutually-exclusive choice from a set -- use a radio group instead.\n- An on/off setting that takes effect immediately (no explicit form submission) -- use `bs-switch`.",
+          "attributes": [
+            {
+              "name": "aria-label",
+              "description": "Accessible name for the checkbox. Required whenever the default (label) slot is empty (e.g. a\nbare \"select row\" checkbox in a table) -- without it, the internal native `<input>` has no\naccessible name at all. Setting `aria-label` directly on the `<bs-checkbox>` host does NOT\nwork for this: that attribute stays on the light-DOM host and is never forwarded into the\nshadow DOM by the browser, so the actual focusable element (the native `<input>` inside) stays\nnameless. This prop exists specifically to bridge that gap -- same pattern as `bs-button`'s and\n`bs-tab`'s identical `ariaLabel` prop, both of which explicitly bind it onto their own internal\nfocusable element for the same reason.",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "fieldName": "ariaLabel"
+            },
+            {
+              "name": "checked",
+              "description": "Whether the checkbox is checked. Mutable so clicking the label/input toggles it directly.\nWhen `indeterminate` is also true, `indeterminate` wins visually (shows the minus icon)\nregardless of this value -- same as native checkboxes.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "checked"
+            },
+            {
+              "name": "disabled",
+              "description": "Disables the checkbox: sets the native `disabled` attribute, suppresses hover/focus styling,\nand prevents toggling.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "error",
+              "description": "Applies the error border/label-color treatment. This component's spec has no error message\ntext of its own (unlike `bs-input`'s `error: string`), so it's a plain boolean.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "error"
+            },
+            {
+              "name": "indeterminate",
+              "description": "Whether the checkbox is in the indeterminate (\"partially selected\") state -- shows a minus\nicon instead of a check, and takes visual precedence over `checked`. Unlike `checked`, native\ncheckboxes have no `indeterminate` HTML attribute; it can only be set as a JS property on the\nelement. This `@Prop` still works as an attribute for the *host* (`<bs-checkbox>`) since that's\nthis component's own reflected state, not the native control's -- the native `<input>` inside\nhas its `.indeterminate` property set imperatively in `componentDidLoad`/`componentDidUpdate`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "indeterminate"
+            },
+            {
+              "name": "size",
+              "description": "Sizing scale. Controls the box's width/height and border width; corner radius is constant\nacross all sizes.",
+              "type": {
+                "text": "\"lg\" | \"md\" | \"sm\"",
+                "references": [
+                  {
+                    "name": "BsCheckboxSize"
+                  }
+                ]
+              },
+              "default": "'lg'",
+              "fieldName": "size"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "description": "Accessible name for the checkbox. Required whenever the default (label) slot is empty (e.g. a\nbare \"select row\" checkbox in a table) -- without it, the internal native `<input>` has no\naccessible name at all. Setting `aria-label` directly on the `<bs-checkbox>` host does NOT\nwork for this: that attribute stays on the light-DOM host and is never forwarded into the\nshadow DOM by the browser, so the actual focusable element (the native `<input>` inside) stays\nnameless. This prop exists specifically to bridge that gap -- same pattern as `bs-button`'s and\n`bs-tab`'s identical `ariaLabel` prop, both of which explicitly bind it onto their own internal\nfocusable element for the same reason.",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "readonly": true,
+              "attribute": "aria-label"
+            },
+            {
+              "kind": "field",
+              "name": "checked",
+              "description": "Whether the checkbox is checked. Mutable so clicking the label/input toggles it directly.\nWhen `indeterminate` is also true, `indeterminate` wins visually (shows the minus icon)\nregardless of this value -- same as native checkboxes.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "checked",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "description": "Disables the checkbox: sets the native `disabled` attribute, suppresses hover/focus styling,\nand prevents toggling.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "disabled"
+            },
+            {
+              "kind": "field",
+              "name": "error",
+              "description": "Applies the error border/label-color treatment. This component's spec has no error message\ntext of its own (unlike `bs-input`'s `error: string`), so it's a plain boolean.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "error"
+            },
+            {
+              "kind": "field",
+              "name": "indeterminate",
+              "description": "Whether the checkbox is in the indeterminate (\"partially selected\") state -- shows a minus\nicon instead of a check, and takes visual precedence over `checked`. Unlike `checked`, native\ncheckboxes have no `indeterminate` HTML attribute; it can only be set as a JS property on the\nelement. This `@Prop` still works as an attribute for the *host* (`<bs-checkbox>`) since that's\nthis component's own reflected state, not the native control's -- the native `<input>` inside\nhas its `.indeterminate` property set imperatively in `componentDidLoad`/`componentDidUpdate`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "indeterminate",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "description": "Sizing scale. Controls the box's width/height and border width; corner radius is constant\nacross all sizes.",
+              "type": {
+                "text": "\"lg\" | \"md\" | \"sm\"",
+                "references": [
+                  {
+                    "name": "BsCheckboxSize"
+                  }
+                ]
+              },
+              "default": "'lg'",
+              "readonly": true,
+              "attribute": "size"
+            }
+          ],
+          "events": [
+            {
+              "name": "bsChange",
+              "description": "Emitted when the checked state changes via user interaction, with the new `checked` value.",
+              "type": {
+                "text": "CustomEvent<boolean>"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Default slot: the label text."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "box",
+              "description": "The visual checkbox square."
+            },
+            {
+              "name": "icon",
+              "description": "The check/minus icon shown inside the box when `checked` or `indeterminate`."
+            },
+            {
+              "name": "label",
+              "description": "The label text wrapper."
+            }
+          ],
+          "cssProperties": [
+            {
+              "name": "--bs-checkbox-bg-disabled",
+              "description": "Box background, disabled. Aliased to --bs-surface-action-disabled."
+            },
+            {
+              "name": "--bs-checkbox-bg-focus",
+              "description": "Box background, deselected/focused. Aliased to --bs-surface-raised."
+            },
+            {
+              "name": "--bs-checkbox-bg-hover",
+              "description": "Box background, deselected/hovered. Aliased to --bs-surface-hover."
+            },
+            {
+              "name": "--bs-checkbox-bg-selected",
+              "description": "Box background, selected or indeterminate/enabled. Aliased to --bs-color-primary-default."
+            },
+            {
+              "name": "--bs-checkbox-bg-selected-error",
+              "description": "Box background, selected or indeterminate/error. Aliased to --bs-icon-error."
+            },
+            {
+              "name": "--bs-checkbox-bg-selected-hover",
+              "description": "Box background, selected or indeterminate/hovered. Aliased to --bs-color-primary-hover."
+            },
+            {
+              "name": "--bs-checkbox-border-default",
+              "description": "Border color, deselected/enabled. Aliased to --bs-border-default."
+            },
+            {
+              "name": "--bs-checkbox-border-disabled",
+              "description": "Border color, disabled. Aliased to --bs-border-neutral-disabled."
+            },
+            {
+              "name": "--bs-checkbox-border-error",
+              "description": "Border color, deselected/error. Aliased to --bs-border-error."
+            },
+            {
+              "name": "--bs-checkbox-border-focus",
+              "description": "Border color, deselected/focused. Aliased to --bs-border-neutral-hover."
+            },
+            {
+              "name": "--bs-checkbox-border-hover",
+              "description": "Border color, deselected/hovered. Aliased to --bs-border-neutral-hover."
+            },
+            {
+              "name": "--bs-checkbox-border-selected",
+              "description": "Border color, selected or indeterminate/enabled. Aliased to --bs-color-primary-default."
+            },
+            {
+              "name": "--bs-checkbox-border-selected-error",
+              "description": "Border color, selected or indeterminate/error. Aliased to --bs-icon-error."
+            },
+            {
+              "name": "--bs-checkbox-border-selected-hover",
+              "description": "Border color, selected or indeterminate/hovered. Aliased to --bs-color-primary-hover."
+            },
+            {
+              "name": "--bs-checkbox-border-width-lg",
+              "description": "Border width at size=\"lg\"."
+            },
+            {
+              "name": "--bs-checkbox-border-width-md",
+              "description": "Border width at size=\"md\"."
+            },
+            {
+              "name": "--bs-checkbox-border-width-sm",
+              "description": "Border width at size=\"sm\"."
+            },
+            {
+              "name": "--bs-checkbox-focus-ring-color",
+              "description": "Focus ring color, drawn outside the box. Aliased to --bs-border-neutral-focus."
+            },
+            {
+              "name": "--bs-checkbox-gap",
+              "description": "Gap between the box and the label text. Aliased to --bs-spacing-100."
+            },
+            {
+              "name": "--bs-checkbox-icon-color",
+              "description": "Check/minus icon color. Aliased to --bs-icon-static-white."
+            },
+            {
+              "name": "--bs-checkbox-icon-color-disabled",
+              "description": "Check/minus icon color, disabled. Aliased to --bs-icon-disabled."
+            },
+            {
+              "name": "--bs-checkbox-label-color",
+              "description": "Label text color. Aliased to --bs-text-default."
+            },
+            {
+              "name": "--bs-checkbox-label-color-disabled",
+              "description": "Label text color, disabled. Aliased to --bs-text-on-disabled."
+            },
+            {
+              "name": "--bs-checkbox-label-color-error",
+              "description": "Label text color, error. Aliased to --bs-text-error."
+            },
+            {
+              "name": "--bs-checkbox-radius",
+              "description": "Corner radius of the box, constant across all sizes. Aliased to --bs-border-radius-50."
+            },
+            {
+              "name": "--bs-checkbox-size-lg",
+              "description": "Box width/height at size=\"lg\". Aliased to --bs-spacing-300."
+            },
+            {
+              "name": "--bs-checkbox-size-md",
+              "description": "Box width/height at size=\"md\". Aliased to --bs-spacing-250."
+            },
+            {
+              "name": "--bs-checkbox-size-sm",
+              "description": "Box width/height at size=\"sm\". Aliased to --bs-spacing-200."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsCheckbox",
+          "declaration": {
+            "name": "BsCheckbox"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-checkbox",
+          "declaration": {
+            "name": "BsCheckbox"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/bs-composer/bs-composer.tsx",
@@ -1612,7 +1918,7 @@
             },
             {
               "name": "value",
-              "description": "Current text value. Native `input` events don't cross the Shadow DOM boundary, so this\ncomponent re-dispatches them as a `bsInput` custom event instead.",
+              "description": "Current text value. Native `input` events don't cross the Shadow DOM boundary, so this\ncomponent re-dispatches them as a `bsInput` custom event instead.\n\nThe field is a `<textarea>` (not a single-line `<input>`) that grows with its content, up to\n`--bs-composer-input-max-lines` (10 by default) -- beyond that it scrolls internally instead\nof growing further. Setting `value` as a prop (not just typing) also re-triggers the resize,\nso e.g. programmatically clearing the field after submit correctly shrinks it back down.",
               "type": {
                 "text": "string"
               },
@@ -1675,7 +1981,7 @@
             {
               "kind": "field",
               "name": "value",
-              "description": "Current text value. Native `input` events don't cross the Shadow DOM boundary, so this\ncomponent re-dispatches them as a `bsInput` custom event instead.",
+              "description": "Current text value. Native `input` events don't cross the Shadow DOM boundary, so this\ncomponent re-dispatches them as a `bsInput` custom event instead.\n\nThe field is a `<textarea>` (not a single-line `<input>`) that grows with its content, up to\n`--bs-composer-input-max-lines` (10 by default) -- beyond that it scrolls internally instead\nof growing further. Setting `value` as a prop (not just typing) also re-triggers the resize,\nso e.g. programmatically clearing the field after submit correctly shrinks it back down.",
               "type": {
                 "text": "string"
               },
@@ -1769,7 +2075,7 @@
             },
             {
               "name": "input",
-              "description": "The native text `<input>`."
+              "description": "The native text `<textarea>`."
             },
             {
               "name": "mic",
@@ -1804,7 +2110,7 @@
           "customElement": true,
           "tagName": "bs-composer-status-banner",
           "name": "BsComposerStatusBanner",
-          "description": "A full-width status banner for use directly above `bs-composer`, surfacing a message about the\ncomposer's current state (e.g. a send failure, an informational notice) with an optional\n\"Continue\"-style action button and an optional close button.\n\n## When to use\n- A message tied to the composer itself (send failed, rate-limited, draft restored, etc.) that\n  needs to sit directly above it, not a general-purpose alert -- see `CONVENTIONS.md` if this\n  library gains a generic banner/alert component later, and prefer that instead once it exists.\n\n## When not to use\n- A toast/snackbar notification unrelated to the composer -- this component is not\n  self-dismissing and has no positioning of its own (it's a static block, not an overlay).",
+          "description": "A full-width status banner for use directly above `bs-composer`, surfacing a message about the\ncomposer's current state (e.g. a send failure, an informational notice) with an optional\n\"Continue\"-style action button and an optional close button.\n\n## When to use\n- A message tied to the composer itself (send failed, rate-limited, draft restored, etc.) that\n  needs to sit directly above it, not a general-purpose alert -- see `CONVENTIONS.md` if this\n  library gains a generic banner/alert component later, and prefer that instead once it exists.\n\n## When not to use\n- A toast/snackbar notification unrelated to the composer -- this component is not\n  self-dismissing and has no positioning of its own (it's a static block, not an overlay).\n\n## Accessibility\nSets `role=\"status\"` for `type=\"info\"`/`type=\"neutral\"` and `role=\"alert\"` for\n`type=\"error\"`/`type=\"warning\"` on its own root element automatically -- no opt-in prop needed.\nBoth roles carry implicit ARIA live-region semantics (`status` is polite, `alert` is assertive),\nso a screen reader announces the message as soon as this banner is inserted into the DOM,\nwithout a consumer having to remember to add `role`/`aria-live` themselves.",
           "attributes": [
             {
               "name": "action-label",
@@ -2172,33 +2478,27 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/bs-input/bs-input.tsx",
+      "path": "src/components/bs-button/bs-icon-button/bs-icon-button.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bs-input",
-          "name": "BsInput",
-          "description": "A single-line text field with an optional label, description, and error state. Also covers a\nrange of related \"field\" shapes (number stepper, password reveal, date, dropdown trigger,\nselect, textarea, chip input, initials, country, and pin) via the `type` prop, since they all\nshare the same label/description/error/icon-slot chrome.\n\n## When to use\n- Collecting a single line of free-text, email, password, or numeric input.\n- Any of the other supported `type`s (search, date, dropdown, select, textarea, chip, initials,\n  country, pin) that share this component's label/description/error chrome.\n- Pair with `error` for inline validation feedback tied to that specific field.\n\n## When not to use\n- A fixed set of choices best served by a dedicated radio/checkbox group rather than a single\n  field. `type=\"select\"` (native `<select>`) and `type=\"dropdown\"` (a `bs-menu` of\n  `bs-menu-item`s from the `options` prop) cover the field-shaped cases; `type=\"chip\"` has no\n  options list at all (freeform chip entry).",
+          "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": "country",
-              "description": "Current selected country code for `type=\"country\"`.",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "fieldName": "country"
-            },
-            {
-              "name": "description",
+              "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"
               },
-              "fieldName": "description"
+              "default": "null",
+              "fieldName": "ariaLabel"
             },
             {
               "name": "disabled",
+              "description": "Disables the button and applies the disabled token set.",
               "type": {
                 "text": "boolean"
               },
@@ -2206,520 +2506,3092 @@
               "fieldName": "disabled"
             },
             {
-              "name": "error",
+              "name": "size",
+              "description": "Sizing scale. `xs` (16px, an 8px icon) is a distinct, much smaller tier meant for compact\nchip/tag \"remove\" controls, not just a smaller toolbar button -- verified against a separate\nFigma redline (EG BrandSync UI Kit v1.5, node 20731:18427) from the one `sm`/`md`/`lg` were\nbuilt against.",
               "type": {
-                "text": "string"
+                "text": "\"lg\" | \"md\" | \"sm\" | \"xs\"",
+                "references": [
+                  {
+                    "name": "BsIconButtonSize"
+                  }
+                ]
               },
-              "fieldName": "error"
+              "default": "'md'",
+              "fieldName": "size"
             },
             {
-              "name": "initials-title",
-              "description": "Current selected title for `type=\"initials\"`. Named `initialsTitle` rather than `title` --\n`title` is a reserved standard HTML attribute (tooltip text) inherited by every element, and\nStencil warns against shadowing it with a component `@Prop`.",
+              "name": "type",
+              "description": "Native `<button>` type.",
               "type": {
-                "text": "string"
+                "text": "\"button\" | \"reset\" | \"submit\""
               },
-              "default": "''",
-              "fieldName": "initialsTitle"
+              "default": "'button'",
+              "fieldName": "type"
             },
             {
-              "name": "label",
+              "name": "variant",
+              "description": "Visual style. Maps to the same semantic token families as `bs-button`'s `variant`.\n`error` is for destructive/irreversible actions per BrandSync guidance, not a stronger\nemphasis alternative to `primary`.",
               "type": {
-                "text": "string"
-              },
-              "fieldName": "label"
+                "text": "\"error\" | \"info\" | \"neutral\" | \"outlined\" | \"primary\" | \"subtle\" | \"success\" | \"warning\"",
+                "references": [
+                  {
+                    "name": "BsIconButtonVariant"
+                  }
+                ]
+              },
+              "default": "'primary'",
+              "fieldName": "variant"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "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",
+              "readonly": true,
+              "attribute": "aria-label"
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "description": "Disables the button and applies the disabled token set.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "disabled"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "description": "Sizing scale. `xs` (16px, an 8px icon) is a distinct, much smaller tier meant for compact\nchip/tag \"remove\" controls, not just a smaller toolbar button -- verified against a separate\nFigma redline (EG BrandSync UI Kit v1.5, node 20731:18427) from the one `sm`/`md`/`lg` were\nbuilt against.",
+              "type": {
+                "text": "\"lg\" | \"md\" | \"sm\" | \"xs\"",
+                "references": [
+                  {
+                    "name": "BsIconButtonSize"
+                  }
+                ]
+              },
+              "default": "'md'",
+              "readonly": true,
+              "attribute": "size"
+            },
+            {
+              "kind": "field",
+              "name": "type",
+              "description": "Native `<button>` type.",
+              "type": {
+                "text": "\"button\" | \"reset\" | \"submit\""
+              },
+              "default": "'button'",
+              "readonly": true,
+              "attribute": "type"
+            },
+            {
+              "kind": "field",
+              "name": "variant",
+              "description": "Visual style. Maps to the same semantic token families as `bs-button`'s `variant`.\n`error` is for destructive/irreversible actions per BrandSync guidance, not a stronger\nemphasis alternative to `primary`.",
+              "type": {
+                "text": "\"error\" | \"info\" | \"neutral\" | \"outlined\" | \"primary\" | \"subtle\" | \"success\" | \"warning\"",
+                "references": [
+                  {
+                    "name": "BsIconButtonVariant"
+                  }
+                ]
+              },
+              "default": "'primary'",
+              "readonly": true,
+              "attribute": "variant"
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Default slot: the icon content. Exactly one icon, no label."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "icon",
+              "description": "The icon wrapper element."
+            }
+          ],
+          "cssProperties": [
+            {
+              "name": "--bs-icon-button-error-default",
+              "description": "Background, variant=\"error\", default. Aliased to --bs-color-error-default."
+            },
+            {
+              "name": "--bs-icon-button-error-disabled",
+              "description": "Background, variant=\"error\", disabled. Aliased to --bs-surface-action-disabled."
+            },
+            {
+              "name": "--bs-icon-button-error-focus",
+              "description": "Focus ring color, variant=\"error\". Aliased to --bs-border-error-focus."
+            },
+            {
+              "name": "--bs-icon-button-error-hover",
+              "description": "Background, variant=\"error\", hover. Aliased to --bs-color-error-hover."
+            },
+            {
+              "name": "--bs-icon-button-error-pressed",
+              "description": "Background, variant=\"error\", pressed. Aliased to --bs-color-error-pressed."
+            },
+            {
+              "name": "--bs-icon-button-icon-size-lg",
+              "description": "Slotted icon width/height at size=\"lg\". 24px."
+            },
+            {
+              "name": "--bs-icon-button-icon-size-md",
+              "description": "Slotted icon width/height at size=\"md\". 20px."
+            },
+            {
+              "name": "--bs-icon-button-icon-size-sm",
+              "description": "Slotted icon width/height at size=\"sm\". 16px."
+            },
+            {
+              "name": "--bs-icon-button-icon-size-xs",
+              "description": "Slotted icon width/height at size=\"xs\". 8px."
+            },
+            {
+              "name": "--bs-icon-button-info-default",
+              "description": "Background, variant=\"info\", default. Aliased to --bs-color-info-default."
+            },
+            {
+              "name": "--bs-icon-button-info-disabled",
+              "description": "Background, variant=\"info\", disabled. Aliased to --bs-surface-action-disabled."
+            },
+            {
+              "name": "--bs-icon-button-info-focus",
+              "description": "Focus ring color, variant=\"info\". Aliased to --bs-border-info-focus."
+            },
+            {
+              "name": "--bs-icon-button-info-hover",
+              "description": "Background, variant=\"info\", hover. Aliased to --bs-color-info-hover."
+            },
+            {
+              "name": "--bs-icon-button-info-pressed",
+              "description": "Background, variant=\"info\", pressed. Aliased to --bs-color-info-pressed."
+            },
+            {
+              "name": "--bs-icon-button-neutral-border",
+              "description": "Border color, variant=\"neutral\", default/disabled. Aliased to --bs-border-neutral-container."
+            },
+            {
+              "name": "--bs-icon-button-neutral-border-hover",
+              "description": "Border color, variant=\"neutral\", hover. Aliased to --bs-border-neutral-container-hover."
+            },
+            {
+              "name": "--bs-icon-button-neutral-border-pressed",
+              "description": "Border color, variant=\"neutral\", pressed. Aliased to --bs-border-neutral-container-pressed."
+            },
+            {
+              "name": "--bs-icon-button-neutral-container",
+              "description": "Background, variant=\"neutral\", default/disabled. Aliased to --bs-color-neutral-container."
+            },
+            {
+              "name": "--bs-icon-button-neutral-hover",
+              "description": "Background, variant=\"neutral\", hover. Aliased to --bs-color-neutral-container-hover."
+            },
+            {
+              "name": "--bs-icon-button-neutral-pressed",
+              "description": "Background, variant=\"neutral\", pressed. Aliased to --bs-color-neutral-container-pressed."
+            },
+            {
+              "name": "--bs-icon-button-outlined-border",
+              "description": "Border color, variant=\"outlined\", default. Aliased to --bs-border-primary."
+            },
+            {
+              "name": "--bs-icon-button-outlined-border-hover",
+              "description": "Border color, variant=\"outlined\", hover/pressed. Aliased to --bs-border-primary-hover."
+            },
+            {
+              "name": "--bs-icon-button-outlined-container",
+              "description": "Background, variant=\"outlined\", hover/pressed. Aliased to --bs-color-primary-container."
+            },
+            {
+              "name": "--bs-icon-button-outlined-focus",
+              "description": "Focus ring color, variant=\"outlined\". Aliased to --bs-border-primary-focus."
+            },
+            {
+              "name": "--bs-icon-button-padding",
+              "description": "Padding on all sides, all sizes (constant -- centers the icon inside the container at every size). Aliased to --bs-spacing-150."
+            },
+            {
+              "name": "--bs-icon-button-padding-xs",
+              "description": "Padding on all sides, size=\"xs\" only -- distinct from --bs-icon-button-padding, since 16px/8px icon math (4px) differs from the sm/md/lg constant (12px). Aliased to --bs-spacing-50."
+            },
+            {
+              "name": "--bs-icon-button-primary-default",
+              "description": "Background, variant=\"primary\", default. Aliased to --bs-color-primary-default."
+            },
+            {
+              "name": "--bs-icon-button-primary-disabled",
+              "description": "Background, variant=\"primary\", disabled. Aliased to --bs-surface-action-disabled."
+            },
+            {
+              "name": "--bs-icon-button-primary-hover",
+              "description": "Background, variant=\"primary\", hover. Aliased to --bs-color-primary-hover."
+            },
+            {
+              "name": "--bs-icon-button-primary-pressed",
+              "description": "Background, variant=\"primary\", pressed. Aliased to --bs-color-primary-pressed."
+            },
+            {
+              "name": "--bs-icon-button-radius",
+              "description": "Corner radius, size=\"sm\"/\"md\"/\"lg\". Aliased to --bs-border-radius-100."
+            },
+            {
+              "name": "--bs-icon-button-radius-xs",
+              "description": "Corner radius, size=\"xs\" -- a smaller radius than --bs-icon-button-radius, since --bs-border-radius-100 (8px) on a 16px box would look nearly circular. Aliased to --bs-border-radius-50."
+            },
+            {
+              "name": "--bs-icon-button-size-lg",
+              "description": "Container width/height at size=\"lg\". 48px."
+            },
+            {
+              "name": "--bs-icon-button-size-md",
+              "description": "Container width/height at size=\"md\". 44px."
+            },
+            {
+              "name": "--bs-icon-button-size-sm",
+              "description": "Container width/height at size=\"sm\". 40px."
+            },
+            {
+              "name": "--bs-icon-button-size-xs",
+              "description": "Container width/height at size=\"xs\". 16px."
+            },
+            {
+              "name": "--bs-icon-button-subtle-focus",
+              "description": "Focus ring color, variant=\"subtle\". Aliased to --bs-border-primary-focus."
+            },
+            {
+              "name": "--bs-icon-button-subtle-hover",
+              "description": "Background, variant=\"subtle\", hover. Aliased to --bs-color-neutral-container."
+            },
+            {
+              "name": "--bs-icon-button-subtle-pressed",
+              "description": "Background, variant=\"subtle\", pressed. Aliased to --bs-color-neutral-container-pressed."
+            },
+            {
+              "name": "--bs-icon-button-success-default",
+              "description": "Background, variant=\"success\", default. Aliased to --bs-color-success-default."
+            },
+            {
+              "name": "--bs-icon-button-success-disabled",
+              "description": "Background, variant=\"success\", disabled. Aliased to --bs-surface-action-disabled."
+            },
+            {
+              "name": "--bs-icon-button-success-focus",
+              "description": "Focus ring color, variant=\"success\". Aliased to --bs-border-success-focus."
+            },
+            {
+              "name": "--bs-icon-button-success-hover",
+              "description": "Background, variant=\"success\", hover. Aliased to --bs-color-success-hover."
+            },
+            {
+              "name": "--bs-icon-button-success-pressed",
+              "description": "Background, variant=\"success\", pressed. Aliased to --bs-color-success-pressed."
+            },
+            {
+              "name": "--bs-icon-button-warning-default",
+              "description": "Background, variant=\"warning\", default. Aliased to --bs-color-warning-default."
+            },
+            {
+              "name": "--bs-icon-button-warning-disabled",
+              "description": "Background, variant=\"warning\", disabled. Aliased to --bs-surface-action-disabled."
+            },
+            {
+              "name": "--bs-icon-button-warning-focus",
+              "description": "Focus ring color, variant=\"warning\". Aliased to --bs-border-warning-focus."
+            },
+            {
+              "name": "--bs-icon-button-warning-hover",
+              "description": "Background, variant=\"warning\", hover. Aliased to --bs-color-warning-hover."
+            },
+            {
+              "name": "--bs-icon-button-warning-pressed",
+              "description": "Background, variant=\"warning\", pressed. Aliased to --bs-color-warning-pressed."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsIconButton",
+          "declaration": {
+            "name": "BsIconButton"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-icon-button",
+          "declaration": {
+            "name": "BsIconButton"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-tab/bs-inline-tab/bs-inline-tab.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-inline-tab",
+          "name": "BsInlineTab",
+          "description": "A pill-shaped tab button -- an optional leading icon plus a text label, rendered as a real\n`<button>` so it participates correctly in tab order and native click/keyboard activation.\nUnlike `bs-tab`'s underline indicator, selection here is communicated entirely by the pill's\nbackground fill color -- there is no separate indicator element.\n\n## When to use\n- As one button within a segmented-control-style tab bar, where exactly one tab is\n  selected/active at a time.\n\n## When not to use\n- As a standalone action button -- use `bs-button` instead, `bs-inline-tab`'s visual language\n  (muted pill until selected/hovered) only makes sense as part of a set.\n\n`selected` is NOT self-toggling -- clicking a `bs-inline-tab` only emits `bsSelect`, it does not\nset its own `selected` prop, and it does not unselect any sibling tabs. Wrap your\n`<bs-inline-tab>` elements in `<bs-tabs type=\"bs-inline-tab\">` -- it owns `role=\"tablist\"` and\ncoordinates selection (listening for `bsSelect` and setting `selected`/`false` across siblings)\nfor you. Using `bs-inline-tab` standalone, outside a `<bs-tabs>` wrapper, still means `selected`\ndoesn't self-toggle and `role=\"tablist\"` isn't provided automatically -- a consumer doing that\nwould still need to coordinate `selected` and supply `role=\"tablist\"` manually, same as\n`bs-tab.mdx`/`bs-radio.mdx` document for their own components. See `bs-inline-tab.mdx`'s\nAccessibility section for the full requirement, including `role=\"tabpanel\"` on the corresponding\ncontent panels.",
+          "attributes": [
+            {
+              "name": "aria-label",
+              "description": "Accessible name for the tab. Required for icon-only usage (no visible label text via the\ndefault slot) so screen readers still announce what the tab does -- without it, an icon-only\ntab has no discernible name at all (axe-core flags this as a critical `button-name`\nviolation). Stencil reflects this camelCase prop to the `aria-label` HTML attribute\nautomatically, same as `bs-tab`'s identical prop.",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "fieldName": "ariaLabel"
+            },
+            {
+              "name": "disabled",
+              "description": "Disables the tab: sets the native `disabled` attribute, suppresses hover/focus styling, and\nprevents clicking from emitting `bsSelect`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "selected",
+              "description": "Whether this tab is the currently active one. NOT mutable and NOT self-toggling -- see the\n\"Known gap\" note in the class JSDoc. Still reflected as an attribute so consumers/CSS can\ntarget `bs-inline-tab[selected]`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "selected"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "description": "Accessible name for the tab. Required for icon-only usage (no visible label text via the\ndefault slot) so screen readers still announce what the tab does -- without it, an icon-only\ntab has no discernible name at all (axe-core flags this as a critical `button-name`\nviolation). Stencil reflects this camelCase prop to the `aria-label` HTML attribute\nautomatically, same as `bs-tab`'s identical prop.",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "readonly": true,
+              "attribute": "aria-label"
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "description": "Disables the tab: sets the native `disabled` attribute, suppresses hover/focus styling, and\nprevents clicking from emitting `bsSelect`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "disabled"
+            },
+            {
+              "kind": "field",
+              "name": "selected",
+              "description": "Whether this tab is the currently active one. NOT mutable and NOT self-toggling -- see the\n\"Known gap\" note in the class JSDoc. Still reflected as an attribute so consumers/CSS can\ntarget `bs-inline-tab[selected]`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "selected",
+              "reflects": true
+            }
+          ],
+          "events": [
+            {
+              "name": "bsSelect",
+              "description": "Fires when the tab is clicked. Does not toggle `selected` itself -- see the class JSDoc.",
+              "type": {
+                "text": "CustomEvent<void>"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Default slot: the tab's label text. When empty (icon-only), no space is reserved for it."
+            },
+            {
+              "name": "icon",
+              "description": "Optional leading icon (24x24). When empty (text-only), no space is reserved for it."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "icon",
+              "description": "The icon wrapper."
+            },
+            {
+              "name": "label",
+              "description": "The label wrapper."
+            },
+            {
+              "name": "tab",
+              "description": "The button element."
+            }
+          ],
+          "cssProperties": [
+            {
+              "name": "--bs-inline-tab-bg-default",
+              "description": "Background, deselected/enabled. Aliased to --bs-color-neutral-container."
+            },
+            {
+              "name": "--bs-inline-tab-bg-disabled",
+              "description": "Background, disabled (wins over selected). Aliased to --bs-surface-action-disabled."
+            },
+            {
+              "name": "--bs-inline-tab-bg-focus",
+              "description": "Background, deselected/focused. Aliased to --bs-color-neutral-container-focused."
+            },
+            {
+              "name": "--bs-inline-tab-bg-hover",
+              "description": "Background, deselected/hovered. Aliased to --bs-color-neutral-container-hover."
+            },
+            {
+              "name": "--bs-inline-tab-bg-pressed",
+              "description": "Background, deselected/pressed. Aliased to --bs-color-neutral-container-pressed."
+            },
+            {
+              "name": "--bs-inline-tab-bg-selected",
+              "description": "Background, selected/enabled. Aliased to --bs-color-primary-default."
+            },
+            {
+              "name": "--bs-inline-tab-bg-selected-focus",
+              "description": "Background, selected/focused. Aliased to --bs-color-primary-focused."
+            },
+            {
+              "name": "--bs-inline-tab-bg-selected-hover",
+              "description": "Background, selected/hovered. Aliased to --bs-color-primary-hover."
+            },
+            {
+              "name": "--bs-inline-tab-bg-selected-pressed",
+              "description": "Background, selected/pressed. Aliased to --bs-color-primary-pressed."
+            },
+            {
+              "name": "--bs-inline-tab-color-default",
+              "description": "Text/icon color, deselected/enabled. Aliased to --bs-text-secondary."
+            },
+            {
+              "name": "--bs-inline-tab-color-disabled",
+              "description": "Text/icon color, disabled (wins over selected). Aliased to --bs-text-on-disabled."
+            },
+            {
+              "name": "--bs-inline-tab-color-hover",
+              "description": "Text/icon color, deselected/hovered, focused or pressed. Aliased to --bs-text-default."
+            },
+            {
+              "name": "--bs-inline-tab-color-selected",
+              "description": "Text/icon color, selected. Aliased to --bs-text-on-action."
+            },
+            {
+              "name": "--bs-inline-tab-focus-ring-color",
+              "description": "Focus ring color. Aliased to --bs-border-neutral-focus."
+            },
+            {
+              "name": "--bs-inline-tab-font-size",
+              "description": "Aliased to --bs-font-size-sm."
+            },
+            {
+              "name": "--bs-inline-tab-font-weight",
+              "description": "Aliased to --bs-font-weight-semibold."
+            },
+            {
+              "name": "--bs-inline-tab-gap",
+              "description": "Gap between icon and label. Aliased to --bs-spacing-50."
+            },
+            {
+              "name": "--bs-inline-tab-line-height",
+              "description": "Aliased to --bs-line-height-body-sm."
+            },
+            {
+              "name": "--bs-inline-tab-padding-left-with-icon",
+              "description": "Left padding, icon present. Aliased to --bs-spacing-150."
+            },
+            {
+              "name": "--bs-inline-tab-padding-right-with-icon",
+              "description": "Right padding, icon present. Aliased to --bs-spacing-200."
+            },
+            {
+              "name": "--bs-inline-tab-padding-x",
+              "description": "Left/right padding, no icon. Aliased to --bs-spacing-200."
+            },
+            {
+              "name": "--bs-inline-tab-padding-y",
+              "description": "Top/bottom padding. Aliased to --bs-spacing-100."
+            },
+            {
+              "name": "--bs-inline-tab-radius",
+              "description": "Corner radius of the pill. Aliased to --bs-border-radius-full."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsInlineTab",
+          "declaration": {
+            "name": "BsInlineTab"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-inline-tab",
+          "declaration": {
+            "name": "BsInlineTab"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-input/bs-input.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-input",
+          "name": "BsInput",
+          "description": "A single-line text field with an optional label, description, and error state. Also covers a\nrange of related \"field\" shapes (number stepper, password reveal, date, dropdown trigger,\nselect, textarea, chip input, initials, country, and pin) via the `type` prop, since they all\nshare the same label/description/error/icon-slot chrome.\n\n## When to use\n- Collecting a single line of free-text, email, password, or numeric input.\n- Any of the other supported `type`s (search, date, dropdown, select, textarea, chip, initials,\n  country, pin) that share this component's label/description/error chrome.\n- Pair with `error` for inline validation feedback tied to that specific field.\n\n## When not to use\n- A fixed set of choices best served by a dedicated radio/checkbox group rather than a single\n  field. `type=\"select\"` (native `<select>`) and `type=\"dropdown\"` (a `bs-menu` of\n  `bs-menu-item`s from the `options` prop) cover the field-shaped cases; `type=\"chip\"` has no\n  options list at all (freeform chip entry).",
+          "attributes": [
+            {
+              "name": "country",
+              "description": "Current selected country code for `type=\"country\"`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "country"
+            },
+            {
+              "name": "description",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "description"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "error",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "error"
+            },
+            {
+              "name": "initials-title",
+              "description": "Current selected title for `type=\"initials\"`. Named `initialsTitle` rather than `title` --\n`title` is a reserved standard HTML attribute (tooltip text) inherited by every element, and\nStencil warns against shadowing it with a component `@Prop`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "initialsTitle"
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "label"
+            },
+            {
+              "name": "length",
+              "description": "Number of cells for `type=\"pin\"`.",
+              "type": {
+                "text": "number"
+              },
+              "default": "4",
+              "fieldName": "length"
+            },
+            {
+              "name": "max",
+              "description": "Maximum value for `type=\"number\"`'s stepper buttons.",
+              "type": {
+                "text": "number"
+              },
+              "fieldName": "max"
+            },
+            {
+              "name": "min",
+              "description": "Minimum value for `type=\"number\"`'s stepper buttons.",
+              "type": {
+                "text": "number"
+              },
+              "fieldName": "min"
+            },
+            {
+              "name": "open",
+              "description": "Whether the `type=\"dropdown\"` trigger is open. Reflects to an attribute so consumers can style\nan open state via CSS. When `options` is non-empty, this also controls whether the `bs-menu`\nof `bs-menu-item`s is rendered below the field.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "open"
+            },
+            {
+              "name": "placeholder",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "placeholder"
+            },
+            {
+              "name": "required",
+              "description": "Marks the field as required: renders a red `*` after the label and sets `aria-required=\"true\"`\non the control. Applies regardless of `type`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "required"
+            },
+            {
+              "name": "rows",
+              "description": "Number of visible rows for `type=\"textarea\"`.",
+              "type": {
+                "text": "number"
+              },
+              "default": "3",
+              "fieldName": "rows"
+            },
+            {
+              "name": "step",
+              "description": "Step size for `type=\"number\"`'s increment/decrement stepper buttons.",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "fieldName": "step"
+            },
+            {
+              "name": "type",
+              "type": {
+                "text": "\"chip\" | \"country\" | \"date\" | \"dropdown\" | \"email\" | \"initials\" | \"number\" | \"password\" | \"pin\" | \"search\" | \"select\" | \"text\" | \"textarea\""
+              },
+              "default": "'text'",
+              "fieldName": "type"
+            },
+            {
+              "name": "value",
+              "description": "Current value. Native `input`/`change` events don't cross the Shadow DOM boundary, so this\ncomponent re-dispatches them as `bsInput`/`bsChange` custom events instead. Mutable so the\n`number` type's stepper buttons can update it directly.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "value"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "chips",
+              "description": "Current chips for `type=\"chip\"`. Must be set as a JS property, not an HTML attribute -- see\nCONVENTIONS.md's non-string props rule.",
+              "type": {
+                "text": "string[]"
+              },
+              "default": "[]",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "country",
+              "description": "Current selected country code for `type=\"country\"`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "country"
+            },
+            {
+              "kind": "field",
+              "name": "countryOptions",
+              "description": "Country select options for `type=\"country\"`. Must be set as a JS property, not an HTML\nattribute -- see CONVENTIONS.md's non-string props rule.",
+              "type": {
+                "text": "{ code: string; label: string; flagIcon?: string; }[]"
+              },
+              "default": "[]",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "description",
+              "type": {
+                "text": "string"
+              },
+              "readonly": true,
+              "attribute": "description"
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "disabled"
+            },
+            {
+              "kind": "field",
+              "name": "error",
+              "type": {
+                "text": "string"
+              },
+              "readonly": true,
+              "attribute": "error"
+            },
+            {
+              "kind": "field",
+              "name": "initialsTitle",
+              "description": "Current selected title for `type=\"initials\"`. Named `initialsTitle` rather than `title` --\n`title` is a reserved standard HTML attribute (tooltip text) inherited by every element, and\nStencil warns against shadowing it with a component `@Prop`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "initials-title"
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "readonly": true,
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "length",
+              "description": "Number of cells for `type=\"pin\"`.",
+              "type": {
+                "text": "number"
+              },
+              "default": "4",
+              "readonly": true,
+              "attribute": "length"
+            },
+            {
+              "kind": "field",
+              "name": "max",
+              "description": "Maximum value for `type=\"number\"`'s stepper buttons.",
+              "type": {
+                "text": "number"
+              },
+              "readonly": true,
+              "attribute": "max"
+            },
+            {
+              "kind": "field",
+              "name": "min",
+              "description": "Minimum value for `type=\"number\"`'s stepper buttons.",
+              "type": {
+                "text": "number"
+              },
+              "readonly": true,
+              "attribute": "min"
+            },
+            {
+              "kind": "field",
+              "name": "open",
+              "description": "Whether the `type=\"dropdown\"` trigger is open. Reflects to an attribute so consumers can style\nan open state via CSS. When `options` is non-empty, this also controls whether the `bs-menu`\nof `bs-menu-item`s is rendered below the field.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "open",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "options",
+              "description": "Options for `type=\"select\"` (rendered as native `<option>`s) and `type=\"dropdown\"` (rendered\nas a `bs-menu` of `bs-menu-item`s when `open`). Must be set as a JS property, not an HTML\nattribute -- see CONVENTIONS.md's non-string props rule.",
+              "type": {
+                "text": "{ label: string; value: string; }[]"
+              },
+              "default": "[]",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "placeholder",
+              "type": {
+                "text": "string"
+              },
+              "readonly": true,
+              "attribute": "placeholder"
+            },
+            {
+              "kind": "field",
+              "name": "required",
+              "description": "Marks the field as required: renders a red `*` after the label and sets `aria-required=\"true\"`\non the control. Applies regardless of `type`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "required"
+            },
+            {
+              "kind": "field",
+              "name": "rows",
+              "description": "Number of visible rows for `type=\"textarea\"`.",
+              "type": {
+                "text": "number"
+              },
+              "default": "3",
+              "readonly": true,
+              "attribute": "rows"
+            },
+            {
+              "kind": "field",
+              "name": "step",
+              "description": "Step size for `type=\"number\"`'s increment/decrement stepper buttons.",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "readonly": true,
+              "attribute": "step"
+            },
+            {
+              "kind": "field",
+              "name": "titleOptions",
+              "description": "Title select options for `type=\"initials\"` (e.g. `['Mrs.', 'Mr.', 'Dr.']`). Must be set as a\nJS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.",
+              "type": {
+                "text": "string[]"
+              },
+              "default": "[]",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "type",
+              "type": {
+                "text": "\"chip\" | \"country\" | \"date\" | \"dropdown\" | \"email\" | \"initials\" | \"number\" | \"password\" | \"pin\" | \"search\" | \"select\" | \"text\" | \"textarea\""
+              },
+              "default": "'text'",
+              "readonly": true,
+              "attribute": "type"
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "description": "Current value. Native `input`/`change` events don't cross the Shadow DOM boundary, so this\ncomponent re-dispatches them as `bsInput`/`bsChange` custom events instead. Mutable so the\n`number` type's stepper buttons can update it directly.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "value"
+            }
+          ],
+          "events": [
+            {
+              "name": "bsChange",
+              "type": {
+                "text": "CustomEvent<string>"
+              }
+            },
+            {
+              "name": "bsChipAdd",
+              "description": "Emitted when a chip is committed (Enter pressed in the draft input) for `type=\"chip\"`.",
+              "type": {
+                "text": "CustomEvent<string>"
+              }
+            },
+            {
+              "name": "bsChipRemove",
+              "description": "Emitted when a chip's remove button is clicked for `type=\"chip\"`.",
+              "type": {
+                "text": "CustomEvent<string>"
+              }
+            },
+            {
+              "name": "bsCountryChange",
+              "description": "Emitted when the country `<select>` changes for `type=\"country\"`.",
+              "type": {
+                "text": "CustomEvent<string>"
+              }
+            },
+            {
+              "name": "bsInput",
+              "type": {
+                "text": "CustomEvent<string>"
+              }
+            },
+            {
+              "name": "bsOpen",
+              "description": "Emitted when `type=\"dropdown\"`'s trigger is toggled. See `open`'s doc comment for this type's\nshell-only limitation.",
+              "type": {
+                "text": "CustomEvent<boolean>"
+              }
+            },
+            {
+              "name": "bsTitleChange",
+              "description": "Emitted when the title `<select>` changes for `type=\"initials\"`.",
+              "type": {
+                "text": "CustomEvent<string>"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "end-icon",
+              "description": "Optional trailing icon, rendered after the native control (e.g. a chevron for a\nfield that opens a picker). Ignored when `type` is `number` (stepper buttons), `password` (show/hide\ntoggle), or `dropdown` (chevron) -- those types always render their own trailing control there.\nFor `type=\"date\"`, the slot is used if provided, otherwise a default calendar icon is shown."
+            },
+            {
+              "name": "icon",
+              "description": "Optional leading icon, rendered before the native control (e.g. a mail icon for an\nemail field). For `type=\"search\"`, the slot is used if provided, otherwise a default\nmagnifying-glass icon is shown."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "chip",
+              "description": "A single chip pill, when `type=\"chip\"`."
+            },
+            {
+              "name": "control",
+              "description": "The native control element (`<input>`, `<select>`, or `<textarea>` depending on\n`type`). Composite types (`initials`, `country`) render this part on more than one element."
+            },
+            {
+              "name": "description",
+              "description": "The helper text element (hidden when `error` is set)."
+            },
+            {
+              "name": "end-icon",
+              "description": "The trailing icon wrapper element."
+            },
+            {
+              "name": "error",
+              "description": "The error message element."
+            },
+            {
+              "name": "error-icon",
+              "description": "The warning icon shown before the error message."
+            },
+            {
+              "name": "field",
+              "description": "The bordered field wrapper containing the icon(s) and native control(s)."
+            },
+            {
+              "name": "icon",
+              "description": "The leading icon wrapper element."
+            },
+            {
+              "name": "label",
+              "description": "The `<label>` element."
+            },
+            {
+              "name": "menu",
+              "description": "The `bs-menu` rendered below the field for `type=\"dropdown\"` when `open` and\n`options` is non-empty."
+            },
+            {
+              "name": "required",
+              "description": "The red `*` rendered after the label text when `required` is set."
+            }
+          ],
+          "cssProperties": [
+            {
+              "name": "--bs-input-chip-bg",
+              "description": "Chip pill background for type=\"chip\". Aliased to --bs-input-bg-disabled."
+            },
+            {
+              "name": "--bs-input-chip-text",
+              "description": "Chip pill text color for type=\"chip\". Aliased to --bs-input-text."
+            },
+            {
+              "name": "--bs-input-description-color",
+              "description": "Description text color. Aliased to --bs-input-description."
+            },
+            {
+              "name": "--bs-input-error-color",
+              "description": "Error message text color. Aliased to --bs-input-error."
+            },
+            {
+              "name": "--bs-input-error-icon-size",
+              "description": "Width/height of the warning icon shown before the error message. Aliased to --bs-spacing-250."
+            },
+            {
+              "name": "--bs-input-field-bg",
+              "description": "Field background. Aliased to --bs-input-bg-default."
+            },
+            {
+              "name": "--bs-input-field-bg-disabled",
+              "description": "Field background when disabled is set. Aliased to --bs-input-bg-disabled."
+            },
+            {
+              "name": "--bs-input-field-border",
+              "description": "Field border color. Aliased to --bs-input-border-default."
+            },
+            {
+              "name": "--bs-input-field-border-error",
+              "description": "Field border color when error is set. Aliased to --bs-input-border-error."
+            },
+            {
+              "name": "--bs-input-field-border-focus",
+              "description": "Field border color when focused. Aliased to --bs-input-border-focus."
+            },
+            {
+              "name": "--bs-input-field-border-hover",
+              "description": "Field border color on hover. Aliased to --bs-input-border-hover."
+            },
+            {
+              "name": "--bs-input-field-placeholder",
+              "description": "Placeholder text color. Aliased to --bs-input-placeholder."
+            },
+            {
+              "name": "--bs-input-field-text",
+              "description": "Input text color. Aliased to --bs-input-text."
+            },
+            {
+              "name": "--bs-input-gap",
+              "description": "Gap between the icon(s) and the native input. Aliased to --bs-spacing-200."
+            },
+            {
+              "name": "--bs-input-height",
+              "description": "Height of the field. Aliased to --bs-spacing-600."
+            },
+            {
+              "name": "--bs-input-icon-color",
+              "description": "Icon color in the default state. Aliased to --bs-icon-muted."
+            },
+            {
+              "name": "--bs-input-icon-color-disabled",
+              "description": "Icon color when disabled is set. Aliased to --bs-input-icon-disabled."
+            },
+            {
+              "name": "--bs-input-icon-color-error",
+              "description": "Icon color when error is set. Aliased to --bs-input-icon-error."
+            },
+            {
+              "name": "--bs-input-icon-size",
+              "description": "Width/height of the leading/trailing icon. Aliased to --bs-spacing-300."
+            },
+            {
+              "name": "--bs-input-label-color",
+              "description": "Label text color. Aliased to --bs-input-label."
+            },
+            {
+              "name": "--bs-input-padding-x",
+              "description": "Horizontal padding inside the field. Aliased to --bs-spacing-150."
+            },
+            {
+              "name": "--bs-input-padding-y",
+              "description": "Vertical padding inside the field. Aliased to --bs-spacing-100."
+            },
+            {
+              "name": "--bs-input-radius",
+              "description": "Corner radius of the field. Aliased to --bs-border-radius-100."
+            },
+            {
+              "name": "--bs-input-stack-gap",
+              "description": "Vertical gap between the label, field, and description/error. Aliased to --bs-spacing-50."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsInput",
+          "declaration": {
+            "name": "BsInput"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-input",
+          "declaration": {
+            "name": "BsInput"
+          }
+        }
+      ]
+    },
+    {
+      "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",
+              "readonly": true,
+              "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'",
+              "readonly": true,
+              "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",
+              "readonly": true,
+              "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'",
+              "readonly": true,
+              "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": "",
+              "description": "Default slot: the menu's items (typically `bs-menu-item` elements, though anything can\nbe slotted in -- this component doesn't restrict slot content via JS)."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "list",
+              "description": "The rounded, elevated box wrapping the slotted items."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsMenu",
+          "declaration": {
+            "name": "BsMenu"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-menu",
+          "declaration": {
+            "name": "BsMenu"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-menu-item/bs-menu-item.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-menu-item",
+          "name": "BsMenuItem",
+          "description": "A single selectable row inside a `bs-menu`: an optional icon plus a text label, rendered as a\nreal `<button>` for correct keyboard/click semantics.\n\n## When to use\n- As a child of `bs-menu`, one per selectable action/option.\n\n## When not to use\n- Outside of `bs-menu` -- this component's sizing/hover treatment is designed to sit inside the\n  menu's rounded, padded list box.",
+          "attributes": [
+            {
+              "name": "disabled",
+              "description": "Disables the item: no hover/pressed/focus styling, no pointer cursor, not reachable by\nkeyboard tabbing, and clicking it does not emit `bsSelect`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "disabled",
+              "description": "Disables the item: no hover/pressed/focus styling, no pointer cursor, not reachable by\nkeyboard tabbing, and clicking it does not emit `bsSelect`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "disabled"
+            }
+          ],
+          "events": [
+            {
+              "name": "bsSelect",
+              "description": "Fires when the item is clicked.",
+              "type": {
+                "text": "CustomEvent<void>"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Default slot: the item's text label."
+            },
+            {
+              "name": "icon",
+              "description": "Optional leading icon (24x24). When left empty, no icon space is reserved."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "icon",
+              "description": "The icon wrapper."
+            },
+            {
+              "name": "item",
+              "description": "The button element."
+            },
+            {
+              "name": "label",
+              "description": "The label wrapper."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsMenuItem",
+          "declaration": {
+            "name": "BsMenuItem"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-menu-item",
+          "declaration": {
+            "name": "BsMenuItem"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-modal/bs-modal.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-modal",
+          "name": "BsModal",
+          "description": "An overlay dialog that interrupts the current flow for a focused task or confirmation.\nCloses itself on backdrop click, Escape, or its own close button, and emits `bsClose`.\n\n## When to use\n- Confirming a consequential action (e.g. \"Confirm booking\") before it takes effect.\n- A short, focused task that doesn't warrant navigating to a new page.\n\n## When not to use\n- For non-blocking status messages — use a toast/notification instead of interrupting the user.\n- For a long, multi-step flow — a full page or a dedicated route is usually a better fit than a\n  modal that just gets taller and taller.",
+          "attributes": [
+            {
+              "name": "heading",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "heading"
+            },
+            {
+              "name": "open",
+              "description": "Mutable + reflected so the component can close itself (backdrop click, Escape, close button)\nthe same way a native `<dialog>` does, while still emitting `bsClose` for the consumer to react to.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "open"
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "\"lg\" | \"md\" | \"sm\"",
+                "references": [
+                  {
+                    "name": "BsModalSize"
+                  }
+                ]
+              },
+              "default": "'md'",
+              "fieldName": "size"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "heading",
+              "type": {
+                "text": "string"
+              },
+              "readonly": true,
+              "attribute": "heading"
+            },
+            {
+              "kind": "field",
+              "name": "open",
+              "description": "Mutable + reflected so the component can close itself (backdrop click, Escape, close button)\nthe same way a native `<dialog>` does, while still emitting `bsClose` for the consumer to react to.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "open",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "\"lg\" | \"md\" | \"sm\"",
+                "references": [
+                  {
+                    "name": "BsModalSize"
+                  }
+                ]
+              },
+              "default": "'md'",
+              "readonly": true,
+              "attribute": "size"
+            }
+          ],
+          "events": [
+            {
+              "name": "bsClose",
+              "type": {
+                "text": "CustomEvent<void>"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Default slot: the dialog body content."
+            },
+            {
+              "name": "footer",
+              "description": "Optional footer content (typically action buttons)."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "backdrop",
+              "description": "The full-viewport overlay behind the dialog."
+            },
+            {
+              "name": "body",
+              "description": "The body content wrapper."
+            },
+            {
+              "name": "close",
+              "description": "The close button."
+            },
+            {
+              "name": "dialog",
+              "description": "The dialog box itself."
+            },
+            {
+              "name": "footer",
+              "description": "The footer wrapper (only visible when the footer slot has content)."
+            },
+            {
+              "name": "header",
+              "description": "The header row (heading + close button)."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsModal",
+          "declaration": {
+            "name": "BsModal"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-modal",
+          "declaration": {
+            "name": "BsModal"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ui-shell/bs-navigation-drawer/bs-navigation-drawer/bs-navigation-drawer.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-navigation-drawer",
+          "name": "BsNavigationDrawer",
+          "description": "A left-side persistent navigation sidebar: the BrandSync logo, a \"Main Menu\" title with a\ncollapse toggle, a reserved slot for a search field, and a scrollable list of nav items.\n\n## When to use\n- The primary in-app navigation, shown alongside `bs-navigation-header` (typically that\n  header's `with-navigation-drawer` alignment, which omits its own logo since this component\n  already renders one).\n\n## When not to use\n- The top navigation bar itself -- use `bs-navigation-header` instead.\n\nThis component renders a real `<nav>` landmark (no explicit `role` needed -- `<nav>` already\ncarries the implicit `navigation` role), labeled via `aria-label={heading}` so the landmark\nstill has a name even when collapsed (see below).\n\n`collapsed` narrows the drawer to a 96px icon-only rail, per Figma node 8028:135374\n(\"Type=Collapsed\"): the title text disappears, the logo swaps from the full \"EG BrandSync\"\nwordmark (`bs-logo variant=\"full\"`) to the real icon-only mark (`bs-logo variant=\"mark\"` -- a\nsecond, properly-designed asset, not a CSS crop of the full one) via CSS visibility toggling on\nboth, the same `:host([collapsed])` attribute-selector pattern already used for the\n`search`/`search-trigger` swap below, the `search` slot is replaced by a compact built-in\nsearch-trigger button (this component can't meaningfully shrink arbitrary slotted search-field\ncontent down to icon size itself, so it emits `bsSearchClick` instead -- e.g. to open a full\nsearch overlay), and every top-level\n`bs-navigation-drawer-item`'s layout switches from icon-beside-label to icon-above-caption.\nThat last part is real prop propagation, not a CSS trick: this component keeps each direct-child\nitem's own `collapsed` prop in sync with its own (see `syncItemsCollapsed` below), the same\ndirect-children-prop-sync approach `bs-tabs` already uses for coordinating `selected` across its\n`bs-tab` children. Clicking the toggle self-toggles `collapsed` (simple local UI state, not\nsomething needing cross-component coordination -- closer to `bs-switch`'s self-toggling\n`checked` than `bs-tab`'s non-self-toggling `selected`) and emits `bsCollapse` with the new\nvalue. The toggle's own caret icon does NOT rotate when collapsed -- Figma's collapsed mock\nreuses the identical left-pointing \"CaretLeft\" asset unchanged, confirmed by directly inspecting\nthat state, so this deliberately does not add the same \"flip on toggle\" idiom the drawer item's\nown disclosure chevron does (that one really is an unconfirmed addition; this one was checked).",
+          "attributes": [
+            {
+              "name": "collapsed",
+              "description": "Narrows the drawer to a 96px icon-only rail (Figma node 8028:135374). Mutable and reflected\n-- clicking the collapse toggle toggles this directly (self-toggling, see the class doc above\nfor why), and this component keeps every direct-child `bs-navigation-drawer-item`'s own\n`collapsed` prop synced to match (see `syncItemsCollapsed`).",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "collapsed"
+            },
+            {
+              "name": "collapsible",
+              "description": "Whether this drawer can be collapsed at all. `false` renders no collapse toggle/chevron --\na \"fixed\" side nav (Carbon's terminology: a `Fixed Side Nav` never collapses, as opposed to a\nrail-capable one) that's always fully expanded. `collapsed` is ignored while this is `false`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "fieldName": "collapsible"
+            },
+            {
+              "name": "heading",
+              "description": "Heading text shown next to the collapse toggle, and used as the `<nav>` landmark's\n`aria-label` (so the landmark keeps a name even when `collapsed` hides the visible text).",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Main Menu'",
+              "fieldName": "heading"
+            },
+            {
+              "name": "logo-background",
+              "description": "Forwarded straight to both internal `bs-logo` elements' own `background` prop. Defaults to\n`\"auto\"`, which follows the ambient `[data-theme=\"dark\"]` state automatically (see `bs-logo`'s\nown docs) -- so if this drawer ends up on a dark surface via the normal theming mechanism, the\nlogo switches to its dedicated dark-background asset with no wiring needed. Set\n`\"light\"`/`\"dark\"` explicitly only if you've overridden `--bs-navigation-drawer-bg` to\nsomething dark yourself *without* setting `[data-theme=\"dark\"]`, and need to pin the logo\nregardless of theme. Has no visible effect on the `variant=\"mark\"` logo shown while\n`collapsed` (see `bs-logo`'s own docs -- there's only one real designed mark asset, it's\nbackground-agnostic).",
+              "type": {
+                "text": "\"auto\" | \"dark\" | \"light\""
+              },
+              "default": "'auto'",
+              "fieldName": "logoBackground"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "collapsed",
+              "description": "Narrows the drawer to a 96px icon-only rail (Figma node 8028:135374). Mutable and reflected\n-- clicking the collapse toggle toggles this directly (self-toggling, see the class doc above\nfor why), and this component keeps every direct-child `bs-navigation-drawer-item`'s own\n`collapsed` prop synced to match (see `syncItemsCollapsed`).",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "collapsed",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "collapsible",
+              "description": "Whether this drawer can be collapsed at all. `false` renders no collapse toggle/chevron --\na \"fixed\" side nav (Carbon's terminology: a `Fixed Side Nav` never collapses, as opposed to a\nrail-capable one) that's always fully expanded. `collapsed` is ignored while this is `false`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "readonly": true,
+              "attribute": "collapsible"
+            },
+            {
+              "kind": "field",
+              "name": "heading",
+              "description": "Heading text shown next to the collapse toggle, and used as the `<nav>` landmark's\n`aria-label` (so the landmark keeps a name even when `collapsed` hides the visible text).",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Main Menu'",
+              "readonly": true,
+              "attribute": "heading"
+            },
+            {
+              "kind": "field",
+              "name": "logoBackground",
+              "description": "Forwarded straight to both internal `bs-logo` elements' own `background` prop. Defaults to\n`\"auto\"`, which follows the ambient `[data-theme=\"dark\"]` state automatically (see `bs-logo`'s\nown docs) -- so if this drawer ends up on a dark surface via the normal theming mechanism, the\nlogo switches to its dedicated dark-background asset with no wiring needed. Set\n`\"light\"`/`\"dark\"` explicitly only if you've overridden `--bs-navigation-drawer-bg` to\nsomething dark yourself *without* setting `[data-theme=\"dark\"]`, and need to pin the logo\nregardless of theme. Has no visible effect on the `variant=\"mark\"` logo shown while\n`collapsed` (see `bs-logo`'s own docs -- there's only one real designed mark asset, it's\nbackground-agnostic).",
+              "type": {
+                "text": "\"auto\" | \"dark\" | \"light\""
+              },
+              "default": "'auto'",
+              "readonly": true,
+              "attribute": "logo-background"
+            }
+          ],
+          "events": [
+            {
+              "name": "bsCollapse",
+              "description": "Fires with the new `collapsed` value when the collapse toggle button is clicked.",
+              "type": {
+                "text": "CustomEvent<boolean>"
+              }
+            },
+            {
+              "name": "bsSearchClick",
+              "description": "Fires when the compact search-trigger button (shown instead of the `search` slot while\n`collapsed`) is clicked -- e.g. to open a full search overlay. This component has no\nvisibility into what the `search` slot actually contains, so it can't drive a real search\nitself once shrunk to icon size.",
+              "type": {
+                "text": "CustomEvent<void>"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Default slot: the scrollable list of nav items, typically one or more\n`bs-navigation-drawer-item` elements."
+            },
+            {
+              "name": "search",
+              "description": "Reserved for a search field, e.g. a `bs-input type=\"search\"`. This component\ndoes not build one itself. Hidden while `collapsed` (see above)."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "collapse",
+              "description": "The collapse toggle button."
+            },
+            {
+              "name": "items",
+              "description": "The wrapper around the default (items) slot."
+            },
+            {
+              "name": "logo",
+              "description": "The wrapper around the BrandSync brand mark. Two of these exist in the shadow DOM\nat once (one wrapping a `bs-logo variant=\"full\"`, one wrapping a `bs-logo variant=\"mark\"`),\nboth carrying this same part name (the same \"multiple elements, one shared part name\"\napproach `bs-attachment`'s `star` part uses) -- only one is visible at a time, toggled by\nplain CSS on `collapsed` (see above), so `::part(logo)` always reaches whichever is showing."
+            },
+            {
+              "name": "search",
+              "description": "The wrapper around the `search` slot."
+            },
+            {
+              "name": "search-trigger",
+              "description": "The compact search button shown instead of the `search` slot while `collapsed`."
+            },
+            {
+              "name": "title",
+              "description": "The \"Main Menu\" heading text wrapper."
+            }
+          ],
+          "cssProperties": [
+            {
+              "name": "--bs-navigation-drawer-bg",
+              "description": "Background of the drawer. Aliased to --bs-surface-base."
+            },
+            {
+              "name": "--bs-navigation-drawer-border",
+              "description": "Right border color. Aliased to --bs-border-neutral-container."
+            },
+            {
+              "name": "--bs-navigation-drawer-collapse-hover",
+              "description": "Collapse toggle background on hover. Aliased to --bs-color-neutral-container."
+            },
+            {
+              "name": "--bs-navigation-drawer-collapse-icon",
+              "description": "Collapse toggle icon color. Aliased to --bs-icon-default."
+            },
+            {
+              "name": "--bs-navigation-drawer-collapse-pressed",
+              "description": "Collapse toggle background when pressed. Aliased to --bs-color-neutral-container-pressed."
+            },
+            {
+              "name": "--bs-navigation-drawer-collapse-radius",
+              "description": "Corner radius of the collapse toggle button. Aliased to --bs-border-radius-100."
+            },
+            {
+              "name": "--bs-navigation-drawer-collapse-size",
+              "description": "Width/height of the collapse toggle button. 48px."
+            },
+            {
+              "name": "--bs-navigation-drawer-collapsed-width",
+              "description": "Width of the drawer when `collapsed`. 96px, per Figma node 8028:135374's own frame (\"Type=Collapsed\")."
+            },
+            {
+              "name": "--bs-navigation-drawer-gap",
+              "description": "Gap between the logo, title row, search slot, and items list. Aliased to --bs-spacing-300 (24px, matching the drawer's own top/bottom padding for an even rhythm) -- bumped up from the originally Figma-measured --bs-spacing-150 (12px) at the user's request after seeing it rendered (felt cramped in practice), not a Figma re-measurement."
+            },
+            {
+              "name": "--bs-navigation-drawer-items-gap",
+              "description": "Gap between top-level item rows in the items list. Aliased to --bs-spacing-100."
+            },
+            {
+              "name": "--bs-navigation-drawer-padding-left",
+              "description": "Left padding. Aliased to --bs-spacing-300 -- note this is deliberately different from --bs-navigation-drawer-padding-right (below), per the Figma spec. Both are ignored (set to 0) while `collapsed` -- see Figma node 8028:135374, which uses `px-0` for the collapsed rail."
+            },
+            {
+              "name": "--bs-navigation-drawer-padding-right",
+              "description": "Right padding. Aliased to --bs-spacing-200."
+            },
+            {
+              "name": "--bs-navigation-drawer-padding-y",
+              "description": "Top/bottom padding. Aliased to --bs-spacing-300."
+            },
+            {
+              "name": "--bs-navigation-drawer-search-trigger-bg",
+              "description": "Search-trigger background. Aliased to --bs-color-neutral-container (Figma's \"button/neutral-container\" tonal fill)."
+            },
+            {
+              "name": "--bs-navigation-drawer-search-trigger-border",
+              "description": "Search-trigger border color. Aliased to --bs-border-neutral-container (same border color as the drawer's own right edge)."
+            },
+            {
+              "name": "--bs-navigation-drawer-search-trigger-icon",
+              "description": "Search-trigger icon color. Aliased to --bs-icon-default."
+            },
+            {
+              "name": "--bs-navigation-drawer-search-trigger-size",
+              "description": "Width/height of the compact search-trigger button shown instead of the `search` slot while `collapsed`. 44px, per Figma."
+            },
+            {
+              "name": "--bs-navigation-drawer-title-color",
+              "description": "Title text color. Aliased to --bs-text-default."
+            },
+            {
+              "name": "--bs-navigation-drawer-title-font-family",
+              "description": "Title text font family. Aliased to --bs-typography-font-family-heading."
+            },
+            {
+              "name": "--bs-navigation-drawer-title-font-size",
+              "description": "Title text font size. The Figma spec calls this style \"heading h7\", but src/global/tokens.css only defines heading tokens through h6 (--bs-fontsize-heading-h6: 16px, --bs-line-height-heading-h6: 20) -- there is no h7 tier. h6 is the smallest/closest defined tier, so this aliases to the plain --bs-font-size-md token (also 16px, the same value as --bs-fontsize-heading-h6) rather than inventing a new h7 token. Flagged here as a judgment call, not a pixel-confirmed h7 value."
+            },
+            {
+              "name": "--bs-navigation-drawer-title-font-weight",
+              "description": "Title text font weight. Aliased to --bs-font-weight-bold."
+            },
+            {
+              "name": "--bs-navigation-drawer-title-line-height",
+              "description": "Title text line height. Aliased to --bs-line-height-heading-h6, for the same reason as the font-size prop above."
+            },
+            {
+              "name": "--bs-navigation-drawer-width",
+              "description": "Default width of the drawer. 280px, matching Figma's own frame -- overridable by a consumer that needs a different fixed width."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsNavigationDrawer",
+          "declaration": {
+            "name": "BsNavigationDrawer"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-navigation-drawer",
+          "declaration": {
+            "name": "BsNavigationDrawer"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ui-shell/bs-navigation-drawer/bs-navigation-drawer-item/bs-navigation-drawer-item.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-navigation-drawer-item",
+          "name": "BsNavigationDrawerItem",
+          "description": "A single row within a `bs-navigation-drawer`'s item list -- either a plain leaf nav item, or an\n`expandable` group header that discloses nested `bs-navigation-drawer-item` children.\n\n## When to use\n- Every row inside a `bs-navigation-drawer`'s default slot.\n\n## When not to use\n- A standalone action outside a navigation drawer -- use `bs-button`/`bs-menu-item` instead.\n\nClick behavior is mutually exclusive, based on `expandable`:\n- `expandable = false` (a plain leaf item): clicking only emits `bsSelect`. `selected` is NOT\n  self-toggling -- same non-self-toggling precedent as `bs-tab`'s `selected` (see `bs-tab.tsx`'s\n  class doc): coordinating which sibling row is selected needs cross-item state a\n  consumer/wrapper owns, not something this component can reason about on its own.\n- `expandable = true` (a group header, never shown with a `selected` tint): clicking toggles\n  `this.expanded` directly and emits `bsToggle` with the new value, and does NOT emit\n  `bsSelect`. This IS self-toggling, unlike `selected` above -- it's simple local disclosure\n  state with no cross-item coordination needed, closer to `bs-switch`'s self-toggling `checked`\n  than `bs-tab`'s non-self-toggling `selected`.\n\nNesting: put child `<bs-navigation-drawer-item nested>` elements inside a parent\n`<bs-navigation-drawer-item expandable>` with `slot=\"children\"`. The parent shows/hides that\nslot's content based on its own `expanded` prop, via a pure-CSS attribute selector (no JS\nvisibility toggling needed, since `expanded` is reflected).\n\n`collapsed` switches this row from its normal icon-beside-label row layout to a compact\nicon-above-caption column (per Figma node 8028:135374, the drawer's \"Type=Collapsed\" state) --\nyou don't need to set this yourself on every item: a parent `bs-navigation-drawer` keeps its own\ntop-level items' `collapsed` prop in sync with its own `collapsed` state automatically (see\n`bs-navigation-drawer.tsx`'s `syncItemsCollapsed`, the same direct-children-prop-sync approach\n`bs-tabs` uses for coordinating `selected` across its own `bs-tab` children). It's still a public\nprop so a standalone item (or this component's own stories) can be demoed without the parent.",
+          "attributes": [
+            {
+              "name": "aria-label",
+              "description": "Optional accessible name override. Not required for `collapsed` rows -- unlike an\nicon-only button, the label caption stays visible (just restyled smaller, under the icon) in\nthat mode per Figma, so the button's default accessible-name computation (its own text\ncontent) already works. Set this if you want a fuller/different name than the visible caption\n(e.g. truncated captions, or matching `bs-switch`/`bs-slider`'s `ariaLabel` convention for\nconsistency).",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "fieldName": "ariaLabel"
+            },
+            {
+              "name": "collapsed",
+              "description": "Switches this row to the compact icon-above-caption column layout used when its parent\n`bs-navigation-drawer` is `collapsed` (see the class doc above). Reflected so\n`bs-navigation-drawer-item[collapsed]` is CSS-targetable. Also forces `expandable` rows'\nchevron and `children` slot to stay hidden regardless of `expanded` -- Figma's collapsed rail\nnever shows a nested tree.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "collapsed"
+            },
+            {
+              "name": "expandable",
+              "description": "Renders this row as a disclosure/group header (trailing chevron, self-toggling `expanded`,\n`bsToggle` instead of `bsSelect` on click) instead of a plain navigable leaf item. See the\nclass doc above for the full click-behavior split.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "expandable"
+            },
+            {
+              "name": "expanded",
+              "description": "Whether an `expandable` row's `children` slot is shown. Mutable and reflected -- clicking an\n`expandable` row toggles this directly (self-toggling, unlike `selected` above), and CSS\nshows/hides the `children` slot wrapper based on the reflected attribute. Ignored when\n`expandable` is false.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "expanded"
+            },
+            {
+              "name": "nested",
+              "description": "Marks this as a child row nested under an `expandable` parent (via `slot=\"children\"`) --\ndeepens the left indent and stops reserving `icon` slot space entirely (Figma's nested rows\nnever have icons).",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "nested"
+            },
+            {
+              "name": "selected",
+              "description": "Tints the row's background/text to indicate it's the current destination. NOT\nself-toggling -- see the class doc above for why. Ignored (never applied) when `expandable`\nis true. Reflected so consumers/CSS can target `bs-navigation-drawer-item[selected]`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "selected"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "description": "Optional accessible name override. Not required for `collapsed` rows -- unlike an\nicon-only button, the label caption stays visible (just restyled smaller, under the icon) in\nthat mode per Figma, so the button's default accessible-name computation (its own text\ncontent) already works. Set this if you want a fuller/different name than the visible caption\n(e.g. truncated captions, or matching `bs-switch`/`bs-slider`'s `ariaLabel` convention for\nconsistency).",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "readonly": true,
+              "attribute": "aria-label"
+            },
+            {
+              "kind": "field",
+              "name": "collapsed",
+              "description": "Switches this row to the compact icon-above-caption column layout used when its parent\n`bs-navigation-drawer` is `collapsed` (see the class doc above). Reflected so\n`bs-navigation-drawer-item[collapsed]` is CSS-targetable. Also forces `expandable` rows'\nchevron and `children` slot to stay hidden regardless of `expanded` -- Figma's collapsed rail\nnever shows a nested tree.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "collapsed",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "expandable",
+              "description": "Renders this row as a disclosure/group header (trailing chevron, self-toggling `expanded`,\n`bsToggle` instead of `bsSelect` on click) instead of a plain navigable leaf item. See the\nclass doc above for the full click-behavior split.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "expandable"
+            },
+            {
+              "kind": "field",
+              "name": "expanded",
+              "description": "Whether an `expandable` row's `children` slot is shown. Mutable and reflected -- clicking an\n`expandable` row toggles this directly (self-toggling, unlike `selected` above), and CSS\nshows/hides the `children` slot wrapper based on the reflected attribute. Ignored when\n`expandable` is false.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "expanded",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "nested",
+              "description": "Marks this as a child row nested under an `expandable` parent (via `slot=\"children\"`) --\ndeepens the left indent and stops reserving `icon` slot space entirely (Figma's nested rows\nnever have icons).",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "nested"
+            },
+            {
+              "kind": "field",
+              "name": "selected",
+              "description": "Tints the row's background/text to indicate it's the current destination. NOT\nself-toggling -- see the class doc above for why. Ignored (never applied) when `expandable`\nis true. Reflected so consumers/CSS can target `bs-navigation-drawer-item[selected]`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "selected",
+              "reflects": true
+            }
+          ],
+          "events": [
+            {
+              "name": "bsSelect",
+              "description": "Fires on click, only when `expandable` is false. See the class doc above.",
+              "type": {
+                "text": "CustomEvent<void>"
+              }
+            },
+            {
+              "name": "bsToggle",
+              "description": "Fires with the new `expanded` value on click, only when `expandable` is true. See the class\ndoc above.",
+              "type": {
+                "text": "CustomEvent<boolean>"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Default slot: the row's label text."
+            },
+            {
+              "name": "children",
+              "description": "`expandable` only: nested `bs-navigation-drawer-item` rows, shown/hidden based\non `expanded`."
+            },
+            {
+              "name": "icon",
+              "description": "Optional leading icon (24x24). Only rendered (and only reserves layout space) when\npopulated -- same \"only take up space if slotted\" pattern as `bs-tab`'s `icon` slot. Not\nrendered at all for `nested` rows (Figma's nested rows never have icons)."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "chevron",
+              "description": "The trailing expand/collapse chevron wrapper (`expandable` only)."
+            },
+            {
+              "name": "children",
+              "description": "The wrapper around the `children` slot."
+            },
+            {
+              "name": "icon",
+              "description": "The icon wrapper (top-level, non-`nested` rows only)."
+            },
+            {
+              "name": "item",
+              "description": "The row's root `<button>` element."
+            },
+            {
+              "name": "label",
+              "description": "The label text wrapper."
+            }
+          ],
+          "cssProperties": [
+            {
+              "name": "--bs-navigation-drawer-item-bg-focus",
+              "description": "Unselected row background while focused (`:focus-visible`) -- shown together with, not instead of, the focus ring below. Aliased to --bs-surface-focus, per the same Figma node (identical value to --bs-surface-hover there)."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-bg-hover",
+              "description": "Unselected row background on hover. Aliased to --bs-surface-hover, per Figma node 13472:7172 (the full Enabled/Hovered/Focused/Pressed/ Disabled state matrix for this component)."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-bg-pressed",
+              "description": "Unselected row background while pressed (`:active`). Aliased to --bs-surface-pressed, per the same Figma node."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-bg-selected",
+              "description": "`selected` row background, resting. Aliased to --bs-surface-selected."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-bg-selected-focus",
+              "description": "`selected` row background while focused. Aliased to --bs-surface-selected-focus, per the same Figma node."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-bg-selected-hover",
+              "description": "`selected` row background on hover. Aliased to --bs-surface-selected-hover, per the same Figma node."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-bg-selected-pressed",
+              "description": "`selected` row background while pressed. Aliased to --bs-surface-selected-pressed, per the same Figma node."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-children-gap",
+              "description": "Gap between nested child rows. Aliased to --bs-spacing-100."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-collapsed-font-size",
+              "description": "Caption font size when `collapsed`. Aliased to --bs-fontsize-caption-sm (12px)."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-collapsed-gap",
+              "description": "Gap between the icon and caption when `collapsed`. Aliased to --bs-spacing-100."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-collapsed-icon-padding-x",
+              "description": "Left/right padding of the small rounded chip behind a `collapsed` row's icon (the `selected` tint applies to just this chip, not the full column). Aliased to --bs-spacing-100."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-collapsed-icon-padding-y",
+              "description": "Top/bottom padding of that chip. Aliased to --bs-spacing-50."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-collapsed-line-height",
+              "description": "Caption line height when `collapsed`. Aliased to --bs-line-height-caption-sm."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-collapsed-padding",
+              "description": "Padding of a `collapsed` row. Aliased to --bs-spacing-100 (8px, all sides -- Figma node 8028:135374's \"Container\")."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-color",
+              "description": "Resting (unselected) text/icon color. Aliased to --bs-text-muted."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-color-hover",
+              "description": "Unselected row text/icon color on hover, focus, or pressed (all three share this color in Figma, distinct from the muted resting color). Aliased to --bs-text-secondary. `selected` rows keep --bs-navigation-drawer-item-color-selected across all of these states instead -- Figma never changes a selected row's text color."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-color-selected",
+              "description": "`selected` text/icon color. Aliased to --bs-text-default."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-focus-ring-color",
+              "description": "Focus ring color. Aliased to --bs-border-neutral-focus."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-font-size",
+              "description": "Label font size. Aliased to --bs-font-size-md."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-font-weight",
+              "description": "Label font weight. Aliased to --bs-font-weight-medium."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-gap",
+              "description": "Gap between the icon, label, and chevron within the row. Aliased to --bs-spacing-100."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-line-height",
+              "description": "Label line height. Aliased to --bs-line-height-body-md."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-padding-left-nested",
+              "description": "Left padding of a `nested` row. Aliased to --bs-spacing-600 (48px) -- deep indent under an expanded parent, replacing --bs-navigation-drawer-item-padding-x on the left side only (right padding stays the same)."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-padding-x",
+              "description": "Left/right padding of a top-level (non-`nested`) row. Aliased to --bs-spacing-100 -- note this is the HORIZONTAL padding while --bs-navigation-drawer-item-padding-y (above) is VERTICAL, the reverse of this value's own relative size (12px vertical / 8px horizontal), per the Figma spec."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-padding-y",
+              "description": "Top/bottom padding of the row. Aliased to --bs-spacing-150."
+            },
+            {
+              "name": "--bs-navigation-drawer-item-radius",
+              "description": "Corner radius of the row. Aliased to --bs-border-radius-100."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsNavigationDrawerItem",
+          "declaration": {
+            "name": "BsNavigationDrawerItem"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-navigation-drawer-item",
+          "declaration": {
+            "name": "BsNavigationDrawerItem"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ui-shell/bs-navigation-header/bs-navigation-header/bs-navigation-header.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-navigation-header",
+          "name": "BsNavigationHeader",
+          "description": "The top-level navigation bar for a page: the BrandSync logo plus two consumer-provided slots\nfor menu/action content (e.g. `bs-button`/`bs-icon-button` elements).\n\n## When to use\n- The persistent top bar of an application, above the page content.\n\n## When not to use\n- The header of a Genie AI chat panel -- use `bs-chatbot-header` instead, which is purpose-built\n  for that narrower layout and its own fixed action buttons.\n\n`alignment` controls both whether the logo renders and how the two slots are laid out:\n- `default` (default): logo on the left, `left` slot content immediately after it, `right` slot\n  content pushed to the far right.\n- `center`: logo and `right` slot both grow equally (`flex: 1`), which centers the `left` slot\n  content in the middle of the bar.\n- `with-navigation-drawer`: no logo at all (this variant assumes a nav-drawer toggle is the\n  leftmost thing on the page instead) -- `left` slot content starts at the bar's own left edge,\n  `right` slot content pushed to the far right.",
+          "attributes": [
+            {
+              "name": "alignment",
+              "description": "Controls whether the logo renders and how the `left`/`right` slots are laid out -- see the\nclass doc above for the three variants' exact behavior.",
+              "type": {
+                "text": "\"center\" | \"default\" | \"with-navigation-drawer\"",
+                "references": [
+                  {
+                    "name": "BsNavigationHeaderAlignment"
+                  }
+                ]
+              },
+              "default": "'default'",
+              "fieldName": "alignment"
+            },
+            {
+              "name": "aria-label",
+              "description": "Accessible label for the header landmark, useful when a page has more than one `<header>`\n(e.g. this one plus a page-specific sub-header) and screen reader users need to tell them\napart in the landmarks list.",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "fieldName": "ariaLabel"
+            },
+            {
+              "name": "logo-background",
+              "description": "Forwarded straight to the internal `bs-logo`'s own `background` prop. Defaults to `\"auto\"`,\nwhich follows the ambient `[data-theme=\"dark\"]` state automatically (see `bs-logo`'s own\ndocs) -- so if this bar ends up on a dark surface via the normal theming mechanism, the logo\nswitches to its dedicated dark-background asset with no wiring needed. Set `\"light\"`/`\"dark\"`\nexplicitly only if you've overridden `--bs-navigation-header-bg` to something dark yourself\n*without* setting `[data-theme=\"dark\"]`, and need to pin the logo regardless of theme.",
+              "type": {
+                "text": "\"auto\" | \"dark\" | \"light\""
+              },
+              "default": "'auto'",
+              "fieldName": "logoBackground"
+            },
+            {
+              "name": "skip-to-content-href",
+              "description": "Fragment/URL to jump to when the \"Skip to main content\" link is activated (e.g.\n`#main-content`, matching an id on your page's main landmark). Unset by default -- the link\nis opt-in rather than pointing at a guessed default id, since a skip link to a target that\ndoesn't exist on the consumer's page is worse than no skip link at all (it silently does\nnothing when activated). Set this to the same id your page's `<main>` (or equivalent) already\nhas to enable it.",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "fieldName": "skipToContentHref"
+            },
+            {
+              "name": "skip-to-content-label",
+              "description": "Link text for the skip-to-content link. Only rendered when `skipToContentHref` is set.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Skip to main content'",
+              "fieldName": "skipToContentLabel"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "alignment",
+              "description": "Controls whether the logo renders and how the `left`/`right` slots are laid out -- see the\nclass doc above for the three variants' exact behavior.",
+              "type": {
+                "text": "\"center\" | \"default\" | \"with-navigation-drawer\"",
+                "references": [
+                  {
+                    "name": "BsNavigationHeaderAlignment"
+                  }
+                ]
+              },
+              "default": "'default'",
+              "readonly": true,
+              "attribute": "alignment"
+            },
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "description": "Accessible label for the header landmark, useful when a page has more than one `<header>`\n(e.g. this one plus a page-specific sub-header) and screen reader users need to tell them\napart in the landmarks list.",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "readonly": true,
+              "attribute": "aria-label"
+            },
+            {
+              "kind": "field",
+              "name": "logoBackground",
+              "description": "Forwarded straight to the internal `bs-logo`'s own `background` prop. Defaults to `\"auto\"`,\nwhich follows the ambient `[data-theme=\"dark\"]` state automatically (see `bs-logo`'s own\ndocs) -- so if this bar ends up on a dark surface via the normal theming mechanism, the logo\nswitches to its dedicated dark-background asset with no wiring needed. Set `\"light\"`/`\"dark\"`\nexplicitly only if you've overridden `--bs-navigation-header-bg` to something dark yourself\n*without* setting `[data-theme=\"dark\"]`, and need to pin the logo regardless of theme.",
+              "type": {
+                "text": "\"auto\" | \"dark\" | \"light\""
+              },
+              "default": "'auto'",
+              "readonly": true,
+              "attribute": "logo-background"
+            },
+            {
+              "kind": "field",
+              "name": "skipToContentHref",
+              "description": "Fragment/URL to jump to when the \"Skip to main content\" link is activated (e.g.\n`#main-content`, matching an id on your page's main landmark). Unset by default -- the link\nis opt-in rather than pointing at a guessed default id, since a skip link to a target that\ndoesn't exist on the consumer's page is worse than no skip link at all (it silently does\nnothing when activated). Set this to the same id your page's `<main>` (or equivalent) already\nhas to enable it.",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "readonly": true,
+              "attribute": "skip-to-content-href"
+            },
+            {
+              "kind": "field",
+              "name": "skipToContentLabel",
+              "description": "Link text for the skip-to-content link. Only rendered when `skipToContentHref` is set.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Skip to main content'",
+              "readonly": true,
+              "attribute": "skip-to-content-label"
+            }
+          ],
+          "slots": [
+            {
+              "name": "left",
+              "description": "Menu/action content immediately after the logo (or, in `with-navigation-drawer`\nmode, at the bar's left edge). Typically one or more `bs-button`/`bs-icon-button` elements."
+            },
+            {
+              "name": "right",
+              "description": "Menu/action content pushed to the bar's far right."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "left",
+              "description": "The wrapper around the `left` slot."
+            },
+            {
+              "name": "logo",
+              "description": "The BrandSync brand mark, rendered via a nested `bs-logo` element (`part=\"logo\"` is\nset directly on that element -- the same pattern `bs-attachment` uses for its own nested\n`bs-icon-button`'s `remove` part -- so `bs-navigation-header::part(logo)` still targets it\ndirectly, no forwarding needed). Not rendered in `with-navigation-drawer` mode."
+            },
+            {
+              "name": "right",
+              "description": "The wrapper around the `right` slot."
+            },
+            {
+              "name": "skip-link",
+              "description": "The \"Skip to main content\" link (only rendered when `skipToContentHref` is set)."
+            }
+          ],
+          "cssProperties": [
+            {
+              "name": "--bs-navigation-header-bg",
+              "description": "Background of the bar. Aliased to --bs-surface-base."
+            },
+            {
+              "name": "--bs-navigation-header-border",
+              "description": "Bottom border color. Aliased to --bs-border-default."
+            },
+            {
+              "name": "--bs-navigation-header-item-gap",
+              "description": "Gap between the logo and the `left` slot (`default` alignment), or between the `left` and `right` slots (`with-navigation-drawer` alignment, which has no logo). Not used in `center` alignment -- see the class doc in bs-navigation-header.tsx. The global vendored --bs-navigation-header-gap token is also malformed (a bare unitless `40`, which is an invalid `gap` value and silently falls back to `normal`/0), so this multiplies it into a real length instead of aliasing directly."
+            },
+            {
+              "name": "--bs-navigation-header-max-width",
+              "description": "Overall max-width of the bar. The global vendored --bs-breakpoints-max-width token is malformed (`1920rem` instead of `1920px` -- at a 16px root font size that's ~30720px, effectively unconstrained), so this is a literal 1920px instead of aliasing to it."
+            },
+            {
+              "name": "--bs-navigation-header-padding-bottom",
+              "description": "Aliased to --bs-spacing-100."
+            },
+            {
+              "name": "--bs-navigation-header-padding-top",
+              "description": "Aliased to --bs-spacing-200."
+            },
+            {
+              "name": "--bs-navigation-header-padding-x",
+              "description": "Aliased to --bs-margin-fluid."
+            },
+            {
+              "name": "--bs-navigation-header-skip-link-bg",
+              "description": "Skip-to-content link background, once focused into view. Aliased to --bs-surface-action."
+            },
+            {
+              "name": "--bs-navigation-header-skip-link-color",
+              "description": "Skip-to-content link text color, once focused into view. Aliased to --bs-text-inverse."
             },
             {
-              "name": "length",
-              "description": "Number of cells for `type=\"pin\"`.",
+              "name": "--bs-navigation-header-slot-gap",
+              "description": "Gap between items within a single `left`/`right` slot. Aliased to --bs-spacing-100."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsNavigationHeader",
+          "declaration": {
+            "name": "BsNavigationHeader"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-navigation-header",
+          "declaration": {
+            "name": "BsNavigationHeader"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-radio/bs-radio.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-radio",
+          "name": "BsRadio",
+          "description": "A single radio button with its label, for one mutually-exclusive choice within a group.\n\n## When to use\n- One option within a set of mutually-exclusive choices, where all options should stay visible\n  (a radio group).\n\n## When not to use\n- An independent, non-exclusive binary choice, or one item in a set of independent choices --\n  use `bs-checkbox` instead.\n- An on/off setting that takes effect immediately (no explicit form submission) -- use `bs-switch`.",
+          "attributes": [
+            {
+              "name": "checked",
+              "description": "Whether the radio is checked. Mutable so clicking the label/input sets it directly.",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "default": "4",
-              "fieldName": "length"
+              "default": "false",
+              "fieldName": "checked"
             },
             {
-              "name": "max",
-              "description": "Maximum value for `type=\"number\"`'s stepper buttons.",
+              "name": "disabled",
+              "description": "Disables the radio: sets the native `disabled` attribute, suppresses hover/focus styling, and\nprevents toggling.",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "fieldName": "max"
+              "default": "false",
+              "fieldName": "disabled"
             },
             {
-              "name": "min",
-              "description": "Minimum value for `type=\"number\"`'s stepper buttons.",
+              "name": "name",
+              "description": "The native radio input's `name` attribute. Passed straight through to the native input inside.\nNOTE: because each `bs-radio` renders its own shadow root, native `<input type=\"radio\">`\nmutual-exclusion grouping (which the HTML spec scopes to a single DOM tree) does NOT extend\nacross separate `bs-radio` instances sharing the same `name` -- checking one will not natively\nuncheck another. Within a single instance this still behaves like a normal radio input. See\nbs-radio.mdx's Accessibility section for this known gap; consumers building a group currently\nneed to manage mutual exclusivity themselves (e.g. via `bsChange`) until a `bs-radio-group`\nwrapper exists.",
               "type": {
-                "text": "number"
+                "text": "string"
               },
-              "fieldName": "min"
+              "fieldName": "name"
             },
             {
-              "name": "open",
-              "description": "Whether the `type=\"dropdown\"` trigger is open. Reflects to an attribute so consumers can style\nan open state via CSS. When `options` is non-empty, this also controls whether the `bs-menu`\nof `bs-menu-item`s is rendered below the field.",
+              "name": "value",
+              "description": "The native radio input's `value` attribute -- read from `event.target.value`, or used when\nwiring the group up to a form.",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "value"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "checked",
+              "description": "Whether the radio is checked. Mutable so clicking the label/input sets it directly.",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "open"
+              "attribute": "checked",
+              "reflects": true
             },
             {
-              "name": "placeholder",
+              "kind": "field",
+              "name": "disabled",
+              "description": "Disables the radio: sets the native `disabled` attribute, suppresses hover/focus styling, and\nprevents toggling.",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "fieldName": "placeholder"
+              "default": "false",
+              "readonly": true,
+              "attribute": "disabled"
             },
             {
-              "name": "required",
-              "description": "Marks the field as required: renders a red `*` after the label and sets `aria-required=\"true\"`\non the control. Applies regardless of `type`.",
+              "kind": "field",
+              "name": "name",
+              "description": "The native radio input's `name` attribute. Passed straight through to the native input inside.\nNOTE: because each `bs-radio` renders its own shadow root, native `<input type=\"radio\">`\nmutual-exclusion grouping (which the HTML spec scopes to a single DOM tree) does NOT extend\nacross separate `bs-radio` instances sharing the same `name` -- checking one will not natively\nuncheck another. Within a single instance this still behaves like a normal radio input. See\nbs-radio.mdx's Accessibility section for this known gap; consumers building a group currently\nneed to manage mutual exclusivity themselves (e.g. via `bsChange`) until a `bs-radio-group`\nwrapper exists.",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "fieldName": "required"
+              "readonly": true,
+              "attribute": "name"
             },
             {
-              "name": "rows",
-              "description": "Number of visible rows for `type=\"textarea\"`.",
+              "kind": "field",
+              "name": "value",
+              "description": "The native radio input's `value` attribute -- read from `event.target.value`, or used when\nwiring the group up to a form.",
               "type": {
-                "text": "number"
+                "text": "string"
               },
-              "default": "3",
-              "fieldName": "rows"
+              "readonly": true,
+              "attribute": "value"
+            }
+          ],
+          "events": [
+            {
+              "name": "bsChange",
+              "description": "Emitted with this radio's own `value` when it becomes checked via user interaction. Since\nnative same-`name` grouping doesn't cross shadow-root boundaries (see the `name` prop's doc),\na consumer wiring up a group of `bs-radio`s must itself set `checked = false` on the others in\nresponse to this event -- there's no automatic un-checking to rely on here.",
+              "type": {
+                "text": "CustomEvent<string>"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Default slot: the label text."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "circle",
+              "description": "The visual radio ring."
             },
             {
-              "name": "step",
-              "description": "Step size for `type=\"number\"`'s increment/decrement stepper buttons.",
+              "name": "dot",
+              "description": "The center fill shown inside the ring when `checked`."
+            },
+            {
+              "name": "label",
+              "description": "The label text wrapper."
+            }
+          ],
+          "cssProperties": [
+            {
+              "name": "--bs-radio-border-width",
+              "description": "Width of the ring border."
+            },
+            {
+              "name": "--bs-radio-gap",
+              "description": "Gap between the ring and the label text. Aliased to --bs-spacing-100."
+            },
+            {
+              "name": "--bs-radio-hit-area-size",
+              "description": "Diameter of the layout box the state layer is centered in."
+            },
+            {
+              "name": "--bs-radio-size",
+              "description": "Diameter of the visual radio ring. Aliased to --bs-spacing-300."
+            },
+            {
+              "name": "--bs-radio-state-layer-size",
+              "description": "Diameter of the hover/focus/pressed halo behind the ring."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsRadio",
+          "declaration": {
+            "name": "BsRadio"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-radio",
+          "declaration": {
+            "name": "BsRadio"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-slider/bs-slider.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-slider",
+          "name": "BsSlider",
+          "description": "A slider for picking a single numeric value (`type=\"default\"`), a value snapped to evenly\nspaced ticks (`type=\"segmented\"`), or a min/max pair (`type=\"range\"`) from within a bounded\n`min`/`max` range.\n\n## When to use\n- A numeric value that's easiest to reason about relative to its bounds (volume, brightness,\n  a price range) rather than typed digit-by-digit.\n- `type=\"segmented\"` when only a fixed number of discrete stops make sense (e.g. a 5-star\n  rating-like scale) but a visual track is still preferable to discrete buttons.\n- `type=\"range\"` for picking a min/max pair (e.g. a price range filter) with two thumbs.\n\n## When not to use\n- A precise value where mis-dragging by a pixel matters more than the at-a-glance bounds --\n  use `bs-input[type=\"number\"]` instead.\n- A small, fixed set of mutually exclusive choices -- use a radio group instead.",
+          "attributes": [
+            {
+              "name": "aria-label",
+              "description": "Accessible name for the slider's native range input(s). Required whenever `showLabel` is\n`false` (a bare track with no visible \"Label\" text) -- without it, the internal native\n`<input>` has no accessible name at all. Setting `aria-label` directly on the `<bs-slider>`\nhost does NOT work for this: that attribute stays on the light-DOM host and is never forwarded\ninto the shadow DOM by the browser. Same pattern/reasoning as `bs-switch`'s and `bs-checkbox`'s\nidentical `ariaLabel` prop. For `type=\"range\"`, this labels the lower-bound thumb; the\nupper-bound thumb gets `\"${ariaLabel} end\"` (or `\"End value\"` when `ariaLabel` is unset).",
               "type": {
-                "text": "number"
+                "text": "string"
               },
-              "default": "1",
-              "fieldName": "step"
+              "default": "null",
+              "fieldName": "ariaLabel"
             },
             {
-              "name": "type",
+              "name": "disabled",
+              "description": "Disables the slider: sets the native `disabled` attribute on the range input(s), suppresses\nhover/focus/drag styling and the value tooltip, and prevents interaction.",
               "type": {
-                "text": "\"chip\" | \"country\" | \"date\" | \"dropdown\" | \"email\" | \"initials\" | \"number\" | \"password\" | \"pin\" | \"search\" | \"select\" | \"text\" | \"textarea\""
+                "text": "boolean"
               },
-              "default": "'text'",
-              "fieldName": "type"
+              "default": "false",
+              "fieldName": "disabled"
             },
             {
-              "name": "value",
-              "description": "Current value. Native `input`/`change` events don't cross the Shadow DOM boundary, so this\ncomponent re-dispatches them as `bsInput`/`bsChange` custom events instead. Mutable so the\n`number` type's stepper buttons can update it directly.",
+              "name": "label",
+              "description": "Label text shown above the track when `showLabel` is set.",
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "fieldName": "value"
-            }
-          ],
-          "members": [
+              "default": "'Label'",
+              "fieldName": "label"
+            },
             {
-              "kind": "field",
-              "name": "chips",
-              "description": "Current chips for `type=\"chip\"`. Must be set as a JS property, not an HTML attribute -- see\nCONVENTIONS.md's non-string props rule.",
+              "name": "max",
+              "description": "Maximum selectable value, for all `type`s.",
               "type": {
-                "text": "string[]"
+                "text": "number"
               },
-              "default": "[]",
-              "readonly": true
+              "default": "100",
+              "fieldName": "max"
             },
             {
-              "kind": "field",
-              "name": "country",
-              "description": "Current selected country code for `type=\"country\"`.",
+              "name": "min",
+              "description": "Minimum selectable value, for all `type`s.",
               "type": {
-                "text": "string"
+                "text": "number"
               },
-              "default": "''",
-              "readonly": true,
-              "attribute": "country"
+              "default": "0",
+              "fieldName": "min"
             },
             {
-              "kind": "field",
-              "name": "countryOptions",
-              "description": "Country select options for `type=\"country\"`. Must be set as a JS property, not an HTML\nattribute -- see CONVENTIONS.md's non-string props rule.",
+              "name": "segments",
+              "description": "Number of equal divisions marked by tick lines along the track, for `type=\"segmented\"` only.\nThe first tick (at the very start of the track) is rendered with `opacity: 0` to keep the\ntick spacing math consistent while not visually doubling up with the track's own start edge --\nthis matches the design spec, not a bug.",
               "type": {
-                "text": "{ code: string; label: string; flagIcon?: string; }[]"
+                "text": "number"
               },
-              "default": "[]",
-              "readonly": true
+              "default": "10",
+              "fieldName": "segments"
             },
             {
-              "kind": "field",
-              "name": "description",
+              "name": "show-label",
+              "description": "Shows/hides the \"Label\" text and editable percentage field(s) above the track, and the\nstatic min/max bound labels flanking it. When `false`, only the bare track (and its\nknob/knobs) renders.",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "readonly": true,
-              "attribute": "description"
+              "default": "true",
+              "fieldName": "showLabel"
             },
             {
-              "kind": "field",
-              "name": "disabled",
+              "name": "step",
+              "description": "Step size between selectable values. For `type=\"segmented\"`, the effective step is derived\nfrom `(max - min) / segments` instead, so the thumb always snaps to a tick.",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "default": "false",
-              "readonly": true,
-              "attribute": "disabled"
+              "default": "1",
+              "fieldName": "step"
             },
             {
-              "kind": "field",
-              "name": "error",
+              "name": "type",
+              "description": "Which slider shape to render. `range` uses two thumbs (`valueStart`/`valueEnd`); `default`\nand `segmented` use one thumb (`value`). `segmented` additionally draws `segments` tick marks\nalong the track.",
               "type": {
-                "text": "string"
+                "text": "\"default\" | \"range\" | \"segmented\"",
+                "references": [
+                  {
+                    "name": "BsSliderType"
+                  }
+                ]
               },
-              "readonly": true,
-              "attribute": "error"
+              "default": "'default'",
+              "fieldName": "type"
             },
             {
-              "kind": "field",
-              "name": "initialsTitle",
-              "description": "Current selected title for `type=\"initials\"`. Named `initialsTitle` rather than `title` --\n`title` is a reserved standard HTML attribute (tooltip text) inherited by every element, and\nStencil warns against shadowing it with a component `@Prop`.",
+              "name": "value",
+              "description": "Current value for `type=\"default\"`/`type=\"segmented\"`. Ignored for `type=\"range\"` -- use\n`valueStart`/`valueEnd` instead. Mutable so dragging the thumb updates it directly.",
               "type": {
-                "text": "string"
+                "text": "number"
               },
-              "default": "''",
-              "readonly": true,
-              "attribute": "initials-title"
+              "default": "0",
+              "fieldName": "value"
             },
             {
-              "kind": "field",
-              "name": "label",
+              "name": "value-end",
+              "description": "Upper thumb's value for `type=\"range\"`. Defaults to `max` when unset. Mutable so dragging the\nthumb updates it directly.",
               "type": {
-                "text": "string"
+                "text": "number"
               },
-              "readonly": true,
-              "attribute": "label"
+              "fieldName": "valueEnd"
             },
             {
-              "kind": "field",
-              "name": "length",
-              "description": "Number of cells for `type=\"pin\"`.",
+              "name": "value-start",
+              "description": "Lower thumb's value for `type=\"range\"`. Defaults to `min` when unset. Mutable so dragging the\nthumb updates it directly.",
               "type": {
                 "text": "number"
               },
-              "default": "4",
+              "fieldName": "valueStart"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "description": "Accessible name for the slider's native range input(s). Required whenever `showLabel` is\n`false` (a bare track with no visible \"Label\" text) -- without it, the internal native\n`<input>` has no accessible name at all. Setting `aria-label` directly on the `<bs-slider>`\nhost does NOT work for this: that attribute stays on the light-DOM host and is never forwarded\ninto the shadow DOM by the browser. Same pattern/reasoning as `bs-switch`'s and `bs-checkbox`'s\nidentical `ariaLabel` prop. For `type=\"range\"`, this labels the lower-bound thumb; the\nupper-bound thumb gets `\"${ariaLabel} end\"` (or `\"End value\"` when `ariaLabel` is unset).",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
               "readonly": true,
-              "attribute": "length"
+              "attribute": "aria-label"
             },
             {
               "kind": "field",
-              "name": "max",
-              "description": "Maximum value for `type=\"number\"`'s stepper buttons.",
+              "name": "disabled",
+              "description": "Disables the slider: sets the native `disabled` attribute on the range input(s), suppresses\nhover/focus/drag styling and the value tooltip, and prevents interaction.",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
+              "default": "false",
               "readonly": true,
-              "attribute": "max"
+              "attribute": "disabled"
             },
             {
               "kind": "field",
-              "name": "min",
-              "description": "Minimum value for `type=\"number\"`'s stepper buttons.",
+              "name": "label",
+              "description": "Label text shown above the track when `showLabel` is set.",
               "type": {
-                "text": "number"
+                "text": "string"
               },
+              "default": "'Label'",
               "readonly": true,
-              "attribute": "min"
+              "attribute": "label"
             },
             {
               "kind": "field",
-              "name": "open",
-              "description": "Whether the `type=\"dropdown\"` trigger is open. Reflects to an attribute so consumers can style\nan open state via CSS. When `options` is non-empty, this also controls whether the `bs-menu`\nof `bs-menu-item`s is rendered below the field.",
+              "name": "max",
+              "description": "Maximum selectable value, for all `type`s.",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "default": "false",
-              "attribute": "open",
-              "reflects": true
+              "default": "100",
+              "readonly": true,
+              "attribute": "max"
             },
             {
               "kind": "field",
-              "name": "options",
-              "description": "Options for `type=\"select\"` (rendered as native `<option>`s) and `type=\"dropdown\"` (rendered\nas a `bs-menu` of `bs-menu-item`s when `open`). Must be set as a JS property, not an HTML\nattribute -- see CONVENTIONS.md's non-string props rule.",
+              "name": "min",
+              "description": "Minimum selectable value, for all `type`s.",
               "type": {
-                "text": "{ label: string; value: string; }[]"
+                "text": "number"
               },
-              "default": "[]",
-              "readonly": true
+              "default": "0",
+              "readonly": true,
+              "attribute": "min"
             },
             {
               "kind": "field",
-              "name": "placeholder",
+              "name": "segments",
+              "description": "Number of equal divisions marked by tick lines along the track, for `type=\"segmented\"` only.\nThe first tick (at the very start of the track) is rendered with `opacity: 0` to keep the\ntick spacing math consistent while not visually doubling up with the track's own start edge --\nthis matches the design spec, not a bug.",
               "type": {
-                "text": "string"
+                "text": "number"
               },
+              "default": "10",
               "readonly": true,
-              "attribute": "placeholder"
+              "attribute": "segments"
             },
             {
               "kind": "field",
-              "name": "required",
-              "description": "Marks the field as required: renders a red `*` after the label and sets `aria-required=\"true\"`\non the control. Applies regardless of `type`.",
+              "name": "showLabel",
+              "description": "Shows/hides the \"Label\" text and editable percentage field(s) above the track, and the\nstatic min/max bound labels flanking it. When `false`, only the bare track (and its\nknob/knobs) renders.",
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
+              "default": "true",
               "readonly": true,
-              "attribute": "required"
+              "attribute": "show-label"
             },
             {
               "kind": "field",
-              "name": "rows",
-              "description": "Number of visible rows for `type=\"textarea\"`.",
+              "name": "step",
+              "description": "Step size between selectable values. For `type=\"segmented\"`, the effective step is derived\nfrom `(max - min) / segments` instead, so the thumb always snaps to a tick.",
               "type": {
                 "text": "number"
               },
-              "default": "3",
+              "default": "1",
               "readonly": true,
-              "attribute": "rows"
+              "attribute": "step"
             },
             {
               "kind": "field",
-              "name": "step",
-              "description": "Step size for `type=\"number\"`'s increment/decrement stepper buttons.",
+              "name": "type",
+              "description": "Which slider shape to render. `range` uses two thumbs (`valueStart`/`valueEnd`); `default`\nand `segmented` use one thumb (`value`). `segmented` additionally draws `segments` tick marks\nalong the track.",
               "type": {
-                "text": "number"
+                "text": "\"default\" | \"range\" | \"segmented\"",
+                "references": [
+                  {
+                    "name": "BsSliderType"
+                  }
+                ]
               },
-              "default": "1",
+              "default": "'default'",
               "readonly": true,
-              "attribute": "step"
+              "attribute": "type"
             },
             {
               "kind": "field",
-              "name": "titleOptions",
-              "description": "Title select options for `type=\"initials\"` (e.g. `['Mrs.', 'Mr.', 'Dr.']`). Must be set as a\nJS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.",
+              "name": "value",
+              "description": "Current value for `type=\"default\"`/`type=\"segmented\"`. Ignored for `type=\"range\"` -- use\n`valueStart`/`valueEnd` instead. Mutable so dragging the thumb updates it directly.",
               "type": {
-                "text": "string[]"
+                "text": "number"
               },
-              "default": "[]",
-              "readonly": true
+              "default": "0",
+              "attribute": "value"
             },
             {
               "kind": "field",
-              "name": "type",
+              "name": "valueEnd",
+              "description": "Upper thumb's value for `type=\"range\"`. Defaults to `max` when unset. Mutable so dragging the\nthumb updates it directly.",
               "type": {
-                "text": "\"chip\" | \"country\" | \"date\" | \"dropdown\" | \"email\" | \"initials\" | \"number\" | \"password\" | \"pin\" | \"search\" | \"select\" | \"text\" | \"textarea\""
+                "text": "number"
               },
-              "default": "'text'",
-              "readonly": true,
-              "attribute": "type"
+              "attribute": "value-end"
             },
             {
               "kind": "field",
-              "name": "value",
-              "description": "Current value. Native `input`/`change` events don't cross the Shadow DOM boundary, so this\ncomponent re-dispatches them as `bsInput`/`bsChange` custom events instead. Mutable so the\n`number` type's stepper buttons can update it directly.",
+              "name": "valueStart",
+              "description": "Lower thumb's value for `type=\"range\"`. Defaults to `min` when unset. Mutable so dragging the\nthumb updates it directly.",
               "type": {
-                "text": "string"
+                "text": "number"
               },
-              "default": "''",
-              "attribute": "value"
+              "attribute": "value-start"
             }
           ],
           "events": [
             {
               "name": "bsChange",
+              "description": "Emitted when `value` changes via user interaction (dragging the thumb, or committing the\nvalue field), with the new value. Only fires for `type=\"default\"`/`type=\"segmented\"`.",
               "type": {
-                "text": "CustomEvent<string>"
+                "text": "CustomEvent<number>"
               }
             },
             {
-              "name": "bsChipAdd",
-              "description": "Emitted when a chip is committed (Enter pressed in the draft input) for `type=\"chip\"`.",
+              "name": "bsRangeChange",
+              "description": "Emitted when `valueStart`/`valueEnd` changes via user interaction, with both current values.\nOnly fires for `type=\"range\"`.",
               "type": {
-                "text": "CustomEvent<string>"
+                "text": "CustomEvent<{ start: number; end: number; }>"
               }
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "bound",
+              "description": "Each static min/max bound label flanking the track itself."
             },
             {
-              "name": "bsChipRemove",
-              "description": "Emitted when a chip's remove button is clicked for `type=\"chip\"`.",
-              "type": {
-                "text": "CustomEvent<string>"
-              }
+              "name": "control",
+              "description": "The native range input(s) that drive the knob(s)."
             },
             {
-              "name": "bsCountryChange",
-              "description": "Emitted when the country `<select>` changes for `type=\"country\"`.",
-              "type": {
-                "text": "CustomEvent<string>"
-              }
+              "name": "field",
+              "description": "Each editable percentage-value field, shown top-right above the track."
             },
             {
-              "name": "bsInput",
-              "type": {
-                "text": "CustomEvent<string>"
-              }
+              "name": "fill",
+              "description": "The active/filled portion of the track."
             },
             {
-              "name": "bsOpen",
-              "description": "Emitted when `type=\"dropdown\"`'s trigger is toggled. See `open`'s doc comment for this type's\nshell-only limitation.",
-              "type": {
-                "text": "CustomEvent<boolean>"
-              }
+              "name": "label",
+              "description": "The \"Label\" text above the track."
             },
             {
-              "name": "bsTitleChange",
-              "description": "Emitted when the title `<select>` changes for `type=\"initials\"`.",
-              "type": {
-                "text": "CustomEvent<string>"
-              }
+              "name": "tooltip",
+              "description": "The value tooltip shown above a knob while focused/dragging."
+            },
+            {
+              "name": "track",
+              "description": "The background (inactive) track."
             }
           ],
-          "slots": [
+          "cssProperties": [
             {
-              "name": "end-icon",
-              "description": "Optional trailing icon, rendered after the native control (e.g. a chevron for a\nfield that opens a picker). Ignored when `type` is `number` (stepper buttons), `password` (show/hide\ntoggle), or `dropdown` (chevron) -- those types always render their own trailing control there.\nFor `type=\"date\"`, the slot is used if provided, otherwise a default calendar icon is shown."
+              "name": "--bs-slider-bound-color",
+              "description": "Static min/max bound label color, enabled. Aliased to --bs-text-default."
             },
             {
-              "name": "icon",
-              "description": "Optional leading icon, rendered before the native control (e.g. a mail icon for an\nemail field). For `type=\"search\"`, the slot is used if provided, otherwise a default\nmagnifying-glass icon is shown."
-            }
-          ],
-          "cssParts": [
+              "name": "--bs-slider-bound-color-disabled",
+              "description": "Static min/max bound label color, disabled. Aliased to --bs-text-on-disabled."
+            },
             {
-              "name": "chip",
-              "description": "A single chip pill, when `type=\"chip\"`."
+              "name": "--bs-slider-field-bg",
+              "description": "Percentage field background. Aliased to --bs-input-bg-default."
             },
             {
-              "name": "control",
-              "description": "The native control element (`<input>`, `<select>`, or `<textarea>` depending on\n`type`). Composite types (`initials`, `country`) render this part on more than one element."
+              "name": "--bs-slider-field-border",
+              "description": "Percentage field border color. Aliased to --bs-input-border-default."
             },
             {
-              "name": "description",
-              "description": "The helper text element (hidden when `error` is set)."
+              "name": "--bs-slider-field-radius",
+              "description": "Percentage field corner radius. Aliased to --bs-border-radius-100."
             },
             {
-              "name": "end-icon",
-              "description": "The trailing icon wrapper element."
+              "name": "--bs-slider-field-text",
+              "description": "Percentage field text color (input value and \"%\" suffix). Aliased to --bs-input-text."
             },
             {
-              "name": "error",
-              "description": "The error message element."
+              "name": "--bs-slider-field-text-disabled",
+              "description": "Percentage field text color, disabled. Aliased to --bs-text-on-disabled."
             },
             {
-              "name": "error-icon",
-              "description": "The warning icon shown before the error message."
+              "name": "--bs-slider-field-width",
+              "description": "Width of each editable percentage field. Fixed 56px per the design spec."
             },
             {
-              "name": "field",
-              "description": "The bordered field wrapper containing the icon(s) and native control(s)."
+              "name": "--bs-slider-fill-bg",
+              "description": "Active/filled track background, enabled. Aliased to --bs-surface-action."
             },
             {
-              "name": "icon",
-              "description": "The leading icon wrapper element."
+              "name": "--bs-slider-fill-bg-disabled",
+              "description": "Active/filled track background, disabled. Aliased to --bs-surface-on-action-disabled."
             },
             {
-              "name": "label",
-              "description": "The `<label>` element."
+              "name": "--bs-slider-focus-ring-color",
+              "description": "Knob focus ring color. Aliased to --bs-border-primary-focus."
             },
             {
-              "name": "menu",
-              "description": "The `bs-menu` rendered below the field for `type=\"dropdown\"` when `open` and\n`options` is non-empty."
+              "name": "--bs-slider-focus-ring-gap-color",
+              "description": "The gap color between the knob and its focus ring (mirrors bs-checkbox's outline-offset gap, drawn via box-shadow here since outline doesn't reliably clip to a circular ::-webkit-slider-thumb/::-moz-range-thumb pseudo-element). Aliased to --bs-surface-base."
             },
             {
-              "name": "required",
-              "description": "The red `*` rendered after the label text when `required` is set."
-            }
-          ],
-          "cssProperties": [
+              "name": "--bs-slider-gap",
+              "description": "Gap between the label text and the row, and between the row's own items. Aliased to --bs-spacing-100."
+            },
             {
-              "name": "--bs-input-chip-bg",
-              "description": "Chip pill background for type=\"chip\". Aliased to --bs-input-bg-disabled."
+              "name": "--bs-slider-knob-bg",
+              "description": "Knob circle background, enabled/active. A solid filled dot per the Figma spec (node 5266:50184) -- not a white circle with a drop shadow. Aliased to --bs-surface-action."
             },
             {
-              "name": "--bs-input-chip-text",
-              "description": "Chip pill text color for type=\"chip\". Aliased to --bs-input-text."
+              "name": "--bs-slider-knob-color-disabled",
+              "description": "Knob circle background, disabled. Aliased to --bs-surface-on-action-disabled (matches the disabled fill token, not the muted text token)."
             },
             {
-              "name": "--bs-input-description-color",
-              "description": "Description text color. Aliased to --bs-input-description."
+              "name": "--bs-slider-knob-hit-size",
+              "description": "Diameter of the knob's invisible hit-target area. Aliased to --bs-spacing-600."
             },
             {
-              "name": "--bs-input-error-color",
-              "description": "Error message text color. Aliased to --bs-input-error."
+              "name": "--bs-slider-knob-size",
+              "description": "Diameter of the knob's visible circle. Aliased to --bs-spacing-300."
             },
             {
-              "name": "--bs-input-error-icon-size",
-              "description": "Width/height of the warning icon shown before the error message. Aliased to --bs-spacing-250."
+              "name": "--bs-slider-label-color",
+              "description": "Label text color, enabled. Aliased to --bs-text-default."
             },
             {
-              "name": "--bs-input-field-bg",
-              "description": "Field background. Aliased to --bs-input-bg-default."
+              "name": "--bs-slider-label-color-disabled",
+              "description": "Label text color, disabled. Aliased to --bs-text-muted."
             },
             {
-              "name": "--bs-input-field-bg-disabled",
-              "description": "Field background when disabled is set. Aliased to --bs-input-bg-disabled."
+              "name": "--bs-slider-label-font-weight",
+              "description": "Label text font weight. Aliased to --bs-font-weight-semibold."
             },
             {
-              "name": "--bs-input-field-border",
-              "description": "Field border color. Aliased to --bs-input-border-default."
+              "name": "--bs-slider-tick-bg",
+              "description": "Segmented tick mark color. Aliased to --bs-surface-inset."
             },
             {
-              "name": "--bs-input-field-border-error",
-              "description": "Field border color when error is set. Aliased to --bs-input-border-error."
+              "name": "--bs-slider-tooltip-bg",
+              "description": "Value tooltip background. Aliased to --bs-surface-inverse."
             },
             {
-              "name": "--bs-input-field-border-focus",
-              "description": "Field border color when focused. Aliased to --bs-input-border-focus."
+              "name": "--bs-slider-tooltip-color",
+              "description": "Value tooltip text color. Aliased to --bs-text-inverse."
             },
             {
-              "name": "--bs-input-field-border-hover",
-              "description": "Field border color on hover. Aliased to --bs-input-border-hover."
+              "name": "--bs-slider-tooltip-radius",
+              "description": "Value tooltip corner radius. Aliased to --bs-border-radius-50."
             },
             {
-              "name": "--bs-input-field-placeholder",
-              "description": "Placeholder text color. Aliased to --bs-input-placeholder."
+              "name": "--bs-slider-track-bg",
+              "description": "Inactive track background, enabled. Aliased to --bs-surface-container."
             },
             {
-              "name": "--bs-input-field-text",
-              "description": "Input text color. Aliased to --bs-input-text."
+              "name": "--bs-slider-track-bg-disabled",
+              "description": "Inactive track background, disabled. Aliased to --bs-surface-action-disabled."
+            },
+            {
+              "name": "--bs-slider-track-height",
+              "description": "Track thickness, constant regardless of type. Aliased to --bs-spacing-50."
+            },
+            {
+              "name": "--bs-slider-track-radius",
+              "description": "Track corner radius (pill). Aliased to --bs-border-radius-full."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsSlider",
+          "declaration": {
+            "name": "BsSlider"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-slider",
+          "declaration": {
+            "name": "BsSlider"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-source-link/bs-source-link.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-source-link",
+          "name": "BsSourceLink",
+          "description": "A single citation row inside `bs-chatbot-sources-drawer` -- a file icon + filename on the first\nline, the originating system and version on the second, and a trailing \"open\" arrow.\n\n## When to use\n- One row per source Genie cited in a response, slotted into `bs-chatbot-sources-drawer`.\n\n## When not to use\n- Outside the sources drawer context -- this is a purpose-built citation row, not a generic\n  link/list-item component.",
+          "attributes": [
+            {
+              "name": "file-name",
+              "description": "The cited document's filename.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Source'",
+              "fieldName": "fileName"
+            },
+            {
+              "name": "href",
+              "description": "If set, renders the row as a link that opens this URL; otherwise as a button that only emits `bsOpen`.",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "href"
+            },
+            {
+              "name": "source-name",
+              "description": "The system/app the document came from (e.g. \"HoltePortalen\").",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "sourceName"
+            },
+            {
+              "name": "target",
+              "description": "`target` used when `href` is set.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'_blank'",
+              "fieldName": "target"
+            },
+            {
+              "name": "version",
+              "description": "The document's version label (e.g. \"v3.2\"). Omit if the source has no version.",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "version"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "fileName",
+              "description": "The cited document's filename.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Source'",
+              "readonly": true,
+              "attribute": "file-name"
             },
             {
-              "name": "--bs-input-gap",
-              "description": "Gap between the icon(s) and the native input. Aliased to --bs-spacing-200."
+              "kind": "field",
+              "name": "href",
+              "description": "If set, renders the row as a link that opens this URL; otherwise as a button that only emits `bsOpen`.",
+              "type": {
+                "text": "string"
+              },
+              "readonly": true,
+              "attribute": "href"
             },
             {
-              "name": "--bs-input-height",
-              "description": "Height of the field. Aliased to --bs-spacing-600."
+              "kind": "field",
+              "name": "sourceName",
+              "description": "The system/app the document came from (e.g. \"HoltePortalen\").",
+              "type": {
+                "text": "string"
+              },
+              "readonly": true,
+              "attribute": "source-name"
             },
             {
-              "name": "--bs-input-icon-color",
-              "description": "Icon color in the default state. Aliased to --bs-icon-muted."
+              "kind": "field",
+              "name": "target",
+              "description": "`target` used when `href` is set.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'_blank'",
+              "readonly": true,
+              "attribute": "target"
             },
             {
-              "name": "--bs-input-icon-color-disabled",
-              "description": "Icon color when disabled is set. Aliased to --bs-input-icon-disabled."
-            },
+              "kind": "field",
+              "name": "version",
+              "description": "The document's version label (e.g. \"v3.2\"). Omit if the source has no version.",
+              "type": {
+                "text": "string"
+              },
+              "readonly": true,
+              "attribute": "version"
+            }
+          ],
+          "events": [
             {
-              "name": "--bs-input-icon-color-error",
-              "description": "Icon color when error is set. Aliased to --bs-input-icon-error."
-            },
+              "name": "bsOpen",
+              "description": "Fires on click/activation, whether or not `href` is set -- lets the consuming app log or handle the open.",
+              "type": {
+                "text": "CustomEvent<void>"
+              }
+            }
+          ],
+          "slots": [
             {
-              "name": "--bs-input-icon-size",
-              "description": "Width/height of the leading/trailing icon. Aliased to --bs-spacing-300."
-            },
+              "name": "icon",
+              "description": "Overrides the default file icon."
+            }
+          ],
+          "cssParts": [
             {
-              "name": "--bs-input-label-color",
-              "description": "Label text color. Aliased to --bs-input-label."
+              "name": "arrow",
+              "description": "The trailing \"open\" arrow icon."
             },
             {
-              "name": "--bs-input-padding-x",
-              "description": "Horizontal padding inside the field. Aliased to --bs-spacing-150."
+              "name": "filename",
+              "description": "The filename text."
             },
             {
-              "name": "--bs-input-padding-y",
-              "description": "Vertical padding inside the field. Aliased to --bs-spacing-100."
+              "name": "icon",
+              "description": "The leading file-type icon."
             },
             {
-              "name": "--bs-input-radius",
-              "description": "Corner radius of the field. Aliased to --bs-border-radius-100."
+              "name": "source",
+              "description": "The source system name."
             },
             {
-              "name": "--bs-input-stack-gap",
-              "description": "Vertical gap between the label, field, and description/error. Aliased to --bs-spacing-50."
+              "name": "version",
+              "description": "The version label."
             }
           ]
         }
@@ -2727,126 +5599,253 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BsInput",
+          "name": "BsSourceLink",
           "declaration": {
-            "name": "BsInput"
+            "name": "BsSourceLink"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bs-input",
+          "name": "bs-source-link",
           "declaration": {
-            "name": "BsInput"
+            "name": "BsSourceLink"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/bs-menu/bs-menu.tsx",
+      "path": "src/components/bs-switch/bs-switch.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": [
+          "tagName": "bs-switch",
+          "name": "BsSwitch",
+          "description": "A toggle switch for an on/off setting that takes effect immediately (no explicit form\nsubmission required).\n\n## When to use\n- A binary setting that applies right away (e.g. \"Enable notifications\", \"Dark mode\").\n\n## When not to use\n- A binary choice that's part of a form submitted later, or one item within a group of\n  independent choices -- use `bs-checkbox` instead.\n- A single mutually-exclusive choice from a set -- use a radio group instead.",
+          "attributes": [
             {
-              "name": "",
-              "description": "Default slot: the menu's items (typically `bs-menu-item` elements, though anything can\nbe slotted in -- this component doesn't restrict slot content via JS)."
-            }
-          ],
-          "cssParts": [
+              "name": "aria-label",
+              "description": "Accessible name for the switch. Required whenever the default (label) slot is empty (e.g. a\nbare \"enabled\" switch in a table row) -- without it, the internal native `<input>` has no\naccessible name at all. Setting `aria-label` directly on the `<bs-switch>` host does NOT\nwork for this: that attribute stays on the light-DOM host and is never forwarded into the\nshadow DOM by the browser, so the actual focusable element (the native `<input>` inside) stays\nnameless. This prop exists specifically to bridge that gap -- same pattern as `bs-button`'s and\n`bs-checkbox`'s identical `ariaLabel` prop, both of which explicitly bind it onto their own\ninternal focusable element for the same reason.",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "fieldName": "ariaLabel"
+            },
             {
-              "name": "list",
-              "description": "The rounded, elevated box wrapping the slotted items."
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "BsMenu",
-          "declaration": {
-            "name": "BsMenu"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "bs-menu",
-          "declaration": {
-            "name": "BsMenu"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/bs-menu-item/bs-menu-item.tsx",
-      "declarations": [
-        {
-          "kind": "class",
-          "customElement": true,
-          "tagName": "bs-menu-item",
-          "name": "BsMenuItem",
-          "description": "A single selectable row inside a `bs-menu`: an optional icon plus a text label, rendered as a\nreal `<button>` for correct keyboard/click semantics.\n\n## When to use\n- As a child of `bs-menu`, one per selectable action/option.\n\n## When not to use\n- Outside of `bs-menu` -- this component's sizing/hover treatment is designed to sit inside the\n  menu's rounded, padded list box.",
-          "attributes": [
+              "name": "checked",
+              "description": "Whether the switch is on. Mutable so clicking the label/input toggles it directly, and\nreflected so consumers can target `bs-switch[checked]` via CSS.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "checked"
+            },
             {
               "name": "disabled",
-              "description": "Disables the item: no hover/pressed/focus styling, no pointer cursor, not reachable by\nkeyboard tabbing, and clicking it does not emit `bsSelect`.",
+              "description": "Disables the switch: sets the native `disabled` attribute, suppresses hover/focus styling,\nand prevents toggling.",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
               "fieldName": "disabled"
+            },
+            {
+              "name": "size",
+              "description": "Sizing scale. Controls the track's width/height and the knob's diameter.",
+              "type": {
+                "text": "\"lg\" | \"md\"",
+                "references": [
+                  {
+                    "name": "BsSwitchSize"
+                  }
+                ]
+              },
+              "default": "'lg'",
+              "fieldName": "size"
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "description": "Accessible name for the switch. Required whenever the default (label) slot is empty (e.g. a\nbare \"enabled\" switch in a table row) -- without it, the internal native `<input>` has no\naccessible name at all. Setting `aria-label` directly on the `<bs-switch>` host does NOT\nwork for this: that attribute stays on the light-DOM host and is never forwarded into the\nshadow DOM by the browser, so the actual focusable element (the native `<input>` inside) stays\nnameless. This prop exists specifically to bridge that gap -- same pattern as `bs-button`'s and\n`bs-checkbox`'s identical `ariaLabel` prop, both of which explicitly bind it onto their own\ninternal focusable element for the same reason.",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "readonly": true,
+              "attribute": "aria-label"
+            },
+            {
+              "kind": "field",
+              "name": "checked",
+              "description": "Whether the switch is on. Mutable so clicking the label/input toggles it directly, and\nreflected so consumers can target `bs-switch[checked]` via CSS.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "checked",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "disabled",
-              "description": "Disables the item: no hover/pressed/focus styling, no pointer cursor, not reachable by\nkeyboard tabbing, and clicking it does not emit `bsSelect`.",
+              "description": "Disables the switch: sets the native `disabled` attribute, suppresses hover/focus styling,\nand prevents toggling.",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
               "readonly": true,
               "attribute": "disabled"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "description": "Sizing scale. Controls the track's width/height and the knob's diameter.",
+              "type": {
+                "text": "\"lg\" | \"md\"",
+                "references": [
+                  {
+                    "name": "BsSwitchSize"
+                  }
+                ]
+              },
+              "default": "'lg'",
+              "readonly": true,
+              "attribute": "size"
             }
           ],
           "events": [
             {
-              "name": "bsSelect",
-              "description": "Fires when the item is clicked.",
+              "name": "bsChange",
+              "description": "Emitted when the checked state changes via user interaction, with the new `checked` value.",
               "type": {
-                "text": "CustomEvent<void>"
+                "text": "CustomEvent<boolean>"
               }
             }
           ],
           "slots": [
             {
               "name": "",
-              "description": "Default slot: the item's text label."
+              "description": "Default slot: the label text."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "knob",
+              "description": "The sliding circular knob."
             },
             {
-              "name": "icon",
-              "description": "Optional leading icon (24x24). When left empty, no icon space is reserved."
+              "name": "label",
+              "description": "The label text wrapper."
+            },
+            {
+              "name": "track",
+              "description": "The visual pill-shaped track."
             }
           ],
-          "cssParts": [
+          "cssProperties": [
             {
-              "name": "icon",
-              "description": "The icon wrapper."
+              "name": "--bs-switch-border-width",
+              "description": "Track border width, constant across all sizes."
             },
             {
-              "name": "item",
-              "description": "The button element."
+              "name": "--bs-switch-focus-ring-color",
+              "description": "Outer focus ring color, drawn outside the track. Aliased to --bs-switch-track-border-focus."
+            },
+            {
+              "name": "--bs-switch-gap",
+              "description": "Gap between the track and the label text. Aliased to --bs-spacing-100."
+            },
+            {
+              "name": "--bs-switch-knob-bg",
+              "description": "Knob background, resting. Aliased to --bs-switch-thumb-bg-default."
+            },
+            {
+              "name": "--bs-switch-knob-bg-checked",
+              "description": "Knob background, checked. Aliased to --bs-switch-thumb-bg-checked."
+            },
+            {
+              "name": "--bs-switch-knob-bg-disabled",
+              "description": "Knob background, disabled. Aliased to --bs-switch-thumb-bg-disabled."
+            },
+            {
+              "name": "--bs-switch-knob-bg-hover",
+              "description": "Knob background, hovered. Aliased to --bs-switch-thumb-bg-hover."
+            },
+            {
+              "name": "--bs-switch-knob-size-lg",
+              "description": "Knob width/height at size=\"lg\"."
+            },
+            {
+              "name": "--bs-switch-knob-size-md",
+              "description": "Knob width/height at size=\"md\"."
+            },
+            {
+              "name": "--bs-switch-label-color",
+              "description": "Label text color. Aliased to --bs-text-default."
+            },
+            {
+              "name": "--bs-switch-label-color-disabled",
+              "description": "Label text color, disabled. Aliased to --bs-text-on-disabled."
+            },
+            {
+              "name": "--bs-switch-padding",
+              "description": "Internal padding of the track around the knob, constant across all sizes. Aliased to --bs-spacing-25."
+            },
+            {
+              "name": "--bs-switch-radius",
+              "description": "Corner radius of the track, constant across all sizes. Aliased to --bs-border-radius-full."
+            },
+            {
+              "name": "--bs-switch-track-bg",
+              "description": "Track background, unchecked/resting. Aliased to --bs-switch-track-bg-default."
+            },
+            {
+              "name": "--bs-switch-track-bg-checked",
+              "description": "Track background, checked/resting. Aliased to --bs-switch-track-bg-checked-default."
+            },
+            {
+              "name": "--bs-switch-track-bg-checked-focus",
+              "description": "Track background, checked/focused. Aliased to --bs-switch-track-bg-checked-focused."
+            },
+            {
+              "name": "--bs-switch-track-bg-checked-hover",
+              "description": "Track background, checked/hovered. The global vendored token directly, same reasoning as --bs-switch-track-bg-hover above."
+            },
+            {
+              "name": "--bs-switch-track-bg-disabled",
+              "description": "Track background, disabled (either checked state). The global vendored token directly, same reasoning as --bs-switch-track-bg-hover above."
+            },
+            {
+              "name": "--bs-switch-track-bg-hover",
+              "description": "Track background, unchecked/hovered. This is the global vendored token directly (src/global/tokens.css) -- not locally re-aliased under a different name here, since it already carries this exact name; see the :host comment below for why."
+            },
+            {
+              "name": "--bs-switch-track-border",
+              "description": "Track border color, resting/disabled. Aliased to --bs-switch-track-border-default."
+            },
+            {
+              "name": "--bs-switch-track-border-hover",
+              "description": "Track border color, hovered or focused. The global vendored token directly, same reasoning as --bs-switch-track-bg-hover above."
+            },
+            {
+              "name": "--bs-switch-track-height-lg",
+              "description": "Track height at size=\"lg\"."
+            },
+            {
+              "name": "--bs-switch-track-height-md",
+              "description": "Track height at size=\"md\"."
+            },
+            {
+              "name": "--bs-switch-track-width-lg",
+              "description": "Track width at size=\"lg\"."
             },
             {
-              "name": "label",
-              "description": "The label wrapper."
+              "name": "--bs-switch-track-width-md",
+              "description": "Track width at size=\"md\"."
             }
           ]
         }
@@ -2854,101 +5853,129 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BsMenuItem",
+          "name": "BsSwitch",
           "declaration": {
-            "name": "BsMenuItem"
+            "name": "BsSwitch"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bs-menu-item",
+          "name": "bs-switch",
           "declaration": {
-            "name": "BsMenuItem"
+            "name": "BsSwitch"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/bs-modal/bs-modal.tsx",
+      "path": "src/components/bs-tab/bs-tab/bs-tab.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bs-modal",
-          "name": "BsModal",
-          "description": "An overlay dialog that interrupts the current flow for a focused task or confirmation.\nCloses itself on backdrop click, Escape, or its own close button, and emits `bsClose`.\n\n## When to use\n- Confirming a consequential action (e.g. \"Confirm booking\") before it takes effect.\n- A short, focused task that doesn't warrant navigating to a new page.\n\n## When not to use\n- For non-blocking status messages — use a toast/notification instead of interrupting the user.\n- For a long, multi-step flow — a full page or a dedicated route is usually a better fit than a\n  modal that just gets taller and taller.",
+          "tagName": "bs-tab",
+          "name": "BsTab",
+          "description": "A single tab button -- an optional icon plus a text label, rendered as a real `<button>` so it\nparticipates correctly in tab order and native click/keyboard activation.\n\n## When to use\n- As one button within a tab bar, where exactly one tab is selected/active at a time.\n\n## When not to use\n- As a standalone action button -- use `bs-button` instead, `bs-tab`'s visual language (muted\n  until selected/hovered, underline indicator) only makes sense as part of a set.\n\n`selected` is NOT self-toggling -- clicking a `bs-tab` only emits `bsSelect`, it does not set its\nown `selected` prop, and it does not unselect any sibling tabs. Wrap your `<bs-tab>` elements in\n`<bs-tabs type=\"bs-tab\">` -- it owns `role=\"tablist\"` and coordinates selection (listening for\n`bsSelect` and setting `selected`/`false` across siblings) for you. Using `bs-tab` standalone,\noutside a `<bs-tabs>` wrapper, still means `selected` doesn't self-toggle and `role=\"tablist\"`\nisn't provided automatically -- a consumer doing that would still need to coordinate `selected`\nand supply `role=\"tablist\"` manually, same as `bs-radio.mdx` documents for `bs-radio`'s missing\n`bs-radio-group`. See `bs-tab.mdx`'s Accessibility section for the full requirement, including\n`role=\"tabpanel\"` on the corresponding content panels.",
           "attributes": [
             {
-              "name": "heading",
+              "name": "aria-label",
+              "description": "Accessible name for the tab. Required for icon-only usage (no visible label text via the\ndefault slot) so screen readers still announce what the tab does -- without it, an icon-only\ntab has no discernible name at all (axe-core flags this as a critical `button-name`\nviolation). Stencil reflects this camelCase prop to the `aria-label` HTML attribute\nautomatically, same as `bs-button`'s identical prop.",
               "type": {
                 "text": "string"
               },
-              "fieldName": "heading"
+              "default": "null",
+              "fieldName": "ariaLabel"
             },
             {
-              "name": "open",
-              "description": "Mutable + reflected so the component can close itself (backdrop click, Escape, close button)\nthe same way a native `<dialog>` does, while still emitting `bsClose` for the consumer to react to.",
+              "name": "disabled",
+              "description": "Disables the tab: sets the native `disabled` attribute, suppresses hover/focus styling, and\nprevents clicking from emitting `bsSelect`.",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "open"
+              "fieldName": "disabled"
             },
             {
-              "name": "size",
+              "name": "icon-position",
+              "description": "Where the icon sits relative to the label, when both `icon` and the default slot are\npopulated. Ignored for icon-only/text-only layouts.",
               "type": {
-                "text": "\"lg\" | \"md\" | \"sm\"",
+                "text": "\"start\" | \"top\"",
                 "references": [
                   {
-                    "name": "BsModalSize"
+                    "name": "BsTabIconPosition"
                   }
                 ]
               },
-              "default": "'md'",
-              "fieldName": "size"
+              "default": "'start'",
+              "fieldName": "iconPosition"
+            },
+            {
+              "name": "selected",
+              "description": "Whether this tab is the currently active one. NOT mutable and NOT self-toggling -- see the\n\"Known gap\" note in the class JSDoc. Still reflected as an attribute so consumers/CSS can\ntarget `bs-tab[selected]`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "selected"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "heading",
+              "name": "ariaLabel",
+              "description": "Accessible name for the tab. Required for icon-only usage (no visible label text via the\ndefault slot) so screen readers still announce what the tab does -- without it, an icon-only\ntab has no discernible name at all (axe-core flags this as a critical `button-name`\nviolation). Stencil reflects this camelCase prop to the `aria-label` HTML attribute\nautomatically, same as `bs-button`'s identical prop.",
               "type": {
                 "text": "string"
               },
+              "default": "null",
               "readonly": true,
-              "attribute": "heading"
+              "attribute": "aria-label"
             },
             {
               "kind": "field",
-              "name": "open",
-              "description": "Mutable + reflected so the component can close itself (backdrop click, Escape, close button)\nthe same way a native `<dialog>` does, while still emitting `bsClose` for the consumer to react to.",
+              "name": "disabled",
+              "description": "Disables the tab: sets the native `disabled` attribute, suppresses hover/focus styling, and\nprevents clicking from emitting `bsSelect`.",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "attribute": "open",
-              "reflects": true
+              "readonly": true,
+              "attribute": "disabled"
             },
             {
               "kind": "field",
-              "name": "size",
+              "name": "iconPosition",
+              "description": "Where the icon sits relative to the label, when both `icon` and the default slot are\npopulated. Ignored for icon-only/text-only layouts.",
               "type": {
-                "text": "\"lg\" | \"md\" | \"sm\"",
+                "text": "\"start\" | \"top\"",
                 "references": [
                   {
-                    "name": "BsModalSize"
+                    "name": "BsTabIconPosition"
                   }
                 ]
               },
-              "default": "'md'",
+              "default": "'start'",
               "readonly": true,
-              "attribute": "size"
+              "attribute": "icon-position"
+            },
+            {
+              "kind": "field",
+              "name": "selected",
+              "description": "Whether this tab is the currently active one. NOT mutable and NOT self-toggling -- see the\n\"Known gap\" note in the class JSDoc. Still reflected as an attribute so consumers/CSS can\ntarget `bs-tab[selected]`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "selected",
+              "reflects": true
             }
           ],
           "events": [
             {
-              "name": "bsClose",
+              "name": "bsSelect",
+              "description": "Fires when the tab is clicked. Does not toggle `selected` itself -- see the class JSDoc.",
               "type": {
                 "text": "CustomEvent<void>"
               }
@@ -2957,37 +5984,123 @@
           "slots": [
             {
               "name": "",
-              "description": "Default slot: the dialog body content."
+              "description": "Default slot: the tab's label text. When empty (icon-only), no space is reserved for it."
             },
             {
-              "name": "footer",
-              "description": "Optional footer content (typically action buttons)."
+              "name": "badge",
+              "description": "Optional trailing badge, rendered after the label (e.g. an unread count). Typically\na `bs-badge` element -- consumer's responsibility to style/populate, this component just reserves\na slot for it. Only rendered for text-only and icon+text-horizontal layouts, per the design spec\n(not icon-only or icon+text-vertical)."
+            },
+            {
+              "name": "icon",
+              "description": "Optional icon (24x24). When empty (text-only), no space is reserved for it."
             }
           ],
           "cssParts": [
             {
-              "name": "backdrop",
-              "description": "The full-viewport overlay behind the dialog."
+              "name": "badge",
+              "description": "The badge wrapper."
             },
             {
-              "name": "body",
-              "description": "The body content wrapper."
+              "name": "icon",
+              "description": "The icon wrapper."
             },
             {
-              "name": "close",
-              "description": "The close button."
+              "name": "indicator",
+              "description": "The selection/hover underline indicator."
             },
             {
-              "name": "dialog",
-              "description": "The dialog box itself."
+              "name": "label",
+              "description": "The label wrapper."
             },
             {
-              "name": "footer",
-              "description": "The footer wrapper (only visible when the footer slot has content)."
+              "name": "tab",
+              "description": "The button element."
+            }
+          ],
+          "cssProperties": [
+            {
+              "name": "--bs-tab-color-default",
+              "description": "Text/icon color, deselected/enabled. Aliased to --bs-text-muted."
             },
             {
-              "name": "header",
-              "description": "The header row (heading + close button)."
+              "name": "--bs-tab-color-disabled",
+              "description": "Text/icon color, disabled. Aliased to --bs-text-on-disabled."
+            },
+            {
+              "name": "--bs-tab-color-hover",
+              "description": "Text/icon color, deselected/hovered, focused or pressed. Aliased to --bs-text-default."
+            },
+            {
+              "name": "--bs-tab-color-selected",
+              "description": "Text/icon color, selected. Aliased to --bs-color-primary-default."
+            },
+            {
+              "name": "--bs-tab-color-selected-hover",
+              "description": "Text/icon color, selected/hovered or focused. Aliased to --bs-color-primary-hover."
+            },
+            {
+              "name": "--bs-tab-color-selected-pressed",
+              "description": "Text/icon color, selected/pressed. Aliased to --bs-color-primary-pressed."
+            },
+            {
+              "name": "--bs-tab-focus-ring-color",
+              "description": "Focus ring color. Aliased to --bs-border-neutral-focus."
+            },
+            {
+              "name": "--bs-tab-font-size",
+              "description": "Aliased to --bs-font-size-md."
+            },
+            {
+              "name": "--bs-tab-gap",
+              "description": "Gap between icon and label, icon+text horizontal layout. Aliased to --bs-spacing-75."
+            },
+            {
+              "name": "--bs-tab-gap-vertical",
+              "description": "Gap between icon and label, icon+text vertical layout. Aliased to --bs-spacing-50."
+            },
+            {
+              "name": "--bs-tab-icon-color-default",
+              "description": "Icon color, deselected/enabled. Aliased to --bs-icon-muted."
+            },
+            {
+              "name": "--bs-tab-icon-color-disabled",
+              "description": "Icon color, disabled. Aliased to --bs-icon-disabled."
+            },
+            {
+              "name": "--bs-tab-icon-color-hover",
+              "description": "Icon color, deselected/hovered, focused or pressed. Aliased to --bs-icon-default."
+            },
+            {
+              "name": "--bs-tab-indicator-hover",
+              "description": "Underline color, deselected/hovered, focused or pressed. Aliased to --bs-border-neutral-hover."
+            },
+            {
+              "name": "--bs-tab-indicator-selected",
+              "description": "Underline color, selected. Aliased to --bs-color-primary-default."
+            },
+            {
+              "name": "--bs-tab-indicator-selected-hover",
+              "description": "Underline color, selected/hovered or focused. Aliased to --bs-color-primary-hover."
+            },
+            {
+              "name": "--bs-tab-indicator-selected-pressed",
+              "description": "Underline color, selected/pressed. Aliased to --bs-color-primary-pressed."
+            },
+            {
+              "name": "--bs-tab-line-height",
+              "description": "Aliased to --bs-line-height-body-md."
+            },
+            {
+              "name": "--bs-tab-padding-x",
+              "description": "Left/right padding. Aliased to --bs-spacing-200."
+            },
+            {
+              "name": "--bs-tab-padding-y",
+              "description": "Top/bottom padding. Aliased to --bs-spacing-150."
+            },
+            {
+              "name": "--bs-tab-radius",
+              "description": "Corner radius of the tab button. Aliased to --bs-border-radius-100."
             }
           ]
         }
@@ -2995,163 +6108,126 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BsModal",
+          "name": "BsTab",
           "declaration": {
-            "name": "BsModal"
+            "name": "BsTab"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bs-modal",
+          "name": "bs-tab",
           "declaration": {
-            "name": "BsModal"
+            "name": "BsTab"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/bs-source-link/bs-source-link.tsx",
+      "path": "src/components/bs-tab/bs-tabs/bs-tabs.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bs-source-link",
-          "name": "BsSourceLink",
-          "description": "A single citation row inside `bs-chatbot-sources-drawer` -- a file icon + filename on the first\nline, the originating system and version on the second, and a trailing \"open\" arrow.\n\n## When to use\n- One row per source Genie cited in a response, slotted into `bs-chatbot-sources-drawer`.\n\n## When not to use\n- Outside the sources drawer context -- this is a purpose-built citation row, not a generic\n  link/list-item component.",
+          "tagName": "bs-tabs",
+          "name": "BsTabs",
+          "description": "A tab-group wrapper: owns `role=\"tablist\"` and coordinates selection across its slotted\n`<bs-tab>` or `<bs-inline-tab>` children, so consumers no longer have to hand-roll this.\n\n`bs-tab.mdx`/`bs-inline-tab.mdx` previously documented this coordination -- listening for\n`bsSelect` and setting `selected`/`false` on siblings, plus supplying `role=\"tablist\"` on\nwhatever element groups the tabs -- as a \"Known gap\"/manual consumer responsibility. This\ncomponent is that wrapper: it renders the `role=\"tablist\"` element and listens for `bsSelect`\nitself. Using `<bs-tab>`/`<bs-inline-tab>` standalone, outside a `<bs-tabs>` wrapper, still means\n`selected` doesn't self-toggle -- a consumer doing that would still need to coordinate `selected`\nmanually -- but that's no longer the first recommended path.\n\n## When to use\n- Wrapping a set of `<bs-tab>` (underline style) or `<bs-inline-tab>` (pill style) elements that\n  should behave as a single-selection tab bar.\n\n## When not to use\n- For a single, standalone tab button not participating in a group -- use `bs-tab`/`bs-inline-tab`\n  directly.",
           "attributes": [
             {
-              "name": "file-name",
-              "description": "The cited document's filename.",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Source'",
-              "fieldName": "fileName"
-            },
-            {
-              "name": "href",
-              "description": "If set, renders the row as a link that opens this URL; otherwise as a button that only emits `bsOpen`.",
-              "type": {
-                "text": "string"
-              },
-              "fieldName": "href"
-            },
-            {
-              "name": "source-name",
-              "description": "The system/app the document came from (e.g. \"HoltePortalen\").",
-              "type": {
-                "text": "string"
-              },
-              "fieldName": "sourceName"
-            },
-            {
-              "name": "target",
-              "description": "`target` used when `href` is set.",
+              "name": "orientation",
+              "description": "Layout direction of the tab bar itself. Sets `aria-orientation` on the internal wrapper and\nswitches `flex-direction`.",
               "type": {
-                "text": "string"
+                "text": "\"horizontal\" | \"vertical\"",
+                "references": [
+                  {
+                    "name": "BsTabsOrientation"
+                  }
+                ]
               },
-              "default": "'_blank'",
-              "fieldName": "target"
+              "default": "'horizontal'",
+              "fieldName": "orientation"
             },
             {
-              "name": "version",
-              "description": "The document's version label (e.g. \"v3.2\"). Omit if the source has no version.",
+              "name": "type",
+              "description": "Which tab-button family this group wraps. Governs the wrapper's own visual treatment (gap-only\nfor `bs-tab`, a filled pill bar for `bs-inline-tab`). Not reflected as an attribute -- nothing\nexternal needs to target it via CSS attribute selector, it only drives internal class names.",
               "type": {
-                "text": "string"
+                "text": "\"bs-inline-tab\" | \"bs-tab\"",
+                "references": [
+                  {
+                    "name": "BsTabsType"
+                  }
+                ]
               },
-              "fieldName": "version"
+              "default": "'bs-tab'",
+              "fieldName": "type"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "fileName",
-              "description": "The cited document's filename.",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Source'",
-              "readonly": true,
-              "attribute": "file-name"
-            },
-            {
-              "kind": "field",
-              "name": "href",
-              "description": "If set, renders the row as a link that opens this URL; otherwise as a button that only emits `bsOpen`.",
-              "type": {
-                "text": "string"
-              },
-              "readonly": true,
-              "attribute": "href"
-            },
-            {
-              "kind": "field",
-              "name": "sourceName",
-              "description": "The system/app the document came from (e.g. \"HoltePortalen\").",
-              "type": {
-                "text": "string"
-              },
-              "readonly": true,
-              "attribute": "source-name"
-            },
-            {
-              "kind": "field",
-              "name": "target",
-              "description": "`target` used when `href` is set.",
+              "name": "orientation",
+              "description": "Layout direction of the tab bar itself. Sets `aria-orientation` on the internal wrapper and\nswitches `flex-direction`.",
               "type": {
-                "text": "string"
+                "text": "\"horizontal\" | \"vertical\"",
+                "references": [
+                  {
+                    "name": "BsTabsOrientation"
+                  }
+                ]
               },
-              "default": "'_blank'",
+              "default": "'horizontal'",
               "readonly": true,
-              "attribute": "target"
+              "attribute": "orientation"
             },
             {
               "kind": "field",
-              "name": "version",
-              "description": "The document's version label (e.g. \"v3.2\"). Omit if the source has no version.",
+              "name": "type",
+              "description": "Which tab-button family this group wraps. Governs the wrapper's own visual treatment (gap-only\nfor `bs-tab`, a filled pill bar for `bs-inline-tab`). Not reflected as an attribute -- nothing\nexternal needs to target it via CSS attribute selector, it only drives internal class names.",
               "type": {
-                "text": "string"
+                "text": "\"bs-inline-tab\" | \"bs-tab\"",
+                "references": [
+                  {
+                    "name": "BsTabsType"
+                  }
+                ]
               },
+              "default": "'bs-tab'",
               "readonly": true,
-              "attribute": "version"
+              "attribute": "type"
             }
           ],
-          "events": [
+          "slots": [
             {
-              "name": "bsOpen",
-              "description": "Fires on click/activation, whether or not `href` is set -- lets the consuming app log or handle the open.",
-              "type": {
-                "text": "CustomEvent<void>"
-              }
+              "name": "",
+              "description": "Default slot: the tab elements (`<bs-tab>` or `<bs-inline-tab>`, matching `type`) that\nmake up this group."
             }
           ],
-          "slots": [
+          "cssParts": [
             {
-              "name": "icon",
-              "description": "Overrides the default file icon."
+              "name": "tablist",
+              "description": "The wrapping element carrying `role=\"tablist\"`."
             }
           ],
-          "cssParts": [
+          "cssProperties": [
             {
-              "name": "arrow",
-              "description": "The trailing \"open\" arrow icon."
+              "name": "--bs-tabs-inline-tab-bg",
+              "description": "Bar background when type=\"bs-inline-tab\". Aliased to --bs-color-neutral-container."
             },
             {
-              "name": "filename",
-              "description": "The filename text."
+              "name": "--bs-tabs-inline-tab-gap",
+              "description": "Gap between tabs when type=\"bs-inline-tab\". Aliased to --bs-spacing-50."
             },
             {
-              "name": "icon",
-              "description": "The leading file-type icon."
+              "name": "--bs-tabs-inline-tab-padding-x",
+              "description": "Bar horizontal padding when type=\"bs-inline-tab\". Aliased to --bs-spacing-50."
             },
             {
-              "name": "source",
-              "description": "The source system name."
+              "name": "--bs-tabs-inline-tab-radius",
+              "description": "Bar corner radius when type=\"bs-inline-tab\". Aliased to --bs-border-radius-full."
             },
             {
-              "name": "version",
-              "description": "The version label."
+              "name": "--bs-tabs-tab-gap",
+              "description": "Gap between tabs when type=\"bs-tab\". Aliased to --bs-spacing-100."
             }
           ]
         }
@@ -3159,16 +6235,16 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BsSourceLink",
+          "name": "BsTabs",
           "declaration": {
-            "name": "BsSourceLink"
+            "name": "BsTabs"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bs-source-link",
+          "name": "bs-tabs",
           "declaration": {
-            "name": "BsSourceLink"
+            "name": "BsTabs"
           }
         }
       ]