documents.js 4.4.1 → 4.4.2

package/README.md

@@ -238,7 +238,7 @@ const docxBytesAgain = encodeDocumentPackage('docx', pkg);
 const odbPkg = decodeOdbPackage(odbBytes);
 ```
 
-`readDocumentMetadata`/`setDocumentMetadata` read or patch metadata across any `DocumentFormat`. `setDocumentMetadata` patches in place (source/target formats must match); `odf` is rejected in both directions, and `csv` is rejected in both directions too (RFC 4180 text has no metadata container) — `readDocumentMetadata('csv', ...)` answers an empty `LayoutMetadata` for the same reason. `svg` reads its root `<title>` as `metadata.title` and is rejected as a `setDocumentMetadata` source/target for the mirror-image reason: `<title>` is svg's whole metadata surface, so any other override would be silently dropped by the rebuild. `readDocumentMetadata('xlsx', ...)` is a named exception: it renders via `xlsxToPdf` and reads the PDF's metadata, because a direct read and the PDF-preview path genuinely disagree on `createdIso`/`modifiedIso`/`producer`.
+`readDocumentMetadata`/`setDocumentMetadata` read or patch metadata across any `DocumentFormat`. `setDocumentMetadata` patches in place (source/target formats must match); `odf` is rejected in both directions, and `csv` is rejected in both directions too (RFC 4180 text has no metadata container) — `readDocumentMetadata('csv', ...)` answers an empty `LayoutMetadata` for the same reason. `svg` reads its root `<title>` as `metadata.title` and is rejected as a `setDocumentMetadata` source/target for the mirror-image reason: `<title>` is svg's whole metadata surface, so any other override would be silently dropped by the rebuild. `readDocumentMetadata('xlsx', ...)` reads the workbook's own `docProps` like every other content format — `createdIso`/`modifiedIso` from `docProps/core.xml` when the file declares them, `docProps/app.xml`'s Application as `creator`, and `producer` unset (a PDF-only concept no semantic reader sets). It previously rendered a `xlsxToPdf` preview and read that PDF's metadata instead, which for a file carrying no timestamps of its own reported facts about the render rather than the workbook: timestamps stamped at the render moment and a producer naming the preview PDF's writer.
 
 ```ts
 import { readDocumentMetadata, setDocumentMetadata } from 'documents.js';
@@ -260,7 +260,7 @@ One subpath is a declared entry point in its own right: **`documents.js/read`**
 import { pdfToMarkdown } from 'documents.js/read';
 ```
 
-It carries the ten `pdfTo*` conversions and `PdfToDocumentOptions` — identical functions to the root barrel's (the same forwarders, run through the composition engine's read half), never a forked behaviour; `convertDocument` and every X-to-PDF direction stay on the root barrel. `src/read-graph.test.ts` walks the entry's static import graph, follows `pdf-codec` specifiers through that package's real `exports` map into its source, and fails the build if the write path or any font asset becomes reachable.
+It carries the ten `pdfTo*` conversions, `PdfToDocumentOptions`, and `readDocumentMetadata` (with `ReadDocumentMetadataOptions`) — identical functions to the root barrel's (the same forwarders, run through the composition engine's read half, and the same metadata reader dispatched through the read-only codec half `src/codecs/read.ts`), never a forked behaviour; `convertDocument` and every X-to-PDF direction stay on the root barrel. `src/read-graph.test.ts` walks the entry's static import graph, follows `pdf-codec` specifiers through that package's real `exports` map into its source, and fails the build if the write path or any font asset becomes reachable.
 
 ### Reading and building xlsx content directly
 

package/dist/codecs/read.cjs

@@ -0,0 +1,66 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_bytes = require("../model/bytes.cjs");
+const require_markdown_read = require("../markdown/read.cjs");
+const require_ooxml_docx_read = require("../ooxml/docx/read.cjs");
+const require_ooxml_pptx_read = require("../ooxml/pptx/read.cjs");
+const require_odf_formula_read = require("../odf/formula/read.cjs");
+const require_odf_odt_read = require("../odf/odt/read.cjs");
+const require_odf_odp_read = require("../odf/odp/read.cjs");
+const require_odf_ods_read = require("../odf/ods/read.cjs");
+const require_odf_odg_read = require("../odf/odg/read.cjs");
+const require_markdown_text = require("../markdown/text.cjs");
+const require_csv_text = require("../csv/text.cjs");
+const require_csv_read = require("../csv/read.cjs");
+const require_svg_text = require("../svg/text.cjs");
+const require_svg_read = require("../svg/read.cjs");
+const require_ports_abort = require("../ports/abort.cjs");
+const require_package_codec = require("../package-codec.cjs");
+let ooxml_js = require("ooxml.js");
+let pdf_codec_read = require("pdf-codec/read");
+//#region src/codecs/read.ts
+const CONTENT_READERS = {
+	docx: (bytes, options) => {
+		require_ports_abort.throwIfAborted(options?.signal);
+		return require_ooxml_docx_read.readDocxContent(require_package_codec.decodeDocumentPackage("docx", require_model_bytes.requireArrayBufferBytes(bytes)));
+	},
+	pptx: (bytes, options) => {
+		require_ports_abort.throwIfAborted(options?.signal);
+		return require_ooxml_pptx_read.readPptxContent(require_package_codec.decodeDocumentPackage("pptx", require_model_bytes.requireArrayBufferBytes(bytes)));
+	},
+	odt: (bytes, options) => {
+		require_ports_abort.throwIfAborted(options?.signal);
+		return require_odf_odt_read.readOdtContent(require_package_codec.decodeDocumentPackage("odt", require_model_bytes.requireArrayBufferBytes(bytes)));
+	},
+	odp: (bytes, options) => {
+		require_ports_abort.throwIfAborted(options?.signal);
+		return require_odf_odp_read.readOdpContent(require_package_codec.decodeDocumentPackage("odp", require_model_bytes.requireArrayBufferBytes(bytes)));
+	},
+	ods: (bytes, options) => {
+		require_ports_abort.throwIfAborted(options?.signal);
+		return require_odf_ods_read.readOdsContent(require_package_codec.decodeDocumentPackage("ods", require_model_bytes.requireArrayBufferBytes(bytes)));
+	},
+	odg: (bytes, options) => {
+		require_ports_abort.throwIfAborted(options?.signal);
+		return require_odf_odg_read.readOdgContent(require_package_codec.decodeDocumentPackage("odg", require_model_bytes.requireArrayBufferBytes(bytes)));
+	},
+	odf: (bytes, options) => {
+		require_ports_abort.throwIfAborted(options?.signal);
+		return require_odf_formula_read.readOdfFormulaContent(require_package_codec.decodeDocumentPackage("odf", require_model_bytes.requireArrayBufferBytes(bytes)));
+	},
+	markdown: (bytes, options) => require_markdown_read.readMarkdownContent(require_markdown_text.decodeMarkdownText(bytes), {
+		signal: options?.signal,
+		images: options?.images
+	}),
+	csv: (bytes) => require_csv_read.readCsvContent(require_csv_text.decodeCsvText(bytes)),
+	svg: (bytes) => require_svg_read.readSvgContent(require_svg_text.decodeSvgText(bytes)),
+	xlsx: (bytes, options) => {
+		require_ports_abort.throwIfAborted(options?.signal);
+		return (0, ooxml_js.readXlsxContent)(require_package_codec.decodeDocumentPackage("xlsx", require_model_bytes.requireArrayBufferBytes(bytes)));
+	}
+};
+function readDocumentLayout(bytes, options) {
+	return (0, pdf_codec_read.readPdf)(require_model_bytes.requireArrayBufferBytes(bytes), { signal: options?.signal });
+}
+//#endregion
+exports.CONTENT_READERS = CONTENT_READERS;
+exports.readDocumentLayout = readDocumentLayout;

package/dist/codecs/read.d.cts

@@ -0,0 +1,15 @@
+import { DocumentFormat } from "../convert/port.cjs";
+import { ContentDocument } from "document-schema.js";
+import { LayoutDocument } from "pdf-codec";
+import { MarkdownImageResolver } from "markdown-codec";
+//#region src/codecs/read.d.ts
+interface DocumentCodecOptions {
+  readonly signal?: AbortSignal;
+  readonly images?: MarkdownImageResolver;
+}
+type ReadContentFormat = Exclude<DocumentFormat, 'pdf'>;
+type ContentReader = (bytes: Uint8Array, options?: DocumentCodecOptions) => ContentDocument;
+declare const CONTENT_READERS: Readonly<Record<ReadContentFormat, ContentReader>>;
+declare function readDocumentLayout(bytes: Uint8Array, options?: DocumentCodecOptions): LayoutDocument;
+//#endregion
+export { CONTENT_READERS, ContentReader, DocumentCodecOptions, ReadContentFormat, readDocumentLayout };

package/dist/codecs/read.d.ts

@@ -0,0 +1,15 @@
+import { DocumentFormat } from "../convert/port.js";
+import { ContentDocument } from "document-schema.js";
+import { LayoutDocument } from "pdf-codec";
+import { MarkdownImageResolver } from "markdown-codec";
+//#region src/codecs/read.d.ts
+interface DocumentCodecOptions {
+  readonly signal?: AbortSignal;
+  readonly images?: MarkdownImageResolver;
+}
+type ReadContentFormat = Exclude<DocumentFormat, 'pdf'>;
+type ContentReader = (bytes: Uint8Array, options?: DocumentCodecOptions) => ContentDocument;
+declare const CONTENT_READERS: Readonly<Record<ReadContentFormat, ContentReader>>;
+declare function readDocumentLayout(bytes: Uint8Array, options?: DocumentCodecOptions): LayoutDocument;
+//#endregion
+export { CONTENT_READERS, ContentReader, DocumentCodecOptions, ReadContentFormat, readDocumentLayout };

package/dist/codecs/read.js

@@ -0,0 +1,64 @@
+import { requireArrayBufferBytes } from "../model/bytes.js";
+import { readMarkdownContent } from "../markdown/read.js";
+import { readDocxContent as readDocxContent$1 } from "../ooxml/docx/read.js";
+import { readPptxContent as readPptxContent$1 } from "../ooxml/pptx/read.js";
+import { readOdfFormulaContent } from "../odf/formula/read.js";
+import { readOdtContent } from "../odf/odt/read.js";
+import { readOdpContent } from "../odf/odp/read.js";
+import { readOdsContent } from "../odf/ods/read.js";
+import { readOdgContent } from "../odf/odg/read.js";
+import { decodeMarkdownText } from "../markdown/text.js";
+import { decodeCsvText } from "../csv/text.js";
+import { readCsvContent } from "../csv/read.js";
+import { decodeSvgText } from "../svg/text.js";
+import { readSvgContent } from "../svg/read.js";
+import { throwIfAborted } from "../ports/abort.js";
+import { decodeDocumentPackage } from "../package-codec.js";
+import { readXlsxContent } from "ooxml.js";
+import { readPdf } from "pdf-codec/read";
+//#region src/codecs/read.ts
+const CONTENT_READERS = {
+	docx: (bytes, options) => {
+		throwIfAborted(options?.signal);
+		return readDocxContent$1(decodeDocumentPackage("docx", requireArrayBufferBytes(bytes)));
+	},
+	pptx: (bytes, options) => {
+		throwIfAborted(options?.signal);
+		return readPptxContent$1(decodeDocumentPackage("pptx", requireArrayBufferBytes(bytes)));
+	},
+	odt: (bytes, options) => {
+		throwIfAborted(options?.signal);
+		return readOdtContent(decodeDocumentPackage("odt", requireArrayBufferBytes(bytes)));
+	},
+	odp: (bytes, options) => {
+		throwIfAborted(options?.signal);
+		return readOdpContent(decodeDocumentPackage("odp", requireArrayBufferBytes(bytes)));
+	},
+	ods: (bytes, options) => {
+		throwIfAborted(options?.signal);
+		return readOdsContent(decodeDocumentPackage("ods", requireArrayBufferBytes(bytes)));
+	},
+	odg: (bytes, options) => {
+		throwIfAborted(options?.signal);
+		return readOdgContent(decodeDocumentPackage("odg", requireArrayBufferBytes(bytes)));
+	},
+	odf: (bytes, options) => {
+		throwIfAborted(options?.signal);
+		return readOdfFormulaContent(decodeDocumentPackage("odf", requireArrayBufferBytes(bytes)));
+	},
+	markdown: (bytes, options) => readMarkdownContent(decodeMarkdownText(bytes), {
+		signal: options?.signal,
+		images: options?.images
+	}),
+	csv: (bytes) => readCsvContent(decodeCsvText(bytes)),
+	svg: (bytes) => readSvgContent(decodeSvgText(bytes)),
+	xlsx: (bytes, options) => {
+		throwIfAborted(options?.signal);
+		return readXlsxContent(decodeDocumentPackage("xlsx", requireArrayBufferBytes(bytes)));
+	}
+};
+function readDocumentLayout(bytes, options) {
+	return readPdf(requireArrayBufferBytes(bytes), { signal: options?.signal });
+}
+//#endregion
+export { CONTENT_READERS, readDocumentLayout };

package/dist/codecs/registry.cjs

@@ -6,108 +6,62 @@ const require_edit_odp_content = require("../edit/odp/content.cjs");
 const require_edit_ods_content = require("../edit/ods/content.cjs");
 const require_edit_odg_content = require("../edit/odg/content.cjs");
 const require_markdown_write = require("../markdown/write.cjs");
-const require_markdown_read = require("../markdown/read.cjs");
-const require_ooxml_docx_read = require("../ooxml/docx/read.cjs");
-const require_ooxml_pptx_read = require("../ooxml/pptx/read.cjs");
-const require_odf_formula_read = require("../odf/formula/read.cjs");
-const require_odf_odt_read = require("../odf/odt/read.cjs");
-const require_odf_odp_read = require("../odf/odp/read.cjs");
-const require_odf_ods_read = require("../odf/ods/read.cjs");
-const require_odf_odg_read = require("../odf/odg/read.cjs");
 const require_markdown_text = require("../markdown/text.cjs");
 const require_csv_text = require("../csv/text.cjs");
-const require_csv_read = require("../csv/read.cjs");
 const require_csv_write = require("../csv/write.cjs");
 const require_svg_text = require("../svg/text.cjs");
-const require_svg_read = require("../svg/read.cjs");
 const require_svg_write = require("../svg/write.cjs");
-const require_ports_abort = require("../ports/abort.cjs");
 const require_package_codec = require("../package-codec.cjs");
+const require_codecs_read = require("./read.cjs");
 let ooxml_js = require("ooxml.js");
 let pdf_codec = require("pdf-codec");
 //#region src/codecs/registry.ts
-function isArrayBufferBacked(bytes) {
-	return bytes.buffer instanceof ArrayBuffer;
-}
-function requireArrayBufferBytes(bytes) {
-	if (!isArrayBufferBacked(bytes)) throw new TypeError("expected an ArrayBuffer-backed Uint8Array, received one backed by a SharedArrayBuffer");
-	return bytes;
-}
 const DOCUMENT_FORMAT_CODECS = {
 	docx: { content: {
-		read: (bytes, options) => {
-			require_ports_abort.throwIfAborted(options?.signal);
-			return require_ooxml_docx_read.readDocxContent(require_package_codec.decodeDocumentPackage("docx", requireArrayBufferBytes(bytes)));
-		},
+		read: require_codecs_read.CONTENT_READERS.docx,
 		write: (content) => require_package_codec.encodeDocumentPackage("docx", require_edit_docx_content.buildDocxPackage(content))
 	} },
 	pptx: { content: {
-		read: (bytes, options) => {
-			require_ports_abort.throwIfAborted(options?.signal);
-			return require_ooxml_pptx_read.readPptxContent(require_package_codec.decodeDocumentPackage("pptx", requireArrayBufferBytes(bytes)));
-		},
+		read: require_codecs_read.CONTENT_READERS.pptx,
 		write: (content) => require_package_codec.encodeDocumentPackage("pptx", require_edit_pptx_content.buildPptxPackage(content))
 	} },
 	odt: { content: {
-		read: (bytes, options) => {
-			require_ports_abort.throwIfAborted(options?.signal);
-			return require_odf_odt_read.readOdtContent(require_package_codec.decodeDocumentPackage("odt", requireArrayBufferBytes(bytes)));
-		},
+		read: require_codecs_read.CONTENT_READERS.odt,
 		write: (content) => require_package_codec.encodeDocumentPackage("odt", require_edit_odt_content.buildOdtPackage(content))
 	} },
 	odp: { content: {
-		read: (bytes, options) => {
-			require_ports_abort.throwIfAborted(options?.signal);
-			return require_odf_odp_read.readOdpContent(require_package_codec.decodeDocumentPackage("odp", requireArrayBufferBytes(bytes)));
-		},
+		read: require_codecs_read.CONTENT_READERS.odp,
 		write: (content) => require_package_codec.encodeDocumentPackage("odp", require_edit_odp_content.buildOdpPackage(content))
 	} },
 	ods: { content: {
-		read: (bytes, options) => {
-			require_ports_abort.throwIfAborted(options?.signal);
-			return require_odf_ods_read.readOdsContent(require_package_codec.decodeDocumentPackage("ods", requireArrayBufferBytes(bytes)));
-		},
+		read: require_codecs_read.CONTENT_READERS.ods,
 		write: (content) => require_package_codec.encodeDocumentPackage("ods", require_edit_ods_content.buildOdsPackage(content))
 	} },
 	odg: { content: {
-		read: (bytes, options) => {
-			require_ports_abort.throwIfAborted(options?.signal);
-			return require_odf_odg_read.readOdgContent(require_package_codec.decodeDocumentPackage("odg", requireArrayBufferBytes(bytes)));
-		},
+		read: require_codecs_read.CONTENT_READERS.odg,
 		write: (content) => require_package_codec.encodeDocumentPackage("odg", require_edit_odg_content.buildOdgPackage(content))
 	} },
-	odf: { content: { read: (bytes, options) => {
-		require_ports_abort.throwIfAborted(options?.signal);
-		return require_odf_formula_read.readOdfFormulaContent(require_package_codec.decodeDocumentPackage("odf", requireArrayBufferBytes(bytes)));
-	} } },
+	odf: { content: { read: require_codecs_read.CONTENT_READERS.odf } },
 	markdown: { content: {
-		read: (bytes, options) => require_markdown_read.readMarkdownContent(require_markdown_text.decodeMarkdownText(bytes), {
-			signal: options?.signal,
-			images: options?.images
-		}),
+		read: require_codecs_read.CONTENT_READERS.markdown,
 		write: (content) => require_markdown_text.encodeMarkdownText(require_markdown_write.buildMarkdownText(content))
 	} },
 	csv: { content: {
-		read: (bytes) => require_csv_read.readCsvContent(require_csv_text.decodeCsvText(bytes)),
+		read: require_codecs_read.CONTENT_READERS.csv,
 		write: (content) => require_csv_text.encodeCsvText(require_csv_write.buildCsvText(content))
 	} },
 	svg: { content: {
-		read: (bytes) => require_svg_read.readSvgContent(require_svg_text.decodeSvgText(bytes)),
+		read: require_codecs_read.CONTENT_READERS.svg,
 		write: (content) => require_svg_text.encodeSvgText(require_svg_write.buildSvgText(content))
 	} },
 	pdf: { layout: {
-		read: (bytes, options) => (0, pdf_codec.readPdf)(requireArrayBufferBytes(bytes), { signal: options?.signal }),
+		read: require_codecs_read.readDocumentLayout,
 		write: (layout, options) => (0, pdf_codec.writePdf)(layout, { signal: options?.signal })
 	} },
 	xlsx: { content: {
-		read: (bytes, options) => {
-			require_ports_abort.throwIfAborted(options?.signal);
-			return (0, ooxml_js.readXlsxContent)(require_package_codec.decodeDocumentPackage("xlsx", requireArrayBufferBytes(bytes)));
-		},
+		read: require_codecs_read.CONTENT_READERS.xlsx,
 		write: (content) => require_package_codec.encodeDocumentPackage("xlsx", (0, ooxml_js.buildXlsxPackageFromContent)(content))
 	} }
 };
 //#endregion
 exports.DOCUMENT_FORMAT_CODECS = DOCUMENT_FORMAT_CODECS;
-exports.isArrayBufferBacked = isArrayBufferBacked;
-exports.requireArrayBufferBytes = requireArrayBufferBytes;

package/dist/codecs/registry.d.cts

@@ -1,14 +1,8 @@
 import { DocumentFormat } from "../convert/port.cjs";
+import { DocumentCodecOptions } from "./read.cjs";
 import { ContentCodec } from "document-schema.js";
 import { LayoutDocument } from "pdf-codec";
-import { MarkdownImageResolver } from "markdown-codec";
 //#region src/codecs/registry.d.ts
-declare function isArrayBufferBacked(bytes: Uint8Array): bytes is Uint8Array<ArrayBuffer>;
-declare function requireArrayBufferBytes(bytes: Uint8Array): Uint8Array<ArrayBuffer>;
-interface DocumentCodecOptions {
-  readonly signal?: AbortSignal;
-  readonly images?: MarkdownImageResolver;
-}
 interface LayoutEntryCodec {
   read(bytes: Uint8Array, options?: DocumentCodecOptions): LayoutDocument;
   write(layout: LayoutDocument, options?: DocumentCodecOptions): Uint8Array;
@@ -19,4 +13,4 @@ interface DocumentFormatCodecs {
 }
 declare const DOCUMENT_FORMAT_CODECS: Readonly<Record<DocumentFormat, DocumentFormatCodecs>>;
 //#endregion
-export { DOCUMENT_FORMAT_CODECS, DocumentCodecOptions, DocumentFormatCodecs, LayoutEntryCodec, isArrayBufferBacked, requireArrayBufferBytes };
+export { DOCUMENT_FORMAT_CODECS, DocumentFormatCodecs, LayoutEntryCodec };

package/dist/codecs/registry.d.ts

@@ -1,14 +1,8 @@
 import { DocumentFormat } from "../convert/port.js";
+import { DocumentCodecOptions } from "./read.js";
 import { ContentCodec } from "document-schema.js";
 import { LayoutDocument } from "pdf-codec";
-import { MarkdownImageResolver } from "markdown-codec";
 //#region src/codecs/registry.d.ts
-declare function isArrayBufferBacked(bytes: Uint8Array): bytes is Uint8Array<ArrayBuffer>;
-declare function requireArrayBufferBytes(bytes: Uint8Array): Uint8Array<ArrayBuffer>;
-interface DocumentCodecOptions {
-  readonly signal?: AbortSignal;
-  readonly images?: MarkdownImageResolver;
-}
 interface LayoutEntryCodec {
   read(bytes: Uint8Array, options?: DocumentCodecOptions): LayoutDocument;
   write(layout: LayoutDocument, options?: DocumentCodecOptions): Uint8Array;
@@ -19,4 +13,4 @@ interface DocumentFormatCodecs {
 }
 declare const DOCUMENT_FORMAT_CODECS: Readonly<Record<DocumentFormat, DocumentFormatCodecs>>;
 //#endregion
-export { DOCUMENT_FORMAT_CODECS, DocumentCodecOptions, DocumentFormatCodecs, LayoutEntryCodec, isArrayBufferBacked, requireArrayBufferBytes };
+export { DOCUMENT_FORMAT_CODECS, DocumentFormatCodecs, LayoutEntryCodec };

package/dist/codecs/registry.js

@@ -5,106 +5,62 @@ import { buildOdpPackage } from "../edit/odp/content.js";
 import { buildOdsPackage } from "../edit/ods/content.js";
 import { buildOdgPackage } from "../edit/odg/content.js";
 import { buildMarkdownText } from "../markdown/write.js";
-import { readMarkdownContent } from "../markdown/read.js";
-import { readDocxContent as readDocxContent$1 } from "../ooxml/docx/read.js";
-import { readPptxContent as readPptxContent$1 } from "../ooxml/pptx/read.js";
-import { readOdfFormulaContent } from "../odf/formula/read.js";
-import { readOdtContent } from "../odf/odt/read.js";
-import { readOdpContent } from "../odf/odp/read.js";
-import { readOdsContent } from "../odf/ods/read.js";
-import { readOdgContent } from "../odf/odg/read.js";
-import { decodeMarkdownText, encodeMarkdownText } from "../markdown/text.js";
-import { decodeCsvText, encodeCsvText } from "../csv/text.js";
-import { readCsvContent } from "../csv/read.js";
+import { encodeMarkdownText } from "../markdown/text.js";
+import { encodeCsvText } from "../csv/text.js";
 import { buildCsvText } from "../csv/write.js";
-import { decodeSvgText, encodeSvgText } from "../svg/text.js";
-import { readSvgContent } from "../svg/read.js";
+import { encodeSvgText } from "../svg/text.js";
 import { buildSvgText } from "../svg/write.js";
-import { throwIfAborted } from "../ports/abort.js";
-import { decodeDocumentPackage, encodeDocumentPackage } from "../package-codec.js";
-import { buildXlsxPackageFromContent, readXlsxContent } from "ooxml.js";
-import { readPdf, writePdf } from "pdf-codec";
+import { encodeDocumentPackage } from "../package-codec.js";
+import { CONTENT_READERS, readDocumentLayout } from "./read.js";
+import { buildXlsxPackageFromContent } from "ooxml.js";
+import { writePdf } from "pdf-codec";
 //#region src/codecs/registry.ts
-function isArrayBufferBacked(bytes) {
-	return bytes.buffer instanceof ArrayBuffer;
-}
-function requireArrayBufferBytes(bytes) {
-	if (!isArrayBufferBacked(bytes)) throw new TypeError("expected an ArrayBuffer-backed Uint8Array, received one backed by a SharedArrayBuffer");
-	return bytes;
-}
 const DOCUMENT_FORMAT_CODECS = {
 	docx: { content: {
-		read: (bytes, options) => {
-			throwIfAborted(options?.signal);
-			return readDocxContent$1(decodeDocumentPackage("docx", requireArrayBufferBytes(bytes)));
-		},
+		read: CONTENT_READERS.docx,
 		write: (content) => encodeDocumentPackage("docx", buildDocxPackage(content))
 	} },
 	pptx: { content: {
-		read: (bytes, options) => {
-			throwIfAborted(options?.signal);
-			return readPptxContent$1(decodeDocumentPackage("pptx", requireArrayBufferBytes(bytes)));
-		},
+		read: CONTENT_READERS.pptx,
 		write: (content) => encodeDocumentPackage("pptx", buildPptxPackage(content))
 	} },
 	odt: { content: {
-		read: (bytes, options) => {
-			throwIfAborted(options?.signal);
-			return readOdtContent(decodeDocumentPackage("odt", requireArrayBufferBytes(bytes)));
-		},
+		read: CONTENT_READERS.odt,
 		write: (content) => encodeDocumentPackage("odt", buildOdtPackage(content))
 	} },
 	odp: { content: {
-		read: (bytes, options) => {
-			throwIfAborted(options?.signal);
-			return readOdpContent(decodeDocumentPackage("odp", requireArrayBufferBytes(bytes)));
-		},
+		read: CONTENT_READERS.odp,
 		write: (content) => encodeDocumentPackage("odp", buildOdpPackage(content))
 	} },
 	ods: { content: {
-		read: (bytes, options) => {
-			throwIfAborted(options?.signal);
-			return readOdsContent(decodeDocumentPackage("ods", requireArrayBufferBytes(bytes)));
-		},
+		read: CONTENT_READERS.ods,
 		write: (content) => encodeDocumentPackage("ods", buildOdsPackage(content))
 	} },
 	odg: { content: {
-		read: (bytes, options) => {
-			throwIfAborted(options?.signal);
-			return readOdgContent(decodeDocumentPackage("odg", requireArrayBufferBytes(bytes)));
-		},
+		read: CONTENT_READERS.odg,
 		write: (content) => encodeDocumentPackage("odg", buildOdgPackage(content))
 	} },
-	odf: { content: { read: (bytes, options) => {
-		throwIfAborted(options?.signal);
-		return readOdfFormulaContent(decodeDocumentPackage("odf", requireArrayBufferBytes(bytes)));
-	} } },
+	odf: { content: { read: CONTENT_READERS.odf } },
 	markdown: { content: {
-		read: (bytes, options) => readMarkdownContent(decodeMarkdownText(bytes), {
-			signal: options?.signal,
-			images: options?.images
-		}),
+		read: CONTENT_READERS.markdown,
 		write: (content) => encodeMarkdownText(buildMarkdownText(content))
 	} },
 	csv: { content: {
-		read: (bytes) => readCsvContent(decodeCsvText(bytes)),
+		read: CONTENT_READERS.csv,
 		write: (content) => encodeCsvText(buildCsvText(content))
 	} },
 	svg: { content: {
-		read: (bytes) => readSvgContent(decodeSvgText(bytes)),
+		read: CONTENT_READERS.svg,
 		write: (content) => encodeSvgText(buildSvgText(content))
 	} },
 	pdf: { layout: {
-		read: (bytes, options) => readPdf(requireArrayBufferBytes(bytes), { signal: options?.signal }),
+		read: readDocumentLayout,
 		write: (layout, options) => writePdf(layout, { signal: options?.signal })
 	} },
 	xlsx: { content: {
-		read: (bytes, options) => {
-			throwIfAborted(options?.signal);
-			return readXlsxContent(decodeDocumentPackage("xlsx", requireArrayBufferBytes(bytes)));
-		},
+		read: CONTENT_READERS.xlsx,
 		write: (content) => encodeDocumentPackage("xlsx", buildXlsxPackageFromContent(content))
 	} }
 };
 //#endregion
-export { DOCUMENT_FORMAT_CODECS, isArrayBufferBacked, requireArrayBufferBytes };
+export { DOCUMENT_FORMAT_CODECS };

package/dist/convert/from-package.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_model_geometry = require("../model/geometry.cjs");
+const require_model_bytes = require("../model/bytes.cjs");
 const require_layout_shared = require("../layout/shared.cjs");
 require("../layout/sheets.cjs");
 const require_layout_drawing = require("../layout/drawing.cjs");
@@ -15,7 +16,7 @@ function buildDocumentBytes(pkg, target) {
 	if (target === "odf") throw new Error("'odf' (a standalone formula document) cannot be built from a DocumentPackage -- there is no ContentDocument-to-odf builder");
 	const content = require_codecs_registry.DOCUMENT_FORMAT_CODECS[target].content;
 	if (!content?.write) throw new Error(`DocumentFormat '${target}' has no content.write codec in DOCUMENT_FORMAT_CODECS, and is not 'pdf'/'odf' -- this is an internal invariant violation, not a caller error`);
-	return require_codecs_registry.requireArrayBufferBytes(content.write((0, document_schema_js.flattenPackage)(pkg)));
+	return require_model_bytes.requireArrayBufferBytes(content.write((0, document_schema_js.flattenPackage)(pkg)));
 }
 function pageOfFrame(state, frame) {
 	return state.pages[frame.pageIndex];

package/dist/convert/from-package.js

@@ -1,8 +1,9 @@
 import { flipY } from "../model/geometry.js";
+import { requireArrayBufferBytes } from "../model/bytes.js";
 import { pushCellBorderLines, registerImage, runFont } from "../layout/shared.js";
 import "../layout/sheets.js";
 import { convertVector } from "../layout/drawing.js";
-import { DOCUMENT_FORMAT_CODECS, requireArrayBufferBytes } from "../codecs/registry.js";
+import { DOCUMENT_FORMAT_CODECS } from "../codecs/registry.js";
 import { COLOR_BLACK, DEFAULT_LAYOUT_FONT, flattenPackage } from "document-schema.js";
 import { LAYOUT_FORMAT_VERSION, writePdf } from "pdf-codec";
 //#region src/convert/from-package.ts

package/dist/convert/from-pdf.cjs

@@ -1,6 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_convert_composition = require("./composition.cjs");
+const require_codecs_read = require("../codecs/read.cjs");
 //#region src/convert/from-pdf.ts
+function readDocumentMetadata(format, bytes, options) {
+	if (format === "pdf") return require_codecs_read.readDocumentLayout(bytes, { signal: options?.signal }).metadata;
+	return require_codecs_read.CONTENT_READERS[format](bytes, { signal: options?.signal }).metadata;
+}
 function pdfToDocx(bytes, options) {
 	return require_convert_composition.convertDocumentFromPdf("docx", bytes, options);
 }
@@ -42,3 +47,4 @@ exports.pdfToOdt = pdfToOdt;
 exports.pdfToPptx = pdfToPptx;
 exports.pdfToSvg = pdfToSvg;
 exports.pdfToXlsx = pdfToXlsx;
+exports.readDocumentMetadata = readDocumentMetadata;

package/dist/convert/from-pdf.d.cts

@@ -1,7 +1,12 @@
+import { DocumentFormat } from "./port.cjs";
 import { CsvWriteOptions, SvgWriteOptions } from "./convert.cjs";
-import { DocumentPackage } from "document-schema.js";
+import { DocumentPackage, LayoutMetadata } from "document-schema.js";
 import { PdfDiagnosticSink } from "pdf-codec";
 //#region src/convert/from-pdf.d.ts
+interface ReadDocumentMetadataOptions {
+  readonly signal?: AbortSignal;
+}
+declare function readDocumentMetadata(format: DocumentFormat, bytes: Uint8Array<ArrayBuffer>, options?: ReadDocumentMetadataOptions): LayoutMetadata;
 interface PdfToDocumentOptions {
   readonly signal?: AbortSignal;
   readonly sink?: PdfDiagnosticSink;
@@ -18,4 +23,4 @@ declare function pdfToCsv(bytes: Uint8Array<ArrayBuffer>, options?: PdfToDocumen
 declare function pdfToSvg(bytes: Uint8Array<ArrayBuffer>, options?: PdfToDocumentOptions & SvgWriteOptions): Uint8Array<ArrayBuffer>;
 declare function pdfToXlsx(bytes: Uint8Array<ArrayBuffer>, options?: PdfToDocumentOptions): Uint8Array<ArrayBuffer>;
 //#endregion
-export { PdfToDocumentOptions, pdfToCsv, pdfToDocx, pdfToMarkdown, pdfToOdg, pdfToOdp, pdfToOds, pdfToOdt, pdfToPptx, pdfToSvg, pdfToXlsx };
+export { PdfToDocumentOptions, ReadDocumentMetadataOptions, pdfToCsv, pdfToDocx, pdfToMarkdown, pdfToOdg, pdfToOdp, pdfToOds, pdfToOdt, pdfToPptx, pdfToSvg, pdfToXlsx, readDocumentMetadata };

package/dist/convert/from-pdf.d.ts

@@ -1,7 +1,12 @@
+import { DocumentFormat } from "./port.js";
 import { CsvWriteOptions, SvgWriteOptions } from "./convert.js";
-import { DocumentPackage } from "document-schema.js";
+import { DocumentPackage, LayoutMetadata } from "document-schema.js";
 import { PdfDiagnosticSink } from "pdf-codec";
 //#region src/convert/from-pdf.d.ts
+interface ReadDocumentMetadataOptions {
+  readonly signal?: AbortSignal;
+}
+declare function readDocumentMetadata(format: DocumentFormat, bytes: Uint8Array<ArrayBuffer>, options?: ReadDocumentMetadataOptions): LayoutMetadata;
 interface PdfToDocumentOptions {
   readonly signal?: AbortSignal;
   readonly sink?: PdfDiagnosticSink;
@@ -18,4 +23,4 @@ declare function pdfToCsv(bytes: Uint8Array<ArrayBuffer>, options?: PdfToDocumen
 declare function pdfToSvg(bytes: Uint8Array<ArrayBuffer>, options?: PdfToDocumentOptions & SvgWriteOptions): Uint8Array<ArrayBuffer>;
 declare function pdfToXlsx(bytes: Uint8Array<ArrayBuffer>, options?: PdfToDocumentOptions): Uint8Array<ArrayBuffer>;
 //#endregion
-export { PdfToDocumentOptions, pdfToCsv, pdfToDocx, pdfToMarkdown, pdfToOdg, pdfToOdp, pdfToOds, pdfToOdt, pdfToPptx, pdfToSvg, pdfToXlsx };
+export { PdfToDocumentOptions, ReadDocumentMetadataOptions, pdfToCsv, pdfToDocx, pdfToMarkdown, pdfToOdg, pdfToOdp, pdfToOds, pdfToOdt, pdfToPptx, pdfToSvg, pdfToXlsx, readDocumentMetadata };

package/dist/convert/from-pdf.js

@@ -1,5 +1,10 @@
 import { convertDocumentFromPdf } from "./composition.js";
+import { CONTENT_READERS, readDocumentLayout } from "../codecs/read.js";
 //#region src/convert/from-pdf.ts
+function readDocumentMetadata(format, bytes, options) {
+	if (format === "pdf") return readDocumentLayout(bytes, { signal: options?.signal }).metadata;
+	return CONTENT_READERS[format](bytes, { signal: options?.signal }).metadata;
+}
 function pdfToDocx(bytes, options) {
 	return convertDocumentFromPdf("docx", bytes, options);
 }
@@ -31,4 +36,4 @@ function pdfToXlsx(bytes, options) {
 	return convertDocumentFromPdf("xlsx", bytes, options);
 }
 //#endregion
-export { pdfToCsv, pdfToDocx, pdfToMarkdown, pdfToOdg, pdfToOdp, pdfToOds, pdfToOdt, pdfToPptx, pdfToSvg, pdfToXlsx };
+export { pdfToCsv, pdfToDocx, pdfToMarkdown, pdfToOdg, pdfToOdp, pdfToOds, pdfToOdt, pdfToPptx, pdfToSvg, pdfToXlsx, readDocumentMetadata };

package/dist/index.cjs

@@ -99,6 +99,7 @@ const require_convert_port = require("./convert/port.cjs");
 const require_convert_composition = require("./convert/composition.cjs");
 const require_convert_composition_to_pdf = require("./convert/composition-to-pdf.cjs");
 const require_convert_convert = require("./convert/convert.cjs");
+const require_package_codec = require("./package-codec.cjs");
 const require_convert_from_pdf = require("./convert/from-pdf.cjs");
 const require_convert_codec = require("./convert/codec.cjs");
 const require_odb_components = require("./odb/components.cjs");
@@ -114,10 +115,8 @@ const require_odb_report_render = require("./odb/report/render.cjs");
 const require_odb_report_source = require("./odb/report/source.cjs");
 const require_odb_report_content = require("./odb/report/content.cjs");
 const require_convert_local = require("./convert/local.cjs");
-const require_package_codec = require("./package-codec.cjs");
 const require_convert_from_package = require("./convert/from-package.cjs");
 const require_convert_document_fonts = require("./convert/document-fonts.cjs");
-const require_metadata_read = require("./metadata/read.cjs");
 const require_metadata_write = require("./metadata/write.cjs");
 let ooxml_js = require("ooxml.js");
 let document_schema_js = require("document-schema.js");
@@ -961,7 +960,7 @@ Object.defineProperty(exports, "rangeReference", {
 	}
 });
 exports.readCsvContent = require_csv_read.readCsvContent;
-exports.readDocumentMetadata = require_metadata_read.readDocumentMetadata;
+exports.readDocumentMetadata = require_convert_from_pdf.readDocumentMetadata;
 exports.readDocxContent = require_ooxml_docx_read.readDocxContent;
 exports.readDocxExtras = require_ooxml_docx_extras.readDocxExtras;
 exports.readFirebirdBackup = require_firebird_backup.readFirebirdBackup;

package/dist/index.d.cts

@@ -12,7 +12,7 @@ import { i as extractSourceFonts, n as FontSourcePackage, r as createDocumentFon
 import { CsvReadOptions, CsvWriteOptions, DocumentBridgeOptions, DocumentToPdfOptions, OdbConversionOptions, OdbReportToDocxOptions, OdbReportToOdtOptions, OdbToCsvOptions, OdmToPdfOptions, OdmUnresolvedSectionError, SvgReadOptions, SvgWriteOptions, csvToMarkdown, csvToOds, csvToPdf, csvToXlsx, docxToMarkdown, docxToOdt, docxToPdf, docxToPptx, markdownToCsv, markdownToDocx, markdownToOdt, markdownToPdf, markdownToXlsx, odbReportToDocx, odbReportToOdt, odbReportToPdf, odbToCsv, odbToXlsx, odfToPdf, odgToPdf, odgToSvg, odmToPdf, odpToOdt, odpToPdf, odpToPptx, odsToCsv, odsToPdf, odsToXlsx, odtToDocx, odtToMarkdown, odtToOdp, odtToPdf, pptxToDocx, pptxToOdp, pptxToPdf, svgToOdg, svgToPdf, xlsxToCsv, xlsxToMarkdown, xlsxToOds, xlsxToPdf } from "./convert/convert.cjs";
 import { UnsupportedFontSourceFormatError, extractSourceFontsForFormat } from "./convert/document-fonts.cjs";
 import { buildDocumentBytes, layoutDocumentFromPackage } from "./convert/from-package.cjs";
-import { PdfToDocumentOptions, pdfToCsv, pdfToDocx, pdfToMarkdown, pdfToOdg, pdfToOdp, pdfToOds, pdfToOdt, pdfToPptx, pdfToSvg, pdfToXlsx } from "./convert/from-pdf.cjs";
+import { PdfToDocumentOptions, ReadDocumentMetadataOptions, pdfToCsv, pdfToDocx, pdfToMarkdown, pdfToOdg, pdfToOdp, pdfToOds, pdfToOdt, pdfToPptx, pdfToSvg, pdfToXlsx, readDocumentMetadata } from "./convert/from-pdf.cjs";
 import { createLocalDocumentConverter } from "./convert/local.cjs";
 import { ReadCsvContentOptions, readCsvContent } from "./csv/read.cjs";
 import { CsvParseError } from "./csv/records.cjs";
@@ -123,7 +123,6 @@ import { OdbReportContentOptions, OdbReportNotSpecifiedError, readOdbReportConte
 import { renderOdbReportContent } from "./odb/report/render.cjs";
 import { OdbReportDataSourceError, odbReportCommandSql, resolveOdbReportRows } from "./odb/report/source.cjs";
 import { UnsupportedPackageFormatError, decodeDocumentPackage, decodeOdbPackage, encodeDocumentPackage } from "./package-codec.cjs";
-import { ReadDocumentMetadataOptions, readDocumentMetadata } from "./metadata/read.cjs";
 import { MetadataOverrides, SetDocumentMetadataOptions, setDocumentMetadata } from "./metadata/write.cjs";
 import { throwIfAborted } from "./ports/abort.cjs";
 import { Alignment, Box, COLOR_BLACK, CellPosition, CellRange, Color as LayoutColor, ContentBlock, ContentBlockSchema, ContentCellValue, ContentCellValueSchema, ContentDocument, ContentDocumentJson, ContentDocumentSchema, ContentDrawPage, ContentDrawPageSchema, ContentImageBlock, ContentImageBlockSchema, ContentListMembership, ContentPageBreak, ContentPageBreakSchema, ContentParagraph, ContentParagraphSchema, ContentPathPoint, ContentPathPointSchema, ContentPathSegment, ContentPathSegmentSchema, ContentRun, ContentRunSchema, ContentSection, ContentSectionSchema, ContentShape, ContentShapeSchema, ContentSheet, ContentSheetCell, ContentSheetCellSchema, ContentSheetColumn, ContentSheetColumnSchema, ContentSheetImage, ContentSheetPrintRange, ContentSheetPrintRangeSchema, ContentSheetPrintSettings, ContentSheetPrintSettingsSchema, ContentSheetRepeatRange, ContentSheetRepeatRangeSchema, ContentSheetRow, ContentSheetRowSchema, ContentSheetSchema, ContentSlide, ContentSlideSchema, ContentStroke, ContentStrokeSchema, ContentSubpath, ContentSubpathSchema, ContentTable, ContentTableCell, ContentTableCellSchema, ContentTableRow, ContentTableRowSchema, ContentTableSchema, ContentVector, ContentVectorSchema, DEFAULT_LAYOUT_FONT, DocumentJsonResult, DocumentPackage, DocumentPackageJson, DocumentPackageSchema, DocumentSchemaKind, FontFace, LayoutFont, LayoutMetadata, Margins, MathAssembledGlyphs, MathBox, MathColor, MathFontMetrics, MathGlyphMetrics, MathGlyphPlacement, MathGlyphRun, MathLayoutItem, MathRule, MathStretchAxis, MathStretchGlyph, MathStretchResult, MathStroke, PAGE_SIZE_A4, PAGE_SIZE_LETTER, PageSize, PositionedFormula, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, UnrecognizedDocumentSchemaError, cellReference, columnIndexToLetters, columnLettersToIndex, contentDocumentWithSchema, documentFromJson, documentPackageWithSchema, documentSchemaKindOf, isContentBlock, parseCellReference, parseRangeReference, rangeReference, rgbHexToColor, schemaUriFor } from "document-schema.js";

package/dist/index.d.ts

@@ -12,7 +12,7 @@ import { i as extractSourceFonts, n as FontSourcePackage, r as createDocumentFon
 import { CsvReadOptions, CsvWriteOptions, DocumentBridgeOptions, DocumentToPdfOptions, OdbConversionOptions, OdbReportToDocxOptions, OdbReportToOdtOptions, OdbToCsvOptions, OdmToPdfOptions, OdmUnresolvedSectionError, SvgReadOptions, SvgWriteOptions, csvToMarkdown, csvToOds, csvToPdf, csvToXlsx, docxToMarkdown, docxToOdt, docxToPdf, docxToPptx, markdownToCsv, markdownToDocx, markdownToOdt, markdownToPdf, markdownToXlsx, odbReportToDocx, odbReportToOdt, odbReportToPdf, odbToCsv, odbToXlsx, odfToPdf, odgToPdf, odgToSvg, odmToPdf, odpToOdt, odpToPdf, odpToPptx, odsToCsv, odsToPdf, odsToXlsx, odtToDocx, odtToMarkdown, odtToOdp, odtToPdf, pptxToDocx, pptxToOdp, pptxToPdf, svgToOdg, svgToPdf, xlsxToCsv, xlsxToMarkdown, xlsxToOds, xlsxToPdf } from "./convert/convert.js";
 import { UnsupportedFontSourceFormatError, extractSourceFontsForFormat } from "./convert/document-fonts.js";
 import { buildDocumentBytes, layoutDocumentFromPackage } from "./convert/from-package.js";
-import { PdfToDocumentOptions, pdfToCsv, pdfToDocx, pdfToMarkdown, pdfToOdg, pdfToOdp, pdfToOds, pdfToOdt, pdfToPptx, pdfToSvg, pdfToXlsx } from "./convert/from-pdf.js";
+import { PdfToDocumentOptions, ReadDocumentMetadataOptions, pdfToCsv, pdfToDocx, pdfToMarkdown, pdfToOdg, pdfToOdp, pdfToOds, pdfToOdt, pdfToPptx, pdfToSvg, pdfToXlsx, readDocumentMetadata } from "./convert/from-pdf.js";
 import { createLocalDocumentConverter } from "./convert/local.js";
 import { ReadCsvContentOptions, readCsvContent } from "./csv/read.js";
 import { CsvParseError } from "./csv/records.js";
@@ -123,7 +123,6 @@ import { OdbReportContentOptions, OdbReportNotSpecifiedError, readOdbReportConte
 import { renderOdbReportContent } from "./odb/report/render.js";
 import { OdbReportDataSourceError, odbReportCommandSql, resolveOdbReportRows } from "./odb/report/source.js";
 import { UnsupportedPackageFormatError, decodeDocumentPackage, decodeOdbPackage, encodeDocumentPackage } from "./package-codec.js";
-import { ReadDocumentMetadataOptions, readDocumentMetadata } from "./metadata/read.js";
 import { MetadataOverrides, SetDocumentMetadataOptions, setDocumentMetadata } from "./metadata/write.js";
 import { throwIfAborted } from "./ports/abort.js";
 import { Attribute, AttributeSchema, BinaryPart, BinaryPartSchema, Comment, CommentSchema, CompactAttrPairs, CompactPackage, CompactPackageSchema, CompactPart, CompactPartSchema, CompactXmlNode, CompactXmlNodeSchema, DefinedName, DefinedNameSchema, Footnote, FootnoteSchema, NumberingDefinition, NumberingDefinitionSchema, NumberingDefinitions, NumberingLevel, NumberingLevelSchema, Package, PackageSchema, Part, PartSchema, Relationship, XmlCdata, XmlCdataSchema, XmlComment, XmlCommentSchema, XmlDeclaration, XmlDeclarationSchema, XmlElement, XmlElementSchema, XmlNode, XmlNodeSchema, XmlPart, XmlPartSchema, XmlPi, XmlPiSchema, XmlText, XmlTextSchema, attr, base64ToBytes, buildXlsxPackageFromContent as buildXlsxPackage, buildXml, bytesToBase64, childrenWithTag, compactCodec, compactPackageCodec, decodeCompactPackage, decodeEntities, decodePackage, elementsWithTag, encodeCompactPackage, encodePackage, fromCompact, isCompactXmlNode, isXmlNode, packageCodec, parsePackage, parseXml, readXlsxContent, resolveRelationships, rootElement, serializePackage, textContent as textContent$1, toCompact, unzipPackage, walk, xmlCodec, zipPackage } from "ooxml.js";

package/dist/index.js

@@ -98,7 +98,8 @@ import { DOCUMENT_FORMATS, DocumentFormatSchema } from "./convert/port.js";
 import { resolveCompositionPlan } from "./convert/composition.js";
 import { convertDocument } from "./convert/composition-to-pdf.js";
 import { OdmUnresolvedSectionError, csvToMarkdown, csvToOds, csvToPdf, csvToXlsx, docxToMarkdown, docxToOdt, docxToPdf, docxToPptx, markdownToCsv, markdownToDocx, markdownToOdt, markdownToPdf, markdownToXlsx, odbReportToDocx, odbReportToOdt, odbReportToPdf, odbToCsv, odbToXlsx, odfToPdf, odgToPdf, odgToSvg, odmToPdf, odpToOdt, odpToPdf, odpToPptx, odsToCsv, odsToPdf, odsToXlsx, odtToDocx, odtToMarkdown, odtToOdp, odtToPdf, pptxToDocx, pptxToOdp, pptxToPdf, svgToOdg, svgToPdf, xlsxToCsv, xlsxToMarkdown, xlsxToOds, xlsxToPdf } from "./convert/convert.js";
-import { pdfToCsv, pdfToDocx, pdfToMarkdown, pdfToOdg, pdfToOdp, pdfToOds, pdfToOdt, pdfToPptx, pdfToSvg, pdfToXlsx } from "./convert/from-pdf.js";
+import { UnsupportedPackageFormatError, decodeDocumentPackage, decodeOdbPackage, encodeDocumentPackage } from "./package-codec.js";
+import { pdfToCsv, pdfToDocx, pdfToMarkdown, pdfToOdg, pdfToOdp, pdfToOds, pdfToOdt, pdfToPptx, pdfToSvg, pdfToXlsx, readDocumentMetadata } from "./convert/from-pdf.js";
 import { csvMarkdownCodec, csvPdfCodec, docxPdfCodec, markdownDocxCodec, markdownOdtCodec, markdownPdfCodec, odgPdfCodec, odgSvgCodec, odpPdfCodec, odpPptxCodec, odsCsvCodec, odsPdfCodec, odsXlsxCodec, odtDocxCodec, odtPdfCodec, pptxPdfCodec, svgPdfCodec, xlsxCsvCodec, xlsxMarkdownCodec, xlsxPdfCodec } from "./convert/codec.js";
 import { readOdbForms, readOdbReports } from "./odb/components.js";
 import { HsqldbSqlEvaluationError, HsqldbSqlParseError, HsqldbSqlUnsupportedError } from "./odb/sql/errors.js";
@@ -113,10 +114,8 @@ import { renderOdbReportContent } from "./odb/report/render.js";
 import { OdbReportDataSourceError, odbReportCommandSql, resolveOdbReportRows } from "./odb/report/source.js";
 import { OdbReportNotSpecifiedError, readOdbReportContent } from "./odb/report/content.js";
 import { createLocalDocumentConverter } from "./convert/local.js";
-import { UnsupportedPackageFormatError, decodeDocumentPackage, decodeOdbPackage, encodeDocumentPackage } from "./package-codec.js";
 import { buildDocumentBytes, layoutDocumentFromPackage } from "./convert/from-package.js";
 import { UnsupportedFontSourceFormatError, extractSourceFontsForFormat } from "./convert/document-fonts.js";
-import { readDocumentMetadata } from "./metadata/read.js";
 import { setDocumentMetadata } from "./metadata/write.js";
 import { AttributeSchema, BinaryPartSchema, CommentSchema, CompactPackageSchema, CompactPartSchema, CompactXmlNodeSchema, DefinedNameSchema, FootnoteSchema, NumberingDefinitionSchema, NumberingLevelSchema, PackageSchema, PartSchema, XmlCdataSchema, XmlCommentSchema, XmlDeclarationSchema, XmlElementSchema, XmlNodeSchema, XmlPartSchema, XmlPiSchema, XmlTextSchema, attr, base64ToBytes, buildXlsxPackageFromContent as buildXlsxPackage, buildXml, bytesToBase64, childrenWithTag, compactCodec, compactPackageCodec, decodeCompactPackage, decodeEntities, decodePackage, elementsWithTag, encodeCompactPackage, encodePackage, fromCompact, isCompactXmlNode, isXmlNode, packageCodec, parsePackage, parseXml, readXlsxContent, resolveRelationships, rootElement, serializePackage, textContent as textContent$1, toCompact, unzipPackage, walk, xmlCodec, zipPackage } from "ooxml.js";
 import { COLOR_BLACK, ContentBlockSchema, ContentCellValueSchema, ContentDocumentSchema, ContentDrawPageSchema, ContentImageBlockSchema, ContentPageBreakSchema, ContentParagraphSchema, ContentPathPointSchema, ContentPathSegmentSchema, ContentRunSchema, ContentSectionSchema, ContentShapeSchema, ContentSheetCellSchema, ContentSheetColumnSchema, ContentSheetPrintRangeSchema, ContentSheetPrintSettingsSchema, ContentSheetRepeatRangeSchema, ContentSheetRowSchema, ContentSheetSchema, ContentSlideSchema, ContentStrokeSchema, ContentSubpathSchema, ContentTableCellSchema, ContentTableRowSchema, ContentTableSchema, ContentVectorSchema, DEFAULT_LAYOUT_FONT, DocumentPackageSchema, PAGE_SIZE_A4, PAGE_SIZE_LETTER, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, UnrecognizedDocumentSchemaError, cellReference, columnIndexToLetters, columnLettersToIndex, contentDocumentWithSchema, documentFromJson, documentPackageWithSchema, documentSchemaKindOf, isContentBlock, parseCellReference, parseRangeReference, rangeReference, rgbHexToColor, schemaUriFor } from "document-schema.js";

package/dist/metadata/write.cjs

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_bytes = require("../model/bytes.cjs");
 const require_ports_abort = require("../ports/abort.cjs");
 const require_codecs_registry = require("../codecs/registry.cjs");
 let pdf_codec = require("pdf-codec");
@@ -24,7 +25,7 @@ function readContentForFormat(format, bytes, options) {
 function buildBytesForRebuildFormat(format, content) {
 	const codec = require_codecs_registry.DOCUMENT_FORMAT_CODECS[format].content;
 	if (!codec?.write) throw new Error(`RebuildFormat '${format}' has no content.write codec in DOCUMENT_FORMAT_CODECS -- this is an internal invariant violation, not a caller error`);
-	return require_codecs_registry.requireArrayBufferBytes(codec.write(content));
+	return require_model_bytes.requireArrayBufferBytes(codec.write(content));
 }
 function mergeMetadata(current, overrides) {
 	return {

package/dist/metadata/write.js

@@ -1,5 +1,6 @@
+import { requireArrayBufferBytes } from "../model/bytes.js";
 import { throwIfAborted } from "../ports/abort.js";
-import { DOCUMENT_FORMAT_CODECS, requireArrayBufferBytes } from "../codecs/registry.js";
+import { DOCUMENT_FORMAT_CODECS } from "../codecs/registry.js";
 import { readPdf, writePdf } from "pdf-codec";
 //#region src/metadata/write.ts
 const REBUILD_FORMATS = {

package/dist/model/bytes.cjs

@@ -94,6 +94,13 @@ const SvgBytesSchema = zod.z.instanceof(Uint8Array).refine((bytes) => {
 	if (!isWellFormedUtf8Text(bytes)) return false;
 	return new TextDecoder().decode(bytes).toLowerCase().includes("<svg");
 }, { message: "not a valid SVG file: not well-formed UTF-8 text containing an <svg root element" });
+function isArrayBufferBacked(bytes) {
+	return bytes.buffer instanceof ArrayBuffer;
+}
+function requireArrayBufferBytes(bytes) {
+	if (!isArrayBufferBacked(bytes)) throw new TypeError("expected an ArrayBuffer-backed Uint8Array, received one backed by a SharedArrayBuffer");
+	return bytes;
+}
 //#endregion
 exports.CsvBytesSchema = CsvBytesSchema;
 exports.DocxBytesSchema = DocxBytesSchema;
@@ -106,3 +113,4 @@ exports.PdfBytesSchema = PdfBytesSchema;
 exports.PptxBytesSchema = PptxBytesSchema;
 exports.SvgBytesSchema = SvgBytesSchema;
 exports.XlsxBytesSchema = XlsxBytesSchema;
+exports.requireArrayBufferBytes = requireArrayBufferBytes;

package/dist/model/bytes.d.cts

@@ -11,5 +11,6 @@ declare const OdgBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<Ar
 declare const MarkdownBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
 declare const CsvBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
 declare const SvgBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+declare function requireArrayBufferBytes(bytes: Uint8Array): Uint8Array<ArrayBuffer>;
 //#endregion
-export { CsvBytesSchema, DocxBytesSchema, MarkdownBytesSchema, OdgBytesSchema, OdpBytesSchema, OdsBytesSchema, OdtBytesSchema, PdfBytesSchema, PptxBytesSchema, SvgBytesSchema, XlsxBytesSchema };
+export { CsvBytesSchema, DocxBytesSchema, MarkdownBytesSchema, OdgBytesSchema, OdpBytesSchema, OdsBytesSchema, OdtBytesSchema, PdfBytesSchema, PptxBytesSchema, SvgBytesSchema, XlsxBytesSchema, requireArrayBufferBytes };

package/dist/model/bytes.d.ts

@@ -11,5 +11,6 @@ declare const OdgBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<Ar
 declare const MarkdownBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
 declare const CsvBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
 declare const SvgBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+declare function requireArrayBufferBytes(bytes: Uint8Array): Uint8Array<ArrayBuffer>;
 //#endregion
-export { CsvBytesSchema, DocxBytesSchema, MarkdownBytesSchema, OdgBytesSchema, OdpBytesSchema, OdsBytesSchema, OdtBytesSchema, PdfBytesSchema, PptxBytesSchema, SvgBytesSchema, XlsxBytesSchema };
+export { CsvBytesSchema, DocxBytesSchema, MarkdownBytesSchema, OdgBytesSchema, OdpBytesSchema, OdsBytesSchema, OdtBytesSchema, PdfBytesSchema, PptxBytesSchema, SvgBytesSchema, XlsxBytesSchema, requireArrayBufferBytes };

package/dist/model/bytes.js

@@ -93,5 +93,12 @@ const SvgBytesSchema = z.instanceof(Uint8Array).refine((bytes) => {
 	if (!isWellFormedUtf8Text(bytes)) return false;
 	return new TextDecoder().decode(bytes).toLowerCase().includes("<svg");
 }, { message: "not a valid SVG file: not well-formed UTF-8 text containing an <svg root element" });
+function isArrayBufferBacked(bytes) {
+	return bytes.buffer instanceof ArrayBuffer;
+}
+function requireArrayBufferBytes(bytes) {
+	if (!isArrayBufferBacked(bytes)) throw new TypeError("expected an ArrayBuffer-backed Uint8Array, received one backed by a SharedArrayBuffer");
+	return bytes;
+}
 //#endregion
-export { CsvBytesSchema, DocxBytesSchema, MarkdownBytesSchema, OdgBytesSchema, OdpBytesSchema, OdsBytesSchema, OdtBytesSchema, PdfBytesSchema, PptxBytesSchema, SvgBytesSchema, XlsxBytesSchema };
+export { CsvBytesSchema, DocxBytesSchema, MarkdownBytesSchema, OdgBytesSchema, OdpBytesSchema, OdsBytesSchema, OdtBytesSchema, PdfBytesSchema, PptxBytesSchema, SvgBytesSchema, XlsxBytesSchema, requireArrayBufferBytes };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "documents.js",
-  "version": "4.4.1",
+  "version": "4.4.2",
   "description": "Bidirectional docx/pptx <-> PDF conversion and a read+write editable OOXML document model, built on ooxml.js and Zod 4 codecs.",
   "type": "module",
   "repository": {
@@ -105,7 +105,7 @@
     "fflate": "^0.8.3",
     "markdown-codec": "^4.1.0",
     "odf.js": "^5.1.2",
-    "ooxml.js": "^4.4.3",
+    "ooxml.js": "^4.4.4",
     "pdf-codec": "^3.2.0",
     "temml": "0.13.4",
     "zod": "^4.4.3"

package/dist/metadata/read.cjs

@@ -1,15 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_convert_convert = require("../convert/convert.cjs");
-const require_codecs_registry = require("../codecs/registry.cjs");
-let pdf_codec = require("pdf-codec");
-//#region src/metadata/read.ts
-function readDocumentMetadata(format, bytes, options) {
-	const signal = options?.signal;
-	if (format === "xlsx") return (0, pdf_codec.readPdf)(require_convert_convert.xlsxToPdf(bytes, { signal }), { signal }).metadata;
-	const codecs = require_codecs_registry.DOCUMENT_FORMAT_CODECS[format];
-	if (codecs.content) return codecs.content.read(bytes, { signal }).metadata;
-	if (codecs.layout) return codecs.layout.read(bytes, { signal }).metadata;
-	throw new Error(`DocumentFormat '${format}' has neither a content nor a layout codec in DOCUMENT_FORMAT_CODECS, and is not 'xlsx' -- this is an internal invariant violation, not a caller error`);
-}
-//#endregion
-exports.readDocumentMetadata = readDocumentMetadata;

package/dist/metadata/read.d.cts

@@ -1,9 +0,0 @@
-import { DocumentFormat } from "../convert/port.cjs";
-import { LayoutMetadata } from "document-schema.js";
-//#region src/metadata/read.d.ts
-interface ReadDocumentMetadataOptions {
-  readonly signal?: AbortSignal;
-}
-declare function readDocumentMetadata(format: DocumentFormat, bytes: Uint8Array<ArrayBuffer>, options?: ReadDocumentMetadataOptions): LayoutMetadata;
-//#endregion
-export { ReadDocumentMetadataOptions, readDocumentMetadata };

package/dist/metadata/read.d.ts

@@ -1,9 +0,0 @@
-import { DocumentFormat } from "../convert/port.js";
-import { LayoutMetadata } from "document-schema.js";
-//#region src/metadata/read.d.ts
-interface ReadDocumentMetadataOptions {
-  readonly signal?: AbortSignal;
-}
-declare function readDocumentMetadata(format: DocumentFormat, bytes: Uint8Array<ArrayBuffer>, options?: ReadDocumentMetadataOptions): LayoutMetadata;
-//#endregion
-export { ReadDocumentMetadataOptions, readDocumentMetadata };

package/dist/metadata/read.js

@@ -1,14 +0,0 @@
-import { xlsxToPdf } from "../convert/convert.js";
-import { DOCUMENT_FORMAT_CODECS } from "../codecs/registry.js";
-import { readPdf } from "pdf-codec";
-//#region src/metadata/read.ts
-function readDocumentMetadata(format, bytes, options) {
-	const signal = options?.signal;
-	if (format === "xlsx") return readPdf(xlsxToPdf(bytes, { signal }), { signal }).metadata;
-	const codecs = DOCUMENT_FORMAT_CODECS[format];
-	if (codecs.content) return codecs.content.read(bytes, { signal }).metadata;
-	if (codecs.layout) return codecs.layout.read(bytes, { signal }).metadata;
-	throw new Error(`DocumentFormat '${format}' has neither a content nor a layout codec in DOCUMENT_FORMAT_CODECS, and is not 'xlsx' -- this is an internal invariant violation, not a caller error`);
-}
-//#endregion
-export { readDocumentMetadata };