pdf-codec 3.2.0 → 3.3.1

package/README.md

@@ -87,6 +87,8 @@ An encrypted PDF that opens without a password decrypts transparently — no ext
 
 Both accept an optional `signal` (`AbortSignal`); `readPdf` additionally takes a `sink` (`PdfDiagnosticSink`, called once per recoverable parse diagnostic — see the three-tier failure policy under [Conventions](#conventions)), and `writePdf` an `onSubstitution` callback (called once per character not representable in a standard-14 font — see [Fidelity](#fidelity)).
 
+**Page boundaries: the crop box is the visible region** (ISO 32000-1 14.11.2). A page's reported `widthPt`/`heightPt` and coordinate frame come from its effective `/CropBox` — the rectangle a viewer displays and prints, inherited through the page tree like `/MediaBox` and defaulting to it — not from the media box: content an author placed outside the crop box (printer's marks, bleed, off-page slugs) is not visible and does not extract. Content wholly outside the crop box is dropped; content straddling the boundary keeps its original unclipped geometry (the item layer records what the file states — a viewer's clipping is a rendering fact, not source data); link annotations are anchored constructs rather than painted content and are never filtered, the same line the optional-content filter draws. The declared boundary rectangles a distinct crop box hides — plus `/BleedBox`/`/TrimBox`/`/ArtBox`, print-production facts with no field in the layout model — are quarantined verbatim as the `page-boxes` package-level residue row rather than silently dropped. A degenerate `/CropBox` (zero width or height) falls back to the media box with a `pdf/invalid-crop-box` warning.
+
 **Cancellation granularity and cost, for CPU-metered runtimes.** Both pipelines are synchronous end to end — there is no `await` point for cancellation to hook into implicitly — so the `signal` is checked explicitly, once per page-loop iteration (and once before `readPdf`'s document-open phase begins). A signal aborted mid-parse therefore takes effect at the next page boundary, not instantly: `readPdf`'s document-open phase (cross-reference resolution, object parsing) and a single page's content-stream interpretation are the two spans that cannot be interrupted, and a document consisting of one enormous page is effectively uninterruptible however many pages it claims. Cost is roughly linear in decompressed content length, so budget for the worst single page, not the page count. On Cloudflare Workers this is the honest shape of the trade: the parse holds the isolate for its whole duration with no opportunity to yield or report progress, and an `AbortSignal` shared with whatever can abort concurrently (a binding, another context) makes a deadline enforceable at page granularity — but it cannot convert a synchronous parse into a resumable one. An async page-at-a-time API is a deliberate non-goal of this package's current surface.
 
 The same round trip is also available as a schema-validated [`z.codec()`](https://zod.dev) pair:

package/dist/read.cjs

@@ -53,10 +53,15 @@ function readPdf(bytes, options) {
 	const optionalContent = require_optional_content.readOptionalContent(doc.catalog, doc, sink);
 	const form = require_form.readAcroForm(doc.catalog, doc, (obj) => doc.pageIndex(obj), sink);
 	const source = readDocumentResidue(doc, sink);
-	const pages = pageDicts.map((pageDict) => {
+	const pageBoxRows = [];
+	const pages = pageDicts.map((pageDict, index) => {
 		require_util_abort.throwIfAborted(signal);
-		return readPage(pageDict, doc, fontResolver, images, imageIdCache, destinationRegistry, optionalContent.layerNameOf, sink);
+		return readPage(index, pageDict, doc, fontResolver, images, imageIdCache, destinationRegistry, optionalContent.layerNameOf, pageBoxRows, sink);
 	});
+	if (pageBoxRows.length > 0) source["page-boxes"] = {
+		format: "pdf",
+		xml: require_serialize.serializeObjectToText(require_objects.pdfArray(pageBoxRows))
+	};
 	return {
 		formatVersion: 1,
 		metadata: readMetadata(doc.trailer, doc, doc.catalog, sink),
@@ -70,18 +75,13 @@ function readPdf(bytes, options) {
 		...Object.keys(source).length > 0 ? { source } : {}
 	};
 }
-function readMediaBox(page) {
-	const arr = require_objects.asArray(require_objects.dictGet(page, "MediaBox"));
-	if (arr === void 0) return {
-		llx: 0,
-		lly: 0,
-		urx: DEFAULT_PAGE_WIDTH_PT,
-		ury: DEFAULT_PAGE_HEIGHT_PT
-	};
+function readDeclaredPageBox(page, key) {
+	const arr = require_objects.asArray(require_objects.dictGet(page, key));
+	if (arr === void 0) return;
 	const a = require_objects.asNumber(arr[0]) ?? 0;
 	const b = require_objects.asNumber(arr[1]) ?? 0;
-	const c = require_objects.asNumber(arr[2]) ?? DEFAULT_PAGE_WIDTH_PT;
-	const d = require_objects.asNumber(arr[3]) ?? DEFAULT_PAGE_HEIGHT_PT;
+	const c = require_objects.asNumber(arr[2]) ?? 0;
+	const d = require_objects.asNumber(arr[3]) ?? 0;
 	return {
 		llx: Math.min(a, c),
 		lly: Math.min(b, d),
@@ -89,6 +89,33 @@ function readMediaBox(page) {
 		ury: Math.max(b, d)
 	};
 }
+function readMediaBox(page) {
+	return readDeclaredPageBox(page, "MediaBox") ?? {
+		llx: 0,
+		lly: 0,
+		urx: DEFAULT_PAGE_WIDTH_PT,
+		ury: DEFAULT_PAGE_HEIGHT_PT
+	};
+}
+function rotatedRectBounds(rect, matrix) {
+	const transformed = [
+		[rect.llx, rect.lly],
+		[rect.urx, rect.lly],
+		[rect.llx, rect.ury],
+		[rect.urx, rect.ury]
+	].map(([x, y]) => require_matrix.applyMatrix(matrix, {
+		x,
+		y
+	}));
+	const xs = transformed.map((point) => point.x);
+	const ys = transformed.map((point) => point.y);
+	return {
+		minX: Math.min(...xs),
+		minY: Math.min(...ys),
+		maxX: Math.max(...xs),
+		maxY: Math.max(...ys)
+	};
+}
 function normalizeRotation(rotate) {
 	if (rotate === void 0) return 0;
 	const normalized = (Math.round(rotate / 90) * 90 % 360 + 360) % 360;
@@ -157,11 +184,114 @@ function readPageContentBytes(page, resolver, sink) {
 	}
 	return /* @__PURE__ */ new Uint8Array(0);
 }
-function readPage(page, resolver, fontResolver, images, imageIdCache, destinationRegistry, layerNameOf, sink) {
+function contentItemBounds(item) {
+	if (item.kind === "link" || item.kind === "internalLink") return;
+	const frameBounds = (xPt, yPt, widthPt, heightPt) => ({
+		minX: xPt,
+		minY: yPt,
+		maxX: xPt + widthPt,
+		maxY: yPt + heightPt
+	});
+	if (item.kind === "text" || item.kind === "image" || item.kind === "rect" || item.kind === "ellipse") {
+		if (item.kind !== "text" || item.rotationDeg === void 0 || item.rotationDeg % 180 === 0) return frameBounds(item.xPt, item.yPt, item.widthPt ?? 0, item.kind === "text" ? item.sizePt : item.heightPt);
+		const rotationDeg = item.rotationDeg;
+		const anchorX = item.xPt;
+		const anchorY = item.yPt;
+		const rotated = [
+			[0, 0],
+			[item.widthPt ?? 0, 0],
+			[0, item.sizePt],
+			[item.widthPt ?? 0, item.sizePt]
+		].map(([dx, dy]) => require_matrix.rotatePointAboutCenter({
+			x: anchorX + dx,
+			y: anchorY + dy
+		}, {
+			x: anchorX,
+			y: anchorY
+		}, rotationDeg));
+		const xs = rotated.map((point) => point.x);
+		const ys = rotated.map((point) => point.y);
+		return {
+			minX: Math.min(...xs),
+			minY: Math.min(...ys),
+			maxX: Math.max(...xs),
+			maxY: Math.max(...ys)
+		};
+	}
+	if (item.kind === "line") return {
+		minX: Math.min(item.x1Pt, item.x2Pt),
+		minY: Math.min(item.y1Pt, item.y2Pt),
+		maxX: Math.max(item.x1Pt, item.x2Pt),
+		maxY: Math.max(item.y1Pt, item.y2Pt)
+	};
+	let minX = Number.POSITIVE_INFINITY;
+	let minY = Number.POSITIVE_INFINITY;
+	let maxX = Number.NEGATIVE_INFINITY;
+	let maxY = Number.NEGATIVE_INFINITY;
+	const include = (x, y) => {
+		minX = Math.min(minX, x);
+		minY = Math.min(minY, y);
+		maxX = Math.max(maxX, x);
+		maxY = Math.max(maxY, y);
+	};
+	for (const subpath of item.subpaths) {
+		include(subpath.startXPt, subpath.startYPt);
+		for (const segment of subpath.segments) {
+			include(segment.xPt, segment.yPt);
+			if (segment.kind === "cubic") {
+				include(segment.c1xPt, segment.c1yPt);
+				include(segment.c2xPt, segment.c2yPt);
+			}
+		}
+	}
+	return {
+		minX,
+		minY,
+		maxX,
+		maxY
+	};
+}
+function itemIntersectsVisibleRegion(item, widthPt, heightPt) {
+	if (item.kind === "link" || item.kind === "internalLink") return true;
+	const bounds = contentItemBounds(item);
+	if (bounds === void 0) return true;
+	return bounds.maxX >= 0 && bounds.minX <= widthPt && bounds.maxY >= 0 && bounds.minY <= heightPt;
+}
+function pageBoxResidueEntry(pageIndex, page, mediaBox, cropBox) {
+	const declaredBoxes = [
+		["MediaBox", require_objects.dictGet(page, "MediaBox")],
+		["CropBox", require_objects.dictGet(page, "CropBox")],
+		["BleedBox", require_objects.dictGet(page, "BleedBox")],
+		["TrimBox", require_objects.dictGet(page, "TrimBox")],
+		["ArtBox", require_objects.dictGet(page, "ArtBox")]
+	];
+	const cropDeclared = require_objects.dictGet(page, "CropBox") !== void 0;
+	const productionBoxDeclared = declaredBoxes.slice(2).some(([, value]) => value !== void 0);
+	if (!(cropDeclared && (cropBox.llx !== mediaBox.llx || cropBox.lly !== mediaBox.lly || cropBox.urx !== mediaBox.urx || cropBox.ury !== mediaBox.ury)) && !productionBoxDeclared) return;
+	const entries = { Page: require_objects.pdfNum(pageIndex) };
+	for (const [key, value] of declaredBoxes) if (value !== void 0) entries[key] = value;
+	return require_objects.pdfDict(entries);
+}
+function readPage(pageIndex, page, resolver, fontResolver, images, imageIdCache, destinationRegistry, layerNameOf, pageBoxRows, sink) {
 	const resources = resolver.resolveDict(require_objects.dictGet(page, "Resources"));
 	const mediaBox = readMediaBox(page);
+	let cropBox = readDeclaredPageBox(page, "CropBox") ?? mediaBox;
+	if (cropBox.urx - cropBox.llx <= 0 || cropBox.ury - cropBox.lly <= 0) {
+		sink({
+			code: "pdf/invalid-crop-box",
+			severity: "warning",
+			pageIndex,
+			message: "page /CropBox is degenerate (zero width or height); falling back to the /MediaBox as the visible region"
+		});
+		cropBox = mediaBox;
+	}
 	const rotationResult = pageRotationTransform(normalizeRotation(require_objects.asNumber(require_objects.dictGet(page, "Rotate"))), mediaBox.urx - mediaBox.llx, mediaBox.ury - mediaBox.lly);
-	const pageMatrix = require_matrix.multiplyMatrices(require_matrix.translationMatrix(-mediaBox.llx, -mediaBox.lly), rotationResult.matrix);
+	const visibleRect = rotatedRectBounds(cropBox, rotationResult.matrix);
+	const widthPt = visibleRect.maxX - visibleRect.minX;
+	const heightPt = visibleRect.maxY - visibleRect.minY;
+	const pageMatrix = require_matrix.multiplyMatrices(rotationResult.matrix, require_matrix.translationMatrix(-visibleRect.minX, -visibleRect.minY));
+	const boxRow = pageBoxResidueEntry(pageIndex, page, mediaBox, cropBox);
+	if (boxRow !== void 0) pageBoxRows.push(boxRow);
 	const items = [];
 	if (resources !== void 0) {
 		const contentBytes = readPageContentBytes(page, resolver, sink);
@@ -173,7 +303,7 @@ function readPage(page, resolver, fontResolver, images, imageIdCache, destinatio
 		});
 		for (const item of extracted) {
 			const converted = convertExtractedItem(item, pageMatrix, fontResolver, images, imageIdCache, resolver, sink);
-			if (converted !== void 0) items.push(converted);
+			if (converted !== void 0 && itemIntersectsVisibleRegion(converted, widthPt, heightPt)) items.push(converted);
 		}
 	} else sink({
 		code: "pdf/object-missing-value",
@@ -184,8 +314,8 @@ function readPage(page, resolver, fontResolver, images, imageIdCache, destinatio
 	const notes = readPageNotes(page, resolver);
 	const annotations = require_annotations.readPageAnnotations(page, pageMatrix, resolver, sink);
 	return {
-		widthPt: rotationResult.widthPt,
-		heightPt: rotationResult.heightPt,
+		widthPt,
+		heightPt,
 		items,
 		...notes !== void 0 ? { notes } : {},
 		...annotations.length > 0 ? { annotations } : {}

package/dist/read.js

@@ -1,9 +1,9 @@
 import "./notes-annotation-author.js";
-import { asArray, asName, asNumber, dictGet, pdfArray, pdfNull } from "./objects.js";
+import { asArray, asName, asNumber, dictGet, pdfArray, pdfDict, pdfNull, pdfNum } from "./objects.js";
 import { decodePdfString, parsePdfDate } from "./pdf-text.js";
 import { concatBytes } from "./bytes/writer.js";
 import { serializeObjectToText } from "./serialize.js";
-import { applyMatrix, matrixRotationDegrees, matrixScaleX, matrixScaleY, multiplyMatrices, translationMatrix } from "./matrix.js";
+import { applyMatrix, matrixRotationDegrees, matrixScaleX, matrixScaleY, multiplyMatrices, rotatePointAboutCenter, translationMatrix } from "./matrix.js";
 import { readPageAnnotations } from "./annotations.js";
 import { decodeStream } from "./filters.js";
 import { bytesToBase64 } from "./util/base64.js";
@@ -52,10 +52,15 @@ function readPdf(bytes, options) {
 	const optionalContent = readOptionalContent(doc.catalog, doc, sink);
 	const form = readAcroForm(doc.catalog, doc, (obj) => doc.pageIndex(obj), sink);
 	const source = readDocumentResidue(doc, sink);
-	const pages = pageDicts.map((pageDict) => {
+	const pageBoxRows = [];
+	const pages = pageDicts.map((pageDict, index) => {
 		throwIfAborted(signal);
-		return readPage(pageDict, doc, fontResolver, images, imageIdCache, destinationRegistry, optionalContent.layerNameOf, sink);
+		return readPage(index, pageDict, doc, fontResolver, images, imageIdCache, destinationRegistry, optionalContent.layerNameOf, pageBoxRows, sink);
 	});
+	if (pageBoxRows.length > 0) source["page-boxes"] = {
+		format: "pdf",
+		xml: serializeObjectToText(pdfArray(pageBoxRows))
+	};
 	return {
 		formatVersion: 1,
 		metadata: readMetadata(doc.trailer, doc, doc.catalog, sink),
@@ -69,18 +74,13 @@ function readPdf(bytes, options) {
 		...Object.keys(source).length > 0 ? { source } : {}
 	};
 }
-function readMediaBox(page) {
-	const arr = asArray(dictGet(page, "MediaBox"));
-	if (arr === void 0) return {
-		llx: 0,
-		lly: 0,
-		urx: DEFAULT_PAGE_WIDTH_PT,
-		ury: DEFAULT_PAGE_HEIGHT_PT
-	};
+function readDeclaredPageBox(page, key) {
+	const arr = asArray(dictGet(page, key));
+	if (arr === void 0) return;
 	const a = asNumber(arr[0]) ?? 0;
 	const b = asNumber(arr[1]) ?? 0;
-	const c = asNumber(arr[2]) ?? DEFAULT_PAGE_WIDTH_PT;
-	const d = asNumber(arr[3]) ?? DEFAULT_PAGE_HEIGHT_PT;
+	const c = asNumber(arr[2]) ?? 0;
+	const d = asNumber(arr[3]) ?? 0;
 	return {
 		llx: Math.min(a, c),
 		lly: Math.min(b, d),
@@ -88,6 +88,33 @@ function readMediaBox(page) {
 		ury: Math.max(b, d)
 	};
 }
+function readMediaBox(page) {
+	return readDeclaredPageBox(page, "MediaBox") ?? {
+		llx: 0,
+		lly: 0,
+		urx: DEFAULT_PAGE_WIDTH_PT,
+		ury: DEFAULT_PAGE_HEIGHT_PT
+	};
+}
+function rotatedRectBounds(rect, matrix) {
+	const transformed = [
+		[rect.llx, rect.lly],
+		[rect.urx, rect.lly],
+		[rect.llx, rect.ury],
+		[rect.urx, rect.ury]
+	].map(([x, y]) => applyMatrix(matrix, {
+		x,
+		y
+	}));
+	const xs = transformed.map((point) => point.x);
+	const ys = transformed.map((point) => point.y);
+	return {
+		minX: Math.min(...xs),
+		minY: Math.min(...ys),
+		maxX: Math.max(...xs),
+		maxY: Math.max(...ys)
+	};
+}
 function normalizeRotation(rotate) {
 	if (rotate === void 0) return 0;
 	const normalized = (Math.round(rotate / 90) * 90 % 360 + 360) % 360;
@@ -156,11 +183,114 @@ function readPageContentBytes(page, resolver, sink) {
 	}
 	return /* @__PURE__ */ new Uint8Array(0);
 }
-function readPage(page, resolver, fontResolver, images, imageIdCache, destinationRegistry, layerNameOf, sink) {
+function contentItemBounds(item) {
+	if (item.kind === "link" || item.kind === "internalLink") return;
+	const frameBounds = (xPt, yPt, widthPt, heightPt) => ({
+		minX: xPt,
+		minY: yPt,
+		maxX: xPt + widthPt,
+		maxY: yPt + heightPt
+	});
+	if (item.kind === "text" || item.kind === "image" || item.kind === "rect" || item.kind === "ellipse") {
+		if (item.kind !== "text" || item.rotationDeg === void 0 || item.rotationDeg % 180 === 0) return frameBounds(item.xPt, item.yPt, item.widthPt ?? 0, item.kind === "text" ? item.sizePt : item.heightPt);
+		const rotationDeg = item.rotationDeg;
+		const anchorX = item.xPt;
+		const anchorY = item.yPt;
+		const rotated = [
+			[0, 0],
+			[item.widthPt ?? 0, 0],
+			[0, item.sizePt],
+			[item.widthPt ?? 0, item.sizePt]
+		].map(([dx, dy]) => rotatePointAboutCenter({
+			x: anchorX + dx,
+			y: anchorY + dy
+		}, {
+			x: anchorX,
+			y: anchorY
+		}, rotationDeg));
+		const xs = rotated.map((point) => point.x);
+		const ys = rotated.map((point) => point.y);
+		return {
+			minX: Math.min(...xs),
+			minY: Math.min(...ys),
+			maxX: Math.max(...xs),
+			maxY: Math.max(...ys)
+		};
+	}
+	if (item.kind === "line") return {
+		minX: Math.min(item.x1Pt, item.x2Pt),
+		minY: Math.min(item.y1Pt, item.y2Pt),
+		maxX: Math.max(item.x1Pt, item.x2Pt),
+		maxY: Math.max(item.y1Pt, item.y2Pt)
+	};
+	let minX = Number.POSITIVE_INFINITY;
+	let minY = Number.POSITIVE_INFINITY;
+	let maxX = Number.NEGATIVE_INFINITY;
+	let maxY = Number.NEGATIVE_INFINITY;
+	const include = (x, y) => {
+		minX = Math.min(minX, x);
+		minY = Math.min(minY, y);
+		maxX = Math.max(maxX, x);
+		maxY = Math.max(maxY, y);
+	};
+	for (const subpath of item.subpaths) {
+		include(subpath.startXPt, subpath.startYPt);
+		for (const segment of subpath.segments) {
+			include(segment.xPt, segment.yPt);
+			if (segment.kind === "cubic") {
+				include(segment.c1xPt, segment.c1yPt);
+				include(segment.c2xPt, segment.c2yPt);
+			}
+		}
+	}
+	return {
+		minX,
+		minY,
+		maxX,
+		maxY
+	};
+}
+function itemIntersectsVisibleRegion(item, widthPt, heightPt) {
+	if (item.kind === "link" || item.kind === "internalLink") return true;
+	const bounds = contentItemBounds(item);
+	if (bounds === void 0) return true;
+	return bounds.maxX >= 0 && bounds.minX <= widthPt && bounds.maxY >= 0 && bounds.minY <= heightPt;
+}
+function pageBoxResidueEntry(pageIndex, page, mediaBox, cropBox) {
+	const declaredBoxes = [
+		["MediaBox", dictGet(page, "MediaBox")],
+		["CropBox", dictGet(page, "CropBox")],
+		["BleedBox", dictGet(page, "BleedBox")],
+		["TrimBox", dictGet(page, "TrimBox")],
+		["ArtBox", dictGet(page, "ArtBox")]
+	];
+	const cropDeclared = dictGet(page, "CropBox") !== void 0;
+	const productionBoxDeclared = declaredBoxes.slice(2).some(([, value]) => value !== void 0);
+	if (!(cropDeclared && (cropBox.llx !== mediaBox.llx || cropBox.lly !== mediaBox.lly || cropBox.urx !== mediaBox.urx || cropBox.ury !== mediaBox.ury)) && !productionBoxDeclared) return;
+	const entries = { Page: pdfNum(pageIndex) };
+	for (const [key, value] of declaredBoxes) if (value !== void 0) entries[key] = value;
+	return pdfDict(entries);
+}
+function readPage(pageIndex, page, resolver, fontResolver, images, imageIdCache, destinationRegistry, layerNameOf, pageBoxRows, sink) {
 	const resources = resolver.resolveDict(dictGet(page, "Resources"));
 	const mediaBox = readMediaBox(page);
+	let cropBox = readDeclaredPageBox(page, "CropBox") ?? mediaBox;
+	if (cropBox.urx - cropBox.llx <= 0 || cropBox.ury - cropBox.lly <= 0) {
+		sink({
+			code: "pdf/invalid-crop-box",
+			severity: "warning",
+			pageIndex,
+			message: "page /CropBox is degenerate (zero width or height); falling back to the /MediaBox as the visible region"
+		});
+		cropBox = mediaBox;
+	}
 	const rotationResult = pageRotationTransform(normalizeRotation(asNumber(dictGet(page, "Rotate"))), mediaBox.urx - mediaBox.llx, mediaBox.ury - mediaBox.lly);
-	const pageMatrix = multiplyMatrices(translationMatrix(-mediaBox.llx, -mediaBox.lly), rotationResult.matrix);
+	const visibleRect = rotatedRectBounds(cropBox, rotationResult.matrix);
+	const widthPt = visibleRect.maxX - visibleRect.minX;
+	const heightPt = visibleRect.maxY - visibleRect.minY;
+	const pageMatrix = multiplyMatrices(rotationResult.matrix, translationMatrix(-visibleRect.minX, -visibleRect.minY));
+	const boxRow = pageBoxResidueEntry(pageIndex, page, mediaBox, cropBox);
+	if (boxRow !== void 0) pageBoxRows.push(boxRow);
 	const items = [];
 	if (resources !== void 0) {
 		const contentBytes = readPageContentBytes(page, resolver, sink);
@@ -172,7 +302,7 @@ function readPage(page, resolver, fontResolver, images, imageIdCache, destinatio
 		});
 		for (const item of extracted) {
 			const converted = convertExtractedItem(item, pageMatrix, fontResolver, images, imageIdCache, resolver, sink);
-			if (converted !== void 0) items.push(converted);
+			if (converted !== void 0 && itemIntersectsVisibleRegion(converted, widthPt, heightPt)) items.push(converted);
 		}
 	} else sink({
 		code: "pdf/object-missing-value",
@@ -183,8 +313,8 @@ function readPage(page, resolver, fontResolver, images, imageIdCache, destinatio
 	const notes = readPageNotes(page, resolver);
 	const annotations = readPageAnnotations(page, pageMatrix, resolver, sink);
 	return {
-		widthPt: rotationResult.widthPt,
-		heightPt: rotationResult.heightPt,
+		widthPt,
+		heightPt,
 		items,
 		...notes !== void 0 ? { notes } : {},
 		...annotations.length > 0 ? { annotations } : {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pdf-codec",
-  "version": "3.2.0",
+  "version": "3.3.1",
   "description": "Hand-written, dependency-minimal PDF codec: parses arbitrary real-world PDFs and generates new ones, built on its own codec-owned LayoutDocument item model and Zod 4 codecs.",
   "type": "module",
   "repository": {
@@ -98,7 +98,7 @@
   "packageManager": "pnpm@11.6.0",
   "dependencies": {
     "byte-codec": "^1.1.13",
-    "document-schema.js": "^4.8.0",
+    "document-schema.js": "^4.9.0",
     "fflate": "^0.8.3",
     "zod": "^4.4.3"
   },