modern-pdf-lib 0.26.0 → 0.28.1

package/README.md

@@ -15,8 +15,8 @@ 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-5%2C135_passing-brightgreen?style=flat-square)](#)
-[![TypeScript](https://img.shields.io/badge/TypeScript-6.0-3178c6?style=flat-square&logo=typescript&logoColor=white)](#)
+[![tests](https://img.shields.io/badge/tests-6%2C302_passing-brightgreen?style=flat-square)](#)
+[![TypeScript](https://img.shields.io/badge/TypeScript-7.0-3178c6?style=flat-square&logo=typescript&logoColor=white)](#)
 [![License: MIT](https://img.shields.io/badge/license-MIT-yellow?style=flat-square)](LICENSE)
 
 <br />
@@ -107,9 +107,11 @@ For environments without ES module support, use the IIFE bundle which exposes a
 - Automatic font subsetting
 - JPEG / PNG image embedding
 - Image optimization (JPEG recompression, dedup, grayscale)
-- RGB, CMYK, grayscale colors
+- RGB, CMYK, grayscale, spot, DeviceN colors
 - Linear & radial gradients, tiling patterns
 - Text layout (multiline, combed, auto-size)
+- Header/footer engine with templates
+- Advanced text layout (Knuth-Plass, hyphenation)
 
 </td>
 <td width="50%" valign="top">
@@ -137,7 +139,8 @@ For environments without ES module support, use the IIFE bundle which exposes a
 - PDF/A-1b through PDF/A-3u validation
 - Tagged PDF / PDF/UA accessibility
 - Structure tree & marked content
-- Redaction with content removal
+- Redaction with content removal & overlay
+- PDF/UA validation & auto-enforcement
 
 </td>
 <td width="50%" valign="top">
@@ -156,6 +159,8 @@ For environments without ES module support, use the IIFE bundle which exposes a
 - Linearization (fast web view)
 - Browser helpers (download, blob, data URL)
 - Service Worker & Web Worker support
+- Batch processing with memory pressure handling
+- Spot colors (Separation) & DeviceN
 - CLI: `npx modern-pdf optimize`
 
 </td>
@@ -182,7 +187,7 @@ For environments without ES module support, use the IIFE bundle which exposes a
 <td align="center">CJS (with ESM wrapper)</td></tr>
 
 <tr><td><strong>TypeScript</strong></td>
-<td align="center">6.0 strict</td>
+<td align="center">7.0 strict</td>
 <td align="center">3.x</td></tr>
 
 <tr><td><strong>Parse existing PDFs</strong></td>
@@ -269,6 +274,14 @@ For environments without ES module support, use the IIFE bundle which exposes a
 <td align="center">9 formats (QR, EAN, Code 128, PDF417…)</td>
 <td align="center">No</td></tr>
 
+<tr><td><strong>Spot / DeviceN colors</strong></td>
+<td align="center">Separation, multi-ink, conversion</td>
+<td align="center">No</td></tr>
+
+<tr><td><strong>Header / footer engine</strong></td>
+<td align="center">Templates, page numbers, dates</td>
+<td align="center">No</td></tr>
+
 <tr><td><strong>Table layout</strong></td>
 <td align="center">Spanning, pagination, presets, overflow</td>
 <td align="center">No</td></tr>
@@ -301,7 +314,7 @@ For environments without ES module support, use the IIFE bundle which exposes a
 
 | Runtime | Version | Status |
 |:---|:---|:---:|
-| **Node.js** | 25.7+ | Fully supported |
+| **Node.js** | 26.4+ | Fully supported |
 | **Deno** | 1.40+ | Fully supported |
 | **Bun** | 1.0+ | Fully supported |
 | **Cloudflare Workers** | &mdash; | Fully supported |
@@ -380,10 +393,11 @@ form.flatten(); // Burn values into page content
 <summary><strong>Merge & Split</strong></summary>
 
 ```ts
-import { mergePdfs, splitPdf, copyPages } from 'modern-pdf-lib';
+import { loadPdf, mergePdfs, splitPdf } from 'modern-pdf-lib';
 
-const merged = await mergePdfs([pdf1Bytes, pdf2Bytes]);
-const pages = await splitPdf(pdfBytes, [
+// mergePdfs / splitPdf operate on PdfDocument objects — load the bytes first.
+const merged = await mergePdfs([await loadPdf(pdf1Bytes), await loadPdf(pdf2Bytes)]);
+const pages = await splitPdf(await loadPdf(pdfBytes), [
   { start: 0, end: 4 },   // Pages 1-5
   { start: 5, end: 9 },   // Pages 6-10
 ]);
@@ -394,11 +408,13 @@ const pages = await splitPdf(pdfBytes, [
 <summary><strong>Encryption</strong> &mdash; AES-256, RC4, permissions</summary>
 
 ```ts
-const bytes = await doc.save({
+// Configure encryption with doc.encrypt(), then save().
+await doc.encrypt({
   userPassword: 'reader',
   ownerPassword: 'admin',
   permissions: { printing: true, copying: false },
 });
+const bytes = await doc.save();
 ```
 </details>
 
@@ -426,11 +442,12 @@ const results = await verifySignatures(signed);
 <summary><strong>Text Extraction</strong></summary>
 
 ```ts
-import { loadPdf, extractTextWithPositions } from 'modern-pdf-lib';
+import { loadPdf, parseContentStream, extractTextWithPositions } from 'modern-pdf-lib';
 
 const doc = await loadPdf(pdfBytes);
 const page = doc.getPage(0);
-const items = extractTextWithPositions(page.getOperators(), page.getResources());
+const operators = parseContentStream(page.getContentStream());
+const items = extractTextWithPositions(operators);
 
 for (const item of items) {
   console.log(`"${item.text}" at (${item.x}, ${item.y})`);
@@ -511,7 +528,7 @@ page.drawQrCode('https://example.com', { x: 50, y: 700, size: 120 });
 import { encodeCode128, encodeEan13, renderStyledBarcode } from 'modern-pdf-lib';
 
 const barcode = encodeCode128('ABC-12345');
-const ops = renderStyledBarcode(barcode, { x: 50, y: 500, height: 60 });
+const ops = renderStyledBarcode(barcode, 50, 500, 'ABC-12345', { height: 60 });
 ```
 </details>
 
@@ -604,7 +621,7 @@ modern-pdf-lib/
     metadata/       XMP metadata, viewer preferences
     wasm/           Rust crate sources (6 modules)
     cli/            CLI tool (modern-pdf optimize)
-  tests/            4,282 tests across 199 suites
+  tests/            6,302 tests across 265 suites
   docs/             VitePress documentation
 ```
 
@@ -616,8 +633,8 @@ modern-pdf-lib/
 git clone https://github.com/ABCrimson/modern-pdf-lib.git
 cd modern-pdf-lib
 npm install
-npm test          # 4,282 tests
-npm run typecheck # TypeScript 6.0 strict
+npm test          # 6,302 tests
+npm run typecheck # TypeScript 7.0 strict
 npm run build     # ESM + CJS + declarations
 ```
 

package/dist/{batchOptimize-C1W3O68Q.cjs → batchOptimize-Ba5ehwoI.cjs}

@@ -1,8 +1,7 @@
-const require_rolldown_runtime = require('./rolldown-runtime-CKhH4XqG.cjs');
-const require_pdfObjects = require('./pdfObjects-1veop1_d.cjs');
-const require_imageExtract = require('./imageExtract-zEb1gnkb.cjs');
-const require_grayscaleDetect = require('./grayscaleDetect-C2m-eEXR.cjs');
-
+const require_rolldown_runtime = require("./rolldown-runtime-ak5kbic3.cjs");
+const require_pdfObjects = require("./pdfObjects-BcPlSI0a.cjs");
+const require_imageExtract = require("./imageExtract-DQomHJiA.cjs");
+const require_grayscaleDetect = require("./grayscaleDetect-DAUqxjgR.cjs");
 //#region src/assets/image/iccProfile.ts
 /**
 * @module assets/image/iccProfile
@@ -90,13 +89,14 @@ function parseIccDescription(data) {
 		if (descLen === 0) return void 0;
 		const strEnd = Math.min(tagOffset + 12 + descLen - 1, tagOffset + tagSize);
 		if (strEnd <= tagOffset + 12) return void 0;
-		const chars = [];
-		for (let j = tagOffset + 12; j < strEnd; j++) {
-			const c = data[j];
-			if (c === 0) break;
-			chars.push(String.fromCharCode(c));
+		let nullIdx = strEnd;
+		for (let j = tagOffset + 12; j < strEnd; j++) if (data[j] === 0) {
+			nullIdx = j;
+			break;
 		}
-		return chars.length > 0 ? chars.join("") : void 0;
+		const strBytes = data.subarray(tagOffset + 12, nullIdx);
+		if (strBytes.length === 0) return void 0;
+		return new TextDecoder("ascii").decode(strBytes);
 	}
 }
 /**
@@ -197,7 +197,6 @@ function embedIccProfile(profile, registry) {
 	const stream = new require_pdfObjects.PdfStream(dict, profile.data);
 	return registry.register(stream);
 }
-
 //#endregion
 //#region src/assets/image/batchOptimize.ts
 var batchOptimize_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ optimizeAllImages: () => optimizeAllImages });
@@ -255,8 +254,8 @@ async function optimizeAllImages(doc, options = {}) {
 	const chromaSubsampling = options.chromaSubsampling ?? "4:2:0";
 	const concurrency = Math.max(1, options.concurrency ?? 1);
 	const { pageRange, minImageSize, colorSpaces, namePattern } = options;
-	const { encodeJpegWasm, isJpegWasmReady } = await Promise.resolve().then(() => require("./bridge-DMEuGtfn.cjs")).then((n) => n.bridge_exports);
-	const { decodeJpegWasm } = await Promise.resolve().then(() => require("./bridge-DMEuGtfn.cjs")).then((n) => n.bridge_exports);
+	const { encodeJpegWasm, isJpegWasmReady } = await Promise.resolve().then(() => require("./bridge-ByvzPu5h.cjs")).then((n) => n.bridge_exports);
+	const { decodeJpegWasm } = await Promise.resolve().then(() => require("./bridge-ByvzPu5h.cjs")).then((n) => n.bridge_exports);
 	const images = require_imageExtract.extractImages(doc);
 	const registry = doc.getRegistry();
 	const results = new Array(images.length);
@@ -302,15 +301,16 @@ async function optimizeAllImages(doc, options = {}) {
 		const expectedLen = img.width * img.height * channels;
 		if (pixels.length !== expectedLen) return skip(false, `Pixel data length mismatch: got ${pixels.length}, expected ${expectedLen}`);
 		if (channels === 4 && img.colorSpace === "DeviceCMYK") {
-			const rgb = new Uint8Array(img.width * img.height * 3);
-			for (let i = 0; i < img.width * img.height; i++) {
-				const c = pixels[i * 4] / 255;
-				const m = pixels[i * 4 + 1] / 255;
-				const y = pixels[i * 4 + 2] / 255;
-				const k = pixels[i * 4 + 3] / 255;
-				rgb[i * 3] = Math.round(255 * (1 - c) * (1 - k));
-				rgb[i * 3 + 1] = Math.round(255 * (1 - m) * (1 - k));
-				rgb[i * 3 + 2] = Math.round(255 * (1 - y) * (1 - k));
+			const pixelCount = img.width * img.height;
+			const rgb = new Uint8Array(pixelCount * 3);
+			for (let i = 0; i < pixelCount; i++) {
+				const ci = 255 - pixels[i * 4];
+				const mi = 255 - pixels[i * 4 + 1];
+				const yi = 255 - pixels[i * 4 + 2];
+				const ki = 255 - pixels[i * 4 + 3];
+				rgb[i * 3] = (ci * ki + 127) / 255 | 0;
+				rgb[i * 3 + 1] = (mi * ki + 127) / 255 | 0;
+				rgb[i * 3 + 2] = (yi * ki + 127) / 255 | 0;
 			}
 			pixels = rgb;
 			channels = 3;
@@ -386,42 +386,42 @@ async function optimizeAllImages(doc, options = {}) {
 		perImage: results
 	};
 }
-
 //#endregion
-Object.defineProperty(exports, 'batchOptimize_exports', {
-  enumerable: true,
-  get: function () {
-    return batchOptimize_exports;
-  }
+Object.defineProperty(exports, "batchOptimize_exports", {
+	enumerable: true,
+	get: function() {
+		return batchOptimize_exports;
+	}
 });
-Object.defineProperty(exports, 'embedIccProfile', {
-  enumerable: true,
-  get: function () {
-    return embedIccProfile;
-  }
+Object.defineProperty(exports, "embedIccProfile", {
+	enumerable: true,
+	get: function() {
+		return embedIccProfile;
+	}
 });
-Object.defineProperty(exports, 'extractIccProfile', {
-  enumerable: true,
-  get: function () {
-    return extractIccProfile;
-  }
+Object.defineProperty(exports, "extractIccProfile", {
+	enumerable: true,
+	get: function() {
+		return extractIccProfile;
+	}
 });
-Object.defineProperty(exports, 'optimizeAllImages', {
-  enumerable: true,
-  get: function () {
-    return optimizeAllImages;
-  }
+Object.defineProperty(exports, "optimizeAllImages", {
+	enumerable: true,
+	get: function() {
+		return optimizeAllImages;
+	}
 });
-Object.defineProperty(exports, 'parseIccColorSpace', {
-  enumerable: true,
-  get: function () {
-    return parseIccColorSpace;
-  }
+Object.defineProperty(exports, "parseIccColorSpace", {
+	enumerable: true,
+	get: function() {
+		return parseIccColorSpace;
+	}
 });
-Object.defineProperty(exports, 'parseIccDescription', {
-  enumerable: true,
-  get: function () {
-    return parseIccDescription;
-  }
+Object.defineProperty(exports, "parseIccDescription", {
+	enumerable: true,
+	get: function() {
+		return parseIccDescription;
+	}
 });
-//# sourceMappingURL=batchOptimize-C1W3O68Q.cjs.map
+
+//# sourceMappingURL=batchOptimize-Ba5ehwoI.cjs.map

package/dist/{batchOptimize-BCJEEN8J.mjs → batchOptimize-KB1k9LFg.mjs}

@@ -1,8 +1,7 @@
-import { Gs as __exportAll } from "./index-B4S61WjK.d.mts";
-import { i as PdfName, l as PdfStream, o as PdfNumber, r as PdfDict, t as PdfArray } from "./pdfObjects-uEsWlfzU.mjs";
-import { n as extractImages, t as decodeImageStream } from "./imageExtract-Dnk_Ssv7.mjs";
-import { n as isGrayscaleImage, t as convertToGrayscale } from "./grayscaleDetect-C6kFF3dk.mjs";
-
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { i as PdfName, l as PdfStream, o as PdfNumber, r as PdfDict, t as PdfArray } from "./pdfObjects-CB7TEdbW.mjs";
+import { n as extractImages, t as decodeImageStream } from "./imageExtract-DV-zq4h3.mjs";
+import { n as isGrayscaleImage, t as convertToGrayscale } from "./grayscaleDetect-6GJrgBRT.mjs";
 //#region src/assets/image/iccProfile.ts
 /**
 * @module assets/image/iccProfile
@@ -90,13 +89,14 @@ function parseIccDescription(data) {
 		if (descLen === 0) return void 0;
 		const strEnd = Math.min(tagOffset + 12 + descLen - 1, tagOffset + tagSize);
 		if (strEnd <= tagOffset + 12) return void 0;
-		const chars = [];
-		for (let j = tagOffset + 12; j < strEnd; j++) {
-			const c = data[j];
-			if (c === 0) break;
-			chars.push(String.fromCharCode(c));
+		let nullIdx = strEnd;
+		for (let j = tagOffset + 12; j < strEnd; j++) if (data[j] === 0) {
+			nullIdx = j;
+			break;
 		}
-		return chars.length > 0 ? chars.join("") : void 0;
+		const strBytes = data.subarray(tagOffset + 12, nullIdx);
+		if (strBytes.length === 0) return void 0;
+		return new TextDecoder("ascii").decode(strBytes);
 	}
 }
 /**
@@ -197,7 +197,6 @@ function embedIccProfile(profile, registry) {
 	const stream = new PdfStream(dict, profile.data);
 	return registry.register(stream);
 }
-
 //#endregion
 //#region src/assets/image/batchOptimize.ts
 var batchOptimize_exports = /* @__PURE__ */ __exportAll({ optimizeAllImages: () => optimizeAllImages });
@@ -255,8 +254,8 @@ async function optimizeAllImages(doc, options = {}) {
 	const chromaSubsampling = options.chromaSubsampling ?? "4:2:0";
 	const concurrency = Math.max(1, options.concurrency ?? 1);
 	const { pageRange, minImageSize, colorSpaces, namePattern } = options;
-	const { encodeJpegWasm, isJpegWasmReady } = await import("./bridge-DaS-gzEd.mjs").then((n) => n.t);
-	const { decodeJpegWasm } = await import("./bridge-DaS-gzEd.mjs").then((n) => n.t);
+	const { encodeJpegWasm, isJpegWasmReady } = await import("./bridge-7dhURZj7.mjs").then((n) => n.t);
+	const { decodeJpegWasm } = await import("./bridge-7dhURZj7.mjs").then((n) => n.t);
 	const images = extractImages(doc);
 	const registry = doc.getRegistry();
 	const results = new Array(images.length);
@@ -302,15 +301,16 @@ async function optimizeAllImages(doc, options = {}) {
 		const expectedLen = img.width * img.height * channels;
 		if (pixels.length !== expectedLen) return skip(false, `Pixel data length mismatch: got ${pixels.length}, expected ${expectedLen}`);
 		if (channels === 4 && img.colorSpace === "DeviceCMYK") {
-			const rgb = new Uint8Array(img.width * img.height * 3);
-			for (let i = 0; i < img.width * img.height; i++) {
-				const c = pixels[i * 4] / 255;
-				const m = pixels[i * 4 + 1] / 255;
-				const y = pixels[i * 4 + 2] / 255;
-				const k = pixels[i * 4 + 3] / 255;
-				rgb[i * 3] = Math.round(255 * (1 - c) * (1 - k));
-				rgb[i * 3 + 1] = Math.round(255 * (1 - m) * (1 - k));
-				rgb[i * 3 + 2] = Math.round(255 * (1 - y) * (1 - k));
+			const pixelCount = img.width * img.height;
+			const rgb = new Uint8Array(pixelCount * 3);
+			for (let i = 0; i < pixelCount; i++) {
+				const ci = 255 - pixels[i * 4];
+				const mi = 255 - pixels[i * 4 + 1];
+				const yi = 255 - pixels[i * 4 + 2];
+				const ki = 255 - pixels[i * 4 + 3];
+				rgb[i * 3] = (ci * ki + 127) / 255 | 0;
+				rgb[i * 3 + 1] = (mi * ki + 127) / 255 | 0;
+				rgb[i * 3 + 2] = (yi * ki + 127) / 255 | 0;
 			}
 			pixels = rgb;
 			channels = 3;
@@ -386,7 +386,7 @@ async function optimizeAllImages(doc, options = {}) {
 		perImage: results
 	};
 }
-
 //#endregion
 export { parseIccColorSpace as a, extractIccProfile as i, optimizeAllImages as n, parseIccDescription as o, embedIccProfile as r, batchOptimize_exports as t };
-//# sourceMappingURL=batchOptimize-BCJEEN8J.mjs.map
+
+//# sourceMappingURL=batchOptimize-KB1k9LFg.mjs.map

package/dist/{bridge-DaS-gzEd.mjs → bridge-7dhURZj7.mjs}

@@ -1,5 +1,4 @@
-import { Gs as __exportAll } from "./index-B4S61WjK.d.mts";
-
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
 //#region src/wasm/jpeg/bridge.ts
 var bridge_exports = /* @__PURE__ */ __exportAll({
 	decodeJpegWasm: () => decodeJpegWasm,
@@ -22,7 +21,7 @@ async function initJpegWasm(wasmSource) {
 			wasmModule = wasmSource;
 			return;
 		}
-		const { loadWasmModule: loadWasm } = await import("./loader-CVB-c_3Z.mjs").then((n) => n.l);
+		const { loadWasmModule: loadWasm } = await import("./loader-DkrXz-h4.mjs").then((n) => n.l);
 		const wasmBytes = await loadWasm("jpeg");
 		wasmModule = (await WebAssembly.instantiate(wasmBytes.buffer, { env: {} })).instance.exports;
 	} catch {
@@ -97,7 +96,7 @@ function decodeJpegWasm(jpegBytes) {
 		return;
 	}
 }
-
 //#endregion
 export { isJpegWasmReady as a, initJpegWasm as i, decodeJpegWasm as n, encodeJpegWasm as r, bridge_exports as t };
-//# sourceMappingURL=bridge-DaS-gzEd.mjs.map
+
+//# sourceMappingURL=bridge-7dhURZj7.mjs.map

package/dist/{bridge-DMEuGtfn.cjs → bridge-ByvzPu5h.cjs}

@@ -1,7 +1,5 @@
-const require_rolldown_runtime = require('./rolldown-runtime-CKhH4XqG.cjs');
-
 //#region src/wasm/jpeg/bridge.ts
-var bridge_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
+var bridge_exports = /* @__PURE__ */ require("./rolldown-runtime-ak5kbic3.cjs").__exportAll({
 	decodeJpegWasm: () => decodeJpegWasm,
 	encodeJpegWasm: () => encodeJpegWasm,
 	initJpegWasm: () => initJpegWasm,
@@ -22,7 +20,7 @@ async function initJpegWasm(wasmSource) {
 			wasmModule = wasmSource;
 			return;
 		}
-		const { loadWasmModule: loadWasm } = await Promise.resolve().then(() => require("./loader-DYCH3n7d.cjs")).then((n) => n.loader_exports);
+		const { loadWasmModule: loadWasm } = await Promise.resolve().then(() => require("./loader-DR7H0XOf.cjs")).then((n) => n.loader_exports);
 		const wasmBytes = await loadWasm("jpeg");
 		wasmModule = (await WebAssembly.instantiate(wasmBytes.buffer, { env: {} })).instance.exports;
 	} catch {
@@ -97,36 +95,36 @@ function decodeJpegWasm(jpegBytes) {
 		return;
 	}
 }
-
 //#endregion
-Object.defineProperty(exports, 'bridge_exports', {
-  enumerable: true,
-  get: function () {
-    return bridge_exports;
-  }
+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, "decodeJpegWasm", {
+	enumerable: true,
+	get: function() {
+		return decodeJpegWasm;
+	}
 });
-Object.defineProperty(exports, 'encodeJpegWasm', {
-  enumerable: true,
-  get: function () {
-    return encodeJpegWasm;
-  }
+Object.defineProperty(exports, "encodeJpegWasm", {
+	enumerable: true,
+	get: function() {
+		return encodeJpegWasm;
+	}
 });
-Object.defineProperty(exports, 'initJpegWasm', {
-  enumerable: true,
-  get: function () {
-    return initJpegWasm;
-  }
+Object.defineProperty(exports, "initJpegWasm", {
+	enumerable: true,
+	get: function() {
+		return initJpegWasm;
+	}
 });
-Object.defineProperty(exports, 'isJpegWasmReady', {
-  enumerable: true,
-  get: function () {
-    return isJpegWasmReady;
-  }
+Object.defineProperty(exports, "isJpegWasmReady", {
+	enumerable: true,
+	get: function() {
+		return isJpegWasmReady;
+	}
 });
-//# sourceMappingURL=bridge-DMEuGtfn.cjs.map
+
+//# sourceMappingURL=bridge-ByvzPu5h.cjs.map