[]
DEMOS DOCS API PRICING
FREE TRIAL
(Showing Draft Content)

README

DsPdfJS API v9.1.1

@mescius/ds-pdf

Document Solutions for PDF JS

Document Solutions for PDF JS (DsPdfJS) is a powerful PDF library for JavaScript and TypeScript that provides a rich set of APIs for fast, memory-efficient PDF and image processing in modern web and server-side environments.

Powered by WebAssembly (Wasm), DsPdfJS runs in browsers and JavaScript runtimes such as Node.js, Deno, and Bun. Its core object model follows the PDF specification, providing programmatic access to PDF elements such as document properties, pages, fonts, annotations, forms, and more.

DsPdfJS also includes high-level APIs for creating PDF documents with complex layouts including formatted text, graphics, images, forms, and advanced document workflows.

Features include:

  • Programmatically create, load, modify, save, or inspect PDF documents
  • Support for modern PDF standards
  • Export PDF pages to raster or vector image formats
  • Merge or split PDF documents
  • Draw text, shapes, paths, and images with high-level graphics APIs
  • Powerful text formatting and layout engine with wrapping, alignment, spacing, tabs, RTL text (including Kashida), and vertical writing
  • Advanced font handling with embedding and subsetting support
  • Add raster or vector images including PNG, JPEG, SVG, and SVGZ
  • Create, edit, fill, or flatten AcroForm PDF forms
  • Work with annotations, links, text markup, and rich media
  • Find and replace text with configurable search options and exact match positions
  • Programmatically create and apply redactions to permanently remove sensitive content
  • Encryption and security APIs
  • Image processing APIs for resizing, transforming, filtering, drawing, and bitmap generation
  • Designed for efficient memory usage through explicit Wasm object lifecycle management
  • TypeScript-ready with modern module support

Compatibility:

DsPdfJS is compatible with:

  • Environments:
    • Modern browsers
    • Node.js, Deno, Bun, other Node‑compatible runtimes
  • Module formats:
    • ES Modules
    • CommonJS
    • UMD
  • TypeScript (type definitions are included)

Latest changes

[9.1.1] - 04-Jun-2026

Fixed

  • Fixed an issue where PdfDocument.pages.clone() did not clone form fields and annotations even when cloneFields or cloneAnnotations parameters were set to true. (DOC-7621)
  • Fixed an issue where importFormDataFromFDF() failed to import some form field data from FDF files. (DOC-7620)
  • Fixed an issue where getText() returned incorrect content when extracting text from redacted PDFs. (DOC-7617)
  • Fixed an issue with inconsistent graphics rendering when applying RadialGradientBrush to shapes. (DOC-7570)
  • Fixed an issue where deleteText() removed content that should not have been deleted. (DOC-7526)

Changed

  • Changed the default angle units for rotation transforms from Degrees to Radians (to align with the HTML canvas API). If your code passed degree values, convert them to radians or specify angle units explicitly.

Added

  • Added new properties:

    • get DrawingContext.width(): number;
    • get DrawingContext.height(): number;
    • get DrawingContext.resolution(): number;
    • FormatProperties.allowFontSbits?: boolean;
    • get Format.allowFontSbits(): boolean;

  • Added new method overloads:

    • BilevelBitmap.clip(x: number, y: number, width: number, height: number, metadataOnly?: boolean): BilevelBitmap;
    • GrayscaleBitmap.clip(x: number, y: number, width: number, height: number, metadataOnly?: boolean): GrayscaleBitmap;
    • Bitmap.resize(width: number, height: number, interpolationMode?: em.InterpolationMode): Bitmap;
    • Bitmap.clip(x: number, y: number, width: number, height: number, metadataOnly?: boolean): Bitmap;
    • Layout.append(text: string): void;
    • Layout.append(text: string, format: Format): void;
    • Layout.append(text: string, font: Font, fontSize: number, foreColor: ds.Color): void;
    • Layout.appendLine(text: string): void;
    • Layout.appendLine(text: string, format: Format): void;
    • Layout.appendLine(text: string, font: Font, fontSize: number, foreColor: ds.Color): void;

[9.1.0] - 05-May-2026

Added

  • Initial release.

Installation:

npm install @mescius/ds-pdf

Getting Started:

1. Set the WebAssembly (Wasm) URL

DsPdfJS uses a WebAssembly module. You must point DsPdfConfig.wasmUrl to the shipped .wasm file:

import { DsPdfConfig } from "@mescius/ds-pdf";
DsPdfConfig.wasmUrl = "/node\_modules/@mescius/ds-pdf/assets/DsPdf.wasm";

2. (Optional) Apply a License Key

// await DsPdfConfig.setLicenseKey("YOUR\_LICENSE\_KEY");

3. Connect to DsPdfJS

import { connectDsPdf } from "@mescius/ds-pdf";
const connected = await connectDsPdf();
if (!connected) throw new Error("Failed to initialize DsPdfJS.");

Usage:

Browser (ES Modules)

import { DsPdfConfig, connectDsPdf, PdfDocument, pushObjectManager, popObjectManager
} from "@mescius/ds-pdf";

DsPdfConfig.wasmUrl = "/node_modules/@mescius/ds-pdf/assets/DsPdf.wasm";
// await DsPdfConfig.setLicenseKey("...");

if (!(await connectDsPdf())) throw new Error("Failed to initialize DsPdfJS.");

pushObjectManager();
try {
  const doc = new PdfDocument();
  const page = doc.pages.addNew();
  const ctx = page.context;

  ctx.drawText({ text: "Hello, World!", fontSize: 20 }, 72, 72);

  const pdfData = doc.savePdf();
  // pdfData is a Uint8Array (or equivalent binary buffer)
  return pdfData;
} finally {
  popObjectManager();
}

Browser (Pure JavaScript / UMD)

Include the UMD bundle directly:

<script src="node_modules/@mescius/ds-pdf/umd/ds-pdf.js"></script>
<script>
async function createDocument() {
  // UMD bundle exposes global 'DocSol'
  DocSol.DsPdfConfig.wasmUrl = "/node_modules/@mescius/ds-pdf/assets/DsPdf.wasm";
  // await DocSol.DsPdfConfig.setLicenseKey("...");

  const connected = await DocSol.connectDsPdf();
  if (!connected) throw new Error("Failed to initialize DsPdfJS.");

  // Use an ObjectManager to control native/Wasm-backed object lifetimes:
  const om = new DocSol.ObjectManager();
  try {
    const doc = new DocSol.PdfDocument(om);
    const page = doc.pages.addNew();
    const ctx = page.context;

    ctx.drawText({ text: "Hello, World!", fontSize: 20 }, 72, 72);

    return doc.savePdf();
  } finally {
    om.dispose();
  }
}

createDocument()
  .then(pdfData => console.log("PDF created:", pdfData))
  .catch(err => console.error(err));
</script>

Node.js (CommonJS)

const { DsPdfConfig, connectDsPdf, PdfDocument, ObjectManager } = require("@mescius/ds-pdf");

// Example: set to the package Wasm (adjust to your environment/pathing)
DsPdfConfig.wasmUrl = "./node_modules/@mescius/ds-pdf/assets/DsPdf.wasm";
// await DsPdfConfig.setLicenseKey("...");

(async () => {
  if (!(await connectDsPdf())) throw new Error("Failed to initialize DsPdfJS.");

  const om = new ObjectManager();
  try {
    const doc = new PdfDocument(om);
    const page = doc.pages.addNew();
    const ctx = page.context;

    ctx.drawText({ text: "Hello, World!", fontSize: 20 }, 72, 72);

    const pdfData = doc.savePdf();
    return pdfData;
  } finally {
    om.dispose();
  }
})();

Memory Management: ObjectManager

Many objects are backed by Wasm memory. Use one of these patterns to control memory usage:

  • Push/pop: pushObjectManager(); ... popObjectManager();
  • Explicit: const om = new ObjectManager(); ... om.dispose();
  • Decorator: @withObjectManager async pdfSample1() { ... }

This makes sure that intermediate objects are released when no longer needed.

Notes:

  • Coordinate units in PDF drawing contexts are “page units” (points) by default (72 units per inch), but can be changed as needed.
  • Coordinate units in image drawing contexts are pixels (96 units per inch).

Resources:

Other Document Solutions Products:

Document Solutions JavaScript Viewers:

License:

A commercial license is required for production use.

Each purchase includes one year of updates and support. Please contact MESCIUS Sales (us.sales@mescius.com) for pricing, trial keys, and licensing options.