@aceshooting/lyra-ui 4.1.0 → 5.0.0

package/dist/components/retrieval/grounding-summary/grounding-summary.class.d.ts

@@ -0,0 +1,80 @@
+import { type TemplateResult } from 'lit';
+import { LyraElement } from '../../../internal/lyra-element.js';
+import '../../data/stat/stat.class.js';
+import '../citation-badge/citation-badge.class.js';
+import '../../overlays/empty/empty.class.js';
+import type { Citation, CitationSelectEventDetail, GroundingAssessment } from '../../../ai/types.js';
+export interface LyraGroundingSummaryEventMap {
+    'lr-citation-select': CustomEvent<CitationSelectEventDetail>;
+}
+/** Coverage/confidence tone thresholds (both are 0-1 fractions) -- the same shape and default
+ *  magnitude `<lr-chunk-inspector>`'s own `thresholds` prop already establishes for its
+ *  relevance-score tiers, reused here for the analogous "how well grounded" reading. */
+export interface GroundingSummaryThresholds {
+    high: number;
+    medium: number;
+}
+/**
+ * `<lr-grounding-summary>` -- the claim-level scorecard for one generated answer: supported/
+ * unsupported claim counts, citation coverage, an optional confidence score, any warnings, and
+ * (when `citations` is supplied) a list of evidence citations linking back to their exact spans.
+ * Consumes `GroundingAssessment` from `src/ai/types.ts` directly as its primary input. Pure
+ * projection + event conduit: never fetches or computes an assessment itself.
+ *
+ * Composes `<lr-stat>` for every numeric display (claim counts, coverage, confidence) and
+ * `<lr-citation-badge>` for each evidence entry -- this component defines no numeric-badge or
+ * citation-link markup of its own.
+ *
+ * `<lr-citation-badge>`'s own `lr-citation-activate` event (`detail: { sourceId, index }`) still
+ * bubbles through unmodified, same as every other Lyra component composing a child that emits its
+ * own events. This component additionally listens for it and re-emits the richer
+ * `lr-citation-select` (`detail: { citation }`, `CitationSelectEventDetail` from `src/ai/types.ts`)
+ * carrying the full `Citation` -- including its `span` -- since a bare `sourceId`/`index` pair
+ * can't by itself tell a host which exact evidence span to jump to.
+ *
+ * @customElement lr-grounding-summary
+ * @event lr-citation-select - An evidence citation badge was activated. `detail: { citation }`.
+ * @csspart base - The `role="group"` root wrapper.
+ * @csspart stats - Container for the claim-count/coverage/confidence `<lr-stat>` row.
+ * @csspart warnings - Wrapper for the warnings section. Omitted when there are no warnings.
+ * @csspart warnings-heading - The "Warnings" heading text.
+ * @csspart warnings-count - The warnings count.
+ * @csspart warnings-list - The `<ul>` of warning messages.
+ * @csspart warning - One warning `<li>`.
+ * @csspart evidence - Wrapper for the evidence section. Omitted when `citations` is empty.
+ * @csspart evidence-heading - The "Evidence" heading text.
+ * @csspart evidence-count - The evidence count.
+ * @csspart evidence-item - One citation's row (badge + always-visible label/span text).
+ * @csspart evidence-label - A citation's `label`, shown next to its badge (omitted when unset).
+ * @csspart evidence-span - A citation's formatted `span` range, shown next to its badge (omitted
+ *   when `span` is unset).
+ * @csspart empty - The empty-state message, shown when `assessment` is `null`.
+ */
+export declare class LyraGroundingSummary extends LyraElement<LyraGroundingSummaryEventMap> {
+    static styles: import("lit").CSSResultGroup[];
+    /** The assessment to summarize. `null` (the default) renders the empty state. */
+    assessment: GroundingAssessment | null;
+    /** Evidence citations backing the assessment, each rendered as an `<lr-citation-badge>` linking
+     *  back to its exact `span`. Independent of `assessment` -- the evidence section is simply
+     *  omitted when this is empty, same as the warnings section is omitted when `assessment.warnings`
+     *  is empty/unset. */
+    citations: Citation[];
+    /** Tone thresholds applied to both `coverage` and `confidence` (both 0-1 fractions): at or above
+     *  `high` renders `success`, at or above `medium` renders `warning`, below `medium` renders
+     *  `danger`. */
+    thresholds: GroundingSummaryThresholds;
+    /** Accessible group label override. Falls back to a host `aria-label`, then the localized
+     *  `groundingSummaryLabel` default. */
+    label: string;
+    private tone;
+    private formatPercent;
+    private onCitationSelect;
+    private renderEvidenceItem;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lr-grounding-summary': LyraGroundingSummary;
+    }
+}
+//# sourceMappingURL=grounding-summary.class.d.ts.map

package/dist/components/retrieval/grounding-summary/grounding-summary.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grounding-summary.class.d.ts","sourceRoot":"","sources":["../../../../src/components/retrieval/grounding-summary/grounding-summary.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAIhE,OAAO,+BAA+B,CAAC;AACvC,OAAO,2CAA2C,CAAC;AACnD,OAAO,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGrG,MAAM,WAAW,4BAA4B;IAC3C,oBAAoB,EAAE,WAAW,CAAC,yBAAyB,CAAC,CAAC;CAC9D;AAED;;wFAEwF;AACxF,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,oBAAqB,SAAQ,WAAW,CAAC,4BAA4B,CAAC;IACjF,MAAM,CAAC,MAAM,iCAAgC;IAE7C,iFAAiF;IACjD,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAQ;IAE9E;;;0BAGsB;IACU,SAAS,EAAE,QAAQ,EAAE,CAAM;IAE3D;;oBAEgB;IACgB,UAAU,EAAE,0BAA0B,CAA8B;IAEpG;2CACuC;IAC3B,KAAK,SAAM;IAEvB,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,kBAAkB,CAqBxB;IAEF,MAAM,IAAI,cAAc,CAiEvB;CACF;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,sBAAsB,EAAE,oBAAoB,CAAC;KAC9C;CACF"}

package/dist/components/retrieval/grounding-summary/grounding-summary.class.js

@@ -0,0 +1,182 @@
+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 } from 'lit/decorators.js';
+import { LyraElement } from '../../../internal/lyra-element.js';
+import { finiteCount, finiteRange } from '../../../internal/numbers.js';
+import { getNumberFormat } from '../../../internal/intl-cache.js';
+import '../../data/stat/stat.class.js';
+import '../citation-badge/citation-badge.class.js';
+import '../../overlays/empty/empty.class.js';
+import { styles } from './grounding-summary.styles.js';
+/**
+ * `<lr-grounding-summary>` -- the claim-level scorecard for one generated answer: supported/
+ * unsupported claim counts, citation coverage, an optional confidence score, any warnings, and
+ * (when `citations` is supplied) a list of evidence citations linking back to their exact spans.
+ * Consumes `GroundingAssessment` from `src/ai/types.ts` directly as its primary input. Pure
+ * projection + event conduit: never fetches or computes an assessment itself.
+ *
+ * Composes `<lr-stat>` for every numeric display (claim counts, coverage, confidence) and
+ * `<lr-citation-badge>` for each evidence entry -- this component defines no numeric-badge or
+ * citation-link markup of its own.
+ *
+ * `<lr-citation-badge>`'s own `lr-citation-activate` event (`detail: { sourceId, index }`) still
+ * bubbles through unmodified, same as every other Lyra component composing a child that emits its
+ * own events. This component additionally listens for it and re-emits the richer
+ * `lr-citation-select` (`detail: { citation }`, `CitationSelectEventDetail` from `src/ai/types.ts`)
+ * carrying the full `Citation` -- including its `span` -- since a bare `sourceId`/`index` pair
+ * can't by itself tell a host which exact evidence span to jump to.
+ *
+ * @customElement lr-grounding-summary
+ * @event lr-citation-select - An evidence citation badge was activated. `detail: { citation }`.
+ * @csspart base - The `role="group"` root wrapper.
+ * @csspart stats - Container for the claim-count/coverage/confidence `<lr-stat>` row.
+ * @csspart warnings - Wrapper for the warnings section. Omitted when there are no warnings.
+ * @csspart warnings-heading - The "Warnings" heading text.
+ * @csspart warnings-count - The warnings count.
+ * @csspart warnings-list - The `<ul>` of warning messages.
+ * @csspart warning - One warning `<li>`.
+ * @csspart evidence - Wrapper for the evidence section. Omitted when `citations` is empty.
+ * @csspart evidence-heading - The "Evidence" heading text.
+ * @csspart evidence-count - The evidence count.
+ * @csspart evidence-item - One citation's row (badge + always-visible label/span text).
+ * @csspart evidence-label - A citation's `label`, shown next to its badge (omitted when unset).
+ * @csspart evidence-span - A citation's formatted `span` range, shown next to its badge (omitted
+ *   when `span` is unset).
+ * @csspart empty - The empty-state message, shown when `assessment` is `null`.
+ */
+export class LyraGroundingSummary extends LyraElement {
+    constructor() {
+        super(...arguments);
+        /** The assessment to summarize. `null` (the default) renders the empty state. */
+        this.assessment = null;
+        /** Evidence citations backing the assessment, each rendered as an `<lr-citation-badge>` linking
+         *  back to its exact `span`. Independent of `assessment` -- the evidence section is simply
+         *  omitted when this is empty, same as the warnings section is omitted when `assessment.warnings`
+         *  is empty/unset. */
+        this.citations = [];
+        /** Tone thresholds applied to both `coverage` and `confidence` (both 0-1 fractions): at or above
+         *  `high` renders `success`, at or above `medium` renders `warning`, below `medium` renders
+         *  `danger`. */
+        this.thresholds = { high: 0.8, medium: 0.5 };
+        /** Accessible group label override. Falls back to a host `aria-label`, then the localized
+         *  `groundingSummaryLabel` default. */
+        this.label = '';
+        this.renderEvidenceItem = (citation, index) => {
+            const spanText = citation.span
+                ? this.localize('groundingSummaryEvidenceSpan', undefined, {
+                    start: citation.span.start,
+                    end: citation.span.end,
+                })
+                : '';
+            return html `
+      <div part="evidence-item">
+        <lr-citation-badge
+          index=${index + 1}
+          source-id=${citation.sourceId ?? ''}
+          @lr-citation-activate=${() => this.onCitationSelect(citation)}
+        >
+          ${citation.label ? html `<span>${citation.label}</span>` : nothing}
+          ${spanText ? html `<span>${spanText}</span>` : nothing}
+        </lr-citation-badge>
+        ${citation.label ? html `<span part="evidence-label">${citation.label}</span>` : nothing}
+        ${spanText ? html `<span part="evidence-span">${spanText}</span>` : nothing}
+      </div>
+    `;
+        };
+    }
+    static { this.styles = [LyraElement.styles, styles]; }
+    tone(value) {
+        if (value >= this.thresholds.high)
+            return 'success';
+        if (value >= this.thresholds.medium)
+            return 'warning';
+        return 'danger';
+    }
+    formatPercent(value) {
+        return getNumberFormat(this.effectiveLocale, { style: 'percent' }).format(finiteRange(value, 0, 0, 1));
+    }
+    onCitationSelect(citation) {
+        this.emit('lr-citation-select', { citation });
+    }
+    render() {
+        const groupLabel = this.getAttribute('aria-label') || this.label || this.localize('groundingSummaryLabel');
+        const a = this.assessment;
+        if (!a) {
+            return html `<div part="base" role="group" aria-label=${groupLabel}>
+        <lr-empty part="empty" heading=${this.localize('groundingSummaryEmpty')}></lr-empty>
+      </div>`;
+        }
+        const supportedClaims = finiteCount(a.supportedClaims);
+        const unsupportedClaims = finiteCount(a.unsupportedClaims);
+        const coverage = finiteRange(a.coverage, 0, 0, 1);
+        const hasConfidence = typeof a.confidence === 'number';
+        const warnings = a.warnings ?? [];
+        const numberFormat = getNumberFormat(this.effectiveLocale);
+        return html `
+      <div part="base" role="group" aria-label=${groupLabel}>
+        <div part="stats">
+          <lr-stat
+            label=${this.localize('groundingSummarySupportedLabel')}
+            value=${numberFormat.format(supportedClaims)}
+            variant=${supportedClaims > 0 ? 'success' : 'neutral'}
+          ></lr-stat>
+          <lr-stat
+            label=${this.localize('groundingSummaryUnsupportedLabel')}
+            value=${numberFormat.format(unsupportedClaims)}
+            variant=${unsupportedClaims > 0 ? 'danger' : 'neutral'}
+          ></lr-stat>
+          <lr-stat
+            label=${this.localize('groundingSummaryCoverageLabel')}
+            value=${this.formatPercent(coverage)}
+            variant=${this.tone(coverage)}
+          ></lr-stat>
+          ${hasConfidence
+            ? html `<lr-stat
+                label=${this.localize('groundingSummaryConfidenceLabel')}
+                value=${this.formatPercent(a.confidence)}
+                variant=${this.tone(finiteRange(a.confidence, 0, 0, 1))}
+              ></lr-stat>`
+            : nothing}
+        </div>
+        ${warnings.length > 0
+            ? html `
+              <div part="warnings">
+                <span part="warnings-heading">${this.localize('groundingSummaryWarningsHeading')}</span>
+                <span part="warnings-count">${warnings.length}</span>
+                <ul part="warnings-list">
+                  ${warnings.map((warning) => html `<li part="warning">${warning}</li>`)}
+                </ul>
+              </div>
+            `
+            : nothing}
+        ${this.citations.length > 0
+            ? html `
+              <div part="evidence">
+                <span part="evidence-heading">${this.localize('groundingSummaryEvidenceHeading')}</span>
+                <span part="evidence-count">${this.citations.length}</span>
+                <div>${this.citations.map((citation, index) => this.renderEvidenceItem(citation, index))}</div>
+              </div>
+            `
+            : nothing}
+      </div>
+    `;
+    }
+}
+__decorate([
+    property({ attribute: false })
+], LyraGroundingSummary.prototype, "assessment", void 0);
+__decorate([
+    property({ attribute: false })
+], LyraGroundingSummary.prototype, "citations", void 0);
+__decorate([
+    property({ attribute: false })
+], LyraGroundingSummary.prototype, "thresholds", void 0);
+__decorate([
+    property()
+], LyraGroundingSummary.prototype, "label", void 0);
+//# sourceMappingURL=grounding-summary.class.js.map

package/dist/components/retrieval/grounding-summary/grounding-summary.class.js.map

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

package/dist/components/retrieval/grounding-summary/grounding-summary.d.ts

@@ -0,0 +1,5 @@
+export * from './grounding-summary.class.js';
+import '../../data/stat/stat.js';
+import '../citation-badge/citation-badge.js';
+import '../../overlays/empty/empty.js';
+//# sourceMappingURL=grounding-summary.d.ts.map

package/dist/components/retrieval/grounding-summary/grounding-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grounding-summary.d.ts","sourceRoot":"","sources":["../../../../src/components/retrieval/grounding-summary/grounding-summary.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAG7C,OAAO,yBAAyB,CAAC;AACjC,OAAO,qCAAqC,CAAC;AAC7C,OAAO,+BAA+B,CAAC"}

package/dist/components/retrieval/grounding-summary/grounding-summary.js

@@ -0,0 +1,8 @@
+export * from './grounding-summary.class.js';
+import { LyraGroundingSummary } from './grounding-summary.class.js';
+import { defineElement } from '../../../internal/prefix.js';
+import '../../data/stat/stat.js';
+import '../citation-badge/citation-badge.js';
+import '../../overlays/empty/empty.js';
+defineElement('grounding-summary', LyraGroundingSummary);
+//# sourceMappingURL=grounding-summary.js.map

package/dist/components/retrieval/grounding-summary/grounding-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grounding-summary.js","sourceRoot":"","sources":["../../../../src/components/retrieval/grounding-summary/grounding-summary.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,yBAAyB,CAAC;AACjC,OAAO,qCAAqC,CAAC;AAC7C,OAAO,+BAA+B,CAAC;AACvC,aAAa,CAAC,mBAAmB,EAAE,oBAAoB,CAAC,CAAC"}

package/dist/components/retrieval/grounding-summary/grounding-summary.styles.d.ts.map

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

package/dist/components/retrieval/grounding-summary/grounding-summary.styles.js.map

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

package/dist/components/retrieval/ingestion-queue/ingestion-queue.class.d.ts

@@ -0,0 +1,125 @@
+import { type TemplateResult } from 'lit';
+import { LyraElement } from '../../../internal/lyra-element.js';
+import type { CancelEventDetail, DocumentRef, RetryEventDetail } from '../../../ai/types.js';
+import '../../overlays/badge/badge.js';
+import '../../overlays/progress/progress-bar.js';
+import '../../overlays/empty/empty.js';
+import '../../layout/virtual-list/virtual-list.js';
+/**
+ * A document's position in the ingestion pipeline. `'queued'` through `'indexing'` are the
+ * in-flight stages (in pipeline order); `'done'`, `'failed'`, and `'cancelled'` are terminal.
+ */
+export type IngestionStage = 'queued' | 'uploading' | 'extracting' | 'chunking' | 'embedding' | 'indexing' | 'done' | 'failed' | 'cancelled';
+/**
+ * One document moving through the ingestion pipeline. `document` reuses the shared `DocumentRef`
+ * shape (`src/ai/types.ts`) rather than a divergent `name`/`mimeType` pair of its own, so a caller
+ * populating this queue from the same source list a `DocumentRef`-typed retrieval/knowledge-base
+ * view already holds needs no adapter.
+ */
+export interface IngestionQueueItem {
+    /** Stable id, echoed back in `lr-retry`/`lr-cancel` event details. */
+    id: string;
+    document: DocumentRef;
+    stage: IngestionStage;
+    /** 0-100 within the current stage. Omitted (or non-finite) renders an indeterminate indicator --
+     *  only meaningful while `stage` is one of the active (non-`'queued'`, non-terminal) stages. */
+    progress?: number;
+    /** Total chunks produced, once chunking has run. */
+    chunkCount?: number;
+    /** Chunks embedded so far, out of `chunkCount`. Rendered only alongside a defined `chunkCount`. */
+    embeddedChunkCount?: number;
+    /** Retry attempts already made (0/undefined = never retried). */
+    attempts?: number;
+    /** Failure detail, rendered only while `stage === 'failed'`. */
+    error?: string;
+}
+/** `lr-retry`'s `detail` -- extends the shared `RetryEventDetail` (`src/ai/types.ts`) with the
+ *  `itemId` identifying *which* queue item the request is about; `attempt` is the attempt number
+ *  about to be made (`(item.attempts ?? 0) + 1`), matching `RetryEventDetail.attempt`'s own
+ *  semantics verbatim. */
+export interface IngestionRetryEventDetail extends RetryEventDetail {
+    itemId: string;
+}
+/** `lr-cancel`'s `detail` -- extends the shared `CancelEventDetail` (`src/ai/types.ts`) with the
+ *  `itemId` identifying *which* queue item the request is about. This component never supplies a
+ *  `reason` itself; it is left for a host wrapping the cancel affordance with its own prompt. */
+export interface IngestionCancelEventDetail extends CancelEventDetail {
+    itemId: string;
+}
+export interface LyraIngestionQueueEventMap {
+    'lr-retry': CustomEvent<IngestionRetryEventDetail>;
+    'lr-cancel': CustomEvent<IngestionCancelEventDetail>;
+}
+/**
+ * `<lr-ingestion-queue>` — a controlled list of documents moving through an ingestion pipeline
+ * (upload → text extraction → chunking → embedding → indexing), each row showing its stage,
+ * progress, chunk/embedding counts, and a retry or cancel affordance. Presentation only: this
+ * component runs no ingestion itself, persists nothing, and never mutates `items` -- retrying or
+ * cancelling a row fires a controlled `lr-retry`/`lr-cancel` request event and waits for the host
+ * to supply an updated `items` array, the same request/response convention `<lr-thread-list>`'s
+ * `lr-thread-pin`/`-archive`/`-delete` events already establish.
+ *
+ * At or above `virtualizeThreshold` items, the list renders through an internal
+ * `<lr-virtual-list>` instead of a plain keyed list (same precedent as `<lr-thread-list>`'s data
+ * mode and `<lr-activity-feed>`'s `virtualizeThreshold`) -- identical row markup and behavior
+ * either way, keyed by `id`.
+ *
+ * @customElement lr-ingestion-queue
+ * @event lr-retry - A row's retry affordance was activated (only rendered for `stage="failed"`
+ *   rows). `detail: { itemId, attempt }` -- `attempt` is the attempt number about to be made.
+ * @event lr-cancel - A row's cancel affordance was activated (rendered for every non-terminal
+ *   row). `detail: { itemId, reason }` -- `reason` is always `undefined` from this component.
+ * @csspart base - The root region.
+ * @csspart list - The row container in non-virtualized mode (`role="list"`).
+ * @csspart empty - The `<lr-empty>` zero-items state.
+ * @csspart item - One queue item row; carries `data-stage`. When virtualized, reached from this
+ *   component's own stylesheet via `lr-virtual-list::part(item)` (renders inside the internal
+ *   `<lr-virtual-list>`'s own shadow root, not this component's).
+ * @csspart item-header - The row's name/stage-badge line.
+ * @csspart item-name - The document's `name`.
+ * @csspart item-progress - The row's `<lr-progress-bar>`, only rendered for an active (uploading
+ *   through indexing) stage.
+ * @csspart item-meta - Wrapper around the chunk-count/embedding-status/attempt-count text.
+ * @csspart item-chunk-count - The chunk count, only rendered once `chunkCount` is set.
+ * @csspart item-embedding-status - The "N of M chunks embedded" text, only rendered once both
+ *   `chunkCount` and `embeddedChunkCount` are set.
+ * @csspart item-attempts - The attempt count, only rendered once `attempts` is greater than 0.
+ * @csspart item-error - The failure message, only rendered for `stage="failed"` with `error` set.
+ * @csspart item-actions - Wrapper around the retry/cancel buttons.
+ * @csspart retry-button - Fires `lr-retry`. Only rendered for `stage="failed"` rows.
+ * @csspart cancel-button - Fires `lr-cancel`. Only rendered for non-terminal rows.
+ * @cssprop [--lr-ingestion-queue-max-height=none] - Non-virtualized mode only: caps how tall the
+ *   list grows before it scrolls internally. Has no effect once virtualized -- the internal
+ *   `<lr-virtual-list>`'s own viewport keeps its independent, fixed default height (retheme it
+ *   directly via `<lr-ingestion-queue>`'s own `lr-virtual-list { --lr-virtual-list-height: ... }`
+ *   if needed).
+ */
+export declare class LyraIngestionQueue extends LyraElement<LyraIngestionQueueEventMap> {
+    static styles: import("lit").CSSResultGroup[];
+    /** The queue to render, in display order. Controlled and never mutated by this component --
+     *  pass a new array (e.g. as ingestion progresses) to update it. */
+    items: IngestionQueueItem[];
+    /** Accessible name for the region. Defaults to the localized `ingestionQueueLabel`. A host
+     *  `aria-label` attribute wins over both. */
+    label: string;
+    /** At/above this item count, the list renders through an internal `<lr-virtual-list>`. */
+    virtualizeThreshold: number;
+    /** `virtualizeThreshold`, normalized to a finite non-negative integer (falling back to the
+     *  property's own default) -- a raw `NaN` (e.g. an invalid `virtualize-threshold` attribute)
+     *  would otherwise make `items.length >= virtualizeThreshold` always false, silently disabling
+     *  virtualization instead of falling back to the default threshold. */
+    private get effectiveVirtualizeThreshold();
+    private get isVirtualized();
+    private stageLabel;
+    private chunkCountText;
+    private onRetryClick;
+    private onCancelClick;
+    private itemTemplate;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lr-ingestion-queue': LyraIngestionQueue;
+    }
+}
+//# sourceMappingURL=ingestion-queue.class.d.ts.map

package/dist/components/retrieval/ingestion-queue/ingestion-queue.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingestion-queue.class.d.ts","sourceRoot":"","sources":["../../../../src/components/retrieval/ingestion-queue/ingestion-queue.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,cAAc,EAA0B,MAAM,KAAK,CAAC;AAGtF,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAIhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAK7F,OAAO,+BAA+B,CAAC;AACvC,OAAO,yCAAyC,CAAC;AACjD,OAAO,+BAA+B,CAAC;AACvC,OAAO,2CAA2C,CAAC;AAGnD;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,UAAU,GACV,WAAW,GACX,UAAU,GACV,MAAM,GACN,QAAQ,GACR,WAAW,CAAC;AAuBhB;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,cAAc,CAAC;IACtB;oGACgG;IAChG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mGAAmG;IACnG,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;0BAG0B;AAC1B,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IACjE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;iGAEiG;AACjG,MAAM,WAAW,0BAA2B,SAAQ,iBAAiB;IACnE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,WAAW,CAAC,yBAAyB,CAAC,CAAC;IACnD,WAAW,EAAE,WAAW,CAAC,0BAA0B,CAAC,CAAC;CACtD;AA2BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,qBAAa,kBAAmB,SAAQ,WAAW,CAAC,0BAA0B,CAAC;IAC7E,MAAM,CAAC,MAAM,iCAAgC;IAE7C;wEACoE;IACpC,KAAK,EAAE,kBAAkB,EAAE,CAAM;IAEjE;iDAC6C;IACjC,KAAK,SAAM;IAEvB,0FAA0F;IAC3B,mBAAmB,SAAgC;IAElH;;;2EAGuE;IACvE,OAAO,KAAK,4BAA4B,GAEvC;IAED,OAAO,KAAK,aAAa,GAExB;IAED,OAAO,CAAC,UAAU;IAuBlB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,YAAY,CA+ElB;IAEF,MAAM,IAAI,cAAc,CA8BvB;CACF;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,oBAAoB,EAAE,kBAAkB,CAAC;KAC1C;CACF"}