@stll/folio-core 0.55.0 → 0.56.0

package/dist/docx/blockPlainText.js

@@ -1,3 +1,4 @@
+import { projectAcceptedBlocks } from "../internal/acceptedBlockProjection.js";
 import { ALT_CHUNK_READER_DIAGNOSTIC, isAltChunkMarkup } from "./altChunk.js";
 import { OPAQUE_REVISION_CARRIER_READER_DIAGNOSTIC, isOpaqueNestedRowMarkup, opaqueRevisionCarrierName } from "./opaqueCarrier.js";
 import { getParagraphText } from "./paragraphParser.js";
@@ -18,7 +19,7 @@ import { panic } from "better-result";
 * everything below block level and reads the accepted tracked-change view.
 */
 /** One entry per block, so callers can join or count lines as they need. */
-const collectBlockTexts = (blocks) => {
+const collectResolvedBlockTexts = (blocks) => {
 	const texts = [];
 	for (const block of blocks) switch (block.type) {
 		case "paragraph":
@@ -27,12 +28,12 @@ const collectBlockTexts = (blocks) => {
 		case "table":
 			for (const row of block.rows) {
 				if (row.formatting?.hidden === true) continue;
-				texts.push(row.cells.map((cell) => collectBlockTexts(cell.content).join("\n")).join("	"));
+				texts.push(row.cells.map((cell) => collectResolvedBlockTexts(cell.content).join("\n")).join("	"));
 			}
 			break;
 		case "blockSdt":
 		case "blockCustomXml":
-			texts.push(...collectBlockTexts(block.content));
+			texts.push(...collectResolvedBlockTexts(block.content));
 			break;
 		case "preservedBlock":
 			if (isAltChunkMarkup(block.xml)) texts.push(block.readerText === void 0 ? ALT_CHUNK_READER_DIAGNOSTIC : `${ALT_CHUNK_READER_DIAGNOSTIC}\n${block.readerText}`);
@@ -45,6 +46,13 @@ const collectBlockTexts = (blocks) => {
 	}
 	return texts;
 };
+/** One entry per accepted block; deleted breaks and table structure resolve together. */
+const collectBlockTexts = (blocks) => {
+	const projection = projectAcceptedBlocks(blocks, void 0);
+	const texts = collectResolvedBlockTexts(projection?.blocks ?? blocks);
+	if (projection?.completeness === "partial") texts.push("[Unresolved tracked structural changes]");
+	return texts;
+};
 const blockPlainText = (blocks) => collectBlockTexts(blocks).join("\n");
 //#endregion
 export { blockPlainText, collectBlockTexts };

package/dist/docx/canonicalResourceSave.d.ts

@@ -0,0 +1,16 @@
+import { document_d_exports } from "../types/document.js";
+import { CANONICAL_GAP } from "../types/canonicalCapabilities.js";
+import { SaveDiagnostic } from "./saveDiagnostics.js";
+//#region src/docx/canonicalResourceSave.d.ts
+declare const CanonicalResourceSaveRefusalError_base: import("better-result").TaggedErrorClass<"CanonicalResourceSaveRefusalError">;
+declare class CanonicalResourceSaveRefusalError extends CanonicalResourceSaveRefusalError_base<{
+  message: string;
+  gap: typeof CANONICAL_GAP.resourceReplacement;
+  diagnostic: Extract<SaveDiagnostic, {
+    type: "canonicalResourceReplacement";
+  }>;
+}> {}
+/** Full and selective package writers preserve existing style/media source entries. */
+declare const canonicalResourceReplacementOf: (document: document_d_exports.Document) => string | undefined;
+//#endregion
+export { CanonicalResourceSaveRefusalError, canonicalResourceReplacementOf };

package/dist/docx/canonicalResourceSave.js

@@ -0,0 +1,27 @@
+import { canonicalJson } from "../utils/canonicalJson.js";
+import { getDocumentSourceBaseline } from "./headerFooterVerbatim.js";
+import { TaggedError } from "better-result";
+//#region src/docx/canonicalResourceSave.ts
+var CanonicalResourceSaveRefusalError = class extends TaggedError("CanonicalResourceSaveRefusalError") {};
+/** Full and selective package writers preserve existing style/media source entries. */
+const canonicalResourceReplacementOf = (document) => {
+	const source = getDocumentSourceBaseline(document);
+	if (source.type !== "captured" || !document.originalBuffer) return void 0;
+	const baseline = source.resourceStyles;
+	const current = document.package.styles;
+	if (baseline) {
+		const { styles: sourceStyles, ...sourceDefaults } = baseline;
+		const { styles: currentStyles, ...currentDefaults } = current ?? { styles: [] };
+		const currentById = new Map(currentStyles.map((style) => [style.styleId, style]));
+		if (canonicalJson(sourceDefaults) !== canonicalJson(currentDefaults) || sourceStyles.some((style) => canonicalJson(style) !== canonicalJson(currentById.get(style.styleId)))) return "word/styles.xml";
+	}
+	for (const [path, media] of source.resourceMedia) {
+		const currentMedia = document.package.media?.get(path);
+		if (!currentMedia || media.mimeType !== currentMedia.mimeType) return path;
+		const sourceBytes = new Uint8Array(media.data);
+		const currentBytes = new Uint8Array(currentMedia.data);
+		if (sourceBytes.length !== currentBytes.length || sourceBytes.some((byte, index) => byte !== currentBytes[index])) return path;
+	}
+};
+//#endregion
+export { CanonicalResourceSaveRefusalError, canonicalResourceReplacementOf };

package/dist/docx/canonicalSave.d.ts

@@ -0,0 +1,29 @@
+import { CANONICAL_GAP } from "../types/canonicalCapabilities.js";
+import { SaveDiagnostic } from "./saveDiagnostics.js";
+import { CanonicalSaveSnapshot } from "../types/canonicalSave.js";
+import { FolioGetDocxOptions } from "../types/docxSerialization.js";
+import { TripwireResult } from "./selectiveSaveTripwire.js";
+import { FolioSelectiveSaveFlags } from "./selectiveSaveFlags.js";
+//#region src/docx/canonicalSave.d.ts
+declare const CanonicalSaveDiagnosticError_base: import("better-result").TaggedErrorClass<"CanonicalSaveDiagnosticError">;
+/** Forward a fidelity fallback through the adapters' existing error channel. */
+declare class CanonicalSaveDiagnosticError extends CanonicalSaveDiagnosticError_base<{
+  message: string;
+  gap: typeof CANONICAL_GAP.save;
+  diagnostic: SaveDiagnostic;
+}> {}
+type SerializeCanonicalSaveOptions = {
+  snapshot: CanonicalSaveSnapshot;
+  options?: FolioGetDocxOptions | undefined;
+  featureFlags?: FolioSelectiveSaveFlags | undefined;
+};
+/** Model and change signals come from one committed snapshot, never from PM. */
+declare const serializeCanonicalSave: ({ snapshot, options, featureFlags }: SerializeCanonicalSaveOptions) => Promise<{
+  buffer: ArrayBuffer;
+  document: import("@stll/docx-core").Document;
+  version: number;
+  diagnostics: SaveDiagnostic[];
+  tripwireResult: TripwireResult | null;
+}>;
+//#endregion
+export { CanonicalSaveDiagnosticError, serializeCanonicalSave };

package/dist/docx/canonicalSave.js

@@ -0,0 +1,101 @@
+import { withoutUnreferencedNotes } from "../prosemirror/noteReferenceReview.js";
+import { CANONICAL_GAP } from "../types/canonicalCapabilities.js";
+import { FOLIO_DOCX_SERIALIZATION_MODE } from "../types/docxSerialization.js";
+import { CanonicalResourceSaveRefusalError, canonicalResourceReplacementOf } from "./canonicalResourceSave.js";
+import { repackWithCanonicalStoryRemovals } from "./canonicalStoryRepack.js";
+import { getDocumentSourceBaseline } from "./headerFooterVerbatim.js";
+import { resolveSelectiveSaveFlags } from "./selectiveSaveFlags.js";
+import { Result, TaggedError } from "better-result";
+//#region src/docx/canonicalSave.ts
+/** Forward a fidelity fallback through the adapters' existing error channel. */
+var CanonicalSaveDiagnosticError = class extends TaggedError("CanonicalSaveDiagnosticError") {};
+/** Model and change signals come from one committed snapshot, never from PM. */
+const serializeCanonicalSave = async ({ snapshot, options, featureFlags }) => {
+	const document = withoutUnreferencedNotes(snapshot.document);
+	const replacementPart = snapshot.structure === "changed" ? canonicalResourceReplacementOf(document) : void 0;
+	if (replacementPart) {
+		const diagnostic = {
+			type: "canonicalResourceReplacement",
+			gap: CANONICAL_GAP.resourceReplacement,
+			part: replacementPart
+		};
+		options?.onDiagnostic?.(diagnostic);
+		throw new CanonicalResourceSaveRefusalError({
+			message: "Canonical save cannot preserve this package resource replacement.",
+			gap: CANONICAL_GAP.resourceReplacement,
+			diagnostic
+		});
+	}
+	const baseline = document.originalBuffer;
+	const flags = resolveSelectiveSaveFlags(featureFlags);
+	const diagnostics = [];
+	const onDiagnostic = (diagnostic) => {
+		if (!diagnostics.some((existing) => existing.type === diagnostic.type && existing.part === diagnostic.part)) diagnostics.push(diagnostic);
+	};
+	const { repackDocx, createDocx } = await import("./rezip.js");
+	const useSelective = flags.selectiveSave && options?.mode !== FOLIO_DOCX_SERIALIZATION_MODE.full;
+	let selectiveBuffer = null;
+	if (baseline && (useSelective || flags.selectiveSaveTripwire)) {
+		const { attemptSelectiveSave } = await import("./selectiveSave.js");
+		selectiveBuffer = await attemptSelectiveSave(document, baseline, {
+			bodyAuthority: "canonical",
+			changedParaIds: new Set(snapshot.changedBlockIds),
+			structuralChange: snapshot.structure === "changed",
+			hasUntrackedChanges: false,
+			maxBytes: flags.selectiveSaveMaxBytes,
+			onDiagnostic
+		});
+		if (useSelective && !selectiveBuffer) onDiagnostic({
+			type: "selectiveSaveRefused",
+			part: "word/document.xml"
+		});
+	}
+	const repack = () => {
+		if (baseline && getDocumentSourceBaseline(document).type === "missing") onDiagnostic({
+			type: "sourceReplayUnavailable",
+			part: "word/document.xml"
+		});
+		return baseline ? repackWithCanonicalStoryRemovals({
+			document,
+			repack: () => repackDocx(document, {
+				onDiagnostic,
+				bodyAuthority: "canonical"
+			})
+		}) : createDocx(document, {
+			onDiagnostic,
+			bodyAuthority: "canonical"
+		});
+	};
+	let buffer = useSelective ? selectiveBuffer : null;
+	let fullBuffer = null;
+	if (!buffer) {
+		fullBuffer = await repack();
+		buffer = fullBuffer;
+	} else if (flags.selectiveSaveTripwire) {
+		const full = await Result.tryPromise({
+			try: repack,
+			catch: (error) => error
+		});
+		if (full.isOk()) fullBuffer = full.value;
+	}
+	let tripwireResult = null;
+	if (flags.selectiveSaveTripwire && fullBuffer) {
+		const { compareSelectiveVsFull } = await import("./selectiveSaveTripwire.js");
+		const capturedFullBuffer = fullBuffer;
+		const compared = await Result.tryPromise({
+			try: () => compareSelectiveVsFull(selectiveBuffer, capturedFullBuffer),
+			catch: (error) => error
+		});
+		if (compared.isOk()) tripwireResult = compared.value;
+	}
+	for (const diagnostic of diagnostics) options?.onDiagnostic?.(diagnostic);
+	return {
+		buffer,
+		document,
+		version: snapshot.version,
+		diagnostics,
+		tripwireResult
+	};
+};
+//#endregion
+export { CanonicalSaveDiagnosticError, serializeCanonicalSave };

package/dist/docx/canonicalStoryRepack.d.ts

@@ -4,7 +4,7 @@ type CanonicalStoryRepackOptions<T> = {
   document: document_d_exports.Document;
   repack: () => Promise<T>;
 };
-/** Authorize only references missing from the committed canonical snapshot, with exact multiplicity. */
+/** Authorize exact canonical section removals and references missing from the committed snapshot. */
 declare const repackWithCanonicalStoryRemovals: <T>({ document, repack }: CanonicalStoryRepackOptions<T>) => Promise<T>;
 //#endregion
 export { repackWithCanonicalStoryRemovals };

package/dist/docx/canonicalStoryRepack.js

@@ -1,17 +1,28 @@
+import { withTrackedSectionEndpointRemoval } from "../internal/sectionEndpointResolution.js";
 import { withSectionReferenceResolution } from "../internal/sectionReferenceResolution.js";
 import { readDocumentSectionFacts } from "./documentSectionFacts.js";
+import { parseDocx } from "./parser.js";
+import { assertSectionCarriersMatchModel } from "./rezip.js";
 import { serializeDocument } from "./serializer/documentSerializer.js";
 import JSZip from "jszip";
 //#region src/docx/canonicalStoryRepack.ts
 /** Canonical snapshots own explicit section references; the PM projection does not. */
 const referenceKey = ({ element, type, rId }) => `${element}:${type}:${rId}`;
-/** Authorize only references missing from the committed canonical snapshot, with exact multiplicity. */
+const xmlFingerprint = async (xml) => {
+	const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(xml));
+	let fingerprint = "";
+	for (const byte of new Uint8Array(digest)) fingerprint += byte.toString(16).padStart(2, "0");
+	return fingerprint;
+};
+/** Authorize exact canonical section removals and references missing from the committed snapshot. */
 const repackWithCanonicalStoryRemovals = async ({ document, repack }) => {
-	if (!document.originalBuffer) return repack();
-	const xml = await (await JSZip.loadAsync(document.originalBuffer)).file("word/document.xml")?.async("text");
+	const originalBuffer = document.originalBuffer;
+	if (!originalBuffer) return repack();
+	const xml = await (await JSZip.loadAsync(originalBuffer)).file("word/document.xml")?.async("text");
 	if (!xml) return repack();
 	const before = readDocumentSectionFacts(xml);
-	const after = readDocumentSectionFacts(serializeDocument(document));
+	const serializedXml = serializeDocument(document);
+	const after = readDocumentSectionFacts(serializedXml);
 	const remaining = /* @__PURE__ */ new Map();
 	for (const reference of after.headerFooterReferences) {
 		const key = referenceKey(reference);
@@ -34,7 +45,29 @@ const repackWithCanonicalStoryRemovals = async ({ document, repack }) => {
 	return withSectionReferenceResolution({
 		document,
 		removedReferences,
-		repack
+		repack: async () => {
+			if (after.sectionCount >= before.sectionCount) return repack();
+			const baseline = await parseDocx(originalBuffer, { preloadFonts: false });
+			const baselineXml = serializeDocument(baseline);
+			const baselineFacts = readDocumentSectionFacts(baselineXml);
+			if (baselineFacts.sectionCount !== before.sectionCount) return repack();
+			assertSectionCarriersMatchModel({
+				doc: baseline,
+				serializedSectionCount: baselineFacts.sectionCount
+			});
+			return withTrackedSectionEndpointRemoval({
+				document,
+				resolution: {
+					type: "tracked-section-endpoint-removal",
+					sourceParagraphEndpointCount: before.sectionCount,
+					expectedParagraphEndpointCount: after.sectionCount,
+					sourceEndpointFingerprint: await xmlFingerprint(baselineXml),
+					expectedEndpointFingerprint: await xmlFingerprint(serializedXml),
+					removedReferences
+				},
+				repack
+			});
+		}
 	});
 };
 //#endregion

package/dist/docx/documentParser.d.ts

@@ -54,22 +54,10 @@ declare function getAllParagraphs(body: document_d_exports.DocumentBody): docume
  * Get all tables from document body
  */
 declare function getAllTables(body: document_d_exports.DocumentBody): document_d_exports.Table[];
-/**
- * Get plain text from entire document body
- */
-declare function getDocumentText(body: document_d_exports.DocumentBody): string;
 /**
  * Count total paragraphs in document
  */
 declare function getParagraphCount(body: document_d_exports.DocumentBody): number;
-/**
- * Count total words in document (approximate)
- */
-declare function getWordCount(body: document_d_exports.DocumentBody): number;
-/**
- * Count total characters in document
- */
-declare function getCharacterCount(body: document_d_exports.DocumentBody): number;
 /**
  * Get section count
  */
@@ -79,4 +67,4 @@ declare function getSectionCount(body: document_d_exports.DocumentBody): number;
  */
 declare function hasTemplateVariables(body: document_d_exports.DocumentBody): boolean;
 //#endregion
-export { extractAllTemplateVariables, extractTemplateVariables, getAllParagraphs, getAllTables, getCharacterCount, getDocumentText, getParagraphCount, getSectionCount, getWordCount, hasTemplateVariables, parseDocumentBody, parseDocumentBodyTree };
+export { extractAllTemplateVariables, extractTemplateVariables, getAllParagraphs, getAllTables, getParagraphCount, getSectionCount, hasTemplateVariables, parseDocumentBody, parseDocumentBodyTree };

package/dist/docx/documentParser.js

@@ -239,58 +239,12 @@ function getNestedTables(table) {
 	return tables;
 }
 /**
-* Get plain text from entire document body
-*/
-function getDocumentText(body) {
-	const lines = [];
-	for (const block of body.content) if (block.type === "paragraph") lines.push(getParagraphText(block));
-	else if (block.type === "table") lines.push(getTableText(block));
-	else if (block.type === "blockSdt" || block.type === "blockCustomXml") lines.push(getTextFromBlocks(block.content));
-	return lines.join("\n");
-}
-const getTextFromBlocks = (blocks) => blocks.flatMap((block) => {
-	if (block.type === "paragraph") return [getParagraphText(block)];
-	if (block.type === "table") return [getTableText(block)];
-	return block.type === "blockSdt" || block.type === "blockCustomXml" ? [getTextFromBlocks(block.content)] : [];
-}).join("\n");
-/**
-* Get plain text from a table
-*/
-function getTableText(table) {
-	const lines = [];
-	for (const row of table.rows) {
-		const rowTexts = [];
-		for (const cell of row.cells) {
-			const cellTexts = [];
-			for (const content of cell.content) if (content.type === "paragraph") cellTexts.push(getParagraphText(content));
-			else if (content.type === "table") cellTexts.push(getTableText(content));
-			else if (content.type === "blockSdt" || content.type === "blockCustomXml") cellTexts.push(getTextFromBlocks(content.content));
-			rowTexts.push(cellTexts.join("\n"));
-		}
-		lines.push(rowTexts.join("	"));
-	}
-	return lines.join("\n");
-}
-/**
 * Count total paragraphs in document
 */
 function getParagraphCount(body) {
 	return getAllParagraphs(body).length;
 }
 /**
-* Count total words in document (approximate)
-*/
-function getWordCount(body) {
-	const words = getDocumentText(body).trim().split(/\s+/u);
-	return words.length > 0 && words[0] !== "" ? words.length : 0;
-}
-/**
-* Count total characters in document
-*/
-function getCharacterCount(body) {
-	return getDocumentText(body).length;
-}
-/**
 * Get section count
 */
 function getSectionCount(body) {
@@ -303,4 +257,4 @@ function hasTemplateVariables(body) {
 	return extractAllTemplateVariables(body.content).length > 0;
 }
 //#endregion
-export { extractAllTemplateVariables, extractTemplateVariables, getAllParagraphs, getAllTables, getCharacterCount, getDocumentText, getParagraphCount, getSectionCount, getWordCount, hasTemplateVariables, parseDocumentBody, parseDocumentBodyTree };
+export { extractAllTemplateVariables, extractTemplateVariables, getAllParagraphs, getAllTables, getParagraphCount, getSectionCount, hasTemplateVariables, parseDocumentBody, parseDocumentBodyTree };

package/dist/docx/ensureParaIds.js

@@ -6,6 +6,7 @@ import { scanStreamingXmlElements } from "./streamingXmlParser.js";
 import { resolveNamespaceUri } from "./xmlNamespaceContext.js";
 import { OFFICE_RELATIONSHIP_NAMESPACE_URIS, WORDPROCESSINGML_NAMESPACE_URIS, getAttribute, getChildElements, getLocalName, getNamespaceUri, parseXmlDocument, resolveAttributeNamespaceUri } from "./xmlParser.js";
 import { TaggedError } from "better-result";
+import { writeZipPart } from "@stll/docx-core/zip";
 import JSZip from "jszip";
 //#region src/docx/ensureParaIds.ts
 /**
@@ -386,10 +387,15 @@ const ensureParaIdsInternal = async (docx, options) => {
 	for (const [partPath, content] of updates) {
 		const sourceEntry = zip.file(partPath);
 		if (sourceEntry === null) throw createEnsureParaIdsError(`Package part disappeared during normalization: ${partPath}`);
-		zip.file(partPath, content, {
-			compression: "DEFLATE",
-			compressionOptions: { level: 6 },
-			date: sourceEntry.date
+		writeZipPart({
+			zip,
+			path: partPath,
+			data: content,
+			options: {
+				compression: "DEFLATE",
+				compressionOptions: { level: 6 },
+				date: sourceEntry.date
+			}
 		});
 	}
 	return {

package/dist/docx/footnoteParser.d.ts

@@ -67,16 +67,6 @@ declare function parseFootnotes(footnotesXml: string | null, styles?: StyleMap |
  * @returns EndnoteMap with all endnotes
  */
 declare function parseEndnotes(endnotesXml: string | null, styles?: StyleMap | null, theme?: document_d_exports.Theme | null, numbering?: NumberingMap | null, rels?: document_d_exports.RelationshipMap | null, media?: Map<string, document_d_exports.MediaFile> | null, context?: ParseContext, previews?: PreviewLedger): EndnoteMap;
-/**
- * Get plain text content of a footnote.
- *
- * Uses the accepted tracked-change view and recurses through every note block.
- */
-declare function getFootnoteText(footnote: document_d_exports.Footnote): string;
-/**
- * Get plain text content of an endnote.
- */
-declare function getEndnoteText(endnote: document_d_exports.Endnote): string;
 /**
  * Check if a footnote is a separator (not regular content)
  */
@@ -102,4 +92,4 @@ declare function mergeFootnoteMaps(...maps: FootnoteMap[]): FootnoteMap;
  */
 declare function mergeEndnoteMaps(...maps: EndnoteMap[]): EndnoteMap;
 //#endregion
-export { EndnoteMap, FootnoteMap, createEmptyEndnoteMap, createEmptyFootnoteMap, getEndnoteText, getFootnoteText, isSeparatorEndnote, isSeparatorFootnote, mergeEndnoteMaps, mergeFootnoteMaps, parseEndnoteProperties, parseEndnotes, parseFootnoteProperties, parseFootnotes };
+export { EndnoteMap, FootnoteMap, createEmptyEndnoteMap, createEmptyFootnoteMap, isSeparatorEndnote, isSeparatorFootnote, mergeEndnoteMaps, mergeFootnoteMaps, parseEndnoteProperties, parseEndnotes, parseFootnoteProperties, parseFootnotes };

package/dist/docx/footnoteParser.js

@@ -1,4 +1,3 @@
-import { blockPlainText } from "./blockPlainText.js";
 import { parseEndnoteProperties, parseFootnoteProperties } from "./notePropertiesParser.js";
 import { parseParagraph } from "./paragraphParser.js";
 import { standalonePreviewLedger } from "./previewBudget.js";
@@ -196,20 +195,6 @@ function createEndnoteMap(byId, endnotes) {
 	};
 }
 /**
-* Get plain text content of a footnote.
-*
-* Uses the accepted tracked-change view and recurses through every note block.
-*/
-function getFootnoteText(footnote) {
-	return blockPlainText(footnote.content);
-}
-/**
-* Get plain text content of an endnote.
-*/
-function getEndnoteText(endnote) {
-	return blockPlainText(endnote.content);
-}
-/**
 * Check if a footnote is a separator (not regular content)
 */
 function isSeparatorFootnote(footnote) {
@@ -258,4 +243,4 @@ function mergeEndnoteMaps(...maps) {
 	return createEndnoteMap(byId, endnotes);
 }
 //#endregion
-export { createEmptyEndnoteMap, createEmptyFootnoteMap, getEndnoteText, getFootnoteText, isSeparatorEndnote, isSeparatorFootnote, mergeEndnoteMaps, mergeFootnoteMaps, parseEndnoteProperties, parseEndnotes, parseFootnoteProperties, parseFootnotes };
+export { createEmptyEndnoteMap, createEmptyFootnoteMap, isSeparatorEndnote, isSeparatorFootnote, mergeEndnoteMaps, mergeFootnoteMaps, parseEndnoteProperties, parseEndnotes, parseFootnoteProperties, parseFootnotes };

package/dist/docx/headerFooterParser.d.ts

@@ -81,14 +81,6 @@ declare function createEmptyHeaderFooterMap(): HeaderFooterMap;
  * @returns HeaderFooterMap with all parsed headers/footers
  */
 declare function buildHeaderFooterMap(references: (document_d_exports.HeaderReference | document_d_exports.FooterReference)[], xmlContents: Map<string, string>, isHeader: boolean, styles?: StyleMap | null, theme?: document_d_exports.Theme | null, numbering?: NumberingMap | null, rels?: document_d_exports.RelationshipMap | null, media?: Map<string, document_d_exports.MediaFile> | null): HeaderFooterMap;
-/**
- * Get plain text content of a header/footer.
- *
- * Shares one walk with the note stories: this used to read only text runs, so a
- * header's fields, hyperlinks, tabs and breaks were silently absent from its
- * text while the same paragraph in a footnote read in full.
- */
-declare function getHeaderFooterText(hf: document_d_exports.HeaderFooter): string;
 /**
  * Check if header/footer is empty (no content)
  */
@@ -129,4 +121,4 @@ declare function hasImages(hf: document_d_exports.HeaderFooter): boolean;
  */
 declare function hasTables(hf: document_d_exports.HeaderFooter): boolean;
 //#endregion
-export { HeaderFooterMap, buildHeaderFooterMap, createEmptyHeaderFooterMap, getFooterForPage, getHeaderFooterText, getHeaderForPage, hasImages, hasPageNumberField, hasTables, headerFooterMapToTypeMap, isEmptyHeaderFooter, parseFooter, parseFooterReference, parseFooterReferences, parseHeader, parseHeaderFooter, parseHeaderReference, parseHeaderReferences };
+export { HeaderFooterMap, buildHeaderFooterMap, createEmptyHeaderFooterMap, getFooterForPage, getHeaderForPage, hasImages, hasPageNumberField, hasTables, headerFooterMapToTypeMap, isEmptyHeaderFooter, parseFooter, parseFooterReference, parseFooterReferences, parseHeader, parseHeaderFooter, parseHeaderReference, parseHeaderReferences };

package/dist/docx/headerFooterParser.js

@@ -1,5 +1,4 @@
 import { parseBlockContent } from "./blockContentParser.js";
-import { blockPlainText } from "./blockPlainText.js";
 import { parseFooterReference, parseFooterReferences, parseHeaderReference, parseHeaderReferences } from "./headerFooterRefParser.js";
 import { assignHeaderFooterVerbatimXml } from "./headerFooterVerbatim.js";
 import { cloneParagraphWithPropertySource } from "./paragraphPropertySource.js";
@@ -150,16 +149,6 @@ function buildHeaderFooterMap(references, xmlContents, isHeader, styles = null,
 	return createHeaderFooterMap(byId);
 }
 /**
-* Get plain text content of a header/footer.
-*
-* Shares one walk with the note stories: this used to read only text runs, so a
-* header's fields, hyperlinks, tabs and breaks were silently absent from its
-* text while the same paragraph in a footnote read in full.
-*/
-function getHeaderFooterText(hf) {
-	return blockPlainText(hf.content);
-}
-/**
 * Check if header/footer is empty (no content)
 */
 function isEmptyHeaderFooter(hf) {
@@ -254,4 +243,4 @@ function hasTables(hf) {
 	return false;
 }
 //#endregion
-export { buildHeaderFooterMap, createEmptyHeaderFooterMap, getFooterForPage, getHeaderFooterText, getHeaderForPage, hasImages, hasPageNumberField, hasTables, headerFooterMapToTypeMap, isEmptyHeaderFooter, parseFooter, parseFooterReference, parseFooterReferences, parseHeader, parseHeaderFooter, parseHeaderReference, parseHeaderReferences };
+export { buildHeaderFooterMap, createEmptyHeaderFooterMap, getFooterForPage, getHeaderForPage, hasImages, hasPageNumberField, hasTables, headerFooterMapToTypeMap, isEmptyHeaderFooter, parseFooter, parseFooterReference, parseFooterReferences, parseHeader, parseHeaderFooter, parseHeaderReference, parseHeaderReferences };

package/dist/docx/headerFooterVerbatim.d.ts

@@ -9,6 +9,13 @@ type HeaderFooterSourceBaseline = {
   content: readonly document_d_exports.BlockContent[];
 };
 declare const captureHeaderFooterPackageBaselines: (document: document_d_exports.Document) => void;
+/**
+ * Transfer body, header and footer capture handles across a trusted
+ * document graph clone. `structuredClone` drops symbol-keyed properties, so a
+ * clone would otherwise read an edited part as uncaptured ("missing") rather
+ * than as a mismatch against its source.
+ */
+declare const copyHeaderFooterBaselineHandles: (target: document_d_exports.Document, source: document_d_exports.Document) => void;
 /** Transfer the parsed package registry only across a trusted document graph clone. */
 declare const copyHeaderFooterPackageBaselines: (target: document_d_exports.Document, source: document_d_exports.Document) => void;
 declare const getHeaderFooterSourceBaseline: (hf: document_d_exports.HeaderFooter, originalBuffer?: ArrayBuffer) => HeaderFooterSourceBaseline;
@@ -18,5 +25,23 @@ declare const canReplayHeaderFooterVerbatim: (hf: document_d_exports.HeaderFoote
 declare const assignHeaderFooterVerbatimXml: (hf: document_d_exports.HeaderFooter, xml: string) => void;
 declare const refreshHeaderFooterVerbatimFingerprint: (hf: document_d_exports.HeaderFooter) => void;
 declare const clearHeaderFooterVerbatimXml: (hf: document_d_exports.HeaderFooter) => void;
+/** Capture the body in the same trusted package registry as secondary stories. */
+declare const captureDocumentSourceBaseline: (document: document_d_exports.Document, xml: string) => void;
+declare const getDocumentSourceBaseline: (document: document_d_exports.Document) => {
+  type: "missing";
+} | {
+  type: "mismatch";
+} | {
+  type: "captured";
+  body: document_d_exports.Document["package"]["document"];
+  xml: string;
+  fingerprint: string;
+  resourceStyles: document_d_exports.Document["package"]["styles"];
+  resourceRelationships: document_d_exports.Document["package"]["relationships"];
+  resourceMedia: ReadonlyMap<string, {
+    data: ArrayBuffer;
+    mimeType: string;
+  }>;
+};
 //#endregion
-export { assignHeaderFooterVerbatimXml, canReplayHeaderFooterBlocks, canReplayHeaderFooterVerbatim, captureHeaderFooterPackageBaselines, clearHeaderFooterVerbatimXml, copyHeaderFooterPackageBaselines, getHeaderFooterSourceBaseline, getHeaderFooterVerbatimXml, refreshHeaderFooterVerbatimFingerprint };
+export { assignHeaderFooterVerbatimXml, canReplayHeaderFooterBlocks, canReplayHeaderFooterVerbatim, captureDocumentSourceBaseline, captureHeaderFooterPackageBaselines, clearHeaderFooterVerbatimXml, copyHeaderFooterBaselineHandles, copyHeaderFooterPackageBaselines, getDocumentSourceBaseline, getHeaderFooterSourceBaseline, getHeaderFooterVerbatimXml, refreshHeaderFooterVerbatimFingerprint };