@brightspot/ui 1.10.0 → 3.0.0

package/docs/components/Tabs.md

@@ -0,0 +1,85 @@
+# `src/components/tabs/Tabs.ts`:
+
+## class: `Tabs`, `btu-tabs`
+
+### Superclass
+
+| Name         | Module | Package |
+| ------------ | ------ | ------- |
+| `LitElement` |        | lit     |
+
+### Mixins
+
+| Name                  | Module                           | Package |
+| --------------------- | -------------------------------- | ------- |
+| `RovingTabindexMixin` | /src/util/RovingTabindexMixin.js |         |
+| `EventEmitterMixin`   | /src/util/EventEmitterMixin.js   |         |
+| `ReadyMixin`          | /src/util/ReadyMixin.js          |         |
+
+### Static Fields
+
+| Name      | Privacy | Type | Default | Description | Inherited From |
+| --------- | ------- | ---- | ------- | ----------- | -------------- |
+| `tagName` |         |      |         |             |                |
+
+### Fields
+
+| Name             | Privacy | Type                           | Default  | Description                                                                                                                                                                          | Inherited From |
+| ---------------- | ------- | ------------------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------- |
+| `size`           |         | `'xs' \| 'sm' \| 'md' \| 'lg'` | `'md'`   | Size variant applied to all child tabs.                                                                                                                                              |                |
+| `activeTab`      |         | `string \| undefined`          |          | The \`name\` value of the currently active tab.                                                                                                                                      |                |
+| `variant`        |         | `'full' \| 'menu'`             | `'full'` | Layout variant.
- 'full': tabs scroll horizontally when they overflow (default)
- 'menu': all tabs are hidden; the active tab label and a chevron dropdown are shown instead |                |
+| `menuWrapper`    | private | `HTMLElement \| null`          | `null`   |                                                                                                                                                                                      |                |
+| `menuDropdown`   | private | `Dropdown \| null`             | `null`   |                                                                                                                                                                                      |                |
+| `menuLabel`      | private | `HTMLSpanElement \| null`      | `null`   |                                                                                                                                                                                      |                |
+| `menuIcon`       | private | `HTMLElement \| null`          | `null`   |                                                                                                                                                                                      |                |
+| `menuErrorBadge` | private | `HTMLElement \| null`          | `null`   |                                                                                                                                                                                      |                |
+| `_dropdownSize`  | private | `'sm' \| 'md' \| 'lg'`         |          |                                                                                                                                                                                      |                |
+| `_menuIconSize`  | private | `'sm' \| 'md'`                 |          |                                                                                                                                                                                      |                |
+
+### Methods
+
+| Name   | Privacy | Description                                                                                                                                                                                                                                                                        | Parameters                                              | Return    | Inherited From    |
+| ------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | --------- | ----------------- |
+| `emit` |         | Dispatches a type-safe CustomEvent with standardized configuration.&#xA;&#xA;All events are configured with:&#xA;- bubbles: true (event propagates up the DOM tree)&#xA;- cancelable: false (event cannot be cancelled)&#xA;- composed: true (event crosses shadow DOM boundaries) | `type: K, detail: UnpackCustomEvent<CustomEventMap[K]>` | `boolean` | EventEmitterMixin |
+
+### Events
+
+| Name             | Type                          | Description                                                           | Inherited From |
+| ---------------- | ----------------------------- | --------------------------------------------------------------------- | -------------- |
+| `btu-tabs-ready` | `CustomEvent`                 | Fired after first render and initialization                           |                |
+| `btu-tabs-show`  | `CustomEvent<{name: string}>` | Fired when a tab becomes active                                       |                |
+| `btu-tabs-hide`  | `CustomEvent<{name: string}>` | Fired when a tab is deactivated                                       |                |
+| `btu-tab-change` | `CustomEvent<{name: string}>` | Fired when a tab is selected (bubbles from btu-tab)                   |                |
+| `btu-tab-ready`  | `CustomEvent`                 | Fired when a child tab finishes initialization (bubbles from btu-tab) |                |
+
+### Attributes
+
+| Name         | Field     | Inherited From |
+| ------------ | --------- | -------------- |
+| `size`       | size      |                |
+| `active-tab` | activeTab |                |
+| `variant`    | variant   |                |
+
+### CSS Properties
+
+| Name                            | Default | Description                                                                                             |
+| ------------------------------- | ------- | ------------------------------------------------------------------------------------------------------- |
+| `--tabs-active-color`           |         | Text and icon color of the active tab (default: gray-700)                                               |
+| `--tabs-active-indicator-color` |         | Color of the active tab underline indicator (default: primary-500 → primary-700 → primary-900 gradient) |
+| `--tabs-border-color`           |         | Color of the bottom border divider (default: gray-200)                                                  |
+| `--tabs-color`                  |         | Text and icon color for all tabs (default: gray-500; active/hover tabs use gray-700)                    |
+| `--tabs-background`             |         | Background color for all tab buttons (default: transparent)                                             |
+| `--tabs-container-background`   |         | Background color of the tabs container (default: theme white)                                           |
+| `--tabs-hover-background`       |         | Background color of a tab on hover (default: gray-100)                                                  |
+| `--tabs-hover-color`            |         | Text and icon color of a tab on hover (default: gray-700)                                               |
+| `--tabs-gap`                    |         | Spacing between tabs (default: 1rem)                                                                    |
+
+<hr/>
+
+## Exports
+
+| Kind                        | Name       | Declaration | Module                      | Package |
+| --------------------------- | ---------- | ----------- | --------------------------- | ------- |
+| `js`                        | `default`  | Tabs        | src/components/tabs/Tabs.ts |         |
+| `custom-element-definition` | `btu-tabs` | Tabs        | src/components/tabs/Tabs.ts |         |

package/docs/components/Upload.md

@@ -0,0 +1,112 @@
+# `src/components/upload/Upload.ts`:
+
+## class: `Upload`, `btu-upload`
+
+### Superclass
+
+| Name         | Module | Package |
+| ------------ | ------ | ------- |
+| `LitElement` |        | lit     |
+
+### Mixins
+
+| Name                | Module                         | Package |
+| ------------------- | ------------------------------ | ------- |
+| `EventEmitterMixin` | /src/util/EventEmitterMixin.js |         |
+| `ReadyMixin`        | /src/util/ReadyMixin.js        |         |
+
+### Fields
+
+| Name                  | Privacy | Type                       | Default     | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Inherited From |
+| --------------------- | ------- | -------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
+| `accept`              |         | `string`                   | `''`        | Accepted file types, matching the HTML \`\<input accept>\` attribute format.&#xA;Client-side filter only — the browser's file picker uses this as a hint,&#xA;and drag-drop is enforced by this component. Server-side validation is&#xA;still required.&#xA;&#xA;Supported forms (comma-separated, any combination):&#xA;- \`image/\*\` — MIME wildcard (any image)&#xA;- \`application/pdf\` — exact MIME type&#xA;- \`.pdf\`, \`.docx\` — file extension (case-insensitive)&#xA;&#xA;Examples:&#xA;- \`accept="image/\*"\` — any image&#xA;- \`accept="image/\*,application/pdf"\` — images and PDFs&#xA;- \`accept=".jpg,.jpeg,.png,.heic"\` — specific extensions&#xA;- \`accept=""\` (or omitted) — allow all&#xA;&#xA;Note: users can bypass the file picker's filter (most browsers offer an&#xA;"All Files" option), so this attribute is a UX filter, not a security&#xA;boundary. |                |
+| `maxFileSize`         |         | `number`                   | `0`         | Maximum file size in bytes. Files exceeding this are rejected. 0 means unlimited.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |                |
+| `maxFiles`            |         | `number`                   | `Infinity`  | Maximum number of files allowed. When omitted, uploads are unlimited.&#xA;\`max-files="1"\` enters single-file mode (selecting a new file replaces the existing one).&#xA;\`max-files="0"\` allows zero files. Values above 1 cap the queue at that many files.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                |
+| `disabled`            |         | `boolean`                  | `false`     | Disables all interaction — file selection, drag-and-drop, and action buttons.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |                |
+| `noDrag`              |         | `boolean`                  | `false`     | Disables drag-and-drop. File selection via click still works.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |                |
+| `_files`              | private | `Map<string, FileState>`   | `new Map()` |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                |
+| `_items`              | private | `Map<string, UploadItem>`  | `new Map()` |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                |
+| `_milestones`         | private | `Map<string, Set<number>>` | `new Map()` |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                |
+| `_dragOver`           | private | `boolean`                  | `false`     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                |
+| `_dragCounter`        | private | `number`                   | `0`         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                |
+| `_inputEl`            | private | `HTMLInputElement \| null` |             |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                |
+| `_dropzoneFull`       | private | `boolean`                  |             |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                |
+| `_interactionBlocked` | private | `boolean`                  |             |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                |
+| `_showCountPill`      | private | `boolean`                  |             |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                |
+
+### Methods
+
+| Name                   | Privacy | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Parameters                                                | Return                 | Inherited From    |
+| ---------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | ---------------------- | ----------------- |
+| `_handleInputChange`   | private |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | `e: Event`                                                | `void`                 |                   |
+| `_handleSelectClick`   | private |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | `e: Event`                                                | `void`                 |                   |
+| `_handleDropzoneClick` | private |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                                                           | `void`                 |                   |
+| `_handleDragEnter`     | private |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | `e: DragEvent`                                            | `void`                 |                   |
+| `_handleDragOver`      | private |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | `e: DragEvent`                                            | `void`                 |                   |
+| `_handleDragLeave`     | private |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | `e: DragEvent`                                            | `void`                 |                   |
+| `_handleDrop`          | private |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | `e: DragEvent`                                            | `void`                 |                   |
+| `_processFiles`        | private |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | `files: File[]`                                           | `void`                 |                   |
+| `_rejectCount`         | private |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | `file: File`                                              | `void`                 |                   |
+| `_validateFile`        | private |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | `file: File`                                              | `boolean`              |                   |
+| `_addFile`             | private |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | `file: File`                                              | `void`                 |                   |
+| `_reportUnknownId`     | private |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | `method: ApiMethod, id: string`                           | `void`                 |                   |
+| `_getOrReport`         | private |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | `method: ApiMethod, id: string`                           | `FileState \| null`    |                   |
+| `_renderItem`          | private |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | `fileState: FileState`                                    | `void`                 |                   |
+| `setFileProgress`      |         | Update the progress of a file upload.&#xA;Clamps value to 0-100 and coerces non-finite inputs to 0. Announces milestones&#xA;(25%, 50%, 75%) to screen readers; 100% completion is announced by setFileStatus('complete').&#xA;&#xA;Status transitions:&#xA;- \`pending\` → \`uploading\` (auto — first progress report starts the upload)&#xA;- \`uploading\` → \`uploading\` (progress updates)&#xA;- \`error\` → \`error\` (progress updates only; status is preserved so a stale late&#xA;  callback can't wipe the error UI. To recover from error, call&#xA;  \`setFileStatus(id, 'uploading')\` first, then report progress.)&#xA;- \`complete\` → ignored (terminal state) | `id: string, percent: number`                             | `void`                 |                   |
+| `setFileStatus`        |         | Set the status of a file.&#xA;Valid statuses: 'uploading', 'complete', 'error'. For 'error' status, an&#xA;optional message can be provided.&#xA;&#xA;Transitions from 'complete' are rejected (terminal state) — a late-resolving&#xA;XHR cannot overwrite a prior success. Rejected calls emit \`btu-upload-api-error\`&#xA;with reason: 'invalid-transition'.                                                                                                                                                                                                                                                                                                                   | `id: string, status: FileStatusSettable, message: string` | `void`                 |                   |
+| `setFileSymbol`        |         | Override the icon symbol for a file.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | `id: string, symbol: string`                              | `void`                 |                   |
+| `removeFile`           |         | Remove a file programmatically. Fires \`btu-upload-file-removed\`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `id: string`                                              | `void`                 |                   |
+| `getFiles`             |         | Get a snapshot of all current files and their states.&#xA;States are readonly; mutations on the returned array's elements are ineffective.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                           | `readonly FileState[]` |                   |
+| `_renderSelectButton`  | private |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | `text: string`                                            |                        |                   |
+| `emit`                 |         | Dispatches a type-safe CustomEvent with standardized configuration.&#xA;&#xA;All events are configured with:&#xA;- bubbles: true (event propagates up the DOM tree)&#xA;- cancelable: false (event cannot be cancelled)&#xA;- composed: true (event crosses shadow DOM boundaries)                                                                                                                                                                                                                                                                                                                                                                                                 | `type: K, detail: UnpackCustomEvent<CustomEventMap[K]>`   | `boolean`              | EventEmitterMixin |
+
+### Events
+
+| Name                        | Type                                                                                                       | Description                                                                                      | Inherited From |
+| --------------------------- | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | -------------- |
+| `btu-upload-ready`          | `CustomEvent<unknown>`                                                                                     | Fired when the component has completed first render                                              |                |
+| `btu-upload-file-added`     | `CustomEvent<{id: string, file: File}>`                                                                    | Fired when a file passes validation and is added                                                 |                |
+| `btu-upload-file-removed`   | `CustomEvent<{id: string, file: File}>`                                                                    | Fired when a file is removed (user action, programmatic, or on disconnect for in-flight uploads) |                |
+| `btu-upload-file-retry`     | `CustomEvent<{id: string, file: File}>`                                                                    | Fired when user clicks "Try again" on a failed upload                                            |                |
+| `btu-upload-file-rejected`  | `CustomEvent<{file: File, reason: 'type' \| 'size' \| 'count'}>`                                           | Fired when a file fails client-side validation or the queue is full                              |                |
+| `btu-upload-file-completed` | `CustomEvent<{id: string, file: File}>`                                                                    | Fired when a file's status transitions into 'complete'                                           |                |
+| `btu-upload-api-error`      | `CustomEvent<{method: string, id: string, reason: 'unknown-id' \| 'invalid-transition', message: string}>` | Fired when an imperative API call references an unknown id or an illegal status transition       |                |
+
+### Attributes
+
+| Name            | Field       | Inherited From |
+| --------------- | ----------- | -------------- |
+| `accept`        | accept      |                |
+| `max-file-size` | maxFileSize |                |
+| `max-files`     | maxFiles    |                |
+| `disabled`      | disabled    |                |
+| `no-drag`       | noDrag      |                |
+
+### CSS Properties
+
+| Name                                   | Default | Description                                                                                   |
+| -------------------------------------- | ------- | --------------------------------------------------------------------------------------------- |
+| `--upload-dropzone-bg`                 |         | Drop zone background color (default: gray-25)                                                 |
+| `--upload-dropzone-border-color`       |         | Drop zone border color (default: gray-300; gray-200 when disabled, gray-400 in high-contrast) |
+| `--upload-dropzone-border-radius`      |         | Drop zone border radius (default: borderRadius.lg)                                            |
+| `--upload-dropzone-hover-bg`           |         | Drop zone hover background (hover default: gray-50; drag-over default: primary-25)            |
+| `--upload-dropzone-hover-border-color` |         | Drop zone hover/focus border color (default: primary-300; drag-over uses primary-400)         |
+| `--upload-dropzone-focus-ring-color`   |         | Drop zone focus ring color (default: primary-100)                                             |
+| `--upload-item-bg`                     |         | Item background color (default: white)                                                        |
+| `--upload-item-border-color`           |         | Item border color (default: gray-200)                                                         |
+| `--upload-item-active-border-color`    |         | Item active/in-progress border (default: gray-300)                                            |
+| `--upload-item-complete-border-color`  |         | Item completed border color (default: primary-500)                                            |
+| `--upload-item-error-bg`               |         | Item error background (default: error-25)                                                     |
+| `--upload-item-error-border-color`     |         | Item error border color (default: error-300)                                                  |
+
+<hr/>
+
+## Exports
+
+| Kind                        | Name                 | Declaration        | Module                          | Package |
+| --------------------------- | -------------------- | ------------------ | ------------------------------- | ------- |
+| `js`                        | `FileState`          | FileState          | src/components/upload/Upload.ts |         |
+| `js`                        | `FileStatus`         | FileStatus         | src/components/upload/Upload.ts |         |
+| `js`                        | `FileStatusSettable` | FileStatusSettable | src/components/upload/Upload.ts |         |
+| `js`                        | `default`            | Upload             | src/components/upload/Upload.ts |         |
+| `custom-element-definition` | `btu-upload`         | Upload             | src/components/upload/Upload.ts |         |

package/docs/components/UploadItem.md

@@ -0,0 +1,61 @@
+# `src/components/upload/UploadItem.ts`:
+
+## class: `UploadItem`, `btu-upload-item`
+
+### Superclass
+
+| Name         | Module | Package |
+| ------------ | ------ | ------- |
+| `LitElement` |        | lit     |
+
+### Mixins
+
+| Name                | Module                         | Package |
+| ------------------- | ------------------------------ | ------- |
+| `EventEmitterMixin` | /src/util/EventEmitterMixin.js |         |
+| `ReadyMixin`        | /src/util/ReadyMixin.js        |         |
+
+### Fields
+
+| Name                    | Privacy | Type                 | Default | Description | Inherited From |
+| ----------------------- | ------- | -------------------- | ------- | ----------- | -------------- |
+| `_state`                | private | `FileState \| null`  | `null`  |             |                |
+| `_baseClasses`          | private | `string`             | `''`    |             |                |
+| `_previousStatus`       | private | `FileStatus \| null` | `null`  |             |                |
+| `_stopProgressComplete` | private |                      |         |             |                |
+
+### Methods
+
+| Name                 | Privacy | Description                                                                                                                                                                                                                                                                        | Parameters                                              | Return    | Inherited From    |
+| -------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | --------- | ----------------- |
+| `_scheduleCelebrate` | private |                                                                                                                                                                                                                                                                                    |                                                         | `void`    |                   |
+| `_handleRemove`      | private |                                                                                                                                                                                                                                                                                    |                                                         | `void`    |                   |
+| `_handleRetry`       | private |                                                                                                                                                                                                                                                                                    |                                                         | `void`    |                   |
+| `emit`               |         | Dispatches a type-safe CustomEvent with standardized configuration.&#xA;&#xA;All events are configured with:&#xA;- bubbles: true (event propagates up the DOM tree)&#xA;- cancelable: false (event cannot be cancelled)&#xA;- composed: true (event crosses shadow DOM boundaries) | `type: K, detail: UnpackCustomEvent<CustomEventMap[K]>` | `boolean` | EventEmitterMixin |
+
+### Events
+
+| Name                     | Type                        | Description                         | Inherited From |
+| ------------------------ | --------------------------- | ----------------------------------- | -------------- |
+| `btu-upload-item-remove` | `CustomEvent<{id: string}>` | Fired when remove button is clicked |                |
+| `btu-upload-item-retry`  | `CustomEvent<{id: string}>` | Fired when retry link is clicked    |                |
+
+### CSS Properties
+
+| Name                                  | Default | Description                                        |
+| ------------------------------------- | ------- | -------------------------------------------------- |
+| `--upload-item-bg`                    |         | Item background color (default: white)             |
+| `--upload-item-border-color`          |         | Item border color (default: gray-200)              |
+| `--upload-item-active-border-color`   |         | Item active/in-progress border (default: gray-300) |
+| `--upload-item-complete-border-color` |         | Item completed border color (default: primary-500) |
+| `--upload-item-error-bg`              |         | Item error background (default: error-25)          |
+| `--upload-item-error-border-color`    |         | Item error border color (default: error-300)       |
+
+<hr/>
+
+## Exports
+
+| Kind                        | Name              | Declaration | Module                              | Package |
+| --------------------------- | ----------------- | ----------- | ----------------------------------- | ------- |
+| `js`                        | `default`         | UploadItem  | src/components/upload/UploadItem.ts |         |
+| `custom-element-definition` | `btu-upload-item` | UploadItem  | src/components/upload/UploadItem.ts |         |

package/docs/components/Widget.md

@@ -35,6 +35,12 @@
 | `_fullscreenTooltip` | private |           | `new TooltipController(this, { target: 'button[data-tooltip="fullscreen"]', text: () => (this._isFullscreen ? 'Exit fullscreen' : 'Enter fullscreen'), position: 'bottom', noArrow: true, offset: 'sm', })` |                                                                                                                                      |                |
 | `isFullscreen`       |         | `boolean` |                                                                                                                                                                                                             | Whether the widget is currently in fullscreen mode (read-only).
Use \`btu-widget-fullscreen-changed\` event to react to changes. |                |
 
+### Methods
+
+| Name   | Privacy | Description                                                                                                                                                                                                                                                                        | Parameters                                              | Return    | Inherited From    |
+| ------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | --------- | ----------------- |
+| `emit` |         | Dispatches a type-safe CustomEvent with standardized configuration.&#xA;&#xA;All events are configured with:&#xA;- bubbles: true (event propagates up the DOM tree)&#xA;- cancelable: false (event cannot be cancelled)&#xA;- composed: true (event crosses shadow DOM boundaries) | `type: K, detail: UnpackCustomEvent<CustomEventMap[K]>` | `boolean` | EventEmitterMixin |
+
 ### Events
 
 | Name                            | Type                                 | Description                                 | Inherited From |
@@ -51,15 +57,15 @@
 | `collapsible`    | collapsible    |                |
 | `collapsed`      | collapsed      |                |
 | `fullscreenable` | fullscreenable |                |
-| `id`             |                |                |
 
 ### CSS Properties
 
-| Name                  | Default | Description                                                   |
-| --------------------- | ------- | ------------------------------------------------------------- |
-| `--widget-background` |         | Body and footer background color (default: --btu-theme-white) |
-| `--widget-border`     |         | Widget border and dividers (default: 1px solid gray-200)      |
-| `--header-background` |         | Header background color (default: transparent)                |
+| Name                    | Default | Description                                                   |
+| ----------------------- | ------- | ------------------------------------------------------------- |
+| `--widget-background`   |         | Body and footer background color (default: --btu-theme-white) |
+| `--widget-border`       |         | Widget border and dividers (default: 1px solid gray-200)      |
+| `--widget-border-color` |         | Color of header bottom divider (default: gray-200)            |
+| `--header-background`   |         | Header background color (default: transparent)                |
 
 ### Slots
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brightspot/ui",
-  "version": "1.10.0",
+  "version": "3.0.0",
   "type": "module",
   "license": "UNLICENSED",
   "description": "A UI library for building Brightspot CMS components.",
@@ -25,6 +25,8 @@
     "storybook": "yarn cem && storybook dev -p 6006",
     "build-storybook": "yarn cem && storybook build -o ./dist/storybook",
     "test:storybook": "vitest --project=storybook",
+    "check:conventions": "yarn cem && node scripts/check-conventions-all.mjs",
+    "check:conventions:fast": "node scripts/check-conventions.mjs",
     "prepare": "husky"
   },
   "devDependencies": {
@@ -59,7 +61,7 @@
     "postcss-loader": "^8.0.0",
     "prettier": "^3.2.5",
     "prettier-plugin-organize-imports": "^4.3.0",
-    "prettier-plugin-tailwindcss": "^0.6.8",
+    "prettier-plugin-tailwindcss": "0.7.2",
     "shx": "^0.4.0",
     "storybook": "10.2.12",
     "style-loader": "^3.3.1",