doc-schema.js 4.2.0 → 4.3.0

package/README.md

@@ -52,7 +52,7 @@ graph TD
 
 The `LayoutDocument` family (pages of positioned `LayoutItem`s — `text`/`image`/`rect`/`line`/`ellipse`/`path`/`link` in PDF user-space coordinates) no longer lives here: 4.0.0 demoted it to a pdf-codec-private model ([pdf-codec#65](https://github.com/ExaDev/pdf-codec/issues/65)), where the only codec that ever read or wrote it owns it outright. `documentFromJson` recognises old layout-document `$schema` URIs and throws a tombstone pointing at pdf-codec rather than failing as if the value were unrelated. Dependents stay on document-schema.js 3.x via semver until their own majors, so the demotion is not a cascade-breaker.
 
-The package contains only [Zod](https://zod.dev) schemas, their inferred types, trivial schema-attached helpers (hex-colour conversion, recursive structural type guards, the style-resolution helpers of `src/definitions.ts`, the construct-marker balance check of `src/content.ts`), and one small structural interface (`ContentCodec`, see [Codecs](#codecs)). No XML, ZIP, PDF, or binary handling; the sole dependency is `zod`.
+The package contains [Zod](https://zod.dev) schemas, their inferred types, trivial schema-attached helpers (hex-colour conversion, recursive structural type guards, the style-resolution helpers of `src/definitions.ts`, the construct-marker balance check of `src/content.ts`), one small structural interface (`ContentCodec`, see [Codecs](#codecs)), and the structural transform between the two encodings it defines (`decompose`/`flattenPackage`/`factorStyles`/`assemblePackage`, see [The package boundary](#the-package-boundary)). No format-specific behaviour and no I/O of any kind — no XML, ZIP, PDF, or binary handling; the sole dependency is `zod`.
 
 Two format-agnostic helpers live here because they operate on the content model itself: cell-addressing utilities in `src/a1.ts` (0-based row/column indices, row-first order matching `ContentSheetCell`'s `{row, column}`) and the `FontFace` interface in `src/font-port.ts` (`{family, bold, italic}`).
 
@@ -102,7 +102,33 @@ The flat `ContentDocument` and the tree are **one format, two encodings**, relat
 2. **Effective-property equality, universally** — resolve styles first, then compare: a factored and an unfactored serialisation of one document are equal (this is also why content hashing and structural diffing resolve first).
 3. **Minting idempotence** — factoring a package a second time mints the identical styles table: `decompose(flatten(decompose(x))) === decompose(x)`.
 
-The codecs do not change: they keep producing flat `ContentDocument`s (their natural reading shape); decomposition runs once at the package boundary in documents.js and flatten runs once where a builder consumes a package.
+The codecs do not change: they keep producing flat `ContentDocument`s (their natural reading shape); decomposition runs once where a package is assembled and flatten runs once where a builder consumes one. Both directions live here — see [The package boundary](#the-package-boundary).
+
+## The package boundary
+
+The transform between the two encodings lives in this package, alongside the schemas that define them:
+
+```ts
+import { assemblePackage, decompose, factorStyles, flattenPackage } from 'document-schema.js';
+
+// The one call a construction site makes: decompose the flat content into the tree, splice the envelope
+// onto the root, and mint a styles table over the result. `pages` is optional -- pass it once a layout
+// pass has produced each rendered page's own size.
+const pkg = assemblePackage(content, pages);
+
+// The inverse, with every style ref resolved away: a fully materialised, ref-free ContentDocument.
+const flat = flattenPackage(pkg);
+
+// The two halves on their own, for a caller composing its own boundary.
+const children = decompose(content);   // flat -> the tree `children` a package carries
+const reminted = factorStyles(pkg);    // re-mint an already-assembled tree (idempotent)
+```
+
+`decompose` throws `ConstructMarkerImbalanceError` — carrying `src/content.ts`'s own `ConstructMarkerImbalance` payload, so a caller narrows with `instanceof` and reads the offending block index rather than parsing a message — when a container's `constructStart`/`constructEnd` markers do not pair up. Promotion is defined only over a balanced stream, so an unbalanced one is refused rather than repaired into a plausible tree.
+
+**This is a deliberate amendment to the "schemas only" charter, not a drift from it.** The transform is not business logic and not format-specific behaviour: it is the canonical, purely structural, zero-I/O relationship between the two shapes this package already defines, and its correctness contract *is* the three laws above. It lives here because it has to: `ooxml.js`, `odf.js`, `markdown-codec`, and `pdf-codec` all depend on this package and none of them depends on `documents.js`, so a codec whose public read/write functions speak `DocumentPackage` directly can only reach the transform if the transform sits at or below the schema layer. Everything the charter actually guards against — XML, ZIP, PDF, fonts, layout, bytes, filesystem — remains firmly out.
+
+The laws are pinned in `src/bijection.test.ts` over a corpus spanning every document kind, every leaf the tree vocabulary admits, and every grouping signal `decompose` reads (headings, list levels, and construct boundaries in each block flow that admits them). `documents.js` runs the same law harness over its own real-format corpus — reader output for every format it supports, editor builds, and conversion captures carrying a layout pass's real frames and pages — which is the complement this package cannot host, since every reader in it belongs to a package that depends on this one.
 
 ## Fidelity constructs
 
@@ -199,7 +225,7 @@ Each is its own root field rather than three more tenants of `definitions`, for
 
 A styles entry carries `{ paragraph?, run? }` sub-objects of **resolved canonical properties only**: paragraph `alignment`/`list`/`spacingBeforePt`/`spacingAfterPt`/`lineSpacing`/`indentLeftPt`/`indentFirstLinePt`, run `bold`/`italic`/`underline`/`strike`/`fontFamily`/`sizePt`/`color`. Never `frames`, never `sourcePath`, never `styleId` (per-node facts — a position is a fact about a node, not a style), never a `basedOn` graph (the table is a dictionary, not a program) — and the ban list is **enforced by schema shape** (strict objects that reject those keys outright), not merely documented.
 
-Resolution is one overlay chain — outermost ancestor group's style, each nearer group's style, the node's own direct properties; innermost wins, with the resolved run half applying one level further down as run defaults under each run's own properties. `src/definitions.ts` exports the pure helpers that implement it (`overlayStyleEntries`, `resolveStyleChain`, `applyParagraphStyleProperties`, `applyRunStyleProperties`); minting entries (the deterministic frequency pass that factors repeated property tuples into `s1`, `s2`, … refs) is documents.js's boundary behaviour, not this package's.
+Resolution is one overlay chain — outermost ancestor group's style, each nearer group's style, the node's own direct properties; innermost wins, with the resolved run half applying one level further down as run defaults under each run's own properties. `src/definitions.ts` exports the pure helpers that implement it (`overlayStyleEntries`, `resolveStyleChain`, `applyParagraphStyleProperties`, `applyRunStyleProperties`), and `factorStyles` (`src/factor-styles.ts`) is the deterministic frequency pass that mints entries, factoring repeated property tuples into `s1`, `s2`, … refs — see [The package boundary](#the-package-boundary).
 
 Every module is also importable directly — `tsdown` builds one file per source module, and `package.json`'s `"./*"` export makes each individually resolvable:
 
@@ -311,7 +337,7 @@ try {
 
 - [ooxml.js](https://github.com/ExaDev/ooxml.js) — `readDocx`/`readPptx`/`readXlsxContent` return types are typed against this package's schemas, not a local lookalike.
 - [odf.js](https://github.com/ExaDev/odf.js) — ODF typed readers return the same shared types, so ODF and OOXML speak the identical pivot.
-- [documents.js](https://github.com/ExaDev/documents.js) — primary consumer of `ContentDocument` and `DocumentPackage`; its `DOCUMENT_FORMAT_CODECS` registry implements `ContentCodec` per format, and its package boundary runs decompose/flatten against the tree form.
+- [documents.js](https://github.com/ExaDev/documents.js) — primary consumer of `ContentDocument` and `DocumentPackage`; its `DOCUMENT_FORMAT_CODECS` registry implements `ContentCodec` per format, and its conversion pipeline calls `assemblePackage`/`flattenPackage` from here at every package construction site.
 - [pdf-codec](https://github.com/ExaDev/pdf-codec) — owns its layout item model outright since 4.0.0; `readPdf`/`writePdf` operate on pdf-codec's own `LayoutDocument`, and this package's `ContentDocument` remains its content pivot.
 - [markdown-codec](https://github.com/ExaDev/markdown-codec) — `readMarkdown`/`writeMarkdown` read and write this package's `ContentDocument` directly.
 

package/dist/canonicalise.cjs

@@ -0,0 +1,20 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/canonicalise.ts
+function canonicalise(value) {
+	if (Array.isArray(value)) return value.map(canonicalise);
+	if (isRecord(value)) {
+		const sorted = {};
+		for (const key of Object.keys(value).sort()) sorted[key] = canonicalise(value[key]);
+		return sorted;
+	}
+	return value;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function canonicalKey(value) {
+	return JSON.stringify(canonicalise(value));
+}
+//#endregion
+exports.canonicalKey = canonicalKey;
+exports.canonicalise = canonicalise;

package/dist/canonicalise.d.cts

@@ -0,0 +1,5 @@
+//#region src/canonicalise.d.ts
+declare function canonicalise(value: unknown): unknown;
+declare function canonicalKey(value: unknown): string;
+//#endregion
+export { canonicalKey, canonicalise };

package/dist/canonicalise.d.ts

@@ -0,0 +1,5 @@
+//#region src/canonicalise.d.ts
+declare function canonicalise(value: unknown): unknown;
+declare function canonicalKey(value: unknown): string;
+//#endregion
+export { canonicalKey, canonicalise };

package/dist/canonicalise.js

@@ -0,0 +1,18 @@
+//#region src/canonicalise.ts
+function canonicalise(value) {
+	if (Array.isArray(value)) return value.map(canonicalise);
+	if (isRecord(value)) {
+		const sorted = {};
+		for (const key of Object.keys(value).sort()) sorted[key] = canonicalise(value[key]);
+		return sorted;
+	}
+	return value;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function canonicalKey(value) {
+	return JSON.stringify(canonicalise(value));
+}
+//#endregion
+export { canonicalKey, canonicalise };

package/dist/codec.d.cts

@@ -1,4 +1,4 @@
-import { m as ContentDocument } from "./content-B5VNueO_.cjs";
+import { m as ContentDocument } from "./content-BmqzegMG.cjs";
 //#region src/codec.d.ts
 interface ContentCodec<TOptions = unknown> {
   read(bytes: Uint8Array, options?: TOptions): ContentDocument;

package/dist/codec.d.ts

@@ -1,4 +1,4 @@
-import { m as ContentDocument } from "./content-DPtA7fC1.js";
+import { m as ContentDocument } from "./content-CIwPb_yh.js";
 //#region src/codec.d.ts
 interface ContentCodec<TOptions = unknown> {
   read(bytes: Uint8Array, options?: TOptions): ContentDocument;

package/dist/{construct-D5pdDPqM.d.cts → construct-CdQuI9f5.d.cts}

@@ -1,12 +1,12 @@
 import { z } from "zod";
 //#region src/construct.d.ts
 declare const ContentControlTypeSchema: z.ZodEnum<{
-  date: "date";
   richText: "richText";
   plainText: "plainText";
   checkbox: "checkbox";
   dropDown: "dropDown";
   comboBox: "comboBox";
+  date: "date";
   picture: "picture";
   repeatingSection: "repeatingSection";
   button: "button";
@@ -23,12 +23,12 @@ type ContentControlLock = z.infer<typeof ContentControlLockSchema>;
 declare const ContentControlDescriptorSchema: z.ZodObject<{
   kind: z.ZodLiteral<"contentControl">;
   controlType: z.ZodEnum<{
-    date: "date";
     richText: "richText";
     plainText: "plainText";
     checkbox: "checkbox";
     dropDown: "dropDown";
     comboBox: "comboBox";
+    date: "date";
     picture: "picture";
     repeatingSection: "repeatingSection";
     button: "button";
@@ -54,19 +54,19 @@ declare const FieldDescriptorSchema: z.ZodObject<{
 }, z.core.$strict>;
 type FieldDescriptor = z.infer<typeof FieldDescriptorSchema>;
 declare const AnchorTypeSchema: z.ZodEnum<{
-  comment: "comment";
   bookmark: "bookmark";
   footnote: "footnote";
   endnote: "endnote";
+  comment: "comment";
 }>;
 type AnchorType = z.infer<typeof AnchorTypeSchema>;
 declare const AnchorDescriptorSchema: z.ZodObject<{
   kind: z.ZodLiteral<"anchor">;
   anchorType: z.ZodEnum<{
-    comment: "comment";
     bookmark: "bookmark";
     footnote: "footnote";
     endnote: "endnote";
+    comment: "comment";
   }>;
   name: z.ZodString;
   definition: z.ZodOptional<z.ZodString>;
@@ -132,12 +132,12 @@ type DivisionDescriptor = z.infer<typeof DivisionDescriptorSchema>;
 declare const ConstructDescriptorSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   kind: z.ZodLiteral<"contentControl">;
   controlType: z.ZodEnum<{
-    date: "date";
     richText: "richText";
     plainText: "plainText";
     checkbox: "checkbox";
     dropDown: "dropDown";
     comboBox: "comboBox";
+    date: "date";
     picture: "picture";
     repeatingSection: "repeatingSection";
     button: "button";
@@ -161,10 +161,10 @@ declare const ConstructDescriptorSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strict>, z.ZodObject<{
   kind: z.ZodLiteral<"anchor">;
   anchorType: z.ZodEnum<{
-    comment: "comment";
     bookmark: "bookmark";
     footnote: "footnote";
     endnote: "endnote";
+    comment: "comment";
   }>;
   name: z.ZodString;
   definition: z.ZodOptional<z.ZodString>;

package/dist/{construct-D5pdDPqM.d.ts → construct-CdQuI9f5.d.ts}

@@ -1,12 +1,12 @@
 import { z } from "zod";
 //#region src/construct.d.ts
 declare const ContentControlTypeSchema: z.ZodEnum<{
-  date: "date";
   richText: "richText";
   plainText: "plainText";
   checkbox: "checkbox";
   dropDown: "dropDown";
   comboBox: "comboBox";
+  date: "date";
   picture: "picture";
   repeatingSection: "repeatingSection";
   button: "button";
@@ -23,12 +23,12 @@ type ContentControlLock = z.infer<typeof ContentControlLockSchema>;
 declare const ContentControlDescriptorSchema: z.ZodObject<{
   kind: z.ZodLiteral<"contentControl">;
   controlType: z.ZodEnum<{
-    date: "date";
     richText: "richText";
     plainText: "plainText";
     checkbox: "checkbox";
     dropDown: "dropDown";
     comboBox: "comboBox";
+    date: "date";
     picture: "picture";
     repeatingSection: "repeatingSection";
     button: "button";
@@ -54,19 +54,19 @@ declare const FieldDescriptorSchema: z.ZodObject<{
 }, z.core.$strict>;
 type FieldDescriptor = z.infer<typeof FieldDescriptorSchema>;
 declare const AnchorTypeSchema: z.ZodEnum<{
-  comment: "comment";
   bookmark: "bookmark";
   footnote: "footnote";
   endnote: "endnote";
+  comment: "comment";
 }>;
 type AnchorType = z.infer<typeof AnchorTypeSchema>;
 declare const AnchorDescriptorSchema: z.ZodObject<{
   kind: z.ZodLiteral<"anchor">;
   anchorType: z.ZodEnum<{
-    comment: "comment";
     bookmark: "bookmark";
     footnote: "footnote";
     endnote: "endnote";
+    comment: "comment";
   }>;
   name: z.ZodString;
   definition: z.ZodOptional<z.ZodString>;
@@ -132,12 +132,12 @@ type DivisionDescriptor = z.infer<typeof DivisionDescriptorSchema>;
 declare const ConstructDescriptorSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   kind: z.ZodLiteral<"contentControl">;
   controlType: z.ZodEnum<{
-    date: "date";
     richText: "richText";
     plainText: "plainText";
     checkbox: "checkbox";
     dropDown: "dropDown";
     comboBox: "comboBox";
+    date: "date";
     picture: "picture";
     repeatingSection: "repeatingSection";
     button: "button";
@@ -161,10 +161,10 @@ declare const ConstructDescriptorSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strict>, z.ZodObject<{
   kind: z.ZodLiteral<"anchor">;
   anchorType: z.ZodEnum<{
-    comment: "comment";
     bookmark: "bookmark";
     footnote: "footnote";
     endnote: "endnote";
+    comment: "comment";
   }>;
   name: z.ZodString;
   definition: z.ZodOptional<z.ZodString>;

package/dist/construct.d.cts

@@ -1,2 +1,2 @@
-import { C as ProvenanceChange, E as ProvenanceDescriptorSchema, S as LinkTargetSchema, T as ProvenanceDescriptor, _ as FieldDescriptor, a as ConstructDescriptor, b as LinkDescriptorSchema, c as ContentControlDescriptorSchema, d as ContentControlType, f as ContentControlTypeSchema, g as DivisionSourceSchema, h as DivisionSource, i as AnchorTypeSchema, l as ContentControlLock, m as DivisionDescriptorSchema, n as AnchorDescriptorSchema, o as ConstructDescriptorSchema, p as DivisionDescriptor, r as AnchorType, s as ContentControlDescriptor, t as AnchorDescriptor, u as ContentControlLockSchema, v as FieldDescriptorSchema, w as ProvenanceChangeSchema, x as LinkTarget, y as LinkDescriptor } from "./construct-D5pdDPqM.cjs";
+import { C as ProvenanceChange, E as ProvenanceDescriptorSchema, S as LinkTargetSchema, T as ProvenanceDescriptor, _ as FieldDescriptor, a as ConstructDescriptor, b as LinkDescriptorSchema, c as ContentControlDescriptorSchema, d as ContentControlType, f as ContentControlTypeSchema, g as DivisionSourceSchema, h as DivisionSource, i as AnchorTypeSchema, l as ContentControlLock, m as DivisionDescriptorSchema, n as AnchorDescriptorSchema, o as ConstructDescriptorSchema, p as DivisionDescriptor, r as AnchorType, s as ContentControlDescriptor, t as AnchorDescriptor, u as ContentControlLockSchema, v as FieldDescriptorSchema, w as ProvenanceChangeSchema, x as LinkTarget, y as LinkDescriptor } from "./construct-CdQuI9f5.cjs";
 export { AnchorDescriptor, AnchorDescriptorSchema, AnchorType, AnchorTypeSchema, ConstructDescriptor, ConstructDescriptorSchema, ContentControlDescriptor, ContentControlDescriptorSchema, ContentControlLock, ContentControlLockSchema, ContentControlType, ContentControlTypeSchema, DivisionDescriptor, DivisionDescriptorSchema, DivisionSource, DivisionSourceSchema, FieldDescriptor, FieldDescriptorSchema, LinkDescriptor, LinkDescriptorSchema, LinkTarget, LinkTargetSchema, ProvenanceChange, ProvenanceChangeSchema, ProvenanceDescriptor, ProvenanceDescriptorSchema };

package/dist/construct.d.ts

@@ -1,2 +1,2 @@
-import { C as ProvenanceChange, E as ProvenanceDescriptorSchema, S as LinkTargetSchema, T as ProvenanceDescriptor, _ as FieldDescriptor, a as ConstructDescriptor, b as LinkDescriptorSchema, c as ContentControlDescriptorSchema, d as ContentControlType, f as ContentControlTypeSchema, g as DivisionSourceSchema, h as DivisionSource, i as AnchorTypeSchema, l as ContentControlLock, m as DivisionDescriptorSchema, n as AnchorDescriptorSchema, o as ConstructDescriptorSchema, p as DivisionDescriptor, r as AnchorType, s as ContentControlDescriptor, t as AnchorDescriptor, u as ContentControlLockSchema, v as FieldDescriptorSchema, w as ProvenanceChangeSchema, x as LinkTarget, y as LinkDescriptor } from "./construct-D5pdDPqM.js";
+import { C as ProvenanceChange, E as ProvenanceDescriptorSchema, S as LinkTargetSchema, T as ProvenanceDescriptor, _ as FieldDescriptor, a as ConstructDescriptor, b as LinkDescriptorSchema, c as ContentControlDescriptorSchema, d as ContentControlType, f as ContentControlTypeSchema, g as DivisionSourceSchema, h as DivisionSource, i as AnchorTypeSchema, l as ContentControlLock, m as DivisionDescriptorSchema, n as AnchorDescriptorSchema, o as ConstructDescriptorSchema, p as DivisionDescriptor, r as AnchorType, s as ContentControlDescriptor, t as AnchorDescriptor, u as ContentControlLockSchema, v as FieldDescriptorSchema, w as ProvenanceChangeSchema, x as LinkTarget, y as LinkDescriptor } from "./construct-CdQuI9f5.js";
 export { AnchorDescriptor, AnchorDescriptorSchema, AnchorType, AnchorTypeSchema, ConstructDescriptor, ConstructDescriptorSchema, ContentControlDescriptor, ContentControlDescriptorSchema, ContentControlLock, ContentControlLockSchema, ContentControlType, ContentControlTypeSchema, DivisionDescriptor, DivisionDescriptorSchema, DivisionSource, DivisionSourceSchema, FieldDescriptor, FieldDescriptorSchema, LinkDescriptor, LinkDescriptorSchema, LinkTarget, LinkTargetSchema, ProvenanceChange, ProvenanceChangeSchema, ProvenanceDescriptor, ProvenanceDescriptorSchema };

package/dist/{content-B5VNueO_.d.cts → content-BmqzegMG.d.cts}

@@ -126,12 +126,12 @@ declare const ContentConstructStartSchema: z.ZodObject<{
   descriptor: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"contentControl">;
     controlType: z.ZodEnum<{
-      date: "date";
       richText: "richText";
       plainText: "plainText";
       checkbox: "checkbox";
       dropDown: "dropDown";
       comboBox: "comboBox";
+      date: "date";
       picture: "picture";
       repeatingSection: "repeatingSection";
       button: "button";
@@ -155,10 +155,10 @@ declare const ContentConstructStartSchema: z.ZodObject<{
   }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"anchor">;
     anchorType: z.ZodEnum<{
-      comment: "comment";
       bookmark: "bookmark";
       footnote: "footnote";
       endnote: "endnote";
+      comment: "comment";
     }>;
     name: z.ZodString;
     definition: z.ZodOptional<z.ZodString>;

package/dist/{content-DPtA7fC1.d.ts → content-CIwPb_yh.d.ts}

@@ -126,12 +126,12 @@ declare const ContentConstructStartSchema: z.ZodObject<{
   descriptor: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"contentControl">;
     controlType: z.ZodEnum<{
-      date: "date";
       richText: "richText";
       plainText: "plainText";
       checkbox: "checkbox";
       dropDown: "dropDown";
       comboBox: "comboBox";
+      date: "date";
       picture: "picture";
       repeatingSection: "repeatingSection";
       button: "button";
@@ -155,10 +155,10 @@ declare const ContentConstructStartSchema: z.ZodObject<{
   }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"anchor">;
     anchorType: z.ZodEnum<{
-      comment: "comment";
       bookmark: "bookmark";
       footnote: "footnote";
       endnote: "endnote";
+      comment: "comment";
     }>;
     name: z.ZodString;
     definition: z.ZodOptional<z.ZodString>;

package/dist/content.d.cts

@@ -1,2 +1,2 @@
-import { $ as ContentSheetPrintRangeSchema, A as ContentPageBreakSchema, At as isContentConstructEnd, B as ContentSectionSchema, C as ContentFormula, Ct as DecimalString, D as ContentListMembership, Dt as contentDocumentSharedFields, E as ContentImageBlockSchema, Et as clampHeadingLevel, F as ContentPathSegment, G as ContentSheetCellComment, H as ContentShapeSchema, I as ContentPathSegmentSchema, J as ContentSheetColumn, K as ContentSheetCellCommentSchema, L as ContentRun, M as ContentParagraphSchema, N as ContentPathPoint, O as ContentListMembershipSchema, Ot as findConstructMarkerImbalance, P as ContentPathPointSchema, Q as ContentSheetPrintRange, R as ContentRunSchema, S as ContentEmbeddedObjectSchema, St as ContentVectorSchema, T as ContentImageBlock, Tt as FusedNode, U as ContentSheet, V as ContentShape, W as ContentSheetCell, X as ContentSheetImage, Y as ContentSheetColumnSchema, Z as ContentSheetImageSchema, _ as ContentDrawPageSchema, _t as ContentTableCellSchema, a as ContentBorderSchema, at as ContentSheetRowSchema, b as ContentEmbeddedObjectBlockSchema, bt as ContentTableSchema, c as ContentCellValue, ct as ContentSlideSchema, d as ContentConstructEndSchema, dt as ContentStrokeStyle, et as ContentSheetPrintSettings, f as ContentConstructStart, ft as ContentStrokeStyleSchema, g as ContentDrawPage, gt as ContentTableCell, h as ContentDocumentSchema, ht as ContentTable, i as ContentBorder, it as ContentSheetRow, j as ContentParagraph, jt as isContentConstructStart, k as ContentPageBreak, kt as isContentBlock, l as ContentCellValueSchema, lt as ContentStroke, m as ContentDocument, mt as ContentSubpathSchema, n as ContentBlock, nt as ContentSheetRepeatRange, o as ContentCellBorders, ot as ContentSheetSchema, p as ContentConstructStartSchema, pt as ContentSubpath, q as ContentSheetCellSchema, r as ContentBlockSchema, rt as ContentSheetRepeatRangeSchema, s as ContentCellBordersSchema, st as ContentSlide, t as ConstructMarkerImbalance, tt as ContentSheetPrintSettingsSchema, u as ContentConstructEnd, ut as ContentStrokeSchema, v as ContentEmbeddedObject, vt as ContentTableRow, w as ContentFormulaSchema, wt as DecimalStringSchema, x as ContentEmbeddedObjectKind, xt as ContentVector, y as ContentEmbeddedObjectBlock, yt as ContentTableRowSchema, z as ContentSection } from "./content-B5VNueO_.cjs";
+import { $ as ContentSheetPrintRangeSchema, A as ContentPageBreakSchema, At as isContentConstructEnd, B as ContentSectionSchema, C as ContentFormula, Ct as DecimalString, D as ContentListMembership, Dt as contentDocumentSharedFields, E as ContentImageBlockSchema, Et as clampHeadingLevel, F as ContentPathSegment, G as ContentSheetCellComment, H as ContentShapeSchema, I as ContentPathSegmentSchema, J as ContentSheetColumn, K as ContentSheetCellCommentSchema, L as ContentRun, M as ContentParagraphSchema, N as ContentPathPoint, O as ContentListMembershipSchema, Ot as findConstructMarkerImbalance, P as ContentPathPointSchema, Q as ContentSheetPrintRange, R as ContentRunSchema, S as ContentEmbeddedObjectSchema, St as ContentVectorSchema, T as ContentImageBlock, Tt as FusedNode, U as ContentSheet, V as ContentShape, W as ContentSheetCell, X as ContentSheetImage, Y as ContentSheetColumnSchema, Z as ContentSheetImageSchema, _ as ContentDrawPageSchema, _t as ContentTableCellSchema, a as ContentBorderSchema, at as ContentSheetRowSchema, b as ContentEmbeddedObjectBlockSchema, bt as ContentTableSchema, c as ContentCellValue, ct as ContentSlideSchema, d as ContentConstructEndSchema, dt as ContentStrokeStyle, et as ContentSheetPrintSettings, f as ContentConstructStart, ft as ContentStrokeStyleSchema, g as ContentDrawPage, gt as ContentTableCell, h as ContentDocumentSchema, ht as ContentTable, i as ContentBorder, it as ContentSheetRow, j as ContentParagraph, jt as isContentConstructStart, k as ContentPageBreak, kt as isContentBlock, l as ContentCellValueSchema, lt as ContentStroke, m as ContentDocument, mt as ContentSubpathSchema, n as ContentBlock, nt as ContentSheetRepeatRange, o as ContentCellBorders, ot as ContentSheetSchema, p as ContentConstructStartSchema, pt as ContentSubpath, q as ContentSheetCellSchema, r as ContentBlockSchema, rt as ContentSheetRepeatRangeSchema, s as ContentCellBordersSchema, st as ContentSlide, t as ConstructMarkerImbalance, tt as ContentSheetPrintSettingsSchema, u as ContentConstructEnd, ut as ContentStrokeSchema, v as ContentEmbeddedObject, vt as ContentTableRow, w as ContentFormulaSchema, wt as DecimalStringSchema, x as ContentEmbeddedObjectKind, xt as ContentVector, y as ContentEmbeddedObjectBlock, yt as ContentTableRowSchema, z as ContentSection } from "./content-BmqzegMG.cjs";
 export { ConstructMarkerImbalance, ContentBlock, ContentBlockSchema, ContentBorder, ContentBorderSchema, ContentCellBorders, ContentCellBordersSchema, ContentCellValue, ContentCellValueSchema, ContentConstructEnd, ContentConstructEndSchema, ContentConstructStart, ContentConstructStartSchema, ContentDocument, ContentDocumentSchema, ContentDrawPage, ContentDrawPageSchema, ContentEmbeddedObject, ContentEmbeddedObjectBlock, ContentEmbeddedObjectBlockSchema, ContentEmbeddedObjectKind, ContentEmbeddedObjectSchema, ContentFormula, ContentFormulaSchema, ContentImageBlock, ContentImageBlockSchema, ContentListMembership, ContentListMembershipSchema, ContentPageBreak, ContentPageBreakSchema, ContentParagraph, ContentParagraphSchema, ContentPathPoint, ContentPathPointSchema, ContentPathSegment, ContentPathSegmentSchema, ContentRun, ContentRunSchema, ContentSection, ContentSectionSchema, ContentShape, ContentShapeSchema, ContentSheet, ContentSheetCell, ContentSheetCellComment, ContentSheetCellCommentSchema, ContentSheetCellSchema, ContentSheetColumn, ContentSheetColumnSchema, ContentSheetImage, ContentSheetImageSchema, ContentSheetPrintRange, ContentSheetPrintRangeSchema, ContentSheetPrintSettings, ContentSheetPrintSettingsSchema, ContentSheetRepeatRange, ContentSheetRepeatRangeSchema, ContentSheetRow, ContentSheetRowSchema, ContentSheetSchema, ContentSlide, ContentSlideSchema, ContentStroke, ContentStrokeSchema, ContentStrokeStyle, ContentStrokeStyleSchema, ContentSubpath, ContentSubpathSchema, ContentTable, ContentTableCell, ContentTableCellSchema, ContentTableRow, ContentTableRowSchema, ContentTableSchema, ContentVector, ContentVectorSchema, DecimalString, DecimalStringSchema, FusedNode, clampHeadingLevel, contentDocumentSharedFields, findConstructMarkerImbalance, isContentBlock, isContentConstructEnd, isContentConstructStart };

package/dist/content.d.ts

@@ -1,2 +1,2 @@
-import { $ as ContentSheetPrintRangeSchema, A as ContentPageBreakSchema, At as isContentConstructEnd, B as ContentSectionSchema, C as ContentFormula, Ct as DecimalString, D as ContentListMembership, Dt as contentDocumentSharedFields, E as ContentImageBlockSchema, Et as clampHeadingLevel, F as ContentPathSegment, G as ContentSheetCellComment, H as ContentShapeSchema, I as ContentPathSegmentSchema, J as ContentSheetColumn, K as ContentSheetCellCommentSchema, L as ContentRun, M as ContentParagraphSchema, N as ContentPathPoint, O as ContentListMembershipSchema, Ot as findConstructMarkerImbalance, P as ContentPathPointSchema, Q as ContentSheetPrintRange, R as ContentRunSchema, S as ContentEmbeddedObjectSchema, St as ContentVectorSchema, T as ContentImageBlock, Tt as FusedNode, U as ContentSheet, V as ContentShape, W as ContentSheetCell, X as ContentSheetImage, Y as ContentSheetColumnSchema, Z as ContentSheetImageSchema, _ as ContentDrawPageSchema, _t as ContentTableCellSchema, a as ContentBorderSchema, at as ContentSheetRowSchema, b as ContentEmbeddedObjectBlockSchema, bt as ContentTableSchema, c as ContentCellValue, ct as ContentSlideSchema, d as ContentConstructEndSchema, dt as ContentStrokeStyle, et as ContentSheetPrintSettings, f as ContentConstructStart, ft as ContentStrokeStyleSchema, g as ContentDrawPage, gt as ContentTableCell, h as ContentDocumentSchema, ht as ContentTable, i as ContentBorder, it as ContentSheetRow, j as ContentParagraph, jt as isContentConstructStart, k as ContentPageBreak, kt as isContentBlock, l as ContentCellValueSchema, lt as ContentStroke, m as ContentDocument, mt as ContentSubpathSchema, n as ContentBlock, nt as ContentSheetRepeatRange, o as ContentCellBorders, ot as ContentSheetSchema, p as ContentConstructStartSchema, pt as ContentSubpath, q as ContentSheetCellSchema, r as ContentBlockSchema, rt as ContentSheetRepeatRangeSchema, s as ContentCellBordersSchema, st as ContentSlide, t as ConstructMarkerImbalance, tt as ContentSheetPrintSettingsSchema, u as ContentConstructEnd, ut as ContentStrokeSchema, v as ContentEmbeddedObject, vt as ContentTableRow, w as ContentFormulaSchema, wt as DecimalStringSchema, x as ContentEmbeddedObjectKind, xt as ContentVector, y as ContentEmbeddedObjectBlock, yt as ContentTableRowSchema, z as ContentSection } from "./content-DPtA7fC1.js";
+import { $ as ContentSheetPrintRangeSchema, A as ContentPageBreakSchema, At as isContentConstructEnd, B as ContentSectionSchema, C as ContentFormula, Ct as DecimalString, D as ContentListMembership, Dt as contentDocumentSharedFields, E as ContentImageBlockSchema, Et as clampHeadingLevel, F as ContentPathSegment, G as ContentSheetCellComment, H as ContentShapeSchema, I as ContentPathSegmentSchema, J as ContentSheetColumn, K as ContentSheetCellCommentSchema, L as ContentRun, M as ContentParagraphSchema, N as ContentPathPoint, O as ContentListMembershipSchema, Ot as findConstructMarkerImbalance, P as ContentPathPointSchema, Q as ContentSheetPrintRange, R as ContentRunSchema, S as ContentEmbeddedObjectSchema, St as ContentVectorSchema, T as ContentImageBlock, Tt as FusedNode, U as ContentSheet, V as ContentShape, W as ContentSheetCell, X as ContentSheetImage, Y as ContentSheetColumnSchema, Z as ContentSheetImageSchema, _ as ContentDrawPageSchema, _t as ContentTableCellSchema, a as ContentBorderSchema, at as ContentSheetRowSchema, b as ContentEmbeddedObjectBlockSchema, bt as ContentTableSchema, c as ContentCellValue, ct as ContentSlideSchema, d as ContentConstructEndSchema, dt as ContentStrokeStyle, et as ContentSheetPrintSettings, f as ContentConstructStart, ft as ContentStrokeStyleSchema, g as ContentDrawPage, gt as ContentTableCell, h as ContentDocumentSchema, ht as ContentTable, i as ContentBorder, it as ContentSheetRow, j as ContentParagraph, jt as isContentConstructStart, k as ContentPageBreak, kt as isContentBlock, l as ContentCellValueSchema, lt as ContentStroke, m as ContentDocument, mt as ContentSubpathSchema, n as ContentBlock, nt as ContentSheetRepeatRange, o as ContentCellBorders, ot as ContentSheetSchema, p as ContentConstructStartSchema, pt as ContentSubpath, q as ContentSheetCellSchema, r as ContentBlockSchema, rt as ContentSheetRepeatRangeSchema, s as ContentCellBordersSchema, st as ContentSlide, t as ConstructMarkerImbalance, tt as ContentSheetPrintSettingsSchema, u as ContentConstructEnd, ut as ContentStrokeSchema, v as ContentEmbeddedObject, vt as ContentTableRow, w as ContentFormulaSchema, wt as DecimalStringSchema, x as ContentEmbeddedObjectKind, xt as ContentVector, y as ContentEmbeddedObjectBlock, yt as ContentTableRowSchema, z as ContentSection } from "./content-CIwPb_yh.js";
 export { ConstructMarkerImbalance, ContentBlock, ContentBlockSchema, ContentBorder, ContentBorderSchema, ContentCellBorders, ContentCellBordersSchema, ContentCellValue, ContentCellValueSchema, ContentConstructEnd, ContentConstructEndSchema, ContentConstructStart, ContentConstructStartSchema, ContentDocument, ContentDocumentSchema, ContentDrawPage, ContentDrawPageSchema, ContentEmbeddedObject, ContentEmbeddedObjectBlock, ContentEmbeddedObjectBlockSchema, ContentEmbeddedObjectKind, ContentEmbeddedObjectSchema, ContentFormula, ContentFormulaSchema, ContentImageBlock, ContentImageBlockSchema, ContentListMembership, ContentListMembershipSchema, ContentPageBreak, ContentPageBreakSchema, ContentParagraph, ContentParagraphSchema, ContentPathPoint, ContentPathPointSchema, ContentPathSegment, ContentPathSegmentSchema, ContentRun, ContentRunSchema, ContentSection, ContentSectionSchema, ContentShape, ContentShapeSchema, ContentSheet, ContentSheetCell, ContentSheetCellComment, ContentSheetCellCommentSchema, ContentSheetCellSchema, ContentSheetColumn, ContentSheetColumnSchema, ContentSheetImage, ContentSheetImageSchema, ContentSheetPrintRange, ContentSheetPrintRangeSchema, ContentSheetPrintSettings, ContentSheetPrintSettingsSchema, ContentSheetRepeatRange, ContentSheetRepeatRangeSchema, ContentSheetRow, ContentSheetRowSchema, ContentSheetSchema, ContentSlide, ContentSlideSchema, ContentStroke, ContentStrokeSchema, ContentStrokeStyle, ContentStrokeStyleSchema, ContentSubpath, ContentSubpathSchema, ContentTable, ContentTableCell, ContentTableCellSchema, ContentTableRow, ContentTableRowSchema, ContentTableSchema, ContentVector, ContentVectorSchema, DecimalString, DecimalStringSchema, FusedNode, clampHeadingLevel, contentDocumentSharedFields, findConstructMarkerImbalance, isContentBlock, isContentConstructEnd, isContentConstructStart };

package/dist/decompose.cjs

@@ -0,0 +1,186 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_content = require("./content.cjs");
+//#region src/decompose.ts
+function isHeadingParagraph(paragraph) {
+	return paragraph.headingLevel !== void 0;
+}
+function isListParagraph(paragraph) {
+	return paragraph.list !== void 0;
+}
+var ConstructMarkerImbalanceError = class extends Error {
+	imbalance;
+	constructor(imbalance) {
+		super(imbalance.kind === "unmatchedEnd" ? `decompose: the constructEnd marker at index ${imbalance.index} of this container's block flow closes no open construct` : `decompose: the constructStart marker at index ${imbalance.index} of this container's block flow is never closed`);
+		this.name = "ConstructMarkerImbalanceError";
+		this.imbalance = imbalance;
+	}
+};
+function decompose(content) {
+	switch (content.kind) {
+		case "wordprocessing": return content.sections.map(decomposeSection);
+		case "presentation": return content.slides.map(decomposeSlide);
+		case "spreadsheet": return content.sheets.map(decomposeSheet);
+		case "drawing": return content.pages.map(decomposeDrawPage);
+		case "formula": return [content.formula];
+	}
+}
+function decomposeSection(section) {
+	const { blocks, ...rest } = section;
+	return {
+		node: {
+			kind: "section",
+			...rest
+		},
+		children: decomposeSectionBlocks(blocks)
+	};
+}
+function assertBalancedConstructMarkers(blocks) {
+	const imbalance = require_content.findConstructMarkerImbalance(blocks);
+	if (imbalance !== void 0) throw new ConstructMarkerImbalanceError(imbalance);
+}
+function decomposeSectionBlocks(blocks) {
+	assertBalancedConstructMarkers(blocks);
+	return walkSectionBlocks(blocks.values());
+}
+function walkSectionBlocks(cursor) {
+	const root = [];
+	const headingStack = [];
+	const listStack = [];
+	const headingScope = () => headingStack.at(-1)?.children ?? root;
+	for (let step = cursor.next(); step.done !== true; step = cursor.next()) {
+		const block = step.value;
+		if (block.kind === "constructEnd") return root;
+		if (block.kind === "constructStart") {
+			openConstructGroup(block.descriptor, cursor, listStack, headingScope());
+			continue;
+		}
+		if (block.kind !== "paragraph") {
+			const parent = listStack.at(-1);
+			(parent !== void 0 ? parent.children : headingScope()).push(block);
+			continue;
+		}
+		if (isHeadingParagraph(block)) {
+			listStack.length = 0;
+			const level = block.headingLevel;
+			for (let top = headingStack.at(-1); top !== void 0 && top.node.headingLevel >= level; top = headingStack.at(-1)) headingStack.pop();
+			const group = {
+				node: block,
+				children: []
+			};
+			const parent = headingStack.at(-1);
+			(parent !== void 0 ? parent.children : root).push(group);
+			headingStack.push(group);
+		} else if (isListParagraph(block)) openListGroup(listStack, headingScope(), block);
+		else {
+			listStack.length = 0;
+			headingScope().push(block);
+		}
+	}
+	return root;
+}
+function decomposeSlide(slide) {
+	const { shapes, ...rest } = slide;
+	return {
+		node: {
+			kind: "slide",
+			...rest
+		},
+		children: shapes.map(decomposeShape)
+	};
+}
+function decomposeSheet(sheet) {
+	const { images, embeddedObjects, ...rest } = sheet;
+	const children = [...images, ...embeddedObjects ?? []];
+	return {
+		node: {
+			kind: "sheet",
+			...rest
+		},
+		children
+	};
+}
+function decomposeDrawPage(page) {
+	const { shapes, vectors, ...rest } = page;
+	const children = [...shapes.map(decomposeShape), ...vectors];
+	return {
+		node: {
+			kind: "drawPage",
+			...rest
+		},
+		children
+	};
+}
+function decomposeShape(shape) {
+	const { blocks, ...rest } = shape;
+	return {
+		node: rest,
+		children: decomposeShapeBlocks(blocks)
+	};
+}
+function decomposeShapeBlocks(blocks) {
+	assertBalancedConstructMarkers(blocks);
+	return walkShapeBlocks(blocks.values());
+}
+function walkShapeBlocks(cursor) {
+	const root = [];
+	const listStack = [];
+	for (let step = cursor.next(); step.done !== true; step = cursor.next()) {
+		const block = step.value;
+		if (block.kind === "constructEnd") return root;
+		if (block.kind === "constructStart") {
+			const parent = listStack.at(-1);
+			(parent !== void 0 ? parent.children : root).push({
+				node: block.descriptor,
+				children: walkShapeBlocks(cursor)
+			});
+			continue;
+		}
+		if (block.kind !== "paragraph") {
+			const parent = listStack.at(-1);
+			(parent !== void 0 ? parent.children : root).push(block);
+			continue;
+		}
+		if (isListParagraph(block)) {
+			openListGroup(listStack, root, block);
+			continue;
+		}
+		listStack.length = 0;
+		root.push(block);
+	}
+	return root;
+}
+function openConstructGroup(descriptor, cursor, listStack, headingScope) {
+	const parent = listStack.at(-1);
+	if (parent === void 0) {
+		headingScope.push({
+			node: descriptor,
+			children: walkSectionBlocks(cursor)
+		});
+		return;
+	}
+	parent.children.push({
+		node: descriptor,
+		children: walkShapeBlocks(cursor)
+	});
+}
+function openListGroup(listStack, scopeChildren, paragraph) {
+	const level = paragraph.list.level;
+	for (let top = listStack.at(-1); top !== void 0 && top.node.list.level >= level; top = listStack.at(-1)) listStack.pop();
+	const group = {
+		node: paragraph,
+		children: []
+	};
+	const parent = listStack.at(-1);
+	(parent !== void 0 ? parent.children : scopeChildren).push(group);
+	listStack.push(group);
+}
+//#endregion
+exports.ConstructMarkerImbalanceError = ConstructMarkerImbalanceError;
+exports.decompose = decompose;
+exports.decomposeDrawPage = decomposeDrawPage;
+exports.decomposeSection = decomposeSection;
+exports.decomposeShape = decomposeShape;
+exports.decomposeSheet = decomposeSheet;
+exports.decomposeSlide = decomposeSlide;
+exports.isHeadingParagraph = isHeadingParagraph;
+exports.isListParagraph = isListParagraph;

package/dist/decompose.d.cts

@@ -0,0 +1,18 @@
+import { C as ContentFormula, U as ContentSheet, V as ContentShape, g as ContentDrawPage, j as ContentParagraph, m as ContentDocument, st as ContentSlide, t as ConstructMarkerImbalance, z as ContentSection } from "./content-BmqzegMG.cjs";
+import { B as SheetGroupNode, F as ShapeGroupNode, O as SectionGroupNode, W as SlideGroupNode, c as HeadingParagraph, i as DrawPageGroupNode, p as ListParagraph } from "./package-node-a9CyRaD3.cjs";
+//#region src/decompose.d.ts
+declare function isHeadingParagraph(paragraph: ContentParagraph): paragraph is HeadingParagraph;
+declare function isListParagraph(paragraph: ContentParagraph): paragraph is ListParagraph;
+declare class ConstructMarkerImbalanceError extends Error {
+  readonly imbalance: ConstructMarkerImbalance;
+  constructor(imbalance: ConstructMarkerImbalance);
+}
+type PackageChildren = SectionGroupNode[] | SlideGroupNode[] | SheetGroupNode[] | DrawPageGroupNode[] | ContentFormula[];
+declare function decompose(content: ContentDocument): PackageChildren;
+declare function decomposeSection(section: ContentSection): SectionGroupNode;
+declare function decomposeSlide(slide: ContentSlide): SlideGroupNode;
+declare function decomposeSheet(sheet: ContentSheet): SheetGroupNode;
+declare function decomposeDrawPage(page: ContentDrawPage): DrawPageGroupNode;
+declare function decomposeShape(shape: ContentShape): ShapeGroupNode;
+//#endregion
+export { ConstructMarkerImbalanceError, PackageChildren, decompose, decomposeDrawPage, decomposeSection, decomposeShape, decomposeSheet, decomposeSlide, isHeadingParagraph, isListParagraph };

package/dist/decompose.d.ts

@@ -0,0 +1,18 @@
+import { C as ContentFormula, U as ContentSheet, V as ContentShape, g as ContentDrawPage, j as ContentParagraph, m as ContentDocument, st as ContentSlide, t as ConstructMarkerImbalance, z as ContentSection } from "./content-CIwPb_yh.js";
+import { B as SheetGroupNode, F as ShapeGroupNode, O as SectionGroupNode, W as SlideGroupNode, c as HeadingParagraph, i as DrawPageGroupNode, p as ListParagraph } from "./package-node-C7RiYhyk.js";
+//#region src/decompose.d.ts
+declare function isHeadingParagraph(paragraph: ContentParagraph): paragraph is HeadingParagraph;
+declare function isListParagraph(paragraph: ContentParagraph): paragraph is ListParagraph;
+declare class ConstructMarkerImbalanceError extends Error {
+  readonly imbalance: ConstructMarkerImbalance;
+  constructor(imbalance: ConstructMarkerImbalance);
+}
+type PackageChildren = SectionGroupNode[] | SlideGroupNode[] | SheetGroupNode[] | DrawPageGroupNode[] | ContentFormula[];
+declare function decompose(content: ContentDocument): PackageChildren;
+declare function decomposeSection(section: ContentSection): SectionGroupNode;
+declare function decomposeSlide(slide: ContentSlide): SlideGroupNode;
+declare function decomposeSheet(sheet: ContentSheet): SheetGroupNode;
+declare function decomposeDrawPage(page: ContentDrawPage): DrawPageGroupNode;
+declare function decomposeShape(shape: ContentShape): ShapeGroupNode;
+//#endregion
+export { ConstructMarkerImbalanceError, PackageChildren, decompose, decomposeDrawPage, decomposeSection, decomposeShape, decomposeSheet, decomposeSlide, isHeadingParagraph, isListParagraph };