@stll/folio-core 0.37.5 → 0.38.0

package/dist/docx/blockContentParser.js

@@ -7,7 +7,7 @@ import { enrichParagraphTextBoxes } from "./paragraphTextBoxEnrichment.js";
 import { parseSdtProperties } from "./sdtProperties.js";
 import { parseTable } from "./tableParser.js";
 import { captureVerbatimXml } from "./verbatimCapture.js";
-import { findChild, getChildElements, getLocalName, mergeXmlnsDeclarations } from "./xmlParser.js";
+import { findChild, getChildElements, getLocalName, mergeXmlnsDeclarations, selectAlternateContentBranch } from "./xmlParser.js";
 //#region src/docx/blockContentParser.ts
 const computeListMarker = (paragraph, { numbering, listCounters, abstractCounters, restartedNumIds, previousList }) => {
 	const listRendering = paragraph.listRendering;
@@ -80,6 +80,13 @@ const computeListMarker = (paragraph, { numbering, listCounters, abstractCounter
 	}
 	listRendering.marker = computedMarker;
 };
+const withContainerXmlns = (state, element) => ({
+	...state,
+	options: {
+		...state.options,
+		rootXmlns: mergeXmlnsDeclarations(state.options?.rootXmlns ?? {}, element)
+	}
+});
 const parseBlockContent = (parent, styles, theme, numbering, rels, media, options) => parseBlockContentWithState(parent, styles, theme, numbering, rels, media, {
 	listCounters: /* @__PURE__ */ new Map(),
 	abstractCounters: /* @__PURE__ */ new Map(),
@@ -132,12 +139,17 @@ const parseBlockContentWithState = (parent, styles, theme, numbering, rels, medi
 			const blockSdt = {
 				type: "blockSdt",
 				properties,
-				content: sdtContent ? parseBlockContentWithState(sdtContent, styles, theme, numbering, rels, media, state) : []
+				content: sdtContent ? parseBlockContentWithState(sdtContent, styles, theme, numbering, rels, media, withContainerXmlns(withContainerXmlns(state, child), sdtContent)) : []
 			};
 			if (prependBookmarkMarkersToFirstParagraphInBlocks(blockSdt.content, pendingBookmarkMarkers)) pendingBookmarkMarkers.length = 0;
 			content.push(blockSdt);
 			continue;
 		}
+		if (localName === "AlternateContent") {
+			const selectedBranch = selectAlternateContentBranch(child);
+			if (selectedBranch) content.push(...parseBlockContentWithState(selectedBranch, styles, theme, numbering, rels, media, withContainerXmlns(withContainerXmlns(state, child), selectedBranch)));
+			continue;
+		}
 		if (localName === "bookmarkStart" || localName === "bookmarkEnd") {
 			const marker = parseBookmarkMarker(child, localName);
 			if (!appendBookmarkMarkerToLastParagraphInBlocks(content, marker)) pendingBookmarkMarkers.push(marker);

package/dist/docx/drawingIdNormalization.js

@@ -1,6 +1,27 @@
+import { isNewDataUrlDrawing } from "./newImage.js";
 import { visitDocxParagraphs, visitParagraphRuns } from "./paragraphTraversal.js";
+import { toTransitionalNamespaceUri } from "./transitionalSpelling.js";
+import { captureVerbatimXml } from "./verbatimCapture.js";
+import { NAMESPACES, OOXML_NAMESPACE_SCOPE, getLocalName, getNamespaceUri, parseXml } from "./xmlParser.js";
+import { panic } from "better-result";
 //#region src/docx/drawingIdNormalization.ts
 const GENERATED_DRAWING_ID_START = 1e5;
+const isDetachedRawDrawing = (drawing) => drawing?.rawXml !== void 0 && isNewDataUrlDrawing(drawing);
+const reassignRawDrawingId = ({ xml, id }) => {
+	const root = parseXml(xml, OOXML_NAMESPACE_SCOPE);
+	let foundDocPr = false;
+	const visit = (element) => {
+		if (toTransitionalNamespaceUri(getNamespaceUri(element) ?? "") === NAMESPACES.wp && getLocalName(element.name) === "docPr" || toTransitionalNamespaceUri(getNamespaceUri(element) ?? "") === NAMESPACES.pic && getLocalName(element.name) === "cNvPr") {
+			for (const name of Object.keys(element.attributes ?? {})) if (getLocalName(name) === "id" && element.attributes) {
+				element.attributes[name] = id;
+				if (toTransitionalNamespaceUri(getNamespaceUri(element) ?? "") === NAMESPACES.wp && getLocalName(element.name) === "docPr") foundDocPr = true;
+			}
+		}
+		for (const child of element.elements ?? []) visit(child);
+	};
+	visit(root);
+	return foundDocPr ? (root.elements ?? []).map(captureVerbatimXml).join("") : null;
+};
 const needsGeneratedId = ({ id }) => id === void 0 || id === "" || id === "0";
 const normalizeDrawingIds = (surfaces) => {
 	const entries = [];
@@ -16,12 +37,13 @@ const normalizeDrawingIds = (surfaces) => {
 				}
 				if (content.type === "drawing") entries.push({
 					drawing: content.image,
-					generateWhenMissing: content.rawXml === void 0
+					generateWhenMissing: content.rawXml === void 0,
+					...content.rawXml !== void 0 ? { rawDrawing: content } : {}
 				});
 			}
 		});
 	});
-	const usedIds = new Set(entries.flatMap(({ drawing }) => needsGeneratedId(drawing) ? [] : [drawing.id]));
+	const usedIds = new Set(entries.flatMap(({ drawing, rawDrawing }) => needsGeneratedId(drawing) || isDetachedRawDrawing(rawDrawing) ? [] : [drawing.id]));
 	let nextId = GENERATED_DRAWING_ID_START;
 	for (const { drawing, generateWhenMissing } of entries) {
 		if (!generateWhenMissing || !needsGeneratedId(drawing)) continue;
@@ -30,6 +52,25 @@ const normalizeDrawingIds = (surfaces) => {
 		usedIds.add(drawing.id);
 		nextId += 1;
 	}
+	for (const { drawing, rawDrawing } of entries) {
+		if (!isDetachedRawDrawing(rawDrawing)) continue;
+		if (!needsGeneratedId(drawing) && !usedIds.has(drawing.id)) {
+			usedIds.add(drawing.id);
+			continue;
+		}
+		while (usedIds.has(String(nextId))) nextId += 1;
+		const sourceXml = rawDrawing.rawXml;
+		if (sourceXml === void 0) panic("Detached raw drawing must retain its XML.");
+		const rawXml = reassignRawDrawingId({
+			xml: sourceXml,
+			id: String(nextId)
+		});
+		if (rawXml === null) panic("Detached raw drawing must contain wp:docPr.");
+		drawing.id = String(nextId);
+		rawDrawing.rawXml = rawXml;
+		usedIds.add(drawing.id);
+		nextId += 1;
+	}
 };
 //#endregion
 export { normalizeDrawingIds };

package/dist/docx/drawingRelationships.d.ts

@@ -0,0 +1,10 @@
+//#region src/docx/drawingRelationships.d.ts
+type RebindDrawingImageRelationshipOptions = {
+  xml: string;
+  previousId: string;
+  nextId: string;
+};
+/** Only a single embedded image can travel without importing other package resources. */
+declare const rebindDrawingImageRelationship: ({ xml, previousId, nextId }: RebindDrawingImageRelationshipOptions) => string | null;
+//#endregion
+export { rebindDrawingImageRelationship };

package/dist/docx/drawingRelationships.js

@@ -0,0 +1,28 @@
+import { captureVerbatimXml } from "./verbatimCapture.js";
+import { OFFICE_RELATIONSHIP_NAMESPACE_URIS, OOXML_NAMESPACE_SCOPE, findAttributeByNamespaceUri, getLocalName, getNamespaceUri, parseXml } from "./xmlParser.js";
+//#region src/docx/drawingRelationships.ts
+/** Only a single embedded image can travel without importing other package resources. */
+const rebindDrawingImageRelationship = ({ xml, previousId, nextId }) => {
+	const root = parseXml(xml, OOXML_NAMESPACE_SCOPE);
+	let embeddedCount = 0;
+	let unsupported = false;
+	const visit = (element) => {
+		for (const name of Object.keys(element.attributes ?? {})) {
+			const localName = getLocalName(name);
+			const attribute = findAttributeByNamespaceUri(element, OFFICE_RELATIONSHIP_NAMESPACE_URIS, localName);
+			if (!attribute || attribute.name !== name) continue;
+			if (!(localName === "embed" || localName === "id" && getLocalName(element.name) === "imagedata" && getNamespaceUri(element) === "urn:schemas-microsoft-com:vml") || attribute.value !== previousId) {
+				unsupported = true;
+				continue;
+			}
+			embeddedCount++;
+			if (element.attributes) element.attributes[name] = nextId;
+		}
+		for (const child of element.elements ?? []) visit(child);
+	};
+	visit(root);
+	if (unsupported || embeddedCount !== 1) return null;
+	return (root.elements ?? []).map(captureVerbatimXml).join("");
+};
+//#endregion
+export { rebindDrawingImageRelationship };

package/dist/docx/fieldParser.js

@@ -209,7 +209,7 @@ function resetComplexFieldContext(ctx) {
 function finalizeComplexField(ctx) {
 	return {
 		type: "complexField",
-		instruction: ctx.instruction.trim(),
+		instruction: ctx.instruction,
 		fieldType: parseFieldType(ctx.instruction),
 		fieldCode: ctx.codeRuns,
 		fieldResult: ctx.resultRuns,

package/dist/docx/hyperlinkParser.js

@@ -52,8 +52,7 @@ function parseHyperlink(node, rels, styles = null, theme = null, media = null, r
 		if (rels) {
 			const rel = rels.get(rId);
 			if (rel) {
-				const safeHref = sanitizeExternalUrl(rel.target);
-				if (safeHref) hyperlink.href = safeHref;
+				if (sanitizeExternalUrl(rel.target)) hyperlink.href = rel.target;
 			}
 		}
 	}
@@ -172,9 +171,8 @@ function resolveHyperlinkUrl(hyperlink, rels) {
 	if (hyperlink.rId) {
 		const rel = rels.get(hyperlink.rId);
 		if (rel) {
-			const safeHref = sanitizeExternalUrl(rel.target);
-			if (safeHref) {
-				hyperlink.href = safeHref;
+			if (sanitizeExternalUrl(rel.target)) {
+				hyperlink.href = rel.target;
 				return hyperlink.href;
 			}
 		}

package/dist/docx/imageRawXml.d.ts

@@ -0,0 +1,8 @@
+import { document_d_exports } from "../types/document.js";
+//#region src/docx/imageRawXml.d.ts
+/** Fingerprints modeled image fields which make raw DrawingML stale when edited. */
+declare const imageRawXmlFingerprint: (image: document_d_exports.Image) => string;
+/** Editable raw drawing XML can replay only while its modeled projection is unchanged. */
+declare const canReplayEditableImageRawXml: (drawing: document_d_exports.DrawingContent) => boolean;
+//#endregion
+export { canReplayEditableImageRawXml, imageRawXmlFingerprint };

package/dist/docx/imageRawXml.js

@@ -0,0 +1,13 @@
+import { canonicalJson } from "../utils/canonicalJson.js";
+import { DRAWING_RAW_XML_MODES } from "@stll/docx-core/model";
+//#region src/docx/imageRawXml.ts
+const editableImageProjection = ({ id: _id, rId: _rId, src: _src, mimeType: _mimeType, filename: _filename, ...image }) => image;
+/** Fingerprints modeled image fields which make raw DrawingML stale when edited. */
+const imageRawXmlFingerprint = (image) => canonicalJson(editableImageProjection(image));
+/** Editable raw drawing XML can replay only while its modeled projection is unchanged. */
+const canReplayEditableImageRawXml = (drawing) => {
+	if (drawing.rawXmlMode === DRAWING_RAW_XML_MODES.PRESERVE_ONLY) return true;
+	return drawing.rawImageFingerprint === void 0 || drawing.rawImageFingerprint === imageRawXmlFingerprint(drawing.image);
+};
+//#endregion
+export { canReplayEditableImageRawXml, imageRawXmlFingerprint };

package/dist/docx/newImage.d.ts

@@ -3,8 +3,8 @@ import { DrawingContent, RunContent } from "../types/content.js";
 /**
  * A drawing needs a new package image part only when it is model-driven.
  *
- * Raw OOXML drawings can carry data-URL previews for browser rendering, but
- * save replays their raw XML instead of serializing the preview image.
+ * Raw OOXML drawings can carry previews for browser rendering. Only an explicit
+ * synthetic relationship opts a detached raw picture into media registration.
  */
 declare const isNewDataUrlDrawing: (content: RunContent) => content is DrawingContent;
 //#endregion

package/dist/docx/newImage.js

@@ -3,9 +3,9 @@ const SYNTHETIC_IMAGE_RID_PREFIX = "rId_img_";
 /**
 * A drawing needs a new package image part only when it is model-driven.
 *
-* Raw OOXML drawings can carry data-URL previews for browser rendering, but
-* save replays their raw XML instead of serializing the preview image.
+* Raw OOXML drawings can carry previews for browser rendering. Only an explicit
+* synthetic relationship opts a detached raw picture into media registration.
 */
-const isNewDataUrlDrawing = (content) => content.type === "drawing" && !content.rawXml && content.image.src?.startsWith("data:") === true && (!content.image.rId || content.image.rId.startsWith(SYNTHETIC_IMAGE_RID_PREFIX));
+const isNewDataUrlDrawing = (content) => content.type === "drawing" && (!content.rawXml || content.image.rId?.startsWith(SYNTHETIC_IMAGE_RID_PREFIX) === true) && content.image.src?.startsWith("data:") === true && (!content.image.rId || content.image.rId.startsWith(SYNTHETIC_IMAGE_RID_PREFIX));
 //#endregion
 export { isNewDataUrlDrawing };

package/dist/docx/numberingParser.js

@@ -1,7 +1,7 @@
 import { formatOoxmlCounter, padDecimal } from "./ooxmlCounterFormatter.js";
 import { LevelSuffixSchema, narrowEnum } from "./parserEnums.js";
 import { parseRunProperties } from "./runParser.js";
-import { findChild, findChildren, getAttribute, parseBooleanElement, parseNumericAttribute, parseXmlDocument } from "./xmlParser.js";
+import { WORDPROCESSINGML_NAMESPACE_URIS, findChild, findChildren, getAttribute, getLocalName, getNamespaceUri, parseBooleanElement, parseNumericAttribute, parseXmlDocument } from "./xmlParser.js";
 //#region src/docx/numberingParser.ts
 const NUMBER_FORMAT_MAP = {
 	decimal: "decimal",
@@ -65,6 +65,7 @@ const NUMBER_FORMAT_MAP = {
 	thaiNumbers: "thaiNumbers",
 	thaiCounting: "thaiCounting"
 };
+const wordprocessingLocalName = (element) => WORDPROCESSINGML_NAMESPACE_URIS.has(getNamespaceUri(element) ?? "") ? getLocalName(element.name) : null;
 /**
 * Parse numbering.xml into NumberingDefinitions
 *
@@ -110,20 +111,20 @@ function parseAbstractNumbering(element) {
 	const levelElements = [];
 	for (const child of element.elements ?? []) {
 		if (child.type !== "element") continue;
-		switch (child.name) {
-			case "w:multiLevelType":
+		switch (wordprocessingLocalName(child)) {
+			case "multiLevelType":
 				multiLevelTypeEl ??= child;
 				break;
-			case "w:name":
+			case "name":
 				nameEl ??= child;
 				break;
-			case "w:numStyleLink":
+			case "numStyleLink":
 				numStyleLinkEl ??= child;
 				break;
-			case "w:styleLink":
+			case "styleLink":
 				styleLinkEl ??= child;
 				break;
-			case "w:lvl":
+			case "lvl":
 				levelElements.push(child);
 				break;
 			default: break;
@@ -164,11 +165,11 @@ function parseNumberingInstance(element) {
 	const overrideElements = [];
 	for (const child of element.elements ?? []) {
 		if (child.type !== "element") continue;
-		if (child.name === "w:abstractNumId") {
+		if (wordprocessingLocalName(child) === "abstractNumId") {
 			abstractNumIdEl ??= child;
 			continue;
 		}
-		if (child.name === "w:lvlOverride") overrideElements.push(child);
+		if (wordprocessingLocalName(child) === "lvlOverride") overrideElements.push(child);
 	}
 	if (!abstractNumIdEl) return null;
 	const abstractNumIdStr = getAttribute(abstractNumIdEl, "w", "val");
@@ -191,11 +192,11 @@ function parseNumberingInstance(element) {
 			let lvlEl;
 			for (const child of overrideEl.elements ?? []) {
 				if (child.type !== "element") continue;
-				if (child.name === "w:startOverride") {
+				if (wordprocessingLocalName(child) === "startOverride") {
 					startOverrideEl ??= child;
 					continue;
 				}
-				if (child.name === "w:lvl") lvlEl ??= child;
+				if (wordprocessingLocalName(child) === "lvl") lvlEl ??= child;
 			}
 			if (startOverrideEl) {
 				const startVal = getAttribute(startOverrideEl, "w", "val");
@@ -239,38 +240,40 @@ function parseListLevel(element) {
 	let rPrEl;
 	for (const child of element.elements ?? []) {
 		if (child.type !== "element") continue;
-		switch (child.name) {
-			case "w:start":
+		const localName = wordprocessingLocalName(child);
+		if (localName === null) {
+			if (getLocalName(child.name) === "AlternateContent") alternateEl ??= child;
+			continue;
+		}
+		switch (localName) {
+			case "start":
 				startEl ??= child;
 				break;
-			case "w:numFmt":
+			case "numFmt":
 				numFmtEl ??= child;
 				break;
-			case "mc:AlternateContent":
-				alternateEl ??= child;
-				break;
-			case "w:lvlText":
+			case "lvlText":
 				lvlTextEl ??= child;
 				break;
-			case "w:lvlJc":
+			case "lvlJc":
 				lvlJcEl ??= child;
 				break;
-			case "w:suff":
+			case "suff":
 				suffEl ??= child;
 				break;
-			case "w:isLgl":
+			case "isLgl":
 				isLglEl ??= child;
 				break;
-			case "w:lvlRestart":
+			case "lvlRestart":
 				lvlRestartEl ??= child;
 				break;
-			case "w:legacy":
+			case "legacy":
 				legacyEl ??= child;
 				break;
-			case "w:pPr":
+			case "pPr":
 				pPrEl ??= child;
 				break;
-			case "w:rPr":
+			case "rPr":
 				rPrEl ??= child;
 				break;
 			default: break;
@@ -361,11 +364,11 @@ function parseLevelParagraphProps(pPr) {
 	let tabsEl;
 	for (const child of pPr.elements ?? []) {
 		if (child.type !== "element") continue;
-		if (child.name === "w:ind") {
+		if (wordprocessingLocalName(child) === "ind") {
 			indEl ??= child;
 			continue;
 		}
-		if (child.name === "w:tabs") tabsEl ??= child;
+		if (wordprocessingLocalName(child) === "tabs") tabsEl ??= child;
 	}
 	if (indEl) {
 		const left = parseNumericAttribute(indEl, "w", "left");

package/dist/docx/paragraphParser.js

@@ -13,10 +13,11 @@ import { parseSdtProperties } from "./sdtProperties.js";
 import { parseSectionProperties } from "./sectionParser.js";
 import { parsePropertyChangeInfo, parseTrackedChangeInfo } from "./trackedChangeInfo.js";
 import { captureVerbatimXml } from "./verbatimCapture.js";
-import { WORDPROCESSINGML_NAMESPACE_URIS, cloneElement, findChild, findChildByNamespaceUri, findChildren, findChildrenByNamespaceUri, getAttribute, getChildElements, getLocalName, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseNumberingLevelAttribute, parseNumericAttribute } from "./xmlParser.js";
+import { WORDPROCESSINGML_NAMESPACE_URIS, cloneElement, findChild, findChildByNamespaceUri, findChildren, findChildrenByNamespaceUri, getAttribute, getAttributeByNamespaceUri, getChildElements, getLocalName, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseNumberingLevelAttribute, parseNumericAttribute, selectAlternateContentBranch } from "./xmlParser.js";
 import { panic } from "better-result";
-import { PARAGRAPH_MARK_CHANGE_KINDS } from "@stll/docx-core/model";
+import { PARAGRAPH_MARK_CHANGE_KINDS, REVIEW_CARRIERS } from "@stll/docx-core/model";
 //#region src/docx/paragraphParser.ts
+const FOLIO_REVIEW_HISTORY_NAMESPACES = /* @__PURE__ */ new Set(["urn:stella:folio:review-history:1"]);
 /**
 * Extract plain text from a math element (recursive text content extraction)
 */
@@ -532,7 +533,7 @@ function parseParagraphMarkChange(pPr) {
 	}
 }
 function isTrackedChangeWrapperChild(content) {
-	return content.type === "run" || content.type === "hyperlink" || content.type === "bookmarkStart" || content.type === "bookmarkEnd" || content.type === "simpleField" || content.type === "complexField" || content.type === "insertion" || content.type === "deletion" || content.type === "moveFrom" || content.type === "moveTo";
+	return content.type === "run" || content.type === "hyperlink" || content.type === "bookmarkStart" || content.type === "bookmarkEnd" || content.type === "simpleField" || content.type === "complexField" || content.type === "mathEquation" || content.type === "insertion" || content.type === "deletion" || content.type === "moveFrom" || content.type === "moveTo";
 }
 function isInlineSdtContent(content) {
 	return content.type === "run" || content.type === "hyperlink" || content.type === "simpleField" || content.type === "complexField" || content.type === "inlineSdt" || content.type === "insertion" || content.type === "deletion" || content.type === "moveFrom" || content.type === "moveTo" || content.type === "mathEquation";
@@ -887,7 +888,7 @@ function parseParagraphContents(paraElement, styles, theme, _numbering, rels, me
 						}];
 						const complexField = {
 							type: "complexField",
-							instruction: complexFieldInstr.trim(),
+							instruction: complexFieldInstr,
 							fieldType: parseFieldType(complexFieldInstr),
 							fieldCode: complexFieldCodeRuns,
 							fieldResult: resultRuns
@@ -911,6 +912,11 @@ function parseParagraphContents(paraElement, styles, theme, _numbering, rels, me
 				} else if (run.content.length > 0 || hasRunPayloadElement(runElement)) contents.push(run);
 				break;
 			}
+			case "AlternateContent": {
+				const selectedBranch = selectAlternateContentBranch(child);
+				if (selectedBranch) contents.push(...parseParagraphContents(selectedBranch, styles, theme, null, rels, media, trackedContext, mergeXmlnsDeclarations(inScopeXmlns, child)));
+				break;
+			}
 			case "hyperlink":
 				contents.push(...parseHyperlinkParagraphContents(child, rels, styles, theme, media, inScopeXmlns));
 				break;
@@ -1078,6 +1084,7 @@ function parseParagraph(node, styles, theme, numbering, rels = null, media = nul
 	if (paraId && isValidHexId(paraId)) paragraph.paraId = paraIdInRange(paraId);
 	const textId = getAttribute(node, "w14", "textId") ?? getAttribute(node, "w", "textId");
 	if (textId && isValidHexId(textId)) paragraph.textId = paraIdInRange(textId);
+	if (getAttributeByNamespaceUri(node, FOLIO_REVIEW_HISTORY_NAMESPACES, "reviewCarrier") === REVIEW_CARRIERS.TERMINAL_TABLE) paragraph.reviewCarrier = REVIEW_CARRIERS.TERMINAL_TABLE;
 	if (!options?.inHeaderFooter && paragraphStartsWithRenderedPageBreak(node)) paragraph.renderedPageBreakBefore = true;
 	const pPr = findChild(node, "w", "pPr");
 	if (pPr) {

package/dist/docx/removeHeaderFooterParts.d.ts

@@ -0,0 +1,14 @@
+import { document_d_exports } from "../types/document.js";
+import { RemovedSectionReference } from "../internal/sectionEndpointResolution.js";
+import JSZip from "jszip";
+//#region src/docx/removeHeaderFooterParts.d.ts
+type RemoveResolvedHeaderFooterPartsOptions = {
+  document: document_d_exports.Document;
+  zip: JSZip;
+  removedReferences: readonly RemovedSectionReference[];
+  compressionLevel: number;
+};
+/** Remove only parts whose last selection was explicitly resolved out of the document. */
+declare const removeResolvedHeaderFooterParts: ({ document, zip, removedReferences, compressionLevel }: RemoveResolvedHeaderFooterPartsOptions) => Promise<void>;
+//#endregion
+export { removeResolvedHeaderFooterParts };

package/dist/docx/removeHeaderFooterParts.js

@@ -0,0 +1,87 @@
+import { isUnsafePackagePath } from "./packageParts.js";
+import { parseRelationships, resolveRelativePath } from "./relsParser.js";
+import { captureVerbatimXml } from "./verbatimCapture.js";
+import { OFFICE_RELATIONSHIP_NAMESPACE_URIS, cloneElement, getAttribute, getLocalName, getNamespaceUri, parseXmlDocument } from "./xmlParser.js";
+import { panic } from "better-result";
+import { OOXML_NS } from "@stll/docx-utils";
+//#region src/docx/removeHeaderFooterParts.ts
+const DOCUMENT_RELS_PATH = "word/_rels/document.xml.rels";
+const officeRelationshipHasType = (type, kind) => [...OFFICE_RELATIONSHIP_NAMESPACE_URIS].some((namespace) => type === `${namespace}/${kind}`);
+const withoutChildren = (xml, remove) => {
+	const root = parseXmlDocument(xml);
+	if (!root) return panic("Cannot update malformed package metadata");
+	return captureVerbatimXml(cloneElement(root, { elements: (root.elements ?? []).filter((child) => !remove(child)) }));
+};
+/** Remove only parts whose last selection was explicitly resolved out of the document. */
+const removeResolvedHeaderFooterParts = async ({ document, zip, removedReferences, compressionLevel }) => {
+	if (removedReferences.length === 0) return;
+	const relsFile = zip.file(DOCUMENT_RELS_PATH);
+	if (!relsFile) return panic("A resolved header/footer part has no document relationships");
+	const relsXml = await relsFile.async("text");
+	const relationships = parseRelationships(relsXml);
+	const removedIds = /* @__PURE__ */ new Set();
+	const candidates = /* @__PURE__ */ new Set();
+	for (const { part, relationshipId } of removedReferences) {
+		if ((part === "header" ? document.package.headers : document.package.footers)?.has(relationshipId)) continue;
+		const relationship = relationships.get(relationshipId);
+		if (!relationship) continue;
+		if (!officeRelationshipHasType(relationship.type, part) || relationship.targetMode === "External") return panic("Resolved header/footer relationship has an unexpected part type");
+		const path = resolveRelativePath(DOCUMENT_RELS_PATH, relationship.target);
+		if (isUnsafePackagePath(path)) return panic("Resolved header/footer has an unsafe package path");
+		removedIds.add(relationshipId);
+		candidates.add(path);
+	}
+	if (removedIds.size === 0) return;
+	for (const relationship of relationships.values()) {
+		if (removedIds.has(relationship.id) || relationship.targetMode === "External") continue;
+		candidates.delete(resolveRelativePath(DOCUMENT_RELS_PATH, relationship.target));
+	}
+	for (const file of Object.values(zip.files)) {
+		if (file.dir || !file.name.endsWith(".rels") || file.name === DOCUMENT_RELS_PATH) continue;
+		const otherRelationships = parseRelationships(await file.async("text"));
+		for (const relationship of otherRelationships.values()) if (relationship.targetMode !== "External") candidates.delete(resolveRelativePath(file.name, relationship.target));
+	}
+	const retiredMedia = /* @__PURE__ */ new Set();
+	for (const path of candidates) {
+		const slash = path.lastIndexOf("/");
+		const relsPath = `${path.slice(0, slash + 1)}_rels/${path.slice(slash + 1)}.rels`;
+		const partRels = zip.file(relsPath);
+		if (!partRels) continue;
+		for (const relationship of parseRelationships(await partRels.async("text")).values()) {
+			if (!officeRelationshipHasType(relationship.type, "image") || relationship.targetMode === "External") continue;
+			const mediaPath = resolveRelativePath(relsPath, relationship.target);
+			if (!isUnsafePackagePath(mediaPath) && mediaPath.startsWith("word/media/")) retiredMedia.add(mediaPath);
+		}
+	}
+	const compressionOptions = { level: compressionLevel };
+	zip.file(DOCUMENT_RELS_PATH, withoutChildren(relsXml, (child) => getNamespaceUri(child) === OOXML_NS.pr && getLocalName(child.name) === "Relationship" && removedIds.has(getAttribute(child, null, "Id") ?? "")), {
+		compression: "DEFLATE",
+		compressionOptions
+	});
+	if (document.package.relationships) {
+		document.package.relationships = new Map(document.package.relationships);
+		for (const id of removedIds) document.package.relationships.delete(id);
+	}
+	for (const path of candidates) {
+		zip.remove(path);
+		const slash = path.lastIndexOf("/");
+		zip.remove(`${path.slice(0, slash + 1)}_rels/${path.slice(slash + 1)}.rels`);
+	}
+	for (const file of Object.values(zip.files)) {
+		if (file.dir || !file.name.endsWith(".rels")) continue;
+		for (const relationship of parseRelationships(await file.async("text")).values()) if (relationship.targetMode !== "External") retiredMedia.delete(resolveRelativePath(file.name, relationship.target));
+	}
+	for (const path of retiredMedia) {
+		zip.remove(path);
+		candidates.add(path);
+	}
+	const contentTypes = zip.file("[Content_Types].xml");
+	if (!contentTypes) return panic("The package has no content types");
+	const contentTypesXml = await contentTypes.async("text");
+	zip.file("[Content_Types].xml", withoutChildren(contentTypesXml, (child) => getNamespaceUri(child) === OOXML_NS.ct && getLocalName(child.name) === "Override" && candidates.has((getAttribute(child, null, "PartName") ?? "").replace(/^\//u, ""))), {
+		compression: "DEFLATE",
+		compressionOptions
+	});
+};
+//#endregion
+export { removeResolvedHeaderFooterParts };

package/dist/docx/rezip.d.ts

@@ -15,6 +15,8 @@ declare function findMaxRId(relsXml: string): number;
  * These are newly created hyperlinks that need relationship entries.
  */
 declare function collectHyperlinksWithoutRId(blocks: BlockContent[]): Hyperlink[];
+/** The selective save boundary must use the same resource census as full repack. */
+declare const hasUnmaterializedInlineResources: (blocks: BlockContent[]) => boolean;
 /**
  * Options for repacking DOCX
  */
@@ -197,4 +199,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, collectHyperlinksWithoutRId, createDocx, createEmptyDocx, findMaxRId, hasModelDrivenPictureWatermark, hasUnmaterializedHeaderFooter, isDocxBuffer, notePartRelsPath, removeCommentsExtendedOverride, removeCommentsExtendedRelationship, repackDocx, repackDocxFromRaw, updateCoreProperties, updateDocumentXml, updateMultipleFiles, updateXmlFile, validateDocx, withoutAttachedTemplate };
+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, hasUnmaterializedInlineResources, isDocxBuffer, notePartRelsPath, removeCommentsExtendedOverride, removeCommentsExtendedRelationship, repackDocx, repackDocxFromRaw, updateCoreProperties, updateDocumentXml, updateMultipleFiles, updateXmlFile, validateDocx, withoutAttachedTemplate };