pdf-codec 3.0.12 → 3.1.0

package/README.md

@@ -185,6 +185,14 @@ import { readJpegInfo } from 'pdf-codec/image/jpeg-info';
 
 This works via package.json's `"./*"` wildcard export, resolving any `pdf-codec/<path>` subpath to the correspondingly-named file under `dist/` — both ESM `import` and CJS `require` resolve the same way.
 
+One subpath is a declared entry point in its own right: **`pdf-codec/read`** (an explicit `exports` entry onto `src/read.ts`, the read pipeline's own module). A consumer that only ever reads PDFs and imports the root barrel statically reaches `write.ts`'s module-scope imports — `math-font.ts` (the vendored STIX Two Math font) and `font-registry.ts` (the four Carlito/Caladea faces), together ~2.9 MB of font binaries it can never execute, which on Cloudflare Workers' free plan (3 MB gzipped for an entire Worker) is most of the budget. The read entry's module graph provably excludes them:
+
+```ts
+import { readPdf } from 'pdf-codec/read';
+```
+
+`src/read-graph.test.ts` walks the entry's static import graph and fails the build if `write.ts`, `math-font.ts`, `font-registry.ts`, or any asset module becomes reachable (type-only imports are exempt — they erase at compile time — so a read-side module can keep typing against the root barrel's types while its runtime graph stays narrow). The entry carries `readPdf` and the read pipeline's own helpers (`normalizeRotation`, `pageRotationTransform`, `decodePdfString`, `parsePdfDate`); the other read-adjacent surfaces it does not itself own stay deep-importable through the wildcard and are asset-free the same way — the diagnostics vocabulary (`pdf-codec/diagnostics`), the `LayoutDocument` item family (`pdf-codec/layout`), and standard-14 resolution/AFM metrics (`pdf-codec/fonts`, `pdf-codec/afm-widths`).
+
 ## Architecture
 
 The package is layered from generic primitives outward to the codec itself:

package/dist/codec.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_layout = require("./layout.cjs");
-const require_write = require("./write.cjs");
 const require_read = require("./read.cjs");
+const require_write = require("./write.cjs");
 let zod = require("zod");
 //#region src/codec.ts
 const PDF_HEADER = [

package/dist/codec.js

@@ -1,6 +1,6 @@
 import { LayoutDocumentSchema } from "./layout.js";
-import { writePdf } from "./write.js";
 import { readPdf } from "./read.js";
+import { writePdf } from "./write.js";
 import { z } from "zod";
 //#region src/codec.ts
 const PDF_HEADER = [

package/dist/index.cjs

@@ -10,12 +10,12 @@ const require_fonts = require("./fonts.cjs");
 const require_image_jpeg2000_errors = require("./image/jpeg2000-errors.cjs");
 const require_image_jp2_boxes = require("./image/jp2-boxes.cjs");
 const require_image_jpeg2000 = require("./image/jpeg2000.cjs");
+const require_read = require("./read.cjs");
 const require_font_registry = require("./font-registry.cjs");
 const require_math_stretch = require("./math-stretch.cjs");
 const require_math_font = require("./math-font.cjs");
 const require_measure = require("./measure.cjs");
 const require_write = require("./write.cjs");
-const require_read = require("./read.cjs");
 const require_codec = require("./codec.cjs");
 const require_font_face = require("./font-face.cjs");
 exports.DEFAULT_VERTICAL_METRIC_POLICY = require_measure.DEFAULT_VERTICAL_METRIC_POLICY;

package/dist/index.js

@@ -9,12 +9,12 @@ import { resolveStandardFont } from "./fonts.js";
 import { Jpeg2000ParseError, Jpeg2000UnsupportedError } from "./image/jpeg2000-errors.js";
 import { looksLikeBareCodestream, parseJp2Container } from "./image/jp2-boxes.js";
 import { decodeJpeg2000, readJpeg2000Metadata } from "./image/jpeg2000.js";
+import { readPdf } from "./read.js";
 import { createFontRegistry, resolveFaceWithRegistry } from "./font-registry.js";
 import { assembleStretchyGlyph, scaleMathStretchConstruction } from "./math-stretch.js";
 import { loadMathFont } from "./math-font.js";
 import { DEFAULT_VERTICAL_METRIC_POLICY, createFontMeasurer, createStandardFontMeasurer } from "./measure.js";
 import { writePdf } from "./write.js";
-import { readPdf } from "./read.js";
 import { PdfBytesSchema, pdfCodec } from "./codec.js";
 import { FontFaceParseError, readFontFace } from "./font-face.js";
 export * from "byte-codec";

package/dist/notes-annotation-author.cjs

@@ -0,0 +1,5 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/notes-annotation-author.ts
+const NOTES_ANNOTATION_AUTHOR = "documents.js:notes";
+//#endregion
+exports.NOTES_ANNOTATION_AUTHOR = NOTES_ANNOTATION_AUTHOR;

package/dist/notes-annotation-author.d.cts

@@ -0,0 +1,4 @@
+//#region src/notes-annotation-author.d.ts
+declare const NOTES_ANNOTATION_AUTHOR = "documents.js:notes";
+//#endregion
+export { NOTES_ANNOTATION_AUTHOR };

package/dist/notes-annotation-author.d.ts

@@ -0,0 +1,4 @@
+//#region src/notes-annotation-author.d.ts
+declare const NOTES_ANNOTATION_AUTHOR = "documents.js:notes";
+//#endregion
+export { NOTES_ANNOTATION_AUTHOR };

package/dist/notes-annotation-author.js

@@ -0,0 +1,4 @@
+//#region src/notes-annotation-author.ts
+const NOTES_ANNOTATION_AUTHOR = "documents.js:notes";
+//#endregion
+export { NOTES_ANNOTATION_AUTHOR };

package/dist/read.cjs

@@ -12,7 +12,7 @@ const require_font_read = require("./font-read.cjs");
 const require_images_read = require("./images-read.cjs");
 const require_matrix = require("./matrix.cjs");
 const require_interpret = require("./interpret.cjs");
-require("./write.cjs");
+require("./notes-annotation-author.cjs");
 //#region src/read.ts
 const PDF_HEADER_BYTES = new TextEncoder().encode("%PDF-");
 const HEADER_SEARCH_WINDOW = 1024;

package/dist/read.js

@@ -11,7 +11,7 @@ import { createFontResolver } from "./font-read.js";
 import { readImageXObject } from "./images-read.js";
 import { applyMatrix, matrixRotationDegrees, matrixScaleX, matrixScaleY, multiplyMatrices, translationMatrix } from "./matrix.js";
 import { interpretContentStream } from "./interpret.js";
-import "./write.js";
+import "./notes-annotation-author.js";
 //#region src/read.ts
 const PDF_HEADER_BYTES = new TextEncoder().encode("%PDF-");
 const HEADER_SEARCH_WINDOW = 1024;

package/dist/write.cjs

@@ -6,6 +6,7 @@ const require_objects = require("./objects.cjs");
 const require_bytes_flate = require("./bytes/flate.cjs");
 const require_util_abort = require("./util/abort.cjs");
 const require_image_jpeg_info = require("./image/jpeg-info.cjs");
+const require_notes_annotation_author = require("./notes-annotation-author.cjs");
 const require_image_png_decode = require("./image/png-decode.cjs");
 const require_embedded_font = require("./embedded-font.cjs");
 const require_serialize = require("./serialize.cjs");
@@ -181,7 +182,6 @@ function isLinkItem(item) {
 	return item.kind === "link";
 }
 const NOTES_ANNOTATION_HIDDEN_FLAG = 2;
-const NOTES_ANNOTATION_AUTHOR = "documents.js:notes";
 function buildNotesAnnotDict(notes) {
 	return require_objects.pdfDict({
 		Type: require_objects.pdfName("Annot"),
@@ -193,7 +193,7 @@ function buildNotesAnnotDict(notes) {
 			0
 		].map((n) => require_objects.pdfNum(n))),
 		Contents: textToPdfString(notes),
-		T: textToPdfString(NOTES_ANNOTATION_AUTHOR),
+		T: textToPdfString(require_notes_annotation_author.NOTES_ANNOTATION_AUTHOR),
 		F: require_objects.pdfNum(NOTES_ANNOTATION_HIDDEN_FLAG)
 	});
 }
@@ -487,5 +487,4 @@ function writePdf(doc, options = {}) {
 	return writer.toBytes();
 }
 //#endregion
-exports.NOTES_ANNOTATION_AUTHOR = NOTES_ANNOTATION_AUTHOR;
 exports.writePdf = writePdf;

package/dist/write.d.cts

@@ -16,7 +16,6 @@ interface WritePdfOptions {
   readonly fonts?: FontRegistry;
   readonly formulas?: readonly PositionedFormula[];
 }
-declare const NOTES_ANNOTATION_AUTHOR = "documents.js:notes";
 declare function writePdf(doc: LayoutDocument, options?: WritePdfOptions): Uint8Array<ArrayBuffer>;
 //#endregion
-export { NOTES_ANNOTATION_AUTHOR, WritePdfOptions, writePdf };
+export { WritePdfOptions, writePdf };

package/dist/write.d.ts

@@ -16,7 +16,6 @@ interface WritePdfOptions {
   readonly fonts?: FontRegistry;
   readonly formulas?: readonly PositionedFormula[];
 }
-declare const NOTES_ANNOTATION_AUTHOR = "documents.js:notes";
 declare function writePdf(doc: LayoutDocument, options?: WritePdfOptions): Uint8Array<ArrayBuffer>;
 //#endregion
-export { NOTES_ANNOTATION_AUTHOR, WritePdfOptions, writePdf };
+export { WritePdfOptions, writePdf };

package/dist/write.js

@@ -5,6 +5,7 @@ import { pdfArray, pdfDict, pdfHexString, pdfName, pdfNum, pdfRef, pdfStream } f
 import { deflate } from "./bytes/flate.js";
 import { throwIfAborted } from "./util/abort.js";
 import { readJpegInfo } from "./image/jpeg-info.js";
+import { NOTES_ANNOTATION_AUTHOR } from "./notes-annotation-author.js";
 import { decodePng } from "./image/png-decode.js";
 import { collectEmbeddedGlyphs } from "./embedded-font.js";
 import { writeObject } from "./serialize.js";
@@ -180,7 +181,6 @@ function isLinkItem(item) {
 	return item.kind === "link";
 }
 const NOTES_ANNOTATION_HIDDEN_FLAG = 2;
-const NOTES_ANNOTATION_AUTHOR = "documents.js:notes";
 function buildNotesAnnotDict(notes) {
 	return pdfDict({
 		Type: pdfName("Annot"),
@@ -486,4 +486,4 @@ function writePdf(doc, options = {}) {
 	return writer.toBytes();
 }
 //#endregion
-export { NOTES_ANNOTATION_AUTHOR, writePdf };
+export { writePdf };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pdf-codec",
-  "version": "3.0.12",
+  "version": "3.1.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": {
@@ -21,6 +21,14 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
+    "./read": {
+      "types": {
+        "import": "./dist/read.d.ts",
+        "require": "./dist/read.d.cts"
+      },
+      "import": "./dist/read.js",
+      "require": "./dist/read.cjs"
+    },
     "./*": {
       "types": {
         "import": "./dist/*.d.ts",
@@ -33,6 +41,13 @@
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "read": [
+        "./dist/read.d.ts"
+      ]
+    }
+  },
   "files": [
     "dist"
   ],