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

package/README.md

@@ -1,3 +1,31 @@
-# Temporary Holding Version
+# @laminapdf/render
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The interface Lamina PDF's web renderers share, the TypeScript twin of the Rust `laminapdf-render` crate. Two packages implement it: [`@laminapdf/render-pdfium`](../render-pdfium/README.md), the default, and [`@laminapdf/render-hayro`](../render-hayro/README.md), a second engine to compare against and debug with. Both run inside the viewer's document Web Worker. It's on npm as an alpha release, `@laminapdf/render@alpha`; most apps reach it through `@laminapdf/viewer`.
+
+```ts
+const backend = await initPdfium(wasmUrl);            // or initHayro()
+using doc = backend.open(bytesSource(bytes), { password });
+const plan = doc.plan({ page: 0, scale: 2, clip: { x: 0, y: 0, width: 512, height: 512 } });
+const { width, height, pixels } = doc.render({ page: 0, scale: 2, clip: plan.tile }, { signal });
+self.postMessage(await createImageBitmap(new ImageData(pixels, width, height)));
+```
+
+- **`RenderSource`:** `{ size, readSync(offset, length) }`, read synchronously, because PDFium's file access can't await. A read returns `undefined` when its bytes haven't arrived; the call then throws `data-pending` with `ranges` to fetch before retrying. `bytesSource(bytes)` wraps bytes already in memory.
+- **`RenderRequest`:**
+  - `page` (0-based) and `scale` (pixels per point, device pixel ratio applied);
+  - `clip?`: a tile, in the whole page's pixels;
+  - `rotation?`: 0, 90, 180 or 270;
+  - `flags?`: `annotations`, `formWidgets` (drawn only with annotations), `print`, `grayscale`;
+  - `background?`: white by default, `null` for transparent.
+- **Output:** straight-alpha RGBA8 rows of `width × 4` bytes.
+- **`planTile`:** the port of Rust's `TilePlan::new`, so both adapters agree on sizes. The page is `max(1, floor(points × scale))` pixels per side after the view rotation, and `RenderLimits` (16.7 MP and 16,384 px per tile, 1 GiB of input) are checked before anything is allocated. `pageToTile` is Rust's `TilePlan::page_to_tile`.
+- **Errors:** `RenderError` (`code`, `kind`, `ranges`), with Lamina PDF's error codes. `isRenderError(e, code)` checks structurally, so it works across copies of the package. `toDiagnostic()` returns the same error as the plain object every Lamina PDF surface uses. `@laminapdf/sdk`'s Web Worker posts that object, and the page receives a `LaminaPdfError` with the same code, message and ranges. An aborted `signal` throws a `DOMException` named `AbortError`, and a closed document throws `disposed`.
+
+## For contributors
+
+The contract is [ADR 0004](../../docs/decisions/0004-render-backend.md); the renderers run in the document worker of [ADR 0009](../../docs/decisions/0009-web-client-architecture.md) §2, and errors follow [ADR 0026](../../docs/decisions/0026-error-and-diagnostic-contract.md).
+
+### Tests
+
+- **Unit tests:** `pnpm --filter @laminapdf/render test`, for the planner and the error, in Node.
+- **The contract suite** that both adapters run, in Node and in Chromium, Firefox and WebKit, lives in [`@laminapdf/test-utils`](../test-utils/README.md), with the browser harness and config it uses.

package/dist/generated/codes.d.ts

@@ -0,0 +1,14 @@
+/** The codes a render backend throws (ADR 0026). */
+export type RenderErrorCode = "render-too-large" | "render-failed" | "render-backend-unavailable" | "invalid-argument" | "page-index-out-of-range" | "password-required" | "wrong-password" | "data-pending" | "source" | "cancelled" | "disposed";
+/** What kind of failure a render code is (the ADR 0026 kinds its codes use). */
+export type RenderErrorKind = "limit" | "input" | "io" | "usage" | "security" | "state" | "cancelled";
+/** The kind of each render code. */
+export declare const KINDS: {
+    readonly [C in RenderErrorCode]: RenderErrorKind;
+};
+/** Where each code's page is (ADR 0026 §6): `${base}${code}${suffix}`. */
+export declare const DOCS_URL: {
+    readonly base: "https://github.com/laudebugs/laminapdf/blob/main/docs/errors/";
+    readonly suffix: ".md";
+};
+//# sourceMappingURL=codes.d.ts.map

package/dist/generated/codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../../src/generated/codes.ts"],"names":[],"mappings":"AAGA,oDAAoD;AACpD,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,eAAe,GACf,4BAA4B,GAC5B,kBAAkB,GAClB,yBAAyB,GACzB,mBAAmB,GACnB,gBAAgB,GAChB,cAAc,GACd,QAAQ,GACR,WAAW,GACX,UAAU,CAAC;AAEf,gFAAgF;AAChF,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,OAAO,GACP,IAAI,GACJ,OAAO,GACP,UAAU,GACV,OAAO,GACP,WAAW,CAAC;AAEhB,oCAAoC;AACpC,eAAO,MAAM,KAAK,EAAE;IAAE,QAAQ,EAAE,CAAC,IAAI,eAAe,GAAG,eAAe;CAYrE,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,QAAQ;aAAK,IAAI,EAAE,+DAA+D;aAAE,MAAM,EAAE,KAAK;CAAW,CAAC"}

package/dist/generated/codes.js

@@ -0,0 +1,19 @@
+// @generated by cargo xtask gen codes. DO NOT EDIT.
+// From fixtures/codes.json (renderErrors and the codes it reuses); `cargo xtask check docs` fails when it is stale.
+/** The kind of each render code. */
+export const KINDS = {
+    "render-too-large": "limit",
+    "render-failed": "input",
+    "render-backend-unavailable": "io",
+    "invalid-argument": "usage",
+    "page-index-out-of-range": "usage",
+    "password-required": "security",
+    "wrong-password": "security",
+    "data-pending": "state",
+    "source": "io",
+    "cancelled": "cancelled",
+    "disposed": "state",
+};
+/** Where each code's page is (ADR 0026 §6): `${base}${code}${suffix}`. */
+export const DOCS_URL = { base: "https://github.com/laudebugs/laminapdf/blob/main/docs/errors/", suffix: ".md" };
+//# sourceMappingURL=codes.js.map

package/dist/generated/codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codes.js","sourceRoot":"","sources":["../../src/generated/codes.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,oHAAoH;AA0BpH,oCAAoC;AACpC,MAAM,CAAC,MAAM,KAAK,GAAyD;IACzE,kBAAkB,EAAE,OAAO;IAC3B,eAAe,EAAE,OAAO;IACxB,4BAA4B,EAAE,IAAI;IAClC,kBAAkB,EAAE,OAAO;IAC3B,yBAAyB,EAAE,OAAO;IAClC,mBAAmB,EAAE,UAAU;IAC/B,gBAAgB,EAAE,UAAU;IAC5B,cAAc,EAAE,OAAO;IACvB,QAAQ,EAAE,IAAI;IACd,WAAW,EAAE,WAAW;IACxB,UAAU,EAAE,OAAO;CACpB,CAAC;AAEF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,IAAI,EAAE,+DAA+D,EAAE,MAAM,EAAE,KAAK,EAAW,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,211 @@
+import { type RenderErrorCode, type RenderErrorKind } from "./generated/codes.js";
+/**
+ * The bytes of a document, read synchronously (PDFium's file access can't await). A read
+ * returns `undefined` when those bytes haven't arrived yet: the call then throws `data-pending`
+ * with the ranges to fetch (ADR 0004 §1, the web form of `Pending`).
+ */
+export interface RenderSource {
+    readonly size: number;
+    /** `length` bytes at `offset` (fewer only at the end), or `undefined` while they haven't arrived. */
+    readSync(offset: number, length: number): Uint8Array | undefined;
+}
+/** A source over bytes already in memory. */
+export declare function bytesSource(bytes: Uint8Array): RenderSource;
+/** Bounds on one render, checked before anything is allocated (`render-too-large`). */
+export interface RenderLimits {
+    /** Most pixels in one tile. Default 16,777,216 (4096 × 4096), iOS Safari's per-canvas cap. */
+    readonly maxRenderPixels: number;
+    /** Most pixels on either side of one tile. Default 16,384. */
+    readonly maxRenderSide: number;
+    /** Most input bytes a backend that reads the whole file (hayro) reads. Default 1 GiB. */
+    readonly maxInputBytes: number;
+}
+/** The render limits when none are given (ADR 0004): 16.7 MP, 16,384 px a side, 1 GiB of input. */
+export declare const DEFAULT_LIMITS: RenderLimits;
+/** A view rotation, clockwise, added to the page's own `/Rotate`. */
+export type ViewRotation = 0 | 90 | 180 | 270;
+/** Whether `rotation` turns the page a quarter (90° or 270°), which swaps its width and height. */
+export declare function isQuarterTurn(rotation: ViewRotation): boolean;
+/** What to draw besides the page content. */
+export interface RenderFlags {
+    /** Annotation appearance streams. Default on. */
+    readonly annotations: boolean;
+    /** Form widgets, read-only; drawn only when `annotations` is on too. Default on. */
+    readonly formWidgets: boolean;
+    /** Print intent: honours annotation `Print`/`NoView` flags. Default off. */
+    readonly print: boolean;
+    /** Grayscale content (the background keeps its colour). Default off. */
+    readonly grayscale: boolean;
+}
+/** The render flags when none are given: annotations and form widgets drawn, screen colours. */
+export declare const DEFAULT_FLAGS: RenderFlags;
+/** A rectangle in the whole page's output pixels (after scale and view rotation), y down. */
+export interface PixelRect {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+/** A straight-alpha sRGB colour, each channel 0–255. */
+export interface Rgba8 {
+    readonly r: number;
+    readonly g: number;
+    readonly b: number;
+    readonly a: number;
+}
+/** Opaque white, the default background. */
+export declare const WHITE: Rgba8;
+/** One render: a page, a scale, an optional tile, a view rotation, flags and a background. */
+export interface RenderRequest {
+    /** 0-based (ADR 0027). */
+    readonly page: number;
+    /** Output pixels per point, device pixel ratio applied (1 is 72 DPI). */
+    readonly scale: number;
+    /** The tile; omitted is the whole page (still bounded by the limits). */
+    readonly clip?: PixelRect;
+    readonly rotation?: ViewRotation;
+    readonly flags?: Partial<RenderFlags>;
+    /** Omitted is white; `null` is transparent. */
+    readonly background?: Rgba8 | null;
+}
+/** A page as a backend reports it: displayed size in points (`/Rotate` applied) and `/Rotate`. */
+export interface RenderPage {
+    readonly width: number;
+    readonly height: number;
+    readonly rotate: number;
+}
+/** The geometry of one validated request. */
+export interface TilePlan {
+    /** The whole page's pixel size at the scale, after the view rotation. */
+    readonly pageWidth: number;
+    readonly pageHeight: number;
+    readonly tile: PixelRect;
+    /** `tile.width × tile.height × 4`. */
+    readonly byteLength: number;
+}
+/** A rendered tile: straight-alpha RGBA8, ready for `new ImageData(pixels, width, height)`. */
+export interface RenderedTile {
+    readonly width: number;
+    readonly height: number;
+    readonly pixels: Uint8ClampedArray<ArrayBuffer>;
+}
+/** Options for opening a document in a backend. */
+export interface RenderOpenOptions {
+    /** Used by `open` only; the backend keeps no copy (ADR 0004 §1). */
+    readonly password?: string;
+    readonly limits?: Partial<RenderLimits>;
+}
+/** One open document. One call at a time (renders are synchronous). */
+export interface RenderDocument extends Disposable {
+    readonly pageCount: number;
+    /** @throws RenderError `page-index-out-of-range`, `data-pending`, `render-failed`. */
+    page(index: number): RenderPage;
+    /** Validates `request` for this document. */
+    plan(request: RenderRequest): TilePlan;
+    /**
+     * Renders `request`. `signal` is checked before and after the engine call: an aborted
+     * request throws a `DOMException` named `AbortError`, and nothing it allocated survives.
+     */
+    render(request: RenderRequest, options?: {
+        readonly signal?: AbortSignal;
+    }): RenderedTile;
+    /** Frees the engine's document. Idempotent. */
+    close(): void;
+}
+/** A rendering engine. */
+export interface RenderBackend {
+    readonly name: "pdfium" | "hayro";
+    readonly version: string;
+    /** The size of the engine's WebAssembly memory, in bytes (it only grows). */
+    memory(): number;
+    /** @throws RenderError `password-required`, `wrong-password`, `data-pending`, `render-failed`. */
+    open(source: RenderSource, options?: RenderOpenOptions): RenderDocument;
+}
+export type { RenderErrorCode, RenderErrorKind } from "./generated/codes.js";
+/** A byte range of the input: its first byte and its length. */
+export type ByteRange = readonly [offset: number, length: number];
+/** A render backend's error, in the ADR 0026 contract. Messages carry no document text. */
+export declare class RenderError extends Error {
+    readonly name = "RenderError";
+    readonly code: RenderErrorCode;
+    readonly kind: RenderErrorKind;
+    /** For `data-pending`: the ranges to fetch before calling again. */
+    readonly ranges: readonly ByteRange[] | undefined;
+    constructor(code: RenderErrorCode, message: string, ranges?: readonly ByteRange[]);
+    /**
+     * The ADR 0026 §1 object: what crosses a worker boundary (structured clone keeps neither a
+     * custom error name nor own properties). `@laminapdf/sdk`'s worker posts it, and the page gets
+     * a `LaminaPdfError` with the same code, message and `ranges`. A `data-pending` lists its ranges
+     * as `[offset, length]` pairs in `data.ranges`, as the Rust core does. It carries no hint.
+     */
+    toDiagnostic(): RenderDiagnostic;
+}
+/** A RenderError as the ADR 0026 §1 object (see {@link RenderError.toDiagnostic}). */
+export interface RenderDiagnostic {
+    readonly code: RenderErrorCode;
+    readonly kind: RenderErrorKind;
+    readonly message: string;
+    readonly data?: {
+        readonly ranges: readonly ByteRange[];
+    };
+    readonly docsUrl: string;
+}
+/** Whether `e` is a RenderError (with `code`, if given). */
+export declare function isRenderError<C extends RenderErrorCode>(e: unknown, code?: C): e is RenderError & {
+    code: C;
+};
+/** Whether `code` is one of the codes a render backend throws. */
+export declare function isRenderErrorCode(code: unknown): code is RenderErrorCode;
+/**
+ * Merges limits over the defaults. Sides are clamped to 2^32 − 1 (a u32 in the Rust planner),
+ * so both planners see the same limit.
+ */
+export declare function limitsOf(limits?: Partial<RenderLimits>): RenderLimits;
+/** Merges flags over the defaults. */
+export declare function flagsOf(flags?: Partial<RenderFlags>): RenderFlags;
+/**
+ * Validates `request` against `page` and `limits` (the port of Rust's `TilePlan::new`): the
+ * whole page is `max(1, floor(points × scale))` pixels per side after the view rotation, and the
+ * tile must lie inside it and within the limits.
+ *
+ * @throws RenderError `invalid-argument` or `render-too-large`.
+ */
+export declare function planTile(page: RenderPage, request: RenderRequest, limits: RenderLimits): TilePlan;
+/**
+ * The affine matrix `[a, b, c, d, e, f]` from the displayed page space (points, top-left origin,
+ * y down, `/Rotate` applied) to the tile's pixels: Rust's `TilePlan::page_to_tile`.
+ */
+export declare function pageToTile(plan: TilePlan, page: RenderPage, rotation?: ViewRotation): readonly number[];
+/** Throws the `AbortError` a cancelled render throws, if `signal` is aborted. */
+export declare function throwIfAborted(signal: AbortSignal | undefined): void;
+/**
+ * Where an engine's `.wasm` comes from: a URL (or URL string) to fetch, a `Response` (or a
+ * promise of one), the bytes, or a compiled `WebAssembly.Module`. The app controls caching and
+ * lazy loading (ADR 0009 §2).
+ */
+export type WasmSource = URL | string | Response | PromiseLike<Response> | ArrayBuffer | ArrayBufferView<ArrayBuffer> | WebAssembly.Module;
+/** The {@link WasmSource} forms that `postMessage` can send to a worker. */
+export type CloneableWasmSource = string | ArrayBuffer | ArrayBufferView<ArrayBuffer> | WebAssembly.Module;
+/** The most input bytes a wasm32 engine can address: its file access and buffers take 32-bit sizes. */
+export declare const MAX_WASM_INPUT = 4294967295;
+/** Throws `render-too-large` when an input of `size` bytes is over `most`. */
+export declare function checkInputSize(size: number, most: number): void;
+/** Throws `page-index-out-of-range` unless `index` is a page of a `pageCount`-page document. */
+export declare function checkPageIndex(index: number, pageCount: number): void;
+/** Throws `disposed` once the document is closed. */
+export declare function checkOpen(open: boolean): asserts open;
+/** The error of a failed read: the source's own RenderError, else `source`. */
+export declare function readFailure(offset: number, length: number, cause?: unknown): RenderError;
+/**
+ * Reads `length` bytes at `offset` from `source`: the bytes, or `undefined` while they haven't
+ * arrived.
+ *
+ * @throws RenderError `source` when the source throws or returns fewer bytes, or the source's own
+ * RenderError.
+ */
+export declare function readRange(source: RenderSource, offset: number, length: number): Uint8Array | undefined;
+/** `ranges` sorted, with overlapping and touching ones merged (an engine may ask for one window many times). */
+export declare function mergeRanges(ranges: readonly ByteRange[]): [offset: number, length: number][];
+/** `data-pending` with the missing `ranges`, merged. */
+export declare function pendingError(ranges: readonly ByteRange[]): RenderError;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,251 @@
+// The web render contract of ADR 0004: the interface both web adapters implement
+// (@laminapdf/render-pdfium, @laminapdf/render-hayro), the tile planner they share, and RenderError.
+// It mirrors laminapdf-render's Rust trait: bounded tiles of a page at a scale, straight-alpha RGBA8
+// rows of width × 4 bytes, validated once by planTile so both adapters agree on sizes.
+import { DOCS_URL, KINDS } from "./generated/codes.js";
+/** A source over bytes already in memory. */
+export function bytesSource(bytes) {
+    return {
+        size: bytes.length,
+        readSync: (offset, length) => bytes.subarray(offset, Math.min(bytes.length, offset + length)),
+    };
+}
+/** The render limits when none are given (ADR 0004): 16.7 MP, 16,384 px a side, 1 GiB of input. */
+export const DEFAULT_LIMITS = Object.freeze({
+    maxRenderPixels: 16_777_216,
+    maxRenderSide: 16_384,
+    maxInputBytes: 2 ** 30,
+});
+/** Whether `rotation` turns the page a quarter (90° or 270°), which swaps its width and height. */
+export function isQuarterTurn(rotation) {
+    return rotation === 90 || rotation === 270;
+}
+/** The render flags when none are given: annotations and form widgets drawn, screen colours. */
+export const DEFAULT_FLAGS = Object.freeze({
+    annotations: true,
+    formWidgets: true,
+    print: false,
+    grayscale: false,
+});
+/** Opaque white, the default background. */
+export const WHITE = Object.freeze({ r: 255, g: 255, b: 255, a: 255 });
+/** A render backend's error, in the ADR 0026 contract. Messages carry no document text. */
+export class RenderError extends Error {
+    name = "RenderError";
+    code;
+    kind;
+    /** For `data-pending`: the ranges to fetch before calling again. */
+    ranges;
+    constructor(code, message, ranges) {
+        super(message);
+        this.code = code;
+        this.kind = KINDS[code];
+        this.ranges = ranges;
+    }
+    /**
+     * The ADR 0026 §1 object: what crosses a worker boundary (structured clone keeps neither a
+     * custom error name nor own properties). `@laminapdf/sdk`'s worker posts it, and the page gets
+     * a `LaminaPdfError` with the same code, message and `ranges`. A `data-pending` lists its ranges
+     * as `[offset, length]` pairs in `data.ranges`, as the Rust core does. It carries no hint.
+     */
+    toDiagnostic() {
+        return {
+            code: this.code,
+            kind: this.kind,
+            message: this.message,
+            ...(this.ranges === undefined ? {} : { data: { ranges: this.ranges } }),
+            docsUrl: `${DOCS_URL.base}${this.code}${DOCS_URL.suffix}`,
+        };
+    }
+}
+/** Whether `e` is a RenderError (with `code`, if given). */
+export function isRenderError(e, code) {
+    // Structural, not instanceof: module copies give one class per copy (ADR 0009 §3).
+    if (typeof e !== "object" || e === null || e.name !== "RenderError")
+        return false;
+    const actual = e.code;
+    return typeof actual === "string" && (code === undefined || actual === code);
+}
+/** Whether `code` is one of the codes a render backend throws. */
+export function isRenderErrorCode(code) {
+    return typeof code === "string" && Object.hasOwn(KINDS, code);
+}
+/**
+ * Merges limits over the defaults. Sides are clamped to 2^32 − 1 (a u32 in the Rust planner),
+ * so both planners see the same limit.
+ */
+export function limitsOf(limits) {
+    const merged = { ...DEFAULT_LIMITS, ...limits };
+    return { ...merged, maxRenderSide: Math.min(Math.max(0, Math.floor(merged.maxRenderSide)), 0xffff_ffff) };
+}
+/** Merges flags over the defaults. */
+export function flagsOf(flags) {
+    return { ...DEFAULT_FLAGS, ...flags };
+}
+/**
+ * Validates `request` against `page` and `limits` (the port of Rust's `TilePlan::new`): the
+ * whole page is `max(1, floor(points × scale))` pixels per side after the view rotation, and the
+ * tile must lie inside it and within the limits.
+ *
+ * @throws RenderError `invalid-argument` or `render-too-large`.
+ */
+export function planTile(page, request, limits) {
+    checkScale(request.scale);
+    checkPage(page);
+    checkBackground(request.background);
+    const quarter = isQuarterTurn(checkRotation(request.rotation ?? 0));
+    const pageWidth = wholePixels(quarter ? page.height : page.width, request.scale);
+    const pageHeight = wholePixels(quarter ? page.width : page.height, request.scale);
+    const tile = request.clip ?? { x: 0, y: 0, width: pageWidth, height: pageHeight };
+    checkTile(tile, pageWidth, pageHeight);
+    checkTileLimits(tile, limits);
+    return { pageWidth, pageHeight, tile, byteLength: tile.width * tile.height * 4 };
+}
+function checkScale(scale) {
+    // The Rust planner sees the scale as an f32: check that value, so both agree.
+    if (!Number.isFinite(Math.fround(scale)) || Math.fround(scale) <= 0) {
+        throw new RenderError("invalid-argument", "invalid render request: scale must be finite and positive");
+    }
+}
+function checkRotation(rotation) {
+    if (![0, 90, 180, 270].includes(rotation)) {
+        throw new RenderError("invalid-argument", "invalid render request: rotation must be 0, 90, 180 or 270");
+    }
+    return rotation;
+}
+function checkPage(page) {
+    if (!(page.width > 0 && page.height > 0 && Number.isFinite(page.width) && Number.isFinite(page.height))) {
+        throw new RenderError("invalid-argument", "invalid render request: the page has no drawable area");
+    }
+}
+function checkBackground(background) {
+    if (background === undefined || background === null)
+        return;
+    const channels = [background.r, background.g, background.b, background.a];
+    if (!channels.every((c) => Number.isInteger(c) && c >= 0 && c <= 255)) {
+        throw new RenderError("invalid-argument", "invalid render request: colour channels must be integers 0–255");
+    }
+}
+/** One side of the whole page in pixels: `max(1, floor(points × scale))`. */
+function wholePixels(points, scale) {
+    // f32 like the Rust planner, so both agree on the floor at every scale.
+    const v = Math.max(1, Math.floor(Math.fround(points) * Math.fround(scale)));
+    if (v > 2_147_483_647) {
+        throw new RenderError("invalid-argument", "invalid render request: the page is too large to address at this scale");
+    }
+    return v;
+}
+/** The tile is whole pixels, not empty, and inside the whole page. */
+function checkTile(tile, pageWidth, pageHeight) {
+    const ints = [tile.x, tile.y, tile.width, tile.height];
+    if (!ints.every((v) => Number.isInteger(v) && v >= 0)) {
+        throw new RenderError("invalid-argument", "invalid render request: the tile must be whole pixels");
+    }
+    if (tile.width === 0 || tile.height === 0) {
+        throw new RenderError("invalid-argument", "invalid render request: the tile is empty");
+    }
+    if (tile.x + tile.width > pageWidth || tile.y + tile.height > pageHeight) {
+        throw new RenderError("invalid-argument", "invalid render request: the tile extends past the page");
+    }
+}
+function checkTileLimits(tile, limits) {
+    if (tile.width > limits.maxRenderSide || tile.height > limits.maxRenderSide) {
+        throw new RenderError("render-too-large", `a ${tile.width}×${tile.height} pixel tile exceeds the render limit of ${limits.maxRenderSide} pixels per side`);
+    }
+    if (tile.width * tile.height > limits.maxRenderPixels) {
+        throw new RenderError("render-too-large", `a ${tile.width}×${tile.height} pixel tile exceeds the render limit of ${limits.maxRenderPixels} pixels`);
+    }
+}
+/**
+ * The affine matrix `[a, b, c, d, e, f]` from the displayed page space (points, top-left origin,
+ * y down, `/Rotate` applied) to the tile's pixels: Rust's `TilePlan::page_to_tile`.
+ */
+export function pageToTile(plan, page, rotation = 0) {
+    const quarter = isQuarterTurn(rotation);
+    const w0 = quarter ? plan.pageHeight : plan.pageWidth;
+    const h0 = quarter ? plan.pageWidth : plan.pageHeight;
+    const sx = w0 / page.width;
+    const sy = h0 / page.height;
+    const { x: tx, y: ty } = plan.tile;
+    switch (rotation) {
+        case 0:
+            return [sx, 0, 0, sy, -tx, -ty];
+        case 90:
+            return [0, sx, -sy, 0, h0 - tx, -ty];
+        case 180:
+            return [-sx, 0, 0, -sy, w0 - tx, h0 - ty];
+        case 270:
+            return [0, -sx, sy, 0, -tx, w0 - ty];
+    }
+}
+/** Throws the `AbortError` a cancelled render throws, if `signal` is aborted. */
+export function throwIfAborted(signal) {
+    if (signal?.aborted)
+        throw new DOMException("the render was aborted", "AbortError");
+}
+// For the adapters (@laminapdf/render-hayro, @laminapdf/render-pdfium): what both share, so they
+// check pages, reads and sizes the same way. Apps don't need these.
+/** The most input bytes a wasm32 engine can address: its file access and buffers take 32-bit sizes. */
+export const MAX_WASM_INPUT = 0xffff_ffff;
+/** Throws `render-too-large` when an input of `size` bytes is over `most`. */
+export function checkInputSize(size, most) {
+    if (size > most) {
+        throw new RenderError("render-too-large", `the input is ${size} bytes, over the render limit of ${most} bytes`);
+    }
+}
+/** Throws `page-index-out-of-range` unless `index` is a page of a `pageCount`-page document. */
+export function checkPageIndex(index, pageCount) {
+    if (!Number.isInteger(index) || index < 0 || index >= pageCount) {
+        throw new RenderError("page-index-out-of-range", `page index ${index} is out of range for a document of ${pageCount} pages`);
+    }
+}
+/** Throws `disposed` once the document is closed. */
+export function checkOpen(open) {
+    if (!open)
+        throw new RenderError("disposed", "the document was closed");
+}
+/** The error of a failed read: the source's own RenderError, else `source`. */
+export function readFailure(offset, length, cause) {
+    return isRenderError(cause)
+        ? cause
+        : new RenderError("source", `bytes ${offset}..+${length} of the input could not be read`);
+}
+/**
+ * Reads `length` bytes at `offset` from `source`: the bytes, or `undefined` while they haven't
+ * arrived.
+ *
+ * @throws RenderError `source` when the source throws or returns fewer bytes, or the source's own
+ * RenderError.
+ */
+export function readRange(source, offset, length) {
+    let bytes;
+    try {
+        bytes = source.readSync(offset, length);
+    }
+    catch (e) {
+        throw readFailure(offset, length, e);
+    }
+    if (bytes !== undefined && bytes.length !== length)
+        throw readFailure(offset, length);
+    return bytes;
+}
+/** `ranges` sorted, with overlapping and touching ones merged (an engine may ask for one window many times). */
+export function mergeRanges(ranges) {
+    const merged = [];
+    for (const [offset, length] of [...ranges].sort((a, b) => a[0] - b[0] || a[1] - b[1])) {
+        const last = merged.at(-1);
+        if (last !== undefined && offset <= last[0] + last[1]) {
+            last[1] = Math.max(last[1], offset + length - last[0]);
+        }
+        else {
+            merged.push([offset, length]);
+        }
+    }
+    return merged;
+}
+/** `data-pending` with the missing `ranges`, merged. */
+export function pendingError(ranges) {
+    const merged = mergeRanges(ranges);
+    return new RenderError("data-pending", `${merged.length} byte range(s) of the input are not available yet`, merged);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "@laminapdf/render",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0-alpha.3",
+  "description": "The web render contract of ADR 0004: the RenderBackend interface @laminapdf/render-pdfium and @laminapdf/render-hayro implement, the tile planner they share, and RenderError.",
+  "license": "MIT OR Apache-2.0",
+  "homepage": "https://laminapdf.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/laudebugs/laminapdf.git",
+    "directory": "packages/render"
+  },
+  "keywords": [
+    "pdf",
+    "render",
+    "renderer",
+    "interface"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "devDependencies": {
+    "@types/node": "26.6.5",
+    "@vitest/browser-playwright": "5.0.5",
+    "typescript": "7.0.2",
+    "vitest": "5.0.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.build.json && tsc --noEmit -p tsconfig.json",
+    "test": "tsc -p tsconfig.build.json && vitest run"
+  }
 }