@brightspot/ui 1.1.0 → 1.3.0

package/dist/util/ProgressMixin.js

@@ -0,0 +1,190 @@
+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 { property } from 'lit/decorators.js';
+import { announce } from '../util/aria';
+/**
+ * Mixin that adds common progress indicator properties.
+ * Used by progress components like CircularProgress and LinearProgress.
+ *
+ * @mixin
+ *
+ * @param Base - The base class to extend
+ * @returns Extended class with progress properties
+ *
+ * @fires {CustomEvent} btu-progress-ready - Fired after first render and initialization
+ * @fires {CustomEvent} btu-progress-complete - Fired when progress reaches 100
+ *
+ * @cssprop --progress-color - Progress indicator color (overrides theme color)
+ * @cssprop --track-color - Track/background color (overrides default gray-100)
+ *
+ * @example
+ * ```typescript
+ * class MyProgress extends ProgressMixin(LitElement) {
+ *   // Component now has color, size, thickness, and progress properties
+ * }
+ * ```
+ */
+export const ProgressMixin = (Base) => {
+    class ProgressMixinClass extends Base {
+        constructor() {
+            super(...arguments);
+            /**
+             * Color theme of the progress indicator.
+             * Supports: black, white, primary, teal, gray, purple, rose, error, warning, success
+             * @attr
+             */
+            this.color = 'primary';
+            /**
+             * Progress value for determinate variant.
+             * Value between 0 and 100.
+             * @attr
+             */
+            this._progress = 0;
+            /**
+             * Whether to animate progress from 0 to target value when component first becomes visible.
+             * @attr initial-animation
+             */
+            this.initialAnimation = true;
+            /**
+             * Optional aria-label attribute for screen readers.
+             * Describes what the progress indicator represents.
+             * @attr aria-label
+             */
+            this.ariaLabel = null;
+            /**
+             * Optional aria-labelledby attribute for screen readers.
+             * References the ID of an element that labels the progress indicator.
+             * @attr aria-labelledby
+             */
+            this.ariaLabelledBy = null;
+            /**
+             * Optional aria-valuetext attribute for screen readers.
+             * Provides human-readable text alternative for progress value.
+             * @attr aria-valuetext
+             */
+            this.ariaValueText = null;
+            this._isAnimationInitialized = false;
+            this._hasCompletedAt100 = false;
+        }
+        get progress() {
+            return this._progress;
+        }
+        set progress(value) {
+            const numValue = isNaN(value) ? 0 : value;
+            this._progress = Math.min(Math.max(numValue, 0), 100);
+        }
+        /**
+         * Get the color value with --progress-color custom property override support.
+         * Returns a CSS color string that checks for custom property first, then falls back to theme color.
+         */
+        _getProgressColorValue() {
+            // Handle special colors (white, black)
+            if (this.color === 'white' || this.color === 'black') {
+                return `var(--progress-color, var(--btu-theme-${this.color}))`;
+            }
+            // Standard theme colors use -600 variant
+            return `var(--progress-color, oklch(var(--btu-theme-${this.color}-600)))`;
+        }
+        /**
+         * Get the animated progress value.
+         * Returns 0 if initialAnimation is enabled and animation hasn't started yet, otherwise returns actual progress.
+         */
+        _getAnimatedProgress() {
+            if (this.initialAnimation && !this._isAnimationInitialized) {
+                return 0;
+            }
+            return this._progress;
+        }
+        /**
+         * Setup initial animation with IntersectionObserver when component first becomes visible.
+         * Should be called from component's firstUpdated() or updated() methods.
+         * Safe to call multiple times - will skip if already initialized.
+         */
+        _setupInitialAnimation() {
+            if (!this.initialAnimation || this._isAnimationInitialized) {
+                this._isAnimationInitialized = true;
+                return;
+            }
+            this._cleanupInitialAnimation();
+            this._intersectionObserver = new IntersectionObserver(entries => {
+                entries.forEach(entry => {
+                    if (entry.isIntersecting && !this._isAnimationInitialized) {
+                        requestAnimationFrame(() => {
+                            this._isAnimationInitialized = true;
+                            this.requestUpdate();
+                        });
+                        this._intersectionObserver?.disconnect();
+                    }
+                });
+            }, { threshold: 0.1 });
+            this._intersectionObserver.observe(this);
+        }
+        /**
+         * Cleanup intersection observer.
+         * Should be called from component's disconnectedCallback() method.
+         */
+        _cleanupInitialAnimation() {
+            this._intersectionObserver?.disconnect();
+        }
+        /**
+         * Lifecycle callback fired after the first render.
+         * Emits btu-progress-ready event.
+         * @internal
+         */
+        firstUpdated(changedProperties) {
+            super.firstUpdated(changedProperties);
+            this.emit('btu-progress-ready');
+        }
+        /**
+         * Track progress completion and emit event when reaching 100%.
+         * Should be called from component's updated() method.
+         */
+        _trackCompletion() {
+            if (this._progress === 100 && !this._hasCompletedAt100) {
+                this._hasCompletedAt100 = true;
+                this.emit('btu-progress-complete');
+                // Announce completion to screen readers if message provided
+                if (this.completionAnnouncement) {
+                    announce(this.completionAnnouncement);
+                }
+            }
+            else if (this._progress < 100 && this._hasCompletedAt100) {
+                // Reset flag if progress drops below 100 (allows re-triggering)
+                this._hasCompletedAt100 = false;
+            }
+        }
+    }
+    __decorate([
+        property({ type: String })
+    ], ProgressMixinClass.prototype, "color", void 0);
+    __decorate([
+        property({ type: Number })
+    ], ProgressMixinClass.prototype, "thickness", void 0);
+    __decorate([
+        property({ type: Number })
+    ], ProgressMixinClass.prototype, "progress", null);
+    __decorate([
+        property({ type: String })
+    ], ProgressMixinClass.prototype, "label", void 0);
+    __decorate([
+        property({ type: Boolean, attribute: 'initial-animation' })
+    ], ProgressMixinClass.prototype, "initialAnimation", void 0);
+    __decorate([
+        property({ type: String, attribute: 'aria-label' })
+    ], ProgressMixinClass.prototype, "ariaLabel", void 0);
+    __decorate([
+        property({ type: String, attribute: 'aria-labelledby' })
+    ], ProgressMixinClass.prototype, "ariaLabelledBy", void 0);
+    __decorate([
+        property({ type: String, attribute: 'aria-valuetext' })
+    ], ProgressMixinClass.prototype, "ariaValueText", void 0);
+    __decorate([
+        property({ type: String, attribute: 'completion-announcement' })
+    ], ProgressMixinClass.prototype, "completionAnnouncement", void 0);
+    return ProgressMixinClass;
+};
+//# sourceMappingURL=ProgressMixin.js.map

package/dist/util/ProgressMixin.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"ReadyMixin.d.ts","sourceRoot":"","sources":["../../src/util/ReadyMixin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AAChC,KAAK,WAAW,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAExD,MAAM,CAAC,OAAO,OAAO,mBAAmB;CAAG;AAE3C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,WAAW,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,KAc/C,WAAW,CAAC,mBAAmB,CAAC,GAAG,CAC9D,CAAA"}

package/dist/util/ReadyMixin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadyMixin.js","sourceRoot":"","sources":["../../src/util/ReadyMixin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AAKhC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAoC,UAAa,EAAE,EAAE;IAC7E,MAAM,eAAgB,SAAQ,UAAU;QACtC,iBAAiB;YACf,MAAM,IAAI,GAAG,GAAG,EAAE;gBAChB,KAAK,CAAC,iBAAiB,EAAE,CAAA;YAC3B,CAAC,CAAA;YAED,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBACtC,IAAI,EAAE,CAAA;YACR,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,CAAA;YAC7D,CAAC;QACH,CAAC;KACF;IACD,OAAO,eAAuD,CAAA;AAChE,CAAC,CAAA"}

package/dist/util/aria.d.ts

@@ -0,0 +1,3 @@
+export declare function replaceWithEach(template: string, data: string[]): string;
+export declare function announce(message: string, data?: string[]): void;
+//# sourceMappingURL=aria.d.ts.map

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

@@ -0,0 +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"}

package/dist/util/aria.js

@@ -0,0 +1,44 @@
+/*
+  Simple string replacement utility.
+  Find all instances of "___" in the string
+  and replace with each string in the list of data.
+  eg:
+    template = 'Today is ___ and the weather is ___.'
+    data = ['Friday', 'sunnny']
+    --------------------------
+    <- 'Today is Friday and the weather is sunny.'
+*/
+export function replaceWithEach(template, data) {
+    return template.replace(/_{3}/g, (i => (_) => data[i++])(0));
+}
+export function announce(message, data) {
+    let container = document.getElementById('aria-live-container');
+    if (!container) {
+        container = document.createElement('div');
+        container.setAttribute('id', 'aria-live-container');
+        document.body.appendChild(container);
+    }
+    const status = document.createElement('div');
+    const id = 'speak-' + Date.now();
+    status.setAttribute('id', id);
+    status.setAttribute('aria-atomic', 'true');
+    status.setAttribute('aria-live', 'polite');
+    status.style.cssText =
+        'position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0, 0, 0, 0); white-space: nowrap; border-width: 0;';
+    if (data && data.length) {
+        message = replaceWithEach(`${message}`, data);
+    }
+    container.appendChild(status);
+    setTimeout(() => {
+        const liveRegion = document.getElementById(id);
+        if (liveRegion)
+            liveRegion.innerHTML = message;
+    }, 150);
+    if (window.BRIGHTSPOT?.ariaDebug === true) {
+        console.log(`ARIA Announced: "${message}"`);
+    }
+    setTimeout(() => {
+        document.getElementById(id)?.remove();
+    }, 2000);
+}
+//# sourceMappingURL=aria.js.map

package/dist/util/aria.js.map

@@ -0,0 +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"}

package/dist/util/onFind.d.ts

@@ -0,0 +1,11 @@
+export type CallbackFunction<E extends Element> = (element: E) => void;
+export type Selectors = string | string[];
+declare function onFind<E extends Element>(root: ParentNode, selectors: Selectors, fn: CallbackFunction<E>): void;
+declare function onFind<E extends Element>(selectors: Selectors, fn: CallbackFunction<E>): void;
+declare namespace onFind {
+    var triggerCallbacks: (mutations?: MutationRecord[]) => void;
+    var pause: () => void;
+    var resume: () => void;
+}
+export default onFind;
+//# sourceMappingURL=onFind.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onFind.d.ts","sourceRoot":"","sources":["../../src/util/onFind.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAA;AACtE,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,EAAE,CAAA;AAqNzC,iBAAS,MAAM,CAAC,CAAC,SAAS,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;AAEzG,iBAAS,MAAM,CAAC,CAAC,SAAS,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;kBAA9E,MAAM;uCA1GuB,cAAc,EAAE;;;;AAiJtD,eAAe,MAAM,CAAA"}

package/dist/util/onFind.js

@@ -0,0 +1,210 @@
+import log from 'loglevel';
+let calledIndex = 0;
+class Callback {
+    #root;
+    #called;
+    #selectors;
+    #fn;
+    #matches;
+    constructor(root, selectors, fn) {
+        this.#root = root;
+        this.#called = `data-ofc${calledIndex++}`;
+        if (!Array.isArray(selectors)) {
+            selectors = [selectors];
+        }
+        this.#selectors = selectors
+            .map(selectors.some(s => s.indexOf(',') > -1) ? s => s : s => `${s}:not([${this.#called}])`)
+            .join(',');
+        this.#fn = fn;
+        const matches = selectors.map(s => s.trim()).filter(s => s.indexOf(' ') < 0 && s.indexOf(',') < 0);
+        if (matches.length === selectors.length) {
+            this.#matches = matches;
+        }
+    }
+    addTriggerElements(triggerElements, element) {
+        if (this.#root.contains(element)) {
+            if (element.matches(this.#selectors)) {
+                triggerElements.push(element);
+            }
+            for (const e of element.querySelectorAll(this.#selectors)) {
+                triggerElements.push(e);
+            }
+        }
+    }
+    trigger(elements) {
+        if (document.readyState === 'loading') {
+            return;
+        }
+        if (this.#matches && Array.isArray(elements)) {
+            for (const element of elements) {
+                if (this.#matches.some(m => element.matches(m))) {
+                    this.#callCallback(element);
+                }
+            }
+        }
+        else {
+            for (const element of this.#root.querySelectorAll(this.#selectors)) {
+                this.#callCallback(element);
+            }
+        }
+    }
+    #callCallback(element) {
+        if (inBlacklist(element)) {
+            return;
+        }
+        if (!element.hasAttribute(this.#called)) {
+            element.setAttribute(this.#called, '');
+            try {
+                this.#fn(element);
+            }
+            catch (error) {
+                log.error('Failed callback!', element, error);
+            }
+        }
+    }
+}
+let triggerPaused = false;
+let triggerOnResume = false;
+let triggerAll = false;
+let triggerElements = [];
+let triggerFrame;
+const callbacks = [];
+function inBlacklist(node) {
+    if (!(node instanceof Element))
+        return false;
+    return (node.closest('.CIG-wordCount') !== null ||
+        node.closest('.ContentEdit-previewDisplay') !== null ||
+        node.closest('.ContentLabel') !== null ||
+        node.closest('.PreviewFrame-typeDisplay') !== null ||
+        node.closest('.ProseMirrorToolbar') !== null ||
+        node.closest('.ProseMirror') !== null ||
+        node.closest('.ProseMirrorContainer') !== null ||
+        node.closest('.ProseMirror-fullscreen-container') !== null ||
+        node.closest('.ProseMirror-comments') !== null ||
+        node.closest('.RichTextEditor') !== null ||
+        node.closest('.WorkInProgressSaveStatus') !== null ||
+        node.closest('#aria-live-container') !== null ||
+        node.closest('.widget-urlsAutomatic') !== null);
+}
+const every = Array.prototype.every;
+const isText = (node) => node.nodeType === Node.TEXT_NODE;
+function triggerCallbacks(mutations) {
+    if (triggerPaused) {
+        triggerOnResume = true;
+        return;
+    }
+    const checkMutations = Array.isArray(mutations);
+    const validMutations = [];
+    if (checkMutations) {
+        for (const mutation of mutations) {
+            const target = mutation.target;
+            if (inBlacklist(target)) {
+                continue;
+            }
+            switch (mutation.type) {
+                case 'attributes':
+                    if (mutation.oldValue !== target.getAttribute(mutation.attributeName)) {
+                        validMutations.push(mutation);
+                    }
+                    break;
+                case 'childList':
+                    if (!every.call(mutation.addedNodes, isText) || !every.call(mutation.removedNodes, isText)) {
+                        validMutations.push(mutation);
+                    }
+                    break;
+            }
+        }
+        if (validMutations.length === 0) {
+            return;
+        }
+    }
+    if (validMutations.length > 500) {
+        triggerAll = true;
+    }
+    if (!triggerAll) {
+        if (checkMutations) {
+            for (const mutation of validMutations) {
+                const element = mutation.target;
+                switch (mutation.type) {
+                    case 'attributes':
+                        triggerElements.push(element);
+                        break;
+                    case 'childList':
+                        for (const callback of callbacks) {
+                            callback.addTriggerElements(triggerElements, element);
+                        }
+                        break;
+                }
+            }
+        }
+        else {
+            triggerAll = true;
+        }
+    }
+    if ((triggerAll || triggerElements.length > 0) && !triggerFrame) {
+        triggerFrame = window.requestAnimationFrame(() => {
+            const elements = triggerAll ? undefined : triggerElements;
+            triggerAll = false;
+            triggerElements = [];
+            triggerFrame = 0;
+            callbacks.forEach(callback => callback.trigger(elements));
+        });
+    }
+}
+function initialize() {
+    document.documentElement.hidden = false;
+    triggerCallbacks();
+    new MutationObserver(triggerCallbacks).observe(document, {
+        attributes: true,
+        attributeFilter: [
+            'class',
+            'data-bsp-autosubmit',
+            'data-chart-type',
+            'data-code-type',
+            'data-internal-name',
+            'data-tab',
+            'name',
+            'rel',
+            'target',
+        ],
+        attributeOldValue: true,
+        childList: true,
+        subtree: true,
+    });
+}
+document.documentElement.hidden = true;
+if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', initialize);
+}
+else {
+    initialize();
+}
+function onFind(rootOrSelectors, selectorsOrFn, fn) {
+    let root;
+    let selectors;
+    if (typeof fn !== 'undefined') {
+        root = rootOrSelectors;
+        selectors = selectorsOrFn;
+    }
+    else {
+        root = document;
+        selectors = rootOrSelectors;
+        fn = selectorsOrFn;
+    }
+    const callback = new Callback(root, selectors, fn);
+    callback.trigger();
+    callbacks.push(callback);
+}
+onFind.triggerCallbacks = triggerCallbacks;
+onFind.pause = () => {
+    triggerPaused = true;
+};
+onFind.resume = () => {
+    triggerPaused = false;
+    if (triggerOnResume) {
+        triggerOnResume = false;
+        setTimeout(triggerCallbacks, 100);
+    }
+};
+export default onFind;
+//# sourceMappingURL=onFind.js.map

package/dist/util/onFind.js.map

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

package/dist/util/svg.d.ts

@@ -1,3 +1,12 @@
 export declare function addNameSpaceXML(data: string): string;
+/**
+ * Adds a mask element to an SVG string. The mask is inserted immediately after the opening <svg> tag
+ * and wraps the existing SVG content, ending before the closing </svg> tag.
+ *
+ * @param {string} svg - The SVG string to which the mask will be added. Must contain valid <svg> tags.
+ * @param {string} maskId - The ID to assign to the <mask> element.
+ * @returns {string} - The modified SVG string with the mask element added.
+ */
+export declare function addMask(svg: string, maskId: string): string;
 export declare function encodeSVG(data: string): string;
 //# sourceMappingURL=svg.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"svg.d.ts","sourceRoot":"","sources":["../../src/util/svg.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9C"}
+{"version":3,"file":"svg.d.ts","sourceRoot":"","sources":["../../src/util/svg.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAe3D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9C"}

package/dist/util/svg.js

@@ -5,6 +5,28 @@ export function addNameSpaceXML(data) {
     }
     return data;
 }
+/**
+ * Adds a mask element to an SVG string. The mask is inserted immediately after the opening <svg> tag
+ * and wraps the existing SVG content, ending before the closing </svg> tag.
+ *
+ * @param {string} svg - The SVG string to which the mask will be added. Must contain valid <svg> tags.
+ * @param {string} maskId - The ID to assign to the <mask> element.
+ * @returns {string} - The modified SVG string with the mask element added.
+ */
+export function addMask(svg, maskId) {
+    // Insert <mask id="..."> right after <svg ...>
+    const openingSvgTagMatch = svg.match(/<svg[^>]*>/);
+    if (!openingSvgTagMatch)
+        return svg;
+    const openingSvgTag = openingSvgTagMatch[0];
+    const maskOpen = `<mask id="${maskId}">`;
+    const maskClose = `</mask>`;
+    // Find positions
+    const start = svg.indexOf(openingSvgTag) + openingSvgTag.length;
+    const end = svg.lastIndexOf('</svg>');
+    // Insert mask tags
+    return svg.slice(0, start) + maskOpen + svg.slice(start, end) + maskClose + svg.slice(end);
+}
 export function encodeSVG(data) {
     data = data.replace(/"/g, `'`);
     data = data.replace(/>\s{1,}</g, `><`);

package/dist/util/svg.js.map

@@ -1 +1 @@
-{"version":3,"file":"svg.js","sourceRoot":"","sources":["../../src/util/svg.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,GAAG,0BAA0B,CAAA;AAE1C,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,IAAI,CAAC,OAAO,CAAC,4BAA4B,CAAC,GAAG,CAAC,EAAE,CAAC;QACnD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,yCAAyC,CAAC,CAAA;IACzE,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAC9B,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;IACtC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;IACnC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAA;AAClD,CAAC"}
+{"version":3,"file":"svg.js","sourceRoot":"","sources":["../../src/util/svg.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,GAAG,0BAA0B,CAAA;AAE1C,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,IAAI,CAAC,OAAO,CAAC,4BAA4B,CAAC,GAAG,CAAC,EAAE,CAAC;QACnD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,yCAAyC,CAAC,CAAA;IACzE,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,MAAc;IACjD,+CAA+C;IAC/C,MAAM,kBAAkB,GAAG,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;IAClD,IAAI,CAAC,kBAAkB;QAAE,OAAO,GAAG,CAAA;IAEnC,MAAM,aAAa,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAA;IAC3C,MAAM,QAAQ,GAAG,aAAa,MAAM,IAAI,CAAA;IACxC,MAAM,SAAS,GAAG,SAAS,CAAA;IAE3B,iBAAiB;IACjB,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC,MAAM,CAAA;IAC/D,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;IAErC,mBAAmB;IACnB,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;AAC5F,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAC9B,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;IACtC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;IACnC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAA;AAClD,CAAC"}

package/dist/util/throttle.d.ts

@@ -0,0 +1,4 @@
+type UnknownFunction = (...args: unknown[]) => unknown;
+export declare function throttle(interval: number, fn: UnknownFunction): UnknownFunction;
+export {};
+//# sourceMappingURL=throttle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../src/util/throttle.ts"],"names":[],"mappings":"AAAA,KAAK,eAAe,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAA;AAGtD,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,eAAe,GAAG,eAAe,CA8B/E"}

package/dist/util/throttle.js

@@ -0,0 +1,30 @@
+/* eslint-disable prefer-rest-params */
+export function throttle(interval, fn) {
+    if (interval <= 0) {
+        return fn;
+    }
+    let timeoutId;
+    let lastTrigger = 0;
+    return function () {
+        // Already scheduled to run.
+        if (timeoutId) {
+            return;
+        }
+        const now = Date.now();
+        const delay = interval - now + lastTrigger;
+        // Waited long enough so execute.
+        if (delay <= 0) {
+            lastTrigger = now;
+            fn.apply(this, [...arguments]);
+        }
+        else {
+            // Schedule for later.
+            timeoutId = setTimeout(() => {
+                lastTrigger = now;
+                timeoutId = undefined;
+                fn.apply(this, [...arguments]);
+            }, delay);
+        }
+    };
+}
+//# sourceMappingURL=throttle.js.map

package/dist/util/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../src/util/throttle.ts"],"names":[],"mappings":"AAEA,uCAAuC;AACvC,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,EAAmB;IAC5D,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAClB,OAAO,EAAE,CAAA;IACX,CAAC;IAED,IAAI,SAAoD,CAAA;IACxD,IAAI,WAAW,GAAG,CAAC,CAAA;IAEnB,OAAO;QACL,4BAA4B;QAC5B,IAAI,SAAS,EAAE,CAAC;YACd,OAAM;QACR,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,MAAM,KAAK,GAAG,QAAQ,GAAG,GAAG,GAAG,WAAW,CAAA;QAE1C,iCAAiC;QACjC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,WAAW,GAAG,GAAG,CAAA;YACjB,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAA;QAChC,CAAC;aAAM,CAAC;YACN,sBAAsB;YACtB,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC1B,WAAW,GAAG,GAAG,CAAA;gBACjB,SAAS,GAAG,SAAS,CAAA;gBACrB,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAA;YAChC,CAAC,EAAE,KAAK,CAAC,CAAA;QACX,CAAC;IACH,CAAC,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brightspot/ui",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "type": "module",
   "license": "UNLICENSED",
   "description": "A UI library for building Brightspot CMS components.",
@@ -46,6 +46,7 @@
     "husky": "^9.1.7",
     "lint-staged": "^16.2.6",
     "lit": "^3.3.0",
+    "loglevel": "^1.8.0",
     "mini-css-extract-plugin": "^2.6.1",
     "postcss-import": "^16.0.0",
     "postcss-loader": "^8.0.0",
@@ -80,7 +81,7 @@
     "src/components/**/*.ts": [
       "node scripts/run-cem.cjs",
       "node scripts/generate-docs.mjs",
-      "git add docs/api.md"
+      "git add docs/components/"
     ],
     "*": "yarn format"
   }