pdf-parser.js 5.2.29 → 5.3.0

package/dist/read.js

@@ -1,13 +1,12 @@
-import "./notes-annotation-author.js";
-import { asArray, asName, asNumber, dictGet, pdfArray, pdfDict, pdfNull, pdfNum } from "./objects.js";
+import { asArray, 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 { applyMatrix, multiplyMatrices, rotatePointAboutCenter, translationMatrix } from "./matrix.js";
 import { readPageAnnotations } from "./annotations.js";
 import { decodeStream } from "./filters.js";
 import { readAttachments } from "./attachments.js";
-import { crc32 } from "./bytes/crc32.js";
+import { convertExtractedItem, readLinkAnnotations, readPageNotes } from "./read-convert.js";
 import { readAcroForm } from "./form.js";
 import { readXmpMetadata } from "./xmp.js";
 import { readOptionalContent } from "./optional-content.js";
@@ -17,10 +16,8 @@ import { NOOP_DIAGNOSTIC_SINK, PdfParseError } from "./diagnostics.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 { interpretContentStream } from "./interpret.js";
+import { t as interpretContentStream } from "./interpret-aWWhdIzr.js";
 import { createDestinationRegistry, readOutline } from "./navigation.js";
-import { bytesToBase64 } from "byte-codec";
 //#region src/read.ts
 const PDF_HEADER_BYTES = new TextEncoder().encode("%PDF-");
 const HEADER_SEARCH_WINDOW = 1024;
@@ -344,291 +341,6 @@ function withStructure(item, structure) {
 		structure
 	};
 }
-function convertExtractedItem(item, pageMatrix, fontResolver, images, imageIdCache, resolver, sink) {
-	if (item.kind === "text") return convertText(item, pageMatrix, fontResolver);
-	if (item.kind === "rect") return convertRect(item, pageMatrix);
-	if (item.kind === "ellipse") return convertEllipse(item, pageMatrix);
-	if (item.kind === "line") return convertLine(item, pageMatrix);
-	if (item.kind === "path") return convertPath(item, pageMatrix);
-	if (item.kind === "image") return convertImage(item, pageMatrix, images, imageIdCache, resolver, sink);
-	return convertInlineImage(item, pageMatrix, images, resolver, sink);
-}
-function convertText(item, pageMatrix, fontResolver) {
-	const font = fontResolver.resolve(item.fontResourceName, item.resources);
-	const text = font?.decodeToUnicode(item.codes) ?? "";
-	if (text.length === 0) return;
-	const startTrm = multiplyMatrices(item.startMatrix, pageMatrix);
-	const endTrm = multiplyMatrices(item.endMatrix, pageMatrix);
-	const widthPt = Math.hypot(endTrm[4] - startTrm[4], endTrm[5] - startTrm[5]);
-	const sizePt = matrixScaleX(startTrm);
-	const rotationDeg = matrixRotationDegrees(startTrm);
-	const layoutFont = {
-		family: font?.family ?? "Helvetica",
-		weight: font?.bold === true ? "bold" : "normal",
-		style: font?.italic === true ? "italic" : "normal"
-	};
-	return {
-		kind: "text",
-		text,
-		xPt: startTrm[4],
-		yPt: startTrm[5],
-		font: layoutFont,
-		sizePt: sizePt > 0 ? sizePt : item.sizePt,
-		color: item.color,
-		widthPt,
-		rotationDeg: rotationDeg !== 0 ? rotationDeg : void 0,
-		...item.vertical === true ? { writingMode: "vertical" } : {},
-		...item.layerName !== void 0 ? { layer: item.layerName } : {},
-		...item.actualText !== void 0 ? { actualText: item.actualText } : {},
-		...item.alt !== void 0 ? { alt: item.alt } : {}
-	};
-}
-function paintFields(paint) {
-	return {
-		...paint.fill !== void 0 ? { fill: paint.fill } : {},
-		...paint.stroke !== void 0 ? { stroke: paint.stroke } : {}
-	};
-}
-function transformBox(item, pageMatrix) {
-	const p1 = applyMatrix(pageMatrix, {
-		x: item.xPt,
-		y: item.yPt
-	});
-	const p2 = applyMatrix(pageMatrix, {
-		x: item.xPt + item.widthPt,
-		y: item.yPt + item.heightPt
-	});
-	return {
-		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)
-	};
-}
-function convertRect(item, pageMatrix) {
-	return {
-		kind: "rect",
-		...transformBox(item, pageMatrix),
-		...paintFields(item),
-		...item.layerName !== void 0 ? { layer: item.layerName } : {}
-	};
-}
-function convertEllipse(item, pageMatrix) {
-	return {
-		kind: "ellipse",
-		...transformBox(item, pageMatrix),
-		...paintFields(item),
-		...item.layerName !== void 0 ? { layer: item.layerName } : {}
-	};
-}
-function convertLine(item, pageMatrix) {
-	const p1 = applyMatrix(pageMatrix, {
-		x: item.x1Pt,
-		y: item.y1Pt
-	});
-	const p2 = applyMatrix(pageMatrix, {
-		x: item.x2Pt,
-		y: item.y2Pt
-	});
-	return {
-		kind: "line",
-		x1Pt: p1.x,
-		y1Pt: p1.y,
-		x2Pt: p2.x,
-		y2Pt: p2.y,
-		color: item.color,
-		widthPt: item.widthPt,
-		...item.style !== void 0 ? { style: item.style } : {},
-		...item.layerName !== void 0 ? { layer: item.layerName } : {}
-	};
-}
-function transformSubpath(subpath, pageMatrix) {
-	const start = applyMatrix(pageMatrix, {
-		x: subpath.startXPt,
-		y: subpath.startYPt
-	});
-	const segments = subpath.segments.map((segment) => {
-		if (segment.kind === "line") {
-			const p = applyMatrix(pageMatrix, {
-				x: segment.xPt,
-				y: segment.yPt
-			});
-			return {
-				kind: "line",
-				xPt: p.x,
-				yPt: p.y
-			};
-		}
-		const c1 = applyMatrix(pageMatrix, {
-			x: segment.c1xPt,
-			y: segment.c1yPt
-		});
-		const c2 = applyMatrix(pageMatrix, {
-			x: segment.c2xPt,
-			y: segment.c2yPt
-		});
-		const p = applyMatrix(pageMatrix, {
-			x: segment.xPt,
-			y: segment.yPt
-		});
-		return {
-			kind: "cubic",
-			c1xPt: c1.x,
-			c1yPt: c1.y,
-			c2xPt: c2.x,
-			c2yPt: c2.y,
-			xPt: p.x,
-			yPt: p.y
-		};
-	});
-	return {
-		startXPt: start.x,
-		startYPt: start.y,
-		segments,
-		closed: subpath.closed
-	};
-}
-function convertPath(item, pageMatrix) {
-	return {
-		kind: "path",
-		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.style !== void 0 ? { style: item.style } : {},
-		...item.layerName !== void 0 ? { layer: item.layerName } : {}
-	};
-}
-function imagePlacementFrom(matrix) {
-	const rotationDeg = matrixRotationDegrees(matrix);
-	return {
-		xPt: matrix[4],
-		yPt: matrix[5],
-		widthPt: matrixScaleX(matrix),
-		heightPt: matrixScaleY(matrix),
-		rotationDeg: rotationDeg !== 0 ? rotationDeg : void 0
-	};
-}
-const HEX_RADIX = 16;
-function registerExtractedImage(format, bytes, widthPx, heightPx, images, original) {
-	const imageId = `img${crc32(bytes).toString(HEX_RADIX)}`;
-	if (!(imageId in images)) images[imageId] = {
-		format,
-		base64: bytesToBase64(bytes),
-		widthPx,
-		heightPx,
-		...original !== void 0 ? { original: {
-			filter: original.filter,
-			base64: bytesToBase64(original.bytes),
-			...original.globalsBytes !== void 0 ? { jbig2GlobalsBase64: bytesToBase64(original.globalsBytes) } : {}
-		} } : {}
-	};
-	return imageId;
-}
-function resolveCachedImageId(dict, raw, images, cache, resolver, sink) {
-	if (cache.has(dict)) return cache.get(dict) ?? void 0;
-	const decoded = readImageXObject(dict, raw, resolver, sink);
-	if (decoded === void 0) {
-		cache.set(dict, null);
-		return;
-	}
-	const imageId = registerExtractedImage(decoded.format, decoded.bytes, decoded.widthPx, decoded.heightPx, images, decoded.original);
-	cache.set(dict, imageId);
-	return imageId;
-}
-function convertImage(item, pageMatrix, images, cache, resolver, sink) {
-	const xobjects = resolver.resolveDict(dictGet(item.resources, "XObject"));
-	const xobj = xobjects !== void 0 ? resolver.resolve(dictGet(xobjects, item.resourceName)) : void 0;
-	if (xobj?.kind !== "stream") return;
-	const imageId = resolveCachedImageId(xobj.dict, xobj.raw, images, cache, resolver, sink);
-	if (imageId === void 0) return;
-	return {
-		kind: "image",
-		imageId,
-		...imagePlacementFrom(multiplyMatrices(item.matrix, pageMatrix)),
-		...item.layerName !== void 0 ? { layer: item.layerName } : {}
-	};
-}
-function convertInlineImage(item, pageMatrix, images, resolver, sink) {
-	const decoded = readImageXObject(item.dict, item.data, resolver, sink);
-	if (decoded === void 0) return;
-	return {
-		kind: "image",
-		imageId: registerExtractedImage(decoded.format, decoded.bytes, decoded.widthPx, decoded.heightPx, images, decoded.original),
-		...imagePlacementFrom(multiplyMatrices(item.matrix, pageMatrix)),
-		...item.layerName !== void 0 ? { layer: item.layerName } : {}
-	};
-}
-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 rectArr = asArray(dictGet(annot, "Rect"));
-		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;
-		const y2 = asNumber(rectArr[3]) ?? 0;
-		const p1 = applyMatrix(pageMatrix, {
-			x: Math.min(x1, x2),
-			y: Math.min(y1, y2)
-		});
-		const p2 = applyMatrix(pageMatrix, {
-			x: Math.max(x1, x2),
-			y: Math.max(y1, y2)
-		});
-		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),
-			...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;
-}
-function readLinkUri(annot, resolver) {
-	const action = resolver.resolveDict(dictGet(annot, "A"));
-	if (action === void 0 || asName(dictGet(action, "S")) !== "URI") return;
-	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;
-	for (const annotRef of annotsArr) {
-		const annot = resolver.resolveDict(annotRef);
-		if (annot === void 0 || asName(dictGet(annot, "Subtype")) !== "Text") continue;
-		const titleObj = dictGet(annot, "T");
-		if ((titleObj?.kind === "string" ? decodePdfString(titleObj.bytes) : void 0) !== "documents.js:notes") continue;
-		const contentsObj = dictGet(annot, "Contents");
-		if (contentsObj?.kind === "string") return decodePdfString(contentsObj.bytes);
-	}
-}
 function readMetadata(trailer, resolver, catalog, sink) {
 	const info = resolver.resolveDict(dictGet(trailer, "Info"));
 	if (info === void 0) return {};

package/dist/structure.d.cts

@@ -1,6 +1,6 @@
-import { PdfDiagnosticSink } from "./diagnostics.cjs";
+import { i as PdfDiagnosticSink } from "./diagnostics-C9FxfZ6H.cjs";
 import { n as PdfDict } from "./objects-e2RS3-yT.cjs";
-import { PdfObjectResolver } from "./interpret.cjs";
+import { PdfObjectResolver } from "./interpret-types.cjs";
 import { LayoutStructureElement } from "./layout.cjs";
 //#region src/structure.d.ts
 interface StructureContext {

package/dist/structure.d.ts

@@ -1,6 +1,6 @@
-import { PdfDiagnosticSink } from "./diagnostics.js";
+import { i as PdfDiagnosticSink } from "./diagnostics-C9FxfZ6H.js";
 import { n as PdfDict } from "./objects-e2RS3-yT.js";
-import { PdfObjectResolver } from "./interpret.js";
+import { PdfObjectResolver } from "./interpret-types.js";
 import { LayoutStructureElement } from "./layout.js";
 //#region src/structure.d.ts
 interface StructureContext {

package/dist/winansi.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_afm_widths = require("./afm-widths-BHD2HZIL.cjs");
+const require_afm_widths = require("./afm-widths-C6U0SQj9.cjs");
 exports.encodeForShow = require_afm_widths.encodeForShow;
 exports.sanitizeToWinAnsi = require_afm_widths.sanitizeToWinAnsi;
 exports.winAnsiCodeToUnicode = require_afm_widths.winAnsiCodeToUnicode;

package/dist/winansi.js

@@ -1,2 +1,2 @@
-import { _ as winAnsiCodeToUnicode, g as sanitizeToWinAnsi, h as encodeForShow } from "./afm-widths-B_IGbGky.js";
+import { c as sanitizeToWinAnsi, l as winAnsiCodeToUnicode, s as encodeForShow } from "./afm-widths-p3UfaXme.js";
 export { encodeForShow, sanitizeToWinAnsi, winAnsiCodeToUnicode };

package/dist/write-annotations.cjs

@@ -0,0 +1,132 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_notes_annotation_author = require("./notes-annotation-author.cjs");
+const require_objects = require("./objects.cjs");
+const require_bytes_reader = require("./bytes/reader.cjs");
+const require_parse = require("./parse.cjs");
+const require_write_strings = require("./write-strings.cjs");
+//#region src/write-annotations.ts
+function buildLinkAnnotDict(link) {
+	return require_objects.pdfDict({
+		Type: require_objects.pdfName("Annot"),
+		Subtype: require_objects.pdfName("Link"),
+		Rect: require_objects.pdfArray([
+			link.xPt,
+			link.yPt,
+			link.xPt + link.widthPt,
+			link.yPt + link.heightPt
+		].map((n) => require_objects.pdfNum(n))),
+		Border: require_objects.pdfArray([
+			0,
+			0,
+			0
+		].map((n) => require_objects.pdfNum(n))),
+		A: require_objects.pdfDict({
+			Type: require_objects.pdfName("Action"),
+			S: require_objects.pdfName("URI"),
+			URI: require_objects.pdfHexString(new TextEncoder().encode(link.uri))
+		})
+	});
+}
+function destinationViewArray(target) {
+	const n = (value) => value === void 0 ? require_objects.pdfNull() : require_objects.pdfNum(value);
+	if (target.kind === "xyz") return [
+		require_objects.pdfName("XYZ"),
+		n(target.leftPt),
+		n(target.topPt),
+		n(target.zoom)
+	];
+	if (target.kind === "fitH") return [require_objects.pdfName("FitH"), n(target.topPt)];
+	if (target.kind === "fitV") return [require_objects.pdfName("FitV"), n(target.leftPt)];
+	if (target.kind === "fitR") return [
+		require_objects.pdfName("FitR"),
+		n(target.leftPt),
+		n(target.bottomPt),
+		n(target.rightPt),
+		n(target.topPt)
+	];
+	if (target.kind === "fitBH") return [require_objects.pdfName("FitBH"), n(target.topPt)];
+	if (target.kind === "fitBV") return [require_objects.pdfName("FitBV"), n(target.leftPt)];
+	return [require_objects.pdfName(target.kind === "fitB" ? "FitB" : "Fit")];
+}
+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 "${destination.name}" names page index ${destination.pageIndex}, which is beyond the document's own pages — this is a caller-invariant violation`);
+	return [require_objects.pdfRef(targetPage.pageNum, 0), ...destinationViewArray(destination.target)];
+}
+function buildInternalLinkAnnotDict(link, doc, pageAllocs) {
+	return require_objects.pdfDict({
+		Type: require_objects.pdfName("Annot"),
+		Subtype: require_objects.pdfName("Link"),
+		Rect: require_objects.pdfArray([
+			link.xPt,
+			link.yPt,
+			link.xPt + link.widthPt,
+			link.yPt + link.heightPt
+		].map((v) => require_objects.pdfNum(v))),
+		Border: require_objects.pdfArray([
+			0,
+			0,
+			0
+		].map((v) => require_objects.pdfNum(v))),
+		Dest: require_objects.pdfArray(resolveDestinationArray(doc, pageAllocs, link.destination, "internal link"))
+	});
+}
+function isLinkItem(item) {
+	return item.kind === "link";
+}
+function isInternalLinkItem(item) {
+	return item.kind === "internalLink";
+}
+const NOTES_ANNOTATION_HIDDEN_FLAG = 2;
+function buildNotesAnnotDict(notes) {
+	return require_objects.pdfDict({
+		Type: require_objects.pdfName("Annot"),
+		Subtype: require_objects.pdfName("Text"),
+		Rect: require_objects.pdfArray([
+			0,
+			0,
+			0,
+			0
+		].map((n) => require_objects.pdfNum(n))),
+		Contents: require_write_strings.textToPdfString(notes),
+		T: require_write_strings.textToPdfString(require_notes_annotation_author.NOTES_ANNOTATION_AUTHOR),
+		F: require_objects.pdfNum(NOTES_ANNOTATION_HIDDEN_FLAG)
+	});
+}
+const XREF_OFFSET_DIGITS = 10;
+const XREF_GENERATION_DIGITS = 5;
+function xrefEntry(offset, generation, inUse) {
+	return `${offset.toString().padStart(XREF_OFFSET_DIGITS, "0")} ${generation.toString().padStart(XREF_GENERATION_DIGITS, "0")} ${inUse ? "n" : "f"} \n`;
+}
+function parseResidueRow(residue) {
+	const reader = new require_bytes_reader.ByteReader(new TextEncoder().encode(residue.xml));
+	return require_parse.parseValue(reader, () => void 0);
+}
+function objectContainsReference(obj) {
+	if (obj.kind === "ref") return true;
+	if (obj.kind === "array") return obj.items.some(objectContainsReference);
+	if (obj.kind === "dict") return [...obj.entries.values()].some(objectContainsReference);
+	if (obj.kind === "stream") return [...obj.dict.entries.values()].some(objectContainsReference);
+	return false;
+}
+function restoreResidueRow(source, key) {
+	const row = source?.[key];
+	if (row === void 0) return;
+	const parsed = parseResidueRow(row);
+	if (parsed === void 0 || objectContainsReference(parsed)) return;
+	return parsed;
+}
+//#endregion
+exports.buildInternalLinkAnnotDict = buildInternalLinkAnnotDict;
+exports.buildLinkAnnotDict = buildLinkAnnotDict;
+exports.buildNotesAnnotDict = buildNotesAnnotDict;
+exports.destinationViewArray = destinationViewArray;
+exports.isInternalLinkItem = isInternalLinkItem;
+exports.isLinkItem = isLinkItem;
+exports.objectContainsReference = objectContainsReference;
+exports.parseResidueRow = parseResidueRow;
+exports.resolveDestinationArray = resolveDestinationArray;
+exports.restoreResidueRow = restoreResidueRow;
+exports.xrefEntry = xrefEntry;

package/dist/write-annotations.d.cts

@@ -0,0 +1,29 @@
+import { r as PdfObject } from "./objects-e2RS3-yT.cjs";
+import { LayoutDestinationTarget, LayoutDocument, LayoutInternalLink, LayoutLink } from "./layout.cjs";
+import { SourceResidue } from "document-schema.js";
+//#region src/write-annotations.d.ts
+declare function buildLinkAnnotDict(link: Readonly<LayoutLink>): PdfObject;
+declare function destinationViewArray(target: Readonly<LayoutDestinationTarget>): PdfObject[];
+declare function resolveDestinationArray(doc: LayoutDocument, pageAllocs: readonly {
+  pageNum: number;
+}[], name: string, what: string): PdfObject[];
+declare function buildInternalLinkAnnotDict(link: Readonly<LayoutInternalLink>, doc: LayoutDocument, pageAllocs: readonly {
+  pageNum: number;
+}[]): PdfObject;
+declare function isLinkItem(item: {
+  readonly kind: string;
+}): item is LayoutLink;
+declare function isInternalLinkItem(item: {
+  readonly kind: string;
+}): item is LayoutInternalLink;
+declare function buildNotesAnnotDict(notes: string): PdfObject;
+interface AllocatedObject {
+  readonly num: number;
+  readonly value: PdfObject;
+}
+declare function xrefEntry(offset: number, generation: number, inUse: boolean): string;
+declare function parseResidueRow(residue: Readonly<SourceResidue>): PdfObject | undefined;
+declare function objectContainsReference(obj: PdfObject): boolean;
+declare function restoreResidueRow(source: Record<string, SourceResidue> | undefined, key: string): PdfObject | undefined;
+//#endregion
+export { AllocatedObject, buildInternalLinkAnnotDict, buildLinkAnnotDict, buildNotesAnnotDict, destinationViewArray, isInternalLinkItem, isLinkItem, objectContainsReference, parseResidueRow, resolveDestinationArray, restoreResidueRow, xrefEntry };

package/dist/write-annotations.d.ts

@@ -0,0 +1,29 @@
+import { r as PdfObject } from "./objects-e2RS3-yT.js";
+import { LayoutDestinationTarget, LayoutDocument, LayoutInternalLink, LayoutLink } from "./layout.js";
+import { SourceResidue } from "document-schema.js";
+//#region src/write-annotations.d.ts
+declare function buildLinkAnnotDict(link: Readonly<LayoutLink>): PdfObject;
+declare function destinationViewArray(target: Readonly<LayoutDestinationTarget>): PdfObject[];
+declare function resolveDestinationArray(doc: LayoutDocument, pageAllocs: readonly {
+  pageNum: number;
+}[], name: string, what: string): PdfObject[];
+declare function buildInternalLinkAnnotDict(link: Readonly<LayoutInternalLink>, doc: LayoutDocument, pageAllocs: readonly {
+  pageNum: number;
+}[]): PdfObject;
+declare function isLinkItem(item: {
+  readonly kind: string;
+}): item is LayoutLink;
+declare function isInternalLinkItem(item: {
+  readonly kind: string;
+}): item is LayoutInternalLink;
+declare function buildNotesAnnotDict(notes: string): PdfObject;
+interface AllocatedObject {
+  readonly num: number;
+  readonly value: PdfObject;
+}
+declare function xrefEntry(offset: number, generation: number, inUse: boolean): string;
+declare function parseResidueRow(residue: Readonly<SourceResidue>): PdfObject | undefined;
+declare function objectContainsReference(obj: PdfObject): boolean;
+declare function restoreResidueRow(source: Record<string, SourceResidue> | undefined, key: string): PdfObject | undefined;
+//#endregion
+export { AllocatedObject, buildInternalLinkAnnotDict, buildLinkAnnotDict, buildNotesAnnotDict, destinationViewArray, isInternalLinkItem, isLinkItem, objectContainsReference, parseResidueRow, resolveDestinationArray, restoreResidueRow, xrefEntry };

package/dist/write-annotations.js

@@ -0,0 +1,121 @@
+import { NOTES_ANNOTATION_AUTHOR } from "./notes-annotation-author.js";
+import { pdfArray, pdfDict, pdfHexString, pdfName, pdfNull, pdfNum, pdfRef } from "./objects.js";
+import { ByteReader } from "./bytes/reader.js";
+import { parseValue } from "./parse.js";
+import { textToPdfString } from "./write-strings.js";
+//#region src/write-annotations.ts
+function buildLinkAnnotDict(link) {
+	return pdfDict({
+		Type: pdfName("Annot"),
+		Subtype: pdfName("Link"),
+		Rect: pdfArray([
+			link.xPt,
+			link.yPt,
+			link.xPt + link.widthPt,
+			link.yPt + link.heightPt
+		].map((n) => pdfNum(n))),
+		Border: pdfArray([
+			0,
+			0,
+			0
+		].map((n) => pdfNum(n))),
+		A: pdfDict({
+			Type: pdfName("Action"),
+			S: pdfName("URI"),
+			URI: pdfHexString(new TextEncoder().encode(link.uri))
+		})
+	});
+}
+function destinationViewArray(target) {
+	const n = (value) => value === void 0 ? pdfNull() : pdfNum(value);
+	if (target.kind === "xyz") return [
+		pdfName("XYZ"),
+		n(target.leftPt),
+		n(target.topPt),
+		n(target.zoom)
+	];
+	if (target.kind === "fitH") return [pdfName("FitH"), n(target.topPt)];
+	if (target.kind === "fitV") return [pdfName("FitV"), n(target.leftPt)];
+	if (target.kind === "fitR") return [
+		pdfName("FitR"),
+		n(target.leftPt),
+		n(target.bottomPt),
+		n(target.rightPt),
+		n(target.topPt)
+	];
+	if (target.kind === "fitBH") return [pdfName("FitBH"), n(target.topPt)];
+	if (target.kind === "fitBV") return [pdfName("FitBV"), n(target.leftPt)];
+	return [pdfName(target.kind === "fitB" ? "FitB" : "Fit")];
+}
+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 "${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"),
+		Rect: pdfArray([
+			link.xPt,
+			link.yPt,
+			link.xPt + link.widthPt,
+			link.yPt + link.heightPt
+		].map((v) => pdfNum(v))),
+		Border: pdfArray([
+			0,
+			0,
+			0
+		].map((v) => pdfNum(v))),
+		Dest: pdfArray(resolveDestinationArray(doc, pageAllocs, link.destination, "internal link"))
+	});
+}
+function isLinkItem(item) {
+	return item.kind === "link";
+}
+function isInternalLinkItem(item) {
+	return item.kind === "internalLink";
+}
+const NOTES_ANNOTATION_HIDDEN_FLAG = 2;
+function buildNotesAnnotDict(notes) {
+	return pdfDict({
+		Type: pdfName("Annot"),
+		Subtype: pdfName("Text"),
+		Rect: pdfArray([
+			0,
+			0,
+			0,
+			0
+		].map((n) => pdfNum(n))),
+		Contents: textToPdfString(notes),
+		T: textToPdfString(NOTES_ANNOTATION_AUTHOR),
+		F: pdfNum(NOTES_ANNOTATION_HIDDEN_FLAG)
+	});
+}
+const XREF_OFFSET_DIGITS = 10;
+const XREF_GENERATION_DIGITS = 5;
+function xrefEntry(offset, generation, inUse) {
+	return `${offset.toString().padStart(XREF_OFFSET_DIGITS, "0")} ${generation.toString().padStart(XREF_GENERATION_DIGITS, "0")} ${inUse ? "n" : "f"} \n`;
+}
+function parseResidueRow(residue) {
+	const reader = new ByteReader(new TextEncoder().encode(residue.xml));
+	return parseValue(reader, () => void 0);
+}
+function objectContainsReference(obj) {
+	if (obj.kind === "ref") return true;
+	if (obj.kind === "array") return obj.items.some(objectContainsReference);
+	if (obj.kind === "dict") return [...obj.entries.values()].some(objectContainsReference);
+	if (obj.kind === "stream") return [...obj.dict.entries.values()].some(objectContainsReference);
+	return false;
+}
+function restoreResidueRow(source, key) {
+	const row = source?.[key];
+	if (row === void 0) return;
+	const parsed = parseResidueRow(row);
+	if (parsed === void 0 || objectContainsReference(parsed)) return;
+	return parsed;
+}
+//#endregion
+export { buildInternalLinkAnnotDict, buildLinkAnnotDict, buildNotesAnnotDict, destinationViewArray, isInternalLinkItem, isLinkItem, objectContainsReference, parseResidueRow, resolveDestinationArray, restoreResidueRow, xrefEntry };