@brightspot/ui 1.10.0 → 3.0.0

package/docs/components/Icon.md

@@ -23,11 +23,18 @@
 
 ### Fields
 
-| Name       | Privacy | Type                                                                                                            | Default           | Description                                                                                                                                                                     | Inherited From |
-| ---------- | ------- | --------------------------------------------------------------------------------------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
-| `size`     |         | `'xs' \| 'sm' \| 'md' \| 'lg' \| 'xl'`                                                                          | `'md'`            | Size of the icon.
- 'xs': Extra small (0.75rem)
- 'sm': Small (1rem)
- 'md': Medium (1.25rem, default)
- 'lg': Large (1.5rem)
- 'xl': Extra large (1.75rem) |                |
-| `symbol`   |         | `string`                                                                                                        | `'circle-dashed'` | Lucide icon name to display.
See https\://lucide.dev/icons/ for available icons.                                                                                            |                |
-| `gradient` |         | `'ai' \| 'error' \| 'gray' \| 'primary' \| 'purple' \| 'rose' \| 'success' \| 'teal' \| 'warning' \| undefined` |                   | Theme color to use for gradient fill.
When set, icon displays with gradient. When undefined, icon inherits parent text color.                                               |                |
+| Name        | Privacy | Type                                   | Default           | Description                                                                                                                                                                                                                                                                                                                                                                                                                                     | Inherited From |
+| ----------- | ------- | -------------------------------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
+| `size`      |         | `'xs' \| 'sm' \| 'md' \| 'lg' \| 'xl'` | `'md'`            | Size of the icon.
- 'xs': Extra small (0.75rem)
- 'sm': Small (1rem)
- 'md': Medium (1.25rem, default)
- 'lg': Large (1.5rem)
- 'xl': Extra large (1.75rem)                                                                                                                                                                                                                                                                 |                |
+| `symbol`    |         | `string`                               | `'circle-dashed'` | Lucide icon name to display.
See https\://lucide.dev/icons/ for available icons.                                                                                                                                                                                                                                                                                                                                                            |                |
+| `gradient`  |         | `IconGradientColor \| undefined`       |                   | Theme color to use for gradient fill.
When set, icon displays with gradient. When undefined, icon inherits parent text color.                                                                                                                                                                                                                                                                                                               |                |
+| `emphasize` |         | `boolean \| 'pulse' \| undefined`      |                   | Emphasize mode — renders a tonal circle with ring behind the icon.
Colors are derived from \`currentColor\` via oklch relative color syntax.
Defaults to primary; override with Tailwind \`text-\*\` classes or \`style="color: ..."\`.
Set as a boolean for the static circle, or \`"pulse"\` for a one-shot ring animation.
Not intended for use with \`gradient\` — the two features target
conflicting rendering modes. |                |
+
+### 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
 
@@ -37,20 +44,21 @@
 
 ### Attributes
 
-| Name       | Field    | Inherited From |
-| ---------- | -------- | -------------- |
-| `size`     | size     |                |
-| `symbol`   | symbol   |                |
-| `gradient` | gradient |                |
+| Name        | Field     | Inherited From |
+| ----------- | --------- | -------------- |
+| `size`      | size      |                |
+| `symbol`    | symbol    |                |
+| `gradient`  | gradient  |                |
+| `emphasize` | emphasize |                |
 
 ### CSS Properties
 
 | Name                  | Default | Description                                                                                         |
 | --------------------- | ------- | --------------------------------------------------------------------------------------------------- |
-| `--Icon-size`         |         | Icon size (overrides size default)                                                                  |
-| `--Icon-stroke-width` |         | SVG stroke width as a unitless number in viewBox units; scales visually with icon size (default: 2) |
-| `--Icon-fill`         |         | Icon fill color for filled icons (e.g., "currentColor")                                             |
-| `--Icon-svg`          |         | SVG data URI for mask-based rendering                                                               |
+| `--icon-size`         |         | Icon size (overrides size default)                                                                  |
+| `--icon-stroke-width` |         | SVG stroke width as a unitless number in viewBox units; scales visually with icon size (default: 2) |
+| `--icon-fill`         |         | Icon fill color for filled icons (e.g., "currentColor")                                             |
+| `--icon-svg`          |         | SVG data URI for mask-based rendering                                                               |
 
 <hr/>
 

package/docs/components/IconButton.md

@@ -18,22 +18,36 @@
 
 ### Fields
 
-| Name          | Privacy | Type                  | Default     | Description                                                                                                                                               | Inherited From |
-| ------------- | ------- | --------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
-| `name`        |         | `string \| undefined` |             | Optional name for the button which can be used to identify the button in a callback.                                                                      |                |
-| `type`        |         | `IconButtonType`      | `'primary'` | Specifies the type of icon-button, controlling the visual style.                                                                                          |                |
-| `iconSymbol`  |         | `string \| undefined` |             | Lucide icon name.                                                                                                                                         |                |
-| `size`        |         | `IconButtonSize`      | `'medium'`  | Specifies the size of icon-button.                                                                                                                        |                |
-| `destructive` |         | `boolean`             | `false`     | Specifies an icon-button will be used to take any destructive action overriding the
default color used for the icon-button type with the error color. |                |
-| `disabled`    |         | `boolean`             | `false`     | Disables the button, preventing interaction and indicating an inactive state.                                                                             |                |
+| Name               | Privacy | Type                                     | Default         | Description                                                                                                                                               | Inherited From |
+| ------------------ | ------- | ---------------------------------------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
+| `name`             |         | `string \| undefined`                    |                 | Optional name for the button which can be used to identify the button in a callback.                                                                      |                |
+| `type`             |         | `IconButtonType`                         | `'primary'`     | Specifies the type of icon-button, controlling the visual style.                                                                                          |                |
+| `symbol`           |         | `string \| undefined`                    |                 | Lucide icon symbol.                                                                                                                                       |                |
+| `size`             |         | `IconButtonSize`                         | `'md'`          | Specifies the size of icon-button.                                                                                                                        |                |
+| `destructive`      |         | `boolean`                                | `false`         | Specifies an icon-button will be used to take any destructive action overriding the
default color used for the icon-button type with the error color. |                |
+| `disabled`         |         | `boolean`                                | `false`         | Disables the button, preventing interaction and indicating an inactive state.                                                                             |                |
+| `tooltip`          |         | `string`                                 | `''`            | Tooltip text content. Set to empty string to remove the tooltip.                                                                                          | TooltipMixin   |
+| `tooltipPosition`  |         | `'top' \| 'bottom' \| 'left' \| 'right'` | `'top'`         | Position relative to the host element. Auto-flips when constrained by the viewport.                                                                       | TooltipMixin   |
+| `tooltipDelay`     |         | `number`                                 | `300`           | Show delay in milliseconds (hover trigger only).                                                                                                          | TooltipMixin   |
+| `tooltipOffset`    |         | `TooltipOffset \| null`                  | `null`          | Gap between host and tooltip (sm=4px, md=8px, lg=12px, xl=16px).                                                                                          | TooltipMixin   |
+| `tooltipNoArrow`   |         | `boolean`                                | `false`         | Hide the arrow pseudo-element.                                                                                                                            | TooltipMixin   |
+| `tooltipTrigger`   |         | `string`                                 | `'hover focus'` | Space-separated trigger types: 'hover', 'focus', 'click'.                                                                                                 | TooltipMixin   |
+| `_onMouseLeave`    | private |                                          |                 |                                                                                                                                                           | TooltipMixin   |
+| `_onFocusIn`       | private |                                          |                 |                                                                                                                                                           | TooltipMixin   |
+| `_onFocusOut`      | private |                                          |                 |                                                                                                                                                           | TooltipMixin   |
+| `_onClick`         | private |                                          |                 |                                                                                                                                                           | TooltipMixin   |
+| `_onNativeToggle`  | private |                                          |                 |                                                                                                                                                           | TooltipMixin   |
+| `_onKeyDown`       | private |                                          |                 |                                                                                                                                                           | TooltipMixin   |
+| `_onDocumentClick` | private | `((e: MouseEvent) => void) \| null`      | `null`          |                                                                                                                                                           | TooltipMixin   |
 
 ### Methods
 
-| Name                  | Privacy | Description | Parameters | Return   | Inherited From |
-| --------------------- | ------- | ----------- | ---------- | -------- | -------------- |
-| `_relayTooltipAttrs`  | private |             |            | `void`   |                |
-| `_handleClick`        | private |             |            | `void`   |                |
-| `_buildButtonClasses` | private |             |            | `string` |                |
+| Name                  | Privacy | Description                                                                                                                                                                                                                                                                        | Parameters                                              | Return    | Inherited From    |
+| --------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | --------- | ----------------- |
+| `_relayTooltipAttrs`  | private |                                                                                                                                                                                                                                                                                    |                                                         | `void`    |                   |
+| `_handleClick`        | private |                                                                                                                                                                                                                                                                                    |                                                         | `void`    |                   |
+| `_buildButtonClasses` | private |                                                                                                                                                                                                                                                                                    |                                                         | `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
 
@@ -44,14 +58,25 @@
 
 ### Attributes
 
-| Name          | Field       | Inherited From |
-| ------------- | ----------- | -------------- |
-| `name`        | name        |                |
-| `type`        | type        |                |
-| `icon-symbol` | iconSymbol  |                |
-| `size`        | size        |                |
-| `destructive` | destructive |                |
-| `disabled`    | disabled    |                |
+| Name               | Field           | Inherited From |
+| ------------------ | --------------- | -------------- |
+| `name`             | name            |                |
+| `type`             | type            |                |
+| `symbol`           | symbol          |                |
+| `size`             | size            |                |
+| `destructive`      | destructive     |                |
+| `disabled`         | disabled        |                |
+| `tooltip`          | tooltip         | TooltipMixin   |
+| `tooltipPosition`  | tooltipPosition | TooltipMixin   |
+| `tooltipDelay`     | tooltipDelay    | TooltipMixin   |
+| `tooltipOffset`    | tooltipOffset   | TooltipMixin   |
+| `tooltipNoArrow`   | tooltipNoArrow  | TooltipMixin   |
+| `tooltipTrigger`   | tooltipTrigger  | TooltipMixin   |
+| `tooltip-position` | tooltipPosition | TooltipMixin   |
+| `tooltip-delay`    | tooltipDelay    | TooltipMixin   |
+| `tooltip-offset`   | tooltipOffset   | TooltipMixin   |
+| `tooltip-no-arrow` | tooltipNoArrow  | TooltipMixin   |
+| `tooltip-trigger`  | tooltipTrigger  | TooltipMixin   |
 
 <hr/>
 

package/docs/components/LinearProgress.md

@@ -16,12 +16,51 @@
 | `EventEmitterMixin` | /src/util/EventEmitterMixin.js |         |
 | `ReadyMixin`        | /src/util/ReadyMixin.js        |         |
 
+### Fields
+
+| Name                      | Privacy | Type                                               | Default     | Description                                                                                                                                 | Inherited From |
+| ------------------------- | ------- | -------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
+| `color`                   |         | `ProgressColors`                                   | `'primary'` | Color theme of the progress indicator.
Supports: black, white, primary, teal, gray, purple, rose, error, warning, success               | ProgressMixin  |
+| `thickness`               |         | `number \| undefined`                              |             | Stroke width of the progress indicator.                                                                                                     | ProgressMixin  |
+| `_progress`               | private | `number`                                           | `0`         |                                                                                                                                             | ProgressMixin  |
+| `progress`                |         |                                                    |             | Progress value for determinate variant. Clamped to 0–100.                                                                                   | ProgressMixin  |
+| `label`                   |         | `string \| undefined`                              |             | Optional label text to display with the progress indicator.                                                                                 | ProgressMixin  |
+| `initialAnimation`        |         | `boolean`                                          | `true`      | Whether to animate progress from 0 to target value when component first becomes visible.                                                    | ProgressMixin  |
+| `ariaLabel`               |         | `string \| null`                                   | `null`      | Optional aria-label attribute for screen readers.
Describes what the progress indicator represents.                                     | ProgressMixin  |
+| `ariaLabelledBy`          |         | `string \| null`                                   | `null`      | Optional aria-labelledby attribute for screen readers.
References the ID of an element that labels the progress indicator.              | ProgressMixin  |
+| `ariaValueText`           |         | `string \| null`                                   | `null`      | Optional aria-valuetext attribute for screen readers.
Provides human-readable text alternative for progress value.                      | ProgressMixin  |
+| `completionAnnouncement`  |         | `string \| undefined`                              |             | Optional message to announce to screen readers when progress reaches 100%.
If not provided, no announcement will be made on completion. | ProgressMixin  |
+| `_isAnimationInitialized` | private | `boolean`                                          | `false`     |                                                                                                                                             | ProgressMixin  |
+| `_intersectionObserver`   | private | `IntersectionObserver \| undefined`                |             |                                                                                                                                             | ProgressMixin  |
+| `_hasCompletedAt100`      | private | `boolean`                                          | `false`     |                                                                                                                                             | ProgressMixin  |
+| `_hostTag`                | private | `'btu-linear-progress' \| 'btu-circular-progress'` |             |                                                                                                                                             | ProgressMixin  |
+
+### 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-progress-ready`    | `CustomEvent` | Fired after first render and initialization |                |
-| `btu-progress-complete` | `CustomEvent` | Fired when progress reaches 100             |                |
+| Name                           | Type          | Description                                 | Inherited From |
+| ------------------------------ | ------------- | ------------------------------------------- | -------------- |
+| `btu-linear-progress-ready`    | `CustomEvent` | Fired after first render and initialization |                |
+| `btu-linear-progress-complete` | `CustomEvent` | Fired when progress reaches 100             |                |
+
+### Attributes
+
+| Name                      | Field                  | Inherited From |
+| ------------------------- | ---------------------- | -------------- |
+| `color`                   | color                  | ProgressMixin  |
+| `thickness`               | thickness              | ProgressMixin  |
+| `progress`                | progress               | ProgressMixin  |
+| `label`                   | label                  | ProgressMixin  |
+| `initial-animation`       | initialAnimation       | ProgressMixin  |
+| `aria-label`              | ariaLabel              | ProgressMixin  |
+| `aria-labelledby`         | ariaLabelledBy         | ProgressMixin  |
+| `aria-valuetext`          | ariaValueText          | ProgressMixin  |
+| `completion-announcement` | completionAnnouncement | ProgressMixin  |
 
 ### CSS Properties
 

package/docs/components/Pagination.md

@@ -17,35 +17,38 @@
 
 ### Fields
 
-| Name                     | Privacy | Type                  | Default        | Description                                       | Inherited From |
-| ------------------------ | ------- | --------------------- | -------------- | ------------------------------------------------- | -------------- |
-| `page`                   |         | `number`              | `1`            | Current page number (1-based)                     |                |
-| `pageSize`               |         | `number`              | `0`            | Number of items per page                          |                |
-| `disabled`               |         | `boolean`             | `false`        | Disables all pagination controls                  |                |
-| `loading`                |         | `boolean`             | `false`        | Shows loading spinner and dims controls           |                |
-| `hideOnSinglePage`       |         | `boolean`             | `true`         | Hide controls when there is only one page         |                |
-| `pageSizeChanger`        |         | `boolean`             | `true`         | Show the page size dropdown                       |                |
-| `pageSizeOptions`        |         | `string`              | `'10, 20, 50'` | Comma-separated page size options                 |                |
-| `totalItems`             |         | `number`              | `0`            | Total number of items across all pages            |                |
-| `boundaryButtons`        |         | `boolean`             | `true`         | Show first and last page buttons                  |                |
-| `hideTotalCount`         |         | `boolean`             | `false`        | Hide the item count display (e.g., "1-10 of 200") |                |
-| `label`                  |         | `string \| undefined` |                | Accessible label for the pagination nav landmark  |                |
-| `_parsedPageSizeOptions` | private | `number[]`            |                |                                                   |                |
-| `_totalPages`            | private | `number`              |                |                                                   |                |
-| `_startItem`             | private | `number`              |                |                                                   |                |
-| `_endItem`               | private | `number`              |                |                                                   |                |
+| Name                     | Privacy | Type                  | Default        | Description                                                                                                                                                                             | Inherited From |
+| ------------------------ | ------- | --------------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
+| `page`                   |         | `number`              | `1`            | Current page number (1-based)                                                                                                                                                           |                |
+| `pageSize`               |         | `number`              | `0`            | Number of items per page                                                                                                                                                                |                |
+| `disabled`               |         | `boolean`             | `false`        | Disables all pagination controls                                                                                                                                                        |                |
+| `loading`                |         | `boolean`             | `false`        | Shows loading spinner and dims controls                                                                                                                                                 |                |
+| `hideOnSinglePage`       |         | `boolean`             | `true`         | Hide controls when there is only one page                                                                                                                                               |                |
+| `pageSizeChanger`        |         | `boolean`             | `true`         | Show the page size dropdown                                                                                                                                                             |                |
+| `pageSizeOptions`        |         | `string`              | `'10, 20, 50'` | Comma-separated page size options                                                                                                                                                       |                |
+| `totalItems`             |         | `number`              | `0`            | Total number of items across all pages                                                                                                                                                  |                |
+| `boundaryButtons`        |         | `boolean`             | `true`         | Show first and last page buttons                                                                                                                                                        |                |
+| `hideTotalCount`         |         | `boolean`             | `false`        | Hide the item count display (e.g., "1-10 of 200")                                                                                                                                       |                |
+| `pageJumper`             |         | `boolean`             | `false`        | Show the page jumper dropdown. Intended for moderate page counts (under \~100 pages).
For large datasets, use a custom \`slot="jumper"\` with a virtualized or input-based control. |                |
+| `label`                  |         | `string \| undefined` |                | Accessible label for the pagination nav landmark                                                                                                                                        |                |
+| `_parsedPageSizeOptions` | private | `number[]`            |                |                                                                                                                                                                                         |                |
+| `_totalPages`            | private | `number`              |                |                                                                                                                                                                                         |                |
+| `_startItem`             | private | `number`              |                |                                                                                                                                                                                         |                |
+| `_endItem`               | private | `number`              |                |                                                                                                                                                                                         |                |
 
 ### Methods
 
-| Name                   | Privacy | Description | Parameters                  | Return | Inherited From |
-| ---------------------- | ------- | ----------- | --------------------------- | ------ | -------------- |
-| `_setupSlots`          | private |             |                             | `void` |                |
-| `_goToFirstPage`       | private |             | `e: Event`                  | `void` |                |
-| `_goToPreviousPage`    | private |             | `e: Event`                  | `void` |                |
-| `_goToNextPage`        | private |             | `e: Event`                  | `void` |                |
-| `_goToLastPage`        | private |             | `e: Event`                  | `void` |                |
-| `_manageBoundaryFocus` | private |             | `clickedButton: IconButton` | `void` |                |
-| `_onPageSizeChange`    | private |             | `e: Event`                  | `void` |                |
+| Name                       | Privacy | Description                                                                                                                                                                                                                                                                        | Parameters                                              | Return    | Inherited From    |
+| -------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | --------- | ----------------- |
+| `_setupSlots`              | private |                                                                                                                                                                                                                                                                                    |                                                         | `void`    |                   |
+| `_goToFirstPage`           | private |                                                                                                                                                                                                                                                                                    | `e: Event`                                              | `void`    |                   |
+| `_goToPreviousPage`        | private |                                                                                                                                                                                                                                                                                    | `e: Event`                                              | `void`    |                   |
+| `_goToNextPage`            | private |                                                                                                                                                                                                                                                                                    | `e: Event`                                              | `void`    |                   |
+| `_goToLastPage`            | private |                                                                                                                                                                                                                                                                                    | `e: Event`                                              | `void`    |                   |
+| `_manageBoundaryFocus`     | private |                                                                                                                                                                                                                                                                                    | `clickedButton: IconButton`                             | `void`    |                   |
+| `_onBuiltinPageSizeSelect` | private |                                                                                                                                                                                                                                                                                    | `e: Event`                                              | `void`    |                   |
+| `_onBuiltinJumperSelect`   | private |                                                                                                                                                                                                                                                                                    | `e: Event`                                              | `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
 
@@ -69,21 +72,22 @@
 | `total-items`         | totalItems       |                |
 | `boundary-buttons`    | boundaryButtons  |                |
 | `hide-total-count`    | hideTotalCount   |                |
+| `page-jumper`         | pageJumper       |                |
 | `label`               | label            |                |
 
 ### CSS Properties
 
-| Name                            | Default | Description                                      |
-| ------------------------------- | ------- | ------------------------------------------------ |
-| `--pagination-color-background` |         | Background color for select, buttons, and jumper |
-| `--pagination-color-foreground` |         | Text/icon color                                  |
+| Name                            | Default | Description                                         |
+| ------------------------------- | ------- | --------------------------------------------------- |
+| `--pagination-color-background` |         | Background color for dropdowns, buttons, and jumper |
+| `--pagination-color-foreground` |         | Text/icon color                                     |
 
 ### Slots
 
-| Name        | Description                                                 |
-| ----------- | ----------------------------------------------------------- |
-| `page-size` | Custom page-size selector (replaces built-in select)        |
-| `jumper`    | Custom jumper content (e.g., page dropdown, "Today" button) |
+| Name        | Description                                                                                    |
+| ----------- | ---------------------------------------------------------------------------------------------- |
+| `page-size` | Custom page-size selector (replaces built-in dropdown). Consumer manages all behavior.         |
+| `jumper`    | Custom jumper content (replaces built-in page jumper dropdown). Consumer manages all behavior. |
 
 <hr/>
 

package/docs/components/Popover.md

@@ -34,6 +34,12 @@
 | `_onNativeToggle`      | private |                                          |            |                                                                                                                                                             |                |
 | `_onKeyDown`           | private |                                          |            |                                                                                                                                                             |                |
 
+### 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 |
@@ -54,6 +60,16 @@
 | `panel-label` | panelLabel |                |
 | `no-arrow`    | noArrow    |                |
 
+### CSS Properties
+
+| Name                         | Default | Description                                                                           |
+| ---------------------------- | ------- | ------------------------------------------------------------------------------------- |
+| `--popover-color-background` |         | Panel background color (default: var(--btu-theme-white))                              |
+| `--popover-color-content`    |         | Panel text color (default: oklch(var(--btu-theme-gray-900)))                          |
+| `--popover-border-radius`    |         | Panel corner radius (default: theme borderRadius.lg)                                  |
+| `--popover-offset`           |         | Gap between trigger and panel (default: 8px; see btu-popover-offset-{sm\|md\|lg\|xl}) |
+| `--popover-arrow-size`       |         | Width/height of the pointer arrow (default: 8px)                                      |
+
 ### Slots
 
 | Name      | Description                                          |

package/docs/components/README.md

@@ -4,20 +4,29 @@ This directory contains auto-generated API documentation for all Brightspot UI w
 
 ## Components
 
+- [`<btu-action-bar>` - ActionBar](ActionBar.md)
+- [`<btu-action-item>` - ActionItem](ActionItem.md)
 - [`<btu-avatar>` - Avatar](Avatar.md)
 - [`<btu-avatar-group>` - AvatarGroup](AvatarGroup.md)
 - [`<btu-badge>` - Badge](Badge.md)
+- [`<btu-button-group>` - ButtonGroup](ButtonGroup.md)
+- [`<btu-checkbox>` - Checkbox](Checkbox.md)
 - [`<btu-circular-progress>` - CircularProgress](CircularProgress.md)
 - [`<btu-copy-to-clipboard>` - CopyToClipboard](CopyToClipboard.md)
 - [`<btu-dropdown>` - Dropdown](Dropdown.md)
 - [`<btu-dropdown-item>` - DropdownItem](DropdownItem.md)
 - [`<btu-dropdown-menu>` - DropdownMenu](DropdownMenu.md)
+- [`<btu-empty-state>` - EmptyState](EmptyState.md)
 - [`<btu-icon>` - Icon](Icon.md)
 - [`<btu-icon-button>` - IconButton](IconButton.md)
 - [`<btu-linear-progress>` - LinearProgress](LinearProgress.md)
 - [`<btu-pagination>` - Pagination](Pagination.md)
 - [`<btu-popover>` - Popover](Popover.md)
 - [`<btu-switch>` - Switch](Switch.md)
+- [`<btu-tab>` - Tab](Tab.md)
+- [`<btu-tabs>` - Tabs](Tabs.md)
+- [`<btu-upload>` - Upload](Upload.md)
+- [`<btu-upload-item>` - UploadItem](UploadItem.md)
 - [`<btu-widget>` - Widget](Widget.md)
 
 ---

package/docs/components/Switch.md

@@ -17,25 +17,26 @@
 
 ### Fields
 
-| Name            | Privacy | Type                             | Default   | Description                                                                         | Inherited From |
-| --------------- | ------- | -------------------------------- | --------- | ----------------------------------------------------------------------------------- | -------------- |
-| `size`          |         | `'small' \| 'medium' \| 'large'` | `'small'` | Controls the physical dimensions of the switch and the associated label typography. |                |
-| `label`         |         | `string \| undefined`            |           | The primary text displayed next to the toggle.                                      |                |
-| `description`   |         | `string \| undefined`            |           | Optional helper text or secondary information displayed below the label.            |                |
-| `checked`       |         | `boolean`                        | `false`   | The current state of the switch (on/off).                                           |                |
-| `disabled`      |         | `boolean`                        | `false`   | If true, the toggle is non-interactive and visually muted.                          |                |
-| `name`          |         | `string \| undefined`            |           | Name of the control for form participation.                                         |                |
-| `labelPosition` |         | `'start' \| 'end'`               | `'end'`   | Determines if the label appears to the left or right of the switch.                 |                |
-| `onIcon`        |         | `string \| undefined`            |           | Lucide icon name shown on the track when the switch is checked (on).                |                |
-| `offIcon`       |         | `string \| undefined`            |           | Lucide icon name shown on the track when the switch is unchecked (off).             |                |
+| Name            | Privacy | Type                   | Default | Description                                                                         | Inherited From |
+| --------------- | ------- | ---------------------- | ------- | ----------------------------------------------------------------------------------- | -------------- |
+| `size`          |         | `'sm' \| 'md' \| 'lg'` | `'sm'`  | Controls the physical dimensions of the switch and the associated label typography. |                |
+| `label`         |         | `string \| undefined`  |         | The primary text displayed next to the toggle.                                      |                |
+| `description`   |         | `string \| undefined`  |         | Optional helper text or secondary information displayed below the label.            |                |
+| `checked`       |         | `boolean`              | `false` | The current state of the switch (on/off).                                           |                |
+| `disabled`      |         | `boolean`              | `false` | If true, the toggle is non-interactive and visually muted.                          |                |
+| `name`          |         | `string \| undefined`  |         | Name of the control for form participation.                                         |                |
+| `labelPosition` |         | `'start' \| 'end'`     | `'end'` | Determines if the label appears to the left or right of the switch.                 |                |
+| `onIcon`        |         | `string \| undefined`  |         | Lucide icon name shown on the track when the switch is checked (on).                |                |
+| `offIcon`       |         | `string \| undefined`  |         | Lucide icon name shown on the track when the switch is unchecked (off).             |                |
 
 ### Methods
 
-| Name             | Privacy | Description | Parameters | Return | Inherited From |
-| ---------------- | ------- | ----------- | ---------- | ------ | -------------- |
-| `_onInputChange` | private |             | `e: Event` | `void` |                |
-| `_onFocus`       | private |             |            | `void` |                |
-| `_toggleInput`   | private |             |            | `void` |                |
+| Name             | Privacy | Description                                                                                                                                                                                                                                                                        | Parameters                                              | Return    | Inherited From    |
+| ---------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | --------- | ----------------- |
+| `_onInputChange` | private |                                                                                                                                                                                                                                                                                    | `e: Event`                                              | `void`    |                   |
+| `_onFocus`       | private |                                                                                                                                                                                                                                                                                    |                                                         | `void`    |                   |
+| `_toggleInput`   | 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
 
@@ -67,6 +68,10 @@
 | `--switch-color-track-off` |         | Background color when the toggle is unchecked (default: var(--btu-theme-gray-300))  |
 | `--switch-color-knob`      |         | Color of the sliding circular handle (default: var(--btu-theme-white))              |
 | `--switch-label-spacing`   |         | Distance between the switch and the text label (default: 0.75rem)                   |
+| `--switch-track-width`     |         | Track width (default: sm 1.75rem, md 2.25rem, lg 2.75rem)                           |
+| `--switch-track-height`    |         | Track height (default: sm 1rem, md 1.25rem, lg 1.5rem)                              |
+| `--switch-knob-size`       |         | Knob diameter (default: sm 0.75rem, md 1rem, lg 1.25rem)                            |
+| `--switch-knob-padding`    |         | Space between knob and track edges (default: 0.125rem)                              |
 | `--switch-track-icon-size` |         | Size of the track icons (default: sm 0.5rem, md 0.625rem, lg 0.75rem)               |
 
 <hr/>

package/docs/components/Tab.md

@@ -0,0 +1,79 @@
+# `src/components/tabs/Tab.ts`:
+
+## class: `Tab`, `btu-tab`
+
+### Superclass
+
+| Name         | Module | Package |
+| ------------ | ------ | ------- |
+| `LitElement` |        | lit     |
+
+### Mixins
+
+| Name                | Module                         | Package |
+| ------------------- | ------------------------------ | ------- |
+| `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 |
+| -------------- | ------- | ------------------------- | ----------- | ----------------------------------------------------------------------------------------------------- | -------------- |
+| `name`         |         | `string \| undefined`     |             | Value that identifies this tab and links it to panel elements that share the same \`name\` attribute. |                |
+| `label`        |         | `string \| undefined`     |             | Text displayed in the tab.                                                                            |                |
+| `description`  |         | `string \| undefined`     |             | Accessibility description for screen readers.                                                         |                |
+| `disabled`     |         | `boolean`                 | `false`     | Whether the tab is disabled and non-interactive.                                                      |                |
+| `symbol`       |         | `string \| undefined`     |             | Lucide icon symbol to display.                                                                        |                |
+| `iconPosition` |         | `'leading' \| 'trailing'` | `'leading'` | Placement of the icon relative to the label.                                                          |                |
+| `iconOnly`     |         | `boolean`                 | `false`     | When true, hides the label visually while maintaining accessibility.                                  |                |
+| `error`        |         | `boolean`                 | `false`     | When true, displays an error badge on the tab.                                                        |                |
+| `badge`        |         | `string \| undefined`     |             | Displays a badge with the given value alongside the label.                                            |                |
+
+### 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-tab-ready`  | `CustomEvent`                 | Fired after first render                             |                |
+| `btu-tab-change` | `CustomEvent<{name: string}>` | Fired when a non-disabled tab with a name is clicked |                |
+
+### Attributes
+
+| Name            | Field        | Inherited From |
+| --------------- | ------------ | -------------- |
+| `name`          | name         |                |
+| `label`         | label        |                |
+| `description`   | description  |                |
+| `disabled`      | disabled     |                |
+| `symbol`        | symbol       |                |
+| `icon-position` | iconPosition |                |
+| `icon-only`     | iconOnly     |                |
+| `error`         | error        |                |
+| `badge`         | badge        |                |
+
+### CSS Properties
+
+| Name                       | Default | Description                                                      |
+| -------------------------- | ------- | ---------------------------------------------------------------- |
+| `--badge-color-background` |         | Background color of the count indicator badge (default: gray-50) |
+| `--badge-color-foreground` |         | Text color of the count indicator badge (default: gray-700)      |
+
+<hr/>
+
+## Exports
+
+| Kind                        | Name      | Declaration | Module                     | Package |
+| --------------------------- | --------- | ----------- | -------------------------- | ------- |
+| `js`                        | `default` | Tab         | src/components/tabs/Tab.ts |         |
+| `custom-element-definition` | `btu-tab` | Tab         | src/components/tabs/Tab.ts |         |