@brightspot/ui 1.5.0 → 1.7.0

package/dist/components/dropdown/DropdownMenu.js

@@ -0,0 +1,295 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { LitElement, html, nothing } from 'lit';
+import { property } from 'lit/decorators.js';
+import { EventEmitterMixin } from '../../util/EventEmitterMixin.js';
+import { ReadyMixin } from '../../util/ReadyMixin.js';
+/**
+ * A menu container component that provides keyboard navigation and ARIA menu semantics.
+ *
+ * Contains `btu-dropdown-item` children and manages roving tabindex, typeahead search,
+ * and keyboard navigation following the WAI-ARIA Menu Button Pattern.
+ *
+ * @element btu-dropdown-menu
+ *
+ * @fires {CustomEvent} btu-dropdown-menu-ready - Fired after first render
+ *
+ * @slot - Menu items (`btu-dropdown-item` elements)
+ *
+ * @cssprop --dropdown-empty-color - Empty state text color (default: gray-400)
+ *
+ * @example
+ * ```html
+ * <btu-dropdown-menu name="Sort By" header checkbox>
+ *   <btu-dropdown-item label="Name" selected></btu-dropdown-item>
+ *   <btu-dropdown-item label="Date"></btu-dropdown-item>
+ *   <btu-dropdown-item label="Size"></btu-dropdown-item>
+ * </btu-dropdown-menu>
+ * ```
+ */
+export default class DropdownMenu extends EventEmitterMixin(ReadyMixin(LitElement)) {
+    constructor() {
+        super(...arguments);
+        /**
+         * Accessible name for the menu, displayed in header when header is true.
+         * @attr
+         */
+        this.name = '';
+        /**
+         * Show header bar with menu name.
+         * @attr
+         */
+        this.header = false;
+        /**
+         * Enable checkbox mode for items (menuitemcheckbox role).
+         * @attr
+         */
+        this.checkbox = false;
+        /**
+         * Show icons before each item.
+         * @attr
+         */
+        this.icon = false;
+        /**
+         * Fallback Lucide icon symbol for items without their own.
+         * @attr icon-symbol
+         */
+        this.iconSymbol = '';
+        /**
+         * Show favorite toggle on each item.
+         * @attr
+         */
+        this.favorites = false;
+        /**
+         * Show keyboard shortcut text on each item.
+         * @attr
+         */
+        this.shortcuts = false;
+        /**
+         * Message displayed when the menu has no focusable items.
+         * @attr empty-message
+         */
+        this.emptyMessage = 'No items available';
+        /** @internal */
+        this._typeaheadBuffer = '';
+        /** @internal */
+        this._typeaheadTimeout = null;
+        /** @internal */
+        this._handleKeydown = (e) => {
+            const focusable = this._getFocusableItems();
+            if (focusable.length === 0)
+                return;
+            const currentIndex = this._getCurrentFocusIndex(focusable);
+            switch (e.key) {
+                case 'ArrowDown': {
+                    e.preventDefault();
+                    const next = this._findNextIndex(focusable, currentIndex, 1);
+                    this.focusItem(focusable[next]);
+                    break;
+                }
+                case 'ArrowUp': {
+                    e.preventDefault();
+                    const prev = this._findNextIndex(focusable, currentIndex, -1);
+                    this.focusItem(focusable[prev]);
+                    break;
+                }
+                case 'Home': {
+                    e.preventDefault();
+                    this.focusItem(focusable[0]);
+                    break;
+                }
+                case 'End': {
+                    e.preventDefault();
+                    this.focusItem(focusable[focusable.length - 1]);
+                    break;
+                }
+                case 'Enter': {
+                    e.preventDefault();
+                    if (currentIndex >= 0) {
+                        focusable[currentIndex].activate();
+                    }
+                    break;
+                }
+                case ' ': {
+                    e.preventDefault();
+                    if (currentIndex >= 0) {
+                        focusable[currentIndex].activate();
+                    }
+                    break;
+                }
+                case 'Escape': {
+                    // Bubble up to Dropdown to handle close
+                    break;
+                }
+                case 'Tab': {
+                    // Bubble up to Dropdown to handle close + focus restore
+                    break;
+                }
+                default: {
+                    // Typeahead: printable characters
+                    if (e.key.length === 1 && !e.ctrlKey && !e.metaKey && !e.altKey) {
+                        this._handleTypeahead(e.key, focusable);
+                    }
+                    break;
+                }
+            }
+        };
+    }
+    createRenderRoot() {
+        this.renderOptions.renderBefore ??= this.firstChild;
+        return this;
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        this.setAttribute('role', 'menu');
+        if (this.name) {
+            this.setAttribute('aria-label', this.name);
+        }
+        this.addEventListener('keydown', this._handleKeydown);
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        this.removeEventListener('keydown', this._handleKeydown);
+        if (this._typeaheadTimeout) {
+            clearTimeout(this._typeaheadTimeout);
+        }
+    }
+    firstUpdated() {
+        this._configureItems();
+        this.emit('btu-dropdown-menu-ready');
+    }
+    updated() {
+        this._configureItems();
+        if (this.name) {
+            this.setAttribute('aria-label', this.name);
+        }
+        else {
+            this.removeAttribute('aria-label');
+        }
+    }
+    /** Configure all child items with menu-level settings */
+    _configureItems() {
+        const items = this._getAllItems();
+        items.forEach(item => {
+            item._configure({
+                checkbox: this.checkbox,
+                icon: this.icon,
+                iconSymbol: this.iconSymbol,
+                favorites: this.favorites,
+                shortcuts: this.shortcuts,
+            });
+        });
+    }
+    /** Get all btu-dropdown-item children */
+    _getAllItems() {
+        return Array.from(this.querySelectorAll('btu-dropdown-item'));
+    }
+    /** Get only focusable items (default type, skip dividers/subheads) */
+    _getFocusableItems() {
+        return this._getAllItems().filter(item => item.focusable);
+    }
+    /** @internal Focus a specific item by updating tabindex */
+    focusItem(item) {
+        const focusable = this._getFocusableItems();
+        focusable.forEach(i => {
+            const el = i.querySelector('[role="menuitem"], [role="menuitemcheckbox"]');
+            if (el)
+                el.setAttribute('tabindex', '-1');
+        });
+        const target = item.querySelector('[role="menuitem"], [role="menuitemcheckbox"]');
+        if (target) {
+            target.setAttribute('tabindex', '0');
+            target.focus();
+        }
+    }
+    /** @internal Focus the first non-disabled focusable item (or first checked in checkbox mode) */
+    focusFirst() {
+        const items = this._getFocusableItems();
+        if (this.checkbox) {
+            const checked = items.find(i => i.selected && !i.disabled);
+            if (checked) {
+                this.focusItem(checked);
+                return;
+            }
+        }
+        const first = items.find(i => !i.disabled) || items[0];
+        if (first)
+            this.focusItem(first);
+    }
+    /** @internal Focus the last non-disabled focusable item */
+    focusLast() {
+        const items = this._getFocusableItems();
+        const last = [...items].reverse().find(i => !i.disabled) || items[items.length - 1];
+        if (last)
+            this.focusItem(last);
+    }
+    /** Find the current focused item index */
+    _getCurrentFocusIndex(focusable) {
+        const active = document.activeElement;
+        return focusable.findIndex(item => item.contains(active));
+    }
+    /** Find next index wrapping around, moving in direction (+1 or -1) */
+    _findNextIndex(focusable, current, direction) {
+        const len = focusable.length;
+        if (current < 0)
+            return direction === 1 ? 0 : len - 1;
+        const next = (current + direction + len) % len;
+        return next;
+    }
+    /** Typeahead character matching with 500ms accumulation */
+    _handleTypeahead(char, focusable) {
+        this._typeaheadBuffer += char.toLowerCase();
+        if (this._typeaheadTimeout) {
+            clearTimeout(this._typeaheadTimeout);
+        }
+        this._typeaheadTimeout = setTimeout(() => {
+            this._typeaheadBuffer = '';
+        }, 500);
+        const match = focusable.find(item => item.label.toLowerCase().startsWith(this._typeaheadBuffer));
+        if (match) {
+            this.focusItem(match);
+        }
+    }
+    /** Check whether the menu has zero focusable items */
+    get _isEmpty() {
+        return this._getFocusableItems().length === 0;
+    }
+    render() {
+        return html `${this.header && this.name ? html `<div class="btu-dropdown-header">${this.name}</div>` : nothing}${this
+            ._isEmpty
+            ? html `<div class="btu-dropdown-empty" role="status">${this.emptyMessage}</div>`
+            : nothing}`;
+    }
+}
+__decorate([
+    property({ type: String })
+], DropdownMenu.prototype, "name", void 0);
+__decorate([
+    property({ type: Boolean })
+], DropdownMenu.prototype, "header", void 0);
+__decorate([
+    property({ type: Boolean })
+], DropdownMenu.prototype, "checkbox", void 0);
+__decorate([
+    property({ type: Boolean })
+], DropdownMenu.prototype, "icon", void 0);
+__decorate([
+    property({ type: String, attribute: 'icon-symbol' })
+], DropdownMenu.prototype, "iconSymbol", void 0);
+__decorate([
+    property({ type: Boolean })
+], DropdownMenu.prototype, "favorites", void 0);
+__decorate([
+    property({ type: Boolean })
+], DropdownMenu.prototype, "shortcuts", void 0);
+__decorate([
+    property({ type: String, attribute: 'empty-message' })
+], DropdownMenu.prototype, "emptyMessage", void 0);
+if (!customElements.get('btu-dropdown-menu')) {
+    customElements.define('btu-dropdown-menu', DropdownMenu);
+}
+//# sourceMappingURL=DropdownMenu.js.map

package/dist/components/dropdown/DropdownMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DropdownMenu.js","sourceRoot":"","sources":["../../../src/components/dropdown/DropdownMenu.ts"],"names":[],"mappings":"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"}

package/dist/components/pagination/Pagination.d.ts

@@ -0,0 +1,109 @@
+import { LitElement } from 'lit';
+import '../circular-progress/CircularProgress.js';
+import '../icon/Icon.js';
+declare const Pagination_base: (new (...args: any[]) => import("../../util/EventEmitterMixin.js").EventEmitterMixinInterface) & (new (...args: any[]) => import("../../util/ReadyMixin.js").ReadyMixinInterface) & typeof LitElement;
+/**
+ * A pagination component for navigating through paged content.
+ *
+ * Supports multiple layout variants (Search, Widget, Widget Small, Calendar)
+ * through configurable props and pseudo-slots.
+ *
+ * @element btu-pagination
+ *
+ * @slot page-size - Custom page-size selector (replaces built-in select)
+ * @slot jumper - Custom jumper content (e.g., page dropdown, "Today" button)
+ *
+ * @fires {CustomEvent} btu-pagination-ready - Fired after first render
+ * @fires {CustomEvent<{page: number, pageSize: number}>} btu-pagination-change - Fired on page navigation
+ * @fires {CustomEvent<{page: number, pageSize: number}>} btu-pagination-page-size-change - Fired on page size change
+ *
+ * @cssprop --pagination-color-background - Background color for select, buttons, and jumper
+ * @cssprop --pagination-color-foreground - Text/icon color
+ */
+export default class Pagination extends Pagination_base {
+    /**
+     * Current page number (1-based)
+     * @attr
+     */
+    page: number;
+    /**
+     * Number of items per page
+     * @attr page-size
+     */
+    pageSize: number;
+    /**
+     * Disables all pagination controls
+     * @attr
+     */
+    disabled: boolean;
+    /**
+     * Shows loading spinner and dims controls
+     * @attr
+     */
+    loading: boolean;
+    /**
+     * Hide controls when there is only one page
+     * @attr hide-on-single-page
+     */
+    hideOnSinglePage: boolean;
+    /**
+     * Show the page size dropdown
+     * @attr page-size-changer
+     */
+    pageSizeChanger: boolean;
+    /**
+     * Comma-separated page size options
+     * @attr page-size-options
+     */
+    pageSizeOptions: string;
+    /**
+     * Total number of items across all pages
+     * @attr total-items
+     */
+    totalItems: number;
+    /**
+     * Show first and last page buttons
+     * @attr boundary-buttons
+     */
+    boundaryButtons: boolean;
+    /**
+     * Hide the item count display (e.g., "1-10 of 200")
+     * @attr hide-total-count
+     */
+    hideTotalCount: boolean;
+    /**
+     * Accessible label for the pagination nav landmark
+     * @attr
+     */
+    label: string | undefined;
+    /** @internal */
+    private _userInitiated;
+    /** @internal */
+    private initialClasses;
+    /** @internal */
+    private _hideControls;
+    private get _parsedPageSizeOptions();
+    private get _totalPages();
+    private get _startItem();
+    private get _endItem();
+    connectedCallback(): void;
+    createRenderRoot(): this;
+    willUpdate(): void;
+    firstUpdated(): void;
+    updated(changed: Map<string, unknown>): void;
+    private _setupSlots;
+    private _goToFirstPage;
+    private _goToPreviousPage;
+    private _goToNextPage;
+    private _goToLastPage;
+    private _manageBoundaryFocus;
+    private _onPageSizeChange;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'btu-pagination': Pagination;
+    }
+}
+export {};
+//# sourceMappingURL=Pagination.d.ts.map

package/dist/components/pagination/Pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pagination.d.ts","sourceRoot":"","sources":["../../../src/components/pagination/Pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAA;AAK/C,OAAO,0CAA0C,CAAA;AACjD,OAAO,iBAAiB,CAAA;;AAExB;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,eAAyC;IAC/E;;;OAGG;IAEH,IAAI,SAAI;IAER;;;OAGG;IAEH,QAAQ,SAAI;IAEZ;;;OAGG;IAEH,QAAQ,UAAQ;IAEhB;;;OAGG;IAEH,OAAO,UAAQ;IAEf;;;OAGG;IAEH,gBAAgB,UAAO;IAEvB;;;OAGG;IAEH,eAAe,UAAO;IAEtB;;;OAGG;IAEH,eAAe,SAAe;IAE9B;;;OAGG;IAEH,UAAU,SAAI;IAEd;;;OAGG;IAEH,eAAe,UAAO;IAEtB;;;OAGG;IAEH,cAAc,UAAQ;IAEtB;;;OAGG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IAEzB,gBAAgB;IAChB,OAAO,CAAC,cAAc,CAAQ;IAE9B,gBAAgB;IAChB,OAAO,CAAC,cAAc,CAAe;IAErC,gBAAgB;IAChB,OAAO,CAAC,aAAa,CAAQ;IAE7B,OAAO,KAAK,sBAAsB,GAMjC;IAED,OAAO,KAAK,WAAW,GAGtB;IAED,OAAO,KAAK,UAAU,GAGrB;IAED,OAAO,KAAK,QAAQ,GAGnB;IAED,iBAAiB,IAAI,IAAI;IAOzB,gBAAgB;IAIhB,UAAU,IAAI,IAAI;IAmClB,YAAY,IAAI,IAAI;IAIpB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAe5C,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,iBAAiB;IAezB,MAAM;CAkFP;AAMD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,gBAAgB,EAAE,UAAU,CAAA;KAC7B;CACF"}