@laminapdf/viewer 0.2.0-alpha.3 → 0.2.0-alpha.5

package/dist/layers/highlight-layer.js

@@ -0,0 +1,95 @@
+// The find highlights: on every mounted page, a box over each match, in the page's
+// `lamina-layer-highlight` slot. Like the text layer, the boxes sit in page points inside one box
+// that a CSS transform scales and turns to the page, so a zoom or a rotation moves none of them.
+// Each match quad is drawn as its bounding box. The current match gets its own class. The viewer
+// adds no style sheet: colours come from `--lamina-find-match` and `--lamina-find-current`, and
+// the current match also gets an outline (`--lamina-find-current-outline`), so it never differs
+// by colour alone. The boxes take no pointer events, so they never stand in a selection's way.
+import { placeBox } from "./box.js";
+/** The axis-aligned box around a quad's four corners. */
+function bounds(q, at) {
+    const xs = [q[at], q[at + 2], q[at + 4], q[at + 6]].map((v) => v ?? 0);
+    const ys = [q[at + 1], q[at + 3], q[at + 5], q[at + 7]].map((v) => v ?? 0);
+    const x = Math.min(...xs);
+    const y = Math.min(...ys);
+    return { x, y, width: Math.max(...xs) - x, height: Math.max(...ys) - y };
+}
+/** The find highlights of one viewer. */
+export class HighlightLayer {
+    name = "highlight";
+    #host;
+    #pages = new Map();
+    constructor(host) {
+        this.#host = host;
+    }
+    onMount(page, slot) {
+        const box = document.createElement("div");
+        box.className = "lamina-highlight-layer";
+        Object.assign(box.style, {
+            position: "absolute",
+            left: "0",
+            top: "0",
+            transformOrigin: "0 0",
+            pointerEvents: "none",
+        });
+        slot.append(box);
+        this.#pages.set(page, { box, size: undefined });
+        this.#draw(page);
+    }
+    onUnmount(page) {
+        this.#pages.get(page)?.box.remove();
+        this.#pages.delete(page);
+    }
+    onZoom(page, _slot, size) {
+        const view = this.#pages.get(page);
+        if (view === undefined)
+            return;
+        view.size = size;
+        this.#place(page, view);
+    }
+    /** Draws the pages again: matches arrived or went, the current one moved, or the view turned. */
+    refresh(pages) {
+        for (const page of pages ?? this.#pages.keys()) {
+            const view = this.#pages.get(page);
+            if (view === undefined)
+                continue;
+            this.#place(page, view);
+            this.#draw(page);
+        }
+    }
+    #place(page, view) {
+        const points = this.#host.points(page);
+        if (points !== undefined && view.size !== undefined)
+            placeBox(view.box, points, view.size, this.#host.rotation());
+    }
+    #draw(page) {
+        const view = this.#pages.get(page);
+        if (view === undefined)
+            return;
+        const { matches, current } = this.#host.matchesOn(page);
+        const marks = [];
+        matches.forEach((quads, index) => {
+            for (let at = 0; at + 8 <= quads.length; at += 8) {
+                const r = bounds(quads, at);
+                const mark = document.createElement("div");
+                const isCurrent = index === current;
+                mark.className = isCurrent ? "lamina-find-match lamina-find-current" : "lamina-find-match";
+                Object.assign(mark.style, {
+                    position: "absolute",
+                    left: `${r.x}px`,
+                    top: `${r.y}px`,
+                    width: `${r.width}px`,
+                    height: `${r.height}px`,
+                    background: isCurrent
+                        ? "var(--lamina-find-current, rgba(237, 191, 106, 0.6))"
+                        : "var(--lamina-find-match, rgba(246, 227, 188, 0.6))",
+                    mixBlendMode: "multiply",
+                    outline: isCurrent ? "2px solid var(--lamina-find-current-outline, #8a5300)" : "",
+                });
+                marks.push(mark);
+            }
+        });
+        view.box.replaceChildren(...marks);
+    }
+}
+//# sourceMappingURL=highlight-layer.js.map

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

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

package/dist/layers/link-layer.d.ts

@@ -0,0 +1,68 @@
+import type { PageLink, Target } from "@laminapdf/sdk";
+import type { ViewerClient } from "../client.js";
+import type { PageSize, Rotation } from "../layout/page-layout.js";
+import type { PageLayer } from "../view/viewer.js";
+import { type OpenableLink } from "./link-url.js";
+/** The words the layer gives links without a description of their own, and its hover notes. */
+export interface LinkWords {
+    /** A link to page `page` (0-based). */
+    page(page: number): string;
+    readonly nextPage: string;
+    readonly previousPage: string;
+    readonly firstPage: string;
+    readonly lastPage: string;
+    /** A link to another file, named when the file says which. */
+    otherFile(file: string | undefined): string;
+    /** A link whose address can't be opened (a `javascript:`, `file:` or `data:` one). */
+    refused(uri: string): string;
+    /** A link that asks to run an action, which the reader never does (`Launch`, `JavaScript`…). */
+    readonly unsupported: string;
+    /** A link whose destination isn't in the document. */
+    readonly broken: string;
+}
+/** The link layer's options (`createViewer`'s `links`). */
+export interface LinkLayerOptions {
+    /**
+     * The address of page `page` (0-based) of this document, for an internal link's `href`, so a
+     * new tab opens the same document there; `undefined` leaves the link without one.
+     */
+    readonly href?: (page: number) => string | undefined;
+    /** A web or email link was followed: ask the reader before opening it (normalised, punycode host). */
+    readonly onExternal?: (link: OpenableLink) => void;
+    /** The words for links without a description, and the hover notes (default English). */
+    readonly words?: LinkWords;
+    /**
+     * A link that does nothing was followed (another file, an action never run, a refused
+     * address, a broken destination), with the note it shows: for the app's debug log.
+     */
+    readonly onInert?: (link: PageLink, note: string) => void;
+}
+/** What the link layer needs of its viewer. */
+export interface LinkHost {
+    /** The viewer's root, where a selection drag starts. */
+    readonly root: HTMLElement;
+    readonly client: Pick<ViewerClient, "pageLinks">;
+    /** Page `page`'s displayed size in points. */
+    points(page: number): PageSize | undefined;
+    rotation(): Rotation;
+    /** The number of pages. */
+    pageCount(): number;
+    /** Goes to `target` as a history jump. */
+    goTo(target: Target): void;
+    /** Goes to page `page` (0-based) as a history jump. */
+    goToPage(page: number): void;
+}
+/** The link layer of one viewer. */
+export declare class LinkLayer implements PageLayer {
+    #private;
+    readonly name = "annot";
+    constructor(host: LinkHost, options?: LinkLayerOptions);
+    /** Stops listening: the viewer is going. */
+    destroy(): void;
+    onMount(page: number, slot: HTMLElement): void;
+    onUnmount(page: number): void;
+    onZoom(page: number, _slot: HTMLElement, size: PageSize): void;
+    /** Places every page again: the view turned. */
+    refresh(): void;
+}
+//# sourceMappingURL=link-layer.d.ts.map

package/dist/layers/link-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-layer.d.ts","sourceRoot":"","sources":["../../src/layers/link-layer.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAEhE,+FAA+F;AAC/F,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IAC5C,sFAAsF;IACtF,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,gGAAgG;IAChG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAkBD,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACrD,sGAAsG;IACtG,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IACnD,wFAAwF;IACxF,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3D;AAED,+CAA+C;AAC/C,MAAM,WAAW,QAAQ;IACvB,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IACjD,8CAA8C;IAC9C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,QAAQ,IAAI,QAAQ,CAAC;IACrB,2BAA2B;IAC3B,SAAS,IAAI,MAAM,CAAC;IACpB,0CAA0C;IAC1C,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AA0DD,oCAAoC;AACpC,qBAAa,SAAU,YAAW,SAAS;;IACzC,QAAQ,CAAC,IAAI,WAAW;IAQxB,YAAY,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAE,gBAAqB,EAiBzD;IAED,4CAA4C;IAC5C,OAAO,IAAI,IAAI,CAEd;IASD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAgC7C;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAK5B;IAED,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAK7D;IAED,gDAAgD;IAChD,OAAO,IAAI,IAAI,CAEd;CAyHF"}

package/dist/layers/link-layer.js

@@ -0,0 +1,279 @@
+// The link layer (web-app §6 C6, R07): on every mounted page, an anchor over each of Lamina PDF's
+// links, in the page's `lamina-layer-annot` slot, above the text and below the find highlights.
+// Like the other layers, the anchors sit in page points inside one box that a CSS transform scales
+// and turns to the page. Only the anchors take pointer events, so text around a link still selects.
+// Anchors follow page order, so Tab moves through a page's links in order, then the next page's.
+// While a drag that started outside every link is under way, no anchor takes pointer events, so a
+// selection begun in the text runs on over the text under a link.
+//
+// What a link does is decided here, never by the browser: a primary click or Enter is always
+// handled (`preventDefault`). A link inside the document goes there through the viewer (a history
+// jump); its `href` is the app's address for that page, so a middle click or "Open in new tab"
+// opens the same document there. A web or email link asks the app to confirm first, on a click,
+// a middle click or Enter. It has no `href`, so no browser menu ("Open in new tab") can open it
+// without asking; its title shows the address. Anything else (another file, an action a reader
+// never runs, a refused scheme, a broken destination) has no `href` either, does nothing, and
+// says why on hover.
+import { placeBox } from "./box.js";
+import { externalLink } from "./link-url.js";
+/** English, for a viewer whose app gives none. */
+const ENGLISH = {
+    page: (page) => `Link to page ${page + 1}`,
+    nextPage: "Goes to the next page",
+    previousPage: "Goes to the previous page",
+    firstPage: "Goes to the first page",
+    lastPage: "Goes to the last page",
+    otherFile: (file) => file === undefined
+        ? "Links to another file, which can't be opened from here"
+        : `Links to another file, ${file}, which can't be opened from here`,
+    refused: (uri) => `This link's address can't be opened: ${uri}`,
+    unsupported: "This link asks to run an action. The reader never runs these.",
+    broken: "This link's destination isn't in the document",
+};
+/** The page a standard named action goes to from page `page` of `count`, and its words. */
+function namedAction(name, page, count, words) {
+    switch (name) {
+        case "NextPage":
+            return { page: Math.min(count - 1, page + 1), label: words.nextPage };
+        case "PrevPage":
+            return { page: Math.max(0, page - 1), label: words.previousPage };
+        case "FirstPage":
+            return { page: 0, label: words.firstPage };
+        case "LastPage":
+            return { page: count - 1, label: words.lastPage };
+        default:
+            return undefined;
+    }
+}
+/** What a link that does nothing means: named and noted by `note`. */
+function inert(link, note) {
+    return { follow: { kind: "none", link, note }, label: note, note };
+}
+/** The box around eight-number quads (or the rectangle, without any), in page points. */
+function areas(link) {
+    const out = [];
+    const q = link.quads ?? [];
+    for (let at = 0; at + 8 <= q.length; at += 8) {
+        const xs = [q[at], q[at + 2], q[at + 4], q[at + 6]].map((v) => v ?? 0);
+        const ys = [q[at + 1], q[at + 3], q[at + 5], q[at + 7]].map((v) => v ?? 0);
+        const x = Math.min(...xs);
+        const y = Math.min(...ys);
+        out.push({ x, y, width: Math.max(...xs) - x, height: Math.max(...ys) - y });
+    }
+    if (out.length > 0)
+        return out;
+    const [x0, y0, x1, y1] = link.rect;
+    return [{ x: Math.min(x0, x1), y: Math.min(y0, y1), width: Math.abs(x1 - x0), height: Math.abs(y1 - y0) }];
+}
+/** The link layer of one viewer. */
+export class LinkLayer {
+    name = "annot";
+    #host;
+    #options;
+    #words;
+    #pages = new Map();
+    #follows = new WeakMap();
+    #listening = new AbortController();
+    constructor(host, options = {}) {
+        this.#host = host;
+        this.#options = options;
+        this.#words = options.words ?? ENGLISH;
+        const { signal } = this.#listening;
+        host.root.addEventListener("pointerdown", (e) => {
+            if (e.button === 0 && !this.#followOf(e))
+                this.#passThrough(true);
+        }, { signal });
+        for (const end of ["pointerup", "pointercancel"]) {
+            document.addEventListener(end, () => this.#passThrough(false), { signal });
+        }
+        // A button released outside the window may send no pointerup: leaving the window ends the drag too.
+        window.addEventListener("blur", () => this.#passThrough(false), { signal });
+    }
+    /** Stops listening: the viewer is going. */
+    destroy() {
+        this.#listening.abort();
+    }
+    /** Lets the pointer through every anchor (a selection drag is under way), or stops letting it. */
+    #passThrough(through) {
+        for (const { box } of this.#pages.values()) {
+            for (const a of box.children)
+                a.style.pointerEvents = through ? "none" : "auto";
+        }
+    }
+    onMount(page, slot) {
+        const box = document.createElement("div");
+        box.className = "lamina-link-layer";
+        Object.assign(box.style, {
+            position: "absolute",
+            left: "0",
+            top: "0",
+            transformOrigin: "0 0",
+            pointerEvents: "none",
+        });
+        slot.append(box);
+        const view = { box, abort: new AbortController(), size: undefined };
+        this.#pages.set(page, view);
+        box.addEventListener("click", (e) => this.#click(e));
+        // A link without an `href` (a web link) gets no click from Enter: it follows it here.
+        box.addEventListener("keydown", (e) => {
+            const anchor = e.target instanceof HTMLElement ? e.target : undefined;
+            // One follow per press, as a native link's click: a held key's repeats ask nothing more.
+            if (e.key === "Enter" && !e.repeat && anchor !== undefined && !anchor.hasAttribute("href"))
+                this.#click(e);
+        });
+        // A middle click on a web link would open it without asking: it asks too.
+        box.addEventListener("auxclick", (e) => {
+            if (e.button === 1 && this.#followOf(e)?.kind === "external")
+                this.#click(e);
+        });
+        this.#host.client
+            .pageLinks(page, { signal: view.abort.signal })
+            .then((links) => {
+            if (this.#pages.get(page) === view)
+                this.#draw(page, view, links);
+        })
+            .catch(() => {
+            // Aborted (the page left), or links that can't be read: the page stays without them.
+        });
+    }
+    onUnmount(page) {
+        const view = this.#pages.get(page);
+        view?.abort.abort();
+        view?.box.remove();
+        this.#pages.delete(page);
+    }
+    onZoom(page, _slot, size) {
+        const view = this.#pages.get(page);
+        if (view === undefined)
+            return;
+        view.size = size;
+        this.#place(page, view);
+    }
+    /** Places every page again: the view turned. */
+    refresh() {
+        for (const [page, view] of this.#pages)
+            this.#place(page, view);
+    }
+    #place(page, view) {
+        const points = this.#host.points(page);
+        if (points !== undefined && view.size !== undefined)
+            placeBox(view.box, points, view.size, this.#host.rotation());
+    }
+    #draw(page, view, links) {
+        view.box.replaceChildren(...links.map((link) => this.#anchor(page, link)));
+    }
+    /** The anchor for `link` on page `page`: placed, named, and with what following it does. */
+    #anchor(page, link) {
+        const { follow, label, note } = this.#meaning(page, link);
+        const a = document.createElement("a");
+        a.className = "lamina-link";
+        a.draggable = false;
+        const href = this.#internalHref(follow);
+        if (href === undefined) {
+            // No address for the browser to follow: still a link in the tab order, and named.
+            a.setAttribute("role", "link");
+            a.tabIndex = 0;
+            if (follow.kind === "none")
+                a.setAttribute("aria-disabled", "true");
+        }
+        else {
+            a.href = href;
+            a.referrerPolicy = "no-referrer";
+        }
+        a.setAttribute("aria-label", link.contents ?? label);
+        if (note !== undefined)
+            a.title = note;
+        const [first, ...rest] = areas(link);
+        const bounds = first ?? { x: 0, y: 0, width: 0, height: 0 };
+        Object.assign(a.style, {
+            position: "absolute",
+            left: `${bounds.x}px`,
+            top: `${bounds.y}px`,
+            width: `${bounds.width}px`,
+            height: `${bounds.height}px`,
+            pointerEvents: "auto",
+            cursor: follow.kind === "none" ? "default" : "pointer",
+        });
+        // A link over several areas (its quads): the first is the anchor, the others its children,
+        // placed from it, so only the areas follow the link and the focus ring is on the first.
+        for (const area of rest) {
+            const part = document.createElement("span");
+            Object.assign(part.style, {
+                position: "absolute",
+                left: `${area.x - bounds.x}px`,
+                top: `${area.y - bounds.y}px`,
+                width: `${area.width}px`,
+                height: `${area.height}px`,
+            });
+            a.append(part);
+        }
+        this.#follows.set(a, follow);
+        return a;
+    }
+    /** What `link` on page `page` does, its name, and the note it shows on hover. */
+    #meaning(page, link) {
+        const words = this.#words;
+        switch (link.kind) {
+            case "dest":
+            case "named":
+                return link.target === undefined
+                    ? inert(link, words.broken)
+                    : { follow: { kind: "target", target: link.target }, label: words.page(link.target.page) };
+            case "uri": {
+                const external = externalLink(link.uri);
+                return external.kind === "open"
+                    ? { follow: { kind: "external", link: external }, label: external.href, note: external.href }
+                    : inert(link, words.refused(link.uri));
+            }
+            case "remote": {
+                return inert(link, words.otherFile(link.file));
+            }
+            case "named-action": {
+                const to = namedAction(link.name, page, this.#host.pageCount(), words);
+                return to === undefined
+                    ? inert(link, words.unsupported)
+                    : { follow: { kind: "page", page: to.page }, label: to.label, note: to.label };
+            }
+            default:
+                return inert(link, words.unsupported);
+        }
+    }
+    #internalHref(follow) {
+        if (follow.kind === "target")
+            return this.#options.href?.(follow.target.page);
+        if (follow.kind === "page")
+            return this.#options.href?.(follow.page);
+        return undefined;
+    }
+    /** What following the anchor `e` happened on does. */
+    #followOf(e) {
+        const anchor = e.target instanceof Element ? e.target.closest("a.lamina-link") : null;
+        return anchor instanceof HTMLElement ? this.#follows.get(anchor) : undefined;
+    }
+    #click(e) {
+        const follow = this.#followOf(e);
+        if (follow === undefined)
+            return;
+        const external = follow.kind === "external";
+        // A modified click on a link inside the document opens its `href` where the browser puts it.
+        const modified = e.ctrlKey || e.metaKey || e.shiftKey || e.altKey || (e instanceof MouseEvent && e.button !== 0);
+        if (!external && modified)
+            return;
+        e.preventDefault();
+        switch (follow.kind) {
+            case "target":
+                this.#host.goTo(follow.target);
+                return;
+            case "page":
+                this.#host.goToPage(follow.page);
+                return;
+            case "external":
+                this.#options.onExternal?.(follow.link);
+                return;
+            case "none":
+                this.#options.onInert?.(follow.link, follow.note);
+                return;
+        }
+    }
+}
+//# sourceMappingURL=link-layer.js.map

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

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

package/dist/layers/link-url.d.ts

@@ -0,0 +1,19 @@
+/** A link address as a reader treats it. */
+export type ExternalLink = OpenableLink | {
+    readonly kind: "refused";
+    readonly uri: string;
+};
+/** A link address that may open after the reader confirms. */
+export type OpenableLink = {
+    readonly kind: "open";
+    readonly href: string;
+    /** The address in three parts, the host (or a mailto address's domain) emphasised. */
+    readonly parts: {
+        readonly before: string;
+        readonly host: string;
+        readonly after: string;
+    };
+};
+/** What a reader does with the link address `uri`. */
+export declare function externalLink(uri: string): ExternalLink;
+//# sourceMappingURL=link-url.d.ts.map

package/dist/layers/link-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-url.d.ts","sourceRoot":"","sources":["../../src/layers/link-url.ts"],"names":[],"mappings":"AASA,4CAA4C;AAC5C,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7F,8DAA8D;AAC9D,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5F,CAAC;AAEF,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAkCtD"}

package/dist/layers/link-url.js

@@ -0,0 +1,47 @@
+// Which link addresses a reader may open (web-app §2: external links confirm before leaving; R07:
+// only `http(s):` and `mailto:` open), and how one is shown so it can't pass for another. The
+// address comes from the file and is never trusted: `javascript:`, `file:`, `data:` and every other
+// scheme are refused, as is anything `URL` can't parse. A host is shown as `URL` gives it: an
+// international name in punycode (`xn--…`), so a look-alike host reads as what it is.
+/** The schemes a link may open. */
+const OPENABLE = new Set(["http:", "https:", "mailto:"]);
+/** What a reader does with the link address `uri`. */
+export function externalLink(uri) {
+    let url;
+    try {
+        url = new URL(uri.trim());
+    }
+    catch {
+        return { kind: "refused", uri };
+    }
+    if (!OPENABLE.has(url.protocol))
+        return { kind: "refused", uri };
+    const { href } = url;
+    if (url.protocol === "mailto:") {
+        // `mailto:` has no host: the domain after the last `@` is what a reader checks.
+        const at = href.lastIndexOf("@");
+        const end = href.search(/[?#]/);
+        const stop = end < 0 ? href.length : end;
+        if (at < 0 || at > stop)
+            return { kind: "open", href, parts: { before: href, host: "", after: "" } };
+        return {
+            kind: "open",
+            href,
+            parts: { before: href.slice(0, at + 1), host: href.slice(at + 1, stop), after: href.slice(stop) },
+        };
+    }
+    // The host follows `//` and any credentials (`user:password@`), which may hold the host's own
+    // text to pass for it: count past them rather than search.
+    const userinfo = url.username === "" && url.password === "" ? 0 : href.indexOf("@", url.protocol.length) + 1;
+    const start = userinfo > 0 ? userinfo : url.protocol.length + 2;
+    return {
+        kind: "open",
+        href,
+        parts: {
+            before: href.slice(0, start),
+            host: url.host,
+            after: href.slice(start + url.host.length),
+        },
+    };
+}
+//# sourceMappingURL=link-url.js.map

package/dist/layers/link-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-url.js","sourceRoot":"","sources":["../../src/layers/link-url.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,8FAA8F;AAC9F,oGAAoG;AACpG,8FAA8F;AAC9F,sFAAsF;AAEtF,mCAAmC;AACnC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;AAazD,sDAAsD;AACtD,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;IAClC,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;IACjE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC;IACrB,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC/B,gFAAgF;QAChF,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;QACzC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,IAAI;YAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC;QACrG,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,IAAI;YACJ,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;SAClG,CAAC;IACJ,CAAC;IACD,8FAA8F;IAC9F,2DAA2D;IAC3D,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,KAAK,EAAE,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7G,MAAM,KAAK,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAChE,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,IAAI;QACJ,KAAK,EAAE;YACL,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;YAC5B,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;SAC3C;KACF,CAAC;AACJ,CAAC"}

package/dist/layers/spans.d.ts

@@ -0,0 +1,36 @@
+import type { TextRunData } from "../protocol.js";
+/** Where one run's span goes, in page space (points). */
+export interface SpanSpec {
+    /** The run's index in the page's runs. */
+    readonly run: number;
+    /** Its text (document text). */
+    readonly text: string;
+    /** The span's top-left corner, before its rotation. */
+    readonly left: number;
+    readonly top: number;
+    /** Its extent along the baseline and across it. */
+    readonly width: number;
+    readonly height: number;
+    /** The baseline's angle, clockwise from the x axis, in radians. */
+    readonly angle: number;
+    /** The run reads right to left. */
+    readonly rtl: boolean;
+    /** The marked-content ID, for the structure tree. */
+    readonly mcid?: number;
+}
+/**
+ * Each run's span, in run order (the page's reading order). Runs without glyphs or text have none.
+ * The baseline's direction comes from the first glyph's quad (its bottom edge), or for vertical
+ * writing from the first glyph's centre to the last's; the span's box covers every glyph's quad
+ * in that frame.
+ */
+export declare function layoutSpans(runs: readonly TextRunData[], quads: Float32Array): SpanSpec[];
+/** A selected piece of a span's text, with where its span is, for joining. */
+export interface Piece {
+    readonly page: number;
+    readonly text: string;
+    readonly span: SpanSpec;
+}
+/** What goes between two pieces as copy writes them: a new line, a space or nothing. */
+export declare function separator(a: Piece, b: Piece): string;
+//# sourceMappingURL=spans.d.ts.map

package/dist/layers/spans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spans.d.ts","sourceRoot":"","sources":["../../src/layers/spans.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,yDAAyD;AACzD,MAAM,WAAW,QAAQ;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAsCD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,EAAE,KAAK,EAAE,YAAY,GAAG,QAAQ,EAAE,CAKzF;AA2CD,8EAA8E;AAC9E,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,MAAM,CAgBpD"}