odf.js 5.1.2 → 5.3.0

package/README.md

@@ -209,7 +209,7 @@ Layered from a lossless core outward, mirroring `ooxml.js`:
 - **`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).
 - **`src/typed/shared/`** — ODF-specific typed primitives every reader builds on (units, A1 cursors, colour/geometry, whitespace runs, style cascade, shared paragraph/table readers, transform/path parsing, metadata).
 - **`src/typed/odt/`, `odp/`, `odg/`, `ods/`** — one module per format, each carrying both levels of its reader: the package-native `readOdt`/`readOdp`/`readOdg`/`readOds` and the flat `readOdtContent`/`readOdpContent`/`readOdgContent`/`readOdsContent` it is built on.
-- **`src/typed/draw/`** — the shared `draw:frame`/`draw:g`/vector shape vocabulary (`shapes.ts`), plus `embedded.ts` (`readDrawObjectReference`, `readDrawImageBlock`).
+- **`src/typed/draw/`** — the shared `draw:frame`/`draw:g`/vector shape vocabulary and `readDrawImageBlock` (`shapes.ts`), plus `embedded.ts` (`readDrawObjectReference`, `readEmbeddedObjectDocument`, `readOdfChartContent` — the shared embedded-object reference resolver and the central kind→reader dispatch table).
 - **`src/typed/formula/`, `odm/`** — `readOdfFormula`/`readOdfFormulaContent`/`readOdfFormulaMathMl` and `readOdm`.
 - **`src/typed/odb/`** — `readOdbInventory`, `readOdbForm`/`readOdbReport`, `resolveOdbComponent`, `subDocumentPackage`.
 
@@ -237,15 +237,17 @@ Layered from a lossless core outward, mirroring `ooxml.js`:
 
 ## Fidelity constructs
 
-`readOdt` reads ODF's fidelity constructs into `document-schema.js`'s harmonised construct vocabulary — the semantic channel of the family's two-channel fidelity model (the quarantined residue channel is the other half). No real-producer fixture in this repository exercises these rows yet: every fixture below the unit suites is programmatic, built to the OASIS element grammar, and real-producer verification is outstanding.
+`readOdt` reads ODF's fidelity constructs into `document-schema.js`'s harmonised construct vocabulary — the semantic channel of the family's two-channel fidelity model (the quarantined residue channel is the other half). Two residue rows carry genuine producer fixtures (`conditional-format.ods`, `transitions.odp` — real LibreOffice output, generated through the same UNO calls the Calc/Impress UIs use); every other fixture below the unit suites is programmatic, built to the OASIS element grammar, with real-producer verification outstanding.
 
 - **Fields** — every inline field element (the simple set, the variable/user-field/sequence instance families, the database displays) reads as ordinary runs carrying its cached text plus a run-level field extent on the paragraph, instruction being the serialised element and `cachedResult` its own text content. Field master declarations (`text:*-decls`) read into the package-root definitions table, keyed per family.
 - **Bookmarks and tracked changes** — paired marker halves at run scope pair inside one paragraph; halves at paragraph edges pair across blocks into `constructStart`/`constructEnd` markers. Change markers resolve their `text:change-id` against the `text:changed-region` definitions (either id spelling, `xml:id` today and ODF 1.0's `text:id`), carrying author and date as provenance.
 - **Notes and annotations** — a `text:note`'s citation becomes a run, its body a definitions entry, an anchor extent naming both; an `office:annotation` does the same and pairs with `office:annotation-end` by `office:name` over a range, falling back to a point anchor when no end arrives.
 - **Divisions and index wrappers** — `text:section` brackets its blocks as a division construct (name, protected, column count, and a `text:section-source`'s external-chapter link); the seven index wrappers bracket their cached `text:index-body` blocks as `index` content controls, with the wrapper's `*-source` build rules quarantined in residue.
 - **Forms** — `office:forms` in an ordinary text document reads as point content controls in pre-order through the same form-tree walker the `.odb` reader uses; `form:properties` bags quarantine into residue.
-- **Anchored frames** — a `draw:frame` in text flow lifts to blocks after its paragraph: images, text-box content, and embedded objects (formula, drawing, presentation, chart; a spreadsheet degrades to its preview image — reading it would need the odt→ods reader edge this package deliberately refuses).
+- **Anchored frames** — a `draw:frame` in text flow lifts to blocks after its paragraph: images, text-box content, and embedded objects (formula, drawing, presentation, chart, spreadsheet), each dispatched through `typed/draw/embedded.ts`'s shared `readEmbeddedObjectDocument` — the central kind→reader table that lets a Writer document read an embedded Calc sheet (and a Calc sheet an embedded Writer document) without any format reader importing a sibling reader.
 - **Style-side tenants** — `number:*` data styles and `office:font-face-decls` read into the definitions table from both parts; a paragraph style's unmodellable properties quarantine as per-node residue.
+- **Master pages and page-break styles** — every `style:master-page` reads as part of a whole-page inventory: a paragraph style's `style:paragraph-properties/@style:master-page-name` switch opens a new `ContentSection` at that paragraph carrying the named master page's own geometry (`breakType: 'nextPage'` — ODF defines the switch as forcing a page break), and each master page's `style:header`/`style:footer` variants (default, `-left`, `-first`) read as real block flow on `OdtDocument.headerFooterParts`, with `sectionMasterPages` naming positionally which master page each section came from. Explicit page breaks ride the shared cascade: `fo:break-before`/`fo:break-after="page"` resolve onto the paragraph's `pageBreakBefore`/`pageBreakAfter` flags (`auto` to an explicit false; `column`/`even-page`/`odd-page` quarantine as residue through the unknown-properties path, since the boolean cannot hold their extra meaning).
+- **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`.

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

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

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

@@ -1,7 +1,7 @@
 import { l as XmlElement } from "./node-CkBWRjNR.cjs";
 import { r as Package } from "./package-L24lkba-.cjs";
-import { n as StyleProperties } from "./properties-BF_Fv6B3.cjs";
-import { i as StyleFamily } from "./registry-CaJpWDke.cjs";
+import { n as StyleProperties } from "./properties-C-JKQZUD.cjs";
+import { i as StyleFamily } from "./registry-CphRYjDD.cjs";
 //#region src/typed/shared/cascade.d.ts
 interface CascadeDiagnostic {
   severity: 'warning';

package/dist/{codec-BAz7YIru.d.cts → codec-LgpdP32n.d.cts}

@@ -7,34 +7,34 @@ import "./build-XSm3I8LT.cjs";
 import "./mimetype-CPNMj04s.cjs";
 import "./fragment-B1og_8uA.cjs";
 import "./manifest-BALwu2JR.cjs";
-import "./properties-BF_Fv6B3.cjs";
-import "./serialize-9xvti0FF.cjs";
-import "./registry-CaJpWDke.cjs";
+import "./properties-C-JKQZUD.cjs";
+import "./serialize-D1fti8C5.cjs";
+import "./registry-CphRYjDD.cjs";
 import "./span-BtmvlqZH.cjs";
 import "./query-P-Y5DK0-.cjs";
 import "./color-CqXjt_to.cjs";
 import "./geometry-lKWJ_ifA.cjs";
 import "./text-BAi1tapc.cjs";
-import "./cascade-BmvsXcAz.cjs";
+import "./cascade-DWQfTwaM.cjs";
 import "./metadata-1j1zm9Cx.cjs";
 import "./list-KZeXA0mR.cjs";
-import "./paragraph-BBmSl_sK.cjs";
+import "./paragraph-CuEMXbDg.cjs";
 import "./table-BH_Q2n_N.cjs";
 import "./transform-DKEjydnm.cjs";
-import "./masterpage-XJ2v2khe.cjs";
+import "./masterpage-Bt6gxuoL.cjs";
 import "./path-DE7wkIcz.cjs";
 import "./shapes-8o3NjBLU.cjs";
-import "./embedded-J3M3kDvY.cjs";
-import "./read-CTfeWaWq.cjs";
-import "./read-Cs1ktkWB.cjs";
-import "./read-DOYWO6BM.cjs";
-import "./read-B4238IGr.cjs";
+import "./embedded-rKOsAsjg.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-cIjw-Jf-.cjs";
-import "./form-BGCT81ss.cjs";
+import "./forms-BydLKkI0.cjs";
+import "./form-D8wh-xhJ.cjs";
 import "./report-D6WNYaVn.cjs";
 import { z } from "zod";
 import { Alignment as Alignment$1, AlignmentSchema, DocumentPackage as DocumentPackage$1 } from "document-schema.js";

package/dist/{codec-BxxFEqvT.d.ts → codec-sFSMk-if.d.ts}

@@ -7,34 +7,34 @@ import "./build-Z1KRkSEB.js";
 import "./mimetype-BfkwTeaW.js";
 import "./fragment-B1ZV7T5Z.js";
 import "./manifest-CP1sqyGU.js";
-import "./properties-DjAIdPry.js";
-import "./serialize-DvaE_t5D.js";
-import "./registry-BVeEpUMI.js";
+import "./properties-Rral02h1.js";
+import "./serialize-B-lq0LiG.js";
+import "./registry-D5RGBteE.js";
 import "./span-KXroEGuH.js";
 import "./query-sECN-7vU.js";
 import "./color-CqXjt_to.js";
 import "./geometry-DnhkIhAM.js";
 import "./text-gJ5R0q3u.js";
-import "./cascade-rhqUQrUa.js";
+import "./cascade-BZ7zqXhL.js";
 import "./metadata-BXpjrAS-.js";
 import "./list-Qeuawtew.js";
-import "./paragraph-6hzAZpmi.js";
+import "./paragraph-BE71DZ0t.js";
 import "./table-ByOoGcq_.js";
 import "./transform-C7GrZZdR.js";
-import "./masterpage-C1McDhMv.js";
+import "./masterpage-By_F05W4.js";
 import "./path-DE7wkIcz.js";
 import "./shapes-CCB8ydqD.js";
-import "./embedded-BPhuSEEI.js";
-import "./read-Db_GZ0ZH.js";
-import "./read-DHuiGh_y.js";
-import "./read-lc0t0UHK.js";
-import "./read-CdvX2qnz.js";
+import "./embedded-ClsebpWi.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-D1-0spCe.js";
-import "./form-D3H5H2NL.js";
+import "./forms-iwRSwhOn.js";
+import "./form-CsOrcORr.js";
 import "./report-DbslT2OR.js";
 import { z } from "zod";
 import { Alignment as Alignment$1, AlignmentSchema as AlignmentSchema$1, DocumentPackage as DocumentPackage$1 } from "document-schema.js";

package/dist/codec.d.cts

@@ -1,2 +1,2 @@
-import { i as xmlCodec, n as encodePackage, r as packageCodec, t as decodePackage } from "./codec-BAz7YIru.cjs";
+import { i as xmlCodec, n as encodePackage, r as packageCodec, t as decodePackage } from "./codec-LgpdP32n.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-BxxFEqvT.js";
+import { i as xmlCodec, n as encodePackage, r as packageCodec, t as decodePackage } from "./codec-sFSMk-if.js";
 export { decodePackage, encodePackage, packageCodec, xmlCodec };

package/dist/{constructs-CJpDDQV0.d.ts → constructs-B1yajQJB.d.ts}

@@ -6,6 +6,13 @@ declare function odfFieldDescriptor(element: XmlElement): FieldDescriptor;
 declare function odfBookmarkAnchorDescriptor(name: string): AnchorDescriptor;
 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>;
+declare function collectOdfUnmappedShapeResidue(children: readonly XmlNode[], out: XmlElement[]): void;
+declare function odfAttributeElement(element: XmlElement, ...attributeNames: readonly string[]): XmlElement;
+declare function addOdfPackageResidue(out: Record<string, SourceResidue>, key: string, format: OdfResidueFormat, ...elements: XmlElement[]): void;
+declare const ODF_CONSUMED_PART_PATHS: ReadonlySet<string>;
+declare function collectOdfNonContentPartResidue(pkg: Package, format: OdfResidueFormat, out: Record<string, SourceResidue>): void;
 declare function odfDivisionDescriptor(sectionElement: XmlElement, pkg: Package): DivisionDescriptor;
 declare const ODF_INDEX_WRAPPER_TAGS: ReadonlySet<string>;
 declare function isOdfIndexWrapper(element: XmlElement): boolean;
@@ -60,4 +67,4 @@ declare function collectOdfDataStyleDefinitions(nodes: readonly XmlNode[], out:
 declare function collectOdfFontFaceDefinitions(nodes: readonly XmlNode[], out: Record<string, DefinitionEntry>): void;
 declare function collectOdfNamedExpressions(nodes: readonly XmlNode[], out: Record<string, DefinitionEntry>): void;
 //#endregion
-export { pairOdfMarkerHalves as C, odfResidue as S, odfChangedRegionId as _, OdfMarkerHalf as a, odfIndexControlDescriptor as b, collectOdfDataStyleDefinitions as c, collectOdfNamedExpressions as d, collectOdfProvenanceRegions as f, odfBookmarkAnchorDescriptor as g, isOdfIndexWrapper as h, OdfMarkerEvent as i, collectOdfFieldMasterDefinitions as l, isOdfBlockScopedHalf as m, OdfConstructExtent as n, OdfMarkerKind as o, insertOdfConstructMarkers as p, OdfDefinitionsSink as r, OdfResidueFormat as s, ODF_INDEX_WRAPPER_TAGS as t, collectOdfFontFaceDefinitions as u, odfDivisionDescriptor as v, resolveOdfMarkerEvents as w, odfMarkerHalfEventIndex as x, odfFieldDescriptor as y };
+export { pairOdfMarkerHalves as A, odfBookmarkAnchorDescriptor as C, odfIndexControlDescriptor as D, odfFieldDescriptor as E, odfMarkerHalfEventIndex as O, odfAttributeElement as S, odfDivisionDescriptor as T, collectOdfUnmappedShapeResidue as _, OdfDefinitionsSink as a, isOdfExtensionElement as b, OdfMarkerKind as c, collectOdfDataStyleDefinitions as d, collectOdfFieldMasterDefinitions as f, collectOdfProvenanceRegions as g, collectOdfNonContentPartResidue as h, OdfConstructExtent as i, resolveOdfMarkerEvents as j, odfResidue as k, OdfResidueFormat as l, collectOdfNamedExpressions as m, ODF_INDEX_WRAPPER_TAGS as n, OdfMarkerEvent as o, collectOdfFontFaceDefinitions as p, ODF_UNMAPPED_SHAPE_TAGS as r, OdfMarkerHalf as s, ODF_CONSUMED_PART_PATHS as t, addOdfPackageResidue as u, insertOdfConstructMarkers as v, odfChangedRegionId as w, isOdfIndexWrapper as x, isOdfBlockScopedHalf as y };

package/dist/{constructs-Dy_DMFs3.d.cts → constructs-BSC_5kfU.d.cts}

@@ -6,6 +6,13 @@ declare function odfFieldDescriptor(element: XmlElement): FieldDescriptor;
 declare function odfBookmarkAnchorDescriptor(name: string): AnchorDescriptor;
 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>;
+declare function collectOdfUnmappedShapeResidue(children: readonly XmlNode[], out: XmlElement[]): void;
+declare function odfAttributeElement(element: XmlElement, ...attributeNames: readonly string[]): XmlElement;
+declare function addOdfPackageResidue(out: Record<string, SourceResidue>, key: string, format: OdfResidueFormat, ...elements: XmlElement[]): void;
+declare const ODF_CONSUMED_PART_PATHS: ReadonlySet<string>;
+declare function collectOdfNonContentPartResidue(pkg: Package, format: OdfResidueFormat, out: Record<string, SourceResidue>): void;
 declare function odfDivisionDescriptor(sectionElement: XmlElement, pkg: Package): DivisionDescriptor;
 declare const ODF_INDEX_WRAPPER_TAGS: ReadonlySet<string>;
 declare function isOdfIndexWrapper(element: XmlElement): boolean;
@@ -60,4 +67,4 @@ declare function collectOdfDataStyleDefinitions(nodes: readonly XmlNode[], out:
 declare function collectOdfFontFaceDefinitions(nodes: readonly XmlNode[], out: Record<string, DefinitionEntry>): void;
 declare function collectOdfNamedExpressions(nodes: readonly XmlNode[], out: Record<string, DefinitionEntry>): void;
 //#endregion
-export { pairOdfMarkerHalves as C, odfResidue as S, odfChangedRegionId as _, OdfMarkerHalf as a, odfIndexControlDescriptor as b, collectOdfDataStyleDefinitions as c, collectOdfNamedExpressions as d, collectOdfProvenanceRegions as f, odfBookmarkAnchorDescriptor as g, isOdfIndexWrapper as h, OdfMarkerEvent as i, collectOdfFieldMasterDefinitions as l, isOdfBlockScopedHalf as m, OdfConstructExtent as n, OdfMarkerKind as o, insertOdfConstructMarkers as p, OdfDefinitionsSink as r, OdfResidueFormat as s, ODF_INDEX_WRAPPER_TAGS as t, collectOdfFontFaceDefinitions as u, odfDivisionDescriptor as v, resolveOdfMarkerEvents as w, odfMarkerHalfEventIndex as x, odfFieldDescriptor as y };
+export { pairOdfMarkerHalves as A, odfBookmarkAnchorDescriptor as C, odfIndexControlDescriptor as D, odfFieldDescriptor as E, odfMarkerHalfEventIndex as O, odfAttributeElement as S, odfDivisionDescriptor as T, collectOdfUnmappedShapeResidue as _, OdfDefinitionsSink as a, isOdfExtensionElement as b, OdfMarkerKind as c, collectOdfDataStyleDefinitions as d, collectOdfFieldMasterDefinitions as f, collectOdfProvenanceRegions as g, collectOdfNonContentPartResidue as h, OdfConstructExtent as i, resolveOdfMarkerEvents as j, odfResidue as k, OdfResidueFormat as l, collectOdfNamedExpressions as m, ODF_INDEX_WRAPPER_TAGS as n, OdfMarkerEvent as o, collectOdfFontFaceDefinitions as p, ODF_UNMAPPED_SHAPE_TAGS as r, OdfMarkerHalf as s, ODF_CONSUMED_PART_PATHS as t, addOdfPackageResidue as u, insertOdfConstructMarkers as v, odfChangedRegionId as w, isOdfIndexWrapper as x, isOdfBlockScopedHalf as y };