pdf-codec 1.1.2 → 1.1.3

package/README.md

@@ -2,11 +2,11 @@
 
 [![GitHub](https://img.shields.io/badge/GitHub-181717?logo=github&logoColor=white)](https://github.com/ExaDev/pdf-codec) [![npm](https://img.shields.io/badge/npm-CB3837?logo=npm&logoColor=white)](https://www.npmjs.com/package/pdf-codec) [![Release](https://img.shields.io/github/v/release/ExaDev/pdf-codec)](https://github.com/ExaDev/pdf-codec/releases/latest) [![CI](https://img.shields.io/github/actions/workflow/status/ExaDev/pdf-codec/ci.yml?branch=main)](https://github.com/ExaDev/pdf-codec/actions)
 
-> A hand-written, dependency-minimal PDF codec: parses arbitrary real-world PDFs into a structured, positioned-content document and generates new PDFs from one, built on [`document-content-model`](https://github.com/ExaDev/document-schema.js)'s `LayoutDocument` pivot and [Zod 4](https://zod.dev) codecs.
+> A hand-written, dependency-minimal PDF codec: parses arbitrary real-world PDFs into a structured, positioned-content document and generates new PDFs from one, built on [`document-schema.js`](https://github.com/ExaDev/document-schema.js)'s `LayoutDocument` pivot and [Zod 4](https://zod.dev) codecs.
 
 `pdf-codec` is the PDF-reading-and-writing half of [`documents.js`](https://github.com/ExaDev/documents.js), extracted into its own package: every layer of the PDF format — the object model, the cross-reference table, the content-stream operators, standard-font metrics, the parser's cross-reference/object-stream resolution and content-stream interpreter — is hand-written against the ISO 32000-1 specification, with no external PDF library (`pdf-lib`, `pdfjs-dist`, `mupdf`, or any other) as a dependency. The one exception is [`fflate`](https://github.com/101arrowz/fflate) for raw DEFLATE/zlib compression underneath PDF's `FlateDecode` filter and PNG's `IDAT` chunks. The OpenType/CFF font parsing this package's own writer uses to embed a real math font (`sfnt.ts`/`math-*.ts`) is hand-written too, for the same "no supply-chain surface beyond what's already declared" reason — the one bundled binary asset is the vendored STIX Two Math font itself (OFL-1.1, see [Fidelity](#fidelity) and `assets/fonts/NOTICE.md`), not a library.
 
-That is a genuinely large undertaking — this codec is comparable in size to a small application in its own right — and it comes with an honest trade-off spelled out in [Fidelity](#fidelity) below: this is not, and does not attempt to be, as robust against adversarial or badly malformed real-world PDFs as a library with 15+ years of hardening. What it buys instead is a dependency-free, fully auditable PDF implementation with no supply-chain surface beyond `document-content-model`, `fflate`, and `zod`.
+That is a genuinely large undertaking — this codec is comparable in size to a small application in its own right — and it comes with an honest trade-off spelled out in [Fidelity](#fidelity) below: this is not, and does not attempt to be, as robust against adversarial or badly malformed real-world PDFs as a library with 15+ years of hardening. What it buys instead is a dependency-free, fully auditable PDF implementation with no supply-chain surface beyond `document-schema.js`, `fflate`, and `zod`.
 
 `documents.js` uses this package to convert docx/pptx/odt/odp/ods/odg to and from PDF, and to render MathML formulas (typeset by its own `src/mathml/` engine) through the embedded math font this package parses and writes. That MathML *layout* engine deliberately stays in `documents.js` — see [Architecture](#architecture) below for exactly where the boundary between the two packages sits and why a real `MathBox` value crosses it with zero cast or wrapper.
 
@@ -87,7 +87,7 @@ Dependency direction is strictly downward and checkable: `math-types`/`formula`/
 
 ## Conventions
 
-- **Zod-first schema/type/guard**: `PdfBytesSchema`/`LayoutDocumentSchema` (the latter imported from `document-content-model`) are the only two schemas this package validates against; every other model type (`PdfObject`, `MathBox` and friends) is plain TypeScript, never Zod-validated, for reasons specific to each — see the next two bullets.
+- **Zod-first schema/type/guard**: `PdfBytesSchema`/`LayoutDocumentSchema` (the latter imported from `document-schema.js`) are the only two schemas this package validates against; every other model type (`PdfObject`, `MathBox` and friends) is plain TypeScript, never Zod-validated, for reasons specific to each — see the next two bullets.
 - **`z.codec()` for the one schema-to-schema round trip this package owns**: `pdfCodec` (PDF bytes ⇄ `LayoutDocument`), wrapping the already-independently-tested `readPdf`/`writePdf` pair and adding automatic two-way schema validation. Deliberately the no-options form — `readPdf`/`writePdf` remain the primary entry points wherever a caller needs an `AbortSignal`, a `PdfDiagnosticSink`, or an `onSubstitution` callback, since `z.codec()`'s fixed `decode(input)`/`encode(output)` signature has no room for side-channel options.
 - **`PdfObject` has no Zod schema at all**, deliberately: it never crosses a public boundary or round-trips through JSON, and is constructed exclusively by this package's own parser — validating it would just be validating our own output. It narrows natively on its own `kind` discriminant instead.
 - **The `MathBox`/`MathFontMetrics` family is structurally typed on purpose, not validated by Zod either.** This is the mechanism that lets a caller (`documents.js`) hand this package a real value produced by a completely independent module, with zero cast, zero wrapper, and no shared class or branded type — see [Architecture](#architecture).
@@ -129,7 +129,7 @@ Commits follow Conventional Commits (`feat:`, `fix:`, `test:`, `chore:`, …), e
 ## References
 
 - [documents.js](https://github.com/ExaDev/documents.js) — the package this codec was extracted from, and its principal downstream consumer: docx/pptx/odt/odp/ods/odg ⇄ PDF conversion, and MathML formula rendering (its own `src/mathml/` typesetting engine feeds a real `MathBox` into this package's `writePdf({ formulas })` with zero cast — see [Architecture](#architecture)).
-- [document-content-model](https://github.com/ExaDev/document-schema.js) — the sibling package that owns `LayoutDocument` itself (the PDF-side pivot this codec reads into and writes from), and the canonical `ContentDocument` pivot the wider `documents.js`/`odf.js`/`ooxml.js` family shares.
+- [document-schema.js](https://github.com/ExaDev/document-schema.js) — the sibling package that owns `LayoutDocument` itself (the PDF-side pivot this codec reads into and writes from), and the canonical `ContentDocument` pivot the wider `documents.js`/`odf.js`/`ooxml.js` family shares.
 - [STIX Two Math](https://github.com/stipub/stixfonts) — the embedded math font `math-font.ts` parses and `writePdf({ formulas })` renders through, vendored at `assets/fonts/STIXTwoMath-Regular.otf` and embedded into `dist/` as a base64 string (`src/assets/stix-two-math-font.ts`, generated by `scripts/generate-math-font-asset.mjs`) rather than read from disk at runtime. Copyright 2001-2021 The STIX Fonts Project Authors, licensed [OFL-1.1](assets/fonts/OFL.txt) — see `assets/fonts/NOTICE.md` for the exact source commit and version this was vendored from.
 
 ## License

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-let document_content_model = require("document-content-model");
+let document_schema_js = require("document-schema.js");
 let fflate = require("fflate");
 let zod = require("zod");
 //#region src/util/base64.ts
@@ -3432,8 +3432,8 @@ function interpretContentStream(bytes, resources, context) {
 	const items = [];
 	runContentStream(bytes, resources, {
 		ctm: IDENTITY_MATRIX,
-		fillColor: document_content_model.COLOR_BLACK,
-		strokeColor: document_content_model.COLOR_BLACK,
+		fillColor: document_schema_js.COLOR_BLACK,
+		strokeColor: document_schema_js.COLOR_BLACK,
 		lineWidth: DEFAULT_LINE_WIDTH_PT
 	}, context, items, 0);
 	return items;
@@ -5276,7 +5276,7 @@ function readPdf(bytes, options) {
 		return readPage(pageDict, resolver, fontResolver, images, imageIdCache, sink);
 	});
 	return {
-		formatVersion: document_content_model.LAYOUT_FORMAT_VERSION,
+		formatVersion: document_schema_js.LAYOUT_FORMAT_VERSION,
 		metadata: readMetadata(doc.trailer, resolver),
 		pages,
 		images
@@ -5666,7 +5666,7 @@ function containsBytesWithin(bytes, signature, window) {
 	return false;
 }
 const PdfBytesSchema = zod.z.instanceof(Uint8Array).refine((bytes) => containsBytesWithin(bytes, PDF_HEADER, PDF_HEADER_SEARCH_WINDOW), { message: "not a valid PDF file: missing the %PDF- header" });
-const pdfCodec = zod.z.codec(PdfBytesSchema, document_content_model.LayoutDocumentSchema, {
+const pdfCodec = zod.z.codec(PdfBytesSchema, document_schema_js.LayoutDocumentSchema, {
 	decode: (bytes) => readPdf(bytes),
 	encode: (doc) => writePdf(doc)
 });

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Color, LayoutDocument, LayoutFont } from "document-content-model";
+import { Color, LayoutDocument, LayoutFont } from "document-schema.js";
 import { z } from "zod";
 //#region src/diagnostics.d.ts
 type PdfDiagnosticSeverity = 'info' | 'warning';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Color, LayoutDocument, LayoutFont } from "document-content-model";
+import { Color, LayoutDocument, LayoutFont } from "document-schema.js";
 import { z } from "zod";
 //#region src/diagnostics.d.ts
 type PdfDiagnosticSeverity = 'info' | 'warning';

package/dist/index.js

@@ -1,4 +1,4 @@
-import { COLOR_BLACK, LAYOUT_FORMAT_VERSION, LayoutDocumentSchema } from "document-content-model";
+import { COLOR_BLACK, LAYOUT_FORMAT_VERSION, LayoutDocumentSchema } from "document-schema.js";
 import { Unzlib, inflateSync, unzlibSync, zlibSync } from "fflate";
 import { z } from "zod";
 //#region src/util/base64.ts

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pdf-codec",
-  "version": "1.1.2",
-  "description": "Hand-written, dependency-minimal PDF codec: parses arbitrary real-world PDFs and generates new ones, built on document-content-model's LayoutDocument pivot and Zod 4 codecs.",
+  "version": "1.1.3",
+  "description": "Hand-written, dependency-minimal PDF codec: parses arbitrary real-world PDFs and generates new ones, built on document-schema.js's LayoutDocument pivot and Zod 4 codecs.",
   "type": "module",
   "repository": {
     "type": "git",
@@ -62,7 +62,7 @@
   "license": "MIT",
   "packageManager": "pnpm@11.6.0",
   "dependencies": {
-    "document-content-model": "^1.5.1",
+    "document-schema.js": "^1.5.3",
     "fflate": "^0.8.3",
     "zod": "^4.4.3"
   },