@brightspot/ui 1.4.1 → 1.6.0

package/dist/util/TooltipMixin.js

@@ -0,0 +1,401 @@
+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 } from 'lit';
+import { property } from 'lit/decorators.js';
+// Tailwind content scanning requires complete class names (no template literals).
+const POSITION_CLASSES = {
+    top: 'btu-tooltip-top',
+    bottom: 'btu-tooltip-bottom',
+    left: 'btu-tooltip-left',
+    right: 'btu-tooltip-right',
+};
+const OFFSET_CLASSES = {
+    sm: 'btu-tooltip-offset-sm',
+    md: 'btu-tooltip-offset-md',
+    lg: 'btu-tooltip-offset-lg',
+    xl: 'btu-tooltip-offset-xl',
+};
+/**
+ * Mixin that adds declarative tooltip support to any LitElement component.
+ *
+ * Uses the native Popover API for top-layer rendering and CSS anchor positioning
+ * for viewport-aware placement. The tooltip element is appended as the last child
+ * of the host (safe from Lit re-render interference in Light DOM components).
+ *
+ * For click triggers (`popover="auto"`), the browser provides light dismiss
+ * (Escape key and click-outside). For hover/focus triggers (`popover="manual"`),
+ * show/hide is controlled by the mixin.
+ *
+ * @mixin
+ *
+ * @cssprop --tooltip-color-background - Background color (default: white)
+ * @cssprop --tooltip-color-text - Text color (default: oklch gray-900)
+ * @cssprop --tooltip-border-radius - Border radius (default: 0.5rem / lg)
+ *
+ * @example
+ * ```typescript
+ * class MyComponent extends TooltipMixin(EventEmitterMixin(ReadyMixin(LitElement))) {
+ *   // Component now supports tooltip, tooltip-position, tooltip-delay attributes
+ * }
+ * ```
+ *
+ * ```html
+ * <my-component tooltip="Hello!" tooltip-position="bottom"></my-component>
+ * ```
+ */
+export const TooltipMixin = (superClass) => {
+    class TooltipMixinClass extends superClass {
+        constructor() {
+            super(...arguments);
+            /**
+             * Tooltip text content. Set to empty string to remove the tooltip.
+             * @attr
+             */
+            this.tooltip = '';
+            /**
+             * Position relative to the host element. Auto-flips when constrained by the viewport.
+             * @attr
+             */
+            this.tooltipPosition = 'top';
+            /**
+             * Show delay in milliseconds (hover trigger only).
+             * @attr
+             */
+            this.tooltipDelay = 300;
+            /**
+             * Gap between host and tooltip (sm=4px, md=8px, lg=12px, xl=16px).
+             * @attr
+             */
+            this.tooltipOffset = null;
+            /**
+             * Hide the arrow pseudo-element.
+             * @attr
+             */
+            this.tooltipNoArrow = false;
+            /**
+             * Space-separated trigger types: 'hover', 'focus', 'click'.
+             * @attr
+             */
+            this.tooltipTrigger = 'hover focus';
+            /** @internal */
+            this._tooltipEl = null;
+            /** @internal */
+            this._tooltipId = `btu-tooltip-${crypto.randomUUID()}`;
+            /** @internal */
+            this._anchorName = `--btu-trigger-${crypto.randomUUID()}`;
+            /** @internal */
+            this._showTimer = null;
+            /** @internal */
+            this._isVisible = false;
+            /** @internal Parsed set of active triggers */
+            this._activeTriggers = new Set();
+            /** @internal bound listeners for cleanup */
+            this._onMouseEnter = this._handleMouseEnter.bind(this);
+            this._onMouseLeave = this._handleMouseLeave.bind(this);
+            this._onFocusIn = this._handleFocusIn.bind(this);
+            this._onFocusOut = this._handleFocusOut.bind(this);
+            this._onClick = this._handleClick.bind(this);
+            this._onNativeToggle = this._handleNativeToggle.bind(this);
+            this._onKeyDown = this._handleKeyDown.bind(this);
+            this._onDocumentClick = null;
+        }
+        connectedCallback() {
+            super.connectedCallback();
+            this._bindTriggerListeners();
+        }
+        disconnectedCallback() {
+            this._clearShowTimer();
+            this._removeDocumentClickListener();
+            this._unbindTriggerListeners();
+            if (this._tooltipEl) {
+                try {
+                    this._tooltipEl.hidePopover();
+                }
+                catch (e) {
+                    if (!(e instanceof DOMException && e.name === 'InvalidStateError')) {
+                        console.warn('[btu-tooltip] Failed to hide tooltip during disconnect:', e);
+                    }
+                }
+                this._tooltipEl.removeEventListener('toggle', this._onNativeToggle);
+                this._tooltipEl.remove();
+                this._tooltipEl = null;
+            }
+            this._removeAriaDescribedBy();
+            this.style.removeProperty('anchor-name');
+            this._isVisible = false;
+            super.disconnectedCallback();
+        }
+        updated(changedProperties) {
+            super.updated(changedProperties);
+            if (changedProperties.has('tooltipTrigger')) {
+                this._unbindTriggerListeners();
+                this._bindTriggerListeners();
+                // Update popover mode when trigger changes
+                if (this._tooltipEl) {
+                    if (this._isVisible) {
+                        this._hide();
+                    }
+                    this._tooltipEl.setAttribute('popover', this._getPopoverMode());
+                }
+            }
+            if (changedProperties.has('tooltip') ||
+                changedProperties.has('tooltipPosition') ||
+                changedProperties.has('tooltipDelay') ||
+                changedProperties.has('tooltipOffset') ||
+                changedProperties.has('tooltipNoArrow')) {
+                this._syncTooltipElement();
+            }
+        }
+        /** @internal
+         * Always manual — popovertarget (needed for popover="auto" click toggle)
+         * only works on <button>/<input>, not arbitrary custom element hosts.
+         */
+        _getPopoverMode() {
+            return 'manual';
+        }
+        /** @internal */
+        _syncTooltipElement() {
+            if (!this.tooltip) {
+                // Remove tooltip if text cleared
+                if (this._tooltipEl) {
+                    this._hide();
+                    this._tooltipEl.removeEventListener('toggle', this._onNativeToggle);
+                    this._tooltipEl.remove();
+                    this._tooltipEl = null;
+                    this._removeAriaDescribedBy();
+                    this.style.removeProperty('anchor-name');
+                    document.removeEventListener('keydown', this._onKeyDown);
+                }
+                return;
+            }
+            // Set unique anchor name on host
+            this.style.setProperty('anchor-name', this._anchorName);
+            if (!this._tooltipEl) {
+                this._tooltipEl = this._createTooltipElement();
+                this.appendChild(this._tooltipEl);
+                this._appendAriaDescribedBy();
+                // Always manual mode — Escape not handled by browser, add only when tooltip exists
+                document.addEventListener('keydown', this._onKeyDown);
+            }
+            // Update text content
+            this._tooltipEl.textContent = this.tooltip;
+            // Update classes (includes offset)
+            this._tooltipEl.className = this._buildTooltipClasses();
+        }
+        /** @internal */
+        _createTooltipElement() {
+            const el = document.createElement('div');
+            el.id = this._tooltipId;
+            el.className = this._buildTooltipClasses();
+            el.setAttribute('role', 'tooltip');
+            el.setAttribute('data-tooltip-internal', '');
+            el.setAttribute('popover', this._getPopoverMode());
+            el.style.setProperty('position-anchor', this._anchorName);
+            el.textContent = this.tooltip;
+            // Listen for native toggle events — single source of truth for state
+            el.addEventListener('toggle', this._onNativeToggle);
+            return el;
+        }
+        /** @internal Builds the full class string for the tooltip element */
+        _buildTooltipClasses() {
+            const classes = ['btu-tooltip', POSITION_CLASSES[this.tooltipPosition]];
+            if (this.tooltipOffset && OFFSET_CLASSES[this.tooltipOffset])
+                classes.push(OFFSET_CLASSES[this.tooltipOffset]);
+            if (this.tooltipNoArrow)
+                classes.push('btu-tooltip-no-arrow');
+            return classes.join(' ');
+        }
+        /** @internal */
+        _hasTrigger(trigger) {
+            return this._activeTriggers.has(trigger);
+        }
+        /** @internal Parses trigger string and attaches relevant listeners */
+        _bindTriggerListeners() {
+            const VALID_TRIGGERS = new Set(['hover', 'focus', 'click']);
+            this._activeTriggers = new Set(this.tooltipTrigger.trim().split(/\s+/));
+            for (const trigger of this._activeTriggers) {
+                if (!VALID_TRIGGERS.has(trigger)) {
+                    console.warn(`[btu-tooltip] Unrecognized tooltip-trigger value: "${trigger}". Valid values: hover, focus, click.`);
+                }
+            }
+            if (this._hasTrigger('hover')) {
+                this.addEventListener('mouseenter', this._onMouseEnter);
+                this.addEventListener('mouseleave', this._onMouseLeave);
+            }
+            if (this._hasTrigger('focus')) {
+                this.addEventListener('focusin', this._onFocusIn);
+                this.addEventListener('focusout', this._onFocusOut);
+            }
+            if (this._hasTrigger('click')) {
+                this.addEventListener('click', this._onClick);
+            }
+            // Keydown listener for Escape is added in _syncTooltipElement when tooltip is set
+        }
+        /** @internal Removes all trigger listeners */
+        _unbindTriggerListeners() {
+            this.removeEventListener('mouseenter', this._onMouseEnter);
+            this.removeEventListener('mouseleave', this._onMouseLeave);
+            this.removeEventListener('focusin', this._onFocusIn);
+            this.removeEventListener('focusout', this._onFocusOut);
+            this.removeEventListener('click', this._onClick);
+            document.removeEventListener('keydown', this._onKeyDown);
+        }
+        /** @internal */
+        _show() {
+            if (this._isVisible || !this._tooltipEl)
+                return;
+            try {
+                this._tooltipEl.showPopover();
+            }
+            catch (e) {
+                if (!(e instanceof DOMException && e.name === 'InvalidStateError')) {
+                    console.warn('[btu-tooltip] Failed to show tooltip:', e);
+                }
+            }
+            // Click-outside dismiss for click-triggered tooltips
+            if (this._hasTrigger('click')) {
+                // Use next tick to avoid the opening click from immediately dismissing
+                setTimeout(() => {
+                    this._removeDocumentClickListener();
+                    this._onDocumentClick = (e) => {
+                        const path = e.composedPath();
+                        if (!path.includes(this) && (!this._tooltipEl || !path.includes(this._tooltipEl))) {
+                            this._hide();
+                        }
+                    };
+                    document.addEventListener('click', this._onDocumentClick);
+                }, 0);
+            }
+        }
+        /** @internal */
+        _hide() {
+            this._clearShowTimer();
+            this._removeDocumentClickListener();
+            if (!this._isVisible || !this._tooltipEl)
+                return;
+            try {
+                this._tooltipEl.hidePopover();
+            }
+            catch (e) {
+                if (!(e instanceof DOMException && e.name === 'InvalidStateError')) {
+                    console.warn('[btu-tooltip] Failed to hide tooltip:', e);
+                }
+            }
+        }
+        /** @internal */
+        _removeDocumentClickListener() {
+            if (this._onDocumentClick) {
+                document.removeEventListener('click', this._onDocumentClick);
+                this._onDocumentClick = null;
+            }
+        }
+        /** @internal Native toggle event — single source of truth for state changes */
+        _handleNativeToggle(e) {
+            const { newState } = e;
+            this._isVisible = newState === 'open';
+            this.dispatchEvent(new CustomEvent(this._isVisible ? 'btu-tooltip-show' : 'btu-tooltip-hide', {
+                bubbles: true,
+                composed: true,
+            }));
+        }
+        /** @internal Escape dismisses for popover="manual" (hover/focus triggers) */
+        _handleKeyDown(e) {
+            if (e.key === 'Escape') {
+                this._clearShowTimer();
+                this._hide();
+            }
+        }
+        /** @internal */
+        _clearShowTimer() {
+            if (this._showTimer !== null) {
+                clearTimeout(this._showTimer);
+                this._showTimer = null;
+            }
+        }
+        /** @internal */
+        _handleMouseEnter() {
+            this._clearShowTimer();
+            this._showTimer = setTimeout(() => {
+                this._show();
+            }, this.tooltipDelay);
+        }
+        /** @internal */
+        _handleMouseLeave() {
+            this._clearShowTimer();
+            this._hide();
+        }
+        /** @internal */
+        _handleFocusIn() {
+            this._clearShowTimer();
+            this._show();
+        }
+        /** @internal */
+        _handleFocusOut() {
+            this._clearShowTimer();
+            this._hide();
+        }
+        /** @internal Click trigger toggles visibility */
+        _handleClick() {
+            this._clearShowTimer();
+            if (this._isVisible) {
+                this._hide();
+            }
+            else {
+                this._show();
+            }
+        }
+        /** @internal Appends tooltip id to existing aria-describedby */
+        _appendAriaDescribedBy() {
+            const existing = this.getAttribute('aria-describedby');
+            if (existing) {
+                if (!existing.includes(this._tooltipId)) {
+                    this.setAttribute('aria-describedby', `${existing} ${this._tooltipId}`);
+                }
+            }
+            else {
+                this.setAttribute('aria-describedby', this._tooltipId);
+            }
+        }
+        /** @internal Removes tooltip id from aria-describedby */
+        _removeAriaDescribedBy() {
+            const existing = this.getAttribute('aria-describedby');
+            if (!existing)
+                return;
+            const ids = existing
+                .split(/\s+/)
+                .filter(id => id !== this._tooltipId)
+                .join(' ')
+                .trim();
+            if (ids) {
+                this.setAttribute('aria-describedby', ids);
+            }
+            else {
+                this.removeAttribute('aria-describedby');
+            }
+        }
+    }
+    __decorate([
+        property({ attribute: 'tooltip' })
+    ], TooltipMixinClass.prototype, "tooltip", void 0);
+    __decorate([
+        property({ attribute: 'tooltip-position' })
+    ], TooltipMixinClass.prototype, "tooltipPosition", void 0);
+    __decorate([
+        property({ attribute: 'tooltip-delay', type: Number })
+    ], TooltipMixinClass.prototype, "tooltipDelay", void 0);
+    __decorate([
+        property({ attribute: 'tooltip-offset' })
+    ], TooltipMixinClass.prototype, "tooltipOffset", void 0);
+    __decorate([
+        property({ attribute: 'tooltip-no-arrow', type: Boolean })
+    ], TooltipMixinClass.prototype, "tooltipNoArrow", void 0);
+    __decorate([
+        property({ attribute: 'tooltip-trigger' })
+    ], TooltipMixinClass.prototype, "tooltipTrigger", void 0);
+    return TooltipMixinClass;
+};
+//# sourceMappingURL=TooltipMixin.js.map

package/dist/util/TooltipMixin.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"aria.d.ts","sourceRoot":"","sources":["../../src/util/aria.ts"],"names":[],"mappings":"AAUA,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAQ/D;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,QA+BxD"}
+{"version":3,"file":"aria.d.ts","sourceRoot":"","sources":["../../src/util/aria.ts"],"names":[],"mappings":"AAUA,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAG/D;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,QA+BxD"}

package/dist/util/aria.js

@@ -9,7 +9,8 @@
     <- 'Today is Friday and the weather is sunny.'
 */
 export function replaceWithEach(template, data) {
-    return template.replace(/_{3}/g, (i => (_) => data[i++])(0));
+    let i = 0;
+    return template.replace(/_{3}/g, () => (i < data.length ? data[i++] : '___'));
 }
 export function announce(message, data) {
     let container = document.getElementById('aria-live-container');

package/dist/util/aria.js.map

@@ -1 +1 @@
-{"version":3,"file":"aria.js","sourceRoot":"","sources":["../../src/util/aria.ts"],"names":[],"mappings":"AAAA;;;;;;;;;EASE;AACF,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,IAAc;IAC9D,OAAO,QAAQ,CAAC,OAAO,CACrB,OAAO,EACP,CACE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAS,EAAE,EAAE,CACjB,IAAI,CAAC,CAAC,EAAE,CAAC,CACZ,CAAC,CAAC,CAAC,CACL,CAAA;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,IAAe;IACvD,IAAI,SAAS,GAAG,QAAQ,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAA;IAC9D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;QACzC,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAA;QACnD,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAA;IACtC,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;IAC5C,MAAM,EAAE,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAChC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IAC7B,MAAM,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;IAC1C,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;IAC1C,MAAM,CAAC,KAAK,CAAC,OAAO;QAClB,wJAAwJ,CAAA;IAC1J,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,GAAG,eAAe,CAAC,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,CAAA;IAC/C,CAAC;IACD,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IAE7B,UAAU,CAAC,GAAG,EAAE;QACd,MAAM,UAAU,GAAG,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAA;QAC9C,IAAI,UAAU;YAAE,UAAU,CAAC,SAAS,GAAG,OAAO,CAAA;IAChD,CAAC,EAAE,GAAG,CAAC,CAAA;IAEP,IAAI,MAAM,CAAC,UAAU,EAAE,SAAS,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,oBAAoB,OAAO,GAAG,CAAC,CAAA;IAC7C,CAAC;IAED,UAAU,CAAC,GAAG,EAAE;QACd,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAA;IACvC,CAAC,EAAE,IAAI,CAAC,CAAA;AACV,CAAC"}
+{"version":3,"file":"aria.js","sourceRoot":"","sources":["../../src/util/aria.ts"],"names":[],"mappings":"AAAA;;;;;;;;;EASE;AACF,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,IAAc;IAC9D,IAAI,CAAC,GAAG,CAAC,CAAA;IACT,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;AAC/E,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,IAAe;IACvD,IAAI,SAAS,GAAG,QAAQ,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAA;IAC9D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;QACzC,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAA;QACnD,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAA;IACtC,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;IAC5C,MAAM,EAAE,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAChC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IAC7B,MAAM,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;IAC1C,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;IAC1C,MAAM,CAAC,KAAK,CAAC,OAAO;QAClB,wJAAwJ,CAAA;IAC1J,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,GAAG,eAAe,CAAC,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,CAAA;IAC/C,CAAC;IACD,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IAE7B,UAAU,CAAC,GAAG,EAAE;QACd,MAAM,UAAU,GAAG,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAA;QAC9C,IAAI,UAAU;YAAE,UAAU,CAAC,SAAS,GAAG,OAAO,CAAA;IAChD,CAAC,EAAE,GAAG,CAAC,CAAA;IAEP,IAAI,MAAM,CAAC,UAAU,EAAE,SAAS,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,oBAAoB,OAAO,GAAG,CAAC,CAAA;IAC7C,CAAC;IAED,UAAU,CAAC,GAAG,EAAE;QACd,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAA;IACvC,CAAC,EAAE,IAAI,CAAC,CAAA;AACV,CAAC"}

package/dist/util/i18n.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Look up a localized string from window.BRIGHTSPOT.ui[namespace][key],
+ * falling back to the provided English default.
+ *
+ * @param namespace - Component namespace (e.g., 'pagination')
+ * @param key - String key within the namespace
+ * @param fallback - English default when no global override exists
+ * @param replacements - Positional values to substitute for sequential `___`
+ *   (triple-underscore) placeholders in the resolved string.
+ *   E.g., `l10n('ns', 'k', '___-___ of ___', [1, 10, 200])` → `"1-10 of 200"`
+ */
+export declare function l10n(namespace: string, key: string, fallback: string, replacements?: (string | number)[]): string;
+//# sourceMappingURL=i18n.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/util/i18n.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,wBAAgB,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM,CAOjH"}

package/dist/util/i18n.js

@@ -0,0 +1,21 @@
+import { replaceWithEach } from './aria.js';
+/**
+ * Look up a localized string from window.BRIGHTSPOT.ui[namespace][key],
+ * falling back to the provided English default.
+ *
+ * @param namespace - Component namespace (e.g., 'pagination')
+ * @param key - String key within the namespace
+ * @param fallback - English default when no global override exists
+ * @param replacements - Positional values to substitute for sequential `___`
+ *   (triple-underscore) placeholders in the resolved string.
+ *   E.g., `l10n('ns', 'k', '___-___ of ___', [1, 10, 200])` → `"1-10 of 200"`
+ */
+export function l10n(namespace, key, fallback, replacements) {
+    const ui = window.BRIGHTSPOT?.ui;
+    const value = ui?.[namespace]?.[key] ?? fallback;
+    if (replacements?.length) {
+        return replaceWithEach(value, replacements.map(String));
+    }
+    return value;
+}
+//# sourceMappingURL=i18n.js.map

package/dist/util/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../src/util/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAE3C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,IAAI,CAAC,SAAiB,EAAE,GAAW,EAAE,QAAgB,EAAE,YAAkC;IACvG,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,EAAwD,CAAA;IACtF,MAAM,KAAK,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAA;IAChD,IAAI,YAAY,EAAE,MAAM,EAAE,CAAC;QACzB,OAAO,eAAe,CAAC,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IACzD,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brightspot/ui",
-  "version": "1.4.1",
+  "version": "1.6.0",
   "type": "module",
   "license": "UNLICENSED",
   "description": "A UI library for building Brightspot CMS components.",
@@ -52,7 +52,6 @@
     "husky": "^9.1.7",
     "lint-staged": "^16.2.6",
     "lit": "^3.3.0",
-    "loglevel": "^1.8.0",
     "mini-css-extract-plugin": "^2.6.1",
     "playwright": "^1.58.2",
     "postcss-import": "^16.0.0",
@@ -74,6 +73,7 @@
   },
   "dependencies": {
     "broadcast-channel": "^4.13.0",
+    "loglevel": "^1.8.0",
     "lucide-static": "0.508.0",
     "tabbable": "6.2.0",
     "tailwindcss": "^3.4.13",