pdf-codec 1.3.0 → 1.4.0

package/dist/content-write.cjs

@@ -0,0 +1,138 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_afm_widths = require("./afm-widths-BoeTOK2r.cjs");
+const require_bytes_writer = require("./bytes/writer.cjs");
+const require_objects = require("./objects.cjs");
+const require_matrix = require("./matrix.cjs");
+const require_serialize = require("./serialize.cjs");
+//#region src/content-write.ts
+const BEZIER_KAPPA = .5522847498;
+function writeRgbOperator(writer, color, operator) {
+	writer.writeAscii(`${require_serialize.formatNumber(color.r)} ${require_serialize.formatNumber(color.g)} ${require_serialize.formatNumber(color.b)} ${operator}\n`);
+}
+function writeMatrixOperator(writer, m, operator) {
+	writer.writeAscii(`${m.map(require_serialize.formatNumber).join(" ")} ${operator}\n`);
+}
+function anchorMatrix(xPt, yPt, rotationDeg) {
+	const r = require_matrix.rotationMatrix(rotationDeg ?? 0);
+	return [
+		r[0],
+		r[1],
+		r[2],
+		r[3],
+		xPt,
+		yPt
+	];
+}
+function writeUnderline(writer, item, widthPt, measurer) {
+	const underline = measurer.underlineAtSize(item.font, item.sizePt);
+	writer.writeAscii("q\n");
+	writeMatrixOperator(writer, anchorMatrix(item.xPt, item.yPt, item.rotationDeg), "cm");
+	writeRgbOperator(writer, item.color, "rg");
+	writer.writeAscii(`0 ${require_serialize.formatNumber(underline.offsetPt)} ${require_serialize.formatNumber(widthPt)} ${require_serialize.formatNumber(underline.thicknessPt)} re\n`);
+	writer.writeAscii("f\n");
+	writer.writeAscii("Q\n");
+}
+function writeText(writer, item, context, substitutions) {
+	const font = context.resolveFont(item.font);
+	const encoded = require_afm_widths.encodeForShow(item.text, font.standardName);
+	substitutions.push(...encoded.substitutions);
+	const scalePercent = context.measurer.horizontalScaleFor(item.font) * 100;
+	writer.writeAscii("BT\n");
+	writer.writeAscii(`/${font.resourceName} ${require_serialize.formatNumber(item.sizePt)} Tf\n`);
+	writer.writeAscii(`${require_serialize.formatNumber(scalePercent)} Tz\n`);
+	writeRgbOperator(writer, item.color, "rg");
+	writeMatrixOperator(writer, anchorMatrix(item.xPt, item.yPt, item.rotationDeg), "Tm");
+	require_serialize.writeObject(writer, require_objects.pdfHexString(encoded.codes));
+	writer.writeAscii(" Tj\n");
+	writer.writeAscii("ET\n");
+	if (item.underline === true) {
+		const scale = context.measurer.horizontalScaleFor(item.font);
+		writeUnderline(writer, item, item.widthPt ?? encoded.width1000 / 1e3 * item.sizePt * scale, context.measurer);
+	}
+}
+function paintOperatorFor(fill, stroke, fillRule) {
+	const evenOdd = fillRule === "evenodd";
+	if (fill !== void 0 && stroke !== void 0) return evenOdd ? "B*" : "B";
+	if (fill !== void 0) return evenOdd ? "f*" : "f";
+	if (stroke !== void 0) return "S";
+}
+function formatPoint(x, y) {
+	return `${require_serialize.formatNumber(x)} ${require_serialize.formatNumber(y)}`;
+}
+function writeFillAndStroke(writer, fill, stroke) {
+	if (fill !== void 0) writeRgbOperator(writer, fill, "rg");
+	if (stroke !== void 0) {
+		writeRgbOperator(writer, stroke.color, "RG");
+		writer.writeAscii(`${require_serialize.formatNumber(stroke.widthPt)} w\n`);
+	}
+}
+function writeRect(writer, item) {
+	const paint = paintOperatorFor(item.fill, item.stroke);
+	if (paint === void 0) return;
+	writeFillAndStroke(writer, item.fill, item.stroke);
+	writer.writeAscii(`${require_serialize.formatNumber(item.xPt)} ${require_serialize.formatNumber(item.yPt)} ${require_serialize.formatNumber(item.widthPt)} ${require_serialize.formatNumber(item.heightPt)} re\n`);
+	writer.writeAscii(`${paint}\n`);
+}
+function writeLine(writer, item) {
+	writeRgbOperator(writer, item.color, "RG");
+	writer.writeAscii(`${require_serialize.formatNumber(item.widthPt)} w\n`);
+	writer.writeAscii(`${require_serialize.formatNumber(item.x1Pt)} ${require_serialize.formatNumber(item.y1Pt)} m ${require_serialize.formatNumber(item.x2Pt)} ${require_serialize.formatNumber(item.y2Pt)} l\n`);
+	writer.writeAscii("S\n");
+}
+function writeEllipse(writer, item) {
+	const paint = paintOperatorFor(item.fill, item.stroke);
+	if (paint === void 0) return;
+	writeFillAndStroke(writer, item.fill, item.stroke);
+	const cx = item.xPt + item.widthPt / 2;
+	const cy = item.yPt + item.heightPt / 2;
+	const rx = item.widthPt / 2;
+	const ry = item.heightPt / 2;
+	const kx = rx * BEZIER_KAPPA;
+	const ky = ry * BEZIER_KAPPA;
+	writer.writeAscii(`${formatPoint(cx + rx, cy)} m\n`);
+	writer.writeAscii(`${formatPoint(cx + rx, cy + ky)} ${formatPoint(cx + kx, cy + ry)} ${formatPoint(cx, cy + ry)} c\n`);
+	writer.writeAscii(`${formatPoint(cx - kx, cy + ry)} ${formatPoint(cx - rx, cy + ky)} ${formatPoint(cx - rx, cy)} c\n`);
+	writer.writeAscii(`${formatPoint(cx - rx, cy - ky)} ${formatPoint(cx - kx, cy - ry)} ${formatPoint(cx, cy - ry)} c\n`);
+	writer.writeAscii(`${formatPoint(cx + kx, cy - ry)} ${formatPoint(cx + rx, cy - ky)} ${formatPoint(cx + rx, cy)} c\n`);
+	writer.writeAscii("h\n");
+	writer.writeAscii(`${paint}\n`);
+}
+function writeSubpath(writer, subpath) {
+	writer.writeAscii(`${formatPoint(subpath.startXPt, subpath.startYPt)} m\n`);
+	for (const segment of subpath.segments) if (segment.kind === "line") writer.writeAscii(`${formatPoint(segment.xPt, segment.yPt)} l\n`);
+	else writer.writeAscii(`${formatPoint(segment.c1xPt, segment.c1yPt)} ${formatPoint(segment.c2xPt, segment.c2yPt)} ${formatPoint(segment.xPt, segment.yPt)} c\n`);
+	if (subpath.closed) writer.writeAscii("h\n");
+}
+function writePath(writer, item) {
+	const paint = paintOperatorFor(item.fill, item.stroke, item.fillRule);
+	if (paint === void 0) return;
+	writeFillAndStroke(writer, item.fill, item.stroke);
+	for (const subpath of item.subpaths) writeSubpath(writer, subpath);
+	writer.writeAscii(`${paint}\n`);
+}
+function writeImage(writer, item, context) {
+	const image = context.resolveImage(item.imageId);
+	const scaled = require_matrix.scaleMatrix(item.widthPt, item.heightPt);
+	const rotated = require_matrix.multiplyMatrices(scaled, require_matrix.rotationMatrix(item.rotationDeg ?? 0));
+	const placed = require_matrix.multiplyMatrices(rotated, require_matrix.translationMatrix(item.xPt, item.yPt));
+	writer.writeAscii("q\n");
+	writeMatrixOperator(writer, placed, "cm");
+	writer.writeAscii(`/${image.resourceName} Do\n`);
+	writer.writeAscii("Q\n");
+}
+function writeContentStream(items, context) {
+	const writer = new require_bytes_writer.ByteWriter();
+	const substitutions = [];
+	for (const item of items) if (item.kind === "text") writeText(writer, item, context, substitutions);
+	else if (item.kind === "image") writeImage(writer, item, context);
+	else if (item.kind === "rect") writeRect(writer, item);
+	else if (item.kind === "line") writeLine(writer, item);
+	else if (item.kind === "ellipse") writeEllipse(writer, item);
+	else if (item.kind === "path") writePath(writer, item);
+	return {
+		bytes: writer.toBytes(),
+		substitutions
+	};
+}
+//#endregion
+exports.writeContentStream = writeContentStream;

package/dist/content-write.d.cts

@@ -0,0 +1,24 @@
+import { r as StandardFontName } from "./afm-widths-DyDq56Ph.cjs";
+import { TextMeasurer } from "./measure.cjs";
+import { WinAnsiSubstitution } from "./winansi.cjs";
+import { LayoutFont, LayoutItem } from "document-schema.js";
+//#region src/content-write.d.ts
+interface ResolvedFontResource {
+  readonly resourceName: string;
+  readonly standardName: StandardFontName;
+}
+interface ResolvedImageResource {
+  readonly resourceName: string;
+}
+interface ContentWriteContext {
+  readonly measurer: TextMeasurer;
+  resolveFont(font: LayoutFont): ResolvedFontResource;
+  resolveImage(imageId: string): ResolvedImageResource;
+}
+interface ContentStreamResult {
+  readonly bytes: Uint8Array<ArrayBuffer>;
+  readonly substitutions: readonly WinAnsiSubstitution[];
+}
+declare function writeContentStream(items: readonly LayoutItem[], context: ContentWriteContext): ContentStreamResult;
+//#endregion
+export { ContentStreamResult, ContentWriteContext, ResolvedFontResource, ResolvedImageResource, writeContentStream };

package/dist/content-write.d.ts

@@ -0,0 +1,24 @@
+import { r as StandardFontName } from "./afm-widths-DyDq56Ph.js";
+import { TextMeasurer } from "./measure.js";
+import { WinAnsiSubstitution } from "./winansi.js";
+import { LayoutFont, LayoutItem } from "document-schema.js";
+//#region src/content-write.d.ts
+interface ResolvedFontResource {
+  readonly resourceName: string;
+  readonly standardName: StandardFontName;
+}
+interface ResolvedImageResource {
+  readonly resourceName: string;
+}
+interface ContentWriteContext {
+  readonly measurer: TextMeasurer;
+  resolveFont(font: LayoutFont): ResolvedFontResource;
+  resolveImage(imageId: string): ResolvedImageResource;
+}
+interface ContentStreamResult {
+  readonly bytes: Uint8Array<ArrayBuffer>;
+  readonly substitutions: readonly WinAnsiSubstitution[];
+}
+declare function writeContentStream(items: readonly LayoutItem[], context: ContentWriteContext): ContentStreamResult;
+//#endregion
+export { ContentStreamResult, ContentWriteContext, ResolvedFontResource, ResolvedImageResource, writeContentStream };

package/dist/content-write.js

@@ -0,0 +1,137 @@
+import { o as encodeForShow } from "./afm-widths-Dxucrg7D.js";
+import { ByteWriter } from "./bytes/writer.js";
+import { pdfHexString } from "./objects.js";
+import { multiplyMatrices, rotationMatrix, scaleMatrix, translationMatrix } from "./matrix.js";
+import { formatNumber, writeObject } from "./serialize.js";
+//#region src/content-write.ts
+const BEZIER_KAPPA = .5522847498;
+function writeRgbOperator(writer, color, operator) {
+	writer.writeAscii(`${formatNumber(color.r)} ${formatNumber(color.g)} ${formatNumber(color.b)} ${operator}\n`);
+}
+function writeMatrixOperator(writer, m, operator) {
+	writer.writeAscii(`${m.map(formatNumber).join(" ")} ${operator}\n`);
+}
+function anchorMatrix(xPt, yPt, rotationDeg) {
+	const r = rotationMatrix(rotationDeg ?? 0);
+	return [
+		r[0],
+		r[1],
+		r[2],
+		r[3],
+		xPt,
+		yPt
+	];
+}
+function writeUnderline(writer, item, widthPt, measurer) {
+	const underline = measurer.underlineAtSize(item.font, item.sizePt);
+	writer.writeAscii("q\n");
+	writeMatrixOperator(writer, anchorMatrix(item.xPt, item.yPt, item.rotationDeg), "cm");
+	writeRgbOperator(writer, item.color, "rg");
+	writer.writeAscii(`0 ${formatNumber(underline.offsetPt)} ${formatNumber(widthPt)} ${formatNumber(underline.thicknessPt)} re\n`);
+	writer.writeAscii("f\n");
+	writer.writeAscii("Q\n");
+}
+function writeText(writer, item, context, substitutions) {
+	const font = context.resolveFont(item.font);
+	const encoded = encodeForShow(item.text, font.standardName);
+	substitutions.push(...encoded.substitutions);
+	const scalePercent = context.measurer.horizontalScaleFor(item.font) * 100;
+	writer.writeAscii("BT\n");
+	writer.writeAscii(`/${font.resourceName} ${formatNumber(item.sizePt)} Tf\n`);
+	writer.writeAscii(`${formatNumber(scalePercent)} Tz\n`);
+	writeRgbOperator(writer, item.color, "rg");
+	writeMatrixOperator(writer, anchorMatrix(item.xPt, item.yPt, item.rotationDeg), "Tm");
+	writeObject(writer, pdfHexString(encoded.codes));
+	writer.writeAscii(" Tj\n");
+	writer.writeAscii("ET\n");
+	if (item.underline === true) {
+		const scale = context.measurer.horizontalScaleFor(item.font);
+		writeUnderline(writer, item, item.widthPt ?? encoded.width1000 / 1e3 * item.sizePt * scale, context.measurer);
+	}
+}
+function paintOperatorFor(fill, stroke, fillRule) {
+	const evenOdd = fillRule === "evenodd";
+	if (fill !== void 0 && stroke !== void 0) return evenOdd ? "B*" : "B";
+	if (fill !== void 0) return evenOdd ? "f*" : "f";
+	if (stroke !== void 0) return "S";
+}
+function formatPoint(x, y) {
+	return `${formatNumber(x)} ${formatNumber(y)}`;
+}
+function writeFillAndStroke(writer, fill, stroke) {
+	if (fill !== void 0) writeRgbOperator(writer, fill, "rg");
+	if (stroke !== void 0) {
+		writeRgbOperator(writer, stroke.color, "RG");
+		writer.writeAscii(`${formatNumber(stroke.widthPt)} w\n`);
+	}
+}
+function writeRect(writer, item) {
+	const paint = paintOperatorFor(item.fill, item.stroke);
+	if (paint === void 0) return;
+	writeFillAndStroke(writer, item.fill, item.stroke);
+	writer.writeAscii(`${formatNumber(item.xPt)} ${formatNumber(item.yPt)} ${formatNumber(item.widthPt)} ${formatNumber(item.heightPt)} re\n`);
+	writer.writeAscii(`${paint}\n`);
+}
+function writeLine(writer, item) {
+	writeRgbOperator(writer, item.color, "RG");
+	writer.writeAscii(`${formatNumber(item.widthPt)} w\n`);
+	writer.writeAscii(`${formatNumber(item.x1Pt)} ${formatNumber(item.y1Pt)} m ${formatNumber(item.x2Pt)} ${formatNumber(item.y2Pt)} l\n`);
+	writer.writeAscii("S\n");
+}
+function writeEllipse(writer, item) {
+	const paint = paintOperatorFor(item.fill, item.stroke);
+	if (paint === void 0) return;
+	writeFillAndStroke(writer, item.fill, item.stroke);
+	const cx = item.xPt + item.widthPt / 2;
+	const cy = item.yPt + item.heightPt / 2;
+	const rx = item.widthPt / 2;
+	const ry = item.heightPt / 2;
+	const kx = rx * BEZIER_KAPPA;
+	const ky = ry * BEZIER_KAPPA;
+	writer.writeAscii(`${formatPoint(cx + rx, cy)} m\n`);
+	writer.writeAscii(`${formatPoint(cx + rx, cy + ky)} ${formatPoint(cx + kx, cy + ry)} ${formatPoint(cx, cy + ry)} c\n`);
+	writer.writeAscii(`${formatPoint(cx - kx, cy + ry)} ${formatPoint(cx - rx, cy + ky)} ${formatPoint(cx - rx, cy)} c\n`);
+	writer.writeAscii(`${formatPoint(cx - rx, cy - ky)} ${formatPoint(cx - kx, cy - ry)} ${formatPoint(cx, cy - ry)} c\n`);
+	writer.writeAscii(`${formatPoint(cx + kx, cy - ry)} ${formatPoint(cx + rx, cy - ky)} ${formatPoint(cx + rx, cy)} c\n`);
+	writer.writeAscii("h\n");
+	writer.writeAscii(`${paint}\n`);
+}
+function writeSubpath(writer, subpath) {
+	writer.writeAscii(`${formatPoint(subpath.startXPt, subpath.startYPt)} m\n`);
+	for (const segment of subpath.segments) if (segment.kind === "line") writer.writeAscii(`${formatPoint(segment.xPt, segment.yPt)} l\n`);
+	else writer.writeAscii(`${formatPoint(segment.c1xPt, segment.c1yPt)} ${formatPoint(segment.c2xPt, segment.c2yPt)} ${formatPoint(segment.xPt, segment.yPt)} c\n`);
+	if (subpath.closed) writer.writeAscii("h\n");
+}
+function writePath(writer, item) {
+	const paint = paintOperatorFor(item.fill, item.stroke, item.fillRule);
+	if (paint === void 0) return;
+	writeFillAndStroke(writer, item.fill, item.stroke);
+	for (const subpath of item.subpaths) writeSubpath(writer, subpath);
+	writer.writeAscii(`${paint}\n`);
+}
+function writeImage(writer, item, context) {
+	const image = context.resolveImage(item.imageId);
+	const scaled = scaleMatrix(item.widthPt, item.heightPt);
+	const rotated = multiplyMatrices(scaled, rotationMatrix(item.rotationDeg ?? 0));
+	const placed = multiplyMatrices(rotated, translationMatrix(item.xPt, item.yPt));
+	writer.writeAscii("q\n");
+	writeMatrixOperator(writer, placed, "cm");
+	writer.writeAscii(`/${image.resourceName} Do\n`);
+	writer.writeAscii("Q\n");
+}
+function writeContentStream(items, context) {
+	const writer = new ByteWriter();
+	const substitutions = [];
+	for (const item of items) if (item.kind === "text") writeText(writer, item, context, substitutions);
+	else if (item.kind === "image") writeImage(writer, item, context);
+	else if (item.kind === "rect") writeRect(writer, item);
+	else if (item.kind === "line") writeLine(writer, item);
+	else if (item.kind === "ellipse") writeEllipse(writer, item);
+	else if (item.kind === "path") writePath(writer, item);
+	return {
+		bytes: writer.toBytes(),
+		substitutions
+	};
+}
+//#endregion
+export { writeContentStream };

package/dist/diagnostics.cjs

@@ -0,0 +1,21 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/diagnostics.ts
+const NOOP_DIAGNOSTIC_SINK = () => {};
+var PdfParseError = class extends Error {
+	code;
+	constructor(code, message) {
+		super(message);
+		this.name = "PdfParseError";
+		this.code = code;
+	}
+};
+var PdfEncryptedError = class extends PdfParseError {
+	constructor(message = "this PDF is encrypted and unsupported") {
+		super("pdf/encrypted", message);
+		this.name = "PdfEncryptedError";
+	}
+};
+//#endregion
+exports.NOOP_DIAGNOSTIC_SINK = NOOP_DIAGNOSTIC_SINK;
+exports.PdfEncryptedError = PdfEncryptedError;
+exports.PdfParseError = PdfParseError;

package/dist/diagnostics.d.cts

@@ -0,0 +1,19 @@
+//#region src/diagnostics.d.ts
+type PdfDiagnosticSeverity = 'info' | 'warning';
+interface PdfDiagnostic {
+  readonly code: string;
+  readonly severity: PdfDiagnosticSeverity;
+  readonly message: string;
+  readonly pageIndex?: number;
+}
+type PdfDiagnosticSink = (diagnostic: PdfDiagnostic) => void;
+declare const NOOP_DIAGNOSTIC_SINK: PdfDiagnosticSink;
+declare class PdfParseError extends Error {
+  readonly code: string;
+  constructor(code: string, message: string);
+}
+declare class PdfEncryptedError extends PdfParseError {
+  constructor(message?: string);
+}
+//#endregion
+export { NOOP_DIAGNOSTIC_SINK, PdfDiagnostic, PdfDiagnosticSeverity, PdfDiagnosticSink, PdfEncryptedError, PdfParseError };

package/dist/diagnostics.d.ts

@@ -0,0 +1,19 @@
+//#region src/diagnostics.d.ts
+type PdfDiagnosticSeverity = 'info' | 'warning';
+interface PdfDiagnostic {
+  readonly code: string;
+  readonly severity: PdfDiagnosticSeverity;
+  readonly message: string;
+  readonly pageIndex?: number;
+}
+type PdfDiagnosticSink = (diagnostic: PdfDiagnostic) => void;
+declare const NOOP_DIAGNOSTIC_SINK: PdfDiagnosticSink;
+declare class PdfParseError extends Error {
+  readonly code: string;
+  constructor(code: string, message: string);
+}
+declare class PdfEncryptedError extends PdfParseError {
+  constructor(message?: string);
+}
+//#endregion
+export { NOOP_DIAGNOSTIC_SINK, PdfDiagnostic, PdfDiagnosticSeverity, PdfDiagnosticSink, PdfEncryptedError, PdfParseError };

package/dist/diagnostics.js

@@ -0,0 +1,18 @@
+//#region src/diagnostics.ts
+const NOOP_DIAGNOSTIC_SINK = () => {};
+var PdfParseError = class extends Error {
+	code;
+	constructor(code, message) {
+		super(message);
+		this.name = "PdfParseError";
+		this.code = code;
+	}
+};
+var PdfEncryptedError = class extends PdfParseError {
+	constructor(message = "this PDF is encrypted and unsupported") {
+		super("pdf/encrypted", message);
+		this.name = "PdfEncryptedError";
+	}
+};
+//#endregion
+export { NOOP_DIAGNOSTIC_SINK, PdfEncryptedError, PdfParseError };

package/dist/document.cjs

@@ -0,0 +1,162 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_bytes_reader = require("./bytes/reader.cjs");
+const require_lexer = require("./lexer.cjs");
+const require_diagnostics = require("./diagnostics.cjs");
+const require_objects = require("./objects.cjs");
+const require_filters = require("./filters.cjs");
+const require_parse = require("./parse.cjs");
+const require_xref = require("./xref.cjs");
+//#region src/document.ts
+const MAX_RESOLVE_DEPTH = 64;
+const INHERITABLE_PAGE_KEYS = [
+	"Resources",
+	"MediaBox",
+	"CropBox",
+	"Rotate"
+];
+function openPdfDocument(bytes, sink) {
+	const xref = require_xref.readXref(bytes, sink);
+	if (require_objects.dictGet(xref.trailer, "Encrypt") !== void 0) throw new require_diagnostics.PdfEncryptedError();
+	const objectCache = /* @__PURE__ */ new Map();
+	const objStmCache = /* @__PURE__ */ new Map();
+	function fetchDirect(num, entry) {
+		const reader = new require_bytes_reader.ByteReader(bytes);
+		reader.seek(entry.offset);
+		const indirect = require_parse.parseIndirectObject(reader, sink);
+		if (indirect === void 0) {
+			sink({
+				code: "pdf/object-missing-value",
+				severity: "warning",
+				message: `object ${String(num)} could not be parsed at its recorded offset`
+			});
+			return require_objects.pdfNull();
+		}
+		return indirect.value;
+	}
+	function decodeObjectStream(streamObjNum) {
+		const cached = objStmCache.get(streamObjNum);
+		if (cached !== void 0) return cached;
+		const streamEntry = xref.entries.get(streamObjNum);
+		const streamObj = streamEntry?.type === "offset" ? fetchDirect(streamObjNum, streamEntry) : void 0;
+		if (streamObj?.kind !== "stream") {
+			sink({
+				code: "pdf/object-missing-value",
+				severity: "warning",
+				message: `object ${String(streamObjNum)} referenced as an object stream is not directly-located, or is not actually a stream`
+			});
+			objStmCache.set(streamObjNum, []);
+			return [];
+		}
+		const decoded = require_filters.decodeStream(streamObj.raw, streamObj.dict, sink);
+		const n = require_objects.asNumber(require_objects.dictGet(streamObj.dict, "N")) ?? 0;
+		const first = require_objects.asNumber(require_objects.dictGet(streamObj.dict, "First")) ?? 0;
+		const headerReader = new require_bytes_reader.ByteReader(decoded.bytes);
+		const relativeOffsets = [];
+		for (let i = 0; i < n; i++) {
+			const numTok = require_lexer.nextToken(headerReader);
+			const offTok = require_lexer.nextToken(headerReader);
+			if (numTok?.kind !== "number" || offTok?.kind !== "number") {
+				sink({
+					code: "pdf/object-missing-value",
+					severity: "warning",
+					message: `object stream ${String(streamObjNum)} header is truncated at entry ${String(i)}`
+				});
+				break;
+			}
+			relativeOffsets.push(offTok.value);
+		}
+		const values = relativeOffsets.map((relativeOffset) => {
+			const valueReader = new require_bytes_reader.ByteReader(decoded.bytes);
+			valueReader.seek(first + relativeOffset);
+			return require_parse.parseValue(valueReader, sink) ?? require_objects.pdfNull();
+		});
+		objStmCache.set(streamObjNum, values);
+		return values;
+	}
+	function fetch(num) {
+		const cached = objectCache.get(num);
+		if (cached !== void 0) return cached;
+		const entry = xref.entries.get(num);
+		if (entry === void 0) {
+			sink({
+				code: "pdf/object-missing-value",
+				severity: "warning",
+				message: `object ${String(num)} is referenced but not present in the cross-reference table`
+			});
+			return require_objects.pdfNull();
+		}
+		const value = entry.type === "offset" ? fetchDirect(num, entry) : decodeObjectStream(entry.streamObjNum)[entry.indexInStream] ?? require_objects.pdfNull();
+		objectCache.set(num, value);
+		return value;
+	}
+	function resolve(obj) {
+		let current = obj;
+		let depth = 0;
+		while (current?.kind === "ref" && depth < MAX_RESOLVE_DEPTH) {
+			current = fetch(current.num);
+			depth++;
+		}
+		if (depth >= MAX_RESOLVE_DEPTH) {
+			sink({
+				code: "pdf/reference-cycle",
+				severity: "warning",
+				message: "a chain of indirect references did not resolve within the depth limit; treating it as null"
+			});
+			return require_objects.pdfNull();
+		}
+		return current;
+	}
+	function resolveDict(obj) {
+		return require_objects.asDict(resolve(obj));
+	}
+	function requireCatalog(dict) {
+		if (dict === void 0 || !require_objects.isName(require_objects.dictGet(dict, "Type"), "Catalog")) throw new require_diagnostics.PdfParseError("pdf/no-root", "no resolvable /Root catalog was found, even after cross-reference recovery");
+		return dict;
+	}
+	const catalog = requireCatalog(resolveDict(require_objects.dictGet(xref.trailer, "Root")));
+	function pages() {
+		const pagesRoot = resolveDict(require_objects.dictGet(catalog, "Pages"));
+		if (pagesRoot === void 0) return [];
+		const result = [];
+		walkPageTree(pagesRoot, {}, /* @__PURE__ */ new Set(), result);
+		return result;
+	}
+	function walkPageTree(node, inherited, visited, result) {
+		if (visited.has(node)) {
+			sink({
+				code: "pdf/page-tree-cycle",
+				severity: "warning",
+				message: "the page tree contains a cycle; stopping descent at the repeated node"
+			});
+			return;
+		}
+		visited.add(node);
+		const merged = { ...inherited };
+		for (const key of INHERITABLE_PAGE_KEYS) {
+			const own = require_objects.dictGet(node, key);
+			if (own !== void 0) merged[key] = own;
+		}
+		const kids = require_objects.asArray(require_objects.dictGet(node, "Kids"));
+		if (kids === void 0) {
+			const entries = new Map(node.entries);
+			for (const key of INHERITABLE_PAGE_KEYS) if (!entries.has(key) && merged[key] !== void 0) entries.set(key, merged[key]);
+			result.push({
+				kind: "dict",
+				entries
+			});
+			return;
+		}
+		for (const kid of kids) {
+			const kidDict = resolveDict(kid);
+			if (kidDict !== void 0) walkPageTree(kidDict, merged, visited, result);
+		}
+	}
+	return {
+		trailer: xref.trailer,
+		resolve,
+		resolveDict,
+		pages
+	};
+}
+//#endregion
+exports.openPdfDocument = openPdfDocument;

package/dist/document.d.cts

@@ -0,0 +1,12 @@
+import { PdfDiagnosticSink } from "./diagnostics.cjs";
+import { PdfDict, PdfObject } from "./objects.cjs";
+//#region src/document.d.ts
+interface PdfDocument {
+  readonly trailer: PdfDict;
+  resolve(obj: PdfObject | undefined): PdfObject | undefined;
+  resolveDict(obj: PdfObject | undefined): PdfDict | undefined;
+  pages(): PdfDict[];
+}
+declare function openPdfDocument(bytes: Uint8Array<ArrayBuffer>, sink: PdfDiagnosticSink): PdfDocument;
+//#endregion
+export { PdfDocument, openPdfDocument };

package/dist/document.d.ts

@@ -0,0 +1,12 @@
+import { PdfDiagnosticSink } from "./diagnostics.js";
+import { PdfDict, PdfObject } from "./objects.js";
+//#region src/document.d.ts
+interface PdfDocument {
+  readonly trailer: PdfDict;
+  resolve(obj: PdfObject | undefined): PdfObject | undefined;
+  resolveDict(obj: PdfObject | undefined): PdfDict | undefined;
+  pages(): PdfDict[];
+}
+declare function openPdfDocument(bytes: Uint8Array<ArrayBuffer>, sink: PdfDiagnosticSink): PdfDocument;
+//#endregion
+export { PdfDocument, openPdfDocument };