@laminapdf/viewer 0.2.0-alpha.2 → 0.2.0-alpha.4

package/dist/layers/text-layer.js

@@ -0,0 +1,292 @@
+// The text layer (web-app §6 C5): on every mounted page, one transparent span per text run of
+// Lamina PDF's extraction, laid over the rendered glyphs, so the browser's own selection, copy
+// and screen readers work on the page's text. Spans are placed in page points inside a box that
+// one CSS transform scales and rotates to the page's current size, so a zoom or a rotation moves
+// no span. The viewer is the one selection root: only spans are selectable, never canvases, gaps
+// or the app around it, so a selection runs from one page into the next; the pages it touches
+// stay mounted while it lasts. Copy writes the extracted text, joined in reading order.
+import { range as range_ } from "../layout/range.js";
+import { placeBox } from "./box.js";
+import { joinPieces, layoutSpans } from "./spans.js";
+import { StructureLayer } from "./structure-layer.js";
+/** Numbers each text layer, for its span ids. */
+let nextViewer = 0;
+/** The text layer of one viewer. */
+export class TextLayer {
+    name = "text";
+    #host;
+    #options;
+    #pages = new Map();
+    #specs = new WeakMap();
+    #structure;
+    #cleanup = [];
+    #points = [];
+    /** Each mounted page's size in CSS px, as the last resize gave it. */
+    #sizes = new Map();
+    #pointerType = "";
+    /** Span ids' prefix, unique to this viewer, so two viewers on a page never share an id. */
+    #idPrefix = `lamina-text-${nextViewer++}-`;
+    /** Counts opens: a structure tree answered for an earlier document is dropped. */
+    #generation = 0;
+    /** Whether the last selection change was in this viewer, so a selection elsewhere is told only once. */
+    #selecting = false;
+    constructor(host, options = {}) {
+        this.#host = host;
+        this.#options = options;
+        this.#structure = new StructureLayer(host.root, options.untaggedLabel ?? "Untagged document", this.#idPrefix);
+        // Nothing in the viewer is selectable but the spans (set on each): canvases, gaps and other
+        // layers stay out of every selection.
+        selectable(host.root, "none");
+        this.#listen(document, "selectionchange", () => this.#selectionChanged());
+        this.#listen(document, "copy", (e) => this.#copy(e));
+        this.#listen(host.root, "keydown", (e) => this.#selectAll(e));
+        this.#listen(host.root, "pointerdown", (e) => {
+            this.#pointerType = e.pointerType;
+        });
+    }
+    /** A new document: its page sizes, and its structure tree, read once. */
+    open(document) {
+        this.#points = document.pages.map((p) => ({ width: p.width, height: p.height }));
+        this.#structure.reset();
+        const opening = ++this.#generation;
+        this.#host.client
+            .structure()
+            .then((structure) => {
+            // Another document opened while this one's tree was read: it isn't this document's.
+            if (opening !== this.#generation)
+                return;
+            this.#structure.show(structure);
+            // Pages whose text came first: link them now that their elements exist.
+            for (const page of this.#pages.keys())
+                this.#linkPage(page);
+        })
+            .catch(() => {
+            // No structure (a worker restart, a closed document): the spans still read in order.
+        });
+    }
+    onMount(page, slot) {
+        const box = document.createElement("div");
+        box.className = "lamina-text-layer";
+        // The spans lie over the canvas, so an app's ::selection fill would paint over the glyphs it
+        // selects. With the box multiplied over the canvas, the fill shows where the page is paper and
+        // the ink stays as dark as drawn: the tint sits under the text, as the find highlights do.
+        Object.assign(box.style, {
+            position: "absolute",
+            left: "0",
+            top: "0",
+            transformOrigin: "0 0",
+            mixBlendMode: "multiply",
+        });
+        slot.append(box);
+        const text = { box, abort: new AbortController(), spans: [] };
+        this.#pages.set(page, text);
+        this.#host.client
+            .pageText(page, { signal: text.abort.signal })
+            .then((data) => {
+            if (this.#pages.get(page) !== text)
+                return;
+            this.#fill(page, text, layoutSpans(data.runs, data.quads));
+        })
+            .catch(() => {
+            // Aborted (the page left), or a page whose text can't be read: it stays without text.
+        });
+    }
+    onUnmount(page) {
+        const text = this.#pages.get(page);
+        if (text === undefined)
+            return;
+        text.abort.abort();
+        text.box.remove();
+        this.#structure.unlink(page);
+        this.#pages.delete(page);
+        this.#sizes.delete(page);
+    }
+    onZoom(page, _slot, size) {
+        this.#sizes.set(page, size);
+        this.#place(page, size);
+    }
+    /** Places every page's box again: the view turned. */
+    refresh() {
+        for (const [page, size] of this.#sizes)
+            this.#place(page, size);
+    }
+    /** Scales and turns page `page`'s box to `size` at the view's rotation. */
+    #place(page, size) {
+        const text = this.#pages.get(page);
+        const points = this.#points[page];
+        if (text === undefined || points === undefined)
+            return;
+        placeBox(text.box, points, size, this.#host.rotation());
+    }
+    /** Stops listening; the viewer calls it on destroy. */
+    destroy() {
+        for (const f of this.#cleanup.splice(0))
+            f();
+        for (const page of [...this.#pages.keys()])
+            this.onUnmount(page);
+        this.#structure.reset();
+    }
+    #listen(target, type, f) {
+        target.addEventListener(type, f);
+        this.#cleanup.push(() => target.removeEventListener(type, f));
+    }
+    /**
+     * The page's spans, built once: written, then every natural width read in one pass, then each
+     * stretched to its run's width in another, so the page costs one layout, not one per span.
+     */
+    #fill(page, text, specs) {
+        const fragment = document.createDocumentFragment();
+        text.spans = specs.map((spec, k) => {
+            const span = document.createElement("span");
+            span.id = `${this.#idPrefix}${page}-${k}`;
+            span.textContent = spec.text;
+            if (spec.rtl)
+                span.dir = "rtl";
+            Object.assign(span.style, {
+                position: "absolute",
+                left: `${spec.left}px`,
+                top: `${spec.top}px`,
+                fontSize: `${spec.height}px`,
+                lineHeight: "1",
+                fontFamily: "sans-serif",
+                whiteSpace: "pre",
+                color: "transparent",
+                cursor: "text",
+                transformOrigin: "0 0",
+                ...(this.#options.outline === true ? { outline: "1px solid rgb(220 0 0 / 0.7)" } : {}),
+            });
+            selectable(span, "text");
+            this.#specs.set(span, { page, spec });
+            fragment.append(span);
+            return span;
+        });
+        text.box.append(fragment);
+        // Reads, then writes: each natural width in points, fractional, with the box briefly
+        // untransformed (its zoom and turn would scale and rotate the rects).
+        const placed = text.box.style.transform;
+        text.box.style.transform = "none";
+        // The box is its points wide: what the page around the viewer scales it by (a zoomed host)
+        // comes out of every width.
+        const outside = text.box.getBoundingClientRect().width / Math.max(1, text.box.offsetWidth);
+        const natural = text.spans.map((span) => span.getBoundingClientRect().width / (outside || 1));
+        text.box.style.transform = placed;
+        specs.forEach((spec, k) => {
+            const span = text.spans[k];
+            const fit = (natural[k] ?? 0) > 0 ? spec.width / natural[k] : 1;
+            span.style.transform = `rotate(${spec.angle}rad) scaleX(${fit})`;
+        });
+        this.#linkPage(page);
+    }
+    /** Gives the structure tree's elements the page's spans that their marked content drew. */
+    #linkPage(page) {
+        const text = this.#pages.get(page);
+        if (text === undefined)
+            return;
+        for (const span of text.spans) {
+            const mcid = this.#specs.get(span)?.spec.mcid;
+            if (mcid !== undefined)
+                this.#structure.link(page, mcid, span.id);
+        }
+    }
+    /** The mounted pages' spans, in page and reading order. */
+    #spansInOrder() {
+        return [...this.#pages.entries()].sort(([a], [b]) => a - b).flatMap(([, text]) => text.spans);
+    }
+    /** The selection's range, when it is in this viewer's text. */
+    #range() {
+        const selection = document.getSelection();
+        if (selection === null || selection.rangeCount === 0 || selection.isCollapsed)
+            return undefined;
+        const range = selection.getRangeAt(0);
+        return this.#host.root.contains(range.commonAncestorContainer) ? range : undefined;
+    }
+    /** The selected part of each span the selection touches, in order. */
+    #pieces(range) {
+        const pieces = [];
+        for (const span of this.#spansInOrder()) {
+            const info = this.#specs.get(span);
+            if (info === undefined || !range.intersectsNode(span))
+                continue;
+            const full = span.textContent ?? "";
+            const start = span.contains(range.startContainer) ? offsetIn(span, range.startContainer, range.startOffset) : 0;
+            const end = span.contains(range.endContainer) ? offsetIn(span, range.endContainer, range.endOffset) : full.length;
+            const text = full.slice(start, end);
+            if (text !== "")
+                pieces.push({ page: info.page, text, span: info.spec });
+        }
+        return pieces;
+    }
+    #copy(event) {
+        const range = this.#range();
+        if (range === undefined || event.clipboardData === null)
+            return;
+        event.clipboardData.setData("text/plain", joinPieces(this.#pieces(range)));
+        event.preventDefault();
+    }
+    /** Ctrl/Cmd+A in the viewer selects the mounted pages' text (find reaches the rest). */
+    #selectAll(event) {
+        if (event.key.toLowerCase() !== "a" || !(event.ctrlKey || event.metaKey) || event.altKey)
+            return;
+        const spans = this.#spansInOrder();
+        const first = spans[0];
+        const last = spans.at(-1);
+        if (first === undefined || last === undefined)
+            return;
+        event.preventDefault();
+        const range = document.createRange();
+        range.setStart(first, 0);
+        range.setEnd(last, last.childNodes.length);
+        const selection = document.getSelection();
+        selection?.removeAllRanges();
+        selection?.addRange(range);
+    }
+    #selectionChanged() {
+        const range = this.#range();
+        if (range === undefined) {
+            // A selection elsewhere on the page (an input, another viewer): told once, when it leaves.
+            if (!this.#selecting)
+                return;
+            this.#selecting = false;
+            this.#host.keepMounted([]);
+            this.#options.onSelection?.(undefined);
+            return;
+        }
+        this.#selecting = true;
+        // Every page from the one the selection starts on to the one it ends on, those between too:
+        // read from its two ends, not by walking every span while a drag goes on.
+        // An end in a gap between pages counts as the other end's page.
+        const start = pageOf(range.startContainer);
+        const end = pageOf(range.endContainer);
+        const [low, high] = [start ?? end, end ?? start];
+        if (low !== undefined && high !== undefined)
+            this.#host.keepMounted(range_(Math.min(low, high), Math.max(low, high)));
+        if (this.#options.onSelection === undefined)
+            return;
+        const pieces = this.#pieces(range);
+        this.#options.onSelection({
+            text: joinPieces(pieces),
+            rects: [...range.getClientRects()],
+            pages: [...new Set(pieces.map((p) => p.page))],
+            pointerType: this.#pointerType,
+        });
+    }
+}
+/** Sets `element`'s `user-select`, with WebKit's prefix (Safari before 26 reads only that). */
+function selectable(element, value) {
+    element.style.setProperty("user-select", value);
+    element.style.setProperty("-webkit-user-select", value);
+}
+/** The index of the page `node` is on, from its shell. */
+function pageOf(node) {
+    const element = node instanceof Element ? node : node.parentElement;
+    const index = element?.closest(".lamina-page")?.dataset.pageIndex;
+    return index === undefined ? undefined : Number(index);
+}
+/** The character offset in `span`'s text of the boundary point (`node`, `offset`). */
+function offsetIn(span, node, offset) {
+    if (node.nodeType === Node.TEXT_NODE)
+        return offset;
+    // A boundary between the span's children: before the first or after its text.
+    return offset === 0 ? 0 : (span.textContent ?? "").length;
+}
+//# sourceMappingURL=text-layer.js.map

package/dist/layers/text-layer.js.map

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

package/dist/layout/range.d.ts

@@ -0,0 +1,3 @@
+/** `first..last`, both included (empty when `last` is before `first`). */
+export declare function range(first: number, last: number): number[];
+//# sourceMappingURL=range.d.ts.map

package/dist/layout/range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../src/layout/range.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAE3D"}

package/dist/layout/range.js

@@ -0,0 +1,5 @@
+/** `first..last`, both included (empty when `last` is before `first`). */
+export function range(first, last) {
+    return Array.from({ length: Math.max(0, last - first + 1) }, (_, k) => first + k);
+}
+//# sourceMappingURL=range.js.map

package/dist/layout/range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"range.js","sourceRoot":"","sources":["../../src/layout/range.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,UAAU,KAAK,CAAC,KAAa,EAAE,IAAY;IAC/C,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;AACpF,CAAC"}

package/dist/network/watch.d.ts

@@ -0,0 +1,30 @@
+import type { NetworkRecord, NetworkSource, PolicyViolation } from "../protocol.js";
+/** What `watchNetwork` reports to. */
+export interface NetworkSink {
+    /** A request was made: called when it starts, failed or not, or when its timing entry arrives. */
+    request(record: NetworkRecord): void;
+    /** The scope's Content Security Policy blocked a request, so nothing was sent. */
+    violation(violation: PolicyViolation): void;
+}
+/** The global scope parts the watcher wraps and reads (a Window or a WorkerGlobalScope). */
+type Scope = typeof globalThis & {
+    XMLHttpRequest?: typeof XMLHttpRequest;
+    WebSocket?: typeof WebSocket;
+    PerformanceObserver?: typeof PerformanceObserver;
+    location?: {
+        href: string;
+    };
+    navigator?: Navigator & {
+        sendBeacon?: Navigator["sendBeacon"];
+    };
+    addEventListener?: (type: string, listener: (event: Event) => void) => void;
+    removeEventListener?: (type: string, listener: (event: Event) => void) => void;
+};
+/**
+ * Starts reporting every request `scope` makes to `sink`, as `source`. Returns the function that
+ * stops it: the scope's own `fetch`, `XMLHttpRequest`, `WebSocket` and `sendBeacon` put back, the
+ * observers disconnected and the violation listener removed.
+ */
+export declare function watchNetwork(scope: Scope, sink: NetworkSink, source: NetworkSource): () => void;
+export {};
+//# sourceMappingURL=watch.d.ts.map

package/dist/network/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/network/watch.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAQpF,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,kGAAkG;IAClG,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,kFAAkF;IAClF,SAAS,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;CAC7C;AAED,4FAA4F;AAC5F,KAAK,KAAK,GAAG,OAAO,UAAU,GAAG;IAC/B,cAAc,CAAC,EAAE,OAAO,cAAc,CAAC;IACvC,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;IAC7B,mBAAmB,CAAC,EAAE,OAAO,mBAAmB,CAAC;IACjD,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,SAAS,CAAC,EAAE,SAAS,GAAG;QAAE,UAAU,CAAC,EAAE,SAAS,CAAC,YAAY,CAAC,CAAA;KAAE,CAAC;IACjE,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,KAAK,IAAI,CAAC;IAC5E,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,KAAK,IAAI,CAAC;CAChF,CAAC;AAkBF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,IAAI,CAwC/F"}

package/dist/network/watch.js

@@ -0,0 +1,181 @@
+// Every network request a JavaScript context makes, reported as it happens: the page's and the
+// document worker's (ADR 0011's privacy guarantees, R13's network panel). A context can request
+// in two ways that leave different traces, so the watcher uses both:
+//
+// - calls the page's or the worker's code makes (`fetch`, `XMLHttpRequest`, `WebSocket`,
+//   `navigator.sendBeacon`) are wrapped, so each is reported when it starts, failed or not, and a
+//   WebSocket, which leaves no timing entry, is counted too;
+// - everything the browser loads by itself (scripts, module imports, styles, fonts, images, the
+//   page) is read from the Resource Timing entries, whose `initiatorType` tells them apart from
+//   the wrapped calls, so nothing is counted twice.
+//
+// Installed before any other code of the context runs, so no code path can capture an unwrapped
+// `fetch` first. A request the context never makes (a browser extension's) is out of its sight.
+/** The entries a wrapped call also leaves in Resource Timing, read from the call instead. */
+const WRAPPED_INITIATORS = new Set(["fetch", "xmlhttprequest", "beacon"]);
+/** The `blockedURI`s of violations that block no request (CSP3 §5.3's keywords for them). */
+const NOT_REQUESTS = new Set(["", "inline", "eval", "wasm-eval", "trusted-types-policy", "trusted-types-sink"]);
+/** `input`'s absolute URL, against the scope's address. */
+function urlOf(input, base) {
+    const raw = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+    try {
+        return new URL(raw, base).href;
+    }
+    catch {
+        return raw;
+    }
+}
+/** A `Content-Length` header's bytes, or 0 when there is none or it isn't a number. */
+function lengthOf(header) {
+    const length = Number(header);
+    return Number.isFinite(length) && length > 0 ? length : 0;
+}
+/**
+ * Starts reporting every request `scope` makes to `sink`, as `source`. Returns the function that
+ * stops it: the scope's own `fetch`, `XMLHttpRequest`, `WebSocket` and `sendBeacon` put back, the
+ * observers disconnected and the violation listener removed.
+ */
+export function watchNetwork(scope, sink, source) {
+    const base = scope.location?.href;
+    const report = (record, at = Date.now()) => sink.request({ ...record, source, at });
+    const restore = [];
+    const originalFetch = scope.fetch;
+    if (typeof originalFetch === "function") {
+        scope.fetch = async (input, init) => {
+            const url = urlOf(input, base);
+            const method = (init?.method ?? (input instanceof Request ? input.method : "GET")).toUpperCase();
+            // Stamped when the call starts: a request belongs to the file that was opening then.
+            const at = Date.now();
+            try {
+                const response = await originalFetch.call(scope, input, init);
+                const bytes = lengthOf(response.headers.get("Content-Length"));
+                report({ url, method, initiator: "fetch", bytes, failed: false }, at);
+                return response;
+            }
+            catch (e) {
+                report({ url, method, initiator: "fetch", bytes: 0, failed: true }, at);
+                throw e;
+            }
+        };
+        restore.push(() => {
+            scope.fetch = originalFetch;
+        });
+    }
+    restore.push(...wrapXhr(scope, base, report), ...wrapWebSocket(scope, base, report));
+    restore.push(...wrapBeacon(scope, base, report), ...observeResources(scope, report));
+    const onViolation = (event) => {
+        const e = event;
+        // Inline code, eval and Trusted Types violations block no request: only a blocked URL is one.
+        if (NOT_REQUESTS.has(e.blockedURI))
+            return;
+        sink.violation({ directive: e.effectiveDirective, blockedUri: e.blockedURI, source, at: Date.now() });
+    };
+    scope.addEventListener?.("securitypolicyviolation", onViolation);
+    restore.push(() => scope.removeEventListener?.("securitypolicyviolation", onViolation));
+    return () => {
+        for (const undo of restore)
+            undo();
+    };
+}
+/** `XMLHttpRequest`: the method and URL from `open`, reported once the request ends. */
+function wrapXhr(scope, base, report) {
+    const Xhr = scope.XMLHttpRequest;
+    if (Xhr === undefined)
+        return [];
+    const { open, send } = Xhr.prototype;
+    const seen = new WeakMap();
+    Xhr.prototype.open = function (method, url, ...rest) {
+        seen.set(this, { method: method.toUpperCase(), url: urlOf(url, base) });
+        return open.call(this, method, url, ...rest);
+    };
+    Xhr.prototype.send = function (body) {
+        const call = seen.get(this);
+        if (call !== undefined) {
+            const at = Date.now();
+            this.addEventListener("loadend", () => {
+                const bytes = lengthOf(this.getResponseHeader("Content-Length"));
+                report({ ...call, initiator: "xmlhttprequest", bytes, failed: this.status === 0 }, at);
+            });
+        }
+        return send.call(this, body);
+    };
+    return [
+        () => {
+            Xhr.prototype.open = open;
+            Xhr.prototype.send = send;
+        },
+    ];
+}
+/** `WebSocket`: each connection attempt, which Resource Timing never lists. */
+function wrapWebSocket(scope, base, report) {
+    const Socket = scope.WebSocket;
+    if (Socket === undefined)
+        return [];
+    const Wrapped = new Proxy(Socket, {
+        construct(target, args) {
+            report({ url: urlOf(args[0], base), method: "GET", initiator: "websocket", bytes: 0, failed: false });
+            return Reflect.construct(target, args);
+        },
+    });
+    scope.WebSocket = Wrapped;
+    return [
+        () => {
+            scope.WebSocket = Socket;
+        },
+    ];
+}
+/** `navigator.sendBeacon` (the page only): each beacon, sent or refused. */
+function wrapBeacon(scope, base, report) {
+    const nav = scope.navigator;
+    const beacon = nav?.sendBeacon;
+    if (nav === undefined || typeof beacon !== "function")
+        return [];
+    nav.sendBeacon = (url, data) => {
+        const sent = beacon.call(nav, url, data);
+        report({ url: urlOf(url, base), method: "POST", initiator: "beacon", bytes: 0, failed: !sent });
+        return sent;
+    };
+    return [
+        () => {
+            nav.sendBeacon = beacon;
+        },
+    ];
+}
+/** What the browser loaded by itself: Resource Timing entries (and the page's own load), buffered. */
+function observeResources(scope, report) {
+    const Observer = scope.PerformanceObserver;
+    if (Observer === undefined)
+        return [];
+    const types = new Set(Observer.supportedEntryTypes ?? []);
+    // A document navigates once, but Chromium reports its navigation entry again when the load ends.
+    let navigated = false;
+    const take = (entry) => {
+        if (entry.entryType === "navigation") {
+            if (navigated)
+                return;
+            navigated = true;
+        }
+        const timing = entry;
+        if (WRAPPED_INITIATORS.has(timing.initiatorType))
+            return;
+        if (!/^https?:/.test(timing.name))
+            return;
+        const bytes = timing.transferSize || timing.encodedBodySize || 0;
+        // When the request started, not when the observer heard of it: a buffered entry comes late.
+        const at = Math.round((scope.performance?.timeOrigin ?? Date.now()) + entry.startTime);
+        report({ url: timing.name, method: "GET", initiator: timing.initiatorType || entry.entryType, bytes, failed: false }, at);
+    };
+    const observers = [];
+    for (const type of ["navigation", "resource"]) {
+        if (!types.has(type))
+            continue;
+        const observer = new Observer((list) => {
+            for (const entry of list.getEntries())
+                take(entry);
+        });
+        observer.observe({ type, buffered: true });
+        observers.push(observer);
+    }
+    return observers.map((observer) => () => observer.disconnect());
+}
+//# sourceMappingURL=watch.js.map

package/dist/network/watch.js.map

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