@stll/folio-core 0.54.2 → 0.55.0

package/dist/docx/paragraphPropertySource.js

@@ -1,11 +1,28 @@
 import { modelParagraphFormattingEmission } from "../internal/paragraphFormattingSerialization.js";
 import { canonicalJson } from "../utils/canonicalJson.js";
+import { copyHeaderFooterPackageBaselines } from "./headerFooterVerbatim.js";
 import { visitDocxParagraphs } from "./paragraphTraversal.js";
 import { TaggedError, panic } from "better-result";
 import { PluginKey } from "prosemirror-state";
 //#region src/docx/paragraphPropertySource.ts
 const paragraphPropertySourceEmissionFingerprint = Symbol("paragraphPropertySourceEmissionFingerprint");
-const paragraphPropertySources = /* @__PURE__ */ new WeakMap();
+const paragraphPropertyCapture = Symbol("paragraphPropertyCapture");
+const paragraphPropertyCaptures = /* @__PURE__ */ new WeakMap();
+const paragraphSourceRecordKinds = /* @__PURE__ */ new WeakMap();
+const captureForParagraph = (paragraph) => {
+	const handle = Object.getOwnPropertyDescriptor(paragraph, paragraphPropertyCapture)?.value;
+	if (!Object.hasOwn(paragraph, paragraphPropertyCapture)) return paragraphPropertyCaptures.get(paragraph);
+	return typeof handle === "object" && handle !== null ? paragraphPropertyCaptures.get(handle) : void 0;
+};
+const attachParagraphCapture = (paragraph, capture) => {
+	const handle = Object.freeze({});
+	paragraphPropertyCaptures.set(handle, capture);
+	Object.defineProperty(paragraph, paragraphPropertyCapture, {
+		value: handle,
+		enumerable: true,
+		configurable: true
+	});
+};
 const paragraphFormattingEmissionFingerprint = (emission) => canonicalJson(emission);
 const ownedParagraphPropertySource = (paragraph, xml) => {
 	return Object.freeze({
@@ -13,7 +30,6 @@ const ownedParagraphPropertySource = (paragraph, xml) => {
 		[paragraphPropertySourceEmissionFingerprint]: paragraphFormattingEmissionFingerprint(modelParagraphFormattingEmission(paragraph.formatting))
 	});
 };
-const paragraphPropertySourceOwners = /* @__PURE__ */ new WeakMap();
 const proseParagraphSourceOwners = /* @__PURE__ */ new WeakMap();
 const paragraphPropertySourceCandidates = /* @__PURE__ */ new WeakMap();
 const paragraphPropertySourceTransferIds = /* @__PURE__ */ new WeakMap();
@@ -91,19 +107,23 @@ const visitDocumentStoryParagraphs = (content, visit) => {
 	visitDocxParagraphs({ documentBody: { content } }, visit);
 };
 const assignParagraphPropertySource = (paragraph, xml) => {
-	paragraphPropertySources.set(paragraph, ownedParagraphPropertySource(paragraph, xml));
-	paragraphPropertySourceOwners.set(paragraph, paragraph);
+	attachParagraphCapture(paragraph, {
+		source: ownedParagraphPropertySource(paragraph, xml),
+		owner: paragraph
+	});
 };
-const getParagraphPropertySource = (paragraph) => paragraphPropertySources.get(paragraph);
+const getParagraphPropertySource = (paragraph) => captureForParagraph(paragraph)?.source;
 const paragraphPropertySourceMatchesEmission = (source, emission) => source[paragraphPropertySourceEmissionFingerprint] === paragraphFormattingEmissionFingerprint(emission);
 /** Copy the captured `w:pPr` without claiming the source paragraph's durable identity. */
 const copyParagraphPropertyCapture = (target, source) => {
-	const propertySource = paragraphPropertySources.get(source);
-	if (propertySource) {
-		const copiedSource = Object.freeze({ ...propertySource });
-		paragraphPropertySources.set(target, copiedSource);
-		paragraphPropertySourceOwners.set(target, paragraphPropertySourceOwners.get(source) ?? source);
-	}
+	const capture = captureForParagraph(source);
+	if (capture) attachParagraphCapture(target, capture);
+	const kind = paragraphPropertySourceTokens.has(source) || paragraphSourceRecordKinds.get(source) === "durable" ? "durable" : "capture-only";
+	if (!paragraphSourceRecordKinds.has(target)) paragraphSourceRecordKinds.set(target, kind);
+};
+const copyParagraphCaptureForTransport = (target, source) => {
+	const capture = captureForParagraph(source);
+	if (capture) paragraphPropertyCaptures.set(target, capture);
 };
 const copyParagraphPropertySource = (target, source) => {
 	copyParagraphPropertyCapture(target, source);
@@ -122,6 +142,7 @@ const assignDocumentParagraphPropertySourceContract = (document, sourceDigest) =
 	visitDocumentStoryParagraphs(document.package.document.content, (paragraph) => {
 		const token = tokenForOrdinal(contract, ordinal);
 		paragraphPropertySourceTokens.set(paragraph, token);
+		paragraphSourceRecordKinds.set(paragraph, "durable");
 		sources.set(token, paragraph);
 		ordinal += 1;
 	});
@@ -144,7 +165,7 @@ const copyDocumentParagraphPropertySources = (document) => {
 	return sources ? new Map(sources) : void 0;
 };
 const paragraphPropertySourceBelongsToDocument = (paragraph, document) => {
-	const owner = paragraphPropertySourceOwners.get(paragraph);
+	const owner = captureForParagraph(paragraph)?.owner;
 	const binding = getDocumentParagraphPropertySourceBinding(document);
 	return owner !== void 0 && binding !== void 0 && binding.sourceOwners.has(owner);
 };
@@ -158,6 +179,26 @@ const copyDocumentParagraphPropertySourceContract = (target, source) => {
 	if (binding) setDocumentParagraphPropertySourceBinding(target, binding);
 };
 const getParagraphPropertySourceToken = (paragraph) => paragraphPropertySourceTokens.get(paragraph);
+/** Byte captures can follow derivations; only explicit copies carry durable tokens. */
+const inspectParagraphSourceIdentity = (paragraph, document) => {
+	const binding = getDocumentParagraphPropertySourceBinding(document);
+	if (!binding) return { type: "invalid" };
+	const capture = captureForParagraph(paragraph);
+	if (Object.hasOwn(paragraph, paragraphPropertyCapture) && !capture) return { type: "invalid" };
+	const token = getParagraphPropertySourceToken(paragraph);
+	if (token !== void 0) {
+		if (capture && !binding.sourceOwners.has(capture.owner)) return { type: "invalid" };
+		return {
+			type: "durable",
+			token
+		};
+	}
+	const kind = paragraphSourceRecordKinds.get(paragraph);
+	if (kind === "durable" || binding.sourceOwners.has(paragraph)) return { type: "missing-token" };
+	if (!capture) return { type: "authored" };
+	if (kind === "capture-only" || binding.sourceOwners.has(capture.owner)) return { type: "capture-only" };
+	return { type: "invalid" };
+};
 /** Clone a paragraph while deliberately retaining its parsed `w:pPr` owner. */
 const cloneParagraphWithPropertySource = (paragraph, overrides) => {
 	const cloned = {
@@ -168,10 +209,14 @@ const cloneParagraphWithPropertySource = (paragraph, overrides) => {
 	return cloned;
 };
 /** Clone a paragraph whose formatting provenance is deliberately no longer applicable. */
-const cloneParagraphWithoutPropertySource = (paragraph, overrides) => ({
-	...paragraph,
-	...overrides
-});
+const cloneParagraphWithoutPropertySource = (paragraph, overrides) => {
+	const cloned = {
+		...paragraph,
+		...overrides
+	};
+	Reflect.deleteProperty(cloned, paragraphPropertyCapture);
+	return cloned;
+};
 const paragraphsIn = (document) => {
 	const paragraphs = [];
 	visitDocxParagraphs({
@@ -199,6 +244,7 @@ const cloneDocumentWithParagraphPropertySources = (document) => {
 		copyParagraphPropertySource(target, source);
 	}
 	copyDocumentParagraphPropertySourceContract(cloned, document);
+	copyHeaderFooterPackageBaselines(cloned, document);
 	return cloned;
 };
 const paragraphsInTableCells = (cells) => {
@@ -299,6 +345,7 @@ const tableCellRunContentTraversalByType = {
 	footnoteRef: "leaf",
 	instrText: "leaf",
 	noBreakHyphen: "leaf",
+	noteMarker: "leaf",
 	preservedXml: "leaf",
 	renderedPageBreak: "leaf",
 	shape: "shape",
@@ -549,7 +596,7 @@ const transportTableCellsWithParagraphPropertySources = (cells) => {
 	for (const [index, source] of sources.entries()) {
 		const target = targets.at(index);
 		if (!target) panic("The cloned table cells lost a paragraph owner.");
-		copyParagraphPropertyCapture(target, source);
+		copyParagraphCaptureForTransport(target, source);
 		const inspection = inspectTableCellParagraphPropertySourceBinding(source);
 		setTableCellParagraphPropertySourceBinding(target, tableCellParagraphPropertySourceBindingForTransport(source, inspection));
 	}
@@ -568,8 +615,11 @@ const restoreTableCellsWithParagraphPropertySources = (payload) => {
 		copyParagraphPropertyCapture(target, source);
 		if (!Reflect.deleteProperty(target, "_docxParagraphSourceBinding")) panic("Cannot detach paragraph-property transport identity from a table cell.");
 		switch (sourceEntry.binding.type) {
-			case "authored": break;
+			case "authored":
+				paragraphSourceRecordKinds.set(target, "capture-only");
+				break;
 			case "source":
+				paragraphSourceRecordKinds.set(target, "durable");
 				paragraphPropertySourceTokens.set(target, sourceEntry.binding.token);
 				break;
 			default: return sourceEntry.binding;
@@ -593,13 +643,14 @@ const cloneTableCellsWithParagraphPropertyCaptures = (payload) => {
 	for (const [index, sourceEntry] of sourceEntries.entries()) {
 		const target = targets.at(index);
 		if (!target) panic("The cloned table cells lost a paragraph owner.");
-		copyParagraphPropertyCapture(target, sourceEntry.paragraph);
+		copyParagraphCaptureForTransport(target, sourceEntry.paragraph);
 		setTableCellParagraphPropertySourceBinding(target, { type: "authored" });
 	}
 	return cloned;
 };
 const linkProseParagraphPropertySource = (proseParagraph, sourceParagraph) => {
-	if (paragraphPropertySources.has(sourceParagraph)) proseParagraphSourceOwners.set(proseParagraph, paragraphPropertySourceOwners.get(sourceParagraph) ?? sourceParagraph);
+	const capture = captureForParagraph(sourceParagraph);
+	if (capture) proseParagraphSourceOwners.set(proseParagraph, capture.owner);
 };
 /** Create a parsed paragraph with both its same-process owner and durable body token. */
 const createProseParagraphWithPropertySource = (nodeType, sourceParagraph, options = {}) => {
@@ -704,11 +755,14 @@ const transferProseParagraphPropertySource = (target, source, paraId) => {
 };
 const linkParagraphPropertySourceCandidate = (target, source) => {
 	const token = source.attrs[PROSE_PARAGRAPH_SOURCE_TOKEN_ATTR];
-	if (typeof token === "string") paragraphPropertySourceTokens.set(target, token);
+	if (typeof token === "string") {
+		paragraphPropertySourceTokens.set(target, token);
+		paragraphSourceRecordKinds.set(target, "durable");
+	} else paragraphSourceRecordKinds.set(target, "capture-only");
 	const sourceOwner = proseParagraphSourceOwners.get(source);
 	if (sourceOwner) paragraphPropertySourceCandidates.set(target, sourceOwner);
 };
 const getParagraphPropertySourceCandidate = (paragraph) => paragraphPropertySourceCandidates.get(paragraph);
 const getParagraphPropertySourceTransferId = (paragraph) => paragraphPropertySourceTransferIds.get(paragraph);
 //#endregion
-export { PARAGRAPH_PROPERTY_SOURCE_VALIDATION_CODES, PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR, PROSE_PARAGRAPH_SOURCE_TOKEN_ATTR, ParagraphPropertySourceValidationError, TABLE_CELL_PARAGRAPH_SOURCE_BINDING_ATTR, TABLE_CELL_PARAGRAPH_SOURCE_PAYLOAD_ERROR_CLASSIFICATIONS, assignDocumentParagraphPropertySourceContract, assignParagraphPropertySource, cloneDocumentWithParagraphPropertySources, cloneParagraphWithPropertySource, cloneParagraphWithoutPropertySource, cloneTableCellsWithParagraphPropertyCaptures, copyDocumentParagraphPropertySourceContract, copyDocumentParagraphPropertySources, copyParagraphPropertyCapture, copyParagraphPropertySource, createProseParagraphWithPropertySource, decodeTableCellParagraphSourcePayload, getDocumentParagraphPropertySourceContract, getExplicitParagraphPropertySourceTransfers, getParagraphPropertySource, getParagraphPropertySourceCandidate, getParagraphPropertySourceToken, getParagraphPropertySourceTransferId, getProseDocumentParagraphPropertySourceContract, getProseParagraphPropertySourceToken, isParagraphPropertySourceToken, joinProseParagraphsWithRightPropertySource, linkParagraphPropertySourceCandidate, linkProseParagraphPropertySource, markParagraphPropertySourceTransfers, paragraphPropertySourceBelongsToDocument, paragraphPropertySourceMatchesEmission, paragraphPropertySourceTokenMatchesContract, proseParagraphAttrsWithoutPropertySource, recreateProseNodeWithDetachedParagraphPropertySource, recreateProseNodeWithParagraphPropertySource, restoreTableCellsWithParagraphPropertySources, setProseParagraphMarkupWithPropertySource, transferProseParagraphPropertySource, transportTableCellsWithParagraphPropertySources, visitDocumentStoryParagraphs, visitTableCellParagraphPropertySourceBindings };
+export { PARAGRAPH_PROPERTY_SOURCE_VALIDATION_CODES, PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR, PROSE_PARAGRAPH_SOURCE_TOKEN_ATTR, ParagraphPropertySourceValidationError, TABLE_CELL_PARAGRAPH_SOURCE_BINDING_ATTR, TABLE_CELL_PARAGRAPH_SOURCE_PAYLOAD_ERROR_CLASSIFICATIONS, assignDocumentParagraphPropertySourceContract, assignParagraphPropertySource, cloneDocumentWithParagraphPropertySources, cloneParagraphWithPropertySource, cloneParagraphWithoutPropertySource, cloneTableCellsWithParagraphPropertyCaptures, copyDocumentParagraphPropertySourceContract, copyDocumentParagraphPropertySources, copyParagraphPropertyCapture, copyParagraphPropertySource, createProseParagraphWithPropertySource, decodeTableCellParagraphSourcePayload, getDocumentParagraphPropertySourceContract, getExplicitParagraphPropertySourceTransfers, getParagraphPropertySource, getParagraphPropertySourceCandidate, getParagraphPropertySourceToken, getParagraphPropertySourceTransferId, getProseDocumentParagraphPropertySourceContract, getProseParagraphPropertySourceToken, inspectParagraphSourceIdentity, isParagraphPropertySourceToken, joinProseParagraphsWithRightPropertySource, linkParagraphPropertySourceCandidate, linkProseParagraphPropertySource, markParagraphPropertySourceTransfers, paragraphPropertySourceBelongsToDocument, paragraphPropertySourceMatchesEmission, paragraphPropertySourceTokenMatchesContract, proseParagraphAttrsWithoutPropertySource, recreateProseNodeWithDetachedParagraphPropertySource, recreateProseNodeWithParagraphPropertySource, restoreTableCellsWithParagraphPropertySources, setProseParagraphMarkupWithPropertySource, transferProseParagraphPropertySource, transportTableCellsWithParagraphPropertySources, visitDocumentStoryParagraphs, visitTableCellParagraphPropertySourceBindings };

package/dist/docx/parser.js

@@ -15,7 +15,7 @@ import { parseFontTable } from "./fontTableParser.js";
 import { parseEndnotes, parseFootnotes } from "./footnoteParser.js";
 import { parseFooter, parseHeader } from "./headerFooterParser.js";
 import { DANGLING_FOOTER_REFERENCE_WARNING, DANGLING_HEADER_REFERENCE_WARNING, assignHeaderFooterRoles, normalizeHeaderFooterReferences } from "./headerFooterReferenceNormalization.js";
-import { assignHeaderFooterVerbatimXml, canReplayHeaderFooterVerbatim, refreshHeaderFooterVerbatimFingerprint } from "./headerFooterVerbatim.js";
+import { assignHeaderFooterVerbatimXml, canReplayHeaderFooterVerbatim, captureHeaderFooterPackageBaselines, refreshHeaderFooterVerbatimFingerprint } from "./headerFooterVerbatim.js";
 import { extractMetafileRaster, isMetafileMimeType } from "./metafileRaster.js";
 import { renderEmfSvg } from "./metafileSvg.js";
 import { DocxModelValidationError, formatDocumentModelIssues, validateFolioDocumentModel } from "./modelValidation.js";
@@ -473,6 +473,7 @@ async function parseDocxWithPreviewBudget(input, options, previewBudget) {
 			document.warnings = formatParseWarnings(parseWarnings);
 		}
 		onProgress("Complete", 100);
+		captureHeaderFooterPackageBaselines(document);
 		return document;
 	} catch (error) {
 		if (error instanceof DocxEncryptionError) throw error;

package/dist/docx/reviewHistoryNamespace.d.ts

@@ -0,0 +1,4 @@
+//#region src/docx/reviewHistoryNamespace.d.ts
+declare const FOLIO_REVIEW_HISTORY_NAMESPACE = "urn:stella:folio:review-history:1";
+//#endregion
+export { FOLIO_REVIEW_HISTORY_NAMESPACE };

package/dist/docx/reviewHistoryNamespace.js

@@ -0,0 +1,4 @@
+//#region src/docx/reviewHistoryNamespace.ts
+const FOLIO_REVIEW_HISTORY_NAMESPACE = "urn:stella:folio:review-history:1";
+//#endregion
+export { FOLIO_REVIEW_HISTORY_NAMESPACE };

package/dist/docx/reviewResolutionProvenance.d.ts

@@ -0,0 +1,25 @@
+import { document_d_exports } from "../types/document.js";
+import { XmlElement } from "./xmlParser.js";
+//#region src/docx/reviewResolutionProvenance.d.ts
+type ResolutionJoins = NonNullable<document_d_exports.Insertion["resolutionJoins"]>;
+type BoundaryJoins = NonNullable<document_d_exports.RunPropertyChange["boundaryJoins"]>;
+declare const isResolutionJoins: (value: unknown) => value is ResolutionJoins;
+declare const isParagraphMarkResolutionJoin: (value: unknown) => value is NonNullable<document_d_exports.ParagraphMarkChange["resolutionJoin"]>;
+declare const isBoundaryJoins: (value: unknown) => value is BoundaryJoins;
+declare const ReviewResolutionProvenanceError_base: import("better-result").TaggedErrorClass<"ReviewResolutionProvenanceError">;
+declare class ReviewResolutionProvenanceError extends ReviewResolutionProvenanceError_base<{
+  message: string;
+  attribute: string;
+  reason: "invalid" | "unsupportedVersion" | "unrepresentable";
+}> {}
+declare const parseResolutionJoins: (node: XmlElement) => ResolutionJoins | undefined;
+declare const parseBoundaryJoins: (node: XmlElement) => BoundaryJoins | undefined;
+declare const serializeResolutionJoins: (value: document_d_exports.Insertion["resolutionJoins"]) => string;
+declare const serializeBoundaryJoins: (value: document_d_exports.RunPropertyChange["boundaryJoins"]) => string;
+/** Null carries an owned undefined depth; a missing attribute carries no field. */
+declare const parseParagraphMarkResolutionJoin: (node: XmlElement) => Pick<document_d_exports.ParagraphMarkChange, "resolutionJoin">;
+declare const serializeParagraphMarkResolutionJoin: (mark: document_d_exports.ParagraphMarkChange) => string;
+/** Captured paragraph properties compose the same envelope into a parsed XML element. */
+declare const paragraphMarkResolutionJoinAttributes: (mark: document_d_exports.ParagraphMarkChange) => Record<string, string>;
+//#endregion
+export { ReviewResolutionProvenanceError, isBoundaryJoins, isParagraphMarkResolutionJoin, isResolutionJoins, paragraphMarkResolutionJoinAttributes, parseBoundaryJoins, parseParagraphMarkResolutionJoin, parseResolutionJoins, serializeBoundaryJoins, serializeParagraphMarkResolutionJoin, serializeResolutionJoins };

package/dist/docx/reviewResolutionProvenance.js

@@ -0,0 +1,153 @@
+import { FOLIO_REVIEW_HISTORY_NAMESPACE } from "./reviewHistoryNamespace.js";
+import { getAttributeByNamespaceUri } from "./xmlParser.js";
+import { Result, TaggedError } from "better-result";
+import { escapeXmlAttribute } from "@stll/docx-core";
+import { MAX_REVISION_ID } from "@stll/docx-core/model";
+//#region src/docx/reviewResolutionProvenance.ts
+const NAMESPACES = /* @__PURE__ */ new Set([FOLIO_REVIEW_HISTORY_NAMESPACE]);
+const VERSION = 1;
+const MAX_ATTRIBUTE_LENGTH = 32768;
+const SLOT_FIELDS = {
+	space: true,
+	id: true
+};
+const RETAINED_FIELDS = {
+	depth: true,
+	source: true,
+	target: true
+};
+const JOIN_FIELDS = {
+	before: true,
+	after: true,
+	remove: true,
+	retainedAfter: true,
+	deferredRemove: true,
+	acceptance: true
+};
+const ACCEPTANCE_POLICIES = { "merge-plain-runs": true };
+const PARAGRAPH_MARK_FIELDS = {
+	kind: { type: "ooxml" },
+	info: { type: "ooxml" },
+	resolutionJoin: {
+		type: "private",
+		attribute: "resolutionJoin"
+	}
+};
+const DEFERRED_REMOVAL_FIELDS = {
+	depth: true,
+	blockers: true
+};
+const record = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const natural = (value) => typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+const slots = (value) => Array.isArray(value) && value.every((slot) => record(slot) && Object.keys(slot).every((key) => Object.hasOwn(SLOT_FIELDS, key)) && (slot["space"] === "revision" || slot["space"] === "control") && natural(slot["id"]) && slot["id"] <= MAX_REVISION_ID);
+const retained = (value) => Array.isArray(value) && value.every((item) => {
+	if (!record(item)) return false;
+	const source = item["source"];
+	const target = item["target"];
+	return Object.keys(item).every((key) => Object.hasOwn(RETAINED_FIELDS, key)) && natural(item["depth"]) && slots(source) && slots(target) && source.length === target.length && source.every((slot, index) => slot.space === target.at(index)?.space);
+});
+const deferredRemoval = (value) => {
+	if (!record(value) || Object.keys(value).some((key) => !Object.hasOwn(DEFERRED_REMOVAL_FIELDS, key))) return false;
+	const depth = value["depth"];
+	const blockers = value["blockers"];
+	return natural(depth) && depth <= MAX_REVISION_ID && Array.isArray(blockers) && blockers.length > 0 && !blockers.includes(void 0) && new Set(blockers).size === blockers.length && blockers.every((blocker) => natural(blocker) && blocker <= MAX_REVISION_ID);
+};
+const deferredRemovals = (value) => {
+	if (!Array.isArray(value) || value.length === 0 || value.includes(void 0) || !value.every(deferredRemoval)) return false;
+	const groups = value.map(({ depth, blockers }) => JSON.stringify({
+		depth,
+		blockers
+	}));
+	return new Set(groups).size === groups.length;
+};
+const isResolutionJoins = (value) => record(value) && Object.keys(value).every((key) => Object.hasOwn(JOIN_FIELDS, key)) && natural(value["before"]) && natural(value["after"]) && natural(value["remove"]) && (!Object.hasOwn(value, "acceptance") || typeof value["acceptance"] === "string" && Object.hasOwn(ACCEPTANCE_POLICIES, value["acceptance"])) && (value["retainedAfter"] === void 0 || retained(value["retainedAfter"])) && (!Object.hasOwn(value, "deferredRemove") || deferredRemovals(value["deferredRemove"]));
+const isParagraphMarkResolutionJoin = (value) => natural(value) && value <= MAX_REVISION_ID;
+const isEncodedParagraphMarkResolutionJoin = (value) => value === null || isParagraphMarkResolutionJoin(value);
+const isBoundaryJoins = (value) => Array.isArray(value) && value.length <= 2 && new Set(value).size === value.length && value.every((side) => side === "before" || side === "after");
+var ReviewResolutionProvenanceError = class extends TaggedError("ReviewResolutionProvenanceError") {};
+const parseAttribute = ({ node, attribute, valid }) => {
+	const encoded = getAttributeByNamespaceUri(node, NAMESPACES, attribute);
+	if (encoded === null) return void 0;
+	const failed = (reason = "invalid") => new ReviewResolutionProvenanceError({
+		attribute,
+		message: `Invalid or unsupported ${attribute} review provenance.`,
+		reason
+	});
+	if (encoded.length > MAX_ATTRIBUTE_LENGTH) throw failed();
+	const parsed = Result.try({
+		try: () => JSON.parse(encoded),
+		catch: () => failed()
+	});
+	if (parsed.isErr()) throw parsed.error;
+	const decoded = parsed.value;
+	if (!record(decoded) || Object.keys(decoded).some((key) => key !== "version" && key !== "value")) throw failed();
+	const value = decoded["value"];
+	if (!valid(value)) throw failed();
+	if (decoded["version"] !== VERSION) throw failed("unsupportedVersion");
+	return value;
+};
+const encodeAttribute = ({ attribute, value, valid }) => {
+	if (value === void 0) return void 0;
+	if (!valid(value)) throw new ReviewResolutionProvenanceError({
+		attribute,
+		reason: "invalid",
+		message: `Invalid or oversized ${attribute} review provenance.`
+	});
+	const encoded = JSON.stringify({
+		version: VERSION,
+		value
+	});
+	if (encoded.length > MAX_ATTRIBUTE_LENGTH) throw new ReviewResolutionProvenanceError({
+		attribute,
+		reason: "invalid",
+		message: `Oversized ${attribute} review provenance.`
+	});
+	return encoded;
+};
+const serializeAttribute = (options) => {
+	const encoded = encodeAttribute(options);
+	return encoded === void 0 ? "" : ` folio:${options.attribute}="${escapeXmlAttribute(encoded)}"`;
+};
+const parseResolutionJoins = (node) => parseAttribute({
+	node,
+	attribute: "resolutionJoins",
+	valid: isResolutionJoins
+});
+const parseBoundaryJoins = (node) => parseAttribute({
+	node,
+	attribute: "boundaryJoins",
+	valid: isBoundaryJoins
+});
+const serializeResolutionJoins = (value) => serializeAttribute({
+	attribute: "resolutionJoins",
+	value,
+	valid: isResolutionJoins
+});
+const serializeBoundaryJoins = (value) => serializeAttribute({
+	attribute: "boundaryJoins",
+	value,
+	valid: isBoundaryJoins
+});
+/** Null carries an owned undefined depth; a missing attribute carries no field. */
+const parseParagraphMarkResolutionJoin = (node) => {
+	const value = parseAttribute({
+		node,
+		attribute: PARAGRAPH_MARK_FIELDS.resolutionJoin.attribute,
+		valid: isEncodedParagraphMarkResolutionJoin
+	});
+	return value === void 0 ? {} : { resolutionJoin: value === null ? void 0 : value };
+};
+const paragraphMarkResolutionJoinOptions = (mark) => ({
+	attribute: PARAGRAPH_MARK_FIELDS.resolutionJoin.attribute,
+	value: Object.hasOwn(mark, "resolutionJoin") ? mark.resolutionJoin ?? null : void 0,
+	valid: isEncodedParagraphMarkResolutionJoin
+});
+const serializeParagraphMarkResolutionJoin = (mark) => serializeAttribute(paragraphMarkResolutionJoinOptions(mark));
+/** Captured paragraph properties compose the same envelope into a parsed XML element. */
+const paragraphMarkResolutionJoinAttributes = (mark) => {
+	const options = paragraphMarkResolutionJoinOptions(mark);
+	const encoded = encodeAttribute(options);
+	return encoded === void 0 ? {} : { [`folio:${options.attribute}`]: encoded };
+};
+//#endregion
+export { ReviewResolutionProvenanceError, isBoundaryJoins, isParagraphMarkResolutionJoin, isResolutionJoins, paragraphMarkResolutionJoinAttributes, parseBoundaryJoins, parseParagraphMarkResolutionJoin, parseResolutionJoins, serializeBoundaryJoins, serializeParagraphMarkResolutionJoin, serializeResolutionJoins };

package/dist/docx/rezip.d.ts

@@ -1,4 +1,5 @@
 import { document_d_exports } from "../types/document.js";
+import { SaveDiagnosticOptions } from "./saveDiagnostics.js";
 import { BlockContent, Hyperlink } from "../types/content.js";
 import { RawDocxContent } from "./unzip.js";
 import JSZip from "jszip";
@@ -46,7 +47,7 @@ declare const hasUnmaterializedInlineResources: (blocks: BlockContent[]) => bool
 /**
  * Options for repacking DOCX
  */
-type RepackOptions = {
+type RepackOptions = SaveDiagnosticOptions & {
   /** Compression level (0-9, default: 6) */
   compressionLevel?: number;
   /** Whether to update modification date in docProps/core.xml */
@@ -185,7 +186,10 @@ declare function hasModelDrivenPictureWatermark(doc: document_d_exports.Document
  * `sourceZip` supplies each part as it stands before the save so the rebuilt
  * root can keep any prefix binding only the source document declared.
  */
-declare function collectHeaderFooterUpdates(doc: document_d_exports.Document, sourceZip: JSZip): Promise<Map<string, string>>;
+type CollectHeaderFooterUpdatesOptions = SaveDiagnosticOptions & {
+  sourceZip: JSZip;
+};
+declare function collectHeaderFooterUpdates(doc: document_d_exports.Document, { sourceZip, onDiagnostic }: CollectHeaderFooterUpdatesOptions): Promise<Map<string, string>>;
 /** `word/Footnotes.xml` -> `word/_rels/Footnotes.xml.rels` (casing preserved). */
 declare function notePartRelsPath(partPath: string): string;
 /** Update existing core-property values without synthesizing absent metadata. */
@@ -219,7 +223,7 @@ declare function isDocxBuffer(buffer: ArrayBuffer): boolean;
  * ignored for a document that carries a source package, which keeps the
  * properties that package already states.
  */
-type DocumentPropertiesOptions = {
+type DocumentPropertiesOptions = SaveDiagnosticOptions & {
   /** `dc:creator` in `docProps/core.xml`. Omitted when absent. */
   creator?: string;
   /** `Application` in `docProps/app.xml`. Omitted, with `AppVersion`, when absent. */