modern-pdf-lib 0.14.0 → 0.15.0

package/README.md

@@ -15,7 +15,7 @@ Create, parse, fill, merge, sign, and manipulate PDF documents<br />in Node, Den
 
 [![npm version](https://img.shields.io/npm/v/modern-pdf-lib?style=flat-square&color=cb3837)](https://www.npmjs.com/package/modern-pdf-lib)
 [![bundle size](https://img.shields.io/badge/gzip-36kb_core-blue?style=flat-square)](https://bundlephobia.com/package/modern-pdf-lib)
-[![tests](https://img.shields.io/badge/tests-2%2C199_passing-brightgreen?style=flat-square)](#)
+[![tests](https://img.shields.io/badge/tests-2%2C323_passing-brightgreen?style=flat-square)](#)
 [![TypeScript](https://img.shields.io/badge/TypeScript-6.0-3178c6?style=flat-square&logo=typescript&logoColor=white)](#)
 [![License: MIT](https://img.shields.io/badge/license-MIT-yellow?style=flat-square)](LICENSE)
 
@@ -68,6 +68,7 @@ const blob = await doc.saveAsBlob();     // Blob (browsers)
 - TrueType & OpenType font embedding
 - Automatic font subsetting
 - JPEG / PNG image embedding
+- Image optimization (JPEG recompression, dedup, grayscale)
 - RGB, CMYK, grayscale colors
 - Linear & radial gradients, tiling patterns
 - Text layout (multiline, combed, auto-size)
@@ -90,7 +91,7 @@ const blob = await doc.saveAsBlob();     // Blob (browsers)
 
 **Secure & Compliant**
 - AES-256 / RC4 encryption & decryption
-- Digital signatures (PKCS#7, timestamps)
+- Digital signatures (PKCS#7, visible/invisible, timestamps)
 - PDF/A-1b through PDF/A-3u validation
 - Tagged PDF / PDF/UA accessibility
 - Structure tree & marked content
@@ -107,6 +108,7 @@ const blob = await doc.saveAsBlob();     // Blob (browsers)
 - Linearization (fast web view)
 - 60+ low-level PDF operators
 - Custom appearance providers
+- CLI: `npx modern-pdf optimize`
 
 </td>
 </tr>
@@ -168,7 +170,7 @@ const blob = await doc.saveAsBlob();     // Blob (browsers)
 <td align="center">Copy pages only</td></tr>
 
 <tr><td><strong>Annotations</strong></td>
-<td align="center">16 types + appearances</td>
+<td align="center">18 types + appearances</td>
 <td align="center">No</td></tr>
 
 <tr><td><strong>Streaming output</strong></td>
@@ -195,8 +197,12 @@ const blob = await doc.saveAsBlob();     // Blob (browsers)
 <td align="center">Yes</td>
 <td align="center">No</td></tr>
 
+<tr><td><strong>Image optimization</strong></td>
+<td align="center">JPEG recompress, dedup, grayscale</td>
+<td align="center">No</td></tr>
+
 <tr><td><strong>WASM acceleration</strong></td>
-<td align="center">Optional (compression, PNG, fonts, JBIG2)</td>
+<td align="center">Optional (compression, PNG, fonts, JBIG2, JPEG)</td>
 <td align="center">No</td></tr>
 
 <tr><td><strong>Dependencies</strong></td>
@@ -322,10 +328,14 @@ const bytes = await doc.save({
 ```ts
 import { signPdf, verifySignatures } from 'modern-pdf-lib';
 
-const signed = await signPdf(pdfBytes, {
-  certificate: certPem,
-  privateKey: keyPem,
+const signed = await signPdf(pdfBytes, 'Signature1', {
+  certificate: certDer,
+  privateKey: keyDer,
   reason: 'Approved',
+  appearance: {                    // optional visible signature
+    rect: [50, 50, 200, 80],
+    fontSize: 10,
+  },
 });
 
 const results = await verifySignatures(signed);
@@ -348,6 +358,38 @@ for (const item of items) {
 ```
 </details>
 
+<details>
+<summary><strong>Image Optimization</strong> &mdash; batch compress, deduplicate, CLI</summary>
+
+```ts
+import { loadPdf, initWasm, optimizeAllImages, deduplicateImages } from 'modern-pdf-lib';
+
+await initWasm({ jpeg: true });
+
+const doc = await loadPdf(pdfBytes);
+
+// Deduplicate identical images
+const dedupReport = deduplicateImages(doc);
+
+// Optimize all images (JPEG recompression)
+const report = await optimizeAllImages(doc, {
+  quality: 75,
+  progressive: true,
+  autoGrayscale: true,
+});
+
+console.log(`${report.optimizedImages}/${report.totalImages} images optimized`);
+console.log(`Savings: ${report.savings.toFixed(1)}%`);
+
+const optimized = await doc.save();
+```
+
+**CLI:**
+```sh
+npx modern-pdf optimize report.pdf report-opt.pdf --quality 60 --grayscale --dedup -v
+```
+</details>
+
 <details>
 <summary><strong>PDF/A & Accessibility</strong></summary>
 
@@ -399,6 +441,7 @@ await initWasm({
   deflate: true,   // Faster compression
   png: true,       // Faster PNG decoding
   fonts: true,     // Faster font subsetting
+  jpeg: true,      // JPEG encode/decode for image optimization
 });
 ```
 
@@ -409,6 +452,7 @@ await initWasm({
 | ttf | Font parsing & subsetting | ~3x |
 | shaping | Complex script layout | ~10x |
 | jbig2 | JBIG2 bilevel image decoding | ~3x |
+| jpeg | JPEG encode/decode for image optimization | Required |
 
 <br />
 
@@ -420,7 +464,7 @@ modern-pdf-lib/
     core/           PDF document model, objects, writer, pages
     parser/         PDF loading, text extraction, content streams
     form/           AcroForm fields (7 types) + appearances
-    annotation/     16 annotation types + appearance generators
+    annotation/     18 annotation types + appearance generators
     accessibility/  Structure tree, marked content, PDF/UA checker
     compliance/     PDF/A validation & enforcement
     signature/      PKCS#7 signatures, timestamps, verification
@@ -430,8 +474,9 @@ modern-pdf-lib/
     layers/         Optional content groups (OCG)
     outline/        Bookmarks / document outline
     metadata/       XMP metadata, viewer preferences
-    wasm/           Rust crate sources (5 modules)
-  tests/            2,199 tests across 100 suites
+    wasm/           Rust crate sources (6 modules)
+    cli/            CLI tool (modern-pdf optimize)
+  tests/            2,323 tests across 110 suites
   docs/             VitePress documentation
 ```
 
@@ -443,7 +488,7 @@ modern-pdf-lib/
 git clone https://github.com/ABCrimson/modern-pdf-lib.git
 cd modern-pdf-lib
 npm install
-npm test          # 2,199 tests
+npm test          # 2,323 tests
 npm run typecheck # TypeScript 6.0 strict
 npm run build     # ESM + CJS + declarations
 ```

package/dist/bridge-C7U4E7St.mjs

@@ -0,0 +1,103 @@
+import { t as __exportAll } from "./rolldown-runtime-95iHPtFO.mjs";
+
+//#region src/wasm/jpeg/bridge.ts
+var bridge_exports = /* @__PURE__ */ __exportAll({
+	decodeJpegWasm: () => decodeJpegWasm,
+	encodeJpegWasm: () => encodeJpegWasm,
+	initJpegWasm: () => initJpegWasm,
+	isJpegWasmReady: () => isJpegWasmReady
+});
+let wasmModule;
+/**
+* Initialize the JPEG WASM module.
+*
+* @param wasmSource - The WASM binary as `Uint8Array`, URL, `Response`,
+*                     or a pre-built wasm-bindgen module.  When omitted,
+*                     the function uses the universal WASM loader.
+*/
+async function initJpegWasm(wasmSource) {
+	if (wasmModule) return;
+	try {
+		if (wasmSource && typeof wasmSource.encode_jpeg === "function") {
+			wasmModule = wasmSource;
+			return;
+		}
+		const { loadWasmModule: loadWasm } = await import("./loader-1VJXLlMZ.mjs");
+		const wasmBytes = await loadWasm("jpeg");
+		wasmModule = (await WebAssembly.instantiate(wasmBytes.buffer, { env: {} })).instance.exports;
+	} catch {
+		wasmModule = void 0;
+	}
+}
+/**
+* Check whether the JPEG WASM module has been initialized.
+*
+* @returns `true` if {@link initJpegWasm} completed successfully.
+*/
+function isJpegWasmReady() {
+	return wasmModule !== void 0;
+}
+/**
+* Map a `ChromaSubsampling` string to the numeric code expected by WASM.
+* @internal
+*/
+function chromaToCode(chroma) {
+	switch (chroma) {
+		case "4:4:4": return 0;
+		case "4:2:2": return 1;
+		default: return 2;
+	}
+}
+/**
+* Encode raw pixel data to JPEG using the WASM encoder.
+*
+* @param pixels   - Raw pixel data (row-major, channel-interleaved).
+* @param width    - Image width in pixels.
+* @param height   - Image height in pixels.
+* @param channels - Number of channels: 1 (grayscale), 3 (RGB), or 4 (RGBA).
+* @param quality  - JPEG quality 1–100.
+* @param progressive - Encode as progressive JPEG (default: false).
+* @param chroma   - Chroma subsampling mode (default: '4:2:0').
+* @returns JPEG-encoded bytes, or `undefined` if WASM is not available.
+*/
+function encodeJpegWasm(pixels, width, height, channels, quality, progressive = false, chroma = "4:2:0") {
+	if (!wasmModule) return void 0;
+	try {
+		return wasmModule.encode_jpeg(pixels, width, height, channels, Math.max(1, Math.min(100, Math.round(quality))), progressive, chromaToCode(chroma));
+	} catch {
+		return;
+	}
+}
+/**
+* Decode JPEG bytes to raw pixel data using the WASM decoder.
+*
+* The WASM module returns a flat byte array with layout:
+* `[width_u32_le, height_u32_le, channels_u8, ...pixels]`.
+*
+* @param jpegBytes - JPEG-encoded image data.
+* @returns Decoded pixel data with metadata, or `undefined` if WASM is not
+*          available or decoding failed.
+*/
+function decodeJpegWasm(jpegBytes) {
+	if (!wasmModule) return void 0;
+	try {
+		const raw = wasmModule.decode_jpeg(jpegBytes);
+		if (raw.length < 9) return void 0;
+		const view = new DataView(raw.buffer, raw.byteOffset, raw.byteLength);
+		const width = view.getUint32(0, true);
+		const height = view.getUint32(4, true);
+		const channels = raw[8];
+		return {
+			pixels: raw.slice(9),
+			width,
+			height,
+			channels
+		};
+	} catch {
+		return;
+	}
+}
+
+//#endregion
+export { isJpegWasmReady as a, initJpegWasm as i, decodeJpegWasm as n, encodeJpegWasm as r, bridge_exports as t };
+//# sourceMappingURL=bridge-C7U4E7St.mjs.map

package/dist/bridge-DUcJFVsk.cjs

@@ -0,0 +1,132 @@
+const require_rolldown_runtime = require('./rolldown-runtime-CKhH4XqG.cjs');
+
+//#region src/wasm/jpeg/bridge.ts
+var bridge_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
+	decodeJpegWasm: () => decodeJpegWasm,
+	encodeJpegWasm: () => encodeJpegWasm,
+	initJpegWasm: () => initJpegWasm,
+	isJpegWasmReady: () => isJpegWasmReady
+});
+let wasmModule;
+/**
+* Initialize the JPEG WASM module.
+*
+* @param wasmSource - The WASM binary as `Uint8Array`, URL, `Response`,
+*                     or a pre-built wasm-bindgen module.  When omitted,
+*                     the function uses the universal WASM loader.
+*/
+async function initJpegWasm(wasmSource) {
+	if (wasmModule) return;
+	try {
+		if (wasmSource && typeof wasmSource.encode_jpeg === "function") {
+			wasmModule = wasmSource;
+			return;
+		}
+		const { loadWasmModule: loadWasm } = await Promise.resolve().then(() => require("./loader-CKlBOHma.cjs"));
+		const wasmBytes = await loadWasm("jpeg");
+		wasmModule = (await WebAssembly.instantiate(wasmBytes.buffer, { env: {} })).instance.exports;
+	} catch {
+		wasmModule = void 0;
+	}
+}
+/**
+* Check whether the JPEG WASM module has been initialized.
+*
+* @returns `true` if {@link initJpegWasm} completed successfully.
+*/
+function isJpegWasmReady() {
+	return wasmModule !== void 0;
+}
+/**
+* Map a `ChromaSubsampling` string to the numeric code expected by WASM.
+* @internal
+*/
+function chromaToCode(chroma) {
+	switch (chroma) {
+		case "4:4:4": return 0;
+		case "4:2:2": return 1;
+		default: return 2;
+	}
+}
+/**
+* Encode raw pixel data to JPEG using the WASM encoder.
+*
+* @param pixels   - Raw pixel data (row-major, channel-interleaved).
+* @param width    - Image width in pixels.
+* @param height   - Image height in pixels.
+* @param channels - Number of channels: 1 (grayscale), 3 (RGB), or 4 (RGBA).
+* @param quality  - JPEG quality 1–100.
+* @param progressive - Encode as progressive JPEG (default: false).
+* @param chroma   - Chroma subsampling mode (default: '4:2:0').
+* @returns JPEG-encoded bytes, or `undefined` if WASM is not available.
+*/
+function encodeJpegWasm(pixels, width, height, channels, quality, progressive = false, chroma = "4:2:0") {
+	if (!wasmModule) return void 0;
+	try {
+		return wasmModule.encode_jpeg(pixels, width, height, channels, Math.max(1, Math.min(100, Math.round(quality))), progressive, chromaToCode(chroma));
+	} catch {
+		return;
+	}
+}
+/**
+* Decode JPEG bytes to raw pixel data using the WASM decoder.
+*
+* The WASM module returns a flat byte array with layout:
+* `[width_u32_le, height_u32_le, channels_u8, ...pixels]`.
+*
+* @param jpegBytes - JPEG-encoded image data.
+* @returns Decoded pixel data with metadata, or `undefined` if WASM is not
+*          available or decoding failed.
+*/
+function decodeJpegWasm(jpegBytes) {
+	if (!wasmModule) return void 0;
+	try {
+		const raw = wasmModule.decode_jpeg(jpegBytes);
+		if (raw.length < 9) return void 0;
+		const view = new DataView(raw.buffer, raw.byteOffset, raw.byteLength);
+		const width = view.getUint32(0, true);
+		const height = view.getUint32(4, true);
+		const channels = raw[8];
+		return {
+			pixels: raw.slice(9),
+			width,
+			height,
+			channels
+		};
+	} catch {
+		return;
+	}
+}
+
+//#endregion
+Object.defineProperty(exports, 'bridge_exports', {
+  enumerable: true,
+  get: function () {
+    return bridge_exports;
+  }
+});
+Object.defineProperty(exports, 'decodeJpegWasm', {
+  enumerable: true,
+  get: function () {
+    return decodeJpegWasm;
+  }
+});
+Object.defineProperty(exports, 'encodeJpegWasm', {
+  enumerable: true,
+  get: function () {
+    return encodeJpegWasm;
+  }
+});
+Object.defineProperty(exports, 'initJpegWasm', {
+  enumerable: true,
+  get: function () {
+    return initJpegWasm;
+  }
+});
+Object.defineProperty(exports, 'isJpegWasmReady', {
+  enumerable: true,
+  get: function () {
+    return isJpegWasmReady;
+  }
+});
+//# sourceMappingURL=bridge-DUcJFVsk.cjs.map