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

package/dist/source/range.d.ts

@@ -0,0 +1,70 @@
+import type { WasmSparseSource } from "@laminapdf/wasm/base";
+/** A byte range of the input. */
+export interface ByteRange {
+    /** First byte. */
+    readonly offset: number;
+    /** Number of bytes. */
+    readonly length: number;
+}
+/**
+ * Random access to a file whose bytes are fetched on demand (a remote file, a `Blob`, a file
+ * handle). Matches the viewer's source interface (C3a).
+ */
+export interface RangeSource {
+    /** The file's size in bytes. */
+    readonly size: number;
+    /**
+     * The `length` bytes at `offset` (exactly that many: the file is at least `offset + length`
+     * long). Rejects when `signal` aborts.
+     */
+    read(offset: number, length: number, options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<Uint8Array>;
+    /** The block size this source prefers fetches aligned to (HTTP: fewer, larger requests). */
+    readonly blockSize?: number;
+}
+/** How a range document fetches. */
+export interface RangeOptions {
+    /** Aborts the open's fetches: it rejects with the signal's reason. Later calls take their own
+     * signal ({@link Document.ensure}). */
+    readonly signal?: AbortSignal;
+    /** Fetches are widened to whole blocks of this many bytes (default: the source's, else 4096). */
+    readonly blockSize?: number;
+    /** Extra bytes fetched after each range (default 0). */
+    readonly readahead?: number;
+    /** Rounds of fetches per call before giving up with the last `data-pending` (default 1024). */
+    readonly maxRounds?: number;
+    /** The most bytes the document may hold (default: no limit); more is `source-budget-exceeded`. */
+    readonly budget?: number;
+}
+/**
+ * A {@link RangeSource} over a caller's read function (a `Blob.slice`, a file handle, an IPC call).
+ *
+ * @param size - the file's size in bytes.
+ * @param read - returns the `length` bytes at `offset`.
+ */
+export declare function callbackSource(size: number, read: (offset: number, length: number, signal?: AbortSignal) => Promise<Uint8Array>): RangeSource;
+/** @internal Marks a source whose bytes are all in memory already (`httpRangeSource` after a `200`). */
+export declare const WHOLE: unique symbol;
+/** @internal The whole file, when `source` already has it in memory. */
+export declare function wholeBytes(source: RangeSource): Uint8Array | undefined;
+/** @internal What a range document keeps to fetch more: never the password or a signal. */
+export interface RangeState {
+    readonly sparse: WasmSparseSource;
+    readonly source: RangeSource;
+    readonly blockSize: number;
+    readonly readahead: number;
+    readonly maxRounds: number;
+}
+/**
+ * Runs `call` until it stops throwing (or rejecting with) `data-pending`: fetches the ranges
+ * asked for (widened to blocks, minus what the source holds), supplies them and calls again.
+ * Gives up with the last `data-pending` after `maxRounds`, or when a round asks again for
+ * exactly what the round before asked (no progress). The fetches of a round share one abort
+ * controller: `signal` aborts them all, and the first failure aborts the others; the round waits
+ * for every fetch before it throws, so nothing is supplied after it returns.
+ *
+ * @internal
+ */
+export declare function settle<T>(state: RangeState, call: () => T | Promise<T>, signal?: AbortSignal): Promise<T>;
+//# sourceMappingURL=range.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../src/source/range.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,iCAAiC;AACjC,MAAM,WAAW,SAAS;IACxB,kBAAkB;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uBAAuB;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACvG,4FAA4F;IAC5F,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,oCAAoC;AACpC,MAAM,WAAW,YAAY;IAC3B;2CACuC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,iGAAiG;IACjG,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,+FAA+F;IAC/F,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,kGAAkG;IAClG,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,GAClF,WAAW,CAEb;AAOD,wGAAwG;AACxG,eAAO,MAAM,KAAK,EAAE,OAAO,MAAoC,CAAC;AAEhE,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,CAGtE;AAED,2FAA2F;AAC3F,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAqB/G"}

package/dist/source/range.js

@@ -0,0 +1,96 @@
+import { guard, isLaminaPdfError, packageError } from "../errors.js";
+/**
+ * A {@link RangeSource} over a caller's read function (a `Blob.slice`, a file handle, an IPC call).
+ *
+ * @param size - the file's size in bytes.
+ * @param read - returns the `length` bytes at `offset`.
+ */
+export function callbackSource(size, read) {
+    return { size, read: (offset, length, options) => read(offset, length, options?.signal) };
+}
+/** The ranges of a `data-pending` error. */
+function rangesOf(e) {
+    return e.ranges ?? [];
+}
+/** @internal Marks a source whose bytes are all in memory already (`httpRangeSource` after a `200`). */
+export const WHOLE = Symbol("lamina.wholeBytes");
+/** @internal The whole file, when `source` already has it in memory. */
+export function wholeBytes(source) {
+    const bytes = source[WHOLE];
+    return bytes instanceof Uint8Array ? bytes : undefined;
+}
+/**
+ * Runs `call` until it stops throwing (or rejecting with) `data-pending`: fetches the ranges
+ * asked for (widened to blocks, minus what the source holds), supplies them and calls again.
+ * Gives up with the last `data-pending` after `maxRounds`, or when a round asks again for
+ * exactly what the round before asked (no progress). The fetches of a round share one abort
+ * controller: `signal` aborts them all, and the first failure aborts the others; the round waits
+ * for every fetch before it throws, so nothing is supplied after it returns.
+ *
+ * @internal
+ */
+export async function settle(state, call, signal) {
+    const { sparse, blockSize, readahead, maxRounds } = state;
+    let previous;
+    for (let round = 0;; round++) {
+        let error;
+        try {
+            return await call();
+        }
+        catch (e) {
+            if (!isLaminaPdfError(e, "data-pending"))
+                throw e;
+            error = e;
+        }
+        const asked = rangesOf(error);
+        const key = JSON.stringify(asked);
+        const flat = new Float64Array(asked.flatMap((r) => [r.offset, r.offset + r.length]));
+        // The planning is laminapdf-source's (`SparseSource::to_fetch`), shared with the Rust loop.
+        const todo = guard(() => sparse.toFetch(flat, blockSize, readahead));
+        if (round >= maxRounds || todo.length === 0 || key === previous)
+            throw error;
+        signal?.throwIfAborted();
+        await fetchRound(state, todo, signal);
+        previous = key;
+    }
+}
+/** Fetches and supplies the flat `[start, end, …]` ranges of one round. */
+async function fetchRound(state, todo, signal) {
+    const { sparse, source } = state;
+    const controller = new AbortController();
+    const onAbort = () => controller.abort(signal?.reason);
+    signal?.addEventListener("abort", onAbort, { once: true });
+    let failure;
+    const fetches = [];
+    for (let i = 0; i + 1 < todo.length; i += 2) {
+        const start = todo[i] ?? 0;
+        const end = todo[i + 1] ?? 0;
+        fetches.push(source
+            .read(start, end - start, { signal: controller.signal })
+            .then((bytes) => {
+            if (bytes.length !== end - start) {
+                throw packageError("fetch-failed", "a range source returned a different number of bytes than asked for", {
+                    data: { reason: "length", expected: end - start, got: bytes.length },
+                });
+            }
+            if (!controller.signal.aborted)
+                guard(() => sparse.supply(start, bytes));
+        })
+            .catch((e) => {
+            // The first failure wins; the aborts it causes in the other fetches don't replace it.
+            failure ??= { reason: e };
+            controller.abort(e);
+        }));
+    }
+    try {
+        await Promise.all(fetches);
+    }
+    finally {
+        signal?.removeEventListener("abort", onAbort);
+    }
+    if (signal?.aborted)
+        throw signal.reason;
+    if (failure !== undefined)
+        throw failure.reason;
+}
+//# sourceMappingURL=range.js.map

package/dist/source/range.js.map

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

package/dist/text.d.ts

@@ -0,0 +1,90 @@
+import type { PageTextJs, TextRunJs } from "@laminapdf/wasm/extract";
+/** Options for {@link PageRef.text}. */
+export interface TextOptions {
+    /** Leave out text drawn invisibly (rendering modes 3 and 7: OCR layers, hidden text). */
+    readonly skipInvisible?: boolean;
+}
+/** A point in page space (ADR 0027: top-left of the displayed CropBox, y down, points). */
+export interface QuadPoint {
+    readonly x: number;
+    readonly y: number;
+}
+/** A glyph's quad: its four corners, in drawing order (bottom-left, bottom-right, top-right, top-left of the glyph box). */
+export type GlyphQuad = readonly [QuadPoint, QuadPoint, QuadPoint, QuadPoint];
+/** One glyph of a run. */
+export interface TextGlyph {
+    /** The glyph's text (document text; U+FFFD when its Unicode is unknown). */
+    readonly text: string;
+    /** Its quad in page space. */
+    readonly quad: GlyphQuad;
+}
+/** A run: glyphs of one font, size, direction and marked content on one baseline, in logical order. */
+export declare class TextRun {
+    #private;
+    /** @internal */
+    constructor(page: PageText, run: TextRunJs);
+    /** The run's text in logical order (document text). */
+    get text(): string;
+    /** The font's `/BaseFont` (document text). */
+    get font(): string;
+    /** Font size, the text matrix applied. */
+    get size(): number;
+    /** Vertical writing. */
+    get vertical(): boolean;
+    /** The marked-content ID the run is in, if any (structure tree links). */
+    get mcid(): number | undefined;
+    /** The text comes from an `/ActualText` span. */
+    get actualText(): boolean;
+    /** Drawn invisibly (`Tr` 3 or 7: an OCR layer, hidden text). */
+    get invisible(): boolean;
+    /** The bounds of its glyph quads in page space: `{ x, y, width, height }`. */
+    get bounds(): {
+        readonly x: number;
+        readonly y: number;
+        readonly width: number;
+        readonly height: number;
+    };
+    /** The `[start, end)` range of its glyphs in the page's glyph arrays ({@link PageText.buffers}). */
+    get glyphRange(): readonly [number, number];
+    /** Its glyphs, with their quads (built on each call). */
+    glyphs(): TextGlyph[];
+}
+/** @internal The raw arrays of a PageText (the worker client sends them, L2a). */
+export declare let rawOf: (text: PageText) => PageTextJs;
+/** A page's extracted text: lines in reading order, and runs with their glyphs' quads. */
+export declare class PageText {
+    #private;
+    /** @internal */
+    constructor(raw: PageTextJs);
+    /** The text by line (runs on one baseline joined, trimmed), in content order. */
+    get lines(): readonly string[];
+    /** The page's text: its lines joined with `\n`. */
+    text(): string;
+    /** The runs, in content order (made on first use). */
+    get runs(): readonly TextRun[];
+    /** Glyphs whose Unicode is unknown (shown as U+FFFD). */
+    get unmapped(): number;
+    /** The number of glyphs. */
+    readonly glyphCount: number;
+    /**
+     * Glyph `i`'s text and quad.
+     *
+     * @throws `RangeError` for an index outside `0 … glyphCount - 1`; `TypeError` once
+     *   {@link PageText.buffers}' arrays were transferred to another thread.
+     */
+    glyph(i: number): TextGlyph;
+    /**
+     * The arrays as the WASM returned them: `quads` (8 numbers per glyph), `glyphText` and
+     * `glyphOffsets` (glyph i is `glyphText.slice(glyphOffsets[i], glyphOffsets[i + 1])`). Post
+     * `quads.buffer` and `glyphOffsets.buffer` as transferables to move them to another thread;
+     * that detaches them here, and this PageText's `glyph()` and `glyphs()` then throw (`lines`
+     * and `runs` keep working). They are this PageText's own arrays, not copies: writing to them
+     * changes what `glyph()` returns.
+     */
+    get buffers(): {
+        readonly quads: Float32Array;
+        readonly glyphText: string;
+        readonly glyphOffsets: Uint32Array;
+    };
+}
+//# sourceMappingURL=text.d.ts.map

package/dist/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAErE,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,yFAAyF;IACzF,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,2FAA2F;AAC3F,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,4HAA4H;AAC5H,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAE9E,0BAA0B;AAC1B,MAAM,WAAW,SAAS;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;CAC1B;AAED,uGAAuG;AACvG,qBAAa,OAAO;;IAMlB,gBAAgB;IAChB,YAAY,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAIzC;IAED,uDAAuD;IACvD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,8CAA8C;IAC9C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,0CAA0C;IAC1C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,wBAAwB;IACxB,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,0EAA0E;IAC1E,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IAED,iDAAiD;IACjD,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,gEAAgE;IAChE,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,8EAA8E;IAC9E,IAAI,MAAM,IAAI;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAGxG;IAED,oGAAoG;IACpG,IAAI,UAAU,IAAI,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAE1C;IAED,yDAAyD;IACzD,MAAM,IAAI,SAAS,EAAE,CAKpB;CACF;AAED,kFAAkF;AAClF,eAAO,IAAI,KAAK,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,UAAU,CAAC;AAEjD,0FAA0F;AAC1F,qBAAa,QAAQ;;IAUnB,gBAAgB;IAChB,YAAY,GAAG,EAAE,UAAU,EAK1B;IAED,iFAAiF;IACjF,IAAI,KAAK,IAAI,SAAS,MAAM,EAAE,CAE7B;IAED,mDAAmD;IACnD,IAAI,IAAI,MAAM,CAEb;IAED,sDAAsD;IACtD,IAAI,IAAI,IAAI,SAAS,OAAO,EAAE,CAG7B;IAED,yDAAyD;IACzD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,4BAA4B;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;;OAKG;IACH,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAc1B;IAED;;;;;;;OAOG;IACH,IAAI,OAAO,IAAI;QAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAA;KAAE,CAE9G;CACF"}

package/dist/text.js

@@ -0,0 +1,127 @@
+/** A run: glyphs of one font, size, direction and marked content on one baseline, in logical order. */
+export class TextRun {
+    #page;
+    #run;
+    #range;
+    /** @internal */
+    constructor(page, run) {
+        this.#page = page;
+        this.#run = run;
+        this.#range = Object.freeze([run.glyphs[0], run.glyphs[1]]);
+    }
+    /** The run's text in logical order (document text). */
+    get text() {
+        return this.#run.text;
+    }
+    /** The font's `/BaseFont` (document text). */
+    get font() {
+        return this.#run.font;
+    }
+    /** Font size, the text matrix applied. */
+    get size() {
+        return this.#run.size;
+    }
+    /** Vertical writing. */
+    get vertical() {
+        return this.#run.vertical;
+    }
+    /** The marked-content ID the run is in, if any (structure tree links). */
+    get mcid() {
+        return this.#run.mcid;
+    }
+    /** The text comes from an `/ActualText` span. */
+    get actualText() {
+        return this.#run.actualText;
+    }
+    /** Drawn invisibly (`Tr` 3 or 7: an OCR layer, hidden text). */
+    get invisible() {
+        return this.#run.invisible;
+    }
+    /** The bounds of its glyph quads in page space: `{ x, y, width, height }`. */
+    get bounds() {
+        const [x, y, width, height] = this.#run.bounds;
+        return { x, y, width, height };
+    }
+    /** The `[start, end)` range of its glyphs in the page's glyph arrays ({@link PageText.buffers}). */
+    get glyphRange() {
+        return this.#range;
+    }
+    /** Its glyphs, with their quads (built on each call). */
+    glyphs() {
+        const [start, end] = this.#run.glyphs;
+        const out = [];
+        for (let i = start; i < end; i++)
+            out.push(this.#page.glyph(i));
+        return out;
+    }
+}
+/** @internal The raw arrays of a PageText (the worker client sends them, L2a). */
+export let rawOf;
+/** A page's extracted text: lines in reading order, and runs with their glyphs' quads. */
+export class PageText {
+    #raw;
+    #runs;
+    static {
+        rawOf = (text) => text.#raw;
+    }
+    #lines;
+    /** @internal */
+    constructor(raw) {
+        this.#raw = raw;
+        this.#lines = Object.freeze([...raw.lines]);
+        // Kept from the start: transferring the buffers detaches glyphOffsets.
+        this.glyphCount = Math.max(0, raw.glyphOffsets.length - 1);
+    }
+    /** The text by line (runs on one baseline joined, trimmed), in content order. */
+    get lines() {
+        return this.#lines;
+    }
+    /** The page's text: its lines joined with `\n`. */
+    text() {
+        return this.#lines.join("\n");
+    }
+    /** The runs, in content order (made on first use). */
+    get runs() {
+        this.#runs ??= this.#raw.runs.map((r) => new TextRun(this, r));
+        return this.#runs;
+    }
+    /** Glyphs whose Unicode is unknown (shown as U+FFFD). */
+    get unmapped() {
+        return this.#raw.unmapped;
+    }
+    /** The number of glyphs. */
+    glyphCount;
+    /**
+     * Glyph `i`'s text and quad.
+     *
+     * @throws `RangeError` for an index outside `0 … glyphCount - 1`; `TypeError` once
+     *   {@link PageText.buffers}' arrays were transferred to another thread.
+     */
+    glyph(i) {
+        if (!Number.isInteger(i) || i < 0 || i >= this.glyphCount) {
+            throw new RangeError(`glyph index ${i} is outside 0..${this.glyphCount - 1}`);
+        }
+        const q = this.#raw.quads;
+        if (q.length < (i + 1) * 8 || this.#raw.glyphOffsets.length <= i + 1) {
+            throw new TypeError("the glyph arrays were transferred (buffers): this PageText no longer holds them");
+        }
+        const o = i * 8;
+        const point = (k) => ({ x: q[o + 2 * k] ?? 0, y: q[o + 2 * k + 1] ?? 0 });
+        return {
+            text: this.#raw.glyphText.slice(this.#raw.glyphOffsets[i] ?? 0, this.#raw.glyphOffsets[i + 1] ?? 0),
+            quad: [point(0), point(1), point(2), point(3)],
+        };
+    }
+    /**
+     * The arrays as the WASM returned them: `quads` (8 numbers per glyph), `glyphText` and
+     * `glyphOffsets` (glyph i is `glyphText.slice(glyphOffsets[i], glyphOffsets[i + 1])`). Post
+     * `quads.buffer` and `glyphOffsets.buffer` as transferables to move them to another thread;
+     * that detaches them here, and this PageText's `glyph()` and `glyphs()` then throw (`lines`
+     * and `runs` keep working). They are this PageText's own arrays, not copies: writing to them
+     * changes what `glyph()` returns.
+     */
+    get buffers() {
+        return { quads: this.#raw.quads, glyphText: this.#raw.glyphText, glyphOffsets: this.#raw.glyphOffsets };
+    }
+}
+//# sourceMappingURL=text.js.map

package/dist/text.js.map

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

package/dist/transaction.d.ts

@@ -0,0 +1,36 @@
+import type { DocumentInfo, Op } from "./types.js";
+/** The rotations `/Rotate` allows. */
+export type Rotation = 0 | 90 | 180 | 270;
+/** An Info patch: a string sets the entry, `null` removes it, a missing key leaves it alone. */
+export type InfoPatch = {
+    readonly [K in keyof DocumentInfo]?: string | null;
+};
+/** Collects the ops of one {@link Document.transact} call. */
+export declare class Transaction {
+    #private;
+    /** The ops collected so far. */
+    get ops(): readonly Op[];
+    /** @internal Ends the transaction: the handle takes no more ops. */
+    close(): void;
+    /**
+     * Adds `op` to the transaction.
+     *
+     * @throws {@link LaminaPdfError} `no-transaction` after `transact` returned.
+     */
+    apply(op: Op): this;
+    /**
+     * Patches the Info dictionary (`setInfo`).
+     *
+     * @param patch - the entries to set (a string) or remove (`null`).
+     * @param at - the modification date to write (`D:20261030120000Z`); omitted, none is written.
+     */
+    setInfo(patch: InfoPatch, at?: string): this;
+    /**
+     * Sets a page's `/Rotate` (`rotatePage`).
+     *
+     * @param page - the page's ID (`doc.page(0).id`).
+     * @param rotate - 0, 90, 180 or 270 degrees.
+     */
+    rotatePage(page: string, rotate: Rotation): this;
+}
+//# sourceMappingURL=transaction.d.ts.map

package/dist/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../src/transaction.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AAEnD,sCAAsC;AACtC,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,CAAC;AAE1C,gGAAgG;AAChG,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;CAAE,CAAC;AAE/E,8DAA8D;AAC9D,qBAAa,WAAW;;IAItB,gCAAgC;IAChC,IAAI,GAAG,IAAI,SAAS,EAAE,EAAE,CAEvB;IAED,oEAAoE;IACpE,KAAK,IAAI,IAAI,CAEZ;IAED;;;;OAIG;IACH,KAAK,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,CAMlB;IAED;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAE3C;IAED;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI,CAE/C;CACF"}

package/dist/transaction.js

@@ -0,0 +1,47 @@
+// The handle `Document.transact` passes to its callback (ADR 0006 §2): a closure can't cross the
+// WASM boundary, so the handle collects ops and the document applies them as one transaction.
+import { packageError } from "./errors.js";
+/** Collects the ops of one {@link Document.transact} call. */
+export class Transaction {
+    #ops = [];
+    #open = true;
+    /** The ops collected so far. */
+    get ops() {
+        return this.#ops;
+    }
+    /** @internal Ends the transaction: the handle takes no more ops. */
+    close() {
+        this.#open = false;
+    }
+    /**
+     * Adds `op` to the transaction.
+     *
+     * @throws {@link LaminaPdfError} `no-transaction` after `transact` returned.
+     */
+    apply(op) {
+        if (!this.#open) {
+            throw packageError("no-transaction", "the transaction has ended");
+        }
+        this.#ops.push(op);
+        return this;
+    }
+    /**
+     * Patches the Info dictionary (`setInfo`).
+     *
+     * @param patch - the entries to set (a string) or remove (`null`).
+     * @param at - the modification date to write (`D:20261030120000Z`); omitted, none is written.
+     */
+    setInfo(patch, at) {
+        return this.apply({ op: "setInfo", args: at === undefined ? { patch } : { patch, at } });
+    }
+    /**
+     * Sets a page's `/Rotate` (`rotatePage`).
+     *
+     * @param page - the page's ID (`doc.page(0).id`).
+     * @param rotate - 0, 90, 180 or 270 degrees.
+     */
+    rotatePage(page, rotate) {
+        return this.apply({ op: "rotatePage", args: { page, rotate } });
+    }
+}
+//# sourceMappingURL=transaction.js.map

package/dist/transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../src/transaction.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,8FAA8F;AAC9F,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAS3C,8DAA8D;AAC9D,MAAM,OAAO,WAAW;IACb,IAAI,GAAS,EAAE,CAAC;IACzB,KAAK,GAAG,IAAI,CAAC;IAEb,gCAAgC;IAChC,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,oEAAoE;IACpE,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,EAAM;QACV,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,YAAY,CAAC,gBAAgB,EAAE,2BAA2B,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,KAAgB,EAAE,EAAW;QACnC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAQ,CAAC,CAAC;IACjG,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,IAAY,EAAE,MAAgB;QACvC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAQ,CAAC,CAAC;IACxE,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,79 @@
+import type { AfRelationshipInit, AlignInit, AttachmentInit, BuildOptionsInit, DirectionInit, DocumentInfoJs, EditedJs, FitInit, LimitsInit, LineBoxJs, LinkTargetInit, MetadataInit, Op as OpJs, OutlineEntryInit, OverflowInit, PageInfoJs, PageLabelInit, ProfileInit, ProgressJs, RectJs, RenderModeInit, SaveOptionsInit, SaveReportJs, TextLayoutJs, TextRunJs, UndoOutcomeJs, ViewerPreferencesInit } from "@laminapdf/wasm/text";
+/** An edit (ADR 0006 §6: `{ op: "setInfo" | "rotatePage", args }`), as in `fixtures/ops/v1`. */
+export type Op = OpJs;
+/** An op log: `{ v: 1, ops }`. */
+export interface OpLog {
+    readonly v: 1;
+    readonly ops: readonly Op[];
+}
+/** `Limits` (ADR 0003 §3); each one left out keeps its default. */
+export type Limits = LimitsInit;
+/** Options for {@link Document.open}. */
+export interface OpenOptions {
+    /** The user or owner password of an encrypted document (normalised to NFKC, ADR 0016 §7). */
+    readonly password?: string;
+    /** Refuse files that need repair (`strict`). */
+    readonly strict?: boolean;
+    /** Resource limits. */
+    readonly limits?: Limits;
+}
+/** Options for saving. */
+export type SaveOptions = SaveOptionsInit;
+/** What a save wrote. */
+export type SaveReport = SaveReportJs;
+/** A page's facts: index, ID, displayed size in points, rotation, label. */
+export type PageInfo = PageInfoJs;
+/** The Info dictionary's text entries (document text). */
+export type DocumentInfo = DocumentInfoJs;
+/** The pages an edit touched. */
+export type Edited = EditedJs;
+/** How an undo or redo went. */
+export type UndoOutcome = UndoOutcomeJs;
+/** A save job's progress. */
+export type Progress = ProgressJs;
+/** Options for a new document: version, fixed file ID (32 hex digits), producer, creation date. */
+export type BuildOptions = BuildOptionsInit;
+/** A conformance profile: `PDF/UA-1` (accessible), `PDF/A-2b`, `PDF/A-2u` or `PDF/A-3b` (archival). */
+export type Profile = ProfileInit;
+/** How an attached file relates to the document (`/AFRelationship`). */
+export type AfRelationship = AfRelationshipInit;
+/** An attached file's relationship, description and modification date. */
+export type AttachmentOptions = AttachmentInit;
+/** Where a link or outline item goes. */
+export type LinkTarget = LinkTargetInit;
+/** How a destination shows its page. */
+export type Fit = FitInit;
+/** An outline (bookmarks) item with its children. */
+export type OutlineEntry = OutlineEntryInit;
+/** A page-label range, by its first page. */
+export type PageLabel = PageLabelInit;
+/** The document's metadata (Info and XMP). */
+export type Metadata = MetadataInit;
+/** How viewers present the document. */
+export type ViewerPreferences = ViewerPreferencesInit;
+/** A rectangle returned by the builder (page space). */
+export type BoxRect = RectJs;
+/** What a text run measures. */
+export type TextRunInfo = TextRunJs;
+/** How a text box laid its text out. */
+export type TextLayout = TextLayoutJs;
+/** A line of a text box. */
+export type LineBox = LineBoxJs;
+/** Text alignment in a text box. */
+export type Align = AlignInit;
+/** Paragraph direction. */
+export type Direction = DirectionInit;
+/** What happens to text that doesn't fit a text box. */
+export type Overflow = OverflowInit;
+/** Text rendering mode. */
+export type RenderMode = RenderModeInit;
+/**
+ * A colour: `[gray]`, `[r, g, b]` or `[c, m, y, k]` with components from 0 to 1, or `"#rrggbb"`
+ * / `"#rgb"` (DeviceRGB).
+ */
+export type Color = string | readonly [number] | readonly [number, number, number] | readonly [number, number, number, number];
+/** A point in page space (points from the top-left of the displayed page, y down; ADR 0027). */
+export type Point = readonly [x: number, y: number];
+/** A rectangle in page space: left, top, width, height. */
+export type Rect = readonly [x: number, y: number, width: number, height: number];
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+/** `@laminapdf/sdk`'s version. */
+export declare const VERSION = "0.2.0-alpha.2";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAIA,kCAAkC;AAClC,eAAO,MAAM,OAAO,kBAAkB,CAAC"}

package/dist/version.js

@@ -0,0 +1,6 @@
+// The package version the worker handshake compares (L2a): the client and the worker it starts
+// must be one build. `cargo xtask version sync` writes it from package.json (ADR 0017), and
+// test/version.test.ts checks the two agree.
+/** `@laminapdf/sdk`'s version. */
+export const VERSION = "0.2.0-alpha.2";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,4FAA4F;AAC5F,6CAA6C;AAE7C,kCAAkC;AAClC,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC"}