@aceshooting/lyra-ui 4.2.0 → 5.0.0

package/dist/components/viewers/html-viewer/html-viewer.class.js

@@ -0,0 +1,100 @@
+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 { unsafeHTML } from 'lit/directives/unsafe-html.js';
+import { LyraElement } from '../../../internal/lyra-element.js';
+import { safeFetchUrl } from '../../../internal/safe-url.js';
+import { isAbortError, isResourceLimitError, LyraUserFacingError, readResponseText } from '../../../internal/resource-loader.js';
+import { srOnly } from '../../../internal/a11y.js';
+import { loadHtmlSanitizer } from './dompurify-loader.js';
+import { styles } from './html-viewer.styles.js';
+/**
+ * Fetches and safely renders an inline HTML document.
+ *
+ * @customElement lr-html-viewer
+ * @event lr-render-error - Fired when fetching or sanitizing the document fails.
+ * @csspart base - The root container.
+ * @csspart body - The wrapper around the fetched-state content.
+ * @csspart html - The sanitized HTML document, once loaded.
+ * @csspart spinner - The loading region.
+ * @csspart error - The error region.
+ */
+export class LyraHtmlViewer extends LyraElement {
+    constructor() {
+        super(...arguments);
+        /** URL to fetch and render as sanitized inline HTML. */
+        this.src = '';
+        /** Accessible name for the rendered HTML document. */
+        this.name = '';
+        /** CSS length that caps the scrollable body. */
+        this.maxHeight = '';
+        this.fetchState = { kind: 'idle' };
+        this.generation = 0;
+    }
+    static { this.styles = [LyraElement.styles, styles, srOnly]; }
+    updated(changed) {
+        if (changed.has('src'))
+            this.scheduleAfterUpdate(() => { void this.load(); });
+    }
+    async load() {
+        const generation = ++this.generation;
+        const signal = this.beginAbortableLoad();
+        if (!this.src) {
+            this.fetchState = { kind: 'idle' };
+            return;
+        }
+        const url = safeFetchUrl(this.src);
+        if (!url) {
+            this.fetchState = { kind: 'error', message: this.localize('documentPreviewUrlNotAllowed') };
+            return;
+        }
+        this.fetchState = { kind: 'loading' };
+        try {
+            const response = await fetch(url, signal ? { signal } : undefined);
+            if (!response.ok)
+                throw new Error(`${response.status} ${response.statusText}`);
+            const sanitizer = await loadHtmlSanitizer();
+            if (!sanitizer)
+                throw new LyraUserFacingError(this.localize('documentViewerMissingSanitizer'));
+            const markup = sanitizer.sanitize(await readResponseText(response));
+            if (generation === this.generation)
+                this.fetchState = { kind: 'loaded', markup };
+        }
+        catch (error) {
+            if (isAbortError(error) || !this.isConnected || generation !== this.generation)
+                return;
+            this.fetchState = { kind: 'error', message: error instanceof LyraUserFacingError ? error.message : this.localize(isResourceLimitError(error) ? 'documentPreviewResourceTooLarge' : 'documentPreviewFailedToLoad') };
+            this.emit('lr-render-error', { error });
+        }
+    }
+    renderBody() {
+        switch (this.fetchState.kind) {
+            case 'loaded': return html `<div part="html" role="document" aria-label=${this.name || this.localize('htmlViewerLabel')}>${unsafeHTML(this.fetchState.markup)}</div>`;
+            case 'loading': return html `<div part="spinner" role="status"><span class="sr-only">${this.localize('loadingDocument')}</span></div>`;
+            case 'error': return html `<div part="error" role="alert">${this.fetchState.message}</div>`;
+            case 'idle':
+            default: return html `<p class="empty-note">${this.localize('documentPreviewEmpty', undefined, { type: this.localize('documentPreviewTypeDocument') })}</p>`;
+        }
+    }
+    render() {
+        return html `<div part="base" style=${this.maxHeight ? `--lr-html-viewer-max-height:${this.maxHeight}` : nothing}><div part="body">${this.renderBody()}</div></div>`;
+    }
+}
+__decorate([
+    property()
+], LyraHtmlViewer.prototype, "src", void 0);
+__decorate([
+    property()
+], LyraHtmlViewer.prototype, "name", void 0);
+__decorate([
+    property({ attribute: 'max-height' })
+], LyraHtmlViewer.prototype, "maxHeight", void 0);
+__decorate([
+    state()
+], LyraHtmlViewer.prototype, "fetchState", void 0);
+//# sourceMappingURL=html-viewer.class.js.map

package/dist/components/viewers/html-viewer/html-viewer.class.js.map

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

package/dist/components/viewers/html-viewer/html-viewer.d.ts.map

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

package/dist/components/viewers/html-viewer/html-viewer.js

@@ -0,0 +1,15 @@
+export * from './html-viewer.class.js';
+import { LyraHtmlViewer } from './html-viewer.class.js';
+import { defineElement } from '../../../internal/prefix.js';
+import { registerDocumentRenderer } from '../document-viewer/registry.js';
+defineElement('html-viewer', LyraHtmlViewer);
+registerDocumentRenderer('text/html', {
+    matches: (file) => /\.html?$/i.test(file.name),
+    render: (file) => {
+        const element = document.createElement('lr-html-viewer');
+        element.src = file.src;
+        element.name = file.name;
+        return element;
+    },
+});
+//# sourceMappingURL=html-viewer.js.map

package/dist/components/viewers/html-viewer/html-viewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-viewer.js","sourceRoot":"","sources":["../../../../src/components/viewers/html-viewer/html-viewer.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAqB,MAAM,gCAAgC,CAAC;AAE7F,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;AAC7C,wBAAwB,CAAC,WAAW,EAAE;IACpC,OAAO,EAAE,CAAC,IAAkB,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAC5D,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QACf,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACvB,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACzB,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAC,CAAC"}

package/dist/components/viewers/html-viewer/html-viewer.styles.d.ts.map

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

package/dist/components/viewers/html-viewer/html-viewer.styles.js.map

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

package/dist/components/viewers/include/include.class.d.ts

@@ -0,0 +1,104 @@
+import { type PropertyValues, type TemplateResult } from 'lit';
+import { LyraElement } from '../../../internal/lyra-element.js';
+/** `fetch()`'s `RequestMode` values this component accepts. */
+export type LyraIncludeMode = 'cors' | 'no-cors' | 'same-origin';
+/**
+ * Why a `lr-include-error` fired instead of a successful `lr-load`:
+ * - `'blocked-url'` — `src` failed the shared `safeFetchUrl()` scheme
+ *   allowlist; `fetch()` was never called.
+ * - `'network'` — `fetch()` itself rejected (DNS/CORS/connection failure).
+ * - `'http'` — the fetch completed but the response was not `ok`.
+ * - `'missing-sanitizer'` — the fetch succeeded but the optional `dompurify`
+ *   peer failed to load, so the fragment could not be sanitized.
+ * - `'resource-too-large'` — the response body exceeded the shared resource
+ *   loader's size cap.
+ */
+export type LyraIncludeErrorReason = 'blocked-url' | 'network' | 'http' | 'missing-sanitizer' | 'resource-too-large';
+export interface LyraIncludeEventMap {
+    'lr-load': CustomEvent<{
+        src: string;
+    }>;
+    'lr-include-error': CustomEvent<{
+        status: number;
+        reason: LyraIncludeErrorReason;
+        error?: unknown;
+    }>;
+}
+/**
+ * `<lr-include>` fetches an HTML fragment from `src` and transcludes it into
+ * the page as sanitized light-DOM content, so the fragment participates in
+ * the surrounding page's CSS cascade exactly like a native server-side
+ * include — unlike `<lr-html-viewer>`, which renders a foreign document
+ * inside an isolated preview card.
+ *
+ * The fetched markup always passes through the shared DOMPurify-backed
+ * sanitizer (`loadHtmlSanitizer()`, the same loader `<lr-html-viewer>`
+ * uses) before it ever touches `innerHTML` — there is no `allow-scripts`
+ * escape hatch here, unlike the Web Awesome/Shoelace components this element
+ * otherwise mirrors: their raw, unsanitized injection (with an opt-in to
+ * actually re-execute embedded `<script>` tags) is incompatible with this
+ * library's sanitize-always contract, so that option is simply omitted
+ * rather than shipped as a documented no-op.
+ *
+ * `mode` deliberately defaults to `'same-origin'` rather than the `'cors'`
+ * default those upstream components document — a same-origin-only fetch
+ * fails closed unless a consumer explicitly opts in to cross-origin fetching
+ * with `mode="cors"` (and the remote server cooperates via CORS headers).
+ * `'no-cors'` is accepted for enum completeness but is rarely useful: it
+ * always yields an opaque response (`status` `0`, unreadable body), a Fetch
+ * API platform limitation rather than a bug here.
+ *
+ * This is a deliberately bare transclusion primitive with no label/hint/
+ * error chrome — its interaction idiom (silently swapping light-DOM content)
+ * is incompatible with a generic label/hint/error frame. Listen for
+ * `lr-include-error` to build your own error UI, and author meaningful
+ * fallback content inside `<lr-include>` for when the fetch never
+ * succeeds; that fallback (and any previously successful include) is left
+ * untouched on failure. No `aria-live` region wraps the slot either: the
+ * fragment can contain its own landmarks and nested content, and forcing the
+ * whole host into a live region would re-announce all of it on every load.
+ *
+ * No implicit ARIA role and no computed accessible name are applied around
+ * the transcluded content — the fragment's own semantics (headings,
+ * landmarks, its own `role`/`aria-*` attributes) surface directly and
+ * unmodified, exactly as they would in a native include. `aria-busy="true"`
+ * is set on the host while a fetch is in flight and removed once it settles,
+ * whether it succeeds or fails.
+ *
+ * @customElement lr-include
+ * @slot - Fallback content shown until (or unless) a fetch succeeds; overwritten with the sanitized fragment once one does.
+ * @event lr-load - The fetched fragment was sanitized and written into the light DOM.
+ * @event lr-include-error - Fetching or sanitizing the fragment failed; see `LyraIncludeErrorReason` for `detail.reason`.
+ * @csspart base - The non-layout (`display: contents`) wrapper around the default slot.
+ */
+export declare class LyraInclude extends LyraElement<LyraIncludeEventMap> {
+    static styles: import("lit").CSSResultGroup[];
+    /**
+     * URL of the HTML fragment to fetch, validated through the shared
+     * `safeFetchUrl()` allowlist (`http:`, `https:`, `blob:`, `data:`).
+     * An empty/falsy value is a no-op: no fetch, no events, existing content
+     * untouched.
+     */
+    src: string;
+    /**
+     * Forwarded to `fetch(url, { mode })`. Deliberately defaults to
+     * `'same-origin'` rather than the `'cors'` default documented by the
+     * Web Awesome/Shoelace components this element otherwise mirrors — a
+     * consumer opts in to cross-origin fetching explicitly. An invalid/typo'd
+     * attribute value is defensively normalized back to `'same-origin'`
+     * rather than letting `fetch()` throw synchronously for an invalid
+     * `RequestMode`.
+     */
+    mode: LyraIncludeMode;
+    private generation;
+    protected updated(changed: PropertyValues): void;
+    private load;
+    private fail;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lr-include': LyraInclude;
+    }
+}
+//# sourceMappingURL=include.class.d.ts.map

package/dist/components/viewers/include/include.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"include.class.d.ts","sourceRoot":"","sources":["../../../../src/components/viewers/include/include.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAErE,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAMhE,+DAA+D;AAC/D,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,CAAC;AAIjE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,sBAAsB,GAAG,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,mBAAmB,GAAG,oBAAoB,CAAC;AAErH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,WAAW,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxC,kBAAkB,EAAE,WAAW,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,sBAAsB,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACtG;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,qBAAa,WAAY,SAAQ,WAAW,CAAC,mBAAmB,CAAC;IAC/D,MAAM,CAAC,MAAM,iCAAgC;IAE7C;;;;;OAKG;IAC0B,GAAG,SAAM;IAEtC;;;;;;;;OAQG;IAC0B,IAAI,EAAE,eAAe,CAAiB;IAEnE,OAAO,CAAC,UAAU,CAAK;IAEvB,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAI/C;YAEa,IAAI;IA0ClB,OAAO,CAAC,IAAI;IAKZ,MAAM,IAAI,cAAc,CAEvB;CACF;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,YAAY,EAAE,WAAW,CAAC;KAC3B;CACF"}

package/dist/components/viewers/include/include.class.js

@@ -0,0 +1,149 @@
+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 } from 'lit';
+import { property } from 'lit/decorators.js';
+import { LyraElement } from '../../../internal/lyra-element.js';
+import { safeFetchUrl } from '../../../internal/safe-url.js';
+import { isAbortError, isResourceLimitError, readResponseText } from '../../../internal/resource-loader.js';
+import { loadHtmlSanitizer } from '../html-viewer/dompurify-loader.js';
+import { styles } from './include.styles.js';
+const VALID_MODES = new Set(['cors', 'no-cors', 'same-origin']);
+/**
+ * `<lr-include>` fetches an HTML fragment from `src` and transcludes it into
+ * the page as sanitized light-DOM content, so the fragment participates in
+ * the surrounding page's CSS cascade exactly like a native server-side
+ * include — unlike `<lr-html-viewer>`, which renders a foreign document
+ * inside an isolated preview card.
+ *
+ * The fetched markup always passes through the shared DOMPurify-backed
+ * sanitizer (`loadHtmlSanitizer()`, the same loader `<lr-html-viewer>`
+ * uses) before it ever touches `innerHTML` — there is no `allow-scripts`
+ * escape hatch here, unlike the Web Awesome/Shoelace components this element
+ * otherwise mirrors: their raw, unsanitized injection (with an opt-in to
+ * actually re-execute embedded `<script>` tags) is incompatible with this
+ * library's sanitize-always contract, so that option is simply omitted
+ * rather than shipped as a documented no-op.
+ *
+ * `mode` deliberately defaults to `'same-origin'` rather than the `'cors'`
+ * default those upstream components document — a same-origin-only fetch
+ * fails closed unless a consumer explicitly opts in to cross-origin fetching
+ * with `mode="cors"` (and the remote server cooperates via CORS headers).
+ * `'no-cors'` is accepted for enum completeness but is rarely useful: it
+ * always yields an opaque response (`status` `0`, unreadable body), a Fetch
+ * API platform limitation rather than a bug here.
+ *
+ * This is a deliberately bare transclusion primitive with no label/hint/
+ * error chrome — its interaction idiom (silently swapping light-DOM content)
+ * is incompatible with a generic label/hint/error frame. Listen for
+ * `lr-include-error` to build your own error UI, and author meaningful
+ * fallback content inside `<lr-include>` for when the fetch never
+ * succeeds; that fallback (and any previously successful include) is left
+ * untouched on failure. No `aria-live` region wraps the slot either: the
+ * fragment can contain its own landmarks and nested content, and forcing the
+ * whole host into a live region would re-announce all of it on every load.
+ *
+ * No implicit ARIA role and no computed accessible name are applied around
+ * the transcluded content — the fragment's own semantics (headings,
+ * landmarks, its own `role`/`aria-*` attributes) surface directly and
+ * unmodified, exactly as they would in a native include. `aria-busy="true"`
+ * is set on the host while a fetch is in flight and removed once it settles,
+ * whether it succeeds or fails.
+ *
+ * @customElement lr-include
+ * @slot - Fallback content shown until (or unless) a fetch succeeds; overwritten with the sanitized fragment once one does.
+ * @event lr-load - The fetched fragment was sanitized and written into the light DOM.
+ * @event lr-include-error - Fetching or sanitizing the fragment failed; see `LyraIncludeErrorReason` for `detail.reason`.
+ * @csspart base - The non-layout (`display: contents`) wrapper around the default slot.
+ */
+export class LyraInclude extends LyraElement {
+    constructor() {
+        super(...arguments);
+        /**
+         * URL of the HTML fragment to fetch, validated through the shared
+         * `safeFetchUrl()` allowlist (`http:`, `https:`, `blob:`, `data:`).
+         * An empty/falsy value is a no-op: no fetch, no events, existing content
+         * untouched.
+         */
+        this.src = '';
+        /**
+         * Forwarded to `fetch(url, { mode })`. Deliberately defaults to
+         * `'same-origin'` rather than the `'cors'` default documented by the
+         * Web Awesome/Shoelace components this element otherwise mirrors — a
+         * consumer opts in to cross-origin fetching explicitly. An invalid/typo'd
+         * attribute value is defensively normalized back to `'same-origin'`
+         * rather than letting `fetch()` throw synchronously for an invalid
+         * `RequestMode`.
+         */
+        this.mode = 'same-origin';
+        this.generation = 0;
+    }
+    static { this.styles = [LyraElement.styles, styles]; }
+    updated(changed) {
+        if (changed.has('src') || changed.has('mode')) {
+            this.scheduleAfterUpdate(() => { void this.load(); });
+        }
+    }
+    async load() {
+        const generation = ++this.generation;
+        const signal = this.beginAbortableLoad();
+        // Unconditionally clear first: a superseded generation's in-flight fetch
+        // may still be settling (as an aborted/rejected promise) after this new
+        // generation starts, and none of its own early-return paths below touch
+        // aria-busy, so a stale "true" from that generation must not survive
+        // into this one. Re-set to 'true' just below if this generation actually
+        // reaches the fetch.
+        this.removeAttribute('aria-busy');
+        if (!this.src)
+            return; // idle no-op: no fetch, no events, content untouched
+        const url = safeFetchUrl(this.src);
+        if (!url) {
+            this.emit('lr-include-error', { status: 0, reason: 'blocked-url' });
+            return;
+        }
+        this.setAttribute('aria-busy', 'true');
+        const mode = VALID_MODES.has(this.mode) ? this.mode : 'same-origin';
+        try {
+            const response = await fetch(url, signal ? { mode, signal } : { mode });
+            if (!response.ok) {
+                if (generation === this.generation)
+                    this.fail(response.status, 'http');
+                return;
+            }
+            const sanitizer = await loadHtmlSanitizer();
+            if (!sanitizer) {
+                if (generation === this.generation)
+                    this.fail(0, 'missing-sanitizer');
+                return;
+            }
+            const markup = sanitizer.sanitize(await readResponseText(response));
+            if (generation !== this.generation || !this.isConnected)
+                return; // superseded/detached — silent
+            this.innerHTML = markup;
+            this.removeAttribute('aria-busy');
+            this.emit('lr-load', { src: this.src });
+        }
+        catch (error) {
+            if (isAbortError(error) || !this.isConnected || generation !== this.generation)
+                return; // silent
+            this.fail(0, isResourceLimitError(error) ? 'resource-too-large' : 'network', error);
+        }
+    }
+    fail(status, reason, error) {
+        this.removeAttribute('aria-busy');
+        this.emit('lr-include-error', { status, reason, error });
+    }
+    render() {
+        return html `<span part="base"><slot></slot></span>`;
+    }
+}
+__decorate([
+    property({ reflect: true })
+], LyraInclude.prototype, "src", void 0);
+__decorate([
+    property({ reflect: true })
+], LyraInclude.prototype, "mode", void 0);
+//# sourceMappingURL=include.class.js.map

package/dist/components/viewers/include/include.class.js.map

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

package/dist/components/viewers/include/include.d.ts.map

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

package/dist/components/viewers/include/include.js

@@ -0,0 +1,5 @@
+export * from './include.class.js';
+import { LyraInclude } from './include.class.js';
+import { defineElement } from '../../../internal/prefix.js';
+defineElement('include', LyraInclude);
+//# sourceMappingURL=include.js.map

package/dist/components/viewers/include/include.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"include.js","sourceRoot":"","sources":["../../../../src/components/viewers/include/include.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,aAAa,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC"}

package/dist/components/viewers/include/include.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"include.styles.d.ts","sourceRoot":"","sources":["../../../../src/components/viewers/include/include.styles.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,MAAM,yBAQlB,CAAC"}

package/dist/components/viewers/include/include.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"include.styles.js","sourceRoot":"","sources":["../../../../src/components/viewers/include/include.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,6EAA6E;AAC7E,yEAAyE;AACzE,qEAAqE;AACrE,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAA;;;;;;;;CAQxB,CAAC"}

package/dist/components/viewers/notebook-viewer/dompurify-loader.d.ts

@@ -0,0 +1,7 @@
+import type { OptionalPeerApi } from '../../../internal/optional-peer-types.js';
+export declare function loadNotebookSanitizerDeps(importDompurify?: () => Promise<{
+    default: OptionalPeerApi;
+}>): Promise<OptionalPeerApi | null>;
+export declare function loadNotebookSanitizer(): Promise<OptionalPeerApi | null>;
+export declare function clearNotebookSanitizerCache(): void;
+//# sourceMappingURL=dompurify-loader.d.ts.map

package/dist/components/viewers/notebook-viewer/dompurify-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dompurify-loader.d.ts","sourceRoot":"","sources":["../../../../src/components/viewers/notebook-viewer/dompurify-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAIhF,wBAAsB,yBAAyB,CAC7C,eAAe,GAAE,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,eAAe,CAAA;CAAE,CACG,GAC7D,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAUjC;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAGvE;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAElD"}

package/dist/components/viewers/notebook-viewer/dompurify-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dompurify-loader.js","sourceRoot":"","sources":["../../../../src/components/viewers/notebook-viewer/dompurify-loader.ts"],"names":[],"mappings":"AAEA,IAAI,SAAsD,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,eAAe,GAAgD,GAAG,EAAE,CAClE,MAAM,CAAC,WAAW,CAA0C;IAE9D,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CACV,iJAAiJ,EACjJ,KAAK,CACN,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,IAAI,CAAC,SAAS;QAAE,SAAS,GAAG,yBAAyB,EAAE,CAAC;IACxD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,SAAS,GAAG,SAAS,CAAC;AACxB,CAAC;AAED,6JAA6J;AAC7J,MAAM,UAAU,gCAAgC,CAAC,KAAyC;IACxF,SAAS,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC"}

package/dist/components/viewers/notebook-viewer/notebook-viewer.class.d.ts

@@ -0,0 +1,171 @@
+import { type PropertyValues, type TemplateResult } from 'lit';
+import { LyraElement } from '../../../internal/lyra-element.js';
+import type { LyraAnchor, LyraAnchorKind } from '../document-viewer/anchors.js';
+import '../../layout/virtual-list/virtual-list.js';
+import '../../conversation/markdown/markdown.js';
+import '../../conversation/code-block/code-block.js';
+import '../../utility/json-viewer/json-viewer.js';
+interface NotebookOutput {
+    output_type: 'stream' | 'error' | 'display_data' | 'execute_result';
+    name?: 'stdout' | 'stderr';
+    text?: string | string[];
+    ename?: string;
+    evalue?: string;
+    traceback?: string[];
+    data?: Record<string, string | string[]>;
+}
+interface NotebookCell {
+    cell_type: 'markdown' | 'code' | 'raw';
+    id?: string;
+    source: string | string[];
+    execution_count?: number | null;
+    outputs?: NotebookOutput[];
+    metadata?: {
+        language_info?: unknown;
+    };
+}
+interface NotebookDoc {
+    nbformat: number;
+    nbformat_minor: number;
+    cells: NotebookCell[];
+    metadata?: {
+        language_info?: {
+            name?: string;
+        };
+        kernelspec?: {
+            language?: string;
+        };
+    };
+}
+export interface LyraNotebookViewerEventMap {
+    'lr-load': CustomEvent<{
+        cellCount: number;
+        language: string;
+    }>;
+    'lr-highlight-activate': CustomEvent<{
+        id: string;
+    }>;
+    'lr-search-change': CustomEvent<{
+        query: string;
+        matchCount: number;
+        activeIndex: number;
+    }>;
+    'lr-render-error': CustomEvent<{
+        error: unknown;
+    }>;
+}
+declare const LyraNotebookViewer_base: typeof LyraElement & (new (...args: any[]) => import("../../../internal/anchor-target.js").LyraAnchorTarget & {
+    renderAnchorLiveRegion(): unknown;
+});
+/**
+ * `<lr-notebook-viewer>` — read-only Jupyter notebook (nbformat 4.x) renderer, composing existing
+ * components per cell. Execution is a hard non-goal.
+ *
+ * Markdown cells render through `<lr-markdown>`, code cells through `<lr-code-block>` (using the
+ * notebook's kernel language for syntax highlighting), and raw cells as plain preformatted text. A
+ * code cell's `execute_result`/`display_data` outputs prefer, in order, `image/png`, `image/jpeg`,
+ * `image/svg+xml` (sanitized), `text/html` (sanitized), `application/json` (via `<lr-json-viewer>`),
+ * then `text/plain`. Stream/error outputs (tinted `danger` for stderr/tracebacks) interpret embedded
+ * ANSI SGR color/style escapes via the shared `internal/ansi.ts` parser, same as `<lr-terminal>`.
+ * Sanitizing raw HTML/SVG
+ * output markup lazy-loads the optional peer dependency `dompurify` via `dompurify-loader.ts`; when
+ * that peer isn't installed, the output renders a localized notice instead of raw markup.
+ *
+ * Cells are virtualized through `<lr-virtual-list>` so a notebook with many cells stays cheap to
+ * scroll. `node-path` anchors resolve `path[0]` as a cell index; `fragment` anchors resolve a cell's
+ * own `id`.
+ *
+ * @customElement lr-notebook-viewer
+ * @event lr-load - Fired once a notebook has been parsed and validated. `detail: { cellCount,
+ *   language }`.
+ * @event lr-highlight-activate - `detail: { id }`.
+ * @event lr-search-change - Fired whenever the search query, match count, or active match index
+ *   changes, from `search()`/`searchNext()`/`searchPrevious()`/`clearSearch()`. `detail: { query,
+ *   matchCount, activeIndex }`.
+ * @event lr-render-error - Fired when fetching, parsing, or validating the notebook fails.
+ *   `detail: { error }`.
+ * @csspart base - The root scroll container.
+ * @csspart cell - One cell row (`data-cell-type`, `data-active`).
+ * @csspart cell-gutter - The `In [n]`/`Out [n]` label column.
+ * @csspart cell-source - A cell's source content.
+ * @csspart outputs - The wrapper around a code cell's outputs.
+ * @csspart output - One output (`data-output-type`, `data-stream`).
+ * @csspart output-toggle - Expands/collapses a long text output.
+ * @csspart error - The error region.
+ * @csspart spinner - The loading status region.
+ * @cssprop [--lr-notebook-viewer-max-height=none] - Maximum block size of the scrollable body
+ *   before it scrolls internally. Also settable via the `max-height` property.
+ */
+export declare class LyraNotebookViewer extends LyraNotebookViewer_base {
+    static styles: import("lit").CSSResultGroup[];
+    /** URL to fetch and parse as a notebook. Ignored once `notebook` is set. */
+    src: string;
+    /** A parsed notebook document, or its raw JSON text. Setting this wins over `src` and is parsed
+     *  (and validated) synchronously. */
+    get notebook(): NotebookDoc | string | undefined;
+    set notebook(value: NotebookDoc | string | undefined);
+    private _notebook?;
+    /** Display name used as the viewer's accessible label, and matched against a `fragment` anchor's
+     *  cell id. */
+    name: string;
+    /** A plain-text output longer than this many lines renders collapsed behind a toggle. `0`
+     *  disables collapsing. */
+    outputCollapseLines: number;
+    /** A CSS length (e.g. `"30rem"`); once set, the notebook scrolls internally past this height
+     *  instead of growing the page. */
+    maxHeight: string;
+    /** Anchor kinds this component resolves via `scrollToAnchor()`. */
+    readonly anchorKinds: readonly LyraAnchorKind[];
+    private loadState;
+    private expandedOutputs;
+    private activeCellIndex;
+    private searchQuery;
+    private searchMatches;
+    private activeSearchIndex;
+    private generation;
+    /** `outputCollapseLines`, normalized to a finite non-negative integer (falling back to the
+     *  property's own default of `40`) -- a raw `NaN` (e.g. an invalid `output-collapse-lines`
+     *  attribute) would otherwise make `lines.length > outputCollapseLines` always false, silently
+     *  disabling collapsing instead of falling back to the default threshold. */
+    private get effectiveOutputCollapseLines();
+    protected updated(changed: PropertyValues): void;
+    private parseInline;
+    private loadFromSrc;
+    private setDoc;
+    protected applyAnchor(anchor: LyraAnchor): Promise<boolean>;
+    /** Case-insensitive substring search over every cell's joined source text and text-bearing
+     *  outputs -- at most one match per cell. Resolves the match count and fires
+     *  `lr-search-change`. */
+    search(query: string): Promise<number>;
+    searchNext(): void;
+    searchPrevious(): void;
+    clearSearch(): void;
+    private emitSearchChange;
+    private toggleOutput;
+    /** Feeds `text` through a fresh, one-shot ANSI parser (this is always a complete, already-final
+     *  string -- never a live stream chunk -- so there is no parser state to persist across renders,
+     *  unlike `<lr-terminal>`'s incremental `push()` usage) and renders the resulting segments as
+     *  styled spans, same color/style token mapping `<lr-terminal>` uses. */
+    private renderAnsiText;
+    private segmentStyle;
+    private renderTextOutput;
+    private renderOutput;
+    /** Cache of already-sanitized SVG/HTML output markup, keyed by `profile:rawMarkup` -- `undefined`
+     *  means "not requested yet", `null` means "sanitizer peer unavailable" (missing-peer notice),
+     *  otherwise the sanitized string. Sanitizing is async (`loadNotebookSanitizer()` lazy-loads the
+     *  `dompurify` peer), which can't resolve inside a synchronous `render()` pass -- `renderSanitized()`
+     *  kicks off the async work on first render and repaints via `requestUpdate()` once it resolves. */
+    private sanitizedOutputCache;
+    private ensureSanitized;
+    private renderSanitized;
+    private renderCell;
+    private notebookLanguage;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lr-notebook-viewer': LyraNotebookViewer;
+    }
+}
+export {};
+//# sourceMappingURL=notebook-viewer.class.d.ts.map

package/dist/components/viewers/notebook-viewer/notebook-viewer.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebook-viewer.class.d.ts","sourceRoot":"","sources":["../../../../src/components/viewers/notebook-viewer/notebook-viewer.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAK9E,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAEhE,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAOhF,OAAO,2CAA2C,CAAC;AACnD,OAAO,yCAAyC,CAAC;AACjD,OAAO,6CAA6C,CAAC;AACrD,OAAO,0CAA0C,CAAC;AAOlD,UAAU,cAAc;IACtB,WAAW,EAAE,QAAQ,GAAG,OAAO,GAAG,cAAc,GAAG,gBAAgB,CAAC;IACpE,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CAC1C;AACD,UAAU,YAAY;IACpB,SAAS,EAAE,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACxC;AACD,UAAU,WAAW;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,UAAU,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CACtF;AAqBD,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,WAAW,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,uBAAuB,EAAE,WAAW,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,kBAAkB,EAAE,WAAW,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5F,iBAAiB,EAAE,WAAW,CAAC;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACpD;;;;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,qBAAa,kBAAmB,SAAQ,uBAAiC;IACvE,MAAM,CAAC,MAAM,iCAAwC;IAErD,4EAA4E;IAChE,GAAG,SAAM;IAErB;yCACqC;IACrC,IACI,QAAQ,IAAI,WAAW,GAAG,MAAM,GAAG,SAAS,CAE/C;IACD,IAAI,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,EAKnD;IACD,OAAO,CAAC,SAAS,CAAC,CAAuB;IAEzC;mBACe;IACH,IAAI,SAAM;IAEtB;+BAC2B;IACqC,mBAAmB,SAAM;IAEzF;uCACmC;IACI,SAAS,SAAM;IAEtD,mEAAmE;IACnE,QAAQ,CAAC,WAAW,EAAE,SAAS,cAAc,EAAE,CAA6B;IAEnE,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,iBAAiB,CAAM;IAExC,OAAO,CAAC,UAAU,CAAK;IAEvB;;;iFAG6E;IAC7E,OAAO,KAAK,4BAA4B,GAEvC;IAED,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAG/C;IAED,OAAO,CAAC,WAAW;YAYL,WAAW;IAoCzB,OAAO,CAAC,MAAM;IAyBd,UAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAUhE;IAED;;8BAE0B;IACpB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmB3C;IAED,UAAU,IAAI,IAAI,CAIjB;IAED,cAAc,IAAI,IAAI,CAIrB;IAED,WAAW,IAAI,IAAI,CAKlB;IAED,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,YAAY;IAOpB;;;6EAGyE;IACzE,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,YAAY;IAmCpB;;;;wGAIoG;IACpG,OAAO,CAAC,oBAAoB,CAAoC;YAElD,eAAe;IAc7B,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,UAAU,CAuBhB;IAEF,OAAO,CAAC,gBAAgB;IAMxB,MAAM,IAAI,cAAc,CAsBvB;CACF;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,oBAAoB,EAAE,kBAAkB,CAAC;KAC1C;CACF"}