odf.js 2.0.0 → 2.1.0

package/README.md

@@ -51,7 +51,7 @@ 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-schema.js`'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 shared `text:p` → `ContentParagraph`/`ContentRun` and `table:table` → `ContentTable` readers (`readOdfParagraph`/`readOdfTable`) every typed reader below builds on, 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), `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-schema.js`'s own `ContentSection`/`ContentSlide`/`ContentDrawPage`/`ContentSheet` 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, plus cell- and page-anchored `draw:frame` images and embedded ODF sub-documents) each resolve a `Package` into `document-schema.js`'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, in this reader's own bespoke `OdfFormulaDocument` shape. **`readOdfFormulaDocument`** wraps that same result into a real `document-schema.js` `ContentDocument` of kind `'formula'` — `document-schema.js` 2.0.0 added a `MathMlNode`/`ContentFormula` pivot shape for exactly this, a structural mirror of this package's own `XmlNode` that `readOdfFormula`'s real output assigns to with zero cast.
 - **`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).
 - **`readOdbInventory`** resolves a `.odb` database front-end package into connection info, its table *names*, its query *definitions* (name, real `db:command` SQL text, and `db:escape-processing` when declared), and its forms/reports as `{ name, href }` pairs. Confirmed against real LibreOffice output that `office:database` lives directly in the package's ordinary `content.xml` (no separate `database/connection.xml` part, contrary to the OASIS schema's own chapter layout suggesting one), that queries are declared inline (`db:queries/db:query`, no manifest part of their own), and that a live engine's own tables have no ODF-level manifest listing at all. A form's/report's sub-document directory is named after an opaque *persistent* name (`forms/Obj11`), **not** after the form/report — the user-visible name lives only in `content.xml`'s own `db:forms`/`db:reports` registry, which is where this reader takes both the name and the href from. See `src/typed/odb/read.ts`'s own top-of-file note for the full findings.
@@ -126,7 +126,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-schema.js`'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), `paragraph.ts`/`table.ts` (`readOdfParagraph`/`readOdfTable`, the shared `text:p` → `ContentParagraph`/`ContentRun` and `table:table` → `ContentTable` readers `readOdt`, `readOds`, and `typed/draw/shapes.ts` all call), `transform.ts` (the `draw:transform`/`draw:g` group-flattening geometry resolver), `masterpage.ts` (master-page → page-layout page-size/print-settings resolution, shared by a `draw:page`'s own size and a spreadsheet's print settings), `path.ts` (an `svg:d`/`draw:points` vector-path grammar parser), `metadata.ts` (`meta.xml` reading).
-- **`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`/`readOdfFormulaDocument` (raw MathML, and the `document-schema.js` `ContentDocument` 'formula'-kind pivot built on top of it) and `readOdm` (a `.odm` master document's own external chapter references — name/href/filter-name per linked `text:section`, never the linked content itself); **`src/typed/odb/`** — `readOdbInventory` (a `.odb` package's own connection info, table/query/form/report registry, never the database engine's own storage), plus `readOdbForm`/`readOdbReport` (static, execution-free structure extraction from a form's or report's own ODF sub-document) and `subDocumentPackage` (the synthetic sub-`Package` view they read those sub-documents through).
+- **`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 (`shapes.ts`), plus `embedded.ts`'s `readDrawObjectReference`, the `draw:object` embedded-sub-document counterpart `readOds` resolves a sheet's anchored OLE objects through; **`src/typed/formula/`, `src/typed/odm/`** — `readOdfFormula`/`readOdfFormulaDocument` (raw MathML, and the `document-schema.js` `ContentDocument` 'formula'-kind pivot built on top of it) and `readOdm` (a `.odm` master document's own external chapter references — name/href/filter-name per linked `text:section`, never the linked content itself); **`src/typed/odb/`** — `readOdbInventory` (a `.odb` package's own connection info, table/query/form/report registry, never the database engine's own storage), plus `readOdbForm`/`readOdbReport` (static, execution-free structure extraction from a form's or report's own ODF sub-document) and `subDocumentPackage` (the synthetic sub-`Package` view they read those sub-documents through).
 
 ## Why no `ooxml.js` dependency
 
@@ -149,8 +149,11 @@ See the top of this README — the short version: `ooxml.js`'s branding and sign
 - **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.
 - **A rotated `draw:rect`/`draw:ellipse`/`draw:path`/`draw:custom-shape` vector primitive now reads its own `rotationDeg`, not just its unrotated bounding frame.** `resolveVectorGeometry` (`typed/draw/shapes.ts`) replaces the old frame-only `resolveVectorFrame`, reusing the exact same `resolveOdfShapeGeometry`/`composeOdfGroupTransform` machinery `draw:frame` already resolved rotation through, including composing an enclosing `draw:g`'s own rotation the same way it already did for a frame. `ContentVectorSchema`'s rect/ellipse/path variants already carried a `rotationDeg` field before this change — it was being discarded on the read side, not missing from the schema.
 - **Every `ContentShape`/`ContentVector` a drawing or presentation reader produces is now stamped with its own resolved `paintOrder`, not merely sorted by it and discarded.** `walkDrawPageContent` (odg) and `walkDrawShapes` (odp) both compute a real z-index per element — an explicit `draw:z-index` when present, otherwise a monotonic document-encounter counter — purely to order their own output arrays; that value is now attached to each produced value via the same single counter threaded across the whole walk. Because `shapes` and `vectors` are stamped from the identical counter, a caller can recover their true relative paint order across the two independently-ordered arrays by comparing `paintOrder` directly — closing the cross-array ordering gap `documents.js`'s own README previously described as unrecoverable, even though `ContentDrawPageSchema` itself still keeps the two arrays with no shared ordering field of its own.
-- **`svg:fill-rule` (`nonzero`/`evenodd`) and `draw:stroke`'s `solid`/`dash` enumeration are now read and mapped onto `ContentVector`'s path-variant `fillRule` and `ContentStroke.style`.** Both mappings are confirmed against the OASIS schema reference rather than only against real-world producer output — `typed/draw/shapes.ts`'s own comment notes that a live-LibreOffice re-verification of `svg:fill-rule` specifically was blocked by the same headless-`soffice`-hang constraint `documents.js`'s own README documents. A genuinely dotted (as opposed to dashed) stroke pattern, and a `"double"` stroke style ODF's own vector-stroke model has no concept of at all, both remain unread — real, permanent boundaries rather than oversights (see that file's own comment for why each).
+- **`svg:fill-rule` (`nonzero`/`evenodd`) and `draw:stroke`'s `solid`/`dash` enumeration are now read and mapped onto `ContentVector`'s path-variant `fillRule` and `ContentStroke.style`.** Both mappings are confirmed against the OASIS schema reference rather than only against real-world producer output — `typed/draw/shapes.ts`'s own comment notes that a live-LibreOffice re-verification of `svg:fill-rule` specifically was blocked by the same headless-`soffice`-hang constraint `documents.js`'s own README documents. A genuinely dotted (as opposed to dashed) stroke pattern, and a `"double"` stroke style ODF's own vector-stroke model has no concept of at all, both remain unread — real, permanent boundaries rather than oversights (see that file's own comment for why each). The original test coverage for `svg:fill-rule` only ever exercised a single-loop `svg:d`, which cannot actually distinguish the two rules — there is nothing for `evenodd`'s alternating parity to differ from `nonzero`'s winding count with only one contour. `shapes.test.ts` now also covers a genuine two-subpath "letter O" donut shape (an outer square and an inner square hole, both wound in the same rotational direction), the real-world case the attribute exists for: `nonzero` would fill the hole solid (winding number 2, still non-zero) while `evenodd` correctly punches it (parity toggles to 0 inside), and the test confirms both subpaths, their `closed` flags, and the inner subpath's scaled points are read correctly alongside `fillRule` itself.
 - **`readOds` and the shared `readTableCell` (odt/odp table cells) now resolve `fo:background-color`, the `fo:border`/`fo:border-(left|right|top|bottom)` shorthand-and-per-edge-override chain, `style:vertical-align`, and a cell style's own `style:paragraph-properties` `fo:text-align` from the real ODF style cascade**, populating `ContentSheetCell`/`ContentTableCell`'s `background`/`borders` (plus `ContentSheetCell`'s own `alignment`/`verticalAlignment`) rather than leaving them unpopulated. `readCellStyleDecoration` (`typed/shared/table.ts`) is the one fold both callers share: `readOds` resolves it over the full root-to-target `style:parent-style-name` chain (`resolveStyleElementChain`, confirmed against this package's own `kitchen-sink.ods` fixture's real `ce1`..`ce5` → `Default` chain), `readTableCell` over the single style element `findStyleElement` already resolves. An explicit `fo:border-*` override of `"none"`/`"hidden"` genuinely clears an inherited edge rather than merely leaving it unmentioned.
+- **`readOds` now reads drawings anchored to a sheet, populating `ContentSheet.images` (previously hardcoded `[]`) and `ContentSheet.embeddedObjects` (previously never set), through the same `typed/draw/shapes.ts` primitives `readOdp`/`readOdg` already use.** ODF has exactly two spreadsheet anchoring conventions, both confirmed against real LibreOffice 26.2 output (`src/typed/ods/fixtures/sheet-anchors.ods`, built via a Java UNO client and never hand-edited): a **cell-anchored** `draw:frame` is a *direct child of the `table:table-cell` it is anchored to*, with `svg:x`/`svg:y` measured from **that cell's own top-left corner**; a **page-anchored** one sits in a `table:shapes` element (a child of `table:table` preceding its column definitions) with absolute sheet coordinates. The anchor cell reference is not read from any attribute at all — ODF cells have none (see the cursor gotchas above) — it is the same running `TableCursor` position `ContentSheetCell.row`/`column` already come from; a page-anchored image is reported against cell `(0, 0)`, whose own top-left *is* the sheet origin, so its absolute offsets carry through exactly rather than being approximated. A `draw:g` group is walked through, composing its own `draw:transform` via `readDrawFrame`'s existing `groupFunctions` parameter. What a sheet cannot carry is anything `ContentSheetSchema` has nowhere to put — a floating text box or table frame (no `shapes` array), a bare vector primitive (no `vectors` array), and an embedded formula or chart object (`ContentEmbeddedObject.document` is a required `ContentDocument`, whose union has no MathML- or chart-shaped variant) — each skipped rather than mapped onto an approximation of a different kind.
+- **`readDrawObjectReference` (`typed/draw/embedded.ts`) is the new shared `draw:object` counterpart to `shapes.ts`'s existing `draw:image` handling**, resolving a frame's embedded-object reference into the sub-`Package` it names (via `subDocumentPackage`) plus the `ContentEmbeddedObjectKind` that sub-document actually is, read from its own `office:body` content child rather than from the manifest's declared media type — one signal, so the reported kind and the reader that produced the content agree by construction. It deliberately stops short of calling `readOdt`/`readOds`/`readOdp`/`readOdg` itself: doing so would import `readOds`, which imports this module. A real embedded-object frame also carries a `draw:image` preview of its own object (an `ObjectReplacements/` GDI metafile), so `draw:object` must be checked *before* a frame's image content — the same ordering, for the same reason, that `readDrawFrameContent` already applies to a table frame's preview image.
+- **A `draw:frame`'s alternative text (`svg:title`, falling back to `svg:desc`) is now read into `ContentImageBlock.altText` for every format**, not just spreadsheets. Both are plain-text *child elements* of `draw:frame` itself, not attributes — confirmed against real LibreOffice output, where a Calc image's UNO `Title`/`Description` properties round-trip as `<svg:title>`/`<svg:desc>` siblings of the frame's own `draw:image`.
 - **`readOdfFormulaDocument` now wraps a formula's raw MathML into a real `document-schema.js` `ContentDocument` of kind `'formula'`**, alongside (not instead of) this package's own pre-existing bespoke `OdfFormulaDocument` shape from `readOdfFormula`, which is unchanged. `document-schema.js` 2.0.0 added the `MathMlNode`/`ContentFormula` pivot specifically for this — a structural mirror of this package's own `XmlNode` that `readOdfFormula`'s existing return value assigns into with zero cast.
 - **`readOdbInventory`'s `queries` now carry each query's real `db:command` SQL text (plus `db:escape-processing` when declared) instead of only a bare name.** `OdbInventory.queries` is now `OdbQueryInfo[]` (`{ name, command, escapeProcessing? }`), a breaking rename from the previous `string[]` — a query's own `db:command` is already inline in `content.xml`, unlike a form/report/table's real content, which lives in a separate sub-document or database engine this reader never opens, so the "content lives elsewhere, only names are read" rule that correctly applies to those does not hold for a query. `db:command` is entity-decoded before being returned, matching every other typed reader's convention.
 - **`.odb` Form/Report structure extraction is real and working, grounded in a genuine LibreOffice-generated fixture, not blocked.** `readOdbForm`/`readOdbReport` open a form's or report's own sub-document (via `subDocumentPackage`, a synthetic sub-`Package` view over its directory) and extract its complete static structure — command bindings, control trees, nested sub-forms, the band/group hierarchy, bound and computed expressions — executing nothing. See the Architecture section above and `src/typed/odb/form.ts`/`report.ts`'s own top-of-file notes for the two real shapes this fixture caught that an assumed reading would have got wrong. **A SQL/`rpt:` rendering engine to actually execute a query or evaluate a report's own totals against real data is deliberately not attempted**, not merely unstarted — that is a materially different, larger undertaking (reimplementing a slice of HSQLDB's/Firebird's own query semantics) with its own unreviewed licensing question, gated on the requesting engineer's explicit sign-off after reading the relevant engine source. See the bounded-SQL-subset assessment immediately below for exactly how far the *reading* side alone gets you.

package/dist/index.cjs

@@ -34,6 +34,8 @@ const require_typed_shared_transform = require("./typed/shared/transform.cjs");
 const require_typed_shared_masterpage = require("./typed/shared/masterpage.cjs");
 const require_typed_shared_path = require("./typed/shared/path.cjs");
 const require_typed_draw_shapes = require("./typed/draw/shapes.cjs");
+const require_typed_odb_subdocument = require("./typed/odb/subdocument.cjs");
+const require_typed_draw_embedded = require("./typed/draw/embedded.cjs");
 const require_typed_odp_read = require("./typed/odp/read.cjs");
 const require_typed_odt_read = require("./typed/odt/read.cjs");
 const require_typed_odg_read = require("./typed/odg/read.cjs");
@@ -41,7 +43,6 @@ const require_typed_ods_read = require("./typed/ods/read.cjs");
 const require_typed_formula_read = require("./typed/formula/read.cjs");
 const require_typed_odm_read = require("./typed/odm/read.cjs");
 const require_typed_odb_read = require("./typed/odb/read.cjs");
-const require_typed_odb_subdocument = require("./typed/odb/subdocument.cjs");
 const require_typed_odb_form = require("./typed/odb/form.cjs");
 const require_typed_odb_report = require("./typed/odb/report.cjs");
 let document_schema_js = require("document-schema.js");
@@ -130,6 +131,7 @@ exports.parseTextProperties = require_styles_properties.parseTextProperties;
 exports.parseXml = require_xml_parse.parseXml;
 exports.rawSubpathFromPoints = require_typed_shared_path.rawSubpathFromPoints;
 exports.readDrawFrame = require_typed_draw_shapes.readDrawFrame;
+exports.readDrawObjectReference = require_typed_draw_embedded.readDrawObjectReference;
 exports.readDrawPageContent = require_typed_draw_shapes.readDrawPageContent;
 exports.readManifest = require_manifest.readManifest;
 exports.readMimetype = require_mimetype.readMimetype;

package/dist/index.d.cts

@@ -33,6 +33,7 @@ import { OdfPoint, OdfShapeGeometry, OdfTransformFunction, applyOdfTransform, co
 import { resolveDrawPageSize, resolvePageLayoutProperties } from "./typed/shared/masterpage.cjs";
 import { OdfRawPoint, OdfRawSegment, OdfRawSubpath, OdfViewBox, buildOdfSubpaths, parseOdfPathData, parseOdfPointsList, parseOdfViewBox, rawSubpathFromPoints, scaleOdfRawPoint } from "./typed/shared/path.cjs";
 import { DrawPageContent, readDrawFrame, readDrawPageContent, walkDrawShapes } from "./typed/draw/shapes.cjs";
+import { EmbeddedDocumentKind, EmbeddedDrawObject, readDrawObjectReference } from "./typed/draw/embedded.cjs";
 import { OdpDocument, readOdp } from "./typed/odp/read.cjs";
 import { OdtDocument, readOdt } from "./typed/odt/read.cjs";
 import { OdgDocument, readOdg } from "./typed/odg/read.cjs";
@@ -43,4 +44,4 @@ import { OdbComponentInfo, OdbConnectionInfo, OdbInventory, OdbQueryInfo, readOd
 import { SubDocumentPackageOptions, subDocumentPackage } from "./typed/odb/subdocument.cjs";
 import { OdbForm, OdbFormControl, OdbFormDefinition, readOdbForm } from "./typed/odb/form.cjs";
 import { OdbReport, OdbReportBand, OdbReportElement, OdbReportFunction, OdbReportGroup, readOdbReport } from "./typed/odb/report.cjs";
-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 OdbComponentInfo, type OdbConnectionInfo, type OdbForm, type OdbFormControl, type OdbFormDefinition, type OdbInventory, type OdbQueryInfo, type OdbReport, type OdbReportBand, type OdbReportElement, type OdbReportFunction, type OdbReportGroup, 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, type SubDocumentPackageOptions, 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, parseOdfLength as parseLength, parseOdfLength, parseLinePoints, parseMargins, parseOdfColor, parseOdfPathData, parseOdfPointsList, parseOdfTransform, parseOdfViewBox, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, rawSubpathFromPoints, readDrawFrame, readDrawPageContent, readManifest, readMimetype, readOdbForm, readOdbInventory, readOdbReport, readOdfFormula, readOdfFormulaDocument, readOdfMetadata, readOdfParagraph, readOdfTable, readOdg, readOdm, readOdp, readOds, readOdt, resolveDrawPageSize, resolveOdbComponent, resolveOdfShapeGeometry, resolvePageLayoutProperties, resolveStyle, resolveStyleElementChain, rootElement, scaleOdfRawPoint, serializePackage, setDocumentMediaType, sniffImageFormat, subDocumentPackage, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, walkDrawShapes, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };
+export { type Alignment, AlignmentSchema, type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type BuildManifestOptions, type CascadeDiagnostic, type DrawPageContent, type EmbeddedDocumentKind, type EmbeddedDrawObject, 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 OdbComponentInfo, type OdbConnectionInfo, type OdbForm, type OdbFormControl, type OdbFormDefinition, type OdbInventory, type OdbQueryInfo, type OdbReport, type OdbReportBand, type OdbReportElement, type OdbReportFunction, type OdbReportGroup, 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, type SubDocumentPackageOptions, 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, parseOdfLength as parseLength, parseOdfLength, parseLinePoints, parseMargins, parseOdfColor, parseOdfPathData, parseOdfPointsList, parseOdfTransform, parseOdfViewBox, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, rawSubpathFromPoints, readDrawFrame, readDrawObjectReference, readDrawPageContent, readManifest, readMimetype, readOdbForm, readOdbInventory, readOdbReport, readOdfFormula, readOdfFormulaDocument, readOdfMetadata, readOdfParagraph, readOdfTable, readOdg, readOdm, readOdp, readOds, readOdt, resolveDrawPageSize, resolveOdbComponent, resolveOdfShapeGeometry, resolvePageLayoutProperties, resolveStyle, resolveStyleElementChain, rootElement, scaleOdfRawPoint, serializePackage, setDocumentMediaType, sniffImageFormat, subDocumentPackage, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, walkDrawShapes, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };

package/dist/index.d.ts

@@ -33,6 +33,7 @@ import { OdfPoint, OdfShapeGeometry, OdfTransformFunction, applyOdfTransform, co
 import { resolveDrawPageSize, resolvePageLayoutProperties } from "./typed/shared/masterpage.js";
 import { OdfRawPoint, OdfRawSegment, OdfRawSubpath, OdfViewBox, buildOdfSubpaths, parseOdfPathData, parseOdfPointsList, parseOdfViewBox, rawSubpathFromPoints, scaleOdfRawPoint } from "./typed/shared/path.js";
 import { DrawPageContent, readDrawFrame, readDrawPageContent, walkDrawShapes } from "./typed/draw/shapes.js";
+import { EmbeddedDocumentKind, EmbeddedDrawObject, readDrawObjectReference } from "./typed/draw/embedded.js";
 import { OdpDocument, readOdp } from "./typed/odp/read.js";
 import { OdtDocument, readOdt } from "./typed/odt/read.js";
 import { OdgDocument, readOdg } from "./typed/odg/read.js";
@@ -43,4 +44,4 @@ import { OdbComponentInfo, OdbConnectionInfo, OdbInventory, OdbQueryInfo, readOd
 import { SubDocumentPackageOptions, subDocumentPackage } from "./typed/odb/subdocument.js";
 import { OdbForm, OdbFormControl, OdbFormDefinition, readOdbForm } from "./typed/odb/form.js";
 import { OdbReport, OdbReportBand, OdbReportElement, OdbReportFunction, OdbReportGroup, readOdbReport } from "./typed/odb/report.js";
-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 OdbComponentInfo, type OdbConnectionInfo, type OdbForm, type OdbFormControl, type OdbFormDefinition, type OdbInventory, type OdbQueryInfo, type OdbReport, type OdbReportBand, type OdbReportElement, type OdbReportFunction, type OdbReportGroup, 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, type SubDocumentPackageOptions, 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, parseOdfLength as parseLength, parseOdfLength, parseLinePoints, parseMargins, parseOdfColor, parseOdfPathData, parseOdfPointsList, parseOdfTransform, parseOdfViewBox, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, rawSubpathFromPoints, readDrawFrame, readDrawPageContent, readManifest, readMimetype, readOdbForm, readOdbInventory, readOdbReport, readOdfFormula, readOdfFormulaDocument, readOdfMetadata, readOdfParagraph, readOdfTable, readOdg, readOdm, readOdp, readOds, readOdt, resolveDrawPageSize, resolveOdbComponent, resolveOdfShapeGeometry, resolvePageLayoutProperties, resolveStyle, resolveStyleElementChain, rootElement, scaleOdfRawPoint, serializePackage, setDocumentMediaType, sniffImageFormat, subDocumentPackage, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, walkDrawShapes, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };
+export { type Alignment, AlignmentSchema, type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type BuildManifestOptions, type CascadeDiagnostic, type DrawPageContent, type EmbeddedDocumentKind, type EmbeddedDrawObject, 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 OdbComponentInfo, type OdbConnectionInfo, type OdbForm, type OdbFormControl, type OdbFormDefinition, type OdbInventory, type OdbQueryInfo, type OdbReport, type OdbReportBand, type OdbReportElement, type OdbReportFunction, type OdbReportGroup, 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, type SubDocumentPackageOptions, 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, parseOdfLength as parseLength, parseOdfLength, parseLinePoints, parseMargins, parseOdfColor, parseOdfPathData, parseOdfPointsList, parseOdfTransform, parseOdfViewBox, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, rawSubpathFromPoints, readDrawFrame, readDrawObjectReference, readDrawPageContent, readManifest, readMimetype, readOdbForm, readOdbInventory, readOdbReport, readOdfFormula, readOdfFormulaDocument, readOdfMetadata, readOdfParagraph, readOdfTable, readOdg, readOdm, readOdp, readOds, readOdt, resolveDrawPageSize, resolveOdbComponent, resolveOdfShapeGeometry, resolvePageLayoutProperties, resolveStyle, resolveStyleElementChain, rootElement, scaleOdfRawPoint, serializePackage, setDocumentMediaType, sniffImageFormat, subDocumentPackage, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, walkDrawShapes, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };

package/dist/index.js

@@ -33,6 +33,8 @@ import { applyOdfTransform, composeOdfGroupTransform, netRotationDeg, parseOdfTr
 import { resolveDrawPageSize, resolvePageLayoutProperties } from "./typed/shared/masterpage.js";
 import { buildOdfSubpaths, parseOdfPathData, parseOdfPointsList, parseOdfViewBox, rawSubpathFromPoints, scaleOdfRawPoint } from "./typed/shared/path.js";
 import { readDrawFrame, readDrawPageContent, walkDrawShapes } from "./typed/draw/shapes.js";
+import { subDocumentPackage } from "./typed/odb/subdocument.js";
+import { readDrawObjectReference } from "./typed/draw/embedded.js";
 import { readOdp } from "./typed/odp/read.js";
 import { readOdt } from "./typed/odt/read.js";
 import { readOdg } from "./typed/odg/read.js";
@@ -40,7 +42,6 @@ import { readOds } from "./typed/ods/read.js";
 import { readOdfFormula, readOdfFormulaDocument } from "./typed/formula/read.js";
 import { readOdm } from "./typed/odm/read.js";
 import { readOdbInventory, resolveOdbComponent } from "./typed/odb/read.js";
-import { subDocumentPackage } from "./typed/odb/subdocument.js";
 import { readOdbForm } from "./typed/odb/form.js";
 import { readOdbReport } from "./typed/odb/report.js";
-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, parseOdfLength as parseLength, parseOdfLength, parseLinePoints, parseMargins, parseOdfColor, parseOdfPathData, parseOdfPointsList, parseOdfTransform, parseOdfViewBox, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, rawSubpathFromPoints, readDrawFrame, readDrawPageContent, readManifest, readMimetype, readOdbForm, readOdbInventory, readOdbReport, readOdfFormula, readOdfFormulaDocument, readOdfMetadata, readOdfParagraph, readOdfTable, readOdg, readOdm, readOdp, readOds, readOdt, resolveDrawPageSize, resolveOdbComponent, resolveOdfShapeGeometry, resolvePageLayoutProperties, resolveStyle, resolveStyleElementChain, rootElement, scaleOdfRawPoint, serializePackage, setDocumentMediaType, sniffImageFormat, subDocumentPackage, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, walkDrawShapes, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };
+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, parseOdfLength as parseLength, parseOdfLength, parseLinePoints, parseMargins, parseOdfColor, parseOdfPathData, parseOdfPointsList, parseOdfTransform, parseOdfViewBox, parsePackage, parsePageSize, parseParagraphProperties, parseStyleElementProperties, parseTextProperties, parseXml, rawSubpathFromPoints, readDrawFrame, readDrawObjectReference, readDrawPageContent, readManifest, readMimetype, readOdbForm, readOdbInventory, readOdbReport, readOdfFormula, readOdfFormulaDocument, readOdfMetadata, readOdfParagraph, readOdfTable, readOdg, readOdm, readOdp, readOds, readOdt, resolveDrawPageSize, resolveOdbComponent, resolveOdfShapeGeometry, resolvePageLayoutProperties, resolveStyle, resolveStyleElementChain, rootElement, scaleOdfRawPoint, serializePackage, setDocumentMediaType, sniffImageFormat, subDocumentPackage, sumOdfNodeLength, syncManifest, textPropertiesToAttributes, txt, unzipPackage, validateManifest, walkDrawShapes, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };

package/dist/typed/draw/embedded.cjs

@@ -0,0 +1,42 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_xml_query = require("../../xml/query.cjs");
+const require_typed_odb_subdocument = require("../odb/subdocument.cjs");
+//#region src/typed/draw/embedded.ts
+const CONTENT_PART = "content.xml";
+function embeddedKindFor(bodyChildTag) {
+	switch (bodyChildTag) {
+		case "office:text": return "wordprocessing";
+		case "office:spreadsheet": return "spreadsheet";
+		case "office:presentation": return "presentation";
+		case "office:drawing": return "drawing";
+		default: return;
+	}
+}
+function normaliseObjectHref(raw) {
+	const withoutPrefix = raw.startsWith("./") ? raw.slice(2) : raw;
+	const trimmed = withoutPrefix.endsWith("/") ? withoutPrefix.slice(0, -1) : withoutPrefix;
+	if (trimmed.length === 0 || trimmed.startsWith("..") || trimmed.startsWith("/") || trimmed.includes("://")) return;
+	return trimmed;
+}
+function readDrawObjectReference(frame, pkg) {
+	const object = require_xml_query.childrenWithTag(frame, "draw:object")[0];
+	if (object === void 0) return;
+	const rawHref = require_xml_query.attrValue(object, "xlink:href");
+	const href = rawHref === void 0 ? void 0 : normaliseObjectHref(rawHref);
+	if (href === void 0) return;
+	const subPackage = require_typed_odb_subdocument.subDocumentPackage(pkg, href, { allowMissingContent: true });
+	const contentPart = subPackage.parts[CONTENT_PART];
+	if (contentPart?.kind !== "xml") return;
+	const root = require_xml_query.rootElement(contentPart.nodes);
+	const body = root === void 0 ? void 0 : require_xml_query.findChildElement(root.children, "office:body");
+	const bodyChild = body === void 0 ? void 0 : require_xml_query.rootElement(body.children);
+	const objectKind = bodyChild === void 0 ? void 0 : embeddedKindFor(bodyChild.tag);
+	if (objectKind === void 0) return;
+	return {
+		objectKind,
+		package: subPackage,
+		href
+	};
+}
+//#endregion
+exports.readDrawObjectReference = readDrawObjectReference;

package/dist/typed/draw/embedded.d.cts

@@ -0,0 +1,13 @@
+import { l as XmlElement } from "../../node-CkBWRjNR.cjs";
+import { Package } from "../../model/package.cjs";
+import { ContentEmbeddedObjectKind } from "document-schema.js";
+//#region src/typed/draw/embedded.d.ts
+type EmbeddedDocumentKind = Extract<ContentEmbeddedObjectKind, 'wordprocessing' | 'presentation' | 'spreadsheet' | 'drawing'>;
+interface EmbeddedDrawObject {
+  objectKind: EmbeddedDocumentKind;
+  package: Package;
+  href: string;
+}
+declare function readDrawObjectReference(frame: XmlElement, pkg: Package): EmbeddedDrawObject | undefined;
+//#endregion
+export { EmbeddedDocumentKind, EmbeddedDrawObject, readDrawObjectReference };

package/dist/typed/draw/embedded.d.ts

@@ -0,0 +1,13 @@
+import { l as XmlElement } from "../../node-CkBWRjNR.js";
+import { Package } from "../../model/package.js";
+import { ContentEmbeddedObjectKind } from "document-schema.js";
+//#region src/typed/draw/embedded.d.ts
+type EmbeddedDocumentKind = Extract<ContentEmbeddedObjectKind, 'wordprocessing' | 'presentation' | 'spreadsheet' | 'drawing'>;
+interface EmbeddedDrawObject {
+  objectKind: EmbeddedDocumentKind;
+  package: Package;
+  href: string;
+}
+declare function readDrawObjectReference(frame: XmlElement, pkg: Package): EmbeddedDrawObject | undefined;
+//#endregion
+export { EmbeddedDocumentKind, EmbeddedDrawObject, readDrawObjectReference };

package/dist/typed/draw/embedded.js

@@ -0,0 +1,41 @@
+import { attrValue, childrenWithTag, findChildElement, rootElement } from "../../xml/query.js";
+import { subDocumentPackage } from "../odb/subdocument.js";
+//#region src/typed/draw/embedded.ts
+const CONTENT_PART = "content.xml";
+function embeddedKindFor(bodyChildTag) {
+	switch (bodyChildTag) {
+		case "office:text": return "wordprocessing";
+		case "office:spreadsheet": return "spreadsheet";
+		case "office:presentation": return "presentation";
+		case "office:drawing": return "drawing";
+		default: return;
+	}
+}
+function normaliseObjectHref(raw) {
+	const withoutPrefix = raw.startsWith("./") ? raw.slice(2) : raw;
+	const trimmed = withoutPrefix.endsWith("/") ? withoutPrefix.slice(0, -1) : withoutPrefix;
+	if (trimmed.length === 0 || trimmed.startsWith("..") || trimmed.startsWith("/") || trimmed.includes("://")) return;
+	return trimmed;
+}
+function readDrawObjectReference(frame, pkg) {
+	const object = childrenWithTag(frame, "draw:object")[0];
+	if (object === void 0) return;
+	const rawHref = attrValue(object, "xlink:href");
+	const href = rawHref === void 0 ? void 0 : normaliseObjectHref(rawHref);
+	if (href === void 0) return;
+	const subPackage = subDocumentPackage(pkg, href, { allowMissingContent: true });
+	const contentPart = subPackage.parts[CONTENT_PART];
+	if (contentPart?.kind !== "xml") return;
+	const root = rootElement(contentPart.nodes);
+	const body = root === void 0 ? void 0 : findChildElement(root.children, "office:body");
+	const bodyChild = body === void 0 ? void 0 : rootElement(body.children);
+	const objectKind = bodyChild === void 0 ? void 0 : embeddedKindFor(bodyChild.tag);
+	if (objectKind === void 0) return;
+	return {
+		objectKind,
+		package: subPackage,
+		href
+	};
+}
+//#endregion
+export { readDrawObjectReference };

package/dist/typed/draw/shapes.cjs

@@ -4,6 +4,7 @@ const require_image_sniff = require("../../image/sniff.cjs");
 const require_typed_shared_units = require("../shared/units.cjs");
 const require_typed_shared_color = require("../shared/color.cjs");
 const require_xml_query = require("../../xml/query.cjs");
+const require_typed_shared_text = require("../shared/text.cjs");
 const require_typed_shared_geometry = require("../shared/geometry.cjs");
 const require_typed_shared_cascade = require("../shared/cascade.cjs");
 const require_typed_shared_paragraph = require("../shared/paragraph.cjs");
@@ -37,20 +38,31 @@ function readFrameInsets(frame, pkg) {
 	}
 	return insets;
 }
-function readDrawImageBlock(image, frameBox, pkg) {
+function readFrameAltText(frame) {
+	const title = require_xml_query.childrenWithTag(frame, "svg:title")[0];
+	const decodedTitle = title === void 0 ? void 0 : require_typed_shared_text.decodeOdfText(title);
+	if (decodedTitle !== void 0 && decodedTitle.length > 0) return decodedTitle;
+	const description = require_xml_query.childrenWithTag(frame, "svg:desc")[0];
+	const decodedDescription = description === void 0 ? void 0 : require_typed_shared_text.decodeOdfText(description);
+	return decodedDescription !== void 0 && decodedDescription.length > 0 ? decodedDescription : void 0;
+}
+function readDrawImageBlock(image, frame, frameBox, pkg) {
 	const href = require_xml_query.attrValue(image, "xlink:href");
 	const part = href === void 0 ? void 0 : pkg.parts[href];
 	if (part?.kind !== "binary") return;
 	const bytes = require_util_base64.base64ToBytes(part.base64);
 	const format = require_image_sniff.sniffImageFormat(bytes);
 	if (format === void 0) return;
-	return {
+	const block = {
 		kind: "image",
 		format,
 		base64: part.base64,
 		widthPt: frameBox.widthPt,
 		heightPt: frameBox.heightPt
 	};
+	const altText = readFrameAltText(frame);
+	if (altText !== void 0) block.altText = altText;
+	return block;
 }
 function readDrawFrameContent(frame, frameBox, pkg) {
 	const table = require_xml_query.childrenWithTag(frame, "table:table")[0];
@@ -59,7 +71,7 @@ function readDrawFrameContent(frame, frameBox, pkg) {
 	if (textBox !== void 0) return require_xml_query.elementsWithTag(textBox.children, "text:p").map((p) => require_typed_shared_paragraph.readOdfParagraph(p, pkg));
 	const image = require_xml_query.childrenWithTag(frame, "draw:image")[0];
 	if (image !== void 0) {
-		const block = readDrawImageBlock(image, frameBox, pkg);
+		const block = readDrawImageBlock(image, frame, frameBox, pkg);
 		return block === void 0 ? [] : [block];
 	}
 	return [];

package/dist/typed/draw/shapes.js

@@ -3,6 +3,7 @@ import { sniffImageFormat } from "../../image/sniff.js";
 import { parseOdfLength } from "../shared/units.js";
 import { parseOdfColor } from "../shared/color.js";
 import { attrValue, childrenWithTag, elementsWithTag } from "../../xml/query.js";
+import { decodeOdfText } from "../shared/text.js";
 import { parseLinePoints } from "../shared/geometry.js";
 import { resolveStyleElementChain } from "../shared/cascade.js";
 import { readOdfParagraph } from "../shared/paragraph.js";
@@ -36,20 +37,31 @@ function readFrameInsets(frame, pkg) {
 	}
 	return insets;
 }
-function readDrawImageBlock(image, frameBox, pkg) {
+function readFrameAltText(frame) {
+	const title = childrenWithTag(frame, "svg:title")[0];
+	const decodedTitle = title === void 0 ? void 0 : decodeOdfText(title);
+	if (decodedTitle !== void 0 && decodedTitle.length > 0) return decodedTitle;
+	const description = childrenWithTag(frame, "svg:desc")[0];
+	const decodedDescription = description === void 0 ? void 0 : decodeOdfText(description);
+	return decodedDescription !== void 0 && decodedDescription.length > 0 ? decodedDescription : void 0;
+}
+function readDrawImageBlock(image, frame, frameBox, pkg) {
 	const href = attrValue(image, "xlink:href");
 	const part = href === void 0 ? void 0 : pkg.parts[href];
 	if (part?.kind !== "binary") return;
 	const bytes = base64ToBytes(part.base64);
 	const format = sniffImageFormat(bytes);
 	if (format === void 0) return;
-	return {
+	const block = {
 		kind: "image",
 		format,
 		base64: part.base64,
 		widthPt: frameBox.widthPt,
 		heightPt: frameBox.heightPt
 	};
+	const altText = readFrameAltText(frame);
+	if (altText !== void 0) block.altText = altText;
+	return block;
 }
 function readDrawFrameContent(frame, frameBox, pkg) {
 	const table = childrenWithTag(frame, "table:table")[0];
@@ -58,7 +70,7 @@ function readDrawFrameContent(frame, frameBox, pkg) {
 	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);
+		const block = readDrawImageBlock(image, frame, frameBox, pkg);
 		return block === void 0 ? [] : [block];
 	}
 	return [];

package/dist/typed/odb/form.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_xml_entities = require("../../xml/entities.cjs");
 const require_xml_query = require("../../xml/query.cjs");
+const require_typed_odb_subdocument = require("./subdocument.cjs");
 const require_typed_odt_read = require("../odt/read.cjs");
 const require_typed_odb_read = require("./read.cjs");
-const require_typed_odb_subdocument = require("./subdocument.cjs");
 //#region src/typed/odb/form.ts
 const CONTENT_PART = "content.xml";
 const FORM_ELEMENT_TAG = "form:form";

package/dist/typed/odb/form.js

@@ -1,8 +1,8 @@
 import { decodeXmlText } from "../../xml/entities.js";
 import { attrValue, findChildElement, rootElement } from "../../xml/query.js";
+import { subDocumentPackage } from "./subdocument.js";
 import { readOdt } from "../odt/read.js";
 import { resolveOdbComponent } from "./read.js";
-import { subDocumentPackage } from "./subdocument.js";
 //#region src/typed/odb/form.ts
 const CONTENT_PART = "content.xml";
 const FORM_ELEMENT_TAG = "form:form";

package/dist/typed/odb/report.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_xml_entities = require("../../xml/entities.cjs");
 const require_xml_query = require("../../xml/query.cjs");
-const require_typed_odb_read = require("./read.cjs");
 const require_typed_odb_subdocument = require("./subdocument.cjs");
+const require_typed_odb_read = require("./read.cjs");
 //#region src/typed/odb/report.ts
 const CONTENT_PART = "content.xml";
 const GROUP_TAG = "rpt:group";

package/dist/typed/odb/report.js

@@ -1,7 +1,7 @@
 import { decodeXmlText } from "../../xml/entities.js";
 import { attrValue, findChildElement, rootElement } from "../../xml/query.js";
-import { resolveOdbComponent } from "./read.js";
 import { subDocumentPackage } from "./subdocument.js";
+import { resolveOdbComponent } from "./read.js";
 //#region src/typed/odb/report.ts
 const CONTENT_PART = "content.xml";
 const GROUP_TAG = "rpt:group";

package/dist/typed/ods/read.cjs

@@ -7,7 +7,13 @@ const require_typed_shared_cascade = require("../shared/cascade.cjs");
 const require_typed_shared_metadata = require("../shared/metadata.cjs");
 const require_typed_shared_paragraph = require("../shared/paragraph.cjs");
 const require_typed_shared_table = require("../shared/table.cjs");
+const require_typed_shared_transform = require("../shared/transform.cjs");
 const require_typed_shared_masterpage = require("../shared/masterpage.cjs");
+const require_typed_draw_shapes = require("../draw/shapes.cjs");
+const require_typed_draw_embedded = require("../draw/embedded.cjs");
+const require_typed_odp_read = require("../odp/read.cjs");
+const require_typed_odt_read = require("../odt/read.cjs");
+const require_typed_odg_read = require("../odg/read.cjs");
 let document_schema_js = require("document-schema.js");
 //#region src/typed/ods/read.ts
 const CONTENT_PART = "content.xml";
@@ -156,10 +162,84 @@ function parseNonNegativeInteger(value) {
 	const parsed = Number.parseInt(value, 10);
 	return Number.isInteger(parsed) && parsed >= 0 ? parsed : void 0;
 }
+function readEmbeddedObjectDocument(reference) {
+	switch (reference.objectKind) {
+		case "wordprocessing": {
+			const { metadata, sections } = require_typed_odt_read.readOdt(reference.package);
+			return {
+				kind: "wordprocessing",
+				formatVersion: document_schema_js.CONTENT_FORMAT_VERSION,
+				metadata,
+				sections
+			};
+		}
+		case "presentation": {
+			const { metadata, slides } = require_typed_odp_read.readOdp(reference.package);
+			return {
+				kind: "presentation",
+				formatVersion: document_schema_js.CONTENT_FORMAT_VERSION,
+				metadata,
+				slides
+			};
+		}
+		case "drawing": {
+			const { metadata, pages } = require_typed_odg_read.readOdg(reference.package);
+			return {
+				kind: "drawing",
+				formatVersion: document_schema_js.CONTENT_FORMAT_VERSION,
+				metadata,
+				pages
+			};
+		}
+		case "spreadsheet": {
+			const { metadata, sheets } = readOds(reference.package);
+			return {
+				kind: "spreadsheet",
+				formatVersion: document_schema_js.CONTENT_FORMAT_VERSION,
+				metadata,
+				sheets
+			};
+		}
+	}
+}
+function collectAnchoredFrame(frameElement, groupFunctions, pkg, anchorRow, anchorColumn, images, embeddedObjects) {
+	const shape = require_typed_draw_shapes.readDrawFrame(frameElement, groupFunctions, pkg);
+	if (shape === void 0) return;
+	const reference = require_typed_draw_embedded.readDrawObjectReference(frameElement, pkg);
+	if (reference !== void 0) {
+		embeddedObjects.push({
+			objectKind: reference.objectKind,
+			document: readEmbeddedObjectDocument(reference),
+			frame: shape.frame
+		});
+		return;
+	}
+	for (const block of shape.blocks) if (block.kind === "image") images.push({
+		...block,
+		anchorRow,
+		anchorColumn,
+		offsetXPt: shape.frame.xPt,
+		offsetYPt: shape.frame.yPt
+	});
+}
+function collectAnchoredFrames(children, groupFunctions, pkg, anchorRow, anchorColumn, images, embeddedObjects) {
+	for (const child of children) {
+		if (child.type !== "element") continue;
+		if (child.tag === "draw:frame") collectAnchoredFrame(child, groupFunctions, pkg, anchorRow, anchorColumn, images, embeddedObjects);
+		else if (child.tag === "draw:g") {
+			const ownValue = require_xml_query.attrValue(child, "draw:transform");
+			const ownFunctions = ownValue === void 0 ? [] : require_typed_shared_transform.parseOdfTransform(ownValue);
+			const nested = ownFunctions.length === 0 ? groupFunctions : [...ownFunctions, ...groupFunctions];
+			collectAnchoredFrames(child.children, nested, pkg, anchorRow, anchorColumn, images, embeddedObjects);
+		}
+	}
+}
 function readTable(tableElement, pkg) {
 	const columns = [];
 	const rows = [];
 	const cells = [];
+	const images = [];
+	const embeddedObjects = [];
 	const manualBreakRows = [];
 	const manualBreakColumns = [];
 	let repeatColumns;
@@ -184,6 +264,7 @@ function readTable(tableElement, pkg) {
 				const columnIndex = cursor.columnIndex;
 				const rowIndex = cursor.rowIndex;
 				cursor.nextCell(readRepeatCount(child, "table:number-columns-repeated"));
+				collectAnchoredFrames(child.children, [], pkg, rowIndex, columnIndex, images, embeddedObjects);
 				const formula = require_xml_query.attrValue(child, "table:formula");
 				const { runs, displayText } = readCellText(child, pkg);
 				if (!(require_xml_query.attrValue(child, "office:value-type") !== void 0) && formula === void 0 && displayText.length === 0) continue;
@@ -225,7 +306,8 @@ function readTable(tableElement, pkg) {
 	}
 	for (const child of tableElement.children) {
 		if (child.type !== "element") continue;
-		if (child.tag === "table:table-column") processColumn(child);
+		if (child.tag === "table:shapes") collectAnchoredFrames(child.children, [], pkg, 0, 0, images, embeddedObjects);
+		else if (child.tag === "table:table-column") processColumn(child);
 		else if (child.tag === "table:table-header-columns") {
 			const startIndex = columnCursor;
 			for (const headerChild of child.children) if (headerChild.type === "element" && headerChild.tag === "table:table-column") processColumn(headerChild);
@@ -247,6 +329,8 @@ function readTable(tableElement, pkg) {
 		columns,
 		rows,
 		cells,
+		images,
+		embeddedObjects,
 		repeatColumns,
 		repeatRows,
 		manualBreakRows,
@@ -296,15 +380,17 @@ function readPrintSettings(tableElement, pkg, repeatColumns, repeatRows, manualB
 function readSheet(tableElement, pkg) {
 	const name = require_xml_query.attrValue(tableElement, "table:name");
 	if (name === void 0) return;
-	const { columns, rows, cells, repeatColumns, repeatRows, manualBreakRows, manualBreakColumns } = readTable(tableElement, pkg);
-	return {
+	const { columns, rows, cells, images, embeddedObjects, repeatColumns, repeatRows, manualBreakRows, manualBreakColumns } = readTable(tableElement, pkg);
+	const sheet = {
 		name,
 		cells,
 		columns,
 		rows,
-		images: [],
+		images,
 		printSettings: readPrintSettings(tableElement, pkg, repeatColumns, repeatRows, manualBreakRows, manualBreakColumns)
 	};
+	if (embeddedObjects.length > 0) sheet.embeddedObjects = embeddedObjects;
+	return sheet;
 }
 function readOds(pkg) {
 	const contentPart = pkg.parts[CONTENT_PART];

package/dist/typed/ods/read.js

@@ -6,8 +6,14 @@ import { findStyleElement, resolveStyleElementChain } from "../shared/cascade.js
 import { readOdfMetadata } from "../shared/metadata.js";
 import { readOdfParagraph } from "../shared/paragraph.js";
 import { readCellStyleDecoration } from "../shared/table.js";
+import { parseOdfTransform } from "../shared/transform.js";
 import { resolvePageLayoutProperties } from "../shared/masterpage.js";
-import { PAGE_SIZE_A4 } from "document-schema.js";
+import { readDrawFrame } from "../draw/shapes.js";
+import { readDrawObjectReference } from "../draw/embedded.js";
+import { readOdp } from "../odp/read.js";
+import { readOdt } from "../odt/read.js";
+import { readOdg } from "../odg/read.js";
+import { CONTENT_FORMAT_VERSION, PAGE_SIZE_A4 } from "document-schema.js";
 //#region src/typed/ods/read.ts
 const CONTENT_PART = "content.xml";
 function parseKnownOdfLength(value) {
@@ -155,10 +161,84 @@ function parseNonNegativeInteger(value) {
 	const parsed = Number.parseInt(value, 10);
 	return Number.isInteger(parsed) && parsed >= 0 ? parsed : void 0;
 }
+function readEmbeddedObjectDocument(reference) {
+	switch (reference.objectKind) {
+		case "wordprocessing": {
+			const { metadata, sections } = readOdt(reference.package);
+			return {
+				kind: "wordprocessing",
+				formatVersion: CONTENT_FORMAT_VERSION,
+				metadata,
+				sections
+			};
+		}
+		case "presentation": {
+			const { metadata, slides } = readOdp(reference.package);
+			return {
+				kind: "presentation",
+				formatVersion: CONTENT_FORMAT_VERSION,
+				metadata,
+				slides
+			};
+		}
+		case "drawing": {
+			const { metadata, pages } = readOdg(reference.package);
+			return {
+				kind: "drawing",
+				formatVersion: CONTENT_FORMAT_VERSION,
+				metadata,
+				pages
+			};
+		}
+		case "spreadsheet": {
+			const { metadata, sheets } = readOds(reference.package);
+			return {
+				kind: "spreadsheet",
+				formatVersion: CONTENT_FORMAT_VERSION,
+				metadata,
+				sheets
+			};
+		}
+	}
+}
+function collectAnchoredFrame(frameElement, groupFunctions, pkg, anchorRow, anchorColumn, images, embeddedObjects) {
+	const shape = readDrawFrame(frameElement, groupFunctions, pkg);
+	if (shape === void 0) return;
+	const reference = readDrawObjectReference(frameElement, pkg);
+	if (reference !== void 0) {
+		embeddedObjects.push({
+			objectKind: reference.objectKind,
+			document: readEmbeddedObjectDocument(reference),
+			frame: shape.frame
+		});
+		return;
+	}
+	for (const block of shape.blocks) if (block.kind === "image") images.push({
+		...block,
+		anchorRow,
+		anchorColumn,
+		offsetXPt: shape.frame.xPt,
+		offsetYPt: shape.frame.yPt
+	});
+}
+function collectAnchoredFrames(children, groupFunctions, pkg, anchorRow, anchorColumn, images, embeddedObjects) {
+	for (const child of children) {
+		if (child.type !== "element") continue;
+		if (child.tag === "draw:frame") collectAnchoredFrame(child, groupFunctions, pkg, anchorRow, anchorColumn, images, embeddedObjects);
+		else if (child.tag === "draw:g") {
+			const ownValue = attrValue(child, "draw:transform");
+			const ownFunctions = ownValue === void 0 ? [] : parseOdfTransform(ownValue);
+			const nested = ownFunctions.length === 0 ? groupFunctions : [...ownFunctions, ...groupFunctions];
+			collectAnchoredFrames(child.children, nested, pkg, anchorRow, anchorColumn, images, embeddedObjects);
+		}
+	}
+}
 function readTable(tableElement, pkg) {
 	const columns = [];
 	const rows = [];
 	const cells = [];
+	const images = [];
+	const embeddedObjects = [];
 	const manualBreakRows = [];
 	const manualBreakColumns = [];
 	let repeatColumns;
@@ -183,6 +263,7 @@ function readTable(tableElement, pkg) {
 				const columnIndex = cursor.columnIndex;
 				const rowIndex = cursor.rowIndex;
 				cursor.nextCell(readRepeatCount(child, "table:number-columns-repeated"));
+				collectAnchoredFrames(child.children, [], pkg, rowIndex, columnIndex, images, embeddedObjects);
 				const formula = attrValue(child, "table:formula");
 				const { runs, displayText } = readCellText(child, pkg);
 				if (!(attrValue(child, "office:value-type") !== void 0) && formula === void 0 && displayText.length === 0) continue;
@@ -224,7 +305,8 @@ function readTable(tableElement, pkg) {
 	}
 	for (const child of tableElement.children) {
 		if (child.type !== "element") continue;
-		if (child.tag === "table:table-column") processColumn(child);
+		if (child.tag === "table:shapes") collectAnchoredFrames(child.children, [], pkg, 0, 0, images, embeddedObjects);
+		else if (child.tag === "table:table-column") processColumn(child);
 		else if (child.tag === "table:table-header-columns") {
 			const startIndex = columnCursor;
 			for (const headerChild of child.children) if (headerChild.type === "element" && headerChild.tag === "table:table-column") processColumn(headerChild);
@@ -246,6 +328,8 @@ function readTable(tableElement, pkg) {
 		columns,
 		rows,
 		cells,
+		images,
+		embeddedObjects,
 		repeatColumns,
 		repeatRows,
 		manualBreakRows,
@@ -295,15 +379,17 @@ function readPrintSettings(tableElement, pkg, repeatColumns, repeatRows, manualB
 function readSheet(tableElement, pkg) {
 	const name = attrValue(tableElement, "table:name");
 	if (name === void 0) return;
-	const { columns, rows, cells, repeatColumns, repeatRows, manualBreakRows, manualBreakColumns } = readTable(tableElement, pkg);
-	return {
+	const { columns, rows, cells, images, embeddedObjects, repeatColumns, repeatRows, manualBreakRows, manualBreakColumns } = readTable(tableElement, pkg);
+	const sheet = {
 		name,
 		cells,
 		columns,
 		rows,
-		images: [],
+		images,
 		printSettings: readPrintSettings(tableElement, pkg, repeatColumns, repeatRows, manualBreakRows, manualBreakColumns)
 	};
+	if (embeddedObjects.length > 0) sheet.embeddedObjects = embeddedObjects;
+	return sheet;
 }
 function readOds(pkg) {
 	const contentPart = pkg.parts[CONTENT_PART];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "odf.js",
-  "version": "2.0.0",
+  "version": "2.1.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": {