@brightspot/ui 1.9.0 → 1.11.0

package/dist/util/RovingTabindexMixin.d.ts

@@ -0,0 +1,38 @@
+import { LitElement } from 'lit';
+type Constructor<T = object> = new (...args: any[]) => T;
+export declare class RovingTabindexInterface {
+    _rovingIndex: number;
+    _getRovingTargets(): HTMLElement[];
+    _rovingFocus(index: number, shouldFocus?: boolean): void;
+    _rovingNext(): void;
+    _rovingPrev(): void;
+    _rovingFirst(): void;
+    _rovingLast(): void;
+    _rovingCurrentIndex(): number;
+}
+/**
+ * @mixin
+ * Mixin that provides roving tabindex navigation primitives for toolbar
+ * and menu components following WAI-ARIA keyboard patterns.
+ *
+ * Subclasses override `_getRovingTargets()` to return the focusable HTMLElements
+ * in DOM order. The mixin manages tabindex across those targets (one `0`, rest `-1`)
+ * and provides wrapping next/prev/first/last navigation.
+ *
+ * Does NOT install a keydown handler — each component defines its own
+ * (horizontal vs vertical, RTL, extra keys like Enter/Escape).
+ *
+ * @example
+ * ```typescript
+ * import { RovingTabindexMixin } from './RovingTabindexMixin'
+ *
+ * class MyToolbar extends RovingTabindexMixin(LitElement) {
+ *   _getRovingTargets(): HTMLElement[] {
+ *     return Array.from(this.querySelectorAll('button'))
+ *   }
+ * }
+ * ```
+ */
+export declare const RovingTabindexMixin: <T extends Constructor<LitElement>>(superClass: T) => Constructor<RovingTabindexInterface> & T;
+export {};
+//# sourceMappingURL=RovingTabindexMixin.d.ts.map

package/dist/util/RovingTabindexMixin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RovingTabindexMixin.d.ts","sourceRoot":"","sources":["../../src/util/RovingTabindexMixin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AAEhC,KAAK,WAAW,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAExD,MAAM,CAAC,OAAO,OAAO,uBAAuB;IAC1C,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,IAAI,WAAW,EAAE;IAClC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI;IACxD,WAAW,IAAI,IAAI;IACnB,WAAW,IAAI,IAAI;IACnB,YAAY,IAAI,IAAI;IACpB,WAAW,IAAI,IAAI;IACnB,mBAAmB,IAAI,MAAM;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,WAAW,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,KAuDpD,WAAW,CAAC,uBAAuB,CAAC,GAAG,CACtE,CAAA"}

package/dist/util/RovingTabindexMixin.js

@@ -0,0 +1,83 @@
+import { LitElement } from 'lit';
+/**
+ * @mixin
+ * Mixin that provides roving tabindex navigation primitives for toolbar
+ * and menu components following WAI-ARIA keyboard patterns.
+ *
+ * Subclasses override `_getRovingTargets()` to return the focusable HTMLElements
+ * in DOM order. The mixin manages tabindex across those targets (one `0`, rest `-1`)
+ * and provides wrapping next/prev/first/last navigation.
+ *
+ * Does NOT install a keydown handler — each component defines its own
+ * (horizontal vs vertical, RTL, extra keys like Enter/Escape).
+ *
+ * @example
+ * ```typescript
+ * import { RovingTabindexMixin } from './RovingTabindexMixin'
+ *
+ * class MyToolbar extends RovingTabindexMixin(LitElement) {
+ *   _getRovingTargets(): HTMLElement[] {
+ *     return Array.from(this.querySelectorAll('button'))
+ *   }
+ * }
+ * ```
+ */
+export const RovingTabindexMixin = (superClass) => {
+    class RovingTabindexClass extends superClass {
+        constructor() {
+            super(...arguments);
+            /** Index of the last focused target */
+            this._rovingIndex = 0;
+        }
+        /** Override: return focusable HTMLElements in navigation order */
+        _getRovingTargets() {
+            return [];
+        }
+        /** Set tabindex 0 on target at index, -1 on all others. Optionally focus. */
+        _rovingFocus(index, shouldFocus = true) {
+            const targets = this._getRovingTargets();
+            if (targets.length === 0)
+                return;
+            const clamped = Math.max(0, Math.min(index, targets.length - 1));
+            targets.forEach((t, i) => t.setAttribute('tabindex', i === clamped ? '0' : '-1'));
+            if (shouldFocus)
+                targets[clamped]?.focus();
+            this._rovingIndex = clamped;
+        }
+        /** Move to next target (wraps to first) */
+        _rovingNext() {
+            const targets = this._getRovingTargets();
+            if (targets.length === 0)
+                return;
+            const current = this._rovingCurrentIndex();
+            const next = current < targets.length - 1 ? current + 1 : 0;
+            this._rovingFocus(next);
+        }
+        /** Move to previous target (wraps to last) */
+        _rovingPrev() {
+            const targets = this._getRovingTargets();
+            if (targets.length === 0)
+                return;
+            const current = this._rovingCurrentIndex();
+            const prev = current > 0 ? current - 1 : targets.length - 1;
+            this._rovingFocus(prev);
+        }
+        /** Focus first target */
+        _rovingFirst() {
+            this._rovingFocus(0);
+        }
+        /** Focus last target */
+        _rovingLast() {
+            const targets = this._getRovingTargets();
+            if (targets.length > 0)
+                this._rovingFocus(targets.length - 1);
+        }
+        /** Find index of currently focused target */
+        _rovingCurrentIndex() {
+            const active = document.activeElement;
+            return this._getRovingTargets().findIndex(t => t === active || t.contains(active));
+        }
+    }
+    return RovingTabindexClass;
+};
+//# sourceMappingURL=RovingTabindexMixin.js.map

package/dist/util/RovingTabindexMixin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RovingTabindexMixin.js","sourceRoot":"","sources":["../../src/util/RovingTabindexMixin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AAehC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAoC,UAAa,EAAE,EAAE;IACtF,MAAM,mBAAoB,SAAQ,UAAU;QAA5C;;YACE,uCAAuC;YACvC,iBAAY,GAAG,CAAC,CAAA;QAmDlB,CAAC;QAjDC,kEAAkE;QAClE,iBAAiB;YACf,OAAO,EAAE,CAAA;QACX,CAAC;QAED,6EAA6E;QAC7E,YAAY,CAAC,KAAa,EAAE,WAAW,GAAG,IAAI;YAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAA;YACxC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAM;YAChC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAA;YAChE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;YACjF,IAAI,WAAW;gBAAE,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAA;YAC1C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAA;QAC7B,CAAC;QAED,2CAA2C;QAC3C,WAAW;YACT,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAA;YACxC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAM;YAChC,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAA;YAC1C,MAAM,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;YAC3D,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;QACzB,CAAC;QAED,8CAA8C;QAC9C,WAAW;YACT,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAA;YACxC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAM;YAChC,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAA;YAC1C,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAA;YAC3D,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;QACzB,CAAC;QAED,yBAAyB;QACzB,YAAY;YACV,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACtB,CAAC;QAED,wBAAwB;QACxB,WAAW;YACT,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAA;YACxC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;gBAAE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAC/D,CAAC;QAED,6CAA6C;QAC7C,mBAAmB;YACjB,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAA;YACrC,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;QACpF,CAAC;KACF;IACD,OAAO,mBAA+D,CAAA;AACxE,CAAC,CAAA"}

package/dist/util/position.d.ts

@@ -0,0 +1,9 @@
+export type EffectPosition = {
+    x: number;
+    y: number;
+} | MouseEvent | Element;
+export declare function resolvePosition(position: EffectPosition): {
+    x: number;
+    y: number;
+};
+//# sourceMappingURL=position.d.ts.map

package/dist/util/position.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"position.d.ts","sourceRoot":"","sources":["../../src/util/position.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,GAAG,OAAO,CAAA;AAE5E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CASlF"}

package/dist/util/position.js

@@ -0,0 +1,11 @@
+export function resolvePosition(position) {
+    if (position instanceof MouseEvent) {
+        return { x: position.clientX, y: position.clientY };
+    }
+    if (position instanceof Element) {
+        const rect = position.getBoundingClientRect();
+        return { x: rect.left + rect.width / 2, y: rect.top + rect.height / 2 };
+    }
+    return position;
+}
+//# sourceMappingURL=position.js.map

package/dist/util/position.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"position.js","sourceRoot":"","sources":["../../src/util/position.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAAC,QAAwB;IACtD,IAAI,QAAQ,YAAY,UAAU,EAAE,CAAC;QACnC,OAAO,EAAE,CAAC,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAA;IACrD,CAAC;IACD,IAAI,QAAQ,YAAY,OAAO,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,QAAQ,CAAC,qBAAqB,EAAE,CAAA;QAC7C,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAA;IACzE,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/docs/components/ActionBar.md

@@ -0,0 +1,71 @@
+# `src/components/action-bar/ActionBar.ts`:
+
+## class: `ActionBar`, `btu-action-bar`
+
+### 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          |         |
+
+### Fields
+
+| Name        | Privacy | Type        | Default     | Description                                                                                                                                                                                                     | Inherited From |
+| ----------- | ------- | ----------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
+| `position`  |         | `Position`  | `'bottom'`  | Bar position: 'top' or 'bottom' (default).                                                                                                                                                                      |                |
+| `sticky`    |         | `boolean`   | `false`     | Enables CSS sticky positioning. When combined with position='top',
the bar sticks to the top of the scroll container. With position='bottom'
(default), it sticks to the bottom.                        |                |
+| `alignment` |         | `Alignment` | `'default'` | Content alignment: 'default' (two-zone), 'start', 'center', 'end'.
Non-default alignments disable two-zone layout.                                                                                          |                |
+| `shadow`    |         | `boolean`   | `false`     | Adds a box-shadow to the bar.                                                                                                                                                                                   |                |
+| `label`     |         | `string`    | `''`        | Accessible label for the toolbar region.                                                                                                                                                                        |                |
+| `compact`   |         | `boolean`   | `false`     | Enables progressive label compacting. When space shrinks, items marked
\`compactable\` (with icons) have their labels hidden one-by-one
from least to most important before items overflow into "More". |                |
+
+### Events
+
+| Name                    | Type                           | Description                                                         | Inherited From |
+| ----------------------- | ------------------------------ | ------------------------------------------------------------------- | -------------- |
+| `btu-action-bar-ready`  | `CustomEvent`                  | Fired after first render and initialization                         |                |
+| `btu-action-item-click` | `CustomEvent<{label: string}>` | Fired when an action item is clicked (bubbles from btu-action-item) |                |
+
+### Attributes
+
+| Name             | Field     | Inherited From |
+| ---------------- | --------- | -------------- |
+| `position`       | position  |                |
+| `sticky`         | sticky    |                |
+| `item-alignment` | alignment |                |
+| `shadow`         | shadow    |                |
+| `label`          | label     |                |
+| `compact`        | compact   |                |
+
+### CSS Properties
+
+| Name                        | Default | Description                          |
+| --------------------------- | ------- | ------------------------------------ |
+| `--action-bar-gap`          |         | Gap between items (default: 0.75rem) |
+| `--action-bar-padding`      |         | Bar padding (default: 1.5rem)        |
+| `--action-bar-background`   |         | Background color (default: white)    |
+| `--action-bar-border-color` |         | Border color (default: gray-200)     |
+| `--action-bar-z-index`      |         | Z-index (default: 100)               |
+
+### Slots
+
+| Name | Description                              |
+| ---- | ---------------------------------------- |
+|      | One or more \`btu-action-item\` elements |
+
+<hr/>
+
+## Exports
+
+| Kind                        | Name             | Declaration | Module                                 | Package |
+| --------------------------- | ---------------- | ----------- | -------------------------------------- | ------- |
+| `js`                        | `default`        | ActionBar   | src/components/action-bar/ActionBar.ts |         |
+| `custom-element-definition` | `btu-action-bar` | ActionBar   | src/components/action-bar/ActionBar.ts |         |

package/docs/components/ActionItem.md

@@ -0,0 +1,76 @@
+# `src/components/action-bar/ActionItem.ts`:
+
+## class: `ActionItem`, `btu-action-item`
+
+### Superclass
+
+| Name         | Module | Package |
+| ------------ | ------ | ------- |
+| `LitElement` |        | lit     |
+
+### Mixins
+
+| Name                | Module                         | Package |
+| ------------------- | ------------------------------ | ------- |
+| `TooltipMixin`      | /src/util/TooltipMixin.js      |         |
+| `EventEmitterMixin` | /src/util/EventEmitterMixin.js |         |
+| `ReadyMixin`        | /src/util/ReadyMixin.js        |         |
+
+### Fields
+
+| Name          | Privacy | Type                     | Default       | Description                                                                                                                                                                                                                                                                                               | Inherited From |
+| ------------- | ------- | ------------------------ | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
+| `label`       |         | `string`                 | `''`          | Button label text.                                                                                                                                                                                                                                                                                        |                |
+| `variant`     |         | `ActionItemVariant`      | `'secondary'` | Visual variant: 'primary', 'secondary', 'tertiary', 'destructive'.                                                                                                                                                                                                                                        |                |
+| `iconName`    |         | `string`                 | `''`          | Lucide icon name for the leading icon.                                                                                                                                                                                                                                                                    |                |
+| `iconOnly`    |         | `boolean`                | `false`       | Show icon only, hiding the label. Tooltip activates automatically with the label text.                                                                                                                                                                                                                    |                |
+| `disabled`    |         | `boolean`                | `false`       | Disables the action item. The button remains focusable for accessibility
but click events are suppressed.                                                                                                                                                                                             |                |
+| `loading`     |         | `boolean`                | `false`       | Shows a loading spinner and prevents interaction.                                                                                                                                                                                                                                                         |                |
+| `zone`        |         | `'start' \| 'end' \| ''` | `''`          | Zone placement: 'start' or 'end'. Used by ActionBar for two-zone layout.
If unset, auto-detected from variant (destructive → start, others → end).                                                                                                                                                    |                |
+| `compactable` |         | `boolean`                | `false`       | Opt-in for progressive label compacting. When the parent bar has \`compact\`
enabled and space shrinks, compactable items with icons have their labels
hidden one-by-one (least important first) before overflowing.
Items without an icon ignore this attribute and go directly to overflow. |                |
+
+### Methods
+
+| Name                  | Privacy | Description | Parameters | Return                   | Inherited From |
+| --------------------- | ------- | ----------- | ---------- | ------------------------ | -------------- |
+| `_relayTooltipAttrs`  | private |             |            | `void`                   |                |
+| `_handleClick`        | private |             |            | `void`                   |                |
+| `_getSpinnerColor`    | private |             |            | `string`                 |                |
+| `_buildButtonClasses` | private |             |            | `string`                 |                |
+| `_getButtonStyles`    | private |             |            | `Record<string, string>` |                |
+
+### Events
+
+| Name                    | Type                           | Description                                                                | Inherited From |
+| ----------------------- | ------------------------------ | -------------------------------------------------------------------------- | -------------- |
+| `btu-action-item-click` | `CustomEvent<{label: string}>` | Fired when the action item is clicked (not fired when disabled or loading) |                |
+
+### Attributes
+
+| Name          | Field       | Inherited From |
+| ------------- | ----------- | -------------- |
+| `label`       | label       |                |
+| `variant`     | variant     |                |
+| `icon-name`   | iconName    |                |
+| `icon-only`   | iconOnly    |                |
+| `disabled`    | disabled    |                |
+| `loading`     | loading     |                |
+| `zone`        | zone        |                |
+| `compactable` | compactable |                |
+
+### CSS Properties
+
+| Name                     | Default | Description                      |
+| ------------------------ | ------- | -------------------------------- |
+| `--button-color`         |         | Override button background color |
+| `--button-text-color`    |         | Override button text color       |
+| `--button-border-radius` |         | Override button border radius    |
+
+<hr/>
+
+## Exports
+
+| Kind                        | Name              | Declaration | Module                                  | Package |
+| --------------------------- | ----------------- | ----------- | --------------------------------------- | ------- |
+| `js`                        | `default`         | ActionItem  | src/components/action-bar/ActionItem.ts |         |
+| `custom-element-definition` | `btu-action-item` | ActionItem  | src/components/action-bar/ActionItem.ts |         |

package/docs/components/Dropdown.md

@@ -42,13 +42,13 @@
 
 ### Events
 
-| Name                         | Type                                               | Description                                                                   | Inherited From |
-| ---------------------------- | -------------------------------------------------- | ----------------------------------------------------------------------------- | -------------- |
-| `btu-dropdown-ready`         | `CustomEvent`                                      | Fired after first render and initialization                                   |                |
-| `btu-dropdown-show`          | `CustomEvent`                                      | Fired when the dropdown panel opens                                           |                |
-| `btu-dropdown-hide`          | `CustomEvent`                                      | Fired when the dropdown panel closes                                          |                |
-| `btu-dropdown-item-select`   | `CustomEvent<{label: string, selected: boolean}>`  | Fired when a menu item is activated (bubbles from btu-dropdown-item)          |                |
-| `btu-dropdown-item-favorite` | `CustomEvent<{label: string, favorited: boolean}>` | Fired when a menu item's favorite is toggled (bubbles from btu-dropdown-item) |                |
+| Name                         | Type                                                             | Description                                                                   | Inherited From |
+| ---------------------------- | ---------------------------------------------------------------- | ----------------------------------------------------------------------------- | -------------- |
+| `btu-dropdown-ready`         | `CustomEvent`                                                    | Fired after first render and initialization                                   |                |
+| `btu-dropdown-show`          | `CustomEvent`                                                    | Fired when the dropdown panel opens                                           |                |
+| `btu-dropdown-hide`          | `CustomEvent`                                                    | Fired when the dropdown panel closes                                          |                |
+| `btu-dropdown-item-select`   | `CustomEvent<{label: string, value: string, selected: boolean}>` | Fired when a menu item is activated (bubbles from btu-dropdown-item)          |                |
+| `btu-dropdown-item-favorite` | `CustomEvent<{label: string, favorited: boolean}>`               | Fired when a menu item's favorite is toggled (bubbles from btu-dropdown-item) |                |
 
 ### Attributes
 

package/docs/components/DropdownItem.md

@@ -23,9 +23,11 @@
 | `type`       |         | `'default' \| 'divider' \| 'subhead'` | `'default'` | Item type: 'default', 'divider', or 'subhead'. |                |
 | `iconSymbol` |         | `string`                              | `''`        | Lucide icon symbol.                            |                |
 | `shortcut`   |         | `string`                              | `''`        | Keyboard shortcut display text.                |                |
+| `value`      |         | `string`                              | `''`        | Optional data value associated with the item.  |                |
 | `disabled`   |         | `boolean`                             | `false`     | Whether the item is disabled.                  |                |
 | `selected`   |         | `boolean`                             | `false`     | Whether the item is selected/checked.          |                |
 | `favorited`  |         | `boolean`                             | `false`     | Whether the item is favorited.                 |                |
+| `error`      |         | `boolean`                             | `false`     | Whether the item has an error.                 |                |
 
 ### Methods
 
@@ -36,11 +38,11 @@
 
 ### Events
 
-| Name                         | Type                                               | Description                    | Inherited From |
-| ---------------------------- | -------------------------------------------------- | ------------------------------ | -------------- |
-| `btu-dropdown-item-ready`    | `CustomEvent`                                      | Fired after first render       |                |
-| `btu-dropdown-item-select`   | `CustomEvent<{label: string, selected: boolean}>`  | Fired when item is activated   |                |
-| `btu-dropdown-item-favorite` | `CustomEvent<{label: string, favorited: boolean}>` | Fired when favorite is toggled |                |
+| Name                         | Type                                                             | Description                    | Inherited From |
+| ---------------------------- | ---------------------------------------------------------------- | ------------------------------ | -------------- |
+| `btu-dropdown-item-ready`    | `CustomEvent`                                                    | Fired after first render       |                |
+| `btu-dropdown-item-select`   | `CustomEvent<{label: string, value: string, selected: boolean}>` | Fired when item is activated   |                |
+| `btu-dropdown-item-favorite` | `CustomEvent<{label: string, favorited: boolean}>`               | Fired when favorite is toggled |                |
 
 ### Attributes
 
@@ -50,9 +52,11 @@
 | `type`        | type       |                |
 | `icon-symbol` | iconSymbol |                |
 | `shortcut`    | shortcut   |                |
+| `value`       | value      |                |
 | `disabled`    | disabled   |                |
 | `selected`    | selected   |                |
 | `favorited`   | favorited  |                |
+| `error`       | error      |                |
 
 <hr/>
 

package/docs/components/DropdownMenu.md

@@ -10,10 +10,11 @@
 
 ### Mixins
 
-| Name                | Module                         | Package |
-| ------------------- | ------------------------------ | ------- |
-| `EventEmitterMixin` | /src/util/EventEmitterMixin.js |         |
-| `ReadyMixin`        | /src/util/ReadyMixin.js        |         |
+| Name                  | Module                           | Package |
+| --------------------- | -------------------------------- | ------- |
+| `RovingTabindexMixin` | /src/util/RovingTabindexMixin.js |         |
+| `EventEmitterMixin`   | /src/util/EventEmitterMixin.js   |         |
+| `ReadyMixin`          | /src/util/ReadyMixin.js          |         |
 
 ### Fields
 
@@ -31,14 +32,13 @@
 
 ### Methods
 
-| Name                    | Privacy | Description                                                     | Parameters                                                       | Return           | Inherited From |
-| ----------------------- | ------- | --------------------------------------------------------------- | ---------------------------------------------------------------- | ---------------- | -------------- |
-| `_configureItems`       | private | Configure all child items with menu-level settings              |                                                                  | `void`           |                |
-| `_getAllItems`          | private | Get all btu-dropdown-item children                              |                                                                  | `DropdownItem[]` |                |
-| `_getFocusableItems`    | private | Get only focusable items (default type, skip dividers/subheads) |                                                                  | `DropdownItem[]` |                |
-| `_getCurrentFocusIndex` | private | Find the current focused item index                             | `focusable: DropdownItem[]`                                      | `number`         |                |
-| `_findNextIndex`        | private | Find next index wrapping around, moving in direction (+1 or -1) | `focusable: DropdownItem[], current: number, direction: 1 \| -1` | `number`         |                |
-| `_handleTypeahead`      | private | Typeahead character matching with 500ms accumulation            | `char: string, focusable: DropdownItem[]`                        | `void`           |                |
+| Name                 | Privacy | Description                                                     | Parameters                                | Return           | Inherited From |
+| -------------------- | ------- | --------------------------------------------------------------- | ----------------------------------------- | ---------------- | -------------- |
+| `_getRovingTargets`  |         | Override: return menuitem elements from focusable items         |                                           | `HTMLElement[]`  |                |
+| `_configureItems`    | private | Configure all child items with menu-level settings              |                                           | `void`           |                |
+| `_getAllItems`       | private | Get all btu-dropdown-item children                              |                                           | `DropdownItem[]` |                |
+| `_getFocusableItems` | private | Get only focusable items (default type, skip dividers/subheads) |                                           | `DropdownItem[]` |                |
+| `_handleTypeahead`   | private | Typeahead character matching with 500ms accumulation            | `char: string, focusable: DropdownItem[]` | `void`           |                |
 
 ### Events
 

package/docs/components/Pagination.md

@@ -17,35 +17,37 @@
 
 ### 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` |                |
 
 ### Events
 
@@ -69,21 +71,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/README.md

@@ -4,6 +4,8 @@ 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)
@@ -17,6 +19,9 @@ This directory contains auto-generated API documentation for all Brightspot UI w
 - [`<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-widget>` - Widget](Widget.md)
 
 ---