@stll/folio-core 0.20.0 → 0.21.0

package/dist/docx/paragraphParser.js

@@ -712,14 +712,16 @@ function parseParagraphContents(paraElement, styles, theme, _numbering, rels, me
 				const run = parseRun(runElement, styles, theme, rels, media, inScopeXmlns);
 				const commentReferenceId = getCommentReferenceId(runElement);
 				let hasFieldBegin = false;
+				let beginFldLock = false;
+				let beginDirty = false;
 				let hasFieldSeparate = false;
 				let hasFieldEnd = false;
 				let endOriginalValue;
 				let instrText = "";
 				for (const content of run.content) if (content.type === "fieldChar") if (content.charType === "begin") {
 					hasFieldBegin = true;
-					if (content.fldLock) complexFieldLock = true;
-					if (content.dirty) complexFieldDirty = true;
+					beginFldLock = content.fldLock === true;
+					beginDirty = content.dirty === true;
 				} else if (content.charType === "separate") hasFieldSeparate = true;
 				else {
 					hasFieldEnd = true;
@@ -736,8 +738,8 @@ function parseParagraphContents(paraElement, styles, theme, _numbering, rels, me
 					complexFieldInstr = "";
 					complexFieldCodeRuns = [];
 					complexFieldResultRuns = [];
-					complexFieldLock = false;
-					complexFieldDirty = false;
+					complexFieldLock = beginFldLock;
+					complexFieldDirty = beginDirty;
 					complexFieldFormatting = run.formatting;
 				}
 				if (inComplexField) {

package/dist/docx/parser.js

@@ -371,8 +371,12 @@ function parseHeadersAndFooters(raw, styles, theme, numbering, rels, media) {
 * Parse footnotes and endnotes from raw content
 */
 function parseNotesContent(raw, styles, theme, numbering, rels, media) {
-	const footnoteMap = parseFootnotes(raw.footnotesXml, styles, theme, numbering, rels, media);
-	const endnoteMap = parseEndnotes(raw.endnotesXml, styles, theme, numbering, rels, media);
+	const relsForNotePart = (partPath) => {
+		const xml = getMapCaseInsensitive(raw.allXml, getRelationshipsPathForPart(partPath));
+		return xml ? parseRelationships(xml) : rels;
+	};
+	const footnoteMap = parseFootnotes(raw.footnotesXml, styles, theme, numbering, relsForNotePart("word/footnotes.xml"), media);
+	const endnoteMap = parseEndnotes(raw.endnotesXml, styles, theme, numbering, relsForNotePart("word/endnotes.xml"), media);
 	return {
 		footnotes: footnoteMap.getNormalFootnotes(),
 		endnotes: endnoteMap.getNormalEndnotes()

package/dist/docx/rezip.d.ts

@@ -1,4 +1,5 @@
 import { document_d_exports } from "../types/document.js";
+import { BlockContent, Hyperlink } from "../types/content.js";
 import { RawDocxContent } from "./unzip.js";
 import JSZip from "jszip";
 //#region src/docx/rezip.d.ts
@@ -9,6 +10,11 @@ declare class DocxPackageFidelityError extends Error {
  * Find the highest rId number in a relationships XML string.
  */
 declare function findMaxRId(relsXml: string): number;
+/**
+ * Collect all hyperlinks that have an href but no rId from block content.
+ * These are newly created hyperlinks that need relationship entries.
+ */
+declare function collectHyperlinksWithoutRId(blocks: BlockContent[]): Hyperlink[];
 /**
  * Options for repacking DOCX
  */
@@ -126,6 +132,8 @@ declare function hasUnmaterializedHeaderFooter(doc: document_d_exports.Document)
  */
 declare function hasModelDrivenPictureWatermark(doc: document_d_exports.Document): boolean;
 declare function collectHeaderFooterUpdates(doc: document_d_exports.Document): Map<string, string>;
+/** `word/Footnotes.xml` -> `word/_rels/Footnotes.xml.rels` (casing preserved). */
+declare function notePartRelsPath(partPath: string): string;
 /** Update existing core-property values without synthesizing absent metadata. */
 declare function updateCoreProperties(corePropsXml: string, { updateModifiedDate, modifiedBy }: {
   updateModifiedDate?: boolean;
@@ -163,4 +171,4 @@ declare function createEmptyDocx(): Promise<ArrayBuffer>;
  */
 declare function createDocx(doc: document_d_exports.Document): Promise<ArrayBuffer>;
 //#endregion
-export { COMMENTS_CONTENT_TYPE, COMMENTS_EXTENDED_CONTENT_TYPE, COMMENTS_EXTENDED_PART, COMMENTS_EXTENDED_PART_LOWER, DocxPackageFidelityError, RepackOptions, addCommentsExtendedOverride, addCommentsExtendedRelationship, addMedia, addRelationship, applyUpdatesToZip, collectHeaderFooterUpdates, createDocx, createEmptyDocx, findMaxRId, hasModelDrivenPictureWatermark, hasUnmaterializedHeaderFooter, isDocxBuffer, removeCommentsExtendedOverride, removeCommentsExtendedRelationship, repackDocx, repackDocxFromRaw, updateCoreProperties, updateDocumentXml, updateMultipleFiles, updateXmlFile, validateDocx };
+export { COMMENTS_CONTENT_TYPE, COMMENTS_EXTENDED_CONTENT_TYPE, COMMENTS_EXTENDED_PART, COMMENTS_EXTENDED_PART_LOWER, DocxPackageFidelityError, RepackOptions, addCommentsExtendedOverride, addCommentsExtendedRelationship, addMedia, addRelationship, applyUpdatesToZip, collectHeaderFooterUpdates, collectHyperlinksWithoutRId, createDocx, createEmptyDocx, findMaxRId, hasModelDrivenPictureWatermark, hasUnmaterializedHeaderFooter, isDocxBuffer, notePartRelsPath, removeCommentsExtendedOverride, removeCommentsExtendedRelationship, repackDocx, repackDocxFromRaw, updateCoreProperties, updateDocumentXml, updateMultipleFiles, updateXmlFile, validateDocx };

package/dist/docx/rezip.js

@@ -18,7 +18,7 @@ import { serializeStylesXml } from "./serializer/stylesSerializer.js";
 import { serializeThemeXml } from "./serializer/themeSerializer.js";
 import { escapeXml } from "./serializer/xmlUtils.js";
 import { isPreservableDocxEntry } from "./unzip.js";
-import { findChild, getChildElements, getLocalName, getNamespaceUri, matchesName, parseXml } from "./xmlParser.js";
+import { WORDPROCESSINGML_NAMESPACE_URIS, findChild, getChildElements, getLocalName, getNamespaceUri, matchesName, parseXml } from "./xmlParser.js";
 import { assertXmlResourceLimits } from "./xmlResourceLimits.js";
 import { panic } from "better-result";
 import JSZip from "jszip";
@@ -70,8 +70,7 @@ function findMaxRId(relsXml) {
 	}
 	return maxId;
 }
-const WORDPROCESSINGML_NAMESPACES = /* @__PURE__ */ new Set(["http://schemas.openxmlformats.org/wordprocessingml/2006/main", "http://purl.oclc.org/ooxml/wordprocessingml/main"]);
-const isWordprocessingElement = (element, localName) => getLocalName(element.name) === localName && WORDPROCESSINGML_NAMESPACES.has(getNamespaceUri(element) ?? "");
+const isWordprocessingElement = (element, localName) => getLocalName(element.name) === localName && WORDPROCESSINGML_NAMESPACE_URIS.has(getNamespaceUri(element) ?? "");
 const countDocumentSections = (xml) => {
 	assertXmlResourceLimits(xml);
 	let count = 0;
@@ -212,15 +211,22 @@ function relativeTargetForPart(partPath, absoluteTarget) {
 	while (shared < fromDir.length && shared < to.length - 1 && fromDir[shared] === to[shared]) shared += 1;
 	return `${"../".repeat(fromDir.length - shared)}${to.slice(shared).join("/")}`;
 }
-function collectImageParts(doc) {
+/**
+* Every package part whose block content may mint relationships (images,
+* external hyperlinks), paired with the rels part those relationships belong
+* to. Header/footer parts own `word/_rels/<part>.rels`; footnotes and endnotes
+* own `word/_rels/<notes part>.rels`, derived from the ZIP entry the note
+* serializer resolves (case-insensitively) so a producer's casing is reused
+* instead of minting a second, lowercase rels part.
+*/
+function collectDocxParts(doc, zip) {
 	const parts = [{
 		relsPath: "word/_rels/document.xml.rels",
 		blocks: doc.package.document.content
 	}];
 	const rels = doc.package.relationships;
-	if (!rels) return parts;
 	const addHeaderFooterParts = (map, type) => {
-		if (!map) return;
+		if (!map || !rels) return;
 		for (const [rId, headerFooter] of map.entries()) {
 			const rel = rels.get(rId);
 			if (!rel || rel.type !== type || !rel.target) continue;
@@ -232,6 +238,16 @@ function collectImageParts(doc) {
 	};
 	addHeaderFooterParts(doc.package.headers, RELATIONSHIP_TYPES.header);
 	addHeaderFooterParts(doc.package.footers, RELATIONSHIP_TYPES.footer);
+	const addNoteParts = (notes, conventionalLowerPath) => {
+		if (!notes || notes.length === 0) return;
+		const partPath = findNotePartEntry(zip, conventionalLowerPath)?.name ?? conventionalLowerPath;
+		parts.push({
+			relsPath: notePartRelsPath(partPath),
+			blocks: notes.flatMap((note) => note.content)
+		});
+	};
+	addNoteParts(doc.package.footnotes, "word/footnotes.xml");
+	addNoteParts(doc.package.endnotes, "word/endnotes.xml");
 	return parts;
 }
 async function readRelsOrStub(zip, relsPath) {
@@ -360,30 +376,29 @@ function collectHyperlinksWithoutRId(blocks) {
 	for (const block of blocks) if (block.type === "paragraph") {
 		for (const item of block.content) if (item.type === "hyperlink" && item.href && !item.rId && !item.anchor) hyperlinks.push(item);
 	} else if (block.type === "table") for (const row of block.rows) for (const cell of row.cells) hyperlinks.push(...collectHyperlinksWithoutRId(cell.content));
+	else hyperlinks.push(...collectHyperlinksWithoutRId(block.content));
 	return hyperlinks;
 }
 /**
-* Process newly created hyperlinks: assign rIds and add relationship entries.
-* Mutates the hyperlinks' rId fields in-place.
+* Process newly created hyperlinks in every part: assign rIds and add
+* relationship entries to the owning part's rels. Mutates the hyperlinks' rId
+* fields in-place.
 */
-async function processNewHyperlinks(newHyperlinks, zip, compressionLevel) {
-	if (newHyperlinks.length === 0) return;
-	const relsPath = "word/_rels/document.xml.rels";
-	const relsFile = zip.file(relsPath);
-	if (!relsFile) return;
-	let relsXml = await relsFile.async("text");
-	let maxId = findMaxRId(relsXml);
-	const relEntries = [];
-	for (const hyperlink of newHyperlinks) {
-		maxId++;
-		const newRId = `rId${maxId}`;
-		if (!hyperlink.href) continue;
-		relEntries.push(`<Relationship Id="${newRId}" Type="${RELATIONSHIP_TYPES.hyperlink}" Target="${escapeXml(hyperlink.href)}" TargetMode="External"/>`);
-		hyperlink.rId = newRId;
-	}
-	if (relEntries.length > 0) {
-		relsXml = relsXml.replace("</Relationships>", `${relEntries.join("")}</Relationships>`);
-		zip.file(relsPath, relsXml, {
+async function processNewHyperlinks(parts, zip, compressionLevel) {
+	for (const { relsPath, blocks } of parts) {
+		const newHyperlinks = collectHyperlinksWithoutRId(blocks);
+		if (newHyperlinks.length === 0) continue;
+		const relsXml = await readRelsOrStub(zip, relsPath);
+		let maxId = findMaxRId(relsXml);
+		const relEntries = [];
+		for (const hyperlink of newHyperlinks) {
+			if (!hyperlink.href) continue;
+			maxId++;
+			const newRId = `rId${maxId}`;
+			relEntries.push(`<Relationship Id="${newRId}" Type="${RELATIONSHIP_TYPES.hyperlink}" Target="${escapeXml(hyperlink.href)}" TargetMode="External"/>`);
+			hyperlink.rId = newRId;
+		}
+		zip.file(relsPath, relsXml.replace("</Relationships>", `${relEntries.join("")}</Relationships>`), {
 			compression: "DEFLATE",
 			compressionOptions: { level: compressionLevel }
 		});
@@ -420,8 +435,9 @@ const cloneDocxZip = (source) => {
 };
 const finishRepack = async ({ document, originalZip, outputZip, originalDocumentXml, originalCorePropertiesXml, compressionLevel, updateModifiedDate, modifiedBy }) => {
 	await materializeNewHeaderFooterParts(document, outputZip, compressionLevel);
-	await processNewImages(collectImageParts(document), outputZip, compressionLevel);
-	await processNewHyperlinks(collectHyperlinksWithoutRId(document.package.document.content), outputZip, compressionLevel);
+	const parts = collectDocxParts(document, outputZip);
+	await processNewImages(parts, outputZip, compressionLevel);
+	await processNewHyperlinks(parts, outputZip, compressionLevel);
 	assertValidFolioDocumentModel(document, "Cannot repack invalid DOCX document model");
 	applyReplyThreadMarkers(document);
 	const documentXml = serializeDocument(document);
@@ -499,8 +515,9 @@ async function repackDocxFromRaw(doc, rawContent, options = {}) {
 		});
 	}
 	await materializeNewHeaderFooterParts(exportDocument, newZip, compressionLevel);
-	await processNewImages(collectImageParts(exportDocument), newZip, compressionLevel);
-	await processNewHyperlinks(collectHyperlinksWithoutRId(exportDocument.package.document.content), newZip, compressionLevel);
+	const parts = collectDocxParts(exportDocument, newZip);
+	await processNewImages(parts, newZip, compressionLevel);
+	await processNewHyperlinks(parts, newZip, compressionLevel);
 	assertValidFolioDocumentModel(exportDocument, "Cannot repack invalid DOCX document model");
 	applyReplyThreadMarkers(exportDocument);
 	const documentXml = serializeDocument(exportDocument);
@@ -768,14 +785,17 @@ function findMaxHeaderFooterNum(zip, prefix) {
 * relationship.
 */
 async function materializeNewHeaderFooterParts(doc, zip, compressionLevel) {
-	const rels = doc.package.relationships;
-	if (!rels) return;
 	if (!hasUnmaterializedHeaderFooter(doc)) return;
+	doc.package.relationships ??= /* @__PURE__ */ new Map();
+	const rels = doc.package.relationships;
 	const relEntries = [];
 	const overrides = [];
 	let maxHeaderNum = findMaxHeaderFooterNum(zip, "header");
 	let maxFooterNum = findMaxHeaderFooterNum(zip, "footer");
-	let maxRId = 0;
+	const relsPath = "word/_rels/document.xml.rels";
+	const relsXml = await readRelsOrStub(zip, relsPath);
+	const zipRels = parseRelationships(relsXml);
+	let maxRId = findMaxRId(relsXml);
 	const considerNumericRId = (id) => {
 		const match = /^rId(?<num>\d+)$/u.exec(id);
 		if (match) {
@@ -792,7 +812,7 @@ async function materializeNewHeaderFooterParts(doc, zip, compressionLevel) {
 	const materialize = (map, relType, prefix, contentType, isHeader) => {
 		if (!map) return;
 		for (const rId of [...map.keys()]) {
-			const existing = rels.get(rId);
+			const existing = rels.get(rId) ?? zipRels.get(rId);
 			if (existing && existing.type === relType && existing.target) continue;
 			let effectiveRId = rId;
 			if (existing) {
@@ -820,8 +840,6 @@ async function materializeNewHeaderFooterParts(doc, zip, compressionLevel) {
 	materialize(doc.package.footers, RELATIONSHIP_TYPES.footer, "footer", FOOTER_CONTENT_TYPE, false);
 	if (relEntries.length === 0) return;
 	const compressionOptions = { level: compressionLevel };
-	const relsPath = "word/_rels/document.xml.rels";
-	const relsXml = await readRelsOrStub(zip, relsPath);
 	zip.file(relsPath, relsXml.replace("</Relationships>", `${relEntries.join("")}</Relationships>`), {
 		compression: "DEFLATE",
 		compressionOptions
@@ -1109,6 +1127,11 @@ function collectChangedNoteParaIds(baselineXml, currentXml) {
 	}
 	return changed;
 }
+/** `word/Footnotes.xml` -> `word/_rels/Footnotes.xml.rels` (casing preserved). */
+function notePartRelsPath(partPath) {
+	const lastSlash = partPath.lastIndexOf("/");
+	return `${partPath.slice(0, lastSlash + 1)}_rels/${partPath.slice(lastSlash + 1)}.rels`;
+}
 /**
 * Locate a note part in the ZIP, matching case-insensitively so a producer that
 * cased the entry differently still resolves to the existing part.
@@ -1362,4 +1385,4 @@ const assertStyleNumberingReferences = (doc) => {
 	for (const numbering of doc.package.numbering?.nums ?? []) if (!availableAbstract.has(numbering.abstractNumId)) panic(`Numbering definition ${numbering.numId} references missing abstract numbering`);
 };
 //#endregion
-export { COMMENTS_CONTENT_TYPE, COMMENTS_EXTENDED_CONTENT_TYPE, COMMENTS_EXTENDED_PART, COMMENTS_EXTENDED_PART_LOWER, DocxPackageFidelityError, addCommentsExtendedOverride, addCommentsExtendedRelationship, addMedia, addRelationship, applyUpdatesToZip, collectHeaderFooterUpdates, createDocx, createEmptyDocx, findMaxRId, hasModelDrivenPictureWatermark, hasUnmaterializedHeaderFooter, isDocxBuffer, removeCommentsExtendedOverride, removeCommentsExtendedRelationship, repackDocx, repackDocxFromRaw, updateCoreProperties, updateDocumentXml, updateMultipleFiles, updateXmlFile, validateDocx };
+export { COMMENTS_CONTENT_TYPE, COMMENTS_EXTENDED_CONTENT_TYPE, COMMENTS_EXTENDED_PART, COMMENTS_EXTENDED_PART_LOWER, DocxPackageFidelityError, addCommentsExtendedOverride, addCommentsExtendedRelationship, addMedia, addRelationship, applyUpdatesToZip, collectHeaderFooterUpdates, collectHyperlinksWithoutRId, createDocx, createEmptyDocx, findMaxRId, hasModelDrivenPictureWatermark, hasUnmaterializedHeaderFooter, isDocxBuffer, notePartRelsPath, removeCommentsExtendedOverride, removeCommentsExtendedRelationship, repackDocx, repackDocxFromRaw, updateCoreProperties, updateDocumentXml, updateMultipleFiles, updateXmlFile, validateDocx };

package/dist/docx/selectiveSave.js

@@ -182,6 +182,12 @@ async function attemptSelectiveSave(doc, originalBuffer, options) {
 	if (originalBuffer.byteLength > maxBytes) return null;
 	const content = doc.package.document.content;
 	if (hasNewImagesOrHyperlinks(content)) return null;
+	for (const part of [
+		...doc.package.headers?.values() ?? [],
+		...doc.package.footers?.values() ?? [],
+		...doc.package.footnotes ?? [],
+		...doc.package.endnotes ?? []
+	]) if (hasNewImagesOrHyperlinks(part.content)) return null;
 	if (hasUnmaterializedHeaderFooter(doc)) return null;
 	if (hasModelDrivenPictureWatermark(doc)) return null;
 	if (withoutOrphanCommentRanges(doc) !== doc) return null;

package/dist/docx/serializer/paragraphSerializer.js

@@ -263,6 +263,7 @@ function serializeComplexField(field) {
 	const rPrXml = structuralFormatting ? serializeTextFormatting(structuralFormatting) : "";
 	const beginAttrs = ["w:fldCharType=\"begin\""];
 	if (field.fldLock) beginAttrs.push("w:fldLock=\"true\"");
+	if (field.dirty) beginAttrs.push("w:dirty=\"true\"");
 	parts.push(`<w:r>${rPrXml}<w:fldChar ${beginAttrs.join(" ")}/></w:r>`);
 	if (field.fieldCode.length > 0) parts.push(...field.fieldCode.map((run) => serializeRun(run)));
 	else if (field.instruction.length > 0) {

package/dist/docx/serializer/settingsSerializer.js

@@ -4,6 +4,7 @@ const W_NS = "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
 const serializeSettingsXml = (settings) => {
 	const parts = [`<w:defaultTabStop w:val="${intAttr(settings.defaultTabStop)}"/>`];
 	if (settings.evenAndOddHeaders) parts.push("<w:evenAndOddHeaders/>");
+	if (settings.updateFields) parts.push("<w:updateFields w:val=\"true\"/>");
 	if (settings.themeFontLang) {
 		const attrs = [];
 		if (settings.themeFontLang.eastAsia) attrs.push(`w:eastAsia="${escapeXml(settings.themeFontLang.eastAsia)}"`);

package/dist/docx/server/build.d.ts

@@ -0,0 +1,103 @@
+import { document_d_exports } from "../../types/document.js";
+import { ShadingProperties } from "../../types/colors.js";
+import { Hyperlink, Paragraph, ParagraphContent, Run, Table } from "../../types/content.js";
+import { ParagraphFormatting, TextFormatting } from "../../types/formatting.js";
+//#region src/docx/server/build.d.ts
+declare const HEADING_LEVELS: readonly [1, 2, 3, 4, 5, 6];
+type HeadingLevel = (typeof HEADING_LEVELS)[number];
+declare const InvalidFolioReportBuilderOptionsError_base: import("better-result").TaggedErrorClass<"InvalidFolioReportBuilderOptionsError", {
+  message: string;
+  path: string;
+}>;
+/**
+ * A builder received a value outside the model's domain (a zero `gridSpan`,
+ * a negative column width, a reversed TOC range). Thrown at the boundary so
+ * the invalid value never reaches the serializer.
+ */
+declare class InvalidFolioReportBuilderOptionsError extends InvalidFolioReportBuilderOptionsError_base {}
+declare const run: (text: string, formatting?: TextFormatting) => Run;
+declare const paragraph: (content: string | ParagraphContent[], formatting?: ParagraphFormatting) => Paragraph;
+type HeadingOptions = {
+  text: string;
+  level: HeadingLevel;
+};
+/** A paragraph in the `Heading<level>` style. */
+declare const heading: ({ text, level }: HeadingOptions) => Paragraph;
+/** An empty paragraph carrying a hard page break. */
+declare const pageBreak: () => Paragraph;
+type HyperlinkTarget = {
+  href: string;
+  anchor?: never;
+} | {
+  anchor: string;
+  href?: never;
+};
+type HyperlinkOptions = HyperlinkTarget & {
+  text: string;
+  formatting?: TextFormatting;
+  tooltip?: string;
+};
+/**
+ * An external (`href`) or in-document (`anchor`, a bookmark name) link. The
+ * relationship for an external link is minted when the document is written.
+ */
+declare const hyperlink: ({ text, formatting, tooltip, href, anchor }: HyperlinkOptions) => Hyperlink;
+type BookmarkOptions = {
+  name: string;
+  content: ParagraphContent[];
+  /**
+   * Bookmark id, unique per document. Defaults to a process-wide counter,
+   * which is unique for documents built from scratch; pass an explicit id
+   * when adding bookmarks to a parsed document.
+   */
+  id?: number;
+};
+/** `content` wrapped in a named bookmark, the target of `hyperlink({ anchor })`. */
+declare const bookmark: ({ name, content, id }: BookmarkOptions) => ParagraphContent[];
+type TableCellSpec = string | {
+  content: Paragraph[];
+  shading?: ShadingProperties;
+  gridSpan?: number;
+  vMerge?: "restart" | "continue";
+};
+type TableOptions = {
+  /** Header row labels; rendered bold, optionally shaded and repeated per page. */
+  header?: string[];
+  rows: TableCellSpec[][];
+  /** Grid column widths in twips. Omitted: the consumer autofits. */
+  columnWidths?: number[];
+  headerShading?: ShadingProperties;
+  /** Repeat the header row at the top of every page (default true). */
+  repeatHeader?: boolean;
+};
+/**
+ * A full-width grid table in the `TableGrid` style. A string cell becomes one
+ * plain paragraph; an object cell supplies its own paragraphs plus optional
+ * shading and horizontal (`gridSpan`) or vertical (`vMerge`) merge.
+ */
+declare const table: ({ header, rows, columnWidths, headerShading, repeatHeader }: TableOptions) => Table;
+/**
+ * Register an endnote on `doc` and return the reference run to place in body
+ * text. Allocates the next free endnote id (Word reserves 0 and -1 for the
+ * separator notes) and pushes the note into `doc.package.endnotes`.
+ */
+declare const endnote: (doc: document_d_exports.Document, content: string | Paragraph[]) => Run;
+type TableOfContentsOptions = {
+  /** Heading levels to include, `1 <= from <= to <= 9` (default 1-3). */
+  levels?: {
+    from: number;
+    to: number;
+  };
+  /** Make entries hyperlinks (`\h`, default true). */
+  hyperlinks?: boolean;
+  /** Result text shown until the consumer recomputes the field. */
+  placeholderText?: string;
+};
+/**
+ * A paragraph holding a dirty `TOC` field, so the consumer recomputes the
+ * table on open. Set `package.settings.updateFields` as well to have Word
+ * recompute without prompting for each field.
+ */
+declare const createTableOfContentsField: ({ levels, hyperlinks, placeholderText }?: TableOfContentsOptions) => Paragraph;
+//#endregion
+export { HEADING_LEVELS, HeadingLevel, InvalidFolioReportBuilderOptionsError, TableCellSpec, bookmark, createTableOfContentsField, endnote, heading, hyperlink, pageBreak, paragraph, run, table };

package/dist/docx/server/build.js

@@ -0,0 +1,265 @@
+import { TaggedError } from "better-result";
+//#region src/docx/server/build.ts
+/**
+* Headless document builders.
+*
+* Thin constructors for the `@stll/docx-core` model so a server can assemble
+* a report in code (`createEmptyDocument` → push blocks → `createDocx`)
+* without hand-writing model literals. They build model values only; the
+* serializer owns the OOXML.
+*/
+/** Character style applied to hyperlink text; present in the bundled style sets. */
+const HYPERLINK_STYLE_ID = "Hyperlink";
+/** Character style applied to the endnote reference mark. */
+const ENDNOTE_REFERENCE_STYLE_ID = "EndnoteReference";
+/** Paragraph style applied to endnote body paragraphs. */
+const ENDNOTE_TEXT_STYLE_ID = "EndnoteText";
+/** Table style used by `table()`; present in the bundled style sets. */
+const TABLE_STYLE_ID = "TableGrid";
+/** `w:tblW w:type="pct"` is in fiftieths of a percent: 5000 = 100%. */
+const FULL_WIDTH_PCT = 5e3;
+const HEADING_LEVELS = [
+	1,
+	2,
+	3,
+	4,
+	5,
+	6
+];
+/** Outline levels a `TOC \o` switch may name (ECMA-376 `w:outlineLvl` 0-8). */
+const TOC_LEVEL_MIN = 1;
+const TOC_LEVEL_MAX = 9;
+/**
+* A builder received a value outside the model's domain (a zero `gridSpan`,
+* a negative column width, a reversed TOC range). Thrown at the boundary so
+* the invalid value never reaches the serializer.
+*/
+var InvalidFolioReportBuilderOptionsError = class extends TaggedError("InvalidFolioReportBuilderOptionsError")() {};
+const assertPositiveInteger = (value, path) => {
+	if (!Number.isInteger(value) || value < 1) throw new InvalidFolioReportBuilderOptionsError({
+		message: `${path} must be a positive integer, got ${String(value)}`,
+		path
+	});
+};
+const assertHeadingLevel = (level) => {
+	if (!HEADING_LEVELS.some((known) => known === level)) throw new InvalidFolioReportBuilderOptionsError({
+		message: `level must be one of ${HEADING_LEVELS.join(", ")}, got ${String(level)}`,
+		path: "level"
+	});
+};
+const assertTocLevels = ({ from, to }) => {
+	const inRange = (value) => Number.isInteger(value) && value >= TOC_LEVEL_MIN && value <= TOC_LEVEL_MAX;
+	if (!inRange(from) || !inRange(to) || from > to) throw new InvalidFolioReportBuilderOptionsError({
+		message: `levels must satisfy ${TOC_LEVEL_MIN} <= from <= to <= ${TOC_LEVEL_MAX}, got ${String(from)}-${String(to)}`,
+		path: "levels"
+	});
+};
+const run = (text, formatting) => ({
+	type: "run",
+	...formatting ? { formatting } : {},
+	content: [{
+		type: "text",
+		text
+	}]
+});
+const paragraph = (content, formatting) => ({
+	type: "paragraph",
+	...formatting ? { formatting } : {},
+	content: typeof content === "string" ? [run(content)] : content
+});
+/** A paragraph in the `Heading<level>` style. */
+const heading = ({ text, level }) => {
+	assertHeadingLevel(level);
+	return paragraph(text, { styleId: `Heading${level}` });
+};
+/** An empty paragraph carrying a hard page break. */
+const pageBreak = () => ({
+	type: "paragraph",
+	content: [{
+		type: "run",
+		content: [{
+			type: "break",
+			breakType: "page"
+		}]
+	}]
+});
+/**
+* An external (`href`) or in-document (`anchor`, a bookmark name) link. The
+* relationship for an external link is minted when the document is written.
+*/
+const hyperlink = ({ text, formatting, tooltip, href, anchor }) => ({
+	type: "hyperlink",
+	...href !== void 0 ? { href } : { anchor },
+	...tooltip !== void 0 ? { tooltip } : {},
+	children: [run(text, {
+		styleId: HYPERLINK_STYLE_ID,
+		...formatting
+	})]
+});
+let nextBookmarkId = 0;
+/** `content` wrapped in a named bookmark, the target of `hyperlink({ anchor })`. */
+const bookmark = ({ name, content, id }) => {
+	const bookmarkId = id ?? nextBookmarkId++;
+	const start = {
+		type: "bookmarkStart",
+		id: bookmarkId,
+		name
+	};
+	const end = {
+		type: "bookmarkEnd",
+		id: bookmarkId
+	};
+	return [
+		start,
+		...content,
+		end
+	];
+};
+const cellWidth = (columnWidths, gridIndex, gridSpan) => {
+	if (!columnWidths) return;
+	let width = 0;
+	for (let column = gridIndex; column < gridIndex + gridSpan; column++) {
+		const columnWidth = columnWidths.at(column);
+		if (columnWidth === void 0) return;
+		width += columnWidth;
+	}
+	return width;
+};
+const buildCell = ({ spec, columnWidths, gridIndex, shading, textFormatting }) => {
+	const resolved = typeof spec === "string" ? {
+		content: [paragraph([run(spec, textFormatting)])],
+		shading
+	} : {
+		...spec,
+		shading: spec.shading ?? shading
+	};
+	const gridSpan = resolved.gridSpan ?? 1;
+	assertPositiveInteger(gridSpan, "gridSpan");
+	const width = cellWidth(columnWidths, gridIndex, gridSpan);
+	const formatting = {
+		...width !== void 0 ? { width: {
+			type: "dxa",
+			value: width
+		} } : {},
+		...resolved.shading ? { shading: resolved.shading } : {},
+		...resolved.gridSpan !== void 0 ? { gridSpan: resolved.gridSpan } : {},
+		...resolved.vMerge !== void 0 ? { vMerge: resolved.vMerge } : {}
+	};
+	return {
+		type: "tableCell",
+		...Object.keys(formatting).length > 0 ? { formatting } : {},
+		content: resolved.content.length > 0 ? resolved.content : [paragraph([])]
+	};
+};
+const buildRow = ({ cells, columnWidths, shading, textFormatting, header }) => {
+	const built = [];
+	let gridIndex = 0;
+	for (const spec of cells) {
+		const cell = buildCell({
+			spec,
+			columnWidths,
+			gridIndex,
+			shading,
+			textFormatting
+		});
+		built.push(cell);
+		gridIndex += cell.formatting?.gridSpan ?? 1;
+	}
+	return {
+		type: "tableRow",
+		...header ? { formatting: {
+			header: true,
+			cantSplit: true
+		} } : {},
+		cells: built
+	};
+};
+/**
+* A full-width grid table in the `TableGrid` style. A string cell becomes one
+* plain paragraph; an object cell supplies its own paragraphs plus optional
+* shading and horizontal (`gridSpan`) or vertical (`vMerge`) merge.
+*/
+const table = ({ header, rows, columnWidths, headerShading, repeatHeader = true }) => {
+	columnWidths?.forEach((width, index) => assertPositiveInteger(width, `columnWidths[${index}]`));
+	const builtRows = [];
+	if (header) builtRows.push(buildRow({
+		cells: header,
+		columnWidths,
+		shading: headerShading,
+		textFormatting: { bold: true },
+		header: repeatHeader
+	}));
+	for (const cells of rows) builtRows.push(buildRow({
+		cells,
+		columnWidths,
+		shading: void 0,
+		textFormatting: void 0,
+		header: false
+	}));
+	return {
+		type: "table",
+		formatting: {
+			styleId: TABLE_STYLE_ID,
+			width: {
+				type: "pct",
+				value: FULL_WIDTH_PCT
+			},
+			layout: columnWidths ? "fixed" : "autofit"
+		},
+		...columnWidths ? { columnWidths } : {},
+		rows: builtRows
+	};
+};
+/**
+* Register an endnote on `doc` and return the reference run to place in body
+* text. Allocates the next free endnote id (Word reserves 0 and -1 for the
+* separator notes) and pushes the note into `doc.package.endnotes`.
+*/
+const endnote = (doc, content) => {
+	const endnotes = doc.package.endnotes ?? [];
+	doc.package.endnotes = endnotes;
+	const id = Math.max(0, ...endnotes.map((note) => note.id)) + 1;
+	const note = {
+		type: "endnote",
+		id,
+		content: typeof content === "string" ? [paragraph(content, { styleId: ENDNOTE_TEXT_STYLE_ID })] : content
+	};
+	endnotes.push(note);
+	return {
+		type: "run",
+		formatting: { styleId: ENDNOTE_REFERENCE_STYLE_ID },
+		content: [{
+			type: "endnoteRef",
+			id
+		}]
+	};
+};
+const DEFAULT_TOC_LEVELS = {
+	from: 1,
+	to: 3
+};
+const DEFAULT_TOC_PLACEHOLDER = "Update the field to build the table of contents.";
+/**
+* A paragraph holding a dirty `TOC` field, so the consumer recomputes the
+* table on open. Set `package.settings.updateFields` as well to have Word
+* recompute without prompting for each field.
+*/
+const createTableOfContentsField = ({ levels = DEFAULT_TOC_LEVELS, hyperlinks = true, placeholderText = DEFAULT_TOC_PLACEHOLDER } = {}) => {
+	assertTocLevels(levels);
+	const switches = [`\\o "${levels.from}-${levels.to}"`];
+	if (hyperlinks) switches.push("\\h");
+	switches.push("\\z", "\\u");
+	return {
+		type: "paragraph",
+		content: [{
+			type: "complexField",
+			instruction: `TOC ${switches.join(" ")}`,
+			fieldType: "TOC",
+			fieldCode: [],
+			fieldResult: [run(placeholderText)],
+			dirty: true
+		}]
+	};
+};
+//#endregion
+export { HEADING_LEVELS, InvalidFolioReportBuilderOptionsError, bookmark, createTableOfContentsField, endnote, heading, hyperlink, pageBreak, paragraph, run, table };

package/dist/docx/settingsParser.js

@@ -1,4 +1,4 @@
-import { findChild, findChildren, getAttribute, parseBooleanElement, parseXmlDocument } from "./xmlParser.js";
+import { WORDPROCESSINGML_NAMESPACE_URIS, findChild, findChildByNamespaceUri, findChildren, getAttribute, parseBooleanElement, parseXmlDocument } from "./xmlParser.js";
 //#region src/docx/settingsParser.ts
 /** OOXML default per §17.6.13 when `w:defaultTabStop` is absent. */
 const DEFAULT_TAB_STOP_TWIPS = 720;
@@ -26,10 +26,13 @@ const MAX_KINSOKU_CHARACTERS_LENGTH = 128;
 function parseSettings(xml) {
 	const root = xml ? parseXmlDocument(xml) : null;
 	const settings = { defaultTabStop: parseDefaultTabStop(root) };
-	const evenAndOddHeaders = root ? findChild(root, "w", "evenAndOddHeaders") : null;
-	if (evenAndOddHeaders && parseBooleanElement(evenAndOddHeaders)) settings.evenAndOddHeaders = true;
-	const mirrorMargins = root ? findChild(root, "w", "mirrorMargins") : null;
-	if (mirrorMargins && parseBooleanElement(mirrorMargins)) settings.mirrorMargins = true;
+	const wordprocessingFlag = (localName) => {
+		const element = findChildByNamespaceUri(root, WORDPROCESSINGML_NAMESPACE_URIS, localName);
+		return element !== null && parseBooleanElement(element);
+	};
+	if (wordprocessingFlag("evenAndOddHeaders")) settings.evenAndOddHeaders = true;
+	if (wordprocessingFlag("mirrorMargins")) settings.mirrorMargins = true;
+	if (wordprocessingFlag("updateFields")) settings.updateFields = true;
 	const themeFontLangEl = root ? findChild(root, "w", "themeFontLang") : null;
 	const eastAsiaLang = themeFontLangEl ? getAttribute(themeFontLangEl, "w", "eastAsia") || void 0 : void 0;
 	const bidiLang = themeFontLangEl ? getAttribute(themeFontLangEl, "w", "bidi") || void 0 : void 0;

package/dist/docx/xmlParser.d.ts

@@ -96,6 +96,14 @@ declare function getLocalName(name: string | undefined): string;
 declare function getNamespacePrefix(name: string): string | null;
 /** Namespace URI resolved from the element's in-scope XML declarations. */
 declare const getNamespaceUri: (element: XmlElement) => string | undefined;
+/** WordprocessingML main namespace, Transitional and Strict (ECMA-376 Parts 1 and 4). */
+declare const WORDPROCESSINGML_NAMESPACE_URIS: ReadonlySet<string>;
+/**
+ * First child whose local name matches AND whose resolved namespace URI is
+ * one of `namespaceUris`. Unlike {@link findChild}, a same-named element
+ * from a foreign namespace is not accepted.
+ */
+declare function findChildByNamespaceUri(parent: XmlElement | null | undefined, namespaceUris: ReadonlySet<string>, localName: string): XmlElement | null;
 /** Get an attribute whose prefix resolves to one of the accepted namespace URIs. */
 declare function getAttributeByNamespaceUri(element: XmlElement | null | undefined, namespaceUris: ReadonlySet<string>, localName: string): string | null;
 /**
@@ -326,4 +334,4 @@ declare function mergeXmlnsDeclarations(inherited: Record<string, string>, eleme
  */
 declare function cloneWithXmlnsDeclarations(element: XmlElement, xmlnsDecls: Record<string, string>): XmlElement;
 //#endregion
-export { NAMESPACES, XmlElement, XmlNamespaceScope, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findByFullName, findChild, findChildByLocalName, findChildren, findChildrenByLocalName, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributeByNamespaceUri, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseTableMeasurementValue, parseXml, parseXmlDocument };
+export { NAMESPACES, WORDPROCESSINGML_NAMESPACE_URIS, XmlElement, XmlNamespaceScope, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findByFullName, findChild, findChildByLocalName, findChildByNamespaceUri, findChildren, findChildrenByLocalName, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributeByNamespaceUri, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseTableMeasurementValue, parseXml, parseXmlDocument };

package/dist/docx/xmlParser.js

@@ -196,6 +196,18 @@ function getNamespacePrefix(name) {
 }
 /** Namespace URI resolved from the element's in-scope XML declarations. */
 const getNamespaceUri = (element) => element.namespaceUri;
+/** WordprocessingML main namespace, Transitional and Strict (ECMA-376 Parts 1 and 4). */
+const WORDPROCESSINGML_NAMESPACE_URIS = /* @__PURE__ */ new Set([NAMESPACES.w, "http://purl.oclc.org/ooxml/wordprocessingml/main"]);
+/**
+* First child whose local name matches AND whose resolved namespace URI is
+* one of `namespaceUris`. Unlike {@link findChild}, a same-named element
+* from a foreign namespace is not accepted.
+*/
+function findChildByNamespaceUri(parent, namespaceUris, localName) {
+	if (!parent?.elements) return null;
+	for (const child of parent.elements) if (child.type === "element" && hasLocalName(child.name, localName) && namespaceUris.has(child.namespaceUri ?? "")) return child;
+	return null;
+}
 /** Get an attribute whose prefix resolves to one of the accepted namespace URIs. */
 function getAttributeByNamespaceUri(element, namespaceUris, localName) {
 	if (!element?.attributes) return null;
@@ -687,4 +699,4 @@ function cloneWithXmlnsDeclarations(element, xmlnsDecls) {
 	return element;
 }
 //#endregion
-export { NAMESPACES, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findByFullName, findChild, findChildByLocalName, findChildren, findChildrenByLocalName, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributeByNamespaceUri, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseTableMeasurementValue, parseXml, parseXmlDocument };
+export { NAMESPACES, WORDPROCESSINGML_NAMESPACE_URIS, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findByFullName, findChild, findChildByLocalName, findChildByNamespaceUri, findChildren, findChildrenByLocalName, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributeByNamespaceUri, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseTableMeasurementValue, parseXml, parseXmlDocument };

package/dist/server.d.ts

@@ -12,14 +12,16 @@ import { STELLA_STYLE_SET_NAME, createStellaStyleDocumentPreset, createStellaSty
 import { createDocx } from "./docx/rezip.js";
 import { EnsureParaIdsError, EnsureParaIdsOptions, EnsureParaIdsResult, ensureParaIds } from "./docx/ensureParaIds.js";
 import { FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FolioDocumentMetadataProperty, FolioDocumentPrivacyArchiveError, FolioDocumentPrivacyOptions, FolioDocumentPrivacyReport, FolioDocumentPrivacyTransform, InvalidFolioDocumentPrivacyOptionsError, RewriteDocxMetadataPrivacyResult, isFolioDocumentPrivacyTransform, rewriteDocxMetadataPrivacy } from "./docx/metadataPrivacy.js";
+import { ParseOptions, parseDocx } from "./docx/parser.js";
 import { CreateCommentReplyInput, replyToComment } from "./docx/replyToComment.js";
 import { DocxArchiveError, DocxArchiveOptions } from "./docx/server/boundedArchive.js";
 import { EvaluateDocxXmlPatchProposalArgs, FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS, FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES, FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION, FolioDocxPreparedXmlReplacement, FolioDocxXmlPatchProposal, FolioDocxXmlPatchProposalEvaluation, FolioDocxXmlPatchProposalIssue, FolioDocxXmlPatchProposalIssueCode, FolioDocxXmlPatchProposalLimits, FolioDocxXmlReplacement, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, evaluateDocxXmlPatchProposal, parseFolioDocxXmlPatchProposal } from "./docx/server/evaluateDocxXmlPatchProposal.js";
 import { FOLIO_DOCX_CONFORMANCE_CHECKS, FOLIO_DOCX_CONFORMANCE_ISSUE_CODES, FOLIO_DOCX_CONFORMANCE_PROFILE, FOLIO_DOCX_CONFORMANCE_REPORT_VERSION, FolioDocxConformanceCheck, FolioDocxConformanceCheckId, FolioDocxConformanceCheckStatus, FolioDocxConformanceIssue, FolioDocxConformanceIssueCode, FolioDocxConformanceReport, FolioDocxConformanceStatus, ValidateDocxConformanceOptions, validateDocxConformance } from "./docx/server/validateDocxConformance.js";
 import { ApplyDocxXmlPatchProposalArgs, FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FolioDocxXmlPatchApplication, FolioDocxXmlPatchApplicationError, FolioDocxXmlPatchApplicationReceipt, UnsupportedFolioDocxXmlPatchApplicationProfileError, applyDocxXmlPatchProposal } from "./docx/server/applyDocxXmlPatchProposal.js";
+import { HEADING_LEVELS, HeadingLevel, InvalidFolioReportBuilderOptionsError, TableCellSpec, bookmark, createTableOfContentsField, endnote, heading, hyperlink, pageBreak, paragraph, run, table } from "./docx/server/build.js";
 import { docxToMarkdown } from "./docx/server/docxToMarkdown.js";
 import { DocxParagraphSource, DocxTableRowKind, DocxTableRowPosition, ExtractedDocxParagraph, ExtractedDocxTableCell, ExtractedDocxTableCellParagraph, ExtractedDocxText, extractDocxText } from "./docx/server/extractDocxText.js";
 import { FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES, FOLIO_DOCX_PACKAGE_INSPECTION_VERSION, FolioDocxInspectedXmlPart, FolioDocxPackageInspection, FolioDocxPackageInspectionError, FolioDocxPackageInspectionErrorCode, FolioDocxPackageInspectionLimits, FolioDocxPackagePart, FolioDocxPackagePartKind, InspectDocxPackageOptions, inspectDocxPackage } from "./docx/server/inspectDocxPackage.js";
 import { GenerateRedlineDocxOptions, GenerateRedlineDocxResult, GenerateRedlineUnprocessedStory, InvalidGenerateRedlineDocxOptionsError, generateRedlineDocx } from "./redline.js";
 import { FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, FolioBlockDiff, FolioCompareDocxVersionsOptions, FolioDocumentMetadataValue, FolioFormatProperty, FolioMetadataDiff, FolioStoryDiff, FolioVersionBlockHandle, FolioVersionComparisonPrivacyTransform, FolioVersionComparisonScope, FolioVersionDiff, FolioVersionDiffPrivacyOptions, FolioVersionDiffPrivacyReport, FolioVersionDiffSegment, FolioVersionDiffSummaryCounts, InvalidFolioVersionComparisonOptionsError, applyFolioVersionDiffPrivacy, compareDocxVersions, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope } from "./version-comparison.js";
-export { type ApplyDocxXmlPatchProposalArgs, type ApplyFolioAIEditsToBufferOptions, type ApplyFolioAIEditsToBufferResult, type CreateCommentReplyInput, type CreateEmptyDocumentOptions, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, type DeriveBlockIdInput, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, DocxArchiveError, type DocxArchiveOptions, type DocxParagraphSource, type DocxTableRowKind, type DocxTableRowPosition, EnsureParaIdsError, type EnsureParaIdsOptions, type EnsureParaIdsResult, type EvaluateDocxXmlPatchProposalArgs, type ExtractDocumentStyleSetOptions, type ExtractedDocxParagraph, type ExtractedDocxTableCell, type ExtractedDocxTableCellParagraph, type ExtractedDocxText, FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FOLIO_DOCX_CONFORMANCE_CHECKS, FOLIO_DOCX_CONFORMANCE_ISSUE_CODES, FOLIO_DOCX_CONFORMANCE_PROFILE, FOLIO_DOCX_CONFORMANCE_REPORT_VERSION, FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES, FOLIO_DOCX_PACKAGE_INSPECTION_VERSION, FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS, FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES, FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditSnapshot, type FolioAIInlineFormatting, type FolioAITextRangeHandle, type FolioApplyDocumentOperationsOptions, type FolioApplyDocumentOperationsToStoryOptions, type FolioApplyOperationsOptions, type FolioBlockDiff, type FolioBlockId, type FolioCompareDocxVersionsOptions, type FolioDocumentMetadataProperty, type FolioDocumentMetadataValue, type FolioDocumentNavigationTarget, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocumentOutline, type FolioDocumentOutlineEntry, FolioDocumentPrivacyArchiveError, type FolioDocumentPrivacyOptions, type FolioDocumentPrivacyReport, type FolioDocumentPrivacyTransform, type FolioDocumentSection, type FolioDocumentSectionHandle, type FolioDocumentSectionReadResult, type FolioDocumentStory, type FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, type FolioDocxConformanceCheck, type FolioDocxConformanceCheckId, type FolioDocxConformanceCheckStatus, type FolioDocxConformanceIssue, type FolioDocxConformanceIssueCode, type FolioDocxConformanceReport, type FolioDocxConformanceStatus, type FolioDocxInspectedXmlPart, type FolioDocxPackageInspection, FolioDocxPackageInspectionError, type FolioDocxPackageInspectionErrorCode, type FolioDocxPackageInspectionLimits, type FolioDocxPackagePart, type FolioDocxPackagePartKind, type FolioDocxPreparedXmlReplacement, FolioDocxReviewer, type FolioDocxReviewerOptions, type FolioDocxXmlPatchApplication, FolioDocxXmlPatchApplicationError, type FolioDocxXmlPatchApplicationReceipt, type FolioDocxXmlPatchProposal, type FolioDocxXmlPatchProposalEvaluation, type FolioDocxXmlPatchProposalIssue, type FolioDocxXmlPatchProposalIssueCode, type FolioDocxXmlPatchProposalLimits, type FolioDocxXmlReplacement, type FolioEditableDocumentStoryHandle, type FolioFormatProperty, type FolioMetadataDiff, type FolioReadReviewedStoryOptions, type FolioResolveReviewedStoryOptions, type FolioResolvedReviewedView, type FolioReviewChange, type FolioReviewChangeFilter, type FolioReviewChangeKind, type FolioReviewComment, type FolioReviewCommentFilter, type FolioReviewCommentReply, type FolioReviewReplyInput, type FolioReviewedStory, type FolioReviewedView, type FolioStoryDiff, type FolioVersionBlockHandle, type FolioVersionComparisonPrivacyTransform, type FolioVersionComparisonScope, type FolioVersionDiff, type FolioVersionDiffPrivacyOptions, type FolioVersionDiffPrivacyReport, type FolioVersionDiffSegment, type FolioVersionDiffSummaryCounts, type GenerateRedlineDocxOptions, type GenerateRedlineDocxResult, type GenerateRedlineUnprocessedStory, type InspectDocxPackageOptions, InvalidFolioDocumentOperationBatchError, InvalidFolioDocumentPrivacyOptionsError, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, InvalidFolioVersionComparisonOptionsError, InvalidGenerateRedlineDocxOptionsError, type RewriteDocxMetadataPrivacyResult, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioDocxXmlPatchApplicationProfileError, UnsupportedFolioReviewedViewError, type ValidateDocxConformanceOptions, applyDocxXmlPatchProposal, applyFolioAIEditsToBuffer, applyFolioVersionDiffPrivacy, assertSupportedFolioDocumentOperationVersion, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, docxToMarkdown, ensureParaIds, evaluateDocxXmlPatchProposal, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxPackage, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, parseFolioDocxXmlPatchProposal, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy, validateDocxConformance };
+export { type ApplyDocxXmlPatchProposalArgs, type ApplyFolioAIEditsToBufferOptions, type ApplyFolioAIEditsToBufferResult, type CreateCommentReplyInput, type CreateEmptyDocumentOptions, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, type DeriveBlockIdInput, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, DocxArchiveError, type DocxArchiveOptions, type DocxParagraphSource, type DocxTableRowKind, type DocxTableRowPosition, EnsureParaIdsError, type EnsureParaIdsOptions, type EnsureParaIdsResult, type EvaluateDocxXmlPatchProposalArgs, type ExtractDocumentStyleSetOptions, type ExtractedDocxParagraph, type ExtractedDocxTableCell, type ExtractedDocxTableCellParagraph, type ExtractedDocxText, FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FOLIO_DOCX_CONFORMANCE_CHECKS, FOLIO_DOCX_CONFORMANCE_ISSUE_CODES, FOLIO_DOCX_CONFORMANCE_PROFILE, FOLIO_DOCX_CONFORMANCE_REPORT_VERSION, FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES, FOLIO_DOCX_PACKAGE_INSPECTION_VERSION, FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS, FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES, FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditSnapshot, type FolioAIInlineFormatting, type FolioAITextRangeHandle, type FolioApplyDocumentOperationsOptions, type FolioApplyDocumentOperationsToStoryOptions, type FolioApplyOperationsOptions, type FolioBlockDiff, type FolioBlockId, type FolioCompareDocxVersionsOptions, type FolioDocumentMetadataProperty, type FolioDocumentMetadataValue, type FolioDocumentNavigationTarget, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocumentOutline, type FolioDocumentOutlineEntry, FolioDocumentPrivacyArchiveError, type FolioDocumentPrivacyOptions, type FolioDocumentPrivacyReport, type FolioDocumentPrivacyTransform, type FolioDocumentSection, type FolioDocumentSectionHandle, type FolioDocumentSectionReadResult, type FolioDocumentStory, type FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, type FolioDocxConformanceCheck, type FolioDocxConformanceCheckId, type FolioDocxConformanceCheckStatus, type FolioDocxConformanceIssue, type FolioDocxConformanceIssueCode, type FolioDocxConformanceReport, type FolioDocxConformanceStatus, type FolioDocxInspectedXmlPart, type FolioDocxPackageInspection, FolioDocxPackageInspectionError, type FolioDocxPackageInspectionErrorCode, type FolioDocxPackageInspectionLimits, type FolioDocxPackagePart, type FolioDocxPackagePartKind, type FolioDocxPreparedXmlReplacement, FolioDocxReviewer, type FolioDocxReviewerOptions, type FolioDocxXmlPatchApplication, FolioDocxXmlPatchApplicationError, type FolioDocxXmlPatchApplicationReceipt, type FolioDocxXmlPatchProposal, type FolioDocxXmlPatchProposalEvaluation, type FolioDocxXmlPatchProposalIssue, type FolioDocxXmlPatchProposalIssueCode, type FolioDocxXmlPatchProposalLimits, type FolioDocxXmlReplacement, type FolioEditableDocumentStoryHandle, type FolioFormatProperty, type FolioMetadataDiff, type FolioReadReviewedStoryOptions, type FolioResolveReviewedStoryOptions, type FolioResolvedReviewedView, type FolioReviewChange, type FolioReviewChangeFilter, type FolioReviewChangeKind, type FolioReviewComment, type FolioReviewCommentFilter, type FolioReviewCommentReply, type FolioReviewReplyInput, type FolioReviewedStory, type FolioReviewedView, type FolioStoryDiff, type FolioVersionBlockHandle, type FolioVersionComparisonPrivacyTransform, type FolioVersionComparisonScope, type FolioVersionDiff, type FolioVersionDiffPrivacyOptions, type FolioVersionDiffPrivacyReport, type FolioVersionDiffSegment, type FolioVersionDiffSummaryCounts, type GenerateRedlineDocxOptions, type GenerateRedlineDocxResult, type GenerateRedlineUnprocessedStory, HEADING_LEVELS, type HeadingLevel, type InspectDocxPackageOptions, InvalidFolioDocumentOperationBatchError, InvalidFolioDocumentPrivacyOptionsError, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, InvalidFolioReportBuilderOptionsError, InvalidFolioVersionComparisonOptionsError, InvalidGenerateRedlineDocxOptionsError, type ParseOptions, type RewriteDocxMetadataPrivacyResult, STELLA_STYLE_SET_NAME, type TableCellSpec, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioDocxXmlPatchApplicationProfileError, UnsupportedFolioReviewedViewError, type ValidateDocxConformanceOptions, applyDocxXmlPatchProposal, applyFolioAIEditsToBuffer, applyFolioVersionDiffPrivacy, assertSupportedFolioDocumentOperationVersion, bookmark, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, createTableOfContentsField, deriveBlockId, docxToMarkdown, endnote, ensureParaIds, evaluateDocxXmlPatchProposal, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, hashFolioAIBlockText, heading, hyperlink, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxPackage, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, pageBreak, paragraph, parseDocx, parseFolioDocumentOperationBatch, parseFolioDocxXmlPatchProposal, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy, run, table, validateDocxConformance };

package/dist/server.js

@@ -4,10 +4,12 @@ import { createFolioAITextRangeHandle, hashFolioAIBlockText, normalizeFolioAIBlo
 import { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "./document-operations.js";
 import { EnsureParaIdsError, ensureParaIds } from "./docx/ensureParaIds.js";
 import { FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FolioDocumentPrivacyArchiveError, InvalidFolioDocumentPrivacyOptionsError, isFolioDocumentPrivacyTransform, rewriteDocxMetadataPrivacy } from "./docx/metadataPrivacy.js";
+import { parseDocx } from "./docx/parser.js";
 import { replyToComment } from "./docx/replyToComment.js";
 import { createDocx } from "./docx/rezip.js";
 import { FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FolioDocxXmlPatchApplicationError, UnsupportedFolioDocxXmlPatchApplicationProfileError, applyDocxXmlPatchProposal } from "./docx/server/applyDocxXmlPatchProposal.js";
 import { DocxArchiveError } from "./docx/server/boundedArchive.js";
+import { HEADING_LEVELS, InvalidFolioReportBuilderOptionsError, bookmark, createTableOfContentsField, endnote, heading, hyperlink, pageBreak, paragraph, run, table } from "./docx/server/build.js";
 import { docxToMarkdown } from "./docx/server/docxToMarkdown.js";
 import { FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS, FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES, FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, evaluateDocxXmlPatchProposal, parseFolioDocxXmlPatchProposal } from "./docx/server/evaluateDocxXmlPatchProposal.js";
 import { extractDocxText } from "./docx/server/extractDocxText.js";
@@ -20,4 +22,4 @@ import { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION } from "./style-set
 import { deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "./types/block-id.js";
 import { createEmptyDocument } from "./utils/createDocument.js";
 import { FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, InvalidFolioVersionComparisonOptionsError, applyFolioVersionDiffPrivacy, compareDocxVersions, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope } from "./version-comparison.js";
-export { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DocxArchiveError, EnsureParaIdsError, FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FOLIO_DOCX_CONFORMANCE_CHECKS, FOLIO_DOCX_CONFORMANCE_ISSUE_CODES, FOLIO_DOCX_CONFORMANCE_PROFILE, FOLIO_DOCX_CONFORMANCE_REPORT_VERSION, FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES, FOLIO_DOCX_PACKAGE_INSPECTION_VERSION, FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS, FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES, FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, FolioDocumentPrivacyArchiveError, FolioDocumentStoryNotFoundError, FolioDocxPackageInspectionError, FolioDocxReviewer, FolioDocxXmlPatchApplicationError, InvalidFolioDocumentOperationBatchError, InvalidFolioDocumentPrivacyOptionsError, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, InvalidFolioVersionComparisonOptionsError, InvalidGenerateRedlineDocxOptionsError, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioDocxXmlPatchApplicationProfileError, UnsupportedFolioReviewedViewError, applyDocxXmlPatchProposal, applyFolioAIEditsToBuffer, applyFolioVersionDiffPrivacy, assertSupportedFolioDocumentOperationVersion, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, docxToMarkdown, ensureParaIds, evaluateDocxXmlPatchProposal, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxPackage, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, parseFolioDocxXmlPatchProposal, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy, validateDocxConformance };
+export { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DocxArchiveError, EnsureParaIdsError, FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FOLIO_DOCX_CONFORMANCE_CHECKS, FOLIO_DOCX_CONFORMANCE_ISSUE_CODES, FOLIO_DOCX_CONFORMANCE_PROFILE, FOLIO_DOCX_CONFORMANCE_REPORT_VERSION, FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES, FOLIO_DOCX_PACKAGE_INSPECTION_VERSION, FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS, FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES, FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, FolioDocumentPrivacyArchiveError, FolioDocumentStoryNotFoundError, FolioDocxPackageInspectionError, FolioDocxReviewer, FolioDocxXmlPatchApplicationError, HEADING_LEVELS, InvalidFolioDocumentOperationBatchError, InvalidFolioDocumentPrivacyOptionsError, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, InvalidFolioReportBuilderOptionsError, InvalidFolioVersionComparisonOptionsError, InvalidGenerateRedlineDocxOptionsError, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioDocxXmlPatchApplicationProfileError, UnsupportedFolioReviewedViewError, applyDocxXmlPatchProposal, applyFolioAIEditsToBuffer, applyFolioVersionDiffPrivacy, assertSupportedFolioDocumentOperationVersion, bookmark, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, createTableOfContentsField, deriveBlockId, docxToMarkdown, endnote, ensureParaIds, evaluateDocxXmlPatchProposal, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, hashFolioAIBlockText, heading, hyperlink, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxPackage, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, pageBreak, paragraph, parseDocx, parseFolioDocumentOperationBatch, parseFolioDocxXmlPatchProposal, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy, run, table, validateDocxConformance };

package/dist/style-sets/stellaStyle.js

@@ -160,6 +160,8 @@ const createStellaStyleSet = () => ({
 				},
 				rPr: { bold: true }
 			},
+			...createHeadingStyles(),
+			...createTableOfContentsStyles(),
 			...createClauseStyles(),
 			...createDefinitionStyles(),
 			{
@@ -248,6 +250,45 @@ const createStellaStyleSet = () => ({
 				uiPriority: 99,
 				rPr: { vertAlign: "superscript" }
 			},
+			{
+				styleId: "EndnoteText",
+				type: "paragraph",
+				name: "Endnote Text",
+				basedOn: "Normal",
+				link: "EndnoteTextChar",
+				semiHidden: true,
+				unhideWhenUsed: true,
+				uiPriority: 99,
+				pPr: { spaceAfter: 0 },
+				rPr: {
+					fontSize: 18,
+					fontSizeCs: 18
+				}
+			},
+			{
+				styleId: "EndnoteTextChar",
+				type: "character",
+				name: "Endnote Text Char",
+				basedOn: "DefaultParagraphFont",
+				link: "EndnoteText",
+				semiHidden: true,
+				unhideWhenUsed: true,
+				uiPriority: 99,
+				rPr: {
+					fontSize: 18,
+					fontSizeCs: 18
+				}
+			},
+			{
+				styleId: "EndnoteReference",
+				type: "character",
+				name: "Endnote Reference",
+				basedOn: "DefaultParagraphFont",
+				semiHidden: true,
+				unhideWhenUsed: true,
+				uiPriority: 99,
+				rPr: { vertAlign: "superscript" }
+			},
 			{
 				styleId: "Footer",
 				type: "paragraph",
@@ -350,6 +391,111 @@ const createStellaStyleDocumentPreset = () => ({
 		verticalAlign: "top"
 	}
 });
+/**
+* Built-in `Heading1`..`Heading6` with outline levels, so a TOC field and
+* the document navigation pane pick the headings up.
+*/
+const createHeadingStyles = () => {
+	return [
+		{
+			styleId: "Heading1",
+			name: "heading 1",
+			fontSize: 28,
+			spaceBefore: 360
+		},
+		{
+			styleId: "Heading2",
+			name: "heading 2",
+			fontSize: 24,
+			spaceBefore: 240
+		},
+		{
+			styleId: "Heading3",
+			name: "heading 3",
+			fontSize: 22,
+			spaceBefore: 240
+		},
+		{
+			styleId: "Heading4",
+			name: "heading 4",
+			fontSize: 20,
+			spaceBefore: 120
+		},
+		{
+			styleId: "Heading5",
+			name: "heading 5",
+			fontSize: 20,
+			spaceBefore: 120
+		},
+		{
+			styleId: "Heading6",
+			name: "heading 6",
+			fontSize: 20,
+			spaceBefore: 120
+		}
+	].map(({ styleId, name, fontSize, spaceBefore }, level) => ({
+		styleId,
+		type: "paragraph",
+		name,
+		basedOn: "Normal",
+		next: "BodyText",
+		qFormat: true,
+		uiPriority: 9,
+		pPr: {
+			keepNext: true,
+			keepLines: true,
+			spaceBefore,
+			spaceAfter: 120,
+			outlineLevel: level
+		},
+		rPr: {
+			bold: true,
+			fontSize,
+			fontSizeCs: fontSize
+		}
+	}));
+};
+/** `TOCHeading` plus `TOC1`..`TOC3`, the styles a `TOC \o "1-3"` field fills. */
+const createTableOfContentsStyles = () => {
+	return [{
+		styleId: "TOCHeading",
+		type: "paragraph",
+		name: "TOC Heading",
+		basedOn: "Heading1",
+		next: "BodyText",
+		unhideWhenUsed: true,
+		uiPriority: 39,
+		pPr: { outlineLevel: 9 }
+	}, ...[
+		{
+			styleId: "TOC1",
+			name: "toc 1",
+			indent: 0
+		},
+		{
+			styleId: "TOC2",
+			name: "toc 2",
+			indent: 220
+		},
+		{
+			styleId: "TOC3",
+			name: "toc 3",
+			indent: 440
+		}
+	].map(({ styleId, name, indent }) => ({
+		styleId,
+		type: "paragraph",
+		name,
+		basedOn: "Normal",
+		next: "Normal",
+		unhideWhenUsed: true,
+		uiPriority: 39,
+		pPr: {
+			indentLeft: indent,
+			spaceAfter: 100
+		}
+	}))];
+};
 const createClauseStyles = () => {
 	return [
 		{

package/dist/utils/createDocument.js

@@ -246,6 +246,7 @@ function createEmptyDocument(options = {}) {
 	const docxPackage = {
 		conformanceClass: DOCX_CONFORMANCE_CLASSES.TRANSITIONAL,
 		document: documentBody,
+		relationships: /* @__PURE__ */ new Map(),
 		styles: structuredClone(styleSet?.styles ?? defaultStyleDefinitions)
 	};
 	if (styleSet?.numbering) docxPackage.numbering = structuredClone(styleSet.numbering);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-core",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Headless, framework-neutral core of folio: the OOXML (.docx) parser, document model, ProseMirror integration, and page-layout engine. No React.",
   "keywords": [
     "document-model",
@@ -113,7 +113,7 @@
     "perf": "bun scripts/profile-editor.ts"
   },
   "dependencies": {
-    "@stll/docx-core": "^0.14.0",
+    "@stll/docx-core": "^0.15.0",
     "@stll/docx-utils": "^0.1.0",
     "@stll/template-conditions": "^0.1.0",
     "better-result": "2.10.0",