js.documents 7.10.4 → 7.11.0

package/README.md

@@ -270,7 +270,7 @@ const pdfBytes = docxToPdf(docxBytes, {
 
 The tree and the flat `ContentDocument` are one format in two encodings, related by three laws (stated on [document-schema.js#20](https://github.com/ExaDev/document-schema.js/issues/20), proven over this package's real corpus by the bijection suite in `src/convert/bijection.test.ts`): (i) `flattenTree(assembleTree(c))` reproduces `c` exactly, up to one declared normalisation (a present-but-empty sheet `embeddedObjects` array normalises to the field absent); (ii) effective-property equality holds universally — a factored and an unfactored serialisation of one document resolve to the same properties; (iii) minting is idempotent — factoring a second time produces the identical styles table.
 
-Three flat-form signals drive the grouping, and all three are reproduced exactly on the way back: `headingLevel`, `list.level`, and — since document-schema.js 4.2.0 — the `constructStart`/`constructEnd` block pair that delimits a fidelity construct (a docx SDT, an ODF field, a tracked-change span, a bookmark, a hyperlink region, a division). `decompose` promotes each marker pair to a construct group carrying the `ConstructDescriptor` and holding the delimited region as its children, decomposed on its own; `flattenTree` writes the pair back around that region. A construct is a semantic wrapper rather than a container, so it neither disturbs the enclosing heading/list nesting it sits inside nor resets the style chain resolving onto it — content inside a construct still inherits the ambient heading's or section's factored properties, exactly as if the construct were not there. Markers must pair up within one container's block flow: an unmatched `constructEnd`, or a `constructStart` a container never closes, throws document-schema.js's `ConstructMarkerImbalanceError` (carrying its `ConstructMarkerImbalance` payload, so the offending block index is available without parsing the message) rather than being repaired into a plausible tree. The format codecs do not emit markers yet — construct extraction per format is tracked separately on [document-schema.js#22](https://github.com/ExaDev/document-schema.js/issues/22) — but the decompose/flatten boundary itself handles them today, so a caller hand-building marker content needs no change at that boundary specifically. Reaching further than the boundary is a mixed picture, not a blanket guarantee: `buildMarkdownText` passes markers through to markdown-codec's own bracket-resolving writer, which renders each construct it has a markdown spelling for (a footnote definition, a blockquote division, a titled image's link wrapper) and renders the rest transparently with a diagnostic — markdown-codec's own read side emits those pairs, so this package's editor and conversion round trips depend on it; building docx/odt bytes back from marker-carrying flat content silently drops the markers, since neither builder reads or writes them yet; and the layout engines (`convertWordprocessingToLayout`, `convertShape`) silently skip a marker block during pagination — harmless there, since a marker carries no content of its own to render.
+Three flat-form signals drive the grouping, and all three are reproduced exactly on the way back: `headingLevel`, `list.level`, and — since document-schema.js 4.2.0 — the `constructStart`/`constructEnd` block pair that delimits a fidelity construct (a docx SDT, an ODF field, a tracked-change span, a bookmark, a hyperlink region, a division). `decompose` promotes each marker pair to a construct group carrying the `ConstructDescriptor` and holding the delimited region as its children, decomposed on its own; `flattenTree` writes the pair back around that region. A construct is a semantic wrapper rather than a container, so it neither disturbs the enclosing heading/list nesting it sits inside nor resets the style chain resolving onto it — content inside a construct still inherits the ambient heading's or section's factored properties, exactly as if the construct were not there. Markers must pair up within one container's block flow: an unmatched `constructEnd`, or a `constructStart` a container never closes, throws document-schema.js's `ConstructMarkerImbalanceError` (carrying its `ConstructMarkerImbalance` payload, so the offending block index is available without parsing the message) rather than being repaired into a plausible tree. The format codecs emit and consume these markers on both sides today — ooxml.js's docx pair (SDTs, bookmarks, tracked changes, block-scoped fields), odf.js's odt reader for divisions, index wrappers, and cross-paragraph bookmarks with its writer covering the construct kinds it models and refusing the rest by name, markdown-codec, rtf-codec, and epub-codec in both directions, and this package's own PDF reconstruction emitting division and anchor pairs — so the marker machinery has real producers and consumers, not just the boundary transform. Reaching further than the codecs is still a mixed picture, not a blanket guarantee: `buildMarkdownText` passes markers through to markdown-codec's own bracket-resolving writer, which renders each construct it has a markdown spelling for (a footnote definition, a blockquote division, a titled image's link wrapper) and renders the rest transparently with a diagnostic — markdown-codec's own read side emits those pairs, so this package's editor and conversion round trips depend on it; building docx bytes from marker-carrying flat content writes a bookmark anchor's pair as real `w:bookmarkStart`/`w:bookmarkEnd` around the blocks it spans, and the odt builder does the same through `text:bookmark-start`/`-end` — the one construct family expressible append-only in either format's body flow — while the wrapper-shaped kinds (an SDT, a tracked change, a division) are dropped rather than written, since neither editor model has a surface for them; and the layout engines (`convertWordprocessingToLayout`, `convertShape`) silently skip a marker block during pagination — harmless there, since a marker carries no content of its own to render.
 
 `assembleTree` is the one constructor behind every construction site — decompose, then `factorStyles`, the minting pass that hoists property tuples occurring two or more times onto a group-wrapper ref plus a `styles` table entry (deterministic order; `frames`/`sourcePath`/`styleId` are per-node facts and never factor). The transform belongs to `document-schema.js`, which owns both encodings and publishes `assembleTree`, `decompose`, `flattenTree`, `factorStyles`, `ConstructMarkerImbalanceError`, and the `TreeChildren` type for any caller composing its own boundary — import them from there, not from this package. documents.js consumes that transform at its own boundary and re-exports none of it; the readers, builders, layout engines, and editors here keep producing and consuming the flat form, so the tree exists only where a `DocumentTree` is constructed or consumed:
 

package/dist/convert/port.d.cts

@@ -4,6 +4,7 @@ import { MarkdownImageResolver } from "markdown-codec";
 import { z } from "zod";
 //#region src/convert/port.d.ts
 declare const DocumentFormatSchema: z.ZodEnum<{
+  wpd: "wpd";
   docx: "docx";
   pptx: "pptx";
   xlsx: "xlsx";
@@ -12,15 +13,14 @@ declare const DocumentFormatSchema: z.ZodEnum<{
   ods: "ods";
   odg: "odg";
   svg: "svg";
-  odf: "odf";
   csv: "csv";
   markdown: "markdown";
   rtf: "rtf";
   doc: "doc";
   xls: "xls";
   ppt: "ppt";
-  wpd: "wpd";
   epub: "epub";
+  odf: "odf";
   pdf: "pdf";
 }>;
 type DocumentFormat = z.infer<typeof DocumentFormatSchema>;

package/dist/convert/port.d.ts

@@ -4,6 +4,7 @@ import { z } from "zod";
 import { MarkdownImageResolver } from "markdown-codec";
 //#region src/convert/port.d.ts
 declare const DocumentFormatSchema: z.ZodEnum<{
+  wpd: "wpd";
   docx: "docx";
   pptx: "pptx";
   xlsx: "xlsx";
@@ -12,15 +13,14 @@ declare const DocumentFormatSchema: z.ZodEnum<{
   ods: "ods";
   odg: "odg";
   svg: "svg";
-  odf: "odf";
   csv: "csv";
   markdown: "markdown";
   rtf: "rtf";
   doc: "doc";
   xls: "xls";
   ppt: "ppt";
-  wpd: "wpd";
   epub: "epub";
+  odf: "odf";
   pdf: "pdf";
 }>;
 type DocumentFormat = z.infer<typeof DocumentFormatSchema>;

package/dist/edit/docx/content.cjs

@@ -13,6 +13,31 @@ const require_edit_docx_numbering = require("./numbering.cjs");
 let ooxml_js = require("ooxml.js");
 let document_schema_js = require("document-schema.js");
 //#region src/edit/docx/content.ts
+var ConstructMarkerState = class {
+	nextBookmarkId = 1;
+	open = [];
+	openConstruct(body, marker) {
+		const detail = marker.descriptor;
+		if (detail.kind === "anchor" && detail.anchorType === "bookmark") {
+			const id = this.nextBookmarkId;
+			this.nextBookmarkId += 1;
+			this.open.push({
+				isBookmark: true,
+				id
+			});
+			body.appendBookmarkStart(id, detail.name);
+			return;
+		}
+		this.open.push({
+			isBookmark: false,
+			id: -1
+		});
+	}
+	closeConstruct(body) {
+		const entry = this.open.pop();
+		if (entry?.isBookmark) body.appendBookmarkEnd(entry.id);
+	}
+};
 function buildDocxPackage(content, options) {
 	if (content.kind !== "wordprocessing") throw new Error("buildDocxPackage requires a wordprocessing ContentDocument");
 	const clock = options?.clock ?? require_ports_clock.systemClock;
@@ -49,12 +74,13 @@ function buildDocxPackage(content, options) {
 		});
 	}
 	const editor = new require_edit_docx_editor.DocxEditor(pkg);
+	const markers = new ConstructMarkerState();
 	(numIdLevels.size > 0 ? content.sections.map((section) => ({
 		...section,
 		blocks: remapListNumIds(section.blocks, remap)
 	})) : content.sections).forEach((section, sectionIndex) => {
 		if (sectionIndex > 0) editor.body.appendPageBreak();
-		appendBlocks(editor.body, section.blocks, options);
+		appendBlocks(editor.body, section.blocks, options, markers);
 	});
 	return editor.toPackage();
 }
@@ -97,7 +123,7 @@ function remapListNumIds(blocks, numIdMap) {
 		return block;
 	});
 }
-function appendBlocks(body, blocks, options) {
+function appendBlocks(body, blocks, options, markers) {
 	let index = 0;
 	while (index < blocks.length) {
 		const block = blocks[index];
@@ -118,7 +144,7 @@ function appendBlocks(body, blocks, options) {
 			index += 2;
 			continue;
 		}
-		if (block !== void 0) appendBlock(body, block, options);
+		if (block !== void 0) appendBlock(body, block, options, markers);
 		index += 1;
 	}
 }
@@ -202,7 +228,7 @@ function appendTable(body, block) {
 function appendCellBlock(cell, block) {
 	if (block.kind === "paragraph") populateParagraph(cell.appendParagraph(), block);
 }
-function appendBlock(body, block, options) {
+function appendBlock(body, block, options, markers) {
 	if (block.kind === "paragraph") populateParagraph(body.appendParagraph(), block);
 	else if (block.kind === "image") {
 		const paragraph = body.appendParagraph();
@@ -217,6 +243,8 @@ function appendBlock(body, block, options) {
 	} else if (block.kind === "pageBreak") body.appendPageBreak();
 	else if (block.kind === "table") appendTable(body, block);
 	else if (block.kind === "embeddedObject") appendEmbeddedObject(body, block, options);
+	else if (block.kind === "constructStart") markers.openConstruct(body, block);
+	else markers.closeConstruct(body);
 }
 function appendEmbeddedObject(body, block, options) {
 	if (require_model_embedded_drawing.drawingOfBlock(block) !== void 0) {

package/dist/edit/docx/content.js

@@ -12,6 +12,31 @@ import { NUMBERING_CONTENT_TYPE, NUMBERING_PART_PATH, NUMBERING_REL_TYPE, buildN
 import { base64ToBytes } from "ooxml.js";
 import { resolveCellFillColor } from "document-schema.js";
 //#region src/edit/docx/content.ts
+var ConstructMarkerState = class {
+	nextBookmarkId = 1;
+	open = [];
+	openConstruct(body, marker) {
+		const detail = marker.descriptor;
+		if (detail.kind === "anchor" && detail.anchorType === "bookmark") {
+			const id = this.nextBookmarkId;
+			this.nextBookmarkId += 1;
+			this.open.push({
+				isBookmark: true,
+				id
+			});
+			body.appendBookmarkStart(id, detail.name);
+			return;
+		}
+		this.open.push({
+			isBookmark: false,
+			id: -1
+		});
+	}
+	closeConstruct(body) {
+		const entry = this.open.pop();
+		if (entry?.isBookmark) body.appendBookmarkEnd(entry.id);
+	}
+};
 function buildDocxPackage(content, options) {
 	if (content.kind !== "wordprocessing") throw new Error("buildDocxPackage requires a wordprocessing ContentDocument");
 	const clock = options?.clock ?? systemClock;
@@ -48,12 +73,13 @@ function buildDocxPackage(content, options) {
 		});
 	}
 	const editor = new DocxEditor(pkg);
+	const markers = new ConstructMarkerState();
 	(numIdLevels.size > 0 ? content.sections.map((section) => ({
 		...section,
 		blocks: remapListNumIds(section.blocks, remap)
 	})) : content.sections).forEach((section, sectionIndex) => {
 		if (sectionIndex > 0) editor.body.appendPageBreak();
-		appendBlocks(editor.body, section.blocks, options);
+		appendBlocks(editor.body, section.blocks, options, markers);
 	});
 	return editor.toPackage();
 }
@@ -96,7 +122,7 @@ function remapListNumIds(blocks, numIdMap) {
 		return block;
 	});
 }
-function appendBlocks(body, blocks, options) {
+function appendBlocks(body, blocks, options, markers) {
 	let index = 0;
 	while (index < blocks.length) {
 		const block = blocks[index];
@@ -117,7 +143,7 @@ function appendBlocks(body, blocks, options) {
 			index += 2;
 			continue;
 		}
-		if (block !== void 0) appendBlock(body, block, options);
+		if (block !== void 0) appendBlock(body, block, options, markers);
 		index += 1;
 	}
 }
@@ -201,7 +227,7 @@ function appendTable(body, block) {
 function appendCellBlock(cell, block) {
 	if (block.kind === "paragraph") populateParagraph(cell.appendParagraph(), block);
 }
-function appendBlock(body, block, options) {
+function appendBlock(body, block, options, markers) {
 	if (block.kind === "paragraph") populateParagraph(body.appendParagraph(), block);
 	else if (block.kind === "image") {
 		const paragraph = body.appendParagraph();
@@ -216,6 +242,8 @@ function appendBlock(body, block, options) {
 	} else if (block.kind === "pageBreak") body.appendPageBreak();
 	else if (block.kind === "table") appendTable(body, block);
 	else if (block.kind === "embeddedObject") appendEmbeddedObject(body, block, options);
+	else if (block.kind === "constructStart") markers.openConstruct(body, block);
+	else markers.closeConstruct(body);
 }
 function appendEmbeddedObject(body, block, options) {
 	if (drawingOfBlock(block) !== void 0) {

package/dist/edit/docx/editor.cjs

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_xml_entities = require("../../xml/entities.cjs");
 const require_xml_fragment = require("../../xml/fragment.cjs");
 const require_metadata_core_patch = require("../../metadata/core-patch.cjs");
 const require_model_metadata = require("../../model/metadata.cjs");
@@ -61,6 +62,15 @@ var DocxBodyImpl = class {
 		const paragraph = require_xml_fragment.el("w:p", {}, [run]);
 		this.body.children.splice(bodyInsertionPoint(this.body), 0, paragraph);
 	}
+	appendBookmarkStart(id, name) {
+		this.body.children.splice(bodyInsertionPoint(this.body), 0, require_xml_fragment.el("w:bookmarkStart", {
+			"w:id": String(id),
+			"w:name": require_xml_entities.encodeXmlText(name)
+		}));
+	}
+	appendBookmarkEnd(id) {
+		this.body.children.splice(bodyInsertionPoint(this.body), 0, require_xml_fragment.el("w:bookmarkEnd", { "w:id": String(id) }));
+	}
 };
 var DocxEditor = class {
 	body;

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

@@ -9,6 +9,8 @@ interface DocxBody {
   appendParagraph(init?: ParagraphInit): DocxParagraph;
   appendTable(init: TableInit): DocxTable;
   appendPageBreak(): void;
+  appendBookmarkStart(id: number, name: string): void;
+  appendBookmarkEnd(id: number): void;
 }
 declare class DocxEditor {
   readonly body: DocxBody;

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

@@ -9,6 +9,8 @@ interface DocxBody {
   appendParagraph(init?: ParagraphInit): DocxParagraph;
   appendTable(init: TableInit): DocxTable;
   appendPageBreak(): void;
+  appendBookmarkStart(id: number, name: string): void;
+  appendBookmarkEnd(id: number): void;
 }
 declare class DocxEditor {
   readonly body: DocxBody;

package/dist/edit/docx/editor.js

@@ -1,3 +1,4 @@
+import { encodeXmlText } from "../../xml/entities.js";
 import { el } from "../../xml/fragment.js";
 import { patchOoxmlCorePropertiesOnPackage } from "../../metadata/core-patch.js";
 import { resolveMetadataTimestamps } from "../../model/metadata.js";
@@ -60,6 +61,15 @@ var DocxBodyImpl = class {
 		const paragraph = el("w:p", {}, [run]);
 		this.body.children.splice(bodyInsertionPoint(this.body), 0, paragraph);
 	}
+	appendBookmarkStart(id, name) {
+		this.body.children.splice(bodyInsertionPoint(this.body), 0, el("w:bookmarkStart", {
+			"w:id": String(id),
+			"w:name": encodeXmlText(name)
+		}));
+	}
+	appendBookmarkEnd(id) {
+		this.body.children.splice(bodyInsertionPoint(this.body), 0, el("w:bookmarkEnd", { "w:id": String(id) }));
+	}
 };
 var DocxEditor = class {
 	body;

package/dist/edit/odt/content.cjs

@@ -14,9 +14,10 @@ function buildOdtPackage(content, options) {
 	const clock = options?.clock ?? require_ports_clock.systemClock;
 	const metadata = require_model_metadata.resolveMetadataTimestamps(content.metadata, clock);
 	const editor = new require_edit_odt_editor.OdtEditor(require_edit_odt_scaffold.createEmptyOdtPackage({ metadata }));
+	const markers = new ConstructMarkerState();
 	content.sections.forEach((section, sectionIndex) => {
 		if (sectionIndex > 0) editor.body.appendPageBreak();
-		appendBlocks(editor.body, section.blocks);
+		appendBlocks(editor.body, section.blocks, markers);
 	});
 	return editor.toPackage();
 }
@@ -36,7 +37,7 @@ function appendMergedImageParagraph(body, paragraphBlock, imageBlock) {
 		altText: imageBlock.altText
 	});
 }
-function appendBlocks(body, blocks) {
+function appendBlocks(body, blocks, markers) {
 	let i = 0;
 	while (i < blocks.length) {
 		const block = blocks[i];
@@ -61,7 +62,7 @@ function appendBlocks(body, blocks) {
 			appendListRun(body, run);
 			continue;
 		}
-		appendBlock(body, block);
+		appendBlock(body, block, markers);
 		i++;
 	}
 }
@@ -187,7 +188,29 @@ function appendCellBlock(cell, block) {
 		altText: block.altText
 	});
 }
-function appendBlock(body, block) {
+var ConstructMarkerState = class {
+	open = [];
+	openConstruct(body, marker) {
+		const detail = marker.descriptor;
+		if (detail.kind === "anchor" && detail.anchorType === "bookmark") {
+			this.open.push({
+				isBookmark: true,
+				name: detail.name
+			});
+			body.appendBookmarkStart(detail.name);
+			return;
+		}
+		this.open.push({
+			isBookmark: false,
+			name: ""
+		});
+	}
+	closeConstruct(body) {
+		const entry = this.open.pop();
+		if (entry?.isBookmark) body.appendBookmarkEnd(entry.name);
+	}
+};
+function appendBlock(body, block, markers) {
 	if (block.kind === "paragraph") populateParagraph(body.appendParagraph(), block, { headings: "element" });
 	else if (block.kind === "image") body.appendParagraph().insertImageAfter({
 		format: block.format,
@@ -199,6 +222,8 @@ function appendBlock(body, block) {
 	else if (block.kind === "pageBreak") body.appendPageBreak();
 	else if (block.kind === "table") appendTable(body, block);
 	else if (block.kind === "embeddedObject") appendEmbeddedObject(body, block);
+	else if (block.kind === "constructStart") markers.openConstruct(body, block);
+	else markers.closeConstruct(body);
 }
 function appendEmbeddedObject(body, block) {
 	if (require_model_embedded_drawing.drawingOfBlock(block) !== void 0) {

package/dist/edit/odt/content.js

@@ -13,9 +13,10 @@ function buildOdtPackage(content, options) {
 	const clock = options?.clock ?? systemClock;
 	const metadata = resolveMetadataTimestamps(content.metadata, clock);
 	const editor = new OdtEditor(createEmptyOdtPackage({ metadata }));
+	const markers = new ConstructMarkerState();
 	content.sections.forEach((section, sectionIndex) => {
 		if (sectionIndex > 0) editor.body.appendPageBreak();
-		appendBlocks(editor.body, section.blocks);
+		appendBlocks(editor.body, section.blocks, markers);
 	});
 	return editor.toPackage();
 }
@@ -35,7 +36,7 @@ function appendMergedImageParagraph(body, paragraphBlock, imageBlock) {
 		altText: imageBlock.altText
 	});
 }
-function appendBlocks(body, blocks) {
+function appendBlocks(body, blocks, markers) {
 	let i = 0;
 	while (i < blocks.length) {
 		const block = blocks[i];
@@ -60,7 +61,7 @@ function appendBlocks(body, blocks) {
 			appendListRun(body, run);
 			continue;
 		}
-		appendBlock(body, block);
+		appendBlock(body, block, markers);
 		i++;
 	}
 }
@@ -186,7 +187,29 @@ function appendCellBlock(cell, block) {
 		altText: block.altText
 	});
 }
-function appendBlock(body, block) {
+var ConstructMarkerState = class {
+	open = [];
+	openConstruct(body, marker) {
+		const detail = marker.descriptor;
+		if (detail.kind === "anchor" && detail.anchorType === "bookmark") {
+			this.open.push({
+				isBookmark: true,
+				name: detail.name
+			});
+			body.appendBookmarkStart(detail.name);
+			return;
+		}
+		this.open.push({
+			isBookmark: false,
+			name: ""
+		});
+	}
+	closeConstruct(body) {
+		const entry = this.open.pop();
+		if (entry?.isBookmark) body.appendBookmarkEnd(entry.name);
+	}
+};
+function appendBlock(body, block, markers) {
 	if (block.kind === "paragraph") populateParagraph(body.appendParagraph(), block, { headings: "element" });
 	else if (block.kind === "image") body.appendParagraph().insertImageAfter({
 		format: block.format,
@@ -198,6 +221,8 @@ function appendBlock(body, block) {
 	else if (block.kind === "pageBreak") body.appendPageBreak();
 	else if (block.kind === "table") appendTable(body, block);
 	else if (block.kind === "embeddedObject") appendEmbeddedObject(body, block);
+	else if (block.kind === "constructStart") markers.openConstruct(body, block);
+	else markers.closeConstruct(body);
 }
 function appendEmbeddedObject(body, block) {
 	if (drawingOfBlock(block) !== void 0) {

package/dist/edit/odt/editor.cjs

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_xml_entities = require("../../xml/entities.cjs");
 const require_metadata_core_patch = require("../../metadata/core-patch.cjs");
 const require_model_metadata = require("../../model/metadata.cjs");
 const require_ports_clock = require("../../ports/clock.cjs");
@@ -69,6 +70,28 @@ var OdtBodyImpl = class {
 		});
 		this.officeText.children.push(paragraphElement);
 	}
+	appendBookmarkStart(name) {
+		this.officeText.children.push({
+			type: "element",
+			tag: "text:bookmark-start",
+			attributes: [{
+				name: "text:name",
+				value: require_xml_entities.encodeXmlText(name)
+			}],
+			children: []
+		});
+	}
+	appendBookmarkEnd(name) {
+		this.officeText.children.push({
+			type: "element",
+			tag: "text:bookmark-end",
+			attributes: [{
+				name: "text:name",
+				value: require_xml_entities.encodeXmlText(name)
+			}],
+			children: []
+		});
+	}
 };
 var OdtEditor = class {
 	body;

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

@@ -12,6 +12,8 @@ interface OdtBody {
   appendPageBreak(): void;
   appendFormula(formula: ContentFormula, frame: Box): OdtParagraph;
   appendVectors(vectors: readonly ContentVector[]): OdtParagraph;
+  appendBookmarkStart(name: string): void;
+  appendBookmarkEnd(name: string): void;
 }
 declare class OdtEditor {
   readonly body: OdtBody;

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

@@ -12,6 +12,8 @@ interface OdtBody {
   appendPageBreak(): void;
   appendFormula(formula: ContentFormula, frame: Box): OdtParagraph;
   appendVectors(vectors: readonly ContentVector[]): OdtParagraph;
+  appendBookmarkStart(name: string): void;
+  appendBookmarkEnd(name: string): void;
 }
 declare class OdtEditor {
   readonly body: OdtBody;

package/dist/edit/odt/editor.js

@@ -1,3 +1,4 @@
+import { encodeXmlText as encodeXmlText$1 } from "../../xml/entities.js";
 import { patchOdfMetadataOnPackage } from "../../metadata/core-patch.js";
 import { resolveMetadataTimestamps } from "../../model/metadata.js";
 import { systemClock } from "../../ports/clock.js";
@@ -68,6 +69,28 @@ var OdtBodyImpl = class {
 		});
 		this.officeText.children.push(paragraphElement);
 	}
+	appendBookmarkStart(name) {
+		this.officeText.children.push({
+			type: "element",
+			tag: "text:bookmark-start",
+			attributes: [{
+				name: "text:name",
+				value: encodeXmlText$1(name)
+			}],
+			children: []
+		});
+	}
+	appendBookmarkEnd(name) {
+		this.officeText.children.push({
+			type: "element",
+			tag: "text:bookmark-end",
+			attributes: [{
+				name: "text:name",
+				value: encodeXmlText$1(name)
+			}],
+			children: []
+		});
+	}
 };
 var OdtEditor = class {
 	body;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js.documents",
-  "version": "7.10.4",
+  "version": "7.11.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": {