pdf-codec 4.1.0 → 4.3.0

package/dist/write.js

@@ -1,6 +1,6 @@
 import { n as widthOfCode, p as winAnsiGlyphName, t as STANDARD_METRICS } from "./afm-widths-De_QMWgC.js";
 import { NOTES_ANNOTATION_AUTHOR } from "./notes-annotation-author.js";
-import { pdfArray, pdfDict, pdfHexString, pdfName, pdfNull, pdfNum, pdfRef, pdfStream } from "./objects.js";
+import { pdfArray, pdfDict, pdfHexString, pdfLiteralString, pdfName, pdfNull, pdfNum, pdfRef, pdfStream } from "./objects.js";
 import { ByteWriter, concatBytes } from "./bytes/writer.js";
 import { writeObject } from "./serialize.js";
 import { deflate } from "./bytes/flate.js";
@@ -201,11 +201,14 @@ function destinationViewArray(target) {
 	if (target.kind === "fitBV") return [pdfName("FitBV"), n(target.leftPt)];
 	return [pdfName(target.kind === "fitB" ? "FitB" : "Fit")];
 }
-function buildInternalLinkAnnotDict(link, doc, pageAllocs) {
-	const destination = doc.destinations?.find((d) => d.name === link.destination);
-	if (destination === void 0) throw new Error(`internal link names destination "${link.destination}", which the document's destinations table does not carry -- this is a caller-invariant violation`);
+function resolveDestinationArray(doc, pageAllocs, name, what) {
+	const destination = doc.destinations?.find((d) => d.name === name);
+	if (destination === void 0) throw new Error(`${what} names destination "${name}", which the document's destinations table does not carry -- this is a caller-invariant violation`);
 	const targetPage = pageAllocs[destination.pageIndex];
-	if (targetPage === void 0) throw new Error(`destination "${link.destination}" names page index ${destination.pageIndex}, which is beyond the document's own pages -- this is a caller-invariant violation`);
+	if (targetPage === void 0) throw new Error(`destination "${destination.name}" names page index ${destination.pageIndex}, which is beyond the document's own pages -- this is a caller-invariant violation`);
+	return [pdfRef(targetPage.pageNum, 0), ...destinationViewArray(destination.target)];
+}
+function buildInternalLinkAnnotDict(link, doc, pageAllocs) {
 	return pdfDict({
 		Type: pdfName("Annot"),
 		Subtype: pdfName("Link"),
@@ -220,7 +223,7 @@ function buildInternalLinkAnnotDict(link, doc, pageAllocs) {
 			0,
 			0
 		].map((v) => pdfNum(v))),
-		Dest: pdfArray([pdfRef(targetPage.pageNum, 0), ...destinationViewArray(destination.target)])
+		Dest: pdfArray(resolveDestinationArray(doc, pageAllocs, link.destination, "internal link"))
 	});
 }
 function isLinkItem(item) {
@@ -321,13 +324,28 @@ function writePdf(doc, options = {}) {
 		contentsNum: nextObjNum++
 	}));
 	const encryptDictNum = options.encryption === void 0 ? void 0 : nextObjNum++;
+	const attachmentAllocs = (doc.attachments ?? []).map(() => ({
+		fileNum: nextObjNum++,
+		specNum: nextObjNum++
+	}));
+	const attachmentsNamesNum = attachmentAllocs.length > 0 ? nextObjNum++ : void 0;
+	const outlineRootNum = (doc.outline ?? []).length > 0 ? nextObjNum++ : void 0;
+	const outlineItemNums = [];
+	if (outlineRootNum !== void 0) {
+		const countItems = (items) => {
+			let n = 0;
+			for (const item of items) n += 1 + countItems(item.children);
+			return n;
+		};
+		for (let i = 0; i < countItems(doc.outline ?? []); i += 1) outlineItemNums.push(nextObjNum++);
+	}
 	const objects = [];
+	const catalogEntries = [["Type", pdfName("Catalog")], ["Pages", pdfRef(pagesNum, 0)]];
+	if (attachmentsNamesNum !== void 0) catalogEntries.push(["Names", pdfRef(attachmentsNamesNum, 0)]);
+	if (outlineRootNum !== void 0) catalogEntries.push(["Outlines", pdfRef(outlineRootNum, 0)]);
 	objects.push({
 		num: catalogNum,
-		value: pdfDict({
-			Type: pdfName("Catalog"),
-			Pages: pdfRef(pagesNum, 0)
-		})
+		value: pdfDict(Object.fromEntries(catalogEntries))
 	});
 	objects.push({
 		num: pagesNum,
@@ -341,6 +359,73 @@ function writePdf(doc, options = {}) {
 		num: infoNum,
 		value: buildInfoDict(doc)
 	});
+	for (const [index, attachment] of (doc.attachments ?? []).entries()) {
+		const alloc = attachmentAllocs[index];
+		const fileEntries = [["Type", pdfName("EmbeddedFile")]];
+		if (attachment.mimeType !== void 0) fileEntries.push(["Subtype", pdfName(attachment.mimeType)]);
+		objects.push({
+			num: alloc.fileNum,
+			value: pdfStream(pdfDict(Object.fromEntries(fileEntries)), base64ToBytes(attachment.base64))
+		});
+		const specEntries = [
+			["Type", pdfName("Filespec")],
+			["F", pdfLiteralString(new TextEncoder().encode(attachment.name))],
+			["EF", pdfDict({ F: pdfRef(alloc.fileNum, 0) })]
+		];
+		if (attachment.description !== void 0) specEntries.push(["Desc", pdfLiteralString(new TextEncoder().encode(attachment.description))]);
+		objects.push({
+			num: alloc.specNum,
+			value: pdfDict(Object.fromEntries(specEntries))
+		});
+	}
+	if (attachmentsNamesNum !== void 0) {
+		const names = [];
+		for (const [index, attachment] of (doc.attachments ?? []).entries()) {
+			names.push(pdfLiteralString(new TextEncoder().encode(attachment.name)));
+			names.push(pdfRef(attachmentAllocs[index].specNum, 0));
+		}
+		objects.push({
+			num: attachmentsNamesNum,
+			value: pdfDict({ EmbeddedFiles: pdfDict({ Names: pdfArray(names) }) })
+		});
+	}
+	if (outlineRootNum !== void 0 && (doc.outline ?? []).length > 0) {
+		let itemCursor = 0;
+		const emitItems = (items, parentNum) => {
+			const siblingNums = [];
+			let prevNum;
+			for (const item of items) {
+				const ownNum = outlineItemNums[itemCursor];
+				itemCursor += 1;
+				siblingNums.push(ownNum);
+				const childNums = emitItems(item.children, ownNum);
+				const entries = [["Title", pdfLiteralString(new TextEncoder().encode(item.title))], ["Parent", pdfRef(parentNum, 0)]];
+				if (item.destination !== void 0) entries.push(["Dest", pdfArray(resolveDestinationArray(doc, pageAllocs, item.destination, `outline item "${item.title}"`))]);
+				if (prevNum !== void 0) entries.push(["Prev", pdfRef(prevNum, 0)]);
+				if (siblingNums.length < items.length) entries.push(["Next", pdfRef(outlineItemNums[itemCursor], 0)]);
+				if (childNums.length > 0) {
+					entries.push(["First", pdfRef(childNums[0], 0)]);
+					entries.push(["Last", pdfRef(childNums[childNums.length - 1], 0)]);
+					entries.push(["Count", pdfNum(childNums.length)]);
+				}
+				objects.push({
+					num: ownNum,
+					value: pdfDict(Object.fromEntries(entries))
+				});
+				prevNum = ownNum;
+			}
+			return siblingNums;
+		};
+		const topLevelNums = emitItems(doc.outline ?? [], outlineRootNum);
+		objects.push({
+			num: outlineRootNum,
+			value: pdfDict({
+				Type: pdfName("Outlines"),
+				First: pdfRef(topLevelNums[0], 0),
+				Last: pdfRef(topLevelNums[topLevelNums.length - 1], 0)
+			})
+		});
+	}
 	for (const [standardName, alloc] of fontAllocs) {
 		const { font, descriptor } = buildFontObjects(standardName, pdfRef(alloc.descNum, 0));
 		objects.push({
@@ -396,9 +481,10 @@ function writePdf(doc, options = {}) {
 		});
 	}
 	for (const [face, alloc] of embeddedAllocs) {
-		const subset = subsetSfnt(face.font, [...alloc.codePoints].sort((a, b) => a - b));
+		const usedGlyphs = collectEmbeddedGlyphs(alloc.texts, face);
+		const subset = subsetSfnt(face.font, [...alloc.codePoints].sort((a, b) => a - b), [...usedGlyphs.keys()].sort((a, b) => a - b));
 		if (subset === void 0) throw new Error(`font "${face.postScriptName}" resolved to an embeddable face, but its glyph outlines could not be subsetted -- only TrueType-outline ('glyf') fonts can be embedded, so supply a TrueType face for this family or drop it from the registry`);
-		const built = buildEmbeddedFontObjects(face, subset, collectEmbeddedGlyphs(alloc.texts, face), {
+		const built = buildEmbeddedFontObjects(face, subset, usedGlyphs, {
 			cidFontRef: pdfRef(alloc.cidFontNum, 0),
 			descriptorRef: pdfRef(alloc.descriptorNum, 0),
 			fontFileRef: pdfRef(alloc.fontFileNum, 0),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pdf-codec",
-  "version": "4.1.0",
+  "version": "4.3.0",
   "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": {