EmbedPDF

# @embedpdf/engines Pluggable rendering engines for EmbedPDF. Ships with **`PdfiumEngine`** – a high‑level, promise‑first wrapper built on top of `@embedpdf/pdfium`. ## Documentation For complete guides, examples, and full API reference, visit: **[Official Documentation](https://www.embedpdf.com/docs/engines/introduction)** ## Why `@embedpdf/engines`? - **High‑level abstraction** – handles tasks, DPR scaling, annotation colour resolution, range/linearised loading. - **Universal runtimes** – works in browsers, Node, and serverless environments. - **Typed & composable** – 100 % TypeScript with generics for custom image pipelines. ## Features - Open PDFs from `ArrayBuffer` or URL - Render full pages, arbitrary rectangles, thumbnails – all DPI‑aware - Text extraction, glyph geometry, word‑break‑aware search with context windows - Read / create / transform / delete **annotations** and **form fields** - Page ops: merge, extract, flatten, partial import - Attachments & digital‑signature introspection ## Installation ```bash npm install @embedpdf/engines @embedpdf/pdfium ``` ## Basic Usage ```typescript import { init } from '@embedpdf/pdfium'; import { PdfiumEngine } from '@embedpdf/engines/pdfium'; const pdfiumWasm = 'https://cdn.jsdelivr.net/npm/@embedpdf/pdfium/dist/pdfium.wasm'; (async () => { const response = await fetch(pdfiumWasm); const wasmBinary = await response.arrayBuffer(); // 1 – boot the low‑level WASM module const pdfium = await init({ wasmBinary }); // 2 – create the high‑level engine const engine = new PdfiumEngine(pdfium); engine.initialize(); // 3 – open & render const document = await engine .openDocumentUrl({ id: 'demo', url: '/demo.pdf' }) .toPromise(); const page0 = doc.pages[0]; const blob = await engine.renderPage(doc, page0).toPromise(); })(); ``` ## Learn More Head over to our docs for: - **Getting Started** – initialise, render, destroy - **Engine Interface** – implement your own back‑end - **Advanced Topics** – workers, Node pipelines, Sharp image adapters ## License MIT – see the [LICENSE](https://github.com/embedpdf/embed-pdf-viewer/blob/main/packages/engines/LICENSE) file.