wolfy-reader 0.1.0

package/dist/view/protocol.d.ts

@@ -0,0 +1,220 @@
+/**
+ * The host↔frame message protocol.
+ *
+ * Every message is validated on receipt on both sides. Origin checking cannot
+ * do that job here: the frame has an opaque origin, so its messages arrive with
+ * an origin of `'null'`, which authenticates nothing. What the host trusts is
+ * the message *source* (it must be this frame's window) plus the shape below.
+ *
+ * The frame's copy of the host-message validator lives inside a template string
+ * in `frame.ts` (it cannot import), so the two must be kept in step by hand. Any
+ * change here — including this version bump — changes both.
+ */
+export declare const PROTOCOL_VERSION = 9;
+export interface Measurement {
+    readonly width: number;
+    readonly height: number;
+}
+/** The paginator's flow mode. */
+export type LayoutMode = 'paginated' | 'scrolled';
+export interface PaginateOptions {
+    readonly mode: LayoutMode;
+    readonly pageWidth: number;
+    readonly pageHeight: number;
+    readonly columnGap: number;
+    readonly chunkChars: number;
+    /** How many chunks either side of the active one stay realized. */
+    readonly windowChunks: number;
+    /**
+     * Text columns per page (a reflowing typography knob): 1 or 2. A page is split
+     * into this many intra-page columns, each `columnGap` apart, so a page of
+     * two-column layout paints twice the text before a turn. The other typography
+     * knobs ride the appearance stylesheet in the srcdoc, but column geometry is the
+     * paginator's, so it travels on the wire alongside `columnGap`.
+     */
+    readonly columnCount: number;
+}
+/** What the frame reports after (re-)paginating. Page count may be an estimate. */
+export interface PaginationState {
+    readonly pageCount: number;
+    /** True once every chunk has been measured; false while the count is an estimate. */
+    readonly firm: boolean;
+    readonly realizedChunks: number;
+    readonly totalChunks: number;
+    /** Content scroll size in scrolled mode; page geometry otherwise. */
+    readonly contentWidth: number;
+    readonly contentHeight: number;
+}
+/** A character offset within the section's concatenated chunk text. */
+export interface PageAnchor {
+    /** Character offset of the first glyph painted on the page, or -1 if none. */
+    readonly offset: number;
+}
+export type HostMessage = {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'ping';
+    readonly id: number;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'measure';
+    readonly id: number;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'paginate';
+    readonly id: number;
+    readonly options: PaginateOptions;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'relayout';
+    readonly id: number;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'goToPage';
+    readonly id: number;
+    readonly page: number;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'offsetOfPage';
+    readonly id: number;
+    readonly page: number;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'pageOfOffset';
+    readonly id: number;
+    readonly offset: number;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'offsetOfElementId';
+    readonly id: number;
+    readonly elementId: string;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'sectionText';
+    readonly id: number;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'diagnostics';
+    readonly id: number;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'decorate';
+    readonly id: number;
+    /** Caller-chosen id: re-issuing the same id replaces that overlay. */
+    readonly decorationId: string;
+    /** UTF-16 code-unit offset of the range start in the section text. */
+    readonly start: number;
+    /** UTF-16 code-unit offset of the range end in the section text. */
+    readonly end: number;
+    /** The class name each painted overlay box carries. */
+    readonly className: string;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'undecorate';
+    readonly id: number;
+    readonly decorationId: string;
+};
+export type FrameMessage = {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'ready';
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'pong';
+    readonly id: number;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'measured';
+    readonly id: number;
+    readonly width: number;
+    readonly height: number;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'paginated';
+    readonly id: number;
+    readonly state: PaginationState;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'movedToPage';
+    readonly id: number;
+    readonly page: number;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'offset';
+    readonly id: number;
+    readonly offset: number;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'page';
+    readonly id: number;
+    readonly page: number;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'text';
+    readonly id: number;
+    readonly text: string;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'decorated';
+    readonly id: number;
+    /** Number of overlay boxes painted for the range (0 on a soft-miss). */
+    readonly boxes: number;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'diagnosticsReport';
+    readonly id: number;
+    readonly domNodes: number;
+    readonly realizedChunks: number;
+    readonly totalChunks: number;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'violation';
+    readonly directive: string;
+    readonly blockedUri: string;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'error';
+    readonly message: string;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'linkclick';
+    readonly href: string;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'key';
+    readonly key: string;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'swipe';
+    readonly dx: number;
+    readonly dy: number;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'tap';
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'selection';
+    /** UTF-16 code-unit offset of the selection's start in the section text. */
+    readonly start: number;
+    /** UTF-16 code-unit offset of the selection's end in the section text. */
+    readonly end: number;
+    /** The selected text, exactly as the frame reads it. */
+    readonly text: string;
+} | {
+    readonly v: typeof PROTOCOL_VERSION;
+    readonly type: 'imagetap';
+    /**
+     * The image's already-substituted `data:` URL — the full-resolution bytes
+     * `applyResources` served into the frame's `<img src>`. Never a `blob:` URL:
+     * the opaque-origin frame cannot mint one the host could load, and the host
+     * overlay renders these bytes directly. The host verifies the `data:` scheme.
+     */
+    readonly src: string;
+    /** The image's `alt` text, for the overlay's accessible name. */
+    readonly alt: string;
+};
+export declare function asFrameMessage(data: unknown): FrameMessage | null;
+export declare function asHostMessage(data: unknown): HostMessage | null;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/view/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/view/protocol.ts"],"names":[],"mappings":"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"}

package/dist/view/protocol.js

@@ -0,0 +1,246 @@
+/**
+ * The host↔frame message protocol.
+ *
+ * Every message is validated on receipt on both sides. Origin checking cannot
+ * do that job here: the frame has an opaque origin, so its messages arrive with
+ * an origin of `'null'`, which authenticates nothing. What the host trusts is
+ * the message *source* (it must be this frame's window) plus the shape below.
+ *
+ * The frame's copy of the host-message validator lives inside a template string
+ * in `frame.ts` (it cannot import), so the two must be kept in step by hand. Any
+ * change here — including this version bump — changes both.
+ */
+export const PROTOCOL_VERSION = 9;
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : null;
+}
+function asPaginationState(value) {
+    const state = asRecord(value);
+    if (state === null)
+        return null;
+    const pageCount = state['pageCount'];
+    const firm = state['firm'];
+    const realizedChunks = state['realizedChunks'];
+    const totalChunks = state['totalChunks'];
+    const contentWidth = state['contentWidth'];
+    const contentHeight = state['contentHeight'];
+    if (typeof pageCount !== 'number' ||
+        typeof firm !== 'boolean' ||
+        typeof realizedChunks !== 'number' ||
+        typeof totalChunks !== 'number' ||
+        typeof contentWidth !== 'number' ||
+        typeof contentHeight !== 'number') {
+        return null;
+    }
+    return { pageCount, firm, realizedChunks, totalChunks, contentWidth, contentHeight };
+}
+export function asFrameMessage(data) {
+    const message = asRecord(data);
+    if (message === null || message['v'] !== PROTOCOL_VERSION)
+        return null;
+    const id = message['id'];
+    switch (message['type']) {
+        case 'ready':
+            return { v: PROTOCOL_VERSION, type: 'ready' };
+        case 'pong':
+            return typeof id === 'number' ? { v: PROTOCOL_VERSION, type: 'pong', id } : null;
+        case 'measured': {
+            const width = message['width'];
+            const height = message['height'];
+            if (typeof id !== 'number' || typeof width !== 'number' || typeof height !== 'number')
+                return null;
+            return { v: PROTOCOL_VERSION, type: 'measured', id, width, height };
+        }
+        case 'paginated': {
+            if (typeof id !== 'number')
+                return null;
+            const state = asPaginationState(message['state']);
+            return state === null ? null : { v: PROTOCOL_VERSION, type: 'paginated', id, state };
+        }
+        case 'movedToPage': {
+            const page = message['page'];
+            if (typeof id !== 'number' || typeof page !== 'number')
+                return null;
+            return { v: PROTOCOL_VERSION, type: 'movedToPage', id, page };
+        }
+        case 'offset': {
+            const offset = message['offset'];
+            if (typeof id !== 'number' || typeof offset !== 'number')
+                return null;
+            return { v: PROTOCOL_VERSION, type: 'offset', id, offset };
+        }
+        case 'page': {
+            const page = message['page'];
+            if (typeof id !== 'number' || typeof page !== 'number')
+                return null;
+            return { v: PROTOCOL_VERSION, type: 'page', id, page };
+        }
+        case 'text': {
+            const text = message['text'];
+            if (typeof id !== 'number' || typeof text !== 'string')
+                return null;
+            return { v: PROTOCOL_VERSION, type: 'text', id, text };
+        }
+        case 'decorated': {
+            const boxes = message['boxes'];
+            if (typeof id !== 'number' || typeof boxes !== 'number')
+                return null;
+            return { v: PROTOCOL_VERSION, type: 'decorated', id, boxes };
+        }
+        case 'diagnosticsReport': {
+            const domNodes = message['domNodes'];
+            const realizedChunks = message['realizedChunks'];
+            const totalChunks = message['totalChunks'];
+            if (typeof id !== 'number' ||
+                typeof domNodes !== 'number' ||
+                typeof realizedChunks !== 'number' ||
+                typeof totalChunks !== 'number') {
+                return null;
+            }
+            return { v: PROTOCOL_VERSION, type: 'diagnosticsReport', id, domNodes, realizedChunks, totalChunks };
+        }
+        case 'violation': {
+            const directive = message['directive'];
+            const blockedUri = message['blockedUri'];
+            if (typeof directive !== 'string' || typeof blockedUri !== 'string')
+                return null;
+            return { v: PROTOCOL_VERSION, type: 'violation', directive, blockedUri };
+        }
+        case 'error': {
+            const text = message['message'];
+            return typeof text === 'string' ? { v: PROTOCOL_VERSION, type: 'error', message: text } : null;
+        }
+        case 'linkclick': {
+            const href = message['href'];
+            return typeof href === 'string' ? { v: PROTOCOL_VERSION, type: 'linkclick', href } : null;
+        }
+        case 'key': {
+            const key = message['key'];
+            return typeof key === 'string' ? { v: PROTOCOL_VERSION, type: 'key', key } : null;
+        }
+        case 'swipe': {
+            const dx = message['dx'];
+            const dy = message['dy'];
+            if (typeof dx !== 'number' || typeof dy !== 'number')
+                return null;
+            return { v: PROTOCOL_VERSION, type: 'swipe', dx, dy };
+        }
+        case 'tap': {
+            const x = message['x'];
+            const y = message['y'];
+            const width = message['width'];
+            const height = message['height'];
+            if (typeof x !== 'number' ||
+                typeof y !== 'number' ||
+                typeof width !== 'number' ||
+                typeof height !== 'number') {
+                return null;
+            }
+            return { v: PROTOCOL_VERSION, type: 'tap', x, y, width, height };
+        }
+        case 'selection': {
+            const start = message['start'];
+            const end = message['end'];
+            const text = message['text'];
+            if (typeof start !== 'number' || typeof end !== 'number' || typeof text !== 'string') {
+                return null;
+            }
+            return { v: PROTOCOL_VERSION, type: 'selection', start, end, text };
+        }
+        case 'imagetap': {
+            const src = message['src'];
+            const alt = message['alt'];
+            if (typeof src !== 'string' || typeof alt !== 'string')
+                return null;
+            return { v: PROTOCOL_VERSION, type: 'imagetap', src, alt };
+        }
+        default:
+            return null;
+    }
+}
+function asPaginateOptions(value) {
+    const options = asRecord(value);
+    if (options === null)
+        return null;
+    const mode = options['mode'];
+    const pageWidth = options['pageWidth'];
+    const pageHeight = options['pageHeight'];
+    const columnGap = options['columnGap'];
+    const chunkChars = options['chunkChars'];
+    const windowChunks = options['windowChunks'];
+    const columnCount = options['columnCount'];
+    if ((mode !== 'paginated' && mode !== 'scrolled') ||
+        typeof pageWidth !== 'number' ||
+        typeof pageHeight !== 'number' ||
+        typeof columnGap !== 'number' ||
+        typeof chunkChars !== 'number' ||
+        typeof windowChunks !== 'number' ||
+        typeof columnCount !== 'number') {
+        return null;
+    }
+    return { mode, pageWidth, pageHeight, columnGap, chunkChars, windowChunks, columnCount };
+}
+export function asHostMessage(data) {
+    const message = asRecord(data);
+    if (message === null || message['v'] !== PROTOCOL_VERSION)
+        return null;
+    const id = message['id'];
+    if (typeof id !== 'number')
+        return null;
+    switch (message['type']) {
+        case 'ping':
+            return { v: PROTOCOL_VERSION, type: 'ping', id };
+        case 'measure':
+            return { v: PROTOCOL_VERSION, type: 'measure', id };
+        case 'paginate': {
+            const options = asPaginateOptions(message['options']);
+            return options === null ? null : { v: PROTOCOL_VERSION, type: 'paginate', id, options };
+        }
+        case 'relayout':
+            return { v: PROTOCOL_VERSION, type: 'relayout', id };
+        case 'goToPage': {
+            const page = message['page'];
+            return typeof page === 'number' ? { v: PROTOCOL_VERSION, type: 'goToPage', id, page } : null;
+        }
+        case 'offsetOfPage': {
+            const page = message['page'];
+            return typeof page === 'number' ? { v: PROTOCOL_VERSION, type: 'offsetOfPage', id, page } : null;
+        }
+        case 'pageOfOffset': {
+            const offset = message['offset'];
+            return typeof offset === 'number' ? { v: PROTOCOL_VERSION, type: 'pageOfOffset', id, offset } : null;
+        }
+        case 'offsetOfElementId': {
+            const elementId = message['elementId'];
+            return typeof elementId === 'string'
+                ? { v: PROTOCOL_VERSION, type: 'offsetOfElementId', id, elementId }
+                : null;
+        }
+        case 'sectionText':
+            return { v: PROTOCOL_VERSION, type: 'sectionText', id };
+        case 'diagnostics':
+            return { v: PROTOCOL_VERSION, type: 'diagnostics', id };
+        case 'decorate': {
+            const decorationId = message['decorationId'];
+            const start = message['start'];
+            const end = message['end'];
+            const className = message['className'];
+            if (typeof decorationId !== 'string' ||
+                typeof start !== 'number' ||
+                typeof end !== 'number' ||
+                typeof className !== 'string') {
+                return null;
+            }
+            return { v: PROTOCOL_VERSION, type: 'decorate', id, decorationId, start, end, className };
+        }
+        case 'undecorate': {
+            const decorationId = message['decorationId'];
+            return typeof decorationId === 'string'
+                ? { v: PROTOCOL_VERSION, type: 'undecorate', id, decorationId }
+                : null;
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=protocol.js.map

package/dist/view/protocol.js.map

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

package/dist/view/reference.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Reference classification and relative-space joining.
+ *
+ * Classification and normalization live in `src/core/reading-text.ts` and are
+ * re-exported here under their established names: the headless search extractor
+ * must classify an `<img src>` exactly the way the resource layer does (the
+ * alt-substitution decision is part of the canonical reading text), and search
+ * may not import `src/view`. One definition, two consumers.
+ */
+export { classifyReference, normalizeReference, type ClassifiedReference, type ReferenceKind, } from '../core/reading-text.ts';
+/**
+ * Joins a reference found inside a document that was itself reached by `base`.
+ * Both are expressed in the section's reference space: `Section.resolve()`
+ * resolves only relative to the section, so a stylesheet's own imports have to
+ * be re-expressed relative to the section before they can be resolved at all.
+ */
+export declare function joinReference(base: string, reference: string): string;
+//# sourceMappingURL=reference.d.ts.map

package/dist/view/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../src/view/reference.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,yBAAyB,CAAC;AAIjC;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKrE"}

package/dist/view/reference.js

@@ -0,0 +1,25 @@
+/**
+ * Reference classification and relative-space joining.
+ *
+ * Classification and normalization live in `src/core/reading-text.ts` and are
+ * re-exported here under their established names: the headless search extractor
+ * must classify an `<img src>` exactly the way the resource layer does (the
+ * alt-substitution decision is part of the canonical reading text), and search
+ * may not import `src/view`. One definition, two consumers.
+ */
+export { classifyReference, normalizeReference, } from '../core/reading-text.js';
+import { normalizeReference } from '../core/reading-text.js';
+/**
+ * Joins a reference found inside a document that was itself reached by `base`.
+ * Both are expressed in the section's reference space: `Section.resolve()`
+ * resolves only relative to the section, so a stylesheet's own imports have to
+ * be re-expressed relative to the section before they can be resolved at all.
+ */
+export function joinReference(base, reference) {
+    if (reference.startsWith('/'))
+        return reference;
+    const slash = base.lastIndexOf('/');
+    const directory = slash === -1 ? '' : base.slice(0, slash + 1);
+    return normalizeReference(directory + reference);
+}
+//# sourceMappingURL=reference.js.map

package/dist/view/reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.js","sourceRoot":"","sources":["../../src/view/reference.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GAGnB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,SAAiB;IAC3D,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IAC/D,OAAO,kBAAkB,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;AACnD,CAAC"}

package/dist/view/resources.d.ts

@@ -0,0 +1,51 @@
+import type { Resource } from '../core/index.ts';
+/** What a reference that names nothing loadable is rewritten to. */
+export declare const UNRESOLVABLE_URL = "about:invalid";
+export type ReferenceResolver = (reference: string) => Resource | undefined;
+export interface ResourceSummary {
+    /** Data URLs minted for this render. */
+    readonly dataUrls: number;
+    readonly resolved: readonly string[];
+    readonly unresolved: readonly string[];
+    /** References that resolved but whose media type this host will not serve. */
+    readonly refused: readonly string[];
+    /** References left as written for the CSP to refuse. */
+    readonly remote: readonly string[];
+    /** Images replaced by their alt text because they could not be resolved. */
+    readonly altSubstituted: number;
+}
+/**
+ * Turns references found in book content into `data:` URLs.
+ *
+ * `blob:` is what the plan asked for and it cannot work here: a blob URL
+ * belongs to the origin that created it, and the frame's origin is opaque, so
+ * the frame is refused the host's blob URLs outright — measured in Chromium as
+ * "Not allowed to load local resource", below CSP, with no violation event to
+ * observe. A `data:` URL carries its own bytes and has no origin to check, so
+ * it crosses the boundary the sandbox deliberately makes uncrossable. The cost
+ * is base64's 33% and no revocation handle; both are bounded by one section.
+ */
+export declare class ResourceRegistry {
+    #private;
+    constructor(resolve?: ReferenceResolver);
+    get summary(): Omit<ResourceSummary, 'altSubstituted'>;
+    /**
+     * Memoized by reference string, not by the resource object: the contract
+     * promises equal bytes for equal references, not one shared object.
+     */
+    urlForResource(reference: string): Promise<string | undefined>;
+    urlForStylesheet(reference: string, ancestors?: ReadonlySet<string>): Promise<string | undefined>;
+    rewriteStylesheet(css: string, base: string, ancestors?: ReadonlySet<string>): Promise<string>;
+    /**
+     * Drops everything this render allocated. Data URLs hold no handle to
+     * release, so this frees memoized strings and stops any in-flight load from
+     * minting more — there is no orphan URL a render can leave behind.
+     */
+    release(): void;
+}
+/**
+ * Replaces every in-book reference in a sanitized document with a `blob:` URL.
+ * Runs after sanitization, so it only ever sees attributes the allowlist kept.
+ */
+export declare function applyResources(doc: Document, registry: ResourceRegistry): Promise<ResourceSummary>;
+//# sourceMappingURL=resources.d.ts.map

package/dist/view/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/view/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAOjD,oEAAoE;AACpE,eAAO,MAAM,gBAAgB,kBAAkB,CAAC;AAEhD,MAAM,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,QAAQ,GAAG,SAAS,CAAC;AAE5E,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAqBD;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;;IAW3B,YAAY,OAAO,CAAC,EAAE,iBAAiB,EAEtC;IAED,IAAI,OAAO,IAAI,IAAI,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAQrD;IAED;;;OAGG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAO7D;IAED,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,GAAE,WAAW,CAAC,MAAM,CAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU9G;IAED,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,WAAW,CAAC,MAAM,CAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB3G;IAED;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAId;CAsDF;AAkBD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAwDxG"}