odf.js 1.7.0 → 1.9.0

package/README.md

@@ -18,9 +18,11 @@ This package is under active development. What's built and shipped:
 - **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/master-page-size 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), the `draw:transform`/`draw:g` group-flattening geometry resolver, an `svg:d`/`draw:points` vector-path grammar parser, and `meta.xml` reading.
-- **Typed readers** — `readOdt` (wordprocessing), `readOdp` (presentation slides: `draw:frame`/`draw:g` text/image/table content), and `readOdg` (drawing pages: every vector primitive — `draw:rect`/`draw:ellipse`/`draw:circle`/`draw:line`/`draw:path`/`draw:polygon`/`draw:polyline`, plus a recognised `draw:custom-shape` preset subset — in real `draw:z-index`-aware paint order) each resolve a `Package` into `document-content-model`'s own `ContentSection`/`ContentSlide`/`ContentDrawPage` shapes.
+- **Typed readers** — `readOdt` (wordprocessing), `readOdp` (presentation slides: `draw:frame`/`draw:g` text/image/table content), `readOdg` (drawing pages: every vector primitive — `draw:rect`/`draw:ellipse`/`draw:circle`/`draw:line`/`draw:path`/`draw:polygon`/`draw:polyline`, plus a recognised `draw:custom-shape` preset subset — in real `draw:z-index`-aware paint order), and `readOds` (spreadsheets: geometry- and print-settings-rich, every `office:value-type` variant with its own OpenFormula string) each resolve a `Package` into `document-content-model`'s own `ContentSection`/`ContentSlide`/`ContentDrawPage`/`ContentSheet` shapes.
+- **`readOdfFormula`** resolves a standalone or embedded `.odf` formula's `content.xml` — bare MathML with no `office:document-content` wrapper, confirmed against real LibreOffice output — into its raw MathML nodes plus, when present, the formula's own native StarMath annotation string. There is no `document-content-model` pivot type for MathML, so this reader's own output type is its own.
+- **`readOdm`** resolves a `.odm` master document's own `content.xml` into an ordered list of chapter references (`{ name, href, filterName? }`, one per top-level linked `text:section`) without opening the external `.odt` files those references point at. A master document's chapters are genuinely external files by ODF design, not embedded package sub-documents — confirmed against real LibreOffice output, which never caches a chapter's own content inside the master document itself (see `src/typed/odm/read.ts`'s own top-of-file note).
 
-Not yet built: `readOds`, `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.
+Not yet built: `readOdbInventory`, live-view editors, and the `.odb` database-table-export subsystem. 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
 
@@ -76,7 +78,7 @@ Layered from a lossless core outward, mirroring `ooxml.js`'s own structure:
 - **`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/odp/`, `src/typed/odg/`** — the built `readOdt`/`readOdp`/`readOdg` readers; **`src/typed/draw/`** — the `draw:frame`/`draw:g`/vector-primitive shape vocabulary `readOdp` and `readOdg` both share; **`src/typed/ods.ts`, `src/typed/formula/`** — not yet built (see [Status](#status)).
+- **`src/typed/odt/`, `src/typed/odp/`, `src/typed/odg/`, `src/typed/ods/`** — the built `readOdt`/`readOdp`/`readOdg`/`readOds` readers; **`src/typed/draw/`** — the `draw:frame`/`draw:g`/vector-primitive shape vocabulary `readOdp` and `readOdg` both share; **`src/typed/formula/`, `src/typed/odm/`** — `readOdfFormula` (raw MathML, no `document-content-model` pivot) and `readOdm` (a `.odm` master document's own external chapter references — name/href/filter-name per linked `text:section`, never the linked content itself).
 
 ## Why no `ooxml.js` dependency
 

package/dist/index.cjs

@@ -2484,7 +2484,7 @@ function readDrawPageContent(children, pkg) {
 }
 //#endregion
 //#region src/typed/odp/read.ts
-const CONTENT_PART$3 = "content.xml";
+const CONTENT_PART$5 = "content.xml";
 function readSlideSize(page, pkg) {
 	return resolveDrawPageSize(page, pkg) ?? document_content_model.SLIDE_SIZE_WIDESCREEN;
 }
@@ -2503,7 +2503,7 @@ function readSlide(page, pkg) {
 	};
 }
 function readOdp(pkg) {
-	const contentPart = pkg.parts[CONTENT_PART$3];
+	const contentPart = pkg.parts[CONTENT_PART$5];
 	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");
@@ -2515,9 +2515,9 @@ function readOdp(pkg) {
 }
 //#endregion
 //#region src/typed/odt/read.ts
-const CONTENT_PART$2 = "content.xml";
+const CONTENT_PART$4 = "content.xml";
 const STYLES_PART = "styles.xml";
-const AUTOMATIC_STYLE_PARTS = [CONTENT_PART$2, STYLES_PART];
+const AUTOMATIC_STYLE_PARTS = [CONTENT_PART$4, STYLES_PART];
 function readOutlineLevel(headingElement) {
 	const raw = attrValue(headingElement, "text:outline-level");
 	if (raw === void 0) return 1;
@@ -2600,12 +2600,12 @@ function readFirstMasterPageGeometry(pkg) {
 	};
 }
 function readOdt(pkg) {
-	const contentPart = pkg.parts[CONTENT_PART$2];
-	if (contentPart?.kind !== "xml") throw new Error(`readOdt: package has no ${CONTENT_PART$2} part`);
+	const contentPart = pkg.parts[CONTENT_PART$4];
+	if (contentPart?.kind !== "xml") throw new Error(`readOdt: package has no ${CONTENT_PART$4} part`);
 	const contentRoot = rootElement(contentPart.nodes);
 	const body = contentRoot === void 0 ? void 0 : findChildElement(contentRoot.children, "office:body");
 	const textElement = body === void 0 ? void 0 : findChildElement(body.children, "office:text");
-	if (textElement === void 0) throw new Error(`readOdt: ${CONTENT_PART$2} has no office:body/office:text element`);
+	if (textElement === void 0) throw new Error(`readOdt: ${CONTENT_PART$4} has no office:body/office:text element`);
 	const metadata = readOdfMetadata(pkg);
 	const { pageSize, margins } = readFirstMasterPageGeometry(pkg);
 	return {
@@ -2619,7 +2619,7 @@ function readOdt(pkg) {
 }
 //#endregion
 //#region src/typed/odg/read.ts
-const CONTENT_PART$1 = "content.xml";
+const CONTENT_PART$3 = "content.xml";
 const DEFAULT_PAGE_SIZE$1 = document_content_model.PAGE_SIZE_A4;
 function readPage(page, pkg) {
 	const size = resolveDrawPageSize(page, pkg) ?? DEFAULT_PAGE_SIZE$1;
@@ -2631,7 +2631,7 @@ function readPage(page, pkg) {
 	};
 }
 function readOdg(pkg) {
-	const contentPart = pkg.parts[CONTENT_PART$1];
+	const contentPart = pkg.parts[CONTENT_PART$3];
 	const root = contentPart?.kind === "xml" ? rootElement(contentPart.nodes) : void 0;
 	const body = root === void 0 ? void 0 : findChildElement(root.children, "office:body");
 	const drawing = body === void 0 ? void 0 : findChildElement(body.children, "office:drawing");
@@ -2643,7 +2643,7 @@ function readOdg(pkg) {
 }
 //#endregion
 //#region src/typed/ods/read.ts
-const CONTENT_PART = "content.xml";
+const CONTENT_PART$2 = "content.xml";
 function parseKnownOdfLength(value) {
 	const parsed = parseOdfLength(value);
 	if (parsed === void 0) throw new Error(`readOds: internal error -- "${value}" is not a valid ODF length literal`);
@@ -2933,7 +2933,7 @@ function readSheet(tableElement, pkg) {
 	};
 }
 function readOds(pkg) {
-	const contentPart = pkg.parts[CONTENT_PART];
+	const contentPart = pkg.parts[CONTENT_PART$2];
 	const root = contentPart?.kind === "xml" ? rootElement(contentPart.nodes) : void 0;
 	const body = root === void 0 ? void 0 : findChildElement(root.children, "office:body");
 	const spreadsheet = body === void 0 ? void 0 : findChildElement(body.children, "office:spreadsheet");
@@ -2949,6 +2949,83 @@ function readOds(pkg) {
 	};
 }
 //#endregion
+//#region src/typed/formula/read.ts
+const CONTENT_PART$1 = "content.xml";
+const MATH_ROOT_TAGS = ["math", "math:math"];
+const ANNOTATION_TAGS = ["annotation", "math:annotation"];
+const STARMATH_ENCODING_PREFIX = "StarMath";
+function findMathRoot(nodes) {
+	const root = rootElement(nodes);
+	if (root === void 0) return;
+	if (MATH_ROOT_TAGS.includes(root.tag)) return root;
+	for (const tag of MATH_ROOT_TAGS) {
+		const [found] = elementsWithTag(root.children, tag);
+		if (found !== void 0) return found;
+	}
+}
+function annotationText(element) {
+	let text = "";
+	for (const child of element.children) if (child.type === "text") text += decodeXmlText(child.value);
+	return text;
+}
+function findStarMathAnnotation(mathRoot) {
+	for (const tag of ANNOTATION_TAGS) for (const annotation of elementsWithTag(mathRoot.children, tag)) {
+		if (!attrValue(annotation, "encoding")?.startsWith(STARMATH_ENCODING_PREFIX)) continue;
+		const text = annotationText(annotation);
+		if (text.length > 0) return text;
+	}
+}
+function readOdfFormula(pkg) {
+	const contentPart = pkg.parts[CONTENT_PART$1];
+	if (contentPart?.kind !== "xml") throw new Error(`readOdfFormula: package has no ${CONTENT_PART$1} part`);
+	const mathRoot = findMathRoot(contentPart.nodes);
+	if (mathRoot === void 0) throw new Error(`readOdfFormula: ${CONTENT_PART$1} has no MathML root element`);
+	const metadata = readOdfMetadata(pkg);
+	const starMath = findStarMathAnnotation(mathRoot);
+	return starMath === void 0 ? {
+		mathml: mathRoot.children,
+		metadata
+	} : {
+		starMath,
+		mathml: mathRoot.children,
+		metadata
+	};
+}
+//#endregion
+//#region src/typed/odm/read.ts
+const CONTENT_PART = "content.xml";
+function readSection(element) {
+	const sourceElement = findChildElement(element.children, "text:section-source");
+	if (sourceElement === void 0) return;
+	const name = attrValue(element, "text:name");
+	const href = attrValue(sourceElement, "xlink:href");
+	if (name === void 0 || href === void 0) return;
+	const filterName = attrValue(sourceElement, "text:filter-name");
+	return filterName === void 0 ? {
+		name,
+		href
+	} : {
+		name,
+		href,
+		filterName
+	};
+}
+function readOdm(pkg) {
+	const contentPart = pkg.parts[CONTENT_PART];
+	if (contentPart?.kind !== "xml") throw new Error(`readOdm: package has no ${CONTENT_PART} part`);
+	const contentRoot = rootElement(contentPart.nodes);
+	const body = contentRoot === void 0 ? void 0 : findChildElement(contentRoot.children, "office:body");
+	const textElement = body === void 0 ? void 0 : findChildElement(body.children, "office:text");
+	if (textElement === void 0) throw new Error(`readOdm: ${CONTENT_PART} has no office:body/office:text element`);
+	const sections = [];
+	for (const node of textElement.children) {
+		if (node.type !== "element" || node.tag !== "text:section") continue;
+		const section = readSection(node);
+		if (section !== void 0) sections.push(section);
+	}
+	return { sections };
+}
+//#endregion
 Object.defineProperty(exports, "AlignmentSchema", {
 	enumerable: true,
 	get: function() {
@@ -3037,10 +3114,12 @@ exports.readDrawFrame = readDrawFrame;
 exports.readDrawPageContent = readDrawPageContent;
 exports.readManifest = readManifest;
 exports.readMimetype = readMimetype;
+exports.readOdfFormula = readOdfFormula;
 exports.readOdfMetadata = readOdfMetadata;
 exports.readOdfParagraph = readOdfParagraph;
 exports.readOdfTable = readOdfTable;
 exports.readOdg = readOdg;
+exports.readOdm = readOdm;
 exports.readOdp = readOdp;
 exports.readOds = readOds;
 exports.readOdt = readOdt;

package/dist/index.d.cts

@@ -642,4 +642,24 @@ interface OdsDocument {
 }
 declare function readOds(pkg: Package): OdsDocument;
 //#endregion
-export { type Alignment, AlignmentSchema, type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type BuildManifestOptions, type CascadeDiagnostic, type DrawPageContent, 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 OdfRawPoint, type OdfRawSegment, type OdfRawSubpath, type OdfShapeGeometry, type OdfTransformFunction, type OdfViewBox, type OdgDocument, type OdpDocument, type OdsDocument, type OdtDocument, 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, buildOdfSubpaths, buildStylePropertyElements, buildXml, bytesToBase64, canonicalPropertiesString, cellReference, childrenWithTag, columnIndexToLetters, columnLettersToIndex, composeOdfGroupTransform, decodeOdfText, decodePackage, decodeXmlText, el, elementsWithTag, encodePackage, encodeXmlText, ensureSpan, findChildElement, findStyleElement, formatOdfColor, formatOdfLength, formatPercentageMultiplier, formatPt, getOdfSpaceCount, isStyleFamily, isXmlNode, measureOdfNodeLength, mediaTypeForExtension, netRotationDeg, packageCodec, paragraphPropertiesToAttributes, parseBox, parseCellReference, parseLength, parseLinePoints, parseMargins, parseOdfColor, parseOdfLength, parseOdfPathData, parseOdfPointsList, parseOdfTransform, parseOdfViewBox, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, rawSubpathFromPoints, readDrawFrame, readDrawPageContent, readManifest, readMimetype, readOdfMetadata, readOdfParagraph, readOdfTable, readOdg, readOdp, readOds, readOdt, resolveDrawPageSize, resolveOdfShapeGeometry, resolvePageLayoutProperties, resolveStyle, resolveStyleElementChain, rootElement, scaleOdfRawPoint, serializePackage, setDocumentMediaType, sniffImageFormat, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, walkDrawShapes, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };
+//#region src/typed/formula/read.d.ts
+interface OdfFormulaDocument {
+  starMath?: string;
+  mathml: XmlNode[];
+  metadata: LayoutMetadata;
+}
+declare function readOdfFormula(pkg: Package): OdfFormulaDocument;
+//#endregion
+//#region src/typed/odm/read.d.ts
+interface OdmSection {
+  name: string;
+  href: string;
+  filterName?: string;
+  inlineContent?: readonly XmlNode[];
+}
+interface OdmDocument {
+  sections: readonly OdmSection[];
+}
+declare function readOdm(pkg: Package): OdmDocument;
+//#endregion
+export { type Alignment, AlignmentSchema, type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type BuildManifestOptions, type CascadeDiagnostic, type DrawPageContent, 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 OdfFormulaDocument, type OdfNamespacePrefix, type OdfPoint, type OdfRawPoint, type OdfRawSegment, type OdfRawSubpath, type OdfShapeGeometry, type OdfTransformFunction, type OdfViewBox, type OdgDocument, type OdmDocument, type OdmSection, type OdpDocument, type OdsDocument, type OdtDocument, 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, buildOdfSubpaths, buildStylePropertyElements, buildXml, bytesToBase64, canonicalPropertiesString, cellReference, childrenWithTag, columnIndexToLetters, columnLettersToIndex, composeOdfGroupTransform, decodeOdfText, decodePackage, decodeXmlText, el, elementsWithTag, encodePackage, encodeXmlText, ensureSpan, findChildElement, findStyleElement, formatOdfColor, formatOdfLength, formatPercentageMultiplier, formatPt, getOdfSpaceCount, isStyleFamily, isXmlNode, measureOdfNodeLength, mediaTypeForExtension, netRotationDeg, packageCodec, paragraphPropertiesToAttributes, parseBox, parseCellReference, parseLength, parseLinePoints, parseMargins, parseOdfColor, parseOdfLength, parseOdfPathData, parseOdfPointsList, parseOdfTransform, parseOdfViewBox, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, rawSubpathFromPoints, readDrawFrame, readDrawPageContent, readManifest, readMimetype, readOdfFormula, readOdfMetadata, readOdfParagraph, readOdfTable, readOdg, readOdm, readOdp, readOds, readOdt, resolveDrawPageSize, resolveOdfShapeGeometry, resolvePageLayoutProperties, resolveStyle, resolveStyleElementChain, rootElement, scaleOdfRawPoint, serializePackage, setDocumentMediaType, sniffImageFormat, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, walkDrawShapes, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };

package/dist/index.d.ts

@@ -642,4 +642,24 @@ interface OdsDocument {
 }
 declare function readOds(pkg: Package): OdsDocument;
 //#endregion
-export { type Alignment, AlignmentSchema, type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type BuildManifestOptions, type CascadeDiagnostic, type DrawPageContent, 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 OdfRawPoint, type OdfRawSegment, type OdfRawSubpath, type OdfShapeGeometry, type OdfTransformFunction, type OdfViewBox, type OdgDocument, type OdpDocument, type OdsDocument, type OdtDocument, 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, buildOdfSubpaths, buildStylePropertyElements, buildXml, bytesToBase64, canonicalPropertiesString, cellReference, childrenWithTag, columnIndexToLetters, columnLettersToIndex, composeOdfGroupTransform, decodeOdfText, decodePackage, decodeXmlText, el, elementsWithTag, encodePackage, encodeXmlText, ensureSpan, findChildElement, findStyleElement, formatOdfColor, formatOdfLength, formatPercentageMultiplier, formatPt, getOdfSpaceCount, isStyleFamily, isXmlNode, measureOdfNodeLength, mediaTypeForExtension, netRotationDeg, packageCodec, paragraphPropertiesToAttributes, parseBox, parseCellReference, parseLength, parseLinePoints, parseMargins, parseOdfColor, parseOdfLength, parseOdfPathData, parseOdfPointsList, parseOdfTransform, parseOdfViewBox, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, rawSubpathFromPoints, readDrawFrame, readDrawPageContent, readManifest, readMimetype, readOdfMetadata, readOdfParagraph, readOdfTable, readOdg, readOdp, readOds, readOdt, resolveDrawPageSize, resolveOdfShapeGeometry, resolvePageLayoutProperties, resolveStyle, resolveStyleElementChain, rootElement, scaleOdfRawPoint, serializePackage, setDocumentMediaType, sniffImageFormat, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, walkDrawShapes, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };
+//#region src/typed/formula/read.d.ts
+interface OdfFormulaDocument {
+  starMath?: string;
+  mathml: XmlNode[];
+  metadata: LayoutMetadata;
+}
+declare function readOdfFormula(pkg: Package): OdfFormulaDocument;
+//#endregion
+//#region src/typed/odm/read.d.ts
+interface OdmSection {
+  name: string;
+  href: string;
+  filterName?: string;
+  inlineContent?: readonly XmlNode[];
+}
+interface OdmDocument {
+  sections: readonly OdmSection[];
+}
+declare function readOdm(pkg: Package): OdmDocument;
+//#endregion
+export { type Alignment, AlignmentSchema, type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type BuildManifestOptions, type CascadeDiagnostic, type DrawPageContent, 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 OdfFormulaDocument, type OdfNamespacePrefix, type OdfPoint, type OdfRawPoint, type OdfRawSegment, type OdfRawSubpath, type OdfShapeGeometry, type OdfTransformFunction, type OdfViewBox, type OdgDocument, type OdmDocument, type OdmSection, type OdpDocument, type OdsDocument, type OdtDocument, 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, buildOdfSubpaths, buildStylePropertyElements, buildXml, bytesToBase64, canonicalPropertiesString, cellReference, childrenWithTag, columnIndexToLetters, columnLettersToIndex, composeOdfGroupTransform, decodeOdfText, decodePackage, decodeXmlText, el, elementsWithTag, encodePackage, encodeXmlText, ensureSpan, findChildElement, findStyleElement, formatOdfColor, formatOdfLength, formatPercentageMultiplier, formatPt, getOdfSpaceCount, isStyleFamily, isXmlNode, measureOdfNodeLength, mediaTypeForExtension, netRotationDeg, packageCodec, paragraphPropertiesToAttributes, parseBox, parseCellReference, parseLength, parseLinePoints, parseMargins, parseOdfColor, parseOdfLength, parseOdfPathData, parseOdfPointsList, parseOdfTransform, parseOdfViewBox, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, rawSubpathFromPoints, readDrawFrame, readDrawPageContent, readManifest, readMimetype, readOdfFormula, readOdfMetadata, readOdfParagraph, readOdfTable, readOdg, readOdm, readOdp, readOds, readOdt, resolveDrawPageSize, resolveOdfShapeGeometry, resolvePageLayoutProperties, resolveStyle, resolveStyleElementChain, rootElement, scaleOdfRawPoint, serializePackage, setDocumentMediaType, sniffImageFormat, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, walkDrawShapes, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };

package/dist/index.js

@@ -2483,7 +2483,7 @@ function readDrawPageContent(children, pkg) {
 }
 //#endregion
 //#region src/typed/odp/read.ts
-const CONTENT_PART$3 = "content.xml";
+const CONTENT_PART$5 = "content.xml";
 function readSlideSize(page, pkg) {
 	return resolveDrawPageSize(page, pkg) ?? SLIDE_SIZE_WIDESCREEN;
 }
@@ -2502,7 +2502,7 @@ function readSlide(page, pkg) {
 	};
 }
 function readOdp(pkg) {
-	const contentPart = pkg.parts[CONTENT_PART$3];
+	const contentPart = pkg.parts[CONTENT_PART$5];
 	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");
@@ -2514,9 +2514,9 @@ function readOdp(pkg) {
 }
 //#endregion
 //#region src/typed/odt/read.ts
-const CONTENT_PART$2 = "content.xml";
+const CONTENT_PART$4 = "content.xml";
 const STYLES_PART = "styles.xml";
-const AUTOMATIC_STYLE_PARTS = [CONTENT_PART$2, STYLES_PART];
+const AUTOMATIC_STYLE_PARTS = [CONTENT_PART$4, STYLES_PART];
 function readOutlineLevel(headingElement) {
 	const raw = attrValue(headingElement, "text:outline-level");
 	if (raw === void 0) return 1;
@@ -2599,12 +2599,12 @@ function readFirstMasterPageGeometry(pkg) {
 	};
 }
 function readOdt(pkg) {
-	const contentPart = pkg.parts[CONTENT_PART$2];
-	if (contentPart?.kind !== "xml") throw new Error(`readOdt: package has no ${CONTENT_PART$2} part`);
+	const contentPart = pkg.parts[CONTENT_PART$4];
+	if (contentPart?.kind !== "xml") throw new Error(`readOdt: package has no ${CONTENT_PART$4} part`);
 	const contentRoot = rootElement(contentPart.nodes);
 	const body = contentRoot === void 0 ? void 0 : findChildElement(contentRoot.children, "office:body");
 	const textElement = body === void 0 ? void 0 : findChildElement(body.children, "office:text");
-	if (textElement === void 0) throw new Error(`readOdt: ${CONTENT_PART$2} has no office:body/office:text element`);
+	if (textElement === void 0) throw new Error(`readOdt: ${CONTENT_PART$4} has no office:body/office:text element`);
 	const metadata = readOdfMetadata(pkg);
 	const { pageSize, margins } = readFirstMasterPageGeometry(pkg);
 	return {
@@ -2618,7 +2618,7 @@ function readOdt(pkg) {
 }
 //#endregion
 //#region src/typed/odg/read.ts
-const CONTENT_PART$1 = "content.xml";
+const CONTENT_PART$3 = "content.xml";
 const DEFAULT_PAGE_SIZE$1 = PAGE_SIZE_A4;
 function readPage(page, pkg) {
 	const size = resolveDrawPageSize(page, pkg) ?? DEFAULT_PAGE_SIZE$1;
@@ -2630,7 +2630,7 @@ function readPage(page, pkg) {
 	};
 }
 function readOdg(pkg) {
-	const contentPart = pkg.parts[CONTENT_PART$1];
+	const contentPart = pkg.parts[CONTENT_PART$3];
 	const root = contentPart?.kind === "xml" ? rootElement(contentPart.nodes) : void 0;
 	const body = root === void 0 ? void 0 : findChildElement(root.children, "office:body");
 	const drawing = body === void 0 ? void 0 : findChildElement(body.children, "office:drawing");
@@ -2642,7 +2642,7 @@ function readOdg(pkg) {
 }
 //#endregion
 //#region src/typed/ods/read.ts
-const CONTENT_PART = "content.xml";
+const CONTENT_PART$2 = "content.xml";
 function parseKnownOdfLength(value) {
 	const parsed = parseOdfLength(value);
 	if (parsed === void 0) throw new Error(`readOds: internal error -- "${value}" is not a valid ODF length literal`);
@@ -2932,7 +2932,7 @@ function readSheet(tableElement, pkg) {
 	};
 }
 function readOds(pkg) {
-	const contentPart = pkg.parts[CONTENT_PART];
+	const contentPart = pkg.parts[CONTENT_PART$2];
 	const root = contentPart?.kind === "xml" ? rootElement(contentPart.nodes) : void 0;
 	const body = root === void 0 ? void 0 : findChildElement(root.children, "office:body");
 	const spreadsheet = body === void 0 ? void 0 : findChildElement(body.children, "office:spreadsheet");
@@ -2948,4 +2948,81 @@ function readOds(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, buildOdfSubpaths, buildStylePropertyElements, buildXml, bytesToBase64, canonicalPropertiesString, cellReference, childrenWithTag, columnIndexToLetters, columnLettersToIndex, composeOdfGroupTransform, decodeOdfText, decodePackage, decodeXmlText, el, elementsWithTag, encodePackage, encodeXmlText, ensureSpan, findChildElement, findStyleElement, formatOdfColor, formatOdfLength, formatPercentageMultiplier, formatPt, getOdfSpaceCount, isStyleFamily, isXmlNode, measureOdfNodeLength, mediaTypeForExtension, netRotationDeg, packageCodec, paragraphPropertiesToAttributes, parseBox, parseCellReference, parseLength, parseLinePoints, parseMargins, parseOdfColor, parseOdfLength, parseOdfPathData, parseOdfPointsList, parseOdfTransform, parseOdfViewBox, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, rawSubpathFromPoints, readDrawFrame, readDrawPageContent, readManifest, readMimetype, readOdfMetadata, readOdfParagraph, readOdfTable, readOdg, readOdp, readOds, readOdt, resolveDrawPageSize, resolveOdfShapeGeometry, resolvePageLayoutProperties, resolveStyle, resolveStyleElementChain, rootElement, scaleOdfRawPoint, serializePackage, setDocumentMediaType, sniffImageFormat, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, walkDrawShapes, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };
+//#region src/typed/formula/read.ts
+const CONTENT_PART$1 = "content.xml";
+const MATH_ROOT_TAGS = ["math", "math:math"];
+const ANNOTATION_TAGS = ["annotation", "math:annotation"];
+const STARMATH_ENCODING_PREFIX = "StarMath";
+function findMathRoot(nodes) {
+	const root = rootElement(nodes);
+	if (root === void 0) return;
+	if (MATH_ROOT_TAGS.includes(root.tag)) return root;
+	for (const tag of MATH_ROOT_TAGS) {
+		const [found] = elementsWithTag(root.children, tag);
+		if (found !== void 0) return found;
+	}
+}
+function annotationText(element) {
+	let text = "";
+	for (const child of element.children) if (child.type === "text") text += decodeXmlText(child.value);
+	return text;
+}
+function findStarMathAnnotation(mathRoot) {
+	for (const tag of ANNOTATION_TAGS) for (const annotation of elementsWithTag(mathRoot.children, tag)) {
+		if (!attrValue(annotation, "encoding")?.startsWith(STARMATH_ENCODING_PREFIX)) continue;
+		const text = annotationText(annotation);
+		if (text.length > 0) return text;
+	}
+}
+function readOdfFormula(pkg) {
+	const contentPart = pkg.parts[CONTENT_PART$1];
+	if (contentPart?.kind !== "xml") throw new Error(`readOdfFormula: package has no ${CONTENT_PART$1} part`);
+	const mathRoot = findMathRoot(contentPart.nodes);
+	if (mathRoot === void 0) throw new Error(`readOdfFormula: ${CONTENT_PART$1} has no MathML root element`);
+	const metadata = readOdfMetadata(pkg);
+	const starMath = findStarMathAnnotation(mathRoot);
+	return starMath === void 0 ? {
+		mathml: mathRoot.children,
+		metadata
+	} : {
+		starMath,
+		mathml: mathRoot.children,
+		metadata
+	};
+}
+//#endregion
+//#region src/typed/odm/read.ts
+const CONTENT_PART = "content.xml";
+function readSection(element) {
+	const sourceElement = findChildElement(element.children, "text:section-source");
+	if (sourceElement === void 0) return;
+	const name = attrValue(element, "text:name");
+	const href = attrValue(sourceElement, "xlink:href");
+	if (name === void 0 || href === void 0) return;
+	const filterName = attrValue(sourceElement, "text:filter-name");
+	return filterName === void 0 ? {
+		name,
+		href
+	} : {
+		name,
+		href,
+		filterName
+	};
+}
+function readOdm(pkg) {
+	const contentPart = pkg.parts[CONTENT_PART];
+	if (contentPart?.kind !== "xml") throw new Error(`readOdm: package has no ${CONTENT_PART} part`);
+	const contentRoot = rootElement(contentPart.nodes);
+	const body = contentRoot === void 0 ? void 0 : findChildElement(contentRoot.children, "office:body");
+	const textElement = body === void 0 ? void 0 : findChildElement(body.children, "office:text");
+	if (textElement === void 0) throw new Error(`readOdm: ${CONTENT_PART} has no office:body/office:text element`);
+	const sections = [];
+	for (const node of textElement.children) {
+		if (node.type !== "element" || node.tag !== "text:section") continue;
+		const section = readSection(node);
+		if (section !== void 0) sections.push(section);
+	}
+	return { sections };
+}
+//#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, buildOdfSubpaths, buildStylePropertyElements, buildXml, bytesToBase64, canonicalPropertiesString, cellReference, childrenWithTag, columnIndexToLetters, columnLettersToIndex, composeOdfGroupTransform, decodeOdfText, decodePackage, decodeXmlText, el, elementsWithTag, encodePackage, encodeXmlText, ensureSpan, findChildElement, findStyleElement, formatOdfColor, formatOdfLength, formatPercentageMultiplier, formatPt, getOdfSpaceCount, isStyleFamily, isXmlNode, measureOdfNodeLength, mediaTypeForExtension, netRotationDeg, packageCodec, paragraphPropertiesToAttributes, parseBox, parseCellReference, parseLength, parseLinePoints, parseMargins, parseOdfColor, parseOdfLength, parseOdfPathData, parseOdfPointsList, parseOdfTransform, parseOdfViewBox, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, rawSubpathFromPoints, readDrawFrame, readDrawPageContent, readManifest, readMimetype, readOdfFormula, readOdfMetadata, readOdfParagraph, readOdfTable, readOdg, readOdm, readOdp, readOds, readOdt, resolveDrawPageSize, resolveOdfShapeGeometry, resolvePageLayoutProperties, resolveStyle, resolveStyleElementChain, rootElement, scaleOdfRawPoint, 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.7.0",
+  "version": "1.9.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": {