@stll/folio-core 0.55.0 → 0.56.0

package/dist/docx/saveDiagnostics.d.ts

@@ -1,8 +1,19 @@
+import { CANONICAL_GAP } from "../types/canonicalCapabilities.js";
 //#region src/docx/saveDiagnostics.d.ts
 /** Save diagnostics describe fidelity fallbacks without including document content. */
 type SaveDiagnostic = {
   type: "sourceReplayMismatch";
   part: string;
+} | {
+  type: "selectiveSaveRefused";
+  part: string;
+} | {
+  type: "sourceReplayUnavailable";
+  part: string;
+} | {
+  type: "canonicalResourceReplacement";
+  gap: typeof CANONICAL_GAP.resourceReplacement;
+  part: string;
 };
 type SaveDiagnosticOptions = {
   onDiagnostic?: ((diagnostic: SaveDiagnostic) => void) | undefined;

package/dist/docx/selectiveSave.d.ts

@@ -1,7 +1,8 @@
 import { document_d_exports } from "../types/document.js";
 import { SaveDiagnosticOptions } from "./saveDiagnostics.js";
+import { DocumentBodyAuthorityOptions } from "./serializer/documentSerializer.js";
 //#region src/docx/selectiveSave.d.ts
-type SelectiveSaveOptions = SaveDiagnosticOptions & {
+type SelectiveSaveOptions = SaveDiagnosticOptions & DocumentBodyAuthorityOptions & {
   /** Changed paragraph IDs to selectively patch */
   changedParaIds: Set<string>;
   /** Whether paragraph membership, order, or block structure changed. */

package/dist/docx/selectiveSave.js

@@ -7,7 +7,7 @@ import { parseNumbering } from "./numberingParser.js";
 import { normalizeImportedNumericIds } from "./numericIdNormalization.js";
 import { isUnsafePackagePath } from "./packageParts.js";
 import { RELATIONSHIP_TYPES } from "./relsParser.js";
-import { COMMENTS_CONTENT_TYPE, COMMENTS_EXTENDED_PART_LOWER, addCommentsExtendedOverride, addCommentsExtendedRelationship, applyUpdatesToZip, collectHeaderFooterUpdates, findMaxRId, hasModelDrivenPictureWatermark, hasUnmaterializedHeaderFooter, hasUnmaterializedInlineResources, updateCoreProperties, withoutAttachedTemplate } from "./rezip.js";
+import { COMMENTS_CONTENT_TYPE, COMMENTS_EXTENDED_PART_LOWER, addCommentsExtendedOverride, addCommentsExtendedRelationship, applyUpdatesToZip, collectHeaderFooterUpdates, findMaxRId, hasModelDrivenPictureWatermark, hasUnmaterializedHeaderFooter, hasUnmaterializedHyperlinkBindings, hasUnmaterializedInlineResources, planAddedStyles, publishCanonicalImageResources, updateCoreProperties, withoutAttachedTemplate } from "./rezip.js";
 import "./selectiveSaveFlags.js";
 import { buildPatchedDocumentXml, buildPatchedNoteXml, collectAddedNumberingDefs, collectParaIds, patchNumberingDefinitions } from "./selectiveXmlPatch.js";
 import { planCommentParts, serializeComments, serializeCommentsExtended } from "./serializer/commentSerializer.js";
@@ -17,6 +17,7 @@ import { serializeNumberingXml } from "./serializer/numberingSerializer.js";
 import { readRootNamespaceBindings } from "./serializer/partNamespaces.js";
 import { buildStructuralDocumentPatch } from "./structuralXmlPatch.js";
 import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
+import { writeZipPart } from "@stll/docx-core/zip";
 //#region src/docx/selectiveSave.ts
 /**
 * Splice edited footnote/endnote paragraphs into their parts and return the
@@ -203,6 +204,7 @@ async function attemptSelectiveSave(doc, originalBuffer, options) {
 	const commentPlan = planCommentParts(comments);
 	try {
 		const zip = await (await import("jszip")).default.loadAsync(originalBuffer);
+		if (await hasUnmaterializedHyperlinkBindings(doc, zip)) return null;
 		for (const [path, file] of Object.entries(zip.files)) if (!file.dir && isUnsafePackagePath(path)) return null;
 		if (originalBuffer !== doc.originalBuffer) {
 			const sourceParts = /* @__PURE__ */ new Map();
@@ -211,14 +213,27 @@ async function attemptSelectiveSave(doc, originalBuffer, options) {
 				if (file.dir || !lowerPath.startsWith("word/") || !lowerPath.endsWith(".xml")) continue;
 				sourceParts.set(path, await file.async("text"));
 			}
-			for (const [path, xml] of normalizeImportedNumericIds(sourceParts)) if (xml !== sourceParts.get(path)) zip.file(path, xml);
+			for (const [path, xml] of normalizeImportedNumericIds(sourceParts)) if (xml !== sourceParts.get(path)) writeZipPart({
+				zip,
+				path,
+				data: xml
+			});
 		}
+		if (options.bodyAuthority === "canonical") await publishCanonicalImageResources({
+			document: doc,
+			zip,
+			compressionLevel: 6
+		});
 		const updates = /* @__PURE__ */ new Map();
 		if (changedParaIds.size > 0 || structuralChange) {
 			const docXmlFile = zip.file("word/document.xml");
 			if (!docXmlFile) return null;
 			const originalDocXml = await docXmlFile.async("text");
-			const serializedDocXml = serializeDocument(doc, readRootNamespaceBindings(originalDocXml));
+			const serializedDocXml = serializeDocument(doc, readRootNamespaceBindings(originalDocXml), {
+				xml: originalDocXml,
+				bodyAuthority: options.bodyAuthority,
+				onDiagnostic: options.onDiagnostic
+			});
 			const bodyParaIds = collectParaIds(serializedDocXml);
 			const originalBodyParaIds = structuralChange ? collectParaIds(originalDocXml) : void 0;
 			if (structuralChange && doc.package.numbering) {
@@ -268,6 +283,20 @@ async function attemptSelectiveSave(doc, originalBuffer, options) {
 		}
 		if (!await patchCommentsExtended(zip, commentPlan, updates)) return null;
 		if (!await patchNumberingPart(zip, doc, updates)) return null;
+		const styles = await planAddedStyles(doc, zip);
+		switch (styles.type) {
+			case "unchanged": break;
+			case "patch":
+				updates.set(styles.path, styles.xml);
+				break;
+			case "materialize":
+				options.onDiagnostic?.({
+					type: "selectiveSaveRefused",
+					part: "word/styles.xml"
+				});
+				return null;
+			default: return styles;
+		}
 		for (const [path, xml] of await collectHeaderFooterUpdates(doc, {
 			sourceZip: zip,
 			onDiagnostic: options.onDiagnostic

package/dist/docx/selectiveXmlPatch.js

@@ -35,7 +35,7 @@ function isXmlNameBoundary(char) {
 */
 function findParagraphOffsets(xml, paraId) {
 	const escaped = escapeRegExp(paraId);
-	const pattern = new RegExp(`<w:p[\\s][^>]*w14:paraId="${escaped}"`, "gu");
+	const pattern = new RegExp(`<w:p[\\s][^>]*w14:paraId\\s*=\\s*(["'])${escaped}\\1`, "gu");
 	const matches = [];
 	let match;
 	while ((match = pattern.exec(xml)) !== null) matches.push(match.index);
@@ -191,7 +191,7 @@ function scanParagraphs(xml) {
 		const tagEnd = xml.indexOf(">", tagStart);
 		if (tagEnd === -1) break;
 		const openTag = xml.slice(tagStart, tagEnd + 1);
-		const paraId = /\bw14:paraId="(?<id>[^"]+)"/u.exec(openTag)?.groups?.["id"];
+		const paraId = /\bw14:paraId\s*=\s*(?<quote>["'])(?<id>[^"']+)\k<quote>/u.exec(openTag)?.groups?.["id"];
 		const container = {
 			inFallback: depth.fallback > 0,
 			inAlternateContent: depth.alternateContent > 0,
@@ -236,7 +236,7 @@ function countParagraphElements(xml) {
 */
 function collectParaIds(xml) {
 	const ids = /* @__PURE__ */ new Map();
-	const pattern = /w14:paraId="(?<id>[^"]+)"/gu;
+	const pattern = /w14:paraId\s*=\s*(?<quote>["'])(?<id>[^"']+)\k<quote>/gu;
 	let match;
 	while ((match = pattern.exec(xml)) !== null) {
 		const id = match.groups["id"];
@@ -245,7 +245,7 @@ function collectParaIds(xml) {
 	return ids;
 }
 /** Paragraph ids folio writes and this module may have to remove again. */
-const MINTED_PARA_ID_ATTRIBUTE = /\sw14:(?:para|text)Id="[^"]*"/gu;
+const MINTED_PARA_ID_ATTRIBUTE = /\sw14:(paraId|textId)="[^"]*"/gu;
 /**
 * The replacement for a paragraph whose source open tag carries no paraId.
 *
@@ -262,7 +262,9 @@ const MINTED_PARA_ID_ATTRIBUTE = /\sw14:(?:para|text)Id="[^"]*"/gu;
 const withoutMintedIds = (paragraphXml, sourceOpenTag) => {
 	const tagEnd = paragraphXml.indexOf(">");
 	if (tagEnd === -1) return paragraphXml;
-	return paragraphXml.slice(0, tagEnd + 1).replace(MINTED_PARA_ID_ATTRIBUTE, (attribute) => sourceOpenTag.includes(attribute.trim()) ? attribute : "") + paragraphXml.slice(tagEnd + 1);
+	return paragraphXml.slice(0, tagEnd + 1).replace(MINTED_PARA_ID_ATTRIBUTE, (attribute, name) => {
+		return new RegExp(`\\bw14:${name}\\s*=\\s*(["'])[^"']*\\1`, "u").test(sourceOpenTag) ? attribute : "";
+	}) + paragraphXml.slice(tagEnd + 1);
 };
 const storyOf = ({ textBoxDepth }) => textBoxDepth > 0 ? "text-box" : "main";
 const sameContainer = (a, b) => a.inAlternateContent === b.inAlternateContent && a.textBoxDepth === b.textBoxDepth && a.tableDepth === b.tableDepth;

package/dist/docx/serializer/documentSerializer.d.ts

@@ -1,4 +1,5 @@
 import { document_d_exports } from "../../types/document.js";
+import { SaveDiagnosticOptions } from "../saveDiagnostics.js";
 //#region src/docx/serializer/documentSerializer.d.ts
 /**
  * Serialize a DocumentBody to document.xml body content
@@ -15,7 +16,13 @@ declare function serializeDocumentBody(body: document_d_exports.DocumentBody): s
  *   prefix only the source document bound keeps its URI
  * @returns Complete XML string for document.xml
  */
-declare function serializeDocument(doc: document_d_exports.Document, sourceBindings?: ReadonlyMap<string, string>): string;
+type DocumentBodyAuthorityOptions = {
+  /** Canonical saves preserve trusted source blocks; default saves serialize the model. */
+  bodyAuthority?: "canonical" | "model" | undefined;
+};
+declare function serializeDocument(doc: document_d_exports.Document, sourceBindings?: ReadonlyMap<string, string>, source?: SaveDiagnosticOptions & DocumentBodyAuthorityOptions & {
+  xml?: string | undefined;
+}): string;
 /**
  * Serialize just the document body (useful for partial updates)
  *
@@ -59,4 +66,4 @@ declare function createSimpleDocument(paragraphs: {
   styleId?: string;
 }[]): document_d_exports.Document;
 //#endregion
-export { createEmptyDocument, createSimpleDocument, getDocumentContentCount, getDocumentParagraphCount, getDocumentTableCount, hasDocumentContent, hasDocumentSections, hasSectionProperties, serializeDocument, serializeDocumentBody, serializeDocumentBodyElement };
+export { DocumentBodyAuthorityOptions, createEmptyDocument, createSimpleDocument, getDocumentContentCount, getDocumentParagraphCount, getDocumentTableCount, hasDocumentContent, hasDocumentSections, hasSectionProperties, serializeDocument, serializeDocumentBody, serializeDocumentBodyElement };

package/dist/docx/serializer/documentSerializer.js

@@ -1,3 +1,5 @@
+import { getDocumentSourceBaseline } from "../headerFooterVerbatim.js";
+import { buildDocumentBlockReplay, canReplayDocumentSource } from "../storyBlockReplay.js";
 import { serializeBlockCustomXml } from "./blockCustomXmlSerializer.js";
 import { serializeBlockSdt } from "./blockSdtSerializer.js";
 import { serializeBookmarkMarker } from "./markupRangeAttributes.js";
@@ -84,24 +86,41 @@ function serializeDocumentBody(body) {
 	if (body.finalSectionProperties) parts.push(serializeSectionProperties(body.finalSectionProperties));
 	return parts.join("");
 }
-/**
-* Serialize a complete Document to valid document.xml
-*
-* @param doc - The document to serialize
-* @param sourceBindings - Root `xmlns:*` of the part being replaced, so a
-*   prefix only the source document bound keeps its URI
-* @returns Complete XML string for document.xml
-*/
-function serializeDocument(doc, sourceBindings) {
+const replayableDocumentSources = /* @__PURE__ */ new WeakMap();
+function serializeDocument(doc, sourceBindings, source) {
 	resetAutoIdCounter();
+	const baseline = source?.bodyAuthority === "canonical" ? getDocumentSourceBaseline(doc) : { type: "missing" };
+	const sourceMatches = baseline.type === "captured" && (source?.xml === void 0 || source.xml === baseline.xml);
+	if (baseline.type === "captured" && sourceMatches && JSON.stringify(doc.package.document) === baseline.fingerprint) {
+		if (replayableDocumentSources.get(baseline.body) === baseline.xml) return baseline.xml;
+		if (canReplayDocumentSource(baseline.xml, baseline.body)) {
+			replayableDocumentSources.set(baseline.body, baseline.xml);
+			return baseline.xml;
+		}
+	}
 	const body = serializeDocumentBackground(doc.package.document.background) + `<w:body>${serializeDocumentBody(doc.package.document)}</w:body>`;
-	return "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>" + serializePartElement({
+	const serializedXml = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>" + serializePartElement({
 		partPath: "word/document.xml",
 		rootName: "w:document",
 		baselinePrefixes: DOCUMENT_BASELINE_PREFIXES,
 		sourceBindings,
 		body
 	});
+	if (baseline.type === "missing") return serializedXml;
+	if (baseline.type === "captured" && sourceMatches) {
+		const replay = buildDocumentBlockReplay({
+			sourceXml: baseline.xml,
+			baseline: baseline.body,
+			current: doc.package.document,
+			serializedXml
+		});
+		if (replay !== null) return replay;
+	}
+	source?.onDiagnostic?.({
+		type: "sourceReplayMismatch",
+		part: "word/document.xml"
+	});
+	return serializedXml;
 }
 /**
 * Serialize just the document body (useful for partial updates)

package/dist/docx/server/applyDocxXmlPatchProposal.js

@@ -3,6 +3,7 @@ import { FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, InvalidFolioDocxXmlPatchProposal
 import { FOLIO_DOCX_CONFORMANCE_PROFILE, validateDocxConformance } from "./validateDocxConformance.js";
 import { TaggedError, panic } from "better-result";
 import { createHash } from "node:crypto";
+import { writeZipPart } from "@stll/docx-core/zip";
 import JSZip from "jszip";
 //#region src/docx/server/applyDocxXmlPatchProposal.ts
 const FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION = 1;
@@ -92,15 +93,19 @@ const applyReplacements = async ({ bytes, proposal }) => {
 			message: "An evaluated package part was unavailable during replacement.",
 			stage: "replace"
 		});
-		zip.file(replacement.path, new TextEncoder().encode(replacement.replacementXml), {
-			binary: true,
-			date: current.date,
-			comment: current.comment,
-			createFolders: false,
-			unixPermissions: current.unixPermissions,
-			dosPermissions: current.dosPermissions,
-			compression: "DEFLATE",
-			compressionOptions: { level: 6 }
+		writeZipPart({
+			zip,
+			path: replacement.path,
+			data: new TextEncoder().encode(replacement.replacementXml),
+			options: {
+				binary: true,
+				date: current.date,
+				comment: current.comment,
+				unixPermissions: current.unixPermissions,
+				dosPermissions: current.dosPermissions,
+				compression: "DEFLATE",
+				compressionOptions: { level: 6 }
+			}
 		});
 	}
 	try {

package/dist/docx/storyBlockReplay.d.ts

@@ -1,11 +1,31 @@
 import { document_d_exports } from "../types/document.js";
+import { XmlElement } from "./xmlParser.js";
 //#region src/docx/storyBlockReplay.d.ts
+type MaterializeReplayFragmentOptions = {
+  xml: string;
+  element: XmlElement;
+  sourceNamespace: string;
+  generatedRoot?: XmlElement;
+};
+/** Bind a replay fragment once, retaining existing local declarations and compatibility tokens. */
+declare const materializeReplayFragment: ({ xml, element, sourceNamespace, generatedRoot }: MaterializeReplayFragmentOptions) => string | null;
 type StoryBlockReplayOptions = {
   sourceXml: string;
   baselineContent: readonly document_d_exports.BlockContent[];
   currentContent: readonly document_d_exports.BlockContent[];
   serializedXml: string;
+  ignoredChild?: string;
 };
 declare const buildStoryBlockReplay: (options: StoryBlockReplayOptions) => string | null;
+/** Validate source/model correspondence before replaying an unchanged complete part. */
+declare const canReplayDocumentSource: (sourceXml: string, baseline: document_d_exports.DocumentBody) => boolean;
+type DocumentBlockReplayOptions = {
+  sourceXml: string;
+  serializedXml: string;
+  baseline: document_d_exports.DocumentBody;
+  current: document_d_exports.DocumentBody;
+};
+/** Replay body blocks and modeled document metadata inside the authored part shell. */
+declare const buildDocumentBlockReplay: ({ sourceXml, serializedXml, baseline, current }: DocumentBlockReplayOptions) => string | null;
 //#endregion
-export { buildStoryBlockReplay };
+export { buildDocumentBlockReplay, buildStoryBlockReplay, canReplayDocumentSource, materializeReplayFragment };

package/dist/docx/storyBlockReplay.js

@@ -31,7 +31,7 @@ const modelMatchesElement = ({ value, element, mode }) => {
 };
 const XML_TOKEN = /<!--[\s\S]*?-->|<!\[CDATA\[[\s\S]*?\]\]>|<\?[\s\S]*?\?>|<(?:"[^"]*"|'[^']*'|[^'">])*>/gu;
 const XML_ATTRIBUTE = /([^\s=<>/]+)(\s*=\s*)(["'])(.*?)\3/gsu;
-const readStory = (xml, scope) => {
+const readStory = (xml, scope, ignoredChild) => {
 	const parsed = parseStreamingXmlWithSourceRanges(xml, scope);
 	if (parsed.status !== "parsed") return null;
 	const roots = getChildElements(parsed.value);
@@ -41,6 +41,7 @@ const readStory = (xml, scope) => {
 	const children = getChildElements(root);
 	const blocks = [];
 	for (const element of children) {
+		if (getLocalName(element.name) === ignoredChild && WORDPROCESSINGML_NAMESPACE_URIS.has(getNamespaceUri(element) ?? "")) continue;
 		const range = getXmlSourceRange(element);
 		if (!range) return null;
 		blocks.push({
@@ -64,7 +65,8 @@ const effectiveBindings = (element) => {
 	}
 	return bindings;
 };
-const generatedFragment = ({ xml, element, sourceNamespace, generatedRoot }) => {
+/** Bind a replay fragment once, retaining existing local declarations and compatibility tokens. */
+const materializeReplayFragment = ({ xml, element, sourceNamespace, generatedRoot }) => {
 	const strict = TRANSITIONAL_NAMESPACE_BY_STRICT_URI.has(sourceNamespace);
 	const first = [...xml.matchAll(XML_TOKEN)].at(0);
 	if (!first || first.index !== 0 || first[0].startsWith("<!") || first[0].startsWith("<?")) return null;
@@ -121,9 +123,9 @@ const takeCandidate = (queue, used) => {
 	}
 };
 /** Replace only mapped block ranges, retaining authored root syntax and every intervening gap. */
-const replayBlocks = ({ sourceXml, baselineContent, currentContent, serializedXml }, scope) => {
-	const source = readStory(sourceXml, scope?.source);
-	const generated = readStory(serializedXml, scope?.generated);
+const replayBlocks = ({ sourceXml, baselineContent, currentContent, serializedXml, ignoredChild }, scope) => {
+	const source = readStory(sourceXml, scope?.source, ignoredChild);
+	const generated = readStory(serializedXml, scope?.generated, ignoredChild);
 	if (!source || !generated || getLocalName(source.root.name) !== getLocalName(generated.root.name) || source.blocks.length !== baselineContent.length || generated.blocks.length !== currentContent.length) return null;
 	if (source.blocks.some((block, index) => !modelMatchesElement({
 		value: baselineContent[index],
@@ -185,7 +187,7 @@ const replayBlocks = ({ sourceXml, baselineContent, currentContent, serializedXm
 				continue;
 			}
 		}
-		const fragment = generatedFragment({
+		const fragment = materializeReplayFragment({
 			xml: serializedXml.slice(replacement.start, replacement.end),
 			element: replacement.element,
 			sourceNamespace: getNamespaceUri(source.root) ?? "",
@@ -208,7 +210,8 @@ const replayBlocks = ({ sourceXml, baselineContent, currentContent, serializedXm
 			newXml: `${opening.slice(0, -2)}>${fragments.join("")}</${source.root.name}>`
 		});
 		else {
-			const close = sourceXml.lastIndexOf("</", source.range.end);
+			const ignored = ignoredChild === void 0 ? void 0 : getChildElements(source.root).find((child) => getLocalName(child.name) === ignoredChild && WORDPROCESSINGML_NAMESPACE_URIS.has(getNamespaceUri(child) ?? ""));
+			const close = (ignored && getXmlSourceRange(ignored)?.start) ?? sourceXml.lastIndexOf("</", source.range.end);
 			if (close < source.range.start) return null;
 			splices.push({
 				start: close,
@@ -322,7 +325,7 @@ const replayCellContent = ({ sourceXml, serializedXml, sourceCell, generatedCell
 		if (getChildElements(sourceCell).at(0) !== sourceProperty || !generatedProperty || getChildElements(generatedCell).at(0) !== generatedProperty) return false;
 		const range = getXmlSourceRange(sourceProperty);
 		if (!range) return false;
-		const propertyXml = generatedFragment({
+		const propertyXml = materializeReplayFragment({
 			xml: sourceXml.slice(range.start, range.end),
 			element: sourceProperty,
 			sourceNamespace: getNamespaceUri(sourceCell) ?? ""
@@ -363,5 +366,106 @@ const replayCellContent = ({ sourceXml, serializedXml, sourceCell, generatedCell
 	});
 	return true;
 };
+const readDocumentStory = (xml) => {
+	const document = readStory(xml);
+	if (!document || getLocalName(document.root.name) !== "document") return null;
+	const bodies = wordChildren(document.root, "body");
+	const body = bodies.at(0);
+	if (bodies.length !== 1 || !body || wordChildren(body, "sectPr").length > 1 || wordChildren(document.root, "background").length > 1) return null;
+	const range = getXmlSourceRange(body);
+	return range ? {
+		document,
+		body,
+		range
+	} : null;
+};
+/** Validate source/model correspondence before replaying an unchanged complete part. */
+const canReplayDocumentSource = (sourceXml, baseline) => {
+	const source = readDocumentStory(sourceXml);
+	if (!source) return false;
+	const body = readStory(sourceXml.slice(source.range.start, source.range.end), source.body.namespaceScope, "sectPr");
+	return body !== null && body.blocks.length === baseline.content.length && body.blocks.every((block, index) => modelMatchesElement({
+		value: baseline.content[index],
+		element: block.element,
+		mode: "source"
+	}));
+};
+/** Replay body blocks and modeled document metadata inside the authored part shell. */
+const buildDocumentBlockReplay = ({ sourceXml, serializedXml, baseline, current }) => {
+	const sourceStory = readDocumentStory(sourceXml);
+	const generatedStory = readDocumentStory(serializedXml);
+	if (!sourceStory || !generatedStory) return null;
+	const { body: sourceBody, range: sourceRange } = sourceStory;
+	const { document: generated, body: generatedBody, range: generatedRange } = generatedStory;
+	let bodyXml = replayBlocks({
+		sourceXml: sourceXml.slice(sourceRange.start, sourceRange.end),
+		serializedXml: serializedXml.slice(generatedRange.start, generatedRange.end),
+		baselineContent: baseline.content,
+		currentContent: current.content,
+		ignoredChild: "sectPr"
+	}, {
+		source: sourceBody.namespaceScope,
+		generated: generatedBody.namespaceScope,
+		generatedRoot: generated.root
+	});
+	if (bodyXml === null) return null;
+	const replaceMetadata = (xml, sourceContainer, generatedContainer, name) => {
+		const before = wordChildren(sourceContainer, name);
+		const after = wordChildren(generatedContainer, name);
+		if (before.length > 1 || after.length > 1) return null;
+		const old = before.at(0);
+		const next = after.at(0);
+		const containerRange = getXmlSourceRange(sourceContainer);
+		const oldRange = old && getXmlSourceRange(old);
+		const nextRange = next && getXmlSourceRange(next);
+		if (!containerRange || old && !oldRange || next && !nextRange) return null;
+		const replacement = next && nextRange ? materializeReplayFragment({
+			xml: serializedXml.slice(nextRange.start, nextRange.end),
+			element: next,
+			sourceNamespace: getNamespaceUri(sourceContainer) ?? "",
+			generatedRoot: generated.root
+		}) : "";
+		if (replacement === null) return null;
+		if (oldRange) return spliceXml(xml, [{
+			start: oldRange.start - containerRange.start,
+			end: oldRange.end - containerRange.start,
+			newXml: replacement
+		}]);
+		if (!next) return xml;
+		const insertion = name === "background" ? [...xml.matchAll(XML_TOKEN)].at(0)?.[0].length ?? -1 : xml.lastIndexOf("</");
+		if (insertion < 0) return null;
+		return spliceXml(xml, [{
+			start: insertion,
+			end: insertion,
+			newXml: replacement
+		}]);
+	};
+	if (canonicalJson(baseline.finalSectionProperties) !== canonicalJson(current.finalSectionProperties)) {
+		const reparsed = parseStreamingXmlWithSourceRanges(bodyXml, sourceBody.namespaceScope);
+		if (reparsed.status !== "parsed") return null;
+		const root = getChildElements(reparsed.value).at(0);
+		if (!root) return null;
+		bodyXml = replaceMetadata(bodyXml, root, generatedBody, "sectPr");
+		if (bodyXml === null) return null;
+	}
+	let result = spliceXml(sourceXml, [{
+		start: sourceRange.start,
+		end: sourceRange.end,
+		newXml: bodyXml
+	}]);
+	if (result === null) return null;
+	if (canonicalJson(baseline.background) !== canonicalJson(current.background)) {
+		const reparsed = readStory(result);
+		if (!reparsed) return null;
+		const replaced = replaceMetadata(result.slice(reparsed.range.start, reparsed.range.end), reparsed.root, generated.root, "background");
+		if (replaced === null) return null;
+		result = spliceXml(result, [{
+			start: reparsed.range.start,
+			end: reparsed.range.end,
+			newXml: replaced
+		}]);
+	}
+	return result;
+};
 //#endregion
-export { buildStoryBlockReplay };
+export { buildDocumentBlockReplay, buildStoryBlockReplay, canReplayDocumentSource, materializeReplayFragment };

package/dist/docx/storyPlainText.d.ts

@@ -0,0 +1,20 @@
+import { document_d_exports } from "../types/document.js";
+//#region src/docx/storyPlainText.d.ts
+/** Read the document body with pending revisions accepted. */
+declare const getDocumentText: (body: document_d_exports.DocumentBody) => string;
+/** Approximate word count of the accepted body text. */
+declare const getWordCount: (body: document_d_exports.DocumentBody) => number;
+/** Character count of the accepted body text. */
+declare const getCharacterCount: (body: document_d_exports.DocumentBody) => number;
+/** Read an accepted table, including nested blocks and tracked structure. */
+declare const getTableText: (table: document_d_exports.Table) => string;
+/** Read accepted text-box content for search and indexing. */
+declare const getTextBoxText: (textBox: document_d_exports.TextBox) => string;
+/** Read an accepted header or footer through the same walk as body and notes. */
+declare const getHeaderFooterText: (headerFooter: document_d_exports.HeaderFooter) => string;
+/** Read accepted footnote content, including nested blocks. */
+declare const getFootnoteText: (footnote: document_d_exports.Footnote) => string;
+/** Read accepted endnote content, including nested blocks. */
+declare const getEndnoteText: (endnote: document_d_exports.Endnote) => string;
+//#endregion
+export { getCharacterCount, getDocumentText, getEndnoteText, getFootnoteText, getHeaderFooterText, getTableText, getTextBoxText, getWordCount };

package/dist/docx/storyPlainText.js

@@ -0,0 +1,23 @@
+import { blockPlainText } from "./blockPlainText.js";
+//#region src/docx/storyPlainText.ts
+/** Read the document body with pending revisions accepted. */
+const getDocumentText = (body) => blockPlainText(body.content);
+/** Approximate word count of the accepted body text. */
+const getWordCount = (body) => {
+	const words = getDocumentText(body).trim().split(/\s+/u);
+	return words.length > 0 && words[0] !== "" ? words.length : 0;
+};
+/** Character count of the accepted body text. */
+const getCharacterCount = (body) => getDocumentText(body).length;
+/** Read an accepted table, including nested blocks and tracked structure. */
+const getTableText = (table) => blockPlainText([table]);
+/** Read accepted text-box content for search and indexing. */
+const getTextBoxText = (textBox) => blockPlainText(textBox.content);
+/** Read an accepted header or footer through the same walk as body and notes. */
+const getHeaderFooterText = (headerFooter) => blockPlainText(headerFooter.content);
+/** Read accepted footnote content, including nested blocks. */
+const getFootnoteText = (footnote) => blockPlainText(footnote.content);
+/** Read accepted endnote content, including nested blocks. */
+const getEndnoteText = (endnote) => blockPlainText(endnote.content);
+//#endregion
+export { getCharacterCount, getDocumentText, getEndnoteText, getFootnoteText, getHeaderFooterText, getTableText, getTextBoxText, getWordCount };

package/dist/docx/structuralXmlPatch.js

@@ -2,7 +2,7 @@ import { canonicalJson } from "../utils/canonicalJson.js";
 import { parseDocumentBody } from "./documentParser.js";
 import { paraIdAttribute } from "./paraIdAttribute.js";
 import { spliceSupportsRootNamespaces, spliceXml } from "./selectiveXmlPatch.js";
-import { readRootNamespaceBindings, serializePartElement } from "./serializer/partNamespaces.js";
+import { materializeReplayFragment } from "./storyBlockReplay.js";
 import { NAMESPACES, WORDPROCESSINGML_NAMESPACE_URIS, getChildElements, getLocalName, getNamespaceUri, parseXmlDocument } from "./xmlParser.js";
 //#region src/docx/structuralXmlPatch.ts
 /** Conservative body-paragraph splices; source offsets never come from reserialization. */
@@ -111,21 +111,6 @@ const paragraphIds = (root) => {
 	}
 	return ids;
 };
-/** Bind fragment prefixes locally: the source root may use entirely different aliases. */
-const paragraphFragment = ({ xml, block, bindings }) => {
-	const fragment = xml.slice(block.start, block.end);
-	const openEnd = fragment.indexOf(">");
-	const name = block.element.name ?? "w:p";
-	const selfClosing = fragment[openEnd - 1] === "/";
-	return serializePartElement({
-		partPath: "word/document.xml",
-		rootName: name,
-		rootAttributes: fragment.slice(name.length + 1, selfClosing ? openEnd - 1 : openEnd).trim(),
-		baselinePrefixes: [],
-		sourceBindings: bindings,
-		body: selfClosing ? "" : fragment.slice(openEnd + 1, fragment.lastIndexOf("</"))
-	});
-};
 /**
 * Insert/delete direct body paragraphs between surviving paragraph/table anchors.
 * Tables are opaque barriers: their modeled content and order must stay identical.
@@ -168,11 +153,11 @@ const buildStructuralDocumentPatch = ({ originalXml, serializedXml, changedIds }
 	const survivingBefore = [...before.keys()].filter((key) => after.has(key));
 	const survivingAfter = [...after.keys()].filter((key) => before.has(key));
 	if (canonicalJson(survivingBefore) !== canonicalJson(survivingAfter)) return null;
-	const bindings = readRootNamespaceBindings(serializedXml);
-	const fragmentFor = (block) => paragraphFragment({
-		xml: serializedXml,
-		block,
-		bindings
+	const fragmentFor = (block) => materializeReplayFragment({
+		xml: serializedXml.slice(block.start, block.end),
+		element: block.element,
+		sourceNamespace: getNamespaceUri(source.root) ?? "",
+		generatedRoot: current.root
 	});
 	const splices = [];
 	for (const [key, block] of before) if (!after.has(key)) splices.push({
@@ -186,11 +171,14 @@ const buildStructuralDocumentPatch = ({ originalXml, serializedXml, changedIds }
 		if (!original) {
 			const id = paraIdAttribute(block.element)?.toUpperCase();
 			if (!id || allSourceIds.has(id)) return null;
-			pending.push(fragmentFor(block));
+			const fragment = fragmentFor(block);
+			if (fragment === null) return null;
+			pending.push(fragment);
 			continue;
 		}
 		const id = paraIdAttribute(block.element)?.toUpperCase();
 		const replacement = id !== void 0 && changed.has(id) ? fragmentFor(block) : originalXml.slice(original.start, original.end);
+		if (replacement === null) return null;
 		if (pending.length > 0 || replacement !== originalXml.slice(original.start, original.end)) splices.push({
 			start: original.start,
 			end: original.end,

package/dist/docx/styleParser.d.ts

@@ -8,6 +8,10 @@ type ParsedStylesPackage = {
   styleDefinitions: document_d_exports.StyleDefinitions;
   styles: StyleMap;
 };
+/**
+ * Resolve style inheritance chain
+ */
+declare function resolveStyleInheritance(style: document_d_exports.Style, styleMap: StyleMap, visited?: Set<string>): document_d_exports.Style;
 /**
  * Parse styles.xml content
  *
@@ -46,4 +50,4 @@ declare function getDefaultCharacterStyle(styleMap: StyleMap): document_d_export
  */
 declare function getStylesByType(styleMap: StyleMap, type: document_d_exports.StyleType): document_d_exports.Style[];
 //#endregion
-export { ParsedStylesPackage, StyleMap, getDefaultCharacterStyle, getDefaultParagraphStyle, getResolvedStyle, getStylesByType, parseStyleDefinitions, parseStyles, parseStylesPackage };
+export { ParsedStylesPackage, StyleMap, getDefaultCharacterStyle, getDefaultParagraphStyle, getResolvedStyle, getStylesByType, parseStyleDefinitions, parseStyles, parseStylesPackage, resolveStyleInheritance };

package/dist/docx/styleParser.js

@@ -554,4 +554,4 @@ function getStylesByType(styleMap, type) {
 	return result;
 }
 //#endregion
-export { getDefaultCharacterStyle, getDefaultParagraphStyle, getResolvedStyle, getStylesByType, parseStyleDefinitions, parseStyles, parseStylesPackage };
+export { getDefaultCharacterStyle, getDefaultParagraphStyle, getResolvedStyle, getStylesByType, parseStyleDefinitions, parseStyles, parseStylesPackage, resolveStyleInheritance };

package/dist/docx/tableParser.d.ts

@@ -342,13 +342,6 @@ declare function isCellMergeStart(cell: document_d_exports.TableCell): boolean;
  * @returns true if cell spans multiple columns
  */
 declare function isCellHorizontallyMerged(cell: document_d_exports.TableCell): boolean;
-/**
- * Get the plain text content of a table
- *
- * @param table - The table to extract text from
- * @returns Plain text content
- */
-declare function getTableText(table: document_d_exports.Table): string;
 /**
  * Check if table has header row
  *
@@ -371,4 +364,4 @@ declare function getHeaderRows(table: document_d_exports.Table): document_d_expo
  */
 declare function isFloatingTable(table: document_d_exports.Table): boolean;
 //#endregion
-export { CELL_CONTENT_HANDLERS, MAX_TABLE_COLUMNS, ROW_CONTENT_HANDLERS, TABLE_CONTENT_HANDLERS, getHeaderRows, getTableColumnCount, getTableRowCount, getTableText, hasHeaderRow, isCellHorizontallyMerged, isCellMergeContinuation, isCellMergeStart, isFloatingTable, isTableCellMergeRevisionContinuation, isTableCellMergeRevisionValue, parseCellMargins, parseConditionalFormatStyle, parseFloatingTableProperties, parseTable, parseTableBorders, parseTableCell, parseTableCellProperties, parseTableGrid, parseTableLook, parseTableMeasurement, parseTableProperties, parseTablePropertyExceptions, parseTableRow, parseTableRowProperties };
+export { CELL_CONTENT_HANDLERS, MAX_TABLE_COLUMNS, ROW_CONTENT_HANDLERS, TABLE_CONTENT_HANDLERS, getHeaderRows, getTableColumnCount, getTableRowCount, hasHeaderRow, isCellHorizontallyMerged, isCellMergeContinuation, isCellMergeStart, isFloatingTable, isTableCellMergeRevisionContinuation, isTableCellMergeRevisionValue, parseCellMargins, parseConditionalFormatStyle, parseFloatingTableProperties, parseTable, parseTableBorders, parseTableCell, parseTableCellProperties, parseTableGrid, parseTableLook, parseTableMeasurement, parseTableProperties, parseTablePropertyExceptions, parseTableRow, parseTableRowProperties };