pdf-codec 5.3.32 → 5.5.0

package/dist/layout.cjs

@@ -173,8 +173,18 @@ const LayoutPageSchema = zod.z.object({
 	heightPt: zod.z.number().positive(),
 	items: zod.z.array(LayoutItemSchema),
 	annotations: zod.z.array(LayoutAnnotationSchema).optional(),
-	notes: zod.z.string().optional()
+	notes: zod.z.string().optional(),
+	index: zod.z.number().int().nonnegative().optional()
 });
+/**
+* The zero-based index in the source PDF's page tree of the page at `position` in a `LayoutDocument`'s `pages`: the page's own `index` when a page-selected read set one, otherwise `position` itself, which is the source index whenever `pages` holds every page in document order. The one place that rule is spelled, so every consumer resolving a page against a document-level reference (a destination, a form widget, a frame) agrees on it.
+* @param page - the page as it appears in `pages`
+* @param position - the page's position in `pages`
+* @returns the page's index in the source document's page tree
+*/
+function sourcePageIndex(page, position) {
+	return page.index ?? position;
+}
 const LayoutImageAssetSchema = zod.z.object({
 	format: zod.z.enum(["png", "jpeg"]),
 	base64: zod.z.string(),
@@ -259,10 +269,22 @@ const LayoutStructureElementSchema = zod.z.lazy(() => zod.z.object({
 	actualText: zod.z.string().optional(),
 	children: zod.z.array(LayoutStructureElementSchema)
 }));
+/**
+* The document-level surfaces a read can leave out (`ReadPdfOptions.surfaces`), each named by the `LayoutDocument` field it fills: `outline`, `destinations`, `form`, `layers` and `structure` are those fields, and `residue` is the package-level `source` channel. A `LayoutDocument` lists the ones its read skipped in `skippedSurfaces`.
+*/
+const LayoutDocumentSurfaceSchema = zod.z.enum([
+	"outline",
+	"destinations",
+	"form",
+	"layers",
+	"structure",
+	"residue"
+]);
 const LayoutDocumentSchema = zod.z.object({
 	formatVersion: zod.z.literal(1),
 	metadata: document_schema_js.LayoutMetadataSchema,
 	pages: zod.z.array(LayoutPageSchema),
+	pageCount: zod.z.number().int().nonnegative().optional(),
 	images: zod.z.record(zod.z.string(), LayoutImageAssetSchema),
 	destinations: zod.z.array(LayoutDestinationSchema).optional(),
 	outline: zod.z.array(LayoutOutlineItemSchema).optional(),
@@ -270,7 +292,8 @@ const LayoutDocumentSchema = zod.z.object({
 	layers: zod.z.array(LayoutLayerSchema).optional(),
 	structure: zod.z.array(LayoutStructureElementSchema).optional(),
 	form: zod.z.array(LayoutFormFieldSchema).optional(),
-	source: zod.z.record(zod.z.string(), document_schema_js.SourceResidueSchema).optional()
+	source: zod.z.record(zod.z.string(), document_schema_js.SourceResidueSchema).optional(),
+	skippedSurfaces: zod.z.array(LayoutDocumentSurfaceSchema).min(1).optional()
 });
 //#endregion
 exports.LAYOUT_FORMAT_VERSION = LAYOUT_FORMAT_VERSION;
@@ -280,6 +303,7 @@ exports.LayoutAttachmentSchema = LayoutAttachmentSchema;
 exports.LayoutDestinationSchema = LayoutDestinationSchema;
 exports.LayoutDestinationTargetSchema = LayoutDestinationTargetSchema;
 exports.LayoutDocumentSchema = LayoutDocumentSchema;
+exports.LayoutDocumentSurfaceSchema = LayoutDocumentSurfaceSchema;
 exports.LayoutEllipseSchema = LayoutEllipseSchema;
 exports.LayoutFormFieldSchema = LayoutFormFieldSchema;
 exports.LayoutFormWidgetSchema = LayoutFormWidgetSchema;
@@ -298,3 +322,4 @@ exports.LayoutRectSchema = LayoutRectSchema;
 exports.LayoutStructureElementSchema = LayoutStructureElementSchema;
 exports.LayoutSubpathSchema = LayoutSubpathSchema;
 exports.LayoutTextSchema = LayoutTextSchema;
+exports.sourcePageIndex = sourcePageIndex;

package/dist/layout.d.cts

@@ -668,8 +668,16 @@ declare const LayoutPageSchema: z.ZodObject<{
     }, z.core.$strict>>;
   }, z.core.$strip>>>;
   notes: z.ZodOptional<z.ZodString>;
+  index: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 type LayoutPage = z.infer<typeof LayoutPageSchema>;
+/**
+ * The zero-based index in the source PDF's page tree of the page at `position` in a `LayoutDocument`'s `pages`: the page's own `index` when a page-selected read set one, otherwise `position` itself, which is the source index whenever `pages` holds every page in document order. The one place that rule is spelled, so every consumer resolving a page against a document-level reference (a destination, a form widget, a frame) agrees on it.
+ * @param page - the page as it appears in `pages`
+ * @param position - the page's position in `pages`
+ * @returns the page's index in the source document's page tree
+ */
+declare function sourcePageIndex(page: LayoutPage, position: number): number;
 declare const LayoutImageAssetSchema: z.ZodObject<{
   format: z.ZodEnum<{
     png: "png";
@@ -776,6 +784,18 @@ interface LayoutStructureElement {
   readonly actualText?: string;
   readonly children: readonly LayoutStructureElement[];
 }
+/**
+ * The document-level surfaces a read can leave out (`ReadPdfOptions.surfaces`), each named by the `LayoutDocument` field it fills: `outline`, `destinations`, `form`, `layers` and `structure` are those fields, and `residue` is the package-level `source` channel. A `LayoutDocument` lists the ones its read skipped in `skippedSurfaces`.
+ */
+declare const LayoutDocumentSurfaceSchema: z.ZodEnum<{
+  structure: "structure";
+  destinations: "destinations";
+  outline: "outline";
+  layers: "layers";
+  form: "form";
+  residue: "residue";
+}>;
+type LayoutDocumentSurface = z.infer<typeof LayoutDocumentSurfaceSchema>;
 declare const LayoutDocumentSchema: z.ZodObject<{
   formatVersion: z.ZodLiteral<1>;
   metadata: z.ZodObject<{
@@ -1019,7 +1039,9 @@ declare const LayoutDocumentSchema: z.ZodObject<{
       }, z.core.$strict>>;
     }, z.core.$strip>>>;
     notes: z.ZodOptional<z.ZodString>;
+    index: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>>;
+  pageCount: z.ZodOptional<z.ZodNumber>;
   images: z.ZodRecord<z.ZodString, z.ZodObject<{
     format: z.ZodEnum<{
       png: "png";
@@ -1091,7 +1113,15 @@ declare const LayoutDocumentSchema: z.ZodObject<{
     }>;
     xml: z.ZodString;
   }, z.core.$strict>>>;
+  skippedSurfaces: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    structure: "structure";
+    destinations: "destinations";
+    outline: "outline";
+    layers: "layers";
+    form: "form";
+    residue: "residue";
+  }>>>;
 }, z.core.$strip>;
 type LayoutDocument = z.infer<typeof LayoutDocumentSchema>;
 //#endregion
-export { LAYOUT_FORMAT_VERSION, LayoutAnnotation, LayoutAnnotationQuad, LayoutAnnotationQuadSchema, LayoutAnnotationSchema, LayoutAttachment, LayoutAttachmentSchema, LayoutDestination, LayoutDestinationSchema, LayoutDestinationTarget, LayoutDestinationTargetSchema, LayoutDocument, LayoutDocumentSchema, LayoutEllipse, LayoutEllipseSchema, LayoutFormField, LayoutFormFieldSchema, LayoutFormWidget, LayoutFormWidgetSchema, LayoutImage, LayoutImageAsset, LayoutImageAssetSchema, LayoutImageSchema, LayoutInternalLink, LayoutInternalLinkSchema, LayoutItem, LayoutItemSchema, LayoutLayer, LayoutLayerSchema, LayoutLine, LayoutLineSchema, LayoutLink, LayoutLinkSchema, LayoutOutlineItem, LayoutOutlineItemSchema, LayoutPage, LayoutPageSchema, LayoutPath, LayoutPathSchema, LayoutPathSegment, LayoutPathSegmentSchema, LayoutRect, LayoutRectSchema, LayoutStructureElement, LayoutStructureElementSchema, LayoutSubpath, LayoutSubpathSchema, LayoutText, LayoutTextSchema };
+export { LAYOUT_FORMAT_VERSION, LayoutAnnotation, LayoutAnnotationQuad, LayoutAnnotationQuadSchema, LayoutAnnotationSchema, LayoutAttachment, LayoutAttachmentSchema, LayoutDestination, LayoutDestinationSchema, LayoutDestinationTarget, LayoutDestinationTargetSchema, LayoutDocument, LayoutDocumentSchema, LayoutDocumentSurface, LayoutDocumentSurfaceSchema, LayoutEllipse, LayoutEllipseSchema, LayoutFormField, LayoutFormFieldSchema, LayoutFormWidget, LayoutFormWidgetSchema, LayoutImage, LayoutImageAsset, LayoutImageAssetSchema, LayoutImageSchema, LayoutInternalLink, LayoutInternalLinkSchema, LayoutItem, LayoutItemSchema, LayoutLayer, LayoutLayerSchema, LayoutLine, LayoutLineSchema, LayoutLink, LayoutLinkSchema, LayoutOutlineItem, LayoutOutlineItemSchema, LayoutPage, LayoutPageSchema, LayoutPath, LayoutPathSchema, LayoutPathSegment, LayoutPathSegmentSchema, LayoutRect, LayoutRectSchema, LayoutStructureElement, LayoutStructureElementSchema, LayoutSubpath, LayoutSubpathSchema, LayoutText, LayoutTextSchema, sourcePageIndex };

package/dist/layout.d.ts

@@ -668,8 +668,16 @@ declare const LayoutPageSchema: z.ZodObject<{
     }, z.core.$strict>>;
   }, z.core.$strip>>>;
   notes: z.ZodOptional<z.ZodString>;
+  index: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 type LayoutPage = z.infer<typeof LayoutPageSchema>;
+/**
+ * The zero-based index in the source PDF's page tree of the page at `position` in a `LayoutDocument`'s `pages`: the page's own `index` when a page-selected read set one, otherwise `position` itself, which is the source index whenever `pages` holds every page in document order. The one place that rule is spelled, so every consumer resolving a page against a document-level reference (a destination, a form widget, a frame) agrees on it.
+ * @param page - the page as it appears in `pages`
+ * @param position - the page's position in `pages`
+ * @returns the page's index in the source document's page tree
+ */
+declare function sourcePageIndex(page: LayoutPage, position: number): number;
 declare const LayoutImageAssetSchema: z.ZodObject<{
   format: z.ZodEnum<{
     png: "png";
@@ -776,6 +784,18 @@ interface LayoutStructureElement {
   readonly actualText?: string;
   readonly children: readonly LayoutStructureElement[];
 }
+/**
+ * The document-level surfaces a read can leave out (`ReadPdfOptions.surfaces`), each named by the `LayoutDocument` field it fills: `outline`, `destinations`, `form`, `layers` and `structure` are those fields, and `residue` is the package-level `source` channel. A `LayoutDocument` lists the ones its read skipped in `skippedSurfaces`.
+ */
+declare const LayoutDocumentSurfaceSchema: z.ZodEnum<{
+  structure: "structure";
+  destinations: "destinations";
+  outline: "outline";
+  layers: "layers";
+  form: "form";
+  residue: "residue";
+}>;
+type LayoutDocumentSurface = z.infer<typeof LayoutDocumentSurfaceSchema>;
 declare const LayoutDocumentSchema: z.ZodObject<{
   formatVersion: z.ZodLiteral<1>;
   metadata: z.ZodObject<{
@@ -1019,7 +1039,9 @@ declare const LayoutDocumentSchema: z.ZodObject<{
       }, z.core.$strict>>;
     }, z.core.$strip>>>;
     notes: z.ZodOptional<z.ZodString>;
+    index: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>>;
+  pageCount: z.ZodOptional<z.ZodNumber>;
   images: z.ZodRecord<z.ZodString, z.ZodObject<{
     format: z.ZodEnum<{
       png: "png";
@@ -1091,7 +1113,15 @@ declare const LayoutDocumentSchema: z.ZodObject<{
     }>;
     xml: z.ZodString;
   }, z.core.$strict>>>;
+  skippedSurfaces: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    structure: "structure";
+    destinations: "destinations";
+    outline: "outline";
+    layers: "layers";
+    form: "form";
+    residue: "residue";
+  }>>>;
 }, z.core.$strip>;
 type LayoutDocument = z.infer<typeof LayoutDocumentSchema>;
 //#endregion
-export { LAYOUT_FORMAT_VERSION, LayoutAnnotation, LayoutAnnotationQuad, LayoutAnnotationQuadSchema, LayoutAnnotationSchema, LayoutAttachment, LayoutAttachmentSchema, LayoutDestination, LayoutDestinationSchema, LayoutDestinationTarget, LayoutDestinationTargetSchema, LayoutDocument, LayoutDocumentSchema, LayoutEllipse, LayoutEllipseSchema, LayoutFormField, LayoutFormFieldSchema, LayoutFormWidget, LayoutFormWidgetSchema, LayoutImage, LayoutImageAsset, LayoutImageAssetSchema, LayoutImageSchema, LayoutInternalLink, LayoutInternalLinkSchema, LayoutItem, LayoutItemSchema, LayoutLayer, LayoutLayerSchema, LayoutLine, LayoutLineSchema, LayoutLink, LayoutLinkSchema, LayoutOutlineItem, LayoutOutlineItemSchema, LayoutPage, LayoutPageSchema, LayoutPath, LayoutPathSchema, LayoutPathSegment, LayoutPathSegmentSchema, LayoutRect, LayoutRectSchema, LayoutStructureElement, LayoutStructureElementSchema, LayoutSubpath, LayoutSubpathSchema, LayoutText, LayoutTextSchema };
+export { LAYOUT_FORMAT_VERSION, LayoutAnnotation, LayoutAnnotationQuad, LayoutAnnotationQuadSchema, LayoutAnnotationSchema, LayoutAttachment, LayoutAttachmentSchema, LayoutDestination, LayoutDestinationSchema, LayoutDestinationTarget, LayoutDestinationTargetSchema, LayoutDocument, LayoutDocumentSchema, LayoutDocumentSurface, LayoutDocumentSurfaceSchema, LayoutEllipse, LayoutEllipseSchema, LayoutFormField, LayoutFormFieldSchema, LayoutFormWidget, LayoutFormWidgetSchema, LayoutImage, LayoutImageAsset, LayoutImageAssetSchema, LayoutImageSchema, LayoutInternalLink, LayoutInternalLinkSchema, LayoutItem, LayoutItemSchema, LayoutLayer, LayoutLayerSchema, LayoutLine, LayoutLineSchema, LayoutLink, LayoutLinkSchema, LayoutOutlineItem, LayoutOutlineItemSchema, LayoutPage, LayoutPageSchema, LayoutPath, LayoutPathSchema, LayoutPathSegment, LayoutPathSegmentSchema, LayoutRect, LayoutRectSchema, LayoutStructureElement, LayoutStructureElementSchema, LayoutSubpath, LayoutSubpathSchema, LayoutText, LayoutTextSchema, sourcePageIndex };

package/dist/layout.js

@@ -172,8 +172,18 @@ const LayoutPageSchema = z.object({
 	heightPt: z.number().positive(),
 	items: z.array(LayoutItemSchema),
 	annotations: z.array(LayoutAnnotationSchema).optional(),
-	notes: z.string().optional()
+	notes: z.string().optional(),
+	index: z.number().int().nonnegative().optional()
 });
+/**
+* The zero-based index in the source PDF's page tree of the page at `position` in a `LayoutDocument`'s `pages`: the page's own `index` when a page-selected read set one, otherwise `position` itself, which is the source index whenever `pages` holds every page in document order. The one place that rule is spelled, so every consumer resolving a page against a document-level reference (a destination, a form widget, a frame) agrees on it.
+* @param page - the page as it appears in `pages`
+* @param position - the page's position in `pages`
+* @returns the page's index in the source document's page tree
+*/
+function sourcePageIndex(page, position) {
+	return page.index ?? position;
+}
 const LayoutImageAssetSchema = z.object({
 	format: z.enum(["png", "jpeg"]),
 	base64: z.string(),
@@ -258,10 +268,22 @@ const LayoutStructureElementSchema = z.lazy(() => z.object({
 	actualText: z.string().optional(),
 	children: z.array(LayoutStructureElementSchema)
 }));
+/**
+* The document-level surfaces a read can leave out (`ReadPdfOptions.surfaces`), each named by the `LayoutDocument` field it fills: `outline`, `destinations`, `form`, `layers` and `structure` are those fields, and `residue` is the package-level `source` channel. A `LayoutDocument` lists the ones its read skipped in `skippedSurfaces`.
+*/
+const LayoutDocumentSurfaceSchema = z.enum([
+	"outline",
+	"destinations",
+	"form",
+	"layers",
+	"structure",
+	"residue"
+]);
 const LayoutDocumentSchema = z.object({
 	formatVersion: z.literal(1),
 	metadata: LayoutMetadataSchema,
 	pages: z.array(LayoutPageSchema),
+	pageCount: z.number().int().nonnegative().optional(),
 	images: z.record(z.string(), LayoutImageAssetSchema),
 	destinations: z.array(LayoutDestinationSchema).optional(),
 	outline: z.array(LayoutOutlineItemSchema).optional(),
@@ -269,7 +291,8 @@ const LayoutDocumentSchema = z.object({
 	layers: z.array(LayoutLayerSchema).optional(),
 	structure: z.array(LayoutStructureElementSchema).optional(),
 	form: z.array(LayoutFormFieldSchema).optional(),
-	source: z.record(z.string(), SourceResidueSchema).optional()
+	source: z.record(z.string(), SourceResidueSchema).optional(),
+	skippedSurfaces: z.array(LayoutDocumentSurfaceSchema).min(1).optional()
 });
 //#endregion
-export { LAYOUT_FORMAT_VERSION, LayoutAnnotationQuadSchema, LayoutAnnotationSchema, LayoutAttachmentSchema, LayoutDestinationSchema, LayoutDestinationTargetSchema, LayoutDocumentSchema, LayoutEllipseSchema, LayoutFormFieldSchema, LayoutFormWidgetSchema, LayoutImageAssetSchema, LayoutImageSchema, LayoutInternalLinkSchema, LayoutItemSchema, LayoutLayerSchema, LayoutLineSchema, LayoutLinkSchema, LayoutOutlineItemSchema, LayoutPageSchema, LayoutPathSchema, LayoutPathSegmentSchema, LayoutRectSchema, LayoutStructureElementSchema, LayoutSubpathSchema, LayoutTextSchema };
+export { LAYOUT_FORMAT_VERSION, LayoutAnnotationQuadSchema, LayoutAnnotationSchema, LayoutAttachmentSchema, LayoutDestinationSchema, LayoutDestinationTargetSchema, LayoutDocumentSchema, LayoutDocumentSurfaceSchema, LayoutEllipseSchema, LayoutFormFieldSchema, LayoutFormWidgetSchema, LayoutImageAssetSchema, LayoutImageSchema, LayoutInternalLinkSchema, LayoutItemSchema, LayoutLayerSchema, LayoutLineSchema, LayoutLinkSchema, LayoutOutlineItemSchema, LayoutPageSchema, LayoutPathSchema, LayoutPathSegmentSchema, LayoutRectSchema, LayoutStructureElementSchema, LayoutSubpathSchema, LayoutTextSchema, sourcePageIndex };

package/dist/names.d.cts

@@ -1,4 +1,4 @@
-import { i as PdfDiagnosticSink } from "./diagnostics-C9FxfZ6H.cjs";
+import { i as PdfDiagnosticSink } from "./diagnostics-BkG_Ej2x.cjs";
 import { r as PdfObject } from "./objects-e2RS3-yT.cjs";
 import { PdfObjectResolver } from "./interpret-types.cjs";
 //#region src/names.d.ts

package/dist/names.d.ts

@@ -1,4 +1,4 @@
-import { i as PdfDiagnosticSink } from "./diagnostics-C9FxfZ6H.js";
+import { i as PdfDiagnosticSink } from "./diagnostics-BkG_Ej2x.js";
 import { r as PdfObject } from "./objects-e2RS3-yT.js";
 import { PdfObjectResolver } from "./interpret-types.js";
 //#region src/names.d.ts

package/dist/navigation.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, r as PdfObject } from "./objects-e2RS3-yT.cjs";
 import { PdfObjectResolver } from "./interpret-types.cjs";
 import { LayoutDestination, LayoutDestinationTarget, LayoutOutlineItem } from "./layout.cjs";

package/dist/navigation.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, r as PdfObject } from "./objects-e2RS3-yT.js";
 import { PdfObjectResolver } from "./interpret-types.js";
 import { LayoutDestination, LayoutDestinationTarget, LayoutOutlineItem } from "./layout.js";

package/dist/optional-content.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, r as PdfObject } from "./objects-e2RS3-yT.cjs";
 import { PdfObjectResolver } from "./interpret-types.cjs";
 import { LayoutLayer } from "./layout.cjs";

package/dist/optional-content.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, r as PdfObject } from "./objects-e2RS3-yT.js";
 import { PdfObjectResolver } from "./interpret-types.js";
 import { LayoutLayer } from "./layout.js";

package/dist/parse.d.cts

@@ -1,4 +1,4 @@
-import { i as PdfDiagnosticSink } from "./diagnostics-C9FxfZ6H.cjs";
+import { i as PdfDiagnosticSink } from "./diagnostics-BkG_Ej2x.cjs";
 import { r as PdfObject } from "./objects-e2RS3-yT.cjs";
 import { ByteReader } from "./bytes/reader.cjs";
 //#region src/parse.d.ts

package/dist/parse.d.ts

@@ -1,4 +1,4 @@
-import { i as PdfDiagnosticSink } from "./diagnostics-C9FxfZ6H.js";
+import { i as PdfDiagnosticSink } from "./diagnostics-BkG_Ej2x.js";
 import { r as PdfObject } from "./objects-e2RS3-yT.js";
 import { ByteReader } from "./bytes/reader.js";
 //#region src/parse.d.ts

package/dist/predictors.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/predictors.d.ts
 interface PredictorParams {

package/dist/predictors.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/predictors.d.ts
 interface PredictorParams {

package/dist/raster-text.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 { r as Matrix } from "./matrix-B7_SBKQ5.cjs";
 import { ExtractedTextRun, PdfObjectResolver } from "./interpret-types.cjs";

package/dist/raster-text.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 { r as Matrix } from "./matrix-B7_SBKQ5.js";
 import { ExtractedTextRun, PdfObjectResolver } from "./interpret-types.js";

package/dist/raster.d.cts

@@ -1,4 +1,4 @@
-import { i as PdfDiagnosticSink } from "./diagnostics-C9FxfZ6H.cjs";
+import { i as PdfDiagnosticSink } from "./diagnostics-BkG_Ej2x.cjs";
 import { t as SfntFont } from "./sfnt-V08bb5ut.cjs";
 import { r as GlyfTable } from "./glyf-DFyknMrW.cjs";
 import { Color } from "document-schema.js";

package/dist/raster.d.ts

@@ -1,4 +1,4 @@
-import { i as PdfDiagnosticSink } from "./diagnostics-C9FxfZ6H.js";
+import { i as PdfDiagnosticSink } from "./diagnostics-BkG_Ej2x.js";
 import { t as SfntFont } from "./sfnt-V08bb5ut.js";
 import { r as GlyfTable } from "./glyf-Bv1katwK.js";
 import { Color } from "document-schema.js";

package/dist/read-convert.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 { r as Matrix } from "./matrix-B7_SBKQ5.cjs";
 import { ExtractedEllipse, ExtractedImage, ExtractedItem, ExtractedLine, ExtractedPaint, ExtractedPath, ExtractedRect, ExtractedSubpath, ExtractedTextRun, PdfObjectResolver } from "./interpret-types.cjs";

package/dist/read-convert.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 { r as Matrix } from "./matrix-B7_SBKQ5.js";
 import { ExtractedEllipse, ExtractedImage, ExtractedItem, ExtractedLine, ExtractedPaint, ExtractedPath, ExtractedRect, ExtractedSubpath, ExtractedTextRun, PdfObjectResolver } from "./interpret-types.js";

package/dist/read.cjs

@@ -12,7 +12,7 @@ const require_form = require("./form.cjs");
 const require_xmp = require("./xmp.cjs");
 const require_optional_content = require("./optional-content.cjs");
 const require_structure = require("./structure.cjs");
-require("./layout.cjs");
+const require_layout = require("./layout.cjs");
 const require_diagnostics = require("./diagnostics.cjs");
 const require_document = require("./document.cjs");
 const require_util_abort = require("./util/abort.cjs");
@@ -20,6 +20,22 @@ const require_font_read = require("./font-read.cjs");
 const require_interpret = require("./interpret-BDVrFWhd.cjs");
 const require_navigation = require("./navigation.cjs");
 //#region src/read.ts
+function skippedSurfacesOf(surfaces) {
+	return require_layout.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 require_diagnostics.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;
@@ -45,21 +61,28 @@ function readPdf(bytes, options) {
 	const images = {};
 	const imageIdCache = /* @__PURE__ */ new Map();
 	const pageDicts = doc.pages();
-	const destinationRegistry = require_navigation.createDestinationRegistry(doc.catalog, doc, (obj) => doc.pageIndex(obj), sink);
-	const outline = require_navigation.readOutline(doc.catalog, destinationRegistry, doc, sink);
-	const attachments = require_attachments.readAttachments(doc.catalog, pageDicts, doc, sink);
-	const optionalContent = require_optional_content.readOptionalContent(doc.catalog, doc, sink);
-	const form = require_form.readAcroForm(doc.catalog, doc, (obj) => doc.pageIndex(obj), sink);
-	const structure = require_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") ? require_navigation.createDestinationRegistry(doc.catalog, doc, (obj) => doc.pageIndex(obj), sink) : UNREAD_DESTINATION_REGISTRY;
+	const outline = reads("outline") ? require_navigation.readOutline(doc.catalog, destinationRegistry, doc, sink) : void 0;
+	const attachments = selection === void 0 ? require_attachments.readAttachments(doc.catalog, pageDicts, doc, sink) : [];
+	const optionalContent = reads("layers") ? require_optional_content.readOptionalContent(doc.catalog, doc, sink) : void 0;
+	const form = reads("form") ? require_form.readAcroForm(doc.catalog, doc, (obj) => doc.pageIndex(obj), sink) : void 0;
+	const structure = reads("structure") ? require_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 [];
 		require_util_abort.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: require_serialize.serializeObjectToText(require_objects.pdfArray(pageBoxRows))
 	};
@@ -67,16 +90,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 = require_objects.asArray(require_objects.dictGet(page, key));
 	if (arr === void 0) return;

package/dist/read.d.cts

@@ -1,11 +1,40 @@
-import { i as PdfDiagnosticSink } from "./diagnostics-C9FxfZ6H.cjs";
+import { i as PdfDiagnosticSink } from "./diagnostics-BkG_Ej2x.cjs";
 import { r as Matrix } from "./matrix-B7_SBKQ5.cjs";
-import { LayoutDocument } from "./layout.cjs";
+import { LayoutDocument, LayoutDocumentSurface } from "./layout.cjs";
 //#region src/read.d.ts
 interface ReadPdfOptions {
   readonly sink?: PdfDiagnosticSink;
   readonly signal?: AbortSignal;
+  /**
+   * The pages to read, as zero-based indices into the document's page tree; a negative index counts from the end (`-1` is the last page). Omitted, every page is read.
+   *
+   * What a selected read skips: an unselected page's content stream is never fetched, decoded or interpreted, so the fonts and images only unselected pages use are never resolved; embedded-file payloads are never decoded, so `attachments` is absent from a page-selected result (an attachment is document-level payload whose size is independent of the pages asked for, and decoding it would cost the same whichever pages were selected).
+   *
+   * What it still reads whole, because a negative index and every document-level page reference resolve against it or because it is document-level and holds no page content stream: the page tree, the outline, named destinations, optional-content layers, the AcroForm, the structure element tree and the /ParentTree number tree (both of which scale with the document), metadata and package residue; every one of those but the page tree and metadata can be left out as well with `surfaces`. Two surfaces are built from page content and so cover selected pages only: the structure-ownership association an item's `structure` field names (and its parent-tree diagnostics), and the `page-boxes` residue row. Destinations a link states as a direct array are minted into `destinations` (as `dest1`, `dest2`, ...) only when their page is interpreted, so an unselected page's direct link destinations are absent and a minted name depends on which pages were read (and on whether the outline was read: see `surfaces`); named destinations are unaffected.
+   *
+   * Duplicates collapse, and the result's `pages` holds the selected pages in ascending document order whatever order they were asked for in, each carrying its source position as `index`, with the document's total as `pageCount`; every document-level reference keeps naming source indices. An empty array is a valid selection: it reads no page and returns the document-level surfaces with `pageCount`, the cheapest way to learn a file's length and metadata. An entry naming no page throws `PdfPageSelectionError` rather than being skipped.
+   */
+  readonly pages?: readonly number[];
+  /**
+   * Which document-level surfaces to read. Each is read unless its entry is `false`, so omitting the setting, or an entry, reads it as before. Independent of `pages`: it applies to a full read and a page-selected read alike.
+   *
+   * A surface turned off is never parsed (its part of the catalog is not walked, so a malformed outline, form, layer list or structure tree reports no diagnostic) and its field is absent from the result whatever the file holds; the result lists it in `skippedSurfaces`, which is how a caller tells "not read" from "none". What each one covers, and what page items lose without it:
+   *
+   * - `outline`: the `/Outlines` bookmark tree (`outline`). Page items do not depend on it, except through minted names: a destination stated as a direct array is named with the first unused `destN` in the order the reader meets it, and the outline is read before any page, so an outline entry's direct destination takes a lower number than any link's. Without the outline, the names minted for page links' direct destinations are renumbered, and `destinations` loses the entries only the outline minted; each link still resolves to the same target.
+   * - `destinations`: the named destinations of the catalog `/Dests` dictionary and the `/Names /Dests` name tree, and the registry links and outline entries name their targets through (`destinations`). Without it nothing can name an internal target, so a link whose target is internal (a `/Dest`, or a `/GoTo` action, named or direct) is left out of its page's items, and a read outline entry carries no `destination`; a link to a URI is kept as usual.
+   * - `form`: the AcroForm field tree (`form`). Page items do not depend on it: a widget annotation is never a page item or annotation either way.
+   * - `layers`: optional content, the `/OCProperties` groups and their default visibility (`layers`). Without it no item carries a `layer`, since an `/OC` membership resolves to no name; the items themselves are all still read, so content the default view hides is indistinguishable from visible content.
+   * - `structure`: the `/StructTreeRoot` element tree and its `/ParentTree` ownership map (`structure`). Without it no item carries a `structure` owner, and the parent-tree diagnostics are not reported.
+   * - `residue`: the package-level residue rows (`source`), including the per-page `page-boxes` row. Page items do not depend on it; `metadata` still reads the XMP packet it falls back to.
+   *
+   * Apart from those stated losses and the renumbering a skipped outline causes, every page item is exactly what a read with the surface on produces.
+   */
+  readonly surfaces?: ReadPdfSurfaces;
 }
+/**
+ * One entry per document-level surface `readPdf` can leave out, each read unless set to `false` (see `ReadPdfOptions.surfaces` for what each covers and what page items lose without it).
+ */
+type ReadPdfSurfaces = Readonly<Partial<Record<LayoutDocumentSurface, boolean>>>;
 declare function readPdf(bytes: Uint8Array<ArrayBuffer>, options?: ReadPdfOptions): LayoutDocument;
 type PageRotation = 0 | 90 | 180 | 270;
 declare function normalizeRotation(rotate: number | undefined): PageRotation;
@@ -16,4 +45,4 @@ interface PageRotationResult {
 }
 declare function pageRotationTransform(rotation: PageRotation, w: number, h: number): PageRotationResult;
 //#endregion
-export { ReadPdfOptions, normalizeRotation, pageRotationTransform, readPdf };
+export { ReadPdfOptions, ReadPdfSurfaces, normalizeRotation, pageRotationTransform, readPdf };

package/dist/read.d.ts

@@ -1,11 +1,40 @@
-import { i as PdfDiagnosticSink } from "./diagnostics-C9FxfZ6H.js";
+import { i as PdfDiagnosticSink } from "./diagnostics-BkG_Ej2x.js";
 import { r as Matrix } from "./matrix-B7_SBKQ5.js";
-import { LayoutDocument } from "./layout.js";
+import { LayoutDocument, LayoutDocumentSurface } from "./layout.js";
 //#region src/read.d.ts
 interface ReadPdfOptions {
   readonly sink?: PdfDiagnosticSink;
   readonly signal?: AbortSignal;
+  /**
+   * The pages to read, as zero-based indices into the document's page tree; a negative index counts from the end (`-1` is the last page). Omitted, every page is read.
+   *
+   * What a selected read skips: an unselected page's content stream is never fetched, decoded or interpreted, so the fonts and images only unselected pages use are never resolved; embedded-file payloads are never decoded, so `attachments` is absent from a page-selected result (an attachment is document-level payload whose size is independent of the pages asked for, and decoding it would cost the same whichever pages were selected).
+   *
+   * What it still reads whole, because a negative index and every document-level page reference resolve against it or because it is document-level and holds no page content stream: the page tree, the outline, named destinations, optional-content layers, the AcroForm, the structure element tree and the /ParentTree number tree (both of which scale with the document), metadata and package residue; every one of those but the page tree and metadata can be left out as well with `surfaces`. Two surfaces are built from page content and so cover selected pages only: the structure-ownership association an item's `structure` field names (and its parent-tree diagnostics), and the `page-boxes` residue row. Destinations a link states as a direct array are minted into `destinations` (as `dest1`, `dest2`, ...) only when their page is interpreted, so an unselected page's direct link destinations are absent and a minted name depends on which pages were read (and on whether the outline was read: see `surfaces`); named destinations are unaffected.
+   *
+   * Duplicates collapse, and the result's `pages` holds the selected pages in ascending document order whatever order they were asked for in, each carrying its source position as `index`, with the document's total as `pageCount`; every document-level reference keeps naming source indices. An empty array is a valid selection: it reads no page and returns the document-level surfaces with `pageCount`, the cheapest way to learn a file's length and metadata. An entry naming no page throws `PdfPageSelectionError` rather than being skipped.
+   */
+  readonly pages?: readonly number[];
+  /**
+   * Which document-level surfaces to read. Each is read unless its entry is `false`, so omitting the setting, or an entry, reads it as before. Independent of `pages`: it applies to a full read and a page-selected read alike.
+   *
+   * A surface turned off is never parsed (its part of the catalog is not walked, so a malformed outline, form, layer list or structure tree reports no diagnostic) and its field is absent from the result whatever the file holds; the result lists it in `skippedSurfaces`, which is how a caller tells "not read" from "none". What each one covers, and what page items lose without it:
+   *
+   * - `outline`: the `/Outlines` bookmark tree (`outline`). Page items do not depend on it, except through minted names: a destination stated as a direct array is named with the first unused `destN` in the order the reader meets it, and the outline is read before any page, so an outline entry's direct destination takes a lower number than any link's. Without the outline, the names minted for page links' direct destinations are renumbered, and `destinations` loses the entries only the outline minted; each link still resolves to the same target.
+   * - `destinations`: the named destinations of the catalog `/Dests` dictionary and the `/Names /Dests` name tree, and the registry links and outline entries name their targets through (`destinations`). Without it nothing can name an internal target, so a link whose target is internal (a `/Dest`, or a `/GoTo` action, named or direct) is left out of its page's items, and a read outline entry carries no `destination`; a link to a URI is kept as usual.
+   * - `form`: the AcroForm field tree (`form`). Page items do not depend on it: a widget annotation is never a page item or annotation either way.
+   * - `layers`: optional content, the `/OCProperties` groups and their default visibility (`layers`). Without it no item carries a `layer`, since an `/OC` membership resolves to no name; the items themselves are all still read, so content the default view hides is indistinguishable from visible content.
+   * - `structure`: the `/StructTreeRoot` element tree and its `/ParentTree` ownership map (`structure`). Without it no item carries a `structure` owner, and the parent-tree diagnostics are not reported.
+   * - `residue`: the package-level residue rows (`source`), including the per-page `page-boxes` row. Page items do not depend on it; `metadata` still reads the XMP packet it falls back to.
+   *
+   * Apart from those stated losses and the renumbering a skipped outline causes, every page item is exactly what a read with the surface on produces.
+   */
+  readonly surfaces?: ReadPdfSurfaces;
 }
+/**
+ * One entry per document-level surface `readPdf` can leave out, each read unless set to `false` (see `ReadPdfOptions.surfaces` for what each covers and what page items lose without it).
+ */
+type ReadPdfSurfaces = Readonly<Partial<Record<LayoutDocumentSurface, boolean>>>;
 declare function readPdf(bytes: Uint8Array<ArrayBuffer>, options?: ReadPdfOptions): LayoutDocument;
 type PageRotation = 0 | 90 | 180 | 270;
 declare function normalizeRotation(rotate: number | undefined): PageRotation;
@@ -16,4 +45,4 @@ interface PageRotationResult {
 }
 declare function pageRotationTransform(rotation: PageRotation, w: number, h: number): PageRotationResult;
 //#endregion
-export { ReadPdfOptions, normalizeRotation, pageRotationTransform, readPdf };
+export { ReadPdfOptions, ReadPdfSurfaces, normalizeRotation, pageRotationTransform, readPdf };