documents.js 1.51.0 → 1.52.0

package/README.md

@@ -81,6 +81,27 @@ const { document, diagnostics } = await converter.convert(
 
 `DocumentFormat` includes `xlsx` alongside `docx`/`pptx`/`odt`/`odp`/`ods`/`odg`/`pdf` — not because xlsx has a PDF conversion of its own, but because `createLocalDocumentConverter`'s `{ source, targetFormat }` contract already generalises past "targetFormat always means pdf": `odt`→`docx`, `docx`→`odt`, `odp`→`pptx`, `pptx`→`odp`, `ods`→`xlsx`, and `xlsx`→`ods` are six further entries in the same `conversions` list, routed to the six bridge functions above with an empty `diagnostics` array.
 
+Getting back the intermediate `DocumentPackage` (content + layout, from `document-content-model`) a conversion built internally, instead of only the target bytes — every ergonomic conversion function above accepts an `onDocument` callback for this, and the port surfaces the same value as `package` on its `ConversionResult`:
+
+```ts
+import { docxToPdf } from 'documents.js';
+
+const pdfBytes = docxToPdf(docxBytes, {
+  onDocument: (pkg) => {
+    console.log(pkg.content.kind); // 'wordprocessing'
+    console.log(pkg.layout?.pages.length); // populated for every X-to-PDF/PDF-to-X conversion
+  },
+});
+
+// or via the port:
+const { document, package: pkg } = await converter.convert(
+  { source: { format: 'docx', bytes: docxBytes }, targetFormat: 'pdf' },
+  { signal: new AbortController().signal },
+);
+```
+
+For the six PDF-bypassing bridges, `pkg.layout` is always `undefined` — a bridge never runs a layout engine, so there is nothing to populate it with; running one purely to fill this field would be wasted work no caller asked for.
+
 Reading and editing docx/pptx content directly, without going through PDF at all:
 
 ```ts
@@ -274,7 +295,7 @@ The package is layered from generic primitives outward to the two conversion dir
 - **`src/layout/`** — the pure conversion algorithms, importing `model` and (for formula placement) `mathml`: `engine.ts` (`ContentDocument` wordprocessing → `LayoutDocument`: flow, line-breaking, pagination — fed identically by docx- and odt-sourced content; also returns `WordprocessingLayoutResult.formulas`, every embedded formula block it laid out via `src/mathml`'s `layoutFormula`, positioned in PDF page space — see the Gotchas entry below on why a formula can't become an ordinary `LayoutItem`), `slides.ts` (`ContentDocument` presentation → `LayoutDocument`: direct EMU-to-point placement, no pagination needed — fed identically by pptx- and odp-sourced content; also exports `convertShape`, the single-`ContentShape`-to-`LayoutItem[]` conversion `drawing.ts` below reuses verbatim, now optionally formula-aware via its own trailing `formulaContext` parameter so `drawing.ts`'s existing call site keeps compiling unchanged), `sheets.ts` (`ContentDocument` spreadsheet → `LayoutDocument`: resolve the print range, build cumulative column/row offsets skipping hidden ones, reserve header/repeat-row-column space, resolve an explicit or non-iterative fit-to-page scale, partition into column/row bands honouring manual breaks with the same "an oversized item gets its own band and overflows rather than looping" guarantee `engine.ts`'s `ensureRoom` documents, emit pages in `downThenOver`/`overThenDown` order, then per page paint backgrounds/gridlines/headers/cell text with default alignment by value kind and `###`/spill-then-truncate overflow handling — the first layout algorithm in this package that accepts an `AbortSignal`, since a 50k-cell sheet needs cancellation where a docx/pptx page count never did), `drawing.ts` (`ContentDocument` drawing → `LayoutDocument`: one `ContentDrawPage` per PDF page, direct placement like `slides.ts`, with one new emission path — a `ContentVector` `rect`/`ellipse`/`line` maps onto the pre-existing `LayoutRect`/`LayoutEllipse`/`LayoutLine` kinds, and a `path` vector's local, viewBox-relative subpath points are resolved through the vector's own frame offset then a single page-space flip into a `LayoutPath` value; vectors paint before shapes, a documented, bounded choice — see this module's own top-of-file note — since `ContentDrawPageSchema` keeps `shapes` and `vectors` as two independently paint-ordered arrays with no field recording their relative order when the two genuinely overlap), `reconstruct.ts` (`LayoutDocument` → `ContentDocument`: `reconstructWordprocessing`/`reconstructPresentation` do baseline-proximity line clustering, then paragraph/text-block clustering from geometry — PDF has no semantic paragraph or shape structure to recover, only positioned glyphs; `reconstructDrawing` does no clustering at all, since a drawing has no such structure to infer in the first place — every `LayoutItem` maps close to 1:1 back onto a `ContentVector` `rect`/`ellipse`/`line`/`path` or a `ContentShape`, in the exact z-order it was painted, bucketed into `ContentDrawPageSchema`'s own two independently-ordered `shapes`/`vectors` arrays the same way `drawing.ts` produced them; `reconstructSpreadsheet` tries a real gridline lattice first — scanning the page's `LayoutLine`/stroked-single-segment-`LayoutPath` items for enough parallel horizontal and vertical lines at consistent positions to call it a printed grid, using those line positions directly as cell boundaries when found — and falls back to text-position clustering otherwise, reusing this same module's `clusterIntoLines` for rows and a parallel recurring-x-position generalisation of `clusterIntoParagraphs`'s own `dominantLeftX` for columns; every recovered cell is a bare string, column widths/row heights are genuinely measured from whichever geometry was used, and no print range/scale/repeat-rows/repeat-columns/manual-breaks are ever inferred).
 - **`src/hsqldb/`** — `script.ts`, the Tier 1 `.odb` decoder: a small, bounded HSQLDB TEXT-script-format (`hsqldb.script_format=0`) DDL/DML text parser, not a database engine — `parseHsqldbScript(bytes)` extracts `CREATE TABLE`'s own column names/types and `INSERT INTO`'s own row values into `HsqldbTable[]`, tolerating (skipping) every other statement kind real HSQLDB output emits that this package has no use for (users, grants, sequences, indexes, views), and throwing `HsqldbScriptParseError` for anything matching neither list. Mirrors `src/pdf/`'s own isolation discipline: it imports only `document-content-model`'s `ContentCellValue` type, no odf.js `Package`/`XmlElement` knowledge at all — the caller is responsible for handing it raw bytes already extracted from a real `.odb` package.
 - **`src/odb/`** — the decoder-selection and pivot-mapping layer sitting between odf.js's `.odb` support and `src/hsqldb/`: `read.ts`'s `readOdbTables(pkg)` calls odf.js's own `readOdbInventory` to classify the package's connection (throwing `OdbNoEmbeddedDataSourceError` for an external-only datasource) and its embedded engine (throwing `OdbUnsupportedFormatError`, naming Firebird or HSQLDB's own binary/compressed script formats explicitly, for anything Tier 1 doesn't cover), then routes a genuine HSQLDB TEXT script to `parseHsqldbScript`. `spreadsheet.ts`'s `odbTablesToSpreadsheetDocument` maps `HsqldbTable[]` onto the same `ContentSheet`-based `ContentDocument` spreadsheet variant `readOdsContent`/`buildOdsPackage` already produce and consume, feeding `odbToXlsx`'s call into `buildXlsxPackage` directly. `csv.ts`'s `buildOdbTableCsv` writes exactly one named table as CSV bytes, with no `ContentSheet`/xlsx machinery involved at all, throwing `OdbTableNotSpecifiedError`/`OdbTableNotFoundError` (naming every available table) when the caller's own `table` option doesn't resolve to exactly one table.
-- **`src/convert/`** — `convert.ts` (the twelve PDF-pivot round-trip ergonomic wrappers, a dedicated "Six cross-format bridges" section: `odtToDocx`/`docxToOdt`, `odpToPptx`/`pptxToOdp`, `odsToXlsx`/`xlsxToOds`, each a direct `readXContent` → `buildYPackage` composition bypassing PDF entirely — see [Fidelity](#fidelity) — `odmToPdf`, the one further conversion shaped around a caller-supplied `resolveSubDocument` callback rather than being purely bytes-in/bytes-out, since a `.odm` master document's own chapters are external references odf.js's `readOdm` never inlines — see Gotchas — `odbToXlsx`/`odbToCsv`, thin compositions over `readOdbTables` and `src/odb/`'s own pivot/CSV mapping, and `odfToPdf`, a standalone `.odf` formula document → PDF via `readOdfFormulaContent` → `src/mathml`'s `layoutFormula` → `writePdf`'s own formula-aware option, with no reverse `pdfToOdf` at all), `codec.ts` (`docxPdfCodec`/`pptxPdfCodec`/`odtPdfCodec`/`odpPdfCodec`/`odsPdfCodec`/`odgPdfCodec` plus `odtDocxCodec`/`odpPptxCodec`/`odsXlsxCodec`, a `z.codec()` pair over each — `odmToPdf`/`odbToXlsx`/`odbToCsv`/`odfToPdf` have no codec of their own, for the same fixed-signature/one-directional reasons each has no port entry, or a one-way port entry, below), `port.ts`/`local.ts` (the swappable `DocumentConverter` contract and its synchronous local implementation, covering `docx`/`pptx`/`odt`/`odp`/`ods`/`odg`/`odf` → `pdf`, `pdf` → `docx`/`pptx`/`odt`/`odp`/`ods`/`odg`, and the six bridge pairs — `DocumentFormat` includes `xlsx` for exactly this reason, even though xlsx has no PDF conversion of its own; `odm` and `odb` are deliberately not `DocumentFormat` members, since neither `odmToPdf` nor `odbToXlsx`/`odbToCsv` is wired into this port at all; `odf` IS a member, but with only the one `odf → pdf` entry — no `pdf → odf`).
+- **`src/convert/`** — `convert.ts` (the twelve PDF-pivot round-trip ergonomic wrappers, a dedicated "Six cross-format bridges" section: `odtToDocx`/`docxToOdt`, `odpToPptx`/`pptxToOdp`, `odsToXlsx`/`xlsxToOds`, each a direct `readXContent` → `buildYPackage` composition bypassing PDF entirely — see [Fidelity](#fidelity) — `odmToPdf`, the one further conversion shaped around a caller-supplied `resolveSubDocument` callback rather than being purely bytes-in/bytes-out, since a `.odm` master document's own chapters are external references odf.js's `readOdm` never inlines — see Gotchas — `odbToXlsx`/`odbToCsv`, thin compositions over `readOdbTables` and `src/odb/`'s own pivot/CSV mapping, and `odfToPdf`, a standalone `.odf` formula document → PDF via `readOdfFormulaContent` → `src/mathml`'s `layoutFormula` → `writePdf`'s own formula-aware option, with no reverse `pdfToOdf` at all), `codec.ts` (`docxPdfCodec`/`pptxPdfCodec`/`odtPdfCodec`/`odpPdfCodec`/`odsPdfCodec`/`odgPdfCodec` plus `odtDocxCodec`/`odpPptxCodec`/`odsXlsxCodec`, a `z.codec()` pair over each — `odmToPdf`/`odbToXlsx`/`odbToCsv`/`odfToPdf` have no codec of their own, for the same fixed-signature/one-directional reasons each has no port entry, or a one-way port entry, below), `port.ts`/`local.ts` (the swappable `DocumentConverter` contract and its synchronous local implementation, covering `docx`/`pptx`/`odt`/`odp`/`ods`/`odg`/`odf` → `pdf`, `pdf` → `docx`/`pptx`/`odt`/`odp`/`ods`/`odg`, and the six bridge pairs — `DocumentFormat` includes `xlsx` for exactly this reason, even though xlsx has no PDF conversion of its own; `odm` and `odb` are deliberately not `DocumentFormat` members, since neither `odmToPdf` nor `odbToXlsx`/`odbToCsv` is wired into this port at all; `odf` IS a member, but with only the one `odf → pdf` entry — no `pdf → odf`). Every conversion function that builds a `ContentDocument`/`LayoutDocument` internally (the twelve PDF-pivot conversions and the six bridges; `odfToPdf` accepts but never invokes it) also accepts an `onDocument` callback, and `ConversionResult` carries the same value through the port as an optional `package` field — the full `DocumentPackage` (content + layout, from `document-content-model`) that conversion built, not just its target bytes.
 
 Dependency direction is strictly downward and checkable: `model`/`bytes`/`mathml` import nothing local (`mathml` is fully self-contained — no dependency on `model`, `document-content-model`, or any ODF/PDF package, since it consumes only its own locally-mirrored `MathMlNode` input and its own injected `MathFontMetrics` port); `image` imports `bytes` only; `pdf` imports `model`+`bytes`+`image`+`mathml`; `ooxml/*` imports `xml`/`model` only (no PDF knowledge); `odf/*` imports `model` only (no PDF knowledge, no `xml/*` — `odf.js` already owns its own XML query helpers); `hsqldb` imports `document-content-model` only (no odf.js knowledge); `layout` imports `model`+`mathml`; `odb` imports `hsqldb`+`model`+odf.js only; `convert` composes everything else. No `PdfObject`/`PdfDict`/`PdfStream` type appears outside `src/pdf/`.
 
@@ -306,6 +327,7 @@ To run a single test file: `pnpm vitest run src/path/to/file.test.ts`.
 
 - **`ooxml.js`'s typed readers (`readDocx`/`readPptx`) are now the actual basis for conversion** — `readDocxContent`/`readPptxContent` are thin wrappers around them, not an independent walk of `word/document.xml`/`ppt/slides/slideN.xml`. They are still deliberately not re-exported from this package's own public surface: `readDocx`/`readPptx` also carry `comments`/`footnotes`/`headers`/`footers` (docx) that `ContentDocument` doesn't model, so exposing both the wrapper and the thing it wraps would invite a caller to reach for the wrong one rather than genuinely offering two competing models.
 - **The docx⇄PDF and pptx⇄PDF conversions are explicitly not round-trip-lossless** — in deliberate contrast to `ooxml.js`'s own `packageCodec`, which is byte/part-faithful by design. See [Fidelity](#fidelity). The six cross-format bridges below (`odtToDocx`/`docxToOdt`, `odpToPptx`/`pptxToOdp`, `odsToXlsx`/`xlsxToOds`) are a genuinely different case — see the [Fidelity](#fidelity) section's own paragraph on them.
+- **A `DocumentPackage` returned via `onDocument`/`ConversionResult.package` is a snapshot from that one conversion pass, not a live view** — its `layout` correlates with its `content` only as of the exact read+layout that produced it (`document-content-model`'s own `DocumentPackageSchema` doc comment), so if a caller mutates the returned `content` afterwards, the `layout` sitting alongside it silently goes stale; nothing in this package (or `document-content-model`) detects or rejects that.
 - **Building the six cross-format bridges surfaced two real, previously-undiscovered gaps in existing `populateParagraph` write paths, both now fixed.** `buildDocxPackage`'s `populateParagraph` (`src/edit/docx/content.ts`) never wrote a paragraph's own `list` membership back (`ContentParagraph.list`, docx's flat `numId`/`level` model) — only read, never written, since no existing caller had ever round-tripped a list-bearing paragraph through it. `buildOdtPackage`'s `populateParagraph` (`src/edit/odt/content.ts`) never wrote a paragraph's own `styleId` back at all (`readOdtContent`/`readOdfParagraph` in `odf.js` reads it unconditionally from `text:style-name`, but nothing on the write side ever set that attribute). Both are now fixed: `DocxParagraph.list` is set unconditionally alongside `styleId`/`alignment`, matching that function's own existing pattern; `OdtParagraph.styleId` is set conditionally alongside `alignment`, matching odt's own local convention. `buildOdtPackage` additionally gained `appendBlocks`/`appendListRun` (`src/edit/odt/content.ts`) — ODF has no flat per-paragraph list property to set the way docx does, so a run of consecutive `ContentParagraph`s sharing `list.numId` is grouped and written as a real, potentially multi-level `text:list`/`text:list-item` tree via `OdtList`/`OdtListItem`, the structural inverse of `odf.js`'s own list-reading (a fresh `text:list` per `numId` change, one level of nesting per `list.level` step, descending only one level at a time since ODF can only open a nested list from inside an existing item). Both gaps were invisible before this task specifically because nothing had previously round-tripped a list-bearing paragraph or a styled paragraph through `docx ⇄ odt` at all — the PDF-pivot conversions never exercised `buildDocxPackage`/`buildOdtPackage` on content read back from the OTHER format.
 - **A table shape inside an odp slide does not survive `odpToPptx`.** `buildPptxPackage`'s `appendShape` (`src/edit/pptx/content.ts`) silently drops any non-paragraph block found inside a shape's own text-box loop — a scope choice whose own comment ("PDF-reconstructed shapes never mix kinds") assumed its only caller was the PDF-reconstruction path, where that is true. `odpToPptx` is a second, non-PDF-reconstructed caller for which it is not: a real odp `draw:frame` containing a `table:table` directly (not inside a text box) reads as a `ContentShape` with a `'table'` block, and that block is silently dropped, leaving an empty pptx text box where the table was. Everything else on the same slide — a rotated shape, grouped shapes, an image, speaker notes — survives correctly (see `src/convert/bridges.test.ts`'s own dedicated fidelity-gap test, which proves both halves against the existing `minimalOdpBytes()` fixture). A real, tracked, bounded gap, not a silent one: closing it means teaching `buildPptxPackage`/`buildOdpPackage` to write a real table into a slide shape, a materially larger feature than this bridge's own scope.
 - **The `ods ⇄ xlsx` bridge inherits several real, format-boundary fidelity limits from `ooxml.js`'s brand-new `readXlsxContent`/`buildXlsxPackage`, on top of its own pivot-copy design.** xlsx has no `percentage`/`currency` cell type of its own (both are a plain numeric cell plus a number-format style neither this reader nor this writer interprets) — an ods `percentage`/`currency` cell survives the `odsToXlsx` hop with its numeric *value* intact but downgrades to a plain `number` *kind*, permanently (currency's own currency code is dropped outright). xlsx also has only one rare `t="d"` cell type covering BOTH date and time — an ods `time` cell survives as a `date`-kind cell carrying its original value string verbatim, but mislabelled; an ods `date` cell is unaffected (it was already the kind xlsx's own `t="d"` maps onto). A formula (`table:formula`/`<f>`) is carried completely verbatim in both directions — never parsed, translated, or evaluated by either this package's own reader or writer — but a REAL spreadsheet application does evaluate a workbook's own `<f>`/`table:formula` on open: confirmed against genuine LibreOffice 26.2, an ods formula authored in OpenFormula syntax (`of:=[.B2]*2`) becomes a formula ERROR (`Err:510`) when the bridged xlsx is opened in real Calc, even though the formula's own cached value is still present and correctly readable via `readXlsxContent` — going the other way is less fragile in practice only because a genuine xlsx formula (bare Excel A1 syntax, e.g. `B2*2`) happens to still parse under LibreOffice's own more lenient, backward-compatible ODF formula grammar, not because of anything this bridge does differently in either direction. Column widths survive the `odsToXlsx` hop within roughly a pixel of rounding tolerance (see `src/convert/bridges.test.ts`'s own `COLUMN_WIDTH_TOLERANCE_PT`) but are then dropped entirely on the return `xlsxToOds` hop — not a character-width-unit rounding loss, but `buildOdsPackage` not writing `ContentSheetColumn.widthPt` at all, a pre-existing, already-documented gap in that file's own module comment, unrelated to and unfixed by this bridge. A boolean cell written by `buildXlsxPackage` renders as a raw `1`/`0` rather than `TRUE`/`FALSE` when opened in real Excel/Calc, since that writer's own genuinely-minimal `xl/styles.xml` (one default cell format, no boolean-specific number format) has nothing else to apply — the underlying `{ kind: 'boolean', value: true }` is still read back correctly by `readXlsxContent` regardless; this is a real-application *display* gap, not a data-fidelity one. `readXlsxContent`'s own cell.value.kind never produces `'error'` from an odf.js-sourced document at all, for a structural reason rather than a bug: ODF's `office:value-type` enumeration has no `error` member, so `OdsCell.value`'s own write-side choice for a `kind: 'error'` cell is to write it as a genuine, non-empty `office:string-value` carrying the error's own text — an `xlsxToOds` → `odsToXlsx` round trip of a genuine xlsx `t="e"` error cell therefore turns it into a plain `string` cell carrying the identical text; the message survives, the `error` semantic does not.

package/dist/index.cjs

@@ -14691,6 +14691,11 @@ function docxToPdf(bytes, options) {
 	const content = readDocxContent(openDocx(bytes).toPackage());
 	if (content.kind !== "wordprocessing") throw new Error("readDocxContent returned a non-wordprocessing ContentDocument");
 	const { document: layout, formulas } = convertWordprocessingToLayout(content, { measurer: createStandardFontMeasurer() });
+	options?.onDocument?.({
+		formatVersion: document_content_model.DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content,
+		layout
+	});
 	return writePdf(layout, {
 		signal: options?.signal,
 		onSubstitution: options?.onSubstitution,
@@ -14704,6 +14709,11 @@ function odtToPdf(bytes, options) {
 		measurer: createStandardFontMeasurer(),
 		formulas: content.formulas
 	});
+	options?.onDocument?.({
+		formatVersion: document_content_model.DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content: content.document,
+		layout
+	});
 	return writePdf(layout, {
 		signal: options?.signal,
 		onSubstitution: options?.onSubstitution,
@@ -14714,6 +14724,11 @@ function pptxToPdf(bytes, options) {
 	const content = readPptxContent(openPptx(bytes).toPackage());
 	if (content.kind !== "presentation") throw new Error("readPptxContent returned a non-presentation ContentDocument");
 	const { document: layout } = convertPresentationToLayout(content, { measurer: createStandardFontMeasurer() });
+	options?.onDocument?.({
+		formatVersion: document_content_model.DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content,
+		layout
+	});
 	return writePdf(layout, {
 		signal: options?.signal,
 		onSubstitution: options?.onSubstitution
@@ -14726,6 +14741,11 @@ function odpToPdf(bytes, options) {
 		measurer: createStandardFontMeasurer(),
 		formulas: content.formulas
 	});
+	options?.onDocument?.({
+		formatVersion: document_content_model.DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content: content.document,
+		layout
+	});
 	return writePdf(layout, {
 		signal: options?.signal,
 		onSubstitution: options?.onSubstitution,
@@ -14735,10 +14755,16 @@ function odpToPdf(bytes, options) {
 function odsToPdf(bytes, options) {
 	const content = readOdsContent((0, odf_js.decodePackage)(bytes));
 	if (content.kind !== "spreadsheet") throw new Error("readOdsContent returned a non-spreadsheet ContentDocument");
-	return writePdf(convertSpreadsheetToLayout(content, {
+	const layout = convertSpreadsheetToLayout(content, {
 		measurer: createStandardFontMeasurer(),
 		signal: options?.signal
-	}), {
+	});
+	options?.onDocument?.({
+		formatVersion: document_content_model.DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content,
+		layout
+	});
+	return writePdf(layout, {
 		signal: options?.signal,
 		onSubstitution: options?.onSubstitution
 	});
@@ -14746,7 +14772,13 @@ function odsToPdf(bytes, options) {
 function odgToPdf(bytes, options) {
 	const content = readOdgContent((0, odf_js.decodePackage)(bytes));
 	if (content.kind !== "drawing") throw new Error("readOdgContent returned a non-drawing ContentDocument");
-	return writePdf(convertDrawingToLayout(content, { measurer: createStandardFontMeasurer() }), {
+	const layout = convertDrawingToLayout(content, { measurer: createStandardFontMeasurer() });
+	options?.onDocument?.({
+		formatVersion: document_content_model.DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content,
+		layout
+	});
+	return writePdf(layout, {
 		signal: options?.signal,
 		onSubstitution: options?.onSubstitution
 	});
@@ -14790,45 +14822,81 @@ function odfToPdf(bytes, options) {
 	});
 }
 function pdfToDocx(bytes, options) {
-	const content = reconstructWordprocessing(readPdf(bytes, {
+	const layout = readPdf(bytes, {
 		signal: options?.signal,
 		sink: options?.sink
-	}), { signal: options?.signal });
+	});
+	const content = reconstructWordprocessing(layout, { signal: options?.signal });
+	options?.onDocument?.({
+		formatVersion: document_content_model.DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content,
+		layout
+	});
 	return (0, ooxml_js.encodePackage)(buildDocxPackage(content));
 }
 function pdfToPptx(bytes, options) {
-	const content = reconstructPresentation(readPdf(bytes, {
+	const layout = readPdf(bytes, {
 		signal: options?.signal,
 		sink: options?.sink
-	}), { signal: options?.signal });
+	});
+	const content = reconstructPresentation(layout, { signal: options?.signal });
+	options?.onDocument?.({
+		formatVersion: document_content_model.DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content,
+		layout
+	});
 	return (0, ooxml_js.encodePackage)(buildPptxPackage(content));
 }
 function pdfToOdt(bytes, options) {
-	const content = reconstructWordprocessing(readPdf(bytes, {
+	const layout = readPdf(bytes, {
 		signal: options?.signal,
 		sink: options?.sink
-	}), { signal: options?.signal });
+	});
+	const content = reconstructWordprocessing(layout, { signal: options?.signal });
+	options?.onDocument?.({
+		formatVersion: document_content_model.DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content,
+		layout
+	});
 	return (0, odf_js.encodePackage)(buildOdtPackage(content));
 }
 function pdfToOdp(bytes, options) {
-	const content = reconstructPresentation(readPdf(bytes, {
+	const layout = readPdf(bytes, {
 		signal: options?.signal,
 		sink: options?.sink
-	}), { signal: options?.signal });
+	});
+	const content = reconstructPresentation(layout, { signal: options?.signal });
+	options?.onDocument?.({
+		formatVersion: document_content_model.DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content,
+		layout
+	});
 	return (0, odf_js.encodePackage)(buildOdpPackage(content));
 }
 function pdfToOdg(bytes, options) {
-	const content = reconstructDrawing(readPdf(bytes, {
+	const layout = readPdf(bytes, {
 		signal: options?.signal,
 		sink: options?.sink
-	}), { signal: options?.signal });
+	});
+	const content = reconstructDrawing(layout, { signal: options?.signal });
+	options?.onDocument?.({
+		formatVersion: document_content_model.DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content,
+		layout
+	});
 	return (0, odf_js.encodePackage)(buildOdgPackage(content));
 }
 function pdfToOds(bytes, options) {
-	const content = reconstructSpreadsheet(readPdf(bytes, {
+	const layout = readPdf(bytes, {
 		signal: options?.signal,
 		sink: options?.sink
-	}), { signal: options?.signal });
+	});
+	const content = reconstructSpreadsheet(layout, { signal: options?.signal });
+	options?.onDocument?.({
+		formatVersion: document_content_model.DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content,
+		layout
+	});
 	return (0, odf_js.encodePackage)(buildOdsPackage(content));
 }
 function odtToDocx(bytes, options) {
@@ -14836,6 +14904,10 @@ function odtToDocx(bytes, options) {
 	const content = readOdtContent((0, odf_js.decodePackage)(bytes)).document;
 	if (content.kind !== "wordprocessing") throw new Error("readOdtContent returned a non-wordprocessing ContentDocument");
 	throwIfAborted(options?.signal);
+	options?.onDocument?.({
+		formatVersion: document_content_model.DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content
+	});
 	return (0, ooxml_js.encodePackage)(buildDocxPackage(content));
 }
 function docxToOdt(bytes, options) {
@@ -14843,6 +14915,10 @@ function docxToOdt(bytes, options) {
 	const content = readDocxContent((0, ooxml_js.decodePackage)(bytes));
 	if (content.kind !== "wordprocessing") throw new Error("readDocxContent returned a non-wordprocessing ContentDocument");
 	throwIfAborted(options?.signal);
+	options?.onDocument?.({
+		formatVersion: document_content_model.DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content
+	});
 	return (0, odf_js.encodePackage)(buildOdtPackage(content));
 }
 function odpToPptx(bytes, options) {
@@ -14850,6 +14926,10 @@ function odpToPptx(bytes, options) {
 	const content = readOdpContent((0, odf_js.decodePackage)(bytes)).document;
 	if (content.kind !== "presentation") throw new Error("readOdpContent returned a non-presentation ContentDocument");
 	throwIfAborted(options?.signal);
+	options?.onDocument?.({
+		formatVersion: document_content_model.DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content
+	});
 	return (0, ooxml_js.encodePackage)(buildPptxPackage(content));
 }
 function pptxToOdp(bytes, options) {
@@ -14857,6 +14937,10 @@ function pptxToOdp(bytes, options) {
 	const content = readPptxContent((0, ooxml_js.decodePackage)(bytes));
 	if (content.kind !== "presentation") throw new Error("readPptxContent returned a non-presentation ContentDocument");
 	throwIfAborted(options?.signal);
+	options?.onDocument?.({
+		formatVersion: document_content_model.DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content
+	});
 	return (0, odf_js.encodePackage)(buildOdpPackage(content));
 }
 function odsToXlsx(bytes, options) {
@@ -14864,6 +14948,10 @@ function odsToXlsx(bytes, options) {
 	const content = readOdsContent((0, odf_js.decodePackage)(bytes));
 	if (content.kind !== "spreadsheet") throw new Error("readOdsContent returned a non-spreadsheet ContentDocument");
 	throwIfAborted(options?.signal);
+	options?.onDocument?.({
+		formatVersion: document_content_model.DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content
+	});
 	return (0, ooxml_js.encodePackage)((0, ooxml_js.buildXlsxPackage)(content));
 }
 function xlsxToOds(bytes, options) {
@@ -14872,6 +14960,10 @@ function xlsxToOds(bytes, options) {
 	const content = (0, ooxml_js.readXlsxContent)(pkg);
 	if (content.kind !== "spreadsheet") throw new Error("readXlsxContent returned a non-spreadsheet ContentDocument");
 	throwIfAborted(options?.signal);
+	options?.onDocument?.({
+		formatVersion: document_content_model.DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content
+	});
 	return (0, odf_js.encodePackage)(buildOdsPackage(content));
 }
 var OdmUnresolvedSectionError = class extends Error {
@@ -15100,238 +15192,292 @@ function fromPdfDiagnostic(diagnostic) {
 }
 function createLocalDocumentConverter() {
 	return {
-		contractVersion: 1,
+		contractVersion: 2,
 		conversions: SUPPORTED_CONVERSIONS,
 		convert(request, options) {
 			const { source, targetFormat } = request;
 			const diagnostics = [];
+			let documentPackage;
+			const onDocument = (pkg) => {
+				documentPackage = pkg;
+			};
 			if (source.format === "docx" && targetFormat === "pdf") {
 				const bytes = docxToPdf(source.bytes, {
 					signal: options.signal,
-					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c))
+					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "pdf",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "pptx" && targetFormat === "pdf") {
 				const bytes = pptxToPdf(source.bytes, {
 					signal: options.signal,
-					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c))
+					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "pdf",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "odt" && targetFormat === "pdf") {
 				const bytes = odtToPdf(source.bytes, {
 					signal: options.signal,
-					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c))
+					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "pdf",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "odp" && targetFormat === "pdf") {
 				const bytes = odpToPdf(source.bytes, {
 					signal: options.signal,
-					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c))
+					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "pdf",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "ods" && targetFormat === "pdf") {
 				const bytes = odsToPdf(source.bytes, {
 					signal: options.signal,
-					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c))
+					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "pdf",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "odg" && targetFormat === "pdf") {
 				const bytes = odgToPdf(source.bytes, {
 					signal: options.signal,
-					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c))
+					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "pdf",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "odf" && targetFormat === "pdf") {
 				const bytes = odfToPdf(source.bytes, {
 					signal: options.signal,
-					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c))
+					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "pdf",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "pdf" && targetFormat === "docx") {
 				const bytes = pdfToDocx(source.bytes, {
 					signal: options.signal,
-					sink: (d) => diagnostics.push(fromPdfDiagnostic(d))
+					sink: (d) => diagnostics.push(fromPdfDiagnostic(d)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "docx",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "pdf" && targetFormat === "pptx") {
 				const bytes = pdfToPptx(source.bytes, {
 					signal: options.signal,
-					sink: (d) => diagnostics.push(fromPdfDiagnostic(d))
+					sink: (d) => diagnostics.push(fromPdfDiagnostic(d)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "pptx",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "pdf" && targetFormat === "odt") {
 				const bytes = pdfToOdt(source.bytes, {
 					signal: options.signal,
-					sink: (d) => diagnostics.push(fromPdfDiagnostic(d))
+					sink: (d) => diagnostics.push(fromPdfDiagnostic(d)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "odt",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "pdf" && targetFormat === "odp") {
 				const bytes = pdfToOdp(source.bytes, {
 					signal: options.signal,
-					sink: (d) => diagnostics.push(fromPdfDiagnostic(d))
+					sink: (d) => diagnostics.push(fromPdfDiagnostic(d)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "odp",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "pdf" && targetFormat === "ods") {
 				const bytes = pdfToOds(source.bytes, {
 					signal: options.signal,
-					sink: (d) => diagnostics.push(fromPdfDiagnostic(d))
+					sink: (d) => diagnostics.push(fromPdfDiagnostic(d)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "ods",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "pdf" && targetFormat === "odg") {
 				const bytes = pdfToOdg(source.bytes, {
 					signal: options.signal,
-					sink: (d) => diagnostics.push(fromPdfDiagnostic(d))
+					sink: (d) => diagnostics.push(fromPdfDiagnostic(d)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "odg",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "odt" && targetFormat === "docx") {
-				const bytes = odtToDocx(source.bytes, { signal: options.signal });
+				const bytes = odtToDocx(source.bytes, {
+					signal: options.signal,
+					onDocument
+				});
 				return Promise.resolve({
 					document: {
 						format: "docx",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "docx" && targetFormat === "odt") {
-				const bytes = docxToOdt(source.bytes, { signal: options.signal });
+				const bytes = docxToOdt(source.bytes, {
+					signal: options.signal,
+					onDocument
+				});
 				return Promise.resolve({
 					document: {
 						format: "odt",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "odp" && targetFormat === "pptx") {
-				const bytes = odpToPptx(source.bytes, { signal: options.signal });
+				const bytes = odpToPptx(source.bytes, {
+					signal: options.signal,
+					onDocument
+				});
 				return Promise.resolve({
 					document: {
 						format: "pptx",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "pptx" && targetFormat === "odp") {
-				const bytes = pptxToOdp(source.bytes, { signal: options.signal });
+				const bytes = pptxToOdp(source.bytes, {
+					signal: options.signal,
+					onDocument
+				});
 				return Promise.resolve({
 					document: {
 						format: "odp",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "ods" && targetFormat === "xlsx") {
-				const bytes = odsToXlsx(source.bytes, { signal: options.signal });
+				const bytes = odsToXlsx(source.bytes, {
+					signal: options.signal,
+					onDocument
+				});
 				return Promise.resolve({
 					document: {
 						format: "xlsx",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "xlsx" && targetFormat === "ods") {
-				const bytes = xlsxToOds(source.bytes, { signal: options.signal });
+				const bytes = xlsxToOds(source.bytes, {
+					signal: options.signal,
+					onDocument
+				});
 				return Promise.resolve({
 					document: {
 						format: "ods",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			return Promise.reject(/* @__PURE__ */ new Error(`unsupported conversion: ${source.format} -> ${targetFormat}`));

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { Attribute, AttributeSchema, BinaryPart, BinaryPartSchema, Comment, CommentSchema, CompactAttrPairs, CompactPackage, CompactPackageSchema, CompactPart, CompactPartSchema, CompactXmlNode, CompactXmlNodeSchema, DefinedName, DefinedNameSchema, Package, Package as Package$1, PackageSchema, Part, PartSchema, Relationship, XmlCdata, XmlCdataSchema, XmlComment, XmlCommentSchema, XmlDeclaration, XmlDeclarationSchema, XmlElement, XmlElement as XmlElement$1, XmlElementSchema, XmlNode, XmlNode as XmlNode$1, XmlNodeSchema, XmlPart, XmlPartSchema, XmlPi, XmlPiSchema, XmlText, XmlTextSchema, attr, base64ToBytes, buildXml, bytesToBase64, childrenWithTag, compactCodec, compactPackageCodec, decodeCompactPackage, decodeEntities, decodePackage, elementsWithTag, encodeCompactPackage, encodePackage, fromCompact, isCompactXmlNode, isXmlNode, packageCodec, parsePackage, parseXml, resolveRelationships, rootElement, serializePackage, textContent as textContent$1, toCompact, unzipPackage, walk, xmlCodec, zipPackage } from "ooxml.js";
-import { Alignment, Box, Box as Box$1, COLOR_BLACK, Color, Color as LayoutColor, ContentBlock, ContentBlockSchema, ContentCellValue, ContentCellValue as ContentCellValue$1, ContentCellValueSchema, ContentDrawPage, ContentDrawPageSchema, ContentImageBlock, ContentImageBlockSchema, ContentListMembership, ContentListMembership as ContentListMembership$1, ContentPageBreak, ContentPageBreakSchema, ContentParagraph, ContentParagraphSchema, ContentPathPoint, ContentPathPoint as ContentPathPoint$1, ContentPathPointSchema, ContentPathSegment, ContentPathSegmentSchema, ContentRun, ContentRun as ContentRun$1, ContentRunSchema, ContentSection, ContentSectionSchema, ContentShape, ContentShapeSchema, ContentSheet, ContentSheetCell, ContentSheetCellSchema, ContentSheetColumn, ContentSheetColumnSchema, ContentSheetImage, ContentSheetPrintRange, ContentSheetPrintRangeSchema, ContentSheetPrintSettings, ContentSheetPrintSettings as ContentSheetPrintSettings$1, ContentSheetPrintSettingsSchema, ContentSheetRepeatRange, ContentSheetRepeatRangeSchema, ContentSheetRow, ContentSheetRowSchema, ContentSheetSchema, ContentSlide, ContentSlideSchema, ContentStroke, ContentStroke as ContentStroke$1, ContentStrokeSchema, ContentSubpath, ContentSubpath as ContentSubpath$1, ContentSubpathSchema, ContentTable, ContentTableCell, ContentTableCellSchema, ContentTableRow, ContentTableRowSchema, ContentTableSchema, ContentVector, ContentVectorSchema, DEFAULT_LAYOUT_FONT, LAYOUT_FORMAT_VERSION, LayoutDocument, LayoutDocument as LayoutDocument$1, LayoutEllipse, LayoutFont, LayoutImage, LayoutImageAsset, LayoutItem, LayoutLine, LayoutLink, LayoutMetadata, LayoutMetadata as LayoutMetadata$1, LayoutPage, LayoutPath, LayoutPathSegment, LayoutRect, LayoutSubpath, LayoutText, Margins, PAGE_SIZE_A4, PAGE_SIZE_LETTER, PageSize, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, isContentBlock, rgbHexToColor } from "document-content-model";
+import { Alignment, Box, Box as Box$1, COLOR_BLACK, Color, Color as LayoutColor, ContentBlock, ContentBlockSchema, ContentCellValue, ContentCellValue as ContentCellValue$1, ContentCellValueSchema, ContentDrawPage, ContentDrawPageSchema, ContentImageBlock, ContentImageBlockSchema, ContentListMembership, ContentListMembership as ContentListMembership$1, ContentPageBreak, ContentPageBreakSchema, ContentParagraph, ContentParagraphSchema, ContentPathPoint, ContentPathPoint as ContentPathPoint$1, ContentPathPointSchema, ContentPathSegment, ContentPathSegmentSchema, ContentRun, ContentRun as ContentRun$1, ContentRunSchema, ContentSection, ContentSectionSchema, ContentShape, ContentShapeSchema, ContentSheet, ContentSheetCell, ContentSheetCellSchema, ContentSheetColumn, ContentSheetColumnSchema, ContentSheetImage, ContentSheetPrintRange, ContentSheetPrintRangeSchema, ContentSheetPrintSettings, ContentSheetPrintSettings as ContentSheetPrintSettings$1, ContentSheetPrintSettingsSchema, ContentSheetRepeatRange, ContentSheetRepeatRangeSchema, ContentSheetRow, ContentSheetRowSchema, ContentSheetSchema, ContentSlide, ContentSlideSchema, ContentStroke, ContentStroke as ContentStroke$1, ContentStrokeSchema, ContentSubpath, ContentSubpath as ContentSubpath$1, ContentSubpathSchema, ContentTable, ContentTableCell, ContentTableCellSchema, ContentTableRow, ContentTableRowSchema, ContentTableSchema, ContentVector, ContentVectorSchema, DEFAULT_LAYOUT_FONT, DocumentPackage, LAYOUT_FORMAT_VERSION, LayoutDocument, LayoutDocument as LayoutDocument$1, LayoutEllipse, LayoutFont, LayoutImage, LayoutImageAsset, LayoutItem, LayoutLine, LayoutLink, LayoutMetadata, LayoutMetadata as LayoutMetadata$1, LayoutPage, LayoutPath, LayoutPathSegment, LayoutRect, LayoutSubpath, LayoutText, Margins, PAGE_SIZE_A4, PAGE_SIZE_LETTER, PageSize, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, isContentBlock, rgbHexToColor } from "document-content-model";
 import { z } from "zod";
 import { Package as Package$2, XmlElement as XmlElement$2, XmlNode as XmlNode$2 } from "odf.js";
 //#region src/model/content.d.ts
@@ -1458,6 +1458,7 @@ interface DocumentToPdfOptions {
   readonly onSubstitution?: (substitution: WinAnsiSubstitution, context: {
     readonly pageIndex: number;
   }) => void;
+  readonly onDocument?: (pkg: DocumentPackage) => void;
 }
 declare function docxToPdf(bytes: Uint8Array<ArrayBuffer>, options?: DocumentToPdfOptions): Uint8Array<ArrayBuffer>;
 declare function odtToPdf(bytes: Uint8Array<ArrayBuffer>, options?: DocumentToPdfOptions): Uint8Array<ArrayBuffer>;
@@ -1469,6 +1470,7 @@ declare function odfToPdf(bytes: Uint8Array<ArrayBuffer>, options?: DocumentToPd
 interface PdfToDocumentOptions {
   readonly signal?: AbortSignal;
   readonly sink?: PdfDiagnosticSink;
+  readonly onDocument?: (pkg: DocumentPackage) => void;
 }
 declare function pdfToDocx(bytes: Uint8Array<ArrayBuffer>, options?: PdfToDocumentOptions): Uint8Array<ArrayBuffer>;
 declare function pdfToPptx(bytes: Uint8Array<ArrayBuffer>, options?: PdfToDocumentOptions): Uint8Array<ArrayBuffer>;
@@ -1478,6 +1480,7 @@ declare function pdfToOdg(bytes: Uint8Array<ArrayBuffer>, options?: PdfToDocumen
 declare function pdfToOds(bytes: Uint8Array<ArrayBuffer>, options?: PdfToDocumentOptions): Uint8Array<ArrayBuffer>;
 interface DocumentBridgeOptions {
   readonly signal?: AbortSignal;
+  readonly onDocument?: (pkg: DocumentPackage) => void;
 }
 declare function odtToDocx(bytes: Uint8Array<ArrayBuffer>, options?: DocumentBridgeOptions): Uint8Array<ArrayBuffer>;
 declare function docxToOdt(bytes: Uint8Array<ArrayBuffer>, options?: DocumentBridgeOptions): Uint8Array<ArrayBuffer>;
@@ -1572,6 +1575,7 @@ interface ConversionRequest {
 interface ConversionResult {
   readonly document: DocumentPayload;
   readonly diagnostics: readonly Diagnostic[];
+  readonly package?: DocumentPackage;
 }
 interface DocumentConverter {
   readonly contractVersion: number;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { Attribute, AttributeSchema, BinaryPart, BinaryPartSchema, Comment, CommentSchema, CompactAttrPairs, CompactPackage, CompactPackageSchema, CompactPart, CompactPartSchema, CompactXmlNode, CompactXmlNodeSchema, DefinedName, DefinedNameSchema, Package, Package as Package$1, PackageSchema, Part, PartSchema, Relationship, XmlCdata, XmlCdataSchema, XmlComment, XmlCommentSchema, XmlDeclaration, XmlDeclarationSchema, XmlElement, XmlElement as XmlElement$1, XmlElementSchema, XmlNode, XmlNode as XmlNode$1, XmlNodeSchema, XmlPart, XmlPartSchema, XmlPi, XmlPiSchema, XmlText, XmlTextSchema, attr, base64ToBytes, buildXml, bytesToBase64, childrenWithTag, compactCodec, compactPackageCodec, decodeCompactPackage, decodeEntities, decodePackage, elementsWithTag, encodeCompactPackage, encodePackage, fromCompact, isCompactXmlNode, isXmlNode, packageCodec, parsePackage, parseXml, resolveRelationships, rootElement, serializePackage, textContent as textContent$1, toCompact, unzipPackage, walk, xmlCodec, zipPackage } from "ooxml.js";
-import { Alignment, Box, Box as Box$1, COLOR_BLACK, Color, Color as LayoutColor, ContentBlock, ContentBlockSchema, ContentCellValue, ContentCellValue as ContentCellValue$1, ContentCellValueSchema, ContentDrawPage, ContentDrawPageSchema, ContentImageBlock, ContentImageBlockSchema, ContentListMembership, ContentListMembership as ContentListMembership$1, ContentPageBreak, ContentPageBreakSchema, ContentParagraph, ContentParagraphSchema, ContentPathPoint, ContentPathPoint as ContentPathPoint$1, ContentPathPointSchema, ContentPathSegment, ContentPathSegmentSchema, ContentRun, ContentRun as ContentRun$1, ContentRunSchema, ContentSection, ContentSectionSchema, ContentShape, ContentShapeSchema, ContentSheet, ContentSheetCell, ContentSheetCellSchema, ContentSheetColumn, ContentSheetColumnSchema, ContentSheetImage, ContentSheetPrintRange, ContentSheetPrintRangeSchema, ContentSheetPrintSettings, ContentSheetPrintSettings as ContentSheetPrintSettings$1, ContentSheetPrintSettingsSchema, ContentSheetRepeatRange, ContentSheetRepeatRangeSchema, ContentSheetRow, ContentSheetRowSchema, ContentSheetSchema, ContentSlide, ContentSlideSchema, ContentStroke, ContentStroke as ContentStroke$1, ContentStrokeSchema, ContentSubpath, ContentSubpath as ContentSubpath$1, ContentSubpathSchema, ContentTable, ContentTableCell, ContentTableCellSchema, ContentTableRow, ContentTableRowSchema, ContentTableSchema, ContentVector, ContentVectorSchema, DEFAULT_LAYOUT_FONT, LAYOUT_FORMAT_VERSION, LayoutDocument, LayoutDocument as LayoutDocument$1, LayoutEllipse, LayoutFont, LayoutImage, LayoutImageAsset, LayoutItem, LayoutLine, LayoutLink, LayoutMetadata, LayoutMetadata as LayoutMetadata$1, LayoutPage, LayoutPath, LayoutPathSegment, LayoutRect, LayoutSubpath, LayoutText, Margins, PAGE_SIZE_A4, PAGE_SIZE_LETTER, PageSize, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, isContentBlock, rgbHexToColor } from "document-content-model";
+import { Alignment, Box, Box as Box$1, COLOR_BLACK, Color, Color as LayoutColor, ContentBlock, ContentBlockSchema, ContentCellValue, ContentCellValue as ContentCellValue$1, ContentCellValueSchema, ContentDrawPage, ContentDrawPageSchema, ContentImageBlock, ContentImageBlockSchema, ContentListMembership, ContentListMembership as ContentListMembership$1, ContentPageBreak, ContentPageBreakSchema, ContentParagraph, ContentParagraphSchema, ContentPathPoint, ContentPathPoint as ContentPathPoint$1, ContentPathPointSchema, ContentPathSegment, ContentPathSegmentSchema, ContentRun, ContentRun as ContentRun$1, ContentRunSchema, ContentSection, ContentSectionSchema, ContentShape, ContentShapeSchema, ContentSheet, ContentSheetCell, ContentSheetCellSchema, ContentSheetColumn, ContentSheetColumnSchema, ContentSheetImage, ContentSheetPrintRange, ContentSheetPrintRangeSchema, ContentSheetPrintSettings, ContentSheetPrintSettings as ContentSheetPrintSettings$1, ContentSheetPrintSettingsSchema, ContentSheetRepeatRange, ContentSheetRepeatRangeSchema, ContentSheetRow, ContentSheetRowSchema, ContentSheetSchema, ContentSlide, ContentSlideSchema, ContentStroke, ContentStroke as ContentStroke$1, ContentStrokeSchema, ContentSubpath, ContentSubpath as ContentSubpath$1, ContentSubpathSchema, ContentTable, ContentTableCell, ContentTableCellSchema, ContentTableRow, ContentTableRowSchema, ContentTableSchema, ContentVector, ContentVectorSchema, DEFAULT_LAYOUT_FONT, DocumentPackage, LAYOUT_FORMAT_VERSION, LayoutDocument, LayoutDocument as LayoutDocument$1, LayoutEllipse, LayoutFont, LayoutImage, LayoutImageAsset, LayoutItem, LayoutLine, LayoutLink, LayoutMetadata, LayoutMetadata as LayoutMetadata$1, LayoutPage, LayoutPath, LayoutPathSegment, LayoutRect, LayoutSubpath, LayoutText, Margins, PAGE_SIZE_A4, PAGE_SIZE_LETTER, PageSize, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, isContentBlock, rgbHexToColor } from "document-content-model";
 import { z } from "zod";
 import { Package as Package$2, XmlElement as XmlElement$2, XmlNode as XmlNode$2 } from "odf.js";
 //#region src/model/content.d.ts
@@ -1458,6 +1458,7 @@ interface DocumentToPdfOptions {
   readonly onSubstitution?: (substitution: WinAnsiSubstitution, context: {
     readonly pageIndex: number;
   }) => void;
+  readonly onDocument?: (pkg: DocumentPackage) => void;
 }
 declare function docxToPdf(bytes: Uint8Array<ArrayBuffer>, options?: DocumentToPdfOptions): Uint8Array<ArrayBuffer>;
 declare function odtToPdf(bytes: Uint8Array<ArrayBuffer>, options?: DocumentToPdfOptions): Uint8Array<ArrayBuffer>;
@@ -1469,6 +1470,7 @@ declare function odfToPdf(bytes: Uint8Array<ArrayBuffer>, options?: DocumentToPd
 interface PdfToDocumentOptions {
   readonly signal?: AbortSignal;
   readonly sink?: PdfDiagnosticSink;
+  readonly onDocument?: (pkg: DocumentPackage) => void;
 }
 declare function pdfToDocx(bytes: Uint8Array<ArrayBuffer>, options?: PdfToDocumentOptions): Uint8Array<ArrayBuffer>;
 declare function pdfToPptx(bytes: Uint8Array<ArrayBuffer>, options?: PdfToDocumentOptions): Uint8Array<ArrayBuffer>;
@@ -1478,6 +1480,7 @@ declare function pdfToOdg(bytes: Uint8Array<ArrayBuffer>, options?: PdfToDocumen
 declare function pdfToOds(bytes: Uint8Array<ArrayBuffer>, options?: PdfToDocumentOptions): Uint8Array<ArrayBuffer>;
 interface DocumentBridgeOptions {
   readonly signal?: AbortSignal;
+  readonly onDocument?: (pkg: DocumentPackage) => void;
 }
 declare function odtToDocx(bytes: Uint8Array<ArrayBuffer>, options?: DocumentBridgeOptions): Uint8Array<ArrayBuffer>;
 declare function docxToOdt(bytes: Uint8Array<ArrayBuffer>, options?: DocumentBridgeOptions): Uint8Array<ArrayBuffer>;
@@ -1572,6 +1575,7 @@ interface ConversionRequest {
 interface ConversionResult {
   readonly document: DocumentPayload;
   readonly diagnostics: readonly Diagnostic[];
+  readonly package?: DocumentPackage;
 }
 interface DocumentConverter {
   readonly contractVersion: number;

package/dist/index.js

@@ -1,5 +1,5 @@
 import { AttributeSchema, BinaryPartSchema, CommentSchema, CompactPackageSchema, CompactPartSchema, CompactXmlNodeSchema, DefinedNameSchema, PackageSchema, PartSchema, XmlCdataSchema, XmlCommentSchema, XmlDeclarationSchema, XmlElementSchema, XmlNodeSchema, XmlPartSchema, XmlPiSchema, XmlTextSchema, attr, attr as attr$1, base64ToBytes, base64ToBytes as base64ToBytes$1, buildXlsxPackage, buildXml, bytesToBase64, bytesToBase64 as bytesToBase64$1, childrenWithTag, compactCodec, compactPackageCodec, decodeCompactPackage, decodeEntities, decodePackage, decodePackage as decodePackage$1, elementsWithTag, elementsWithTag as elementsWithTag$1, encodeCompactPackage, encodePackage, encodePackage as encodePackage$1, fromCompact, isCompactXmlNode, isXmlNode, packageCodec, parsePackage, parseXml, readDocx, readPptx, readXlsxContent, resolveRelationships, resolveRelationships as resolveRelationships$1, rootElement, rootElement as rootElement$1, serializePackage, textContent as textContent$1, textContent as textContent$2, toCompact, unzipPackage, walk, xmlCodec, zipPackage } from "ooxml.js";
-import { COLOR_BLACK, COLOR_BLACK as COLOR_BLACK$1, ContentBlockSchema, ContentCellValueSchema, ContentDrawPageSchema, ContentDrawPageSchema as ContentDrawPageSchema$1, ContentImageBlockSchema, ContentPageBreakSchema, ContentParagraphSchema, ContentPathPointSchema, ContentPathSegmentSchema, ContentRunSchema, ContentSectionSchema, ContentSectionSchema as ContentSectionSchema$1, ContentShapeSchema, ContentSheetCellSchema, ContentSheetColumnSchema, ContentSheetPrintRangeSchema, ContentSheetPrintSettingsSchema, ContentSheetRepeatRangeSchema, ContentSheetRowSchema, ContentSheetSchema, ContentSheetSchema as ContentSheetSchema$1, ContentSlideSchema, ContentSlideSchema as ContentSlideSchema$1, ContentStrokeSchema, ContentSubpathSchema, ContentTableCellSchema, ContentTableRowSchema, ContentTableSchema, ContentVectorSchema, DEFAULT_LAYOUT_FONT, LAYOUT_FORMAT_VERSION, LAYOUT_FORMAT_VERSION as LAYOUT_FORMAT_VERSION$1, LayoutDocumentSchema, LayoutMetadataSchema, PAGE_SIZE_A4, PAGE_SIZE_LETTER, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, colorToRgbHex, isContentBlock, rgbHexToColor } from "document-content-model";
+import { COLOR_BLACK, COLOR_BLACK as COLOR_BLACK$1, ContentBlockSchema, ContentCellValueSchema, ContentDrawPageSchema, ContentDrawPageSchema as ContentDrawPageSchema$1, ContentImageBlockSchema, ContentPageBreakSchema, ContentParagraphSchema, ContentPathPointSchema, ContentPathSegmentSchema, ContentRunSchema, ContentSectionSchema, ContentSectionSchema as ContentSectionSchema$1, ContentShapeSchema, ContentSheetCellSchema, ContentSheetColumnSchema, ContentSheetPrintRangeSchema, ContentSheetPrintSettingsSchema, ContentSheetRepeatRangeSchema, ContentSheetRowSchema, ContentSheetSchema, ContentSheetSchema as ContentSheetSchema$1, ContentSlideSchema, ContentSlideSchema as ContentSlideSchema$1, ContentStrokeSchema, ContentSubpathSchema, ContentTableCellSchema, ContentTableRowSchema, ContentTableSchema, ContentVectorSchema, DEFAULT_LAYOUT_FONT, DOCUMENT_PACKAGE_FORMAT_VERSION, LAYOUT_FORMAT_VERSION, LAYOUT_FORMAT_VERSION as LAYOUT_FORMAT_VERSION$1, LayoutDocumentSchema, LayoutMetadataSchema, PAGE_SIZE_A4, PAGE_SIZE_LETTER, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, colorToRgbHex, isContentBlock, rgbHexToColor } from "document-content-model";
 import { z } from "zod";
 import { ODF_MEDIA_TYPES, StyleRegistry, applyOdfTransform, attrValue, base64ToBytes as base64ToBytes$2, buildOdfSubpaths, bytesToBase64 as bytesToBase64$2, childrenWithTag as childrenWithTag$1, decodeOdfText, decodePackage as decodePackage$2, encodePackage as encodePackage$2, findChildElement, findStyleElement, formatOdfColor, formatOdfLength, parseBox, parseCellReference, parseLinePoints, parseMargins, parseOdfColor, parseOdfLength, parseOdfPathData, parseOdfViewBox, parsePageSize, readDrawFrame, readManifest, readOdbInventory, readOdfFormula, readOdfMetadata, readOdfParagraph, readOdfTable, readOdg, readOdm, readOdp, readOds, readOdt, resolveOdfShapeGeometry, resolvePageLayoutProperties, resolveStyle, rootElement as rootElement$2, setDocumentMediaType, syncManifest, syncManifest as syncManifest$1, xmlnsAttributes } from "odf.js";
 import { Unzlib, inflateSync, unzlibSync, zlibSync } from "fflate";
@@ -14690,6 +14690,11 @@ function docxToPdf(bytes, options) {
 	const content = readDocxContent(openDocx(bytes).toPackage());
 	if (content.kind !== "wordprocessing") throw new Error("readDocxContent returned a non-wordprocessing ContentDocument");
 	const { document: layout, formulas } = convertWordprocessingToLayout(content, { measurer: createStandardFontMeasurer() });
+	options?.onDocument?.({
+		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content,
+		layout
+	});
 	return writePdf(layout, {
 		signal: options?.signal,
 		onSubstitution: options?.onSubstitution,
@@ -14703,6 +14708,11 @@ function odtToPdf(bytes, options) {
 		measurer: createStandardFontMeasurer(),
 		formulas: content.formulas
 	});
+	options?.onDocument?.({
+		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content: content.document,
+		layout
+	});
 	return writePdf(layout, {
 		signal: options?.signal,
 		onSubstitution: options?.onSubstitution,
@@ -14713,6 +14723,11 @@ function pptxToPdf(bytes, options) {
 	const content = readPptxContent(openPptx(bytes).toPackage());
 	if (content.kind !== "presentation") throw new Error("readPptxContent returned a non-presentation ContentDocument");
 	const { document: layout } = convertPresentationToLayout(content, { measurer: createStandardFontMeasurer() });
+	options?.onDocument?.({
+		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content,
+		layout
+	});
 	return writePdf(layout, {
 		signal: options?.signal,
 		onSubstitution: options?.onSubstitution
@@ -14725,6 +14740,11 @@ function odpToPdf(bytes, options) {
 		measurer: createStandardFontMeasurer(),
 		formulas: content.formulas
 	});
+	options?.onDocument?.({
+		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content: content.document,
+		layout
+	});
 	return writePdf(layout, {
 		signal: options?.signal,
 		onSubstitution: options?.onSubstitution,
@@ -14734,10 +14754,16 @@ function odpToPdf(bytes, options) {
 function odsToPdf(bytes, options) {
 	const content = readOdsContent(decodePackage$2(bytes));
 	if (content.kind !== "spreadsheet") throw new Error("readOdsContent returned a non-spreadsheet ContentDocument");
-	return writePdf(convertSpreadsheetToLayout(content, {
+	const layout = convertSpreadsheetToLayout(content, {
 		measurer: createStandardFontMeasurer(),
 		signal: options?.signal
-	}), {
+	});
+	options?.onDocument?.({
+		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content,
+		layout
+	});
+	return writePdf(layout, {
 		signal: options?.signal,
 		onSubstitution: options?.onSubstitution
 	});
@@ -14745,7 +14771,13 @@ function odsToPdf(bytes, options) {
 function odgToPdf(bytes, options) {
 	const content = readOdgContent(decodePackage$2(bytes));
 	if (content.kind !== "drawing") throw new Error("readOdgContent returned a non-drawing ContentDocument");
-	return writePdf(convertDrawingToLayout(content, { measurer: createStandardFontMeasurer() }), {
+	const layout = convertDrawingToLayout(content, { measurer: createStandardFontMeasurer() });
+	options?.onDocument?.({
+		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content,
+		layout
+	});
+	return writePdf(layout, {
 		signal: options?.signal,
 		onSubstitution: options?.onSubstitution
 	});
@@ -14789,45 +14821,81 @@ function odfToPdf(bytes, options) {
 	});
 }
 function pdfToDocx(bytes, options) {
-	const content = reconstructWordprocessing(readPdf(bytes, {
+	const layout = readPdf(bytes, {
 		signal: options?.signal,
 		sink: options?.sink
-	}), { signal: options?.signal });
+	});
+	const content = reconstructWordprocessing(layout, { signal: options?.signal });
+	options?.onDocument?.({
+		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content,
+		layout
+	});
 	return encodePackage$1(buildDocxPackage(content));
 }
 function pdfToPptx(bytes, options) {
-	const content = reconstructPresentation(readPdf(bytes, {
+	const layout = readPdf(bytes, {
 		signal: options?.signal,
 		sink: options?.sink
-	}), { signal: options?.signal });
+	});
+	const content = reconstructPresentation(layout, { signal: options?.signal });
+	options?.onDocument?.({
+		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content,
+		layout
+	});
 	return encodePackage$1(buildPptxPackage(content));
 }
 function pdfToOdt(bytes, options) {
-	const content = reconstructWordprocessing(readPdf(bytes, {
+	const layout = readPdf(bytes, {
 		signal: options?.signal,
 		sink: options?.sink
-	}), { signal: options?.signal });
+	});
+	const content = reconstructWordprocessing(layout, { signal: options?.signal });
+	options?.onDocument?.({
+		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content,
+		layout
+	});
 	return encodePackage$2(buildOdtPackage(content));
 }
 function pdfToOdp(bytes, options) {
-	const content = reconstructPresentation(readPdf(bytes, {
+	const layout = readPdf(bytes, {
 		signal: options?.signal,
 		sink: options?.sink
-	}), { signal: options?.signal });
+	});
+	const content = reconstructPresentation(layout, { signal: options?.signal });
+	options?.onDocument?.({
+		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content,
+		layout
+	});
 	return encodePackage$2(buildOdpPackage(content));
 }
 function pdfToOdg(bytes, options) {
-	const content = reconstructDrawing(readPdf(bytes, {
+	const layout = readPdf(bytes, {
 		signal: options?.signal,
 		sink: options?.sink
-	}), { signal: options?.signal });
+	});
+	const content = reconstructDrawing(layout, { signal: options?.signal });
+	options?.onDocument?.({
+		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content,
+		layout
+	});
 	return encodePackage$2(buildOdgPackage(content));
 }
 function pdfToOds(bytes, options) {
-	const content = reconstructSpreadsheet(readPdf(bytes, {
+	const layout = readPdf(bytes, {
 		signal: options?.signal,
 		sink: options?.sink
-	}), { signal: options?.signal });
+	});
+	const content = reconstructSpreadsheet(layout, { signal: options?.signal });
+	options?.onDocument?.({
+		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content,
+		layout
+	});
 	return encodePackage$2(buildOdsPackage(content));
 }
 function odtToDocx(bytes, options) {
@@ -14835,6 +14903,10 @@ function odtToDocx(bytes, options) {
 	const content = readOdtContent(decodePackage$2(bytes)).document;
 	if (content.kind !== "wordprocessing") throw new Error("readOdtContent returned a non-wordprocessing ContentDocument");
 	throwIfAborted(options?.signal);
+	options?.onDocument?.({
+		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content
+	});
 	return encodePackage$1(buildDocxPackage(content));
 }
 function docxToOdt(bytes, options) {
@@ -14842,6 +14914,10 @@ function docxToOdt(bytes, options) {
 	const content = readDocxContent(decodePackage$1(bytes));
 	if (content.kind !== "wordprocessing") throw new Error("readDocxContent returned a non-wordprocessing ContentDocument");
 	throwIfAborted(options?.signal);
+	options?.onDocument?.({
+		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content
+	});
 	return encodePackage$2(buildOdtPackage(content));
 }
 function odpToPptx(bytes, options) {
@@ -14849,6 +14925,10 @@ function odpToPptx(bytes, options) {
 	const content = readOdpContent(decodePackage$2(bytes)).document;
 	if (content.kind !== "presentation") throw new Error("readOdpContent returned a non-presentation ContentDocument");
 	throwIfAborted(options?.signal);
+	options?.onDocument?.({
+		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content
+	});
 	return encodePackage$1(buildPptxPackage(content));
 }
 function pptxToOdp(bytes, options) {
@@ -14856,6 +14936,10 @@ function pptxToOdp(bytes, options) {
 	const content = readPptxContent(decodePackage$1(bytes));
 	if (content.kind !== "presentation") throw new Error("readPptxContent returned a non-presentation ContentDocument");
 	throwIfAborted(options?.signal);
+	options?.onDocument?.({
+		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content
+	});
 	return encodePackage$2(buildOdpPackage(content));
 }
 function odsToXlsx(bytes, options) {
@@ -14863,6 +14947,10 @@ function odsToXlsx(bytes, options) {
 	const content = readOdsContent(decodePackage$2(bytes));
 	if (content.kind !== "spreadsheet") throw new Error("readOdsContent returned a non-spreadsheet ContentDocument");
 	throwIfAborted(options?.signal);
+	options?.onDocument?.({
+		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content
+	});
 	return encodePackage$1(buildXlsxPackage(content));
 }
 function xlsxToOds(bytes, options) {
@@ -14871,6 +14959,10 @@ function xlsxToOds(bytes, options) {
 	const content = readXlsxContent(pkg);
 	if (content.kind !== "spreadsheet") throw new Error("readXlsxContent returned a non-spreadsheet ContentDocument");
 	throwIfAborted(options?.signal);
+	options?.onDocument?.({
+		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
+		content
+	});
 	return encodePackage$2(buildOdsPackage(content));
 }
 var OdmUnresolvedSectionError = class extends Error {
@@ -15099,238 +15191,292 @@ function fromPdfDiagnostic(diagnostic) {
 }
 function createLocalDocumentConverter() {
 	return {
-		contractVersion: 1,
+		contractVersion: 2,
 		conversions: SUPPORTED_CONVERSIONS,
 		convert(request, options) {
 			const { source, targetFormat } = request;
 			const diagnostics = [];
+			let documentPackage;
+			const onDocument = (pkg) => {
+				documentPackage = pkg;
+			};
 			if (source.format === "docx" && targetFormat === "pdf") {
 				const bytes = docxToPdf(source.bytes, {
 					signal: options.signal,
-					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c))
+					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "pdf",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "pptx" && targetFormat === "pdf") {
 				const bytes = pptxToPdf(source.bytes, {
 					signal: options.signal,
-					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c))
+					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "pdf",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "odt" && targetFormat === "pdf") {
 				const bytes = odtToPdf(source.bytes, {
 					signal: options.signal,
-					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c))
+					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "pdf",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "odp" && targetFormat === "pdf") {
 				const bytes = odpToPdf(source.bytes, {
 					signal: options.signal,
-					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c))
+					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "pdf",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "ods" && targetFormat === "pdf") {
 				const bytes = odsToPdf(source.bytes, {
 					signal: options.signal,
-					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c))
+					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "pdf",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "odg" && targetFormat === "pdf") {
 				const bytes = odgToPdf(source.bytes, {
 					signal: options.signal,
-					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c))
+					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "pdf",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "odf" && targetFormat === "pdf") {
 				const bytes = odfToPdf(source.bytes, {
 					signal: options.signal,
-					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c))
+					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "pdf",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "pdf" && targetFormat === "docx") {
 				const bytes = pdfToDocx(source.bytes, {
 					signal: options.signal,
-					sink: (d) => diagnostics.push(fromPdfDiagnostic(d))
+					sink: (d) => diagnostics.push(fromPdfDiagnostic(d)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "docx",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "pdf" && targetFormat === "pptx") {
 				const bytes = pdfToPptx(source.bytes, {
 					signal: options.signal,
-					sink: (d) => diagnostics.push(fromPdfDiagnostic(d))
+					sink: (d) => diagnostics.push(fromPdfDiagnostic(d)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "pptx",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "pdf" && targetFormat === "odt") {
 				const bytes = pdfToOdt(source.bytes, {
 					signal: options.signal,
-					sink: (d) => diagnostics.push(fromPdfDiagnostic(d))
+					sink: (d) => diagnostics.push(fromPdfDiagnostic(d)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "odt",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "pdf" && targetFormat === "odp") {
 				const bytes = pdfToOdp(source.bytes, {
 					signal: options.signal,
-					sink: (d) => diagnostics.push(fromPdfDiagnostic(d))
+					sink: (d) => diagnostics.push(fromPdfDiagnostic(d)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "odp",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "pdf" && targetFormat === "ods") {
 				const bytes = pdfToOds(source.bytes, {
 					signal: options.signal,
-					sink: (d) => diagnostics.push(fromPdfDiagnostic(d))
+					sink: (d) => diagnostics.push(fromPdfDiagnostic(d)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "ods",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "pdf" && targetFormat === "odg") {
 				const bytes = pdfToOdg(source.bytes, {
 					signal: options.signal,
-					sink: (d) => diagnostics.push(fromPdfDiagnostic(d))
+					sink: (d) => diagnostics.push(fromPdfDiagnostic(d)),
+					onDocument
 				});
 				return Promise.resolve({
 					document: {
 						format: "odg",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "odt" && targetFormat === "docx") {
-				const bytes = odtToDocx(source.bytes, { signal: options.signal });
+				const bytes = odtToDocx(source.bytes, {
+					signal: options.signal,
+					onDocument
+				});
 				return Promise.resolve({
 					document: {
 						format: "docx",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "docx" && targetFormat === "odt") {
-				const bytes = docxToOdt(source.bytes, { signal: options.signal });
+				const bytes = docxToOdt(source.bytes, {
+					signal: options.signal,
+					onDocument
+				});
 				return Promise.resolve({
 					document: {
 						format: "odt",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "odp" && targetFormat === "pptx") {
-				const bytes = odpToPptx(source.bytes, { signal: options.signal });
+				const bytes = odpToPptx(source.bytes, {
+					signal: options.signal,
+					onDocument
+				});
 				return Promise.resolve({
 					document: {
 						format: "pptx",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "pptx" && targetFormat === "odp") {
-				const bytes = pptxToOdp(source.bytes, { signal: options.signal });
+				const bytes = pptxToOdp(source.bytes, {
+					signal: options.signal,
+					onDocument
+				});
 				return Promise.resolve({
 					document: {
 						format: "odp",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "ods" && targetFormat === "xlsx") {
-				const bytes = odsToXlsx(source.bytes, { signal: options.signal });
+				const bytes = odsToXlsx(source.bytes, {
+					signal: options.signal,
+					onDocument
+				});
 				return Promise.resolve({
 					document: {
 						format: "xlsx",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			if (source.format === "xlsx" && targetFormat === "ods") {
-				const bytes = xlsxToOds(source.bytes, { signal: options.signal });
+				const bytes = xlsxToOds(source.bytes, {
+					signal: options.signal,
+					onDocument
+				});
 				return Promise.resolve({
 					document: {
 						format: "ods",
 						bytes
 					},
-					diagnostics
+					diagnostics,
+					package: documentPackage
 				});
 			}
 			return Promise.reject(/* @__PURE__ */ new Error(`unsupported conversion: ${source.format} -> ${targetFormat}`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "documents.js",
-  "version": "1.51.0",
+  "version": "1.52.0",
   "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": {
@@ -64,7 +64,7 @@
   "license": "MIT",
   "packageManager": "pnpm@11.6.0",
   "dependencies": {
-    "document-content-model": "^1.3.0",
+    "document-content-model": "^1.4.0",
     "fflate": "^0.8.3",
     "odf.js": "^1.10.0",
     "ooxml.js": "^2.2.0",