@brandsync/wc 0.0.7 → 0.0.9

package/dist/types/components.d.ts

@@ -5,41 +5,102 @@
  * It contains typing information for all components that exist in this project.
  */
 import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
+import { BsAttachmentType } from "./components/bs-attachment/bs-attachment";
 import { BsBadgeVariant } from "./components/bs-badge/bs-badge";
 import { BsButtonSize, BsButtonVariant } from "./components/bs-button/bs-button";
 import { BsButtonSize as BsButtonSize1 } from "./components/bs-button/bs-button";
 import { BsCardSurface } from "./components/bs-card/bs-card";
 import { BsComposerState, BsComposerVariant } from "./components/bs-composer/bs-composer";
+import { BsComposerStatusBannerType } from "./components/bs-composer-status-banner/bs-composer-status-banner";
 import { BsDataTableColumn, BsDataTableRow } from "./components/bs-data-table/bs-data-table";
 import { BsModalSize } from "./components/bs-modal/bs-modal";
+export { BsAttachmentType } from "./components/bs-attachment/bs-attachment";
 export { BsBadgeVariant } from "./components/bs-badge/bs-badge";
 export { BsButtonSize, BsButtonVariant } from "./components/bs-button/bs-button";
 export { BsButtonSize as BsButtonSize1 } from "./components/bs-button/bs-button";
 export { BsCardSurface } from "./components/bs-card/bs-card";
 export { BsComposerState, BsComposerVariant } from "./components/bs-composer/bs-composer";
+export { BsComposerStatusBannerType } from "./components/bs-composer-status-banner/bs-composer-status-banner";
 export { BsDataTableColumn, BsDataTableRow } from "./components/bs-data-table/bs-data-table";
 export { BsModalSize } from "./components/bs-modal/bs-modal";
 export namespace Components {
+    /**
+     * A centered caption disclaimer for Genie AI surfaces, e.g. "AI can make mistakes. Please verify
+     * important information."
+     * ## When to use
+     * - Below or above `bs-composer` in a Genie AI chat panel, to remind users AI output can be wrong.
+     * ## When not to use
+     * - A general-purpose caption/helper text — use plain text or `bs-input`'s description slot for
+     *   non-AI-related helper copy.
+     * The default slot (rather than a fixed prop) is intentional: Figma only specifies plain text, but
+     * some consuming apps link out to a policy/help page from this copy, and a slot supports that
+     * without inventing an unconfirmed `href`/link prop.
+     * @prop --bs-ai-disclaimer-padding-x - Horizontal padding. Aliased to `--bs-spacing-200`.
+     * @prop --bs-ai-disclaimer-text-color - Text color. Aliased to `--bs-text-secondary`.
+     * @prop --bs-ai-disclaimer-font-size - Text font size. Aliased to `--bs-font-size-sm`.
+     * @prop --bs-ai-disclaimer-line-height - Text line height. Aliased to `--bs-line-height-body-sm`.
+     */
+    interface BsAiDisclaimer {
+    }
+    /**
+     * The centered welcome heading shown at the top of an empty Genie AI chat panel, e.g.
+     * "Hi. I'm Genie, your AI assistant." + "How can I help you with [product] today?"
+     * ## When to use
+     * - The empty/initial state of a Genie AI chat panel, before the user has sent a message.
+     * ## When not to use
+     * - Once a conversation has started -- this is a one-time empty-state greeting, not a persistent
+     *   header (see `bs-chatbot-header` for that).
+     * `productName` is optional: Figma's copy has a `[product_name]` placeholder the consuming app is
+     * expected to fill in, but a component shouldn't force a product name to exist, so leaving it
+     * unset falls back to a product-agnostic "How can I help you today?".
+     * @prop --bs-ai-greeting-gap - Gap between heading and subtext. Aliased to `--bs-spacing-200`.
+     * @prop --bs-ai-greeting-max-width - Max width of the centered content block. Matches Figma's
+     * 490px.
+     * @prop --bs-ai-greeting-heading-color - Heading text color. Aliased to `--bs-text-default`.
+     * @prop --bs-ai-greeting-heading-font-size - Heading font size. Aliased to `--bs-font-size-4xl`.
+     * @prop --bs-ai-greeting-heading-line-height - Heading line height. Figma specifies 28px, which
+     * doesn't match any `--bs-line-height-heading-*` token (h4 is 32) -- aliased directly to
+     * `--bs-line-height-body-lg`, the token that happens to share the same numeric value.
+     * @prop --bs-ai-greeting-heading-weight - Heading font weight. Aliased to `--bs-font-weight-bold`.
+     * @prop --bs-ai-greeting-heading-gap - Gap between the two heading lines. Aliased to
+     * `--bs-spacing-200`.
+     * @prop --bs-ai-greeting-subtext-color - Subtext color. Aliased to `--bs-text-secondary`.
+     * @prop --bs-ai-greeting-subtext-font-size - Subtext font size. Figma specifies 20px, which
+     * doesn't match the semantic `--bs-text-style-body-lg-size` (18px) -- aliased directly to the
+     * raw `--bs-font-size-xl` primitive instead.
+     * @prop --bs-ai-greeting-subtext-line-height - Subtext line height. Aliased to
+     * `--bs-line-height-body-lg`.
+     */
+    interface BsAiGreeting {
+        /**
+          * The assistant's name, used in the heading ("Hi. I'm {assistantName},").
+          * @default 'Genie'
+         */
+        "assistantName": string;
+        /**
+          * The product name mentioned in the subtext. Omit to use a product-agnostic subtext.
+         */
+        "productName"?: string;
+    }
     /**
      * A small inline status indicator for Genie AI surfaces: the colorful Genie mark next to a label
-     * (e.g. "Retrieving", "Thinking", "Searching") whose text pulses in a slow breathing loop while
-     * an operation is in progress.
+     * (e.g. "Retrieving", "Thinking", "Searching") whose text shimmers with a moving highlight band
+     * while an operation is in progress.
      * ## When to use
      * - Inline in a Genie AI chat transcript to show what the assistant is currently doing while a
      *   response is being generated (retrieving context, searching, thinking).
      * ## When not to use
      * - A blocking/full-panel loading state -- this is a small inline indicator, not a spinner overlay.
-     * The label's pulse animation reproduces Figma's exact keyframe track (a plain opacity
-     * fade-in/hold/reset with the source's own cubic-bezier easing) rather than an invented
-     * shimmer-sweep -- the source design only specifies this one animation.
      * @prop --bs-ai-thinking-gap - Gap between icon and label. Aliased to `--bs-spacing-100`.
      * @prop --bs-ai-thinking-icon-size - Width/height of the icon.
-     * @prop --bs-ai-thinking-text - Label color. Aliased to `--bs-text-muted`.
+     * @prop --bs-ai-thinking-text - Label base color. Aliased to `--bs-text-muted`.
+     * @prop --bs-ai-thinking-shimmer-highlight - Color of the moving highlight band. Aliased to
+     * `--bs-text-default` (more prominent than `--bs-text-muted` in both themes).
      * @prop --bs-ai-thinking-font-size - Label font size. Aliased to `--bs-font-size-md`.
      * @prop --bs-ai-thinking-line-height - Label line height. Aliased to `--bs-line-height-body-md`.
-     * @prop --bs-ai-thinking-cycle-duration - Duration of one pulse loop. Figma specifies exactly 2s,
-     * longer than any `--bs-duration-*` token (max `--bs-duration-slower` is 500ms), so this is
-     * aliased directly to the literal value.
+     * @prop --bs-ai-thinking-cycle-duration - Duration of one shimmer sweep. Figma's own keyframe
+     * track for this label runs over exactly 2s, longer than any `--bs-duration-*` token (max
+     * `--bs-duration-slower` is 500ms), so this is aliased directly to the literal value.
      */
     interface BsAiThinking {
         /**
@@ -48,6 +109,93 @@ export namespace Components {
          */
         "label": string;
     }
+    /**
+     * A single file attachment preview for `bs-composer` -- an image thumbnail, or a filename card
+     * with a colored file-type badge (PDF/Document), with an optional upload-in-progress spinner and
+     * a hover/focus-revealed remove button.
+     * ## When to use
+     * - Rendered by the consuming app for each file a user has attached to a Genie AI chat message,
+     *   typically alongside or inside `bs-composer`.
+     * ## When not to use
+     * - A generic file-upload control -- this is a preview-only presentational component. The
+     *   consuming app owns the actual file picker/upload logic and drives `loading` from that state.
+     * @prop --bs-attachment-size - Width/height of the image thumbnail and of the card. Defaults to 112px.
+     * @prop --bs-attachment-radius - Corner radius of the thumbnail/card. Aliased to
+     * `--bs-border-radius-100`.
+     * @prop --bs-attachment-border-color - Border color of the card / loading image wrap. Aliased to
+     * `--bs-border-default`.
+     * @prop --bs-attachment-card-bg - Card background. Aliased to `--bs-surface-base`.
+     * @prop --bs-attachment-filename-color - Filename text color. Aliased to `--bs-text-default`.
+     * @prop --bs-attachment-badge-bg-pdf - PDF badge background. Aliased to `--bs-badge-bg-error`.
+     * @prop --bs-attachment-badge-bg-document - Document badge background. Aliased to
+     * `--bs-badge-bg-info`.
+     * @prop --bs-attachment-remove-bg - Remove button (neutral icon button) default background.
+     * Aliased to `--bs-button-neutral-container`.
+     * @prop --bs-attachment-remove-hover - Remove button hover background. Aliased to
+     * `--bs-button-neutral-hover`.
+     * @prop --bs-attachment-remove-pressed - Remove button active/pressed background. Aliased to
+     * `--bs-button-neutral-pressed`.
+     * @prop --bs-attachment-remove-focus - Remove button focus outline color. Aliased to
+     * `--bs-border-neutral-focus`.
+     */
+    interface BsAttachment {
+        /**
+          * The filename shown on the card. Only used when `type` is "pdf" or "document".
+          * @default 'Attachment'
+         */
+        "fileName": string;
+        /**
+          * Accessible alt text for the image thumbnail. Only used when `type` is "image".
+          * @default ''
+         */
+        "imageAlt": string;
+        /**
+          * The thumbnail image URL. Only used when `type` is "image".
+         */
+        "imageSrc"?: string;
+        /**
+          * Shows an upload-in-progress spinner (blurred + overlaid for images, in the badge for files).
+          * @default false
+         */
+        "loading": boolean;
+        /**
+          * Whether the hover/focus-revealed remove button is rendered at all.
+          * @default true
+         */
+        "removable": boolean;
+        /**
+          * Which kind of attachment preview to render.
+          * @default 'image'
+         */
+        "type": BsAttachmentType;
+    }
+    /**
+     * A horizontally-scrolling row wrapper for one or more `bs-attachment` previews, for slotting into
+     * `bs-composer`'s `attachments` slot when a Genie AI chat message has file attachments.
+     * ## When to use
+     * - Wrapping any number of `bs-attachment` elements the user has attached to a message, so they
+     *   lay out in a single row and scroll horizontally instead of wrapping/overflowing once there
+     *   are more than fit the available width.
+     * ## When not to use
+     * - A single attachment on its own — just render `bs-attachment` directly, this wrapper's
+     *   scroll/fade affordance only matters once there's more content than fits.
+     * @prop --bs-attachment-list-gap - Gap between attachments. Matches the 10px Figma spec (not tied
+     * to the `--bs-spacing-*` scale, which only has 8px/12px neighbors).
+     * @prop --bs-attachment-list-padding - Padding around the row. Aliased to `--bs-spacing-150`.
+     * @prop --bs-attachment-list-fade-color - Color the right-edge fade blends into. Aliased to
+     * `--bs-static-white`.
+     * @prop --bs-attachment-list-fade-width - Width of the right-edge fade overlay. Aliased to
+     * `--bs-spacing-800`.
+     * @prop --bs-attachment-list-scrollbar-thumb - Color of the scrollbar thumb that appears on
+     * hover/focus once the row is scrollable. Aliased to `--bs-neutral-300`.
+     */
+    interface BsAttachmentList {
+        /**
+          * Accessible name for the scrollable region.
+          * @default 'Attachments'
+         */
+        "ariaLabel": string | null;
+    }
     /**
      * A small status or category pill, usually paired with a label or list item.
      * ## When to use
@@ -151,6 +299,72 @@ export namespace Components {
          */
         "surface": BsCardSurface;
     }
+    /**
+     * A star-rating feedback card shown at the end of a Genie AI chat: a heading/subtitle, a 5-star
+     * rating, an optional comment, and either "Submit feedback" + "Start new chat" (before
+     * submitting) or just "Start new chat" (after).
+     * ## When to use
+     * - Prompting for feedback on a Genie response or chat session, typically after the user ends or
+     *   restarts a conversation.
+     * ## When not to use
+     * - A generic star-rating input elsewhere in the product -- this component's copy and layout are
+     *   purpose-built for the Genie feedback flow, not a reusable rating control.
+     * The heading and subtitle are not freeform props: before submitting, they're always the fixed
+     * "How was your experience..." copy; after submitting, they're determined entirely by `rating`
+     * (1-2 stars reads apologetic, 3 neutral, 4-5 positive), matching the Figma source exactly. Use
+     * `heading`/`subtitle` only if a consuming app genuinely needs to override that copy.
+     * @prop --bs-chatbot-feedback-bg - Card background. Aliased to `--bs-surface-raised`.
+     * @prop --bs-chatbot-feedback-border - Card border color. Aliased to `--bs-border-default`.
+     * @prop --bs-chatbot-feedback-radius - Card corner radius. Aliased to `--bs-border-radius-200`.
+     * @prop --bs-chatbot-feedback-padding-x - Card horizontal padding. Aliased to `--bs-spacing-250`.
+     * @prop --bs-chatbot-feedback-padding-y - Card vertical padding. Aliased to `--bs-spacing-550`.
+     * @prop --bs-chatbot-feedback-max-width - Max width of the card. Matches Figma's 762px.
+     * @prop --bs-chatbot-feedback-gap - Gap between the top content block and the button(s). Aliased
+     * to `--bs-spacing-300`.
+     * @prop --bs-chatbot-feedback-top-gap - Gap between heading/subtitle, stars, and the
+     * textarea/comment within the top block. Aliased to `--bs-spacing-250`.
+     * @prop --bs-chatbot-feedback-heading-color - Aliased to `--bs-text-default`.
+     * @prop --bs-chatbot-feedback-subtitle-color - Aliased to `--bs-text-secondary`.
+     * @prop --bs-chatbot-feedback-star-filled - Filled star color. Aliased to `--bs-color-primary-default`.
+     * @prop --bs-chatbot-feedback-star-empty - Empty star color. Aliased to `--bs-border-neutral-container`.
+     * @prop --bs-chatbot-feedback-comment-color - Submitted comment text color. Aliased to `--bs-text-default`.
+     * @prop --bs-chatbot-feedback-close-hover - Close button hover background. Aliased to `--bs-surface-hover`.
+     * @prop --bs-chatbot-feedback-primary-bg - "Submit feedback" / post-submit "Start new chat"
+     * background. Aliased to `--bs-button-primary-default`.
+     * @prop --bs-chatbot-feedback-primary-bg-hover - Aliased to `--bs-button-primary-hover`.
+     * @prop --bs-chatbot-feedback-primary-bg-disabled - Aliased to `--bs-button-primary-disabled`.
+     * @prop --bs-chatbot-feedback-outlined-border - Pre-submit "Start new chat" border. Aliased to
+     * `--bs-border-primary`.
+     * @prop --bs-chatbot-feedback-outlined-hover - Pre-submit "Start new chat" hover background.
+     * Aliased to `--bs-color-primary-container-hover`.
+     * @prop --bs-chatbot-feedback-outlined-text - Pre-submit "Start new chat" text/icon color.
+     * Aliased to `--bs-text-action`.
+     */
+    interface BsChatbotFeedback {
+        /**
+          * The comment text.
+          * @default ''
+         */
+        "comment": string;
+        /**
+          * Overrides the computed heading (see the class doc for why this is computed by default).
+         */
+        "heading"?: string;
+        /**
+          * Current star rating, 0-5. 0 means no rating has been given yet.
+          * @default 0
+         */
+        "rating": number;
+        /**
+          * Whether feedback has been submitted. Switches the card from the editable form to the read-only "thanks" view.
+          * @default false
+         */
+        "submitted": boolean;
+        /**
+          * Overrides the computed subtitle.
+         */
+        "subtitle"?: string;
+    }
     /**
      * The header bar that sits above `bs-composer` in a Genie AI chat panel: the Genie brand mark on
      * the left and four fixed actions (new chat, history, expand, close) on the right.
@@ -225,6 +439,45 @@ export namespace Components {
          */
         "sourcesCount"?: number;
     }
+    /**
+     * The "Sources" panel shown alongside a Genie AI chat response -- a header with a title, a count
+     * badge, and a collapse chevron, above a stack of `bs-source-link` citation rows.
+     * ## When to use
+     * - Displaying the documents/sources a Genie response cited, typically opened from a "view
+     *   sources" action on a `bs-chatbot-response-action` bar.
+     * ## When not to use
+     * - A generic list container -- this component's header (title + count + collapse) is
+     *   purpose-built for the sources use case.
+     * @prop --bs-chatbot-sources-drawer-bg - Background of the whole panel. Aliased to `--bs-surface-raised`.
+     * @prop --bs-chatbot-sources-drawer-header-shadow - Drop shadow under the header, separating it
+     * from the scrolled list. Aliased to `--bs-shadow-xs`.
+     * @prop --bs-chatbot-sources-drawer-header-padding-x - Aliased to `--bs-spacing-200`.
+     * @prop --bs-chatbot-sources-drawer-header-padding-top - Aliased to `--bs-spacing-150`.
+     * @prop --bs-chatbot-sources-drawer-header-padding-bottom - Aliased to `--bs-spacing-100`.
+     * @prop --bs-chatbot-sources-drawer-heading-color - Aliased to `--bs-text-default`.
+     * @prop --bs-chatbot-sources-drawer-count-bg - Count badge background. Aliased to
+     * `--bs-badge-bg-neutral-container`.
+     * @prop --bs-chatbot-sources-drawer-count-color - Count badge text color. Aliased to
+     * `--bs-badge-text-neutral`.
+     * @prop --bs-chatbot-sources-drawer-collapse-hover - Collapse button background on hover. Aliased
+     * to `--bs-surface-hover`.
+     * @prop --bs-chatbot-sources-drawer-section-gap - Gap between the header and the list. Aliased to
+     * `--bs-spacing-200`.
+     * @prop --bs-chatbot-sources-drawer-list-padding - Horizontal/bottom padding of the list. Aliased
+     * to `--bs-spacing-200`.
+     * @prop --bs-chatbot-sources-drawer-list-gap - Gap between rows. Aliased to `--bs-spacing-50`.
+     */
+    interface BsChatbotSourcesDrawer {
+        /**
+          * Overrides the auto-detected count badge. By default the badge reflects the number of slotted `bs-source-link` children, so most consumers don't need to set this.
+         */
+        "count"?: number;
+        /**
+          * The panel title.
+          * @default 'Sources'
+         */
+        "heading": string;
+    }
     /**
      * A pill-shaped clickable suggestion chip for a Genie AI chat panel (e.g. "How can I help you?").
      * One instance renders one chip -- to show several suggestion prompts side by side, render
@@ -321,6 +574,95 @@ export namespace Components {
          */
         "variant": BsComposerVariant;
     }
+    /**
+     * A full-width status banner for use directly above `bs-composer`, surfacing a message about the
+     * composer's current state (e.g. a send failure, an informational notice) with an optional
+     * "Continue"-style action button and an optional close button.
+     * ## When to use
+     * - A message tied to the composer itself (send failed, rate-limited, draft restored, etc.) that
+     *   needs to sit directly above it, not a general-purpose alert -- see `CONVENTIONS.md` if this
+     *   library gains a generic banner/alert component later, and prefer that instead once it exists.
+     * ## When not to use
+     * - A toast/snackbar notification unrelated to the composer -- this component is not
+     *   self-dismissing and has no positioning of its own (it's a static block, not an overlay).
+     * @prop --bs-composer-status-banner-radius - Corner radius of the top-left/top-right corners
+     * (bottom corners are square, so this sits flush above `bs-composer`). Aliased to
+     * `--bs-border-radius-150`.
+     * @prop --bs-composer-status-banner-padding-x - Horizontal padding. Aliased to `--bs-spacing-150`.
+     * @prop --bs-composer-status-banner-padding-top - Top padding. Aliased to `--bs-spacing-100`.
+     * @prop --bs-composer-status-banner-padding-bottom - Bottom padding. Aliased to `--bs-spacing-200`.
+     * @prop --bs-composer-status-banner-gap - Gap between the message group and the action/close
+     * controls. Aliased to `--bs-spacing-100`.
+     * @prop --bs-composer-status-banner-icon-gap - Gap between the icon and the message text.
+     * Aliased to `--bs-spacing-75`.
+     * @prop --bs-composer-status-banner-error-bg - Background for `type="error"`. Aliased to
+     * `--bs-color-error-container`.
+     * @prop --bs-composer-status-banner-error-text - Text/icon color for `type="error"`. Aliased to
+     * `--bs-text-error`.
+     * @prop --bs-composer-status-banner-error-action-bg - Action button background for
+     * `type="error"`. Aliased to `--bs-color-error-default`.
+     * @prop --bs-composer-status-banner-error-action-bg-hover - Aliased to `--bs-color-error-hover`.
+     * @prop --bs-composer-status-banner-info-bg - Background for `type="info"`. Aliased to
+     * `--bs-color-info-container`.
+     * @prop --bs-composer-status-banner-info-text - Text/icon color for `type="info"`. Aliased to
+     * `--bs-text-info`.
+     * @prop --bs-composer-status-banner-info-action-bg - Action button background for `type="info"`.
+     * Aliased to `--bs-color-info-default`.
+     * @prop --bs-composer-status-banner-info-action-bg-hover - Aliased to `--bs-color-info-hover`.
+     * @prop --bs-composer-status-banner-neutral-bg - Background for `type="neutral"`. Aliased to
+     * `--bs-color-neutral-container`.
+     * @prop --bs-composer-status-banner-neutral-text - Text/icon color for `type="neutral"`. Aliased
+     * to `--bs-text-default`.
+     * @prop --bs-composer-status-banner-neutral-action-bg - Action button background for
+     * `type="neutral"`. Aliased to `--bs-color-neutral-container`.
+     * @prop --bs-composer-status-banner-neutral-action-bg-hover - Aliased to
+     * `--bs-color-neutral-container-hover`.
+     * @prop --bs-composer-status-banner-neutral-action-border - Action button border for
+     * `type="neutral"` (the only variant whose action button is outlined). Aliased to
+     * `--bs-border-neutral-container`.
+     * @prop --bs-composer-status-banner-warning-bg - Background for `type="warning"`. Aliased to
+     * `--bs-color-warning-container`.
+     * @prop --bs-composer-status-banner-warning-text - Text/icon color for `type="warning"`. Aliased
+     * to `--bs-text-warning`.
+     * @prop --bs-composer-status-banner-warning-action-bg - Action button background for
+     * `type="warning"`. Aliased to `--bs-color-warning-default`.
+     * @prop --bs-composer-status-banner-warning-action-bg-hover - Aliased to
+     * `--bs-color-warning-hover`.
+     * @prop --bs-composer-status-banner-close-hover-bg - Close button hover background (same across
+     * every `type`). Aliased to `--bs-color-neutral-container-hover`.
+     */
+    interface BsComposerStatusBanner {
+        /**
+          * Label for the action button, only rendered when `showButton` is true.
+          * @default 'Continue'
+         */
+        "actionLabel": string;
+        /**
+          * Whether the close button is rendered.
+          * @default true
+         */
+        "allowClose": boolean;
+        /**
+          * The message text.
+          * @default 'This is a message'
+         */
+        "message": string;
+        /**
+          * Whether the "Continue"-style action button is rendered.
+          * @default false
+         */
+        "showButton": boolean;
+        /**
+          * Whether the leading icon (default: clock) is rendered.
+          * @default true
+         */
+        "showIcon": boolean;
+        /**
+          * Which severity/style to render. Drives background, text/icon color, and the action button's color.
+          * @default 'error'
+         */
+        "type": BsComposerStatusBannerType;
+    }
     /**
      * A sortable, optionally row-selectable table for tabular data.
      * `columns`, `rows`, and `cellRenderer` are JS-property-only — HTML attributes can only carry
@@ -358,29 +700,111 @@ export namespace Components {
         "sortDirection": 'asc' | 'desc';
     }
     /**
-     * A single-line text field with an optional label, description, and error state.
+     * A single-line text field with an optional label, description, and error state. Also covers a
+     * range of related "field" shapes (number stepper, password reveal, date, dropdown trigger,
+     * select, textarea, chip input, initials, country, and pin) via the `type` prop, since they all
+     * share the same label/description/error/icon-slot chrome.
      * ## When to use
      * - Collecting a single line of free-text, email, password, or numeric input.
+     * - Any of the other supported `type`s (search, date, dropdown, select, textarea, chip, initials,
+     *   country, pin) that share this component's label/description/error chrome.
      * - Pair with `error` for inline validation feedback tied to that specific field.
      * ## When not to use
-     * - Multi-line text — this component has no `textarea` mode.
-     * - A fixed set of choices — use a select/radio/checkbox component instead of free text.
+     * - A fixed set of choices best served by a dedicated radio/checkbox group rather than a single
+     *   field. `type="select"` (native `<select>`) and `type="dropdown"` (a `bs-menu` of
+     *   `bs-menu-item`s from the `options` prop) cover the field-shaped cases; `type="chip"` has no
+     *   options list at all (freeform chip entry).
      */
     interface BsInput {
+        /**
+          * Current chips for `type="chip"`. Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
+          * @default []
+         */
+        "chips": string[];
+        /**
+          * Current selected country code for `type="country"`.
+          * @default ''
+         */
+        "country": string;
+        /**
+          * Country select options for `type="country"`. Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
+          * @default []
+         */
+        "countryOptions": { code: string; label: string; flagIcon?: string }[];
         "description"?: string;
         /**
           * @default false
          */
         "disabled": boolean;
         "error"?: string;
+        /**
+          * Current selected title for `type="initials"`. Named `initialsTitle` rather than `title` -- `title` is a reserved standard HTML attribute (tooltip text) inherited by every element, and Stencil warns against shadowing it with a component `@Prop`.
+          * @default ''
+         */
+        "initialsTitle": string;
         "label"?: string;
+        /**
+          * Number of cells for `type="pin"`.
+          * @default 4
+         */
+        "length": number;
+        /**
+          * Maximum value for `type="number"`'s stepper buttons.
+         */
+        "max"?: number;
+        /**
+          * Minimum value for `type="number"`'s stepper buttons.
+         */
+        "min"?: number;
+        /**
+          * Whether the `type="dropdown"` trigger is open. Reflects to an attribute so consumers can style an open state via CSS. When `options` is non-empty, this also controls whether the `bs-menu` of `bs-menu-item`s is rendered below the field.
+          * @default false
+         */
+        "open": boolean;
+        /**
+          * Options for `type="select"` (rendered as native `<option>`s) and `type="dropdown"` (rendered as a `bs-menu` of `bs-menu-item`s when `open`). Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
+          * @default []
+         */
+        "options": { label: string; value: string }[];
         "placeholder"?: string;
         /**
-          * @default 'text'
+          * Marks the field as required: renders a red `*` after the label and sets `aria-required="true"` on the control. Applies regardless of `type`.
+          * @default false
+         */
+        "required": boolean;
+        /**
+          * Number of visible rows for `type="textarea"`.
+          * @default 3
+         */
+        "rows": number;
+        /**
+          * Step size for `type="number"`'s increment/decrement stepper buttons.
+          * @default 1
          */
-        "type": 'text' | 'email' | 'password' | 'number';
+        "step": number;
         /**
-          * Current value. Native `input`/`change` events don't cross the Shadow DOM boundary, so this component re-dispatches them as `bsInput`/`bsChange` custom events instead.
+          * Title select options for `type="initials"` (e.g. `['Mrs.', 'Mr.', 'Dr.']`). Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
+          * @default []
+         */
+        "titleOptions": string[];
+        /**
+          * @default 'text'
+         */
+        "type": | 'text'
+    | 'email'
+    | 'password'
+    | 'number'
+    | 'search'
+    | 'date'
+    | 'dropdown'
+    | 'select'
+    | 'textarea'
+    | 'chip'
+    | 'initials'
+    | 'country'
+    | 'pin';
+        /**
+          * Current value. Native `input`/`change` events don't cross the Shadow DOM boundary, so this component re-dispatches them as `bsInput`/`bsChange` custom events instead. Mutable so the `number` type's stepper buttons can update it directly.
           * @default ''
          */
         "value": string;
@@ -446,6 +870,55 @@ export namespace Components {
          */
         "size": BsModalSize;
     }
+    /**
+     * A single citation row inside `bs-chatbot-sources-drawer` -- a file icon + filename on the first
+     * line, the originating system and version on the second, and a trailing "open" arrow.
+     * ## When to use
+     * - One row per source Genie cited in a response, slotted into `bs-chatbot-sources-drawer`.
+     * ## When not to use
+     * - Outside the sources drawer context -- this is a purpose-built citation row, not a generic
+     *   link/list-item component.
+     * @prop --bs-source-link-radius - Corner radius of the row. Aliased to `--bs-border-radius-150`.
+     * @prop --bs-source-link-padding - Padding around the row. Aliased to `--bs-spacing-150`.
+     * @prop --bs-source-link-gap - Gap between the filename+meta block and the trailing arrow.
+     * Aliased to `--bs-spacing-50`.
+     * @prop --bs-source-link-icon-gap - Gap between the leading icon and the filename text. Aliased
+     * to `--bs-spacing-75`.
+     * @prop --bs-source-link-hover - Row background on hover/focus. Aliased to `--bs-surface-hover`.
+     * @prop --bs-source-link-pressed - Row background while active/pressed. Aliased to
+     * `--bs-surface-pressed`.
+     * @prop --bs-source-link-focus - Focus-visible outline color. Aliased to
+     * `--bs-border-neutral-focus`.
+     * @prop --bs-source-link-filename-color - Filename text color. Aliased to `--bs-text-default`.
+     * @prop --bs-source-link-meta-color - Source/version text color. Aliased to `--bs-text-secondary`.
+     * @prop --bs-source-link-icon-color - File icon and arrow color. Aliased to `--bs-icon-default`.
+     * @prop --bs-source-link-dot-color - Separator dot between source and version. Aliased to
+     * `--bs-text-secondary`.
+     */
+    interface BsSourceLink {
+        /**
+          * The cited document's filename.
+          * @default 'Source'
+         */
+        "fileName": string;
+        /**
+          * If set, renders the row as a link that opens this URL; otherwise as a button that only emits `bsOpen`.
+         */
+        "href"?: string;
+        /**
+          * The system/app the document came from (e.g. "HoltePortalen").
+         */
+        "sourceName"?: string;
+        /**
+          * `target` used when `href` is set.
+          * @default '_blank'
+         */
+        "target": string;
+        /**
+          * The document's version label (e.g. "v3.2"). Omit if the source has no version.
+         */
+        "version"?: string;
+    }
     /**
      * A dark tooltip bubble with a pointer arrow, used to surface a short hint of extra information
      * next to a trigger element.
@@ -481,6 +954,14 @@ export namespace Components {
         "placement": 'top';
     }
 }
+export interface BsAttachmentCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsAttachmentElement;
+}
+export interface BsChatbotFeedbackCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsChatbotFeedbackElement;
+}
 export interface BsChatbotHeaderCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsChatbotHeaderElement;
@@ -489,6 +970,10 @@ export interface BsChatbotResponseActionCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsChatbotResponseActionElement;
 }
+export interface BsChatbotSourcesDrawerCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsChatbotSourcesDrawerElement;
+}
 export interface BsChatbotSuggestionButtonCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsChatbotSuggestionButtonElement;
@@ -497,6 +982,10 @@ export interface BsComposerCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsComposerElement;
 }
+export interface BsComposerStatusBannerCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsComposerStatusBannerElement;
+}
 export interface BsDataTableCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsDataTableElement;
@@ -513,27 +1002,87 @@ export interface BsModalCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsModalElement;
 }
+export interface BsSourceLinkCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsSourceLinkElement;
+}
 declare global {
+    /**
+     * A centered caption disclaimer for Genie AI surfaces, e.g. "AI can make mistakes. Please verify
+     * important information."
+     * ## When to use
+     * - Below or above `bs-composer` in a Genie AI chat panel, to remind users AI output can be wrong.
+     * ## When not to use
+     * - A general-purpose caption/helper text — use plain text or `bs-input`'s description slot for
+     *   non-AI-related helper copy.
+     * The default slot (rather than a fixed prop) is intentional: Figma only specifies plain text, but
+     * some consuming apps link out to a policy/help page from this copy, and a slot supports that
+     * without inventing an unconfirmed `href`/link prop.
+     * @prop --bs-ai-disclaimer-padding-x - Horizontal padding. Aliased to `--bs-spacing-200`.
+     * @prop --bs-ai-disclaimer-text-color - Text color. Aliased to `--bs-text-secondary`.
+     * @prop --bs-ai-disclaimer-font-size - Text font size. Aliased to `--bs-font-size-sm`.
+     * @prop --bs-ai-disclaimer-line-height - Text line height. Aliased to `--bs-line-height-body-sm`.
+     */
+    interface HTMLBsAiDisclaimerElement extends Components.BsAiDisclaimer, HTMLStencilElement {
+    }
+    var HTMLBsAiDisclaimerElement: {
+        prototype: HTMLBsAiDisclaimerElement;
+        new (): HTMLBsAiDisclaimerElement;
+    };
+    /**
+     * The centered welcome heading shown at the top of an empty Genie AI chat panel, e.g.
+     * "Hi. I'm Genie, your AI assistant." + "How can I help you with [product] today?"
+     * ## When to use
+     * - The empty/initial state of a Genie AI chat panel, before the user has sent a message.
+     * ## When not to use
+     * - Once a conversation has started -- this is a one-time empty-state greeting, not a persistent
+     *   header (see `bs-chatbot-header` for that).
+     * `productName` is optional: Figma's copy has a `[product_name]` placeholder the consuming app is
+     * expected to fill in, but a component shouldn't force a product name to exist, so leaving it
+     * unset falls back to a product-agnostic "How can I help you today?".
+     * @prop --bs-ai-greeting-gap - Gap between heading and subtext. Aliased to `--bs-spacing-200`.
+     * @prop --bs-ai-greeting-max-width - Max width of the centered content block. Matches Figma's
+     * 490px.
+     * @prop --bs-ai-greeting-heading-color - Heading text color. Aliased to `--bs-text-default`.
+     * @prop --bs-ai-greeting-heading-font-size - Heading font size. Aliased to `--bs-font-size-4xl`.
+     * @prop --bs-ai-greeting-heading-line-height - Heading line height. Figma specifies 28px, which
+     * doesn't match any `--bs-line-height-heading-*` token (h4 is 32) -- aliased directly to
+     * `--bs-line-height-body-lg`, the token that happens to share the same numeric value.
+     * @prop --bs-ai-greeting-heading-weight - Heading font weight. Aliased to `--bs-font-weight-bold`.
+     * @prop --bs-ai-greeting-heading-gap - Gap between the two heading lines. Aliased to
+     * `--bs-spacing-200`.
+     * @prop --bs-ai-greeting-subtext-color - Subtext color. Aliased to `--bs-text-secondary`.
+     * @prop --bs-ai-greeting-subtext-font-size - Subtext font size. Figma specifies 20px, which
+     * doesn't match the semantic `--bs-text-style-body-lg-size` (18px) -- aliased directly to the
+     * raw `--bs-font-size-xl` primitive instead.
+     * @prop --bs-ai-greeting-subtext-line-height - Subtext line height. Aliased to
+     * `--bs-line-height-body-lg`.
+     */
+    interface HTMLBsAiGreetingElement extends Components.BsAiGreeting, HTMLStencilElement {
+    }
+    var HTMLBsAiGreetingElement: {
+        prototype: HTMLBsAiGreetingElement;
+        new (): HTMLBsAiGreetingElement;
+    };
     /**
      * A small inline status indicator for Genie AI surfaces: the colorful Genie mark next to a label
-     * (e.g. "Retrieving", "Thinking", "Searching") whose text pulses in a slow breathing loop while
-     * an operation is in progress.
+     * (e.g. "Retrieving", "Thinking", "Searching") whose text shimmers with a moving highlight band
+     * while an operation is in progress.
      * ## When to use
      * - Inline in a Genie AI chat transcript to show what the assistant is currently doing while a
      *   response is being generated (retrieving context, searching, thinking).
      * ## When not to use
      * - A blocking/full-panel loading state -- this is a small inline indicator, not a spinner overlay.
-     * The label's pulse animation reproduces Figma's exact keyframe track (a plain opacity
-     * fade-in/hold/reset with the source's own cubic-bezier easing) rather than an invented
-     * shimmer-sweep -- the source design only specifies this one animation.
      * @prop --bs-ai-thinking-gap - Gap between icon and label. Aliased to `--bs-spacing-100`.
      * @prop --bs-ai-thinking-icon-size - Width/height of the icon.
-     * @prop --bs-ai-thinking-text - Label color. Aliased to `--bs-text-muted`.
+     * @prop --bs-ai-thinking-text - Label base color. Aliased to `--bs-text-muted`.
+     * @prop --bs-ai-thinking-shimmer-highlight - Color of the moving highlight band. Aliased to
+     * `--bs-text-default` (more prominent than `--bs-text-muted` in both themes).
      * @prop --bs-ai-thinking-font-size - Label font size. Aliased to `--bs-font-size-md`.
      * @prop --bs-ai-thinking-line-height - Label line height. Aliased to `--bs-line-height-body-md`.
-     * @prop --bs-ai-thinking-cycle-duration - Duration of one pulse loop. Figma specifies exactly 2s,
-     * longer than any `--bs-duration-*` token (max `--bs-duration-slower` is 500ms), so this is
-     * aliased directly to the literal value.
+     * @prop --bs-ai-thinking-cycle-duration - Duration of one shimmer sweep. Figma's own keyframe
+     * track for this label runs over exactly 2s, longer than any `--bs-duration-*` token (max
+     * `--bs-duration-slower` is 500ms), so this is aliased directly to the literal value.
      */
     interface HTMLBsAiThinkingElement extends Components.BsAiThinking, HTMLStencilElement {
     }
@@ -541,6 +1090,78 @@ declare global {
         prototype: HTMLBsAiThinkingElement;
         new (): HTMLBsAiThinkingElement;
     };
+    interface HTMLBsAttachmentElementEventMap {
+        "bsRemove": void;
+    }
+    /**
+     * A single file attachment preview for `bs-composer` -- an image thumbnail, or a filename card
+     * with a colored file-type badge (PDF/Document), with an optional upload-in-progress spinner and
+     * a hover/focus-revealed remove button.
+     * ## When to use
+     * - Rendered by the consuming app for each file a user has attached to a Genie AI chat message,
+     *   typically alongside or inside `bs-composer`.
+     * ## When not to use
+     * - A generic file-upload control -- this is a preview-only presentational component. The
+     *   consuming app owns the actual file picker/upload logic and drives `loading` from that state.
+     * @prop --bs-attachment-size - Width/height of the image thumbnail and of the card. Defaults to 112px.
+     * @prop --bs-attachment-radius - Corner radius of the thumbnail/card. Aliased to
+     * `--bs-border-radius-100`.
+     * @prop --bs-attachment-border-color - Border color of the card / loading image wrap. Aliased to
+     * `--bs-border-default`.
+     * @prop --bs-attachment-card-bg - Card background. Aliased to `--bs-surface-base`.
+     * @prop --bs-attachment-filename-color - Filename text color. Aliased to `--bs-text-default`.
+     * @prop --bs-attachment-badge-bg-pdf - PDF badge background. Aliased to `--bs-badge-bg-error`.
+     * @prop --bs-attachment-badge-bg-document - Document badge background. Aliased to
+     * `--bs-badge-bg-info`.
+     * @prop --bs-attachment-remove-bg - Remove button (neutral icon button) default background.
+     * Aliased to `--bs-button-neutral-container`.
+     * @prop --bs-attachment-remove-hover - Remove button hover background. Aliased to
+     * `--bs-button-neutral-hover`.
+     * @prop --bs-attachment-remove-pressed - Remove button active/pressed background. Aliased to
+     * `--bs-button-neutral-pressed`.
+     * @prop --bs-attachment-remove-focus - Remove button focus outline color. Aliased to
+     * `--bs-border-neutral-focus`.
+     */
+    interface HTMLBsAttachmentElement extends Components.BsAttachment, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsAttachmentElementEventMap>(type: K, listener: (this: HTMLBsAttachmentElement, ev: BsAttachmentCustomEvent<HTMLBsAttachmentElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLBsAttachmentElementEventMap>(type: K, listener: (this: HTMLBsAttachmentElement, ev: BsAttachmentCustomEvent<HTMLBsAttachmentElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLBsAttachmentElement: {
+        prototype: HTMLBsAttachmentElement;
+        new (): HTMLBsAttachmentElement;
+    };
+    /**
+     * A horizontally-scrolling row wrapper for one or more `bs-attachment` previews, for slotting into
+     * `bs-composer`'s `attachments` slot when a Genie AI chat message has file attachments.
+     * ## When to use
+     * - Wrapping any number of `bs-attachment` elements the user has attached to a message, so they
+     *   lay out in a single row and scroll horizontally instead of wrapping/overflowing once there
+     *   are more than fit the available width.
+     * ## When not to use
+     * - A single attachment on its own — just render `bs-attachment` directly, this wrapper's
+     *   scroll/fade affordance only matters once there's more content than fits.
+     * @prop --bs-attachment-list-gap - Gap between attachments. Matches the 10px Figma spec (not tied
+     * to the `--bs-spacing-*` scale, which only has 8px/12px neighbors).
+     * @prop --bs-attachment-list-padding - Padding around the row. Aliased to `--bs-spacing-150`.
+     * @prop --bs-attachment-list-fade-color - Color the right-edge fade blends into. Aliased to
+     * `--bs-static-white`.
+     * @prop --bs-attachment-list-fade-width - Width of the right-edge fade overlay. Aliased to
+     * `--bs-spacing-800`.
+     * @prop --bs-attachment-list-scrollbar-thumb - Color of the scrollbar thumb that appears on
+     * hover/focus once the row is scrollable. Aliased to `--bs-neutral-300`.
+     */
+    interface HTMLBsAttachmentListElement extends Components.BsAttachmentList, HTMLStencilElement {
+    }
+    var HTMLBsAttachmentListElement: {
+        prototype: HTMLBsAttachmentListElement;
+        new (): HTMLBsAttachmentListElement;
+    };
     /**
      * A small status or category pill, usually paired with a label or list item.
      * ## When to use
@@ -620,6 +1241,68 @@ declare global {
         prototype: HTMLBsCardElement;
         new (): HTMLBsCardElement;
     };
+    interface HTMLBsChatbotFeedbackElementEventMap {
+        "bsRatingChange": number;
+        "bsCommentInput": string;
+        "bsSubmit": { rating: number; comment: string };
+        "bsNewChat": void;
+        "bsClose": void;
+    }
+    /**
+     * A star-rating feedback card shown at the end of a Genie AI chat: a heading/subtitle, a 5-star
+     * rating, an optional comment, and either "Submit feedback" + "Start new chat" (before
+     * submitting) or just "Start new chat" (after).
+     * ## When to use
+     * - Prompting for feedback on a Genie response or chat session, typically after the user ends or
+     *   restarts a conversation.
+     * ## When not to use
+     * - A generic star-rating input elsewhere in the product -- this component's copy and layout are
+     *   purpose-built for the Genie feedback flow, not a reusable rating control.
+     * The heading and subtitle are not freeform props: before submitting, they're always the fixed
+     * "How was your experience..." copy; after submitting, they're determined entirely by `rating`
+     * (1-2 stars reads apologetic, 3 neutral, 4-5 positive), matching the Figma source exactly. Use
+     * `heading`/`subtitle` only if a consuming app genuinely needs to override that copy.
+     * @prop --bs-chatbot-feedback-bg - Card background. Aliased to `--bs-surface-raised`.
+     * @prop --bs-chatbot-feedback-border - Card border color. Aliased to `--bs-border-default`.
+     * @prop --bs-chatbot-feedback-radius - Card corner radius. Aliased to `--bs-border-radius-200`.
+     * @prop --bs-chatbot-feedback-padding-x - Card horizontal padding. Aliased to `--bs-spacing-250`.
+     * @prop --bs-chatbot-feedback-padding-y - Card vertical padding. Aliased to `--bs-spacing-550`.
+     * @prop --bs-chatbot-feedback-max-width - Max width of the card. Matches Figma's 762px.
+     * @prop --bs-chatbot-feedback-gap - Gap between the top content block and the button(s). Aliased
+     * to `--bs-spacing-300`.
+     * @prop --bs-chatbot-feedback-top-gap - Gap between heading/subtitle, stars, and the
+     * textarea/comment within the top block. Aliased to `--bs-spacing-250`.
+     * @prop --bs-chatbot-feedback-heading-color - Aliased to `--bs-text-default`.
+     * @prop --bs-chatbot-feedback-subtitle-color - Aliased to `--bs-text-secondary`.
+     * @prop --bs-chatbot-feedback-star-filled - Filled star color. Aliased to `--bs-color-primary-default`.
+     * @prop --bs-chatbot-feedback-star-empty - Empty star color. Aliased to `--bs-border-neutral-container`.
+     * @prop --bs-chatbot-feedback-comment-color - Submitted comment text color. Aliased to `--bs-text-default`.
+     * @prop --bs-chatbot-feedback-close-hover - Close button hover background. Aliased to `--bs-surface-hover`.
+     * @prop --bs-chatbot-feedback-primary-bg - "Submit feedback" / post-submit "Start new chat"
+     * background. Aliased to `--bs-button-primary-default`.
+     * @prop --bs-chatbot-feedback-primary-bg-hover - Aliased to `--bs-button-primary-hover`.
+     * @prop --bs-chatbot-feedback-primary-bg-disabled - Aliased to `--bs-button-primary-disabled`.
+     * @prop --bs-chatbot-feedback-outlined-border - Pre-submit "Start new chat" border. Aliased to
+     * `--bs-border-primary`.
+     * @prop --bs-chatbot-feedback-outlined-hover - Pre-submit "Start new chat" hover background.
+     * Aliased to `--bs-color-primary-container-hover`.
+     * @prop --bs-chatbot-feedback-outlined-text - Pre-submit "Start new chat" text/icon color.
+     * Aliased to `--bs-text-action`.
+     */
+    interface HTMLBsChatbotFeedbackElement extends Components.BsChatbotFeedback, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsChatbotFeedbackElementEventMap>(type: K, listener: (this: HTMLBsChatbotFeedbackElement, ev: BsChatbotFeedbackCustomEvent<HTMLBsChatbotFeedbackElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLBsChatbotFeedbackElementEventMap>(type: K, listener: (this: HTMLBsChatbotFeedbackElement, ev: BsChatbotFeedbackCustomEvent<HTMLBsChatbotFeedbackElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLBsChatbotFeedbackElement: {
+        prototype: HTMLBsChatbotFeedbackElement;
+        new (): HTMLBsChatbotFeedbackElement;
+    };
     interface HTMLBsChatbotHeaderElementEventMap {
         "bsNewChat": void;
         "bsHistory": void;
@@ -713,6 +1396,51 @@ declare global {
         prototype: HTMLBsChatbotResponseActionElement;
         new (): HTMLBsChatbotResponseActionElement;
     };
+    interface HTMLBsChatbotSourcesDrawerElementEventMap {
+        "bsCollapse": void;
+    }
+    /**
+     * The "Sources" panel shown alongside a Genie AI chat response -- a header with a title, a count
+     * badge, and a collapse chevron, above a stack of `bs-source-link` citation rows.
+     * ## When to use
+     * - Displaying the documents/sources a Genie response cited, typically opened from a "view
+     *   sources" action on a `bs-chatbot-response-action` bar.
+     * ## When not to use
+     * - A generic list container -- this component's header (title + count + collapse) is
+     *   purpose-built for the sources use case.
+     * @prop --bs-chatbot-sources-drawer-bg - Background of the whole panel. Aliased to `--bs-surface-raised`.
+     * @prop --bs-chatbot-sources-drawer-header-shadow - Drop shadow under the header, separating it
+     * from the scrolled list. Aliased to `--bs-shadow-xs`.
+     * @prop --bs-chatbot-sources-drawer-header-padding-x - Aliased to `--bs-spacing-200`.
+     * @prop --bs-chatbot-sources-drawer-header-padding-top - Aliased to `--bs-spacing-150`.
+     * @prop --bs-chatbot-sources-drawer-header-padding-bottom - Aliased to `--bs-spacing-100`.
+     * @prop --bs-chatbot-sources-drawer-heading-color - Aliased to `--bs-text-default`.
+     * @prop --bs-chatbot-sources-drawer-count-bg - Count badge background. Aliased to
+     * `--bs-badge-bg-neutral-container`.
+     * @prop --bs-chatbot-sources-drawer-count-color - Count badge text color. Aliased to
+     * `--bs-badge-text-neutral`.
+     * @prop --bs-chatbot-sources-drawer-collapse-hover - Collapse button background on hover. Aliased
+     * to `--bs-surface-hover`.
+     * @prop --bs-chatbot-sources-drawer-section-gap - Gap between the header and the list. Aliased to
+     * `--bs-spacing-200`.
+     * @prop --bs-chatbot-sources-drawer-list-padding - Horizontal/bottom padding of the list. Aliased
+     * to `--bs-spacing-200`.
+     * @prop --bs-chatbot-sources-drawer-list-gap - Gap between rows. Aliased to `--bs-spacing-50`.
+     */
+    interface HTMLBsChatbotSourcesDrawerElement extends Components.BsChatbotSourcesDrawer, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsChatbotSourcesDrawerElementEventMap>(type: K, listener: (this: HTMLBsChatbotSourcesDrawerElement, ev: BsChatbotSourcesDrawerCustomEvent<HTMLBsChatbotSourcesDrawerElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLBsChatbotSourcesDrawerElementEventMap>(type: K, listener: (this: HTMLBsChatbotSourcesDrawerElement, ev: BsChatbotSourcesDrawerCustomEvent<HTMLBsChatbotSourcesDrawerElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLBsChatbotSourcesDrawerElement: {
+        prototype: HTMLBsChatbotSourcesDrawerElement;
+        new (): HTMLBsChatbotSourcesDrawerElement;
+    };
     interface HTMLBsChatbotSuggestionButtonElementEventMap {
         "bsSelect": void;
     }
@@ -815,6 +1543,81 @@ declare global {
         prototype: HTMLBsComposerElement;
         new (): HTMLBsComposerElement;
     };
+    interface HTMLBsComposerStatusBannerElementEventMap {
+        "bsAction": void;
+        "bsClose": void;
+    }
+    /**
+     * A full-width status banner for use directly above `bs-composer`, surfacing a message about the
+     * composer's current state (e.g. a send failure, an informational notice) with an optional
+     * "Continue"-style action button and an optional close button.
+     * ## When to use
+     * - A message tied to the composer itself (send failed, rate-limited, draft restored, etc.) that
+     *   needs to sit directly above it, not a general-purpose alert -- see `CONVENTIONS.md` if this
+     *   library gains a generic banner/alert component later, and prefer that instead once it exists.
+     * ## When not to use
+     * - A toast/snackbar notification unrelated to the composer -- this component is not
+     *   self-dismissing and has no positioning of its own (it's a static block, not an overlay).
+     * @prop --bs-composer-status-banner-radius - Corner radius of the top-left/top-right corners
+     * (bottom corners are square, so this sits flush above `bs-composer`). Aliased to
+     * `--bs-border-radius-150`.
+     * @prop --bs-composer-status-banner-padding-x - Horizontal padding. Aliased to `--bs-spacing-150`.
+     * @prop --bs-composer-status-banner-padding-top - Top padding. Aliased to `--bs-spacing-100`.
+     * @prop --bs-composer-status-banner-padding-bottom - Bottom padding. Aliased to `--bs-spacing-200`.
+     * @prop --bs-composer-status-banner-gap - Gap between the message group and the action/close
+     * controls. Aliased to `--bs-spacing-100`.
+     * @prop --bs-composer-status-banner-icon-gap - Gap between the icon and the message text.
+     * Aliased to `--bs-spacing-75`.
+     * @prop --bs-composer-status-banner-error-bg - Background for `type="error"`. Aliased to
+     * `--bs-color-error-container`.
+     * @prop --bs-composer-status-banner-error-text - Text/icon color for `type="error"`. Aliased to
+     * `--bs-text-error`.
+     * @prop --bs-composer-status-banner-error-action-bg - Action button background for
+     * `type="error"`. Aliased to `--bs-color-error-default`.
+     * @prop --bs-composer-status-banner-error-action-bg-hover - Aliased to `--bs-color-error-hover`.
+     * @prop --bs-composer-status-banner-info-bg - Background for `type="info"`. Aliased to
+     * `--bs-color-info-container`.
+     * @prop --bs-composer-status-banner-info-text - Text/icon color for `type="info"`. Aliased to
+     * `--bs-text-info`.
+     * @prop --bs-composer-status-banner-info-action-bg - Action button background for `type="info"`.
+     * Aliased to `--bs-color-info-default`.
+     * @prop --bs-composer-status-banner-info-action-bg-hover - Aliased to `--bs-color-info-hover`.
+     * @prop --bs-composer-status-banner-neutral-bg - Background for `type="neutral"`. Aliased to
+     * `--bs-color-neutral-container`.
+     * @prop --bs-composer-status-banner-neutral-text - Text/icon color for `type="neutral"`. Aliased
+     * to `--bs-text-default`.
+     * @prop --bs-composer-status-banner-neutral-action-bg - Action button background for
+     * `type="neutral"`. Aliased to `--bs-color-neutral-container`.
+     * @prop --bs-composer-status-banner-neutral-action-bg-hover - Aliased to
+     * `--bs-color-neutral-container-hover`.
+     * @prop --bs-composer-status-banner-neutral-action-border - Action button border for
+     * `type="neutral"` (the only variant whose action button is outlined). Aliased to
+     * `--bs-border-neutral-container`.
+     * @prop --bs-composer-status-banner-warning-bg - Background for `type="warning"`. Aliased to
+     * `--bs-color-warning-container`.
+     * @prop --bs-composer-status-banner-warning-text - Text/icon color for `type="warning"`. Aliased
+     * to `--bs-text-warning`.
+     * @prop --bs-composer-status-banner-warning-action-bg - Action button background for
+     * `type="warning"`. Aliased to `--bs-color-warning-default`.
+     * @prop --bs-composer-status-banner-warning-action-bg-hover - Aliased to
+     * `--bs-color-warning-hover`.
+     * @prop --bs-composer-status-banner-close-hover-bg - Close button hover background (same across
+     * every `type`). Aliased to `--bs-color-neutral-container-hover`.
+     */
+    interface HTMLBsComposerStatusBannerElement extends Components.BsComposerStatusBanner, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsComposerStatusBannerElementEventMap>(type: K, listener: (this: HTMLBsComposerStatusBannerElement, ev: BsComposerStatusBannerCustomEvent<HTMLBsComposerStatusBannerElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLBsComposerStatusBannerElementEventMap>(type: K, listener: (this: HTMLBsComposerStatusBannerElement, ev: BsComposerStatusBannerCustomEvent<HTMLBsComposerStatusBannerElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLBsComposerStatusBannerElement: {
+        prototype: HTMLBsComposerStatusBannerElement;
+        new (): HTMLBsComposerStatusBannerElement;
+    };
     interface HTMLBsDataTableElementEventMap {
         "bsSort": { column: string; direction: 'asc' | 'desc' };
         "bsRowSelect": { id: string | number; selected: boolean };
@@ -847,15 +1650,27 @@ declare global {
     interface HTMLBsInputElementEventMap {
         "bsInput": string;
         "bsChange": string;
+        "bsOpen": boolean;
+        "bsChipAdd": string;
+        "bsChipRemove": string;
+        "bsTitleChange": string;
+        "bsCountryChange": string;
     }
     /**
-     * A single-line text field with an optional label, description, and error state.
+     * A single-line text field with an optional label, description, and error state. Also covers a
+     * range of related "field" shapes (number stepper, password reveal, date, dropdown trigger,
+     * select, textarea, chip input, initials, country, and pin) via the `type` prop, since they all
+     * share the same label/description/error/icon-slot chrome.
      * ## When to use
      * - Collecting a single line of free-text, email, password, or numeric input.
+     * - Any of the other supported `type`s (search, date, dropdown, select, textarea, chip, initials,
+     *   country, pin) that share this component's label/description/error chrome.
      * - Pair with `error` for inline validation feedback tied to that specific field.
      * ## When not to use
-     * - Multi-line text — this component has no `textarea` mode.
-     * - A fixed set of choices — use a select/radio/checkbox component instead of free text.
+     * - A fixed set of choices best served by a dedicated radio/checkbox group rather than a single
+     *   field. `type="select"` (native `<select>`) and `type="dropdown"` (a `bs-menu` of
+     *   `bs-menu-item`s from the `options` prop) cover the field-shaped cases; `type="chip"` has no
+     *   options list at all (freeform chip entry).
      */
     interface HTMLBsInputElement extends Components.BsInput, HTMLStencilElement {
         addEventListener<K extends keyof HTMLBsInputElementEventMap>(type: K, listener: (this: HTMLBsInputElement, ev: BsInputCustomEvent<HTMLBsInputElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -956,6 +1771,48 @@ declare global {
         prototype: HTMLBsModalElement;
         new (): HTMLBsModalElement;
     };
+    interface HTMLBsSourceLinkElementEventMap {
+        "bsOpen": void;
+    }
+    /**
+     * A single citation row inside `bs-chatbot-sources-drawer` -- a file icon + filename on the first
+     * line, the originating system and version on the second, and a trailing "open" arrow.
+     * ## When to use
+     * - One row per source Genie cited in a response, slotted into `bs-chatbot-sources-drawer`.
+     * ## When not to use
+     * - Outside the sources drawer context -- this is a purpose-built citation row, not a generic
+     *   link/list-item component.
+     * @prop --bs-source-link-radius - Corner radius of the row. Aliased to `--bs-border-radius-150`.
+     * @prop --bs-source-link-padding - Padding around the row. Aliased to `--bs-spacing-150`.
+     * @prop --bs-source-link-gap - Gap between the filename+meta block and the trailing arrow.
+     * Aliased to `--bs-spacing-50`.
+     * @prop --bs-source-link-icon-gap - Gap between the leading icon and the filename text. Aliased
+     * to `--bs-spacing-75`.
+     * @prop --bs-source-link-hover - Row background on hover/focus. Aliased to `--bs-surface-hover`.
+     * @prop --bs-source-link-pressed - Row background while active/pressed. Aliased to
+     * `--bs-surface-pressed`.
+     * @prop --bs-source-link-focus - Focus-visible outline color. Aliased to
+     * `--bs-border-neutral-focus`.
+     * @prop --bs-source-link-filename-color - Filename text color. Aliased to `--bs-text-default`.
+     * @prop --bs-source-link-meta-color - Source/version text color. Aliased to `--bs-text-secondary`.
+     * @prop --bs-source-link-icon-color - File icon and arrow color. Aliased to `--bs-icon-default`.
+     * @prop --bs-source-link-dot-color - Separator dot between source and version. Aliased to
+     * `--bs-text-secondary`.
+     */
+    interface HTMLBsSourceLinkElement extends Components.BsSourceLink, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsSourceLinkElementEventMap>(type: K, listener: (this: HTMLBsSourceLinkElement, ev: BsSourceLinkCustomEvent<HTMLBsSourceLinkElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLBsSourceLinkElementEventMap>(type: K, listener: (this: HTMLBsSourceLinkElement, ev: BsSourceLinkCustomEvent<HTMLBsSourceLinkElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLBsSourceLinkElement: {
+        prototype: HTMLBsSourceLinkElement;
+        new (): HTMLBsSourceLinkElement;
+    };
     /**
      * A dark tooltip bubble with a pointer arrow, used to surface a short hint of extra information
      * next to a trigger element.
@@ -990,44 +1847,109 @@ declare global {
         new (): HTMLBsTooltipElement;
     };
     interface HTMLElementTagNameMap {
+        "bs-ai-disclaimer": HTMLBsAiDisclaimerElement;
+        "bs-ai-greeting": HTMLBsAiGreetingElement;
         "bs-ai-thinking": HTMLBsAiThinkingElement;
+        "bs-attachment": HTMLBsAttachmentElement;
+        "bs-attachment-list": HTMLBsAttachmentListElement;
         "bs-badge": HTMLBsBadgeElement;
         "bs-button": HTMLBsButtonElement;
         "bs-button-skeleton": HTMLBsButtonSkeletonElement;
         "bs-card": HTMLBsCardElement;
+        "bs-chatbot-feedback": HTMLBsChatbotFeedbackElement;
         "bs-chatbot-header": HTMLBsChatbotHeaderElement;
         "bs-chatbot-response-action": HTMLBsChatbotResponseActionElement;
+        "bs-chatbot-sources-drawer": HTMLBsChatbotSourcesDrawerElement;
         "bs-chatbot-suggestion-button": HTMLBsChatbotSuggestionButtonElement;
         "bs-composer": HTMLBsComposerElement;
+        "bs-composer-status-banner": HTMLBsComposerStatusBannerElement;
         "bs-data-table": HTMLBsDataTableElement;
         "bs-input": HTMLBsInputElement;
         "bs-menu": HTMLBsMenuElement;
         "bs-menu-item": HTMLBsMenuItemElement;
         "bs-modal": HTMLBsModalElement;
+        "bs-source-link": HTMLBsSourceLinkElement;
         "bs-tooltip": HTMLBsTooltipElement;
     }
 }
 declare namespace LocalJSX {
+    /**
+     * A centered caption disclaimer for Genie AI surfaces, e.g. "AI can make mistakes. Please verify
+     * important information."
+     * ## When to use
+     * - Below or above `bs-composer` in a Genie AI chat panel, to remind users AI output can be wrong.
+     * ## When not to use
+     * - A general-purpose caption/helper text — use plain text or `bs-input`'s description slot for
+     *   non-AI-related helper copy.
+     * The default slot (rather than a fixed prop) is intentional: Figma only specifies plain text, but
+     * some consuming apps link out to a policy/help page from this copy, and a slot supports that
+     * without inventing an unconfirmed `href`/link prop.
+     * @prop --bs-ai-disclaimer-padding-x - Horizontal padding. Aliased to `--bs-spacing-200`.
+     * @prop --bs-ai-disclaimer-text-color - Text color. Aliased to `--bs-text-secondary`.
+     * @prop --bs-ai-disclaimer-font-size - Text font size. Aliased to `--bs-font-size-sm`.
+     * @prop --bs-ai-disclaimer-line-height - Text line height. Aliased to `--bs-line-height-body-sm`.
+     */
+    interface BsAiDisclaimer {
+    }
+    /**
+     * The centered welcome heading shown at the top of an empty Genie AI chat panel, e.g.
+     * "Hi. I'm Genie, your AI assistant." + "How can I help you with [product] today?"
+     * ## When to use
+     * - The empty/initial state of a Genie AI chat panel, before the user has sent a message.
+     * ## When not to use
+     * - Once a conversation has started -- this is a one-time empty-state greeting, not a persistent
+     *   header (see `bs-chatbot-header` for that).
+     * `productName` is optional: Figma's copy has a `[product_name]` placeholder the consuming app is
+     * expected to fill in, but a component shouldn't force a product name to exist, so leaving it
+     * unset falls back to a product-agnostic "How can I help you today?".
+     * @prop --bs-ai-greeting-gap - Gap between heading and subtext. Aliased to `--bs-spacing-200`.
+     * @prop --bs-ai-greeting-max-width - Max width of the centered content block. Matches Figma's
+     * 490px.
+     * @prop --bs-ai-greeting-heading-color - Heading text color. Aliased to `--bs-text-default`.
+     * @prop --bs-ai-greeting-heading-font-size - Heading font size. Aliased to `--bs-font-size-4xl`.
+     * @prop --bs-ai-greeting-heading-line-height - Heading line height. Figma specifies 28px, which
+     * doesn't match any `--bs-line-height-heading-*` token (h4 is 32) -- aliased directly to
+     * `--bs-line-height-body-lg`, the token that happens to share the same numeric value.
+     * @prop --bs-ai-greeting-heading-weight - Heading font weight. Aliased to `--bs-font-weight-bold`.
+     * @prop --bs-ai-greeting-heading-gap - Gap between the two heading lines. Aliased to
+     * `--bs-spacing-200`.
+     * @prop --bs-ai-greeting-subtext-color - Subtext color. Aliased to `--bs-text-secondary`.
+     * @prop --bs-ai-greeting-subtext-font-size - Subtext font size. Figma specifies 20px, which
+     * doesn't match the semantic `--bs-text-style-body-lg-size` (18px) -- aliased directly to the
+     * raw `--bs-font-size-xl` primitive instead.
+     * @prop --bs-ai-greeting-subtext-line-height - Subtext line height. Aliased to
+     * `--bs-line-height-body-lg`.
+     */
+    interface BsAiGreeting {
+        /**
+          * The assistant's name, used in the heading ("Hi. I'm {assistantName},").
+          * @default 'Genie'
+         */
+        "assistantName"?: string;
+        /**
+          * The product name mentioned in the subtext. Omit to use a product-agnostic subtext.
+         */
+        "productName"?: string;
+    }
     /**
      * A small inline status indicator for Genie AI surfaces: the colorful Genie mark next to a label
-     * (e.g. "Retrieving", "Thinking", "Searching") whose text pulses in a slow breathing loop while
-     * an operation is in progress.
+     * (e.g. "Retrieving", "Thinking", "Searching") whose text shimmers with a moving highlight band
+     * while an operation is in progress.
      * ## When to use
      * - Inline in a Genie AI chat transcript to show what the assistant is currently doing while a
      *   response is being generated (retrieving context, searching, thinking).
      * ## When not to use
      * - A blocking/full-panel loading state -- this is a small inline indicator, not a spinner overlay.
-     * The label's pulse animation reproduces Figma's exact keyframe track (a plain opacity
-     * fade-in/hold/reset with the source's own cubic-bezier easing) rather than an invented
-     * shimmer-sweep -- the source design only specifies this one animation.
      * @prop --bs-ai-thinking-gap - Gap between icon and label. Aliased to `--bs-spacing-100`.
      * @prop --bs-ai-thinking-icon-size - Width/height of the icon.
-     * @prop --bs-ai-thinking-text - Label color. Aliased to `--bs-text-muted`.
+     * @prop --bs-ai-thinking-text - Label base color. Aliased to `--bs-text-muted`.
+     * @prop --bs-ai-thinking-shimmer-highlight - Color of the moving highlight band. Aliased to
+     * `--bs-text-default` (more prominent than `--bs-text-muted` in both themes).
      * @prop --bs-ai-thinking-font-size - Label font size. Aliased to `--bs-font-size-md`.
      * @prop --bs-ai-thinking-line-height - Label line height. Aliased to `--bs-line-height-body-md`.
-     * @prop --bs-ai-thinking-cycle-duration - Duration of one pulse loop. Figma specifies exactly 2s,
-     * longer than any `--bs-duration-*` token (max `--bs-duration-slower` is 500ms), so this is
-     * aliased directly to the literal value.
+     * @prop --bs-ai-thinking-cycle-duration - Duration of one shimmer sweep. Figma's own keyframe
+     * track for this label runs over exactly 2s, longer than any `--bs-duration-*` token (max
+     * `--bs-duration-slower` is 500ms), so this is aliased directly to the literal value.
      */
     interface BsAiThinking {
         /**
@@ -1036,6 +1958,97 @@ declare namespace LocalJSX {
          */
         "label"?: string;
     }
+    /**
+     * A single file attachment preview for `bs-composer` -- an image thumbnail, or a filename card
+     * with a colored file-type badge (PDF/Document), with an optional upload-in-progress spinner and
+     * a hover/focus-revealed remove button.
+     * ## When to use
+     * - Rendered by the consuming app for each file a user has attached to a Genie AI chat message,
+     *   typically alongside or inside `bs-composer`.
+     * ## When not to use
+     * - A generic file-upload control -- this is a preview-only presentational component. The
+     *   consuming app owns the actual file picker/upload logic and drives `loading` from that state.
+     * @prop --bs-attachment-size - Width/height of the image thumbnail and of the card. Defaults to 112px.
+     * @prop --bs-attachment-radius - Corner radius of the thumbnail/card. Aliased to
+     * `--bs-border-radius-100`.
+     * @prop --bs-attachment-border-color - Border color of the card / loading image wrap. Aliased to
+     * `--bs-border-default`.
+     * @prop --bs-attachment-card-bg - Card background. Aliased to `--bs-surface-base`.
+     * @prop --bs-attachment-filename-color - Filename text color. Aliased to `--bs-text-default`.
+     * @prop --bs-attachment-badge-bg-pdf - PDF badge background. Aliased to `--bs-badge-bg-error`.
+     * @prop --bs-attachment-badge-bg-document - Document badge background. Aliased to
+     * `--bs-badge-bg-info`.
+     * @prop --bs-attachment-remove-bg - Remove button (neutral icon button) default background.
+     * Aliased to `--bs-button-neutral-container`.
+     * @prop --bs-attachment-remove-hover - Remove button hover background. Aliased to
+     * `--bs-button-neutral-hover`.
+     * @prop --bs-attachment-remove-pressed - Remove button active/pressed background. Aliased to
+     * `--bs-button-neutral-pressed`.
+     * @prop --bs-attachment-remove-focus - Remove button focus outline color. Aliased to
+     * `--bs-border-neutral-focus`.
+     */
+    interface BsAttachment {
+        /**
+          * The filename shown on the card. Only used when `type` is "pdf" or "document".
+          * @default 'Attachment'
+         */
+        "fileName"?: string;
+        /**
+          * Accessible alt text for the image thumbnail. Only used when `type` is "image".
+          * @default ''
+         */
+        "imageAlt"?: string;
+        /**
+          * The thumbnail image URL. Only used when `type` is "image".
+         */
+        "imageSrc"?: string;
+        /**
+          * Shows an upload-in-progress spinner (blurred + overlaid for images, in the badge for files).
+          * @default false
+         */
+        "loading"?: boolean;
+        /**
+          * Fires when the remove button is clicked.
+         */
+        "onBsRemove"?: (event: BsAttachmentCustomEvent<void>) => void;
+        /**
+          * Whether the hover/focus-revealed remove button is rendered at all.
+          * @default true
+         */
+        "removable"?: boolean;
+        /**
+          * Which kind of attachment preview to render.
+          * @default 'image'
+         */
+        "type"?: BsAttachmentType;
+    }
+    /**
+     * A horizontally-scrolling row wrapper for one or more `bs-attachment` previews, for slotting into
+     * `bs-composer`'s `attachments` slot when a Genie AI chat message has file attachments.
+     * ## When to use
+     * - Wrapping any number of `bs-attachment` elements the user has attached to a message, so they
+     *   lay out in a single row and scroll horizontally instead of wrapping/overflowing once there
+     *   are more than fit the available width.
+     * ## When not to use
+     * - A single attachment on its own — just render `bs-attachment` directly, this wrapper's
+     *   scroll/fade affordance only matters once there's more content than fits.
+     * @prop --bs-attachment-list-gap - Gap between attachments. Matches the 10px Figma spec (not tied
+     * to the `--bs-spacing-*` scale, which only has 8px/12px neighbors).
+     * @prop --bs-attachment-list-padding - Padding around the row. Aliased to `--bs-spacing-150`.
+     * @prop --bs-attachment-list-fade-color - Color the right-edge fade blends into. Aliased to
+     * `--bs-static-white`.
+     * @prop --bs-attachment-list-fade-width - Width of the right-edge fade overlay. Aliased to
+     * `--bs-spacing-800`.
+     * @prop --bs-attachment-list-scrollbar-thumb - Color of the scrollbar thumb that appears on
+     * hover/focus once the row is scrollable. Aliased to `--bs-neutral-300`.
+     */
+    interface BsAttachmentList {
+        /**
+          * Accessible name for the scrollable region.
+          * @default 'Attachments'
+         */
+        "ariaLabel"?: string | null;
+    }
     /**
      * A small status or category pill, usually paired with a label or list item.
      * ## When to use
@@ -1139,6 +2152,92 @@ declare namespace LocalJSX {
          */
         "surface"?: BsCardSurface;
     }
+    /**
+     * A star-rating feedback card shown at the end of a Genie AI chat: a heading/subtitle, a 5-star
+     * rating, an optional comment, and either "Submit feedback" + "Start new chat" (before
+     * submitting) or just "Start new chat" (after).
+     * ## When to use
+     * - Prompting for feedback on a Genie response or chat session, typically after the user ends or
+     *   restarts a conversation.
+     * ## When not to use
+     * - A generic star-rating input elsewhere in the product -- this component's copy and layout are
+     *   purpose-built for the Genie feedback flow, not a reusable rating control.
+     * The heading and subtitle are not freeform props: before submitting, they're always the fixed
+     * "How was your experience..." copy; after submitting, they're determined entirely by `rating`
+     * (1-2 stars reads apologetic, 3 neutral, 4-5 positive), matching the Figma source exactly. Use
+     * `heading`/`subtitle` only if a consuming app genuinely needs to override that copy.
+     * @prop --bs-chatbot-feedback-bg - Card background. Aliased to `--bs-surface-raised`.
+     * @prop --bs-chatbot-feedback-border - Card border color. Aliased to `--bs-border-default`.
+     * @prop --bs-chatbot-feedback-radius - Card corner radius. Aliased to `--bs-border-radius-200`.
+     * @prop --bs-chatbot-feedback-padding-x - Card horizontal padding. Aliased to `--bs-spacing-250`.
+     * @prop --bs-chatbot-feedback-padding-y - Card vertical padding. Aliased to `--bs-spacing-550`.
+     * @prop --bs-chatbot-feedback-max-width - Max width of the card. Matches Figma's 762px.
+     * @prop --bs-chatbot-feedback-gap - Gap between the top content block and the button(s). Aliased
+     * to `--bs-spacing-300`.
+     * @prop --bs-chatbot-feedback-top-gap - Gap between heading/subtitle, stars, and the
+     * textarea/comment within the top block. Aliased to `--bs-spacing-250`.
+     * @prop --bs-chatbot-feedback-heading-color - Aliased to `--bs-text-default`.
+     * @prop --bs-chatbot-feedback-subtitle-color - Aliased to `--bs-text-secondary`.
+     * @prop --bs-chatbot-feedback-star-filled - Filled star color. Aliased to `--bs-color-primary-default`.
+     * @prop --bs-chatbot-feedback-star-empty - Empty star color. Aliased to `--bs-border-neutral-container`.
+     * @prop --bs-chatbot-feedback-comment-color - Submitted comment text color. Aliased to `--bs-text-default`.
+     * @prop --bs-chatbot-feedback-close-hover - Close button hover background. Aliased to `--bs-surface-hover`.
+     * @prop --bs-chatbot-feedback-primary-bg - "Submit feedback" / post-submit "Start new chat"
+     * background. Aliased to `--bs-button-primary-default`.
+     * @prop --bs-chatbot-feedback-primary-bg-hover - Aliased to `--bs-button-primary-hover`.
+     * @prop --bs-chatbot-feedback-primary-bg-disabled - Aliased to `--bs-button-primary-disabled`.
+     * @prop --bs-chatbot-feedback-outlined-border - Pre-submit "Start new chat" border. Aliased to
+     * `--bs-border-primary`.
+     * @prop --bs-chatbot-feedback-outlined-hover - Pre-submit "Start new chat" hover background.
+     * Aliased to `--bs-color-primary-container-hover`.
+     * @prop --bs-chatbot-feedback-outlined-text - Pre-submit "Start new chat" text/icon color.
+     * Aliased to `--bs-text-action`.
+     */
+    interface BsChatbotFeedback {
+        /**
+          * The comment text.
+          * @default ''
+         */
+        "comment"?: string;
+        /**
+          * Overrides the computed heading (see the class doc for why this is computed by default).
+         */
+        "heading"?: string;
+        /**
+          * Fires when the close button is clicked. The consuming app owns actually hiding the card.
+         */
+        "onBsClose"?: (event: BsChatbotFeedbackCustomEvent<void>) => void;
+        /**
+          * Fires on every keystroke in the comment textarea, with the current value.
+         */
+        "onBsCommentInput"?: (event: BsChatbotFeedbackCustomEvent<string>) => void;
+        /**
+          * Fires when "Start new chat" is clicked. The consuming app owns actually starting a new chat.
+         */
+        "onBsNewChat"?: (event: BsChatbotFeedbackCustomEvent<void>) => void;
+        /**
+          * Fires when a star is clicked, with the new rating.
+         */
+        "onBsRatingChange"?: (event: BsChatbotFeedbackCustomEvent<number>) => void;
+        /**
+          * Fires when "Submit feedback" is clicked, with the current rating and comment. Also sets `submitted` to true.
+         */
+        "onBsSubmit"?: (event: BsChatbotFeedbackCustomEvent<{ rating: number; comment: string }>) => void;
+        /**
+          * Current star rating, 0-5. 0 means no rating has been given yet.
+          * @default 0
+         */
+        "rating"?: number;
+        /**
+          * Whether feedback has been submitted. Switches the card from the editable form to the read-only "thanks" view.
+          * @default false
+         */
+        "submitted"?: boolean;
+        /**
+          * Overrides the computed subtitle.
+         */
+        "subtitle"?: string;
+    }
     /**
      * The header bar that sits above `bs-composer` in a Genie AI chat panel: the Genie brand mark on
      * the left and four fixed actions (new chat, history, expand, close) on the right.
@@ -1253,6 +2352,49 @@ declare namespace LocalJSX {
          */
         "sourcesCount"?: number;
     }
+    /**
+     * The "Sources" panel shown alongside a Genie AI chat response -- a header with a title, a count
+     * badge, and a collapse chevron, above a stack of `bs-source-link` citation rows.
+     * ## When to use
+     * - Displaying the documents/sources a Genie response cited, typically opened from a "view
+     *   sources" action on a `bs-chatbot-response-action` bar.
+     * ## When not to use
+     * - A generic list container -- this component's header (title + count + collapse) is
+     *   purpose-built for the sources use case.
+     * @prop --bs-chatbot-sources-drawer-bg - Background of the whole panel. Aliased to `--bs-surface-raised`.
+     * @prop --bs-chatbot-sources-drawer-header-shadow - Drop shadow under the header, separating it
+     * from the scrolled list. Aliased to `--bs-shadow-xs`.
+     * @prop --bs-chatbot-sources-drawer-header-padding-x - Aliased to `--bs-spacing-200`.
+     * @prop --bs-chatbot-sources-drawer-header-padding-top - Aliased to `--bs-spacing-150`.
+     * @prop --bs-chatbot-sources-drawer-header-padding-bottom - Aliased to `--bs-spacing-100`.
+     * @prop --bs-chatbot-sources-drawer-heading-color - Aliased to `--bs-text-default`.
+     * @prop --bs-chatbot-sources-drawer-count-bg - Count badge background. Aliased to
+     * `--bs-badge-bg-neutral-container`.
+     * @prop --bs-chatbot-sources-drawer-count-color - Count badge text color. Aliased to
+     * `--bs-badge-text-neutral`.
+     * @prop --bs-chatbot-sources-drawer-collapse-hover - Collapse button background on hover. Aliased
+     * to `--bs-surface-hover`.
+     * @prop --bs-chatbot-sources-drawer-section-gap - Gap between the header and the list. Aliased to
+     * `--bs-spacing-200`.
+     * @prop --bs-chatbot-sources-drawer-list-padding - Horizontal/bottom padding of the list. Aliased
+     * to `--bs-spacing-200`.
+     * @prop --bs-chatbot-sources-drawer-list-gap - Gap between rows. Aliased to `--bs-spacing-50`.
+     */
+    interface BsChatbotSourcesDrawer {
+        /**
+          * Overrides the auto-detected count badge. By default the badge reflects the number of slotted `bs-source-link` children, so most consumers don't need to set this.
+         */
+        "count"?: number;
+        /**
+          * The panel title.
+          * @default 'Sources'
+         */
+        "heading"?: string;
+        /**
+          * Fires when the collapse chevron is clicked. The consuming app owns actually hiding the panel.
+         */
+        "onBsCollapse"?: (event: BsChatbotSourcesDrawerCustomEvent<void>) => void;
+    }
     /**
      * A pill-shaped clickable suggestion chip for a Genie AI chat panel (e.g. "How can I help you?").
      * One instance renders one chip -- to show several suggestion prompts side by side, render
@@ -1377,6 +2519,103 @@ declare namespace LocalJSX {
          */
         "variant"?: BsComposerVariant;
     }
+    /**
+     * A full-width status banner for use directly above `bs-composer`, surfacing a message about the
+     * composer's current state (e.g. a send failure, an informational notice) with an optional
+     * "Continue"-style action button and an optional close button.
+     * ## When to use
+     * - A message tied to the composer itself (send failed, rate-limited, draft restored, etc.) that
+     *   needs to sit directly above it, not a general-purpose alert -- see `CONVENTIONS.md` if this
+     *   library gains a generic banner/alert component later, and prefer that instead once it exists.
+     * ## When not to use
+     * - A toast/snackbar notification unrelated to the composer -- this component is not
+     *   self-dismissing and has no positioning of its own (it's a static block, not an overlay).
+     * @prop --bs-composer-status-banner-radius - Corner radius of the top-left/top-right corners
+     * (bottom corners are square, so this sits flush above `bs-composer`). Aliased to
+     * `--bs-border-radius-150`.
+     * @prop --bs-composer-status-banner-padding-x - Horizontal padding. Aliased to `--bs-spacing-150`.
+     * @prop --bs-composer-status-banner-padding-top - Top padding. Aliased to `--bs-spacing-100`.
+     * @prop --bs-composer-status-banner-padding-bottom - Bottom padding. Aliased to `--bs-spacing-200`.
+     * @prop --bs-composer-status-banner-gap - Gap between the message group and the action/close
+     * controls. Aliased to `--bs-spacing-100`.
+     * @prop --bs-composer-status-banner-icon-gap - Gap between the icon and the message text.
+     * Aliased to `--bs-spacing-75`.
+     * @prop --bs-composer-status-banner-error-bg - Background for `type="error"`. Aliased to
+     * `--bs-color-error-container`.
+     * @prop --bs-composer-status-banner-error-text - Text/icon color for `type="error"`. Aliased to
+     * `--bs-text-error`.
+     * @prop --bs-composer-status-banner-error-action-bg - Action button background for
+     * `type="error"`. Aliased to `--bs-color-error-default`.
+     * @prop --bs-composer-status-banner-error-action-bg-hover - Aliased to `--bs-color-error-hover`.
+     * @prop --bs-composer-status-banner-info-bg - Background for `type="info"`. Aliased to
+     * `--bs-color-info-container`.
+     * @prop --bs-composer-status-banner-info-text - Text/icon color for `type="info"`. Aliased to
+     * `--bs-text-info`.
+     * @prop --bs-composer-status-banner-info-action-bg - Action button background for `type="info"`.
+     * Aliased to `--bs-color-info-default`.
+     * @prop --bs-composer-status-banner-info-action-bg-hover - Aliased to `--bs-color-info-hover`.
+     * @prop --bs-composer-status-banner-neutral-bg - Background for `type="neutral"`. Aliased to
+     * `--bs-color-neutral-container`.
+     * @prop --bs-composer-status-banner-neutral-text - Text/icon color for `type="neutral"`. Aliased
+     * to `--bs-text-default`.
+     * @prop --bs-composer-status-banner-neutral-action-bg - Action button background for
+     * `type="neutral"`. Aliased to `--bs-color-neutral-container`.
+     * @prop --bs-composer-status-banner-neutral-action-bg-hover - Aliased to
+     * `--bs-color-neutral-container-hover`.
+     * @prop --bs-composer-status-banner-neutral-action-border - Action button border for
+     * `type="neutral"` (the only variant whose action button is outlined). Aliased to
+     * `--bs-border-neutral-container`.
+     * @prop --bs-composer-status-banner-warning-bg - Background for `type="warning"`. Aliased to
+     * `--bs-color-warning-container`.
+     * @prop --bs-composer-status-banner-warning-text - Text/icon color for `type="warning"`. Aliased
+     * to `--bs-text-warning`.
+     * @prop --bs-composer-status-banner-warning-action-bg - Action button background for
+     * `type="warning"`. Aliased to `--bs-color-warning-default`.
+     * @prop --bs-composer-status-banner-warning-action-bg-hover - Aliased to
+     * `--bs-color-warning-hover`.
+     * @prop --bs-composer-status-banner-close-hover-bg - Close button hover background (same across
+     * every `type`). Aliased to `--bs-color-neutral-container-hover`.
+     */
+    interface BsComposerStatusBanner {
+        /**
+          * Label for the action button, only rendered when `showButton` is true.
+          * @default 'Continue'
+         */
+        "actionLabel"?: string;
+        /**
+          * Whether the close button is rendered.
+          * @default true
+         */
+        "allowClose"?: boolean;
+        /**
+          * The message text.
+          * @default 'This is a message'
+         */
+        "message"?: string;
+        /**
+          * Fires when the action button is clicked. Only relevant when `showButton` is true.
+         */
+        "onBsAction"?: (event: BsComposerStatusBannerCustomEvent<void>) => void;
+        /**
+          * Fires when the close button is clicked. Only relevant when `allowClose` is true.
+         */
+        "onBsClose"?: (event: BsComposerStatusBannerCustomEvent<void>) => void;
+        /**
+          * Whether the "Continue"-style action button is rendered.
+          * @default false
+         */
+        "showButton"?: boolean;
+        /**
+          * Whether the leading icon (default: clock) is rendered.
+          * @default true
+         */
+        "showIcon"?: boolean;
+        /**
+          * Which severity/style to render. Drives background, text/icon color, and the action button's color.
+          * @default 'error'
+         */
+        "type"?: BsComposerStatusBannerType;
+    }
     /**
      * A sortable, optionally row-selectable table for tabular data.
      * `columns`, `rows`, and `cellRenderer` are JS-property-only — HTML attributes can only carry
@@ -1416,31 +2655,133 @@ declare namespace LocalJSX {
         "sortDirection"?: 'asc' | 'desc';
     }
     /**
-     * A single-line text field with an optional label, description, and error state.
+     * A single-line text field with an optional label, description, and error state. Also covers a
+     * range of related "field" shapes (number stepper, password reveal, date, dropdown trigger,
+     * select, textarea, chip input, initials, country, and pin) via the `type` prop, since they all
+     * share the same label/description/error/icon-slot chrome.
      * ## When to use
      * - Collecting a single line of free-text, email, password, or numeric input.
+     * - Any of the other supported `type`s (search, date, dropdown, select, textarea, chip, initials,
+     *   country, pin) that share this component's label/description/error chrome.
      * - Pair with `error` for inline validation feedback tied to that specific field.
      * ## When not to use
-     * - Multi-line text — this component has no `textarea` mode.
-     * - A fixed set of choices — use a select/radio/checkbox component instead of free text.
+     * - A fixed set of choices best served by a dedicated radio/checkbox group rather than a single
+     *   field. `type="select"` (native `<select>`) and `type="dropdown"` (a `bs-menu` of
+     *   `bs-menu-item`s from the `options` prop) cover the field-shaped cases; `type="chip"` has no
+     *   options list at all (freeform chip entry).
      */
     interface BsInput {
+        /**
+          * Current chips for `type="chip"`. Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
+          * @default []
+         */
+        "chips"?: string[];
+        /**
+          * Current selected country code for `type="country"`.
+          * @default ''
+         */
+        "country"?: string;
+        /**
+          * Country select options for `type="country"`. Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
+          * @default []
+         */
+        "countryOptions"?: { code: string; label: string; flagIcon?: string }[];
         "description"?: string;
         /**
           * @default false
          */
         "disabled"?: boolean;
         "error"?: string;
+        /**
+          * Current selected title for `type="initials"`. Named `initialsTitle` rather than `title` -- `title` is a reserved standard HTML attribute (tooltip text) inherited by every element, and Stencil warns against shadowing it with a component `@Prop`.
+          * @default ''
+         */
+        "initialsTitle"?: string;
         "label"?: string;
+        /**
+          * Number of cells for `type="pin"`.
+          * @default 4
+         */
+        "length"?: number;
+        /**
+          * Maximum value for `type="number"`'s stepper buttons.
+         */
+        "max"?: number;
+        /**
+          * Minimum value for `type="number"`'s stepper buttons.
+         */
+        "min"?: number;
         "onBsChange"?: (event: BsInputCustomEvent<string>) => void;
+        /**
+          * Emitted when a chip is committed (Enter pressed in the draft input) for `type="chip"`.
+         */
+        "onBsChipAdd"?: (event: BsInputCustomEvent<string>) => void;
+        /**
+          * Emitted when a chip's remove button is clicked for `type="chip"`.
+         */
+        "onBsChipRemove"?: (event: BsInputCustomEvent<string>) => void;
+        /**
+          * Emitted when the country `<select>` changes for `type="country"`.
+         */
+        "onBsCountryChange"?: (event: BsInputCustomEvent<string>) => void;
         "onBsInput"?: (event: BsInputCustomEvent<string>) => void;
+        /**
+          * Emitted when `type="dropdown"`'s trigger is toggled. See `open`'s doc comment for this type's shell-only limitation.
+         */
+        "onBsOpen"?: (event: BsInputCustomEvent<boolean>) => void;
+        /**
+          * Emitted when the title `<select>` changes for `type="initials"`.
+         */
+        "onBsTitleChange"?: (event: BsInputCustomEvent<string>) => void;
+        /**
+          * Whether the `type="dropdown"` trigger is open. Reflects to an attribute so consumers can style an open state via CSS. When `options` is non-empty, this also controls whether the `bs-menu` of `bs-menu-item`s is rendered below the field.
+          * @default false
+         */
+        "open"?: boolean;
+        /**
+          * Options for `type="select"` (rendered as native `<option>`s) and `type="dropdown"` (rendered as a `bs-menu` of `bs-menu-item`s when `open`). Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
+          * @default []
+         */
+        "options"?: { label: string; value: string }[];
         "placeholder"?: string;
         /**
-          * @default 'text'
+          * Marks the field as required: renders a red `*` after the label and sets `aria-required="true"` on the control. Applies regardless of `type`.
+          * @default false
          */
-        "type"?: 'text' | 'email' | 'password' | 'number';
+        "required"?: boolean;
         /**
-          * Current value. Native `input`/`change` events don't cross the Shadow DOM boundary, so this component re-dispatches them as `bsInput`/`bsChange` custom events instead.
+          * Number of visible rows for `type="textarea"`.
+          * @default 3
+         */
+        "rows"?: number;
+        /**
+          * Step size for `type="number"`'s increment/decrement stepper buttons.
+          * @default 1
+         */
+        "step"?: number;
+        /**
+          * Title select options for `type="initials"` (e.g. `['Mrs.', 'Mr.', 'Dr.']`). Must be set as a JS property, not an HTML attribute -- see CONVENTIONS.md's non-string props rule.
+          * @default []
+         */
+        "titleOptions"?: string[];
+        /**
+          * @default 'text'
+         */
+        "type"?: | 'text'
+    | 'email'
+    | 'password'
+    | 'number'
+    | 'search'
+    | 'date'
+    | 'dropdown'
+    | 'select'
+    | 'textarea'
+    | 'chip'
+    | 'initials'
+    | 'country'
+    | 'pin';
+        /**
+          * Current value. Native `input`/`change` events don't cross the Shadow DOM boundary, so this component re-dispatches them as `bsInput`/`bsChange` custom events instead. Mutable so the `number` type's stepper buttons can update it directly.
           * @default ''
          */
         "value"?: string;
@@ -1511,6 +2852,59 @@ declare namespace LocalJSX {
          */
         "size"?: BsModalSize;
     }
+    /**
+     * A single citation row inside `bs-chatbot-sources-drawer` -- a file icon + filename on the first
+     * line, the originating system and version on the second, and a trailing "open" arrow.
+     * ## When to use
+     * - One row per source Genie cited in a response, slotted into `bs-chatbot-sources-drawer`.
+     * ## When not to use
+     * - Outside the sources drawer context -- this is a purpose-built citation row, not a generic
+     *   link/list-item component.
+     * @prop --bs-source-link-radius - Corner radius of the row. Aliased to `--bs-border-radius-150`.
+     * @prop --bs-source-link-padding - Padding around the row. Aliased to `--bs-spacing-150`.
+     * @prop --bs-source-link-gap - Gap between the filename+meta block and the trailing arrow.
+     * Aliased to `--bs-spacing-50`.
+     * @prop --bs-source-link-icon-gap - Gap between the leading icon and the filename text. Aliased
+     * to `--bs-spacing-75`.
+     * @prop --bs-source-link-hover - Row background on hover/focus. Aliased to `--bs-surface-hover`.
+     * @prop --bs-source-link-pressed - Row background while active/pressed. Aliased to
+     * `--bs-surface-pressed`.
+     * @prop --bs-source-link-focus - Focus-visible outline color. Aliased to
+     * `--bs-border-neutral-focus`.
+     * @prop --bs-source-link-filename-color - Filename text color. Aliased to `--bs-text-default`.
+     * @prop --bs-source-link-meta-color - Source/version text color. Aliased to `--bs-text-secondary`.
+     * @prop --bs-source-link-icon-color - File icon and arrow color. Aliased to `--bs-icon-default`.
+     * @prop --bs-source-link-dot-color - Separator dot between source and version. Aliased to
+     * `--bs-text-secondary`.
+     */
+    interface BsSourceLink {
+        /**
+          * The cited document's filename.
+          * @default 'Source'
+         */
+        "fileName"?: string;
+        /**
+          * If set, renders the row as a link that opens this URL; otherwise as a button that only emits `bsOpen`.
+         */
+        "href"?: string;
+        /**
+          * Fires on click/activation, whether or not `href` is set -- lets the consuming app log or handle the open.
+         */
+        "onBsOpen"?: (event: BsSourceLinkCustomEvent<void>) => void;
+        /**
+          * The system/app the document came from (e.g. "HoltePortalen").
+         */
+        "sourceName"?: string;
+        /**
+          * `target` used when `href` is set.
+          * @default '_blank'
+         */
+        "target"?: string;
+        /**
+          * The document's version label (e.g. "v3.2"). Omit if the source has no version.
+         */
+        "version"?: string;
+    }
     /**
      * A dark tooltip bubble with a pointer arrow, used to surface a short hint of extra information
      * next to a trigger element.
@@ -1546,9 +2940,24 @@ declare namespace LocalJSX {
         "placement"?: 'top';
     }
 
+    interface BsAiGreetingAttributes {
+        "assistantName": string;
+        "productName": string;
+    }
     interface BsAiThinkingAttributes {
         "label": string;
     }
+    interface BsAttachmentAttributes {
+        "type": BsAttachmentType;
+        "fileName": string;
+        "imageSrc": string;
+        "imageAlt": string;
+        "loading": boolean;
+        "removable": boolean;
+    }
+    interface BsAttachmentListAttributes {
+        "ariaLabel": string | null;
+    }
     interface BsBadgeAttributes {
         "variant": BsBadgeVariant;
     }
@@ -1565,6 +2974,13 @@ declare namespace LocalJSX {
     interface BsCardAttributes {
         "surface": BsCardSurface;
     }
+    interface BsChatbotFeedbackAttributes {
+        "rating": number;
+        "submitted": boolean;
+        "comment": string;
+        "heading": string;
+        "subtitle": string;
+    }
     interface BsChatbotHeaderAttributes {
         "heading": string;
         "expanded": boolean;
@@ -1573,6 +2989,10 @@ declare namespace LocalJSX {
         "sourcesCount": number;
         "menuOpen": boolean;
     }
+    interface BsChatbotSourcesDrawerAttributes {
+        "heading": string;
+        "count": number;
+    }
     interface BsChatbotSuggestionButtonAttributes {
         "disabled": boolean;
     }
@@ -1583,6 +3003,14 @@ declare namespace LocalJSX {
         "state": BsComposerState;
         "ariaLabel": string | null;
     }
+    interface BsComposerStatusBannerAttributes {
+        "type": BsComposerStatusBannerType;
+        "message": string;
+        "showIcon": boolean;
+        "showButton": boolean;
+        "actionLabel": string;
+        "allowClose": boolean;
+    }
     interface BsDataTableAttributes {
         "sortColumn": string;
         "sortDirection": 'asc' | 'desc';
@@ -1590,37 +3018,73 @@ declare namespace LocalJSX {
     }
     interface BsInputAttributes {
         "value": string;
-        "type": 'text' | 'email' | 'password' | 'number';
+        "type": | 'text'
+    | 'email'
+    | 'password'
+    | 'number'
+    | 'search'
+    | 'date'
+    | 'dropdown'
+    | 'select'
+    | 'textarea'
+    | 'chip'
+    | 'initials'
+    | 'country'
+    | 'pin';
         "label": string;
         "placeholder": string;
         "description": string;
         "error": string;
         "disabled": boolean;
+        "required": boolean;
+        "step": number;
+        "min": number;
+        "max": number;
+        "rows": number;
+        "initialsTitle": string;
+        "country": string;
+        "length": number;
+        "open": boolean;
     }
     interface BsModalAttributes {
         "open": boolean;
         "heading": string;
         "size": BsModalSize;
     }
+    interface BsSourceLinkAttributes {
+        "fileName": string;
+        "sourceName": string;
+        "version": string;
+        "href": string;
+        "target": string;
+    }
     interface BsTooltipAttributes {
         "placement": 'top';
     }
 
     interface IntrinsicElements {
+        "bs-ai-disclaimer": BsAiDisclaimer;
+        "bs-ai-greeting": Omit<BsAiGreeting, keyof BsAiGreetingAttributes> & { [K in keyof BsAiGreeting & keyof BsAiGreetingAttributes]?: BsAiGreeting[K] } & { [K in keyof BsAiGreeting & keyof BsAiGreetingAttributes as `attr:${K}`]?: BsAiGreetingAttributes[K] } & { [K in keyof BsAiGreeting & keyof BsAiGreetingAttributes as `prop:${K}`]?: BsAiGreeting[K] };
         "bs-ai-thinking": Omit<BsAiThinking, keyof BsAiThinkingAttributes> & { [K in keyof BsAiThinking & keyof BsAiThinkingAttributes]?: BsAiThinking[K] } & { [K in keyof BsAiThinking & keyof BsAiThinkingAttributes as `attr:${K}`]?: BsAiThinkingAttributes[K] } & { [K in keyof BsAiThinking & keyof BsAiThinkingAttributes as `prop:${K}`]?: BsAiThinking[K] };
+        "bs-attachment": Omit<BsAttachment, keyof BsAttachmentAttributes> & { [K in keyof BsAttachment & keyof BsAttachmentAttributes]?: BsAttachment[K] } & { [K in keyof BsAttachment & keyof BsAttachmentAttributes as `attr:${K}`]?: BsAttachmentAttributes[K] } & { [K in keyof BsAttachment & keyof BsAttachmentAttributes as `prop:${K}`]?: BsAttachment[K] };
+        "bs-attachment-list": Omit<BsAttachmentList, keyof BsAttachmentListAttributes> & { [K in keyof BsAttachmentList & keyof BsAttachmentListAttributes]?: BsAttachmentList[K] } & { [K in keyof BsAttachmentList & keyof BsAttachmentListAttributes as `attr:${K}`]?: BsAttachmentListAttributes[K] } & { [K in keyof BsAttachmentList & keyof BsAttachmentListAttributes as `prop:${K}`]?: BsAttachmentList[K] };
         "bs-badge": Omit<BsBadge, keyof BsBadgeAttributes> & { [K in keyof BsBadge & keyof BsBadgeAttributes]?: BsBadge[K] } & { [K in keyof BsBadge & keyof BsBadgeAttributes as `attr:${K}`]?: BsBadgeAttributes[K] } & { [K in keyof BsBadge & keyof BsBadgeAttributes as `prop:${K}`]?: BsBadge[K] };
         "bs-button": Omit<BsButton, keyof BsButtonAttributes> & { [K in keyof BsButton & keyof BsButtonAttributes]?: BsButton[K] } & { [K in keyof BsButton & keyof BsButtonAttributes as `attr:${K}`]?: BsButtonAttributes[K] } & { [K in keyof BsButton & keyof BsButtonAttributes as `prop:${K}`]?: BsButton[K] };
         "bs-button-skeleton": Omit<BsButtonSkeleton, keyof BsButtonSkeletonAttributes> & { [K in keyof BsButtonSkeleton & keyof BsButtonSkeletonAttributes]?: BsButtonSkeleton[K] } & { [K in keyof BsButtonSkeleton & keyof BsButtonSkeletonAttributes as `attr:${K}`]?: BsButtonSkeletonAttributes[K] } & { [K in keyof BsButtonSkeleton & keyof BsButtonSkeletonAttributes as `prop:${K}`]?: BsButtonSkeleton[K] };
         "bs-card": Omit<BsCard, keyof BsCardAttributes> & { [K in keyof BsCard & keyof BsCardAttributes]?: BsCard[K] } & { [K in keyof BsCard & keyof BsCardAttributes as `attr:${K}`]?: BsCardAttributes[K] } & { [K in keyof BsCard & keyof BsCardAttributes as `prop:${K}`]?: BsCard[K] };
+        "bs-chatbot-feedback": Omit<BsChatbotFeedback, keyof BsChatbotFeedbackAttributes> & { [K in keyof BsChatbotFeedback & keyof BsChatbotFeedbackAttributes]?: BsChatbotFeedback[K] } & { [K in keyof BsChatbotFeedback & keyof BsChatbotFeedbackAttributes as `attr:${K}`]?: BsChatbotFeedbackAttributes[K] } & { [K in keyof BsChatbotFeedback & keyof BsChatbotFeedbackAttributes as `prop:${K}`]?: BsChatbotFeedback[K] };
         "bs-chatbot-header": Omit<BsChatbotHeader, keyof BsChatbotHeaderAttributes> & { [K in keyof BsChatbotHeader & keyof BsChatbotHeaderAttributes]?: BsChatbotHeader[K] } & { [K in keyof BsChatbotHeader & keyof BsChatbotHeaderAttributes as `attr:${K}`]?: BsChatbotHeaderAttributes[K] } & { [K in keyof BsChatbotHeader & keyof BsChatbotHeaderAttributes as `prop:${K}`]?: BsChatbotHeader[K] };
         "bs-chatbot-response-action": Omit<BsChatbotResponseAction, keyof BsChatbotResponseActionAttributes> & { [K in keyof BsChatbotResponseAction & keyof BsChatbotResponseActionAttributes]?: BsChatbotResponseAction[K] } & { [K in keyof BsChatbotResponseAction & keyof BsChatbotResponseActionAttributes as `attr:${K}`]?: BsChatbotResponseActionAttributes[K] } & { [K in keyof BsChatbotResponseAction & keyof BsChatbotResponseActionAttributes as `prop:${K}`]?: BsChatbotResponseAction[K] };
+        "bs-chatbot-sources-drawer": Omit<BsChatbotSourcesDrawer, keyof BsChatbotSourcesDrawerAttributes> & { [K in keyof BsChatbotSourcesDrawer & keyof BsChatbotSourcesDrawerAttributes]?: BsChatbotSourcesDrawer[K] } & { [K in keyof BsChatbotSourcesDrawer & keyof BsChatbotSourcesDrawerAttributes as `attr:${K}`]?: BsChatbotSourcesDrawerAttributes[K] } & { [K in keyof BsChatbotSourcesDrawer & keyof BsChatbotSourcesDrawerAttributes as `prop:${K}`]?: BsChatbotSourcesDrawer[K] };
         "bs-chatbot-suggestion-button": Omit<BsChatbotSuggestionButton, keyof BsChatbotSuggestionButtonAttributes> & { [K in keyof BsChatbotSuggestionButton & keyof BsChatbotSuggestionButtonAttributes]?: BsChatbotSuggestionButton[K] } & { [K in keyof BsChatbotSuggestionButton & keyof BsChatbotSuggestionButtonAttributes as `attr:${K}`]?: BsChatbotSuggestionButtonAttributes[K] } & { [K in keyof BsChatbotSuggestionButton & keyof BsChatbotSuggestionButtonAttributes as `prop:${K}`]?: BsChatbotSuggestionButton[K] };
         "bs-composer": Omit<BsComposer, keyof BsComposerAttributes> & { [K in keyof BsComposer & keyof BsComposerAttributes]?: BsComposer[K] } & { [K in keyof BsComposer & keyof BsComposerAttributes as `attr:${K}`]?: BsComposerAttributes[K] } & { [K in keyof BsComposer & keyof BsComposerAttributes as `prop:${K}`]?: BsComposer[K] };
+        "bs-composer-status-banner": Omit<BsComposerStatusBanner, keyof BsComposerStatusBannerAttributes> & { [K in keyof BsComposerStatusBanner & keyof BsComposerStatusBannerAttributes]?: BsComposerStatusBanner[K] } & { [K in keyof BsComposerStatusBanner & keyof BsComposerStatusBannerAttributes as `attr:${K}`]?: BsComposerStatusBannerAttributes[K] } & { [K in keyof BsComposerStatusBanner & keyof BsComposerStatusBannerAttributes as `prop:${K}`]?: BsComposerStatusBanner[K] };
         "bs-data-table": Omit<BsDataTable, keyof BsDataTableAttributes> & { [K in keyof BsDataTable & keyof BsDataTableAttributes]?: BsDataTable[K] } & { [K in keyof BsDataTable & keyof BsDataTableAttributes as `attr:${K}`]?: BsDataTableAttributes[K] } & { [K in keyof BsDataTable & keyof BsDataTableAttributes as `prop:${K}`]?: BsDataTable[K] };
         "bs-input": Omit<BsInput, keyof BsInputAttributes> & { [K in keyof BsInput & keyof BsInputAttributes]?: BsInput[K] } & { [K in keyof BsInput & keyof BsInputAttributes as `attr:${K}`]?: BsInputAttributes[K] } & { [K in keyof BsInput & keyof BsInputAttributes as `prop:${K}`]?: BsInput[K] };
         "bs-menu": BsMenu;
         "bs-menu-item": BsMenuItem;
         "bs-modal": Omit<BsModal, keyof BsModalAttributes> & { [K in keyof BsModal & keyof BsModalAttributes]?: BsModal[K] } & { [K in keyof BsModal & keyof BsModalAttributes as `attr:${K}`]?: BsModalAttributes[K] } & { [K in keyof BsModal & keyof BsModalAttributes as `prop:${K}`]?: BsModal[K] };
+        "bs-source-link": Omit<BsSourceLink, keyof BsSourceLinkAttributes> & { [K in keyof BsSourceLink & keyof BsSourceLinkAttributes]?: BsSourceLink[K] } & { [K in keyof BsSourceLink & keyof BsSourceLinkAttributes as `attr:${K}`]?: BsSourceLinkAttributes[K] } & { [K in keyof BsSourceLink & keyof BsSourceLinkAttributes as `prop:${K}`]?: BsSourceLink[K] };
         "bs-tooltip": Omit<BsTooltip, keyof BsTooltipAttributes> & { [K in keyof BsTooltip & keyof BsTooltipAttributes]?: BsTooltip[K] } & { [K in keyof BsTooltip & keyof BsTooltipAttributes as `attr:${K}`]?: BsTooltipAttributes[K] } & { [K in keyof BsTooltip & keyof BsTooltipAttributes as `prop:${K}`]?: BsTooltip[K] };
     }
 }
@@ -1628,28 +3092,125 @@ export { LocalJSX as JSX };
 declare module "@stencil/core" {
     export namespace JSX {
         interface IntrinsicElements {
+            /**
+             * A centered caption disclaimer for Genie AI surfaces, e.g. "AI can make mistakes. Please verify
+             * important information."
+             * ## When to use
+             * - Below or above `bs-composer` in a Genie AI chat panel, to remind users AI output can be wrong.
+             * ## When not to use
+             * - A general-purpose caption/helper text — use plain text or `bs-input`'s description slot for
+             *   non-AI-related helper copy.
+             * The default slot (rather than a fixed prop) is intentional: Figma only specifies plain text, but
+             * some consuming apps link out to a policy/help page from this copy, and a slot supports that
+             * without inventing an unconfirmed `href`/link prop.
+             * @prop --bs-ai-disclaimer-padding-x - Horizontal padding. Aliased to `--bs-spacing-200`.
+             * @prop --bs-ai-disclaimer-text-color - Text color. Aliased to `--bs-text-secondary`.
+             * @prop --bs-ai-disclaimer-font-size - Text font size. Aliased to `--bs-font-size-sm`.
+             * @prop --bs-ai-disclaimer-line-height - Text line height. Aliased to `--bs-line-height-body-sm`.
+             */
+            "bs-ai-disclaimer": LocalJSX.IntrinsicElements["bs-ai-disclaimer"] & JSXBase.HTMLAttributes<HTMLBsAiDisclaimerElement>;
+            /**
+             * The centered welcome heading shown at the top of an empty Genie AI chat panel, e.g.
+             * "Hi. I'm Genie, your AI assistant." + "How can I help you with [product] today?"
+             * ## When to use
+             * - The empty/initial state of a Genie AI chat panel, before the user has sent a message.
+             * ## When not to use
+             * - Once a conversation has started -- this is a one-time empty-state greeting, not a persistent
+             *   header (see `bs-chatbot-header` for that).
+             * `productName` is optional: Figma's copy has a `[product_name]` placeholder the consuming app is
+             * expected to fill in, but a component shouldn't force a product name to exist, so leaving it
+             * unset falls back to a product-agnostic "How can I help you today?".
+             * @prop --bs-ai-greeting-gap - Gap between heading and subtext. Aliased to `--bs-spacing-200`.
+             * @prop --bs-ai-greeting-max-width - Max width of the centered content block. Matches Figma's
+             * 490px.
+             * @prop --bs-ai-greeting-heading-color - Heading text color. Aliased to `--bs-text-default`.
+             * @prop --bs-ai-greeting-heading-font-size - Heading font size. Aliased to `--bs-font-size-4xl`.
+             * @prop --bs-ai-greeting-heading-line-height - Heading line height. Figma specifies 28px, which
+             * doesn't match any `--bs-line-height-heading-*` token (h4 is 32) -- aliased directly to
+             * `--bs-line-height-body-lg`, the token that happens to share the same numeric value.
+             * @prop --bs-ai-greeting-heading-weight - Heading font weight. Aliased to `--bs-font-weight-bold`.
+             * @prop --bs-ai-greeting-heading-gap - Gap between the two heading lines. Aliased to
+             * `--bs-spacing-200`.
+             * @prop --bs-ai-greeting-subtext-color - Subtext color. Aliased to `--bs-text-secondary`.
+             * @prop --bs-ai-greeting-subtext-font-size - Subtext font size. Figma specifies 20px, which
+             * doesn't match the semantic `--bs-text-style-body-lg-size` (18px) -- aliased directly to the
+             * raw `--bs-font-size-xl` primitive instead.
+             * @prop --bs-ai-greeting-subtext-line-height - Subtext line height. Aliased to
+             * `--bs-line-height-body-lg`.
+             */
+            "bs-ai-greeting": LocalJSX.IntrinsicElements["bs-ai-greeting"] & JSXBase.HTMLAttributes<HTMLBsAiGreetingElement>;
             /**
              * A small inline status indicator for Genie AI surfaces: the colorful Genie mark next to a label
-             * (e.g. "Retrieving", "Thinking", "Searching") whose text pulses in a slow breathing loop while
-             * an operation is in progress.
+             * (e.g. "Retrieving", "Thinking", "Searching") whose text shimmers with a moving highlight band
+             * while an operation is in progress.
              * ## When to use
              * - Inline in a Genie AI chat transcript to show what the assistant is currently doing while a
              *   response is being generated (retrieving context, searching, thinking).
              * ## When not to use
              * - A blocking/full-panel loading state -- this is a small inline indicator, not a spinner overlay.
-             * The label's pulse animation reproduces Figma's exact keyframe track (a plain opacity
-             * fade-in/hold/reset with the source's own cubic-bezier easing) rather than an invented
-             * shimmer-sweep -- the source design only specifies this one animation.
              * @prop --bs-ai-thinking-gap - Gap between icon and label. Aliased to `--bs-spacing-100`.
              * @prop --bs-ai-thinking-icon-size - Width/height of the icon.
-             * @prop --bs-ai-thinking-text - Label color. Aliased to `--bs-text-muted`.
+             * @prop --bs-ai-thinking-text - Label base color. Aliased to `--bs-text-muted`.
+             * @prop --bs-ai-thinking-shimmer-highlight - Color of the moving highlight band. Aliased to
+             * `--bs-text-default` (more prominent than `--bs-text-muted` in both themes).
              * @prop --bs-ai-thinking-font-size - Label font size. Aliased to `--bs-font-size-md`.
              * @prop --bs-ai-thinking-line-height - Label line height. Aliased to `--bs-line-height-body-md`.
-             * @prop --bs-ai-thinking-cycle-duration - Duration of one pulse loop. Figma specifies exactly 2s,
-             * longer than any `--bs-duration-*` token (max `--bs-duration-slower` is 500ms), so this is
-             * aliased directly to the literal value.
+             * @prop --bs-ai-thinking-cycle-duration - Duration of one shimmer sweep. Figma's own keyframe
+             * track for this label runs over exactly 2s, longer than any `--bs-duration-*` token (max
+             * `--bs-duration-slower` is 500ms), so this is aliased directly to the literal value.
              */
             "bs-ai-thinking": LocalJSX.IntrinsicElements["bs-ai-thinking"] & JSXBase.HTMLAttributes<HTMLBsAiThinkingElement>;
+            /**
+             * A single file attachment preview for `bs-composer` -- an image thumbnail, or a filename card
+             * with a colored file-type badge (PDF/Document), with an optional upload-in-progress spinner and
+             * a hover/focus-revealed remove button.
+             * ## When to use
+             * - Rendered by the consuming app for each file a user has attached to a Genie AI chat message,
+             *   typically alongside or inside `bs-composer`.
+             * ## When not to use
+             * - A generic file-upload control -- this is a preview-only presentational component. The
+             *   consuming app owns the actual file picker/upload logic and drives `loading` from that state.
+             * @prop --bs-attachment-size - Width/height of the image thumbnail and of the card. Defaults to 112px.
+             * @prop --bs-attachment-radius - Corner radius of the thumbnail/card. Aliased to
+             * `--bs-border-radius-100`.
+             * @prop --bs-attachment-border-color - Border color of the card / loading image wrap. Aliased to
+             * `--bs-border-default`.
+             * @prop --bs-attachment-card-bg - Card background. Aliased to `--bs-surface-base`.
+             * @prop --bs-attachment-filename-color - Filename text color. Aliased to `--bs-text-default`.
+             * @prop --bs-attachment-badge-bg-pdf - PDF badge background. Aliased to `--bs-badge-bg-error`.
+             * @prop --bs-attachment-badge-bg-document - Document badge background. Aliased to
+             * `--bs-badge-bg-info`.
+             * @prop --bs-attachment-remove-bg - Remove button (neutral icon button) default background.
+             * Aliased to `--bs-button-neutral-container`.
+             * @prop --bs-attachment-remove-hover - Remove button hover background. Aliased to
+             * `--bs-button-neutral-hover`.
+             * @prop --bs-attachment-remove-pressed - Remove button active/pressed background. Aliased to
+             * `--bs-button-neutral-pressed`.
+             * @prop --bs-attachment-remove-focus - Remove button focus outline color. Aliased to
+             * `--bs-border-neutral-focus`.
+             */
+            "bs-attachment": LocalJSX.IntrinsicElements["bs-attachment"] & JSXBase.HTMLAttributes<HTMLBsAttachmentElement>;
+            /**
+             * A horizontally-scrolling row wrapper for one or more `bs-attachment` previews, for slotting into
+             * `bs-composer`'s `attachments` slot when a Genie AI chat message has file attachments.
+             * ## When to use
+             * - Wrapping any number of `bs-attachment` elements the user has attached to a message, so they
+             *   lay out in a single row and scroll horizontally instead of wrapping/overflowing once there
+             *   are more than fit the available width.
+             * ## When not to use
+             * - A single attachment on its own — just render `bs-attachment` directly, this wrapper's
+             *   scroll/fade affordance only matters once there's more content than fits.
+             * @prop --bs-attachment-list-gap - Gap between attachments. Matches the 10px Figma spec (not tied
+             * to the `--bs-spacing-*` scale, which only has 8px/12px neighbors).
+             * @prop --bs-attachment-list-padding - Padding around the row. Aliased to `--bs-spacing-150`.
+             * @prop --bs-attachment-list-fade-color - Color the right-edge fade blends into. Aliased to
+             * `--bs-static-white`.
+             * @prop --bs-attachment-list-fade-width - Width of the right-edge fade overlay. Aliased to
+             * `--bs-spacing-800`.
+             * @prop --bs-attachment-list-scrollbar-thumb - Color of the scrollbar thumb that appears on
+             * hover/focus once the row is scrollable. Aliased to `--bs-neutral-300`.
+             */
+            "bs-attachment-list": LocalJSX.IntrinsicElements["bs-attachment-list"] & JSXBase.HTMLAttributes<HTMLBsAttachmentListElement>;
             /**
              * A small status or category pill, usually paired with a label or list item.
              * ## When to use
@@ -1709,6 +3270,48 @@ declare module "@stencil/core" {
              * - For a dismissible/transient message — use a modal or a dedicated notification component.
              */
             "bs-card": LocalJSX.IntrinsicElements["bs-card"] & JSXBase.HTMLAttributes<HTMLBsCardElement>;
+            /**
+             * A star-rating feedback card shown at the end of a Genie AI chat: a heading/subtitle, a 5-star
+             * rating, an optional comment, and either "Submit feedback" + "Start new chat" (before
+             * submitting) or just "Start new chat" (after).
+             * ## When to use
+             * - Prompting for feedback on a Genie response or chat session, typically after the user ends or
+             *   restarts a conversation.
+             * ## When not to use
+             * - A generic star-rating input elsewhere in the product -- this component's copy and layout are
+             *   purpose-built for the Genie feedback flow, not a reusable rating control.
+             * The heading and subtitle are not freeform props: before submitting, they're always the fixed
+             * "How was your experience..." copy; after submitting, they're determined entirely by `rating`
+             * (1-2 stars reads apologetic, 3 neutral, 4-5 positive), matching the Figma source exactly. Use
+             * `heading`/`subtitle` only if a consuming app genuinely needs to override that copy.
+             * @prop --bs-chatbot-feedback-bg - Card background. Aliased to `--bs-surface-raised`.
+             * @prop --bs-chatbot-feedback-border - Card border color. Aliased to `--bs-border-default`.
+             * @prop --bs-chatbot-feedback-radius - Card corner radius. Aliased to `--bs-border-radius-200`.
+             * @prop --bs-chatbot-feedback-padding-x - Card horizontal padding. Aliased to `--bs-spacing-250`.
+             * @prop --bs-chatbot-feedback-padding-y - Card vertical padding. Aliased to `--bs-spacing-550`.
+             * @prop --bs-chatbot-feedback-max-width - Max width of the card. Matches Figma's 762px.
+             * @prop --bs-chatbot-feedback-gap - Gap between the top content block and the button(s). Aliased
+             * to `--bs-spacing-300`.
+             * @prop --bs-chatbot-feedback-top-gap - Gap between heading/subtitle, stars, and the
+             * textarea/comment within the top block. Aliased to `--bs-spacing-250`.
+             * @prop --bs-chatbot-feedback-heading-color - Aliased to `--bs-text-default`.
+             * @prop --bs-chatbot-feedback-subtitle-color - Aliased to `--bs-text-secondary`.
+             * @prop --bs-chatbot-feedback-star-filled - Filled star color. Aliased to `--bs-color-primary-default`.
+             * @prop --bs-chatbot-feedback-star-empty - Empty star color. Aliased to `--bs-border-neutral-container`.
+             * @prop --bs-chatbot-feedback-comment-color - Submitted comment text color. Aliased to `--bs-text-default`.
+             * @prop --bs-chatbot-feedback-close-hover - Close button hover background. Aliased to `--bs-surface-hover`.
+             * @prop --bs-chatbot-feedback-primary-bg - "Submit feedback" / post-submit "Start new chat"
+             * background. Aliased to `--bs-button-primary-default`.
+             * @prop --bs-chatbot-feedback-primary-bg-hover - Aliased to `--bs-button-primary-hover`.
+             * @prop --bs-chatbot-feedback-primary-bg-disabled - Aliased to `--bs-button-primary-disabled`.
+             * @prop --bs-chatbot-feedback-outlined-border - Pre-submit "Start new chat" border. Aliased to
+             * `--bs-border-primary`.
+             * @prop --bs-chatbot-feedback-outlined-hover - Pre-submit "Start new chat" hover background.
+             * Aliased to `--bs-color-primary-container-hover`.
+             * @prop --bs-chatbot-feedback-outlined-text - Pre-submit "Start new chat" text/icon color.
+             * Aliased to `--bs-text-action`.
+             */
+            "bs-chatbot-feedback": LocalJSX.IntrinsicElements["bs-chatbot-feedback"] & JSXBase.HTMLAttributes<HTMLBsChatbotFeedbackElement>;
             /**
              * The header bar that sits above `bs-composer` in a Genie AI chat panel: the Genie brand mark on
              * the left and four fixed actions (new chat, history, expand, close) on the right.
@@ -1762,6 +3365,35 @@ declare module "@stencil/core" {
              * @prop --bs-chatbot-response-action-sources-line-height - Aliased to `--bs-line-height-body-sm`.
              */
             "bs-chatbot-response-action": LocalJSX.IntrinsicElements["bs-chatbot-response-action"] & JSXBase.HTMLAttributes<HTMLBsChatbotResponseActionElement>;
+            /**
+             * The "Sources" panel shown alongside a Genie AI chat response -- a header with a title, a count
+             * badge, and a collapse chevron, above a stack of `bs-source-link` citation rows.
+             * ## When to use
+             * - Displaying the documents/sources a Genie response cited, typically opened from a "view
+             *   sources" action on a `bs-chatbot-response-action` bar.
+             * ## When not to use
+             * - A generic list container -- this component's header (title + count + collapse) is
+             *   purpose-built for the sources use case.
+             * @prop --bs-chatbot-sources-drawer-bg - Background of the whole panel. Aliased to `--bs-surface-raised`.
+             * @prop --bs-chatbot-sources-drawer-header-shadow - Drop shadow under the header, separating it
+             * from the scrolled list. Aliased to `--bs-shadow-xs`.
+             * @prop --bs-chatbot-sources-drawer-header-padding-x - Aliased to `--bs-spacing-200`.
+             * @prop --bs-chatbot-sources-drawer-header-padding-top - Aliased to `--bs-spacing-150`.
+             * @prop --bs-chatbot-sources-drawer-header-padding-bottom - Aliased to `--bs-spacing-100`.
+             * @prop --bs-chatbot-sources-drawer-heading-color - Aliased to `--bs-text-default`.
+             * @prop --bs-chatbot-sources-drawer-count-bg - Count badge background. Aliased to
+             * `--bs-badge-bg-neutral-container`.
+             * @prop --bs-chatbot-sources-drawer-count-color - Count badge text color. Aliased to
+             * `--bs-badge-text-neutral`.
+             * @prop --bs-chatbot-sources-drawer-collapse-hover - Collapse button background on hover. Aliased
+             * to `--bs-surface-hover`.
+             * @prop --bs-chatbot-sources-drawer-section-gap - Gap between the header and the list. Aliased to
+             * `--bs-spacing-200`.
+             * @prop --bs-chatbot-sources-drawer-list-padding - Horizontal/bottom padding of the list. Aliased
+             * to `--bs-spacing-200`.
+             * @prop --bs-chatbot-sources-drawer-list-gap - Gap between rows. Aliased to `--bs-spacing-50`.
+             */
+            "bs-chatbot-sources-drawer": LocalJSX.IntrinsicElements["bs-chatbot-sources-drawer"] & JSXBase.HTMLAttributes<HTMLBsChatbotSourcesDrawerElement>;
             /**
              * A pill-shaped clickable suggestion chip for a Genie AI chat panel (e.g. "How can I help you?").
              * One instance renders one chip -- to show several suggestion prompts side by side, render
@@ -1827,6 +3459,64 @@ declare module "@stencil/core" {
              * @prop --bs-composer-subtle-pressed - Background of the attach/mic buttons when pressed. Aliased to `--bs-color-neutral-container-pressed`.
              */
             "bs-composer": LocalJSX.IntrinsicElements["bs-composer"] & JSXBase.HTMLAttributes<HTMLBsComposerElement>;
+            /**
+             * A full-width status banner for use directly above `bs-composer`, surfacing a message about the
+             * composer's current state (e.g. a send failure, an informational notice) with an optional
+             * "Continue"-style action button and an optional close button.
+             * ## When to use
+             * - A message tied to the composer itself (send failed, rate-limited, draft restored, etc.) that
+             *   needs to sit directly above it, not a general-purpose alert -- see `CONVENTIONS.md` if this
+             *   library gains a generic banner/alert component later, and prefer that instead once it exists.
+             * ## When not to use
+             * - A toast/snackbar notification unrelated to the composer -- this component is not
+             *   self-dismissing and has no positioning of its own (it's a static block, not an overlay).
+             * @prop --bs-composer-status-banner-radius - Corner radius of the top-left/top-right corners
+             * (bottom corners are square, so this sits flush above `bs-composer`). Aliased to
+             * `--bs-border-radius-150`.
+             * @prop --bs-composer-status-banner-padding-x - Horizontal padding. Aliased to `--bs-spacing-150`.
+             * @prop --bs-composer-status-banner-padding-top - Top padding. Aliased to `--bs-spacing-100`.
+             * @prop --bs-composer-status-banner-padding-bottom - Bottom padding. Aliased to `--bs-spacing-200`.
+             * @prop --bs-composer-status-banner-gap - Gap between the message group and the action/close
+             * controls. Aliased to `--bs-spacing-100`.
+             * @prop --bs-composer-status-banner-icon-gap - Gap between the icon and the message text.
+             * Aliased to `--bs-spacing-75`.
+             * @prop --bs-composer-status-banner-error-bg - Background for `type="error"`. Aliased to
+             * `--bs-color-error-container`.
+             * @prop --bs-composer-status-banner-error-text - Text/icon color for `type="error"`. Aliased to
+             * `--bs-text-error`.
+             * @prop --bs-composer-status-banner-error-action-bg - Action button background for
+             * `type="error"`. Aliased to `--bs-color-error-default`.
+             * @prop --bs-composer-status-banner-error-action-bg-hover - Aliased to `--bs-color-error-hover`.
+             * @prop --bs-composer-status-banner-info-bg - Background for `type="info"`. Aliased to
+             * `--bs-color-info-container`.
+             * @prop --bs-composer-status-banner-info-text - Text/icon color for `type="info"`. Aliased to
+             * `--bs-text-info`.
+             * @prop --bs-composer-status-banner-info-action-bg - Action button background for `type="info"`.
+             * Aliased to `--bs-color-info-default`.
+             * @prop --bs-composer-status-banner-info-action-bg-hover - Aliased to `--bs-color-info-hover`.
+             * @prop --bs-composer-status-banner-neutral-bg - Background for `type="neutral"`. Aliased to
+             * `--bs-color-neutral-container`.
+             * @prop --bs-composer-status-banner-neutral-text - Text/icon color for `type="neutral"`. Aliased
+             * to `--bs-text-default`.
+             * @prop --bs-composer-status-banner-neutral-action-bg - Action button background for
+             * `type="neutral"`. Aliased to `--bs-color-neutral-container`.
+             * @prop --bs-composer-status-banner-neutral-action-bg-hover - Aliased to
+             * `--bs-color-neutral-container-hover`.
+             * @prop --bs-composer-status-banner-neutral-action-border - Action button border for
+             * `type="neutral"` (the only variant whose action button is outlined). Aliased to
+             * `--bs-border-neutral-container`.
+             * @prop --bs-composer-status-banner-warning-bg - Background for `type="warning"`. Aliased to
+             * `--bs-color-warning-container`.
+             * @prop --bs-composer-status-banner-warning-text - Text/icon color for `type="warning"`. Aliased
+             * to `--bs-text-warning`.
+             * @prop --bs-composer-status-banner-warning-action-bg - Action button background for
+             * `type="warning"`. Aliased to `--bs-color-warning-default`.
+             * @prop --bs-composer-status-banner-warning-action-bg-hover - Aliased to
+             * `--bs-color-warning-hover`.
+             * @prop --bs-composer-status-banner-close-hover-bg - Close button hover background (same across
+             * every `type`). Aliased to `--bs-color-neutral-container-hover`.
+             */
+            "bs-composer-status-banner": LocalJSX.IntrinsicElements["bs-composer-status-banner"] & JSXBase.HTMLAttributes<HTMLBsComposerStatusBannerElement>;
             /**
              * A sortable, optionally row-selectable table for tabular data.
              * `columns`, `rows`, and `cellRenderer` are JS-property-only — HTML attributes can only carry
@@ -1840,13 +3530,20 @@ declare module "@stencil/core" {
              */
             "bs-data-table": LocalJSX.IntrinsicElements["bs-data-table"] & JSXBase.HTMLAttributes<HTMLBsDataTableElement>;
             /**
-             * A single-line text field with an optional label, description, and error state.
+             * A single-line text field with an optional label, description, and error state. Also covers a
+             * range of related "field" shapes (number stepper, password reveal, date, dropdown trigger,
+             * select, textarea, chip input, initials, country, and pin) via the `type` prop, since they all
+             * share the same label/description/error/icon-slot chrome.
              * ## When to use
              * - Collecting a single line of free-text, email, password, or numeric input.
+             * - Any of the other supported `type`s (search, date, dropdown, select, textarea, chip, initials,
+             *   country, pin) that share this component's label/description/error chrome.
              * - Pair with `error` for inline validation feedback tied to that specific field.
              * ## When not to use
-             * - Multi-line text — this component has no `textarea` mode.
-             * - A fixed set of choices — use a select/radio/checkbox component instead of free text.
+             * - A fixed set of choices best served by a dedicated radio/checkbox group rather than a single
+             *   field. `type="select"` (native `<select>`) and `type="dropdown"` (a `bs-menu` of
+             *   `bs-menu-item`s from the `options` prop) cover the field-shaped cases; `type="chip"` has no
+             *   options list at all (freeform chip entry).
              */
             "bs-input": LocalJSX.IntrinsicElements["bs-input"] & JSXBase.HTMLAttributes<HTMLBsInputElement>;
             /**
@@ -1897,6 +3594,32 @@ declare module "@stencil/core" {
              *   modal that just gets taller and taller.
              */
             "bs-modal": LocalJSX.IntrinsicElements["bs-modal"] & JSXBase.HTMLAttributes<HTMLBsModalElement>;
+            /**
+             * A single citation row inside `bs-chatbot-sources-drawer` -- a file icon + filename on the first
+             * line, the originating system and version on the second, and a trailing "open" arrow.
+             * ## When to use
+             * - One row per source Genie cited in a response, slotted into `bs-chatbot-sources-drawer`.
+             * ## When not to use
+             * - Outside the sources drawer context -- this is a purpose-built citation row, not a generic
+             *   link/list-item component.
+             * @prop --bs-source-link-radius - Corner radius of the row. Aliased to `--bs-border-radius-150`.
+             * @prop --bs-source-link-padding - Padding around the row. Aliased to `--bs-spacing-150`.
+             * @prop --bs-source-link-gap - Gap between the filename+meta block and the trailing arrow.
+             * Aliased to `--bs-spacing-50`.
+             * @prop --bs-source-link-icon-gap - Gap between the leading icon and the filename text. Aliased
+             * to `--bs-spacing-75`.
+             * @prop --bs-source-link-hover - Row background on hover/focus. Aliased to `--bs-surface-hover`.
+             * @prop --bs-source-link-pressed - Row background while active/pressed. Aliased to
+             * `--bs-surface-pressed`.
+             * @prop --bs-source-link-focus - Focus-visible outline color. Aliased to
+             * `--bs-border-neutral-focus`.
+             * @prop --bs-source-link-filename-color - Filename text color. Aliased to `--bs-text-default`.
+             * @prop --bs-source-link-meta-color - Source/version text color. Aliased to `--bs-text-secondary`.
+             * @prop --bs-source-link-icon-color - File icon and arrow color. Aliased to `--bs-icon-default`.
+             * @prop --bs-source-link-dot-color - Separator dot between source and version. Aliased to
+             * `--bs-text-secondary`.
+             */
+            "bs-source-link": LocalJSX.IntrinsicElements["bs-source-link"] & JSXBase.HTMLAttributes<HTMLBsSourceLinkElement>;
             /**
              * A dark tooltip bubble with a pointer arrow, used to surface a short hint of extra information
              * next to a trigger element.