documents.js 4.1.0 → 4.2.0

package/README.md

@@ -116,7 +116,7 @@ const pdfFromXlsx = xlsxToPdf(xlsxBytes); // composes xlsxToOds -> odsToPdf inte
 const xlsxBytes2 = pdfToXlsx(pdfFromXlsx); // composes pdfToOds -> odsToXlsx internally
 
 const pdfFromMarkdown = markdownToPdf(markdownBytes);
-const markdownBytes2 = pdfToMarkdown(pdfFromMarkdown); // the lossiest conversion in the whole package -- see Fidelity
+const markdownBytes2 = pdfToMarkdown(pdfFromMarkdown); // the lossiest conversion in the whole package -- see Fidelity; it does carry page boundaries (one '<!-- page break -->' marker per page) and rank-inferred heading levels
 
 const pdfFromCsv = csvToPdf(csvBytes); // composes csvToOds -> odsToPdf internally
 const csvBytes2 = pdfToCsv(pdfFromCsv); // composes pdfToOds -> odsToCsv internally; recovers what was printed, then heuristically re-types it
@@ -127,6 +127,8 @@ const svgBytes2 = pdfToSvg(pdfFromSvg); // readPdf -> reconstructDrawing -> buil
 
 Each accepts an optional `signal` (`AbortSignal`) and either `onSubstitution` (X → PDF, called per character not representable in a standard-14 font) or `sink` (PDF → X, called per recoverable parse diagnostic). Every X → PDF conversion additionally accepts `fonts` (extra `ProvidedFont` faces) and `onFontSubstitution` (per family+weight+style that resolved to something else). Neither is needed for the common case — see [Fonts](#fonts).
 
+**Cancellation granularity, for CPU-metered runtimes** (ExaDev/documents.js#585): every conversion here is synchronous end to end, and the `signal` is honoured at page boundaries — once per page in pdf-codec's `readPdf`/`writePdf` page loops and once per page in each of this package's four reconstructors (wordprocessing/presentation/drawing/spreadsheet). An abort arriving mid-conversion therefore takes effect at the next page boundary, not instantly: a single page's content-stream interpretation, pdf-codec's document-open phase, and the per-target build/encode stage after reconstruction are not interruptible, and parse cost is roughly linear in decompressed content length — budget for the worst single page, not the page count. A shared `AbortSignal` makes a deadline enforceable at that granularity on Cloudflare Workers; it cannot convert a synchronous conversion into a resumable or streaming one (an async page-at-a-time API is a deliberate non-goal of the current surface — see pdf-codec's README for the same statement from the codec side).
+
 ### Cross-format bridges
 
 Twenty-four bridge functions across twelve pairs bypass the PDF pivot where a direct path exists. Eight same-variant direct-copy pairs (`odtToDocx`/`docxToOdt`, `odpToPptx`/`pptxToOdp`, `odsToXlsx`/`xlsxToOds`, `csvToOds`/`odsToCsv`, `csvToXlsx`/`xlsxToCsv`, `svgToOdg`/`odgToSvg`, `markdownToDocx`/`docxToMarkdown`, `markdownToOdt`/`odtToMarkdown`) compose a direct `readXContent` → `buildYPackage` pivot copy — the csv pairs are one hop to its spreadsheet siblings, so csv never needs PDF to reach ods or xlsx, and `svgToOdg`/`odgToSvg` bridge svg to its drawing sibling odg the same way. Two cross-variant semantic-transform pairs (`docxToPptx`/`pptxToDocx`, `odtToOdp`/`odpToOdt`) go through `src/convert/variant-bridges.ts`. Two PDF-composed pairs (`xlsxToMarkdown`/`markdownToXlsx`, `csvToMarkdown`/`markdownToCsv`) route through PDF internally — the lossiest conversions in the package.
@@ -716,7 +718,7 @@ Read as **row → column**. `✓` lossless, `~` bounded, `✗` lossy, `✗✗` s
 
 **PDF → ods** recovers what was printed, not what was entered. The printed string always survives in `displayText`; re-typed `value` is explicitly probabilistic inference.
 
-**`markdownToPdf`/`pdfToMarkdown`** is the lossiest round trip: `markdownToPdf` is faithful, but `pdfToMarkdown` stacks reconstruction lossiness PLUS markdown's coarser vocabulary (no colour, font, size, alignment). The PDF-composed markdown bridges (`xlsxToMarkdown`/`markdownToXlsx`, `csvToMarkdown`/`markdownToCsv`) stack the same two losses in both directions — hence their `✗✗` cells.
+**`markdownToPdf`/`pdfToMarkdown`** is the lossiest round trip: `markdownToPdf` is faithful, but `pdfToMarkdown` stacks reconstruction lossiness PLUS markdown's coarser vocabulary (no colour, font, size, alignment). Two structure signals do survive it (ExaDev/documents.js#584): every page boundary arrives as an exact `<!-- page break -->` marker (one per boundary — the one fact a rendered PDF states precisely), and headings are inferred from font size — each distinct size at least 2pt above the document's modal body size is a heading, ranked largest-first into `Heading1..6`, which inverts this package's own heading render sizes exactly and is a heuristic (the well-worn "largest text is the title" reading) for any other producer. Tables reach markdown as GFM pipe tables wherever the gridline-lattice gate succeeds; a table rendered without drawn gridlines (which includes every `markdownToPdf`-authored one, markdown carrying no border concept) correctly comes back as tab-separated prose rather than invented structure. The PDF-composed markdown bridges (`xlsxToMarkdown`/`markdownToXlsx`, `csvToMarkdown`/`markdownToCsv`) stack the same two losses in both directions — hence their `✗✗` cells.
 
 **The six same-variant bridge pairs** (odt⇄docx, odp⇄pptx, ods⇄xlsx, csv⇄ods, csv⇄xlsx, svg⇄odg) bypass PDF entirely — no layout engine, no reconstruction. Text, styling, tables, lists, rotated shapes survive completely. `ods⇄xlsx` has small format-boundary limits (time cells, formula dialects). Embedded formulas survive `odtToDocx` as real OOXML math. The csv pairs are bounded by what csv itself carries: toward ods/xlsx nothing the csv had is lost, while writing to csv collapses each cell to its `displayText` — formulas become their rendered values, formatting disappears, and a multi-sheet source must name the sheet it wants. The svg pair carries the six vector primitives losslessly in both directions; its one asymmetry is paint defaults — SVG's absent-fill-is-black versus a drawing frame's no-fill.
 

package/dist/codecs/registry.cjs

@@ -5,8 +5,8 @@ const require_edit_odt_content = require("../edit/odt/content.cjs");
 const require_edit_odp_content = require("../edit/odp/content.cjs");
 const require_edit_ods_content = require("../edit/ods/content.cjs");
 const require_edit_odg_content = require("../edit/odg/content.cjs");
-const require_markdown_read = require("../markdown/read.cjs");
 const require_markdown_write = require("../markdown/write.cjs");
+const require_markdown_read = require("../markdown/read.cjs");
 const require_ooxml_docx_read = require("../ooxml/docx/read.cjs");
 const require_ooxml_pptx_read = require("../ooxml/pptx/read.cjs");
 const require_odf_formula_read = require("../odf/formula/read.cjs");

package/dist/codecs/registry.js

@@ -4,8 +4,8 @@ import { buildOdtPackage } from "../edit/odt/content.js";
 import { buildOdpPackage } from "../edit/odp/content.js";
 import { buildOdsPackage } from "../edit/ods/content.js";
 import { buildOdgPackage } from "../edit/odg/content.js";
-import { readMarkdownContent } from "../markdown/read.js";
 import { buildMarkdownText } from "../markdown/write.js";
+import { readMarkdownContent } from "../markdown/read.js";
 import { readDocxContent as readDocxContent$1 } from "../ooxml/docx/read.js";
 import { readPptxContent as readPptxContent$1 } from "../ooxml/pptx/read.js";
 import { readOdfFormulaContent } from "../odf/formula/read.js";

package/dist/convert/composition.cjs

@@ -5,8 +5,8 @@ const require_edit_odt_content = require("../edit/odt/content.cjs");
 const require_edit_odp_content = require("../edit/odp/content.cjs");
 const require_edit_ods_content = require("../edit/ods/content.cjs");
 const require_edit_odg_content = require("../edit/odg/content.cjs");
-const require_markdown_read = require("../markdown/read.cjs");
 const require_markdown_write = require("../markdown/write.cjs");
+const require_markdown_read = require("../markdown/read.cjs");
 const require_ooxml_docx_read = require("../ooxml/docx/read.cjs");
 const require_ooxml_pptx_read = require("../ooxml/pptx/read.cjs");
 const require_odf_odt_read = require("../odf/odt/read.cjs");

package/dist/convert/composition.js

@@ -4,8 +4,8 @@ import { buildOdtPackage } from "../edit/odt/content.js";
 import { buildOdpPackage } from "../edit/odp/content.js";
 import { buildOdsPackage } from "../edit/ods/content.js";
 import { buildOdgPackage } from "../edit/odg/content.js";
-import { readMarkdownContent as readMarkdownContent$1 } from "../markdown/read.js";
 import { buildMarkdownText } from "../markdown/write.js";
+import { readMarkdownContent as readMarkdownContent$1 } from "../markdown/read.js";
 import { readDocxContent as readDocxContent$1 } from "../ooxml/docx/read.js";
 import { readPptxContent as readPptxContent$1 } from "../ooxml/pptx/read.js";
 import { readOdtContent as readOdtContent$1 } from "../odf/odt/read.js";

package/dist/edit/docx/content.cjs

@@ -123,6 +123,7 @@ function populateParagraph(paragraph, block) {
 	paragraph.styleId = block.styleId;
 	paragraph.alignment = block.alignment;
 	paragraph.list = block.list;
+	if (block.headingLevel !== void 0) paragraph.headingLevel = block.headingLevel;
 	if (block.spacingBeforePt !== void 0) paragraph.spacingBeforePt = block.spacingBeforePt;
 	if (block.spacingAfterPt !== void 0) paragraph.spacingAfterPt = block.spacingAfterPt;
 	if (block.lineSpacing !== void 0) paragraph.lineSpacing = block.lineSpacing;

package/dist/edit/docx/content.js

@@ -122,6 +122,7 @@ function populateParagraph(paragraph, block) {
 	paragraph.styleId = block.styleId;
 	paragraph.alignment = block.alignment;
 	paragraph.list = block.list;
+	if (block.headingLevel !== void 0) paragraph.headingLevel = block.headingLevel;
 	if (block.spacingBeforePt !== void 0) paragraph.spacingBeforePt = block.spacingBeforePt;
 	if (block.spacingAfterPt !== void 0) paragraph.spacingAfterPt = block.spacingAfterPt;
 	if (block.lineSpacing !== void 0) paragraph.lineSpacing = block.lineSpacing;

package/dist/edit/docx/paragraph.cjs

@@ -208,6 +208,22 @@ var DocxParagraph = class {
 		const numPr = require_xml_edit.getOrCreateChildElement(pPr, "w:numPr", require_edit_docx_props.PPR_ORDER, () => require_xml_fragment.el("w:numPr"));
 		numPr.children = [require_xml_fragment.el("w:ilvl", { "w:val": String(value.level) }), require_xml_fragment.el("w:numId", { "w:val": value.numId })];
 	}
+	get headingLevel() {
+		const pPr = this.pPr(false);
+		const outlineLvl = pPr === void 0 ? void 0 : directChild(pPr, "w:outlineLvl");
+		const val = outlineLvl === void 0 ? void 0 : (0, ooxml_js.attr)(outlineLvl, "w:val");
+		return val === void 0 ? void 0 : Number(val) + 1;
+	}
+	set headingLevel(value) {
+		if (value === void 0) {
+			const pPr = this.pPr(false);
+			const existing = pPr === void 0 ? void 0 : directChild(pPr, "w:outlineLvl");
+			if (existing !== void 0 && pPr !== void 0) require_xml_edit.removeChild(pPr.children, existing);
+			return;
+		}
+		const outlineLvl = require_xml_edit.getOrCreateChildElement(this.pPr(true), "w:outlineLvl", require_edit_docx_props.PPR_ORDER, () => require_xml_fragment.el("w:outlineLvl"));
+		require_xml_edit.setAttr(outlineLvl, "w:val", String(value - 1));
+	}
 	appendOfficeMath(mathml) {
 		const node = this.live();
 		const result = require_omml_write.buildOfficeMathParagraph(mathml);
@@ -256,10 +272,11 @@ var DocxParagraph = class {
 };
 function buildParagraph(init = {}) {
 	const paragraph = require_xml_fragment.el("w:p");
-	if (init.styleId !== void 0 || init.alignment !== void 0) {
+	if (init.styleId !== void 0 || init.alignment !== void 0 || init.headingLevel !== void 0) {
 		const pPr = require_xml_fragment.el("w:pPr");
 		if (init.styleId !== void 0) pPr.children.push(require_xml_fragment.el("w:pStyle", { "w:val": init.styleId }));
 		if (init.alignment !== void 0) pPr.children.push(require_xml_fragment.el("w:jc", { "w:val": init.alignment === "justify" ? "both" : init.alignment }));
+		if (init.headingLevel !== void 0) pPr.children.push(require_xml_fragment.el("w:outlineLvl", { "w:val": String(init.headingLevel - 1) }));
 		paragraph.children.push(pPr);
 	}
 	if (init.text !== void 0) paragraph.children.push(require_edit_docx_run.buildRun({ text: init.text }));

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

@@ -8,6 +8,7 @@ import { Package, XmlElement, XmlNode } from "ooxml.js";
 interface ParagraphInit {
   readonly text?: string;
   readonly styleId?: string;
+  readonly headingLevel?: number;
   readonly alignment?: 'left' | 'center' | 'right' | 'justify';
 }
 interface ImageMediaContext {
@@ -47,6 +48,8 @@ declare class DocxParagraph {
   set indentFirstLinePt(value: number | undefined);
   get list(): ContentListMembership | undefined;
   set list(value: ContentListMembership | undefined);
+  get headingLevel(): number | undefined;
+  set headingLevel(value: number | undefined);
   appendOfficeMath(mathml: readonly MathMlNode$1[]): OmmlWriteResult & {
     readonly written: boolean;
   };

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

@@ -8,6 +8,7 @@ import { ContentListMembership, ContentVector } from "document-schema.js";
 interface ParagraphInit {
   readonly text?: string;
   readonly styleId?: string;
+  readonly headingLevel?: number;
   readonly alignment?: 'left' | 'center' | 'right' | 'justify';
 }
 interface ImageMediaContext {
@@ -47,6 +48,8 @@ declare class DocxParagraph {
   set indentFirstLinePt(value: number | undefined);
   get list(): ContentListMembership | undefined;
   set list(value: ContentListMembership | undefined);
+  get headingLevel(): number | undefined;
+  set headingLevel(value: number | undefined);
   appendOfficeMath(mathml: readonly MathMlNode$1[]): OmmlWriteResult & {
     readonly written: boolean;
   };

package/dist/edit/docx/paragraph.js

@@ -207,6 +207,22 @@ var DocxParagraph = class {
 		const numPr = getOrCreateChildElement(pPr, "w:numPr", PPR_ORDER, () => el("w:numPr"));
 		numPr.children = [el("w:ilvl", { "w:val": String(value.level) }), el("w:numId", { "w:val": value.numId })];
 	}
+	get headingLevel() {
+		const pPr = this.pPr(false);
+		const outlineLvl = pPr === void 0 ? void 0 : directChild(pPr, "w:outlineLvl");
+		const val = outlineLvl === void 0 ? void 0 : attr(outlineLvl, "w:val");
+		return val === void 0 ? void 0 : Number(val) + 1;
+	}
+	set headingLevel(value) {
+		if (value === void 0) {
+			const pPr = this.pPr(false);
+			const existing = pPr === void 0 ? void 0 : directChild(pPr, "w:outlineLvl");
+			if (existing !== void 0 && pPr !== void 0) removeChild(pPr.children, existing);
+			return;
+		}
+		const outlineLvl = getOrCreateChildElement(this.pPr(true), "w:outlineLvl", PPR_ORDER, () => el("w:outlineLvl"));
+		setAttr(outlineLvl, "w:val", String(value - 1));
+	}
 	appendOfficeMath(mathml) {
 		const node = this.live();
 		const result = buildOfficeMathParagraph(mathml);
@@ -255,10 +271,11 @@ var DocxParagraph = class {
 };
 function buildParagraph(init = {}) {
 	const paragraph = el("w:p");
-	if (init.styleId !== void 0 || init.alignment !== void 0) {
+	if (init.styleId !== void 0 || init.alignment !== void 0 || init.headingLevel !== void 0) {
 		const pPr = el("w:pPr");
 		if (init.styleId !== void 0) pPr.children.push(el("w:pStyle", { "w:val": init.styleId }));
 		if (init.alignment !== void 0) pPr.children.push(el("w:jc", { "w:val": init.alignment === "justify" ? "both" : init.alignment }));
+		if (init.headingLevel !== void 0) pPr.children.push(el("w:outlineLvl", { "w:val": String(init.headingLevel - 1) }));
 		paragraph.children.push(pPr);
 	}
 	if (init.text !== void 0) paragraph.children.push(buildRun({ text: init.text }));

package/dist/edit/docx/props.cjs

@@ -24,6 +24,7 @@ const PPR_ORDER = [
 	"w:spacing",
 	"w:ind",
 	"w:jc",
+	"w:outlineLvl",
 	"w:rPr"
 ];
 function ensureFirstChild(parent, tag) {

package/dist/edit/docx/props.js

@@ -23,6 +23,7 @@ const PPR_ORDER = [
 	"w:spacing",
 	"w:ind",
 	"w:jc",
+	"w:outlineLvl",
 	"w:rPr"
 ];
 function ensureFirstChild(parent, tag) {

package/dist/edit/markdown/editor.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_model_metadata = require("../../model/metadata.cjs");
 const require_ports_clock = require("../../ports/clock.cjs");
-const require_markdown_read = require("../../markdown/read.cjs");
 const require_markdown_write = require("../../markdown/write.cjs");
+const require_markdown_read = require("../../markdown/read.cjs");
 const require_edit_markdown_paragraph = require("./paragraph.cjs");
 const require_edit_markdown_list = require("./list.cjs");
 const require_edit_markdown_table = require("./table.cjs");

package/dist/edit/markdown/editor.js

@@ -1,7 +1,7 @@
 import { resolveMetadataTimestamps } from "../../model/metadata.js";
 import { systemClock } from "../../ports/clock.js";
-import { readMarkdownContent as readMarkdownContent$1 } from "../../markdown/read.js";
 import { buildMarkdownText } from "../../markdown/write.js";
+import { readMarkdownContent as readMarkdownContent$1 } from "../../markdown/read.js";
 import { MarkdownParagraph, buildParagraph } from "./paragraph.js";
 import { MarkdownList } from "./list.js";
 import { MarkdownTable, buildTable } from "./table.js";

package/dist/index.cjs

@@ -39,8 +39,8 @@ const require_edit_odg_editor = require("./edit/odg/editor.cjs");
 const require_edit_odg_content = require("./edit/odg/content.cjs");
 const require_latex_lower = require("./latex/lower.cjs");
 const require_markdown_math = require("./markdown/math.cjs");
-const require_markdown_read = require("./markdown/read.cjs");
 const require_markdown_write = require("./markdown/write.cjs");
+const require_markdown_read = require("./markdown/read.cjs");
 const require_edit_markdown_run = require("./edit/markdown/run.cjs");
 const require_edit_markdown_paragraph = require("./edit/markdown/paragraph.cjs");
 const require_edit_markdown_list = require("./edit/markdown/list.cjs");

package/dist/index.js

@@ -38,8 +38,8 @@ import { OdgEditor, createOdg, openOdg } from "./edit/odg/editor.js";
 import { buildOdgPackage } from "./edit/odg/content.js";
 import { latexToFormula, lowerLatex } from "./latex/lower.js";
 import { lowerMarkdownMath } from "./markdown/math.js";
-import { readMarkdownContent } from "./markdown/read.js";
 import { MarkdownConstructUnsupportedError, buildMarkdownText } from "./markdown/write.js";
+import { readMarkdownContent } from "./markdown/read.js";
 import { MarkdownRun } from "./edit/markdown/run.js";
 import { MarkdownParagraph } from "./edit/markdown/paragraph.js";
 import { MarkdownList } from "./edit/markdown/list.js";

package/dist/layout/reconstruct.cjs

@@ -42,8 +42,8 @@ function textItemVerticalExtent(item) {
 function textItemToContentRun(item) {
 	return {
 		text: item.text,
-		bold: item.font.weight === "bold" ? true : void 0,
-		italic: item.font.style === "italic" ? true : void 0,
+		...item.font.weight === "bold" ? { bold: true } : {},
+		...item.font.style === "italic" ? { italic: true } : {},
 		fontFamily: item.font.family,
 		sizePt: item.sizePt,
 		color: item.color
@@ -134,33 +134,55 @@ function estimateModalLineSpacing(lines) {
 }
 function reconstructWordprocessing(doc, options) {
 	const signal = options?.signal;
+	const headingLevels = headingSizeLevels(doc);
 	const sections = [];
 	let currentGroup = [];
 	let groupStartPageIndex = 0;
 	for (const page of doc.pages) {
 		require_ports_abort.throwIfAborted(signal);
 		if (currentGroup.length > 0 && !samePageSize(currentGroup[0], page)) {
-			sections.push(buildSection(currentGroup, groupStartPageIndex, doc.images));
+			sections.push(buildSection(currentGroup, groupStartPageIndex, doc.images, headingLevels));
 			groupStartPageIndex += currentGroup.length;
 			currentGroup = [];
 		}
 		currentGroup.push(page);
 	}
-	if (currentGroup.length > 0) sections.push(buildSection(currentGroup, groupStartPageIndex, doc.images));
+	if (currentGroup.length > 0) sections.push(buildSection(currentGroup, groupStartPageIndex, doc.images, headingLevels));
 	return {
 		kind: "wordprocessing",
 		metadata: doc.metadata,
 		sections
 	};
 }
+const HEADING_MIN_SIZE_DELTA_PT = 2;
+const MAX_HEADING_LEVEL = 6;
+function headingSizeLevels(doc) {
+	const sizes = [];
+	for (const page of doc.pages) for (const item of page.items) if (item.kind === "text") sizes.push(item.sizePt);
+	if (sizes.length === 0) return /* @__PURE__ */ new Map();
+	const bodySizePt = modeOf(sizes, .5);
+	const headingBuckets = /* @__PURE__ */ new Set();
+	for (const size of sizes) {
+		const bucket = Math.round(size / .5) * .5;
+		if (bucket - bodySizePt >= HEADING_MIN_SIZE_DELTA_PT) headingBuckets.add(bucket);
+	}
+	const levels = /* @__PURE__ */ new Map();
+	[...headingBuckets].sort((a, b) => b - a).forEach((bucket, index) => {
+		levels.set(bucket, Math.min(index + 1, MAX_HEADING_LEVEL));
+	});
+	return levels;
+}
+function headingLevelOf(paragraph, levels) {
+	return levels.get(modeOf(paragraph.lines.flatMap((line) => line.items.map((item) => item.sizePt)), .5));
+}
 function samePageSize(a, b) {
 	return a.widthPt === b.widthPt && a.heightPt === b.heightPt;
 }
-function buildSection(pages, startPageIndex, images) {
+function buildSection(pages, startPageIndex, images, headingLevels) {
 	const blocks = [];
 	pages.forEach((page, i) => {
 		if (i > 0) blocks.push({ kind: "pageBreak" });
-		blocks.push(...reconstructPageBlocks(page, startPageIndex + i, images));
+		blocks.push(...reconstructPageBlocks(page, startPageIndex + i, images, headingLevels));
 	});
 	return {
 		pageSize: {
@@ -171,7 +193,7 @@ function buildSection(pages, startPageIndex, images) {
 		blocks
 	};
 }
-function reconstructPageBlocks(page, pageIndex, images) {
+function reconstructPageBlocks(page, pageIndex, images, headingLevels) {
 	const recoveredTable = recoverTable(page, pageIndex);
 	const consumedText = recoveredTable?.consumedText;
 	const textItems = page.items.filter((i) => i.kind === "text" && consumedText?.has(i) !== true);
@@ -180,7 +202,7 @@ function reconstructPageBlocks(page, pageIndex, images) {
 	const positioned = [];
 	for (const paragraph of paragraphs) positioned.push({
 		yPt: paragraph.lines[0].baselineY,
-		block: paragraphToContentParagraph(paragraph, pageIndex)
+		block: paragraphToContentParagraph(paragraph, pageIndex, headingLevelOf(paragraph, headingLevels))
 	});
 	for (const img of imageItems) {
 		const asset = images[img.imageId];
@@ -231,6 +253,7 @@ function clusterIntoParagraphs(lines) {
 }
 function startsNewParagraph(prev, next, modalSpacing, dominantLeftX) {
 	if (prev.baselineY - next.baselineY > PARAGRAPH_GAP_MULTIPLIER * modalSpacing) return true;
+	if (!fontSizesClose(prev.items[0].sizePt, next.items[0].sizePt)) return true;
 	const nextLeft = next.items[0].xPt;
 	const prevLeft = prev.items[0].xPt;
 	const emPt = next.items[0].sizePt;
@@ -239,12 +262,16 @@ function startsNewParagraph(prev, next, modalSpacing, dominantLeftX) {
 	return nextIndented && prevAtMargin;
 }
 const LEFT_ALIGN_TOLERANCE_PT = 2;
-function paragraphToContentParagraph(paragraph, pageIndex) {
+function paragraphToContentParagraph(paragraph, pageIndex, headingLevel) {
 	const dominantLeftX = modeOf(paragraph.lines.map((l) => l.items[0].xPt), 1);
 	const result = {
 		kind: "paragraph",
 		runs: [],
-		alignment: paragraph.lines.every((l) => Math.abs(l.items[0].xPt - dominantLeftX) <= LEFT_ALIGN_TOLERANCE_PT) ? "left" : void 0
+		alignment: paragraph.lines.every((l) => Math.abs(l.items[0].xPt - dominantLeftX) <= LEFT_ALIGN_TOLERANCE_PT) ? "left" : void 0,
+		...headingLevel !== void 0 ? {
+			styleId: `Heading${String(headingLevel)}`,
+			headingLevel
+		} : {}
 	};
 	paragraph.lines.forEach((line, lineIndex) => {
 		require_layout_shared.stampFrame(result, pageIndex, lineBox(line, pageIndex));
@@ -254,6 +281,12 @@ function paragraphToContentParagraph(paragraph, pageIndex) {
 		}
 		pushRunsForLine(result.runs, line, pageIndex);
 	});
+	if (headingLevel !== void 0) result.runs = result.runs.map((run) => {
+		if (run.bold !== true) return run;
+		const withoutBold = { ...run };
+		delete withoutBold.bold;
+		return withoutBold;
+	});
 	return result;
 }
 function reconstructPresentation(doc, options) {

package/dist/layout/reconstruct.js

@@ -41,8 +41,8 @@ function textItemVerticalExtent(item) {
 function textItemToContentRun(item) {
 	return {
 		text: item.text,
-		bold: item.font.weight === "bold" ? true : void 0,
-		italic: item.font.style === "italic" ? true : void 0,
+		...item.font.weight === "bold" ? { bold: true } : {},
+		...item.font.style === "italic" ? { italic: true } : {},
 		fontFamily: item.font.family,
 		sizePt: item.sizePt,
 		color: item.color
@@ -133,33 +133,55 @@ function estimateModalLineSpacing(lines) {
 }
 function reconstructWordprocessing(doc, options) {
 	const signal = options?.signal;
+	const headingLevels = headingSizeLevels(doc);
 	const sections = [];
 	let currentGroup = [];
 	let groupStartPageIndex = 0;
 	for (const page of doc.pages) {
 		throwIfAborted(signal);
 		if (currentGroup.length > 0 && !samePageSize(currentGroup[0], page)) {
-			sections.push(buildSection(currentGroup, groupStartPageIndex, doc.images));
+			sections.push(buildSection(currentGroup, groupStartPageIndex, doc.images, headingLevels));
 			groupStartPageIndex += currentGroup.length;
 			currentGroup = [];
 		}
 		currentGroup.push(page);
 	}
-	if (currentGroup.length > 0) sections.push(buildSection(currentGroup, groupStartPageIndex, doc.images));
+	if (currentGroup.length > 0) sections.push(buildSection(currentGroup, groupStartPageIndex, doc.images, headingLevels));
 	return {
 		kind: "wordprocessing",
 		metadata: doc.metadata,
 		sections
 	};
 }
+const HEADING_MIN_SIZE_DELTA_PT = 2;
+const MAX_HEADING_LEVEL = 6;
+function headingSizeLevels(doc) {
+	const sizes = [];
+	for (const page of doc.pages) for (const item of page.items) if (item.kind === "text") sizes.push(item.sizePt);
+	if (sizes.length === 0) return /* @__PURE__ */ new Map();
+	const bodySizePt = modeOf(sizes, .5);
+	const headingBuckets = /* @__PURE__ */ new Set();
+	for (const size of sizes) {
+		const bucket = Math.round(size / .5) * .5;
+		if (bucket - bodySizePt >= HEADING_MIN_SIZE_DELTA_PT) headingBuckets.add(bucket);
+	}
+	const levels = /* @__PURE__ */ new Map();
+	[...headingBuckets].sort((a, b) => b - a).forEach((bucket, index) => {
+		levels.set(bucket, Math.min(index + 1, MAX_HEADING_LEVEL));
+	});
+	return levels;
+}
+function headingLevelOf(paragraph, levels) {
+	return levels.get(modeOf(paragraph.lines.flatMap((line) => line.items.map((item) => item.sizePt)), .5));
+}
 function samePageSize(a, b) {
 	return a.widthPt === b.widthPt && a.heightPt === b.heightPt;
 }
-function buildSection(pages, startPageIndex, images) {
+function buildSection(pages, startPageIndex, images, headingLevels) {
 	const blocks = [];
 	pages.forEach((page, i) => {
 		if (i > 0) blocks.push({ kind: "pageBreak" });
-		blocks.push(...reconstructPageBlocks(page, startPageIndex + i, images));
+		blocks.push(...reconstructPageBlocks(page, startPageIndex + i, images, headingLevels));
 	});
 	return {
 		pageSize: {
@@ -170,7 +192,7 @@ function buildSection(pages, startPageIndex, images) {
 		blocks
 	};
 }
-function reconstructPageBlocks(page, pageIndex, images) {
+function reconstructPageBlocks(page, pageIndex, images, headingLevels) {
 	const recoveredTable = recoverTable(page, pageIndex);
 	const consumedText = recoveredTable?.consumedText;
 	const textItems = page.items.filter((i) => i.kind === "text" && consumedText?.has(i) !== true);
@@ -179,7 +201,7 @@ function reconstructPageBlocks(page, pageIndex, images) {
 	const positioned = [];
 	for (const paragraph of paragraphs) positioned.push({
 		yPt: paragraph.lines[0].baselineY,
-		block: paragraphToContentParagraph(paragraph, pageIndex)
+		block: paragraphToContentParagraph(paragraph, pageIndex, headingLevelOf(paragraph, headingLevels))
 	});
 	for (const img of imageItems) {
 		const asset = images[img.imageId];
@@ -230,6 +252,7 @@ function clusterIntoParagraphs(lines) {
 }
 function startsNewParagraph(prev, next, modalSpacing, dominantLeftX) {
 	if (prev.baselineY - next.baselineY > PARAGRAPH_GAP_MULTIPLIER * modalSpacing) return true;
+	if (!fontSizesClose(prev.items[0].sizePt, next.items[0].sizePt)) return true;
 	const nextLeft = next.items[0].xPt;
 	const prevLeft = prev.items[0].xPt;
 	const emPt = next.items[0].sizePt;
@@ -238,12 +261,16 @@ function startsNewParagraph(prev, next, modalSpacing, dominantLeftX) {
 	return nextIndented && prevAtMargin;
 }
 const LEFT_ALIGN_TOLERANCE_PT = 2;
-function paragraphToContentParagraph(paragraph, pageIndex) {
+function paragraphToContentParagraph(paragraph, pageIndex, headingLevel) {
 	const dominantLeftX = modeOf(paragraph.lines.map((l) => l.items[0].xPt), 1);
 	const result = {
 		kind: "paragraph",
 		runs: [],
-		alignment: paragraph.lines.every((l) => Math.abs(l.items[0].xPt - dominantLeftX) <= LEFT_ALIGN_TOLERANCE_PT) ? "left" : void 0
+		alignment: paragraph.lines.every((l) => Math.abs(l.items[0].xPt - dominantLeftX) <= LEFT_ALIGN_TOLERANCE_PT) ? "left" : void 0,
+		...headingLevel !== void 0 ? {
+			styleId: `Heading${String(headingLevel)}`,
+			headingLevel
+		} : {}
 	};
 	paragraph.lines.forEach((line, lineIndex) => {
 		stampFrame(result, pageIndex, lineBox(line, pageIndex));
@@ -253,6 +280,12 @@ function paragraphToContentParagraph(paragraph, pageIndex) {
 		}
 		pushRunsForLine(result.runs, line, pageIndex);
 	});
+	if (headingLevel !== void 0) result.runs = result.runs.map((run) => {
+		if (run.bold !== true) return run;
+		const withoutBold = { ...run };
+		delete withoutBold.bold;
+		return withoutBold;
+	});
 	return result;
 }
 function reconstructPresentation(doc, options) {

package/dist/markdown/read.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_markdown_math = require("./math.cjs");
+require("./write.cjs");
 let markdown_codec = require("markdown-codec");
 //#region src/markdown/read.ts
 function readMarkdownContent(text, options, math) {
@@ -8,7 +9,20 @@ function readMarkdownContent(text, options, math) {
 		...options
 	});
 	if (document.kind !== "wordprocessing") throw new Error("readMarkdownContent returned a non-wordprocessing ContentDocument");
-	return require_markdown_math.lowerMarkdownMath(document, math);
+	return require_markdown_math.lowerMarkdownMath(promotePageBreakMarkers(document), math);
+}
+function promotePageBreakMarkers(document) {
+	return {
+		...document,
+		sections: document.sections.map((section) => ({
+			...section,
+			blocks: section.blocks.map(promoteBlock)
+		}))
+	};
+}
+function promoteBlock(block) {
+	if (block.kind !== "paragraph" || block.styleId !== markdown_codec.HTML_PREFORMATTED_STYLE_ID) return block;
+	return block.runs.map((run) => run.text).join("") === "<!-- page break -->" ? { kind: "pageBreak" } : block;
 }
 //#endregion
 exports.readMarkdownContent = readMarkdownContent;

package/dist/markdown/read.js

@@ -1,5 +1,6 @@
 import { lowerMarkdownMath } from "./math.js";
-import { readMarkdownContent as readMarkdownContent$1 } from "markdown-codec";
+import "./write.js";
+import { HTML_PREFORMATTED_STYLE_ID, readMarkdownContent as readMarkdownContent$1 } from "markdown-codec";
 //#region src/markdown/read.ts
 function readMarkdownContent(text, options, math) {
 	const { document } = readMarkdownContent$1(text, {
@@ -7,7 +8,20 @@ function readMarkdownContent(text, options, math) {
 		...options
 	});
 	if (document.kind !== "wordprocessing") throw new Error("readMarkdownContent returned a non-wordprocessing ContentDocument");
-	return lowerMarkdownMath(document, math);
+	return lowerMarkdownMath(promotePageBreakMarkers(document), math);
+}
+function promotePageBreakMarkers(document) {
+	return {
+		...document,
+		sections: document.sections.map((section) => ({
+			...section,
+			blocks: section.blocks.map(promoteBlock)
+		}))
+	};
+}
+function promoteBlock(block) {
+	if (block.kind !== "paragraph" || block.styleId !== HTML_PREFORMATTED_STYLE_ID) return block;
+	return block.runs.map((run) => run.text).join("") === "<!-- page break -->" ? { kind: "pageBreak" } : block;
 }
 //#endregion
 export { readMarkdownContent };

package/dist/markdown/write.cjs

@@ -13,6 +13,7 @@ var MarkdownConstructUnsupportedError = class extends Error {
 const MATH_BLOCK_STYLE_ID = "MathBlock";
 const MATH_INLINE_FONT_MARKER = "Cambria Math";
 const MATH_INLINE_SOURCE = "markdown:math-inline";
+const PAGE_BREAK_MARKER = "<!-- page break -->";
 function formulaParagraph(formula) {
 	const latex = formula.presentation?.latex;
 	if (latex === void 0) return {
@@ -34,6 +35,11 @@ function formulaParagraph(formula) {
 }
 function markdownBlock(block) {
 	if (block.kind === "constructStart" || block.kind === "constructEnd") throw new MarkdownConstructUnsupportedError(block);
+	if (block.kind === "pageBreak") return {
+		kind: "paragraph",
+		runs: [{ text: PAGE_BREAK_MARKER }],
+		styleId: markdown_codec.HTML_PREFORMATTED_STYLE_ID
+	};
 	if (block.kind === "table") return {
 		...block,
 		rows: block.rows.map((row) => ({
@@ -67,4 +73,5 @@ function buildMarkdownText(document, options) {
 }
 //#endregion
 exports.MarkdownConstructUnsupportedError = MarkdownConstructUnsupportedError;
+exports.PAGE_BREAK_MARKER = PAGE_BREAK_MARKER;
 exports.buildMarkdownText = buildMarkdownText;

package/dist/markdown/write.d.cts

@@ -5,6 +5,7 @@ declare class MarkdownConstructUnsupportedError extends Error {
   readonly descriptorKind: ContentConstructStart['descriptor']['kind'] | undefined;
   constructor(block: ContentConstructStart | ContentConstructEnd);
 }
+declare const PAGE_BREAK_MARKER = "<!-- page break -->";
 declare function buildMarkdownText(document: ContentDocument, options?: WriteMarkdownOptions): string;
 //#endregion
-export { MarkdownConstructUnsupportedError, buildMarkdownText };
+export { MarkdownConstructUnsupportedError, PAGE_BREAK_MARKER, buildMarkdownText };

package/dist/markdown/write.d.ts

@@ -5,6 +5,7 @@ declare class MarkdownConstructUnsupportedError extends Error {
   readonly descriptorKind: ContentConstructStart['descriptor']['kind'] | undefined;
   constructor(block: ContentConstructStart | ContentConstructEnd);
 }
+declare const PAGE_BREAK_MARKER = "<!-- page break -->";
 declare function buildMarkdownText(document: ContentDocument, options?: WriteMarkdownOptions): string;
 //#endregion
-export { MarkdownConstructUnsupportedError, buildMarkdownText };
+export { MarkdownConstructUnsupportedError, PAGE_BREAK_MARKER, buildMarkdownText };

package/dist/markdown/write.js

@@ -1,5 +1,5 @@
 import { formulaOfBlock, formulaPlaceholderText } from "../model/formula.js";
-import { MarkdownUnsupportedDocumentKindError, writeMarkdownContent } from "markdown-codec";
+import { HTML_PREFORMATTED_STYLE_ID, MarkdownUnsupportedDocumentKindError, writeMarkdownContent } from "markdown-codec";
 //#region src/markdown/write.ts
 var MarkdownConstructUnsupportedError = class extends Error {
 	descriptorKind;
@@ -12,6 +12,7 @@ var MarkdownConstructUnsupportedError = class extends Error {
 const MATH_BLOCK_STYLE_ID = "MathBlock";
 const MATH_INLINE_FONT_MARKER = "Cambria Math";
 const MATH_INLINE_SOURCE = "markdown:math-inline";
+const PAGE_BREAK_MARKER = "<!-- page break -->";
 function formulaParagraph(formula) {
 	const latex = formula.presentation?.latex;
 	if (latex === void 0) return {
@@ -33,6 +34,11 @@ function formulaParagraph(formula) {
 }
 function markdownBlock(block) {
 	if (block.kind === "constructStart" || block.kind === "constructEnd") throw new MarkdownConstructUnsupportedError(block);
+	if (block.kind === "pageBreak") return {
+		kind: "paragraph",
+		runs: [{ text: PAGE_BREAK_MARKER }],
+		styleId: HTML_PREFORMATTED_STYLE_ID
+	};
 	if (block.kind === "table") return {
 		...block,
 		rows: block.rows.map((row) => ({
@@ -65,4 +71,4 @@ function buildMarkdownText(document, options) {
 	}, options);
 }
 //#endregion
-export { MarkdownConstructUnsupportedError, buildMarkdownText };
+export { MarkdownConstructUnsupportedError, PAGE_BREAK_MARKER, buildMarkdownText };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "documents.js",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "description": "Bidirectional docx/pptx <-> PDF conversion and a read+write editable OOXML document model, built on ooxml.js and Zod 4 codecs.",
   "type": "module",
   "repository": {
@@ -101,12 +101,12 @@
   "packageManager": "pnpm@11.6.0",
   "dependencies": {
     "byte-codec": "^1.1.13",
-    "document-schema.js": "^4.3.7",
+    "document-schema.js": "^4.5.0",
     "fflate": "^0.8.3",
-    "markdown-codec": "^4.0.12",
-    "odf.js": "^5.0.7",
-    "ooxml.js": "^4.1.1",
-    "pdf-codec": "^3.1.0",
+    "markdown-codec": "^4.0.13",
+    "odf.js": "^5.0.8",
+    "ooxml.js": "^4.3.0",
+    "pdf-codec": "^3.1.2",
     "temml": "0.13.4",
     "zod": "^4.4.3"
   },