@brandsync/wc 1.6.0 → 1.8.0

package/dist/types/components.d.ts

@@ -15,6 +15,7 @@ import { BsBreadcrumbSize as BsBreadcrumbSize1 } from "./components/bs-breadcrum
 import { BsButtonSize, BsButtonVariant } from "./components/bs-button/bs-button/bs-button";
 import { BsButtonSize as BsButtonSize1 } from "./components/bs-button/bs-button/bs-button";
 import { BsCardSurface } from "./components/bs-card/bs-card";
+import { BsCarouselTracker } from "./components/bs-carousel/bs-carousel";
 import { BsCheckboxSize } from "./components/bs-checkbox/bs-checkbox";
 import { BsCheckboxSize as BsCheckboxSize1 } from "./components/bs-checkbox/bs-checkbox";
 import { BsChipFilterSize } from "./components/bs-chip/bs-chip-filter/bs-chip-filter";
@@ -24,6 +25,8 @@ import { BsComposerState, BsComposerVariant } from "./components/bs-composer/bs-
 import { BsComposerStatusBannerType } from "./components/bs-composer-status-banner/bs-composer-status-banner";
 import { BsDataTableColumn, BsDataTableRow } from "./components/bs-data-table/bs-data-table";
 import { BsDialogSize } from "./components/bs-dialog/bs-dialog";
+import { BsFileUploadDirection } from "./components/bs-file-upload/bs-file-upload";
+import { BsFileUploadItemState } from "./components/bs-file-upload-item/bs-file-upload-item";
 import { BsIconButtonSize, BsIconButtonVariant } from "./components/bs-button/bs-icon-button/bs-icon-button";
 import { BsLogoBackground, BsLogoVariant } from "./components/bs-logo/bs-logo";
 import { BsNavigationHeaderAlignment } from "./components/ui-shell/bs-navigation-header/bs-navigation-header/bs-navigation-header";
@@ -47,6 +50,7 @@ export { BsBreadcrumbSize as BsBreadcrumbSize1 } from "./components/bs-breadcrum
 export { BsButtonSize, BsButtonVariant } from "./components/bs-button/bs-button/bs-button";
 export { BsButtonSize as BsButtonSize1 } from "./components/bs-button/bs-button/bs-button";
 export { BsCardSurface } from "./components/bs-card/bs-card";
+export { BsCarouselTracker } from "./components/bs-carousel/bs-carousel";
 export { BsCheckboxSize } from "./components/bs-checkbox/bs-checkbox";
 export { BsCheckboxSize as BsCheckboxSize1 } from "./components/bs-checkbox/bs-checkbox";
 export { BsChipFilterSize } from "./components/bs-chip/bs-chip-filter/bs-chip-filter";
@@ -56,6 +60,8 @@ export { BsComposerState, BsComposerVariant } from "./components/bs-composer/bs-
 export { BsComposerStatusBannerType } from "./components/bs-composer-status-banner/bs-composer-status-banner";
 export { BsDataTableColumn, BsDataTableRow } from "./components/bs-data-table/bs-data-table";
 export { BsDialogSize } from "./components/bs-dialog/bs-dialog";
+export { BsFileUploadDirection } from "./components/bs-file-upload/bs-file-upload";
+export { BsFileUploadItemState } from "./components/bs-file-upload-item/bs-file-upload-item";
 export { BsIconButtonSize, BsIconButtonVariant } from "./components/bs-button/bs-icon-button/bs-icon-button";
 export { BsLogoBackground, BsLogoVariant } from "./components/bs-logo/bs-logo";
 export { BsNavigationHeaderAlignment } from "./components/ui-shell/bs-navigation-header/bs-navigation-header/bs-navigation-header";
@@ -488,7 +494,7 @@ export namespace Components {
          */
         "size": BsButtonSize;
         /**
-          * Native `<button>` type.
+          * Button type. `submit` submits the surrounding `<form>` (via `requestSubmit()`, so validation runs); `reset` resets it; `button` (default) does nothing on its own.
           * @default 'button'
          */
         "type": 'button' | 'submit' | 'reset';
@@ -538,6 +544,82 @@ export namespace Components {
          */
         "surface": BsCardSurface;
     }
+    /**
+     * A carousel that shows a page of slides at a time, with a tracker (dots or numbered blocks) and
+     * previous/next controls, and optional auto-advance with a Pause/Play button.
+     * Slides are the default slot's direct children (a `bs-card`, an image, anything). The carousel
+     * shows `slidesPerView` of them at once, so there are `ceil(slides / slidesPerView)` pages. It
+     * manages two things on those slide elements: the `hidden` attribute (off-page slides are hidden,
+     * so they leave the tab order and the accessibility tree) and, only when not already set,
+     * `role="group"`, `aria-roledescription="slide"` and an `aria-label` of "n of N".
+     * Composes `bs-pagination` (`tracker="numbers"`), `bs-icon-button` (previous/next for
+     * `tracker="dots"`) and `bs-button` (Pause/Play) rather than re-implementing them.
+     * ## When to use
+     * - Browsing a set of related items (cards, images, announcements) where only a few fit at once.
+     * - Rotating promotional or highlight content, where auto-advance with a Pause control is wanted.
+     * ## When not to use
+     * - Content users must see in full to complete a task -- hiding it behind paging hurts discovery;
+     *   lay it out in a list or grid instead.
+     * - A strict sequence of steps -- use `bs-stepper`.
+     * - Paging through a large, addressable result set -- use `bs-pagination`.
+     */
+    interface BsCarousel {
+        /**
+          * Auto-advances to the next page every `interval` ms, looping from the last page to the first. Off by default. The Pause/Play button is only rendered when this is set. Auto-advance also stops while the pointer is over the carousel or focus is inside it, and starts paused for users who prefer reduced motion.
+          * @default false
+         */
+        "autoplay": boolean;
+        /**
+          * The visible page, 1-based (same convention as `bs-pagination`). Mutable so the carousel advances it itself (tracker, previous/next, autoplay). Clamped to the available pages.
+          * @default 1
+         */
+        "currentPage": number;
+        /**
+          * Milliseconds between auto-advances, when `autoplay` is set.
+          * @default 5000
+         */
+        "interval": number;
+        /**
+          * Accessible name of the carousel region (e.g. "Featured articles").
+          * @default 'Carousel'
+         */
+        "label": string;
+        /**
+          * Accessible name of the next button (`tracker="dots"`) -- override for localisation.
+          * @default 'Next slide'
+         */
+        "nextLabel": string;
+        /**
+          * Label of the Pause/Play button while auto-advance is running.
+          * @default 'Pause'
+         */
+        "pauseLabel": string;
+        /**
+          * Whether auto-advance is paused by the user (the Pause/Play button). Mutable and reflected so the state is visible to CSS and settable from outside. Only meaningful with `autoplay`.
+          * @default false
+         */
+        "paused": boolean;
+        /**
+          * Label of the Pause/Play button while auto-advance is paused.
+          * @default 'Play'
+         */
+        "playLabel": string;
+        /**
+          * Accessible name of the previous button (`tracker="dots"`) -- override for localisation.
+          * @default 'Previous slide'
+         */
+        "previousLabel": string;
+        /**
+          * How many slides are visible at once. The tracker counts pages: `ceil(slides / slidesPerView)`.
+          * @default 3
+         */
+        "slidesPerView": number;
+        /**
+          * Which tracker to show under the slides. `dots` is a compact dot row between previous/next buttons (the dots are an indicator, not buttons); `numbers` is a numbered `bs-pagination` where each page can be jumped to directly.
+          * @default 'dots'
+         */
+        "tracker": BsCarouselTracker;
+    }
     /**
      * 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
@@ -792,11 +874,25 @@ export namespace Components {
           * @default false
          */
         "indeterminate": boolean;
+        /**
+          * The `name` the value is submitted under in a surrounding `<form>`'s `FormData`.
+         */
+        "name"?: string;
+        /**
+          * Marks the checkbox as required: the surrounding form fails validation while unchecked.
+          * @default false
+         */
+        "required": boolean;
         /**
           * Sizing scale. Controls the box's width/height and border width; corner radius is constant across all sizes.
           * @default 'lg'
          */
         "size": BsCheckboxSize;
+        /**
+          * The value submitted when checked (native checkbox default: `"on"`).
+          * @default 'on'
+         */
+        "value": string;
     }
     /**
      * A shape-matched loading placeholder for `bs-checkbox`, shown while the real label text isn't
@@ -1152,6 +1248,111 @@ export namespace Components {
          */
         "size": BsDialogSize;
     }
+    /**
+     * A file dropzone: drag files onto it, or press "Browse file" to open the file picker. It reports
+     * the chosen files and does nothing else -- the consuming app owns the upload itself and shows its
+     * progress with `bs-file-upload-item`.
+     * ## When to use
+     * - Letting users add one or more files (documents, images) to upload.
+     * ## When not to use
+     * - Attaching files to a chat message -- see `bs-composer` / `bs-attachment`.
+     * - A file input that must submit with a native `<form>`: this component is **not**
+     *   form-associated. Read the files from `bsFilesSelect` and submit them yourself.
+     */
+    interface BsFileUpload {
+        /**
+          * Which files are accepted, same syntax as the native `accept` attribute: comma-separated extensions (`.pdf`), MIME types (`image/png`) or wildcards (`image/*`). Applied to the picker and also to dropped files, which the browser does not filter.
+         */
+        "accept"?: string;
+        /**
+          * Label of the browse button. Override for localisation.
+          * @default 'Browse file'
+         */
+        "buttonLabel": string;
+        /**
+          * Guidelines under the heading (e.g. "PDF or JPG, up to 8MB").
+         */
+        "description"?: string;
+        /**
+          * Layout: icon beside the text (`horizontal`) or stacked above it, centered (`vertical`).
+          * @default 'horizontal'
+         */
+        "direction": BsFileUploadDirection;
+        /**
+          * Disables the browse button and ignores drops.
+          * @default false
+         */
+        "disabled": boolean;
+        /**
+          * Whether a file is currently being dragged over the dropzone (the Figma "Drop" state). Set by the component during a drag; mutable and reflected so it can also be set to show the state statically.
+          * @default false
+         */
+        "dragging": boolean;
+        /**
+          * Heading text (e.g. "Upload your documents").
+         */
+        "heading"?: string;
+        /**
+          * Allows selecting/dropping more than one file. Without it only the first file is taken.
+          * @default false
+         */
+        "multiple": boolean;
+    }
+    /**
+     * One file in an upload list: a thumbnail, the file name and size, a status line (a progress bar
+     * while uploading, or a success / error message) and an action button (cancel while uploading or
+     * after an error, remove once uploaded).
+     * Presentational only -- the consuming app owns the upload and drives `state`, `progress` and
+     * `message` from it. Pair with `bs-file-upload` (the dropzone that picks the files).
+     * ## When to use
+     * - Showing the status of each file the user has added, in a list under a `bs-file-upload`.
+     * ## When not to use
+     * - Attaching files to a chat message -- use `bs-attachment`.
+     */
+    interface BsFileUploadItem {
+        /**
+          * Accessible name of the cancel button (`loading`, `in-progress`, `error`).
+          * @default 'Cancel upload'
+         */
+        "cancelLabel": string;
+        /**
+          * The file name.
+          * @default ''
+         */
+        "fileName": string;
+        /**
+          * The file size, already formatted (e.g. "8MB").
+         */
+        "fileSize"?: string;
+        /**
+          * The status text. Defaults per state: "Loading..." (`loading`), "{progress}% uploaded" (`in-progress`), "Upload failed" (`error`), "File uploaded successfully" (`success`). Provide your own for localisation or a specific error.
+         */
+        "message"?: string;
+        /**
+          * Upload progress, 0-100. Only used when `state="in-progress"`.
+          * @default 0
+         */
+        "progress": number;
+        /**
+          * Accessible name of the remove button (`success`).
+          * @default 'Remove file'
+         */
+        "removeLabel": string;
+        /**
+          * Where the upload is. `loading` = working with no known percentage (indeterminate bar); `in-progress` = uploading with a known `progress`; `error` and `success` are final.
+          * @default 'loading'
+         */
+        "state": BsFileUploadItemState;
+        /**
+          * Alt text for `thumbnailSrc`. Leave empty when the file name already says it all.
+          * @default ''
+         */
+        "thumbnailAlt": string;
+        /**
+          * A preview image of the file. Shown instead of the placeholder icon when set.
+         */
+        "thumbnailSrc"?: string;
+    }
     /**
      * A clickable, icon-only action element -- the icon-only sibling of `bs-button`, sharing the same
      * 8 visual variants and color language, but ALWAYS rendering just a single icon, never a label.
@@ -1187,7 +1388,7 @@ export namespace Components {
          */
         "size": BsIconButtonSize;
         /**
-          * Native `<button>` type.
+          * Button type. `submit` submits the surrounding `<form>` (via `requestSubmit()`, so validation runs); `reset` resets it; `button` (default) does nothing on its own.
           * @default 'button'
          */
         "type": 'button' | 'submit' | 'reset';
@@ -1235,6 +1436,10 @@ export namespace Components {
           * @default false
          */
         "selected": boolean;
+        /**
+          * Set by a parent `bs-tabs` to implement roving tabindex (only one tab in the group is in the Tab order; arrow keys move between them). Left `undefined` for a standalone tab, which stays a normal tab stop.
+         */
+        "tabbable"?: boolean;
     }
     /**
      * A single-line text field with an optional label, description, and error state. Also covers a
@@ -1293,6 +1498,10 @@ export namespace Components {
           * Minimum value for `type="number"`'s stepper buttons.
          */
         "min"?: number;
+        /**
+          * The `name` the value is submitted under in a surrounding `<form>`'s `FormData`.
+         */
+        "name"?: string;
         /**
           * 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
@@ -1660,6 +1869,11 @@ export namespace Components {
      *   weight of a ring.
      */
     interface BsProgress {
+        /**
+          * Accessible name for the progress bar (e.g. "Uploading report"). Required for assistive tech -- a `role="progressbar"` with no name is an axe-core `aria-progressbar-name` violation. Setting `aria-label` on the host doesn't reach the inner element across the shadow boundary, so this prop binds it directly -- same pattern as `bs-button`'s `ariaLabel`.
+          * @default null
+         */
+        "ariaLabel": string | null;
         /**
           * Shows the `${value}%` label below the ring. Only takes effect for `type="determinate"` -- `indeterminate` never shows a label regardless of this prop, since there's no percentage to show. Defaults to `true`.
           * @default true
@@ -1701,6 +1915,11 @@ export namespace Components {
      *   weight of a bar.
      */
     interface BsProgressLinear {
+        /**
+          * Accessible name for the progress bar (e.g. "Uploading report"). Required for assistive tech -- a `role="progressbar"` with no name is an axe-core `aria-progressbar-name` violation. Setting `aria-label` on the host doesn't reach the inner element across the shadow boundary, so this prop binds it directly -- same pattern as `bs-button`'s `ariaLabel`.
+          * @default null
+         */
+        "ariaLabel": string | null;
         /**
           * Shows the slotted label below the bar. When `false`, or when no content is slotted, the label wrapper isn't rendered at all. Defaults to `true`.
           * @default true
@@ -1744,7 +1963,7 @@ export namespace Components {
          */
         "disabled": boolean;
         /**
-          * The native radio input's `name` attribute. Passed straight through to the native input inside. NOTE: because each `bs-radio` renders its own shadow root, native `<input type="radio">` mutual-exclusion grouping (which the HTML spec scopes to a single DOM tree) does NOT extend across separate `bs-radio` instances sharing the same `name` -- checking one will not natively uncheck another. Within a single instance this still behaves like a normal radio input. See bs-radio.mdx's Accessibility section for this known gap; consumers building a group currently need to manage mutual exclusivity themselves (e.g. via `bsChange`) until a `bs-radio-group` wrapper exists.
+          * The native radio input's `name` attribute. Passed straight through to the native input inside. Also the group key: `bs-radio` elements sharing a `name` within the same root (document or shadow root) behave as one radio group -- checking one unchecks the others, arrow keys move between them, and only one is in the tab order. Native grouping can't cross each radio's own shadow root, so this component implements it itself.
          */
         "name": string;
         /**
@@ -1793,6 +2012,10 @@ export namespace Components {
           * @default 0
          */
         "min": number;
+        /**
+          * The `name` the value is submitted under in a surrounding `<form>`'s `FormData`. `type="range"` submits two entries under this name: the start value, then the end value.
+         */
+        "name"?: string;
         /**
           * Number of equal divisions marked by tick lines along the track, for `type="segmented"` only. The first tick (at the very start of the track) is rendered with `opacity: 0` to keep the tick spacing math consistent while not visually doubling up with the track's own start edge -- this matches the design spec, not a bug.
           * @default 10
@@ -2029,11 +2252,20 @@ export namespace Components {
           * @default false
          */
         "disabled": boolean;
+        /**
+          * The `name` the value is submitted under in a surrounding `<form>`'s `FormData`.
+         */
+        "name"?: string;
         /**
           * Sizing scale. Controls the track's width/height and the knob's diameter.
           * @default 'lg'
          */
         "size": BsSwitchSize;
+        /**
+          * The value submitted when on (native checkbox default: `"on"`).
+          * @default 'on'
+         */
+        "value": string;
     }
     /**
      * A single tab button -- an optional icon plus a text label, rendered as a real `<button>` so it
@@ -2074,6 +2306,10 @@ export namespace Components {
           * @default false
          */
         "selected": boolean;
+        /**
+          * Set by a parent `bs-tabs` to implement roving tabindex (only one tab in the group is in the Tab order; arrow keys move between them). Left `undefined` for a standalone tab, which stays a normal tab stop.
+         */
+        "tabbable"?: boolean;
     }
     /**
      * A tab-group wrapper: owns `role="tablist"` and coordinates selection across its slotted
@@ -2162,6 +2398,10 @@ export interface BsAttachmentCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsAttachmentElement;
 }
+export interface BsCarouselCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsCarouselElement;
+}
 export interface BsChatbotFeedbackCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsChatbotFeedbackElement;
@@ -2210,6 +2450,14 @@ export interface BsDialogCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsDialogElement;
 }
+export interface BsFileUploadCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsFileUploadElement;
+}
+export interface BsFileUploadItemCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBsFileUploadItemElement;
+}
 export interface BsInlineTabCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBsInlineTabElement;
@@ -2622,6 +2870,43 @@ declare global {
         prototype: HTMLBsCardElement;
         new (): HTMLBsCardElement;
     };
+    interface HTMLBsCarouselElementEventMap {
+        "bsPageChange": number;
+        "bsPauseChange": boolean;
+    }
+    /**
+     * A carousel that shows a page of slides at a time, with a tracker (dots or numbered blocks) and
+     * previous/next controls, and optional auto-advance with a Pause/Play button.
+     * Slides are the default slot's direct children (a `bs-card`, an image, anything). The carousel
+     * shows `slidesPerView` of them at once, so there are `ceil(slides / slidesPerView)` pages. It
+     * manages two things on those slide elements: the `hidden` attribute (off-page slides are hidden,
+     * so they leave the tab order and the accessibility tree) and, only when not already set,
+     * `role="group"`, `aria-roledescription="slide"` and an `aria-label` of "n of N".
+     * Composes `bs-pagination` (`tracker="numbers"`), `bs-icon-button` (previous/next for
+     * `tracker="dots"`) and `bs-button` (Pause/Play) rather than re-implementing them.
+     * ## When to use
+     * - Browsing a set of related items (cards, images, announcements) where only a few fit at once.
+     * - Rotating promotional or highlight content, where auto-advance with a Pause control is wanted.
+     * ## When not to use
+     * - Content users must see in full to complete a task -- hiding it behind paging hurts discovery;
+     *   lay it out in a list or grid instead.
+     * - A strict sequence of steps -- use `bs-stepper`.
+     * - Paging through a large, addressable result set -- use `bs-pagination`.
+     */
+    interface HTMLBsCarouselElement extends Components.BsCarousel, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsCarouselElementEventMap>(type: K, listener: (this: HTMLBsCarouselElement, ev: BsCarouselCustomEvent<HTMLBsCarouselElementEventMap[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 HTMLBsCarouselElementEventMap>(type: K, listener: (this: HTMLBsCarouselElement, ev: BsCarouselCustomEvent<HTMLBsCarouselElementEventMap[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 HTMLBsCarouselElement: {
+        prototype: HTMLBsCarouselElement;
+        new (): HTMLBsCarouselElement;
+    };
     interface HTMLBsChatbotFeedbackElementEventMap {
         "bsRatingChange": number;
         "bsCommentInput": string;
@@ -3202,6 +3487,64 @@ declare global {
         prototype: HTMLBsDialogElement;
         new (): HTMLBsDialogElement;
     };
+    interface HTMLBsFileUploadElementEventMap {
+        "bsFilesSelect": File[];
+        "bsFilesReject": File[];
+    }
+    /**
+     * A file dropzone: drag files onto it, or press "Browse file" to open the file picker. It reports
+     * the chosen files and does nothing else -- the consuming app owns the upload itself and shows its
+     * progress with `bs-file-upload-item`.
+     * ## When to use
+     * - Letting users add one or more files (documents, images) to upload.
+     * ## When not to use
+     * - Attaching files to a chat message -- see `bs-composer` / `bs-attachment`.
+     * - A file input that must submit with a native `<form>`: this component is **not**
+     *   form-associated. Read the files from `bsFilesSelect` and submit them yourself.
+     */
+    interface HTMLBsFileUploadElement extends Components.BsFileUpload, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsFileUploadElementEventMap>(type: K, listener: (this: HTMLBsFileUploadElement, ev: BsFileUploadCustomEvent<HTMLBsFileUploadElementEventMap[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 HTMLBsFileUploadElementEventMap>(type: K, listener: (this: HTMLBsFileUploadElement, ev: BsFileUploadCustomEvent<HTMLBsFileUploadElementEventMap[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 HTMLBsFileUploadElement: {
+        prototype: HTMLBsFileUploadElement;
+        new (): HTMLBsFileUploadElement;
+    };
+    interface HTMLBsFileUploadItemElementEventMap {
+        "bsCancel": void;
+        "bsRemove": void;
+    }
+    /**
+     * One file in an upload list: a thumbnail, the file name and size, a status line (a progress bar
+     * while uploading, or a success / error message) and an action button (cancel while uploading or
+     * after an error, remove once uploaded).
+     * Presentational only -- the consuming app owns the upload and drives `state`, `progress` and
+     * `message` from it. Pair with `bs-file-upload` (the dropzone that picks the files).
+     * ## When to use
+     * - Showing the status of each file the user has added, in a list under a `bs-file-upload`.
+     * ## When not to use
+     * - Attaching files to a chat message -- use `bs-attachment`.
+     */
+    interface HTMLBsFileUploadItemElement extends Components.BsFileUploadItem, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBsFileUploadItemElementEventMap>(type: K, listener: (this: HTMLBsFileUploadItemElement, ev: BsFileUploadItemCustomEvent<HTMLBsFileUploadItemElementEventMap[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 HTMLBsFileUploadItemElementEventMap>(type: K, listener: (this: HTMLBsFileUploadItemElement, ev: BsFileUploadItemCustomEvent<HTMLBsFileUploadItemElementEventMap[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 HTMLBsFileUploadItemElement: {
+        prototype: HTMLBsFileUploadItemElement;
+        new (): HTMLBsFileUploadItemElement;
+    };
     /**
      * A clickable, icon-only action element -- the icon-only sibling of `bs-button`, sharing the same
      * 8 visual variants and color language, but ALWAYS rendering just a single icon, never a label.
@@ -3935,6 +4278,7 @@ declare global {
         "bs-button": HTMLBsButtonElement;
         "bs-button-skeleton": HTMLBsButtonSkeletonElement;
         "bs-card": HTMLBsCardElement;
+        "bs-carousel": HTMLBsCarouselElement;
         "bs-chatbot-feedback": HTMLBsChatbotFeedbackElement;
         "bs-chatbot-header": HTMLBsChatbotHeaderElement;
         "bs-chatbot-response-action": HTMLBsChatbotResponseActionElement;
@@ -3949,6 +4293,8 @@ declare global {
         "bs-composer-status-banner": HTMLBsComposerStatusBannerElement;
         "bs-data-table": HTMLBsDataTableElement;
         "bs-dialog": HTMLBsDialogElement;
+        "bs-file-upload": HTMLBsFileUploadElement;
+        "bs-file-upload-item": HTMLBsFileUploadItemElement;
         "bs-icon-button": HTMLBsIconButtonElement;
         "bs-inline-tab": HTMLBsInlineTabElement;
         "bs-input": HTMLBsInputElement;
@@ -4395,13 +4741,21 @@ declare namespace LocalJSX {
           * @default false
          */
         "disabled"?: boolean;
+        /**
+          * The `id` of a `<form>` element to associate this element with.
+         */
+        "form"?: string;
+        /**
+          * The name of the element, used when submitting an HTML form.
+         */
+        "name"?: string;
         /**
           * Sizing scale.
           * @default 'md'
          */
         "size"?: BsButtonSize;
         /**
-          * Native `<button>` type.
+          * Button type. `submit` submits the surrounding `<form>` (via `requestSubmit()`, so validation runs); `reset` resets it; `button` (default) does nothing on its own.
           * @default 'button'
          */
         "type"?: 'button' | 'submit' | 'reset';
@@ -4451,6 +4805,90 @@ declare namespace LocalJSX {
          */
         "surface"?: BsCardSurface;
     }
+    /**
+     * A carousel that shows a page of slides at a time, with a tracker (dots or numbered blocks) and
+     * previous/next controls, and optional auto-advance with a Pause/Play button.
+     * Slides are the default slot's direct children (a `bs-card`, an image, anything). The carousel
+     * shows `slidesPerView` of them at once, so there are `ceil(slides / slidesPerView)` pages. It
+     * manages two things on those slide elements: the `hidden` attribute (off-page slides are hidden,
+     * so they leave the tab order and the accessibility tree) and, only when not already set,
+     * `role="group"`, `aria-roledescription="slide"` and an `aria-label` of "n of N".
+     * Composes `bs-pagination` (`tracker="numbers"`), `bs-icon-button` (previous/next for
+     * `tracker="dots"`) and `bs-button` (Pause/Play) rather than re-implementing them.
+     * ## When to use
+     * - Browsing a set of related items (cards, images, announcements) where only a few fit at once.
+     * - Rotating promotional or highlight content, where auto-advance with a Pause control is wanted.
+     * ## When not to use
+     * - Content users must see in full to complete a task -- hiding it behind paging hurts discovery;
+     *   lay it out in a list or grid instead.
+     * - A strict sequence of steps -- use `bs-stepper`.
+     * - Paging through a large, addressable result set -- use `bs-pagination`.
+     */
+    interface BsCarousel {
+        /**
+          * Auto-advances to the next page every `interval` ms, looping from the last page to the first. Off by default. The Pause/Play button is only rendered when this is set. Auto-advance also stops while the pointer is over the carousel or focus is inside it, and starts paused for users who prefer reduced motion.
+          * @default false
+         */
+        "autoplay"?: boolean;
+        /**
+          * The visible page, 1-based (same convention as `bs-pagination`). Mutable so the carousel advances it itself (tracker, previous/next, autoplay). Clamped to the available pages.
+          * @default 1
+         */
+        "currentPage"?: number;
+        /**
+          * Milliseconds between auto-advances, when `autoplay` is set.
+          * @default 5000
+         */
+        "interval"?: number;
+        /**
+          * Accessible name of the carousel region (e.g. "Featured articles").
+          * @default 'Carousel'
+         */
+        "label"?: string;
+        /**
+          * Accessible name of the next button (`tracker="dots"`) -- override for localisation.
+          * @default 'Next slide'
+         */
+        "nextLabel"?: string;
+        /**
+          * Fires after the visible page changes via the tracker, previous/next or autoplay, with the new 1-based page.
+         */
+        "onBsPageChange"?: (event: BsCarouselCustomEvent<number>) => void;
+        /**
+          * Fires when the user toggles the Pause/Play button, with the new `paused` value.
+         */
+        "onBsPauseChange"?: (event: BsCarouselCustomEvent<boolean>) => void;
+        /**
+          * Label of the Pause/Play button while auto-advance is running.
+          * @default 'Pause'
+         */
+        "pauseLabel"?: string;
+        /**
+          * Whether auto-advance is paused by the user (the Pause/Play button). Mutable and reflected so the state is visible to CSS and settable from outside. Only meaningful with `autoplay`.
+          * @default false
+         */
+        "paused"?: boolean;
+        /**
+          * Label of the Pause/Play button while auto-advance is paused.
+          * @default 'Play'
+         */
+        "playLabel"?: string;
+        /**
+          * Accessible name of the previous button (`tracker="dots"`) -- override for localisation.
+          * @default 'Previous slide'
+         */
+        "previousLabel"?: string;
+        /**
+          * How many slides are visible at once. The tracker counts pages: `ceil(slides / slidesPerView)`.
+          * @default 3
+         */
+        "slidesPerView"?: number;
+        /**
+          * Which tracker to show under the slides. `dots` is a compact dot row between previous/next buttons (the dots are an indicator, not buttons); `numbers` is a numbered `bs-pagination` where each page can be jumped to directly.
+          * @default 'dots'
+         */
+        "tracker"?: BsCarouselTracker;
+    }
     /**
      * 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
@@ -4768,20 +5206,38 @@ declare namespace LocalJSX {
           * @default false
          */
         "error"?: boolean;
+        /**
+          * The `id` of a `<form>` element to associate this element with.
+         */
+        "form"?: string;
         /**
           * Whether the checkbox is in the indeterminate ("partially selected") state -- shows a minus icon instead of a check, and takes visual precedence over `checked`. Unlike `checked`, native checkboxes have no `indeterminate` HTML attribute; it can only be set as a JS property on the element. This `@Prop` still works as an attribute for the *host* (`<bs-checkbox>`) since that's this component's own reflected state, not the native control's -- the native `<input>` inside has its `.indeterminate` property set imperatively in `componentDidLoad`/`componentDidUpdate`.
           * @default false
          */
         "indeterminate"?: boolean;
+        /**
+          * The `name` the value is submitted under in a surrounding `<form>`'s `FormData`.
+         */
+        "name"?: string;
         /**
           * Emitted when the checked state changes via user interaction, with the new `checked` value.
          */
         "onBsChange"?: (event: BsCheckboxCustomEvent<boolean>) => void;
+        /**
+          * Marks the checkbox as required: the surrounding form fails validation while unchecked.
+          * @default false
+         */
+        "required"?: boolean;
         /**
           * Sizing scale. Controls the box's width/height and border width; corner radius is constant across all sizes.
           * @default 'lg'
          */
         "size"?: BsCheckboxSize;
+        /**
+          * The value submitted when checked (native checkbox default: `"on"`).
+          * @default 'on'
+         */
+        "value"?: string;
     }
     /**
      * A shape-matched loading placeholder for `bs-checkbox`, shown while the real label text isn't
@@ -5180,6 +5636,127 @@ declare namespace LocalJSX {
          */
         "size"?: BsDialogSize;
     }
+    /**
+     * A file dropzone: drag files onto it, or press "Browse file" to open the file picker. It reports
+     * the chosen files and does nothing else -- the consuming app owns the upload itself and shows its
+     * progress with `bs-file-upload-item`.
+     * ## When to use
+     * - Letting users add one or more files (documents, images) to upload.
+     * ## When not to use
+     * - Attaching files to a chat message -- see `bs-composer` / `bs-attachment`.
+     * - A file input that must submit with a native `<form>`: this component is **not**
+     *   form-associated. Read the files from `bsFilesSelect` and submit them yourself.
+     */
+    interface BsFileUpload {
+        /**
+          * Which files are accepted, same syntax as the native `accept` attribute: comma-separated extensions (`.pdf`), MIME types (`image/png`) or wildcards (`image/*`). Applied to the picker and also to dropped files, which the browser does not filter.
+         */
+        "accept"?: string;
+        /**
+          * Label of the browse button. Override for localisation.
+          * @default 'Browse file'
+         */
+        "buttonLabel"?: string;
+        /**
+          * Guidelines under the heading (e.g. "PDF or JPG, up to 8MB").
+         */
+        "description"?: string;
+        /**
+          * Layout: icon beside the text (`horizontal`) or stacked above it, centered (`vertical`).
+          * @default 'horizontal'
+         */
+        "direction"?: BsFileUploadDirection;
+        /**
+          * Disables the browse button and ignores drops.
+          * @default false
+         */
+        "disabled"?: boolean;
+        /**
+          * Whether a file is currently being dragged over the dropzone (the Figma "Drop" state). Set by the component during a drag; mutable and reflected so it can also be set to show the state statically.
+          * @default false
+         */
+        "dragging"?: boolean;
+        /**
+          * Heading text (e.g. "Upload your documents").
+         */
+        "heading"?: string;
+        /**
+          * Allows selecting/dropping more than one file. Without it only the first file is taken.
+          * @default false
+         */
+        "multiple"?: boolean;
+        /**
+          * Fires with files that were not taken: they didn't match `accept`, or were extra files dropped while `multiple` is off.
+         */
+        "onBsFilesReject"?: (event: BsFileUploadCustomEvent<File[]>) => void;
+        /**
+          * Fires with the accepted files, after the picker closes or files are dropped.
+         */
+        "onBsFilesSelect"?: (event: BsFileUploadCustomEvent<File[]>) => void;
+    }
+    /**
+     * One file in an upload list: a thumbnail, the file name and size, a status line (a progress bar
+     * while uploading, or a success / error message) and an action button (cancel while uploading or
+     * after an error, remove once uploaded).
+     * Presentational only -- the consuming app owns the upload and drives `state`, `progress` and
+     * `message` from it. Pair with `bs-file-upload` (the dropzone that picks the files).
+     * ## When to use
+     * - Showing the status of each file the user has added, in a list under a `bs-file-upload`.
+     * ## When not to use
+     * - Attaching files to a chat message -- use `bs-attachment`.
+     */
+    interface BsFileUploadItem {
+        /**
+          * Accessible name of the cancel button (`loading`, `in-progress`, `error`).
+          * @default 'Cancel upload'
+         */
+        "cancelLabel"?: string;
+        /**
+          * The file name.
+          * @default ''
+         */
+        "fileName"?: string;
+        /**
+          * The file size, already formatted (e.g. "8MB").
+         */
+        "fileSize"?: string;
+        /**
+          * The status text. Defaults per state: "Loading..." (`loading`), "{progress}% uploaded" (`in-progress`), "Upload failed" (`error`), "File uploaded successfully" (`success`). Provide your own for localisation or a specific error.
+         */
+        "message"?: string;
+        /**
+          * Fires when the cancel button is clicked (`loading`, `in-progress`, `error`). The consumer stops the upload and removes the item.
+         */
+        "onBsCancel"?: (event: BsFileUploadItemCustomEvent<void>) => void;
+        /**
+          * Fires when the remove button is clicked (`success`). The consumer removes the file.
+         */
+        "onBsRemove"?: (event: BsFileUploadItemCustomEvent<void>) => void;
+        /**
+          * Upload progress, 0-100. Only used when `state="in-progress"`.
+          * @default 0
+         */
+        "progress"?: number;
+        /**
+          * Accessible name of the remove button (`success`).
+          * @default 'Remove file'
+         */
+        "removeLabel"?: string;
+        /**
+          * Where the upload is. `loading` = working with no known percentage (indeterminate bar); `in-progress` = uploading with a known `progress`; `error` and `success` are final.
+          * @default 'loading'
+         */
+        "state"?: BsFileUploadItemState;
+        /**
+          * Alt text for `thumbnailSrc`. Leave empty when the file name already says it all.
+          * @default ''
+         */
+        "thumbnailAlt"?: string;
+        /**
+          * A preview image of the file. Shown instead of the placeholder icon when set.
+         */
+        "thumbnailSrc"?: string;
+    }
     /**
      * A clickable, icon-only action element -- the icon-only sibling of `bs-button`, sharing the same
      * 8 visual variants and color language, but ALWAYS rendering just a single icon, never a label.
@@ -5209,13 +5786,21 @@ declare namespace LocalJSX {
           * @default false
          */
         "disabled"?: boolean;
+        /**
+          * The `id` of a `<form>` element to associate this element with.
+         */
+        "form"?: string;
+        /**
+          * The name of the element, used when submitting an HTML form.
+         */
+        "name"?: string;
         /**
           * Sizing scale. `xs` (16px, an 8px icon) is a distinct, much smaller tier meant for compact chip/tag "remove" controls, not just a smaller toolbar button -- verified against a separate Figma redline (EG BrandSync UI Kit v1.5, node 20731:18427) from the one `sm`/`md`/`lg` were built against.
           * @default 'md'
          */
         "size"?: BsIconButtonSize;
         /**
-          * Native `<button>` type.
+          * Button type. `submit` submits the surrounding `<form>` (via `requestSubmit()`, so validation runs); `reset` resets it; `button` (default) does nothing on its own.
           * @default 'button'
          */
         "type"?: 'button' | 'submit' | 'reset';
@@ -5267,6 +5852,10 @@ declare namespace LocalJSX {
           * @default false
          */
         "selected"?: boolean;
+        /**
+          * Set by a parent `bs-tabs` to implement roving tabindex (only one tab in the group is in the Tab order; arrow keys move between them). Left `undefined` for a standalone tab, which stays a normal tab stop.
+         */
+        "tabbable"?: boolean;
     }
     /**
      * A single-line text field with an optional label, description, and error state. Also covers a
@@ -5306,6 +5895,10 @@ declare namespace LocalJSX {
          */
         "disabled"?: boolean;
         "error"?: string;
+        /**
+          * The `id` of a `<form>` element to associate this element with.
+         */
+        "form"?: 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 ''
@@ -5325,6 +5918,10 @@ declare namespace LocalJSX {
           * Minimum value for `type="number"`'s stepper buttons.
          */
         "min"?: number;
+        /**
+          * The `name` the value is submitted under in a surrounding `<form>`'s `FormData`.
+         */
+        "name"?: string;
         "onBsChange"?: (event: BsInputCustomEvent<string>) => void;
         /**
           * Emitted when a chip is committed (Enter pressed in the draft input) for `type="chip"`.
@@ -5738,6 +6335,11 @@ declare namespace LocalJSX {
      *   weight of a ring.
      */
     interface BsProgress {
+        /**
+          * Accessible name for the progress bar (e.g. "Uploading report"). Required for assistive tech -- a `role="progressbar"` with no name is an axe-core `aria-progressbar-name` violation. Setting `aria-label` on the host doesn't reach the inner element across the shadow boundary, so this prop binds it directly -- same pattern as `bs-button`'s `ariaLabel`.
+          * @default null
+         */
+        "ariaLabel"?: string | null;
         /**
           * Shows the `${value}%` label below the ring. Only takes effect for `type="determinate"` -- `indeterminate` never shows a label regardless of this prop, since there's no percentage to show. Defaults to `true`.
           * @default true
@@ -5779,6 +6381,11 @@ declare namespace LocalJSX {
      *   weight of a bar.
      */
     interface BsProgressLinear {
+        /**
+          * Accessible name for the progress bar (e.g. "Uploading report"). Required for assistive tech -- a `role="progressbar"` with no name is an axe-core `aria-progressbar-name` violation. Setting `aria-label` on the host doesn't reach the inner element across the shadow boundary, so this prop binds it directly -- same pattern as `bs-button`'s `ariaLabel`.
+          * @default null
+         */
+        "ariaLabel"?: string | null;
         /**
           * Shows the slotted label below the bar. When `false`, or when no content is slotted, the label wrapper isn't rendered at all. Defaults to `true`.
           * @default true
@@ -5822,11 +6429,15 @@ declare namespace LocalJSX {
          */
         "disabled"?: boolean;
         /**
-          * The native radio input's `name` attribute. Passed straight through to the native input inside. NOTE: because each `bs-radio` renders its own shadow root, native `<input type="radio">` mutual-exclusion grouping (which the HTML spec scopes to a single DOM tree) does NOT extend across separate `bs-radio` instances sharing the same `name` -- checking one will not natively uncheck another. Within a single instance this still behaves like a normal radio input. See bs-radio.mdx's Accessibility section for this known gap; consumers building a group currently need to manage mutual exclusivity themselves (e.g. via `bsChange`) until a `bs-radio-group` wrapper exists.
+          * The `id` of a `<form>` element to associate this element with.
+         */
+        "form"?: string;
+        /**
+          * The native radio input's `name` attribute. Passed straight through to the native input inside. Also the group key: `bs-radio` elements sharing a `name` within the same root (document or shadow root) behave as one radio group -- checking one unchecks the others, arrow keys move between them, and only one is in the tab order. Native grouping can't cross each radio's own shadow root, so this component implements it itself.
          */
         "name"?: string;
         /**
-          * Emitted with this radio's own `value` when it becomes checked via user interaction. Since native same-`name` grouping doesn't cross shadow-root boundaries (see the `name` prop's doc), a consumer wiring up a group of `bs-radio`s must itself set `checked = false` on the others in response to this event -- there's no automatic un-checking to rely on here.
+          * Emitted with this radio's own `value` when it becomes checked via user interaction. Since native same-`name` grouping doesn't cross shadow-root boundaries (see the `name` prop's doc), a consumer wiring up a group of `bs-radio`s does not need to un-check the others itself.
          */
         "onBsChange"?: (event: BsRadioCustomEvent<string>) => void;
         /**
@@ -5860,6 +6471,10 @@ declare namespace LocalJSX {
           * @default false
          */
         "disabled"?: boolean;
+        /**
+          * The `id` of a `<form>` element to associate this element with.
+         */
+        "form"?: string;
         /**
           * Label text shown above the track when `showLabel` is set.
           * @default 'Label'
@@ -5875,6 +6490,10 @@ declare namespace LocalJSX {
           * @default 0
          */
         "min"?: number;
+        /**
+          * The `name` the value is submitted under in a surrounding `<form>`'s `FormData`. `type="range"` submits two entries under this name: the start value, then the end value.
+         */
+        "name"?: string;
         /**
           * Emitted when `value` changes via user interaction (dragging the thumb, or committing the value field), with the new value. Only fires for `type="default"`/`type="segmented"`.
          */
@@ -6131,6 +6750,14 @@ declare namespace LocalJSX {
           * @default false
          */
         "disabled"?: boolean;
+        /**
+          * The `id` of a `<form>` element to associate this element with.
+         */
+        "form"?: string;
+        /**
+          * The `name` the value is submitted under in a surrounding `<form>`'s `FormData`.
+         */
+        "name"?: string;
         /**
           * Emitted when the checked state changes via user interaction, with the new `checked` value.
          */
@@ -6140,6 +6767,11 @@ declare namespace LocalJSX {
           * @default 'lg'
          */
         "size"?: BsSwitchSize;
+        /**
+          * The value submitted when on (native checkbox default: `"on"`).
+          * @default 'on'
+         */
+        "value"?: string;
     }
     /**
      * A single tab button -- an optional icon plus a text label, rendered as a real `<button>` so it
@@ -6184,6 +6816,10 @@ declare namespace LocalJSX {
           * @default false
          */
         "selected"?: boolean;
+        /**
+          * Set by a parent `bs-tabs` to implement roving tabindex (only one tab in the group is in the Tab order; arrow keys move between them). Left `undefined` for a standalone tab, which stays a normal tab stop.
+         */
+        "tabbable"?: boolean;
     }
     /**
      * A tab-group wrapper: owns `role="tablist"` and coordinates selection across its slotted
@@ -6331,6 +6967,19 @@ declare namespace LocalJSX {
     interface BsCardAttributes {
         "surface": BsCardSurface;
     }
+    interface BsCarouselAttributes {
+        "tracker": BsCarouselTracker;
+        "slidesPerView": number;
+        "currentPage": number;
+        "autoplay": boolean;
+        "interval": number;
+        "paused": boolean;
+        "label": string;
+        "previousLabel": string;
+        "nextLabel": string;
+        "pauseLabel": string;
+        "playLabel": string;
+    }
     interface BsChatbotFeedbackAttributes {
         "rating": number;
         "submitted": boolean;
@@ -6354,6 +7003,9 @@ declare namespace LocalJSX {
         "disabled": boolean;
     }
     interface BsCheckboxAttributes {
+        "name": string;
+        "value": string;
+        "required": boolean;
         "size": BsCheckboxSize;
         "checked": boolean;
         "indeterminate": boolean;
@@ -6407,6 +7059,27 @@ declare namespace LocalJSX {
         "size": BsDialogSize;
         "centered": boolean;
     }
+    interface BsFileUploadAttributes {
+        "direction": BsFileUploadDirection;
+        "heading": string;
+        "description": string;
+        "buttonLabel": string;
+        "accept": string;
+        "multiple": boolean;
+        "disabled": boolean;
+        "dragging": boolean;
+    }
+    interface BsFileUploadItemAttributes {
+        "state": BsFileUploadItemState;
+        "fileName": string;
+        "fileSize": string;
+        "progress": number;
+        "message": string;
+        "thumbnailSrc": string;
+        "thumbnailAlt": string;
+        "cancelLabel": string;
+        "removeLabel": string;
+    }
     interface BsIconButtonAttributes {
         "variant": BsIconButtonVariant;
         "size": BsIconButtonSize;
@@ -6418,8 +7091,10 @@ declare namespace LocalJSX {
         "selected": boolean;
         "disabled": boolean;
         "ariaLabel": string | null;
+        "tabbable": boolean;
     }
     interface BsInputAttributes {
+        "name": string;
         "value": string;
         "type": | 'text'
     | 'email'
@@ -6493,12 +7168,14 @@ declare namespace LocalJSX {
         "strokeWidth": BsProgressStrokeWidth;
         "value": number;
         "showLabel": boolean;
+        "ariaLabel": string | null;
     }
     interface BsProgressLinearAttributes {
         "type": BsProgressLinearType;
         "size": BsProgressLinearSize;
         "value": number;
         "showLabel": boolean;
+        "ariaLabel": string | null;
     }
     interface BsRadioAttributes {
         "name": string;
@@ -6508,6 +7185,7 @@ declare namespace LocalJSX {
     }
     interface BsSliderAttributes {
         "type": BsSliderType;
+        "name": string;
         "showLabel": boolean;
         "label": string;
         "min": number;
@@ -6547,6 +7225,8 @@ declare namespace LocalJSX {
         "showDescription": boolean;
     }
     interface BsSwitchAttributes {
+        "name": string;
+        "value": string;
         "size": BsSwitchSize;
         "checked": boolean;
         "disabled": boolean;
@@ -6557,6 +7237,7 @@ declare namespace LocalJSX {
         "disabled": boolean;
         "iconPosition": BsTabIconPosition;
         "ariaLabel": string | null;
+        "tabbable": boolean;
     }
     interface BsTabsAttributes {
         "type": BsTabsType;
@@ -6584,6 +7265,7 @@ declare namespace LocalJSX {
         "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-carousel": Omit<BsCarousel, keyof BsCarouselAttributes> & { [K in keyof BsCarousel & keyof BsCarouselAttributes]?: BsCarousel[K] } & { [K in keyof BsCarousel & keyof BsCarouselAttributes as `attr:${K}`]?: BsCarouselAttributes[K] } & { [K in keyof BsCarousel & keyof BsCarouselAttributes as `prop:${K}`]?: BsCarousel[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] };
@@ -6598,6 +7280,8 @@ declare namespace LocalJSX {
         "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-dialog": Omit<BsDialog, keyof BsDialogAttributes> & { [K in keyof BsDialog & keyof BsDialogAttributes]?: BsDialog[K] } & { [K in keyof BsDialog & keyof BsDialogAttributes as `attr:${K}`]?: BsDialogAttributes[K] } & { [K in keyof BsDialog & keyof BsDialogAttributes as `prop:${K}`]?: BsDialog[K] };
+        "bs-file-upload": Omit<BsFileUpload, keyof BsFileUploadAttributes> & { [K in keyof BsFileUpload & keyof BsFileUploadAttributes]?: BsFileUpload[K] } & { [K in keyof BsFileUpload & keyof BsFileUploadAttributes as `attr:${K}`]?: BsFileUploadAttributes[K] } & { [K in keyof BsFileUpload & keyof BsFileUploadAttributes as `prop:${K}`]?: BsFileUpload[K] };
+        "bs-file-upload-item": Omit<BsFileUploadItem, keyof BsFileUploadItemAttributes> & { [K in keyof BsFileUploadItem & keyof BsFileUploadItemAttributes]?: BsFileUploadItem[K] } & { [K in keyof BsFileUploadItem & keyof BsFileUploadItemAttributes as `attr:${K}`]?: BsFileUploadItemAttributes[K] } & { [K in keyof BsFileUploadItem & keyof BsFileUploadItemAttributes as `prop:${K}`]?: BsFileUploadItem[K] };
         "bs-icon-button": Omit<BsIconButton, keyof BsIconButtonAttributes> & { [K in keyof BsIconButton & keyof BsIconButtonAttributes]?: BsIconButton[K] } & { [K in keyof BsIconButton & keyof BsIconButtonAttributes as `attr:${K}`]?: BsIconButtonAttributes[K] } & { [K in keyof BsIconButton & keyof BsIconButtonAttributes as `prop:${K}`]?: BsIconButton[K] };
         "bs-inline-tab": Omit<BsInlineTab, keyof BsInlineTabAttributes> & { [K in keyof BsInlineTab & keyof BsInlineTabAttributes]?: BsInlineTab[K] } & { [K in keyof BsInlineTab & keyof BsInlineTabAttributes as `attr:${K}`]?: BsInlineTabAttributes[K] } & { [K in keyof BsInlineTab & keyof BsInlineTabAttributes as `prop:${K}`]?: BsInlineTab[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] };
@@ -6894,6 +7578,26 @@ 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 carousel that shows a page of slides at a time, with a tracker (dots or numbered blocks) and
+             * previous/next controls, and optional auto-advance with a Pause/Play button.
+             * Slides are the default slot's direct children (a `bs-card`, an image, anything). The carousel
+             * shows `slidesPerView` of them at once, so there are `ceil(slides / slidesPerView)` pages. It
+             * manages two things on those slide elements: the `hidden` attribute (off-page slides are hidden,
+             * so they leave the tab order and the accessibility tree) and, only when not already set,
+             * `role="group"`, `aria-roledescription="slide"` and an `aria-label` of "n of N".
+             * Composes `bs-pagination` (`tracker="numbers"`), `bs-icon-button` (previous/next for
+             * `tracker="dots"`) and `bs-button` (Pause/Play) rather than re-implementing them.
+             * ## When to use
+             * - Browsing a set of related items (cards, images, announcements) where only a few fit at once.
+             * - Rotating promotional or highlight content, where auto-advance with a Pause control is wanted.
+             * ## When not to use
+             * - Content users must see in full to complete a task -- hiding it behind paging hurts discovery;
+             *   lay it out in a list or grid instead.
+             * - A strict sequence of steps -- use `bs-stepper`.
+             * - Paging through a large, addressable result set -- use `bs-pagination`.
+             */
+            "bs-carousel": LocalJSX.IntrinsicElements["bs-carousel"] & JSXBase.HTMLAttributes<HTMLBsCarouselElement>;
             /**
              * 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
@@ -7252,6 +7956,30 @@ declare module "@stencil/core" {
              * button in the header row next to the heading, same as before this addition.
              */
             "bs-dialog": LocalJSX.IntrinsicElements["bs-dialog"] & JSXBase.HTMLAttributes<HTMLBsDialogElement>;
+            /**
+             * A file dropzone: drag files onto it, or press "Browse file" to open the file picker. It reports
+             * the chosen files and does nothing else -- the consuming app owns the upload itself and shows its
+             * progress with `bs-file-upload-item`.
+             * ## When to use
+             * - Letting users add one or more files (documents, images) to upload.
+             * ## When not to use
+             * - Attaching files to a chat message -- see `bs-composer` / `bs-attachment`.
+             * - A file input that must submit with a native `<form>`: this component is **not**
+             *   form-associated. Read the files from `bsFilesSelect` and submit them yourself.
+             */
+            "bs-file-upload": LocalJSX.IntrinsicElements["bs-file-upload"] & JSXBase.HTMLAttributes<HTMLBsFileUploadElement>;
+            /**
+             * One file in an upload list: a thumbnail, the file name and size, a status line (a progress bar
+             * while uploading, or a success / error message) and an action button (cancel while uploading or
+             * after an error, remove once uploaded).
+             * Presentational only -- the consuming app owns the upload and drives `state`, `progress` and
+             * `message` from it. Pair with `bs-file-upload` (the dropzone that picks the files).
+             * ## When to use
+             * - Showing the status of each file the user has added, in a list under a `bs-file-upload`.
+             * ## When not to use
+             * - Attaching files to a chat message -- use `bs-attachment`.
+             */
+            "bs-file-upload-item": LocalJSX.IntrinsicElements["bs-file-upload-item"] & JSXBase.HTMLAttributes<HTMLBsFileUploadItemElement>;
             /**
              * A clickable, icon-only action element -- the icon-only sibling of `bs-button`, sharing the same
              * 8 visual variants and color language, but ALWAYS rendering just a single icon, never a label.