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

package/README.md

@@ -1,3 +1,36 @@
-# Temporary Holding Version
+# @laminapdf/render-pdfium
 
-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.
+Lamina PDF's default web renderer: PDFium as WebAssembly behind [`@laminapdf/render`](../render/README.md)'s `RenderBackend`. It runs only inside the viewer's document Web Worker. It is private, and `@laminapdf/sdk` never depends on it.
+
+```ts
+import wasmUrl from "@embedpdf/pdfium/pdfium.wasm?url";
+import { initPdfium } from "@laminapdf/render-pdfium";
+
+const pdfium = await initPdfium(wasmUrl); // a URL, Response, bytes or compiled WebAssembly.Module
+```
+
+- **The build:** [`@embedpdf/pdfium`](https://www.npmjs.com/package/@embedpdf/pdfium) **2.15.1**, an npm dependency pinned exactly. Its `pdfium.wasm` must have SHA-256 `5e4cd023…4eaa`.
+  - **Checking:** the hash is checked before every build and test, so any other file fails them.
+  - **Fetched, not vendored:** pnpm's lockfile pins the tarball's integrity, and the 4.6 MB binary stays out of git.
+  - **Revision:** the package doesn't record its PDFium revision. It is built from EmbedPDF's fork, [`embedpdf/runtime`](https://github.com/embedpdf/runtime), without XFA, V8 or Skia.
+- **Loading:** `initPdfium(wasm)` takes any `WasmSource`. Bytes (an `ArrayBuffer` or any view of one) go to Emscripten's `wasmBinary`. A module, a URL, or a `Response` or a promise of one goes through Emscripten's `instantiateWasm` hook. A URL served as `application/wasm` compiles while it downloads. The caller decides where the `.wasm` comes from, which controls caching and lazy loading. There are no top-level side effects.
+- **Input:** PDFium's custom file access (`FPDF_LoadCustomDocument`) reads the `RenderSource` block by block, with no whole copy. A block the source can't give yet makes the call throw `data-pending` with its ranges, even if PDFium carried on with defaults. Input is limited to 4 GiB (a wasm32 `unsigned long`).
+- **Rendering:** each document has a form-fill environment (`PDFiumExt_InitFormFillEnvironment`), as the native adapter does.
+  - **With widgets** (`FPDF_RenderPageBitmap`, then `FPDF_FFLDraw`), the page is laid out at its whole pixel size and shifted, so only the tile lands in a tile-sized bitmap.
+  - **Without widgets,** `FPDF_RenderPageBitmapWithMatrix` gets `pageToTile`'s matrix.
+  - **Output:** `FPDF_REVERSE_BYTE_ORDER` gives RGBA, which is copied out of the heap once. Bitmap and buffer are freed on every path.
+- **Cancellation:** the `AbortSignal` is checked before and after the synchronous engine call. Progressive rendering is exported by the build, but not used yet; that's a follow-up if long single tiles need it.
+- **Notices:** `@embedpdf/pdfium` ships none for PDFium's bundled libraries. [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md) lists them, and apps ship it.
+- **Size:** `pdfium.wasm` is 2,136,390 B gzip.
+
+## For contributors
+
+It is the default renderer of [ADR 0004](../../docs/decisions/0004-render-backend.md), pinned per [§3](../../docs/decisions/0004-render-backend.md#3-the-pinned-pdfium-builds), in the document worker of [ADR 0009](../../docs/decisions/0009-web-client-architecture.md) §2; its size was measured by [C1b](../../docs/todos/done/C1b-pdfium-wasm-spike.md). A re-pin changes `package.json`, the hash in the script, ADR 0004 and `THIRD_PARTY_NOTICES.md` together.
+
+- **Hash check:** `scripts/verify-pdfium.mjs` checks the hash before every `build`, `typecheck` and `test`; `test/verify.test.ts` tests the verifier.
+- **Size budget:** `thirdParty.pdfium` in `packages/wasm/size-budgets.json` is the measured size plus 5 %, checked by `cargo xtask size`.
+
+### Tests
+
+- **Node:** `pnpm --filter @laminapdf/render-pdfium test` (part of `cargo xtask check ts`) runs the verifier and the RenderBackend contract over the installed `pdfium.wasm`.
+- **Browsers:** `pnpm --filter @laminapdf/render-pdfium exec vitest run -c vitest.browser.config.ts --project chromium` runs the contract in Chromium, and likewise `firefox` and `webkit`. `cargo xtask pdf-runtimes <browser>` runs it too. The browser runs add [C2b](../../docs/todos/done/C2b-lamina-render-crate.md)'s goldens: EmbedPDF's build against native `chromium/7881` goldens, at SSIM ≥ 0.98.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,30 @@
+# Third-party notices: `@laminapdf/render-pdfium`
+
+This package loads `pdfium.wasm` from [`@embedpdf/pdfium`](https://www.npmjs.com/package/@embedpdf/pdfium) 2.15.1 (SHA-256 `5e4cd023c3dad4a895b3571ca573d3fc51bac6de48360d95283134385b954eaa`, checked by `scripts/verify-pdfium.mjs`). The `@embedpdf/pdfium` package ships none of the notices below ([C1b](../../spikes/pdfium-wasm/README.md#licences)); [ADR 0004 §3](../../docs/decisions/0004-render-backend.md#3-the-pinned-pdfium-builds) requires every product that ships PDFium to carry them. An app that bundles this package ships this file, plus the full licence texts it links to, with its other notices.
+
+## Where the list comes from
+
+- EmbedPDF builds `pdfium.wasm` from its PDFium fork, [`embedpdf/runtime`](https://github.com/embedpdf/runtime) (`scripts/embedpdf-runtime/build-target.sh`).
+- That build sets `pdf_enable_xfa=false`, `pdf_enable_v8=false` and `pdf_use_skia=false`. So V8, Skia and XFA's own dependencies (libtiff among them) are **not** linked, and the rasteriser is PDFium's copy of AGG.
+- **Confirmed in the binary's strings:** libpng, zlib, OpenJPEG. The symbol names are stripped, so the others below are inferred from PDFium's non-XFA build: FreeType, Little-CMS 2, libjpeg-turbo and AGG are core dependencies of PDFium's codecs and font engine.
+- **Possibly linked, depending on the PDFium revision:** Abseil, fast_float and simdutf. Their notices are listed so a bundle is never short of one.
+- **To do on every re-pin (ADR 0004 §3):** re-check this list against the fork's `DEPS` and `BUILD.gn` at the pinned revision.
+
+## Components
+
+| Component | Licence | Required notice or attribution |
+| --- | --- | --- |
+| `@embedpdf/pdfium` (the wrapper and its JS glue) | MIT | © 2024 CloudPDF, Ji Chang. The MIT text ships as the package's `LICENSE`. |
+| PDFium | BSD-3-Clause; parts Apache-2.0 | © 2014 The PDFium Authors. Both texts ship as the package's `LICENSE.pdfium`. |
+| FreeType | FreeType Project License (FTL), chosen over GPLv2 | "Portions of this software are copyright © The FreeType Project (www.freetype.org). All rights reserved." ([FTL](https://gitlab.freedesktop.org/freetype/freetype/-/blob/master/docs/FTL.TXT)) |
+| Little-CMS 2 | MIT | Copyright © Marti Maria Saguer ([COPYING](https://github.com/mm2/Little-CMS/blob/master/LICENSE)) |
+| libjpeg-turbo | IJG License, BSD-3-Clause, zlib | "This software is based in part on the work of the Independent JPEG Group." ([LICENSE.md](https://github.com/libjpeg-turbo/libjpeg-turbo/blob/main/LICENSE.md)) |
+| libpng | PNG Reference Library License v2 | Copyright © the libpng authors ([LICENSE](https://github.com/pnggroup/libpng/blob/libpng16/LICENSE)) |
+| zlib | zlib | Copyright © Jean-loup Gailly and Mark Adler ([zlib licence](https://zlib.net/zlib_license.html)) |
+| OpenJPEG | BSD-2-Clause | Copyright © Université catholique de Louvain, CNES, and the OpenJPEG contributors ([LICENSE](https://github.com/uclouvain/openjpeg/blob/master/LICENSE)) |
+| Anti-Grain Geometry 2.3 (PDFium's copy) | AGG 2.3 licence (permissive) | Copyright © 2002–2005 Maxim Shemanarev ([PDFium's copy](https://pdfium.googlesource.com/pdfium/+/refs/heads/main/third_party/agg23/)) |
+| Abseil (if linked) | Apache-2.0 | © The Abseil Authors |
+| fast_float (if linked) | MIT OR Apache-2.0 OR BSL-1.0 | © The fast_float authors |
+| simdutf (if linked) | MIT OR Apache-2.0 | © The simdutf authors |
+
+**Licences:** all of these are permissive, and none is GPL, LGPL or AGPL ([ADR 0001](../../docs/decisions/0001-core-language-and-licence.md)). FreeType is used under the FTL.

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import { type WrappedPdfiumModule } from "@embedpdf/pdfium";
+import { type RenderBackend, type RenderDocument, type RenderOpenOptions, type RenderSource, type WasmSource } from "@laminapdf/render";
+/** The pinned package (ADR 0004 §3); its pdfium.wasm's SHA-256 is checked at build time. */
+export declare const PDFIUM_PACKAGE = "@embedpdf/pdfium@2.15.1";
+type Pdfium = WrappedPdfiumModule;
+/**
+ * Loads PDFium. Call it inside the document worker (ADR 0009 §2), once per worker.
+ *
+ * @throws RenderError `render-backend-unavailable` when the module can't be fetched or compiled.
+ */
+export declare function initPdfium(wasm: WasmSource): Promise<PdfiumBackend>;
+/** PDFium-WASM as a RenderBackend. */
+export declare class PdfiumBackend implements RenderBackend {
+    #private;
+    readonly name = "pdfium";
+    readonly version = "@embedpdf/pdfium@2.15.1";
+    constructor(pdfium: Pdfium);
+    /** The size of PDFium's WebAssembly memory, in bytes. */
+    memory(): number;
+    /** Opens `source` (see {@link RenderBackend.open}). */
+    open(source: RenderSource, options?: RenderOpenOptions): RenderDocument;
+}
+export {};
+//# 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":"AAUA,OAAO,EAAQ,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAUL,KAAK,aAAa,EAClB,KAAK,cAAc,EAKnB,KAAK,iBAAiB,EAGtB,KAAK,YAAY,EAMjB,KAAK,UAAU,EAEhB,MAAM,mBAAmB,CAAC;AAE3B,4FAA4F;AAC5F,eAAO,MAAM,cAAc,4BAA4B,CAAC;AAExD,KAAK,MAAM,GAAG,mBAAmB,CAAC;AA2ClC;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAuBzE;AAED,sCAAsC;AACtC,qBAAa,aAAc,YAAW,aAAa;;IACjD,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,OAAO,6BAAkB;IAGlC,YAAY,MAAM,EAAE,MAAM,EAEzB;IAED,yDAAyD;IACzD,MAAM,IAAI,MAAM,CAEf;IAED,uDAAuD;IACvD,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,iBAAsB,GAAG,cAAc,CAE1E;CACF"}

package/dist/index.js

@@ -0,0 +1,368 @@
+// ADR 0004's default web renderer: the pinned PDFium-WASM build behind
+// @laminapdf/render's RenderBackend. It mirrors the native adapter (laminapdf-render-pdfium):
+// - input through PDFium's custom file access over a RenderSource (no whole copy); a read the
+//   source can't answer yet makes the call throw `data-pending` with the ranges;
+// - a form-fill environment per document, so widgets are drawn by FPDF_FFLDraw and can be left
+//   out; with widgets the page is laid out at its whole pixel size and shifted so only the tile
+//   lands in a tile-sized bitmap, without them FPDF_RenderPageBitmapWithMatrix gets
+//   pageToTile's matrix;
+// - straight RGBA through FPDF_REVERSE_BYTE_ORDER, copied out once into the result.
+// PDFium is synchronous: the AbortSignal is checked before and after the engine call.
+import { init } from "@embedpdf/pdfium";
+import { checkInputSize, checkOpen, checkPageIndex, flagsOf, limitsOf, MAX_WASM_INPUT, pageToTile, pendingError, planTile, RenderError, readFailure, readRange, throwIfAborted, WHITE, } from "@laminapdf/render";
+/** The pinned package (ADR 0004 §3); its pdfium.wasm's SHA-256 is checked at build time. */
+export const PDFIUM_PACKAGE = "@embedpdf/pdfium@2.15.1";
+// fpdfview.h
+const FPDF_ANNOT = 0x01;
+const FPDF_GRAYSCALE = 0x08;
+const FPDF_REVERSE_BYTE_ORDER = 0x10;
+const FPDF_PRINTING = 0x800;
+const FPDFBITMAP_BGRA = 4;
+const FPDF_ERR_PASSWORD = 4;
+/** Whether `wasm` is the module's bytes: an ArrayBuffer or any view of one. */
+function isBytes(wasm) {
+    return wasm instanceof ArrayBuffer || ArrayBuffer.isView(wasm);
+}
+/** `wasm`'s bytes as a Uint8Array over the same memory. */
+function asUint8Array(wasm) {
+    return wasm instanceof ArrayBuffer
+        ? new Uint8Array(wasm)
+        : new Uint8Array(wasm.buffer, wasm.byteOffset, wasm.byteLength);
+}
+/**
+ * A module, or a URL or `Response` to fetch. `isBytes` is the check that keeps bytes out:
+ * `WebAssembly.Module` is an empty interface, so this parameter's type alone would accept them.
+ */
+async function instantiate(wasm, imports) {
+    if (wasm instanceof WebAssembly.Module)
+        return WebAssembly.instantiate(wasm, imports);
+    const awaited = await wasm;
+    const response = awaited instanceof Response ? awaited : await fetch(awaited);
+    if (!response.ok)
+        throw new RenderError("render-backend-unavailable", `pdfium.wasm: HTTP ${response.status}`);
+    // Streaming compile needs `application/wasm`; fall back to the bytes otherwise.
+    if (response.headers.get("content-type")?.startsWith("application/wasm")) {
+        return (await WebAssembly.instantiateStreaming(response, imports)).instance;
+    }
+    return (await WebAssembly.instantiate(await response.arrayBuffer(), imports)).instance;
+}
+/**
+ * Loads PDFium. Call it inside the document worker (ADR 0009 §2), once per worker.
+ *
+ * @throws RenderError `render-backend-unavailable` when the module can't be fetched or compiled.
+ */
+export async function initPdfium(wasm) {
+    let fail = () => { };
+    const failed = new Promise((_, reject) => {
+        fail = reject;
+    });
+    // Bytes go to the glue's own `wasmBinary` as a Uint8Array over the same memory (it reads it with
+    // `new Uint8Array(…)`, wrong for other views); a module, a URL or a Response through its hook.
+    const overrides = isBytes(wasm)
+        ? { wasmBinary: asUint8Array(wasm) }
+        : {
+            instantiateWasm: (imports, done) => {
+                instantiate(wasm, imports).then(done, fail);
+                return {};
+            },
+        };
+    try {
+        const pdfium = await Promise.race([failed, init(overrides)]);
+        pdfium.PDFiumExt_Init();
+        return new PdfiumBackend(pdfium);
+    }
+    catch (e) {
+        if (e instanceof RenderError)
+            throw e;
+        throw new RenderError("render-backend-unavailable", "PDFium could not be loaded");
+    }
+}
+/** PDFium-WASM as a RenderBackend. */
+export class PdfiumBackend {
+    name = "pdfium";
+    version = PDFIUM_PACKAGE;
+    #pdfium;
+    constructor(pdfium) {
+        this.#pdfium = pdfium;
+    }
+    /** The size of PDFium's WebAssembly memory, in bytes. */
+    memory() {
+        return heap(this.#pdfium).buffer.byteLength;
+    }
+    /** Opens `source` (see {@link RenderBackend.open}). */
+    open(source, options = {}) {
+        return PdfiumDocument.open(this.#pdfium, source, options);
+    }
+}
+function heap(p) {
+    return p.pdfium.wasmExports.memory;
+}
+/** The error the refused reads make, if any: a failed read first, else `data-pending`. */
+function refusal(reads) {
+    if (reads.failure !== undefined)
+        return reads.failure;
+    return reads.pending.length > 0 ? pendingError(reads.pending) : undefined;
+}
+/** PDFium's render flags for the request's flags; every render writes RGBA byte order. */
+function renderFlagsOf(flags) {
+    return ((flags.annotations ? FPDF_ANNOT : 0) |
+        (flags.print ? FPDF_PRINTING : 0) |
+        (flags.grayscale ? FPDF_GRAYSCALE : 0) |
+        FPDF_REVERSE_BYTE_ORDER);
+}
+class PdfiumDocument {
+    pageCount;
+    #p;
+    #limits;
+    #pages = new Map();
+    #reads;
+    #doc;
+    #form;
+    #formInfo;
+    #access;
+    #getBlock;
+    constructor(p, handles, reads, limits) {
+        this.#p = p;
+        this.#doc = handles.doc;
+        this.#form = handles.form;
+        this.#formInfo = handles.formInfo;
+        this.#access = handles.access;
+        this.#getBlock = handles.getBlock;
+        this.pageCount = handles.count;
+        this.#reads = reads;
+        this.#limits = limits;
+    }
+    static open(p, source, options) {
+        // PDFium reads block by block, so only wasm32's custom file access (32-bit sizes) bounds the
+        // input; `maxInputBytes` is for engines that read the whole file (ADR 0004).
+        checkInputSize(source.size, MAX_WASM_INPUT);
+        const reads = { pending: [], failure: undefined };
+        const { malloc, free } = p.pdfium.wasmExports;
+        // FPDF_FILEACCESS.m_GetBlock(param, position, pBuf, size): 1 on success, 0 on failure. It
+        // never throws: an exception would unwind through PDFium's C++ frames. A throwing or short
+        // read is recorded and reported after the engine call returns.
+        const getBlock = p.pdfium.addFunction((_param, position, buf, size) => {
+            const at = position >>> 0;
+            const length = size >>> 0;
+            try {
+                const bytes = readRange(source, at, length);
+                if (bytes === undefined) {
+                    reads.pending.push([at, length]);
+                    return 0;
+                }
+                new Uint8Array(heap(p).buffer, buf, length).set(bytes);
+                return 1;
+            }
+            catch (e) {
+                reads.failure ??= readFailure(at, length, e);
+                return 0;
+            }
+        }, "iiiii");
+        // FPDF_FILEACCESS on wasm32: m_FileLen (unsigned long), m_GetBlock, m_Param: 12 bytes.
+        const access = malloc(12);
+        if (access === 0) {
+            p.pdfium.removeFunction(getBlock);
+            throw new RenderError("render-failed", "the pdfium backend could not allocate memory");
+        }
+        p.pdfium.setValue(access, source.size >>> 0, "i32");
+        p.pdfium.setValue(access + 4, getBlock, "i32");
+        p.pdfium.setValue(access + 8, 0, "i32");
+        const release = () => {
+            free(access);
+            p.pdfium.removeFunction(getBlock);
+        };
+        const doc = p.FPDF_LoadCustomDocument(access, options.password ?? "");
+        if (doc === 0) {
+            const error = p.FPDF_GetLastError();
+            release();
+            const refused = refusal(reads);
+            if (refused !== undefined)
+                throw refused;
+            if (error === FPDF_ERR_PASSWORD) {
+                throw options.password === undefined
+                    ? new RenderError("password-required", "the document is encrypted and needs a password")
+                    : new RenderError("wrong-password", "the password does not open the document");
+            }
+            throw new RenderError("render-failed", "the pdfium backend could not open the document");
+        }
+        const formInfo = p.PDFiumExt_OpenFormFillInfo();
+        const form = p.PDFiumExt_InitFormFillEnvironment(doc, formInfo);
+        const count = p.FPDF_GetPageCount(doc);
+        // PDFium may open after refused reads by rebuilding the structure, and the form environment
+        // and the page count read more: any refusal up to here makes the open fail, so a document
+        // never keeps a page count read from a partial file.
+        const refused = refusal(reads);
+        if (refused !== undefined) {
+            if (form !== 0)
+                p.PDFiumExt_ExitFormFillEnvironment(form);
+            if (formInfo !== 0)
+                p.PDFiumExt_CloseFormFillInfo(formInfo);
+            p.FPDF_CloseDocument(doc);
+            release();
+            throw refused;
+        }
+        return new PdfiumDocument(p, { doc, form, formInfo, access, getBlock, count }, reads, limitsOf(options.limits));
+    }
+    #live() {
+        checkOpen(this.#doc !== 0);
+        return this.#doc;
+    }
+    /**
+     * Runs `f` with the refusals cleared; any read the source refused makes the outcome that
+     * refusal (`source` or `data-pending`), success or not.
+     */
+    #reading(f) {
+        this.#reads.pending.length = 0;
+        this.#reads.failure = undefined;
+        let outcome;
+        try {
+            outcome = f();
+        }
+        catch (e) {
+            throw refusal(this.#reads) ?? e;
+        }
+        const refused = refusal(this.#reads);
+        if (refused !== undefined)
+            throw refused;
+        return outcome;
+    }
+    #withPage(index, f) {
+        const doc = this.#live();
+        checkPageIndex(index, this.pageCount);
+        const p = this.#p;
+        const page = p.FPDF_LoadPage(doc, index);
+        if (page === 0)
+            throw new RenderError("render-failed", "the pdfium backend could not load the page");
+        if (this.#form !== 0)
+            p.FORM_OnAfterLoadPage(page, this.#form);
+        try {
+            return f(page);
+        }
+        finally {
+            if (this.#form !== 0)
+                p.FORM_OnBeforeClosePage(page, this.#form);
+            p.FPDF_ClosePage(page);
+        }
+    }
+    #geometry(page) {
+        const p = this.#p;
+        return {
+            width: p.FPDF_GetPageWidthF(page),
+            height: p.FPDF_GetPageHeightF(page),
+            rotate: (((p.FPDFPage_GetRotation(page) % 4) + 4) % 4) * 90,
+        };
+    }
+    page(index) {
+        this.#live();
+        const cached = this.#pages.get(index);
+        if (cached !== undefined)
+            return cached;
+        const page = this.#reading(() => this.#withPage(index, (handle) => this.#geometry(handle)));
+        this.#pages.set(index, page);
+        return page;
+    }
+    plan(request) {
+        return planTile(this.page(request.page), request, this.#limits);
+    }
+    render(request, options = {}) {
+        // As in every adapter: the abort first, then whether the document is open.
+        throwIfAborted(options.signal);
+        this.#live();
+        const result = this.#reading(() => this.#withPage(request.page, (page) => this.#renderPage(page, request)));
+        throwIfAborted(options.signal);
+        return result;
+    }
+    /** Renders the request's tile of an open page into a fresh bitmap and copies it out. */
+    #renderPage(page, request) {
+        const p = this.#p;
+        const { malloc, free } = p.pdfium.wasmExports;
+        const info = this.#geometry(page);
+        const plan = planTile(info, request, this.#limits);
+        const { width, height } = plan.tile;
+        const buffer = malloc(plan.byteLength);
+        if (buffer === 0)
+            throw new RenderError("render-failed", "the pdfium backend could not allocate the tile");
+        const bitmap = p.FPDFBitmap_CreateEx(width, height, FPDFBITMAP_BGRA, buffer, width * 4);
+        try {
+            if (bitmap === 0)
+                throw new RenderError("render-failed", "the pdfium backend could not allocate the tile");
+            this.#fillBackground(bitmap, plan, request.background === undefined ? WHITE : request.background);
+            this.#draw(bitmap, page, plan, info, request);
+            const pixels = new Uint8ClampedArray(plan.byteLength);
+            pixels.set(new Uint8Array(heap(p).buffer, buffer, plan.byteLength));
+            return { width, height, pixels };
+        }
+        finally {
+            if (bitmap !== 0)
+                p.FPDFBitmap_Destroy(bitmap);
+            free(buffer);
+        }
+    }
+    /**
+     * Draws the page into the bitmap. Widgets need the whole page laid out and shifted, since
+     * FPDF_FFLDraw takes no matrix; without them the matrix call draws only the tile.
+     */
+    #draw(bitmap, page, plan, info, request) {
+        const flags = flagsOf(request.flags);
+        const renderFlags = renderFlagsOf(flags);
+        const rotation = request.rotation ?? 0;
+        if (flags.annotations && flags.formWidgets) {
+            this.#drawWithWidgets(bitmap, page, plan, rotation / 90, renderFlags);
+        }
+        else {
+            this.#drawWithMatrix(bitmap, page, pageToTile(plan, info, rotation), plan, renderFlags);
+        }
+    }
+    #drawWithWidgets(bitmap, page, plan, rotate, renderFlags) {
+        const p = this.#p;
+        const [x, y] = [-plan.tile.x, -plan.tile.y];
+        p.FPDF_RenderPageBitmap(bitmap, page, x, y, plan.pageWidth, plan.pageHeight, rotate, renderFlags);
+        if (this.#form !== 0) {
+            p.FPDF_FFLDraw(this.#form, bitmap, page, x, y, plan.pageWidth, plan.pageHeight, rotate, renderFlags);
+        }
+    }
+    /** Fills the whole bitmap with the background, or with transparent black when it is `null`. */
+    #fillBackground(bitmap, plan, background) {
+        // FillRect takes 0xAARRGGBB into BGRA memory; with R and B swapped it lands as RGBA, the
+        // order the reversed-byte-order render writes.
+        const c = background ?? { r: 0, g: 0, b: 0, a: 0 };
+        const color = ((c.a << 24) | (c.b << 16) | (c.g << 8) | c.r) >>> 0;
+        this.#p.FPDFBitmap_FillRect(bitmap, 0, 0, plan.tile.width, plan.tile.height, color);
+    }
+    /** Draws only the tile, through `matrix` (pageToTile's) and a clip of the whole bitmap. */
+    #drawWithMatrix(bitmap, page, matrix, plan, renderFlags) {
+        const p = this.#p;
+        const { malloc, free } = p.pdfium.wasmExports;
+        // FS_MATRIX (6 floats) then FS_RECTF (left, top, right, bottom).
+        const scratch = malloc(40);
+        if (scratch === 0)
+            throw new RenderError("render-failed", "the pdfium backend could not allocate memory");
+        try {
+            const floats = new Float32Array(heap(p).buffer, scratch, 10);
+            floats.set([...matrix, 0, 0, plan.tile.width, plan.tile.height]);
+            p.FPDF_RenderPageBitmapWithMatrix(bitmap, page, scratch, scratch + 24, renderFlags);
+        }
+        finally {
+            free(scratch);
+        }
+    }
+    close() {
+        if (this.#doc === 0)
+            return;
+        const p = this.#p;
+        if (this.#form !== 0)
+            p.PDFiumExt_ExitFormFillEnvironment(this.#form);
+        if (this.#formInfo !== 0)
+            p.PDFiumExt_CloseFormFillInfo(this.#formInfo);
+        p.FPDF_CloseDocument(this.#doc);
+        p.pdfium.wasmExports.free(this.#access);
+        p.pdfium.removeFunction(this.#getBlock);
+        this.#doc = 0;
+        this.#form = 0;
+        this.#formInfo = 0;
+    }
+    [Symbol.dispose]() {
+        this.close();
+    }
+}
+//# 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,55 @@
 {
   "name": "@laminapdf/render-pdfium",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0-alpha.3",
+  "description": "ADR 0004's default web renderer: the pinned PDFium-WASM build (@embedpdf/pdfium 2.15.1, SHA-256 checked) behind @laminapdf/render's RenderBackend interface, for the document worker.",
+  "license": "MIT OR Apache-2.0",
+  "homepage": "https://laminapdf.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/laudebugs/laminapdf.git",
+    "directory": "packages/render-pdfium"
+  },
+  "keywords": [
+    "pdf",
+    "render",
+    "pdfium",
+    "wasm"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@embedpdf/pdfium": "2.15.1",
+    "@laminapdf/render": "0.2.0-alpha.3"
+  },
+  "devDependencies": {
+    "@types/node": "26.6.5",
+    "@vitest/browser-playwright": "5.0.5",
+    "playwright": "1.64.1",
+    "typescript": "7.0.2",
+    "vite": "8.3.5",
+    "vitest": "5.0.5",
+    "@laminapdf/test-utils": "0.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "node scripts/verify-pdfium.mjs && tsc -p tsconfig.build.json",
+    "typecheck": "node scripts/verify-pdfium.mjs && tsc -p tsconfig.build.json && tsc --noEmit -p tsconfig.json",
+    "test": "node scripts/verify-pdfium.mjs && tsc -p tsconfig.build.json && vitest run -c vitest.node.config.ts"
+  }
 }