@aceshooting/lyra-ui 1.1.0 → 2.0.0

package/dist/components/chip/chip.js

@@ -0,0 +1,115 @@
+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 { html, nothing } from 'lit';
+import { property, state } from 'lit/decorators.js';
+import { LyraElement } from '../../internal/lyra-element.js';
+import { defineElement } from '../../internal/prefix.js';
+import { closeIcon } from '../../internal/icons.js';
+import { styles } from './chip.styles.js';
+/**
+ * `<lyra-chip>` — a small, content-agnostic pill for a short label: a tag, an
+ * active-filter/scope indicator, etc. Distinct from `<lyra-attachment-chip>`
+ * (specifically file-shaped, with a thumbnail/size/upload-progress) — this
+ * one carries no domain assumptions at all, just a label and an optional
+ * leading icon/dot.
+ *
+ * `tone` tints the whole pill using the same loud-color-on-quiet-tint
+ * convention `<lyra-tool-call-chip>`/`<lyra-citation-badge>` already
+ * establish for status coloring: background is the tone's `-quiet` tint,
+ * text/icon is the tone's loud color. `neutral` (the default) has no
+ * dedicated token pair of its own, so it falls back to a plain
+ * bordered-surface look — the same "no signal" treatment
+ * `<lyra-citation-badge>`'s `default` status and `<lyra-tool-call-chip>`'s
+ * `pending` status already use.
+ *
+ * This is a controlled component: clicking the remove (×) button only fires
+ * `lyra-remove` — the chip never removes itself from the DOM on its own
+ * interaction, the same contract `<lyra-attachment-chip>`/
+ * `<lyra-conversation-item>` already follow. A consumer owns the underlying
+ * list and decides whether/how the click actually removes anything.
+ *
+ * @customElement lyra-chip
+ * @slot - The chip's label content.
+ * @slot icon - Optional leading icon or status dot. Nothing is reserved for
+ * it (no extra gap) when left empty.
+ * @event lyra-remove - The remove (×) button was activated (click, or
+ * Enter/Space while focused — native `<button>` behavior). `detail: { value }`
+ * — `value` is `undefined` when the `value` prop was never set. Only
+ * rendered while `removable`.
+ * @csspart base - The pill's root container.
+ * @csspart icon - Wrapper around the `icon` slot. Hidden entirely while empty.
+ * @csspart label - Wrapper around the default slot.
+ * @csspart remove-button - The remove (×) affordance, only rendered while `removable`.
+ */
+export class LyraChip extends LyraElement {
+    constructor() {
+        super(...arguments);
+        /** Status/emphasis color. `neutral` (the default) reads as plain/unstyled. */
+        this.tone = 'neutral';
+        /** Shows the remove (×) button. */
+        this.removable = false;
+        // A `[part]` always contains a literal `<slot>` child regardless of
+        // assigned content, so `:empty` never matches — real emptiness is tracked
+        // in JS instead, the same fix `<lyra-stat>`'s `hasIcon`/
+        // `<lyra-tool-call-chip>`'s `hasDetailSlot` etc. already establish.
+        this.hasIconSlot = false;
+        this.onIconSlotChange = (e) => {
+            this.hasIconSlot = e.target.assignedElements({ flatten: true }).length > 0;
+        };
+        this.onRemoveClick = () => {
+            this.emit('lyra-remove', { value: this.value });
+        };
+    }
+    static { this.styles = [LyraElement.styles, styles]; }
+    willUpdate() {
+        if (!this.hasUpdated) {
+            this.hasIconSlot = Array.from(this.children).some((el) => el.getAttribute('slot') === 'icon');
+        }
+    }
+    // Only the default slot's own content counts toward the remove button's
+    // accessible name — text incidentally living inside the (decorative)
+    // `icon` slot shouldn't leak into "Remove {text}".
+    get labelText() {
+        return Array.from(this.childNodes)
+            .filter((n) => !(n instanceof Element && n.getAttribute('slot') === 'icon'))
+            .map((n) => n.textContent ?? '')
+            .join('')
+            .trim();
+    }
+    get accessibleRemoveLabel() {
+        const text = this.labelText;
+        return text ? `Remove ${text}` : 'Remove';
+    }
+    render() {
+        return html `
+      <span part="base">
+        <span part="icon" aria-hidden="true" ?hidden=${!this.hasIconSlot}>
+          <slot name="icon" @slotchange=${this.onIconSlotChange}></slot>
+        </span>
+        <span part="label"><slot></slot></span>
+        ${this.removable
+            ? html `<button part="remove-button" type="button" aria-label=${this.accessibleRemoveLabel} @click=${this.onRemoveClick}>
+              ${closeIcon()}
+            </button>`
+            : nothing}
+      </span>
+    `;
+    }
+}
+__decorate([
+    property({ reflect: true })
+], LyraChip.prototype, "tone", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], LyraChip.prototype, "removable", void 0);
+__decorate([
+    property()
+], LyraChip.prototype, "value", void 0);
+__decorate([
+    state()
+], LyraChip.prototype, "hasIconSlot", void 0);
+defineElement('chip', LyraChip);

package/dist/components/chip/chip.styles.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/dist/components/chip/chip.styles.js

@@ -0,0 +1,115 @@
+import { css } from 'lit';
+export const styles = css `
+  :host {
+    display: inline-flex;
+    max-inline-size: 100%;
+    vertical-align: middle;
+    /* One custom-property trio swapped by the :host([tone]) rules below,
+       rather than repeating background/color/border per part per tone —
+       mirrors lyra-tool-call-chip's/lyra-attachment-chip's identical
+       -accent/-bg/-border trio so a chip's tone vocabulary reads the same
+       everywhere in the library. 'neutral' has no dedicated token pair (see
+       the class doc), so it falls back to plain surface/border/text instead
+       of inventing a sixth tint. */
+    --lyra-chip-accent: var(--lyra-color-text);
+    --lyra-chip-bg: var(--lyra-color-surface);
+    --lyra-chip-border: var(--lyra-color-border);
+  }
+
+  :host([tone='brand']) {
+    --lyra-chip-accent: var(--lyra-color-brand);
+    --lyra-chip-bg: var(--lyra-color-brand-quiet);
+    --lyra-chip-border: transparent;
+  }
+  :host([tone='success']) {
+    --lyra-chip-accent: var(--lyra-color-success);
+    --lyra-chip-bg: var(--lyra-color-success-quiet);
+    --lyra-chip-border: transparent;
+  }
+  :host([tone='warning']) {
+    --lyra-chip-accent: var(--lyra-color-warning);
+    --lyra-chip-bg: var(--lyra-color-warning-quiet);
+    --lyra-chip-border: transparent;
+  }
+  :host([tone='danger']) {
+    --lyra-chip-accent: var(--lyra-color-danger);
+    --lyra-chip-bg: var(--lyra-color-danger-quiet);
+    --lyra-chip-border: transparent;
+  }
+
+  [part='base'] {
+    display: inline-flex;
+    align-items: center;
+    gap: var(--lyra-space-xs);
+    max-inline-size: 100%;
+    box-sizing: border-box;
+    padding: 0.25rem var(--lyra-space-s);
+    border: 1px solid var(--lyra-chip-border);
+    border-radius: 999px;
+    background: var(--lyra-chip-bg);
+    color: var(--lyra-chip-accent);
+    font: inherit;
+    font-size: 0.8125rem;
+    font-weight: 500;
+    line-height: 1.3;
+  }
+
+  [part='icon'] {
+    display: inline-flex;
+    flex: 0 0 auto;
+    align-items: center;
+    justify-content: center;
+  }
+  [part='icon'] ::slotted(*) {
+    display: block;
+  }
+  /* Defeats [part='icon']'s own 'display: inline-flex' above -- the native
+     [hidden] UA rule alone would lose to it at equal specificity. Same fix
+     lyra-stat's identical [part='icon'][hidden] override already applies. */
+  [part='icon'][hidden] {
+    display: none;
+  }
+
+  [part='label'] {
+    flex: 1 1 auto;
+    min-inline-size: 0;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+
+  [part='remove-button'] {
+    flex: 0 0 auto;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    min-inline-size: min(var(--lyra-icon-button-size), 1.25rem);
+    min-block-size: min(var(--lyra-icon-button-size), 1.25rem);
+    margin-inline-end: -0.15rem;
+    padding: 0;
+    border: none;
+    border-radius: 999px;
+    background: transparent;
+    color: inherit;
+    font-size: 0.75em;
+    cursor: pointer;
+    -webkit-tap-highlight-color: transparent;
+    transition: background-color var(--lyra-transition-fast);
+  }
+  [part='remove-button']:hover {
+    background: color-mix(in srgb, currentColor 16%, transparent);
+  }
+  [part='remove-button']:focus-visible {
+    outline: var(--lyra-focus-ring-width) solid var(--lyra-focus-ring-color);
+    outline-offset: var(--lyra-focus-ring-offset);
+  }
+  [part='remove-button'] svg {
+    display: block;
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    [part='remove-button'] {
+      transition: none !important;
+    }
+  }
+`;

package/dist/components/citation-badge/citation-badge.d.ts

@@ -0,0 +1,113 @@
+import { type TemplateResult, type PropertyValues } from 'lit';
+import { LyraElement } from '../../internal/lyra-element.js';
+export type CitationBadgeStatus = 'default' | 'high' | 'medium' | 'low' | 'verified' | 'unverified';
+export interface CitationActivateDetail {
+    sourceId: string;
+    index: number;
+}
+export interface CitationOpenDetail {
+    sourceId: string;
+    index: number;
+    href?: string;
+}
+/**
+ * `<lyra-citation-badge>` — an inline `[n]` citation marker with a hover/
+ * focus preview popover and confidence/verification-status coloring. Used
+ * for an agent response's inline citations, each carrying a `source-id`
+ * that matches a corresponding `<lyra-source-card>` shown elsewhere on the
+ * page (a sibling component in this same family — this component doesn't
+ * import or know anything about it, only carries the id through its
+ * events).
+ *
+ * The default slot is *not* the badge's visible content — the badge always
+ * renders `[index]` — it's reserved for optional rich preview content (e.g.
+ * a filename + short excerpt) shown in a floating popover on hover/focus,
+ * positioned with `internal/positioner.js`'s `place()` the same way
+ * `<lyra-tool-call-chip>` positions its own detail tooltip. No popover shows
+ * at all when the slot carries no content, and the popover never traps
+ * focus — it's supplementary preview content, not a modal, so Tab continues
+ * past the badge normally even while it happens to be visible from a mouse
+ * hover.
+ *
+ * Two distinct signals fire from the same badge: `lyra-citation-activate`
+ * (click, or Enter while focused — native `<button>` behavior, no listener
+ * needed for the Enter case) is the lightweight "jump to this source"
+ * signal a host wires to scrolling/highlighting the matching
+ * `<lyra-source-card>`. `lyra-citation-open` (dblclick, or Space while
+ * focused) is a distinct "full preview" signal — `href` in its detail is
+ * `undefined` when the `href` prop isn't set; the consumer decides what
+ * "open" means (a new tab, a dialog, etc). A double-click still fires two
+ * `lyra-citation-activate` events (one per constituent click — standard
+ * browser `dblclick` behavior) in addition to the one `lyra-citation-open`;
+ * a consumer that only cares about the richer signal on a double-click
+ * should ignore the paired activate events in that case.
+ *
+ * Status coloring: `verified`/`high` use the success tones (a claim that's
+ * been checked out, or the model is confident in). `medium`/`low` use
+ * warning (progressively less certain, but still a real citation).
+ * `unverified` uses danger — deliberately distinct from `low`: "hasn't been
+ * checked at all" is a different (arguably riskier) claim than "checked but
+ * uncertain". `default` renders as plain neutral text with no background
+ * tint, for citations that carry no confidence/verification signal at all.
+ *
+ * @customElement lyra-citation-badge
+ * @slot - Rich preview/tooltip content (e.g. a filename + excerpt), shown in
+ * a floating popover on hover/focus. Nothing renders (no hover affordance at
+ * all) when this slot is empty.
+ * @event lyra-citation-activate - The badge was activated (click, or Enter
+ * while focused). `detail: { sourceId, index }`.
+ * @event lyra-citation-open - The badge's "full preview" affordance was
+ * triggered (dblclick, or Space while focused).
+ * `detail: { sourceId, index, href }`.
+ * @csspart base - The clickable badge (`<button>`).
+ * @csspart bracket - Each of the two literal `[`/`]` glyphs.
+ * @csspart index - The citation number.
+ * @csspart popover - The floating preview panel (only meaningful while open).
+ */
+export declare class LyraCitationBadge extends LyraElement {
+    static styles: import("lit").CSSResultGroup[];
+    /** The citation number shown, e.g. `3` renders as `[3]`. */
+    index: number;
+    /** Confidence/verification state — drives the badge's color and (unless
+     *  `label` is set) part of its accessible name. */
+    status: CitationBadgeStatus;
+    /** Id of a corresponding `<lyra-source-card>` elsewhere on the page —
+     *  echoed back verbatim in both events, never read or validated here. */
+    sourceId: string;
+    /** Optional direct link target for the citation's source. Carried into
+     *  `lyra-citation-open`'s detail as-is; this component never navigates. */
+    href: string;
+    /** Overrides the computed accessible name (`"Citation {index}[, {status}]"`). */
+    label: string;
+    private hasPreviewSlot;
+    private popoverOpen;
+    private buttonEl?;
+    private popoverEl?;
+    private readonly popoverId;
+    private cleanupPositioner?;
+    private hideTimer?;
+    private hovering;
+    private focused;
+    protected willUpdate(): void;
+    protected updated(changed: PropertyValues): void;
+    disconnectedCallback(): void;
+    private get accessibleLabel();
+    private onSlotChange;
+    private showPreview;
+    private scheduleHidePreview;
+    private hidePreviewNow;
+    private onPointerEnter;
+    private onPointerLeave;
+    private onFocusIn;
+    private onFocusOut;
+    private onKeyDown;
+    private onClick;
+    private onDblClick;
+    private emitOpen;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lyra-citation-badge': LyraCitationBadge;
+    }
+}

package/dist/components/citation-badge/citation-badge.js

@@ -0,0 +1,300 @@
+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 { html, nothing } from 'lit';
+import { property, state, query } from 'lit/decorators.js';
+import { LyraElement } from '../../internal/lyra-element.js';
+import { defineElement } from '../../internal/prefix.js';
+import { place } from '../../internal/positioner.js';
+import { nextId } from '../../internal/a11y.js';
+import { styles } from './citation-badge.styles.js';
+/** Visible (not just color-coded) status word, folded into the computed
+ *  accessible name — `''` for `default` omits the status clause entirely
+ *  rather than announcing a meaningless "Citation 3, Default". */
+const STATUS_LABEL = {
+    default: '',
+    high: 'High confidence',
+    medium: 'Medium confidence',
+    low: 'Low confidence',
+    verified: 'Verified',
+    unverified: 'Unverified',
+};
+// A short grace period before the popover actually hides on pointer-leave/
+// focus-out, so moving the mouse from the badge into the popover itself (to
+// select/copy its text) doesn't make it vanish mid-move. Cancelled outright
+// if hover or focus returns before it fires. No delay on Escape or explicit
+// keyboard blur — those are intentional dismissals, not transient pointer
+// travel, so they close immediately.
+const HIDE_DELAY_MS = 200;
+/**
+ * `<lyra-citation-badge>` — an inline `[n]` citation marker with a hover/
+ * focus preview popover and confidence/verification-status coloring. Used
+ * for an agent response's inline citations, each carrying a `source-id`
+ * that matches a corresponding `<lyra-source-card>` shown elsewhere on the
+ * page (a sibling component in this same family — this component doesn't
+ * import or know anything about it, only carries the id through its
+ * events).
+ *
+ * The default slot is *not* the badge's visible content — the badge always
+ * renders `[index]` — it's reserved for optional rich preview content (e.g.
+ * a filename + short excerpt) shown in a floating popover on hover/focus,
+ * positioned with `internal/positioner.js`'s `place()` the same way
+ * `<lyra-tool-call-chip>` positions its own detail tooltip. No popover shows
+ * at all when the slot carries no content, and the popover never traps
+ * focus — it's supplementary preview content, not a modal, so Tab continues
+ * past the badge normally even while it happens to be visible from a mouse
+ * hover.
+ *
+ * Two distinct signals fire from the same badge: `lyra-citation-activate`
+ * (click, or Enter while focused — native `<button>` behavior, no listener
+ * needed for the Enter case) is the lightweight "jump to this source"
+ * signal a host wires to scrolling/highlighting the matching
+ * `<lyra-source-card>`. `lyra-citation-open` (dblclick, or Space while
+ * focused) is a distinct "full preview" signal — `href` in its detail is
+ * `undefined` when the `href` prop isn't set; the consumer decides what
+ * "open" means (a new tab, a dialog, etc). A double-click still fires two
+ * `lyra-citation-activate` events (one per constituent click — standard
+ * browser `dblclick` behavior) in addition to the one `lyra-citation-open`;
+ * a consumer that only cares about the richer signal on a double-click
+ * should ignore the paired activate events in that case.
+ *
+ * Status coloring: `verified`/`high` use the success tones (a claim that's
+ * been checked out, or the model is confident in). `medium`/`low` use
+ * warning (progressively less certain, but still a real citation).
+ * `unverified` uses danger — deliberately distinct from `low`: "hasn't been
+ * checked at all" is a different (arguably riskier) claim than "checked but
+ * uncertain". `default` renders as plain neutral text with no background
+ * tint, for citations that carry no confidence/verification signal at all.
+ *
+ * @customElement lyra-citation-badge
+ * @slot - Rich preview/tooltip content (e.g. a filename + excerpt), shown in
+ * a floating popover on hover/focus. Nothing renders (no hover affordance at
+ * all) when this slot is empty.
+ * @event lyra-citation-activate - The badge was activated (click, or Enter
+ * while focused). `detail: { sourceId, index }`.
+ * @event lyra-citation-open - The badge's "full preview" affordance was
+ * triggered (dblclick, or Space while focused).
+ * `detail: { sourceId, index, href }`.
+ * @csspart base - The clickable badge (`<button>`).
+ * @csspart bracket - Each of the two literal `[`/`]` glyphs.
+ * @csspart index - The citation number.
+ * @csspart popover - The floating preview panel (only meaningful while open).
+ */
+export class LyraCitationBadge extends LyraElement {
+    constructor() {
+        super(...arguments);
+        /** The citation number shown, e.g. `3` renders as `[3]`. */
+        this.index = 1;
+        /** Confidence/verification state — drives the badge's color and (unless
+         *  `label` is set) part of its accessible name. */
+        this.status = 'default';
+        /** Id of a corresponding `<lyra-source-card>` elsewhere on the page —
+         *  echoed back verbatim in both events, never read or validated here. */
+        this.sourceId = '';
+        /** Optional direct link target for the citation's source. Carried into
+         *  `lyra-citation-open`'s detail as-is; this component never navigates. */
+        this.href = '';
+        /** Overrides the computed accessible name (`"Citation {index}[, {status}]"`). */
+        this.label = '';
+        // A `[part]` always contains a literal `<slot>` child regardless of
+        // assigned content, so `:empty` never matches — real emptiness is tracked
+        // in JS instead, same fix lyra-tool-call-chip's hasDetailSlot/lyra-stat's
+        // hasIcon etc. already establish.
+        this.hasPreviewSlot = false;
+        this.popoverOpen = false;
+        this.popoverId = nextId('citation-badge-popover');
+        // Hover and focus are tracked as independent "keep it open" reasons —
+        // mirrors lyra-toast-item's identical hovering/focused pair — so releasing
+        // one (e.g. the pointer leaving while the badge still has keyboard focus)
+        // doesn't schedule a hide the other modality is still holding open.
+        this.hovering = false;
+        this.focused = false;
+        this.onSlotChange = (e) => {
+            this.hasPreviewSlot = e.target.assignedElements({ flatten: true }).length > 0;
+            // The slot can be emptied out from under an already-open popover (e.g. a
+            // consumer clearing preview content asynchronously) — nothing left to
+            // show, so don't leave an empty panel floating open.
+            if (!this.hasPreviewSlot)
+                this.hidePreviewNow();
+        };
+        // Attached to the wrapper (not the button alone) so the popover's own
+        // slotted content counts too — pointerenter/pointerleave/focusin/focusout
+        // fire relative to whichever element they're bound to, not per descendant,
+        // so moving the pointer or focus between the button and the popover panel
+        // within this same wrapper never toggles hovering/focused off and on.
+        this.onPointerEnter = () => {
+            this.hovering = true;
+            this.showPreview();
+        };
+        this.onPointerLeave = () => {
+            this.hovering = false;
+            this.scheduleHidePreview();
+        };
+        this.onFocusIn = () => {
+            this.focused = true;
+            this.showPreview();
+        };
+        // No grace period here, unlike onPointerLeave -- a blur (Tab/Shift+Tab
+        // away, or focus programmatically moved elsewhere) is a deliberate
+        // navigation, not the transient pointer travel the delay exists to survive,
+        // so it closes at once. Still deferred to hover if the pointer happens to
+        // be resting on the badge/popover at the same time.
+        this.onFocusOut = () => {
+            this.focused = false;
+            if (this.hovering)
+                return;
+            this.hidePreviewNow();
+        };
+        // keydown bubbles up from whatever actually holds focus (the button, or a
+        // focusable element inside slotted preview content) — attaching this at
+        // the wrapper, rather than the button alone, is what makes Escape work
+        // "while the popover has focus-within" per the component's contract,
+        // without needing to track focus targets explicitly here.
+        this.onKeyDown = (e) => {
+            if (e.key === 'Escape' && this.popoverOpen) {
+                // Swallow it here rather than letting it bubble to e.g. a containing
+                // lyra-dialog's own Escape-to-close handler — dismissing this
+                // lightweight preview shouldn't also close a surrounding modal.
+                e.stopPropagation();
+                this.hidePreviewNow();
+                return;
+            }
+            // Space normally activates a <button> the same as Enter, but this
+            // component gives the two keys distinct meanings (Enter = activate,
+            // Space = open) — so Space's native click-on-keyup must be pre-empted
+            // here (preventDefault on keydown suppresses it) rather than left to
+            // fire alongside this. Enter deliberately gets no such handling: its
+            // native immediate click already reaches onClick below.
+            if (e.key === ' ' && !e.repeat && e.target === this.buttonEl) {
+                e.preventDefault();
+                this.emitOpen();
+            }
+        };
+        this.onClick = () => {
+            this.emit('lyra-citation-activate', { sourceId: this.sourceId, index: this.index });
+        };
+        this.onDblClick = () => {
+            this.emitOpen();
+        };
+    }
+    static { this.styles = [LyraElement.styles, styles]; }
+    willUpdate() {
+        if (!this.hasUpdated) {
+            this.hasPreviewSlot = Array.from(this.children).some((el) => !el.hasAttribute('slot'));
+        }
+    }
+    updated(changed) {
+        if (changed.has('popoverOpen')) {
+            this.cleanupPositioner?.();
+            this.cleanupPositioner = undefined;
+            if (this.popoverOpen && this.buttonEl && this.popoverEl) {
+                this.cleanupPositioner = place(this.buttonEl, this.popoverEl, { placement: 'top-start' });
+            }
+        }
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        this.cleanupPositioner?.();
+        clearTimeout(this.hideTimer);
+    }
+    get accessibleLabel() {
+        if (this.label)
+            return this.label;
+        const statusText = STATUS_LABEL[this.status];
+        return statusText ? `Citation ${this.index}, ${statusText}` : `Citation ${this.index}`;
+    }
+    // Named showPreview/hidePreviewNow (not show/hidePopover) to avoid
+    // colliding with the standard HTML Popover API's own
+    // HTMLElement.prototype.showPopover()/hidePopover() -- this component
+    // renders its own floating panel via internal/positioner.js rather than
+    // the native `popover` attribute, but TS's DOM lib still declares those
+    // method names on every HTMLElement subclass, so reusing them here would
+    // be a same-name-different-signature override error.
+    showPreview() {
+        if (!this.hasPreviewSlot || this.popoverOpen)
+            return;
+        clearTimeout(this.hideTimer);
+        this.hideTimer = undefined;
+        this.popoverOpen = true;
+    }
+    scheduleHidePreview() {
+        if (!this.popoverOpen || this.hovering || this.focused)
+            return;
+        clearTimeout(this.hideTimer);
+        this.hideTimer = setTimeout(() => {
+            this.hideTimer = undefined;
+            this.popoverOpen = false;
+        }, HIDE_DELAY_MS);
+    }
+    hidePreviewNow() {
+        clearTimeout(this.hideTimer);
+        this.hideTimer = undefined;
+        if (this.popoverOpen)
+            this.popoverOpen = false;
+    }
+    emitOpen() {
+        this.emit('lyra-citation-open', {
+            sourceId: this.sourceId,
+            index: this.index,
+            href: this.href || undefined,
+        });
+    }
+    render() {
+        return html `
+      <span
+        class="wrapper"
+        @pointerenter=${this.onPointerEnter}
+        @pointerleave=${this.onPointerLeave}
+        @focusin=${this.onFocusIn}
+        @focusout=${this.onFocusOut}
+        @keydown=${this.onKeyDown}
+      >
+        <button
+          part="base"
+          type="button"
+          aria-label=${this.getAttribute('aria-label') || this.accessibleLabel}
+          aria-describedby=${this.hasPreviewSlot && this.popoverOpen ? this.popoverId : nothing}
+          @click=${this.onClick}
+          @dblclick=${this.onDblClick}
+        >
+          <span part="bracket" aria-hidden="true">[</span><span part="index">${this.index}</span
+          ><span part="bracket" aria-hidden="true">]</span>
+        </button>
+        <div part="popover" id=${this.popoverId} role="tooltip" ?hidden=${!this.popoverOpen}>
+          <slot @slotchange=${this.onSlotChange}></slot>
+        </div>
+      </span>
+    `;
+    }
+}
+__decorate([
+    property({ type: Number })
+], LyraCitationBadge.prototype, "index", void 0);
+__decorate([
+    property({ reflect: true })
+], LyraCitationBadge.prototype, "status", void 0);
+__decorate([
+    property({ attribute: 'source-id' })
+], LyraCitationBadge.prototype, "sourceId", void 0);
+__decorate([
+    property()
+], LyraCitationBadge.prototype, "href", void 0);
+__decorate([
+    property()
+], LyraCitationBadge.prototype, "label", void 0);
+__decorate([
+    state()
+], LyraCitationBadge.prototype, "hasPreviewSlot", void 0);
+__decorate([
+    state()
+], LyraCitationBadge.prototype, "popoverOpen", void 0);
+__decorate([
+    query('[part="base"]')
+], LyraCitationBadge.prototype, "buttonEl", void 0);
+__decorate([
+    query('[part="popover"]')
+], LyraCitationBadge.prototype, "popoverEl", void 0);
+defineElement('citation-badge', LyraCitationBadge);

package/dist/components/citation-badge/citation-badge.styles.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;