@brandsync/wc 1.5.4 → 1.7.0

package/custom-elements.json

@@ -1859,6 +1859,358 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-carousel/bs-carousel.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-carousel",
+          "name": "BsCarousel",
+          "description": "A carousel that shows a page of slides at a time, with a tracker (dots or numbered blocks) and\nprevious/next controls, and optional auto-advance with a Pause/Play button.\n\nSlides are the default slot's direct children (a `bs-card`, an image, anything). The carousel\nshows `slidesPerView` of them at once, so there are `ceil(slides / slidesPerView)` pages. It\nmanages two things on those slide elements: the `hidden` attribute (off-page slides are hidden,\nso they leave the tab order and the accessibility tree) and, only when not already set,\n`role=\"group\"`, `aria-roledescription=\"slide\"` and an `aria-label` of \"n of N\".\n\nComposes `bs-pagination` (`tracker=\"numbers\"`), `bs-icon-button` (previous/next for\n`tracker=\"dots\"`) and `bs-button` (Pause/Play) rather than re-implementing them.\n\n## When to use\n- Browsing a set of related items (cards, images, announcements) where only a few fit at once.\n- Rotating promotional or highlight content, where auto-advance with a Pause control is wanted.\n\n## When not to use\n- Content users must see in full to complete a task -- hiding it behind paging hurts discovery;\n  lay it out in a list or grid instead.\n- A strict sequence of steps -- use `bs-stepper`.\n- Paging through a large, addressable result set -- use `bs-pagination`.",
+          "attributes": [
+            {
+              "name": "autoplay",
+              "description": "Auto-advances to the next page every `interval` ms, looping from the last page to the first.\nOff by default. The Pause/Play button is only rendered when this is set. Auto-advance also\nstops while the pointer is over the carousel or focus is inside it, and starts paused for\nusers who prefer reduced motion.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "autoplay"
+            },
+            {
+              "name": "current-page",
+              "description": "The visible page, 1-based (same convention as `bs-pagination`). Mutable so the carousel\nadvances it itself (tracker, previous/next, autoplay). Clamped to the available pages.",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "fieldName": "currentPage"
+            },
+            {
+              "name": "interval",
+              "description": "Milliseconds between auto-advances, when `autoplay` is set.",
+              "type": {
+                "text": "number"
+              },
+              "default": "5000",
+              "fieldName": "interval"
+            },
+            {
+              "name": "label",
+              "description": "Accessible name of the carousel region (e.g. \"Featured articles\").",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Carousel'",
+              "fieldName": "label"
+            },
+            {
+              "name": "next-label",
+              "description": "Accessible name of the next button (`tracker=\"dots\"`) -- override for localisation.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Next slide'",
+              "fieldName": "nextLabel"
+            },
+            {
+              "name": "pause-label",
+              "description": "Label of the Pause/Play button while auto-advance is running.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Pause'",
+              "fieldName": "pauseLabel"
+            },
+            {
+              "name": "paused",
+              "description": "Whether auto-advance is paused by the user (the Pause/Play button). Mutable and reflected so\nthe state is visible to CSS and settable from outside. Only meaningful with `autoplay`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "paused"
+            },
+            {
+              "name": "play-label",
+              "description": "Label of the Pause/Play button while auto-advance is paused.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Play'",
+              "fieldName": "playLabel"
+            },
+            {
+              "name": "previous-label",
+              "description": "Accessible name of the previous button (`tracker=\"dots\"`) -- override for localisation.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Previous slide'",
+              "fieldName": "previousLabel"
+            },
+            {
+              "name": "slides-per-view",
+              "description": "How many slides are visible at once. The tracker counts pages: `ceil(slides / slidesPerView)`.",
+              "type": {
+                "text": "number"
+              },
+              "default": "3",
+              "fieldName": "slidesPerView"
+            },
+            {
+              "name": "tracker",
+              "description": "Which tracker to show under the slides. `dots` is a compact dot row between previous/next\nbuttons (the dots are an indicator, not buttons); `numbers` is a numbered `bs-pagination`\nwhere each page can be jumped to directly.",
+              "type": {
+                "text": "\"dots\" | \"numbers\"",
+                "references": [
+                  {
+                    "name": "BsCarouselTracker"
+                  }
+                ]
+              },
+              "default": "'dots'",
+              "fieldName": "tracker"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "autoplay",
+              "description": "Auto-advances to the next page every `interval` ms, looping from the last page to the first.\nOff by default. The Pause/Play button is only rendered when this is set. Auto-advance also\nstops while the pointer is over the carousel or focus is inside it, and starts paused for\nusers who prefer reduced motion.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "autoplay"
+            },
+            {
+              "kind": "field",
+              "name": "currentPage",
+              "description": "The visible page, 1-based (same convention as `bs-pagination`). Mutable so the carousel\nadvances it itself (tracker, previous/next, autoplay). Clamped to the available pages.",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "attribute": "current-page",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "interval",
+              "description": "Milliseconds between auto-advances, when `autoplay` is set.",
+              "type": {
+                "text": "number"
+              },
+              "default": "5000",
+              "attribute": "interval"
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "description": "Accessible name of the carousel region (e.g. \"Featured articles\").",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Carousel'",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "nextLabel",
+              "description": "Accessible name of the next button (`tracker=\"dots\"`) -- override for localisation.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Next slide'",
+              "attribute": "next-label"
+            },
+            {
+              "kind": "field",
+              "name": "pauseLabel",
+              "description": "Label of the Pause/Play button while auto-advance is running.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Pause'",
+              "attribute": "pause-label"
+            },
+            {
+              "kind": "field",
+              "name": "paused",
+              "description": "Whether auto-advance is paused by the user (the Pause/Play button). Mutable and reflected so\nthe state is visible to CSS and settable from outside. Only meaningful with `autoplay`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "paused",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "playLabel",
+              "description": "Label of the Pause/Play button while auto-advance is paused.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Play'",
+              "attribute": "play-label"
+            },
+            {
+              "kind": "field",
+              "name": "previousLabel",
+              "description": "Accessible name of the previous button (`tracker=\"dots\"`) -- override for localisation.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Previous slide'",
+              "attribute": "previous-label"
+            },
+            {
+              "kind": "field",
+              "name": "slidesPerView",
+              "description": "How many slides are visible at once. The tracker counts pages: `ceil(slides / slidesPerView)`.",
+              "type": {
+                "text": "number"
+              },
+              "default": "3",
+              "attribute": "slides-per-view"
+            },
+            {
+              "kind": "field",
+              "name": "tracker",
+              "description": "Which tracker to show under the slides. `dots` is a compact dot row between previous/next\nbuttons (the dots are an indicator, not buttons); `numbers` is a numbered `bs-pagination`\nwhere each page can be jumped to directly.",
+              "type": {
+                "text": "\"dots\" | \"numbers\"",
+                "references": [
+                  {
+                    "name": "BsCarouselTracker"
+                  }
+                ]
+              },
+              "default": "'dots'",
+              "attribute": "tracker"
+            }
+          ],
+          "events": [
+            {
+              "name": "bsPageChange",
+              "description": "Fires after the visible page changes via the tracker, previous/next or autoplay, with the\nnew 1-based page.",
+              "type": {
+                "text": "CustomEvent<number>"
+              }
+            },
+            {
+              "name": "bsPauseChange",
+              "description": "Fires when the user toggles the Pause/Play button, with the new `paused` value.",
+              "type": {
+                "text": "CustomEvent<boolean>"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Default slot: the slides. Each direct child is one slide."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "carousel",
+              "description": "The outer region (`role=\"region\"`, `aria-roledescription=\"carousel\"`)."
+            },
+            {
+              "name": "current",
+              "description": "The current page's dot (in addition to `dot`)."
+            },
+            {
+              "name": "dot",
+              "description": "Each dot (`tracker=\"dots\"`)."
+            },
+            {
+              "name": "dots",
+              "description": "The dot group (`tracker=\"dots\"`)."
+            },
+            {
+              "name": "next",
+              "description": "The next button (`tracker=\"dots\"`)."
+            },
+            {
+              "name": "pagination",
+              "description": "The numbered tracker (`tracker=\"numbers\"`)."
+            },
+            {
+              "name": "pause",
+              "description": "The Pause/Play button (only rendered when `autoplay`)."
+            },
+            {
+              "name": "prev",
+              "description": "The previous button (`tracker=\"dots\"`)."
+            },
+            {
+              "name": "slides",
+              "description": "The row holding the visible slides."
+            },
+            {
+              "name": "tracker",
+              "description": "The row holding the tracker and the Pause/Play button."
+            }
+          ],
+          "cssProperties": [
+            {
+              "name": "--bs-carousel-dot-active-color",
+              "description": "Fill of the active dot. Aliased to --bs-color-primary-default."
+            },
+            {
+              "name": "--bs-carousel-dot-color",
+              "description": "Fill of an inactive dot. Aliased to --bs-surface-container."
+            },
+            {
+              "name": "--bs-carousel-dot-radius",
+              "description": "Corner radius of a dot. Aliased to --bs-border-radius-full."
+            },
+            {
+              "name": "--bs-carousel-dot-size",
+              "description": "Width/height of an inactive dot; the active dot is twice as wide. Aliased to --bs-spacing-100 (8px, exact match to Figma)."
+            },
+            {
+              "name": "--bs-carousel-dots-gap",
+              "description": "Gap between dots. Aliased to --bs-spacing-50."
+            },
+            {
+              "name": "--bs-carousel-gap",
+              "description": "Gap between visible slides. Aliased to --bs-spacing-200."
+            },
+            {
+              "name": "--bs-carousel-tracker-gap",
+              "description": "Gap between the items of the tracker row (previous, dots, next, Pause). Aliased to --bs-spacing-50."
+            },
+            {
+              "name": "--bs-carousel-tracker-offset",
+              "description": "Vertical gap between the slides and the tracker row. Aliased to --bs-spacing-200."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsCarousel",
+          "declaration": {
+            "name": "BsCarousel"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-carousel",
+          "declaration": {
+            "name": "BsCarousel"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/bs-chatbot-feedback/bs-chatbot-feedback.tsx",
@@ -4053,44 +4405,541 @@
               }
             }
           ],
-          "events": [
+          "events": [
+            {
+              "name": "bsRowSelect",
+              "type": {
+                "text": "CustomEvent<{ id: string | number; selected: boolean; }>"
+              }
+            },
+            {
+              "name": "bsSort",
+              "type": {
+                "text": "CustomEvent<{ column: string; direction: \"desc\" | \"asc\"; }>"
+              }
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "body",
+              "description": "The `<tbody>` element."
+            },
+            {
+              "name": "cell",
+              "description": "Each `<td>` in a body row."
+            },
+            {
+              "name": "head",
+              "description": "The `<thead>` element."
+            },
+            {
+              "name": "header-cell",
+              "description": "Each `<th>` in the header row."
+            },
+            {
+              "name": "row",
+              "description": "Each `<tr>` in the body."
+            },
+            {
+              "name": "table",
+              "description": "The `<table>` element."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsDataTable",
+          "declaration": {
+            "name": "BsDataTable"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-data-table",
+          "declaration": {
+            "name": "BsDataTable"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-dialog/bs-dialog.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-dialog",
+          "name": "BsDialog",
+          "description": "An overlay dialog that interrupts the current flow for a focused task or confirmation.\nCloses itself on backdrop click, Escape, or its own close button, and emits `bsClose`.\n\n## When to use\n- Confirming a consequential action (e.g. \"Confirm booking\") before it takes effect.\n- A short, focused task that doesn't warrant navigating to a new page.\n\n## When not to use\n- For non-blocking status messages — use a toast/notification instead of interrupting the user.\n- For a long, multi-step flow — a full page or a dedicated route is usually a better fit than a\n  dialog that just gets taller and taller.\n\nTwo additional slots cover the Figma \"Dialog\" component's other states: `image` (a hero image\nacross the top, close button floats over it instead of sitting in the header row) and `icon`\n(only rendered when `centered` is set, e.g. a success checkmark above a centered heading). The\nclose button \"floats\" (absolute-positioned, top-right of the dialog, with its own background)\nwhenever `centered` is true or the `image` slot has content -- otherwise it's the plain inline\nbutton in the header row next to the heading, same as before this addition.",
+          "attributes": [
+            {
+              "name": "centered",
+              "description": "Switches to the Figma \"Icon Centered\" layout: heading/body text centered, the `icon` slot\nrendered above the heading, and the close button floating top-right of the dialog instead of\ninline in the header row. Doesn't hide a slotted `image` if one is also provided -- Figma's\nspec doesn't show the two combined, so this is unspecified rather than actively blocked.\nReflected so consumers/CSS can target `bs-dialog[centered]`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "centered"
+            },
+            {
+              "name": "heading",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "heading"
+            },
+            {
+              "name": "open",
+              "description": "Mutable + reflected so the component can close itself (backdrop click, Escape, close button)\nthe same way a native `<dialog>` does, while still emitting `bsClose` for the consumer to react to.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "open"
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "\"lg\" | \"md\" | \"sm\"",
+                "references": [
+                  {
+                    "name": "BsDialogSize"
+                  }
+                ]
+              },
+              "default": "'md'",
+              "fieldName": "size"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "centered",
+              "description": "Switches to the Figma \"Icon Centered\" layout: heading/body text centered, the `icon` slot\nrendered above the heading, and the close button floating top-right of the dialog instead of\ninline in the header row. Doesn't hide a slotted `image` if one is also provided -- Figma's\nspec doesn't show the two combined, so this is unspecified rather than actively blocked.\nReflected so consumers/CSS can target `bs-dialog[centered]`.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "centered",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "heading",
+              "type": {
+                "text": "string"
+              },
+              "attribute": "heading"
+            },
+            {
+              "kind": "field",
+              "name": "open",
+              "description": "Mutable + reflected so the component can close itself (backdrop click, Escape, close button)\nthe same way a native `<dialog>` does, while still emitting `bsClose` for the consumer to react to.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "open",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "\"lg\" | \"md\" | \"sm\"",
+                "references": [
+                  {
+                    "name": "BsDialogSize"
+                  }
+                ]
+              },
+              "default": "'md'",
+              "attribute": "size"
+            }
+          ],
+          "events": [
+            {
+              "name": "bsClose",
+              "type": {
+                "text": "CustomEvent<void>"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Default slot: the dialog body content."
+            },
+            {
+              "name": "footer",
+              "description": "Optional footer content (typically action buttons)."
+            },
+            {
+              "name": "icon",
+              "description": "Optional icon shown above the heading, only rendered at all when `centered` is true."
+            },
+            {
+              "name": "image",
+              "description": "Optional hero image across the top of the dialog. Presence of assigned content\nswitches the close button to float over it; doesn't affect layout when empty."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "backdrop",
+              "description": "The full-viewport overlay behind the dialog."
+            },
+            {
+              "name": "body",
+              "description": "The body content wrapper."
+            },
+            {
+              "name": "close",
+              "description": "The close button (inline in the header, or floating -- see the class doc above)."
+            },
+            {
+              "name": "dialog",
+              "description": "The dialog box itself."
+            },
+            {
+              "name": "footer",
+              "description": "The footer wrapper (only visible when the footer slot has content)."
+            },
+            {
+              "name": "header",
+              "description": "The header row (heading + close button, when the close button isn't floating)."
+            },
+            {
+              "name": "icon",
+              "description": "The icon wrapper (only rendered when `centered` is true)."
+            },
+            {
+              "name": "image",
+              "description": "The hero image wrapper (only visible when the `image` slot has content)."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BsDialog",
+          "declaration": {
+            "name": "BsDialog"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bs-dialog",
+          "declaration": {
+            "name": "BsDialog"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/bs-file-upload/bs-file-upload.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bs-file-upload",
+          "name": "BsFileUpload",
+          "description": "A file dropzone: drag files onto it, or press \"Browse file\" to open the file picker. It reports\nthe chosen files and does nothing else -- the consuming app owns the upload itself and shows its\nprogress with `bs-file-upload-item`.\n\n## When to use\n- Letting users add one or more files (documents, images) to upload.\n\n## When not to use\n- Attaching files to a chat message -- see `bs-composer` / `bs-attachment`.\n- A file input that must submit with a native `<form>`: this component is **not**\n  form-associated. Read the files from `bsFilesSelect` and submit them yourself.",
+          "attributes": [
+            {
+              "name": "accept",
+              "description": "Which files are accepted, same syntax as the native `accept` attribute: comma-separated\nextensions (`.pdf`), MIME types (`image/png`) or wildcards (`image/*`). Applied to the picker\nand also to dropped files, which the browser does not filter.",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "accept"
+            },
+            {
+              "name": "button-label",
+              "description": "Label of the browse button. Override for localisation.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Browse file'",
+              "fieldName": "buttonLabel"
+            },
+            {
+              "name": "description",
+              "description": "Guidelines under the heading (e.g. \"PDF or JPG, up to 8MB\").",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "description"
+            },
+            {
+              "name": "direction",
+              "description": "Layout: icon beside the text (`horizontal`) or stacked above it, centered (`vertical`).",
+              "type": {
+                "text": "\"horizontal\" | \"vertical\"",
+                "references": [
+                  {
+                    "name": "BsFileUploadDirection"
+                  }
+                ]
+              },
+              "default": "'horizontal'",
+              "fieldName": "direction"
+            },
+            {
+              "name": "disabled",
+              "description": "Disables the browse button and ignores drops.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "dragging",
+              "description": "Whether a file is currently being dragged over the dropzone (the Figma \"Drop\" state). Set by\nthe component during a drag; mutable and reflected so it can also be set to show the state\nstatically.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "dragging"
+            },
+            {
+              "name": "heading",
+              "description": "Heading text (e.g. \"Upload your documents\").",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "heading"
+            },
+            {
+              "name": "multiple",
+              "description": "Allows selecting/dropping more than one file. Without it only the first file is taken.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "multiple"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "accept",
+              "description": "Which files are accepted, same syntax as the native `accept` attribute: comma-separated\nextensions (`.pdf`), MIME types (`image/png`) or wildcards (`image/*`). Applied to the picker\nand also to dropped files, which the browser does not filter.",
+              "type": {
+                "text": "string"
+              },
+              "attribute": "accept"
+            },
+            {
+              "kind": "field",
+              "name": "buttonLabel",
+              "description": "Label of the browse button. Override for localisation.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Browse file'",
+              "attribute": "button-label"
+            },
+            {
+              "kind": "field",
+              "name": "description",
+              "description": "Guidelines under the heading (e.g. \"PDF or JPG, up to 8MB\").",
+              "type": {
+                "text": "string"
+              },
+              "attribute": "description"
+            },
+            {
+              "kind": "field",
+              "name": "direction",
+              "description": "Layout: icon beside the text (`horizontal`) or stacked above it, centered (`vertical`).",
+              "type": {
+                "text": "\"horizontal\" | \"vertical\"",
+                "references": [
+                  {
+                    "name": "BsFileUploadDirection"
+                  }
+                ]
+              },
+              "default": "'horizontal'",
+              "attribute": "direction",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "description": "Disables the browse button and ignores drops.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "dragging",
+              "description": "Whether a file is currently being dragged over the dropzone (the Figma \"Drop\" state). Set by\nthe component during a drag; mutable and reflected so it can also be set to show the state\nstatically.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "dragging",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "heading",
+              "description": "Heading text (e.g. \"Upload your documents\").",
+              "type": {
+                "text": "string"
+              },
+              "attribute": "heading"
+            },
+            {
+              "kind": "field",
+              "name": "multiple",
+              "description": "Allows selecting/dropping more than one file. Without it only the first file is taken.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "multiple"
+            }
+          ],
+          "events": [
+            {
+              "name": "bsFilesReject",
+              "description": "Fires with files that were not taken: they didn't match `accept`, or were extra files\ndropped while `multiple` is off.",
+              "type": {
+                "text": "CustomEvent<File[]>",
+                "references": [
+                  {
+                    "name": "File",
+                    "package": "global:"
+                  }
+                ]
+              }
+            },
+            {
+              "name": "bsFilesSelect",
+              "description": "Fires with the accepted files, after the picker closes or files are dropped.",
+              "type": {
+                "text": "CustomEvent<File[]>",
+                "references": [
+                  {
+                    "name": "File",
+                    "package": "global:"
+                  }
+                ]
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "icon",
+              "description": "Replaces the default upload icon inside the round icon area."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "browse",
+              "description": "The \"Browse file\" button."
+            },
+            {
+              "name": "description",
+              "description": "The guidelines text under the heading."
+            },
+            {
+              "name": "dropzone",
+              "description": "The dashed drop area."
+            },
+            {
+              "name": "heading",
+              "description": "The heading text."
+            },
+            {
+              "name": "icon",
+              "description": "The round icon area."
+            }
+          ],
+          "cssProperties": [
             {
-              "name": "bsRowSelect",
-              "type": {
-                "text": "CustomEvent<{ id: string | number; selected: boolean; }>"
-              }
+              "name": "--bs-file-upload-bg",
+              "description": "Background of the dropzone at rest. Aliased to --bs-surface-raised."
             },
             {
-              "name": "bsSort",
-              "type": {
-                "text": "CustomEvent<{ column: string; direction: \"desc\" | \"asc\"; }>"
-              }
-            }
-          ],
-          "cssParts": [
+              "name": "--bs-file-upload-bg-dragging",
+              "description": "Background while a file is dragged over it. Aliased to --bs-surface-container."
+            },
             {
-              "name": "body",
-              "description": "The `<tbody>` element."
+              "name": "--bs-file-upload-border-color",
+              "description": "Dashed border color at rest. Aliased to --bs-border-neutral-container."
             },
             {
-              "name": "cell",
-              "description": "Each `<td>` in a body row."
+              "name": "--bs-file-upload-border-color-dragging",
+              "description": "Dashed border color while dragging. Aliased to --bs-border-neutral-container-pressed."
             },
             {
-              "name": "head",
-              "description": "The `<thead>` element."
+              "name": "--bs-file-upload-border-width",
+              "description": "Dashed border width. Aliased to --bs-border-width-medium."
             },
             {
-              "name": "header-cell",
-              "description": "Each `<th>` in the header row."
+              "name": "--bs-file-upload-content-gap",
+              "description": "Gap between the text and the browse button. Aliased to --bs-spacing-100."
             },
             {
-              "name": "row",
-              "description": "Each `<tr>` in the body."
+              "name": "--bs-file-upload-description-color",
+              "description": "Guidelines color. Aliased to --bs-text-secondary."
             },
             {
-              "name": "table",
-              "description": "The `<table>` element."
+              "name": "--bs-file-upload-font-size",
+              "description": "Text size. Aliased to --bs-font-size-md."
+            },
+            {
+              "name": "--bs-file-upload-gap",
+              "description": "Gap between the icon area and the content. Aliased to --bs-spacing-300."
+            },
+            {
+              "name": "--bs-file-upload-heading-color",
+              "description": "Heading color. Aliased to --bs-text-default."
+            },
+            {
+              "name": "--bs-file-upload-icon-bg",
+              "description": "Background of the round icon area at rest. Aliased to --bs-surface-hover."
+            },
+            {
+              "name": "--bs-file-upload-icon-bg-dragging",
+              "description": "Background of the icon area while dragging. Aliased to --bs-surface-raised."
+            },
+            {
+              "name": "--bs-file-upload-icon-color",
+              "description": "Upload icon color. Aliased to --bs-icon-default."
+            },
+            {
+              "name": "--bs-file-upload-icon-size",
+              "description": "Diameter of the round icon area. 102px, per the Figma spec."
+            },
+            {
+              "name": "--bs-file-upload-line-height",
+              "description": "Text line height. Aliased to --bs-line-height-body-md."
+            },
+            {
+              "name": "--bs-file-upload-padding",
+              "description": "Padding on all sides. Aliased to --bs-spacing-300."
+            },
+            {
+              "name": "--bs-file-upload-radius",
+              "description": "Corner radius. Aliased to --bs-border-radius-150."
+            },
+            {
+              "name": "--bs-file-upload-text-gap",
+              "description": "Gap between the heading and the guidelines. Aliased to --bs-spacing-25."
             }
           ]
         }
@@ -4098,119 +4947,221 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BsDataTable",
+          "name": "BsFileUpload",
           "declaration": {
-            "name": "BsDataTable"
+            "name": "BsFileUpload"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bs-data-table",
+          "name": "bs-file-upload",
           "declaration": {
-            "name": "BsDataTable"
+            "name": "BsFileUpload"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/bs-dialog/bs-dialog.tsx",
+      "path": "src/components/bs-file-upload-item/bs-file-upload-item.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bs-dialog",
-          "name": "BsDialog",
-          "description": "An overlay dialog that interrupts the current flow for a focused task or confirmation.\nCloses itself on backdrop click, Escape, or its own close button, and emits `bsClose`.\n\n## When to use\n- Confirming a consequential action (e.g. \"Confirm booking\") before it takes effect.\n- A short, focused task that doesn't warrant navigating to a new page.\n\n## When not to use\n- For non-blocking status messages — use a toast/notification instead of interrupting the user.\n- For a long, multi-step flow — a full page or a dedicated route is usually a better fit than a\n  dialog that just gets taller and taller.\n\nTwo additional slots cover the Figma \"Dialog\" component's other states: `image` (a hero image\nacross the top, close button floats over it instead of sitting in the header row) and `icon`\n(only rendered when `centered` is set, e.g. a success checkmark above a centered heading). The\nclose button \"floats\" (absolute-positioned, top-right of the dialog, with its own background)\nwhenever `centered` is true or the `image` slot has content -- otherwise it's the plain inline\nbutton in the header row next to the heading, same as before this addition.",
+          "tagName": "bs-file-upload-item",
+          "name": "BsFileUploadItem",
+          "description": "One file in an upload list: a thumbnail, the file name and size, a status line (a progress bar\nwhile uploading, or a success / error message) and an action button (cancel while uploading or\nafter an error, remove once uploaded).\n\nPresentational only -- the consuming app owns the upload and drives `state`, `progress` and\n`message` from it. Pair with `bs-file-upload` (the dropzone that picks the files).\n\n## When to use\n- Showing the status of each file the user has added, in a list under a `bs-file-upload`.\n\n## When not to use\n- Attaching files to a chat message -- use `bs-attachment`.",
           "attributes": [
             {
-              "name": "centered",
-              "description": "Switches to the Figma \"Icon Centered\" layout: heading/body text centered, the `icon` slot\nrendered above the heading, and the close button floating top-right of the dialog instead of\ninline in the header row. Doesn't hide a slotted `image` if one is also provided -- Figma's\nspec doesn't show the two combined, so this is unspecified rather than actively blocked.\nReflected so consumers/CSS can target `bs-dialog[centered]`.",
+              "name": "cancel-label",
+              "description": "Accessible name of the cancel button (`loading`, `in-progress`, `error`).",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "fieldName": "centered"
+              "default": "'Cancel upload'",
+              "fieldName": "cancelLabel"
             },
             {
-              "name": "heading",
+              "name": "file-name",
+              "description": "The file name.",
               "type": {
                 "text": "string"
               },
-              "fieldName": "heading"
+              "default": "''",
+              "fieldName": "fileName"
             },
             {
-              "name": "open",
-              "description": "Mutable + reflected so the component can close itself (backdrop click, Escape, close button)\nthe same way a native `<dialog>` does, while still emitting `bsClose` for the consumer to react to.",
+              "name": "file-size",
+              "description": "The file size, already formatted (e.g. \"8MB\").",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "fieldName": "open"
+              "fieldName": "fileSize"
             },
             {
-              "name": "size",
+              "name": "message",
+              "description": "The status text. Defaults per state: \"Loading...\" (`loading`), \"{progress}% uploaded\"\n(`in-progress`), \"Upload failed\" (`error`), \"File uploaded successfully\" (`success`). Provide\nyour own for localisation or a specific error.",
               "type": {
-                "text": "\"lg\" | \"md\" | \"sm\"",
+                "text": "string"
+              },
+              "fieldName": "message"
+            },
+            {
+              "name": "progress",
+              "description": "Upload progress, 0-100. Only used when `state=\"in-progress\"`.",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "fieldName": "progress"
+            },
+            {
+              "name": "remove-label",
+              "description": "Accessible name of the remove button (`success`).",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Remove file'",
+              "fieldName": "removeLabel"
+            },
+            {
+              "name": "state",
+              "description": "Where the upload is. `loading` = working with no known percentage (indeterminate bar);\n`in-progress` = uploading with a known `progress`; `error` and `success` are final.",
+              "type": {
+                "text": "\"error\" | \"in-progress\" | \"loading\" | \"success\"",
                 "references": [
                   {
-                    "name": "BsDialogSize"
+                    "name": "BsFileUploadItemState"
                   }
                 ]
               },
-              "default": "'md'",
-              "fieldName": "size"
+              "default": "'loading'",
+              "fieldName": "state"
+            },
+            {
+              "name": "thumbnail-alt",
+              "description": "Alt text for `thumbnailSrc`. Leave empty when the file name already says it all.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "thumbnailAlt"
+            },
+            {
+              "name": "thumbnail-src",
+              "description": "A preview image of the file. Shown instead of the placeholder icon when set.",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "thumbnailSrc"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "centered",
-              "description": "Switches to the Figma \"Icon Centered\" layout: heading/body text centered, the `icon` slot\nrendered above the heading, and the close button floating top-right of the dialog instead of\ninline in the header row. Doesn't hide a slotted `image` if one is also provided -- Figma's\nspec doesn't show the two combined, so this is unspecified rather than actively blocked.\nReflected so consumers/CSS can target `bs-dialog[centered]`.",
+              "name": "cancelLabel",
+              "description": "Accessible name of the cancel button (`loading`, `in-progress`, `error`).",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "attribute": "centered",
-              "reflects": true
+              "default": "'Cancel upload'",
+              "attribute": "cancel-label"
             },
             {
               "kind": "field",
-              "name": "heading",
+              "name": "fileName",
+              "description": "The file name.",
               "type": {
                 "text": "string"
               },
-              "attribute": "heading"
+              "default": "''",
+              "attribute": "file-name"
             },
             {
               "kind": "field",
-              "name": "open",
-              "description": "Mutable + reflected so the component can close itself (backdrop click, Escape, close button)\nthe same way a native `<dialog>` does, while still emitting `bsClose` for the consumer to react to.",
+              "name": "fileSize",
+              "description": "The file size, already formatted (e.g. \"8MB\").",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "attribute": "open",
-              "reflects": true
+              "attribute": "file-size"
             },
             {
               "kind": "field",
-              "name": "size",
+              "name": "message",
+              "description": "The status text. Defaults per state: \"Loading...\" (`loading`), \"{progress}% uploaded\"\n(`in-progress`), \"Upload failed\" (`error`), \"File uploaded successfully\" (`success`). Provide\nyour own for localisation or a specific error.",
               "type": {
-                "text": "\"lg\" | \"md\" | \"sm\"",
+                "text": "string"
+              },
+              "attribute": "message"
+            },
+            {
+              "kind": "field",
+              "name": "progress",
+              "description": "Upload progress, 0-100. Only used when `state=\"in-progress\"`.",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "attribute": "progress"
+            },
+            {
+              "kind": "field",
+              "name": "removeLabel",
+              "description": "Accessible name of the remove button (`success`).",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Remove file'",
+              "attribute": "remove-label"
+            },
+            {
+              "kind": "field",
+              "name": "state",
+              "description": "Where the upload is. `loading` = working with no known percentage (indeterminate bar);\n`in-progress` = uploading with a known `progress`; `error` and `success` are final.",
+              "type": {
+                "text": "\"error\" | \"in-progress\" | \"loading\" | \"success\"",
                 "references": [
                   {
-                    "name": "BsDialogSize"
+                    "name": "BsFileUploadItemState"
                   }
                 ]
               },
-              "default": "'md'",
-              "attribute": "size"
+              "default": "'loading'",
+              "attribute": "state",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "thumbnailAlt",
+              "description": "Alt text for `thumbnailSrc`. Leave empty when the file name already says it all.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "thumbnail-alt"
+            },
+            {
+              "kind": "field",
+              "name": "thumbnailSrc",
+              "description": "A preview image of the file. Shown instead of the placeholder icon when set.",
+              "type": {
+                "text": "string"
+              },
+              "attribute": "thumbnail-src"
             }
           ],
           "events": [
             {
-              "name": "bsClose",
+              "name": "bsCancel",
+              "description": "Fires when the cancel button is clicked (`loading`, `in-progress`, `error`). The consumer\nstops the upload and removes the item.",
+              "type": {
+                "text": "CustomEvent<void>"
+              }
+            },
+            {
+              "name": "bsRemove",
+              "description": "Fires when the remove button is clicked (`success`). The consumer removes the file.",
               "type": {
                 "text": "CustomEvent<void>"
               }
@@ -4218,54 +5169,108 @@
           ],
           "slots": [
             {
-              "name": "",
-              "description": "Default slot: the dialog body content."
+              "name": "thumbnail",
+              "description": "Replaces the thumbnail content (the image-placeholder icon, or `thumbnailSrc`)."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "action",
+              "description": "The cancel / remove button."
             },
             {
-              "name": "footer",
-              "description": "Optional footer content (typically action buttons)."
+              "name": "item",
+              "description": "The card."
             },
             {
-              "name": "icon",
-              "description": "Optional icon shown above the heading, only rendered at all when `centered` is true."
+              "name": "name",
+              "description": "The file name."
             },
             {
-              "name": "image",
-              "description": "Optional hero image across the top of the dialog. Presence of assigned content\nswitches the close button to float over it; doesn't affect layout when empty."
+              "name": "progress",
+              "description": "The progress bar (`loading` / `in-progress`)."
+            },
+            {
+              "name": "size",
+              "description": "The file size text."
+            },
+            {
+              "name": "status",
+              "description": "The success / error message line."
+            },
+            {
+              "name": "thumbnail",
+              "description": "The thumbnail box."
             }
           ],
-          "cssParts": [
+          "cssProperties": [
             {
-              "name": "backdrop",
-              "description": "The full-viewport overlay behind the dialog."
+              "name": "--bs-file-upload-item-bg",
+              "description": "Card background. Aliased to --bs-surface-base."
             },
             {
-              "name": "body",
-              "description": "The body content wrapper."
+              "name": "--bs-file-upload-item-border-color",
+              "description": "Card border color. Aliased to --bs-border-default."
             },
             {
-              "name": "close",
-              "description": "The close button (inline in the header, or floating -- see the class doc above)."
+              "name": "--bs-file-upload-item-border-width",
+              "description": "Card border width. Aliased to --bs-border-width-thin."
             },
             {
-              "name": "dialog",
-              "description": "The dialog box itself."
+              "name": "--bs-file-upload-item-content-gap",
+              "description": "Gap between the name/size block and the status line. Aliased to --bs-spacing-100."
             },
             {
-              "name": "footer",
-              "description": "The footer wrapper (only visible when the footer slot has content)."
+              "name": "--bs-file-upload-item-error-color",
+              "description": "Error text color. Aliased to --bs-text-error."
             },
             {
-              "name": "header",
-              "description": "The header row (heading + close button, when the close button isn't floating)."
+              "name": "--bs-file-upload-item-error-icon-color",
+              "description": "Error icon color. Aliased to --bs-icon-error."
             },
             {
-              "name": "icon",
-              "description": "The icon wrapper (only rendered when `centered` is true)."
+              "name": "--bs-file-upload-item-gap",
+              "description": "Gap between the thumbnail, the content and the action. Aliased to --bs-spacing-150."
             },
             {
-              "name": "image",
-              "description": "The hero image wrapper (only visible when the `image` slot has content)."
+              "name": "--bs-file-upload-item-name-color",
+              "description": "File name color. Aliased to --bs-text-default."
+            },
+            {
+              "name": "--bs-file-upload-item-padding",
+              "description": "Card padding on all sides. Aliased to --bs-spacing-200."
+            },
+            {
+              "name": "--bs-file-upload-item-radius",
+              "description": "Card corner radius. Aliased to --bs-border-radius-150."
+            },
+            {
+              "name": "--bs-file-upload-item-size-color",
+              "description": "File size color. Aliased to --bs-text-default."
+            },
+            {
+              "name": "--bs-file-upload-item-success-color",
+              "description": "Success text color. Aliased to --bs-text-success."
+            },
+            {
+              "name": "--bs-file-upload-item-success-icon-color",
+              "description": "Success icon color. Aliased to --bs-icon-success."
+            },
+            {
+              "name": "--bs-file-upload-item-thumbnail-bg",
+              "description": "Placeholder background (when there is no image). Aliased to --bs-surface-container."
+            },
+            {
+              "name": "--bs-file-upload-item-thumbnail-icon-color",
+              "description": "Placeholder icon color. Aliased to --bs-icon-muted."
+            },
+            {
+              "name": "--bs-file-upload-item-thumbnail-radius",
+              "description": "Thumbnail corner radius. Aliased to --bs-border-radius-100."
+            },
+            {
+              "name": "--bs-file-upload-item-thumbnail-size",
+              "description": "Thumbnail width/height. 80px, per the Figma spec."
             }
           ]
         }
@@ -4273,16 +5278,16 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BsDialog",
+          "name": "BsFileUploadItem",
           "declaration": {
-            "name": "BsDialog"
+            "name": "BsFileUploadItem"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bs-dialog",
+          "name": "bs-file-upload-item",
           "declaration": {
-            "name": "BsDialog"
+            "name": "BsFileUploadItem"
           }
         }
       ]
@@ -6969,6 +7974,15 @@
           "name": "BsProgressLinear",
           "description": "A linear (horizontal) progress indicator -- either a static bar showing a percentage fill\n(`type=\"determinate\"`) or a continuously sliding bar signaling in-progress work with no known\ncompletion percentage (`type=\"indeterminate\"`).\n\n## When to use\n- Showing the progress of a task with a known, quantifiable completion percentage (`determinate`),\n  e.g. a file upload.\n- Signaling that work is happening in the background with no meaningful percentage to report\n  (`indeterminate`), e.g. while waiting on a network response.\n\n## When not to use\n- For a compact, ring-shaped progress indicator -- use `bs-progress` (circular) instead.\n- For a percentage that's better expressed as plain text, without the reserved space and visual\n  weight of a bar.",
           "attributes": [
+            {
+              "name": "aria-label",
+              "description": "Accessible name for the progress bar (e.g. \"Uploading report\"). Required for assistive tech --\na `role=\"progressbar\"` with no name is an axe-core `aria-progressbar-name` violation. Setting\n`aria-label` on the host doesn't reach the inner element across the shadow boundary, so this\nprop binds it directly -- same pattern as `bs-button`'s `ariaLabel`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "fieldName": "ariaLabel"
+            },
             {
               "name": "show-label",
               "description": "Shows the slotted label below the bar. When `false`, or when no content is slotted, the\nlabel wrapper isn't rendered at all. Defaults to `true`.",
@@ -7017,6 +8031,16 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "description": "Accessible name for the progress bar (e.g. \"Uploading report\"). Required for assistive tech --\na `role=\"progressbar\"` with no name is an axe-core `aria-progressbar-name` violation. Setting\n`aria-label` on the host doesn't reach the inner element across the shadow boundary, so this\nprop binds it directly -- same pattern as `bs-button`'s `ariaLabel`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "attribute": "aria-label"
+            },
             {
               "kind": "field",
               "name": "showLabel",