@aceshooting/lyra-ui 2.1.0 → 2.3.0

package/dist/components/document-preview/document-preview.class.d.ts

@@ -0,0 +1,153 @@
+import { type TemplateResult, type PropertyValues } from 'lit';
+import { LyraElement } from '../../internal/lyra-element.js';
+export type DocumentPreviewStatus = 'idle' | 'converting' | 'ready' | 'error';
+export interface LyraDocumentPreviewEventMap {
+    'lyra-render-error': CustomEvent<{
+        error: unknown;
+    }>;
+    'lyra-download': CustomEvent<{
+        src: string;
+        filename: string;
+    }>;
+}
+/**
+ * `<lyra-document-preview>` — a format-dispatching viewer for one document/
+ * attachment, plus the visual state machine for an async server-side
+ * conversion a host app runs in front of it.
+ *
+ * Format dispatch is intentionally minimal (see this family's scope
+ * guidance): only `text/*`/`application/json` (plain, scrollable `<pre>` —
+ * no syntax highlighting; compose `<lyra-code-block>` yourself via the
+ * `unsupported` slot for that) and `image/*` (a contained `<img>`) render
+ * inline. Everything else — PDF, office documents, video, audio, or any
+ * unrecognized MIME type — falls back to a generic "can't preview this"
+ * state: a file glyph, a short message, and (when `src` is set) a native
+ * `<a download>` link. This is a deliberate ceiling, not a gap: this
+ * component ships a dispatch *shell*, not a format registry. The
+ * `unsupported` slot is the escape hatch for every format left out of the
+ * built-in three — plug in a PDF.js viewer, an office-doc renderer, a
+ * `<lyra-code-block>`, or anything else keyed off `mime-type` yourself.
+ *
+ * `status="converting"` is a second, independent axis from format dispatch.
+ * This component does not know your backend's conversion API shape and
+ * therefore owns none of the actual polling/fetch — a host that's converting
+ * a non-natively-previewable format server-side (e.g. .docx → .pdf) polls
+ * its own backend and updates `status`/`progress`/`src` here as that
+ * proceeds. This component only *visualizes* that state: an indeterminate
+ * spinner, or a determinate one once `progress` is supplied. Once the host
+ * flips `status` to `"ready"` (typically alongside a new `src`/`mime-type`
+ * pointing at the converted artifact), normal format dispatch resumes.
+ *
+ * The one piece of async work this component *does* own is fetching a
+ * `text/*`/`application/json` `src` itself (there's no other way to get a
+ * `<pre>`'s text content from a URL) — gated behind the same generation-
+ * counter guard `<lyra-tool-result-view>`'s `resolve()` uses, so a `src`
+ * reassigned mid-fetch can't have a stale response clobber a newer one. A
+ * failure here (network error, non-2xx response) renders inline via
+ * `[part="error"]` and fires `lyra-render-error`, independently of the
+ * host-owned `status` prop — mirrors `<lyra-markdown>`'s identical stance
+ * that a *rendering* failure and a host's own state machine are different
+ * concerns.
+ *
+ * Every `src` is validated for the DOM/API sink that consumes it. Text
+ * fetches and image sources allow relative URLs plus `http:`, `https:`,
+ * `blob:`, and `data:`. Download links deliberately exclude `data:` because
+ * following a `data:text/html` URL can create an active document. Unsafe or
+ * malformed URLs never reach `fetch()`, an image `src`, or an anchor `href`;
+ * they render a non-interactive fallback/error instead.
+ *
+ * Accessibility: the `"converting"` state (no numeric `progress`) is a
+ * `role="status"` region wrapping a visually-hidden "Converting document…"
+ * string. This is a *plain* static region, not routed through
+ * `<lyra-live-region>`/`Announcer` — like `<lyra-typing-indicator>`'s
+ * identical judgement call (see that component's class doc), this only ever
+ * has one thing to announce (entering the state), not a rapidly-repeating
+ * stream of updates, so the coalescing machinery a high-frequency component
+ * needs would be pure overhead here. Once real `progress` is available, the
+ * region becomes a standard `role="progressbar"` instead, which is
+ * self-describing via `aria-valuenow` with no extra live-region wiring
+ * needed. `status="error"` renders `[part="error"]` as `role="alert"` — an
+ * assertive, one-shot failure notice, the same native-role shortcut
+ * `<lyra-live-region>`'s own `mode="assertive"` maps to, without requiring
+ * the announcer machinery here either.
+ *
+ * @customElement lyra-document-preview
+ * @slot unsupported - Escape hatch: when populated, its content renders
+ *   *instead of* the generic download fallback for any `mime-type` this
+ *   component doesn't natively support (i.e. whenever format dispatch would
+ *   otherwise fall through to "generic"). Ignored while `mime-type` resolves
+ *   to `text`/`image` dispatch, or while `status` is `"converting"`/`"error"`.
+ * @event lyra-download - `detail: { src, filename }` — fired when the safe
+ *   generic-download fallback link is activated. The browser download itself
+ *   needs no JS (a plain `<a download>` handles it); this is purely for a host
+ *   that wants to observe/log the download.
+ * @event lyra-render-error - `detail: { error }` — fired when this
+ *   component's own `text/*`/`application/json` `fetch(src)` fails. Distinct
+ *   from `status="error"`, which is entirely host-driven (see the class
+ *   doc).
+ * @csspart base - The root container.
+ * @csspart header - The row above the body, holding `filename`. Hidden entirely when `filename` is unset.
+ * @csspart filename - The filename text.
+ * @csspart body - The wrapper around whichever content is currently showing (text/image preview, the generic fallback, the spinner, or the error message).
+ * @csspart spinner - The converting/loading indicator — indeterminate (`role="status"`) or, once numeric progress is known, a determinate `role="progressbar"`. Used both for `status="converting"` and for this component's own in-flight text fetch.
+ * @csspart error - The error message region (`role="alert"`) — used both for `status="error"` and for a failed text fetch.
+ * @csspart download-link - The `<a download>` affordance in the generic fallback. Only rendered when `src` is set and safe for link navigation.
+ */
+export declare class LyraDocumentPreview extends LyraElement<LyraDocumentPreviewEventMap> {
+    static styles: import("lit").CSSResultGroup[];
+    /** URL to fetch (for `text`/`application/json`) or display (`image`, or as
+     *  the generic fallback's download `href`). The value is validated against
+     *  a sink-specific scheme allowlist before use. Optional — gracefully
+     *  absent while, e.g., a conversion is still in progress. */
+    src: string;
+    /** Drives format dispatch — see the class doc. */
+    mimeType: string;
+    /** Shown in the header and used as the download link's suggested filename. */
+    filename: string;
+    /** Host-owned lifecycle state. `"converting"` shows the spinner regardless
+     *  of `mime-type`/`src`; `"error"` shows `errorMessage` regardless of
+     *  either. `"idle"`/`"ready"` both resume normal format dispatch — this
+     *  component doesn't require a host that has no conversion step to ever
+     *  set `"ready"` explicitly. */
+    status: DocumentPreviewStatus;
+    /** 0-100. Only consulted while `status="converting"`. Unset (the default)
+     *  renders the indeterminate spinner instead of a determinate progress bar. */
+    progress?: number;
+    /** Shown (via `[part="error"]`) while `status="error"`. */
+    errorMessage: string;
+    /** A CSS length (e.g. `"24rem"`); once set, `[part="body"]` scrolls
+     *  internally past this height instead of growing the page — same
+     *  contract as `<lyra-json-viewer>`'s identically-named prop. */
+    maxHeight: string;
+    private hasUnsupportedSlot;
+    private textFetch;
+    private fetchGeneration;
+    protected willUpdate(changed: PropertyValues): void;
+    private fetchText;
+    private onUnsupportedSlotChange;
+    private onDownloadClick;
+    /** Renders `[part="spinner"]` -- indeterminate (`role="status"` + a
+     *  visually-hidden label, per the class doc's accessibility note) when
+     *  `progressValue` is absent, or a `role="progressbar"` once it's a finite
+     *  0-100 number. Shared by the host-driven `"converting"` state and this
+     *  component's own in-flight text fetch (which never has a numeric
+     *  progress of its own to report). */
+    private renderSpinner;
+    private renderError;
+    private renderTextPreview;
+    private renderImagePreview;
+    private renderDownloadFallback;
+    /** The `<slot>` element renders unconditionally (not just while
+     *  `hasUnsupportedSlot`) so a slot-assignment change is always observable
+     *  via `slotchange` -- same reasoning as `<lyra-chat-message>`'s
+     *  always-rendered optional slots. */
+    private renderGenericFallback;
+    private renderBody;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lyra-document-preview': LyraDocumentPreview;
+    }
+}
+//# sourceMappingURL=document-preview.class.d.ts.map

package/dist/components/document-preview/document-preview.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-preview.class.d.ts","sourceRoot":"","sources":["../../../src/components/document-preview/document-preview.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,cAAc,EAA0B,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAE3G,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAK7D,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,YAAY,GAAG,OAAO,GAAG,OAAO,CAAC;AAoF9E,MAAM,WAAW,2BAA2B;IAC1C,mBAAmB,EAAE,WAAW,CAAC;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACrD,eAAe,EAAE,WAAW,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE;AACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkFG;AACH,qBAAa,mBAAoB,SAAQ,WAAW,CAAC,2BAA2B,CAAC;IAC/E,MAAM,CAAC,MAAM,iCAAwC;IAErD;;;iEAG6D;IACjD,GAAG,SAAM;IAErB,kDAAkD;IACZ,QAAQ,SAAM;IAEpD,8EAA8E;IAClE,QAAQ,SAAM;IAE1B;;;;oCAIgC;IACH,MAAM,EAAE,qBAAqB,CAAU;IAEpE;mFAC+E;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE9C,2DAA2D;IACjB,YAAY,SAAM;IAE5D;;qEAEiE;IAC1B,SAAS,SAAM;IAE7C,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,SAAS,CAAmC;IAM7D,OAAO,CAAC,eAAe,CAAK;IAE5B,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CA+BlD;YAEa,SAAS;IAiBvB,OAAO,CAAC,uBAAuB,CAE7B;IAEF,OAAO,CAAC,eAAe,CAErB;IAEF;;;;;0CAKsC;IACtC,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,sBAAsB;IAuB9B;;;0CAGsC;IACtC,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,UAAU;IAclB,MAAM,IAAI,cAAc,CASvB;CACF;AAGD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,uBAAuB,EAAE,mBAAmB,CAAC;KAC9C;CACF"}

package/dist/components/document-preview/document-preview.class.js

@@ -0,0 +1,387 @@
+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, svg } from 'lit';
+import { property, state } from 'lit/decorators.js';
+import { LyraElement } from '../../internal/lyra-element.js';
+import { srOnly } from '../../internal/a11y.js';
+import { safeFetchUrl, safeLinkHref, safeMediaSrc } from '../../internal/safe-url.js';
+import { styles } from './document-preview.styles.js';
+const IDLE_TEXT_FETCH = { kind: 'idle' };
+function classifyFormat(mimeType) {
+    const mt = mimeType.trim().toLowerCase();
+    if (mt.startsWith('text/') || mt === 'application/json')
+        return 'text';
+    if (mt.startsWith('image/'))
+        return 'image';
+    return 'generic';
+}
+// Mirrors the shared icon set's viewBox/stroke conventions
+// (internal/icons.ts's chevronIcon()/closeIcon()/etc.) without adding
+// document/download glyphs to that module -- it's off limits here -- so
+// these one-off icons still read as part of the same visual language as the
+// rest of the library's inline icons.
+const ICON_VIEW_BOX = '0 0 24 24';
+const ICON_STROKE_WIDTH = '1.75';
+/** A generic "document" glyph for the can't-preview-this fallback. Same
+ *  shape as `<lyra-attachment-chip>`'s local `fileGlyph()` -- duplicated
+ *  rather than imported (these are two independently consumable components)
+ *  but kept visually identical so an unpreviewable-file affordance reads the
+ *  same wherever it shows up in the library. */
+function fileGlyph() {
+    return svg `
+    <svg
+      width="1em"
+      height="1em"
+      viewBox=${ICON_VIEW_BOX}
+      fill="none"
+      stroke="currentColor"
+      stroke-width=${ICON_STROKE_WIDTH}
+      stroke-linecap="round"
+      stroke-linejoin="round"
+      aria-hidden="true"
+      focusable="false"
+    ><path d="M6 2h8l6 6v12a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2Z"></path><polyline points="14 2 14 8 20 8"></polyline></svg>
+  `;
+}
+/** A downward arrow into a tray -- the conventional "download" glyph. */
+function downloadIcon() {
+    return icon(svg `
+    <path d="M12 3v12"></path>
+    <polyline points="7 11 12 16 17 11"></polyline>
+    <path d="M4 18v2a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-2"></path>
+  `);
+}
+function icon(paths) {
+    return svg `
+    <svg
+      width="1em"
+      height="1em"
+      viewBox=${ICON_VIEW_BOX}
+      fill="none"
+      stroke="currentColor"
+      stroke-width=${ICON_STROKE_WIDTH}
+      stroke-linecap="round"
+      stroke-linejoin="round"
+      aria-hidden="true"
+      focusable="false"
+    >${paths}</svg>
+  `;
+}
+/**
+ * `<lyra-document-preview>` — a format-dispatching viewer for one document/
+ * attachment, plus the visual state machine for an async server-side
+ * conversion a host app runs in front of it.
+ *
+ * Format dispatch is intentionally minimal (see this family's scope
+ * guidance): only `text/*`/`application/json` (plain, scrollable `<pre>` —
+ * no syntax highlighting; compose `<lyra-code-block>` yourself via the
+ * `unsupported` slot for that) and `image/*` (a contained `<img>`) render
+ * inline. Everything else — PDF, office documents, video, audio, or any
+ * unrecognized MIME type — falls back to a generic "can't preview this"
+ * state: a file glyph, a short message, and (when `src` is set) a native
+ * `<a download>` link. This is a deliberate ceiling, not a gap: this
+ * component ships a dispatch *shell*, not a format registry. The
+ * `unsupported` slot is the escape hatch for every format left out of the
+ * built-in three — plug in a PDF.js viewer, an office-doc renderer, a
+ * `<lyra-code-block>`, or anything else keyed off `mime-type` yourself.
+ *
+ * `status="converting"` is a second, independent axis from format dispatch.
+ * This component does not know your backend's conversion API shape and
+ * therefore owns none of the actual polling/fetch — a host that's converting
+ * a non-natively-previewable format server-side (e.g. .docx → .pdf) polls
+ * its own backend and updates `status`/`progress`/`src` here as that
+ * proceeds. This component only *visualizes* that state: an indeterminate
+ * spinner, or a determinate one once `progress` is supplied. Once the host
+ * flips `status` to `"ready"` (typically alongside a new `src`/`mime-type`
+ * pointing at the converted artifact), normal format dispatch resumes.
+ *
+ * The one piece of async work this component *does* own is fetching a
+ * `text/*`/`application/json` `src` itself (there's no other way to get a
+ * `<pre>`'s text content from a URL) — gated behind the same generation-
+ * counter guard `<lyra-tool-result-view>`'s `resolve()` uses, so a `src`
+ * reassigned mid-fetch can't have a stale response clobber a newer one. A
+ * failure here (network error, non-2xx response) renders inline via
+ * `[part="error"]` and fires `lyra-render-error`, independently of the
+ * host-owned `status` prop — mirrors `<lyra-markdown>`'s identical stance
+ * that a *rendering* failure and a host's own state machine are different
+ * concerns.
+ *
+ * Every `src` is validated for the DOM/API sink that consumes it. Text
+ * fetches and image sources allow relative URLs plus `http:`, `https:`,
+ * `blob:`, and `data:`. Download links deliberately exclude `data:` because
+ * following a `data:text/html` URL can create an active document. Unsafe or
+ * malformed URLs never reach `fetch()`, an image `src`, or an anchor `href`;
+ * they render a non-interactive fallback/error instead.
+ *
+ * Accessibility: the `"converting"` state (no numeric `progress`) is a
+ * `role="status"` region wrapping a visually-hidden "Converting document…"
+ * string. This is a *plain* static region, not routed through
+ * `<lyra-live-region>`/`Announcer` — like `<lyra-typing-indicator>`'s
+ * identical judgement call (see that component's class doc), this only ever
+ * has one thing to announce (entering the state), not a rapidly-repeating
+ * stream of updates, so the coalescing machinery a high-frequency component
+ * needs would be pure overhead here. Once real `progress` is available, the
+ * region becomes a standard `role="progressbar"` instead, which is
+ * self-describing via `aria-valuenow` with no extra live-region wiring
+ * needed. `status="error"` renders `[part="error"]` as `role="alert"` — an
+ * assertive, one-shot failure notice, the same native-role shortcut
+ * `<lyra-live-region>`'s own `mode="assertive"` maps to, without requiring
+ * the announcer machinery here either.
+ *
+ * @customElement lyra-document-preview
+ * @slot unsupported - Escape hatch: when populated, its content renders
+ *   *instead of* the generic download fallback for any `mime-type` this
+ *   component doesn't natively support (i.e. whenever format dispatch would
+ *   otherwise fall through to "generic"). Ignored while `mime-type` resolves
+ *   to `text`/`image` dispatch, or while `status` is `"converting"`/`"error"`.
+ * @event lyra-download - `detail: { src, filename }` — fired when the safe
+ *   generic-download fallback link is activated. The browser download itself
+ *   needs no JS (a plain `<a download>` handles it); this is purely for a host
+ *   that wants to observe/log the download.
+ * @event lyra-render-error - `detail: { error }` — fired when this
+ *   component's own `text/*`/`application/json` `fetch(src)` fails. Distinct
+ *   from `status="error"`, which is entirely host-driven (see the class
+ *   doc).
+ * @csspart base - The root container.
+ * @csspart header - The row above the body, holding `filename`. Hidden entirely when `filename` is unset.
+ * @csspart filename - The filename text.
+ * @csspart body - The wrapper around whichever content is currently showing (text/image preview, the generic fallback, the spinner, or the error message).
+ * @csspart spinner - The converting/loading indicator — indeterminate (`role="status"`) or, once numeric progress is known, a determinate `role="progressbar"`. Used both for `status="converting"` and for this component's own in-flight text fetch.
+ * @csspart error - The error message region (`role="alert"`) — used both for `status="error"` and for a failed text fetch.
+ * @csspart download-link - The `<a download>` affordance in the generic fallback. Only rendered when `src` is set and safe for link navigation.
+ */
+export class LyraDocumentPreview extends LyraElement {
+    constructor() {
+        super(...arguments);
+        /** URL to fetch (for `text`/`application/json`) or display (`image`, or as
+         *  the generic fallback's download `href`). The value is validated against
+         *  a sink-specific scheme allowlist before use. Optional — gracefully
+         *  absent while, e.g., a conversion is still in progress. */
+        this.src = '';
+        /** Drives format dispatch — see the class doc. */
+        this.mimeType = '';
+        /** Shown in the header and used as the download link's suggested filename. */
+        this.filename = '';
+        /** Host-owned lifecycle state. `"converting"` shows the spinner regardless
+         *  of `mime-type`/`src`; `"error"` shows `errorMessage` regardless of
+         *  either. `"idle"`/`"ready"` both resume normal format dispatch — this
+         *  component doesn't require a host that has no conversion step to ever
+         *  set `"ready"` explicitly. */
+        this.status = 'idle';
+        /** Shown (via `[part="error"]`) while `status="error"`. */
+        this.errorMessage = '';
+        /** A CSS length (e.g. `"24rem"`); once set, `[part="body"]` scrolls
+         *  internally past this height instead of growing the page — same
+         *  contract as `<lyra-json-viewer>`'s identically-named prop. */
+        this.maxHeight = '';
+        this.hasUnsupportedSlot = false;
+        this.textFetch = IDLE_TEXT_FETCH;
+        // Bumped on every fetchText() call so a stale in-flight fetch (superseded
+        // by a newer src/mime-type/status before it settles) can detect it's no
+        // longer current and skip writing its result over a more recent one --
+        // same guard <lyra-tool-result-view>'s resolve() uses.
+        this.fetchGeneration = 0;
+        this.onUnsupportedSlotChange = (e) => {
+            this.hasUnsupportedSlot = e.target.assignedElements({ flatten: true }).length > 0;
+        };
+        this.onDownloadClick = () => {
+            this.emit('lyra-download', { src: this.src, filename: this.filename });
+        };
+    }
+    static { this.styles = [LyraElement.styles, styles, srOnly]; }
+    willUpdate(changed) {
+        if (!this.hasUpdated) {
+            this.hasUnsupportedSlot = Array.from(this.children).some((el) => el.getAttribute('slot') === 'unsupported');
+        }
+        const safeTextSrc = safeFetchUrl(this.src);
+        const shouldFetchText = classifyFormat(this.mimeType) === 'text' &&
+            safeTextSrc !== null &&
+            this.status !== 'converting' &&
+            this.status !== 'error';
+        if (shouldFetchText) {
+            // Refetch when the target itself changed, or when this just became
+            // fetchable (e.g. a "converting" -> "ready" transition) and nothing
+            // has been fetched yet -- but not on every unrelated property change.
+            if (!this.hasUpdated ||
+                changed.has('src') ||
+                changed.has('mimeType') ||
+                (changed.has('status') && this.textFetch.kind === 'idle')) {
+                void this.fetchText(safeTextSrc);
+            }
+        }
+        else if (this.textFetch.kind !== 'idle') {
+            // No longer applicable (format changed away from text, src cleared,
+            // or status moved to converting/error) -- invalidate any in-flight
+            // fetch and drop the stale result so a later re-entry starts clean.
+            this.fetchGeneration++;
+            this.textFetch = IDLE_TEXT_FETCH;
+        }
+    }
+    async fetchText(url) {
+        const generation = ++this.fetchGeneration;
+        this.textFetch = { kind: 'loading' };
+        try {
+            const response = await fetch(url);
+            if (!response.ok)
+                throw new Error(`${response.status} ${response.statusText}`);
+            const text = await response.text();
+            if (generation !== this.fetchGeneration)
+                return;
+            this.textFetch = { kind: 'loaded', text };
+        }
+        catch (error) {
+            if (generation !== this.fetchGeneration)
+                return;
+            const message = error instanceof Error ? error.message : 'Failed to load document.';
+            this.textFetch = { kind: 'error', message };
+            this.emit('lyra-render-error', { error });
+        }
+    }
+    /** Renders `[part="spinner"]` -- indeterminate (`role="status"` + a
+     *  visually-hidden label, per the class doc's accessibility note) when
+     *  `progressValue` is absent, or a `role="progressbar"` once it's a finite
+     *  0-100 number. Shared by the host-driven `"converting"` state and this
+     *  component's own in-flight text fetch (which never has a numeric
+     *  progress of its own to report). */
+    renderSpinner(label, progressValue) {
+        const hasProgress = progressValue != null && Number.isFinite(progressValue);
+        if (hasProgress) {
+            const clamped = Math.min(100, Math.max(0, progressValue));
+            const rounded = Math.round(clamped);
+            return html `
+        <div
+          part="spinner"
+          role="progressbar"
+          aria-valuenow=${rounded}
+          aria-valuemin="0"
+          aria-valuemax="100"
+          aria-label=${label}
+        >
+          <span class="ring determinate" style=${`--lyra-document-preview-progress:${clamped}`}></span>
+          <span class="spinner-text">${rounded}%</span>
+        </div>
+      `;
+        }
+        return html `
+      <div part="spinner" role="status">
+        <span class="ring" aria-hidden="true"></span>
+        <span class="sr-only">${label}</span>
+      </div>
+    `;
+    }
+    renderError(message) {
+        return html `<div part="error" role="alert">${message || 'Something went wrong.'}</div>`;
+    }
+    renderTextPreview() {
+        if (this.src === '')
+            return html `<p class="empty-note">No document to display.</p>`;
+        if (safeFetchUrl(this.src) === null)
+            return this.renderError('Document URL is not allowed.');
+        switch (this.textFetch.kind) {
+            case 'loaded':
+                return html `<pre class="text">${this.textFetch.text}</pre>`;
+            case 'error':
+                return this.renderError(this.textFetch.message);
+            case 'loading':
+            case 'idle':
+            default:
+                return this.renderSpinner('Loading document…');
+        }
+    }
+    renderImagePreview() {
+        if (this.src === '')
+            return html `<p class="empty-note">No image to display.</p>`;
+        const src = safeMediaSrc(this.src);
+        if (src === null)
+            return this.renderDownloadFallback();
+        return html `<img src=${src} alt=${this.filename || 'Document preview'} />`;
+    }
+    renderDownloadFallback() {
+        const label = this.filename || 'this file';
+        const href = safeLinkHref(this.src);
+        return html `
+      <div class="fallback">
+        <span class="fallback-icon" aria-hidden="true">${fileGlyph()}</span>
+        <p class="fallback-text">Preview not available for ${label}.</p>
+        ${href !== null
+            ? html `
+              <a
+                part="download-link"
+                href=${href}
+                download=${this.filename || ''}
+                @click=${this.onDownloadClick}
+              >
+                ${downloadIcon()}<span>Download</span>
+              </a>
+            `
+            : nothing}
+      </div>
+    `;
+    }
+    /** The `<slot>` element renders unconditionally (not just while
+     *  `hasUnsupportedSlot`) so a slot-assignment change is always observable
+     *  via `slotchange` -- same reasoning as `<lyra-chat-message>`'s
+     *  always-rendered optional slots. */
+    renderGenericFallback() {
+        return html `
+      <slot name="unsupported" @slotchange=${this.onUnsupportedSlotChange}></slot>
+      ${this.hasUnsupportedSlot ? nothing : this.renderDownloadFallback()}
+    `;
+    }
+    renderBody() {
+        if (this.status === 'converting')
+            return this.renderSpinner('Converting document…', this.progress);
+        if (this.status === 'error')
+            return this.renderError(this.errorMessage);
+        switch (classifyFormat(this.mimeType)) {
+            case 'text':
+                return this.renderTextPreview();
+            case 'image':
+                return this.renderImagePreview();
+            default:
+                return this.renderGenericFallback();
+        }
+    }
+    render() {
+        return html `
+      <div part="base" style=${this.maxHeight ? `--lyra-document-preview-max-height:${this.maxHeight}` : nothing}>
+        <div part="header" ?hidden=${!this.filename}>
+          <span part="filename" title=${this.filename}>${this.filename}</span>
+        </div>
+        <div part="body">${this.renderBody()}</div>
+      </div>
+    `;
+    }
+}
+__decorate([
+    property()
+], LyraDocumentPreview.prototype, "src", void 0);
+__decorate([
+    property({ attribute: 'mime-type' })
+], LyraDocumentPreview.prototype, "mimeType", void 0);
+__decorate([
+    property()
+], LyraDocumentPreview.prototype, "filename", void 0);
+__decorate([
+    property({ reflect: true })
+], LyraDocumentPreview.prototype, "status", void 0);
+__decorate([
+    property({ type: Number })
+], LyraDocumentPreview.prototype, "progress", void 0);
+__decorate([
+    property({ attribute: 'error-message' })
+], LyraDocumentPreview.prototype, "errorMessage", void 0);
+__decorate([
+    property({ attribute: 'max-height' })
+], LyraDocumentPreview.prototype, "maxHeight", void 0);
+__decorate([
+    state()
+], LyraDocumentPreview.prototype, "hasUnsupportedSlot", void 0);
+__decorate([
+    state()
+], LyraDocumentPreview.prototype, "textFetch", void 0);
+//# sourceMappingURL=document-preview.class.js.map

package/dist/components/document-preview/document-preview.class.js.map

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