@stll/folio-core 0.55.0 → 0.56.0

package/dist/docx/headerFooterVerbatim.js

@@ -15,7 +15,7 @@ const readFingerprint = (hf) => {
 	});
 	return value;
 };
-const BASELINE_HANDLE = Symbol("header-footer-source-baseline");
+const BASELINE_HANDLE = Symbol("package-source-baseline");
 const contentBaselines = /* @__PURE__ */ new WeakMap();
 const captureContentBaseline = (hf) => {
 	const fingerprint = hf.verbatimFingerprint;
@@ -23,6 +23,7 @@ const captureContentBaseline = (hf) => {
 	const handle = {};
 	const content = structuredClone(hf.content);
 	contentBaselines.set(handle, {
+		type: "headerFooter",
 		fingerprint,
 		xml: hf.verbatimXml,
 		contentFingerprint: canonicalJson(content),
@@ -46,6 +47,33 @@ const captureHeaderFooterPackageBaselines = (document) => {
 	}
 	packageBaselines.set(document.originalBuffer, handles);
 };
+/**
+* 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.
+*/
+const copyHeaderFooterBaselineHandles = (target, source) => {
+	const sourceBody = source.package.document;
+	if (BASELINE_HANDLE in sourceBody) Object.defineProperty(target.package.document, BASELINE_HANDLE, {
+		value: sourceBody[BASELINE_HANDLE],
+		enumerable: true,
+		configurable: true
+	});
+	for (const kind of ["headers", "footers"]) {
+		const targets = target.package[kind];
+		for (const [rId, sourcePart] of source.package[kind] ?? []) {
+			if (!(BASELINE_HANDLE in sourcePart)) continue;
+			const targetPart = targets?.get(rId);
+			if (!targetPart) continue;
+			Object.defineProperty(targetPart, BASELINE_HANDLE, {
+				value: sourcePart[BASELINE_HANDLE],
+				enumerable: true,
+				configurable: true
+			});
+		}
+	}
+};
 /** Transfer the parsed package registry only across a trusted document graph clone. */
 const copyHeaderFooterPackageBaselines = (target, source) => {
 	if (!target.originalBuffer || !source.originalBuffer) return;
@@ -59,7 +87,7 @@ const getHeaderFooterSourceBaseline = (hf, originalBuffer) => {
 	if (handle === void 0 && !(BASELINE_HANDLE in hf)) return { type: "missing" };
 	if (typeof handle !== "object" || handle === null) return { type: "mismatch" };
 	const baseline = contentBaselines.get(handle);
-	if (!baseline || baseline.fingerprint !== hf.verbatimFingerprint || baseline.xml !== hf.verbatimXml || baseline.contentFingerprint !== canonicalJson(baseline.content)) return { type: "mismatch" };
+	if (!baseline || baseline.type !== "headerFooter" || baseline.fingerprint !== hf.verbatimFingerprint || baseline.xml !== hf.verbatimXml || baseline.contentFingerprint !== canonicalJson(baseline.content)) return { type: "mismatch" };
 	return {
 		type: "captured",
 		content: baseline.content
@@ -119,5 +147,55 @@ const clearHeaderFooterVerbatimXml = (hf) => {
 	delete ext.verbatimFingerprint;
 	Reflect.deleteProperty(hf, BASELINE_HANDLE);
 };
+/** Capture the body in the same trusted package registry as secondary stories. */
+const captureDocumentSourceBaseline = (document, xml) => {
+	const body = structuredClone(document.package.document);
+	const handle = {};
+	contentBaselines.set(handle, {
+		type: "body",
+		fingerprint: { type: "pending" },
+		xml,
+		body,
+		resourceStyles: structuredClone(document.package.styles),
+		resourceRelationships: structuredClone(document.package.relationships),
+		resourceMedia: new Map([...document.package.media ?? []].map(([path, media]) => [path, {
+			data: media.data,
+			mimeType: media.mimeType
+		}]))
+	});
+	Object.defineProperty(document.package.document, BASELINE_HANDLE, {
+		value: handle,
+		enumerable: true,
+		configurable: true
+	});
+	if (document.originalBuffer) {
+		const registry = packageBaselines.get(document.originalBuffer) ?? /* @__PURE__ */ new Map();
+		registry.set("word/document.xml", /* @__PURE__ */ new Map([["body", handle]]));
+		packageBaselines.set(document.originalBuffer, registry);
+	}
+};
+const getDocumentSourceBaseline = (document) => {
+	const body = document.package.document;
+	const handle = BASELINE_HANDLE in body ? body[BASELINE_HANDLE] : document.originalBuffer && packageBaselines.get(document.originalBuffer)?.get("word/document.xml")?.get("body");
+	if (handle === void 0) return { type: "missing" };
+	if (typeof handle !== "object" || handle === null) return { type: "mismatch" };
+	const baseline = contentBaselines.get(handle);
+	if (!baseline || baseline.type !== "body") return { type: "mismatch" };
+	const fingerprint = JSON.stringify(baseline.body);
+	if (baseline.fingerprint.type === "pending") baseline.fingerprint = {
+		type: "captured",
+		value: fingerprint
+	};
+	if (baseline.fingerprint.value !== fingerprint) return { type: "mismatch" };
+	return {
+		type: "captured",
+		body: baseline.body,
+		xml: baseline.xml,
+		fingerprint,
+		resourceStyles: baseline.resourceStyles,
+		resourceRelationships: baseline.resourceRelationships,
+		resourceMedia: baseline.resourceMedia
+	};
+};
 //#endregion
-export { assignHeaderFooterVerbatimXml, canReplayHeaderFooterBlocks, canReplayHeaderFooterVerbatim, captureHeaderFooterPackageBaselines, clearHeaderFooterVerbatimXml, copyHeaderFooterPackageBaselines, getHeaderFooterSourceBaseline, getHeaderFooterVerbatimXml, refreshHeaderFooterVerbatimFingerprint };
+export { assignHeaderFooterVerbatimXml, canReplayHeaderFooterBlocks, canReplayHeaderFooterVerbatim, captureDocumentSourceBaseline, captureHeaderFooterPackageBaselines, clearHeaderFooterVerbatimXml, copyHeaderFooterBaselineHandles, copyHeaderFooterPackageBaselines, getDocumentSourceBaseline, getHeaderFooterSourceBaseline, getHeaderFooterVerbatimXml, refreshHeaderFooterVerbatimFingerprint };

package/dist/docx/imageParser.d.ts

@@ -22,6 +22,18 @@ declare function resolveImageData(rId: string | undefined, rels: document_d_expo
   mimeType?: string;
   filename?: string;
 };
+type ImageDerivedFactsOptions = {
+  id: string | undefined;
+  pictureNames: NonNullable<document_d_exports.Image["pictureNames"]>;
+  imageData: ReturnType<typeof resolveImageData>;
+};
+/** Facts the parser obtains from exported drawing markup and image relationships. */
+declare const imageDerivedFactsOf: ({ id, pictureNames, imageData }: ImageDerivedFactsOptions) => {
+  filename?: string;
+  mimeType?: string;
+  pictureNames?: import("@stll/docx-core/model").NonVisualDrawingNames;
+  id?: string;
+};
 /**
  * Parse a w:drawing element
  *
@@ -97,4 +109,4 @@ declare function getWrapDistancesPx(image: document_d_exports.Image): {
  */
 declare function needsTextWrapping(image: document_d_exports.Image): boolean;
 //#endregion
-export { DECORATIVE_EXTENSION_URI, DECORATIVE_NAMESPACE, getImageDimensionsPx, getImageHeightPx, getImageWidthPx, getWrapDistancesPx, hasAltText, isBehindText, isDecorativeImage, isFloatingImage, isInFrontOfText, isInlineImage, needsTextWrapping, parseDrawing, parseImage, resolveImageData };
+export { DECORATIVE_EXTENSION_URI, DECORATIVE_NAMESPACE, getImageDimensionsPx, getImageHeightPx, getImageWidthPx, getWrapDistancesPx, hasAltText, imageDerivedFactsOf, isBehindText, isDecorativeImage, isFloatingImage, isInFrontOfText, isInlineImage, needsTextWrapping, parseDrawing, parseImage, resolveImageData };

package/dist/docx/imageParser.js

@@ -10,7 +10,7 @@ import { RELATIONSHIP_TYPES, resolveRelationshipIdOfType } from "./relsParser.js
 import { isTextBoxDrawing } from "./textBoxParser.js";
 import { percentageSpelling } from "./transitionalSpelling.js";
 import { captureVerbatimXml } from "./verbatimCapture.js";
-import { findByFullName, findChildByNamespaceUri, findChildrenByNamespaceUri, getAttribute, getChildElements, getLocalName, getNamespaceUri, parseNumericAttribute, parseOnOffAttribute, parseOnOffValue } from "./xmlParser.js";
+import { OFFICE_RELATIONSHIP_NAMESPACE_URIS, findAttributeByNamespaceUri, findByFullName, findChildByNamespaceUri, findChildrenByNamespaceUri, getAttribute, getChildElements, getLocalName, getNamespaceUri, parseNumericAttribute, parseOnOffAttribute, parseOnOffValue } from "./xmlParser.js";
 import { relationshipIdOf } from "@stll/docx-core/model";
 //#region src/docx/imageParser.ts
 /**
@@ -129,7 +129,7 @@ const parseDocPropsExtensions = (docPr) => {
 const parseDocPrLink = (docPr, localName) => {
 	const element = findChildByNamespaceUri(docPr, DRAWINGML_NAMESPACE_URIS, localName);
 	if (!element) return;
-	const rId = getAttribute(element, "r", "id");
+	const rId = findAttributeByNamespaceUri(element, OFFICE_RELATIONSHIP_NAMESPACE_URIS, "id")?.value;
 	return {
 		xml: captureVerbatimXml(element),
 		...rId == null ? {} : { rId }
@@ -382,6 +382,13 @@ function resolveImageData(rId, rels, media) {
 		...filename !== void 0 ? { filename } : {}
 	};
 }
+/** Facts the parser obtains from exported drawing markup and image relationships. */
+const imageDerivedFactsOf = ({ id, pictureNames, imageData }) => ({
+	...id ? { id } : {},
+	...Object.keys(pictureNames).length > 0 ? { pictureNames } : {},
+	...imageData.mimeType ? { mimeType: imageData.mimeType } : {},
+	...imageData.filename ? { filename: imageData.filename } : {}
+});
 /**
 * Parse a wp:inline element (inline image)
 *
@@ -411,18 +418,19 @@ function parseInline(inlineEl, rels, media) {
 		size,
 		wrap
 	};
-	if (props.id) image.id = props.id;
+	Object.assign(image, imageDerivedFactsOf({
+		id: props.id,
+		pictureNames,
+		imageData
+	}));
 	if (props.name !== void 0) image.docPrName = props.name;
 	if (props.alt !== void 0) image.alt = props.alt;
 	if (props.title !== void 0) image.title = props.title;
-	if (Object.keys(pictureNames).length > 0) image.pictureNames = pictureNames;
 	if (props.decorative !== void 0) image.decorative = props.decorative;
 	if (props.hidden !== void 0) image.hidden = props.hidden;
 	if (props.docPrExtensions !== void 0) image.docPrExtensions = props.docPrExtensions;
 	const safeSrc = sanitizeImageSrc(imageData.src);
 	if (safeSrc) image.src = safeSrc;
-	if (imageData.mimeType) image.mimeType = imageData.mimeType;
-	if (imageData.filename) image.filename = imageData.filename;
 	if (padding) image.padding = padding;
 	if (transform) image.transform = transform;
 	if (crop) image.crop = crop;
@@ -492,18 +500,19 @@ function parseAnchor(anchorEl, rels, media) {
 		size,
 		wrap
 	};
-	if (props.id) image.id = props.id;
+	Object.assign(image, imageDerivedFactsOf({
+		id: props.id,
+		pictureNames,
+		imageData
+	}));
 	if (props.name !== void 0) image.docPrName = props.name;
 	if (props.alt !== void 0) image.alt = props.alt;
 	if (props.title !== void 0) image.title = props.title;
-	if (Object.keys(pictureNames).length > 0) image.pictureNames = pictureNames;
 	if (props.decorative !== void 0) image.decorative = props.decorative;
 	if (props.hidden !== void 0) image.hidden = props.hidden;
 	if (props.docPrExtensions !== void 0) image.docPrExtensions = props.docPrExtensions;
 	const safeSrc = sanitizeImageSrc(imageData.src);
 	if (safeSrc) image.src = safeSrc;
-	if (imageData.mimeType) image.mimeType = imageData.mimeType;
-	if (imageData.filename) image.filename = imageData.filename;
 	if (position) image.position = position;
 	if (padding) image.padding = padding;
 	if (transform) image.transform = transform;
@@ -628,4 +637,4 @@ function needsTextWrapping(image) {
 	].includes(image.wrap.type);
 }
 //#endregion
-export { DECORATIVE_EXTENSION_URI, DECORATIVE_NAMESPACE, getImageDimensionsPx, getImageHeightPx, getImageWidthPx, getWrapDistancesPx, hasAltText, isBehindText, isDecorativeImage, isFloatingImage, isInFrontOfText, isInlineImage, needsTextWrapping, parseDrawing, parseImage, resolveImageData };
+export { DECORATIVE_EXTENSION_URI, DECORATIVE_NAMESPACE, getImageDimensionsPx, getImageHeightPx, getImageWidthPx, getWrapDistancesPx, hasAltText, imageDerivedFactsOf, isBehindText, isDecorativeImage, isFloatingImage, isInFrontOfText, isInlineImage, needsTextWrapping, parseDrawing, parseImage, resolveImageData };

package/dist/docx/metadataPrivacy.js

@@ -1,6 +1,7 @@
 import { countCentralDirectoryRecords, createInflationBudget, inflateEntryWithinLimits } from "./archiveInflation.js";
 import { elementToXml, getLocalName, parseXmlDocument } from "./xmlParser.js";
 import { TaggedError } from "better-result";
+import { writeZipPart } from "@stll/docx-core/zip";
 import JSZip from "jszip";
 //#region src/docx/metadataPrivacy.ts
 const FOLIO_DOCUMENT_METADATA_PROPERTIES = Object.freeze([
@@ -152,7 +153,11 @@ const rewriteDocxMetadataPrivacy = async (buffer, { transforms }) => {
 			removedMetadataProperties: []
 		}
 	};
-	zip.file(coreProperties.name, rewritten.xml);
+	writeZipPart({
+		zip,
+		path: coreProperties.name,
+		data: rewritten.xml
+	});
 	return {
 		buffer: await zip.generateAsync({
 			type: "arraybuffer",

package/dist/docx/packageParts.js

@@ -1,4 +1,5 @@
 import { Result } from "better-result";
+import { writeZipPart } from "@stll/docx-core/zip";
 //#region src/docx/packageParts.ts
 /**
 * What a repack carries out of the source package, and the guarantee that
@@ -129,9 +130,14 @@ const readRelationshipParts = async (zip) => {
 	return parts;
 };
 const writePart = ({ zip, path, xml, compressionLevel }) => {
-	zip.file(path, xml, {
-		compression: "DEFLATE",
-		compressionOptions: { level: compressionLevel }
+	writeZipPart({
+		zip,
+		path,
+		data: xml,
+		options: {
+			compression: "DEFLATE",
+			compressionOptions: { level: compressionLevel }
+		}
 	});
 };
 /**

package/dist/docx/paragraphPropertySource.js

@@ -1,6 +1,6 @@
 import { modelParagraphFormattingEmission } from "../internal/paragraphFormattingSerialization.js";
 import { canonicalJson } from "../utils/canonicalJson.js";
-import { copyHeaderFooterPackageBaselines } from "./headerFooterVerbatim.js";
+import { copyHeaderFooterBaselineHandles, copyHeaderFooterPackageBaselines } from "./headerFooterVerbatim.js";
 import { visitDocxParagraphs } from "./paragraphTraversal.js";
 import { TaggedError, panic } from "better-result";
 import { PluginKey } from "prosemirror-state";
@@ -244,6 +244,7 @@ const cloneDocumentWithParagraphPropertySources = (document) => {
 		copyParagraphPropertySource(target, source);
 	}
 	copyDocumentParagraphPropertySourceContract(cloned, document);
+	copyHeaderFooterBaselineHandles(cloned, document);
 	copyHeaderFooterPackageBaselines(cloned, document);
 	return cloned;
 };

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, captureHeaderFooterPackageBaselines, refreshHeaderFooterVerbatimFingerprint } from "./headerFooterVerbatim.js";
+import { assignHeaderFooterVerbatimXml, canReplayHeaderFooterVerbatim, captureDocumentSourceBaseline, captureHeaderFooterPackageBaselines, refreshHeaderFooterVerbatimFingerprint } from "./headerFooterVerbatim.js";
 import { extractMetafileRaster, isMetafileMimeType } from "./metafileRaster.js";
 import { renderEmfSvg } from "./metafileSvg.js";
 import { DocxModelValidationError, formatDocumentModelIssues, validateFolioDocumentModel } from "./modelValidation.js";
@@ -474,6 +474,7 @@ async function parseDocxWithPreviewBudget(input, options, previewBudget) {
 		}
 		onProgress("Complete", 100);
 		captureHeaderFooterPackageBaselines(document);
+		if (raw.documentXml) captureDocumentSourceBaseline(document, raw.documentXml);
 		return document;
 	} catch (error) {
 		if (error instanceof DocxEncryptionError) throw error;

package/dist/docx/removeHeaderFooterParts.js

@@ -4,6 +4,7 @@ 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";
+import { writeZipPart } from "@stll/docx-core/zip";
 //#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}`);
@@ -54,9 +55,14 @@ const removeResolvedHeaderFooterParts = async ({ document, zip, removedReference
 		}
 	}
 	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
+	writeZipPart({
+		zip,
+		path: DOCUMENT_RELS_PATH,
+		data: withoutChildren(relsXml, (child) => getNamespaceUri(child) === OOXML_NS.pr && getLocalName(child.name) === "Relationship" && removedIds.has(getAttribute(child, null, "Id") ?? "")),
+		options: {
+			compression: "DEFLATE",
+			compressionOptions
+		}
 	});
 	if (document.package.relationships) {
 		document.package.relationships = new Map(document.package.relationships);
@@ -78,9 +84,14 @@ const removeResolvedHeaderFooterParts = async ({ document, zip, removedReference
 	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
+	writeZipPart({
+		zip,
+		path: "[Content_Types].xml",
+		data: withoutChildren(contentTypesXml, (child) => getNamespaceUri(child) === OOXML_NS.ct && getLocalName(child.name) === "Override" && candidates.has((getAttribute(child, null, "PartName") ?? "").replace(/^\//u, ""))),
+		options: {
+			compression: "DEFLATE",
+			compressionOptions
+		}
 	});
 };
 //#endregion

package/dist/docx/rezip.d.ts

@@ -1,6 +1,8 @@
 import { document_d_exports } from "../types/document.js";
+import { CANONICAL_GAP } from "../types/canonicalCapabilities.js";
 import { SaveDiagnosticOptions } from "./saveDiagnostics.js";
 import { BlockContent, Hyperlink } from "../types/content.js";
+import { DocumentBodyAuthorityOptions } from "./serializer/documentSerializer.js";
 import { RawDocxContent } from "./unzip.js";
 import JSZip from "jszip";
 //#region src/docx/rezip.d.ts
@@ -38,16 +40,46 @@ declare class DocxDuplicateSectionCarrierError extends DocxPackageFidelityError
  */
 declare function findMaxRId(relsXml: string): number;
 /**
- * Collect all hyperlinks that have an href but no rId from block content.
- * These are newly created hyperlinks that need relationship entries.
+ * Every serialized section has exactly one model record, and vice versa.
+ *
+ * A split paragraph's duplicated `w:sectPr` is a section nobody added,
+ * repeating the real one's `w:rsidSect` and claiming its revision history too.
+ * Two carriers over one record are therefore invalid regardless of whether a
+ * separate deletion makes the total section count rise, fall, or stay equal.
+ *
+ * The count is a separate invariant: `serializeSectionProperties` fails closed
+ * to `""` for a record holding settings it cannot write, so carrier uniqueness
+ * alone does not prove the package states the sections the model holds.
  */
+declare const assertSectionCarriersMatchModel: ({ doc, serializedSectionCount }: {
+  doc: document_d_exports.Document;
+  serializedSectionCount: number;
+}) => void;
+declare const CanonicalImageRelationshipRefusalError_base: import("better-result").TaggedErrorClass<"CanonicalImageRelationshipRefusalError">;
+declare class CanonicalImageRelationshipRefusalError extends CanonicalImageRelationshipRefusalError_base<{
+  message: string;
+  gap: typeof CANONICAL_GAP.save;
+  part: string;
+  relationshipId: string;
+  reason: "conflict" | "unresolved" | "missingMedia" | "unsafeTarget";
+}> {}
+type PublishCanonicalImageResourcesOptions = {
+  document: document_d_exports.Document;
+  zip: JSZip;
+  compressionLevel: number;
+};
+/** Publish allocated pictures into each owning story without rebinding canonical ids. */
+declare const publishCanonicalImageResources: ({ document, zip, compressionLevel }: PublishCanonicalImageResourcesOptions) => Promise<void>;
+/** Newly authored text links; the census shares the complete owning-part traversal. */
 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;
+/** Compare against the already loaded source ZIP, without mutating model or package. */
+declare const hasUnmaterializedHyperlinkBindings: (document: document_d_exports.Document, zip: JSZip) => Promise<boolean>;
 /**
  * Options for repacking DOCX
  */
-type RepackOptions = SaveDiagnosticOptions & {
+type RepackOptions = SaveDiagnosticOptions & DocumentBodyAuthorityOptions & {
   /** Compression level (0-9, default: 6) */
   compressionLevel?: number;
   /** Whether to update modification date in docProps/core.xml */
@@ -190,6 +222,18 @@ type CollectHeaderFooterUpdatesOptions = SaveDiagnosticOptions & {
   sourceZip: JSZip;
 };
 declare function collectHeaderFooterUpdates(doc: document_d_exports.Document, { sourceZip, onDiagnostic }: CollectHeaderFooterUpdatesOptions): Promise<Map<string, string>>;
+type AddedStylesPlan = {
+  type: "unchanged";
+} | {
+  type: "materialize";
+  styles: document_d_exports.StyleDefinitions;
+} | {
+  type: "patch";
+  path: string;
+  xml: string;
+};
+/** One append-only style owner for full repack and selective overlays. */
+declare function planAddedStyles(doc: document_d_exports.Document, originalZip: JSZip): Promise<AddedStylesPlan>;
 /** `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. */
@@ -223,7 +267,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 = SaveDiagnosticOptions & {
+type DocumentPropertiesOptions = SaveDiagnosticOptions & DocumentBodyAuthorityOptions & {
   /** `dc:creator` in `docProps/core.xml`. Omitted when absent. */
   creator?: string;
   /** `Application` in `docProps/app.xml`. Omitted, with `AppVersion`, when absent. */
@@ -246,4 +290,4 @@ declare function createEmptyDocx(properties?: DocumentPropertiesOptions): Promis
  */
 declare function createDocx(doc: document_d_exports.Document, properties?: DocumentPropertiesOptions): Promise<ArrayBuffer>;
 //#endregion
-export { COMMENTS_CONTENT_TYPE, COMMENTS_EXTENDED_CONTENT_TYPE, COMMENTS_EXTENDED_PART, COMMENTS_EXTENDED_PART_LOWER, DocumentPropertiesOptions, DocxDuplicateSectionCarrierError, 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 };
+export { COMMENTS_CONTENT_TYPE, COMMENTS_EXTENDED_CONTENT_TYPE, COMMENTS_EXTENDED_PART, COMMENTS_EXTENDED_PART_LOWER, CanonicalImageRelationshipRefusalError, DocumentPropertiesOptions, DocxDuplicateSectionCarrierError, DocxPackageFidelityError, RepackOptions, addCommentsExtendedOverride, addCommentsExtendedRelationship, addMedia, addRelationship, applyUpdatesToZip, assertSectionCarriersMatchModel, collectHeaderFooterUpdates, collectHyperlinksWithoutRId, createDocx, createEmptyDocx, findMaxRId, hasModelDrivenPictureWatermark, hasUnmaterializedHeaderFooter, hasUnmaterializedHyperlinkBindings, hasUnmaterializedInlineResources, isDocxBuffer, notePartRelsPath, planAddedStyles, publishCanonicalImageResources, removeCommentsExtendedOverride, removeCommentsExtendedRelationship, repackDocx, repackDocxFromRaw, updateCoreProperties, updateDocumentXml, updateMultipleFiles, updateXmlFile, validateDocx, withoutAttachedTemplate };