@laminapdf/sdk 0.0.0-stage → 0.2.0-alpha.2

package/dist/init.js

@@ -0,0 +1,127 @@
+// Loading the WebAssembly modules (ADR 0016 §2, §3): `init()` compiles and instantiates the base
+// module once; the text module is loaded by `init({ text: true })` or `loadText()`, the extract
+// module (base + text extraction, B9c) by `init({ extract: true })` or `loadExtract()`. After
+// that, every call is synchronous. Each export condition supplies its own `Locate` (src/loader/), so
+// this file has no environment detection and no runtime-specific API.
+import * as baseGlue from "@laminapdf/wasm/base";
+import { packageError } from "./errors.js";
+const base = {};
+const text = {};
+const extract = {};
+function isOptions(input) {
+    if (typeof input !== "object" || input === null || "then" in input)
+        return false;
+    const proto = Object.getPrototypeOf(input);
+    return proto === Object.prototype || proto === null;
+}
+/**
+ * Loads `slot`'s module once with `glue` (a failed load can be retried). A later call naming a
+ * different source than the first throws `already-initialized` instead of being ignored.
+ */
+function load(slot, name, glue, locate, source) {
+    if (slot.pending !== undefined) {
+        if (source !== undefined && source !== slot.requested) {
+            return Promise.reject(packageError("already-initialized", `the ${name} module is already loaded or loading from another source; the new source is ignored`));
+        }
+        return slot.pending;
+    }
+    slot.requested = source;
+    slot.pending = (async () => {
+        const g = await glue();
+        const from = source ?? (await locate(name));
+        const exports = (await g.default(from === undefined ? undefined : { module_or_path: from }));
+        slot.loaded = { glue: g, exports };
+    })().catch((e) => {
+        slot.pending = undefined;
+        slot.requested = undefined;
+        throw e;
+    });
+    return slot.pending;
+}
+/** Loads the text module (once; a failed load can be retried). */
+export function loadTextWith(locate, source) {
+    return load(text, "text", () => import("@laminapdf/wasm/text"), locate, source);
+}
+/**
+ * Loads the extract module (once; a failed load can be retried). Not when the text module is
+ * loaded or loading: it extracts too, and documents open in it first, so the extract module
+ * would never be used.
+ */
+export function loadExtractWith(locate, source) {
+    const loadIt = () => load(extract, "extract", () => import("@laminapdf/wasm/extract"), locate, source);
+    // A source given is honoured as for any module; without one, a text module loaded or loading
+    // makes the extract module unnecessary, unless that load fails.
+    if (source !== undefined || text.pending === undefined)
+        return loadIt();
+    return text.pending.catch(loadIt);
+}
+/** `init` for an export condition's `locate`. */
+export async function initWith(locate, input) {
+    const options = input === undefined ? {} : isOptions(input) ? input : { module: input };
+    const loads = [load(base, "base", async () => baseGlue, locate, options.module)];
+    if (options.text !== undefined && options.text !== false) {
+        loads.push(loadTextWith(locate, options.text === true ? undefined : options.text));
+    }
+    // The text module extracts too: with it, the extract module would never be used.
+    if (options.extract !== undefined &&
+        options.extract !== false &&
+        (options.text === undefined || options.text === false)) {
+        loads.push(loadExtractWith(locate, options.extract === true ? undefined : options.extract));
+    }
+    await Promise.all(loads);
+}
+/** The base module's glue. @throws {@link LaminaPdfError} `not-initialized` before `init()`. */
+export function baseModule() {
+    if (base.loaded === undefined) {
+        throw packageError("not-initialized", "init() has not finished loading the WebAssembly module");
+    }
+    return base.loaded.glue;
+}
+/**
+ * The module documents are opened in: the text module when loaded, else the extract module, else
+ * the base one (each a superset of the base module's reading API; the first two extract text).
+ * @throws {@link LaminaPdfError} `not-initialized` before `init()`.
+ */
+export function readingModule() {
+    const base = baseModule();
+    return (text.loaded?.glue ?? extract.loaded?.glue ?? base);
+}
+/**
+ * Whether documents opened or built from now on can extract text: the extract or the text module
+ * is loaded. A document opened earlier stays in the module it was opened in; ask it with
+ * {@link Document.canExtractText}.
+ */
+export function isExtractLoaded() {
+    return extract.loaded !== undefined || text.loaded !== undefined;
+}
+/** Whether `doc` lives in a module that extracts text (the extract or the text module). */
+export function extractsText(doc) {
+    return ((text.loaded !== undefined && doc instanceof text.loaded.glue.WasmDocument) ||
+        (extract.loaded !== undefined && doc instanceof extract.loaded.glue.WasmDocument));
+}
+/** The text module's glue, when loaded. */
+export function textModule() {
+    return text.loaded?.glue;
+}
+/** Whether `init()` has finished. */
+export function isInitialized() {
+    return base.loaded !== undefined;
+}
+/** Whether the text module is loaded (builders created now can draw text). */
+export function isTextLoaded() {
+    return text.loaded !== undefined;
+}
+/**
+ * The size of each loaded module's WebAssembly memory. Memory grows and never shrinks; freed
+ * documents and builders leave room that later ones reuse.
+ *
+ * @returns the byte length of each loaded module's memory.
+ */
+export function wasmMemory() {
+    return {
+        ...(base.loaded === undefined ? {} : { base: base.loaded.exports.memory.buffer.byteLength }),
+        ...(text.loaded === undefined ? {} : { text: text.loaded.exports.memory.buffer.byteLength }),
+        ...(extract.loaded === undefined ? {} : { extract: extract.loaded.exports.memory.buffer.byteLength }),
+    };
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

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

package/dist/loader/fetch.d.ts

@@ -0,0 +1,3 @@
+import type { Locate } from "../init.js";
+export declare const locate: Locate;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/loader/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/loader/fetch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,eAAO,MAAM,MAAM,EAAE,MAAwB,CAAC"}

package/dist/loader/fetch.js

@@ -0,0 +1,2 @@
+export const locate = () => undefined;
+//# sourceMappingURL=fetch.js.map

package/dist/loader/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/loader/fetch.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,MAAM,GAAW,GAAG,EAAE,CAAC,SAAS,CAAC"}

package/dist/loader/node.d.ts

@@ -0,0 +1,3 @@
+import type { Locate } from "../init.js";
+export declare const locate: Locate;
+//# sourceMappingURL=node.d.ts.map

package/dist/loader/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/loader/node.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,eAAO,MAAM,MAAM,EAAE,MASlB,CAAC"}

package/dist/loader/node.js

@@ -0,0 +1,9 @@
+// The `node` condition (Node, Bun): the `.wasm` file of @laminapdf/wasm, read as bytes (Node's
+// fetch can't read file: URLs). The one file in src/ allowed a Node API (biome.json override).
+import { readFile } from "node:fs/promises";
+export const locate = (module) => readFile(new URL(module === "base"
+    ? import.meta.resolve("@laminapdf/wasm/lamina_pdf_base.wasm")
+    : module === "text"
+        ? import.meta.resolve("@laminapdf/wasm/lamina_pdf_text.wasm")
+        : import.meta.resolve("@laminapdf/wasm/lamina_pdf_extract.wasm")));
+//# sourceMappingURL=node.js.map

package/dist/loader/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/loader/node.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,+FAA+F;AAC/F,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,MAAM,CAAC,MAAM,MAAM,GAAW,CAAC,MAAM,EAAE,EAAE,CACvC,QAAQ,CACN,IAAI,GAAG,CACL,MAAM,KAAK,MAAM;IACf,CAAC,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,sCAAsC,CAAC;IAC7D,CAAC,CAAC,MAAM,KAAK,MAAM;QACjB,CAAC,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,sCAAsC,CAAC;QAC7D,CAAC,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,yCAAyC,CAAC,CACrE,CACF,CAAC"}

package/dist/loader/workerd.d.ts

@@ -0,0 +1,3 @@
+import type { Locate } from "../init.js";
+export declare const locate: Locate;
+//# sourceMappingURL=workerd.d.ts.map

package/dist/loader/workerd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerd.d.ts","sourceRoot":"","sources":["../../src/loader/workerd.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAIzC,eAAO,MAAM,MAAM,EAAE,MAQpB,CAAC"}

package/dist/loader/workerd.js

@@ -0,0 +1,15 @@
+// The `workerd` condition (Cloudflare Workers): Workers can't compile WebAssembly at run time,
+// so the modules are imported statically; wrangler turns a `.wasm` import into a
+// `WebAssembly.Module` (ADR 0016 §2). Both modules are part of the Worker's bundle.
+import base from "@laminapdf/wasm/lamina_pdf_base.wasm";
+import text from "@laminapdf/wasm/lamina_pdf_text.wasm";
+import { packageError } from "../errors.js";
+// The extract module isn't imported here: a static import would put it in every Worker's bundle
+// (about 526 KB gzip) whether or not it extracts text. A Worker that does passes it itself.
+export const locate = (module) => {
+    if (module === "extract") {
+        throw packageError("extract-module-not-loaded", 'in workerd, pass the extract module: import extract from "@laminapdf/wasm/lamina_pdf_extract.wasm"; await loadExtract(extract)');
+    }
+    return module === "base" ? base : text;
+};
+//# sourceMappingURL=workerd.js.map

package/dist/loader/workerd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerd.js","sourceRoot":"","sources":["../../src/loader/workerd.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,iFAAiF;AACjF,oFAAoF;AACpF,OAAO,IAAI,MAAM,sCAAsC,CAAC;AACxD,OAAO,IAAI,MAAM,sCAAsC,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,gGAAgG;AAChG,4FAA4F;AAC5F,MAAM,CAAC,MAAM,MAAM,GAAW,CAAC,MAAM,EAAE,EAAE;IACvC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,YAAY,CAChB,2BAA2B,EAC3B,gIAAgI,CACjI,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC,CAAC"}

package/dist/matrix.d.ts

@@ -0,0 +1,16 @@
+/** A transformation matrix `[a, b, c, d, e, f]` (ISO 32000-2 §8.3.4), in page space. */
+export type Transform = readonly [a: number, b: number, c: number, d: number, e: number, f: number];
+/** Building transformation matrices. */
+export declare const Matrix: {
+    /** The identity. */
+    readonly identity: Transform;
+    /** A translation by (x, y) points. */
+    readonly translate: (x: number, y: number) => Transform;
+    /** A scaling by `sx` horizontally and `sy` vertically. */
+    readonly scale: (sx: number, sy: number) => Transform;
+    /** A rotation by `degrees` about the origin, clockwise as displayed. */
+    readonly rotate: (degrees: number) => Transform;
+    /** `outer` applied after `inner`: maps p to outer(inner(p)). */
+    readonly after: (outer: Transform, inner: Transform) => Transform;
+};
+//# sourceMappingURL=matrix.d.ts.map

package/dist/matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix.d.ts","sourceRoot":"","sources":["../src/matrix.ts"],"names":[],"mappings":"AAGA,wFAAwF;AACxF,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;AAEpG,wCAAwC;AACxC,eAAO,MAAM,MAAM;IACjB,oBAAoB;aACpB,QAAQ,EAAwB,SAAS;IACzC,sCAAsC;aACtC,SAAS,MAAI,MAAM,KAAK,MAAM,KAAG,SAAS;IAG1C,0DAA0D;aAC1D,KAAK,OAAK,MAAM,MAAM,MAAM,KAAG,SAAS;IAGxC,wEAAwE;aACxE,MAAM,YAAU,MAAM,KAAG,SAAS;IAMlC,gEAAgE;aAChE,KAAK,UAAQ,SAAS,SAAS,SAAS,KAAG,SAAS;CAY5C,CAAC"}

package/dist/matrix.js

@@ -0,0 +1,36 @@
+// Transformation matrices `[a b c d e f]` in page space, computed as the Rust `Matrix` does so
+// that the same drawing gives the same bytes.
+/** Building transformation matrices. */
+export const Matrix = {
+    /** The identity. */
+    identity: [1, 0, 0, 1, 0, 0],
+    /** A translation by (x, y) points. */
+    translate(x, y) {
+        return [1, 0, 0, 1, x, y];
+    },
+    /** A scaling by `sx` horizontally and `sy` vertically. */
+    scale(sx, sy) {
+        return [sx, 0, 0, sy, 0, 0];
+    },
+    /** A rotation by `degrees` about the origin, clockwise as displayed. */
+    rotate(degrees) {
+        const radians = degrees * (Math.PI / 180);
+        const s = Math.sin(radians);
+        const c = Math.cos(radians);
+        return [c, s, -s, c, 0, 0];
+    },
+    /** `outer` applied after `inner`: maps p to outer(inner(p)). */
+    after(outer, inner) {
+        const [a, b, c, d, e, f] = outer;
+        const [ia, ib, ic, id, ie, iff] = inner;
+        return [
+            a * ia + c * ib,
+            b * ia + d * ib,
+            a * ic + c * id,
+            b * ic + d * id,
+            a * ie + c * iff + e,
+            b * ie + d * iff + f,
+        ];
+    },
+};
+//# sourceMappingURL=matrix.js.map

package/dist/matrix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix.js","sourceRoot":"","sources":["../src/matrix.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,8CAA8C;AAK9C,wCAAwC;AACxC,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,oBAAoB;IACpB,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAc;IACzC,sCAAsC;IACtC,SAAS,CAAC,CAAS,EAAE,CAAS;QAC5B,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,CAAC;IACD,0DAA0D;IAC1D,KAAK,CAAC,EAAU,EAAE,EAAU;QAC1B,OAAO,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,wEAAwE;IACxE,MAAM,CAAC,OAAe;QACpB,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,gEAAgE;IAChE,KAAK,CAAC,KAAgB,EAAE,KAAgB;QACtC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC;QACjC,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;QACxC,OAAO;YACL,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE;YACf,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE;YACf,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE;YACf,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE;YACf,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC;YACpB,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC;SACrB,CAAC;IACJ,CAAC;CACO,CAAC"}

package/dist/path.d.ts

@@ -0,0 +1,34 @@
+import type { Point, Rect } from "./types.js";
+/** Builds a path in page space; every method returns the builder, so calls chain. */
+export interface PathBuilder {
+    /** Starts a subpath at (x, y). */
+    moveTo(x: number, y: number): PathBuilder;
+    /** A straight line to (x, y). */
+    lineTo(x: number, y: number): PathBuilder;
+    /** A cubic Bézier curve through two control points to (x, y). */
+    cubicTo(x1: number, y1: number, x2: number, y2: number, x: number, y: number): PathBuilder;
+    /** A quadratic Bézier curve through one control point to (x, y). */
+    quadTo(x1: number, y1: number, x: number, y: number): PathBuilder;
+    /** Closes the subpath. */
+    close(): PathBuilder;
+    /** A rectangle: left, top, width, height. */
+    rect(rect: Rect): PathBuilder;
+    /** The ellipse inscribed in a rectangle. */
+    ellipse(rect: Rect): PathBuilder;
+    /** A circle around `center`. */
+    circle(center: Point, radius: number): PathBuilder;
+}
+/** @internal Collects a path's verbs and numbers. */
+export declare class PathEncoder implements PathBuilder {
+    #private;
+    moveTo(x: number, y: number): this;
+    lineTo(x: number, y: number): this;
+    cubicTo(x1: number, y1: number, x2: number, y2: number, x: number, y: number): this;
+    quadTo(x1: number, y1: number, x: number, y: number): this;
+    close(): this;
+    rect(rect: Rect): this;
+    ellipse(rect: Rect): this;
+    circle(center: Point, radius: number): this;
+    finish(): Float64Array;
+}
+//# sourceMappingURL=path.d.ts.map

package/dist/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAE9C,qFAAqF;AACrF,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC1C,iCAAiC;IACjC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC1C,iEAAiE;IACjE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3F,oEAAoE;IACpE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAClE,0BAA0B;IAC1B,KAAK,IAAI,WAAW,CAAC;IACrB,6CAA6C;IAC7C,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,CAAC;IAC9B,4CAA4C;IAC5C,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,CAAC;IACjC,gCAAgC;IAChC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;CACpD;AAYD,qDAAqD;AACrD,qBAAa,WAAY,YAAW,WAAW;;IAG7C,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAGjC;IAED,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAGjC;IAED,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAGlF;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAGzD;IAED,KAAK,IAAI,IAAI,CAGZ;IAED,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAGrB;IAED,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAGxB;IAED,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAG1C;IAED,MAAM,IAAI,YAAY,CAErB;CACF"}

package/dist/path.js

@@ -0,0 +1,49 @@
+/** The verbs of the flat encoding. */
+const MOVE = 0;
+const LINE = 1;
+const CUBIC = 2;
+const QUAD = 3;
+const CLOSE = 4;
+const RECT = 5;
+const ELLIPSE = 6;
+const CIRCLE = 7;
+/** @internal Collects a path's verbs and numbers. */
+export class PathEncoder {
+    #data = [];
+    moveTo(x, y) {
+        this.#data.push(MOVE, x, y);
+        return this;
+    }
+    lineTo(x, y) {
+        this.#data.push(LINE, x, y);
+        return this;
+    }
+    cubicTo(x1, y1, x2, y2, x, y) {
+        this.#data.push(CUBIC, x1, y1, x2, y2, x, y);
+        return this;
+    }
+    quadTo(x1, y1, x, y) {
+        this.#data.push(QUAD, x1, y1, x, y);
+        return this;
+    }
+    close() {
+        this.#data.push(CLOSE);
+        return this;
+    }
+    rect(rect) {
+        this.#data.push(RECT, ...rect);
+        return this;
+    }
+    ellipse(rect) {
+        this.#data.push(ELLIPSE, ...rect);
+        return this;
+    }
+    circle(center, radius) {
+        this.#data.push(CIRCLE, center[0], center[1], radius);
+        return this;
+    }
+    finish() {
+        return new Float64Array(this.#data);
+    }
+}
+//# sourceMappingURL=path.js.map

package/dist/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":"AAuBA,sCAAsC;AACtC,MAAM,IAAI,GAAG,CAAC,CAAC;AACf,MAAM,IAAI,GAAG,CAAC,CAAC;AACf,MAAM,KAAK,GAAG,CAAC,CAAC;AAChB,MAAM,IAAI,GAAG,CAAC,CAAC;AACf,MAAM,KAAK,GAAG,CAAC,CAAC;AAChB,MAAM,IAAI,GAAG,CAAC,CAAC;AACf,MAAM,OAAO,GAAG,CAAC,CAAC;AAClB,MAAM,MAAM,GAAG,CAAC,CAAC;AAEjB,qDAAqD;AACrD,MAAM,OAAO,WAAW;IACb,KAAK,GAAa,EAAE,CAAC;IAE9B,MAAM,CAAC,CAAS,EAAE,CAAS;QACzB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,CAAS,EAAE,CAAS;QACzB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,CAAS,EAAE,CAAS;QAC1E,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,EAAU,EAAE,EAAU,EAAE,CAAS,EAAE,CAAS;QACjD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,IAAU;QACb,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,IAAU;QAChB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,MAAa,EAAE,MAAc;QAClC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/source/http.d.ts

@@ -0,0 +1,36 @@
+import { type RangeSource } from "./range.js";
+/** Options for {@link httpRangeSource}. */
+export interface HttpRangeOptions {
+    /** Extra request headers (authorisation, …). `Range` and `If-Range` are Lamina PDF's. */
+    readonly headers?: Readonly<Record<string, string>>;
+    /** `fetch`'s credentials mode. */
+    readonly credentials?: RequestCredentials;
+    /** Aborts the probe; reads take their own signal. */
+    readonly signal?: AbortSignal;
+    /** Fetches are aligned to blocks of this many bytes (default 16 384: each object a reader
+     * checks costs one block, so larger blocks fetch more of the file). */
+    readonly blockSize?: number;
+    /** The first request asks for this many bytes at the end of the file (default 65 536). */
+    readonly tail?: number;
+    /** The `fetch` to use (default: the global one). */
+    readonly fetch?: typeof fetch;
+}
+/**
+ * A {@link RangeSource} over a URL, for `Document.openRange`. The first request asks for the
+ * last `tail` bytes, which gives the size and the part of the file a reader needs first (the
+ * xref is at the end). Every later request sends `If-Range` with the first strong `ETag` (else
+ * its `Last-Modified`); a response whose `ETag`, `Last-Modified` or total size differs fails
+ * with `source-changed`. A server that ignores
+ * `Range` (it answers `200`) is read with that one full download.
+ *
+ * The server must allow `Range` (across origins: `Access-Control-Allow-Headers: Range` and
+ * `Access-Control-Expose-Headers: Content-Range, Content-Length, ETag`) and must not compress
+ * the response.
+ *
+ * @param url - the file.
+ * @param options - headers, credentials, signal, block size.
+ * @returns the source, once the first request has answered.
+ * @throws {@link LaminaPdfError} `fetch-failed` (with `data.status`), `source-changed`.
+ */
+export declare function httpRangeSource(url: string | URL, options?: HttpRangeOptions): Promise<RangeSource>;
+//# sourceMappingURL=http.d.ts.map

package/dist/source/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/source/http.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,WAAW,EAAS,MAAM,YAAY,CAAC;AAErD,2CAA2C;AAC3C,MAAM,WAAW,gBAAgB;IAC/B,yFAAyF;IACzF,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,kCAAkC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAC1C,qDAAqD;IACrD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B;2EACuE;IACvE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,0FAA0F;IAC1F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CAC/B;AAqBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,CA0B7G"}

package/dist/source/http.js

@@ -0,0 +1,211 @@
+// httpRangeSource (L2c): a remote PDF read with HTTP Range requests. Errors never carry the URL
+// (ADR 0026 §4): it may hold tokens.
+import { packageError } from "../errors.js";
+import { WHOLE } from "./range.js";
+/** `bytes start-end/size` → its numbers. */
+function contentRange(header) {
+    const m = /^bytes (\d+)-(\d+)\/(\d+)$/.exec(header?.trim() ?? "");
+    if (m === null)
+        return undefined;
+    return { start: Number(m[1]), end: Number(m[2]), size: Number(m[3]) };
+}
+function failed(reason, status, cause) {
+    const e = packageError("fetch-failed", "fetching a range of the remote file failed", {
+        data: status === undefined ? { reason } : { reason, status },
+    });
+    if (cause !== undefined)
+        Object.defineProperty(e, "cause", { value: cause });
+    return e;
+}
+function changed() {
+    return packageError("source-changed", "the remote file changed while it was being read");
+}
+/**
+ * A {@link RangeSource} over a URL, for `Document.openRange`. The first request asks for the
+ * last `tail` bytes, which gives the size and the part of the file a reader needs first (the
+ * xref is at the end). Every later request sends `If-Range` with the first strong `ETag` (else
+ * its `Last-Modified`); a response whose `ETag`, `Last-Modified` or total size differs fails
+ * with `source-changed`. A server that ignores
+ * `Range` (it answers `200`) is read with that one full download.
+ *
+ * The server must allow `Range` (across origins: `Access-Control-Allow-Headers: Range` and
+ * `Access-Control-Expose-Headers: Content-Range, Content-Length, ETag`) and must not compress
+ * the response.
+ *
+ * @param url - the file.
+ * @param options - headers, credentials, signal, block size.
+ * @returns the source, once the first request has answered.
+ * @throws {@link LaminaPdfError} `fetch-failed` (with `data.status`), `source-changed`.
+ */
+export async function httpRangeSource(url, options = {}) {
+    // A whole number of bytes, at least 1 (a fraction would make a malformed Range header).
+    const tail = Number.isFinite(options.tail) ? Math.max(1, Math.floor(options.tail ?? 0)) : 65_536;
+    const request = rangeRequester(url, options);
+    const first = await request(`bytes=-${tail}`, options.signal);
+    if (first.status === 200) {
+        // No range support: this response is the whole file.
+        const whole = new Uint8Array(await first.arrayBuffer());
+        // Tagged, so Document.openRange opens these bytes directly instead of copying them again.
+        return {
+            size: whole.length,
+            read: async (offset, length) => whole.slice(offset, offset + length),
+            [WHOLE]: whole,
+        };
+    }
+    if (first.status === 416 && /^bytes \*\/0$/.test(first.headers.get("Content-Range")?.trim() ?? "")) {
+        // An empty file has no last bytes to send: open it as empty (Lamina PDF then says what it is).
+        await first.body?.cancel();
+        return { size: 0, read: async () => new Uint8Array() };
+    }
+    const file = new RangedFile(request, await readProbe(first));
+    return {
+        size: file.size,
+        read: (offset, length, opts) => file.read(offset, length, opts?.signal),
+        blockSize: options.blockSize ?? 16_384,
+    };
+}
+/** Cancels `res`'s body (nothing will read it) and rejects with `error`. */
+async function discard(res, error) {
+    await res.body?.cancel();
+    throw error;
+}
+function rangeRequester(url, options) {
+    const doFetch = options.fetch ?? fetch;
+    return async (range, signal, ifRange) => {
+        const headers = new Headers(options.headers);
+        headers.set("Range", range);
+        if (ifRange !== undefined)
+            headers.set("If-Range", ifRange);
+        try {
+            return await doFetch(url, {
+                headers,
+                ...(options.credentials === undefined ? {} : { credentials: options.credentials }),
+                ...(signal === undefined ? {} : { signal }),
+            });
+        }
+        catch (e) {
+            if (signal?.aborted)
+                throw signal.reason;
+            throw failed("network", undefined, e);
+        }
+    };
+}
+/** Checks the first answer is a `206` with the file's last bytes, and reads them. */
+async function readProbe(first) {
+    if (first.status !== 206) {
+        return discard(first, failed("status", first.status));
+    }
+    const range = contentRange(first.headers.get("Content-Range"));
+    if (range === undefined || range.end !== range.size - 1) {
+        return discard(first, failed("content-range", 206));
+    }
+    const tailBytes = new Uint8Array(await first.arrayBuffer());
+    if (tailBytes.length !== range.size - range.start)
+        throw failed("content-range", 206);
+    return {
+        size: range.size,
+        tailStart: range.start,
+        tailBytes,
+        etag: first.headers.get("ETag") ?? undefined,
+        lastModified: first.headers.get("Last-Modified") ?? undefined,
+    };
+}
+/** The reads after the probe: from its tail, by ranged requests, or from one whole download. */
+class RangedFile {
+    #request;
+    #probe;
+    // If-Range needs a strong ETag, else a Last-Modified date; a weak ETag is only compared.
+    #ifRange;
+    // Set once a ranged request is answered 200: the whole file, downloaded once and shared by
+    // every read (reads already in flight cancel their own bodies and wait for it).
+    #whole;
+    constructor(request, probe) {
+        this.#request = request;
+        this.#probe = probe;
+        const { etag, lastModified } = probe;
+        this.#ifRange = etag !== undefined && !etag.startsWith("W/") ? etag : lastModified;
+    }
+    get size() {
+        return this.#probe.size;
+    }
+    async read(offset, length, signal) {
+        const { tailStart, tailBytes } = this.#probe;
+        const end = offset + length;
+        if (offset >= tailStart)
+            return tailBytes.slice(offset - tailStart, end - tailStart);
+        if (end <= tailStart)
+            return this.#fetchRange(offset, end, signal);
+        // Straddles the tail the probe brought: fetch only the part before it.
+        const out = new Uint8Array(length);
+        out.set(await this.#fetchRange(offset, tailStart, signal));
+        out.set(tailBytes.subarray(0, end - tailStart), tailStart - offset);
+        return out;
+    }
+    /** Whether `res` shows a different version than the first response (ETag, then Last-Modified). */
+    #differs(res) {
+        const { etag, lastModified } = this.#probe;
+        const tag = res.headers.get("ETag") ?? undefined;
+        if (etag !== undefined && tag !== undefined)
+            return tag !== etag;
+        const modified = res.headers.get("Last-Modified") ?? undefined;
+        return lastModified !== undefined && modified !== undefined && modified !== lastModified;
+    }
+    /** The bytes `offset..end` from the network (or from the whole file, once there is one). */
+    async #fetchRange(offset, end, signal) {
+        if (this.#whole !== undefined)
+            return (await this.#whole).slice(offset, end);
+        const res = await this.#request(`bytes=${offset}-${end - 1}`, signal, this.#ifRange);
+        if (this.#differs(res)) {
+            return discard(res, changed());
+        }
+        if (res.status === 200)
+            return this.#fromWhole(res, offset, end);
+        return this.#fromPartial(res, offset, end);
+    }
+    /** The server ignored Range (or If-Range found the file changed and sent it whole). */
+    async #fromWhole(res, offset, end) {
+        if (this.#probe.etag !== undefined && res.headers.get("ETag") === null) {
+            return discard(res, changed());
+        }
+        let whole = this.#whole;
+        if (whole === undefined)
+            whole = this.#download(res);
+        else
+            await res.body?.cancel();
+        return (await whole).slice(offset, end);
+    }
+    #download(res) {
+        const download = res.arrayBuffer().then((buffer) => {
+            const bytes = new Uint8Array(buffer);
+            if (bytes.length !== this.#probe.size)
+                throw changed();
+            return bytes;
+        });
+        this.#whole = download;
+        // A failed or aborted download (its read's signal) must not stick: the next read that
+        // gets a 200 starts a new one.
+        download.catch(() => {
+            if (this.#whole === download)
+                this.#whole = undefined;
+        });
+        return download;
+    }
+    /** A `206` with exactly the bytes asked for, from the same file. */
+    async #fromPartial(res, offset, end) {
+        if (res.status !== 206) {
+            return discard(res, failed("status", res.status));
+        }
+        const got = contentRange(res.headers.get("Content-Range"));
+        if (got !== undefined && got.size !== this.#probe.size) {
+            return discard(res, changed());
+        }
+        if (got === undefined || got.start !== offset || got.end !== end - 1) {
+            return discard(res, failed("content-range", 206));
+        }
+        const bytes = new Uint8Array(await res.arrayBuffer());
+        if (bytes.length !== end - offset)
+            throw failed("content-range", 206);
+        return bytes;
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/source/http.js.map

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