pdf-codec 5.3.32 → 5.5.0

package/dist/read.js

@@ -11,14 +11,30 @@ 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 { LayoutDocumentSurfaceSchema } from "./layout.js";
+import { NOOP_DIAGNOSTIC_SINK, PdfPageSelectionError, PdfParseError } from "./diagnostics.js";
 import { openPdfDocument } from "./document.js";
 import { throwIfAborted } from "./util/abort.js";
 import { createFontResolver } from "./font-read.js";
 import { t as interpretContentStream } from "./interpret---0lZPlv.js";
 import { createDestinationRegistry, readOutline } from "./navigation.js";
 //#region src/read.ts
+function skippedSurfacesOf(surfaces) {
+	return LayoutDocumentSurfaceSchema.options.filter((surface) => surfaces?.[surface] === false);
+}
+const UNREAD_DESTINATION_REGISTRY = {
+	entries: [],
+	intern: () => void 0
+};
+function resolvePageSelection(selection, pageCount) {
+	const resolved = /* @__PURE__ */ new Set();
+	for (const requested of selection) {
+		const index = requested < 0 ? pageCount + requested : requested;
+		if (!Number.isInteger(requested) || index < 0 || index >= pageCount) throw new PdfPageSelectionError(requested, pageCount);
+		resolved.add(index);
+	}
+	return resolved;
+}
 const PDF_HEADER_BYTES = new TextEncoder().encode("%PDF-");
 const HEADER_SEARCH_WINDOW = 1024;
 const DEFAULT_PAGE_WIDTH_PT = 612;
@@ -44,21 +60,28 @@ function readPdf(bytes, options) {
 	const images = {};
 	const imageIdCache = /* @__PURE__ */ new Map();
 	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 selection = options?.pages === void 0 ? void 0 : resolvePageSelection(options.pages, pageDicts.length);
+	const skippedSurfaces = skippedSurfacesOf(options?.surfaces);
+	const reads = (surface) => !skippedSurfaces.includes(surface);
+	const destinationRegistry = reads("destinations") ? createDestinationRegistry(doc.catalog, doc, (obj) => doc.pageIndex(obj), sink) : UNREAD_DESTINATION_REGISTRY;
+	const outline = reads("outline") ? readOutline(doc.catalog, destinationRegistry, doc, sink) : void 0;
+	const attachments = selection === void 0 ? readAttachments(doc.catalog, pageDicts, doc, sink) : [];
+	const optionalContent = reads("layers") ? readOptionalContent(doc.catalog, doc, sink) : void 0;
+	const form = reads("form") ? readAcroForm(doc.catalog, doc, (obj) => doc.pageIndex(obj), sink) : void 0;
+	const structure = reads("structure") ? readStructure(doc.catalog, pageDicts, (index) => selection === void 0 || selection.has(index), doc, sink) : void 0;
+	const source = reads("residue") ? readDocumentResidue(doc, sink) : void 0;
 	const pageBoxRows = [];
-	const pages = pageDicts.map((pageDict, index) => {
+	const pages = pageDicts.flatMap((pageDict, index) => {
+		if (selection !== void 0 && !selection.has(index)) return [];
 		throwIfAborted(signal);
-		const read = readPage(index, pageDict, doc, fontResolver, images, imageIdCache, destinationRegistry, optionalContent.layerNameOf, structure.ownerOf, sink);
+		const read = readPage(index, pageDict, doc, fontResolver, images, imageIdCache, destinationRegistry, optionalContent?.layerNameOf ?? noLayerName, structure?.ownerOf ?? noStructureOwner, sink);
 		if (read.boxRow !== void 0) pageBoxRows.push(read.boxRow);
-		return read.page;
+		return [selection === void 0 ? read.page : {
+			...read.page,
+			index
+		}];
 	});
-	if (pageBoxRows.length > 0) source["page-boxes"] = {
+	if (source !== void 0 && pageBoxRows.length > 0) source["page-boxes"] = {
 		format: "pdf",
 		xml: serializeObjectToText(pdfArray(pageBoxRows))
 	};
@@ -66,16 +89,20 @@ function readPdf(bytes, options) {
 		formatVersion: 1,
 		metadata: readMetadata(doc.trailer, doc, doc.catalog, sink),
 		pages,
+		...selection !== void 0 ? { pageCount: pageDicts.length } : {},
 		images,
 		...destinationRegistry.entries.length > 0 ? { destinations: [...destinationRegistry.entries] } : {},
-		...outline.length > 0 ? { outline } : {},
+		...outline !== void 0 && 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 } : {}
+		...optionalContent !== void 0 && optionalContent.layers.length > 0 ? { layers: [...optionalContent.layers] } : {},
+		...form !== void 0 && form.length > 0 ? { form } : {},
+		...structure !== void 0 && structure.tree.length > 0 ? { structure: [...structure.tree] } : {},
+		...source !== void 0 && Object.keys(source).length > 0 ? { source } : {},
+		...skippedSurfaces.length > 0 ? { skippedSurfaces } : {}
 	};
 }
+function noLayerName() {}
+function noStructureOwner() {}
 function readDeclaredPageBox(page, key) {
 	const arr = asArray(dictGet(page, key));
 	if (arr === void 0) return;

package/dist/structure.cjs

@@ -6,7 +6,16 @@ const NEVER_DICT = {
 	kind: "dict",
 	entries: /* @__PURE__ */ new Map()
 };
-function readStructure(catalog, pages, resolver, sink) {
+/**
+* Reads the tagged-structure element tree and the (page, MCID) ownership map.
+* @param catalog - the document catalog
+* @param pages - every page of the page tree, in document order, so a position is a source page index
+* @param includePage - whether the page at a source index is being read: ownership entries and parent-tree diagnostics are built for those pages only, while the element tree itself is document-level and always read whole
+* @param resolver - the object resolver
+* @param sink - where recoverable parse diagnostics go
+* @returns the element tree and an owner lookup answering for included pages
+*/
+function readStructure(catalog, pages, includePage, resolver, sink) {
 	const root = resolver.resolveDict(require_objects.dictGet(catalog, "StructTreeRoot"));
 	if (root === void 0) return {
 		tree: [],
@@ -68,7 +77,7 @@ function readStructure(catalog, pages, resolver, sink) {
 	}
 	return {
 		tree,
-		ownerOf: parentTreeOwners(root, pages, resolver, idByDict, sink)
+		ownerOf: parentTreeOwners(root, pages, includePage, resolver, idByDict, sink)
 	};
 }
 const ATTRIBUTE_KEYS = [
@@ -146,7 +155,7 @@ function numberTreeEntries(node, resolver, visited) {
 	}
 	return entries;
 }
-function parentTreeOwners(root, pages, resolver, idByDict, sink) {
+function parentTreeOwners(root, pages, includePage, resolver, idByDict, sink) {
 	const documentTree = resolver.resolveDict(require_objects.dictGet(root, "ParentTree"));
 	if (documentTree === void 0) {
 		if (require_objects.dictGet(root, "ParentTree") !== void 0) sink({
@@ -159,6 +168,7 @@ function parentTreeOwners(root, pages, resolver, idByDict, sink) {
 	const entries = new Map(numberTreeEntries(documentTree, resolver, /* @__PURE__ */ new Set()));
 	const owners = /* @__PURE__ */ new Map();
 	pages.forEach((page, pageIndex) => {
+		if (!includePage(pageIndex)) return;
 		const structParents = require_objects.asNumber(require_objects.dictGet(page, "StructParents"));
 		if (structParents === void 0) return;
 		const entry = entries.get(structParents);

package/dist/structure.d.cts

@@ -1,4 +1,4 @@
-import { i as PdfDiagnosticSink } from "./diagnostics-C9FxfZ6H.cjs";
+import { i as PdfDiagnosticSink } from "./diagnostics-BkG_Ej2x.cjs";
 import { n as PdfDict } from "./objects-e2RS3-yT.cjs";
 import { PdfObjectResolver } from "./interpret-types.cjs";
 import { LayoutStructureElement } from "./layout.cjs";
@@ -7,6 +7,15 @@ interface StructureContext {
   readonly tree: readonly LayoutStructureElement[];
   readonly ownerOf: (pageIndex: number, mcid: number) => string | undefined;
 }
-declare function readStructure(catalog: PdfDict, pages: readonly PdfDict[], resolver: Readonly<PdfObjectResolver>, sink: PdfDiagnosticSink): StructureContext;
+/**
+ * Reads the tagged-structure element tree and the (page, MCID) ownership map.
+ * @param catalog - the document catalog
+ * @param pages - every page of the page tree, in document order, so a position is a source page index
+ * @param includePage - whether the page at a source index is being read: ownership entries and parent-tree diagnostics are built for those pages only, while the element tree itself is document-level and always read whole
+ * @param resolver - the object resolver
+ * @param sink - where recoverable parse diagnostics go
+ * @returns the element tree and an owner lookup answering for included pages
+ */
+declare function readStructure(catalog: PdfDict, pages: readonly PdfDict[], includePage: (pageIndex: number) => boolean, resolver: Readonly<PdfObjectResolver>, sink: PdfDiagnosticSink): StructureContext;
 //#endregion
 export { StructureContext, readStructure };

package/dist/structure.d.ts

@@ -1,4 +1,4 @@
-import { i as PdfDiagnosticSink } from "./diagnostics-C9FxfZ6H.js";
+import { i as PdfDiagnosticSink } from "./diagnostics-BkG_Ej2x.js";
 import { n as PdfDict } from "./objects-e2RS3-yT.js";
 import { PdfObjectResolver } from "./interpret-types.js";
 import { LayoutStructureElement } from "./layout.js";
@@ -7,6 +7,15 @@ interface StructureContext {
   readonly tree: readonly LayoutStructureElement[];
   readonly ownerOf: (pageIndex: number, mcid: number) => string | undefined;
 }
-declare function readStructure(catalog: PdfDict, pages: readonly PdfDict[], resolver: Readonly<PdfObjectResolver>, sink: PdfDiagnosticSink): StructureContext;
+/**
+ * Reads the tagged-structure element tree and the (page, MCID) ownership map.
+ * @param catalog - the document catalog
+ * @param pages - every page of the page tree, in document order, so a position is a source page index
+ * @param includePage - whether the page at a source index is being read: ownership entries and parent-tree diagnostics are built for those pages only, while the element tree itself is document-level and always read whole
+ * @param resolver - the object resolver
+ * @param sink - where recoverable parse diagnostics go
+ * @returns the element tree and an owner lookup answering for included pages
+ */
+declare function readStructure(catalog: PdfDict, pages: readonly PdfDict[], includePage: (pageIndex: number) => boolean, resolver: Readonly<PdfObjectResolver>, sink: PdfDiagnosticSink): StructureContext;
 //#endregion
 export { StructureContext, readStructure };

package/dist/structure.js

@@ -5,7 +5,16 @@ const NEVER_DICT = {
 	kind: "dict",
 	entries: /* @__PURE__ */ new Map()
 };
-function readStructure(catalog, pages, resolver, sink) {
+/**
+* Reads the tagged-structure element tree and the (page, MCID) ownership map.
+* @param catalog - the document catalog
+* @param pages - every page of the page tree, in document order, so a position is a source page index
+* @param includePage - whether the page at a source index is being read: ownership entries and parent-tree diagnostics are built for those pages only, while the element tree itself is document-level and always read whole
+* @param resolver - the object resolver
+* @param sink - where recoverable parse diagnostics go
+* @returns the element tree and an owner lookup answering for included pages
+*/
+function readStructure(catalog, pages, includePage, resolver, sink) {
 	const root = resolver.resolveDict(dictGet(catalog, "StructTreeRoot"));
 	if (root === void 0) return {
 		tree: [],
@@ -67,7 +76,7 @@ function readStructure(catalog, pages, resolver, sink) {
 	}
 	return {
 		tree,
-		ownerOf: parentTreeOwners(root, pages, resolver, idByDict, sink)
+		ownerOf: parentTreeOwners(root, pages, includePage, resolver, idByDict, sink)
 	};
 }
 const ATTRIBUTE_KEYS = [
@@ -145,7 +154,7 @@ function numberTreeEntries(node, resolver, visited) {
 	}
 	return entries;
 }
-function parentTreeOwners(root, pages, resolver, idByDict, sink) {
+function parentTreeOwners(root, pages, includePage, resolver, idByDict, sink) {
 	const documentTree = resolver.resolveDict(dictGet(root, "ParentTree"));
 	if (documentTree === void 0) {
 		if (dictGet(root, "ParentTree") !== void 0) sink({
@@ -158,6 +167,7 @@ function parentTreeOwners(root, pages, resolver, idByDict, sink) {
 	const entries = new Map(numberTreeEntries(documentTree, resolver, /* @__PURE__ */ new Set()));
 	const owners = /* @__PURE__ */ new Map();
 	pages.forEach((page, pageIndex) => {
+		if (!includePage(pageIndex)) return;
 		const structParents = asNumber(dictGet(page, "StructParents"));
 		if (structParents === void 0) return;
 		const entry = entries.get(structParents);

package/dist/write-skipped-surfaces.cjs

@@ -0,0 +1,16 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/write-skipped-surfaces.ts
+/**
+* writePdf was handed a LayoutDocument from a read that left document-level surfaces out (one carrying `skippedSurfaces`, which only `ReadPdfOptions.surfaces` sets). Such a document is a reading with parts of the file deliberately unread, not a document to re-emit: each skipped surface's field is absent whatever the source holds, and its page items lack what depended on it (internal links without destinations, structure owners without the structure tree, layer names without layers), so writing it would silently drop the source's outline, form, layers, structure or residue. Thrown rather than writing a file that looks complete. Checked after `PdfPartialDocumentError`, so a page-selected read that also skipped surfaces reports the page selection.
+*/
+var PdfSkippedSurfacesError = class extends Error {
+	/** The surfaces the read skipped, as the document's `skippedSurfaces` lists them. */
+	skippedSurfaces;
+	constructor(skippedSurfaces) {
+		super(`this LayoutDocument was read with ${skippedSurfaces.join(", ")} left out (it carries skippedSurfaces, which only a read with ReadPdfOptions.surfaces sets); writing it would drop whatever the source holds there, so it cannot be written as a document of its own`);
+		this.name = "PdfSkippedSurfacesError";
+		this.skippedSurfaces = skippedSurfaces;
+	}
+};
+//#endregion
+exports.PdfSkippedSurfacesError = PdfSkippedSurfacesError;

package/dist/write-skipped-surfaces.d.cts

@@ -0,0 +1,12 @@
+import { LayoutDocumentSurface } from "./layout.cjs";
+//#region src/write-skipped-surfaces.d.ts
+/**
+ * writePdf was handed a LayoutDocument from a read that left document-level surfaces out (one carrying `skippedSurfaces`, which only `ReadPdfOptions.surfaces` sets). Such a document is a reading with parts of the file deliberately unread, not a document to re-emit: each skipped surface's field is absent whatever the source holds, and its page items lack what depended on it (internal links without destinations, structure owners without the structure tree, layer names without layers), so writing it would silently drop the source's outline, form, layers, structure or residue. Thrown rather than writing a file that looks complete. Checked after `PdfPartialDocumentError`, so a page-selected read that also skipped surfaces reports the page selection.
+ */
+declare class PdfSkippedSurfacesError extends Error {
+  /** The surfaces the read skipped, as the document's `skippedSurfaces` lists them. */
+  readonly skippedSurfaces: readonly LayoutDocumentSurface[];
+  constructor(skippedSurfaces: readonly LayoutDocumentSurface[]);
+}
+//#endregion
+export { PdfSkippedSurfacesError };

package/dist/write-skipped-surfaces.d.ts

@@ -0,0 +1,12 @@
+import { LayoutDocumentSurface } from "./layout.js";
+//#region src/write-skipped-surfaces.d.ts
+/**
+ * writePdf was handed a LayoutDocument from a read that left document-level surfaces out (one carrying `skippedSurfaces`, which only `ReadPdfOptions.surfaces` sets). Such a document is a reading with parts of the file deliberately unread, not a document to re-emit: each skipped surface's field is absent whatever the source holds, and its page items lack what depended on it (internal links without destinations, structure owners without the structure tree, layer names without layers), so writing it would silently drop the source's outline, form, layers, structure or residue. Thrown rather than writing a file that looks complete. Checked after `PdfPartialDocumentError`, so a page-selected read that also skipped surfaces reports the page selection.
+ */
+declare class PdfSkippedSurfacesError extends Error {
+  /** The surfaces the read skipped, as the document's `skippedSurfaces` lists them. */
+  readonly skippedSurfaces: readonly LayoutDocumentSurface[];
+  constructor(skippedSurfaces: readonly LayoutDocumentSurface[]);
+}
+//#endregion
+export { PdfSkippedSurfacesError };

package/dist/write-skipped-surfaces.js

@@ -0,0 +1,15 @@
+//#region src/write-skipped-surfaces.ts
+/**
+* writePdf was handed a LayoutDocument from a read that left document-level surfaces out (one carrying `skippedSurfaces`, which only `ReadPdfOptions.surfaces` sets). Such a document is a reading with parts of the file deliberately unread, not a document to re-emit: each skipped surface's field is absent whatever the source holds, and its page items lack what depended on it (internal links without destinations, structure owners without the structure tree, layer names without layers), so writing it would silently drop the source's outline, form, layers, structure or residue. Thrown rather than writing a file that looks complete. Checked after `PdfPartialDocumentError`, so a page-selected read that also skipped surfaces reports the page selection.
+*/
+var PdfSkippedSurfacesError = class extends Error {
+	/** The surfaces the read skipped, as the document's `skippedSurfaces` lists them. */
+	skippedSurfaces;
+	constructor(skippedSurfaces) {
+		super(`this LayoutDocument was read with ${skippedSurfaces.join(", ")} left out (it carries skippedSurfaces, which only a read with ReadPdfOptions.surfaces sets); writing it would drop whatever the source holds there, so it cannot be written as a document of its own`);
+		this.name = "PdfSkippedSurfacesError";
+		this.skippedSurfaces = skippedSurfaces;
+	}
+};
+//#endregion
+export { PdfSkippedSurfacesError };

package/dist/write.cjs

@@ -15,6 +15,7 @@ const require_font_registry = require("./font-registry.cjs");
 const require_measure = require("./measure.cjs");
 const require_write_page_emit = require("./write-page-emit.cjs");
 const require_write_outline = require("./write-outline.cjs");
+const require_write_skipped_surfaces = require("./write-skipped-surfaces.cjs");
 let byte_codec = require("byte-codec");
 //#region src/write.ts
 const MATH_FONT_RESOURCE_NAME = "MF";
@@ -69,7 +70,22 @@ function buildFontObjects(standardName, descriptorRef) {
 function codePointsOf(texts) {
 	return new Set(texts.flatMap((text) => [...text].map((character) => character.codePointAt(0))));
 }
+/**
+* writePdf was handed a LayoutDocument from a page-selected read (one carrying `pageCount`). Such a document is a reading of part of a file, not a document to re-emit: its pages are a selection while its destinations, form widgets and outline still name source page indices, and the writer places pages by position, so writing it would point those references at the wrong pages or past the end. Thrown rather than writing a file whose links silently lie.
+*/
+var PdfPartialDocumentError = class extends Error {
+	pageCount;
+	selectedPageCount;
+	constructor(pageCount, selectedPageCount) {
+		super(`this LayoutDocument holds ${String(selectedPageCount)} pages selected from a ${String(pageCount)}-page file (it carries pageCount, which only a page-selected read sets); its page references name pages of the source file, so it cannot be written as a document of its own`);
+		this.name = "PdfPartialDocumentError";
+		this.pageCount = pageCount;
+		this.selectedPageCount = selectedPageCount;
+	}
+};
 function writePdf(doc, options = {}) {
+	if (doc.pageCount !== void 0) throw new PdfPartialDocumentError(doc.pageCount, doc.pages.length);
+	if (doc.skippedSurfaces !== void 0) throw new require_write_skipped_surfaces.PdfSkippedSurfacesError(doc.skippedSurfaces);
 	const compress = options.compress ?? true;
 	const registry = options.fonts;
 	const measurer = require_measure.createFontMeasurer(registry);
@@ -478,4 +494,5 @@ function writePdf(doc, options = {}) {
 	return writer.toBytes();
 }
 //#endregion
+exports.PdfPartialDocumentError = PdfPartialDocumentError;
 exports.writePdf = writePdf;

package/dist/write.d.cts

@@ -18,6 +18,14 @@ interface WritePdfOptions {
   readonly formulas?: readonly PositionedFormula[];
   readonly encryption?: PdfEncryptionOptions;
 }
+/**
+ * writePdf was handed a LayoutDocument from a page-selected read (one carrying `pageCount`). Such a document is a reading of part of a file, not a document to re-emit: its pages are a selection while its destinations, form widgets and outline still name source page indices, and the writer places pages by position, so writing it would point those references at the wrong pages or past the end. Thrown rather than writing a file whose links silently lie.
+ */
+declare class PdfPartialDocumentError extends Error {
+  readonly pageCount: number;
+  readonly selectedPageCount: number;
+  constructor(pageCount: number, selectedPageCount: number);
+}
 declare function writePdf(doc: LayoutDocument, options?: WritePdfOptions): Uint8Array<ArrayBuffer>;
 //#endregion
-export { WritePdfOptions, writePdf };
+export { PdfPartialDocumentError, WritePdfOptions, writePdf };

package/dist/write.d.ts

@@ -18,6 +18,14 @@ interface WritePdfOptions {
   readonly formulas?: readonly PositionedFormula[];
   readonly encryption?: PdfEncryptionOptions;
 }
+/**
+ * writePdf was handed a LayoutDocument from a page-selected read (one carrying `pageCount`). Such a document is a reading of part of a file, not a document to re-emit: its pages are a selection while its destinations, form widgets and outline still name source page indices, and the writer places pages by position, so writing it would point those references at the wrong pages or past the end. Thrown rather than writing a file whose links silently lie.
+ */
+declare class PdfPartialDocumentError extends Error {
+  readonly pageCount: number;
+  readonly selectedPageCount: number;
+  constructor(pageCount: number, selectedPageCount: number);
+}
 declare function writePdf(doc: LayoutDocument, options?: WritePdfOptions): Uint8Array<ArrayBuffer>;
 //#endregion
-export { WritePdfOptions, writePdf };
+export { PdfPartialDocumentError, WritePdfOptions, writePdf };

package/dist/write.js

@@ -14,6 +14,7 @@ import { resolveFaceWithRegistry } from "./font-registry.js";
 import { createFontMeasurer } from "./measure.js";
 import { emitPageObjects } from "./write-page-emit.js";
 import { emitOutlineObjects } from "./write-outline.js";
+import { PdfSkippedSurfacesError } from "./write-skipped-surfaces.js";
 import { base64ToBytes } from "byte-codec";
 //#region src/write.ts
 const MATH_FONT_RESOURCE_NAME = "MF";
@@ -68,7 +69,22 @@ function buildFontObjects(standardName, descriptorRef) {
 function codePointsOf(texts) {
 	return new Set(texts.flatMap((text) => [...text].map((character) => character.codePointAt(0))));
 }
+/**
+* writePdf was handed a LayoutDocument from a page-selected read (one carrying `pageCount`). Such a document is a reading of part of a file, not a document to re-emit: its pages are a selection while its destinations, form widgets and outline still name source page indices, and the writer places pages by position, so writing it would point those references at the wrong pages or past the end. Thrown rather than writing a file whose links silently lie.
+*/
+var PdfPartialDocumentError = class extends Error {
+	pageCount;
+	selectedPageCount;
+	constructor(pageCount, selectedPageCount) {
+		super(`this LayoutDocument holds ${String(selectedPageCount)} pages selected from a ${String(pageCount)}-page file (it carries pageCount, which only a page-selected read sets); its page references name pages of the source file, so it cannot be written as a document of its own`);
+		this.name = "PdfPartialDocumentError";
+		this.pageCount = pageCount;
+		this.selectedPageCount = selectedPageCount;
+	}
+};
 function writePdf(doc, options = {}) {
+	if (doc.pageCount !== void 0) throw new PdfPartialDocumentError(doc.pageCount, doc.pages.length);
+	if (doc.skippedSurfaces !== void 0) throw new PdfSkippedSurfacesError(doc.skippedSurfaces);
 	const compress = options.compress ?? true;
 	const registry = options.fonts;
 	const measurer = createFontMeasurer(registry);
@@ -477,4 +493,4 @@ function writePdf(doc, options = {}) {
 	return writer.toBytes();
 }
 //#endregion
-export { writePdf };
+export { PdfPartialDocumentError, writePdf };

package/dist/xref.d.cts

@@ -1,4 +1,4 @@
-import { i as PdfDiagnosticSink } from "./diagnostics-C9FxfZ6H.cjs";
+import { i as PdfDiagnosticSink } from "./diagnostics-BkG_Ej2x.cjs";
 import { n as PdfDict } from "./objects-e2RS3-yT.cjs";
 //#region src/xref.d.ts
 interface XrefOffsetEntry {

package/dist/xref.d.ts

@@ -1,4 +1,4 @@
-import { i as PdfDiagnosticSink } from "./diagnostics-C9FxfZ6H.js";
+import { i as PdfDiagnosticSink } from "./diagnostics-BkG_Ej2x.js";
 import { n as PdfDict } from "./objects-e2RS3-yT.js";
 //#region src/xref.d.ts
 interface XrefOffsetEntry {

package/package.json

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

package/dist/diagnostics-C9FxfZ6H.d.cts

@@ -1,22 +0,0 @@
-//#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);
-}
-declare class PdfPasswordRequiredError extends PdfParseError {
-  constructor(message?: string);
-}
-//#endregion
-export { PdfEncryptedError as a, PdfDiagnosticSink as i, PdfDiagnostic as n, PdfParseError as o, PdfDiagnosticSeverity as r, PdfPasswordRequiredError as s, NOOP_DIAGNOSTIC_SINK as t };

package/dist/diagnostics-C9FxfZ6H.d.ts

@@ -1,22 +0,0 @@
-//#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);
-}
-declare class PdfPasswordRequiredError extends PdfParseError {
-  constructor(message?: string);
-}
-//#endregion
-export { PdfEncryptedError as a, PdfDiagnosticSink as i, PdfDiagnostic as n, PdfParseError as o, PdfDiagnosticSeverity as r, PdfPasswordRequiredError as s, NOOP_DIAGNOSTIC_SINK as t };