@brandsync/wc 1.6.0 → 1.7.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";
@@ -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
@@ -1152,6 +1234,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.
@@ -1701,6 +1888,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
@@ -2162,6 +2354,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 +2406,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 +2826,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 +3443,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 +4234,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 +4249,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;
@@ -4451,6 +4753,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
@@ -5180,6 +5566,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.
@@ -5779,6 +6286,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
@@ -6331,6 +6843,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;
@@ -6407,6 +6932,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;
@@ -6499,6 +7045,7 @@ declare namespace LocalJSX {
         "size": BsProgressLinearSize;
         "value": number;
         "showLabel": boolean;
+        "ariaLabel": string | null;
     }
     interface BsRadioAttributes {
         "name": string;
@@ -6584,6 +7131,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 +7146,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 +7444,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 +7822,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.