pdf-parser.js 3.0.7 → 4.5.1

package/dist/read.js

@@ -1,17 +1,26 @@
+import "./notes-annotation-author.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, rotatePointAboutCenter, translationMatrix } from "./matrix.js";
+import { readPageAnnotations } from "./annotations.js";
+import { decodeStream } from "./filters.js";
 import { bytesToBase64 } from "./util/base64.js";
+import { readAttachments } from "./attachments.js";
 import { crc32 } from "./bytes/crc32.js";
-import { concatBytes } from "./bytes/writer.js";
+import { readAcroForm } from "./form.js";
+import { readXmpMetadata } from "./xmp.js";
+import { readOptionalContent } from "./optional-content.js";
+import { readStructure } from "./structure.js";
 import "./layout.js";
 import { NOOP_DIAGNOSTIC_SINK, PdfParseError } from "./diagnostics.js";
-import { asArray, asName, asNumber, dictGet } from "./objects.js";
-import { decodeStream } from "./filters.js";
 import { openPdfDocument } from "./document.js";
 import { throwIfAborted } from "./util/abort.js";
 import { createFontResolver } from "./font-read.js";
 import { readImageXObject } from "./images-read.js";
-import { applyMatrix, matrixRotationDegrees, matrixScaleX, matrixScaleY, multiplyMatrices, translationMatrix } from "./matrix.js";
 import { interpretContentStream } from "./interpret.js";
-import "./write.js";
+import { createDestinationRegistry, readOutline } from "./navigation.js";
 //#region src/read.ts
 const PDF_HEADER_BYTES = new TextEncoder().encode("%PDF-");
 const HEADER_SEARCH_WINDOW = 1024;
@@ -29,6 +38,7 @@ function readPdf(bytes, options) {
 	const sink = options?.sink ?? NOOP_DIAGNOSTIC_SINK;
 	const signal = options?.signal;
 	if (!hasPdfHeader(bytes)) throw new PdfParseError("pdf/no-header", "no \"%PDF-\" header found within the first bytes of the file; this does not look like a PDF at all");
+	throwIfAborted(signal);
 	const doc = openPdfDocument(bytes, sink);
 	const fontResolver = createFontResolver({
 		resolver: doc,
@@ -36,29 +46,44 @@ function readPdf(bytes, options) {
 	});
 	const images = {};
 	const imageIdCache = /* @__PURE__ */ new Map();
-	const pages = doc.pages().map((pageDict) => {
+	const pageDicts = doc.pages();
+	const destinationRegistry = createDestinationRegistry(doc.catalog, doc, (obj) => doc.pageIndex(obj), sink);
+	const outline = readOutline(doc.catalog, destinationRegistry, doc, sink);
+	const attachments = readAttachments(doc.catalog, pageDicts, doc, sink);
+	const optionalContent = readOptionalContent(doc.catalog, doc, sink);
+	const form = readAcroForm(doc.catalog, doc, (obj) => doc.pageIndex(obj), sink);
+	const structure = readStructure(doc.catalog, pageDicts, doc, sink);
+	const source = readDocumentResidue(doc, sink);
+	const pageBoxRows = [];
+	const pages = pageDicts.map((pageDict, index) => {
 		throwIfAborted(signal);
-		return readPage(pageDict, doc, fontResolver, images, imageIdCache, sink);
+		return readPage(index, pageDict, doc, fontResolver, images, imageIdCache, destinationRegistry, optionalContent.layerNameOf, structure.ownerOf, pageBoxRows, sink);
 	});
+	if (pageBoxRows.length > 0) source["page-boxes"] = {
+		format: "pdf",
+		xml: serializeObjectToText(pdfArray(pageBoxRows))
+	};
 	return {
 		formatVersion: 1,
-		metadata: readMetadata(doc.trailer, doc),
+		metadata: readMetadata(doc.trailer, doc, doc.catalog, sink),
 		pages,
-		images
+		images,
+		...destinationRegistry.entries.length > 0 ? { destinations: [...destinationRegistry.entries] } : {},
+		...outline.length > 0 ? { outline } : {},
+		...attachments.length > 0 ? { attachments } : {},
+		...optionalContent.layers.length > 0 ? { layers: [...optionalContent.layers] } : {},
+		...form.length > 0 ? { form } : {},
+		...structure.tree.length > 0 ? { structure: [...structure.tree] } : {},
+		...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),
@@ -66,6 +91,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;
@@ -134,35 +186,150 @@ function readPageContentBytes(page, resolver, sink) {
 	}
 	return /* @__PURE__ */ new Uint8Array(0);
 }
-function readPage(page, resolver, fontResolver, images, imageIdCache, 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, structureOwnerOf, 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);
 		const extracted = interpretContentStream(contentBytes, resources, {
 			fontMetrics: fontResolver.metrics,
 			resolver,
-			sink
+			sink,
+			layerNameOf
 		});
 		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)) continue;
+			const owner = item.mcid === void 0 ? void 0 : structureOwnerOf(pageIndex, item.mcid);
+			items.push(owner === void 0 ? converted : withStructure(converted, owner));
 		}
 	} else sink({
 		code: "pdf/object-missing-value",
 		severity: "warning",
 		message: "page has no /Resources dict; its content stream cannot be interpreted"
 	});
-	items.push(...readLinkAnnotations(page, pageMatrix, resolver));
+	items.push(...readLinkAnnotations(page, pageMatrix, resolver, destinationRegistry));
 	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 } : {}
+		...notes !== void 0 ? { notes } : {},
+		...annotations.length > 0 ? { annotations } : {}
+	};
+}
+function withStructure(item, structure) {
+	if (item.kind === "link" || item.kind === "internalLink") return item;
+	return {
+		...item,
+		structure
 	};
 }
 function convertExtractedItem(item, pageMatrix, fontResolver, images, imageIdCache, resolver, sink) {
@@ -197,7 +364,10 @@ function convertText(item, pageMatrix, fontResolver) {
 		sizePt: sizePt > 0 ? sizePt : item.sizePt,
 		color: item.color,
 		widthPt,
-		rotationDeg: rotationDeg !== 0 ? rotationDeg : void 0
+		rotationDeg: rotationDeg !== 0 ? rotationDeg : void 0,
+		...item.layerName !== void 0 ? { layer: item.layerName } : {},
+		...item.actualText !== void 0 ? { actualText: item.actualText } : {},
+		...item.alt !== void 0 ? { alt: item.alt } : {}
 	};
 }
 function paintFields(paint) {
@@ -226,14 +396,16 @@ function convertRect(item, pageMatrix) {
 	return {
 		kind: "rect",
 		...transformBox(item, pageMatrix),
-		...paintFields(item)
+		...paintFields(item),
+		...item.layerName !== void 0 ? { layer: item.layerName } : {}
 	};
 }
 function convertEllipse(item, pageMatrix) {
 	return {
 		kind: "ellipse",
 		...transformBox(item, pageMatrix),
-		...paintFields(item)
+		...paintFields(item),
+		...item.layerName !== void 0 ? { layer: item.layerName } : {}
 	};
 }
 function convertLine(item, pageMatrix) {
@@ -252,7 +424,9 @@ function convertLine(item, pageMatrix) {
 		x2Pt: p2.x,
 		y2Pt: p2.y,
 		color: item.color,
-		widthPt: item.widthPt
+		widthPt: item.widthPt,
+		...item.style !== void 0 ? { style: item.style } : {},
+		...item.layerName !== void 0 ? { layer: item.layerName } : {}
 	};
 }
 function transformSubpath(subpath, pageMatrix) {
@@ -307,7 +481,9 @@ function convertPath(item, pageMatrix) {
 		subpaths: item.subpaths.map((subpath) => transformSubpath(subpath, pageMatrix)),
 		...item.fill !== void 0 ? { fill: item.fill } : {},
 		...item.fill !== void 0 && item.fillRule === "evenodd" ? { fillRule: "evenodd" } : {},
-		...item.stroke !== void 0 ? { stroke: item.stroke } : {}
+		...item.stroke !== void 0 ? { stroke: item.stroke } : {},
+		...item.style !== void 0 ? { style: item.style } : {},
+		...item.layerName !== void 0 ? { layer: item.layerName } : {}
 	};
 }
 function imagePlacementFrom(matrix) {
@@ -350,7 +526,8 @@ function convertImage(item, pageMatrix, images, cache, resolver, sink) {
 	return {
 		kind: "image",
 		imageId,
-		...imagePlacementFrom(multiplyMatrices(item.matrix, pageMatrix))
+		...imagePlacementFrom(multiplyMatrices(item.matrix, pageMatrix)),
+		...item.layerName !== void 0 ? { layer: item.layerName } : {}
 	};
 }
 function convertInlineImage(item, pageMatrix, images, resolver, sink) {
@@ -359,19 +536,22 @@ function convertInlineImage(item, pageMatrix, images, resolver, sink) {
 	return {
 		kind: "image",
 		imageId: registerExtractedImage(decoded.format, decoded.bytes, decoded.widthPx, decoded.heightPx, images),
-		...imagePlacementFrom(multiplyMatrices(item.matrix, pageMatrix))
+		...imagePlacementFrom(multiplyMatrices(item.matrix, pageMatrix)),
+		...item.layerName !== void 0 ? { layer: item.layerName } : {}
 	};
 }
-function readLinkAnnotations(page, pageMatrix, resolver) {
+function readLinkAnnotations(page, pageMatrix, resolver, destinationRegistry) {
 	const annotsArr = asArray(dictGet(page, "Annots"));
 	if (annotsArr === void 0) return [];
 	const links = [];
 	for (const annotRef of annotsArr) {
 		const annot = resolver.resolveDict(annotRef);
 		if (annot === void 0 || asName(dictGet(annot, "Subtype")) !== "Link") continue;
-		const uri = readLinkUri(annot, resolver);
 		const rectArr = asArray(dictGet(annot, "Rect"));
-		if (uri === void 0 || rectArr === void 0) continue;
+		if (rectArr === void 0) continue;
+		const uri = readLinkUri(annot, resolver);
+		const destination = uri === void 0 ? readInternalDestination(annot, resolver, destinationRegistry) : void 0;
+		if (uri === void 0 && destination === void 0) continue;
 		const x1 = asNumber(rectArr[0]) ?? 0;
 		const y1 = asNumber(rectArr[1]) ?? 0;
 		const x2 = asNumber(rectArr[2]) ?? 0;
@@ -384,13 +564,24 @@ function readLinkAnnotations(page, pageMatrix, resolver) {
 			x: Math.max(x1, x2),
 			y: Math.max(y1, y2)
 		});
-		links.push({
-			kind: "link",
-			uri,
+		const contentsObj = dictGet(annot, "Contents");
+		const title = contentsObj?.kind === "string" ? decodePdfString(contentsObj.bytes) : void 0;
+		const box = {
 			xPt: Math.min(p1.x, p2.x),
 			yPt: Math.min(p1.y, p2.y),
 			widthPt: Math.abs(p2.x - p1.x),
-			heightPt: Math.abs(p2.y - p1.y)
+			heightPt: Math.abs(p2.y - p1.y),
+			...title !== void 0 ? { title } : {}
+		};
+		if (uri !== void 0) links.push({
+			kind: "link",
+			uri,
+			...box
+		});
+		else if (destination !== void 0) links.push({
+			kind: "internalLink",
+			destination,
+			...box
 		});
 	}
 	return links;
@@ -401,6 +592,12 @@ function readLinkUri(annot, resolver) {
 	const uriObj = dictGet(action, "URI");
 	return uriObj?.kind === "string" ? decodePdfString(uriObj.bytes) : void 0;
 }
+function readInternalDestination(annot, resolver, destinationRegistry) {
+	const dest = dictGet(annot, "Dest");
+	if (dest !== void 0) return destinationRegistry.intern(dest);
+	const action = resolver.resolveDict(dictGet(annot, "A"));
+	if (action !== void 0 && asName(dictGet(action, "S")) === "GoTo") return destinationRegistry.intern(dictGet(action, "D"));
+}
 function readPageNotes(page, resolver) {
 	const annotsArr = asArray(dictGet(page, "Annots"));
 	if (annotsArr === void 0) return;
@@ -413,23 +610,7 @@ function readPageNotes(page, resolver) {
 		if (contentsObj?.kind === "string") return decodePdfString(contentsObj.bytes);
 	}
 }
-function decodePdfString(bytes) {
-	if (bytes.length >= 2 && bytes[0] === 254 && bytes[1] === 255) {
-		let out = "";
-		for (let i = 2; i + 1 < bytes.length; i += 2) out += String.fromCharCode((bytes[i] ?? 0) << 8 | (bytes[i + 1] ?? 0));
-		return out;
-	}
-	return Array.from(bytes, (b) => String.fromCharCode(b)).join("");
-}
-const PDF_DATE_PATTERN = /^D:(\d{4})(\d{2})?(\d{2})?(\d{2})?(\d{2})?(\d{2})?([+\-Z])?(\d{2})?'?(\d{2})?'?$/;
-function parsePdfDate(raw) {
-	if (raw === void 0) return;
-	const match = PDF_DATE_PATTERN.exec(raw);
-	if (match === null) return;
-	const [, year, month = "01", day = "01", hour = "00", minute = "00", second = "00", tzSign, tzHour = "00", tzMinute = "00"] = match;
-	return `${year}-${month}-${day}T${hour}:${minute}:${second}${tzSign === void 0 || tzSign === "Z" ? "Z" : `${tzSign}${tzHour}:${tzMinute}`}`;
-}
-function readMetadata(trailer, resolver) {
+function readMetadata(trailer, resolver, catalog, sink) {
 	const info = resolver.resolveDict(dictGet(trailer, "Info"));
 	if (info === void 0) return {};
 	const stringField = (key) => {
@@ -437,16 +618,52 @@ function readMetadata(trailer, resolver) {
 		return obj?.kind === "string" ? decodePdfString(obj.bytes) : void 0;
 	};
 	const keywords = stringField("Keywords")?.split(",").map((k) => k.trim()).filter((k) => k.length > 0);
+	const langObj = dictGet(catalog, "Lang");
+	const xmp = xmpPacket(catalog, resolver, sink);
+	const mirrored = readXmpMetadata(xmp ?? "");
 	return {
-		title: stringField("Title"),
-		author: stringField("Author"),
-		subject: stringField("Subject"),
-		keywords: keywords !== void 0 && keywords.length > 0 ? keywords : void 0,
-		creator: stringField("Creator"),
-		producer: stringField("Producer"),
-		createdIso: parsePdfDate(stringField("CreationDate")),
-		modifiedIso: parsePdfDate(stringField("ModDate"))
+		title: stringField("Title") ?? mirrored.title,
+		author: stringField("Author") ?? mirrored.author,
+		subject: stringField("Subject") ?? mirrored.subject,
+		keywords: (keywords !== void 0 && keywords.length > 0 ? keywords : void 0) ?? mirrored.keywords,
+		creator: stringField("Creator") ?? mirrored.creator,
+		producer: stringField("Producer") ?? mirrored.producer,
+		createdIso: parsePdfDate(stringField("CreationDate")) ?? mirrored.createdIso,
+		modifiedIso: parsePdfDate(stringField("ModDate")) ?? mirrored.modifiedIso,
+		...langObj?.kind === "string" ? { language: decodePdfString(langObj.bytes) } : {}
+	};
+}
+function xmpPacket(catalog, resolver, sink) {
+	const metadataObj = resolver.resolve(dictGet(catalog, "Metadata"));
+	if (metadataObj?.kind !== "stream") return;
+	const decoded = decodeStream(metadataObj.raw, metadataObj.dict, sink);
+	return new TextDecoder().decode(decoded.bytes);
+}
+function readDocumentResidue(doc, sink) {
+	const source = {};
+	const residue = (key, obj) => {
+		if (obj !== void 0) source[key] = {
+			format: "pdf",
+			xml: serializeObjectToText(obj)
+		};
+	};
+	const catalog = doc.catalog;
+	const packet = xmpPacket(catalog, doc, sink);
+	if (packet !== void 0) source.xmp = {
+		format: "pdf",
+		xml: packet
 	};
+	residue("viewer-preferences", dictGet(catalog, "ViewerPreferences"));
+	residue("page-mode", dictGet(catalog, "PageMode"));
+	residue("page-layout", dictGet(catalog, "PageLayout"));
+	residue("open-action", dictGet(catalog, "OpenAction"));
+	const outputIntents = asArray(dictGet(catalog, "OutputIntents"));
+	if (outputIntents !== void 0) residue("output-intents", pdfArray(outputIntents.map((intent) => doc.resolve(intent) ?? pdfNull())));
+	residue("piece-info", dictGet(catalog, "PieceInfo"));
+	residue("legal", dictGet(catalog, "Legal"));
+	residue("collection", dictGet(catalog, "Collection"));
+	residue("trailer-id", dictGet(doc.trailer, "ID"));
+	return source;
 }
 //#endregion
-export { decodePdfString, normalizeRotation, pageRotationTransform, parsePdfDate, readPdf };
+export { normalizeRotation, pageRotationTransform, readPdf };

package/dist/serialize.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_bytes_writer = require("./bytes/writer.cjs");
 const require_objects = require("./objects.cjs");
+const require_bytes_writer = require("./bytes/writer.cjs");
 //#region src/serialize.ts
 const NUMBER_DECIMAL_PLACES = 4;
 const NUMBER_EPSILON = 10 ** -4;
@@ -63,7 +63,11 @@ function serializeObject(obj) {
 	writeObject(writer, obj);
 	return writer.toBytes();
 }
+function serializeObjectToText(obj) {
+	return new TextDecoder().decode(serializeObject(obj));
+}
 //#endregion
 exports.formatNumber = formatNumber;
 exports.serializeObject = serializeObject;
+exports.serializeObjectToText = serializeObjectToText;
 exports.writeObject = writeObject;

package/dist/serialize.d.cts

@@ -1,8 +1,9 @@
+import { r as PdfObject } from "./objects-B7HdMeWS.cjs";
 import { ByteWriter } from "./bytes/writer.cjs";
-import { PdfObject } from "./objects.cjs";
 //#region src/serialize.d.ts
 declare function formatNumber(n: number): string;
 declare function writeObject(writer: ByteWriter, obj: PdfObject): void;
 declare function serializeObject(obj: PdfObject): Uint8Array<ArrayBuffer>;
+declare function serializeObjectToText(obj: PdfObject): string;
 //#endregion
-export { formatNumber, serializeObject, writeObject };
+export { formatNumber, serializeObject, serializeObjectToText, writeObject };

package/dist/serialize.d.ts

@@ -1,8 +1,9 @@
+import { r as PdfObject } from "./objects-B7HdMeWS.js";
 import { ByteWriter } from "./bytes/writer.js";
-import { PdfObject } from "./objects.js";
 //#region src/serialize.d.ts
 declare function formatNumber(n: number): string;
 declare function writeObject(writer: ByteWriter, obj: PdfObject): void;
 declare function serializeObject(obj: PdfObject): Uint8Array<ArrayBuffer>;
+declare function serializeObjectToText(obj: PdfObject): string;
 //#endregion
-export { formatNumber, serializeObject, writeObject };
+export { formatNumber, serializeObject, serializeObjectToText, writeObject };

package/dist/serialize.js

@@ -1,5 +1,5 @@
-import { ByteWriter } from "./bytes/writer.js";
 import { pdfNum } from "./objects.js";
+import { ByteWriter } from "./bytes/writer.js";
 //#region src/serialize.ts
 const NUMBER_DECIMAL_PLACES = 4;
 const NUMBER_EPSILON = 10 ** -4;
@@ -62,5 +62,8 @@ function serializeObject(obj) {
 	writeObject(writer, obj);
 	return writer.toBytes();
 }
+function serializeObjectToText(obj) {
+	return new TextDecoder().decode(serializeObject(obj));
+}
 //#endregion
-export { formatNumber, serializeObject, writeObject };
+export { formatNumber, serializeObject, serializeObjectToText, writeObject };

package/dist/sfnt-subset.cjs

@@ -71,7 +71,7 @@ function buildPostStub(font) {
 	if (sourcePost !== void 0 && require_sfnt.hasBytes(sourcePost, POST_METRICS_OFFSET, POST_METRICS_SIZE)) post.set(sourcePost.subarray(POST_METRICS_OFFSET, 16), POST_METRICS_OFFSET);
 	return post;
 }
-function collectGlyphIds(glyf, cmap, numGlyphs, codePoints) {
+function collectGlyphIds(glyf, cmap, numGlyphs, codePoints, extraGlyphIds) {
 	const used = /* @__PURE__ */ new Set([0]);
 	const unmapped = /* @__PURE__ */ new Set();
 	const pending = [0];
@@ -87,6 +87,13 @@ function collectGlyphIds(glyf, cmap, numGlyphs, codePoints) {
 			pending.push(glyphId);
 		}
 	}
+	for (const glyphId of extraGlyphIds) {
+		if (glyphId >= numGlyphs) return;
+		if (!used.has(glyphId)) {
+			used.add(glyphId);
+			pending.push(glyphId);
+		}
+	}
 	while (pending.length > 0) {
 		const glyphId = pending.pop();
 		if (glyf.glyphBytes(glyphId) === void 0) return;
@@ -107,7 +114,7 @@ function collectGlyphIds(glyf, cmap, numGlyphs, codePoints) {
 		unmapped: [...unmapped].sort((a, b) => a - b)
 	};
 }
-function subsetSfnt(font, codePoints) {
+function subsetSfnt(font, codePoints, extraGlyphIds = []) {
 	const head = require_font_tables.parseHead(font);
 	const maxp = require_font_tables.parseMaxp(font);
 	const sourceHead = require_sfnt.sfntTableBytes(font, "head");
@@ -124,7 +131,7 @@ function subsetSfnt(font, codePoints) {
 	});
 	const cmap = require_cmap_table.buildCmapLookup(font);
 	if (glyf === void 0 || cmap === void 0) return;
-	const collected = collectGlyphIds(glyf, cmap, maxp.numGlyphs, codePoints);
+	const collected = collectGlyphIds(glyf, cmap, maxp.numGlyphs, codePoints, extraGlyphIds);
 	if (collected === void 0) return;
 	const glyphIds = [...collected.used].sort((a, b) => a - b);
 	const numGlyphs = glyphIds[glyphIds.length - 1] + 1;

package/dist/sfnt-subset.d.cts

@@ -6,6 +6,6 @@ interface SfntSubsetResult {
   readonly glyphIds: readonly number[];
   readonly unmappedCodePoints: readonly number[];
 }
-declare function subsetSfnt(font: SfntFont, codePoints: Iterable<number>): SfntSubsetResult | undefined;
+declare function subsetSfnt(font: SfntFont, codePoints: Iterable<number>, extraGlyphIds?: Iterable<number>): SfntSubsetResult | undefined;
 //#endregion
 export { SfntSubsetResult, subsetSfnt };

package/dist/sfnt-subset.d.ts

@@ -6,6 +6,6 @@ interface SfntSubsetResult {
   readonly glyphIds: readonly number[];
   readonly unmappedCodePoints: readonly number[];
 }
-declare function subsetSfnt(font: SfntFont, codePoints: Iterable<number>): SfntSubsetResult | undefined;
+declare function subsetSfnt(font: SfntFont, codePoints: Iterable<number>, extraGlyphIds?: Iterable<number>): SfntSubsetResult | undefined;
 //#endregion
 export { SfntSubsetResult, subsetSfnt };

package/dist/sfnt-subset.js

@@ -70,7 +70,7 @@ function buildPostStub(font) {
 	if (sourcePost !== void 0 && hasBytes(sourcePost, POST_METRICS_OFFSET, POST_METRICS_SIZE)) post.set(sourcePost.subarray(POST_METRICS_OFFSET, 16), POST_METRICS_OFFSET);
 	return post;
 }
-function collectGlyphIds(glyf, cmap, numGlyphs, codePoints) {
+function collectGlyphIds(glyf, cmap, numGlyphs, codePoints, extraGlyphIds) {
 	const used = /* @__PURE__ */ new Set([0]);
 	const unmapped = /* @__PURE__ */ new Set();
 	const pending = [0];
@@ -86,6 +86,13 @@ function collectGlyphIds(glyf, cmap, numGlyphs, codePoints) {
 			pending.push(glyphId);
 		}
 	}
+	for (const glyphId of extraGlyphIds) {
+		if (glyphId >= numGlyphs) return;
+		if (!used.has(glyphId)) {
+			used.add(glyphId);
+			pending.push(glyphId);
+		}
+	}
 	while (pending.length > 0) {
 		const glyphId = pending.pop();
 		if (glyf.glyphBytes(glyphId) === void 0) return;
@@ -106,7 +113,7 @@ function collectGlyphIds(glyf, cmap, numGlyphs, codePoints) {
 		unmapped: [...unmapped].sort((a, b) => a - b)
 	};
 }
-function subsetSfnt(font, codePoints) {
+function subsetSfnt(font, codePoints, extraGlyphIds = []) {
 	const head = parseHead(font);
 	const maxp = parseMaxp(font);
 	const sourceHead = sfntTableBytes(font, "head");
@@ -123,7 +130,7 @@ function subsetSfnt(font, codePoints) {
 	});
 	const cmap = buildCmapLookup(font);
 	if (glyf === void 0 || cmap === void 0) return;
-	const collected = collectGlyphIds(glyf, cmap, maxp.numGlyphs, codePoints);
+	const collected = collectGlyphIds(glyf, cmap, maxp.numGlyphs, codePoints, extraGlyphIds);
 	if (collected === void 0) return;
 	const glyphIds = [...collected.used].sort((a, b) => a - b);
 	const numGlyphs = glyphIds[glyphIds.length - 1] + 1;