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

package/dist/internal/handle.js

@@ -0,0 +1,113 @@
+// The base of every handle that owns memory in a WebAssembly instance: `free()` and
+// `Symbol.dispose` (the same thing; a second call does nothing), `disposed` for any call after it,
+// `instance-reset` for a handle whose instance was replaced, and a parent that frees it too (a
+// page with its document or builder). A handle the garbage collector reclaims is still freed, by
+// wasm-bindgen's own finalizer; `onLeak` reports those.
+import { packageError } from "../errors.js";
+/**
+ * `Symbol.dispose`, or, where a runtime lacks it (Safari), `Symbol.for("Symbol.dispose")`: the key
+ * the `using` helpers of esbuild and Babel fall back to.
+ */
+const DISPOSE = typeof Symbol.dispose === "symbol" ? Symbol.dispose : Symbol.for("Symbol.dispose");
+let leakHook;
+const leaks = typeof FinalizationRegistry === "function"
+    ? new FinalizationRegistry((handle) => leakHook?.({ handle }))
+    : undefined;
+/**
+ * Reports every document, builder and image created from now on that the garbage collector
+ * reclaims without a `free()` or `using`: a debugging aid for code that should free what it
+ * makes. Reclaimed handles are freed anyway, only later. `onLeak()` turns the reports off.
+ *
+ * @param hook - called once per leaked handle, some time after the collection.
+ */
+export function onLeak(hook) {
+    leakHook = hook;
+}
+/** Watches `handle` for a leak while a hook is set; {@link forget} once it is freed. */
+export function watch(handle, name) {
+    if (leakHook !== undefined)
+        leaks?.register(handle, name, handle);
+}
+/** Stops watching `handle`. */
+export function forget(handle) {
+    leaks?.unregister(handle);
+}
+/** A handle on memory in one WebAssembly instance. */
+export class Handle {
+    /** The class, for messages (minifiers rename classes). */
+    #name;
+    #instance;
+    #generation;
+    #parent;
+    #freed = false;
+    /**
+     * @param name - the class, as messages name it.
+     * @param instance - the instance the handle's memory lives in.
+     * @param parent - the handle it is freed with, if any.
+     */
+    constructor(name, instance, parent) {
+        this.#name = name;
+        this.#instance = instance;
+        this.#generation = instance.generation;
+        this.#parent = parent;
+    }
+    /** The instance this handle lives in (for the handles it makes). */
+    get instance() {
+        return this.#instance;
+    }
+    /** Whether the handle's raw objects can be freed: its instance is current and hasn't trapped. */
+    get owned() {
+        return this.#instance.owns(this.#generation);
+    }
+    /** Whether `free()` ran on this handle or its parent. */
+    get isFreed() {
+        return this.#freed || this.#parent?.isFreed === true;
+    }
+    /**
+     * @throws {@link LaminaPdfError} `disposed` after `free()` (here or on the parent);
+     *   `instance-reset` when the instance was replaced (a trapped one is replaced first).
+     */
+    assertLive() {
+        if (this.isFreed) {
+            throw packageError("disposed", `the ${this.#name} was used after free() or its using block`);
+        }
+        this.#instance.check(this.#generation, this.#name);
+    }
+    /** Runs `f` (calls into the glue) on this live handle; see {@link Instance.call}. */
+    call(f) {
+        this.assertLive();
+        return this.#instance.call(f);
+    }
+    /**
+     * Frees the handle's memory now; without it, the garbage collector frees it later. A second
+     * call does nothing, and any other call afterwards throws `disposed`. Prefer `using`, which
+     * calls this at the end of the block.
+     */
+    free() {
+        if (this.#freed)
+            return;
+        this.#freed = true;
+        forget(this);
+        // A replaced instance's memory is gone already, and its objects must not reach the new one.
+        if (this.owned)
+            this.release();
+    }
+    /** Frees the handle at the end of a `using` block (an alias of `free()`). */
+    [Symbol.dispose]() {
+        this.free();
+    }
+}
+/** Gives `target`'s prototype the dispose method under {@link DISPOSE} where it isn't `Symbol.dispose`. */
+export function disposable(target) {
+    if (DISPOSE === Symbol.dispose)
+        return;
+    Object.defineProperty(target.prototype, DISPOSE, {
+        value() {
+            this.free();
+        },
+        configurable: true,
+        writable: true,
+    });
+}
+disposable(Handle);
+//# sourceMappingURL=handle.js.map

package/dist/internal/handle.js.map

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

package/dist/internal/instance.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Whether `e` is a trap: as {@link Instance.call} reports one (`wasm-trap`, `out-of-memory`), or
+ * raw from a module the package doesn't guard (an extension's PDFium).
+ */
+export declare function isTrap(e: unknown): boolean;
+/** The modules of `@laminapdf/wasm` that `@laminapdf/sdk` loads. */
+export type ModuleName = "base" | "text" | "extract";
+/** The exports every wasm-bindgen module has. */
+interface Exports {
+    readonly memory: WebAssembly.Memory;
+}
+/** What `@laminapdf/sdk` needs from a module's glue besides its classes. */
+export interface Glue {
+    /** Replaces the instance with a fresh one of the same compiled module. */
+    __wbg_reset_state(): void;
+    /** Whether an allocation failed in the current instance. */
+    allocationFailed(): boolean;
+    /** Once the module is loaded: the current instance's exports. */
+    initSync(module: never): Exports;
+}
+/** One loaded module: its glue, and which of its instances is current. */
+export declare class Instance<G extends Glue = Glue> {
+    #private;
+    readonly name: ModuleName;
+    readonly glue: G;
+    constructor(name: ModuleName, glue: G, exports: Exports);
+    /** Which instance is current; a handle keeps the one it was made in. */
+    get generation(): number;
+    /** The size of the current instance's memory, in bytes. */
+    get memoryBytes(): number;
+    /**
+     * Whether objects made in `generation` can still be freed: it is current, and hasn't trapped
+     * (a trapped instance is about to be replaced, and freeing into it could trap again).
+     */
+    owns(generation: number): boolean;
+    /**
+     * Throws `instance-reset` unless objects made in `generation` belong to the current instance,
+     * after replacing an instance that trapped (so a trap's survivors never reach the fresh one).
+     *
+     * @param name - what holds the objects, for the message.
+     */
+    check(generation: number, name: string): void;
+    /** The glue, after replacing an instance that trapped. */
+    live(): G;
+    /** Replaces the instance with a fresh one: memory back to its initial size, every handle gone. */
+    replace(): void;
+    /**
+     * Runs one call into the glue, after replacing an instance that trapped.
+     *
+     * @throws {@link LaminaPdfError} for the §1 object the module throws; `wasm-trap` or
+     *   `out-of-memory` when it traps or overflows the stack (the next call gets a fresh instance).
+     */
+    call<T>(f: (glue: G) => T): T;
+}
+export {};
+//# sourceMappingURL=instance.d.ts.map

package/dist/internal/instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/internal/instance.ts"],"names":[],"mappings":"AAsBA;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAE1C;AAED,oEAAoE;AACpE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAErD,iDAAiD;AACjD,UAAU,OAAO;IACf,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC;CACrC;AAED,4EAA4E;AAC5E,MAAM,WAAW,IAAI;IACnB,0EAA0E;IAC1E,iBAAiB,IAAI,IAAI,CAAC;IAC1B,4DAA4D;IAC5D,gBAAgB,IAAI,OAAO,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC;CAClC;AAED,0EAA0E;AAC1E,qBAAa,QAAQ,CAAC,CAAC,SAAS,IAAI,GAAG,IAAI;;IACzC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAMjB,YAAY,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAItD;IAED,wEAAwE;IACxE,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,2DAA2D;IAC3D,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;;OAGG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEhC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ5C;IAED,0DAA0D;IAC1D,IAAI,IAAI,CAAC,CAGR;IAED,kGAAkG;IAClG,OAAO,IAAI,IAAI,CAMd;IAED;;;;;OAKG;IACH,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAO5B;CA2BF"}

package/dist/internal/instance.js

@@ -0,0 +1,125 @@
+// The WebAssembly instances behind every handle. A trap (a bug, or growth past the memory maximum
+// set when the modules are built) can leave an instance's memory half-written, so the call that
+// trapped throws `wasm-trap` or `out-of-memory`, and the next call first replaces the instance with
+// a fresh one of the same compiled module (wasm-bindgen's `__wbg_reset_state`); `reset()` replaces
+// every one. Each replacement starts a new generation: a handle made in an older one throws
+// `instance-reset` rather than reach into the new instance's memory.
+import { isDiagnostic, isLaminaPdfError, LaminaPdfError, packageError } from "../errors.js";
+/**
+ * Whether `e` stopped WebAssembly code mid-call: a trap (`RuntimeError`), or the engine's stack
+ * overflowing inside it (V8 and JavaScriptCore throw a `RangeError`, Firefox an `InternalError`).
+ * Either leaves the instance's memory half-written.
+ */
+function stoppedMidCall(e) {
+    if (e instanceof WebAssembly.RuntimeError)
+        return true;
+    if (!(e instanceof Error))
+        return false;
+    return ((e instanceof RangeError && /call stack/i.test(e.message)) ||
+        (e.name === "InternalError" && /recursion/i.test(e.message)));
+}
+/**
+ * Whether `e` is a trap: as {@link Instance.call} reports one (`wasm-trap`, `out-of-memory`), or
+ * raw from a module the package doesn't guard (an extension's PDFium).
+ */
+export function isTrap(e) {
+    return stoppedMidCall(e) || isLaminaPdfError(e, "wasm-trap") || isLaminaPdfError(e, "out-of-memory");
+}
+/** One loaded module: its glue, and which of its instances is current. */
+export class Instance {
+    name;
+    glue;
+    #memory;
+    #generation = 0;
+    /** Set by a trap: the next call replaces the instance first. */
+    #poisoned = false;
+    constructor(name, glue, exports) {
+        this.name = name;
+        this.glue = glue;
+        this.#memory = exports.memory;
+    }
+    /** Which instance is current; a handle keeps the one it was made in. */
+    get generation() {
+        return this.#generation;
+    }
+    /** The size of the current instance's memory, in bytes. */
+    get memoryBytes() {
+        return this.#memory.buffer.byteLength;
+    }
+    /**
+     * Whether objects made in `generation` can still be freed: it is current, and hasn't trapped
+     * (a trapped instance is about to be replaced, and freeing into it could trap again).
+     */
+    owns(generation) {
+        return generation === this.#generation && !this.#poisoned;
+    }
+    /**
+     * Throws `instance-reset` unless objects made in `generation` belong to the current instance,
+     * after replacing an instance that trapped (so a trap's survivors never reach the fresh one).
+     *
+     * @param name - what holds the objects, for the message.
+     */
+    check(generation, name) {
+        this.live();
+        if (generation !== this.#generation) {
+            throw packageError("instance-reset", `the ${name} belongs to a WebAssembly instance that reset() or a trap replaced`);
+        }
+    }
+    /** The glue, after replacing an instance that trapped. */
+    live() {
+        if (this.#poisoned)
+            this.replace();
+        return this.glue;
+    }
+    /** Replaces the instance with a fresh one: memory back to its initial size, every handle gone. */
+    replace() {
+        this.glue.__wbg_reset_state();
+        // The glue's `initSync` returns early with the current exports once the module is loaded.
+        this.#memory = this.glue.initSync(undefined).memory;
+        this.#generation++;
+        this.#poisoned = false;
+    }
+    /**
+     * Runs one call into the glue, after replacing an instance that trapped.
+     *
+     * @throws {@link LaminaPdfError} for the §1 object the module throws; `wasm-trap` or
+     *   `out-of-memory` when it traps or overflows the stack (the next call gets a fresh instance).
+     */
+    call(f) {
+        const glue = this.live();
+        try {
+            return f(glue);
+        }
+        catch (e) {
+            throw this.#wrap(e);
+        }
+    }
+    #wrap(e) {
+        if (isDiagnostic(e))
+            return new LaminaPdfError(e);
+        if (!stoppedMidCall(e))
+            return e;
+        this.#poisoned = true;
+        const module = this.name;
+        if (this.#allocationFailed()) {
+            return packageError("out-of-memory", `the ${module} module ran out of memory; the next call starts afresh`, {
+                data: { module, memoryBytes: this.memoryBytes },
+                cause: e,
+            });
+        }
+        return packageError("wasm-trap", `the ${module} module trapped; the next call starts afresh`, {
+            data: { module },
+            cause: e,
+        });
+    }
+    /** Whether the trapped instance ran out of memory. Reading its flag is safe: a trap leaves memory as it was. */
+    #allocationFailed() {
+        try {
+            return this.glue.allocationFailed();
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=instance.js.map

package/dist/internal/instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.js","sourceRoot":"","sources":["../../src/internal/instance.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"}