@office-open/docx 0.12.3 → 0.13.1

package/dist/index.mjs

@@ -362,6 +362,31 @@ const HighlightColor = {
 	/** Yellow highlight */
 	YELLOW: "yellow"
 };
+/**
+* Word's highlighter palette — the RGB each {@link HighlightColor} name shows
+* as on screen. `w:highlight` accepts only these fixed names (an off-palette
+* value makes Word refuse the file), so callers encoding an arbitrary color as
+* a highlight must first map it through this table and fall back to run
+* shading when it is off-palette.
+*/
+const HIGHLIGHT_PALETTE_RGB = {
+	black: "000000",
+	blue: "0000FF",
+	cyan: "00FFFF",
+	green: "00FF00",
+	magenta: "FF00FF",
+	red: "FF0000",
+	yellow: "FFFF00",
+	white: "FFFFFF",
+	darkBlue: "000080",
+	darkCyan: "008080",
+	darkGreen: "008000",
+	darkMagenta: "800080",
+	darkRed: "800000",
+	darkYellow: "808000",
+	darkGray: "808080",
+	lightGray: "C0C0C0"
+};
 //#endregion
 //#region src/shared/media/media.ts
 /**
@@ -381,7 +406,8 @@ const createTransformation = (options) => {
 			x: widthEmu,
 			y: heightEmu
 		},
-		flip: options.flip,
+		flipHorizontal: options.flipHorizontal,
+		flipVertical: options.flipVertical,
 		offset: {
 			emus: {
 				x: offsetLeftEmu,
@@ -1003,46 +1029,9 @@ const TableLayoutType = {
 //#endregion
 //#region src/shared/border.ts
 /**
-* Table borders are defined with the <w:tblBorders> element. Child elements of this element specify the kinds of `border`:
-*
-* `bottom`, `end` (`right` in the previous version of the standard), `insideH`, `insideV`, `start` (`left` in the previous version of the standard), and `top`.
-*
-* Reference: http://officeopenxml.com/WPtableBorders.php
-*
-* ## XSD Schema
-* ```xml
-* <xsd:simpleType name="ST_Border">
-*     <xsd:restriction base="xsd:string">
-*          <xsd:enumeration value="single"/>
-*          <xsd:enumeration value="dashDotStroked"/>
-*          <xsd:enumeration value="dashed"/>
-*          <xsd:enumeration value="dashSmallGap"/>
-*          <xsd:enumeration value="dotDash"/>
-*          <xsd:enumeration value="dotDotDash"/>
-*          <xsd:enumeration value="dotted"/>
-*          <xsd:enumeration value="double"/>
-*          <xsd:enumeration value="doubleWave"/>
-*          <xsd:enumeration value="inset"/>
-*          <xsd:enumeration value="nil"/>
-*          <xsd:enumeration value="none"/>
-*          <xsd:enumeration value="outset"/>
-*          <xsd:enumeration value="thick"/>
-*          <xsd:enumeration value="thickThinLargeGap"/>
-*          <xsd:enumeration value="thickThinMediumGap"/>
-*          <xsd:enumeration value="thickThinSmallGap"/>
-*          <xsd:enumeration value="thinThickLargeGap"/>
-*          <xsd:enumeration value="thinThickMediumGap"/>
-*          <xsd:enumeration value="thinThickSmallGap"/>
-*          <xsd:enumeration value="thinThickThinLargeGap"/>
-*          <xsd:enumeration value="thinThickThinMediumGap"/>
-*          <xsd:enumeration value="thinThickThinSmallGap"/>
-*          <xsd:enumeration value="threeDEmboss"/>
-*          <xsd:enumeration value="threeDEngrave"/>
-*          <xsd:enumeration value="triple"/>
-*          <xsd:enumeration value="wave"/>
-*     </xsd:restriction>
-* </xsd:simpleType>
-* ```
+* Border style tokens for the `style` field — the common line styles Word
+* renders as line patterns. Child elements of w:tblBorders specify the sides:
+* `top`, `bottom`, `start`/`left`, `end`/`right`, `insideH`, `insideV`.
 *
 * @publicApi
 */
@@ -1102,15 +1091,15 @@ const BorderStyle = {
 	/** A wavy line */
 	WAVE: "wave"
 };
-/** Valid border `@w:val` values (ST_Border). */
-const BORDER_STYLES = Object.values(BorderStyle);
 /**
 * Parse one CT_Border side element. Returns undefined when the element is
-* malformed (missing/unknown `@w:val`) so callers skip the side.
+* malformed (missing `@w:val`) so callers skip the side. Any ST_Border token
+* passes through — Word's artistic styles (apples, weavingBraid, …) keep the
+* whole side instead of being dropped.
 */
 function parseBorderSide(sideEl) {
 	const style = attr(sideEl, "w:val");
-	if (!style || !BORDER_STYLES.includes(style)) return void 0;
+	if (!style) return void 0;
 	const sideOpts = { style };
 	const color = attr(sideEl, "w:color");
 	if (color) sideOpts.color = color;
@@ -3038,7 +3027,7 @@ const altChunkDesc = {
 		const partPath = `afchunks/afchunk${relId}.${extension}`;
 		const rawData = typeof opts.data === "string" ? toUint8Array(opts.data) : opts.data;
 		const data = opts.contentType === "text/html" && typeof opts.data === "string" ? toUint8Array(wrapHtmlDocument(opts.data)) : rawData;
-		ctx.fileData.document.relationships.addRelationship(relId, ALTCHUNK_REL_TYPE, partPath);
+		ctx.fileData.document.relationships.addRelationship(`rId${relId}`, ALTCHUNK_REL_TYPE, partPath);
 		ctx.fileData.altChunks.addAltChunk(relId, {
 			key: relId,
 			data,
@@ -3088,7 +3077,7 @@ const subDocDesc = {
 		const relId = uniqueId();
 		const partPath = `subdocs/subdoc${relId}.docx`;
 		const data = toUint8Array(opts.data);
-		ctx.fileData.document.relationships.addRelationship(relId, SUBDOC_REL_TYPE, partPath);
+		ctx.fileData.document.relationships.addRelationship(`rId${relId}`, SUBDOC_REL_TYPE, partPath);
 		ctx.fileData.subDocs.addSubDoc(relId, {
 			data,
 			path: partPath
@@ -3324,7 +3313,7 @@ function buildCustomXmlPropertiesXml(pr) {
 function stringifyCustomXmlShell(opts, contentXml) {
 	const attrs = [`w:element="${escapeXml(opts.element)}"`];
 	if (opts.uri !== void 0) attrs.push(`w:uri="${escapeXml(opts.uri)}"`);
-	const prXml = opts.customXmlPr ? buildCustomXmlPropertiesXml(opts.customXmlPr) : "";
+	const prXml = opts.properties ? buildCustomXmlPropertiesXml(opts.properties) : "";
 	return `<w:customXml ${attrs.join(" ")}>${prXml}${contentXml}</w:customXml>`;
 }
 const customXmlBlockDesc = {
@@ -3342,7 +3331,7 @@ const customXmlBlockDesc = {
 		const uri = attr(el, "w:uri");
 		if (uri) opts.uri = uri;
 		const xmlPr = findChild(el, "w:customXmlPr");
-		if (xmlPr) opts.customXmlPr = parseCustomXmlProperties(xmlPr);
+		if (xmlPr) opts.properties = parseCustomXmlProperties(xmlPr);
 		const childList = [];
 		for (const child of el.elements ?? []) {
 			if (child.name === "w:customXmlPr") continue;
@@ -6252,7 +6241,7 @@ function parseCustomXmlInline(el, ctx) {
 	const pr = findChild(el, "w:customXmlPr");
 	if (pr) {
 		const parsed = parseCustomXmlProperties(pr);
-		if (parsed.placeholder !== void 0 || parsed.attributes !== void 0) cx.customXmlPr = parsed;
+		if (parsed.placeholder !== void 0 || parsed.attributes !== void 0) cx.properties = parsed;
 	}
 	const content = parseContainerChildren(el, ctx);
 	if (content.length > 0) cx.children = content;
@@ -6916,6 +6905,8 @@ function parsePictureRun(el, ctx) {
 	if (info.altText) imageOpts.altText = info.altText;
 	if (info.floating) imageOpts.floating = info.floating;
 	if (info.graphicFrameLocks !== void 0) imageOpts.graphicFrameLocks = info.graphicFrameLocks;
+	const cstate = attr(blip, "cstate");
+	if (cstate !== void 0) imageOpts.compression = cstate;
 	const blipFill = findFirst(el, "pic:blipFill");
 	if (blipFill) {
 		const srcRect = readSourceRectangle(blipFill);
@@ -6942,10 +6933,8 @@ function parsePictureRun(el, ctx) {
 			if (rot !== void 0) transform.rotation = parseAngle(rot);
 			const flipH = attrBool(xfrm, "flipH");
 			const flipV = attrBool(xfrm, "flipV");
-			if (flipH !== void 0 || flipV !== void 0) transform.flip = {
-				...flipH !== void 0 ? { horizontal: flipH } : {},
-				...flipV !== void 0 ? { vertical: flipV } : {}
-			};
+			if (flipH !== void 0) transform.flipHorizontal = flipH;
+			if (flipV !== void 0) transform.flipVertical = flipV;
 		}
 	}
 	const blipResult = blipDesc.parse(blip, ctx);
@@ -7066,16 +7055,29 @@ function readShapeFill(parent, ctx) {
 * the `idx` attribute plus an optional EG_ColorChoice color override.
 */
 function parseStyleRef(el, ctx) {
-	const idx = attr(el, "idx");
+	const idx = attrNum(el, "idx");
 	if (idx === void 0) return void 0;
-	const result = { idx };
+	const result = { index: idx };
+	const color = parseColorChoice(el, ctx);
+	if (color && Object.keys(color).length > 0) result.color = color;
+	return result;
+}
+/**
+* Parse a:fontRef — @idx is ST_FontCollectionIndex (major/minor/none), not a
+* number, so it reads as a collection slot instead of a matrix index. Off-XSD
+* tokens drop the reference (core parseFontReference precedent).
+*/
+function parseFontRef(el, ctx) {
+	const idx = attr(el, "idx");
+	if (idx !== "major" && idx !== "minor" && idx !== "none") return void 0;
+	const result = { collection: idx };
 	const color = parseColorChoice(el, ctx);
 	if (color && Object.keys(color).length > 0) result.color = color;
 	return result;
 }
 /**
 * Parse a wps:style (CT_ShapeStyle): line/fill/effect/font references into the
-* document theme. Delegates color to the shared core {@link parseColorChoice}.
+* document theme. Delegates color to the shared core parseColorChoice.
 */
 function parseShapeStyle(styleEl, ctx) {
 	const result = {};
@@ -7086,7 +7088,7 @@ function parseShapeStyle(styleEl, ctx) {
 	const effectRef = findChild(styleEl, "a:effectRef");
 	if (effectRef) result.effectReference = parseStyleRef(effectRef, ctx);
 	const fontRef = findChild(styleEl, "a:fontRef");
-	if (fontRef) result.fontReference = parseStyleRef(fontRef, ctx);
+	if (fontRef) result.fontReference = parseFontRef(fontRef, ctx);
 	return result;
 }
 /**
@@ -7161,7 +7163,7 @@ function parseWpsShapeCore(wspEl, ctx) {
 		const custGeom = findChild(spPr, "a:custGeom");
 		if (custGeom) result.customGeometry = customGeometryDesc.parse(custGeom, ctx);
 		const prstGeom = findChild(spPr, "a:prstGeom");
-		if (prstGeom) result.presetGeometry = presetGeometryDesc.parse(prstGeom, ctx);
+		if (prstGeom) result.geometry = presetGeometryDesc.parse(prstGeom, ctx);
 		const scene3d = findChild(spPr, "a:scene3d");
 		if (scene3d) result.scene3d = scene3DDesc.parse(scene3d, ctx);
 		const sp3d = findChild(spPr, "a:sp3d");
@@ -7224,12 +7226,8 @@ function readChildTransformation(spPr) {
 	}
 	const flipH = attrBool(xfrm, "flipH");
 	const flipV = attrBool(xfrm, "flipV");
-	if (flipH !== void 0 || flipV !== void 0) {
-		const flip = {};
-		if (flipH !== void 0) flip.horizontal = flipH;
-		if (flipV !== void 0) flip.vertical = flipV;
-		result.flip = flip;
-	}
+	if (flipH !== void 0) result.flipHorizontal = flipH;
+	if (flipV !== void 0) result.flipVertical = flipV;
 	const rot = attrNum(xfrm, "rot");
 	if (rot !== void 0) result.rotation = rot;
 	return result;
@@ -7375,7 +7373,7 @@ function parseWpgGroupDrawing(el, ctx) {
 	if (!wgp) return void 0;
 	const info = parseAnchorOrInline(el, ctx) ?? {};
 	const grpSpPr = findChild(wgp, "wpg:grpSpPr");
-	const { childOffset, childExtent } = readGroupCoords(grpSpPr);
+	const { childOffsetX, childOffsetY, childExtentWidth, childExtentHeight } = readGroupCoords(grpSpPr);
 	const group = {
 		children: parseGroupChildren(wgp, ctx),
 		transformation: {
@@ -7384,8 +7382,10 @@ function parseWpgGroupDrawing(el, ctx) {
 			...info.effectExtent ? { effectExtent: info.effectExtent } : {}
 		}
 	};
-	if (childOffset) group.childOffset = childOffset;
-	if (childExtent) group.childExtent = childExtent;
+	if (childOffsetX !== void 0) group.childOffsetX = childOffsetX;
+	if (childOffsetY !== void 0) group.childOffsetY = childOffsetY;
+	if (childExtentWidth !== void 0) group.childExtentWidth = childExtentWidth;
+	if (childExtentHeight !== void 0) group.childExtentHeight = childExtentHeight;
 	if (info.floating) group.floating = info.floating;
 	if (info.altText) group.altText = info.altText;
 	if (info.graphicFrameLocks !== void 0) group.graphicFrameLocks = info.graphicFrameLocks;
@@ -7407,22 +7407,18 @@ function readGroupCoords(grpSpPr) {
 	if (!grpSpPr) return {};
 	const xfrm = findChild(grpSpPr, "a:xfrm");
 	if (!xfrm) return {};
-	let childOffset;
-	let childExtent;
+	const result = {};
 	const off = findChild(xfrm, "a:chOff");
-	if (off?.attributes) childOffset = {
-		x: Number(off.attributes["x"] ?? 0),
-		y: Number(off.attributes["y"] ?? 0)
-	};
+	if (off?.attributes) {
+		result.childOffsetX = Number(off.attributes["x"] ?? 0);
+		result.childOffsetY = Number(off.attributes["y"] ?? 0);
+	}
 	const ext = findChild(xfrm, "a:chExt");
-	if (ext?.attributes) childExtent = {
-		cx: Number(ext.attributes["cx"] ?? 0),
-		cy: Number(ext.attributes["cy"] ?? 0)
-	};
-	return {
-		childOffset,
-		childExtent
-	};
+	if (ext?.attributes) {
+		result.childExtentWidth = Number(ext.attributes["cx"] ?? 0);
+		result.childExtentHeight = Number(ext.attributes["cy"] ?? 0);
+	}
+	return result;
 }
 /**
 * Parse the children of a group element (CT_WordprocessingGroup choice):
@@ -7561,14 +7557,16 @@ function parseContentPart(el) {
 */
 function parseNestedGroup(grpSpEl, ctx) {
 	const grpSpPr = findChild(grpSpEl, "wpg:grpSpPr");
-	const { childOffset, childExtent } = readGroupCoords(grpSpPr);
+	const { childOffsetX, childOffsetY, childExtentWidth, childExtentHeight } = readGroupCoords(grpSpPr);
 	const result = {
 		type: "wpg",
 		transformation: readChildTransformation(grpSpPr),
 		children: parseGroupChildren(grpSpEl, ctx)
 	};
-	if (childOffset) result.childOffset = childOffset;
-	if (childExtent) result.childExtent = childExtent;
+	if (childOffsetX !== void 0) result.childOffsetX = childOffsetX;
+	if (childOffsetY !== void 0) result.childOffsetY = childOffsetY;
+	if (childExtentWidth !== void 0) result.childExtentWidth = childExtentWidth;
+	if (childExtentHeight !== void 0) result.childExtentHeight = childExtentHeight;
 	const grpSpLocks = readGrpSpLocks(findChild(grpSpEl, "wpg:cNvGrpSpPr"));
 	if (grpSpLocks) result.groupShapeLocks = grpSpLocks;
 	if (grpSpPr) {
@@ -7920,16 +7918,8 @@ function buildUseLocalDpiExt(useLocalDpi) {
 function registerHyperlinks(hyperlink, ctx) {
 	if (!hyperlink) return {};
 	const result = {};
-	if (hyperlink.click) {
-		const linkId = uniqueId();
-		ctx.viewWrapper.relationships.addRelationship(linkId, HYPERLINK_REL, hyperlink.click, TargetModeType.EXTERNAL);
-		result.clickId = `rId${linkId}`;
-	}
-	if (hyperlink.hover) {
-		const linkId = uniqueId();
-		ctx.viewWrapper.relationships.addRelationship(linkId, HYPERLINK_REL, hyperlink.hover, TargetModeType.EXTERNAL);
-		result.hoverId = `rId${linkId}`;
-	}
+	if (hyperlink.click) result.clickId = `rId${ctx.viewWrapper.relationships.add(HYPERLINK_REL, hyperlink.click, TargetModeType.EXTERNAL)}`;
+	if (hyperlink.hover) result.hoverId = `rId${ctx.viewWrapper.relationships.add(HYPERLINK_REL, hyperlink.hover, TargetModeType.EXTERNAL)}`;
 	return result;
 }
 function buildHyperlinkChildren(ids) {
@@ -7958,6 +7948,7 @@ function stringifyBlipFill(mediaData, blipEffects, tile, ctx) {
 	const parts = [];
 	const blipAttrs = [];
 	if (fileName !== void 0) blipAttrs.push(`r:embed="{${escapeXml(fileName)}}"`);
+	if (mediaData.compression !== void 0) blipAttrs.push(`cstate="${escapeXml(mediaData.compression)}"`);
 	if (mediaData.sourceUrl !== void 0 && ctx) {
 		const linkId = ctx.viewWrapper.relationships.add(IMAGE_REL, mediaData.sourceUrl, TargetModeType.EXTERNAL);
 		blipAttrs.push(`r:link="rId${linkId}"`);
@@ -7989,8 +7980,8 @@ function stringifyShapeProps(transform, outline, fill, effects, scene3d, shape3d
 		y: transform.offset?.emus?.y ?? 0,
 		width: transform.emus.x,
 		height: transform.emus.y,
-		flipHorizontal: transform.flip?.horizontal,
-		flipVertical: transform.flip?.vertical,
+		flipHorizontal: transform.flipHorizontal,
+		flipVertical: transform.flipVertical,
 		rotation: transform.rotation,
 		geometry: "rect",
 		fill,
@@ -8032,11 +8023,11 @@ function stringifyWpsShape(opts, ctx) {
 		y: transform.offset?.emus?.y ?? 0,
 		width: transform.emus.x,
 		height: transform.emus.y,
-		flipHorizontal: transform.flip?.horizontal,
-		flipVertical: transform.flip?.vertical,
+		flipHorizontal: transform.flipHorizontal,
+		flipVertical: transform.flipVertical,
 		rotation: transform.rotation,
 		customGeometry: opts.customGeometry,
-		geometry: opts.customGeometry ? void 0 : opts.presetGeometry ?? "rect",
+		geometry: opts.customGeometry ? void 0 : opts.geometry ?? "rect",
 		fill: opts.fill,
 		outline: opts.outline,
 		effectDag: opts.effectDag,
@@ -8085,14 +8076,20 @@ function stringifyNonVisualShapeProperties(opts) {
 /** Stringify a single style-matrix reference (a:lnRef/a:fillRef/...). */
 function stringifyStyleRef(name, ref) {
 	if (!ref) return "";
-	const idx = escapeXml(ref.idx);
 	const colorXml = ref.color ? createColorElement(ref.color) : "";
-	if (colorXml) return `<${name} idx="${idx}">${colorXml}</${name}>`;
-	return `<${name} idx="${idx}"/>`;
+	if (colorXml) return `<${name} idx="${ref.index}">${colorXml}</${name}>`;
+	return `<${name} idx="${ref.index}"/>`;
+}
+/** Stringify a:fontRef — @idx is ST_FontCollectionIndex, not a number. */
+function stringifyFontRef(ref) {
+	if (!ref) return "";
+	const colorXml = ref.color ? createColorElement(ref.color) : "";
+	if (colorXml) return `<a:fontRef idx="${escapeXml(ref.collection)}">${colorXml}</a:fontRef>`;
+	return `<a:fontRef idx="${escapeXml(ref.collection)}"/>`;
 }
 /** Stringify a wps:style (CT_ShapeStyle): lnRef/fillRef/effectRef/fontRef. */
 function stringifyShapeStyle(opts) {
-	const inner = stringifyStyleRef("a:lnRef", opts.lineReference) + stringifyStyleRef("a:fillRef", opts.fillReference) + stringifyStyleRef("a:effectRef", opts.effectReference) + stringifyStyleRef("a:fontRef", opts.fontReference);
+	const inner = stringifyStyleRef("a:lnRef", opts.lineReference) + stringifyStyleRef("a:fillRef", opts.fillReference) + stringifyStyleRef("a:effectRef", opts.effectReference) + stringifyFontRef(opts.fontReference);
 	return inner ? `<wps:style>${inner}</wps:style>` : "";
 }
 function stringifyBodyPr(opts) {
@@ -8105,13 +8102,13 @@ function stringifyWpgGroup(opts, ctx) {
 		y: transform.offset?.emus?.y ?? 0,
 		width: transform.emus.x,
 		height: transform.emus.y,
-		flipHorizontal: transform.flip?.horizontal,
-		flipVertical: transform.flip?.vertical,
+		flipHorizontal: transform.flipHorizontal,
+		flipVertical: transform.flipVertical,
 		rotation: transform.rotation,
-		childOffsetX: opts.childOffset?.x,
-		childOffsetY: opts.childOffset?.y,
-		childExtentWidth: opts.childExtent?.cx,
-		childExtentHeight: opts.childExtent?.cy,
+		childOffsetX: opts.childOffsetX,
+		childOffsetY: opts.childOffsetY,
+		childExtentWidth: opts.childExtentWidth,
+		childExtentHeight: opts.childExtentHeight,
 		fill: opts.fill,
 		effects: opts.effects
 	}, ctx) ?? "";
@@ -8187,7 +8184,7 @@ function stringifyCnvFrPr(locks) {
 function stringifyChildXfrm(prefix, t) {
 	const x = t.offset?.emus?.x ?? 0;
 	const y = t.offset?.emus?.y ?? 0;
-	return `<${prefix}:xfrm${(t.flip?.horizontal ? " flipH=\"1\"" : "") + (t.flip?.vertical ? " flipV=\"1\"" : "")}${t.rotation !== void 0 ? ` rot="${t.rotation}"` : ""}><a:off x="${x}" y="${y}"/><a:ext cx="${t.emus.x}" cy="${t.emus.y}"/></${prefix}:xfrm>`;
+	return `<${prefix}:xfrm${(t.flipHorizontal ? " flipH=\"1\"" : "") + (t.flipVertical ? " flipV=\"1\"" : "")}${t.rotation !== void 0 ? ` rot="${t.rotation}"` : ""}><a:off x="${x}" y="${y}"/><a:ext cx="${t.emus.x}" cy="${t.emus.y}"/></${prefix}:xfrm>`;
 }
 /**
 * Stringify a wpg:contentPart child (CT_WordprocessingContentPart) inside a
@@ -8213,13 +8210,13 @@ function stringifyNestedGroup(grp, ctx) {
 		y: grp.transformation.offset?.emus?.y ?? 0,
 		width: grp.transformation.emus.x,
 		height: grp.transformation.emus.y,
-		flipHorizontal: grp.transformation.flip?.horizontal,
-		flipVertical: grp.transformation.flip?.vertical,
+		flipHorizontal: grp.transformation.flipHorizontal,
+		flipVertical: grp.transformation.flipVertical,
 		rotation: grp.transformation.rotation,
-		childOffsetX: grp.childOffset?.x,
-		childOffsetY: grp.childOffset?.y,
-		childExtentWidth: grp.childExtent?.cx,
-		childExtentHeight: grp.childExtent?.cy,
+		childOffsetX: grp.childOffsetX,
+		childOffsetY: grp.childOffsetY,
+		childExtentWidth: grp.childExtentWidth,
+		childExtentHeight: grp.childExtentHeight,
 		fill: grp.fill,
 		effects: grp.effects
 	}, ctx) ?? "";
@@ -8248,8 +8245,10 @@ function stringifyGraphicDataContent(mediaData, opts, hlIds, ctx) {
 		const wpgXml = stringifyWpgGroup({
 			children: md.children,
 			transformation: transform,
-			childOffset: md.childOffset,
-			childExtent: md.childExtent,
+			childOffsetX: md.childOffsetX,
+			childOffsetY: md.childOffsetY,
+			childExtentWidth: md.childExtentWidth,
+			childExtentHeight: md.childExtentHeight,
 			fill: md.fill,
 			effects: md.effects,
 			groupShapeLocks: md.groupShapeLocks
@@ -8938,7 +8937,8 @@ function stringifyChildDispatch(child, ctx) {
 				transformation: createTransformation(opts.transformation),
 				sourceRectangle: opts.sourceRectangle,
 				nonVisualProperties: opts.nonVisualProperties,
-				useLocalDpi: opts.useLocalDpi
+				useLocalDpi: opts.useLocalDpi,
+				compression: opts.compression
 			},
 			docProperties: opts.altText,
 			floating: opts.floating,
@@ -8964,6 +8964,7 @@ function stringifyChildDispatch(child, ctx) {
 				type: "svg",
 				...createPictureData(rawData, opts.transformation, fileName, opts.sourceRectangle, opts.nonVisualProperties),
 				useLocalDpi: opts.useLocalDpi,
+				compression: opts.compression,
 				fallback
 			}), opts.fileName);
 		} else {
@@ -8972,6 +8973,7 @@ function stringifyChildDispatch(child, ctx) {
 				type,
 				...createPictureData(rawData, opts.transformation, fileName, opts.sourceRectangle, opts.nonVisualProperties),
 				useLocalDpi: opts.useLocalDpi,
+				compression: opts.compression,
 				sourceUrl: opts.sourceUrl
 			}), opts.fileName);
 		}
@@ -9099,8 +9101,10 @@ function stringifyChildDispatch(child, ctx) {
 		const mediaData = {
 			children: opts.children,
 			transformation: createTransformation(opts.transformation),
-			childOffset: opts.childOffset,
-			childExtent: opts.childExtent,
+			childOffsetX: opts.childOffsetX,
+			childOffsetY: opts.childOffsetY,
+			childExtentWidth: opts.childExtentWidth,
+			childExtentHeight: opts.childExtentHeight,
 			fill: opts.fill,
 			effects: opts.effects,
 			groupShapeLocks: opts.groupShapeLocks,
@@ -10524,7 +10528,7 @@ function parseTableRowEl(el, ctx) {
 		const xmlPr = findChild(child, "w:customXmlPr");
 		if (xmlPr) {
 			const parsed = parseCustomXmlProperties(xmlPr);
-			if (parsed.placeholder !== void 0 || parsed.attributes !== void 0) cx.customXmlPr = parsed;
+			if (parsed.placeholder !== void 0 || parsed.attributes !== void 0) cx.properties = parsed;
 		}
 		const cxCells = [];
 		for (const sub of child.elements ?? []) if (sub.name === "w:tc") cxCells.push(parseTableCellEl(sub, ctx));
@@ -10577,7 +10581,7 @@ function parseTableEl(el, ctx) {
 		const xmlPr = findChild(child, "w:customXmlPr");
 		if (xmlPr) {
 			const parsed = parseCustomXmlProperties(xmlPr);
-			if (parsed.placeholder !== void 0 || parsed.attributes !== void 0) cx.customXmlPr = parsed;
+			if (parsed.placeholder !== void 0 || parsed.attributes !== void 0) cx.properties = parsed;
 		}
 		const cxRows = [];
 		for (const sub of child.elements ?? []) if (sub.name === "w:tr") cxRows.push(parseTableRowEl(sub, ctx));
@@ -13983,7 +13987,7 @@ function parseCustomXmlBlock(el, ctx, parseChild) {
 	const uri = attr(el, "w:uri");
 	if (uri) opts.uri = uri;
 	const xmlPr = findChild(el, "w:customXmlPr");
-	if (xmlPr) opts.customXmlPr = parseCustomXmlProperties(xmlPr);
+	if (xmlPr) opts.properties = parseCustomXmlProperties(xmlPr);
 	const children = [];
 	for (const child of el.elements ?? []) {
 		if (child.name === "w:customXmlPr") continue;
@@ -14217,6 +14221,7 @@ var DocxWriteContext = class {
 			relationships: new Relationships(),
 			partName: "word/document.xml"
 		};
+		this.document.relationships.reserveSourceRids("word/document.xml", options.passthroughRelationships ?? []);
 		this._settingsOptions = {
 			displayBackgroundShape: options.background?.image ? true : void 0,
 			...options.settings
@@ -15665,6 +15670,8 @@ const bibliographyDesc = {
 /** Gallery type for building blocks (ST_DocPartGallery) */
 const DocPartGallery = {
 	PLACEHOLDER: "placeholder",
+	/** Matches any gallery — used by docPartObj references without a specific gallery. */
+	ANY: "any",
 	DEFAULT: "default",
 	DOC_PARTS: "docParts",
 	COVER_PAGE: "coverPg",
@@ -19377,6 +19384,6 @@ function generateDocumentStream(options, packerOptions) {
 	return Packer.toStream(options, packerOptions);
 }
 //#endregion
-export { AlignmentType, AltChunkCollection, BorderStyle, BreakType, COMMENTS_NS, CharacterSet, DefaultStylesFactory, DocPartBehavior, DocPartGallery, DocPartType, DocumentAttributeNamespaces, DocumentGridType, DocxReadContext, DocxWriteContext, DropCapType, EMPTY_RUN_ELEMENTS, EditGroupType, EmphasisMarkType, FormFieldTextType, FrameAnchorType, FrameWrap, HeadingLevel, HeightRule, HighlightColor, HorizontalPositionAlign, HorizontalPositionRelativeFrom, HyperlinkType, LeaderType, LevelFormat, LevelSuffix, LineNumberRestartFormat, LineRuleType, Media, NumberFormat, Numbering, OverlapType, PageBorderDisplay, PageBorderOffsetFrom, PageBorderZOrder, PageNumber, PageNumberSeparator, PageOrientation, PageTextDirectionType, PositionalTabAlignment, PositionalTabLeader, PositionalTabRelativeTo, ProofErrorType, RelativeHorizontalPosition, RelativeVerticalPosition, RubyAlign, SdtDateMappingType, SdtLock, SectionType, ShadingType, SpaceType, StyleLevel, Styles, SubDocCollection, TABLE_BORDERS_NONE, TabStopPosition, TabStopType, TableAnchorType, TableLayoutType, TargetScreenSize, TextAlignmentType, TextDirection, TextEffect, TextWrappingSide, TextWrappingType, TextboxTightWrapType, UnderlineType, VerticalAlignSection, VerticalAlignTable, VerticalMergeRevisionType, VerticalMergeType, VerticalPositionAlign, VerticalPositionRelativeFrom, WidthType, altChunkDesc, appPropertiesDesc, bibliographyDesc, bodyPropertiesDesc, breakXml, buildBookmarkStartAttrs, buildMarkupRangeAttrs, buildNumIdCache, buildNumberingCache, buildStyleCache, checkboxSymbolRunInner, commentsDesc, commentsExtendedDesc, compileDocument, corePropertiesDesc, createBodyProperties, createDocumentGrid, createFormFieldData, createHorizontalPosition, createLineNumberType, createPageMargin, createPageNumberType, createPictureData, createSectionType, createTransformation, createVerticalPosition, createWrapThrough, createWrapTight, customPropertiesDesc, customXmlBlockDesc, documentNamespaceAttributes, documentNamespaceRecord, drawingDesc, endnotesDesc, extractStyleId, fontTableDesc, footnotesDesc, frameXml, framesetXml, generateDocument, generateDocumentStream, generateDocumentSync, glossaryDesc, keepTocClosingParagraph, objectDesc, parseArchive, parseBodyProperties, parseBorderSide, parseCustomXmlProperties, parseDocument, parseDocx, parseFormFieldData, parseNumberingDefinitions, parsePict, parseRegisteredBodyChild, parseSdtBlock, parseSdtProperties, parseSectionPropertiesEl, parseShading, parseStyleDefinitions, parseTableCellPropertiesEl, parseTablePropertiesEl, parseTableRowPropertiesEl, parseToc, parseTocFieldFromElements, parseTocFieldInstruction, patchDetector, patchDocument, peopleDesc, resetDrawingIdGen, sdtBlockDesc, sectionMarginDefaults, sectionPageSizeDefaults, sectionPropertiesDesc, selectTocEntryElements, setBodyParseChild, setTableParseChild, settingsDesc, stringifyCharacterStyle, stringifyChildDispatch, stringifyConditionalTableStyle, stringifyCustomXmlShell, stringifyDocDefaults, stringifyNumberingStyle, stringifyParagraphInline, stringifyParagraphStyle, stringifyPict, stringifyRunInline, stringifySdtPr, stringifySdtShell, stringifySectionProperties, stringifyTableOfContents, stringifyTableStyle, subDocDesc, tableDesc, webSettingsDesc, widthFiftiethsToPct, widthPctToFiftieths };
+export { AlignmentType, AltChunkCollection, BorderStyle, BreakType, COMMENTS_NS, CharacterSet, DefaultStylesFactory, DocPartBehavior, DocPartGallery, DocPartType, DocumentAttributeNamespaces, DocumentGridType, DocxReadContext, DocxWriteContext, DropCapType, EMPTY_RUN_ELEMENTS, EditGroupType, EmphasisMarkType, FormFieldTextType, FrameAnchorType, FrameWrap, HIGHLIGHT_PALETTE_RGB, HeadingLevel, HeightRule, HighlightColor, HorizontalPositionAlign, HorizontalPositionRelativeFrom, HyperlinkType, LeaderType, LevelFormat, LevelSuffix, LineNumberRestartFormat, LineRuleType, Media, NumberFormat, Numbering, OverlapType, PageBorderDisplay, PageBorderOffsetFrom, PageBorderZOrder, PageNumber, PageNumberSeparator, PageOrientation, PageTextDirectionType, PositionalTabAlignment, PositionalTabLeader, PositionalTabRelativeTo, ProofErrorType, RelativeHorizontalPosition, RelativeVerticalPosition, RubyAlign, SdtDateMappingType, SdtLock, SectionType, ShadingType, SpaceType, StyleLevel, Styles, SubDocCollection, TABLE_BORDERS_NONE, TabStopPosition, TabStopType, TableAnchorType, TableLayoutType, TargetScreenSize, TextAlignmentType, TextDirection, TextEffect, TextWrappingSide, TextWrappingType, TextboxTightWrapType, UnderlineType, VerticalAlignSection, VerticalAlignTable, VerticalMergeRevisionType, VerticalMergeType, VerticalPositionAlign, VerticalPositionRelativeFrom, WidthType, altChunkDesc, appPropertiesDesc, bibliographyDesc, bodyPropertiesDesc, breakXml, buildBookmarkStartAttrs, buildMarkupRangeAttrs, buildNumIdCache, buildNumberingCache, buildStyleCache, checkboxSymbolRunInner, commentsDesc, commentsExtendedDesc, compileDocument, corePropertiesDesc, createBodyProperties, createDocumentGrid, createFormFieldData, createHorizontalPosition, createLineNumberType, createPageMargin, createPageNumberType, createPictureData, createSectionType, createTransformation, createVerticalPosition, createWrapThrough, createWrapTight, customPropertiesDesc, customXmlBlockDesc, documentNamespaceAttributes, documentNamespaceRecord, drawingDesc, endnotesDesc, extractStyleId, fontTableDesc, footnotesDesc, frameXml, framesetXml, generateDocument, generateDocumentStream, generateDocumentSync, glossaryDesc, keepTocClosingParagraph, objectDesc, parseArchive, parseBodyProperties, parseBorderSide, parseCustomXmlProperties, parseDocument, parseDocx, parseFormFieldData, parseNumberingDefinitions, parsePict, parseRegisteredBodyChild, parseSdtBlock, parseSdtProperties, parseSectionPropertiesEl, parseShading, parseStyleDefinitions, parseTableCellPropertiesEl, parseTablePropertiesEl, parseTableRowPropertiesEl, parseToc, parseTocFieldFromElements, parseTocFieldInstruction, patchDetector, patchDocument, peopleDesc, resetDrawingIdGen, sdtBlockDesc, sectionMarginDefaults, sectionPageSizeDefaults, sectionPropertiesDesc, selectTocEntryElements, setBodyParseChild, setTableParseChild, settingsDesc, stringifyCharacterStyle, stringifyChildDispatch, stringifyConditionalTableStyle, stringifyCustomXmlShell, stringifyDocDefaults, stringifyNumberingStyle, stringifyParagraphInline, stringifyParagraphStyle, stringifyPict, stringifyRunInline, stringifySdtPr, stringifySdtShell, stringifySectionProperties, stringifyTableOfContents, stringifyTableStyle, subDocDesc, tableDesc, webSettingsDesc, widthFiftiethsToPct, widthPctToFiftieths };
 
 //# sourceMappingURL=index.mjs.map