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

package/dist/history/history.js

@@ -0,0 +1,135 @@
+// Back and forward through the places a reader jumped from and to (web-app §6 C6, R07): links,
+// the outline, thumbnails, go to page and find each record a jump; scrolling alone never does.
+// A jump first notes where the view is now (so Back returns to where the reader had scrolled,
+// not only to where they last landed), then adds the place it lands on, cutting off whatever
+// Forward held. A jump that lands where the view already is adds nothing. Each entry has an id
+// that outlives the oldest entries' removal, so an app can tie its own history (the browser's,
+// through the address fragment) to these entries and come back to one by id.
+/** Whether `a` and `b` show the same view: one page, a point within a thousandth of the page, one zoom. */
+function samePlace(a, b) {
+    const near = (x, y) => Math.abs(x - y) < 1e-3;
+    return a.point.page === b.point.page && near(a.point.x, b.point.x) && near(a.point.y, b.point.y) && a.zoom === b.zoom;
+}
+/** One viewer's back and forward history. */
+export class NavigationHistory {
+    #host;
+    #max;
+    #entries = [];
+    #index = -1;
+    #nextId = 1;
+    #state = { current: undefined, back: undefined, forward: undefined };
+    #listeners = new Set();
+    #pushes = new Set();
+    constructor(host, options = {}) {
+        this.#host = host;
+        this.#max = Math.max(2, Math.trunc(options.max ?? 100));
+    }
+    /** What Back and Forward do now (a new object after each change). */
+    getState() {
+        return this.#state;
+    }
+    /** Calls `listener` after every change (for `useSyncExternalStore`). */
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    }
+    /**
+     * Calls `listener` when an entry is added: by a jump (`replaced` false), or as the first entry
+     * of a document (`replaced` true, as `history.replaceState` would). Back, Forward and `goTo`
+     * add nothing, so they never call it.
+     */
+    onEntry(listener) {
+        this.#pushes.add(listener);
+        return () => this.#pushes.delete(listener);
+    }
+    /** Forgets every entry: a new document starts a history of its own. */
+    reset() {
+        this.#entries = [];
+        this.#index = -1;
+        this.#changed();
+    }
+    /**
+     * Runs `go` (which moves the view) as a jump: where the view was is kept for Back, and where it
+     * lands is the new current entry, with nothing left for Forward. Landing where it was adds
+     * nothing.
+     */
+    jump(go) {
+        const before = this.#host.place();
+        if (before !== undefined)
+            this.#note(before);
+        go();
+        const after = this.#host.place();
+        if (after === undefined)
+            return;
+        const current = this.#entries[this.#index];
+        if (current !== undefined && samePlace(current, after))
+            return;
+        this.#entries.splice(this.#index + 1);
+        const entry = this.#add(after);
+        for (const listener of this.#pushes)
+            listener(entry, false);
+        this.#changed();
+    }
+    /** Goes back one entry; `false` when there is none. */
+    back() {
+        const entry = this.#entries[this.#index - 1];
+        return entry === undefined ? false : this.goTo(entry.id);
+    }
+    /** Goes forward one entry; `false` when there is none. */
+    forward() {
+        const entry = this.#entries[this.#index + 1];
+        return entry === undefined ? false : this.goTo(entry.id);
+    }
+    /**
+     * Goes to the entry `id` (Back or Forward, by the browser's history or the app's own): the
+     * view moves there and the entries stay. `false` when that entry is gone (pushed out, or from
+     * another document).
+     */
+    goTo(id) {
+        const index = this.#entries.findIndex((e) => e.id === id);
+        const entry = this.#entries[index];
+        if (entry === undefined)
+            return false;
+        const here = this.#host.place();
+        // Where the reader scrolled to since landing is where coming back returns.
+        if (here !== undefined)
+            this.#update(here);
+        this.#index = index;
+        this.#host.show(entry);
+        this.#changed();
+        return true;
+    }
+    /** The current entry takes `place`, or the first entry is made from it. */
+    #note(place) {
+        if (this.#index < 0) {
+            const entry = this.#add(place);
+            for (const listener of this.#pushes)
+                listener(entry, true);
+            return;
+        }
+        this.#update(place);
+    }
+    #update(place) {
+        const current = this.#entries[this.#index];
+        if (current !== undefined)
+            this.#entries[this.#index] = { ...place, id: current.id };
+    }
+    #add(place) {
+        const entry = { ...place, id: this.#nextId++ };
+        this.#entries.push(entry);
+        if (this.#entries.length > this.#max)
+            this.#entries.splice(0, this.#entries.length - this.#max);
+        this.#index = this.#entries.length - 1;
+        return entry;
+    }
+    #changed() {
+        this.#state = {
+            current: this.#entries[this.#index],
+            back: this.#entries[this.#index - 1],
+            forward: this.#entries[this.#index + 1],
+        };
+        for (const listener of this.#listeners)
+            listener();
+    }
+}
+//# sourceMappingURL=history.js.map

package/dist/history/history.js.map

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

package/dist/index.d.ts

@@ -1,15 +1,23 @@
 export type { CanvasPoolOptions } from "./canvas/pool.js";
 export type { RestartReason, ViewerCallOptions, ViewerEvent, ViewerEvents, ViewerOptions } from "./client.js";
 export { ViewerClient } from "./client.js";
+export { CLOSED_SESSION, type EditBlock, type EditFailure, type EditSession, type EditSessionState, type FailureListener, type RevertListener, } from "./edit/session.js";
 export type { FindController, FindResult, FindState } from "./find/controller.js";
 export type { FindOptions } from "./find/fold.js";
 export type { FindSnippet } from "./find/page.js";
+export type { HistoryEntry, HistoryPlace, HistoryState, NavigationHistory, NavigationHistoryOptions, ViewPosition, } from "./history/history.js";
+export type { CopyMode } from "./layers/copy.js";
+export type { LinkLayerOptions, LinkPreviewPointer, LinkPreviewRequest, LinkWords } from "./layers/link-layer.js";
+export { type ExternalLink, externalLink, type OpenableLink } from "./layers/link-url.js";
 export type { TextLayerOptions, TextSelection } from "./layers/text-layer.js";
-export type { Rotation } from "./layout/page-layout.js";
+export type { PageSize, Rotation } from "./layout/page-layout.js";
 export { type NetworkSink, watchNetwork } from "./network/watch.js";
-export type { BackendInit, BackendName, FindPageResult, LoadProgress, MethodName, Methods, NetworkRecord, NetworkSource, OpenedDocument, PageTextData, Params, PolicyViolation, Priority, RemoteSource, RenderedBitmap, Result, SourceInit, StructureData, TextRunData, ViewerOpenOptions, WorkerMemory, WorkerNetworkLog, } from "./protocol.js";
+export type { BackendInit, BackendName, EditHistory, EditResult, EditStep, FindPageResult, LoadProgress, MethodName, Methods, NetworkRecord, NetworkSource, OpenedDocument, PageTextData, Params, PolicyViolation, PrintedPage, PrintOptions, Priority, ReadingBlock, RemoteSource, RenderedBitmap, ReplayedStep, Result, RevertedStep, SourceInit, StructureData, TextRunData, ViewerOpenOptions, WorkerMemory, WorkerNetworkLog, } from "./protocol.js";
+export { EMPTY_HISTORY, HISTORY_DEPTH } from "./protocol.js";
+export { CACHE_FOLDER } from "./source/opfs.js";
 export { ThumbnailStrip, type ThumbnailStripOptions } from "./thumbnails/strip.js";
-export type { CreateViewerOptions, PageLayer, PageRenderState, RenderStats, ViewerEventMap, ViewState, } from "./view/viewer.js";
+export type { LinkPreviewPicture } from "./view/previews.js";
+export type { CreateViewerOptions, InvalidatedPage, PageLayer, PageRegionOptions, PageRenderState, RenderStats, ViewerEventMap, ViewState, } from "./view/viewer.js";
 export { createViewer, Viewer } from "./view/viewer.js";
 export type { DocumentPoint, Point, Zoom, ZoomMode } from "./zoom/zoom.js";
 export { MAX_ZOOM, MIN_ZOOM } from "./zoom/zoom.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9G,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAClF,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC9E,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,KAAK,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpE,YAAY,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,YAAY,EACZ,UAAU,EACV,OAAO,EACP,aAAa,EACb,aAAa,EACb,cAAc,EACd,YAAY,EACZ,MAAM,EACN,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,MAAM,EACN,UAAU,EACV,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnF,YAAY,EACV,mBAAmB,EACnB,SAAS,EACT,eAAe,EACf,WAAW,EACX,cAAc,EACd,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9G,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EACL,cAAc,EACd,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAClF,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,wBAAwB,EACxB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAClH,OAAO,EAAE,KAAK,YAAY,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC1F,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC9E,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,KAAK,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpE,YAAY,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,UAAU,EACV,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,UAAU,EACV,OAAO,EACP,aAAa,EACb,aAAa,EACb,cAAc,EACd,YAAY,EACZ,MAAM,EACN,eAAe,EACf,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,MAAM,EACN,YAAY,EACZ,UAAU,EACV,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnF,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,cAAc,EACd,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -3,7 +3,11 @@
 // canvas pool, the bitmap cache, the tile and zoom maths) are not exported: the README describes
 // them, and their unit tests import them by path within the package.
 export { ViewerClient } from "./client.js";
+export { CLOSED_SESSION, } from "./edit/session.js";
+export { externalLink } from "./layers/link-url.js";
 export { watchNetwork } from "./network/watch.js";
+export { EMPTY_HISTORY, HISTORY_DEPTH } from "./protocol.js";
+export { CACHE_FOLDER } from "./source/opfs.js";
 export { ThumbnailStrip } from "./thumbnails/strip.js";
 export { createViewer, Viewer } from "./view/viewer.js";
 export { MAX_ZOOM, MIN_ZOOM } from "./zoom/zoom.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,iGAAiG;AACjG,iGAAiG;AACjG,qEAAqE;AAIrE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C,OAAO,EAAoB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAyBpE,OAAO,EAAE,cAAc,EAA8B,MAAM,uBAAuB,CAAC;AASnF,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,iGAAiG;AACjG,iGAAiG;AACjG,qEAAqE;AAIrE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EACL,cAAc,GAOf,MAAM,mBAAmB,CAAC;AAc3B,OAAO,EAAqB,YAAY,EAAqB,MAAM,sBAAsB,CAAC;AAG1F,OAAO,EAAoB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAiCpE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,cAAc,EAA8B,MAAM,uBAAuB,CAAC;AAYnF,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/layers/copy.d.ts

@@ -0,0 +1,26 @@
+import type { ReadingBlock } from "../protocol.js";
+import { type Piece } from "./spans.js";
+/** How copy joins a selection: by paragraph (reading order) or as laid out. */
+export type CopyMode = "paragraph" | "exact";
+/** What copy writes to the clipboard. */
+export interface Copied {
+    readonly text: string;
+    readonly html: string;
+}
+/** `text` with each ligature written as its letters, so the copied words can be searched. */
+export declare function expandLigatures(text: string): string;
+/**
+ * The copy of `pieces` (the selection's, in page and run order). `blocks` gives a page's
+ * reading-order blocks, or `undefined` when they aren't known (yet): that page's pieces then form
+ * one block in run order.
+ */
+export declare function copySelection(pieces: readonly Piece[], mode: CopyMode, blocks: (page: number) => readonly ReadingBlock[] | undefined): Copied;
+/**
+ * `lines` as one, by the extraction's own rule (`join_lines` in laminapdf-extract's
+ * `text_fix.rs`), so a paragraph copies as `extract()` gives it: joined by a space, except after
+ * a soft hyphen or a word-final hyphen. There a lowercase continuation joins the word again (the
+ * hyphen dropped), and anything else follows the hyphen with no space ("Jean-" "Paul" gives
+ * "Jean-Paul"; a soft hyphen becomes a hyphen). A spaced dash ("a -") is followed by a space.
+ */
+export declare function joinLines(lines: readonly string[]): string;
+//# sourceMappingURL=copy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../src/layers/copy.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,KAAK,KAAK,EAAa,MAAM,YAAY,CAAC;AAEnD,+EAA+E;AAC/E,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;AAE7C,yCAAyC;AACzC,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAgBD,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAQD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,YAAY,EAAE,GAAG,SAAS,GAC5D,MAAM,CAWR;AAiFD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAQ1D"}

package/dist/layers/copy.js

@@ -0,0 +1,150 @@
+// What copy writes (UI/UX plan §5.3): the selected pieces of the text layer's spans, joined in one
+// of two modes. Copy as paragraph, the default, follows the reading order of Lamina PDF's
+// extraction: the pieces go block by block, a block's lines join into one line (a word broken by
+// a hyphen at a line's end joined again), and blocks are separated by a blank line, so a paragraph
+// pasted from a two-column page reads as one paragraph, column after column. Copy exact keeps the
+// layout's line breaks. Both write the same text as HTML too, a paragraph per block. A table's
+// lines keep their breaks in both modes, since joining them would merge its cells.
+import { separator } from "./spans.js";
+/** U+00AD, which marks where a word may break: written as a code, since it is invisible. */
+const SOFT_HYPHEN = String.fromCharCode(0xad);
+/** The Latin ligatures of Unicode's Alphabetic Presentation Forms, as the letters they join. */
+const LIGATURES = {
+    ff: "ff",
+    fi: "fi",
+    fl: "fl",
+    ffi: "ffi",
+    ffl: "ffl",
+    ſt: "st",
+    st: "st",
+};
+/** `text` with each ligature written as its letters, so the copied words can be searched. */
+export function expandLigatures(text) {
+    return text.replace(/[ff-st]/g, (c) => LIGATURES[c] ?? c);
+}
+/**
+ * The copy of `pieces` (the selection's, in page and run order). `blocks` gives a page's
+ * reading-order blocks, or `undefined` when they aren't known (yet): that page's pieces then form
+ * one block in run order.
+ */
+export function copySelection(pieces, mode, blocks) {
+    const groups = mode === "paragraph" ? byBlock(pieces, blocks) : byPage(pieces);
+    const paragraphs = groups
+        .map((group) => {
+        const lines = linesOf(group.pieces);
+        return mode === "exact" || group.table ? lines.map((l) => l.replaceAll(SOFT_HYPHEN, "")) : [joinLines(lines)];
+    })
+        .filter((lines) => lines.some((l) => l !== ""));
+    const text = paragraphs.map((lines) => lines.join("\n")).join(mode === "paragraph" ? "\n\n" : "\n");
+    const html = paragraphs.map((lines) => `<p>${lines.map(escapeHtml).join("<br>")}</p>`).join("");
+    return { text, html };
+}
+/** The pieces page by page, in run order (copy exact). */
+function byPage(pieces) {
+    const groups = [];
+    for (const piece of pieces) {
+        const last = groups.at(-1);
+        if (last !== undefined && last.pieces[0]?.page === piece.page)
+            last.pieces.push(piece);
+        else
+            groups.push({ pieces: [piece], table: false });
+    }
+    return groups;
+}
+/**
+ * The pieces block by block, in the page's reading order: each piece goes to the block its span's
+ * centre is in, or the nearest one; within a block they keep their run order.
+ */
+function byBlock(pieces, blocks) {
+    const keyed = new Map();
+    pieces.forEach((piece, k) => {
+        const found = blocks(piece.page);
+        const index = found === undefined || found.length === 0 ? -1 : nearest(found, centreOf(piece));
+        const key = `${piece.page}:${index}`;
+        let entry = keyed.get(key);
+        if (entry === undefined) {
+            // A page without blocks keeps its place by its first piece; a block, by its reading order.
+            const order = index === -1 ? k : index;
+            entry = { page: piece.page, order, group: { pieces: [], table: found?.[index]?.type === "table" } };
+            keyed.set(key, entry);
+        }
+        entry.group.pieces.push(piece);
+    });
+    return [...keyed.values()].sort((a, b) => a.page - b.page || a.order - b.order).map((e) => e.group);
+}
+/** The centre of `piece`'s span, in page space. */
+function centreOf(piece) {
+    const { left, top, width, height, angle } = piece.span;
+    const along = { x: Math.cos(angle), y: Math.sin(angle) };
+    const down = { x: -along.y, y: along.x };
+    return {
+        x: left + (along.x * width) / 2 + (down.x * height) / 2,
+        y: top + (along.y * width) / 2 + (down.y * height) / 2,
+    };
+}
+/** The index of the block whose box holds `p`, or else the one nearest it. */
+function nearest(blocks, p) {
+    let best = 0;
+    let bestDistance = Infinity;
+    blocks.forEach((block, k) => {
+        const [x, y, w, h] = block.bbox;
+        const dx = Math.max(x - p.x, 0, p.x - (x + w));
+        const dy = Math.max(y - p.y, 0, p.y - (y + h));
+        const distance = Math.hypot(dx, dy);
+        if (distance < bestDistance) {
+            best = k;
+            bestDistance = distance;
+        }
+    });
+    return best;
+}
+/** `pieces` as the lines they are laid out on (the text layer's rule: `separator`). */
+function linesOf(pieces) {
+    const lines = [];
+    let line = "";
+    let before;
+    for (const piece of pieces) {
+        const gap = before === undefined ? "" : separator(before, piece);
+        if (gap === "\n") {
+            lines.push(line);
+            line = "";
+        }
+        else
+            line += gap;
+        line += piece.text;
+        before = piece;
+    }
+    lines.push(line);
+    return lines.map((l) => expandLigatures(l).trimEnd());
+}
+/**
+ * `lines` as one, by the extraction's own rule (`join_lines` in laminapdf-extract's
+ * `text_fix.rs`), so a paragraph copies as `extract()` gives it: joined by a space, except after
+ * a soft hyphen or a word-final hyphen. There a lowercase continuation joins the word again (the
+ * hyphen dropped), and anything else follows the hyphen with no space ("Jean-" "Paul" gives
+ * "Jean-Paul"; a soft hyphen becomes a hyphen). A spaced dash ("a -") is followed by a space.
+ */
+export function joinLines(lines) {
+    let out = "";
+    for (const raw of lines) {
+        const line = raw.trim();
+        if (line === "")
+            continue;
+        out = out === "" ? line : joinTwo(out, line);
+    }
+    return out.replaceAll(SOFT_HYPHEN, "");
+}
+/** `out` followed by the next `line`, by `joinLines`' rule. */
+function joinTwo(out, line) {
+    const lowerNext = /^\p{Ll}/u.test(line);
+    if (out.endsWith(SOFT_HYPHEN))
+        return out.slice(0, -1) + (lowerNext ? "" : "-") + line;
+    if (out.endsWith("-") && !out.endsWith(" -"))
+        return (lowerNext ? out.slice(0, -1) : out) + line;
+    return `${out} ${line}`;
+}
+/** `text` safe in HTML. */
+function escapeHtml(text) {
+    return text.replace(/[&<>"]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" })[c] ?? c);
+}
+//# sourceMappingURL=copy.js.map

package/dist/layers/copy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.js","sourceRoot":"","sources":["../../src/layers/copy.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,0FAA0F;AAC1F,iGAAiG;AACjG,mGAAmG;AACnG,kGAAkG;AAClG,+FAA+F;AAC/F,mFAAmF;AAGnF,OAAO,EAAc,SAAS,EAAE,MAAM,YAAY,CAAC;AAWnD,4FAA4F;AAC5F,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;AAE9C,gGAAgG;AAChG,MAAM,SAAS,GAAqC;IAClD,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,KAAK;IACR,CAAC,EAAE,KAAK;IACR,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;CACR,CAAC;AAEF,6FAA6F;AAC7F,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1D,CAAC;AAQD;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAwB,EACxB,IAAc,EACd,MAA6D;IAE7D,MAAM,MAAM,GAAG,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/E,MAAM,UAAU,GAAG,MAAM;SACtB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAChH,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACpG,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChG,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,0DAA0D;AAC1D,SAAS,MAAM,CAAC,MAAwB;IACtC,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,KAAK,CAAC,IAAI;YAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;;YAClF,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,OAAO,CAAC,MAAwB,EAAE,MAA6D;IACtG,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyD,CAAC;IAC/E,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/F,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC;QACrC,IAAI,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,2FAA2F;YAC3F,MAAM,KAAK,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YACvC,KAAK,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,KAAK,OAAO,EAAE,EAAE,CAAC;YACpG,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACxB,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACtG,CAAC;AAED,mDAAmD;AACnD,SAAS,QAAQ,CAAC,KAAY;IAC5B,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC;IACvD,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;IACzD,MAAM,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;IACzC,OAAO;QACL,CAAC,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC;QACvD,CAAC,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,SAAS,OAAO,CAAC,MAA+B,EAAE,CAA2B;IAC3E,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,YAAY,GAAG,QAAQ,CAAC;IAC5B,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;QAChC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACpC,IAAI,QAAQ,GAAG,YAAY,EAAE,CAAC;YAC5B,IAAI,GAAG,CAAC,CAAC;YACT,YAAY,GAAG,QAAQ,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uFAAuF;AACvF,SAAS,OAAO,CAAC,MAAwB;IACvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,MAAyB,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACjE,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,IAAI,GAAG,EAAE,CAAC;QACZ,CAAC;;YAAM,IAAI,IAAI,GAAG,CAAC;QACnB,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC;QACnB,MAAM,GAAG,KAAK,CAAC;IACjB,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,KAAwB;IAChD,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,IAAI,KAAK,EAAE;YAAE,SAAS;QAC1B,GAAG,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,+DAA+D;AAC/D,SAAS,OAAO,CAAC,GAAW,EAAE,IAAY;IACxC,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IACvF,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IACjG,OAAO,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,2BAA2B;AAC3B,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7G,CAAC"}

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

@@ -0,0 +1,101 @@
+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;
+}
+/** How the pointer asked for a preview. */
+export type LinkPreviewPointer = "fine" | "keyboard" | "touch";
+/** A link asking to be previewed (the viewer's `linkpreview` event). */
+export interface LinkPreviewRequest {
+    readonly link: PageLink;
+    /** What the preview shows: where the link goes, or a sentence saying what it does. */
+    readonly shows: {
+        readonly kind: "target";
+        readonly target: Target;
+    } | {
+        readonly kind: "page";
+        readonly page: number;
+        readonly note: string;
+    } | {
+        readonly kind: "note";
+        readonly note: string;
+    };
+    /** The link's anchor, which the preview describes (`aria-describedby`). */
+    readonly anchor: HTMLElement;
+    readonly pointer: LinkPreviewPointer;
+}
+/** 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;
+    /** Shows a preview of a link. */
+    preview?(request: LinkPreviewRequest): void;
+    /** Hides the preview of `anchor`'s link. */
+    previewEnd?(anchor: HTMLElement): 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;
+    /** The pointer is over the preview (`true`) or has left it (`false`): a hovered preview stays. */
+    hold(held: boolean): void;
+    /** Escape or Close: hides the preview, which stays hidden until its link is left. */
+    dismiss(): void;
+    /** Whether a link is previewed or focused, so `follow` has one to follow. */
+    canFollow(): boolean;
+    /** Follows the previewed link, else the focused one (`nav.follow-link`); `false` when there is neither. */
+    follow(): boolean;
+    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":"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"}