documents.js 4.4.8 → 4.6.0

package/README.md

@@ -303,7 +303,17 @@ const { comments, footnotes, headers, footers, numbering } = readDocxExtras(deco
 console.log(Object.values(numbering)[0]?.levels['0']?.format); // numbering is keyed by numId, each level by its own level index
 ```
 
-`openPptx`/`createPptx` and `PptxSlide`/`PptxShape` are the pptx equivalent. `openOdt`/`createOdt` and `OdtParagraph`/`OdtRun`/`OdtTable`/`OdtList` are the odt equivalent, built on ODF's style-name-referencing model. `openOdp`/`createOdp` and `OdpSlide`/`OdpShape` reuse `OdtParagraph`/`OdtRun`/`OdtList` directly (a `draw:frame`'s `draw:text-box` holds the identical `text:p`/`text:span` model):
+`openPptx`/`createPptx` and `PptxSlide`/`PptxShape` are the pptx equivalent. `embeddedPresentationSerialiser` is ooxml.js's embedded-presentation port wired from this package's own pptx builder. ooxml.js has no PresentationML writer and cannot depend on the one pptx writer in the ecosystem (`buildPptxPackage`, living here one layer above it), so its docx writer instead accepts an injected serialiser; pass this value as `BuildDocxContentOptions.serialiseEmbeddedPresentation` and a docx carrying an OLE-embedded presentation — which `readDocxContent` genuinely recovers as an `embeddedObject` block — round-trips through that writer, the nested deck re-serialised into a real `word/embeddings/oleObject<N>.pptx` payload rather than refused:
+
+```ts
+import { embeddedPresentationSerialiser } from 'documents.js';
+import { buildDocxPackageFromContent, decodePackage, encodePackage, readDocxContent } from 'ooxml.js';
+
+const content = readDocxContent(decodePackage(docxBytes)); // carries a presentation embed
+const rebuilt = encodePackage(buildDocxPackageFromContent(content, { serialiseEmbeddedPresentation: embeddedPresentationSerialiser }));
+```
+
+`openOdt`/`createOdt` and `OdtParagraph`/`OdtRun`/`OdtTable`/`OdtList` are the odt equivalent, built on ODF's style-name-referencing model. `openOdp`/`createOdp` and `OdpSlide`/`OdpShape` reuse `OdtParagraph`/`OdtRun`/`OdtList` directly (a `draw:frame`'s `draw:text-box` holds the identical `text:p`/`text:span` model):
 
 ```ts
 import { createOdp } from 'documents.js';
@@ -565,7 +575,7 @@ The package is layered from generic primitives outward to the two conversion dir
 - **`src/markdown/`** — third adapter family, via `markdown-codec`. `readMarkdownContent` passes `readMarkdownContent`'s (markdown-codec's flat reader, so named since that package's 4.0.0; the bare `readMarkdown` name is now its tree-form `DocumentPackage` reader) result through the math-lowering pass (`math.ts` — markdown-codec's preserved `$$` display blocks and `\( \)` inline spans become two-layer formula blocks, with the document's symbol table seeded from its own prose). `buildMarkdownText` wraps `writeMarkdownContent`, reconstructing markdown math syntax from formula blocks carrying a presentation layer. `text.ts` is the byte↔text boundary. `MarkdownEditor` holds a mutable in-memory `ContentDocument`.
 - **`src/csv/`** — fourth adapter family, sharing the spreadsheet variant with xlsx/ods. `records.ts` is the RFC 4180 record parser/writer (one shared `quoteCsvField`, also used by the `.odb` CSV exporter); `text.ts` is the byte↔text boundary, rejecting malformed UTF-8; `read.ts` turns records into a spreadsheet `ContentDocument` (first record as verbatim string header, data cells through the same cell-typing heuristic `pdfToOds` uses); `write.ts` turns one sheet of a spreadsheet `ContentDocument` back into records via each cell's `displayText`. TSV is the same format with `{ delimiter: '\t' }` on either side.
 - **`src/svg/`** — fifth adapter family, sharing the drawing variant with odg. `text.ts` is the byte↔text boundary, rejecting malformed UTF-8; `read.ts` maps the six SVG shape primitives (rect/circle/ellipse/line/polyline/polygon/path) onto a one-page drawing `ContentDocument`, with transform lists composed as 2×3 affines and CSS lengths and the viewBox map resolved into page points; `write.ts` writes the six primitives back out, one shape element each; `path.ts` is the full SVG path-data grammar (M/L/H/V/C/S/Z plus Q/T/A and the relative forms — S/Q/T convert exactly, A is the one bounded approximation at ≤90° per cubic); `transform.ts` parses and composes the transform attribute and classifies the result by frame representability; `units.ts` resolves CSS length units and the viewBox; `paint.ts` resolves fill/stroke presentation attributes and dash styles; `diagnostics.ts` is the shared scope-limit vocabulary.
-- **`src/layout/`** — the pure conversion algorithms: `engine.ts` (wordprocessing → layout: flow, line-breaking, pagination), `slides.ts` (presentation → layout: direct placement), `sheets.ts` (spreadsheet → layout: grid, print settings, the first algorithm accepting `AbortSignal`), `drawing.ts` (drawing → layout: vector primitives + shape reuse), `reconstruct.ts` (layout → content: baseline clustering for wordprocessing/presentation, near-1:1 mapping for drawing, gridline-lattice-or-text-clustering for spreadsheet; plus the PDF construct surfacing — link reconciliation to `ContentRun.hyperlink` or link constructs, hidden-layer content dropped, anchor/comment and AcroForm contentControl constructs).
+- **`src/layout/`** — the pure conversion algorithms: `engine.ts` (wordprocessing → layout: flow, line-breaking, pagination), `slides.ts` (presentation → layout: direct placement), `sheets.ts` (spreadsheet → layout: grid, print settings, the first algorithm accepting `AbortSignal`), `drawing.ts` (drawing → layout: vector primitives + shape reuse), `reconstruct.ts` (layout → content: baseline clustering for wordprocessing/presentation, near-1:1 mapping for drawing, gridline-lattice-or-text-clustering for spreadsheet; plus the PDF construct surfacing — link reconciliation to `ContentRun.hyperlink` or link constructs, hidden-layer content dropped, anchor/comment and AcroForm contentControl constructs, and tagged-structure semantics where the file states them: heading levels from owning `H1`..`H6` elements over the font-size census, lattice-free table recovery from `/Table`/`/TR`/`/TH`/`/TD` ownership, and `division` constructs around `/Part`/`/Sect`/`/Div` extents).
 - **`src/hsqldb/`** — `.odb` decoders, four tiers: `script.ts` (TEXT-script DDL/DML parser), `rowformat.ts`/`cache.ts` (CACHED binary row-store), `binary-script.ts` (BINARY/COMPRESSED whole-script). All import only `document-schema.js` — no odf.js knowledge.
 - **`src/firebird/`** — Tier 3: gbak logical-backup reader. `reader.ts` (attribute framing + RLE decompression + XDR decoding), `schema.ts`/`data.ts` (table/row walking). No ratified spec — built against Firebird's own engine source.
 - **`src/odb/`** — decoder-selection and pivot-mapping: `read.ts` routes to the right tier, `spreadsheet.ts`/`csv.ts` map to output formats. `odb/sql/` is the bounded SQL engine, `odb/formula/` is the rpt formula engine, `odb/report/` is the renderer, `odb/values.ts` is shared comparison/aggregation semantics.

package/dist/convert/convert.cjs

@@ -2,9 +2,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_model_geometry = require("../model/geometry.cjs");
 const require_model_metadata = require("../model/metadata.cjs");
 const require_edit_docx_content = require("../edit/docx/content.cjs");
+const require_mathml_layout = require("../mathml/layout.cjs");
 const require_edit_odt_content = require("../edit/odt/content.cjs");
 const require_fonts_registry = require("../fonts/registry.cjs");
-const require_mathml_layout = require("../mathml/layout.cjs");
 const require_odf_formula_read = require("../odf/formula/read.cjs");
 const require_odf_odt_read = require("../odf/odt/read.cjs");
 const require_layout_engine = require("../layout/engine.cjs");

package/dist/convert/convert.js

@@ -1,9 +1,9 @@
 import { flipY } from "../model/geometry.js";
 import { resolveMetadataTimestamps } from "../model/metadata.js";
 import { buildDocxPackage } from "../edit/docx/content.js";
+import { layoutFormula } from "../mathml/layout.js";
 import { buildOdtPackage } from "../edit/odt/content.js";
 import { extractSourceFonts } from "../fonts/registry.js";
-import { layoutFormula } from "../mathml/layout.js";
 import { readOdfFormulaContent as readOdfFormulaContent$1 } from "../odf/formula/read.js";
 import { readOdtContent as readOdtContent$1 } from "../odf/odt/read.js";
 import { convertWordprocessingToLayout } from "../layout/engine.js";

package/dist/convert/pdf-package-tables.cjs

@@ -67,10 +67,25 @@ function stampPdfPackageTables(pkg, layout) {
 			};
 		});
 	});
+	if (layout.structure !== void 0) walkStructureElements(layout.structure, void 0, definitions);
 	if (Object.keys(definitions).length > 0) pkg.definitions = {
 		...pkg.definitions,
 		...definitions
 	};
 }
+function walkStructureElements(elements, parentKey, definitions) {
+	for (const element of elements) {
+		definitions[element.id] = {
+			kind: "structure",
+			type: element.type,
+			...element.title !== void 0 ? { title: element.title } : {},
+			...element.language !== void 0 ? { language: element.language } : {},
+			...element.alt !== void 0 ? { alt: element.alt } : {},
+			...element.actualText !== void 0 ? { actualText: element.actualText } : {},
+			...parentKey !== void 0 ? { parent: parentKey } : {}
+		};
+		walkStructureElements(element.children, element.id, definitions);
+	}
+}
 //#endregion
 exports.stampPdfPackageTables = stampPdfPackageTables;

package/dist/convert/pdf-package-tables.js

@@ -66,10 +66,25 @@ function stampPdfPackageTables(pkg, layout) {
 			};
 		});
 	});
+	if (layout.structure !== void 0) walkStructureElements(layout.structure, void 0, definitions);
 	if (Object.keys(definitions).length > 0) pkg.definitions = {
 		...pkg.definitions,
 		...definitions
 	};
 }
+function walkStructureElements(elements, parentKey, definitions) {
+	for (const element of elements) {
+		definitions[element.id] = {
+			kind: "structure",
+			type: element.type,
+			...element.title !== void 0 ? { title: element.title } : {},
+			...element.language !== void 0 ? { language: element.language } : {},
+			...element.alt !== void 0 ? { alt: element.alt } : {},
+			...element.actualText !== void 0 ? { actualText: element.actualText } : {},
+			...parentKey !== void 0 ? { parent: parentKey } : {}
+		};
+		walkStructureElements(element.children, element.id, definitions);
+	}
+}
 //#endregion
 export { stampPdfPackageTables };

package/dist/edit/odg/content.cjs

@@ -41,7 +41,7 @@ function appendShape(page, shape) {
 	textShape.paragraphs()[0]?.remove();
 	for (const block of shape.blocks) {
 		if (block.kind !== "paragraph") continue;
-		require_edit_odt_content.populateParagraph(textShape.appendParagraph(), block);
+		require_edit_odt_content.populateParagraph(textShape.appendParagraph(), block, { headings: false });
 	}
 }
 //#endregion

package/dist/edit/odg/content.js

@@ -40,7 +40,7 @@ function appendShape(page, shape) {
 	textShape.paragraphs()[0]?.remove();
 	for (const block of shape.blocks) {
 		if (block.kind !== "paragraph") continue;
-		populateParagraph(textShape.appendParagraph(), block);
+		populateParagraph(textShape.appendParagraph(), block, { headings: false });
 	}
 }
 //#endregion

package/dist/edit/odg/page.d.cts

@@ -1,5 +1,5 @@
 import { t as ImageInit } from "../../image-3ql9_z1y.cjs";
-import { t as OdpShape } from "../../shape-Cuk0RTZn.cjs";
+import { t as OdpShape } from "../../shape-C56METn9.cjs";
 import { a as OdgLineVector, l as PathVectorInit, n as LineVectorInit, o as OdgPathVector, r as OdgBoxVector, s as OdgVector, t as BoxVectorInit } from "../../vector-D03KX8Ux.cjs";
 import { Box, ContentVector } from "document-schema.js";
 import { Package, XmlElement, XmlNode } from "odf.js";

package/dist/edit/odg/page.d.ts

@@ -1,5 +1,5 @@
 import { t as ImageInit } from "../../image-3ql9_z1y.js";
-import { t as OdpShape } from "../../shape-CCPBGhbV.js";
+import { t as OdpShape } from "../../shape-JrdFW78K.js";
 import { a as OdgLineVector, l as PathVectorInit, n as LineVectorInit, o as OdgPathVector, r as OdgBoxVector, s as OdgVector, t as BoxVectorInit } from "../../vector-D03KX8Ux.js";
 import { Box, ContentVector } from "document-schema.js";
 import { Package, XmlElement, XmlNode } from "odf.js";

package/dist/edit/odp/content.cjs

@@ -70,7 +70,7 @@ function appendShape(slide, shape) {
 	textShape.paragraphs()[0]?.remove();
 	for (const block of shape.blocks) {
 		if (block.kind !== "paragraph") continue;
-		require_edit_odt_content.populateParagraph(textShape.appendParagraph(), block);
+		require_edit_odt_content.populateParagraph(textShape.appendParagraph(), block, { headings: false });
 	}
 }
 //#endregion

package/dist/edit/odp/content.js

@@ -69,7 +69,7 @@ function appendShape(slide, shape) {
 	textShape.paragraphs()[0]?.remove();
 	for (const block of shape.blocks) {
 		if (block.kind !== "paragraph") continue;
-		populateParagraph(textShape.appendParagraph(), block);
+		populateParagraph(textShape.appendParagraph(), block, { headings: false });
 	}
 }
 //#endregion

package/dist/edit/odp/shape.d.cts

@@ -1,2 +1,2 @@
-import { i as buildTextBoxFrame, n as buildImageFrame, r as buildTableFrame, t as OdpShape } from "../../shape-Cuk0RTZn.cjs";
+import { i as buildTextBoxFrame, n as buildImageFrame, r as buildTableFrame, t as OdpShape } from "../../shape-C56METn9.cjs";
 export { OdpShape, buildImageFrame, buildTableFrame, buildTextBoxFrame };

package/dist/edit/odp/shape.d.ts

@@ -1,2 +1,2 @@
-import { i as buildTextBoxFrame, n as buildImageFrame, r as buildTableFrame, t as OdpShape } from "../../shape-CCPBGhbV.js";
+import { i as buildTextBoxFrame, n as buildImageFrame, r as buildTableFrame, t as OdpShape } from "../../shape-JrdFW78K.js";
 export { OdpShape, buildImageFrame, buildTableFrame, buildTextBoxFrame };

package/dist/edit/odp/slide.d.cts

@@ -1,7 +1,7 @@
 import { t as ImageInit } from "../../image-3ql9_z1y.cjs";
-import { t as OdpShape } from "../../shape-Cuk0RTZn.cjs";
+import { t as OdpShape } from "../../shape-C56METn9.cjs";
 import { s as OdgVector } from "../../vector-D03KX8Ux.cjs";
-import { a as TableInit, n as OdtTable } from "../../table-b9-ipGtZ.cjs";
+import { a as TableInit, n as OdtTable } from "../../table-Cu8f1XmW.cjs";
 import { Box, ContentFormula, ContentVector } from "document-schema.js";
 import { Package, XmlElement, XmlNode } from "odf.js";
 //#region src/edit/odp/slide.d.ts

package/dist/edit/odp/slide.d.ts

@@ -1,7 +1,7 @@
 import { t as ImageInit } from "../../image-3ql9_z1y.js";
-import { t as OdpShape } from "../../shape-CCPBGhbV.js";
+import { t as OdpShape } from "../../shape-JrdFW78K.js";
 import { s as OdgVector } from "../../vector-D03KX8Ux.js";
-import { a as TableInit, n as OdtTable } from "../../table-Dtml8NyR.js";
+import { a as TableInit, n as OdtTable } from "../../table-CY1ChByv.js";
 import { Box, ContentFormula, ContentVector } from "document-schema.js";
 import { Package, XmlElement, XmlNode } from "odf.js";
 //#region src/edit/odp/slide.d.ts

package/dist/edit/ods/cell.cjs

@@ -175,7 +175,7 @@ var OdsCell = class {
 		require_edit_odt_content.populateParagraph(paragraph, {
 			kind: "paragraph",
 			runs: [...runs]
-		});
+		}, { headings: false });
 	}
 };
 //#endregion

package/dist/edit/ods/cell.js

@@ -174,7 +174,7 @@ var OdsCell = class {
 		populateParagraph(paragraph, {
 			kind: "paragraph",
 			runs: [...runs]
-		});
+		}, { headings: false });
 	}
 };
 //#endregion

package/dist/edit/odt/content.cjs

@@ -23,7 +23,8 @@ function isMergeableImageParagraph(block) {
 }
 function appendMergedImageParagraph(body, paragraphBlock, imageBlock) {
 	const paragraph = body.appendParagraph();
-	if (paragraphBlock.styleId !== void 0) paragraph.styleId = paragraphBlock.styleId;
+	if (paragraphBlock.headingLevel !== void 0) paragraph.headingLevel = paragraphBlock.headingLevel;
+	else if (paragraphBlock.styleId !== void 0) paragraph.styleId = paragraphBlock.styleId;
 	if (paragraphBlock.alignment !== void 0) paragraph.alignment = paragraphBlock.alignment;
 	paragraph.insertImageAfter({
 		format: imageBlock.format,
@@ -83,12 +84,13 @@ function appendListRun(body, paragraphs) {
 		const currentList = stack[stack.length - 1];
 		if (currentList === void 0) continue;
 		const item = currentList.addItem();
-		populateParagraph(item.appendParagraph(), para);
+		populateParagraph(item.appendParagraph(), para, { headings: true });
 		lastItem = item;
 	}
 }
-function populateParagraph(paragraph, block) {
-	if (block.styleId !== void 0) paragraph.styleId = block.styleId;
+function populateParagraph(paragraph, block, options) {
+	if (options.headings && block.headingLevel !== void 0) paragraph.headingLevel = block.headingLevel;
+	else if (block.styleId !== void 0) paragraph.styleId = block.styleId;
 	if (block.alignment !== void 0) paragraph.alignment = block.alignment;
 	if (block.spacingBeforePt !== void 0) paragraph.spacingBeforePt = block.spacingBeforePt;
 	if (block.spacingAfterPt !== void 0) paragraph.spacingAfterPt = block.spacingAfterPt;
@@ -114,7 +116,7 @@ function populateParagraph(paragraph, block) {
 function populateCellBlocks(cell, blocks) {
 	const [firstBlock, ...restBlocks] = blocks;
 	const firstParagraph = cell.paragraphs()[0];
-	if (firstBlock?.kind === "paragraph" && firstParagraph !== void 0) populateParagraph(firstParagraph, firstBlock);
+	if (firstBlock?.kind === "paragraph" && firstParagraph !== void 0) populateParagraph(firstParagraph, firstBlock, { headings: false });
 	else if (firstBlock?.kind === "image" && firstParagraph !== void 0) firstParagraph.insertImageAfter({
 		format: firstBlock.format,
 		bytes: (0, odf_js.base64ToBytes)(firstBlock.base64),
@@ -172,7 +174,7 @@ function appendTable(body, block) {
 	}), block);
 }
 function appendCellBlock(cell, block) {
-	if (block.kind === "paragraph") populateParagraph(cell.appendParagraph(), block);
+	if (block.kind === "paragraph") populateParagraph(cell.appendParagraph(), block, { headings: false });
 	else if (block.kind === "image") cell.appendParagraph().insertImageAfter({
 		format: block.format,
 		bytes: (0, odf_js.base64ToBytes)(block.base64),
@@ -182,7 +184,7 @@ function appendCellBlock(cell, block) {
 	});
 }
 function appendBlock(body, block) {
-	if (block.kind === "paragraph") populateParagraph(body.appendParagraph(), block);
+	if (block.kind === "paragraph") populateParagraph(body.appendParagraph(), block, { headings: true });
 	else if (block.kind === "image") body.appendParagraph().insertImageAfter({
 		format: block.format,
 		bytes: (0, odf_js.base64ToBytes)(block.base64),
@@ -205,7 +207,7 @@ function appendEmbeddedObject(body, block) {
 		populateParagraph(body.appendParagraph(), {
 			kind: "paragraph",
 			runs: [{ text: require_model_formula.formulaPlaceholderText(formula) }]
-		});
+		}, { headings: false });
 		return;
 	}
 	body.appendFormula(formula, block.frame);

package/dist/edit/odt/content.d.cts

@@ -1,6 +1,6 @@
 import { t as ClockPort } from "../../clock-C7SUuYN0.cjs";
-import { t as OdtParagraph } from "../../paragraph-CdGRPSYA.cjs";
-import { n as OdtTable } from "../../table-b9-ipGtZ.cjs";
+import { t as OdtParagraph } from "../../paragraph-C9jf4pMK.cjs";
+import { n as OdtTable } from "../../table-Cu8f1XmW.cjs";
 import { ContentDocument, ContentParagraph, ContentTable } from "document-schema.js";
 import { Package } from "odf.js";
 //#region src/edit/odt/content.d.ts
@@ -8,7 +8,10 @@ interface BuildOdtPackageOptions {
   readonly clock?: ClockPort;
 }
 declare function buildOdtPackage(content: ContentDocument, options?: BuildOdtPackageOptions): Package;
-declare function populateParagraph(paragraph: OdtParagraph, block: ContentParagraph): void;
+interface PopulateParagraphOptions {
+  readonly headings: boolean;
+}
+declare function populateParagraph(paragraph: OdtParagraph, block: ContentParagraph, options: PopulateParagraphOptions): void;
 declare function populateOdtTable(table: OdtTable, block: ContentTable): void;
 //#endregion
-export { BuildOdtPackageOptions, buildOdtPackage, populateOdtTable, populateParagraph };
+export { BuildOdtPackageOptions, PopulateParagraphOptions, buildOdtPackage, populateOdtTable, populateParagraph };

package/dist/edit/odt/content.d.ts

@@ -1,6 +1,6 @@
 import { t as ClockPort } from "../../clock-C7SUuYN0.js";
-import { t as OdtParagraph } from "../../paragraph-BPRc-VVV.js";
-import { n as OdtTable } from "../../table-Dtml8NyR.js";
+import { t as OdtParagraph } from "../../paragraph-CeFnOpEi.js";
+import { n as OdtTable } from "../../table-CY1ChByv.js";
 import { ContentDocument, ContentParagraph, ContentTable } from "document-schema.js";
 import { Package } from "odf.js";
 //#region src/edit/odt/content.d.ts
@@ -8,7 +8,10 @@ interface BuildOdtPackageOptions {
   readonly clock?: ClockPort;
 }
 declare function buildOdtPackage(content: ContentDocument, options?: BuildOdtPackageOptions): Package;
-declare function populateParagraph(paragraph: OdtParagraph, block: ContentParagraph): void;
+interface PopulateParagraphOptions {
+  readonly headings: boolean;
+}
+declare function populateParagraph(paragraph: OdtParagraph, block: ContentParagraph, options: PopulateParagraphOptions): void;
 declare function populateOdtTable(table: OdtTable, block: ContentTable): void;
 //#endregion
-export { BuildOdtPackageOptions, buildOdtPackage, populateOdtTable, populateParagraph };
+export { BuildOdtPackageOptions, PopulateParagraphOptions, buildOdtPackage, populateOdtTable, populateParagraph };

package/dist/edit/odt/content.js

@@ -22,7 +22,8 @@ function isMergeableImageParagraph(block) {
 }
 function appendMergedImageParagraph(body, paragraphBlock, imageBlock) {
 	const paragraph = body.appendParagraph();
-	if (paragraphBlock.styleId !== void 0) paragraph.styleId = paragraphBlock.styleId;
+	if (paragraphBlock.headingLevel !== void 0) paragraph.headingLevel = paragraphBlock.headingLevel;
+	else if (paragraphBlock.styleId !== void 0) paragraph.styleId = paragraphBlock.styleId;
 	if (paragraphBlock.alignment !== void 0) paragraph.alignment = paragraphBlock.alignment;
 	paragraph.insertImageAfter({
 		format: imageBlock.format,
@@ -82,12 +83,13 @@ function appendListRun(body, paragraphs) {
 		const currentList = stack[stack.length - 1];
 		if (currentList === void 0) continue;
 		const item = currentList.addItem();
-		populateParagraph(item.appendParagraph(), para);
+		populateParagraph(item.appendParagraph(), para, { headings: true });
 		lastItem = item;
 	}
 }
-function populateParagraph(paragraph, block) {
-	if (block.styleId !== void 0) paragraph.styleId = block.styleId;
+function populateParagraph(paragraph, block, options) {
+	if (options.headings && block.headingLevel !== void 0) paragraph.headingLevel = block.headingLevel;
+	else if (block.styleId !== void 0) paragraph.styleId = block.styleId;
 	if (block.alignment !== void 0) paragraph.alignment = block.alignment;
 	if (block.spacingBeforePt !== void 0) paragraph.spacingBeforePt = block.spacingBeforePt;
 	if (block.spacingAfterPt !== void 0) paragraph.spacingAfterPt = block.spacingAfterPt;
@@ -113,7 +115,7 @@ function populateParagraph(paragraph, block) {
 function populateCellBlocks(cell, blocks) {
 	const [firstBlock, ...restBlocks] = blocks;
 	const firstParagraph = cell.paragraphs()[0];
-	if (firstBlock?.kind === "paragraph" && firstParagraph !== void 0) populateParagraph(firstParagraph, firstBlock);
+	if (firstBlock?.kind === "paragraph" && firstParagraph !== void 0) populateParagraph(firstParagraph, firstBlock, { headings: false });
 	else if (firstBlock?.kind === "image" && firstParagraph !== void 0) firstParagraph.insertImageAfter({
 		format: firstBlock.format,
 		bytes: base64ToBytes(firstBlock.base64),
@@ -171,7 +173,7 @@ function appendTable(body, block) {
 	}), block);
 }
 function appendCellBlock(cell, block) {
-	if (block.kind === "paragraph") populateParagraph(cell.appendParagraph(), block);
+	if (block.kind === "paragraph") populateParagraph(cell.appendParagraph(), block, { headings: false });
 	else if (block.kind === "image") cell.appendParagraph().insertImageAfter({
 		format: block.format,
 		bytes: base64ToBytes(block.base64),
@@ -181,7 +183,7 @@ function appendCellBlock(cell, block) {
 	});
 }
 function appendBlock(body, block) {
-	if (block.kind === "paragraph") populateParagraph(body.appendParagraph(), block);
+	if (block.kind === "paragraph") populateParagraph(body.appendParagraph(), block, { headings: true });
 	else if (block.kind === "image") body.appendParagraph().insertImageAfter({
 		format: block.format,
 		bytes: base64ToBytes(block.base64),
@@ -204,7 +206,7 @@ function appendEmbeddedObject(body, block) {
 		populateParagraph(body.appendParagraph(), {
 			kind: "paragraph",
 			runs: [{ text: formulaPlaceholderText(formula) }]
-		});
+		}, { headings: false });
 		return;
 	}
 	body.appendFormula(formula, block.frame);

package/dist/edit/odt/editor.cjs

@@ -80,7 +80,7 @@ var OdtEditor = class {
 	paragraphs() {
 		const officeText = findOfficeText(findContentRoot(this.pkg));
 		const out = [];
-		for (const child of officeText.children) if (child.type === "element" && child.tag === "text:p") out.push(new require_edit_odt_paragraph.OdtParagraph(officeText.children, child, this.pkg));
+		for (const child of officeText.children) if (child.type === "element" && (child.tag === "text:p" || child.tag === "text:h")) out.push(new require_edit_odt_paragraph.OdtParagraph(officeText.children, child, this.pkg));
 		return out;
 	}
 	tables() {

package/dist/edit/odt/editor.d.cts

@@ -1,7 +1,7 @@
 import { t as ClockPort } from "../../clock-C7SUuYN0.cjs";
-import { n as ParagraphInit, t as OdtParagraph } from "../../paragraph-CdGRPSYA.cjs";
-import { t as OdtList } from "../../list-BT1Zb3PV.cjs";
-import { a as TableInit, n as OdtTable } from "../../table-b9-ipGtZ.cjs";
+import { n as ParagraphInit, t as OdtParagraph } from "../../paragraph-C9jf4pMK.cjs";
+import { t as OdtList } from "../../list-CzGRStUr.cjs";
+import { a as TableInit, n as OdtTable } from "../../table-Cu8f1XmW.cjs";
 import { Box, ContentFormula, ContentVector } from "document-schema.js";
 import { Package } from "odf.js";
 //#region src/edit/odt/editor.d.ts

package/dist/edit/odt/editor.d.ts

@@ -1,7 +1,7 @@
 import { t as ClockPort } from "../../clock-C7SUuYN0.js";
-import { n as ParagraphInit, t as OdtParagraph } from "../../paragraph-BPRc-VVV.js";
-import { t as OdtList } from "../../list-D9MtQtjK.js";
-import { a as TableInit, n as OdtTable } from "../../table-Dtml8NyR.js";
+import { n as ParagraphInit, t as OdtParagraph } from "../../paragraph-CeFnOpEi.js";
+import { t as OdtList } from "../../list-Cg_zlwVv.js";
+import { a as TableInit, n as OdtTable } from "../../table-CY1ChByv.js";
 import { Box, ContentFormula, ContentVector } from "document-schema.js";
 import { Package } from "odf.js";
 //#region src/edit/odt/editor.d.ts

package/dist/edit/odt/editor.js

@@ -79,7 +79,7 @@ var OdtEditor = class {
 	paragraphs() {
 		const officeText = findOfficeText(findContentRoot(this.pkg));
 		const out = [];
-		for (const child of officeText.children) if (child.type === "element" && child.tag === "text:p") out.push(new OdtParagraph(officeText.children, child, this.pkg));
+		for (const child of officeText.children) if (child.type === "element" && (child.tag === "text:p" || child.tag === "text:h")) out.push(new OdtParagraph(officeText.children, child, this.pkg));
 		return out;
 	}
 	tables() {

package/dist/edit/odt/list.cjs

@@ -35,7 +35,7 @@ var OdtListItem = class {
 	}
 	paragraphs() {
 		const out = [];
-		for (const child of this.node.children) if (child.type === "element" && child.tag === "text:p") out.push(new require_edit_odt_paragraph.OdtParagraph(this.node.children, child, this.pkg));
+		for (const child of this.node.children) if (child.type === "element" && (child.tag === "text:p" || child.tag === "text:h")) out.push(new require_edit_odt_paragraph.OdtParagraph(this.node.children, child, this.pkg));
 		return out;
 	}
 	get text() {

package/dist/edit/odt/list.d.cts

@@ -1,2 +1,2 @@
-import { n as OdtListItem, r as buildList, t as OdtList } from "../../list-BT1Zb3PV.cjs";
+import { n as OdtListItem, r as buildList, t as OdtList } from "../../list-CzGRStUr.cjs";
 export { OdtList, OdtListItem, buildList };

package/dist/edit/odt/list.d.ts

@@ -1,2 +1,2 @@
-import { n as OdtListItem, r as buildList, t as OdtList } from "../../list-D9MtQtjK.js";
+import { n as OdtListItem, r as buildList, t as OdtList } from "../../list-Cg_zlwVv.js";
 export { OdtList, OdtListItem, buildList };

package/dist/edit/odt/list.js

@@ -34,7 +34,7 @@ var OdtListItem = class {
 	}
 	paragraphs() {
 		const out = [];
-		for (const child of this.node.children) if (child.type === "element" && child.tag === "text:p") out.push(new OdtParagraph(this.node.children, child, this.pkg));
+		for (const child of this.node.children) if (child.type === "element" && (child.tag === "text:p" || child.tag === "text:h")) out.push(new OdtParagraph(this.node.children, child, this.pkg));
 		return out;
 	}
 	get text() {

package/dist/edit/odt/paragraph.cjs

@@ -71,6 +71,26 @@ var OdtParagraph = class {
 		}
 		require_xml_edit.setAttr(node, "text:style-name", value);
 	}
+	get headingLevel() {
+		const node = this.live();
+		if (node.tag !== "text:h") return;
+		const raw = (0, ooxml_js.attr)(node, "text:outline-level");
+		if (raw === void 0) return 1;
+		const parsed = Number.parseInt(raw, 10);
+		return Number.isInteger(parsed) && parsed > 0 ? parsed : 1;
+	}
+	set headingLevel(value) {
+		const node = this.live();
+		if (value === void 0) {
+			node.tag = "text:p";
+			require_xml_edit.removeAttr(node, "text:outline-level");
+			require_xml_edit.removeAttr(node, "text:style-name");
+			return;
+		}
+		node.tag = "text:h";
+		require_xml_edit.setAttr(node, "text:outline-level", String(value));
+		require_xml_edit.setAttr(node, "text:style-name", `Heading_20_${String(value)}`);
+	}
 	get alignment() {
 		return require_edit_odt_props.readCurrentStyleProperties(this.pkg, this.live(), "paragraph").alignment;
 	}
@@ -125,7 +145,8 @@ var OdtParagraph = class {
 function buildParagraph(pkg, init = {}) {
 	const node = require_xml_fragment.el("text:p");
 	const paragraph = new OdtParagraph([], node, pkg);
-	if (init.styleId !== void 0) paragraph.styleId = init.styleId;
+	if (init.headingLevel !== void 0) paragraph.headingLevel = init.headingLevel;
+	else if (init.styleId !== void 0) paragraph.styleId = init.styleId;
 	if (init.alignment !== void 0) paragraph.alignment = init.alignment;
 	if (init.text !== void 0) node.children.push(require_edit_odt_run.buildRun(pkg, { text: init.text }));
 	return node;

package/dist/edit/odt/paragraph.d.cts

@@ -1,2 +1,2 @@
-import { n as ParagraphInit, r as buildParagraph, t as OdtParagraph } from "../../paragraph-CdGRPSYA.cjs";
+import { n as ParagraphInit, r as buildParagraph, t as OdtParagraph } from "../../paragraph-C9jf4pMK.cjs";
 export { OdtParagraph, ParagraphInit, buildParagraph };

package/dist/edit/odt/paragraph.d.ts

@@ -1,2 +1,2 @@
-import { n as ParagraphInit, r as buildParagraph, t as OdtParagraph } from "../../paragraph-BPRc-VVV.js";
+import { n as ParagraphInit, r as buildParagraph, t as OdtParagraph } from "../../paragraph-CeFnOpEi.js";
 export { OdtParagraph, ParagraphInit, buildParagraph };

package/dist/edit/odt/paragraph.js

@@ -70,6 +70,26 @@ var OdtParagraph = class {
 		}
 		setAttr(node, "text:style-name", value);
 	}
+	get headingLevel() {
+		const node = this.live();
+		if (node.tag !== "text:h") return;
+		const raw = attr(node, "text:outline-level");
+		if (raw === void 0) return 1;
+		const parsed = Number.parseInt(raw, 10);
+		return Number.isInteger(parsed) && parsed > 0 ? parsed : 1;
+	}
+	set headingLevel(value) {
+		const node = this.live();
+		if (value === void 0) {
+			node.tag = "text:p";
+			removeAttr(node, "text:outline-level");
+			removeAttr(node, "text:style-name");
+			return;
+		}
+		node.tag = "text:h";
+		setAttr(node, "text:outline-level", String(value));
+		setAttr(node, "text:style-name", `Heading_20_${String(value)}`);
+	}
 	get alignment() {
 		return readCurrentStyleProperties(this.pkg, this.live(), "paragraph").alignment;
 	}
@@ -124,7 +144,8 @@ var OdtParagraph = class {
 function buildParagraph(pkg, init = {}) {
 	const node = el("text:p");
 	const paragraph = new OdtParagraph([], node, pkg);
-	if (init.styleId !== void 0) paragraph.styleId = init.styleId;
+	if (init.headingLevel !== void 0) paragraph.headingLevel = init.headingLevel;
+	else if (init.styleId !== void 0) paragraph.styleId = init.styleId;
 	if (init.alignment !== void 0) paragraph.alignment = init.alignment;
 	if (init.text !== void 0) node.children.push(buildRun(pkg, { text: init.text }));
 	return node;

package/dist/edit/odt/scaffold.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_xml_fragment = require("../../xml/fragment.cjs");
 const require_xml_entities = require("../../xml/entities.cjs");
+const require_layout_shared = require("../../layout/shared.cjs");
 let document_schema_js = require("document-schema.js");
 let odf_js = require("odf.js");
 //#region src/edit/odt/scaffold.ts
@@ -62,12 +63,22 @@ function buildPageLayout() {
 		"fo:margin-left": `${DEFAULT_MARGIN_PT}pt`
 	})]);
 }
+function buildHeadingStyles() {
+	return Object.entries(require_layout_shared.HEADING_STYLES).map(([level, style]) => require_xml_fragment.el("style:style", {
+		"style:name": `Heading_20_${level}`,
+		"style:display-name": `Heading ${level}`,
+		"style:family": "paragraph"
+	}, [require_xml_fragment.el("style:text-properties", {
+		"fo:font-size": `${String(style.sizePt)}pt`,
+		"fo:font-weight": style.bold ? "bold" : "normal"
+	})]));
+}
 function buildStylesXml() {
 	return require_xml_fragment.el("office:document-styles", {
 		...(0, odf_js.xmlnsAttributes)([...STYLES_NS_PREFIXES]),
 		"office:version": ODF_VERSION
 	}, [
-		require_xml_fragment.el("office:styles"),
+		require_xml_fragment.el("office:styles", {}, buildHeadingStyles()),
 		require_xml_fragment.el("office:automatic-styles", {}, [buildPageLayout()]),
 		require_xml_fragment.el("office:master-styles", {}, [require_xml_fragment.el("style:master-page", {
 			"style:name": MASTER_PAGE_NAME,

package/dist/edit/odt/scaffold.js

@@ -1,5 +1,6 @@
 import { el, txt } from "../../xml/fragment.js";
 import { encodeXmlText as encodeXmlText$1 } from "../../xml/entities.js";
+import { HEADING_STYLES } from "../../layout/shared.js";
 import { PAGE_SIZE_LETTER } from "document-schema.js";
 import { ODF_MEDIA_TYPES, setDocumentMediaType, syncManifest, xmlnsAttributes } from "odf.js";
 //#region src/edit/odt/scaffold.ts
@@ -61,12 +62,22 @@ function buildPageLayout() {
 		"fo:margin-left": `${DEFAULT_MARGIN_PT}pt`
 	})]);
 }
+function buildHeadingStyles() {
+	return Object.entries(HEADING_STYLES).map(([level, style]) => el("style:style", {
+		"style:name": `Heading_20_${level}`,
+		"style:display-name": `Heading ${level}`,
+		"style:family": "paragraph"
+	}, [el("style:text-properties", {
+		"fo:font-size": `${String(style.sizePt)}pt`,
+		"fo:font-weight": style.bold ? "bold" : "normal"
+	})]));
+}
 function buildStylesXml() {
 	return el("office:document-styles", {
 		...xmlnsAttributes([...STYLES_NS_PREFIXES]),
 		"office:version": ODF_VERSION
 	}, [
-		el("office:styles"),
+		el("office:styles", {}, buildHeadingStyles()),
 		el("office:automatic-styles", {}, [buildPageLayout()]),
 		el("office:master-styles", {}, [el("style:master-page", {
 			"style:name": MASTER_PAGE_NAME,