@brandsync/wc 0.0.8 → 0.0.9

package/custom-elements.json

@@ -3,46 +3,105 @@
   "modules": [
     {
       "kind": "javascript-module",
-      "path": "src/components/bs-ai-thinking/bs-ai-thinking.tsx",
+      "path": "src/components/bs-ai-disclaimer/bs-ai-disclaimer.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bs-ai-thinking",
-          "name": "BsAiThinking",
-          "description": "A small inline status indicator for Genie AI surfaces: the colorful Genie mark next to a label\n(e.g. \"Retrieving\", \"Thinking\", \"Searching\") whose text shimmers with a moving highlight band\nwhile an operation is in progress.\n\n## When to use\n- Inline in a Genie AI chat transcript to show what the assistant is currently doing while a\n  response is being generated (retrieving context, searching, thinking).\n\n## When not to use\n- A blocking/full-panel loading state -- this is a small inline indicator, not a spinner overlay.",
+          "tagName": "bs-ai-disclaimer",
+          "name": "BsAiDisclaimer",
+          "description": "A centered caption disclaimer for Genie AI surfaces, e.g. \"AI can make mistakes. Please verify\nimportant information.\"\n\n## When to use\n- Below or above `bs-composer` in a Genie AI chat panel, to remind users AI output can be wrong.\n\n## When not to use\n- A general-purpose caption/helper text — use plain text or `bs-input`'s description slot for\n  non-AI-related helper copy.\n\nThe default slot (rather than a fixed prop) is intentional: Figma only specifies plain text, but\nsome consuming apps link out to a policy/help page from this copy, and a slot supports that\nwithout inventing an unconfirmed `href`/link prop.",
+          "slots": [
+            {
+              "name": "",
+              "description": "The disclaimer text/content, centered. Defaults to no content -- the consumer supplies\nthe copy, e.g. \"AI can make mistakes. Please verify important information.\""
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "text",
+              "description": "The disclaimer text container."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsAiDisclaimer",
+          "declaration": {
+            "name": "BsAiDisclaimer"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-ai-disclaimer",
+          "declaration": {
+            "name": "BsAiDisclaimer"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-ai-greeting/bs-ai-greeting.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-ai-greeting",
+          "name": "BsAiGreeting",
+          "description": "The centered welcome heading shown at the top of an empty Genie AI chat panel, e.g.\n\"Hi. I'm Genie, your AI assistant.\" + \"How can I help you with [product] today?\"\n\n## When to use\n- The empty/initial state of a Genie AI chat panel, before the user has sent a message.\n\n## When not to use\n- Once a conversation has started -- this is a one-time empty-state greeting, not a persistent\n  header (see `bs-chatbot-header` for that).\n\n`productName` is optional: Figma's copy has a `[product_name]` placeholder the consuming app is\nexpected to fill in, but a component shouldn't force a product name to exist, so leaving it\nunset falls back to a product-agnostic \"How can I help you today?\".",
           "attributes": [
             {
-              "name": "label",
-              "description": "The status text shown next to the icon, e.g. \"Retrieving\", \"Thinking\", \"Searching\".",
+              "name": "assistant-name",
+              "description": "The assistant's name, used in the heading (\"Hi. I'm {assistantName},\").",
               "type": {
                 "text": "string"
               },
-              "default": "'Thinking'",
-              "fieldName": "label"
+              "default": "'Genie'",
+              "fieldName": "assistantName"
+            },
+            {
+              "name": "product-name",
+              "description": "The product name mentioned in the subtext. Omit to use a product-agnostic subtext.",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "productName"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "label",
-              "description": "The status text shown next to the icon, e.g. \"Retrieving\", \"Thinking\", \"Searching\".",
+              "name": "assistantName",
+              "description": "The assistant's name, used in the heading (\"Hi. I'm {assistantName},\").",
               "type": {
                 "text": "string"
               },
-              "default": "'Thinking'",
+              "default": "'Genie'",
               "readonly": true,
-              "attribute": "label"
+              "attribute": "assistant-name"
+            },
+            {
+              "kind": "field",
+              "name": "productName",
+              "description": "The product name mentioned in the subtext. Omit to use a product-agnostic subtext.",
+              "type": {
+                "text": "string"
+              },
+              "readonly": true,
+              "attribute": "product-name"
             }
           ],
           "cssParts": [
             {
-              "name": "icon",
-              "description": "The Genie mark icon."
+              "name": "heading",
+              "description": "The bold \"Hi. I'm {assistantName}, your AI assistant.\" heading."
             },
             {
-              "name": "label",
-              "description": "The status label text."
+              "name": "subtext",
+              "description": "The \"How can I help you...\" subtext."
             }
           ]
         }
@@ -50,74 +109,62 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BsAiThinking",
+          "name": "BsAiGreeting",
           "declaration": {
-            "name": "BsAiThinking"
+            "name": "BsAiGreeting"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bs-ai-thinking",
+          "name": "bs-ai-greeting",
           "declaration": {
-            "name": "BsAiThinking"
+            "name": "BsAiGreeting"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/bs-badge/bs-badge.tsx",
+      "path": "src/components/bs-ai-thinking/bs-ai-thinking.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bs-badge",
-          "name": "BsBadge",
-          "description": "A small status or category pill, usually paired with a label or list item.\n\n## When to use\n- Communicating a short, fixed status (e.g. \"Active\", \"On leave\") or category label.\n\n## When not to use\n- As an interactive/clickable element — a badge is a label, not a control. Use a button\n  or chip component if it needs to be clickable.\n- For long text — badges are sized for one or two words.",
+          "tagName": "bs-ai-thinking",
+          "name": "BsAiThinking",
+          "description": "A small inline status indicator for Genie AI surfaces: the colorful Genie mark next to a label\n(e.g. \"Retrieving\", \"Thinking\", \"Searching\") whose text shimmers with a moving highlight band\nwhile an operation is in progress.\n\n## When to use\n- Inline in a Genie AI chat transcript to show what the assistant is currently doing while a\n  response is being generated (retrieving context, searching, thinking).\n\n## When not to use\n- A blocking/full-panel loading state -- this is a small inline indicator, not a spinner overlay.",
           "attributes": [
             {
-              "name": "variant",
-              "description": "Maps directly to the brandsync-tokens `--bs-badge-bg-*` / `--bs-badge-text-*` sets.",
+              "name": "label",
+              "description": "The status text shown next to the icon, e.g. \"Retrieving\", \"Thinking\", \"Searching\".",
               "type": {
-                "text": "\"default\" | \"error\" | \"info\" | \"inverse\" | \"neutral\" | \"primary\" | \"success\" | \"warning\"",
-                "references": [
-                  {
-                    "name": "BsBadgeVariant"
-                  }
-                ]
+                "text": "string"
               },
-              "default": "'default'",
-              "fieldName": "variant"
+              "default": "'Thinking'",
+              "fieldName": "label"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "variant",
-              "description": "Maps directly to the brandsync-tokens `--bs-badge-bg-*` / `--bs-badge-text-*` sets.",
+              "name": "label",
+              "description": "The status text shown next to the icon, e.g. \"Retrieving\", \"Thinking\", \"Searching\".",
               "type": {
-                "text": "\"default\" | \"error\" | \"info\" | \"inverse\" | \"neutral\" | \"primary\" | \"success\" | \"warning\"",
-                "references": [
-                  {
-                    "name": "BsBadgeVariant"
-                  }
-                ]
+                "text": "string"
               },
-              "default": "'default'",
+              "default": "'Thinking'",
               "readonly": true,
-              "attribute": "variant"
-            }
-          ],
-          "slots": [
-            {
-              "name": "",
-              "description": "Default slot: the badge's label text."
+              "attribute": "label"
             }
           ],
           "cssParts": [
             {
-              "name": "container",
-              "description": "The pill element."
+              "name": "icon",
+              "description": "The Genie mark icon."
+            },
+            {
+              "name": "label",
+              "description": "The status label text."
             }
           ]
         }
@@ -125,180 +172,191 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BsBadge",
+          "name": "BsAiThinking",
           "declaration": {
-            "name": "BsBadge"
+            "name": "BsAiThinking"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bs-badge",
+          "name": "bs-ai-thinking",
           "declaration": {
-            "name": "BsBadge"
+            "name": "BsAiThinking"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/bs-button/bs-button.tsx",
+      "path": "src/components/bs-attachment/bs-attachment.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bs-button",
-          "name": "BsButton",
-          "description": "A clickable action element for the single most important action in a given context.\n\n## When to use\n- The primary call to action on a screen or within a card/modal (e.g. \"Book room\", \"Confirm\").\n- Secondary, lower-emphasis actions alongside it (use `variant=\"neutral\"`).\n- `variant=\"error\"` for destructive/irreversible actions (e.g. \"Delete account\") — per\n  BrandSync guidance, destructive actions should always use the error variant, never\n  `neutral`, so the visual weight matches the risk of the action.\n\n## When not to use\n- For navigation between pages — use a link/nav component instead, a button implies an\n  in-page action, not a destination change.\n- For more than one primary-emphasis action in the same view — pick one, demote the rest to\n  `neutral`.\n- `error` purely for visual emphasis — it signals a destructive action to the user, so reserve\n  it for actions that actually delete/revoke/undo something.",
+          "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.",
           "attributes": [
             {
-              "name": "aria-label",
-              "description": "Accessible name for the button. Required for icon-only usage (no visible label text via the\ndefault slot) so screen readers still announce what the button does. Stencil reflects this\ncamelCase prop to the `aria-label` HTML attribute automatically.",
+              "name": "file-name",
+              "description": "The filename shown on the card. Only used when `type` is \"pdf\" or \"document\".",
               "type": {
                 "text": "string"
               },
-              "default": "null",
-              "fieldName": "ariaLabel"
+              "default": "'Attachment'",
+              "fieldName": "fileName"
             },
             {
-              "name": "disabled",
-              "description": "Disables the button and applies the disabled token set.",
+              "name": "image-alt",
+              "description": "Accessible alt text for the image thumbnail. Only used when `type` is \"image\".",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "fieldName": "disabled"
+              "default": "''",
+              "fieldName": "imageAlt"
             },
             {
-              "name": "size",
-              "description": "Sizing scale.",
+              "name": "image-src",
+              "description": "The thumbnail image URL. Only used when `type` is \"image\".",
               "type": {
-                "text": "\"lg\" | \"md\" | \"sm\"",
-                "references": [
-                  {
-                    "name": "BsButtonSize"
-                  }
-                ]
+                "text": "string"
               },
-              "default": "'md'",
-              "fieldName": "size"
+              "fieldName": "imageSrc"
             },
             {
-              "name": "type",
-              "description": "Native `<button>` type.",
+              "name": "loading",
+              "description": "Shows an upload-in-progress spinner (blurred + overlaid for images, in the badge for files).",
               "type": {
-                "text": "\"button\" | \"reset\" | \"submit\""
+                "text": "boolean"
               },
-              "default": "'button'",
-              "fieldName": "type"
+              "default": "false",
+              "fieldName": "loading"
             },
             {
-              "name": "variant",
-              "description": "Visual style. Maps directly to the brandsync-tokens `--bs-button-*` semantic set.\n`error` is for destructive/irreversible actions per BrandSync guidance, not a stronger\nemphasis alternative to `primary`.",
+              "name": "removable",
+              "description": "Whether the hover/focus-revealed remove button is rendered at all.",
               "type": {
-                "text": "\"error\" | \"info\" | \"neutral\" | \"outlined\" | \"primary\" | \"subtle\" | \"success\" | \"warning\"",
+                "text": "boolean"
+              },
+              "default": "true",
+              "fieldName": "removable"
+            },
+            {
+              "name": "type",
+              "description": "Which kind of attachment preview to render.",
+              "type": {
+                "text": "\"document\" | \"image\" | \"pdf\"",
                 "references": [
                   {
-                    "name": "BsButtonVariant"
+                    "name": "BsAttachmentType"
                   }
                 ]
               },
-              "default": "'primary'",
-              "fieldName": "variant"
+              "default": "'image'",
+              "fieldName": "type"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "ariaLabel",
-              "description": "Accessible name for the button. Required for icon-only usage (no visible label text via the\ndefault slot) so screen readers still announce what the button does. Stencil reflects this\ncamelCase prop to the `aria-label` HTML attribute automatically.",
+              "name": "fileName",
+              "description": "The filename shown on the card. Only used when `type` is \"pdf\" or \"document\".",
               "type": {
                 "text": "string"
               },
-              "default": "null",
+              "default": "'Attachment'",
               "readonly": true,
-              "attribute": "aria-label"
+              "attribute": "file-name"
             },
             {
               "kind": "field",
-              "name": "disabled",
-              "description": "Disables the button and applies the disabled token set.",
+              "name": "imageAlt",
+              "description": "Accessible alt text for the image thumbnail. Only used when `type` is \"image\".",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
+              "default": "''",
               "readonly": true,
-              "attribute": "disabled"
+              "attribute": "image-alt"
             },
             {
               "kind": "field",
-              "name": "size",
-              "description": "Sizing scale.",
+              "name": "imageSrc",
+              "description": "The thumbnail image URL. Only used when `type` is \"image\".",
               "type": {
-                "text": "\"lg\" | \"md\" | \"sm\"",
-                "references": [
-                  {
-                    "name": "BsButtonSize"
-                  }
-                ]
+                "text": "string"
               },
-              "default": "'md'",
               "readonly": true,
-              "attribute": "size"
+              "attribute": "image-src"
             },
             {
               "kind": "field",
-              "name": "type",
-              "description": "Native `<button>` type.",
+              "name": "loading",
+              "description": "Shows an upload-in-progress spinner (blurred + overlaid for images, in the badge for files).",
               "type": {
-                "text": "\"button\" | \"reset\" | \"submit\""
+                "text": "boolean"
               },
-              "default": "'button'",
+              "default": "false",
               "readonly": true,
-              "attribute": "type"
+              "attribute": "loading"
             },
             {
               "kind": "field",
-              "name": "variant",
-              "description": "Visual style. Maps directly to the brandsync-tokens `--bs-button-*` semantic set.\n`error` is for destructive/irreversible actions per BrandSync guidance, not a stronger\nemphasis alternative to `primary`.",
+              "name": "removable",
+              "description": "Whether the hover/focus-revealed remove button is rendered at all.",
               "type": {
-                "text": "\"error\" | \"info\" | \"neutral\" | \"outlined\" | \"primary\" | \"subtle\" | \"success\" | \"warning\"",
+                "text": "boolean"
+              },
+              "default": "true",
+              "readonly": true,
+              "attribute": "removable"
+            },
+            {
+              "kind": "field",
+              "name": "type",
+              "description": "Which kind of attachment preview to render.",
+              "type": {
+                "text": "\"document\" | \"image\" | \"pdf\"",
                 "references": [
                   {
-                    "name": "BsButtonVariant"
+                    "name": "BsAttachmentType"
                   }
                 ]
               },
-              "default": "'primary'",
+              "default": "'image'",
               "readonly": true,
-              "attribute": "variant"
+              "attribute": "type"
             }
           ],
-          "slots": [
-            {
-              "name": "",
-              "description": "Default slot: the button's label content."
-            },
-            {
-              "name": "end-icon",
-              "description": "Optional trailing icon, rendered after the label."
-            },
+          "events": [
             {
-              "name": "icon",
-              "description": "Optional leading icon, rendered before the label."
+              "name": "bsRemove",
+              "description": "Fires when the remove button is clicked.",
+              "type": {
+                "text": "CustomEvent<void>"
+              }
             }
           ],
           "cssParts": [
             {
-              "name": "end-icon",
-              "description": "The trailing icon wrapper element."
+              "name": "badge",
+              "description": "The colored file-type badge inside the card."
             },
             {
-              "name": "icon",
-              "description": "The icon wrapper element."
+              "name": "card",
+              "description": "The filename card (type=\"pdf\" / type=\"document\" only)."
             },
             {
-              "name": "label",
-              "description": "The text label element."
+              "name": "filename",
+              "description": "The truncated filename text inside the card."
+            },
+            {
+              "name": "remove",
+              "description": "The remove button."
+            },
+            {
+              "name": "thumbnail",
+              "description": "The image thumbnail wrapper (type=\"image\" only)."
             }
           ]
         }
@@ -306,40 +364,365 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BsButton",
+          "name": "BsAttachment",
           "declaration": {
-            "name": "BsButton"
+            "name": "BsAttachment"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bs-button",
+          "name": "bs-attachment",
           "declaration": {
-            "name": "BsButton"
+            "name": "BsAttachment"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/bs-button-skeleton/bs-button-skeleton.tsx",
+      "path": "src/components/bs-attachment-list/bs-attachment-list.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bs-button-skeleton",
-          "name": "BsButtonSkeleton",
-          "description": "A shape-matched loading placeholder for `bs-button`, shown while the real label/action isn't\nknown yet (e.g. still being fetched from an API). Sized to match `bs-button`'s `sm`/`md`/`lg`\nheights so layout doesn't shift once the real button renders.\n\nThis is not a submit-in-progress spinner — that's a different concern (a button that's\nalready rendered but waiting on an async action it triggered). Use this component only when\nthe button itself doesn't exist yet.\n\n## When to use\n- In place of a `bs-button` whose label/visibility depends on data that hasn't loaded yet.\n\n## When not to use\n- While a button's own click handler is running (e.g. a submit request in flight) — render the\n  real `bs-button` and show its own busy/spinner state instead.",
+          "tagName": "bs-attachment-list",
+          "name": "BsAttachmentList",
+          "description": "A horizontally-scrolling row wrapper for one or more `bs-attachment` previews, for slotting into\n`bs-composer`'s `attachments` slot when a Genie AI chat message has file attachments.\n\n## When to use\n- Wrapping any number of `bs-attachment` elements the user has attached to a message, so they\n  lay out in a single row and scroll horizontally instead of wrapping/overflowing once there\n  are more than fit the available width.\n\n## When not to use\n- A single attachment on its own — just render `bs-attachment` directly, this wrapper's\n  scroll/fade affordance only matters once there's more content than fits.",
           "attributes": [
             {
-              "name": "size",
-              "description": "Sizing scale, matching the `bs-button` size it stands in for.",
+              "name": "aria-label",
+              "description": "Accessible name for the scrollable region.",
               "type": {
-                "text": "\"lg\" | \"md\" | \"sm\"",
-                "references": [
-                  {
-                    "name": "BsButtonSize",
-                    "module": "../bs-button/bs-button"
+                "text": "string"
+              },
+              "default": "'Attachments'",
+              "fieldName": "ariaLabel"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "description": "Accessible name for the scrollable region.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Attachments'",
+              "readonly": true,
+              "attribute": "aria-label"
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "One or more `bs-attachment` elements."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "fade",
+              "description": "The right-edge fade-out overlay shown only while the row has more content to\nscroll to."
+            },
+            {
+              "name": "row",
+              "description": "The scrollable flex row containing the slotted attachments."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsAttachmentList",
+          "declaration": {
+            "name": "BsAttachmentList"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-attachment-list",
+          "declaration": {
+            "name": "BsAttachmentList"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-badge/bs-badge.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-badge",
+          "name": "BsBadge",
+          "description": "A small status or category pill, usually paired with a label or list item.\n\n## When to use\n- Communicating a short, fixed status (e.g. \"Active\", \"On leave\") or category label.\n\n## When not to use\n- As an interactive/clickable element — a badge is a label, not a control. Use a button\n  or chip component if it needs to be clickable.\n- For long text — badges are sized for one or two words.",
+          "attributes": [
+            {
+              "name": "variant",
+              "description": "Maps directly to the brandsync-tokens `--bs-badge-bg-*` / `--bs-badge-text-*` sets.",
+              "type": {
+                "text": "\"default\" | \"error\" | \"info\" | \"inverse\" | \"neutral\" | \"primary\" | \"success\" | \"warning\"",
+                "references": [
+                  {
+                    "name": "BsBadgeVariant"
+                  }
+                ]
+              },
+              "default": "'default'",
+              "fieldName": "variant"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "variant",
+              "description": "Maps directly to the brandsync-tokens `--bs-badge-bg-*` / `--bs-badge-text-*` sets.",
+              "type": {
+                "text": "\"default\" | \"error\" | \"info\" | \"inverse\" | \"neutral\" | \"primary\" | \"success\" | \"warning\"",
+                "references": [
+                  {
+                    "name": "BsBadgeVariant"
+                  }
+                ]
+              },
+              "default": "'default'",
+              "readonly": true,
+              "attribute": "variant"
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Default slot: the badge's label text."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "container",
+              "description": "The pill element."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsBadge",
+          "declaration": {
+            "name": "BsBadge"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-badge",
+          "declaration": {
+            "name": "BsBadge"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-button/bs-button.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-button",
+          "name": "BsButton",
+          "description": "A clickable action element for the single most important action in a given context.\n\n## When to use\n- The primary call to action on a screen or within a card/modal (e.g. \"Book room\", \"Confirm\").\n- Secondary, lower-emphasis actions alongside it (use `variant=\"neutral\"`).\n- `variant=\"error\"` for destructive/irreversible actions (e.g. \"Delete account\") — per\n  BrandSync guidance, destructive actions should always use the error variant, never\n  `neutral`, so the visual weight matches the risk of the action.\n\n## When not to use\n- For navigation between pages — use a link/nav component instead, a button implies an\n  in-page action, not a destination change.\n- For more than one primary-emphasis action in the same view — pick one, demote the rest to\n  `neutral`.\n- `error` purely for visual emphasis — it signals a destructive action to the user, so reserve\n  it for actions that actually delete/revoke/undo something.",
+          "attributes": [
+            {
+              "name": "aria-label",
+              "description": "Accessible name for the button. Required for icon-only usage (no visible label text via the\ndefault slot) so screen readers still announce what the button does. Stencil reflects this\ncamelCase prop to the `aria-label` HTML attribute automatically.",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "fieldName": "ariaLabel"
+            },
+            {
+              "name": "disabled",
+              "description": "Disables the button and applies the disabled token set.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "size",
+              "description": "Sizing scale.",
+              "type": {
+                "text": "\"lg\" | \"md\" | \"sm\"",
+                "references": [
+                  {
+                    "name": "BsButtonSize"
+                  }
+                ]
+              },
+              "default": "'md'",
+              "fieldName": "size"
+            },
+            {
+              "name": "type",
+              "description": "Native `<button>` type.",
+              "type": {
+                "text": "\"button\" | \"reset\" | \"submit\""
+              },
+              "default": "'button'",
+              "fieldName": "type"
+            },
+            {
+              "name": "variant",
+              "description": "Visual style. Maps directly to the brandsync-tokens `--bs-button-*` semantic set.\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": "BsButtonVariant"
+                  }
+                ]
+              },
+              "default": "'primary'",
+              "fieldName": "variant"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "description": "Accessible name for the button. Required for icon-only usage (no visible label text via the\ndefault slot) so screen readers still announce what the button does. Stencil reflects this\ncamelCase prop 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.",
+              "type": {
+                "text": "\"lg\" | \"md\" | \"sm\"",
+                "references": [
+                  {
+                    "name": "BsButtonSize"
+                  }
+                ]
+              },
+              "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 directly to the brandsync-tokens `--bs-button-*` semantic set.\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": "BsButtonVariant"
+                  }
+                ]
+              },
+              "default": "'primary'",
+              "readonly": true,
+              "attribute": "variant"
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Default slot: the button's label content."
+            },
+            {
+              "name": "end-icon",
+              "description": "Optional trailing icon, rendered after the label."
+            },
+            {
+              "name": "icon",
+              "description": "Optional leading icon, rendered before the label."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "end-icon",
+              "description": "The trailing icon wrapper element."
+            },
+            {
+              "name": "icon",
+              "description": "The icon wrapper element."
+            },
+            {
+              "name": "label",
+              "description": "The text label element."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsButton",
+          "declaration": {
+            "name": "BsButton"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-button",
+          "declaration": {
+            "name": "BsButton"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-button-skeleton/bs-button-skeleton.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-button-skeleton",
+          "name": "BsButtonSkeleton",
+          "description": "A shape-matched loading placeholder for `bs-button`, shown while the real label/action isn't\nknown yet (e.g. still being fetched from an API). Sized to match `bs-button`'s `sm`/`md`/`lg`\nheights so layout doesn't shift once the real button renders.\n\nThis is not a submit-in-progress spinner — that's a different concern (a button that's\nalready rendered but waiting on an async action it triggered). Use this component only when\nthe button itself doesn't exist yet.\n\n## When to use\n- In place of a `bs-button` whose label/visibility depends on data that hasn't loaded yet.\n\n## When not to use\n- While a button's own click handler is running (e.g. a submit request in flight) — render the\n  real `bs-button` and show its own busy/spinner state instead.",
+          "attributes": [
+            {
+              "name": "size",
+              "description": "Sizing scale, matching the `bs-button` size it stands in for.",
+              "type": {
+                "text": "\"lg\" | \"md\" | \"sm\"",
+                "references": [
+                  {
+                    "name": "BsButtonSize",
+                    "module": "../bs-button/bs-button"
                   }
                 ]
               },
@@ -398,73 +781,276 @@
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bs-card",
-          "name": "BsCard",
-          "description": "A bounded surface for grouping related content — a summary, a form section, a list item.\n\n## When to use\n- Grouping a self-contained piece of content that needs visual separation from the page\n  background (e.g. a booking summary, a settings section).\n\n## When not to use\n- As the only structural element on a page — cards group content, they don't replace layout.\n- For a dismissible/transient message — use a modal or a dedicated notification component.",
+          "tagName": "bs-card",
+          "name": "BsCard",
+          "description": "A bounded surface for grouping related content — a summary, a form section, a list item.\n\n## When to use\n- Grouping a self-contained piece of content that needs visual separation from the page\n  background (e.g. a booking summary, a settings section).\n\n## When not to use\n- As the only structural element on a page — cards group content, they don't replace layout.\n- For a dismissible/transient message — use a modal or a dedicated notification component.",
+          "attributes": [
+            {
+              "name": "surface",
+              "description": "Maps to the brandsync-tokens `--bs-paper-bg-*` set — Brandsync's tokens don't have a\ndedicated \"card\" component yet, so this reuses the existing Paper surface tokens.",
+              "type": {
+                "text": "\"base\" | \"container\" | \"raised\"",
+                "references": [
+                  {
+                    "name": "BsCardSurface"
+                  }
+                ]
+              },
+              "default": "'raised'",
+              "fieldName": "surface"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "surface",
+              "description": "Maps to the brandsync-tokens `--bs-paper-bg-*` set — Brandsync's tokens don't have a\ndedicated \"card\" component yet, so this reuses the existing Paper surface tokens.",
+              "type": {
+                "text": "\"base\" | \"container\" | \"raised\"",
+                "references": [
+                  {
+                    "name": "BsCardSurface"
+                  }
+                ]
+              },
+              "default": "'raised'",
+              "readonly": true,
+              "attribute": "surface"
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Default slot: the card's main body content."
+            },
+            {
+              "name": "footer",
+              "description": "Optional actions/content below the body (e.g. a button)."
+            },
+            {
+              "name": "header",
+              "description": "Optional heading content above the body."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "body",
+              "description": "The body wrapper."
+            },
+            {
+              "name": "container",
+              "description": "The outer bordered surface element."
+            },
+            {
+              "name": "footer",
+              "description": "The footer wrapper."
+            },
+            {
+              "name": "header",
+              "description": "The header wrapper."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsCard",
+          "declaration": {
+            "name": "BsCard"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-card",
+          "declaration": {
+            "name": "BsCard"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-chatbot-feedback/bs-chatbot-feedback.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-chatbot-feedback",
+          "name": "BsChatbotFeedback",
+          "description": "A star-rating feedback card shown at the end of a Genie AI chat: a heading/subtitle, a 5-star\nrating, an optional comment, and either \"Submit feedback\" + \"Start new chat\" (before\nsubmitting) or just \"Start new chat\" (after).\n\n## When to use\n- Prompting for feedback on a Genie response or chat session, typically after the user ends or\n  restarts a conversation.\n\n## When not to use\n- A generic star-rating input elsewhere in the product -- this component's copy and layout are\n  purpose-built for the Genie feedback flow, not a reusable rating control.\n\nThe heading and subtitle are not freeform props: before submitting, they're always the fixed\n\"How was your experience...\" copy; after submitting, they're determined entirely by `rating`\n(1-2 stars reads apologetic, 3 neutral, 4-5 positive), matching the Figma source exactly. Use\n`heading`/`subtitle` only if a consuming app genuinely needs to override that copy.",
           "attributes": [
             {
-              "name": "surface",
-              "description": "Maps to the brandsync-tokens `--bs-paper-bg-*` set — Brandsync's tokens don't have a\ndedicated \"card\" component yet, so this reuses the existing Paper surface tokens.",
+              "name": "comment",
+              "description": "The comment text.",
               "type": {
-                "text": "\"base\" | \"container\" | \"raised\"",
-                "references": [
-                  {
-                    "name": "BsCardSurface"
-                  }
-                ]
+                "text": "string"
               },
-              "default": "'raised'",
-              "fieldName": "surface"
+              "default": "''",
+              "fieldName": "comment"
+            },
+            {
+              "name": "heading",
+              "description": "Overrides the computed heading (see the class doc for why this is computed by default).",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "heading"
+            },
+            {
+              "name": "rating",
+              "description": "Current star rating, 0-5. 0 means no rating has been given yet.",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "fieldName": "rating"
+            },
+            {
+              "name": "submitted",
+              "description": "Whether feedback has been submitted. Switches the card from the editable form to the\nread-only \"thanks\" view.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "submitted"
+            },
+            {
+              "name": "subtitle",
+              "description": "Overrides the computed subtitle.",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "subtitle"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "surface",
-              "description": "Maps to the brandsync-tokens `--bs-paper-bg-*` set — Brandsync's tokens don't have a\ndedicated \"card\" component yet, so this reuses the existing Paper surface tokens.",
+              "name": "comment",
+              "description": "The comment text.",
               "type": {
-                "text": "\"base\" | \"container\" | \"raised\"",
-                "references": [
-                  {
-                    "name": "BsCardSurface"
-                  }
-                ]
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "comment"
+            },
+            {
+              "kind": "field",
+              "name": "heading",
+              "description": "Overrides the computed heading (see the class doc for why this is computed by default).",
+              "type": {
+                "text": "string"
               },
-              "default": "'raised'",
               "readonly": true,
-              "attribute": "surface"
+              "attribute": "heading"
+            },
+            {
+              "kind": "field",
+              "name": "rating",
+              "description": "Current star rating, 0-5. 0 means no rating has been given yet.",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "attribute": "rating",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "submitted",
+              "description": "Whether feedback has been submitted. Switches the card from the editable form to the\nread-only \"thanks\" view.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "submitted",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "subtitle",
+              "description": "Overrides the computed subtitle.",
+              "type": {
+                "text": "string"
+              },
+              "readonly": true,
+              "attribute": "subtitle"
             }
           ],
-          "slots": [
+          "events": [
             {
-              "name": "",
-              "description": "Default slot: the card's main body content."
+              "name": "bsClose",
+              "description": "Fires when the close button is clicked. The consuming app owns actually hiding the card.",
+              "type": {
+                "text": "CustomEvent<void>"
+              }
             },
             {
-              "name": "footer",
-              "description": "Optional actions/content below the body (e.g. a button)."
+              "name": "bsCommentInput",
+              "description": "Fires on every keystroke in the comment textarea, with the current value.",
+              "type": {
+                "text": "CustomEvent<string>"
+              }
             },
             {
-              "name": "header",
-              "description": "Optional heading content above the body."
+              "name": "bsNewChat",
+              "description": "Fires when \"Start new chat\" is clicked. The consuming app owns actually starting a new chat.",
+              "type": {
+                "text": "CustomEvent<void>"
+              }
+            },
+            {
+              "name": "bsRatingChange",
+              "description": "Fires when a star is clicked, with the new rating.",
+              "type": {
+                "text": "CustomEvent<number>"
+              }
+            },
+            {
+              "name": "bsSubmit",
+              "description": "Fires when \"Submit feedback\" is clicked, with the current rating and comment. Also sets\n`submitted` to true.",
+              "type": {
+                "text": "CustomEvent<{ rating: number; comment: string; }>"
+              }
             }
           ],
           "cssParts": [
             {
-              "name": "body",
-              "description": "The body wrapper."
+              "name": "close",
+              "description": "The close button."
             },
             {
-              "name": "container",
-              "description": "The outer bordered surface element."
+              "name": "comment",
+              "description": "The submitted comment, read-only (only rendered after submitting, if a comment was given)."
             },
             {
-              "name": "footer",
-              "description": "The footer wrapper."
+              "name": "heading",
+              "description": "The heading text."
             },
             {
-              "name": "header",
-              "description": "The header wrapper."
+              "name": "label",
+              "description": "The \"Tell us what you think\" label (only rendered before submitting)."
+            },
+            {
+              "name": "new-chat",
+              "description": "The \"Start new chat\" button."
+            },
+            {
+              "name": "star",
+              "description": "A single star button (`::part(star)` matches all five)."
+            },
+            {
+              "name": "submit",
+              "description": "The \"Submit feedback\" button (only rendered before submitting)."
+            },
+            {
+              "name": "subtitle",
+              "description": "The subtitle text."
+            },
+            {
+              "name": "textarea",
+              "description": "The comment textarea (only rendered before submitting)."
             }
           ]
         }
@@ -472,16 +1058,16 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BsCard",
+          "name": "BsChatbotFeedback",
           "declaration": {
-            "name": "BsCard"
+            "name": "BsChatbotFeedback"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bs-card",
+          "name": "bs-chatbot-feedback",
           "declaration": {
-            "name": "BsCard"
+            "name": "BsChatbotFeedback"
           }
         }
       ]
@@ -718,8 +1304,144 @@
               }
             },
             {
-              "name": "bsSourcesClick",
-              "description": "Fires when the \"N sources\" button is clicked.",
+              "name": "bsSourcesClick",
+              "description": "Fires when the \"N sources\" button is clicked.",
+              "type": {
+                "text": "CustomEvent<void>"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "copy-icon",
+              "description": "Overrides the default \"Copy\" button icon."
+            },
+            {
+              "name": "dislike-icon",
+              "description": "Overrides the default \"Dislike\" button icon."
+            },
+            {
+              "name": "like-icon",
+              "description": "Overrides the default \"Like\" button icon."
+            },
+            {
+              "name": "menu",
+              "description": "A `bs-menu` (or other content) rendered in a popup positioned below the \"More\noptions\" button, shown only while `menuOpen` is `true`."
+            },
+            {
+              "name": "menu-icon",
+              "description": "Overrides the default \"More options\" button icon."
+            },
+            {
+              "name": "regenerate-icon",
+              "description": "Overrides the default \"Regenerate\" button icon."
+            },
+            {
+              "name": "sources-icon",
+              "description": "Overrides the default icon in the \"N sources\" button."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "copy",
+              "description": "The \"Copy\" icon button."
+            },
+            {
+              "name": "dislike",
+              "description": "The \"Dislike\" icon button."
+            },
+            {
+              "name": "like",
+              "description": "The \"Like\" icon button."
+            },
+            {
+              "name": "menu",
+              "description": "The \"More options\" icon button."
+            },
+            {
+              "name": "regenerate",
+              "description": "The \"Regenerate\" icon button."
+            },
+            {
+              "name": "sources",
+              "description": "The \"N sources\" button (only rendered when `sourcesCount` is set)."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsChatbotResponseAction",
+          "declaration": {
+            "name": "BsChatbotResponseAction"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-chatbot-response-action",
+          "declaration": {
+            "name": "BsChatbotResponseAction"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-chatbot-sources-drawer/bs-chatbot-sources-drawer.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-chatbot-sources-drawer",
+          "name": "BsChatbotSourcesDrawer",
+          "description": "The \"Sources\" panel shown alongside a Genie AI chat response -- a header with a title, a count\nbadge, and a collapse chevron, above a stack of `bs-source-link` citation rows.\n\n## When to use\n- Displaying the documents/sources a Genie response cited, typically opened from a \"view\n  sources\" action on a `bs-chatbot-response-action` bar.\n\n## When not to use\n- A generic list container -- this component's header (title + count + collapse) is\n  purpose-built for the sources use case.",
+          "attributes": [
+            {
+              "name": "count",
+              "description": "Overrides the auto-detected count badge. By default the badge reflects the number of slotted\n`bs-source-link` children, so most consumers don't need to set this.",
+              "type": {
+                "text": "number"
+              },
+              "fieldName": "count"
+            },
+            {
+              "name": "heading",
+              "description": "The panel title.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Sources'",
+              "fieldName": "heading"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "count",
+              "description": "Overrides the auto-detected count badge. By default the badge reflects the number of slotted\n`bs-source-link` children, so most consumers don't need to set this.",
+              "type": {
+                "text": "number"
+              },
+              "readonly": true,
+              "attribute": "count"
+            },
+            {
+              "kind": "field",
+              "name": "heading",
+              "description": "The panel title.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Sources'",
+              "readonly": true,
+              "attribute": "heading"
+            }
+          ],
+          "events": [
+            {
+              "name": "bsCollapse",
+              "description": "Fires when the collapse chevron is clicked. The consuming app owns actually hiding the panel.",
               "type": {
                 "text": "CustomEvent<void>"
               }
@@ -727,58 +1449,30 @@
           ],
           "slots": [
             {
-              "name": "copy-icon",
-              "description": "Overrides the default \"Copy\" button icon."
-            },
-            {
-              "name": "dislike-icon",
-              "description": "Overrides the default \"Dislike\" button icon."
-            },
-            {
-              "name": "like-icon",
-              "description": "Overrides the default \"Like\" button icon."
-            },
-            {
-              "name": "menu",
-              "description": "A `bs-menu` (or other content) rendered in a popup positioned below the \"More\noptions\" button, shown only while `menuOpen` is `true`."
-            },
-            {
-              "name": "menu-icon",
-              "description": "Overrides the default \"More options\" button icon."
-            },
-            {
-              "name": "regenerate-icon",
-              "description": "Overrides the default \"Regenerate\" button icon."
+              "name": "",
+              "description": "One or more `bs-source-link` rows."
             },
             {
-              "name": "sources-icon",
-              "description": "Overrides the default icon in the \"N sources\" button."
+              "name": "collapse-icon",
+              "description": "Overrides the default collapse chevron icon."
             }
           ],
           "cssParts": [
             {
-              "name": "copy",
-              "description": "The \"Copy\" icon button."
-            },
-            {
-              "name": "dislike",
-              "description": "The \"Dislike\" icon button."
-            },
-            {
-              "name": "like",
-              "description": "The \"Like\" icon button."
+              "name": "collapse",
+              "description": "The collapse chevron button."
             },
             {
-              "name": "menu",
-              "description": "The \"More options\" icon button."
+              "name": "count",
+              "description": "The count badge next to the title."
             },
             {
-              "name": "regenerate",
-              "description": "The \"Regenerate\" icon button."
+              "name": "heading",
+              "description": "The \"Sources\" title text."
             },
             {
-              "name": "sources",
-              "description": "The \"N sources\" button (only rendered when `sourcesCount` is set)."
+              "name": "list",
+              "description": "The scrollable container of slotted `bs-source-link` rows."
             }
           ]
         }
@@ -786,16 +1480,16 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BsChatbotResponseAction",
+          "name": "BsChatbotSourcesDrawer",
           "declaration": {
-            "name": "BsChatbotResponseAction"
+            "name": "BsChatbotSourcesDrawer"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bs-chatbot-response-action",
+          "name": "bs-chatbot-sources-drawer",
           "declaration": {
-            "name": "BsChatbotResponseAction"
+            "name": "BsChatbotSourcesDrawer"
           }
         }
       ]
@@ -922,129 +1616,340 @@
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "fieldName": "value"
+              "default": "''",
+              "fieldName": "value"
+            },
+            {
+              "name": "variant",
+              "description": "Which flavor of composer this is: changes the *default* placeholder text (set `placeholder`\ndirectly to override it) and, per the Figma design, renders the container border dashed\ninstead of solid for `'human'` -- a deliberate visual cue distinguishing a human-support\ncomposer from the AI one, not a layout/token difference.",
+              "type": {
+                "text": "\"ai\" | \"human\"",
+                "references": [
+                  {
+                    "name": "BsComposerVariant"
+                  }
+                ]
+              },
+              "default": "'ai'",
+              "fieldName": "variant"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "description": "Accessible name for the text field. This component has no visible `<label>` (chat composers\ndon't show one in the design), so `ariaLabel` is the only way a consumer gives the textbox an\naccessible name -- set it in every real usage.",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "readonly": true,
+              "attribute": "aria-label"
+            },
+            {
+              "kind": "field",
+              "name": "placeholder",
+              "description": "Overrides the variant's default placeholder.",
+              "type": {
+                "text": "string"
+              },
+              "readonly": true,
+              "attribute": "placeholder"
+            },
+            {
+              "kind": "field",
+              "name": "state",
+              "description": "Which of the four mutually-exclusive composer states to render: `idle` (send, enabled),\n`generating` (stop, while the AI is responding), `disabled` (send, but not interactive), or\n`recording` (voice input in progress -- shows a waveform and a confirm action).",
+              "type": {
+                "text": "\"disabled\" | \"generating\" | \"idle\" | \"recording\"",
+                "references": [
+                  {
+                    "name": "BsComposerState"
+                  }
+                ]
+              },
+              "default": "'idle'",
+              "readonly": true,
+              "attribute": "state"
+            },
+            {
+              "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.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "value"
+            },
+            {
+              "kind": "field",
+              "name": "variant",
+              "description": "Which flavor of composer this is: changes the *default* placeholder text (set `placeholder`\ndirectly to override it) and, per the Figma design, renders the container border dashed\ninstead of solid for `'human'` -- a deliberate visual cue distinguishing a human-support\ncomposer from the AI one, not a layout/token difference.",
+              "type": {
+                "text": "\"ai\" | \"human\"",
+                "references": [
+                  {
+                    "name": "BsComposerVariant"
+                  }
+                ]
+              },
+              "default": "'ai'",
+              "readonly": true,
+              "attribute": "variant"
+            }
+          ],
+          "events": [
+            {
+              "name": "bsAttach",
+              "description": "Fires when the \"+\" attach button is clicked.",
+              "type": {
+                "text": "CustomEvent<void>"
+              }
+            },
+            {
+              "name": "bsInput",
+              "description": "Fires on every keystroke in the text field, with the current value.",
+              "type": {
+                "text": "CustomEvent<string>"
+              }
+            },
+            {
+              "name": "bsMicToggle",
+              "description": "Fires when the mic/stop-recording button is clicked. The consumer decides what that means\n(e.g. start recording when idle/generating, or stop recording when `state=\"recording\"`).",
+              "type": {
+                "text": "CustomEvent<void>"
+              }
+            },
+            {
+              "name": "bsStop",
+              "description": "Fires when the primary action button is clicked while `state=\"generating\"`.",
+              "type": {
+                "text": "CustomEvent<void>"
+              }
+            },
+            {
+              "name": "bsSubmit",
+              "description": "Fires when the primary action button is clicked while `state=\"idle\"`.",
+              "type": {
+                "text": "CustomEvent<void>"
+              }
+            },
+            {
+              "name": "bsVoiceConfirm",
+              "description": "Fires when the primary action button is clicked while `state=\"recording\"`.",
+              "type": {
+                "text": "CustomEvent<void>"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "actions-end",
+              "description": "Extra consumer-supplied controls appended after the primary action button\nin the controls row (e.g. a product-specific \"Tools\" button). Slotted content is placed\ninline in the same flex row as attach/mic/action, so a slotted element should size itself to\nroughly match `--bs-composer-button-size` to align visually."
+            },
+            {
+              "name": "attachments",
+              "description": "A `bs-attachment-list` (or other content) rendered inside the composer's own\nbordered container, above the text field -- only takes up space/padding when it has assigned\ncontent, so leaving it empty renders identically to not having the slot at all."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "action",
+              "description": "The primary circular action button (send, stop, or confirm depending on `state`)."
+            },
+            {
+              "name": "attach",
+              "description": "The \"+\" attach button."
+            },
+            {
+              "name": "attachments",
+              "description": "The wrapper around the `attachments` slot."
+            },
+            {
+              "name": "input",
+              "description": "The native text `<input>`."
+            },
+            {
+              "name": "mic",
+              "description": "The secondary icon button (microphone, or the stop-recording square while `state=\"recording\"`)."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsComposer",
+          "declaration": {
+            "name": "BsComposer"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-composer",
+          "declaration": {
+            "name": "BsComposer"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-composer-status-banner/bs-composer-status-banner.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "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).",
+          "attributes": [
+            {
+              "name": "action-label",
+              "description": "Label for the action button, only rendered when `showButton` is true.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Continue'",
+              "fieldName": "actionLabel"
+            },
+            {
+              "name": "allow-close",
+              "description": "Whether the close button is rendered.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "fieldName": "allowClose"
+            },
+            {
+              "name": "message",
+              "description": "The message text.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'This is a message'",
+              "fieldName": "message"
+            },
+            {
+              "name": "show-button",
+              "description": "Whether the \"Continue\"-style action button is rendered.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "showButton"
+            },
+            {
+              "name": "show-icon",
+              "description": "Whether the leading icon (default: clock) is rendered.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "fieldName": "showIcon"
             },
             {
-              "name": "variant",
-              "description": "Which flavor of composer this is: changes the *default* placeholder text (set `placeholder`\ndirectly to override it) and, per the Figma design, renders the container border dashed\ninstead of solid for `'human'` -- a deliberate visual cue distinguishing a human-support\ncomposer from the AI one, not a layout/token difference.",
+              "name": "type",
+              "description": "Which severity/style to render. Drives background, text/icon color, and the action button's color.",
               "type": {
-                "text": "\"ai\" | \"human\"",
+                "text": "\"error\" | \"info\" | \"neutral\" | \"warning\"",
                 "references": [
                   {
-                    "name": "BsComposerVariant"
+                    "name": "BsComposerStatusBannerType"
                   }
                 ]
               },
-              "default": "'ai'",
-              "fieldName": "variant"
+              "default": "'error'",
+              "fieldName": "type"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "ariaLabel",
-              "description": "Accessible name for the text field. This component has no visible `<label>` (chat composers\ndon't show one in the design), so `ariaLabel` is the only way a consumer gives the textbox an\naccessible name -- set it in every real usage.",
+              "name": "actionLabel",
+              "description": "Label for the action button, only rendered when `showButton` is true.",
               "type": {
                 "text": "string"
               },
-              "default": "null",
+              "default": "'Continue'",
               "readonly": true,
-              "attribute": "aria-label"
+              "attribute": "action-label"
             },
             {
               "kind": "field",
-              "name": "placeholder",
-              "description": "Overrides the variant's default placeholder.",
+              "name": "allowClose",
+              "description": "Whether the close button is rendered.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "readonly": true,
+              "attribute": "allow-close"
+            },
+            {
+              "kind": "field",
+              "name": "message",
+              "description": "The message text.",
               "type": {
                 "text": "string"
               },
+              "default": "'This is a message'",
               "readonly": true,
-              "attribute": "placeholder"
+              "attribute": "message"
             },
             {
               "kind": "field",
-              "name": "state",
-              "description": "Which of the four mutually-exclusive composer states to render: `idle` (send, enabled),\n`generating` (stop, while the AI is responding), `disabled` (send, but not interactive), or\n`recording` (voice input in progress -- shows a waveform and a confirm action).",
+              "name": "showButton",
+              "description": "Whether the \"Continue\"-style action button is rendered.",
               "type": {
-                "text": "\"disabled\" | \"generating\" | \"idle\" | \"recording\"",
-                "references": [
-                  {
-                    "name": "BsComposerState"
-                  }
-                ]
+                "text": "boolean"
               },
-              "default": "'idle'",
+              "default": "false",
               "readonly": true,
-              "attribute": "state"
+              "attribute": "show-button"
             },
             {
               "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.",
+              "name": "showIcon",
+              "description": "Whether the leading icon (default: clock) is rendered.",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
+              "default": "true",
               "readonly": true,
-              "attribute": "value"
+              "attribute": "show-icon"
             },
             {
               "kind": "field",
-              "name": "variant",
-              "description": "Which flavor of composer this is: changes the *default* placeholder text (set `placeholder`\ndirectly to override it) and, per the Figma design, renders the container border dashed\ninstead of solid for `'human'` -- a deliberate visual cue distinguishing a human-support\ncomposer from the AI one, not a layout/token difference.",
+              "name": "type",
+              "description": "Which severity/style to render. Drives background, text/icon color, and the action button's color.",
               "type": {
-                "text": "\"ai\" | \"human\"",
+                "text": "\"error\" | \"info\" | \"neutral\" | \"warning\"",
                 "references": [
                   {
-                    "name": "BsComposerVariant"
+                    "name": "BsComposerStatusBannerType"
                   }
                 ]
               },
-              "default": "'ai'",
+              "default": "'error'",
               "readonly": true,
-              "attribute": "variant"
+              "attribute": "type"
             }
           ],
           "events": [
             {
-              "name": "bsAttach",
-              "description": "Fires when the \"+\" attach button is clicked.",
-              "type": {
-                "text": "CustomEvent<void>"
-              }
-            },
-            {
-              "name": "bsInput",
-              "description": "Fires on every keystroke in the text field, with the current value.",
-              "type": {
-                "text": "CustomEvent<string>"
-              }
-            },
-            {
-              "name": "bsMicToggle",
-              "description": "Fires when the mic/stop-recording button is clicked. The consumer decides what that means\n(e.g. start recording when idle/generating, or stop recording when `state=\"recording\"`).",
-              "type": {
-                "text": "CustomEvent<void>"
-              }
-            },
-            {
-              "name": "bsStop",
-              "description": "Fires when the primary action button is clicked while `state=\"generating\"`.",
-              "type": {
-                "text": "CustomEvent<void>"
-              }
-            },
-            {
-              "name": "bsSubmit",
-              "description": "Fires when the primary action button is clicked while `state=\"idle\"`.",
+              "name": "bsAction",
+              "description": "Fires when the action button is clicked. Only relevant when `showButton` is true.",
               "type": {
                 "text": "CustomEvent<void>"
               }
             },
             {
-              "name": "bsVoiceConfirm",
-              "description": "Fires when the primary action button is clicked while `state=\"recording\"`.",
+              "name": "bsClose",
+              "description": "Fires when the close button is clicked. Only relevant when `allowClose` is true.",
               "type": {
                 "text": "CustomEvent<void>"
               }
@@ -1052,26 +1957,26 @@
           ],
           "slots": [
             {
-              "name": "actions-end",
-              "description": "Extra consumer-supplied controls appended after the primary action button\nin the controls row (e.g. a product-specific \"Tools\" button). Slotted content is placed\ninline in the same flex row as attach/mic/action, so a slotted element should size itself to\nroughly match `--bs-composer-button-size` to align visually."
+              "name": "icon",
+              "description": "Overrides the default leading icon. Only rendered when `showIcon` is true."
             }
           ],
           "cssParts": [
             {
               "name": "action",
-              "description": "The primary circular action button (send, stop, or confirm depending on `state`)."
+              "description": "The optional \"Continue\"-style action button."
             },
             {
-              "name": "attach",
-              "description": "The \"+\" attach button."
+              "name": "close",
+              "description": "The optional close button."
             },
             {
-              "name": "input",
-              "description": "The native text `<input>`."
+              "name": "icon",
+              "description": "The leading icon wrapper."
             },
             {
-              "name": "mic",
-              "description": "The secondary icon button (microphone, or the stop-recording square while `state=\"recording\"`)."
+              "name": "message",
+              "description": "The message text."
             }
           ]
         }
@@ -1079,16 +1984,16 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BsComposer",
+          "name": "BsComposerStatusBanner",
           "declaration": {
-            "name": "BsComposer"
+            "name": "BsComposerStatusBanner"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bs-composer",
+          "name": "bs-composer-status-banner",
           "declaration": {
-            "name": "BsComposer"
+            "name": "BsComposerStatusBanner"
           }
         }
       ]
@@ -1274,8 +2179,17 @@
           "customElement": true,
           "tagName": "bs-input",
           "name": "BsInput",
-          "description": "A single-line text field with an optional label, description, and error state.\n\n## When to use\n- Collecting a single line of free-text, email, password, or numeric input.\n- Pair with `error` for inline validation feedback tied to that specific field.\n\n## When not to use\n- Multi-line text — this component has no `textarea` mode.\n- A fixed set of choices — use a select/radio/checkbox component instead of free text.",
+          "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": {
@@ -1298,6 +2212,15 @@
               },
               "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": {
@@ -1305,83 +2228,281 @@
               },
               "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"
+              "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"
             },
             {
-              "name": "type",
+              "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": "\"email\" | \"number\" | \"password\" | \"text\""
+                "text": "boolean"
               },
-              "default": "'text'",
-              "fieldName": "type"
+              "default": "false",
+              "attribute": "open",
+              "reflects": true
             },
             {
-              "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.",
+              "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": "string"
+                "text": "{ label: string; value: string; }[]"
               },
-              "default": "''",
-              "fieldName": "value"
-            }
-          ],
-          "members": [
+              "default": "[]",
+              "readonly": true
+            },
             {
               "kind": "field",
-              "name": "description",
+              "name": "placeholder",
               "type": {
                 "text": "string"
               },
               "readonly": true,
-              "attribute": "description"
+              "attribute": "placeholder"
             },
             {
               "kind": "field",
-              "name": "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`.",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
               "readonly": true,
-              "attribute": "disabled"
+              "attribute": "required"
             },
             {
               "kind": "field",
-              "name": "error",
+              "name": "rows",
+              "description": "Number of visible rows for `type=\"textarea\"`.",
               "type": {
-                "text": "string"
+                "text": "number"
               },
+              "default": "3",
               "readonly": true,
-              "attribute": "error"
+              "attribute": "rows"
             },
             {
               "kind": "field",
-              "name": "label",
+              "name": "step",
+              "description": "Step size for `type=\"number\"`'s increment/decrement stepper buttons.",
               "type": {
-                "text": "string"
+                "text": "number"
               },
+              "default": "1",
               "readonly": true,
-              "attribute": "label"
+              "attribute": "step"
             },
             {
               "kind": "field",
-              "name": "placeholder",
+              "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"
+                "text": "string[]"
               },
-              "readonly": true,
-              "attribute": "placeholder"
+              "default": "[]",
+              "readonly": true
             },
             {
               "kind": "field",
               "name": "type",
               "type": {
-                "text": "\"email\" | \"number\" | \"password\" | \"text\""
+                "text": "\"chip\" | \"country\" | \"date\" | \"dropdown\" | \"email\" | \"initials\" | \"number\" | \"password\" | \"pin\" | \"search\" | \"select\" | \"text\" | \"textarea\""
               },
               "default": "'text'",
               "readonly": true,
@@ -1390,12 +2511,11 @@
             {
               "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.",
+              "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": "''",
-              "readonly": true,
               "attribute": "value"
             }
           ],
@@ -1406,29 +2526,200 @@
                 "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 `<input>` element."
+              "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."
             }
           ]
         }
@@ -1694,6 +2985,170 @@
         }
       ]
     },
+    {
+      "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"
+            },
+            {
+              "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.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'_blank'",
+              "readonly": true,
+              "attribute": "target"
+            },
+            {
+              "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": "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": "icon",
+              "description": "Overrides the default file icon."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "arrow",
+              "description": "The trailing \"open\" arrow icon."
+            },
+            {
+              "name": "filename",
+              "description": "The filename text."
+            },
+            {
+              "name": "icon",
+              "description": "The leading file-type icon."
+            },
+            {
+              "name": "source",
+              "description": "The source system name."
+            },
+            {
+              "name": "version",
+              "description": "The version label."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsSourceLink",
+          "declaration": {
+            "name": "BsSourceLink"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-source-link",
+          "declaration": {
+            "name": "BsSourceLink"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/bs-tooltip/bs-tooltip.tsx",