odf.js 1.3.0 → 1.4.0

package/README.md

@@ -0,0 +1,116 @@
+# odf.js
+
+[![GitHub](https://img.shields.io/badge/GitHub-181717?logo=github&logoColor=white)](https://github.com/ExaDev/odf.js) [![npm](https://img.shields.io/badge/npm-CB3837?logo=npm&logoColor=white)](https://www.npmjs.com/package/odf.js) [![Release](https://img.shields.io/github/v/release/ExaDev/odf.js)](https://github.com/ExaDev/odf.js/releases/latest) [![CI](https://img.shields.io/github/actions/workflow/status/ExaDev/odf.js/ci.yml?branch=main)](https://github.com/ExaDev/odf.js/actions)
+
+> A hand-written, dependency-minimal codec for the OpenDocument Format (ODF — OASIS/ISO 26300): `.odt`/`.ods`/`.odp`/`.odg`/`.odf`/`.odb`/`.odm` and their template variants, built on [Zod 4](https://zod.dev) codecs.
+
+`odf.js` is the ODF sibling of [`ooxml.js`](https://github.com/ExaDev/ooxml.js), mirroring its architecture as closely as the two, structurally unrelated formats allow: a lossless ZIP-of-XML core that round-trips any package byte-for-content-faithful, with ergonomic typed readers layered on top for convenient access. Unlike OOXML — a ZIP of parts with a relationship-file (`.rels`) mechanism and an extension-defaults-plus-overrides `[Content_Types].xml` — ODF has no relationships at all (inter-part references are direct paths/IRIs) and an exhaustive `META-INF/manifest.xml` that enumerates every part explicitly. Where OOXML runs carry formatting directly as attributes, ODF has no inline/direct formatting whatsoever: every formatting difference, however small, must be a named "automatic style" — so `odf.js` owns a style-interning subsystem (`src/styles/`) with no equivalent anywhere in `ooxml.js`.
+
+**This package does not depend on `ooxml.js`**, even though the two do near-identical jobs for their respective formats: `ooxml.js` is a package signed, SBOM-attested, and branded exclusively around ECMA-376/OOXML, so depending on it here would be a permanently wrong signal for an OASIS-standard codec, and would force a breaking `ooxml.js` release every time an ODF-only fix needed the shared primitive layer. Instead, `odf.js` duplicates the small (~400-line) generic ZIP/XML/`Package` layer as its own code — kept deliberately structurally identical (plain, unmarked shapes, no branding) so TypeScript's structural typing makes the two packages' `Package`/`XmlNode`/`XmlElement` values freely interchangeable wherever a shared consumer (like `documents.js`) needs to treat them uniformly, without either package formally depending on the other.
+
+Both packages **do** depend on [`document-content-model`](https://github.com/ExaDev/document-content-model), the genuinely shared canonical schema for `ContentDocument`/`LayoutDocument` — the semantic content model (paragraphs, runs, tables, shapes, slides) both an ODF and an OOXML reader ultimately produce. `odf.js`'s typed readers return the real, imported `ContentSection`/`ContentSlide`/etc. types from that package, not a structurally-similar lookalike, so a downstream consumer (`documents.js`) can run an `.odt` through the exact same layout/pagination engine it already uses for `.docx`, unmodified.
+
+## Status
+
+This package is under active development. What's built and shipped:
+
+- **Lossless core** — generic ZIP-of-XML primitives (`Package`/`XmlNode`/`XmlElement`, XML parse/build, zip/unzip, base64, the `packageCodec`/`xmlCodec` `z.codec()` pairs) with zero ODF-specific knowledge.
+- **Namespaces, media types, mimetype, manifest** (`src/ns.ts`, `src/media-type.ts`, `src/mimetype.ts`, `src/manifest.ts`) — full read *and* write, including `META-INF/manifest.xml`'s exhaustive per-part enumeration and the mimetype part's mandatory first-entry/stored/uncompressed byte layout, verified against real LibreOffice-produced output.
+- **Style interning** (`src/styles/`) — `StyleRegistry`: adopts a part's existing automatic styles on construction, finds-or-mints on `intern()`, fingerprints on canonical serialized properties plus parent style name (never `JSON.stringify`), and is collision-checked across all four style containers a document can have.
+- **Shared typed primitives** (`src/typed/shared/`) — ODF length-unit parsing (`cm`/`mm`/`in`/`pt`/`pc`/`px`), A1-style spreadsheet cell-reference computation with repeat-count cursor advancement, colour/geometry parsing into `document-content-model`'s own types, ODF's `text:s`/`text:tab`/`text:line-break` whitespace-run decoding, the read-side style cascade (`style:default-style` → parent chain → the referenced style — one layer shorter than OOXML's, since ODF has no separate direct-formatting layer on top), and `meta.xml` reading.
+
+Not yet built: the per-format typed readers (`readOdt`, `readOds`, `readOdp`, `readOdg`, `readOdfFormula`, `readOdbInventory`), live-view editors, and the `.odm` master-document/`.odb` database-table-export subsystems. This section will be replaced with real usage examples once those land — see the [Architecture](#architecture) section below for the intended shape, and this repository's own commit history/releases for current progress.
+
+## Getting started
+
+Requires Node.js `>=20` and pnpm `11.6.0` (pinned via `packageManager` in `package.json`).
+
+```sh
+pnpm install
+```
+
+Install as a dependency in another project:
+
+```sh
+pnpm add odf.js
+# or
+npm install odf.js
+```
+
+## Usage
+
+The lossless core — the only public surface stable enough to document with real examples right now:
+
+```ts
+import { decodePackage, encodePackage } from 'odf.js';
+
+// .odt / .ods / .odp bytes -> faithful JSON Package
+const pkg = decodePackage(new Uint8Array(await file.arrayBuffer()));
+
+// ...inspect pkg.parts...
+
+// Package -> bytes (content-identical, mimetype-first/stored, manifest untouched)
+const bytes = encodePackage(pkg);
+```
+
+Manifest and mimetype, ODF's own package-identity mechanism (no relationships, unlike OOXML):
+
+```ts
+import { readManifest, syncManifest, setDocumentMediaType, readMimetype } from 'odf.js';
+
+const manifest = readManifest(pkg); // { entries: [{ fullPath, mediaType }, ...] }
+setDocumentMediaType(pkg, 'application/vnd.oasis.opendocument.text'); // updates mimetype + manifest root entry atomically
+syncManifest(pkg); // rebuilds manifest.xml to exactly match pkg's current parts
+readMimetype(pkg); // 'application/vnd.oasis.opendocument.text'
+```
+
+## Architecture
+
+Layered from a lossless core outward, mirroring `ooxml.js`'s own structure:
+
+- **`src/model/`** — `Package`/`XmlNode`/`XmlElement` and friends: a duplicate-by-design copy of `ooxml.js`'s equivalent, kept structurally identical (see [Why no `ooxml.js` dependency](#why-no-ooxmljs-dependency) above).
+- **`src/xml/`** — `parse.ts`/`build.ts` (XML string ⇄ `XmlNode[]` forest via `fast-xml-parser`), `fragment.ts`/`entities.ts` (production element/text-node construction and entity encoding — `odf.js` writes `manifest.xml` itself, unlike `ooxml.js`'s read-only stance on OPC relationships, so this needs to be real writing code, not test-only scaffolding), `query.ts` (shared tree-query helpers).
+- **`src/zip.ts`** — takes *ordered* `[path, entry]` tuples, not a `Record`, specifically so ODF's mimetype-first/stored/uncompressed requirement doesn't depend on `Record`/`Object.keys` insertion order surviving a Zod round trip.
+- **`src/package-io/`** — `write.ts` hoists a `mimetype` part first (stored) and `META-INF/manifest.xml` second, if present, before everything else in existing order — the one deliberate behavioural difference from `ooxml.js`'s own writer, and never fabricates either part as a side effect.
+- **`src/manifest.ts`** — unlike `ooxml.js` (which only ever *reads* OPC relationships, leaving writing to `documents.js`), `odf.js` owns manifest read **and** write, since the manifest is ODF's one mandatory part and its correctness is exhaustive.
+- **`src/styles/`** — `properties.ts` (the property-bag shape + real ODF attribute parsing), `serialize.ts` (canonical, deterministic property-bag → XML attributes), `registry.ts` (`StyleRegistry`, ODF's mandatory style-interning layer, no OOXML equivalent), `span.ts` (character-range wrapping into a formattable `text:span`, correctly splitting `text:s`/`text:tab` elements that straddle a boundary).
+- **`src/typed/shared/`** — the ODF-specific typed primitives every future format reader builds on: `units.ts`, `a1.ts`, `color.ts`/`geometry.ts` (parsing into `document-content-model`'s own types, never redefining them), `style.ts` (a thin re-export — ODF's style-properties concern is fully covered by `styles/properties.ts` and the cascade below), `text.ts` (whitespace-run decoding), `cascade.ts` (the read-side style-resolution walk), `metadata.ts` (`meta.xml` reading).
+- **`src/typed/odt/`, `src/typed/ods.ts`, `src/typed/odp/`, `src/typed/odg/`, `src/typed/draw/`, `src/typed/formula/`** — per-format typed readers, in progress (see [Status](#status)).
+
+## Why no `ooxml.js` dependency
+
+See the top of this README — the short version: `ooxml.js`'s branding and signed SBOM make it the wrong dependency for an OASIS-standard package regardless of how much low-level code the two could share; `document-content-model` is the neutral package both actually depend on for the parts that are genuinely, permanently identical (the semantic content vocabulary), while the ZIP-of-XML primitive layer stays duplicated on purpose.
+
+## Conventions
+
+- **Zod-first schema/type/guard**, matching `ooxml.js`/`document-content-model`: every model type is inferred from its Zod schema, never hand-written.
+- **Recursive types use a hand-written structural guard, not `z.lazy`** — the same `z.lazy`-collapses-to-`unknown` issue `ooxml.js`'s `XmlNode` and `document-content-model`'s `ContentBlock` already work around.
+- **No type assertions anywhere** — `assertionStyle: 'never'`, `noInlineConfig: true`, matching both sibling packages exactly.
+- **Ground truth over memory for every ODF spec fact.** Namespace URIs, media types, style-property attribute names, and `meta.xml` element names are all verified against either the live OASIS ODF specification or real files produced by an installed LibreOffice, never assumed from pattern-matching an OOXML analogue or a remembered convention — several confirmed traps exist specifically because the "obvious" guess is wrong (see [Gotchas](#gotchas-and-quirks)).
+
+## Gotchas and quirks
+
+- **Several ODF namespace URIs are not what you'd guess from the prefix.** `draw:` is `...xmlns:drawing:1.0`, not `...draw:1.0`; `number:` is `...xmlns:datastyle:1.0`, not `...number:1.0`; `fo:`/`svg:`/`smil:` are OASIS's own `*-compatible:1.0` URIs, not the real W3C namespaces those prefixes suggest. See `src/ns.ts`'s inline comments for the full, verified table.
+- **`.odb`'s real media type is `application/vnd.oasis.opendocument.base`**, not `...database` — a common stale/wrong value found in some third-party documentation.
+- **ODF's `dc:creator` is not "the author."** It records whoever most recently *saved* the document (Dublin Core's own definition); the original author is `meta:initial-creator`. `typed/shared/metadata.ts` maps `LayoutMetadata.author` to `meta:initial-creator`, matching the byline role `ooxml.js`'s own `DocumentMetadata.author` plays for OOXML.
+- **`meta:keyword` appears once per keyword**, unlike OOXML's single comma-separated `cp:keywords` element.
+- **`table:number-columns-repeated`/`table:number-rows-repeated` must be cursor-advanced, never materialized.** A real spreadsheet has trailing cells/rows with repeat counts over a million; `typed/shared/a1.ts`'s cursor advances in O(1) without allocating that many objects — tested against a real repeat count taken from a genuine LibreOffice template.
+- **ODF cells carry no explicit cell-reference attribute at all** (unlike xlsx's `r="B7"`) — `typed/shared/a1.ts` computes A1-style references from a running column/row cursor as a reader walks cells in document order.
+
+## Release and publishing
+
+`.github/workflows/ci.yml` runs commitlint, lint, typecheck, the unit suite, and the smoke test on every push and pull request. On a push to `main` where those all pass, `release.config.ts` drives [semantic-release](https://semantic-release.gitbook.io/semantic-release): commit history since the last tag decides the version bump, `CHANGELOG.md` and `package.json` are committed back to `main`, a GitHub Release is cut, and the package publishes to [npmjs.org](https://www.npmjs.com/package/odf.js) — via npm's OIDC trusted publishing, so no `NPM_TOKEN` exists anywhere in the pipeline. A further job republishes the same build under the scoped `@exadev/odf.js` alias to GitHub Packages, and another signs an SPDX SBOM and build-provenance attestation against the exact release tarball.
+
+## Contributing
+
+Commits follow Conventional Commits (`feat:`, `fix:`, `test:`, `chore:`, …), enforced by commitlint via a husky `commit-msg` hook and a CI `commitlint` job. A husky `pre-commit` hook runs `lint-staged` (`eslint --fix` on staged `*.ts` files) and `pre-push` runs the test suite. There is a single `main` branch and no open pull request workflow established so far.
+
+## References
+
+- [ooxml.js](https://github.com/ExaDev/ooxml.js) — the sibling package doing the equivalent lossless-codec job for OOXML (docx/pptx/xlsx). Architecturally mirrored, deliberately not depended on — see [Why no `ooxml.js` dependency](#why-no-ooxmljs-dependency).
+- [document-content-model](https://github.com/ExaDev/document-content-model) — the canonical `ContentDocument`/`LayoutDocument` schema pivot both this package and `ooxml.js` depend on.
+- [documents.js](https://github.com/ExaDev/documents.js) — the intended downstream consumer, adding ODF ⇄ PDF conversion and a live-view ODF editor once this package's typed readers land.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -1243,6 +1243,17 @@ function childrenWithTag(element, tag) {
 	for (const child of element.children) if (child.type === "element" && child.tag === tag) out.push(child);
 	return out;
 }
+function* walk(nodes) {
+	for (const node of nodes) {
+		yield node;
+		if (node.type === "element") yield* walk(node.children);
+	}
+}
+function elementsWithTag(nodes, tag) {
+	const out = [];
+	for (const node of walk(nodes)) if (node.type === "element" && node.tag === tag) out.push(node);
+	return out;
+}
 function attrValue(element, name) {
 	return element.attributes.find((attribute) => attribute.name === name)?.value;
 }
@@ -1522,13 +1533,14 @@ function collectStyles(pkg) {
 		defaultByFamily
 	};
 }
-function resolveStyle(styleName, family, pkg) {
+function resolveStyleElementChain(styleName, family, pkg) {
 	const { byName, defaultByFamily } = collectStyles(pkg);
 	const diagnostics = [];
+	const elements = [];
 	const defaultElement = defaultByFamily.get(family);
-	let properties = defaultElement === void 0 ? {} : parseStyleElementProperties(defaultElement).properties;
+	if (defaultElement !== void 0) elements.push(defaultElement);
 	if (styleName === void 0) return {
-		properties,
+		elements,
 		diagnostics
 	};
 	const chain = [];
@@ -1556,7 +1568,16 @@ function resolveStyle(styleName, family, pkg) {
 		currentName = attrValue(element, "style:parent-style-name");
 	}
 	chain.reverse();
-	for (const element of chain) properties = {
+	elements.push(...chain);
+	return {
+		elements,
+		diagnostics
+	};
+}
+function resolveStyle(styleName, family, pkg) {
+	const { elements, diagnostics } = resolveStyleElementChain(styleName, family, pkg);
+	let properties = {};
+	for (const element of elements) properties = {
 		...properties,
 		...parseStyleElementProperties(element).properties
 	};
@@ -1565,6 +1586,10 @@ function resolveStyle(styleName, family, pkg) {
 		diagnostics
 	};
 }
+function findStyleElement(styleName, family, pkg) {
+	const { byName } = collectStyles(pkg);
+	return byName.get(nameKey(family, styleName));
+}
 //#endregion
 //#region src/typed/shared/metadata.ts
 const META_PART = "meta.xml";
@@ -1603,6 +1628,376 @@ function readOdfMetadata(pkg) {
 	return metadata;
 }
 //#endregion
+//#region src/typed/shared/paragraph.ts
+function collectRuns(nodes, baseProperties, pkg, out) {
+	for (const node of nodes) {
+		if (node.type === "text") {
+			if (node.value.length > 0) out.push(runFromText(decodeXmlText(node.value), baseProperties));
+			continue;
+		}
+		if (node.type !== "element") continue;
+		if (node.tag === "text:s") out.push(runFromText(" ".repeat(getOdfSpaceCount(node)), baseProperties));
+		else if (node.tag === "text:tab") out.push(runFromText("	", baseProperties));
+		else if (node.tag === "text:line-break") out.push(runFromText("\n", baseProperties));
+		else if (node.tag === "text:span") {
+			const styleName = attrValue(node, "text:style-name");
+			const spanProperties = {
+				...baseProperties,
+				...resolveStyle(styleName, "text", pkg).properties
+			};
+			collectRuns(node.children, spanProperties, pkg, out);
+		}
+	}
+}
+function runFromText(text, properties) {
+	return {
+		text,
+		bold: properties.bold,
+		italic: properties.italic,
+		underline: properties.underline,
+		strike: properties.strike,
+		fontFamily: properties.fontFamily,
+		sizePt: properties.sizePt,
+		color: properties.color
+	};
+}
+function readOdfParagraph(pElement, pkg) {
+	const styleName = attrValue(pElement, "text:style-name");
+	const paragraphProperties = resolveStyle(styleName, "paragraph", pkg).properties;
+	const runs = [];
+	collectRuns(pElement.children, paragraphProperties, pkg, runs);
+	return {
+		kind: "paragraph",
+		runs,
+		styleId: styleName,
+		alignment: paragraphProperties.alignment,
+		spacingBeforePt: paragraphProperties.spacingBeforePt,
+		spacingAfterPt: paragraphProperties.spacingAfterPt,
+		lineSpacing: paragraphProperties.lineSpacing,
+		indentLeftPt: paragraphProperties.indentLeftPt,
+		indentFirstLinePt: paragraphProperties.indentFirstLinePt
+	};
+}
+//#endregion
+//#region src/typed/shared/table.ts
+function readRepeatCount(element, attrName) {
+	const raw = attrValue(element, attrName);
+	if (raw === void 0) return 1;
+	const parsed = Number.parseInt(raw, 10);
+	return Number.isInteger(parsed) && parsed > 0 ? parsed : 1;
+}
+function resolveColumnWidthPt(columnElement, pkg) {
+	const styleName = attrValue(columnElement, "table:style-name");
+	const styleElement = styleName === void 0 ? void 0 : findStyleElement(styleName, "table-column", pkg);
+	const props = styleElement === void 0 ? void 0 : childrenWithTag(styleElement, "style:table-column-properties")[0];
+	const widthValue = props === void 0 ? void 0 : attrValue(props, "style:column-width");
+	return widthValue === void 0 ? 0 : parseOdfLength(widthValue) ?? 0;
+}
+function resolveRowHeightPt(rowElement, pkg) {
+	const styleName = attrValue(rowElement, "table:style-name");
+	const styleElement = styleName === void 0 ? void 0 : findStyleElement(styleName, "table-row", pkg);
+	const props = styleElement === void 0 ? void 0 : childrenWithTag(styleElement, "style:table-row-properties")[0];
+	const heightValue = props === void 0 ? void 0 : attrValue(props, "style:row-height");
+	return heightValue === void 0 ? void 0 : parseOdfLength(heightValue);
+}
+function readTableCellBackground(cellElement, pkg) {
+	const styleName = attrValue(cellElement, "table:style-name");
+	const styleElement = styleName === void 0 ? void 0 : findStyleElement(styleName, "table-cell", pkg);
+	const props = styleElement === void 0 ? void 0 : childrenWithTag(styleElement, "style:table-cell-properties")[0];
+	const value = props === void 0 ? void 0 : attrValue(props, "fo:background-color");
+	return value === void 0 ? void 0 : parseOdfColor(value);
+}
+function readTableCell(cellElement, pkg) {
+	const blocks = childrenWithTag(cellElement, "text:p").map((p) => readOdfParagraph(p, pkg));
+	const colSpanRaw = attrValue(cellElement, "table:number-columns-spanned");
+	const rowSpanRaw = attrValue(cellElement, "table:number-rows-spanned");
+	return {
+		blocks,
+		colSpan: colSpanRaw === void 0 ? void 0 : Number.parseInt(colSpanRaw, 10),
+		rowSpan: rowSpanRaw === void 0 ? void 0 : Number.parseInt(rowSpanRaw, 10),
+		background: readTableCellBackground(cellElement, pkg)
+	};
+}
+function readTableRow(rowElement, pkg) {
+	const cells = [];
+	for (const child of rowElement.children) {
+		if (child.type !== "element") continue;
+		if (child.tag === "table:covered-table-cell") {
+			const repeat = readRepeatCount(child, "table:number-columns-repeated");
+			for (let i = 0; i < repeat; i++) cells.push({ blocks: [] });
+		} else if (child.tag === "table:table-cell") {
+			const cell = readTableCell(child, pkg);
+			const repeat = readRepeatCount(child, "table:number-columns-repeated");
+			for (let i = 0; i < repeat; i++) cells.push(cell);
+		}
+	}
+	return {
+		cells,
+		heightPt: resolveRowHeightPt(rowElement, pkg)
+	};
+}
+function readOdfTable(tableElement, pkg) {
+	const columnWidthsPt = [];
+	for (const column of childrenWithTag(tableElement, "table:table-column")) {
+		const widthPt = resolveColumnWidthPt(column, pkg);
+		const repeat = readRepeatCount(column, "table:number-columns-repeated");
+		for (let i = 0; i < repeat; i++) columnWidthsPt.push(widthPt);
+	}
+	const rows = [];
+	for (const rowElement of childrenWithTag(tableElement, "table:table-row")) {
+		const row = readTableRow(rowElement, pkg);
+		const repeat = readRepeatCount(rowElement, "table:number-rows-repeated");
+		for (let i = 0; i < repeat; i++) rows.push(row);
+	}
+	return {
+		kind: "table",
+		rows,
+		columnWidthsPt
+	};
+}
+//#endregion
+//#region src/typed/shared/transform.ts
+const FUNCTION_PATTERN = /([a-zA-Z]+)\s*\(\s*([^)]*?)\s*\)/g;
+function parseOdfTransform(value) {
+	const functions = [];
+	for (const match of value.matchAll(FUNCTION_PATTERN)) {
+		const name = match[1];
+		const argsRaw = match[2];
+		if (name === void 0 || argsRaw === void 0) continue;
+		const args = argsRaw.split(/\s+/).filter((arg) => arg.length > 0);
+		if (name === "rotate") {
+			const angleArg = args[0];
+			if (angleArg === void 0) continue;
+			const angleRad = Number(angleArg);
+			if (!Number.isFinite(angleRad)) continue;
+			functions.push({
+				kind: "rotate",
+				angleRad
+			});
+		} else if (name === "translate") {
+			const xArg = args[0];
+			if (xArg === void 0) continue;
+			const yArg = args[1];
+			const xPt = parseOdfLength(xArg);
+			const yPt = yArg === void 0 ? 0 : parseOdfLength(yArg);
+			if (xPt === void 0 || yPt === void 0) continue;
+			functions.push({
+				kind: "translate",
+				xPt,
+				yPt
+			});
+		}
+	}
+	return functions;
+}
+function applyOdfTransform(functions, point) {
+	let current = point;
+	for (const fn of functions) if (fn.kind === "rotate") {
+		const cos = Math.cos(fn.angleRad);
+		const sin = Math.sin(fn.angleRad);
+		current = {
+			xPt: current.xPt * cos + current.yPt * sin,
+			yPt: current.yPt * cos - current.xPt * sin
+		};
+	} else current = {
+		xPt: current.xPt + fn.xPt,
+		yPt: current.yPt + fn.yPt
+	};
+	return current;
+}
+function netRotationDeg(functions) {
+	let totalRad = 0;
+	for (const fn of functions) if (fn.kind === "rotate") totalRad += fn.angleRad;
+	return -totalRad * 180 / Math.PI;
+}
+function resolveOdfShapeGeometry(element) {
+	const transformValue = attrValue(element, "draw:transform");
+	if (transformValue === void 0) {
+		const box = parseBox(element);
+		return box === void 0 ? void 0 : {
+			frame: box,
+			rotationDeg: void 0
+		};
+	}
+	const widthValue = attrValue(element, "svg:width");
+	const heightValue = attrValue(element, "svg:height");
+	if (widthValue === void 0 || heightValue === void 0) return;
+	const widthPt = parseOdfLength(widthValue);
+	const heightPt = parseOdfLength(heightValue);
+	if (widthPt === void 0 || heightPt === void 0) return;
+	const functions = parseOdfTransform(transformValue);
+	const center = applyOdfTransform(functions, {
+		xPt: widthPt / 2,
+		yPt: heightPt / 2
+	});
+	const rotationDeg = netRotationDeg(functions);
+	return {
+		frame: {
+			xPt: center.xPt - widthPt / 2,
+			yPt: center.yPt - heightPt / 2,
+			widthPt,
+			heightPt
+		},
+		rotationDeg: rotationDeg === 0 ? void 0 : rotationDeg
+	};
+}
+function composeOdfGroupTransform(groupFunctions, child) {
+	if (groupFunctions.length === 0) return child;
+	const newCenter = applyOdfTransform(groupFunctions, {
+		xPt: child.frame.xPt + child.frame.widthPt / 2,
+		yPt: child.frame.yPt + child.frame.heightPt / 2
+	});
+	const newRotationDeg = (child.rotationDeg ?? 0) + netRotationDeg(groupFunctions);
+	return {
+		frame: {
+			xPt: newCenter.xPt - child.frame.widthPt / 2,
+			yPt: newCenter.yPt - child.frame.heightPt / 2,
+			widthPt: child.frame.widthPt,
+			heightPt: child.frame.heightPt
+		},
+		rotationDeg: newRotationDeg === 0 ? void 0 : newRotationDeg
+	};
+}
+//#endregion
+//#region src/typed/draw/shapes.ts
+const ZERO_INSETS = {
+	insetLeftPt: 0,
+	insetTopPt: 0,
+	insetRightPt: 0,
+	insetBottomPt: 0
+};
+function readPaddingPt(props, attrName) {
+	const value = attrValue(props, attrName);
+	return value === void 0 ? void 0 : parseOdfLength(value);
+}
+function readFrameInsets(frame, pkg) {
+	const { elements } = resolveStyleElementChain(attrValue(frame, "draw:style-name"), "graphic", pkg);
+	let insets = ZERO_INSETS;
+	for (const element of elements) {
+		const props = childrenWithTag(element, "style:graphic-properties")[0];
+		if (props === void 0) continue;
+		insets = {
+			insetLeftPt: readPaddingPt(props, "fo:padding-left") ?? insets.insetLeftPt,
+			insetTopPt: readPaddingPt(props, "fo:padding-top") ?? insets.insetTopPt,
+			insetRightPt: readPaddingPt(props, "fo:padding-right") ?? insets.insetRightPt,
+			insetBottomPt: readPaddingPt(props, "fo:padding-bottom") ?? insets.insetBottomPt
+		};
+	}
+	return insets;
+}
+function readDrawImageBlock(image, frameBox, pkg) {
+	const href = attrValue(image, "xlink:href");
+	const part = href === void 0 ? void 0 : pkg.parts[href];
+	if (part?.kind !== "binary") return;
+	const format = sniffImageFormat(base64ToBytes(part.base64));
+	if (format === void 0) return;
+	return {
+		kind: "image",
+		format,
+		base64: part.base64,
+		widthPt: frameBox.widthPt,
+		heightPt: frameBox.heightPt
+	};
+}
+function readDrawFrameContent(frame, frameBox, pkg) {
+	const table = childrenWithTag(frame, "table:table")[0];
+	if (table !== void 0) return [readOdfTable(table, pkg)];
+	const textBox = childrenWithTag(frame, "draw:text-box")[0];
+	if (textBox !== void 0) return elementsWithTag(textBox.children, "text:p").map((p) => readOdfParagraph(p, pkg));
+	const image = childrenWithTag(frame, "draw:image")[0];
+	if (image !== void 0) {
+		const block = readDrawImageBlock(image, frameBox, pkg);
+		return block === void 0 ? [] : [block];
+	}
+	return [];
+}
+function readDrawFrame(frame, groupFunctions, pkg) {
+	const ownGeometry = resolveOdfShapeGeometry(frame);
+	if (ownGeometry === void 0) return;
+	const geometry = composeOdfGroupTransform(groupFunctions, ownGeometry);
+	return {
+		name: attrValue(frame, "draw:name"),
+		frame: geometry.frame,
+		rotationDeg: geometry.rotationDeg,
+		...readFrameInsets(frame, pkg),
+		blocks: readDrawFrameContent(frame, geometry.frame, pkg)
+	};
+}
+function readOwnTransformFunctions(element) {
+	const value = attrValue(element, "draw:transform");
+	return value === void 0 ? [] : parseOdfTransform(value);
+}
+function walkDrawShapes(children, groupFunctions, pkg, out) {
+	for (const node of children) {
+		if (node.type !== "element") continue;
+		if (node.tag === "draw:frame") {
+			const shape = readDrawFrame(node, groupFunctions, pkg);
+			if (shape !== void 0) out.push(shape);
+		} else if (node.tag === "draw:g") {
+			const ownFunctions = readOwnTransformFunctions(node);
+			const nested = ownFunctions.length === 0 ? groupFunctions : [...ownFunctions, ...groupFunctions];
+			walkDrawShapes(node.children, nested, pkg, out);
+		}
+	}
+}
+//#endregion
+//#region src/typed/odp/read.ts
+const CONTENT_PART = "content.xml";
+const STYLES_PART = "styles.xml";
+const AUTOMATIC_STYLE_PARTS = [CONTENT_PART, STYLES_PART];
+function findMasterPageElement(pkg, masterPageName) {
+	if (masterPageName === void 0) return;
+	const stylesPart = pkg.parts[STYLES_PART];
+	if (stylesPart?.kind !== "xml") return;
+	const root = rootElement(stylesPart.nodes);
+	const masterStyles = root === void 0 ? void 0 : findChildElement(root.children, "office:master-styles");
+	if (masterStyles === void 0) return;
+	return childrenWithTag(masterStyles, "style:master-page").find((element) => attrValue(element, "style:name") === masterPageName);
+}
+function findPageLayoutElement(pkg, pageLayoutName) {
+	if (pageLayoutName === void 0) return;
+	for (const partPath of AUTOMATIC_STYLE_PARTS) {
+		const part = pkg.parts[partPath];
+		if (part?.kind !== "xml") continue;
+		const root = rootElement(part.nodes);
+		const automaticStyles = root === void 0 ? void 0 : findChildElement(root.children, "office:automatic-styles");
+		if (automaticStyles === void 0) continue;
+		const found = childrenWithTag(automaticStyles, "style:page-layout").find((element) => attrValue(element, "style:name") === pageLayoutName);
+		if (found !== void 0) return found;
+	}
+}
+function readSlideSize(page, pkg) {
+	const masterPage = findMasterPageElement(pkg, attrValue(page, "draw:master-page-name"));
+	const pageLayout = findPageLayoutElement(pkg, masterPage === void 0 ? void 0 : attrValue(masterPage, "style:page-layout-name"));
+	const properties = pageLayout === void 0 ? void 0 : childrenWithTag(pageLayout, "style:page-layout-properties")[0];
+	return (properties === void 0 ? void 0 : parsePageSize(properties)) ?? document_content_model.SLIDE_SIZE_WIDESCREEN;
+}
+function readSlideNotes(page) {
+	const notes = childrenWithTag(page, "presentation:notes")[0];
+	if (notes === void 0) return "";
+	return elementsWithTag(notes.children, "text:p").map(decodeOdfText).join("\n");
+}
+function readSlide(page, pkg) {
+	const shapes = [];
+	walkDrawShapes(page.children, [], pkg, shapes);
+	return {
+		size: readSlideSize(page, pkg),
+		shapes,
+		notes: readSlideNotes(page)
+	};
+}
+function readOdp(pkg) {
+	const contentPart = pkg.parts[CONTENT_PART];
+	const root = contentPart?.kind === "xml" ? rootElement(contentPart.nodes) : void 0;
+	const body = root === void 0 ? void 0 : findChildElement(root.children, "office:body");
+	const presentation = body === void 0 ? void 0 : findChildElement(body.children, "office:presentation");
+	const pages = presentation === void 0 ? [] : childrenWithTag(presentation, "draw:page");
+	return {
+		metadata: readOdfMetadata(pkg),
+		slides: pages.map((page) => readSlide(page, pkg))
+	};
+}
+//#endregion
 Object.defineProperty(exports, "AlignmentSchema", {
 	enumerable: true,
 	get: function() {
@@ -1633,6 +2028,7 @@ exports.XmlNodeSchema = XmlNodeSchema;
 exports.XmlPartSchema = XmlPartSchema;
 exports.XmlPiSchema = XmlPiSchema;
 exports.XmlTextSchema = XmlTextSchema;
+exports.applyOdfTransform = applyOdfTransform;
 exports.attrValue = attrValue;
 exports.base64ToBytes = base64ToBytes;
 exports.buildManifest = buildManifest;
@@ -1643,14 +2039,17 @@ exports.canonicalPropertiesString = canonicalPropertiesString;
 exports.cellReference = cellReference;
 exports.childrenWithTag = childrenWithTag;
 exports.columnIndexToLetters = columnIndexToLetters;
+exports.composeOdfGroupTransform = composeOdfGroupTransform;
 exports.decodeOdfText = decodeOdfText;
 exports.decodePackage = decodePackage;
 exports.decodeXmlText = decodeXmlText;
 exports.el = el;
+exports.elementsWithTag = elementsWithTag;
 exports.encodePackage = encodePackage;
 exports.encodeXmlText = encodeXmlText;
 exports.ensureSpan = ensureSpan;
 exports.findChildElement = findChildElement;
+exports.findStyleElement = findStyleElement;
 exports.formatOdfColor = formatOdfColor;
 exports.formatOdfLength = formatOdfLength;
 exports.formatPercentageMultiplier = formatPercentageMultiplier;
@@ -1660,6 +2059,7 @@ exports.isStyleFamily = isStyleFamily;
 exports.isXmlNode = isXmlNode;
 exports.measureOdfNodeLength = measureOdfNodeLength;
 exports.mediaTypeForExtension = mediaTypeForExtension;
+exports.netRotationDeg = netRotationDeg;
 exports.packageCodec = packageCodec;
 exports.paragraphPropertiesToAttributes = paragraphPropertiesToAttributes;
 exports.parseBox = parseBox;
@@ -1667,16 +2067,23 @@ exports.parseLength = parseLength;
 exports.parseMargins = parseMargins;
 exports.parseOdfColor = parseOdfColor;
 exports.parseOdfLength = parseOdfLength;
+exports.parseOdfTransform = parseOdfTransform;
 exports.parsePackage = parsePackage;
 exports.parsePageSize = parsePageSize;
 exports.parseParagraphProperties = parseParagraphProperties;
 exports.parseStyleElementProperties = parseStyleElementProperties;
 exports.parseTextProperties = parseTextProperties;
 exports.parseXml = parseXml;
+exports.readDrawFrame = readDrawFrame;
 exports.readManifest = readManifest;
 exports.readMimetype = readMimetype;
 exports.readOdfMetadata = readOdfMetadata;
+exports.readOdfParagraph = readOdfParagraph;
+exports.readOdfTable = readOdfTable;
+exports.readOdp = readOdp;
+exports.resolveOdfShapeGeometry = resolveOdfShapeGeometry;
 exports.resolveStyle = resolveStyle;
+exports.resolveStyleElementChain = resolveStyleElementChain;
 exports.rootElement = rootElement;
 exports.serializePackage = serializePackage;
 exports.setDocumentMediaType = setDocumentMediaType;
@@ -1687,6 +2094,7 @@ exports.textPropertiesToAttributes = textPropertiesToAttributes;
 exports.txt = txt;
 exports.unzipPackage = unzipPackage;
 exports.validateManifest = validateManifest;
+exports.walkDrawShapes = walkDrawShapes;
 exports.writeManifest = writeManifest;
 exports.writeMimetype = writeMimetype;
 exports.xmlCodec = xmlCodec;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { Alignment, AlignmentSchema, Box, Color, LayoutMetadata, Margins, PageSize } from "document-content-model";
+import { Alignment, AlignmentSchema, Box, Color, ContentParagraph, ContentShape, ContentSlide, ContentTable, LayoutMetadata, Margins, PageSize } from "document-content-model";
 //#region src/model/node.d.ts
 declare const AttributeSchema: z.ZodObject<{
   name: z.ZodString;
@@ -480,6 +480,7 @@ declare function ensureSpan(paragraph: XmlElement, start: number, end: number, s
 declare function rootElement(nodes: readonly XmlNode[]): XmlElement | undefined;
 declare function findChildElement(nodes: readonly XmlNode[], tag: string): XmlElement | undefined;
 declare function childrenWithTag(element: XmlElement, tag: string): XmlElement[];
+declare function elementsWithTag(nodes: readonly XmlNode[], tag: string): XmlElement[];
 declare function attrValue(element: XmlElement, name: string): string | undefined;
 //#endregion
 //#region src/typed/shared/a1.d.ts
@@ -518,10 +519,56 @@ interface StyleCascadeResult {
   properties: StyleProperties;
   diagnostics: CascadeDiagnostic[];
 }
+interface StyleElementChainResult {
+  elements: XmlElement[];
+  diagnostics: CascadeDiagnostic[];
+}
+declare function resolveStyleElementChain(styleName: string | undefined, family: StyleFamily, pkg: Package): StyleElementChainResult;
 declare function resolveStyle(styleName: string | undefined, family: StyleFamily, pkg: Package): StyleCascadeResult;
+declare function findStyleElement(styleName: string, family: StyleFamily, pkg: Package): XmlElement | undefined;
 //#endregion
 //#region src/typed/shared/metadata.d.ts
 declare const META_PART = "meta.xml";
 declare function readOdfMetadata(pkg: Package): LayoutMetadata;
 //#endregion
-export { type Alignment, AlignmentSchema, type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type BuildManifestOptions, type CascadeDiagnostic, type ImageFormat, type InternRequest, type LengthUnit, MANIFEST_PART, META_PART, MIMETYPE_PART, type Manifest, type ManifestEntry, ManifestEntrySchema, type ManifestProblem, ManifestProblemSchema, ManifestSchema, ODF_MEDIA_TYPES, ODF_NAMESPACES, type OdfExtension, type OdfNamespacePrefix, type OtherPartRef, type Package, PackageSchema, type ParsedProperties, type Part, PartSchema, STYLE_FAMILIES, type StyleCascadeResult, type StyleFamily, type StyleProperties, StylePropertiesSchema, StyleRegistry, type StyleRegistryOptions, TableCursor, type XmlCdata, XmlCdataSchema, type XmlComment, XmlCommentSchema, type XmlDeclaration, XmlDeclarationSchema, type XmlElement, XmlElementSchema, type XmlNode, XmlNodeSchema, type XmlPart, XmlPartSchema, type XmlPi, XmlPiSchema, type XmlText, XmlTextSchema, type ZipEntry, attrValue, base64ToBytes, buildManifest, buildStylePropertyElements, buildXml, bytesToBase64, canonicalPropertiesString, cellReference, childrenWithTag, columnIndexToLetters, decodeOdfText, decodePackage, decodeXmlText, el, encodePackage, encodeXmlText, ensureSpan, findChildElement, formatOdfColor, formatOdfLength, formatPercentageMultiplier, formatPt, getOdfSpaceCount, isStyleFamily, isXmlNode, measureOdfNodeLength, mediaTypeForExtension, packageCodec, paragraphPropertiesToAttributes, parseBox, parseLength, parseMargins, parseOdfColor, parseOdfLength, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, readManifest, readMimetype, readOdfMetadata, resolveStyle, rootElement, serializePackage, setDocumentMediaType, sniffImageFormat, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };
+//#region src/typed/shared/paragraph.d.ts
+declare function readOdfParagraph(pElement: XmlElement, pkg: Package): ContentParagraph;
+//#endregion
+//#region src/typed/shared/table.d.ts
+declare function readOdfTable(tableElement: XmlElement, pkg: Package): ContentTable;
+//#endregion
+//#region src/typed/shared/transform.d.ts
+type OdfTransformFunction = {
+  readonly kind: 'rotate';
+  readonly angleRad: number;
+} | {
+  readonly kind: 'translate';
+  readonly xPt: number;
+  readonly yPt: number;
+};
+interface OdfPoint {
+  readonly xPt: number;
+  readonly yPt: number;
+}
+declare function parseOdfTransform(value: string): OdfTransformFunction[];
+declare function applyOdfTransform(functions: readonly OdfTransformFunction[], point: OdfPoint): OdfPoint;
+declare function netRotationDeg(functions: readonly OdfTransformFunction[]): number;
+interface OdfShapeGeometry {
+  readonly frame: Box;
+  readonly rotationDeg: number | undefined;
+}
+declare function resolveOdfShapeGeometry(element: XmlElement): OdfShapeGeometry | undefined;
+declare function composeOdfGroupTransform(groupFunctions: readonly OdfTransformFunction[], child: OdfShapeGeometry): OdfShapeGeometry;
+//#endregion
+//#region src/typed/draw/shapes.d.ts
+declare function readDrawFrame(frame: XmlElement, groupFunctions: readonly OdfTransformFunction[], pkg: Package): ContentShape | undefined;
+declare function walkDrawShapes(children: readonly XmlNode[], groupFunctions: readonly OdfTransformFunction[], pkg: Package, out: ContentShape[]): void;
+//#endregion
+//#region src/typed/odp/read.d.ts
+interface OdpDocument {
+  metadata: LayoutMetadata;
+  slides: ContentSlide[];
+}
+declare function readOdp(pkg: Package): OdpDocument;
+//#endregion
+export { type Alignment, AlignmentSchema, type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type BuildManifestOptions, type CascadeDiagnostic, type ImageFormat, type InternRequest, type LengthUnit, MANIFEST_PART, META_PART, MIMETYPE_PART, type Manifest, type ManifestEntry, ManifestEntrySchema, type ManifestProblem, ManifestProblemSchema, ManifestSchema, ODF_MEDIA_TYPES, ODF_NAMESPACES, type OdfExtension, type OdfNamespacePrefix, type OdfPoint, type OdfShapeGeometry, type OdfTransformFunction, type OdpDocument, type OtherPartRef, type Package, PackageSchema, type ParsedProperties, type Part, PartSchema, STYLE_FAMILIES, type StyleCascadeResult, type StyleElementChainResult, type StyleFamily, type StyleProperties, StylePropertiesSchema, StyleRegistry, type StyleRegistryOptions, TableCursor, type XmlCdata, XmlCdataSchema, type XmlComment, XmlCommentSchema, type XmlDeclaration, XmlDeclarationSchema, type XmlElement, XmlElementSchema, type XmlNode, XmlNodeSchema, type XmlPart, XmlPartSchema, type XmlPi, XmlPiSchema, type XmlText, XmlTextSchema, type ZipEntry, applyOdfTransform, attrValue, base64ToBytes, buildManifest, buildStylePropertyElements, buildXml, bytesToBase64, canonicalPropertiesString, cellReference, childrenWithTag, columnIndexToLetters, composeOdfGroupTransform, decodeOdfText, decodePackage, decodeXmlText, el, elementsWithTag, encodePackage, encodeXmlText, ensureSpan, findChildElement, findStyleElement, formatOdfColor, formatOdfLength, formatPercentageMultiplier, formatPt, getOdfSpaceCount, isStyleFamily, isXmlNode, measureOdfNodeLength, mediaTypeForExtension, netRotationDeg, packageCodec, paragraphPropertiesToAttributes, parseBox, parseLength, parseMargins, parseOdfColor, parseOdfLength, parseOdfTransform, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, readDrawFrame, readManifest, readMimetype, readOdfMetadata, readOdfParagraph, readOdfTable, readOdp, resolveOdfShapeGeometry, resolveStyle, resolveStyleElementChain, rootElement, serializePackage, setDocumentMediaType, sniffImageFormat, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, walkDrawShapes, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { Alignment, AlignmentSchema, Box, Color, LayoutMetadata, Margins, PageSize } from "document-content-model";
+import { Alignment, AlignmentSchema, Box, Color, ContentParagraph, ContentShape, ContentSlide, ContentTable, LayoutMetadata, Margins, PageSize } from "document-content-model";
 //#region src/model/node.d.ts
 declare const AttributeSchema: z.ZodObject<{
   name: z.ZodString;
@@ -480,6 +480,7 @@ declare function ensureSpan(paragraph: XmlElement, start: number, end: number, s
 declare function rootElement(nodes: readonly XmlNode[]): XmlElement | undefined;
 declare function findChildElement(nodes: readonly XmlNode[], tag: string): XmlElement | undefined;
 declare function childrenWithTag(element: XmlElement, tag: string): XmlElement[];
+declare function elementsWithTag(nodes: readonly XmlNode[], tag: string): XmlElement[];
 declare function attrValue(element: XmlElement, name: string): string | undefined;
 //#endregion
 //#region src/typed/shared/a1.d.ts
@@ -518,10 +519,56 @@ interface StyleCascadeResult {
   properties: StyleProperties;
   diagnostics: CascadeDiagnostic[];
 }
+interface StyleElementChainResult {
+  elements: XmlElement[];
+  diagnostics: CascadeDiagnostic[];
+}
+declare function resolveStyleElementChain(styleName: string | undefined, family: StyleFamily, pkg: Package): StyleElementChainResult;
 declare function resolveStyle(styleName: string | undefined, family: StyleFamily, pkg: Package): StyleCascadeResult;
+declare function findStyleElement(styleName: string, family: StyleFamily, pkg: Package): XmlElement | undefined;
 //#endregion
 //#region src/typed/shared/metadata.d.ts
 declare const META_PART = "meta.xml";
 declare function readOdfMetadata(pkg: Package): LayoutMetadata;
 //#endregion
-export { type Alignment, AlignmentSchema, type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type BuildManifestOptions, type CascadeDiagnostic, type ImageFormat, type InternRequest, type LengthUnit, MANIFEST_PART, META_PART, MIMETYPE_PART, type Manifest, type ManifestEntry, ManifestEntrySchema, type ManifestProblem, ManifestProblemSchema, ManifestSchema, ODF_MEDIA_TYPES, ODF_NAMESPACES, type OdfExtension, type OdfNamespacePrefix, type OtherPartRef, type Package, PackageSchema, type ParsedProperties, type Part, PartSchema, STYLE_FAMILIES, type StyleCascadeResult, type StyleFamily, type StyleProperties, StylePropertiesSchema, StyleRegistry, type StyleRegistryOptions, TableCursor, type XmlCdata, XmlCdataSchema, type XmlComment, XmlCommentSchema, type XmlDeclaration, XmlDeclarationSchema, type XmlElement, XmlElementSchema, type XmlNode, XmlNodeSchema, type XmlPart, XmlPartSchema, type XmlPi, XmlPiSchema, type XmlText, XmlTextSchema, type ZipEntry, attrValue, base64ToBytes, buildManifest, buildStylePropertyElements, buildXml, bytesToBase64, canonicalPropertiesString, cellReference, childrenWithTag, columnIndexToLetters, decodeOdfText, decodePackage, decodeXmlText, el, encodePackage, encodeXmlText, ensureSpan, findChildElement, formatOdfColor, formatOdfLength, formatPercentageMultiplier, formatPt, getOdfSpaceCount, isStyleFamily, isXmlNode, measureOdfNodeLength, mediaTypeForExtension, packageCodec, paragraphPropertiesToAttributes, parseBox, parseLength, parseMargins, parseOdfColor, parseOdfLength, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, readManifest, readMimetype, readOdfMetadata, resolveStyle, rootElement, serializePackage, setDocumentMediaType, sniffImageFormat, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };
+//#region src/typed/shared/paragraph.d.ts
+declare function readOdfParagraph(pElement: XmlElement, pkg: Package): ContentParagraph;
+//#endregion
+//#region src/typed/shared/table.d.ts
+declare function readOdfTable(tableElement: XmlElement, pkg: Package): ContentTable;
+//#endregion
+//#region src/typed/shared/transform.d.ts
+type OdfTransformFunction = {
+  readonly kind: 'rotate';
+  readonly angleRad: number;
+} | {
+  readonly kind: 'translate';
+  readonly xPt: number;
+  readonly yPt: number;
+};
+interface OdfPoint {
+  readonly xPt: number;
+  readonly yPt: number;
+}
+declare function parseOdfTransform(value: string): OdfTransformFunction[];
+declare function applyOdfTransform(functions: readonly OdfTransformFunction[], point: OdfPoint): OdfPoint;
+declare function netRotationDeg(functions: readonly OdfTransformFunction[]): number;
+interface OdfShapeGeometry {
+  readonly frame: Box;
+  readonly rotationDeg: number | undefined;
+}
+declare function resolveOdfShapeGeometry(element: XmlElement): OdfShapeGeometry | undefined;
+declare function composeOdfGroupTransform(groupFunctions: readonly OdfTransformFunction[], child: OdfShapeGeometry): OdfShapeGeometry;
+//#endregion
+//#region src/typed/draw/shapes.d.ts
+declare function readDrawFrame(frame: XmlElement, groupFunctions: readonly OdfTransformFunction[], pkg: Package): ContentShape | undefined;
+declare function walkDrawShapes(children: readonly XmlNode[], groupFunctions: readonly OdfTransformFunction[], pkg: Package, out: ContentShape[]): void;
+//#endregion
+//#region src/typed/odp/read.d.ts
+interface OdpDocument {
+  metadata: LayoutMetadata;
+  slides: ContentSlide[];
+}
+declare function readOdp(pkg: Package): OdpDocument;
+//#endregion
+export { type Alignment, AlignmentSchema, type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type BuildManifestOptions, type CascadeDiagnostic, type ImageFormat, type InternRequest, type LengthUnit, MANIFEST_PART, META_PART, MIMETYPE_PART, type Manifest, type ManifestEntry, ManifestEntrySchema, type ManifestProblem, ManifestProblemSchema, ManifestSchema, ODF_MEDIA_TYPES, ODF_NAMESPACES, type OdfExtension, type OdfNamespacePrefix, type OdfPoint, type OdfShapeGeometry, type OdfTransformFunction, type OdpDocument, type OtherPartRef, type Package, PackageSchema, type ParsedProperties, type Part, PartSchema, STYLE_FAMILIES, type StyleCascadeResult, type StyleElementChainResult, type StyleFamily, type StyleProperties, StylePropertiesSchema, StyleRegistry, type StyleRegistryOptions, TableCursor, type XmlCdata, XmlCdataSchema, type XmlComment, XmlCommentSchema, type XmlDeclaration, XmlDeclarationSchema, type XmlElement, XmlElementSchema, type XmlNode, XmlNodeSchema, type XmlPart, XmlPartSchema, type XmlPi, XmlPiSchema, type XmlText, XmlTextSchema, type ZipEntry, applyOdfTransform, attrValue, base64ToBytes, buildManifest, buildStylePropertyElements, buildXml, bytesToBase64, canonicalPropertiesString, cellReference, childrenWithTag, columnIndexToLetters, composeOdfGroupTransform, decodeOdfText, decodePackage, decodeXmlText, el, elementsWithTag, encodePackage, encodeXmlText, ensureSpan, findChildElement, findStyleElement, formatOdfColor, formatOdfLength, formatPercentageMultiplier, formatPt, getOdfSpaceCount, isStyleFamily, isXmlNode, measureOdfNodeLength, mediaTypeForExtension, netRotationDeg, packageCodec, paragraphPropertiesToAttributes, parseBox, parseLength, parseMargins, parseOdfColor, parseOdfLength, parseOdfTransform, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, readDrawFrame, readManifest, readMimetype, readOdfMetadata, readOdfParagraph, readOdfTable, readOdp, resolveOdfShapeGeometry, resolveStyle, resolveStyleElementChain, rootElement, serializePackage, setDocumentMediaType, sniffImageFormat, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, walkDrawShapes, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };

package/dist/index.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { XMLBuilder, XMLParser } from "fast-xml-parser";
 import { unzipSync, zipSync } from "fflate";
-import { AlignmentSchema, AlignmentSchema as AlignmentSchema$1, ColorSchema, colorToRgbHex, rgbHexToColor } from "document-content-model";
+import { AlignmentSchema, AlignmentSchema as AlignmentSchema$1, ColorSchema, SLIDE_SIZE_WIDESCREEN, colorToRgbHex, rgbHexToColor } from "document-content-model";
 //#region src/model/node.ts
 const AttributeSchema = z.object({
 	name: z.string(),
@@ -1242,6 +1242,17 @@ function childrenWithTag(element, tag) {
 	for (const child of element.children) if (child.type === "element" && child.tag === tag) out.push(child);
 	return out;
 }
+function* walk(nodes) {
+	for (const node of nodes) {
+		yield node;
+		if (node.type === "element") yield* walk(node.children);
+	}
+}
+function elementsWithTag(nodes, tag) {
+	const out = [];
+	for (const node of walk(nodes)) if (node.type === "element" && node.tag === tag) out.push(node);
+	return out;
+}
 function attrValue(element, name) {
 	return element.attributes.find((attribute) => attribute.name === name)?.value;
 }
@@ -1521,13 +1532,14 @@ function collectStyles(pkg) {
 		defaultByFamily
 	};
 }
-function resolveStyle(styleName, family, pkg) {
+function resolveStyleElementChain(styleName, family, pkg) {
 	const { byName, defaultByFamily } = collectStyles(pkg);
 	const diagnostics = [];
+	const elements = [];
 	const defaultElement = defaultByFamily.get(family);
-	let properties = defaultElement === void 0 ? {} : parseStyleElementProperties(defaultElement).properties;
+	if (defaultElement !== void 0) elements.push(defaultElement);
 	if (styleName === void 0) return {
-		properties,
+		elements,
 		diagnostics
 	};
 	const chain = [];
@@ -1555,7 +1567,16 @@ function resolveStyle(styleName, family, pkg) {
 		currentName = attrValue(element, "style:parent-style-name");
 	}
 	chain.reverse();
-	for (const element of chain) properties = {
+	elements.push(...chain);
+	return {
+		elements,
+		diagnostics
+	};
+}
+function resolveStyle(styleName, family, pkg) {
+	const { elements, diagnostics } = resolveStyleElementChain(styleName, family, pkg);
+	let properties = {};
+	for (const element of elements) properties = {
 		...properties,
 		...parseStyleElementProperties(element).properties
 	};
@@ -1564,6 +1585,10 @@ function resolveStyle(styleName, family, pkg) {
 		diagnostics
 	};
 }
+function findStyleElement(styleName, family, pkg) {
+	const { byName } = collectStyles(pkg);
+	return byName.get(nameKey(family, styleName));
+}
 //#endregion
 //#region src/typed/shared/metadata.ts
 const META_PART = "meta.xml";
@@ -1602,4 +1627,374 @@ function readOdfMetadata(pkg) {
 	return metadata;
 }
 //#endregion
-export { AlignmentSchema, AttributeSchema, BinaryPartSchema, MANIFEST_PART, META_PART, MIMETYPE_PART, ManifestEntrySchema, ManifestProblemSchema, ManifestSchema, ODF_MEDIA_TYPES, ODF_NAMESPACES, PackageSchema, PartSchema, STYLE_FAMILIES, StylePropertiesSchema, StyleRegistry, TableCursor, XmlCdataSchema, XmlCommentSchema, XmlDeclarationSchema, XmlElementSchema, XmlNodeSchema, XmlPartSchema, XmlPiSchema, XmlTextSchema, attrValue, base64ToBytes, buildManifest, buildStylePropertyElements, buildXml, bytesToBase64, canonicalPropertiesString, cellReference, childrenWithTag, columnIndexToLetters, decodeOdfText, decodePackage, decodeXmlText, el, encodePackage, encodeXmlText, ensureSpan, findChildElement, formatOdfColor, formatOdfLength, formatPercentageMultiplier, formatPt, getOdfSpaceCount, isStyleFamily, isXmlNode, measureOdfNodeLength, mediaTypeForExtension, packageCodec, paragraphPropertiesToAttributes, parseBox, parseLength, parseMargins, parseOdfColor, parseOdfLength, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, readManifest, readMimetype, readOdfMetadata, resolveStyle, rootElement, serializePackage, setDocumentMediaType, sniffImageFormat, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };
+//#region src/typed/shared/paragraph.ts
+function collectRuns(nodes, baseProperties, pkg, out) {
+	for (const node of nodes) {
+		if (node.type === "text") {
+			if (node.value.length > 0) out.push(runFromText(decodeXmlText(node.value), baseProperties));
+			continue;
+		}
+		if (node.type !== "element") continue;
+		if (node.tag === "text:s") out.push(runFromText(" ".repeat(getOdfSpaceCount(node)), baseProperties));
+		else if (node.tag === "text:tab") out.push(runFromText("	", baseProperties));
+		else if (node.tag === "text:line-break") out.push(runFromText("\n", baseProperties));
+		else if (node.tag === "text:span") {
+			const styleName = attrValue(node, "text:style-name");
+			const spanProperties = {
+				...baseProperties,
+				...resolveStyle(styleName, "text", pkg).properties
+			};
+			collectRuns(node.children, spanProperties, pkg, out);
+		}
+	}
+}
+function runFromText(text, properties) {
+	return {
+		text,
+		bold: properties.bold,
+		italic: properties.italic,
+		underline: properties.underline,
+		strike: properties.strike,
+		fontFamily: properties.fontFamily,
+		sizePt: properties.sizePt,
+		color: properties.color
+	};
+}
+function readOdfParagraph(pElement, pkg) {
+	const styleName = attrValue(pElement, "text:style-name");
+	const paragraphProperties = resolveStyle(styleName, "paragraph", pkg).properties;
+	const runs = [];
+	collectRuns(pElement.children, paragraphProperties, pkg, runs);
+	return {
+		kind: "paragraph",
+		runs,
+		styleId: styleName,
+		alignment: paragraphProperties.alignment,
+		spacingBeforePt: paragraphProperties.spacingBeforePt,
+		spacingAfterPt: paragraphProperties.spacingAfterPt,
+		lineSpacing: paragraphProperties.lineSpacing,
+		indentLeftPt: paragraphProperties.indentLeftPt,
+		indentFirstLinePt: paragraphProperties.indentFirstLinePt
+	};
+}
+//#endregion
+//#region src/typed/shared/table.ts
+function readRepeatCount(element, attrName) {
+	const raw = attrValue(element, attrName);
+	if (raw === void 0) return 1;
+	const parsed = Number.parseInt(raw, 10);
+	return Number.isInteger(parsed) && parsed > 0 ? parsed : 1;
+}
+function resolveColumnWidthPt(columnElement, pkg) {
+	const styleName = attrValue(columnElement, "table:style-name");
+	const styleElement = styleName === void 0 ? void 0 : findStyleElement(styleName, "table-column", pkg);
+	const props = styleElement === void 0 ? void 0 : childrenWithTag(styleElement, "style:table-column-properties")[0];
+	const widthValue = props === void 0 ? void 0 : attrValue(props, "style:column-width");
+	return widthValue === void 0 ? 0 : parseOdfLength(widthValue) ?? 0;
+}
+function resolveRowHeightPt(rowElement, pkg) {
+	const styleName = attrValue(rowElement, "table:style-name");
+	const styleElement = styleName === void 0 ? void 0 : findStyleElement(styleName, "table-row", pkg);
+	const props = styleElement === void 0 ? void 0 : childrenWithTag(styleElement, "style:table-row-properties")[0];
+	const heightValue = props === void 0 ? void 0 : attrValue(props, "style:row-height");
+	return heightValue === void 0 ? void 0 : parseOdfLength(heightValue);
+}
+function readTableCellBackground(cellElement, pkg) {
+	const styleName = attrValue(cellElement, "table:style-name");
+	const styleElement = styleName === void 0 ? void 0 : findStyleElement(styleName, "table-cell", pkg);
+	const props = styleElement === void 0 ? void 0 : childrenWithTag(styleElement, "style:table-cell-properties")[0];
+	const value = props === void 0 ? void 0 : attrValue(props, "fo:background-color");
+	return value === void 0 ? void 0 : parseOdfColor(value);
+}
+function readTableCell(cellElement, pkg) {
+	const blocks = childrenWithTag(cellElement, "text:p").map((p) => readOdfParagraph(p, pkg));
+	const colSpanRaw = attrValue(cellElement, "table:number-columns-spanned");
+	const rowSpanRaw = attrValue(cellElement, "table:number-rows-spanned");
+	return {
+		blocks,
+		colSpan: colSpanRaw === void 0 ? void 0 : Number.parseInt(colSpanRaw, 10),
+		rowSpan: rowSpanRaw === void 0 ? void 0 : Number.parseInt(rowSpanRaw, 10),
+		background: readTableCellBackground(cellElement, pkg)
+	};
+}
+function readTableRow(rowElement, pkg) {
+	const cells = [];
+	for (const child of rowElement.children) {
+		if (child.type !== "element") continue;
+		if (child.tag === "table:covered-table-cell") {
+			const repeat = readRepeatCount(child, "table:number-columns-repeated");
+			for (let i = 0; i < repeat; i++) cells.push({ blocks: [] });
+		} else if (child.tag === "table:table-cell") {
+			const cell = readTableCell(child, pkg);
+			const repeat = readRepeatCount(child, "table:number-columns-repeated");
+			for (let i = 0; i < repeat; i++) cells.push(cell);
+		}
+	}
+	return {
+		cells,
+		heightPt: resolveRowHeightPt(rowElement, pkg)
+	};
+}
+function readOdfTable(tableElement, pkg) {
+	const columnWidthsPt = [];
+	for (const column of childrenWithTag(tableElement, "table:table-column")) {
+		const widthPt = resolveColumnWidthPt(column, pkg);
+		const repeat = readRepeatCount(column, "table:number-columns-repeated");
+		for (let i = 0; i < repeat; i++) columnWidthsPt.push(widthPt);
+	}
+	const rows = [];
+	for (const rowElement of childrenWithTag(tableElement, "table:table-row")) {
+		const row = readTableRow(rowElement, pkg);
+		const repeat = readRepeatCount(rowElement, "table:number-rows-repeated");
+		for (let i = 0; i < repeat; i++) rows.push(row);
+	}
+	return {
+		kind: "table",
+		rows,
+		columnWidthsPt
+	};
+}
+//#endregion
+//#region src/typed/shared/transform.ts
+const FUNCTION_PATTERN = /([a-zA-Z]+)\s*\(\s*([^)]*?)\s*\)/g;
+function parseOdfTransform(value) {
+	const functions = [];
+	for (const match of value.matchAll(FUNCTION_PATTERN)) {
+		const name = match[1];
+		const argsRaw = match[2];
+		if (name === void 0 || argsRaw === void 0) continue;
+		const args = argsRaw.split(/\s+/).filter((arg) => arg.length > 0);
+		if (name === "rotate") {
+			const angleArg = args[0];
+			if (angleArg === void 0) continue;
+			const angleRad = Number(angleArg);
+			if (!Number.isFinite(angleRad)) continue;
+			functions.push({
+				kind: "rotate",
+				angleRad
+			});
+		} else if (name === "translate") {
+			const xArg = args[0];
+			if (xArg === void 0) continue;
+			const yArg = args[1];
+			const xPt = parseOdfLength(xArg);
+			const yPt = yArg === void 0 ? 0 : parseOdfLength(yArg);
+			if (xPt === void 0 || yPt === void 0) continue;
+			functions.push({
+				kind: "translate",
+				xPt,
+				yPt
+			});
+		}
+	}
+	return functions;
+}
+function applyOdfTransform(functions, point) {
+	let current = point;
+	for (const fn of functions) if (fn.kind === "rotate") {
+		const cos = Math.cos(fn.angleRad);
+		const sin = Math.sin(fn.angleRad);
+		current = {
+			xPt: current.xPt * cos + current.yPt * sin,
+			yPt: current.yPt * cos - current.xPt * sin
+		};
+	} else current = {
+		xPt: current.xPt + fn.xPt,
+		yPt: current.yPt + fn.yPt
+	};
+	return current;
+}
+function netRotationDeg(functions) {
+	let totalRad = 0;
+	for (const fn of functions) if (fn.kind === "rotate") totalRad += fn.angleRad;
+	return -totalRad * 180 / Math.PI;
+}
+function resolveOdfShapeGeometry(element) {
+	const transformValue = attrValue(element, "draw:transform");
+	if (transformValue === void 0) {
+		const box = parseBox(element);
+		return box === void 0 ? void 0 : {
+			frame: box,
+			rotationDeg: void 0
+		};
+	}
+	const widthValue = attrValue(element, "svg:width");
+	const heightValue = attrValue(element, "svg:height");
+	if (widthValue === void 0 || heightValue === void 0) return;
+	const widthPt = parseOdfLength(widthValue);
+	const heightPt = parseOdfLength(heightValue);
+	if (widthPt === void 0 || heightPt === void 0) return;
+	const functions = parseOdfTransform(transformValue);
+	const center = applyOdfTransform(functions, {
+		xPt: widthPt / 2,
+		yPt: heightPt / 2
+	});
+	const rotationDeg = netRotationDeg(functions);
+	return {
+		frame: {
+			xPt: center.xPt - widthPt / 2,
+			yPt: center.yPt - heightPt / 2,
+			widthPt,
+			heightPt
+		},
+		rotationDeg: rotationDeg === 0 ? void 0 : rotationDeg
+	};
+}
+function composeOdfGroupTransform(groupFunctions, child) {
+	if (groupFunctions.length === 0) return child;
+	const newCenter = applyOdfTransform(groupFunctions, {
+		xPt: child.frame.xPt + child.frame.widthPt / 2,
+		yPt: child.frame.yPt + child.frame.heightPt / 2
+	});
+	const newRotationDeg = (child.rotationDeg ?? 0) + netRotationDeg(groupFunctions);
+	return {
+		frame: {
+			xPt: newCenter.xPt - child.frame.widthPt / 2,
+			yPt: newCenter.yPt - child.frame.heightPt / 2,
+			widthPt: child.frame.widthPt,
+			heightPt: child.frame.heightPt
+		},
+		rotationDeg: newRotationDeg === 0 ? void 0 : newRotationDeg
+	};
+}
+//#endregion
+//#region src/typed/draw/shapes.ts
+const ZERO_INSETS = {
+	insetLeftPt: 0,
+	insetTopPt: 0,
+	insetRightPt: 0,
+	insetBottomPt: 0
+};
+function readPaddingPt(props, attrName) {
+	const value = attrValue(props, attrName);
+	return value === void 0 ? void 0 : parseOdfLength(value);
+}
+function readFrameInsets(frame, pkg) {
+	const { elements } = resolveStyleElementChain(attrValue(frame, "draw:style-name"), "graphic", pkg);
+	let insets = ZERO_INSETS;
+	for (const element of elements) {
+		const props = childrenWithTag(element, "style:graphic-properties")[0];
+		if (props === void 0) continue;
+		insets = {
+			insetLeftPt: readPaddingPt(props, "fo:padding-left") ?? insets.insetLeftPt,
+			insetTopPt: readPaddingPt(props, "fo:padding-top") ?? insets.insetTopPt,
+			insetRightPt: readPaddingPt(props, "fo:padding-right") ?? insets.insetRightPt,
+			insetBottomPt: readPaddingPt(props, "fo:padding-bottom") ?? insets.insetBottomPt
+		};
+	}
+	return insets;
+}
+function readDrawImageBlock(image, frameBox, pkg) {
+	const href = attrValue(image, "xlink:href");
+	const part = href === void 0 ? void 0 : pkg.parts[href];
+	if (part?.kind !== "binary") return;
+	const format = sniffImageFormat(base64ToBytes(part.base64));
+	if (format === void 0) return;
+	return {
+		kind: "image",
+		format,
+		base64: part.base64,
+		widthPt: frameBox.widthPt,
+		heightPt: frameBox.heightPt
+	};
+}
+function readDrawFrameContent(frame, frameBox, pkg) {
+	const table = childrenWithTag(frame, "table:table")[0];
+	if (table !== void 0) return [readOdfTable(table, pkg)];
+	const textBox = childrenWithTag(frame, "draw:text-box")[0];
+	if (textBox !== void 0) return elementsWithTag(textBox.children, "text:p").map((p) => readOdfParagraph(p, pkg));
+	const image = childrenWithTag(frame, "draw:image")[0];
+	if (image !== void 0) {
+		const block = readDrawImageBlock(image, frameBox, pkg);
+		return block === void 0 ? [] : [block];
+	}
+	return [];
+}
+function readDrawFrame(frame, groupFunctions, pkg) {
+	const ownGeometry = resolveOdfShapeGeometry(frame);
+	if (ownGeometry === void 0) return;
+	const geometry = composeOdfGroupTransform(groupFunctions, ownGeometry);
+	return {
+		name: attrValue(frame, "draw:name"),
+		frame: geometry.frame,
+		rotationDeg: geometry.rotationDeg,
+		...readFrameInsets(frame, pkg),
+		blocks: readDrawFrameContent(frame, geometry.frame, pkg)
+	};
+}
+function readOwnTransformFunctions(element) {
+	const value = attrValue(element, "draw:transform");
+	return value === void 0 ? [] : parseOdfTransform(value);
+}
+function walkDrawShapes(children, groupFunctions, pkg, out) {
+	for (const node of children) {
+		if (node.type !== "element") continue;
+		if (node.tag === "draw:frame") {
+			const shape = readDrawFrame(node, groupFunctions, pkg);
+			if (shape !== void 0) out.push(shape);
+		} else if (node.tag === "draw:g") {
+			const ownFunctions = readOwnTransformFunctions(node);
+			const nested = ownFunctions.length === 0 ? groupFunctions : [...ownFunctions, ...groupFunctions];
+			walkDrawShapes(node.children, nested, pkg, out);
+		}
+	}
+}
+//#endregion
+//#region src/typed/odp/read.ts
+const CONTENT_PART = "content.xml";
+const STYLES_PART = "styles.xml";
+const AUTOMATIC_STYLE_PARTS = [CONTENT_PART, STYLES_PART];
+function findMasterPageElement(pkg, masterPageName) {
+	if (masterPageName === void 0) return;
+	const stylesPart = pkg.parts[STYLES_PART];
+	if (stylesPart?.kind !== "xml") return;
+	const root = rootElement(stylesPart.nodes);
+	const masterStyles = root === void 0 ? void 0 : findChildElement(root.children, "office:master-styles");
+	if (masterStyles === void 0) return;
+	return childrenWithTag(masterStyles, "style:master-page").find((element) => attrValue(element, "style:name") === masterPageName);
+}
+function findPageLayoutElement(pkg, pageLayoutName) {
+	if (pageLayoutName === void 0) return;
+	for (const partPath of AUTOMATIC_STYLE_PARTS) {
+		const part = pkg.parts[partPath];
+		if (part?.kind !== "xml") continue;
+		const root = rootElement(part.nodes);
+		const automaticStyles = root === void 0 ? void 0 : findChildElement(root.children, "office:automatic-styles");
+		if (automaticStyles === void 0) continue;
+		const found = childrenWithTag(automaticStyles, "style:page-layout").find((element) => attrValue(element, "style:name") === pageLayoutName);
+		if (found !== void 0) return found;
+	}
+}
+function readSlideSize(page, pkg) {
+	const masterPage = findMasterPageElement(pkg, attrValue(page, "draw:master-page-name"));
+	const pageLayout = findPageLayoutElement(pkg, masterPage === void 0 ? void 0 : attrValue(masterPage, "style:page-layout-name"));
+	const properties = pageLayout === void 0 ? void 0 : childrenWithTag(pageLayout, "style:page-layout-properties")[0];
+	return (properties === void 0 ? void 0 : parsePageSize(properties)) ?? SLIDE_SIZE_WIDESCREEN;
+}
+function readSlideNotes(page) {
+	const notes = childrenWithTag(page, "presentation:notes")[0];
+	if (notes === void 0) return "";
+	return elementsWithTag(notes.children, "text:p").map(decodeOdfText).join("\n");
+}
+function readSlide(page, pkg) {
+	const shapes = [];
+	walkDrawShapes(page.children, [], pkg, shapes);
+	return {
+		size: readSlideSize(page, pkg),
+		shapes,
+		notes: readSlideNotes(page)
+	};
+}
+function readOdp(pkg) {
+	const contentPart = pkg.parts[CONTENT_PART];
+	const root = contentPart?.kind === "xml" ? rootElement(contentPart.nodes) : void 0;
+	const body = root === void 0 ? void 0 : findChildElement(root.children, "office:body");
+	const presentation = body === void 0 ? void 0 : findChildElement(body.children, "office:presentation");
+	const pages = presentation === void 0 ? [] : childrenWithTag(presentation, "draw:page");
+	return {
+		metadata: readOdfMetadata(pkg),
+		slides: pages.map((page) => readSlide(page, pkg))
+	};
+}
+//#endregion
+export { AlignmentSchema, AttributeSchema, BinaryPartSchema, MANIFEST_PART, META_PART, MIMETYPE_PART, ManifestEntrySchema, ManifestProblemSchema, ManifestSchema, ODF_MEDIA_TYPES, ODF_NAMESPACES, PackageSchema, PartSchema, STYLE_FAMILIES, StylePropertiesSchema, StyleRegistry, TableCursor, XmlCdataSchema, XmlCommentSchema, XmlDeclarationSchema, XmlElementSchema, XmlNodeSchema, XmlPartSchema, XmlPiSchema, XmlTextSchema, applyOdfTransform, attrValue, base64ToBytes, buildManifest, buildStylePropertyElements, buildXml, bytesToBase64, canonicalPropertiesString, cellReference, childrenWithTag, columnIndexToLetters, composeOdfGroupTransform, decodeOdfText, decodePackage, decodeXmlText, el, elementsWithTag, encodePackage, encodeXmlText, ensureSpan, findChildElement, findStyleElement, formatOdfColor, formatOdfLength, formatPercentageMultiplier, formatPt, getOdfSpaceCount, isStyleFamily, isXmlNode, measureOdfNodeLength, mediaTypeForExtension, netRotationDeg, packageCodec, paragraphPropertiesToAttributes, parseBox, parseLength, parseMargins, parseOdfColor, parseOdfLength, parseOdfTransform, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, readDrawFrame, readManifest, readMimetype, readOdfMetadata, readOdfParagraph, readOdfTable, readOdp, resolveOdfShapeGeometry, resolveStyle, resolveStyleElementChain, rootElement, serializePackage, setDocumentMediaType, sniffImageFormat, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, walkDrawShapes, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "odf.js",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Type-safe, lossless round-trip conversion between OpenDocument Format packages (odt, ods, odp) and JSON, hand-written and dependency-minimal, built on Zod 4 codecs.",
   "type": "module",
   "repository": {