@brightspot/ui 1.3.0 → 1.4.0

package/dist/util/TetherLayout.js

@@ -0,0 +1,121 @@
+import { repaint } from './repaint.js';
+export class TetherLayout {
+    #oldUpdates;
+    #tethers;
+    #update;
+    #updateInterval;
+    constructor() {
+        this.#oldUpdates = new WeakMap();
+        this.#tethers = [];
+        this.#updateInterval = null;
+        this.#update = repaint(this.updateImmediately.bind(this));
+    }
+    get tethers() {
+        return this.#tethers;
+    }
+    add(tether) {
+        this.#tethers.push(tether);
+        this.start();
+    }
+    remove(tether) {
+        const tethers = this.#tethers;
+        const index = tethers.indexOf(tether);
+        if (index > -1) {
+            tethers.splice(index, 1);
+        }
+        if (tethers.length < 0) {
+            this.stop();
+        }
+    }
+    start() {
+        this.updateImmediately();
+        if (this.#updateInterval === null) {
+            window.addEventListener('resize', this.#update, true);
+            window.addEventListener('scroll', this.#update, true);
+            this.#updateInterval = setInterval(this.#update, 50);
+        }
+    }
+    stop() {
+        if (this.#updateInterval !== null) {
+            window.removeEventListener('resize', this.#update);
+            window.removeEventListener('scroll', this.#update);
+            clearInterval(this.#updateInterval);
+            this.#updateInterval = null;
+        }
+    }
+    updateImmediately() {
+        const tethers = this.#tethers;
+        if (tethers.length === 0) {
+            return;
+        }
+        const updates = [];
+        const root = document.documentElement;
+        let rw2 = root.clientWidth / 2;
+        let rh2 = root.clientHeight / 2;
+        const isRTL = root.dir === 'rtl';
+        for (const tether of tethers) {
+            const e = tether.element;
+            const rr = tether.reference.getBoundingClientRect();
+            const w = rr.width;
+            const h = rr.height;
+            if (w === 0 && h === 0) {
+                continue;
+            }
+            let top = rr.top;
+            let left = rr.left;
+            let viewportWidth = root.clientWidth;
+            // Adjust top and left values if inside fixed-position popover.
+            if (e.parentElement?.hasAttribute('popover')) {
+                top = tether.reference.offsetTop;
+                left = tether.reference.offsetLeft;
+                const popover = e.parentElement;
+                viewportWidth = popover.clientWidth;
+                rw2 = viewportWidth / 2;
+                rh2 = popover.clientHeight / 2;
+            }
+            // Calculate horizontal position, accounting for RTL direction
+            let horizontalPosition;
+            let calculatedLeft = left;
+            if (isRTL) {
+                // In RTL, we need to mirror the positioning
+                // Convert left position to right position, then back to left for calculation
+                const rightPosition = viewportWidth - left - w;
+                calculatedLeft = rightPosition;
+                // Determine which side based on mirrored position
+                horizontalPosition = rightPosition < rw2 ? 'l' : 'r';
+            }
+            else {
+                // In LTR, use normal logic: left side uses 'l', right side uses 'r'
+                horizontalPosition = left < rw2 ? 'l' : 'r';
+            }
+            updates.push({
+                element: e,
+                x: horizontalPosition,
+                y: top + h / 2 < rh2 ? 't' : 'b',
+                l: `${calculatedLeft}px`,
+                w: `${w}px`,
+                t: `${top}px`,
+                h: `${h}px`,
+            });
+        }
+        for (const update of updates) {
+            const e = update.element;
+            const oldUpdate = this.#oldUpdates.get(e) || {};
+            const es = e.style;
+            if (update.x !== oldUpdate.x)
+                e.setAttribute('data-tether-rx', update.x);
+            if (update.y !== oldUpdate.y)
+                e.setAttribute('data-tether-ry', update.y);
+            if (update.l !== oldUpdate.l)
+                es.setProperty('--Tether-rl', update.l);
+            if (update.w !== oldUpdate.w)
+                es.setProperty('--Tether-rw', update.w);
+            if (update.t !== oldUpdate.t)
+                es.setProperty('--Tether-rt', update.t);
+            if (update.h !== oldUpdate.h)
+                es.setProperty('--Tether-rh', update.h);
+            this.#oldUpdates.set(e, update);
+        }
+    }
+}
+//# sourceMappingURL=TetherLayout.js.map

package/dist/util/TetherLayout.js.map

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

package/dist/util/debounce.d.ts

@@ -0,0 +1,3 @@
+import type { UnknownFunction } from './types.js';
+export declare function debounce(wait: number, fn: UnknownFunction): UnknownFunction;
+//# sourceMappingURL=debounce.d.ts.map

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

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

package/dist/util/debounce.js

@@ -0,0 +1,15 @@
+/* eslint-disable prefer-rest-params */
+export function debounce(wait, fn) {
+    if (wait <= 0) {
+        return fn;
+    }
+    let timeoutId;
+    return function () {
+        clearTimeout(timeoutId);
+        timeoutId = setTimeout(() => {
+            timeoutId = undefined;
+            fn.apply(this, [...arguments]);
+        }, wait);
+    };
+}
+//# sourceMappingURL=debounce.js.map

package/dist/util/debounce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.js","sourceRoot":"","sources":["../../src/util/debounce.ts"],"names":[],"mappings":"AAEA,uCAAuC;AACvC,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,EAAmB;IACxD,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;QACd,OAAO,EAAE,CAAA;IACX,CAAC;IAED,IAAI,SAAoD,CAAA;IAExD,OAAO;QACL,YAAY,CAAC,SAAS,CAAC,CAAA;QAEvB,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,SAAS,GAAG,SAAS,CAAA;YACrB,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAA;QAChC,CAAC,EAAE,IAAI,CAAC,CAAA;IACV,CAAC,CAAA;AACH,CAAC"}

package/dist/util/focusable.d.ts

@@ -0,0 +1,9 @@
+export declare function getFocusableDescendants(selector: string, domElement: Element | null, startIndex?: number): {
+    first: import("tabbable").FocusableElement;
+    last: import("tabbable").FocusableElement;
+} | null;
+export declare function getFirstAndLastFocusableDescendants(el: Element, startIndex?: number): {
+    first: import("tabbable").FocusableElement;
+    last: import("tabbable").FocusableElement;
+} | null;
+//# sourceMappingURL=focusable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"focusable.d.ts","sourceRoot":"","sources":["../../src/util/focusable.ts"],"names":[],"mappings":"AAEA,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,EAAE,UAAU,SAAI;;;SAInG;AAGD,wBAAgB,mCAAmC,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,SAAI;;;SAU9E"}

package/dist/util/focusable.js

@@ -0,0 +1,19 @@
+import { tabbable } from 'tabbable';
+export function getFocusableDescendants(selector, domElement, startIndex = 0) {
+    const element = domElement ? domElement.querySelector(selector) : document.querySelector(selector);
+    if (!element)
+        return null;
+    return getFirstAndLastFocusableDescendants(element, startIndex);
+}
+// A function to get the first and last tabbable elements of a container
+export function getFirstAndLastFocusableDescendants(el, startIndex = 0) {
+    const tabbableArray = tabbable(el, { includeContainer: true });
+    if (tabbableArray.length === 0)
+        return null;
+    const safeStartIndex = Math.min(startIndex, tabbableArray.length - 1);
+    return {
+        first: tabbableArray[safeStartIndex],
+        last: tabbableArray[tabbableArray.length - 1],
+    };
+}
+//# sourceMappingURL=focusable.js.map

package/dist/util/focusable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focusable.js","sourceRoot":"","sources":["../../src/util/focusable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAEnC,MAAM,UAAU,uBAAuB,CAAC,QAAgB,EAAE,UAA0B,EAAE,UAAU,GAAG,CAAC;IAClG,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;IAClG,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAA;IACzB,OAAO,mCAAmC,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;AACjE,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,mCAAmC,CAAC,EAAW,EAAE,UAAU,GAAG,CAAC;IAC7E,MAAM,aAAa,GAAG,QAAQ,CAAC,EAAE,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAA;IAE9D,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAC3C,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAErE,OAAO;QACL,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC;QACpC,IAAI,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;KAC9C,CAAA;AACH,CAAC"}

package/dist/util/getComponentKey.d.ts

@@ -0,0 +1,2 @@
+export declare function getComponentKey(component: HTMLElement, nameAttribute: string): string | null;
+//# sourceMappingURL=getComponentKey.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getComponentKey.d.ts","sourceRoot":"","sources":["../../src/util/getComponentKey.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkB5F"}

package/dist/util/getComponentKey.js

@@ -0,0 +1,21 @@
+export function getComponentKey(component, nameAttribute) {
+    const edit = component.closest('.ContentEdit') || component.closest('btu-widget');
+    if (!edit)
+        return null;
+    let typeId;
+    let componentName;
+    if (edit.classList.contains('ContentEdit')) {
+        typeId = edit.getAttribute('data-type-id');
+        componentName = component.getAttribute(nameAttribute);
+        if (!typeId || !componentName)
+            return null;
+    }
+    else if (edit instanceof HTMLElement) {
+        typeId = edit.getAttribute('widgetid');
+        componentName = edit.getAttribute('internalname');
+        if (!typeId || !componentName)
+            return null;
+    }
+    return typeId && componentName ? `BSP.ContentEdit.widgetCollapsed.${typeId}.${componentName}` : null;
+}
+//# sourceMappingURL=getComponentKey.js.map

package/dist/util/getComponentKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getComponentKey.js","sourceRoot":"","sources":["../../src/util/getComponentKey.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAC,SAAsB,EAAE,aAAqB;IAC3E,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;IACjF,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IAEtB,IAAI,MAAM,CAAA;IACV,IAAI,aAAa,CAAA;IAEjB,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAC3C,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC,CAAA;QAC1C,aAAa,GAAG,SAAS,CAAC,YAAY,CAAC,aAAa,CAAC,CAAA;QACrD,IAAI,CAAC,MAAM,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAA;IAC5C,CAAC;SAAM,IAAI,IAAI,YAAY,WAAW,EAAE,CAAC;QACvC,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAA;QACtC,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC,CAAA;QACjD,IAAI,CAAC,MAAM,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAA;IAC5C,CAAC;IAED,OAAO,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC,mCAAmC,MAAM,IAAI,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACtG,CAAC"}

package/dist/util/keyboard.d.ts

@@ -0,0 +1,8 @@
+import type { FocusableElement } from 'tabbable';
+interface FocusableGroup {
+    first: FocusableElement;
+    last: FocusableElement;
+}
+export declare function trapFocusWithin(e: KeyboardEvent, elementGroups: FocusableGroup[], cycle?: boolean): void;
+export {};
+//# sourceMappingURL=keyboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/util/keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAGhD,UAAU,cAAc;IACtB,KAAK,EAAE,gBAAgB,CAAA;IACvB,IAAI,EAAE,gBAAgB,CAAA;CACvB;AAQD,wBAAgB,eAAe,CAAC,CAAC,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,EAAE,KAAK,UAAO,QAsC9F"}

package/dist/util/keyboard.js

@@ -0,0 +1,138 @@
+import { announce } from './aria.js';
+/*
+NOTE: This function will not perform as expected with the Safari Browser. Safari by default
+does not tab to anchor and button elements. Therefore, if the item being checked is a button or anchor tag,
+it will not be triggered since Safari will not tab to that element. For this functionality to work with Safari, the following
+must be set in the Safari settings: 'Press Tab to highlight each item on a webpage' in the 'advanced' section.
+*/
+export function trapFocusWithin(e, elementGroups, cycle = true) {
+    let keyType;
+    if (e.key === 'Tab' && e.shiftKey) {
+        keyType = 'back';
+    }
+    else if (e.key === 'Tab') {
+        keyType = 'forward';
+    }
+    else {
+        return;
+    }
+    /*
+     * NOTE: The following guard is a temporary workaround for users who get stuck in a focus trap due to poor DOM
+     * ordering not playing nicely with our focus trap logic. This code will become unnecessary once we reorder
+     * key elements in the DOM to match visual/tabbing order.
+     */
+    if (!cycle) {
+        guardAgainstFocusLoop(e, elementGroups, keyType);
+    }
+    for (let i = 0; i < elementGroups.length; i++) {
+        const group = elementGroups[i];
+        if (keyType === 'forward' && e.target === group.last) {
+            const nextGroup = elementGroups[i + 1] || (cycle ? elementGroups[0] : undefined);
+            if (nextGroup) {
+                e.preventDefault();
+                nextGroup.first?.focus();
+                return;
+            }
+        }
+        else if (keyType === 'back' && e.target === group.first) {
+            const prevGroup = elementGroups[i - 1] || (cycle ? elementGroups[elementGroups.length - 1] : undefined);
+            if (prevGroup) {
+                e.preventDefault();
+                prevGroup.last?.focus();
+                return;
+            }
+        }
+    }
+}
+/*
+ * Checks if one of the following conditions are met, and shows an escape hint if so:
+ * 1. User is tabbing forward from the last element of the last group, and there are elements
+ *    from earlier groups positioned after the last element in DOM order.
+ * 2. User is tabbing backward from the first element of the first group, and there are elements
+ *    from later groups positioned before the first element in DOM order.
+ */
+function guardAgainstFocusLoop(e, elementGroups, keyType) {
+    const lastGroup = elementGroups[elementGroups.length - 1];
+    const firstGroup = elementGroups[0];
+    if (keyType === 'forward' && e.target === lastGroup?.last) {
+        // Check if any element from an earlier group comes after the last element in DOM order
+        const lastElement = lastGroup.last;
+        for (let i = 0; i < elementGroups.length - 1; i++) {
+            const group = elementGroups[i];
+            if (comesAfter(group.first, lastElement) || comesAfter(group.last, lastElement)) {
+                showEscapeHint();
+                return;
+            }
+        }
+    }
+    if (keyType === 'back' && e.target === firstGroup?.first) {
+        // Check if any element from a later group comes before the first element in DOM order
+        const firstElement = firstGroup.first;
+        for (let i = 1; i < elementGroups.length; i++) {
+            const group = elementGroups[i];
+            if (comesBefore(group.first, firstElement) || comesBefore(group.last, firstElement)) {
+                showEscapeHint();
+                return;
+            }
+        }
+    }
+}
+/*
+ * Checks if an element comes after a reference element in DOM order.
+ */
+function comesAfter(element, reference) {
+    const position = reference.compareDocumentPosition(element);
+    return Boolean(position & Node.DOCUMENT_POSITION_FOLLOWING);
+}
+/*
+ * Checks if an element comes before a reference element in DOM order.
+ */
+function comesBefore(element, reference) {
+    const position = reference.compareDocumentPosition(element);
+    return Boolean(position & Node.DOCUMENT_POSITION_PRECEDING);
+}
+/*
+ * Shows a hint to the user about how to escape the focus trap.
+ * This hint is shown at most once every HINT_COOLDOWN milliseconds.
+ */
+let lastHintTime = 0;
+const HINT_COOLDOWN = 5000;
+function showEscapeHint() {
+    const now = Date.now();
+    if (now - lastHintTime < HINT_COOLDOWN)
+        return;
+    lastHintTime = now;
+    const message = window.BRIGHTSPOT?.ui?.tooltips?.focusTrapHint;
+    if (!message)
+        return;
+    // ARIA announcement for screen readers
+    announce(message);
+    // Visual popover for sighted users
+    showVisualPopover(message);
+}
+// A rudimentary visual popover that should be replaced later on with a list of landmark skip links.
+function showVisualPopover(message) {
+    const existingPopover = document.getElementById('focus-escape-hint');
+    if (existingPopover)
+        existingPopover.remove();
+    const popover = document.createElement('div');
+    popover.id = 'focus-escape-hint';
+    popover.textContent = message;
+    popover.setAttribute('role', 'status');
+    popover.style.position = 'fixed';
+    popover.style.bottom = '20px';
+    popover.style.right = '20px';
+    popover.style.padding = '12px 16px';
+    popover.style.backgroundColor = '#333';
+    popover.style.color = '#fff';
+    popover.style.borderRadius = '4px';
+    popover.style.fontSize = '14px';
+    popover.style.zIndex = '10000';
+    popover.style.boxShadow = '0 2px 8px rgba(0,0,0,0.3)';
+    popover.style.pointerEvents = 'none';
+    document.body.appendChild(popover);
+    setTimeout(() => {
+        popover.remove();
+    }, 4000);
+}
+//# sourceMappingURL=keyboard.js.map

package/dist/util/keyboard.js.map

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

package/dist/util/noise.d.ts

@@ -0,0 +1,6 @@
+export declare function noise(): {
+    getVal: (x: number) => number;
+    setAmplitude: (newAmplitude: number) => void;
+    setScale: (newScale: number) => void;
+};
+//# sourceMappingURL=noise.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"noise.d.ts","sourceRoot":"","sources":["../../src/util/noise.ts"],"names":[],"mappings":"AAEA,wBAAgB,KAAK;gBAYS,MAAM;iCA6BM,MAAM;yBAGd,MAAM;EAIvC"}

package/dist/util/noise.js

@@ -0,0 +1,43 @@
+// via: https://www.michaelbromley.co.uk/blog/simple-1d-noise-in-javascript/
+export function noise() {
+    const MAX_VERTICES = 256;
+    const MAX_VERTICES_MASK = MAX_VERTICES - 1;
+    let amplitude = 1;
+    let scale = 1;
+    const r = [];
+    for (let i = 0; i < MAX_VERTICES; ++i) {
+        r.push(Math.random());
+    }
+    const getVal = function (x) {
+        const scaledX = x * scale;
+        const xFloor = Math.floor(scaledX);
+        const t = scaledX - xFloor;
+        const tRemapSmoothstep = t * t * (3 - 2 * t);
+        /// Modulo using &
+        const xMin = xFloor & MAX_VERTICES_MASK;
+        const xMax = (xMin + 1) & MAX_VERTICES_MASK;
+        const y = lerp(r[xMin], r[xMax], tRemapSmoothstep);
+        return y * amplitude;
+    };
+    /**
+     * Linear interpolation function.
+     * @param a The lower integer value
+     * @param b The upper integer value
+     * @param t The value between the two
+     * @returns {number}
+     */
+    const lerp = function (a, b, t) {
+        return a * (1 - t) + b * t;
+    };
+    // return the API
+    return {
+        getVal: getVal,
+        setAmplitude: function (newAmplitude) {
+            amplitude = newAmplitude;
+        },
+        setScale: function (newScale) {
+            scale = newScale;
+        },
+    };
+}
+//# sourceMappingURL=noise.js.map

package/dist/util/noise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noise.js","sourceRoot":"","sources":["../../src/util/noise.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,MAAM,UAAU,KAAK;IACnB,MAAM,YAAY,GAAG,GAAG,CAAA;IACxB,MAAM,iBAAiB,GAAG,YAAY,GAAG,CAAC,CAAA;IAC1C,IAAI,SAAS,GAAG,CAAC,CAAA;IACjB,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,MAAM,CAAC,GAAa,EAAE,CAAA;IAEtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC;QACtC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;IACvB,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAS;QAChC,MAAM,OAAO,GAAG,CAAC,GAAG,KAAK,CAAA;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAClC,MAAM,CAAC,GAAG,OAAO,GAAG,MAAM,CAAA;QAC1B,MAAM,gBAAgB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;QAE5C,kBAAkB;QAClB,MAAM,IAAI,GAAG,MAAM,GAAG,iBAAiB,CAAA;QACvC,MAAM,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,iBAAiB,CAAA;QAE3C,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC,CAAA;QAElD,OAAO,CAAC,GAAG,SAAS,CAAA;IACtB,CAAC,CAAA;IAED;;;;;;OAMG;IACH,MAAM,IAAI,GAAG,UAAU,CAAS,EAAE,CAAS,EAAE,CAAS;QACpD,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC5B,CAAC,CAAA;IAED,iBAAiB;IACjB,OAAO;QACL,MAAM,EAAE,MAAM;QACd,YAAY,EAAE,UAAU,YAAoB;YAC1C,SAAS,GAAG,YAAY,CAAA;QAC1B,CAAC;QACD,QAAQ,EAAE,UAAU,QAAgB;YAClC,KAAK,GAAG,QAAQ,CAAA;QAClB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/util/onFindOnce.d.ts

@@ -0,0 +1,3 @@
+import type { Selectors } from './onFind.js';
+export declare function onFindOnce(selectors: Selectors, callback: () => void): void;
+//# sourceMappingURL=onFindOnce.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onFindOnce.d.ts","sourceRoot":"","sources":["../../src/util/onFindOnce.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,wBAAgB,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,IAAI,QA4BpE"}

package/dist/util/onFindOnce.js

@@ -0,0 +1,25 @@
+export function onFindOnce(selectors, callback) {
+    if (Array.isArray(selectors)) {
+        selectors = selectors.join(',');
+    }
+    if (document.querySelector(selectors)) {
+        callback();
+        return;
+    }
+    let called = false;
+    const observer = new MutationObserver(() => {
+        if (document.querySelector(selectors)) {
+            observer.disconnect();
+            if (!called) {
+                called = true;
+                callback();
+            }
+        }
+    });
+    observer.observe(document, {
+        attributes: true,
+        childList: true,
+        subtree: true,
+    });
+}
+//# sourceMappingURL=onFindOnce.js.map

package/dist/util/onFindOnce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onFindOnce.js","sourceRoot":"","sources":["../../src/util/onFindOnce.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,UAAU,CAAC,SAAoB,EAAE,QAAoB;IACnE,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACjC,CAAC;IAED,IAAI,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;QACtC,QAAQ,EAAE,CAAA;QACV,OAAM;IACR,CAAC;IAED,IAAI,MAAM,GAAG,KAAK,CAAA;IAElB,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,GAAG,EAAE;QACzC,IAAI,QAAQ,CAAC,aAAa,CAAC,SAAmB,CAAC,EAAE,CAAC;YAChD,QAAQ,CAAC,UAAU,EAAE,CAAA;YAErB,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,GAAG,IAAI,CAAA;gBACb,QAAQ,EAAE,CAAA;YACZ,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE;QACzB,UAAU,EAAE,IAAI;QAChB,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACd,CAAC,CAAA;AACJ,CAAC"}

package/dist/util/onRTEReady.d.ts

@@ -0,0 +1,22 @@
+interface RTEInstance {
+    ctx: HTMLTextAreaElement;
+    loaded: boolean;
+    view: {
+        dom: HTMLElement;
+    };
+}
+export interface OnRTEReadyOptions {
+    /** If true, auto-unsubscribe after first callback execution. Defaults to true. */
+    once?: boolean;
+}
+/**
+ * Execute callback when a specific RTE is fully loaded
+ * @param callback - Function called with RTE instance when ready
+ * @param target - Textarea element or selector for the specific RTE
+ * @param options - Optional configuration
+ * @param options.once - Auto-cleanup after first fire (default: true)
+ * @returns Cleanup function to unsubscribe
+ */
+export default function onRTEReady(callback: (rte: RTEInstance) => void, target: HTMLTextAreaElement | string, options?: OnRTEReadyOptions): () => void;
+export {};
+//# sourceMappingURL=onRTEReady.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onRTEReady.d.ts","sourceRoot":"","sources":["../../src/util/onRTEReady.ts"],"names":[],"mappings":"AAAA,UAAU,WAAW;IACnB,GAAG,EAAE,mBAAmB,CAAA;IACxB,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,EAAE;QACJ,GAAG,EAAE,WAAW,CAAA;KACjB,CAAA;CACF;AAMD,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAsCD;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,QAAQ,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,EACpC,MAAM,EAAE,mBAAmB,GAAG,MAAM,EACpC,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,IAAI,CAwCZ"}

package/dist/util/onRTEReady.js

@@ -0,0 +1,69 @@
+/**
+ * Check if a textarea has an RTE instance
+ */
+function hasRTE(textarea) {
+    return textarea !== null && 'rte' in textarea && typeof textarea.rte === 'object';
+}
+/**
+ * Execute the RTE ready callback with context
+ * @param rte - The RTE instance that has loaded
+ * @param context - Execution context containing callback, once flag, and state
+ */
+function executeCallback(rte, context) {
+    if (context.once && context.hasExecuted) {
+        return;
+    }
+    try {
+        context.callback(rte);
+        context.hasExecuted = true;
+        if (context.once && context.subscription) {
+            context.subscription.remove();
+            context.subscription = null;
+        }
+    }
+    catch (error) {
+        console.error('onRTEReady callback failed', error);
+    }
+}
+/**
+ * Execute callback when a specific RTE is fully loaded
+ * @param callback - Function called with RTE instance when ready
+ * @param target - Textarea element or selector for the specific RTE
+ * @param options - Optional configuration
+ * @param options.once - Auto-cleanup after first fire (default: true)
+ * @returns Cleanup function to unsubscribe
+ */
+export default function onRTEReady(callback, target, options) {
+    const { once = true } = options || {};
+    // Resolve target to textarea element
+    const targetTextarea = typeof target === 'string' ? document.querySelector(target) : target;
+    if (!(targetTextarea instanceof HTMLTextAreaElement)) {
+        return () => { }; // No-op
+    }
+    // Context shared by all executeCallback invocations
+    const context = {
+        callback,
+        once,
+        hasExecuted: false,
+        subscription: null,
+    };
+    // Already loaded?
+    if (hasRTE(targetTextarea) && targetTextarea.rte.loaded) {
+        executeCallback(targetTextarea.rte, context);
+        if (once) {
+            return () => { }; // Already executed, no cleanup needed
+        }
+    }
+    const pubSub = window.PubSub;
+    if (!pubSub || typeof pubSub.subscribe !== 'function') {
+        // PubSub not available: fail gracefully
+        return () => { };
+    }
+    context.subscription = pubSub.subscribe('rteLoaded', (rte) => {
+        if (rte.ctx === targetTextarea) {
+            executeCallback(rte, context);
+        }
+    });
+    return () => context.subscription?.remove();
+}
+//# sourceMappingURL=onRTEReady.js.map

package/dist/util/onRTEReady.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onRTEReady.js","sourceRoot":"","sources":["../../src/util/onRTEReady.ts"],"names":[],"mappings":"AAwBA;;GAEG;AACH,SAAS,MAAM,CAAC,QAAoC;IAClD,OAAO,QAAQ,KAAK,IAAI,IAAI,KAAK,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,GAAG,KAAK,QAAQ,CAAA;AACnF,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,GAAgB,EAAE,OAAuB;IAChE,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxC,OAAM;IACR,CAAC;IAED,IAAI,CAAC;QACH,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;QACrB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAA;QAC1B,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACzC,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,CAAA;YAC7B,OAAO,CAAC,YAAY,GAAG,IAAI,CAAA;QAC7B,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAA;IACpD,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,QAAoC,EACpC,MAAoC,EACpC,OAA2B;IAE3B,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,GAAG,OAAO,IAAI,EAAE,CAAA;IAErC,qCAAqC;IACrC,MAAM,cAAc,GAClB,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;IAEtE,IAAI,CAAC,CAAC,cAAc,YAAY,mBAAmB,CAAC,EAAE,CAAC;QACrD,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA,CAAC,QAAQ;IAC1B,CAAC;IAED,oDAAoD;IACpD,MAAM,OAAO,GAAmB;QAC9B,QAAQ;QACR,IAAI;QACJ,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,IAAI;KACnB,CAAA;IAED,kBAAkB;IAClB,IAAI,MAAM,CAAC,cAAc,CAAC,IAAI,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QACxD,eAAe,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAC5C,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA,CAAC,sCAAsC;QACxD,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAI,MAAc,CAAC,MAAM,CAAA;IACrC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QACtD,wCAAwC;QACxC,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;IACjB,CAAC;IAED,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,GAAgB,EAAE,EAAE;QACxE,IAAI,GAAG,CAAC,GAAG,KAAK,cAAc,EAAE,CAAC;YAC/B,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAC/B,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,CAAA;AAC7C,CAAC"}

package/dist/util/onRemove.d.ts

@@ -0,0 +1,7 @@
+declare function onRemove(element: Element, callback: () => void): void;
+declare namespace onRemove {
+    var pause: () => void;
+    var resume: () => void;
+}
+export default onRemove;
+//# sourceMappingURL=onRemove.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onRemove.d.ts","sourceRoot":"","sources":["../../src/util/onRemove.ts"],"names":[],"mappings":"AAGA,iBAAwB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,QAatE;kBAbuB,QAAQ;qBAgBX,IAAI;sBAKH,IAAI;;eArBF,QAAQ"}

package/dist/util/onRemove.js

@@ -0,0 +1,24 @@
+let triggerPaused = false;
+/* Triggers a callback when a DOM element is removed from the document. */
+export default function onRemove(element, callback) {
+    const observer = new MutationObserver(mutations => {
+        for (const mutation of mutations) {
+            for (const removedNode of mutation.removedNodes) {
+                if (removedNode.contains(element) && !triggerPaused) {
+                    observer.disconnect();
+                    callback();
+                }
+            }
+        }
+    });
+    observer.observe(document, { childList: true, subtree: true });
+}
+/* Globally pauses all callback invocations. */
+onRemove.pause = () => {
+    triggerPaused = true;
+};
+/* Globally resumes all callback invocations. */
+onRemove.resume = () => {
+    triggerPaused = false;
+};
+//# sourceMappingURL=onRemove.js.map

package/dist/util/onRemove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onRemove.js","sourceRoot":"","sources":["../../src/util/onRemove.ts"],"names":[],"mappings":"AAAA,IAAI,aAAa,GAAG,KAAK,CAAA;AAEzB,0EAA0E;AAC1E,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,OAAgB,EAAE,QAAoB;IACrE,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,SAAS,CAAC,EAAE;QAChD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,KAAK,MAAM,WAAW,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;gBAChD,IAAI,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;oBACpD,QAAQ,CAAC,UAAU,EAAE,CAAA;oBACrB,QAAQ,EAAE,CAAA;gBACZ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;AAChE,CAAC;AAED,+CAA+C;AAC/C,QAAQ,CAAC,KAAK,GAAG,GAAS,EAAE;IAC1B,aAAa,GAAG,IAAI,CAAA;AACtB,CAAC,CAAA;AAED,gDAAgD;AAChD,QAAQ,CAAC,MAAM,GAAG,GAAS,EAAE;IAC3B,aAAa,GAAG,KAAK,CAAA;AACvB,CAAC,CAAA"}