odf.js 5.5.2 → 6.1.0

package/README.md

@@ -6,7 +6,7 @@
 
 `odf.js` is the ODF sibling of [`ooxml.js`](../ooxml.js/README.md), mirroring its architecture: a lossless ZIP-of-XML core that round-trips any package byte-for-content-faithful, with typed readers layered on top. Two ODF-specific differences shape the design: ODF has no relationship mechanism (inter-part references are direct paths, with an exhaustive `META-INF/manifest.xml`), and ODF has no inline/direct formatting — every formatting difference must be a named "automatic style," so `odf.js` owns a style-interning subsystem (`src/styles/`) with no OOXML equivalent.
 
-**This package does not depend on `ooxml.js`.** `ooxml.js`'s branding and SBOM are scoped to ECMA-376/OOXML; depending on it would be the wrong signal for an OASIS-standard codec and would force a breaking `ooxml.js` release for every ODF-only fix. The small generic ZIP/XML/`Package` layer is duplicated, kept structurally identical so TypeScript's structural typing makes both packages' values interchangeable for a shared consumer like `documents.js`. Both depend on [`document-schema.js`](../document-schema.js/README.md) for the genuinely identical `ContentDocument`/`DocumentPackage` content model.
+**This package does not depend on `ooxml.js`.** `ooxml.js`'s branding and SBOM are scoped to ECMA-376/OOXML; depending on it would be the wrong signal for an OASIS-standard codec and would force a breaking `ooxml.js` release for every ODF-only fix. The small generic ZIP/XML/`Package` layer is duplicated, kept structurally identical so TypeScript's structural typing makes both packages' values interchangeable for a shared consumer like `documents.js`. Both depend on [`document-schema.js`](../document-schema.js/README.md) for the genuinely identical `ContentDocument`/`DocumentTree` content model.
 
 ```mermaid
 graph TD
@@ -58,12 +58,12 @@ Under active development. 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` and the mimetype part's mandatory first-entry/stored/uncompressed layout.
 - **Style interning** (`src/styles/`) — `StyleRegistry` adopts existing automatic styles, finds-or-mints on `intern()`, fingerprints on canonical serialized properties (never `JSON.stringify`), collision-checked across all four style containers.
 - **Shared typed primitives** (`src/typed/shared/`) — unit parsing, A1 cell-reference computation with repeat-count cursor advancement, colour/geometry/master-page parsing into `document-schema.js` types, whitespace-run decoding, the read-side style cascade, shared `readOdfParagraph`/`readOdfTable`, the `draw:transform`/`draw:g` group-flattening geometry resolver, an `svg:d`/`draw:points` path parser, and `meta.xml` reading.
-- **Typed readers, at two levels** — `readOdt`/`readOdp`/`readOdg`/`readOds`/`readOdfFormula` resolve a `Package` into a `document-schema.js` **`DocumentPackage`**: the single hierarchical artefact, with a minted styles table. Beneath each sits its `*Content` sibling (`readOdtContent`, `readOdpContent`, `readOdgContent`, `readOdsContent`, `readOdfFormulaContent`) producing the flat `ContentDocument`-level shape instead. See [Reading a document](#reading-a-document).
+- **Typed readers, at two levels** — `readOdt`/`readOdp`/`readOdg`/`readOds`/`readOdfFormula` resolve a `Package` into a `document-schema.js` **`DocumentTree`**: the single hierarchical artefact, with a minted styles table. Beneath each sits its `*Content` sibling (`readOdtContent`, `readOdpContent`, `readOdgContent`, `readOdsContent`, `readOdfFormulaContent`) producing the flat `ContentDocument`-level shape instead. See [Reading a document](#reading-a-document).
 - **What each reader actually covers** — wordprocessing (`readOdt`), presentation (`readOdp`), drawing (`readOdg`: vector primitives in `draw:z-index`-aware paint order), spreadsheet (`readOds`: every `office:value-type`, cell/page-anchored images, and embedded sub-documents including charts), each expressed in `document-schema.js`'s own `ContentSection`/`ContentSlide`/`ContentDrawPage`/`ContentSheet` vocabulary — plus the fidelity construct vocabulary in `readOdt` (fields including the cross-reference displays, bookmarks and reference-marks, tracked changes, notes, annotations, divisions, index wrappers, forms, and anchored frames; see [Fidelity constructs](#fidelity-constructs)).
-- **`readOdfFormulaMathMl`** — resolves a standalone/embedded `.odf` formula's bare-MathML `content.xml` into raw MathML nodes plus a StarMath annotation, with no pivot shaping at all. **`readOdfFormulaContent`** wraps that into a real `'formula'`-kind `ContentDocument`, and **`readOdfFormula`** into a `DocumentPackage`.
+- **`readOdfFormulaMathMl`** — resolves a standalone/embedded `.odf` formula's bare-MathML `content.xml` into raw MathML nodes plus a StarMath annotation, with no pivot shaping at all. **`readOdfFormulaContent`** wraps that into a real `'formula'`-kind `ContentDocument`, and **`readOdfFormula`** into a `DocumentTree`.
 - **`readOdm`** — resolves a `.odm` master document into an ordered list of chapter references (`{ name, href, filterName? }`); chapters are genuinely external `.odt` files by ODF design, never cached.
-- **`readOdbInventory`** — resolves a `.odb` into connection info, table names, query definitions (`{ name, command, escapeProcessing? }` with real SQL text), and form/report `{ name, href }` pairs. A sub-document directory is named after an opaque *persistent* name (`forms/Obj11`), not the user-visible name.
-- **`readOdbForm`/`readOdbReport`** — extract one sub-document's *static structure*, executing nothing: a form's control tree and data bindings, or a report's band stack, recursive group tree, bound fields, and computed expressions.
+- **`readOdbInventory`** — resolves a `.odb` into connection info, table names, query definitions (`{ name, command, escapeProcessing? }` with real SQL text), and form/report `{ name, href }` pairs. A sub-document directory is named after an opaque _persistent_ name (`forms/Obj11`), not the user-visible name.
+- **`readOdbForm`/`readOdbReport`** — extract one sub-document's _static structure_, executing nothing: a form's control tree and data bindings, or a report's band stack, recursive group tree, bound fields, and computed expressions.
 
 Not yet built: live-view editors and the `.odb` database-table-export subsystem. A general-purpose SQL query engine for rendering a Report against its data is **deliberately not attempted** — building even a bounded SQL engine means reimplementing HSQLDB's/Firebird's query semantics, a materially different undertaking from decoding their file formats, with unreviewed licensing questions. Gated on the requesting engineer's explicit sign-off.
 
@@ -99,70 +99,70 @@ To run a single test file: `pnpm vitest run src/path/to/file.test.ts`.
 
 ### Reading a document
 
-A typed reader takes a `Package` (bytes go through `decodePackage`/`parsePackage` first) and returns a [`DocumentPackage`](../document-schema.js/README.md#the-package-tree) — `document-schema.js`'s single hierarchical artefact, where structure, layout, and content are fused in one tree and a `styles` table has already been minted over it:
+A typed reader takes a `Package` (bytes go through `decodePackage`/`parsePackage` first) and returns a [`DocumentTree`](../document-schema.js/README.md#the-package-tree) — `document-schema.js`'s single hierarchical artefact, where structure, layout, and content are fused in one tree and a `styles` table has already been minted over it:
 
 ```ts
-import { decodePackage, readOdt } from 'odf.js';
+import { decodePackage, readOdt } from "odf.js";
 
 const pkg = decodePackage(new Uint8Array(await file.arrayBuffer()));
 const document = readOdt(pkg);
 
-document.kind;      // 'wordprocessing'
-document.metadata;  // title, author, keywords, ... from meta.xml
-document.children;  // one section group per ContentSection, headings and lists grouped inside it
-document.styles;    // the minted styles table the tree's `style` refs name
+document.kind; // 'wordprocessing'
+document.metadata; // title, author, keywords, ... from meta.xml
+document.children; // one section group per ContentSection, headings and lists grouped inside it
+document.styles; // the minted styles table the tree's `style` refs name
 ```
 
-One reader per format, each returning the `DocumentPackage` arm its format produces:
+One reader per format, each returning the `DocumentTree` arm its format produces:
 
-| Format | Reader | Package kind |
-| --- | --- | --- |
-| `.odt` | `readOdt` | `wordprocessing` |
-| `.odp` | `readOdp` | `presentation` |
-| `.ods` | `readOds` | `spreadsheet` |
-| `.odg` | `readOdg` | `drawing` |
-| `.odf` | `readOdfFormula` | `formula` |
+| Format | Reader           | Package kind     |
+| ------ | ---------------- | ---------------- |
+| `.odt` | `readOdt`        | `wordprocessing` |
+| `.odp` | `readOdp`        | `presentation`   |
+| `.ods` | `readOds`        | `spreadsheet`    |
+| `.odg` | `readOdg`        | `drawing`        |
+| `.odf` | `readOdfFormula` | `formula`        |
 
-Each is assembled through `document-schema.js`'s own `assemblePackage`, so odf.js's packages are built exactly the way every other package construction site in this family builds one. No `pages` array is populated and no node carries `frames`: a reader runs before any layout pass, and rendered page geometry is a layout engine's to report, never a reader's to invent.
+Each is assembled through `document-schema.js`'s own `assembleTree`, so odf.js's packages are built exactly the way every other package construction site in this family builds one. No `pages` array is populated and no node carries `frames`: a reader runs before any layout pass, and rendered page geometry is a layout engine's to report, never a reader's to invent.
 
 ### The flat `ContentDocument` level
 
 Beneath each package-native reader sits the flat reader it is built on, unchanged in behaviour and exported under a `*Content` name. Reach for these when you work in `document-schema.js`'s flat codec-exchange form — as `documents.js`'s own conversion pipeline does — rather than in the tree:
 
 ```ts
-import { readOdsContent, readOdfFormulaMathMl } from 'odf.js';
+import { readOdsContent, readOdfFormulaMathMl } from "odf.js";
 
-const { metadata, sheets } = readOdsContent(pkg);   // the flat ContentSheet[] shape, no tree, no styles table
+const { metadata, sheets } = readOdsContent(pkg); // the flat ContentSheet[] shape, no tree, no styles table
 const { mathml, starMath } = readOdfFormulaMathMl(formulaPkg); // rawest of all: MathML nodes and the StarMath annotation
 ```
 
 `readOdtContent`/`readOdpContent`/`readOdgContent`/`readOdsContent` return `{ metadata, sections | slides | pages | sheets }`; `readOdfFormulaContent` returns a whole `'formula'`-kind `ContentDocument`; `readOdfFormulaMathMl` returns the raw MathML with no pivot shaping at all. A package-native reader calls its own `*Content` sibling and reshapes that result, so the two levels are one read and can never disagree about what the file says.
 
-Crossing between the levels is `document-schema.js`'s job, not this package's: `flattenPackage(readOdt(pkg))` reproduces exactly what `readOdtContent(pkg)` returns, wrapped in its `ContentDocument` envelope. That equality is pinned per format against real fixture bytes in this package's own test suites.
+Crossing between the levels is `document-schema.js`'s job, not this package's: `flattenTree(readOdt(pkg))` reproduces exactly what `readOdtContent(pkg)` returns, wrapped in its `ContentDocument` envelope. That equality is pinned per format against real fixture bytes in this package's own test suites.
 
 ### The primary names moved — migrating from 4.x
 
 Every bare `readOdX` name now belongs to the package-native reader. Callers of the old flat functions rename; nothing about those functions' behaviour changed:
 
-| 4.x | 5.0 | Returns |
-| --- | --- | --- |
-| `readOdt` | `readOdtContent` | `OdtDocument` |
-| `readOdp` | `readOdpContent` | `OdpDocument` |
-| `readOdg` | `readOdgContent` | `OdgDocument` |
-| `readOds` | `readOdsContent` | `OdsDocument` |
-| `readOdfFormulaDocument` | `readOdfFormulaContent` | `ContentDocument` |
-| `readOdfFormula` | `readOdfFormulaMathMl` | `OdfFormulaDocument` |
+| 4.x                      | 5.0                     | Returns              |
+| ------------------------ | ----------------------- | -------------------- |
+| `readOdt`                | `readOdtContent`        | `OdtDocument`        |
+| `readOdp`                | `readOdpContent`        | `OdpDocument`        |
+| `readOdg`                | `readOdgContent`        | `OdgDocument`        |
+| `readOds`                | `readOdsContent`        | `OdsDocument`        |
+| `readOdfFormulaDocument` | `readOdfFormulaContent` | `ContentDocument`    |
+| `readOdfFormula`         | `readOdfFormulaMathMl`  | `OdfFormulaDocument` |
 
-The rename is a compile error at every call site, never a silent behaviour change: each new bare name returns a `DocumentPackage`, which is assignable to none of the old return types.
+The rename is a compile error at every call site, never a silent behaviour change: each new bare name returns a `DocumentTree`, which is assignable to none of the old return types.
 
-`readOdm`, `readOdbInventory`, `readOdbForm`, and `readOdbReport` are untouched, and none gains a package-native form. `readOdm`'s chapters are external file references and `readOdbInventory`/`readOdbReport` describe structure rather than content, so none of those three has a `ContentDocument` to decompose. `readOdbForm` is the exception that proves the rule rather than a fourth case of it: a form's sub-document is a complete, ordinary ODF text document, so `readOdbForm` does call `readOdtContent` on it and does return an `OdtDocument` — but that document is one component nested inside the form's own control-tree result, not the function's own top-level return value, so there is no `DocumentPackage`-native `readOdbForm` to add without changing what the function returns altogether.
+`readOdm`, `readOdbInventory`, `readOdbForm`, and `readOdbReport` are untouched, and none gains a package-native form. `readOdm`'s chapters are external file references and `readOdbInventory`/`readOdbReport` describe structure rather than content, so none of those three has a `ContentDocument` to decompose. `readOdbForm` is the exception that proves the rule rather than a fourth case of it: a form's sub-document is a complete, ordinary ODF text document, so `readOdbForm` does call `readOdtContent` on it and does return an `OdtDocument` — but that document is one component nested inside the form's own control-tree result, not the function's own top-level return value, so there is no `DocumentTree`-native `readOdbForm` to add without changing what the function returns altogether.
 
 ### The lossless core
 
 The ZIP-of-XML layer every reader above is built on:
 
 ```ts
-import { decodePackage, encodePackage } from 'odf.js';
+import { decodePackage, encodePackage } from "odf.js";
 
 // .odt / .ods / .odp bytes -> faithful JSON Package
 const pkg = decodePackage(new Uint8Array(await file.arrayBuffer()));
@@ -176,10 +176,15 @@ const bytes = encodePackage(pkg);
 Manifest and mimetype, ODF's own package-identity mechanism (no relationships, unlike OOXML):
 
 ```ts
-import { readManifest, syncManifest, setDocumentMediaType, readMimetype } from 'odf.js';
+import {
+  readManifest,
+  syncManifest,
+  setDocumentMediaType,
+  readMimetype,
+} from "odf.js";
 
 const manifest = readManifest(pkg); // { entries: [{ fullPath, mediaType }, ...] }
-setDocumentMediaType(pkg, 'application/vnd.oasis.opendocument.text'); // updates mimetype + manifest root entry atomically
+setDocumentMediaType(pkg, "application/vnd.oasis.opendocument.text"); // updates mimetype + manifest root entry atomically
 syncManifest(pkg); // rebuilds manifest.xml to exactly match pkg's current parts
 readMimetype(pkg); // 'application/vnd.oasis.opendocument.text'
 ```
@@ -189,9 +194,9 @@ readMimetype(pkg); // 'application/vnd.oasis.opendocument.text'
 Every module is also importable directly by its own subpath, without going through the barrel:
 
 ```ts
-import { parseOdfLength } from 'odf.js/typed/shared/units';
+import { parseOdfLength } from "odf.js/typed/shared/units";
 
-parseOdfLength('2.5cm'); // 70.86614173228347
+parseOdfLength("2.5cm"); // 70.86614173228347
 ```
 
 Any `src/**/*.ts` module (excluding tests and `test-support/` fixtures) resolves at its path relative to `src/` — `src/manifest.ts` as `odf.js/manifest`, `src/typed/odt/read.ts` as `odf.js/typed/odt/read`, and so on.
@@ -203,7 +208,7 @@ Layered from a lossless core outward, mirroring `ooxml.js`:
 - **`src/model/`** — `Package`/`XmlNode`/`XmlElement`: a duplicate-by-design copy of `ooxml.js`'s equivalent.
 - **`src/xml/`** — XML parse/build (`fast-xml-parser`), production element/text-node construction, entity encoding, and tree-query helpers.
 - **`src/image/`** — `sniffImageFormat`: a PNG/JPEG magic-byte sniffer consumed by `src/manifest.ts` and `src/typed/draw/shapes.ts`.
-- **`src/zip.ts`** — takes *ordered* `[path, entry]` tuples, not a `Record`, so the mimetype-first/stored/uncompressed requirement doesn't depend on insertion order surviving a Zod round trip.
+- **`src/zip.ts`** — takes _ordered_ `[path, entry]` tuples, not a `Record`, so the mimetype-first/stored/uncompressed requirement doesn't depend on insertion order surviving a Zod round trip.
 - **`src/package-io/`** — `write.ts` hoists `mimetype` first (stored) and `META-INF/manifest.xml` second if present; never fabricates either as a side effect.
 - **`src/manifest.ts`** — full manifest read/write; the manifest is ODF's one mandatory part, unlike `ooxml.js`'s read-only OPC-relationship stance.
 - **`src/styles/`** — `properties.ts`/`serialize.ts` (canonical property-bag ↔ XML attributes), `registry.ts` (`StyleRegistry`, the mandatory style-interning layer), `span.ts` (character-range `text:span` wrapping).
@@ -224,7 +229,7 @@ Layered from a lossless core outward, mirroring `ooxml.js`:
 
 - **Several ODF namespace URIs are not what you'd guess from the prefix.** `draw:` is `...drawing:1.0`, `number:` is `...datastyle:1.0`, `fo:`/`svg:`/`smil:` are `*-compatible:1.0`. See `src/ns.ts`.
 - **`.odb`'s media type is `application/vnd.oasis.opendocument.base`**, not `...database`.
-- **`dc:creator` records whoever most recently *saved* the document, not the author** — the original author is `meta:initial-creator`.
+- **`dc:creator` records whoever most recently _saved_ the document, not the author** — the original author is `meta:initial-creator`.
 - **`meta:keyword` appears once per keyword**, unlike OOXML's single comma-separated `cp:keywords`.
 - **`table:number-columns-repeated`/`-rows-repeated` must be cursor-advanced, never materialized** — real sheets have trailing repeat counts over a million.
 - **ODF cells carry no explicit cell-reference attribute** (unlike xlsx's `r="B7"`) — `typed/shared/a1.ts` computes references from a running cursor.
@@ -233,7 +238,7 @@ Layered from a lossless core outward, mirroring `ooxml.js`:
 - **`svg:fill-rule` and `draw:stroke` map onto `ContentVector.fillRule`/`ContentStroke.style`.** A dotted pattern and `"double"` stroke have no ODF vector-stroke counterpart and remain unread.
 - **`readOdsContent`/`readTableCell` resolve cell `background`/`borders`/`alignment`/`verticalAlignment` from the real style cascade.** An explicit `fo:border-*` of `"none"`/`"hidden"` clears an inherited edge.
 - **`readOdsContent` reads sheet-anchored drawings** — cell-anchored `draw:frame`s (coordinates relative to the cell) and page-anchored ones (in `table:shapes`). An embedded chart resolves as a `chart`-kind object whose document is a frame-sized drawing page carrying the chart's own cached data table, with the `chart:chart` element quarantined in residue. A sheet cannot carry a floating text box or bare vector; each is skipped.
-- **`readDrawObjectReference` resolves a frame's embedded sub-document kind from its own `content.xml`, not the manifest.** A `draw:object` must be checked *before* the frame's preview image, since an embedded-object frame also carries a preview `draw:image`.
+- **`readDrawObjectReference` resolves a frame's embedded sub-document kind from its own `content.xml`, not the manifest.** A `draw:object` must be checked _before_ the frame's preview image, since an embedded-object frame also carries a preview `draw:image`.
 
 ## Fidelity constructs
 
@@ -250,7 +255,8 @@ Layered from a lossless core outward, mirroring `ooxml.js`:
 - **The quarantined residue rows** — inline no-analogue constructs (`text:ruby`, `text:meta`, a heading's `text:is-list-header` flag) quarantine on their own paragraph beside the style-chain unknowns; document-level tenants nothing else owns (`xforms:model`, DDE connection declarations and `text:dde-source` links, vendor-extension elements) quarantine at the package tier on `OdtDocument.source`; `table:calculation-settings` and vendor-extension elements (Calc writes its `calcext:conditional-formats` inside each `table:table`) do the same on `OdsDocument.source`; an odp slide's presentation extras — the transition attributes off the slide's own drawing-page style, where every ODF schema version and real Impress output put them (the legacy `presentation:transition-*`/`presentation:duration` spelling and the ODF 1.2 `smil:type`/`-subtype`/`-direction`/`-fadeColor` one), plus `presentation:sound` and `anim:` trees — and every format's unmapped shape kinds (`dr3d:scene`, `draw:connector`, `draw:measure`, applet/plugin/floating-frame) quarantine on their own slide/page; an unrecognised `draw:custom-shape` preset's whole `draw:enhanced-geometry` quarantines in the text shape it degrades to; and every non-content XML part (`settings.xml`, `META-INF/manifest.rdf`, `Configurations2/…`) quarantines at the package tier keyed by its part path — never an embedded sub-document's own `Object N/` parts, which the semantic channel already carries whole.
 
 Every read-side construct has no write-side counterpart because this package's typed layer is read-only — the honest asymmetry of a reader with no content writer; the lossless `encodePackage` layer remains the byte-fidelity tier.
-- **An embedded Math object in a spreadsheet cell reads as `objectKind: 'formula'`** — its `content.xml` root *is* the MathML root, so `readDrawObjectReference` falls back to `findMathRoot` and dispatches to `readOdfFormulaContent`.
+
+- **An embedded Math object in a spreadsheet cell reads as `objectKind: 'formula'`** — its `content.xml` root _is_ the MathML root, so `readDrawObjectReference` falls back to `findMathRoot` and dispatches to `readOdfFormulaContent`.
 - **A `draw:frame`'s alternative text (`svg:title`, falling back to `svg:desc`) reads into `ContentImageBlock.altText`.**
 - **`readOdbInventory`'s `queries` carry real `db:command` SQL text**, not just names — a breaking rename from `string[]` to `OdbQueryInfo[]`.
 - **`.odb` Form/Report structure extraction is real** (`readOdbForm`/`readOdbReport`), grounded in a genuine fixture. **A SQL/`rpt:` rendering engine to execute a query or evaluate report totals is deliberately not attempted** — see the Status section. Even a fully bounded SQL engine would not suffice to render a report: grouping breaks (`rpt:HASCHANGED`), prefix functions (`rpt:LEFT`), and running totals (`rpt:SUM`) are evaluated by Report Builder's own `rpt:` formula language, not by SQL.
@@ -266,7 +272,7 @@ Conventional Commits, enforced workspace-wide by commitlint through a root `comm
 ## References
 
 - [ooxml.js](../ooxml.js/README.md) — the OOXML sibling; architecturally mirrored, deliberately not depended on.
-- [document-schema.js](../document-schema.js/README.md) — the canonical `ContentDocument`/`DocumentPackage` schema both packages depend on, and the home of the `assemblePackage`/`flattenPackage`/`decompose`/`factorStyles` transform between the two encodings.
+- [document-schema.js](../document-schema.js/README.md) — the canonical `ContentDocument`/`DocumentTree` schema both packages depend on, and the home of the `assembleTree`/`flattenTree`/`decompose`/`factorStyles` transform between the two encodings.
 - [documents.js](https://github.com/ExaDev/documents.js) — the downstream consumer; its own `readOdtContent`/`readOdpContent`/`readOdsContent`/`readOdgContent` adapters wrap this package's flat `*Content` readers into `ContentDocument`s, adding the odt/odp formula, image, and vector detection passes those readers deliberately leave out.
 
 ## License

package/dist/{build-XSm3I8LT.d.cts → build--uPsivid.d.cts}

@@ -1,4 +1,4 @@
-import { d as XmlNode } from "./node-CkBWRjNR.cjs";
+import { d as XmlNode } from "./node-B6JX5CRX.cjs";
 //#region src/xml/build.d.ts
 declare function buildXml(nodes: XmlNode[]): string;
 //#endregion

package/dist/{build-Z1KRkSEB.d.ts → build-DgBE0bmv.d.ts}

@@ -1,4 +1,4 @@
-import { d as XmlNode } from "./node-CkBWRjNR.js";
+import { d as XmlNode } from "./node-B6JX5CRX.js";
 //#region src/xml/build.d.ts
 declare function buildXml(nodes: XmlNode[]): string;
 //#endregion

package/dist/{cascade-DWQfTwaM.d.cts → cascade-BDkyOmoo.d.cts}

@@ -1,10 +1,10 @@
-import { l as XmlElement } from "./node-CkBWRjNR.cjs";
-import { r as Package } from "./package-L24lkba-.cjs";
-import { n as StyleProperties } from "./properties-C-JKQZUD.cjs";
-import { i as StyleFamily } from "./registry-CphRYjDD.cjs";
+import { l as XmlElement } from "./node-B6JX5CRX.cjs";
+import { r as Package } from "./package-DMk9fuTI.cjs";
+import { n as StyleProperties } from "./properties-CiIoNu2h.cjs";
+import { i as StyleFamily } from "./registry-B-ZkdQv1.cjs";
 //#region src/typed/shared/cascade.d.ts
 interface CascadeDiagnostic {
-  severity: 'warning';
+  severity: "warning";
   message: string;
 }
 interface StyleCascadeResult {

package/dist/{cascade-BZ7zqXhL.d.ts → cascade-CaVinmvp.d.ts}

@@ -1,10 +1,10 @@
-import { l as XmlElement } from "./node-CkBWRjNR.js";
-import { r as Package } from "./package-BUojjTXf.js";
-import { n as StyleProperties } from "./properties-Rral02h1.js";
-import { i as StyleFamily } from "./registry-D5RGBteE.js";
+import { l as XmlElement } from "./node-B6JX5CRX.js";
+import { r as Package } from "./package-otZYrxiO.js";
+import { n as StyleProperties } from "./properties-CJyykyc_.js";
+import { i as StyleFamily } from "./registry-Dajfxsbz.js";
 //#region src/typed/shared/cascade.d.ts
 interface CascadeDiagnostic {
-  severity: 'warning';
+  severity: "warning";
   message: string;
 }
 interface StyleCascadeResult {

package/dist/{codec-CbPSWzQ2.d.ts → codec-CyJ4gSH2.d.ts}

@@ -1,43 +1,43 @@
-import { d as XmlNode } from "./node-CkBWRjNR.js";
-import { r as Package } from "./package-BUojjTXf.js";
-import "./read-CMDEXqGw.js";
-import "./write-BxVkPZID.js";
-import "./parse-A8_8sdpX.js";
-import "./build-Z1KRkSEB.js";
-import "./mimetype-BfkwTeaW.js";
-import "./fragment-B1ZV7T5Z.js";
-import "./manifest-CP1sqyGU.js";
-import "./properties-Rral02h1.js";
-import "./serialize-B-lq0LiG.js";
-import "./registry-D5RGBteE.js";
-import "./span-KXroEGuH.js";
-import "./query-sECN-7vU.js";
+import { d as XmlNode } from "./node-B6JX5CRX.js";
+import { r as Package } from "./package-otZYrxiO.js";
+import "./read-a0p7laV3.js";
+import "./write-R36XIZKx.js";
+import "./parse-BLukZ2z0.js";
+import "./build-DgBE0bmv.js";
+import "./mimetype-DvMCOzmu.js";
+import "./fragment-ClgCV_if.js";
+import "./manifest-Bju-_gTQ.js";
+import "./properties-CJyykyc_.js";
+import "./serialize-CWz84e0m.js";
+import "./registry-Dajfxsbz.js";
+import "./span-C3aJuEOM.js";
+import "./query-CbxD-WiQ.js";
 import "./color-CqXjt_to.js";
-import "./geometry-DnhkIhAM.js";
-import "./text-gJ5R0q3u.js";
-import "./cascade-BZ7zqXhL.js";
-import "./metadata-BXpjrAS-.js";
-import "./list-Qeuawtew.js";
-import "./paragraph-hzoy-Wos.js";
-import "./table-ByOoGcq_.js";
-import "./transform-C7GrZZdR.js";
-import "./masterpage-By_F05W4.js";
-import "./path-DE7wkIcz.js";
-import "./shapes-CCB8ydqD.js";
-import "./embedded-Zv8KtFUo.js";
-import "./read-DfEHXwgn.js";
-import "./read-24g5eZw6.js";
-import "./read-BLoaDxr_.js";
-import "./read-DJqvINGW.js";
-import "./read-BnN7u9Y2.js";
-import "./read-DYYxbvfo.js";
-import "./read-CvjbdgH3.js";
-import "./subdocument-BwW3FZC_.js";
-import "./forms-CyLw7lpE.js";
-import "./form-RJTtSmwn.js";
-import "./report-DbslT2OR.js";
+import "./geometry-BI33aJpv.js";
+import "./text-Bn3C7lnm.js";
+import "./cascade-CaVinmvp.js";
+import "./metadata-D1SOBTh8.js";
+import "./list-X_GJY7P3.js";
+import "./paragraph-ByTzS8Li.js";
+import "./table-DclDgC5h.js";
+import "./transform-BFNc16LQ.js";
+import "./masterpage-BLK2OJ9q.js";
+import "./path-CK0dIPgx.js";
+import "./shapes-QkOsc-WT.js";
+import "./embedded-C8tiMCE_.js";
+import "./read-DUOJ-1hX.js";
+import "./read-BcxAWBB5.js";
+import "./read-D3wLfr-7.js";
+import "./read-Bo1GBjSE.js";
+import "./read-C_oVZAnY.js";
+import "./read-8s8AdaEd.js";
+import "./read-B2jnd5eS.js";
+import "./subdocument-BhabEY9P.js";
+import "./forms-Eq2p1ss3.js";
+import "./form-D6XHM5SR.js";
+import "./report-x9RuNwmr.js";
 import { z } from "zod";
-import { Alignment as Alignment$1, AlignmentSchema as AlignmentSchema$1, DocumentPackage as DocumentPackage$1 } from "document-schema.js";
+import { Alignment as Alignment$1, AlignmentSchema as AlignmentSchema$1, DocumentTree as DocumentTree$1 } from "document-schema.js";
 //#region src/codec.d.ts
 declare const xmlCodec: z.ZodCodec<z.ZodString, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
   type: z.ZodLiteral<"text">;
@@ -106,4 +106,4 @@ declare const packageCodec: z.ZodCodec<z.ZodCustom<Uint8Array<ArrayBuffer>, Uint
 declare function decodePackage(bytes: Uint8Array<ArrayBuffer>): Package;
 declare function encodePackage(pkg: Package): Uint8Array<ArrayBuffer>;
 //#endregion
-export { Alignment$1 as a, xmlCodec as i, encodePackage as n, AlignmentSchema$1 as o, packageCodec as r, DocumentPackage$1 as s, decodePackage as t };
+export { Alignment$1 as a, xmlCodec as i, encodePackage as n, AlignmentSchema$1 as o, packageCodec as r, DocumentTree$1 as s, decodePackage as t };

package/dist/{codec-C3i7QbVt.d.cts → codec-lz3vgEos.d.cts}

@@ -1,43 +1,43 @@
-import { d as XmlNode } from "./node-CkBWRjNR.cjs";
-import { r as Package } from "./package-L24lkba-.cjs";
-import "./read-DzmMJPHd.cjs";
-import "./write-D3kyj1Xw.cjs";
-import "./parse-CP5FLZqv.cjs";
-import "./build-XSm3I8LT.cjs";
-import "./mimetype-CPNMj04s.cjs";
-import "./fragment-B1og_8uA.cjs";
-import "./manifest-BALwu2JR.cjs";
-import "./properties-C-JKQZUD.cjs";
-import "./serialize-D1fti8C5.cjs";
-import "./registry-CphRYjDD.cjs";
-import "./span-BtmvlqZH.cjs";
-import "./query-P-Y5DK0-.cjs";
+import { d as XmlNode } from "./node-B6JX5CRX.cjs";
+import { r as Package } from "./package-DMk9fuTI.cjs";
+import "./read-sawU0IWI.cjs";
+import "./write-Crk-Yt_w.cjs";
+import "./parse-DcVtB3jT.cjs";
+import "./build--uPsivid.cjs";
+import "./mimetype-1BaQzNiS.cjs";
+import "./fragment-9dNg-m46.cjs";
+import "./manifest-BGs8Bbd_.cjs";
+import "./properties-CiIoNu2h.cjs";
+import "./serialize-BU7HZ8Qh.cjs";
+import "./registry-B-ZkdQv1.cjs";
+import "./span-DSM1SnHI.cjs";
+import "./query-C69wTkqg.cjs";
 import "./color-CqXjt_to.cjs";
-import "./geometry-lKWJ_ifA.cjs";
-import "./text-BAi1tapc.cjs";
-import "./cascade-DWQfTwaM.cjs";
-import "./metadata-1j1zm9Cx.cjs";
-import "./list-KZeXA0mR.cjs";
-import "./paragraph-DaMqmhe3.cjs";
-import "./table-BH_Q2n_N.cjs";
-import "./transform-DKEjydnm.cjs";
-import "./masterpage-Bt6gxuoL.cjs";
-import "./path-DE7wkIcz.cjs";
-import "./shapes-8o3NjBLU.cjs";
-import "./embedded-BzPTTzdf.cjs";
-import "./read-CDSmR3qt.cjs";
-import "./read-rwDsgR0d.cjs";
-import "./read-IOYq80AA.cjs";
-import "./read-C3Ei_MYc.cjs";
-import "./read-DUCm1nUv.cjs";
-import "./read-ydLJ8bid.cjs";
-import "./read-BV2an1ok.cjs";
-import "./subdocument-yY8ASE4N.cjs";
-import "./forms-Eh1N15Qy.cjs";
-import "./form-CWWCkG-r.cjs";
-import "./report-D6WNYaVn.cjs";
+import "./geometry-B7FZHSyD.cjs";
+import "./text-CDUCcwje.cjs";
+import "./cascade-BDkyOmoo.cjs";
+import "./metadata-01SgHkRR.cjs";
+import "./list-DwTyo_B2.cjs";
+import "./paragraph-CVULactG.cjs";
+import "./table-CYvFMlP6.cjs";
+import "./transform-M1gbHp4j.cjs";
+import "./masterpage-KqZshNGZ.cjs";
+import "./path-CK0dIPgx.cjs";
+import "./shapes-BCjeY90t.cjs";
+import "./embedded-tlaHMady.cjs";
+import "./read-DHOQqjOZ.cjs";
+import "./read-Dy5p1OMb.cjs";
+import "./read-DSyz0YLj.cjs";
+import "./read-tpfiT_n4.cjs";
+import "./read-j9o0IoMq.cjs";
+import "./read-jVX8DHs3.cjs";
+import "./read-D3V_MVAL.cjs";
+import "./subdocument-CQptFIQK.cjs";
+import "./forms-Dc74fCtk.cjs";
+import "./form-coDwVdjG.cjs";
+import "./report-39DyUx5W.cjs";
 import { z } from "zod";
-import { Alignment as Alignment$1, AlignmentSchema, DocumentPackage as DocumentPackage$1 } from "document-schema.js";
+import { Alignment as Alignment$1, AlignmentSchema, DocumentTree as DocumentTree$1 } from "document-schema.js";
 //#region src/codec.d.ts
 declare const xmlCodec: z.ZodCodec<z.ZodString, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
   type: z.ZodLiteral<"text">;
@@ -106,4 +106,4 @@ declare const packageCodec: z.ZodCodec<z.ZodCustom<Uint8Array<ArrayBuffer>, Uint
 declare function decodePackage(bytes: Uint8Array<ArrayBuffer>): Package;
 declare function encodePackage(pkg: Package): Uint8Array<ArrayBuffer>;
 //#endregion
-export { Alignment$1 as a, xmlCodec as i, encodePackage as n, AlignmentSchema as o, packageCodec as r, DocumentPackage$1 as s, decodePackage as t };
+export { Alignment$1 as a, xmlCodec as i, encodePackage as n, AlignmentSchema as o, packageCodec as r, DocumentTree$1 as s, decodePackage as t };

package/dist/codec.d.cts

@@ -1,2 +1,2 @@
-import { i as xmlCodec, n as encodePackage, r as packageCodec, t as decodePackage } from "./codec-C3i7QbVt.cjs";
+import { i as xmlCodec, n as encodePackage, r as packageCodec, t as decodePackage } from "./codec-lz3vgEos.cjs";
 export { decodePackage, encodePackage, packageCodec, xmlCodec };

package/dist/codec.d.ts

@@ -1,2 +1,2 @@
-import { i as xmlCodec, n as encodePackage, r as packageCodec, t as decodePackage } from "./codec-CbPSWzQ2.js";
+import { i as xmlCodec, n as encodePackage, r as packageCodec, t as decodePackage } from "./codec-CyJ4gSH2.js";
 export { decodePackage, encodePackage, packageCodec, xmlCodec };

package/dist/{constructs-C1S8qlVv.d.ts → constructs-BntJjuvH.d.ts}

@@ -1,10 +1,10 @@
-import { d as XmlNode, l as XmlElement } from "./node-CkBWRjNR.js";
-import { r as Package } from "./package-BUojjTXf.js";
+import { d as XmlNode, l as XmlElement } from "./node-B6JX5CRX.js";
+import { r as Package } from "./package-otZYrxiO.js";
 import { AnchorDescriptor, ConstructDescriptor, ContentBlock, ContentControlDescriptor, DefinitionEntry, DivisionDescriptor, FieldDescriptor, ProvenanceDescriptor, RunConstructExtent, SourceResidue } from "document-schema.js";
 //#region src/typed/shared/constructs.d.ts
 declare function odfFieldDescriptor(element: XmlElement): FieldDescriptor;
 declare function odfBookmarkAnchorDescriptor(name: string): AnchorDescriptor;
-type OdfResidueFormat = 'odt' | 'ods' | 'odp' | 'odg' | 'odm' | 'odb' | 'odf';
+type OdfResidueFormat = "odt" | "ods" | "odp" | "odg" | "odm" | "odb" | "odf";
 declare function odfResidue(format: OdfResidueFormat, ...elements: XmlElement[]): SourceResidue;
 declare function isOdfExtensionElement(element: XmlElement): boolean;
 declare const ODF_UNMAPPED_SHAPE_TAGS: ReadonlySet<string>;
@@ -17,16 +17,16 @@ declare function odfDivisionDescriptor(sectionElement: XmlElement, pkg: Package)
 declare const ODF_INDEX_WRAPPER_TAGS: ReadonlySet<string>;
 declare function isOdfIndexWrapper(element: XmlElement): boolean;
 declare function odfIndexControlDescriptor(wrapper: XmlElement): ContentControlDescriptor;
-type OdfMarkerKind = 'bookmark' | 'referenceMark' | 'change' | 'annotation';
+type OdfMarkerKind = "bookmark" | "referenceMark" | "change" | "annotation";
 interface OdfMarkerHalf {
   readonly kind: OdfMarkerKind;
-  readonly side: 'start' | 'end';
+  readonly side: "start" | "end";
   readonly key: string;
   readonly element: XmlElement;
   readonly parent: XmlElement;
   readonly runPosition: number;
   readonly order: number;
-  readonly descriptor: () => RunConstructExtent['descriptor'] | undefined;
+  readonly descriptor: () => RunConstructExtent["descriptor"] | undefined;
 }
 declare function odfMarkerHalfEventIndex(half: OdfMarkerHalf, paragraphElement: XmlElement, paragraphStartIndex: number, liftedBlocksBeforeHalf?: number): number | undefined;
 declare function isOdfBlockScopedHalf(half: OdfMarkerHalf, paragraphElement: XmlElement): boolean;
@@ -48,12 +48,12 @@ interface OdfConstructExtent {
 declare function insertOdfConstructMarkers(blocks: readonly ContentBlock[], extents: readonly OdfConstructExtent[]): ContentBlock[];
 interface OdfMarkerEvent {
   readonly kind: OdfMarkerKind;
-  readonly side: 'start' | 'end';
+  readonly side: "start" | "end";
   readonly key: string;
   readonly index: number;
   readonly qualified: boolean;
   readonly order: number;
-  readonly descriptor: () => RunConstructExtent['descriptor'] | undefined;
+  readonly descriptor: () => RunConstructExtent["descriptor"] | undefined;
   readonly element: XmlElement;
 }
 declare function resolveOdfMarkerEvents(events: readonly OdfMarkerEvent[]): {

package/dist/{constructs-FLBse5UV.d.cts → constructs-BzLZy5YP.d.cts}

@@ -1,10 +1,10 @@
-import { d as XmlNode, l as XmlElement } from "./node-CkBWRjNR.cjs";
-import { r as Package } from "./package-L24lkba-.cjs";
+import { d as XmlNode, l as XmlElement } from "./node-B6JX5CRX.cjs";
+import { r as Package } from "./package-DMk9fuTI.cjs";
 import { AnchorDescriptor, ConstructDescriptor, ContentBlock, ContentControlDescriptor, DefinitionEntry, DivisionDescriptor, FieldDescriptor, ProvenanceDescriptor, RunConstructExtent, SourceResidue } from "document-schema.js";
 //#region src/typed/shared/constructs.d.ts
 declare function odfFieldDescriptor(element: XmlElement): FieldDescriptor;
 declare function odfBookmarkAnchorDescriptor(name: string): AnchorDescriptor;
-type OdfResidueFormat = 'odt' | 'ods' | 'odp' | 'odg' | 'odm' | 'odb' | 'odf';
+type OdfResidueFormat = "odt" | "ods" | "odp" | "odg" | "odm" | "odb" | "odf";
 declare function odfResidue(format: OdfResidueFormat, ...elements: XmlElement[]): SourceResidue;
 declare function isOdfExtensionElement(element: XmlElement): boolean;
 declare const ODF_UNMAPPED_SHAPE_TAGS: ReadonlySet<string>;
@@ -17,16 +17,16 @@ declare function odfDivisionDescriptor(sectionElement: XmlElement, pkg: Package)
 declare const ODF_INDEX_WRAPPER_TAGS: ReadonlySet<string>;
 declare function isOdfIndexWrapper(element: XmlElement): boolean;
 declare function odfIndexControlDescriptor(wrapper: XmlElement): ContentControlDescriptor;
-type OdfMarkerKind = 'bookmark' | 'referenceMark' | 'change' | 'annotation';
+type OdfMarkerKind = "bookmark" | "referenceMark" | "change" | "annotation";
 interface OdfMarkerHalf {
   readonly kind: OdfMarkerKind;
-  readonly side: 'start' | 'end';
+  readonly side: "start" | "end";
   readonly key: string;
   readonly element: XmlElement;
   readonly parent: XmlElement;
   readonly runPosition: number;
   readonly order: number;
-  readonly descriptor: () => RunConstructExtent['descriptor'] | undefined;
+  readonly descriptor: () => RunConstructExtent["descriptor"] | undefined;
 }
 declare function odfMarkerHalfEventIndex(half: OdfMarkerHalf, paragraphElement: XmlElement, paragraphStartIndex: number, liftedBlocksBeforeHalf?: number): number | undefined;
 declare function isOdfBlockScopedHalf(half: OdfMarkerHalf, paragraphElement: XmlElement): boolean;
@@ -48,12 +48,12 @@ interface OdfConstructExtent {
 declare function insertOdfConstructMarkers(blocks: readonly ContentBlock[], extents: readonly OdfConstructExtent[]): ContentBlock[];
 interface OdfMarkerEvent {
   readonly kind: OdfMarkerKind;
-  readonly side: 'start' | 'end';
+  readonly side: "start" | "end";
   readonly key: string;
   readonly index: number;
   readonly qualified: boolean;
   readonly order: number;
-  readonly descriptor: () => RunConstructExtent['descriptor'] | undefined;
+  readonly descriptor: () => RunConstructExtent["descriptor"] | undefined;
   readonly element: XmlElement;
 }
 declare function resolveOdfMarkerEvents(events: readonly OdfMarkerEvent[]): {

package/dist/{embedded-CBTvjVKb.cjs → embedded-BsO-SvtW.cjs}

@@ -395,7 +395,7 @@ function readOdsContent(pkg) {
 }
 function readOds(pkg) {
 	const { metadata, sheets, definitions, source } = readOdsContent(pkg);
-	const assembled = (0, document_schema_js.assemblePackage)({
+	const assembled = (0, document_schema_js.assembleTree)({
 		kind: "spreadsheet",
 		metadata,
 		sheets
@@ -747,7 +747,7 @@ function readOdtContent(pkg, options = {}) {
 }
 function readOdt(pkg, options = {}) {
 	const { metadata, sections, definitions, source } = readOdtContent(pkg, options);
-	const assembled = (0, document_schema_js.assemblePackage)({
+	const assembled = (0, document_schema_js.assembleTree)({
 		kind: "wordprocessing",
 		metadata,
 		sections

package/dist/{embedded-Zv8KtFUo.d.ts → embedded-C8tiMCE_.d.ts}

@@ -1,6 +1,6 @@
-import { l as XmlElement } from "./node-CkBWRjNR.js";
-import { r as Package } from "./package-BUojjTXf.js";
-import { l as OdfResidueFormat } from "./constructs-C1S8qlVv.js";
+import { l as XmlElement } from "./node-B6JX5CRX.js";
+import { r as Package } from "./package-otZYrxiO.js";
+import { l as OdfResidueFormat } from "./constructs-BntJjuvH.js";
 import { Box, ContentDocument, ContentEmbeddedObjectKind, SourceResidue } from "document-schema.js";
 //#region src/typed/draw/embedded.d.ts
 type EmbeddedDocumentKind = ContentEmbeddedObjectKind;

package/dist/{embedded-D2MXjcFm.js → embedded-UQQNFd5U.js}

@@ -16,7 +16,7 @@ import { subDocumentPackage } from "./typed/odb/subdocument.js";
 import { readOdgContent } from "./typed/odg/read.js";
 import { readOdpContent } from "./typed/odp/read.js";
 import { readOdfFormControlConstructs } from "./typed/shared/forms.js";
-import { PAGE_SIZE_A4, assemblePackage } from "document-schema.js";
+import { PAGE_SIZE_A4, assembleTree } from "document-schema.js";
 //#region src/typed/ods/read.ts
 const CONTENT_PART$2 = "content.xml";
 function parseKnownOdfLength$1(value) {
@@ -395,7 +395,7 @@ function readOdsContent(pkg) {
 }
 function readOds(pkg) {
 	const { metadata, sheets, definitions, source } = readOdsContent(pkg);
-	const assembled = assemblePackage({
+	const assembled = assembleTree({
 		kind: "spreadsheet",
 		metadata,
 		sheets
@@ -747,7 +747,7 @@ function readOdtContent(pkg, options = {}) {
 }
 function readOdt(pkg, options = {}) {
 	const { metadata, sections, definitions, source } = readOdtContent(pkg, options);
-	const assembled = assemblePackage({
+	const assembled = assembleTree({
 		kind: "wordprocessing",
 		metadata,
 		sections