@aceshooting/lyra-ui 2.0.0 → 2.2.0

package/dist/components/source-card/source-card.class.js

@@ -0,0 +1,194 @@
+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 { nextId } from '../../internal/a11y.js';
+import { styles } from './source-card.styles.js';
+/**
+ * `<lyra-source-card>` — one citation/source entry, meant to be a direct
+ * light-DOM child of `<lyra-source-list>` (though it renders and functions
+ * fine standalone). Shows a title/page heading, an always-visible `excerpt`
+ * slot, and an optional `full` slot revealed behind its own independent
+ * "Show more" toggle — unrelated to the parent `<lyra-source-list>`'s own
+ * expand/collapse, which only ever hides/shows the *set* of cards, never a
+ * single card's own content.
+ *
+ * `source-id` is this card's stable identity, meant to match a
+ * `<lyra-citation-badge>` (a sibling component) elsewhere on the page. This
+ * component doesn't implement any scroll-to/highlight behavior itself — that
+ * lives at the app level, wiring a citation badge's activation event to this
+ * card's `id`/`source-id`. See the `@example` below.
+ *
+ * @customElement lyra-source-card
+ * @slot excerpt - A short preview. When left empty, the `excerpt` part
+ * collapses away entirely rather than leaving an empty gap in the card.
+ * @slot full - The complete source text/chunk, hidden behind the "Show
+ * more"/"Show less" toggle. When left empty, no toggle renders at all — a
+ * card with no `full` content simply has no expand affordance. Removing all
+ * `full`-slotted content while expanded automatically collapses it back.
+ * @event lyra-expand - The per-card "Show more"/"Show less" toggle was
+ * activated. `detail: { sourceId, expanded }`.
+ * @event lyra-open - The title was activated. `detail: { sourceId, href }` —
+ * `href` may be `undefined`. This component never navigates on its own
+ * (staying a controlled component, the same convention
+ * `<lyra-tool-call-chip>`'s `lyra-tool-chip-select` follows); a listener
+ * decides what "open" means (open `href` in a new tab, open an in-app
+ * viewer, etc).
+ * @csspart base - The outer container.
+ * @csspart title - The clickable title/page heading (`<button>`).
+ * @csspart excerpt - The wrapper around the `excerpt` slot, `hidden` when the slot has no assigned content.
+ * @csspart full - The wrapper around the `full` slot, `hidden` while collapsed.
+ * @csspart toggle - The "Show more"/"Show less" button. Only rendered when the `full` slot has content.
+ *
+ * @example
+ * ```html
+ * <lyra-source-list label-plural="2 sources">
+ *   <lyra-source-card source-id="doc-1" title="annual_report.pdf" page="12">
+ *     <span slot="excerpt">Revenue grew 12% year over year...</span>
+ *     <span slot="full">Revenue grew 12% year over year, driven primarily by...</span>
+ *   </lyra-source-card>
+ * </lyra-source-list>
+ * ```
+ * ```js
+ * // Elsewhere, a <lyra-citation-badge>'s activation handler can scroll to
+ * // and highlight the matching card -- this component needs no extra API
+ * // surface for that, only its existing source-id to be targeted by:
+ * document.addEventListener('lyra-citation-activate', (e) => {
+ *   const card = document.querySelector(`lyra-source-card[source-id="${e.detail.sourceId}"]`);
+ *   card?.scrollIntoView({ behavior: 'smooth', block: 'center' });
+ *   card?.classList.add('is-highlighted'); // consumer-defined CSS, e.g. a brief background flash
+ *   setTimeout(() => card?.classList.remove('is-highlighted'), 2000);
+ * });
+ * ```
+ */
+export class LyraSourceCard extends LyraElement {
+    constructor() {
+        super(...arguments);
+        /** Stable identifier matching a `<lyra-citation-badge>` elsewhere on the page. */
+        this.sourceId = '';
+        /** The source's display title, e.g. a filename. Rendered only as the
+         *  title button's own text -- a bare host-level `title` attribute (the
+         *  browser's global tooltip attribute) is actively stripped once Lit has
+         *  synced it into this property, so the card never grows an unsolicited
+         *  native tooltip repeating the same text. See `attributeChangedCallback`
+         *  and `updated` below. */
+        this.title = '';
+        // See `<lyra-widget>`'s `hasActionsSlot` for the identical
+        // presence-tracking convention -- a `[part]` always contains a literal
+        // `<slot>` child regardless of assigned content, so CSS `:empty` never
+        // matches; real emptiness is tracked in JS instead.
+        this.hasFullSlot = false;
+        this.hasExcerptSlot = false;
+        this.fullExpanded = false;
+        this.fullId = nextId('source-card-full');
+        // Guards the `removeAttribute('title')` call in `updated()` below: removing
+        // an observed attribute fires `attributeChangedCallback` synchronously just
+        // like setting one does, and without this flag Lit would treat the removal
+        // as a fresh (empty) attribute value and reset the `title` property right
+        // back to `null`, losing the value it just finished syncing in.
+        this.stripHostTitleAttr = false;
+        this.onFullSlotChange = (e) => {
+            const count = e.target.assignedElements({ flatten: true }).length;
+            this.hasFullSlot = count > 0;
+            if (count === 0)
+                this.fullExpanded = false;
+        };
+        this.onExcerptSlotChange = (e) => {
+            this.hasExcerptSlot = e.target.assignedElements({ flatten: true }).length > 0;
+        };
+        this.onTitleClick = () => {
+            this.emit('lyra-open', { sourceId: this.sourceId, href: this.href });
+        };
+        this.toggleFull = () => {
+            this.fullExpanded = !this.fullExpanded;
+            this.emit('lyra-expand', { sourceId: this.sourceId, expanded: this.fullExpanded });
+        };
+    }
+    static { this.styles = [LyraElement.styles, styles]; }
+    willUpdate() {
+        if (!this.hasUpdated) {
+            this.hasFullSlot = Array.from(this.children).some((el) => el.getAttribute('slot') === 'full');
+            this.hasExcerptSlot = Array.from(this.children).some((el) => el.getAttribute('slot') === 'excerpt');
+        }
+    }
+    firstUpdated() {
+        const fullSlot = this.shadowRoot.querySelector('slot[name="full"]');
+        const fullCount = fullSlot.assignedElements({ flatten: true }).length;
+        this.hasFullSlot = fullCount > 0;
+        if (fullCount === 0)
+            this.fullExpanded = false;
+        const excerptSlot = this.shadowRoot.querySelector('slot[name="excerpt"]');
+        this.hasExcerptSlot = excerptSlot.assignedElements({ flatten: true }).length > 0;
+    }
+    attributeChangedCallback(name, old, value) {
+        if (name === 'title' && this.stripHostTitleAttr)
+            return;
+        super.attributeChangedCallback(name, old, value);
+    }
+    updated(changed) {
+        if (changed.has('title') && this.hasAttribute('title')) {
+            // The attribute has already been converted into the `title` property
+            // by this point (that's how it got here), so the DOM attribute itself
+            // is now redundant -- and, left in place, would make the whole card
+            // show a native tooltip repeating the title text on hover.
+            this.stripHostTitleAttr = true;
+            this.removeAttribute('title');
+            this.stripHostTitleAttr = false;
+        }
+    }
+    get titleText() {
+        const base = this.title || 'Untitled source';
+        return this.page == null || this.page === '' ? base : `${base} — p. ${this.page}`;
+    }
+    render() {
+        return html `
+      <div part="base">
+        <button part="title" type="button" @click=${this.onTitleClick}>${this.titleText}</button>
+        <div part="excerpt" ?hidden=${!this.hasExcerptSlot}>
+          <slot name="excerpt" @slotchange=${this.onExcerptSlotChange}></slot>
+        </div>
+        ${this.hasFullSlot
+            ? html `<button
+              part="toggle"
+              type="button"
+              aria-expanded=${this.fullExpanded ? 'true' : 'false'}
+              aria-controls=${this.fullId}
+              @click=${this.toggleFull}
+            >
+              ${this.localize(this.fullExpanded ? 'showLess' : 'showMore')}
+            </button>`
+            : nothing}
+        <div part="full" id=${this.fullId} ?hidden=${!this.fullExpanded}>
+          <slot name="full" @slotchange=${this.onFullSlotChange}></slot>
+        </div>
+      </div>
+    `;
+    }
+}
+__decorate([
+    property({ attribute: 'source-id' })
+], LyraSourceCard.prototype, "sourceId", void 0);
+__decorate([
+    property()
+], LyraSourceCard.prototype, "title", void 0);
+__decorate([
+    property()
+], LyraSourceCard.prototype, "page", void 0);
+__decorate([
+    property()
+], LyraSourceCard.prototype, "href", void 0);
+__decorate([
+    state()
+], LyraSourceCard.prototype, "hasFullSlot", void 0);
+__decorate([
+    state()
+], LyraSourceCard.prototype, "hasExcerptSlot", void 0);
+__decorate([
+    state()
+], LyraSourceCard.prototype, "fullExpanded", void 0);
+//# sourceMappingURL=source-card.class.js.map

package/dist/components/source-card/source-card.class.js.map

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

package/dist/components/source-card/source-card.d.ts

@@ -1,92 +1,2 @@
-import { type TemplateResult } from 'lit';
-import { LyraElement } from '../../internal/lyra-element.js';
-export interface SourceCardExpandDetail {
-    sourceId: string;
-    expanded: boolean;
-}
-export interface SourceCardOpenDetail {
-    sourceId: string;
-    href?: string;
-}
-/**
- * `<lyra-source-card>` — one citation/source entry, meant to be a direct
- * light-DOM child of `<lyra-source-list>` (though it renders and functions
- * fine standalone). Shows a title/page heading, an always-visible `excerpt`
- * slot, and an optional `full` slot revealed behind its own independent
- * "Show more" toggle — unrelated to the parent `<lyra-source-list>`'s own
- * expand/collapse, which only ever hides/shows the *set* of cards, never a
- * single card's own content.
- *
- * `source-id` is this card's stable identity, meant to match a
- * `<lyra-citation-badge>` (a sibling component) elsewhere on the page. This
- * component doesn't implement any scroll-to/highlight behavior itself — that
- * lives at the app level, wiring a citation badge's activation event to this
- * card's `id`/`source-id`. See the `@example` below.
- *
- * @customElement lyra-source-card
- * @slot excerpt - A short preview, always visible.
- * @slot full - The complete source text/chunk, hidden behind the "Show
- * more"/"Show less" toggle. When left empty, no toggle renders at all — a
- * card with no `full` content simply has no expand affordance.
- * @event lyra-expand - The per-card "Show more"/"Show less" toggle was
- * activated. `detail: { sourceId, expanded }`.
- * @event lyra-open - The title was activated. `detail: { sourceId, href }` —
- * `href` may be `undefined`. This component never navigates on its own
- * (staying a controlled component, the same convention
- * `<lyra-tool-call-chip>`'s `lyra-tool-chip-select` follows); a listener
- * decides what "open" means (open `href` in a new tab, open an in-app
- * viewer, etc).
- * @csspart base - The outer container.
- * @csspart title - The clickable title/page heading (`<button>`).
- * @csspart excerpt - The wrapper around the `excerpt` slot.
- * @csspart full - The wrapper around the `full` slot, `hidden` while collapsed.
- * @csspart toggle - The "Show more"/"Show less" button. Only rendered when the `full` slot has content.
- *
- * @example
- * ```html
- * <lyra-source-list label-plural="2 sources">
- *   <lyra-source-card source-id="doc-1" title="annual_report.pdf" page="12">
- *     <span slot="excerpt">Revenue grew 12% year over year...</span>
- *     <span slot="full">Revenue grew 12% year over year, driven primarily by...</span>
- *   </lyra-source-card>
- * </lyra-source-list>
- * ```
- * ```js
- * // Elsewhere, a <lyra-citation-badge>'s activation handler can scroll to
- * // and highlight the matching card -- this component needs no extra API
- * // surface for that, only its existing source-id to be targeted by:
- * document.addEventListener('lyra-citation-activate', (e) => {
- *   const card = document.querySelector(`lyra-source-card[source-id="${e.detail.sourceId}"]`);
- *   card?.scrollIntoView({ behavior: 'smooth', block: 'center' });
- *   card?.classList.add('is-highlighted'); // consumer-defined CSS, e.g. a brief background flash
- *   setTimeout(() => card?.classList.remove('is-highlighted'), 2000);
- * });
- * ```
- */
-export declare class LyraSourceCard extends LyraElement {
-    static styles: import("lit").CSSResultGroup[];
-    /** Stable identifier matching a `<lyra-citation-badge>` elsewhere on the page. */
-    sourceId: string;
-    /** The source's display title, e.g. a filename. */
-    title: string;
-    /** Optional page reference, e.g. `12` or `"iv"` — rendered as-is (never
-     *  parsed/validated as a number), so a non-numeric page label works too. */
-    page?: string | number;
-    /** Optional URL, echoed back (unopened) in `lyra-open`'s detail. */
-    href?: string;
-    private hasFullSlot;
-    private fullExpanded;
-    private readonly fullId;
-    protected willUpdate(): void;
-    firstUpdated(): void;
-    private onFullSlotChange;
-    private get titleText();
-    private onTitleClick;
-    private toggleFull;
-    render(): TemplateResult;
-}
-declare global {
-    interface HTMLElementTagNameMap {
-        'lyra-source-card': LyraSourceCard;
-    }
-}
+export * from './source-card.class.js';
+//# sourceMappingURL=source-card.d.ts.map

package/dist/components/source-card/source-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-card.d.ts","sourceRoot":"","sources":["../../../src/components/source-card/source-card.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/dist/components/source-card/source-card.js

@@ -1,148 +1,5 @@
-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';
+export * from './source-card.class.js';
+import { LyraSourceCard } from './source-card.class.js';
 import { defineElement } from '../../internal/prefix.js';
-import { nextId } from '../../internal/a11y.js';
-import { styles } from './source-card.styles.js';
-/**
- * `<lyra-source-card>` — one citation/source entry, meant to be a direct
- * light-DOM child of `<lyra-source-list>` (though it renders and functions
- * fine standalone). Shows a title/page heading, an always-visible `excerpt`
- * slot, and an optional `full` slot revealed behind its own independent
- * "Show more" toggle — unrelated to the parent `<lyra-source-list>`'s own
- * expand/collapse, which only ever hides/shows the *set* of cards, never a
- * single card's own content.
- *
- * `source-id` is this card's stable identity, meant to match a
- * `<lyra-citation-badge>` (a sibling component) elsewhere on the page. This
- * component doesn't implement any scroll-to/highlight behavior itself — that
- * lives at the app level, wiring a citation badge's activation event to this
- * card's `id`/`source-id`. See the `@example` below.
- *
- * @customElement lyra-source-card
- * @slot excerpt - A short preview, always visible.
- * @slot full - The complete source text/chunk, hidden behind the "Show
- * more"/"Show less" toggle. When left empty, no toggle renders at all — a
- * card with no `full` content simply has no expand affordance.
- * @event lyra-expand - The per-card "Show more"/"Show less" toggle was
- * activated. `detail: { sourceId, expanded }`.
- * @event lyra-open - The title was activated. `detail: { sourceId, href }` —
- * `href` may be `undefined`. This component never navigates on its own
- * (staying a controlled component, the same convention
- * `<lyra-tool-call-chip>`'s `lyra-tool-chip-select` follows); a listener
- * decides what "open" means (open `href` in a new tab, open an in-app
- * viewer, etc).
- * @csspart base - The outer container.
- * @csspart title - The clickable title/page heading (`<button>`).
- * @csspart excerpt - The wrapper around the `excerpt` slot.
- * @csspart full - The wrapper around the `full` slot, `hidden` while collapsed.
- * @csspart toggle - The "Show more"/"Show less" button. Only rendered when the `full` slot has content.
- *
- * @example
- * ```html
- * <lyra-source-list label-plural="2 sources">
- *   <lyra-source-card source-id="doc-1" title="annual_report.pdf" page="12">
- *     <span slot="excerpt">Revenue grew 12% year over year...</span>
- *     <span slot="full">Revenue grew 12% year over year, driven primarily by...</span>
- *   </lyra-source-card>
- * </lyra-source-list>
- * ```
- * ```js
- * // Elsewhere, a <lyra-citation-badge>'s activation handler can scroll to
- * // and highlight the matching card -- this component needs no extra API
- * // surface for that, only its existing source-id to be targeted by:
- * document.addEventListener('lyra-citation-activate', (e) => {
- *   const card = document.querySelector(`lyra-source-card[source-id="${e.detail.sourceId}"]`);
- *   card?.scrollIntoView({ behavior: 'smooth', block: 'center' });
- *   card?.classList.add('is-highlighted'); // consumer-defined CSS, e.g. a brief background flash
- *   setTimeout(() => card?.classList.remove('is-highlighted'), 2000);
- * });
- * ```
- */
-export class LyraSourceCard extends LyraElement {
-    constructor() {
-        super(...arguments);
-        /** Stable identifier matching a `<lyra-citation-badge>` elsewhere on the page. */
-        this.sourceId = '';
-        /** The source's display title, e.g. a filename. */
-        this.title = '';
-        // See `<lyra-widget>`'s `hasActionsSlot` for the identical
-        // presence-tracking convention -- a `[part]` always contains a literal
-        // `<slot>` child regardless of assigned content, so CSS `:empty` never
-        // matches; real emptiness is tracked in JS instead.
-        this.hasFullSlot = false;
-        this.fullExpanded = false;
-        this.fullId = nextId('source-card-full');
-        this.onFullSlotChange = (e) => {
-            this.hasFullSlot = e.target.assignedElements({ flatten: true }).length > 0;
-        };
-        this.onTitleClick = () => {
-            this.emit('lyra-open', { sourceId: this.sourceId, href: this.href });
-        };
-        this.toggleFull = () => {
-            this.fullExpanded = !this.fullExpanded;
-            this.emit('lyra-expand', { sourceId: this.sourceId, expanded: this.fullExpanded });
-        };
-    }
-    static { this.styles = [LyraElement.styles, styles]; }
-    willUpdate() {
-        if (!this.hasUpdated) {
-            this.hasFullSlot = Array.from(this.children).some((el) => el.getAttribute('slot') === 'full');
-        }
-    }
-    firstUpdated() {
-        const slot = this.shadowRoot.querySelector('slot[name="full"]');
-        this.hasFullSlot = slot.assignedElements({ flatten: true }).length > 0;
-    }
-    get titleText() {
-        const base = this.title || 'Untitled source';
-        return this.page == null || this.page === '' ? base : `${base} — p. ${this.page}`;
-    }
-    render() {
-        return html `
-      <div part="base">
-        <button part="title" type="button" @click=${this.onTitleClick}>${this.titleText}</button>
-        <div part="excerpt"><slot name="excerpt"></slot></div>
-        ${this.hasFullSlot
-            ? html `<button
-              part="toggle"
-              type="button"
-              aria-expanded=${this.fullExpanded ? 'true' : 'false'}
-              aria-controls=${this.fullId}
-              @click=${this.toggleFull}
-            >
-              ${this.fullExpanded ? 'Show less' : 'Show more'}
-            </button>`
-            : nothing}
-        <div part="full" id=${this.fullId} ?hidden=${!this.fullExpanded}>
-          <slot name="full" @slotchange=${this.onFullSlotChange}></slot>
-        </div>
-      </div>
-    `;
-    }
-}
-__decorate([
-    property({ attribute: 'source-id' })
-], LyraSourceCard.prototype, "sourceId", void 0);
-__decorate([
-    property()
-], LyraSourceCard.prototype, "title", void 0);
-__decorate([
-    property()
-], LyraSourceCard.prototype, "page", void 0);
-__decorate([
-    property()
-], LyraSourceCard.prototype, "href", void 0);
-__decorate([
-    state()
-], LyraSourceCard.prototype, "hasFullSlot", void 0);
-__decorate([
-    state()
-], LyraSourceCard.prototype, "fullExpanded", void 0);
 defineElement('source-card', LyraSourceCard);
+//# sourceMappingURL=source-card.js.map

package/dist/components/source-card/source-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-card.js","sourceRoot":"","sources":["../../../src/components/source-card/source-card.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC"}

package/dist/components/source-card/source-card.styles.d.ts

@@ -1 +1,2 @@
 export declare const styles: import("lit").CSSResult;
+//# sourceMappingURL=source-card.styles.d.ts.map

package/dist/components/source-card/source-card.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-card.styles.d.ts","sourceRoot":"","sources":["../../../src/components/source-card/source-card.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,yBAmElB,CAAC"}

package/dist/components/source-card/source-card.styles.js

@@ -8,7 +8,7 @@ export const styles = css `
     flex-direction: column;
     gap: var(--lyra-space-xs);
     padding: var(--lyra-space-s);
-    border: 1px solid var(--lyra-color-border);
+    border: var(--lyra-border-width-thin) solid var(--lyra-color-border);
     border-radius: var(--lyra-radius);
     background: var(--lyra-color-surface);
   }
@@ -20,8 +20,8 @@ export const styles = css `
     margin: 0;
     color: var(--lyra-color-brand);
     font: inherit;
-    font-weight: 600;
-    font-size: 0.875rem;
+    font-weight: var(--lyra-font-weight-semibold);
+    font-size: var(--lyra-font-size-md-sm);
     text-align: start;
     cursor: pointer;
   }
@@ -35,10 +35,10 @@ export const styles = css `
   }
   [part='excerpt'] {
     color: var(--lyra-color-text-quiet);
-    font-size: 0.8125rem;
-    line-height: 1.4;
+    font-size: var(--lyra-font-size-sm);
+    line-height: var(--lyra-line-height-1-4);
   }
-  [part='excerpt']:empty {
+  [part='excerpt'][hidden] {
     display: none;
   }
   [part='toggle'] {
@@ -49,8 +49,8 @@ export const styles = css `
     margin: 0;
     color: var(--lyra-color-brand);
     font: inherit;
-    font-size: 0.75rem;
-    font-weight: 600;
+    font-size: var(--lyra-font-size-xs);
+    font-weight: var(--lyra-font-weight-semibold);
     cursor: pointer;
   }
   [part='toggle']:hover {
@@ -58,12 +58,13 @@ export const styles = css `
   }
   [part='full'] {
     padding-block-start: var(--lyra-space-xs);
-    border-block-start: 1px solid var(--lyra-color-border);
+    border-block-start: var(--lyra-border-width-thin) solid var(--lyra-color-border);
     color: var(--lyra-color-text);
-    font-size: 0.8125rem;
-    line-height: 1.4;
+    font-size: var(--lyra-font-size-sm);
+    line-height: var(--lyra-line-height-1-4);
   }
   [part='full'][hidden] {
     display: none;
   }
 `;
+//# sourceMappingURL=source-card.styles.js.map

package/dist/components/source-card/source-card.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-card.styles.js","sourceRoot":"","sources":["../../../src/components/source-card/source-card.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmExB,CAAC"}

package/dist/components/source-list/source-list.class.d.ts

@@ -0,0 +1,64 @@
+import { type TemplateResult } from 'lit';
+import { LyraElement } from '../../internal/lyra-element.js';
+export interface SourceListToggleDetail {
+    expanded: boolean;
+}
+/**
+ * `<lyra-source-list>` — a collapsible "Sources" panel for one chat message,
+ * grouping a set of `<lyra-source-card>` children (its default-slot light-DOM
+ * children, plain composition — no `.items` array prop, the same shape
+ * `<lyra-split>`'s panels take) behind a single clickable header.
+ *
+ * This library has no built-in i18n/pluralization (see `<lyra-empty>`'s plain
+ * `description` prop for the same stance), so the header text is entirely
+ * consumer-supplied: `label-plural` (e.g. `"3 sources"`) wins when set,
+ * falling back to `label`, falling back to the literal word `"Sources"` — see
+ * each property's own doc. `sourceCount` (a read-only, live-updated count of
+ * the currently-slotted children) is exposed for a consumer who wants to
+ * build that string reactively instead of hand-counting DOM children.
+ *
+ * The card list is removed from the accessibility tree (not just visually
+ * hidden) while collapsed, via the native `hidden` attribute on
+ * `[part="list"]` — a screen reader user tabbing past the header never lands
+ * on off-screen source cards they can't currently see.
+ *
+ * @customElement lyra-source-list
+ * @slot - `<lyra-source-card>` elements (or any content, though the card
+ * pairing is the intended usage).
+ * @event lyra-toggle - The header was activated, expanding or collapsing the
+ * list. `detail: { expanded }`.
+ * @csspart base - The outer container.
+ * @csspart header - The clickable header (`<button>`) toggling `expanded`.
+ * @csspart toggle - The chevron indicator inside the header.
+ * @csspart list - The wrapper around the default slot, `hidden` while collapsed.
+ */
+export declare class LyraSourceList extends LyraElement {
+    static styles: import("lit").CSSResultGroup[];
+    /** Whether the card list is currently shown. Starts collapsed by default
+     *  so a message's sources don't eat vertical space until asked for. */
+    expanded: boolean;
+    /** Header text used when `label-plural` isn't set, e.g. `"Sources"`. */
+    label: string;
+    /** Fully consumer-built, already-pluralized header summary, e.g. `"3 sources"`
+     *  or `"1 source"` — this component never counts or pluralizes on its own
+     *  (see the class doc). Takes precedence over `label` when both are set. */
+    labelPlural: string;
+    private slottedCount;
+    private readonly listId;
+    protected willUpdate(): void;
+    firstUpdated(): void;
+    /** Read-only, live-updated count of the currently-slotted children —
+     *  handy for building a `label-plural` string that stays in sync with
+     *  what's actually slotted without hand-counting DOM children, e.g.
+     *  `list.labelPlural = \`${list.sourceCount} sources\`;`. */
+    get sourceCount(): number;
+    private onSlotChange;
+    private toggle;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lyra-source-list': LyraSourceList;
+    }
+}
+//# sourceMappingURL=source-list.class.d.ts.map

package/dist/components/source-list/source-list.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-list.class.d.ts","sourceRoot":"","sources":["../../../src/components/source-list/source-list.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAK7D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,MAAM,CAAC,MAAM,iCAAgC;IAE7C;2EACuE;IAC3B,QAAQ,UAAS;IAE7D,wEAAwE;IAC5D,KAAK,SAAM;IAEvB;;gFAE4E;IACnC,WAAW,SAAM;IAMjD,OAAO,CAAC,YAAY,CAAK;IAElC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IAEvD,SAAS,CAAC,UAAU,IAAI,IAAI,CAY3B;IAED,YAAY,IAAI,IAAI,CAMnB;IAED;;;iEAG6D;IAC7D,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,OAAO,CAAC,YAAY,CAElB;IAEF,OAAO,CAAC,MAAM,CAGZ;IAEF,MAAM,IAAI,cAAc,CAoBvB;CACF;AAGD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,kBAAkB,EAAE,cAAc,CAAC;KACpC;CACF"}