@aceshooting/lyra-ui 2.1.0 → 2.2.0

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

@@ -0,0 +1,304 @@
+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>
+  `;
+}
+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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"}

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

@@ -1,143 +1,2 @@
-import { type TemplateResult, type PropertyValues } from 'lit';
-import { LyraElement } from '../../internal/lyra-element.js';
-export type DocumentPreviewStatus = 'idle' | 'converting' | 'ready' | 'error';
-/**
- * `<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 {
-    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;
-    }
-}
+export * from './document-preview.class.js';
+//# sourceMappingURL=document-preview.d.ts.map

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

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