@brightspot/ui 5.5.0 → 5.6.0

package/dist/components/ai-sparkle/AiSparkle.d.ts

@@ -0,0 +1,66 @@
+import { LitElement } from 'lit';
+/** Size scale, mirroring `<btu-avatar>` / `<btu-esca-avatar>` (LESSONS-NAMING §1). */
+export type AiSparkleSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+declare const AiSparkle_base: (new (...args: any[]) => import("../../util/EventEmitterMixin.js").EventEmitterMixinInterface) & (new (...args: any[]) => import("../../util/ReadyMixin.js").ReadyMixinInterface) & typeof LitElement;
+/**
+ * The animated AI-branding sparkle. Drive it with the `playing` boolean: `true` loops the clip to
+ * draw the eye to an AI entry point, `false` freezes the full sparkle so it reads as a static brand
+ * mark once the surface it advertises is engaged. Reduced-motion users always get the frozen frame.
+ *
+ * Decorative by default (`aria-hidden="true"`, set only when absent) — the control it sits in owns
+ * the accessible name.
+ *
+ * @element btu-ai-sparkle
+ *
+ * @fires {CustomEvent} btu-ai-sparkle-ready - Fired after the first render
+ *
+ * @cssprop --ai-sparkle-size - Width and height of the sparkle; overrides the `size` attribute (default: 2.5rem)
+ *
+ * @example
+ * ```html
+ * <btu-ai-sparkle></btu-ai-sparkle>
+ * <btu-ai-sparkle size="lg"></btu-ai-sparkle>
+ * <btu-ai-sparkle playing style="--ai-sparkle-size: 20px"></btu-ai-sparkle>
+ * ```
+ */
+export default class AiSparkle extends AiSparkle_base {
+    /**
+     * Whether the sparkle animates; otherwise it holds the last (fully-formed) frame. Opt-in
+     * (default `false`) like `autoplay`: a boolean defaulting to `true` can't be cleared by attribute
+     * absence. The converter also treats `playing="false"` as paused (a plain `type: Boolean` would
+     * read any present value, even "false", as `true`).
+     * @attr
+     */
+    playing: boolean;
+    /**
+     * Size of the sparkle, mirroring `<btu-avatar>`'s scale. `--ai-sparkle-size` overrides it.
+     * @attr
+     */
+    size: AiSparkleSize;
+    private _containerRef;
+    private _animation;
+    private _loaded;
+    private _loadToken;
+    private _reduceMotion;
+    private _visible;
+    private _resizeObserver?;
+    private _intersectionObserver?;
+    private _motionQuery?;
+    createRenderRoot(): this;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    firstUpdated(changed: Map<PropertyKey, unknown>): void;
+    updated(changed: Map<PropertyKey, unknown>): void;
+    render(): import("lit-html").TemplateResult<1>;
+    private _applySize;
+    private _onMotionChange;
+    private _build;
+    private _sync;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'btu-ai-sparkle': AiSparkle;
+    }
+}
+export {};
+//# sourceMappingURL=AiSparkle.d.ts.map

package/dist/components/ai-sparkle/AiSparkle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiSparkle.d.ts","sourceRoot":"","sources":["../../../src/components/ai-sparkle/AiSparkle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAQ,MAAM,KAAK,CAAA;AAOtC,sFAAsF;AACtF,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;;AAmB5D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,cAAyC;IAC9E;;;;;;OAMG;IAQH,OAAO,UAAQ;IAEf;;;OAGG;IAEH,IAAI,EAAE,aAAa,CAAO;IAE1B,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAO;IACvB,OAAO,CAAC,eAAe,CAAC,CAAgB;IACxC,OAAO,CAAC,qBAAqB,CAAC,CAAsB;IACpD,OAAO,CAAC,YAAY,CAAC,CAAgB;IAErC,gBAAgB;IAIhB,iBAAiB;IAYjB,oBAAoB;IAapB,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC;IAqB/C,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC;IAM1C,MAAM;IAIN,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,eAAe,CAGtB;YAEa,MAAM;IA2BpB,OAAO,CAAC,KAAK;CAgBd;AAMD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,gBAAgB,EAAE,SAAS,CAAA;KAC5B;CACF"}

package/dist/components/ai-sparkle/AiSparkle.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 { LitElement, html } from 'lit';
+import { property } from 'lit/decorators.js';
+import { createRef, ref } from 'lit/directives/ref.js';
+import { EventEmitterMixin } from '../../util/EventEmitterMixin.js';
+import { ReadyMixin } from '../../util/ReadyMixin.js';
+// Load the animation data on demand so importing the component doesn't eagerly pull the clip.
+const loadData = () => import('./animations/ai-sparkle.json').then(m => m.default);
+// SVG renderer (not canvas like btu-esca-avatar): the sparkle is pure vector, so SVG stays crisp at
+// any size and clips the nested comp exactly — the canvas renderer leaves a faint 1px clip edge.
+let lottiePlayer;
+const loadLottie = () => (lottiePlayer ??= import('lottie-web/build/player/lottie_svg.js'));
+// Public size key → rendered box.
+const SIZE_REM = {
+    xs: '1.5rem',
+    sm: '2.25rem',
+    md: '2.5rem',
+    lg: '3rem',
+    xl: '3.5rem',
+};
+/**
+ * The animated AI-branding sparkle. Drive it with the `playing` boolean: `true` loops the clip to
+ * draw the eye to an AI entry point, `false` freezes the full sparkle so it reads as a static brand
+ * mark once the surface it advertises is engaged. Reduced-motion users always get the frozen frame.
+ *
+ * Decorative by default (`aria-hidden="true"`, set only when absent) — the control it sits in owns
+ * the accessible name.
+ *
+ * @element btu-ai-sparkle
+ *
+ * @fires {CustomEvent} btu-ai-sparkle-ready - Fired after the first render
+ *
+ * @cssprop --ai-sparkle-size - Width and height of the sparkle; overrides the `size` attribute (default: 2.5rem)
+ *
+ * @example
+ * ```html
+ * <btu-ai-sparkle></btu-ai-sparkle>
+ * <btu-ai-sparkle size="lg"></btu-ai-sparkle>
+ * <btu-ai-sparkle playing style="--ai-sparkle-size: 20px"></btu-ai-sparkle>
+ * ```
+ */
+export default class AiSparkle extends EventEmitterMixin(ReadyMixin(LitElement)) {
+    constructor() {
+        super(...arguments);
+        /**
+         * Whether the sparkle animates; otherwise it holds the last (fully-formed) frame. Opt-in
+         * (default `false`) like `autoplay`: a boolean defaulting to `true` can't be cleared by attribute
+         * absence. The converter also treats `playing="false"` as paused (a plain `type: Boolean` would
+         * read any present value, even "false", as `true`).
+         * @attr
+         */
+        this.playing = false;
+        /**
+         * Size of the sparkle, mirroring `<btu-avatar>`'s scale. `--ai-sparkle-size` overrides it.
+         * @attr
+         */
+        this.size = 'md';
+        this._containerRef = createRef();
+        this._animation = null;
+        this._loaded = false;
+        this._loadToken = 0;
+        this._reduceMotion = false;
+        this._visible = true;
+        this._onMotionChange = (event) => {
+            this._reduceMotion = event.matches;
+            this._sync();
+        };
+    }
+    createRenderRoot() {
+        return this;
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        if (!this.hasAttribute('aria-hidden'))
+            this.setAttribute('aria-hidden', 'true');
+        if (!this.style.display)
+            this.style.display = 'inline-block';
+        this._applySize();
+        this._motionQuery = window.matchMedia?.('(prefers-reduced-motion: reduce)');
+        this._reduceMotion = this._motionQuery?.matches ?? false;
+        this._motionQuery?.addEventListener('change', this._onMotionChange);
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        this._resizeObserver?.disconnect();
+        this._resizeObserver = undefined;
+        this._intersectionObserver?.disconnect();
+        this._intersectionObserver = undefined;
+        this._motionQuery?.removeEventListener('change', this._onMotionChange);
+        // Invalidate any in-flight _build() so it exits instead of creating a leaked, orphaned animation.
+        this._loadToken++;
+        this._animation?.destroy();
+        this._animation = null;
+    }
+    firstUpdated(changed) {
+        super.firstUpdated(changed);
+        // Keep the art fitted to the host box as it resizes.
+        this._resizeObserver = new ResizeObserver(() => this._animation?.resize());
+        this._resizeObserver.observe(this);
+        this._intersectionObserver = new IntersectionObserver(([entry]) => {
+            this._visible = entry.isIntersecting;
+            // Art sized while the host had no layout box (a hidden panel) renders blank; re-fit it once
+            // it's on-screen.
+            if (this._visible)
+                this._animation?.resize();
+            // Don't burn a rAF loop for a sparkle that's scrolled out of view.
+            this._sync();
+        });
+        this._intersectionObserver.observe(this);
+        void this._build();
+        this.emit('btu-ai-sparkle-ready');
+    }
+    updated(changed) {
+        super.updated(changed);
+        if (changed.has('playing'))
+            this._sync();
+        if (changed.has('size'))
+            this._applySize();
+    }
+    render() {
+        return html `<div ${ref(this._containerRef)} style="width: 100%; height: 100%"></div>`;
+    }
+    _applySize() {
+        const fallback = SIZE_REM[this.size] ?? SIZE_REM.md;
+        // `--ai-sparkle-size` still wins when a consumer sets it.
+        this.style.width = `var(--ai-sparkle-size, ${fallback})`;
+        this.style.height = `var(--ai-sparkle-size, ${fallback})`;
+    }
+    async _build() {
+        // The element can disconnect while the player and data load; a stale token means it did, so
+        // bail rather than create an animation nothing will ever destroy.
+        const token = ++this._loadToken;
+        const [{ default: lottie }, data] = await Promise.all([loadLottie(), loadData()]);
+        const container = this._containerRef.value;
+        if (token !== this._loadToken || !container || this._animation)
+            return;
+        const animation = lottie.loadAnimation({
+            container,
+            renderer: 'svg',
+            loop: true,
+            autoplay: false,
+            animationData: structuredClone(data),
+        });
+        // getDuration() and goToAndStop() need the data parsed; do the first sync only once loaded so a
+        // static sparkle freezes on its true last frame rather than frame 0.
+        animation.addEventListener('DOMLoaded', () => {
+            this._loaded = true;
+            animation.resize();
+            this._sync();
+        });
+        this._animation = animation;
+    }
+    _sync() {
+        const animation = this._animation;
+        if (!animation || !this._loaded)
+            return;
+        if (!this.playing || this._reduceMotion) {
+            const lastFrame = Math.max(0, animation.getDuration(true) - 1);
+            animation.goToAndStop(lastFrame, true);
+            return;
+        }
+        if (this._visible) {
+            animation.play();
+        }
+        else {
+            animation.pause();
+        }
+    }
+}
+__decorate([
+    property({
+        reflect: true,
+        converter: {
+            fromAttribute: value => value !== null && value !== 'false',
+            toAttribute: value => (value ? '' : null),
+        },
+    })
+], AiSparkle.prototype, "playing", void 0);
+__decorate([
+    property({ type: String, reflect: true })
+], AiSparkle.prototype, "size", void 0);
+if (!customElements.get('btu-ai-sparkle')) {
+    customElements.define('btu-ai-sparkle', AiSparkle);
+}
+//# sourceMappingURL=AiSparkle.js.map

package/dist/components/ai-sparkle/AiSparkle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiSparkle.js","sourceRoot":"","sources":["../../../src/components/ai-sparkle/AiSparkle.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,CAAA;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,GAAG,EAAY,MAAM,uBAAuB,CAAA;AAEhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAKrD,8FAA8F;AAC9F,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,8BAA8B,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;AAElF,oGAAoG;AACpG,iGAAiG;AACjG,IAAI,YAAyF,CAAA;AAC7F,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,CAAC,YAAY,KAAK,MAAM,CAAC,uCAAuC,CAAC,CAAC,CAAA;AAE3F,kCAAkC;AAClC,MAAM,QAAQ,GAAkC;IAC9C,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,SAAS;IACb,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,QAAQ;CACb,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,iBAAiB,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAAhF;;QACE;;;;;;WAMG;QAQH,YAAO,GAAG,KAAK,CAAA;QAEf;;;WAGG;QAEH,SAAI,GAAkB,IAAI,CAAA;QAElB,kBAAa,GAAwB,SAAS,EAAE,CAAA;QAChD,eAAU,GAAyB,IAAI,CAAA;QACvC,YAAO,GAAG,KAAK,CAAA;QACf,eAAU,GAAG,CAAC,CAAA;QACd,kBAAa,GAAG,KAAK,CAAA;QACrB,aAAQ,GAAG,IAAI,CAAA;QAwEf,oBAAe,GAAG,CAAC,KAA0B,EAAE,EAAE;YACvD,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC,OAAO,CAAA;YAClC,IAAI,CAAC,KAAK,EAAE,CAAA;QACd,CAAC,CAAA;IA6CH,CAAC;IAnHC,gBAAgB;QACd,OAAO,IAAI,CAAA;IACb,CAAC;IAED,iBAAiB;QACf,KAAK,CAAC,iBAAiB,EAAE,CAAA;QAEzB,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC;YAAE,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;QAC/E,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO;YAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,cAAc,CAAA;QAC5D,IAAI,CAAC,UAAU,EAAE,CAAA;QAEjB,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC,kCAAkC,CAAC,CAAA;QAC3E,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,YAAY,EAAE,OAAO,IAAI,KAAK,CAAA;QACxD,IAAI,CAAC,YAAY,EAAE,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,CAAA;IACrE,CAAC;IAED,oBAAoB;QAClB,KAAK,CAAC,oBAAoB,EAAE,CAAA;QAC5B,IAAI,CAAC,eAAe,EAAE,UAAU,EAAE,CAAA;QAClC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAA;QAChC,IAAI,CAAC,qBAAqB,EAAE,UAAU,EAAE,CAAA;QACxC,IAAI,CAAC,qBAAqB,GAAG,SAAS,CAAA;QACtC,IAAI,CAAC,YAAY,EAAE,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,CAAA;QACtE,kGAAkG;QAClG,IAAI,CAAC,UAAU,EAAE,CAAA;QACjB,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,CAAA;QAC1B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;IACxB,CAAC;IAED,YAAY,CAAC,OAAkC;QAC7C,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;QAE3B,qDAAqD;QACrD,IAAI,CAAC,eAAe,GAAG,IAAI,cAAc,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAAA;QAC1E,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAElC,IAAI,CAAC,qBAAqB,GAAG,IAAI,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE;YAChE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,cAAc,CAAA;YACpC,4FAA4F;YAC5F,kBAAkB;YAClB,IAAI,IAAI,CAAC,QAAQ;gBAAE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,CAAA;YAC5C,mEAAmE;YACnE,IAAI,CAAC,KAAK,EAAE,CAAA;QACd,CAAC,CAAC,CAAA;QACF,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAExC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAA;QAClB,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;IACnC,CAAC;IAED,OAAO,CAAC,OAAkC;QACxC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACtB,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,IAAI,CAAC,KAAK,EAAE,CAAA;QACxC,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,IAAI,CAAC,UAAU,EAAE,CAAA;IAC5C,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAA,QAAQ,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,2CAA2C,CAAA;IACvF,CAAC;IAEO,UAAU;QAChB,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,EAAE,CAAA;QACnD,0DAA0D;QAC1D,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,0BAA0B,QAAQ,GAAG,CAAA;QACxD,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,0BAA0B,QAAQ,GAAG,CAAA;IAC3D,CAAC;IAOO,KAAK,CAAC,MAAM;QAClB,4FAA4F;QAC5F,kEAAkE;QAClE,MAAM,KAAK,GAAG,EAAE,IAAI,CAAC,UAAU,CAAA;QAC/B,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAA;QACjF,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAA;QAC1C,IAAI,KAAK,KAAK,IAAI,CAAC,UAAU,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,UAAU;YAAE,OAAM;QAEtE,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC;YACrC,SAAS;YACT,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,IAAI;YACV,QAAQ,EAAE,KAAK;YACf,aAAa,EAAE,eAAe,CAAC,IAAI,CAAC;SACrC,CAAC,CAAA;QAEF,gGAAgG;QAChG,qEAAqE;QACrE,SAAS,CAAC,gBAAgB,CAAC,WAAW,EAAE,GAAG,EAAE;YAC3C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;YACnB,SAAS,CAAC,MAAM,EAAE,CAAA;YAClB,IAAI,CAAC,KAAK,EAAE,CAAA;QACd,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,UAAU,GAAG,SAAS,CAAA;IAC7B,CAAC;IAEO,KAAK;QACX,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAA;QACjC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAM;QAEvC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACxC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;YAC9D,SAAS,CAAC,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;YACtC,OAAM;QACR,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,SAAS,CAAC,IAAI,EAAE,CAAA;QAClB,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,KAAK,EAAE,CAAA;QACnB,CAAC;IACH,CAAC;CACF;AAtIC;IAPC,QAAQ,CAAC;QACR,OAAO,EAAE,IAAI;QACb,SAAS,EAAE;YACT,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,OAAO;YAC3D,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAC1C;KACF,CAAC;0CACa;AAOf;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;uCAChB;AAiI5B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC;IAC1C,cAAc,CAAC,MAAM,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAA;AACpD,CAAC"}

package/dist/components/ai-sparkle/animations/ai-sparkle.json

@@ -0,0 +1 @@
+{ "nm": "AI_sparkle-icon", "ddd": 0, "h": 400, "w": 400, "meta": { "g": "@lottiefiles/toolkit-js 0.71.10" }, "layers": [{ "ty": 0, "nm": "Pre-comp 1", "sr": 1, "st": 0, "op": 240, "ip": 0, "ln": "36", "hasMask": false, "ao": 0, "ks": { "a": { "a": 0, "k": [91, 88.5] }, "s": { "a": 0, "k": [100, 100] }, "p": { "a": 0, "k": [200, 200] }, "r": { "a": 0, "k": 0 }, "sa": { "a": 0, "k": 0 }, "o": { "a": 0, "k": 100 } }, "w": 182, "h": 177, "refId": "1", "tm": { "a": 1, "k": [{ "o": { "x": 0.167, "y": 0.167 }, "i": { "x": 0.833, "y": 0.833 }, "s": [0], "t": 0 }, { "o": { "x": 0.167, "y": 0.167 }, "i": { "x": 0.833, "y": 0.833 }, "s": [2.5], "t": 45 }, { "o": { "x": 0.167, "y": 0.167 }, "i": { "x": 0.833, "y": 0.833 }, "s": [0], "t": 89.999 }, { "s": [2.5], "t": 134.999 }] }, "ind": 1 }], "v": "5.7.0", "fr": 30, "op": 135, "ip": 0, "assets": [{ "nm": "Pre-comp 1", "id": "1", "fr": 30, "layers": [{ "ty": 4, "nm": "Shape Layer 1", "sr": 1, "st": 0, "op": 240, "ip": 0, "ln": "24", "tt": 1, "hasMask": false, "ao": 0, "ks": { "a": { "a": 0, "k": [0, 0] }, "s": { "a": 0, "k": [121.239, 135.053] }, "p": { "a": 0, "k": [91, 88.5] }, "r": { "a": 1, "k": [{ "o": { "x": 0.265, "y": 0 }, "i": { "x": 0.531, "y": 1 }, "s": [0], "t": 0 }, { "s": [360], "t": 74.999 }] }, "sa": { "a": 0, "k": 0 }, "o": { "a": 0, "k": 100 } }, "shapes": [{ "ty": "gr", "nm": "Rectangle 1", "it": [{ "ty": "rc", "nm": "Rectangle Path 1", "d": 1, "p": { "a": 0, "k": [0, 0] }, "r": { "a": 0, "k": 0 }, "s": { "a": 0, "k": [51.479, 182.207] } }, { "ty": "gf", "nm": "Gradient Fill 1", "e": { "a": 0, "k": [-0.316, -64.664] }, "g": { "p": 3, "k": { "a": 0, "k": [0, 0.92941183, 0.13725491, 0.14509805, 0.518, 0.964705915, 0.46274513999999994, 0.15294118500000004, 1, 1, 0.78823537, 0.16078432] } }, "t": 1, "a": { "a": 0, "k": 0 }, "h": { "a": 0, "k": 0 }, "s": { "a": 0, "k": [-0.641, 33.568] }, "r": 1, "o": { "a": 0, "k": 100 } }, { "ty": "tr", "a": { "a": 0, "k": [0, 0] }, "s": { "a": 0, "k": [402.719, 101.264] }, "p": { "a": 0, "k": [-5.774, -0.029] }, "r": { "a": 0, "k": 0 }, "sa": { "a": 0, "k": 0 }, "o": { "a": 0, "k": 100 } }] }], "ind": 1, "tp": 2 }, { "ty": 2, "nm": "Layer 1", "sr": 1, "st": 0, "op": 240, "ip": 0, "ln": "23", "hasMask": false, "td": 1, "ao": 0, "ks": { "a": { "a": 0, "k": [81.337, 81.672] }, "s": { "a": 0, "k": [100, 100] }, "p": { "a": 0, "k": [90.064, 87.517] }, "r": { "a": 0, "k": 0 }, "sa": { "a": 0, "k": 0 }, "o": { "a": 0, "k": 100 } }, "refId": "2", "ind": 2 }] }, { "id": "2", "e": 1, "w": 163, "h": 164, "p": "data:image/png;base64,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", "u": "" }] }

package/dist/custom-elements.json

@@ -876,6 +876,240 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-sparkle/AiSparkle.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "The animated AI-branding sparkle. Drive it with the `playing` boolean: `true` loops the clip to\ndraw the eye to an AI entry point, `false` freezes the full sparkle so it reads as a static brand\nmark once the surface it advertises is engaged. Reduced-motion users always get the frozen frame.\n\nDecorative by default (`aria-hidden=\"true\"`, set only when absent) — the control it sits in owns\nthe accessible name.",
+          "name": "AiSparkle",
+          "cssProperties": [
+            {
+              "description": "Width and height of the sparkle; overrides the `size` attribute (default: 2.5rem)",
+              "name": "--ai-sparkle-size"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "playing",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the sparkle animates; otherwise it holds the last (fully-formed) frame. Opt-in\n(default `false`) like `autoplay`: a boolean defaulting to `true` can't be cleared by attribute\nabsence. The converter also treats `playing=\"false\"` as paused (a plain `type: Boolean` would\nread any present value, even \"false\", as `true`).",
+              "attribute": "playing",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "AiSparkleSize"
+              },
+              "default": "'md'",
+              "description": "Size of the sparkle, mirroring `<btu-avatar>`'s scale. `--ai-sparkle-size` overrides it.",
+              "attribute": "size",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "_containerRef",
+              "type": {
+                "text": "Ref<HTMLDivElement>"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_animation",
+              "type": {
+                "text": "AnimationItem | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_loaded",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_loadToken",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            },
+            {
+              "kind": "field",
+              "name": "_reduceMotion",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_visible",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "true"
+            },
+            {
+              "kind": "field",
+              "name": "_resizeObserver",
+              "type": {
+                "text": "ResizeObserver | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_intersectionObserver",
+              "type": {
+                "text": "IntersectionObserver | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_motionQuery",
+              "type": {
+                "text": "MediaQueryList | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_applySize",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_onMotionChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_build",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_sync",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "emit",
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "K"
+                  },
+                  "description": "Event name from CustomEventMap"
+                },
+                {
+                  "name": "detail",
+                  "optional": true,
+                  "type": {
+                    "text": "UnpackCustomEvent<CustomEventMap[K]>"
+                  },
+                  "description": "Optional event detail payload"
+                }
+              ],
+              "description": "Dispatches a type-safe CustomEvent with standardized configuration.\n\nAll events are configured with:\n- bubbles: true (event propagates up the DOM tree)\n- cancelable: false (event cannot be cancelled)\n- composed: true (event crosses shadow DOM boundaries)",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "inheritedFrom": {
+                "name": "EventEmitterMixin",
+                "module": "src/util/EventEmitterMixin.ts"
+              }
+            }
+          ],
+          "events": [
+            {
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired after the first render",
+              "name": "btu-ai-sparkle-ready"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "playing",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the sparkle animates; otherwise it holds the last (fully-formed) frame. Opt-in\n(default `false`) like `autoplay`: a boolean defaulting to `true` can't be cleared by attribute\nabsence. The converter also treats `playing=\"false\"` as paused (a plain `type: Boolean` would\nread any present value, even \"false\", as `true`).",
+              "fieldName": "playing",
+              "attribute": "playing"
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "AiSparkleSize"
+              },
+              "default": "'md'",
+              "description": "Size of the sparkle, mirroring `<btu-avatar>`'s scale. `--ai-sparkle-size` overrides it.",
+              "fieldName": "size",
+              "attribute": "size"
+            }
+          ],
+          "mixins": [
+            {
+              "name": "EventEmitterMixin",
+              "module": "/src/util/EventEmitterMixin.js"
+            },
+            {
+              "name": "ReadyMixin",
+              "module": "/src/util/ReadyMixin.js"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "btu-ai-sparkle",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "AiSparkle",
+            "module": "src/components/ai-sparkle/AiSparkle.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "btu-ai-sparkle",
+          "declaration": {
+            "name": "AiSparkle",
+            "module": "src/components/ai-sparkle/AiSparkle.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/avatar/Avatar.ts",

package/dist/storybook/assets/{ActionBar.stories-BwKZ8jTT.js → ActionBar.stories-BcwPhWTp.js}

@@ -1,4 +1,4 @@
-import{g as p,x as e}from"./iframe-Dvs8mbFG.js";import{o as u}from"./style-map-K0t_tOsq.js";import"./preload-helper-PPVm8Dsz.js";const{events:y,args:v,argTypes:a}=p("btu-action-bar"),x={title:"Components/Action Bar",component:"btu-action-bar",tags:["autodocs"],parameters:{docs:{subtitle:"A persistent container for primary, secondary, tertiary, and destructive actions",description:{component:`
+import{g as p,x as e}from"./iframe-BsOwdi_g.js";import{o as u}from"./style-map-cpVeTpyC.js";import"./preload-helper-PPVm8Dsz.js";const{events:y,args:v,argTypes:a}=p("btu-action-bar"),x={title:"Components/Action Bar",component:"btu-action-bar",tags:["autodocs"],parameters:{docs:{subtitle:"A persistent container for primary, secondary, tertiary, and destructive actions",description:{component:`
 ActionBar provides a horizontal bar for grouping action buttons, typically anchored to the bottom of a view.
 
 <h3>Two-Zone Layout:</h3>

package/dist/storybook/assets/{ActionItem.stories-Df3verWG.js → ActionItem.stories-By6op0BA.js}

@@ -1,4 +1,4 @@
-import{g as d,x as a}from"./iframe-Dvs8mbFG.js";import{o as b}from"./style-map-K0t_tOsq.js";import"./preload-helper-PPVm8Dsz.js";const{events:m,args:u,argTypes:e}=d("btu-action-item"),g={title:"Components/Action Bar/Action Item",component:"btu-action-item",tags:["autodocs"],parameters:{docs:{subtitle:"A button element for use within an ActionBar",description:{component:`
+import{g as d,x as a}from"./iframe-BsOwdi_g.js";import{o as b}from"./style-map-cpVeTpyC.js";import"./preload-helper-PPVm8Dsz.js";const{events:m,args:u,argTypes:e}=d("btu-action-item"),g={title:"Components/Action Bar/Action Item",component:"btu-action-item",tags:["autodocs"],parameters:{docs:{subtitle:"A button element for use within an ActionBar",description:{component:`
 ActionItem renders a styled button using existing \`btu-button-*\` classes. It supports four visual variants — primary, secondary, tertiary, and destructive — along with optional icons, icon-only mode, loading state, and disabled state.
 
 <h3>Standalone vs. Inside ActionBar:</h3>

package/dist/storybook/assets/AiSparkle.stories-C6pbkiaj.js

@@ -0,0 +1,72 @@
+import{g as l,x as t}from"./iframe-BsOwdi_g.js";import{o as p}from"./style-map-cpVeTpyC.js";import"./preload-helper-PPVm8Dsz.js";const{events:c,args:d,argTypes:i}=l("btu-ai-sparkle"),n=["xs","sm","md","lg","xl"],g={title:"Components/AI/Sparkle",component:"btu-ai-sparkle",tags:["autodocs"],parameters:{docs:{subtitle:"The animated AI-branding sparkle",description:{component:`
+<h3>When to use:</h3>
+<ul>
+  <li>On the control that opens an AI surface (e.g. the button that opens the Esca assistant), to draw the eye to it</li>
+</ul>
+
+<p>Drive it with the <code>playing</code> boolean: <code>true</code> loops the clip while the AI surface is closed; set it <code>false</code> once the surface is open so it holds a static frame and stops competing for attention. Reduced-motion users always get the frozen frame.</p>
+
+<h3>Accessibility:</h3>
+<ul>
+  <li>Decorative by default (<code>aria-hidden="true"</code>, set only when absent) — the control it sits in owns the accessible name.</li>
+</ul>
+        `}},actions:{handles:c},controls:{expanded:!0}},args:{...d,playing:!0,size:"md"},argTypes:{...i,"--ai-sparkle-size":{table:{disable:!0}},playing:{...i.playing,control:{type:"boolean"},description:"Whether the sparkle animates. `false` (default) holds the last (fully-formed) frame.",table:{category:"Attributes",defaultValue:{summary:"false"}}},size:{...i.size,control:{type:"select"},options:n,description:"Sparkle size scale (mirrors btu-avatar). Overridden by `--ai-sparkle-size`.",table:{category:"Attributes",defaultValue:{summary:"md"}}},customSize:{name:"--ai-sparkle-size",control:{type:"text"},description:'Width/height override (e.g. "20px"). Beats the `size` attribute; default box is 2.5rem (md).',table:{category:"css properties"}}},render:e=>{const o={};return e.customSize&&(o["--ai-sparkle-size"]=e.customSize),t`<btu-ai-sparkle
+      ?playing=${e.playing}
+      size="${e.size}"
+      style=${p(o)}
+    ></btu-ai-sparkle>`}},s={args:{},parameters:{docs:{description:{story:"Toggle `playing` to switch between the looping animation and the static frame, and resize with `size`."}}}},a={render:()=>t`<div class="flex flex-row items-start gap-8">
+      ${[!0,!1].map(e=>t`
+          <div class="flex flex-col items-center gap-2">
+            <btu-ai-sparkle ?playing=${e} size="xl"></btu-ai-sparkle>
+            <span class="text-xs font-medium text-gray-700">${e?"playing":"static"}</span>
+          </div>
+        `)}
+    </div>`,parameters:{docs:{description:{story:'The looping state (left) next to the frozen frame (right) that `playing="false"` holds.'}}}},r={render:()=>t`<div class="flex flex-row items-center gap-6">
+      ${n.map(e=>t`
+          <div class="flex flex-col items-center gap-2">
+            <btu-ai-sparkle size="${e}"></btu-ai-sparkle>
+            <span class="text-xs text-gray-600">${e}</span>
+          </div>
+        `)}
+    </div>`,parameters:{docs:{description:{story:"The `size` scale (`xs`–`xl`), mirroring `<btu-avatar>`. For an arbitrary size, override with the `--ai-sparkle-size` custom property."}}}};s.parameters={...s.parameters,docs:{...s.parameters?.docs,source:{originalSource:`{
+  args: {},
+  parameters: {
+    docs: {
+      description: {
+        story: 'Toggle \`playing\` to switch between the looping animation and the static frame, and resize with \`size\`.'
+      }
+    }
+  }
+}`,...s.parameters?.docs?.source}}};a.parameters={...a.parameters,docs:{...a.parameters?.docs,source:{originalSource:`{
+  render: () => html\`<div class="flex flex-row items-start gap-8">
+      \${([true, false] as const).map(playing => html\`
+          <div class="flex flex-col items-center gap-2">
+            <btu-ai-sparkle ?playing=\${playing} size="xl"></btu-ai-sparkle>
+            <span class="text-xs font-medium text-gray-700">\${playing ? 'playing' : 'static'}</span>
+          </div>
+        \`)}
+    </div>\`,
+  parameters: {
+    docs: {
+      description: {
+        story: 'The looping state (left) next to the frozen frame (right) that \`playing="false"\` holds.'
+      }
+    }
+  }
+}`,...a.parameters?.docs?.source}}};r.parameters={...r.parameters,docs:{...r.parameters?.docs,source:{originalSource:`{
+  render: () => html\`<div class="flex flex-row items-center gap-6">
+      \${sizeOptions.map(size => html\`
+          <div class="flex flex-col items-center gap-2">
+            <btu-ai-sparkle size="\${size}"></btu-ai-sparkle>
+            <span class="text-xs text-gray-600">\${size}</span>
+          </div>
+        \`)}
+    </div>\`,
+  parameters: {
+    docs: {
+      description: {
+        story: 'The \`size\` scale (\`xs\`–\`xl\`), mirroring \`<btu-avatar>\`. For an arbitrary size, override with the \`--ai-sparkle-size\` custom property.'
+      }
+    }
+  }
+}`,...r.parameters?.docs?.source}}};const f=["Default","PlayingVsStatic","Sizes"];export{s as Default,a as PlayingVsStatic,r as Sizes,f as __namedExportsOrder,g as default};