@office-open/xlsx 0.14.2 → 0.14.3

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { ChartCollection, IMAGE_MEDIA_CONTENT_TYPES, Media, OoxmlMimeType, ParsedArchive, Relationships, TargetModeType, XLSX_PARTS, ZIP_DEFLATE_LEVEL, ZipStreamWriter, appPropertiesDesc, appendContentType, appendOverride, appendRelationship, applyCorePropertiesOverride, assertEncryptedExclusive, buildCorePropertiesXmlString, buildRootRelationships, collectPassthroughParts, compileMapping, contentTypesDesc, convertToEmu, convertToInch, convertToPt, createPacker, customPropertiesDesc, deriveContentTypes, derivePasswordHash, dropDanglingPassthroughRels, encryptedContainerOutput, encryptedContainerStream, getNextRelationshipIndex, isEncryptedContainer, nextNumericId, parseArchive, parseCorePropsElement, parseOnOff, parseVmlShape, partPathToRelsPath, pickNonVisualDrawingProperties, removeOverride, resolveRelationshipTarget, resolverFromRegistry, strFromU8, stringifyVmlShape, stringifyVmlShapeLayout, stringifyVmlShapetype, toJson, toUint8Array, toUint8ArrayAsync, unzipSync, xsdComments, xsdConsolidateFunction, xsdTotalsRowFunction, zipAndConvert } from "@office-open/core";
+import { ChartCollection, IMAGE_MEDIA_CONTENT_TYPES, Media, OoxmlMimeType, ParsedArchive, RELATIONSHIP_TYPES, Relationships, TargetModeType, XLSX_PARTS, ZIP_DEFLATE_LEVEL, ZipStreamWriter, appPropertiesDesc, appendContentType, appendOverride, appendRelationship, applyCorePropertiesOverride, assertEncryptedExclusive, buildCorePropertiesXmlString, buildRootRelationships, collectPassthroughParts, compileMapping, contentTypesDesc, convertToEmu, convertToInch, convertToPt, createPacker, customPropertiesDesc, deriveContentTypes, derivePasswordHash, dropDanglingPassthroughRels, encryptedContainerOutput, encryptedContainerStream, finalizeContentTypes, getNextRelationshipIndex, isEncryptedContainer, nextNumericId, parseArchive, parseCorePropsElement, parseOnOff, parseVmlShape, partPathToRelsPath, pickNonVisualDrawingProperties, removeOverride, resolveRelationshipTarget, resolverFromRegistry, strFromU8, stringifyVmlShape, stringifyVmlShapeLayout, stringifyVmlShapetype, toJson, toUint8Array, toUint8ArrayAsync, unzipSync, xsdComments, xsdConsolidateFunction, xsdTotalsRowFunction, zipAndConvert } from "@office-open/core";
 import { OOXML_XML_DECLARATION, attr, attrMeasure, attrNum, attrs, children, escapeXml, findChild, selfCloseElement, stringify, stringifyElement, textOf, unescapeXml } from "@office-open/xml";
 import { blipDesc, buildHyperlinkElement, connectorLockingDesc, createSourceRectangle, graphicFrameLockingDesc, groupShapePropertiesDesc, parseEndpointConnection, parseNonVisualDrawingProperties, pictureLockingDesc, readHyperlink, registerHyperlink, shapeLockingDesc, shapePropertiesDesc, sourceRectangleDesc, stringifyBlipEffects, stringifyEndpointConnection, stringifyNonVisualDrawingProperties, textBodyDesc } from "@office-open/core/drawing";
 import { buildThemeXml, createThemeXml, createThemeXml as createThemeXml$1, parseShapeStyle, stringifyShapeStyle, themeDesc } from "@office-open/core/theme";
@@ -1687,10 +1687,11 @@ function scanAttrs(src, from, to, visit) {
 		i++;
 	}
 }
-/** parseOnOff truthiness for on/off attribute values ("1"/"true"/"on"). */
+/** parseOnOff truthiness for on/off attribute values ("1"/"true"/"on" plus the
+*  single-letter t/f Word 2007 wrote). */
 function isOn(value) {
 	const lower = value.length <= 5 ? value.toLowerCase() : value;
-	return lower === "1" || lower === "true" || lower === "on";
+	return lower === "1" || lower === "true" || lower === "on" || lower === "t";
 }
 /**
 * Text content of a leaf element's inner XML slice, matching the Element-tree
@@ -9906,9 +9907,9 @@ function parseWorkbookFromXlsx(xlsx) {
 /** Reusable TextEncoder (stateless, safe to share). */
 const encoder$1 = new TextEncoder();
 const WORKSHEET_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml";
-const WORKSHEET_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet";
-const COMMENTS_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments";
-const VML_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/vmlDrawing";
+const WORKSHEET_REL_TYPE = RELATIONSHIP_TYPES.worksheet;
+const COMMENTS_REL_TYPE = RELATIONSHIP_TYPES.comments;
+const VML_REL_TYPE = RELATIONSHIP_TYPES.vmlDrawing;
 const COMMENTS_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.spreadsheetml.comments+xml";
 const VML_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.vmlDrawing";
 /**
@@ -10402,17 +10403,16 @@ function appendCommentsToMap(xmlMap, vmlFiles, sheetName, commentOpts) {
 	}
 }
 //#endregion
-//#region src/compiler.ts
+//#region src/compile/sheet-drawing.ts
 /**
-* XLSX Compiler — compiles WorkbookOptions into a Zippable structure.
-*
-* Accepts pure JSON WorkbookOptions — no intermediate File class needed.
-* Uses XlsxWriteContext for shared state (strings, styles, media, charts).
+* Worksheet drawing compile phase: images, charts, SmartArt, shapes,
+* connectors, and groups on a sheet — the drawing part, its relationships,
+* and the `<drawing>` reference inserted into the sheet XML.
 *
 * @module
 */
-const XML_DECL = OOXML_XML_DECLARATION;
-const IMAGE_REL = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image";
+const XML_DECL$2 = OOXML_XML_DECLARATION;
+const IMAGE_REL$1 = RELATIONSHIP_TYPES.image;
 /**
 * Replace `{fileName}` media placeholders in compiled part XML with
 * relationship ids. Core fill descriptors register blip-fill images through
@@ -10435,592 +10435,171 @@ function bindMediaPlaceholders(xml, media, rels) {
 		let rid = ridByName.get(name);
 		if (rid === void 0) {
 			if (!names.has(name)) return whole;
-			rid = `rId${rels.add(IMAGE_REL, `../media/${name}`)}`;
+			rid = `rId${rels.add(IMAGE_REL$1, `../media/${name}`)}`;
 			ridByName.set(name, rid);
 		}
 		return rid;
 	});
 }
-/** XLSX part path → content type, derived from the part registry. Matches
-* actual file paths, so the dense/sequential xlsx part naming is handled. */
-const XLSX_CONTENT_TYPE_RESOLVER$1 = resolverFromRegistry(XLSX_PARTS);
-/** Chart part → user-shapes part relationship (c:userShapes bridge). */
-const CHART_USER_SHAPES_REL = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chartUserShapes";
-const PKG_REL_NS = "http://schemas.openxmlformats.org/package/2006/relationships";
-/** Extension → MIME for image and VML Default entries. Declared only for
-* extensions actually present in the package. VML backs legacy comment
-* anchors (xl/drawings/vmlDrawing${i}.vml). */
-const XLSX_MEDIA_CONTENT_TYPES = {
-	...IMAGE_MEDIA_CONTENT_TYPES,
-	vml: "application/vnd.openxmlformats-officedocument.vmlDrawing"
-};
-/** UTF-8 encoder for serializing the derived [Content_Types].xml into the package. */
-const encoder = new TextEncoder();
-/**
-* Compile workbook options into a Zippable structure.
-*/
-function compileWorkbook(options, overrides = [], mediaLevel = 0) {
-	const ctx = new XlsxWriteContext();
-	const mapping = {};
-	if (options.sharedStrings) ctx.sharedStrings.loadEntries(options.sharedStrings);
-	const worksheetConfigs = options.worksheets ?? [];
-	const chartsheetConfigs = options.chartsheets ?? [];
-	const dialogsheetConfigs = options.dialogsheets ?? [];
-	const hasCustomProperties = !!options.customProperties && options.customProperties.length > 0;
-	mapping["Properties"] = {
-		data: XML_DECL + buildCorePropertiesXmlString(options),
-		path: "docProps/core.xml"
-	};
-	mapping["AppProperties"] = {
-		data: XML_DECL + (appPropertiesDesc.stringify(options.appProperties ?? {}, ctx) ?? ""),
-		path: "docProps/app.xml"
-	};
-	if (hasCustomProperties) mapping["CustomProperties"] = {
-		data: XML_DECL + (customPropertiesDesc.stringify({ properties: options.customProperties ?? [] }, ctx) ?? ""),
-		path: "docProps/custom.xml"
-	};
-	const fileRels = buildRootRelationships("xl/workbook.xml", hasCustomProperties, options.passthroughRelationships);
-	mapping["FileRelationships"] = {
-		data: XML_DECL + fileRels.serialize(),
-		path: "_rels/.rels"
-	};
-	if (options.dxfs !== void 0) ctx.styles.setDxfs(options.dxfs);
-	if (options.fonts !== void 0) ctx.styles.adopt({
-		fonts: options.fonts,
-		fills: options.fills ?? [],
-		borders: options.borders ?? [],
-		cellXfs: options.cellXfs ?? [],
-		numFmts: options.numFmts
-	});
-	if (options.colors) ctx.styles.setColors(options.colors);
-	if (options.tableStyles) ctx.styles.setTableStyles(options.tableStyles);
-	if (options.cellStyles !== void 0) ctx.styles.setCustomCellStyles(options.cellStyles);
-	if (options.cellStyleXfs !== void 0) ctx.styles.setCellStyleXfs(options.cellStyleXfs);
-	if (options.styleExtensions) ctx.styles.setExtensions(options.styleExtensions);
-	buildWorkbookRelationships(ctx.workbookRels, worksheetConfigs.length, chartsheetConfigs.length, dialogsheetConfigs.length);
-	const sheets = [];
-	let sheetId = 1;
-	const nextSheetId = (explicit) => {
-		const id = explicit ?? sheetId;
-		if (id >= sheetId) sheetId = id + 1;
-		return id;
-	};
-	let rId = 1;
-	for (const ws of worksheetConfigs) sheets.push({
-		name: ws.name ?? `Sheet${sheetId}`,
-		sheetId: nextSheetId(ws.sheetId),
-		state: ws.state,
-		rId: `rId${rId++}`
-	});
-	for (const cs of chartsheetConfigs) sheets.push({
-		name: cs.name ?? `Chart${sheetId}`,
-		sheetId: nextSheetId(cs.sheetId),
-		state: cs.state,
-		rId: `rId${rId++}`
-	});
-	for (const ds of dialogsheetConfigs) sheets.push({
-		name: ds.name ?? `Dialog${sheetId}`,
-		sheetId: nextSheetId(ds.sheetId),
-		state: ds.state,
-		rId: `rId${rId++}`
-	});
-	const wsContext = {
-		sharedStrings: ctx.sharedStrings,
-		styles: ctx.styles
-	};
-	const state = {
-		globalMediaIdx: 0,
-		globalChartIdx: 0,
-		globalPivotIdx: 0,
-		globalPivotCacheIdx: 0,
-		globalTableIdx: 0,
-		globalQueryTableIdx: 0,
-		globalSingleXmlCellsIdx: 0,
-		pivotCacheDataMap: /* @__PURE__ */ new Map(),
-		calcCells: [],
-		allTableParts: []
-	};
-	for (const [i, wsOpts] of worksheetConfigs.entries()) compileWorksheetPart(wsOpts, i, worksheetConfigs, ctx, mapping, wsContext, state, options.passthroughRelationships);
-	compileChartsheets(chartsheetConfigs, ctx, mapping, options.passthroughRelationships);
-	compileDialogsheets(dialogsheetConfigs, ctx, mapping);
-	let rtPivotRefs;
-	if (options.pivotCacheRefs && options.pivotCacheRefs.length > 0) {
-		rtPivotRefs = [];
-		for (const ref of options.pivotCacheRefs) {
-			const rel = (options.passthroughRelationships ?? []).find((r) => r.source === "xl/workbook.xml" && r.rId === ref.rId);
-			if (!rel) continue;
-			let rid = ctx.workbookRels.idOf(rel.relationshipType, rel.target);
-			if (rid === void 0) {
-				ctx.workbookRels.add(rel.relationshipType, rel.target);
-				rid = ctx.workbookRels.idOf(rel.relationshipType, rel.target);
+/** Compile a sheet's drawing: register image/chart/SmartArt media and
+* relationships, serialize the drawing part via the descriptor, bind media
+* and text-hyperlink placeholders, and splice the `<drawing r:id>` element
+* into the sheet XML at its CT_Worksheet position. Returns the updated XML. */
+function compileSheetDrawing(wsOpts, i, sheetXml, ctx, mapping, state, wsRels) {
+	const imgOpts = wsOpts.images ?? [];
+	const chartOpts = wsOpts.charts ?? [];
+	const smartArtOpts = wsOpts.smartArts ?? [];
+	const shapeOpts = wsOpts.shapes ?? [];
+	const connectorOpts = wsOpts.connectors ?? [];
+	const groupOpts = wsOpts.groups ?? [];
+	const drawingImages = [];
+	const drawingCharts = [];
+	const drawingSmartArts = [];
+	const drawingRels = new Relationships();
+	let rid = 1;
+	for (const img of imgOpts) {
+		let embedRid;
+		let linkRid;
+		if (img.data !== void 0) {
+			const ext = img.type === "jpg" ? "jpeg" : img.type;
+			const rawBytes = toUint8Array(img.data, { encoding: "base64" });
+			const target = `../media/${ctx.media.addMedia(rawBytes, ext, (fileName) => ({
+				fileName,
+				type: ext,
+				data: rawBytes,
+				width: 0,
+				height: 0
+			})).fileName}`;
+			embedRid = drawingRels.idOf(IMAGE_REL$1, target);
+			if (embedRid === void 0) {
+				drawingRels.addRelationship(rid, IMAGE_REL$1, target);
+				embedRid = `rId${rid}`;
+				rid++;
 			}
-			if (rid) rtPivotRefs.push({
-				cacheId: ref.cacheId,
-				rId: rid
-			});
+			state.globalMediaIdx++;
 		}
+		if (img.sourceUrl !== void 0) {
+			drawingRels.addRelationship(rid, IMAGE_REL$1, img.sourceUrl, "External");
+			linkRid = `rId${rid}`;
+			rid++;
+		}
+		drawingImages.push({
+			...pickAnchorOptions(img),
+			rId: embedRid ?? "",
+			...linkRid ? { linkRId: linkRid } : {},
+			...pickNonVisualDrawingProperties(img),
+			...img.properties ? { properties: img.properties } : {},
+			...img.blackWhiteMode ? { blackWhiteMode: img.blackWhiteMode } : {},
+			...img.sourceRectangle ? { sourceRectangle: img.sourceRectangle } : {},
+			...img.preferRelativeResize !== void 0 ? { preferRelativeResize: img.preferRelativeResize } : {},
+			...img.blipEffects ? { blipEffects: img.blipEffects } : {},
+			...img.useLocalDpi !== void 0 ? { useLocalDpi: img.useLocalDpi } : {},
+			...img.blipExt !== void 0 ? { blipExt: img.blipExt } : {},
+			...img.locking ? { locking: img.locking } : {},
+			...img.hyperlink ? { hyperlink: img.hyperlink } : {},
+			...img.zOrder !== void 0 ? { zOrder: img.zOrder } : {},
+			...img.shapeId !== void 0 ? { shapeId: img.shapeId } : {}
+		});
 	}
-	let wbXml = workbookDesc.stringify({
-		sheets,
-		pivotCaches: ctx.pivotCacheRefs.length > 0 ? ctx.pivotCacheRefs : rtPivotRefs ?? [],
-		protection: options.workbookProtection,
-		customViews: options.customWorkbookViews,
-		fileRecovery: options.fileRecovery,
-		functionGroups: options.functionGroups,
-		webPublishing: options.webPublishing,
-		fileSharing: options.fileSharing,
-		webPublishObjects: options.webPublishObjects,
-		definedNames: options.definedNames,
-		properties: options.properties,
-		calculation: options.calculation,
-		oleSize: options.oleSize,
-		bookView: options.bookView,
-		...options.absPath !== void 0 ? { absPath: options.absPath } : {},
-		...options.revisionPtr ? { revisionPtr: options.revisionPtr } : {},
-		...options.extensions ? { extensions: options.extensions } : {}
-	}, ctx) ?? "";
-	if (options.connections && options.connections.length > 0) {
-		const cRid = ctx.workbookRels.nextRelationshipId;
-		ctx.workbookRels.addRelationship(cRid, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/connections", "connections.xml");
-		mapping["Connections"] = {
-			data: XML_DECL + connectionsDesc.stringify({ connections: options.connections }, ctx),
-			path: "xl/connections.xml"
-		};
-	}
-	if (options.metadata && hasMetadataContent(options.metadata)) {
-		const mRid = ctx.workbookRels.nextRelationshipId;
-		ctx.workbookRels.addRelationship(mRid, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/sheetMetadata", "metadata.xml");
-		mapping["Metadata"] = {
-			data: XML_DECL + metadataDesc.stringify(options.metadata, ctx),
-			path: "xl/metadata.xml"
-		};
-	}
-	if (options.xmlMaps) {
-		const xRid = ctx.workbookRels.nextRelationshipId;
-		ctx.workbookRels.addRelationship(xRid, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/xmlMaps", "xmlMaps.xml");
-		mapping["XmlMaps"] = {
-			data: XML_DECL + mapInfoDesc.stringify(options.xmlMaps, ctx),
-			path: "xl/xmlMaps.xml"
-		};
-	}
-	if (options.volTypes && options.volTypes.length > 0) {
-		const vRid = ctx.workbookRels.nextRelationshipId;
-		ctx.workbookRels.addRelationship(vRid, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/volTypes", "volTypes.xml");
-		mapping["VolTypes"] = {
-			data: XML_DECL + buildVolTypesXml(options.volTypes),
-			path: "xl/volTypes.xml"
+	for (const chart of chartOpts) {
+		const chartKey = `chart_${state.globalChartIdx}`;
+		const userShapes = chart.userShapes ? buildUserShapesData(chart.userShapes) : void 0;
+		ctx.charts.addChart(chartKey, {
+			key: chartKey,
+			chartSpaceXml: chartSpaceDesc.stringify(chart, ctx) ?? "",
+			...userShapes ? { userShapes } : {}
+		});
+		drawingRels.addRelationship(rid, RELATIONSHIP_TYPES.chart, `../charts/chart${state.globalChartIdx + 1}.xml`);
+		const chartCnvPr = pickNonVisualDrawingProperties({
+			...chart,
+			title: void 0,
+			ext: void 0
+		});
+		drawingCharts.push({
+			...pickAnchorOptions(chart),
+			...chartCnvPr,
+			rId: `rId${rid}`,
+			...chart.frameLocks ? { frameLocks: chart.frameLocks } : {},
+			...chart.macro !== void 0 ? { macro: chart.macro } : {},
+			...chart.hyperlink ? { hyperlink: chart.hyperlink } : {},
+			...chart.zOrder !== void 0 ? { zOrder: chart.zOrder } : {},
+			...chart.shapeId !== void 0 ? { shapeId: chart.shapeId } : {}
+		});
+		rid++;
+		state.globalChartIdx++;
+	}
+	for (const sa of smartArtOpts) {
+		const relTarget = (path) => path.startsWith("xl/") ? `../${path.slice(3)}` : path;
+		const addDiagRel = (relType, path) => {
+			const target = relTarget(path);
+			const existing = drawingRels.idOf(relType, target);
+			if (existing !== void 0) return existing;
+			drawingRels.addRelationship(rid, relType, target);
+			return `rId${rid++}`;
 		};
+		const relBase = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+		drawingSmartArts.push({
+			...pickAnchorOptions(sa),
+			...pickNonVisualDrawingProperties(sa),
+			dataRId: addDiagRel(`${relBase}/diagramData`, sa.dataPath),
+			layoutRId: addDiagRel(`${relBase}/diagramLayout`, sa.layoutPath),
+			quickStyleRId: addDiagRel(`${relBase}/diagramQuickStyle`, sa.quickStylePath),
+			colorsRId: addDiagRel(`${relBase}/diagramColors`, sa.colorsPath),
+			...sa.frameLocks ? { frameLocks: sa.frameLocks } : {},
+			...sa.macro !== void 0 ? { macro: sa.macro } : {},
+			...sa.zOrder !== void 0 ? { zOrder: sa.zOrder } : {},
+			...sa.shapeId !== void 0 ? { shapeId: sa.shapeId } : {}
+		});
 	}
-	const extLinks = options.externalLinks ?? [];
-	if (extLinks.length > 0) {
-		const extRefs = [];
-		for (let ei = 0; ei < extLinks.length; ei++) {
-			const elIdx = ei + 1;
-			const elRid = ctx.workbookRels.nextRelationshipId;
-			ctx.workbookRels.addRelationship(elRid, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/externalLink", `externalLinks/externalLink${elIdx}.xml`);
-			const elOpts = extLinks[ei];
-			if (!elOpts) continue;
-			let bookRId;
-			if (elOpts.externalBook?.target) {
-				const elRels = new Relationships();
-				elRels.addRelationship(1, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/externalLinkPath", elOpts.externalBook.target, TargetModeType.EXTERNAL);
-				bookRId = "rId1";
-				mapping[`ExternalLinkRels${elIdx}`] = {
-					data: XML_DECL + elRels.serialize(),
-					path: `xl/externalLinks/_rels/externalLink${elIdx}.xml.rels`
-				};
-			}
-			mapping[`ExternalLink${elIdx}`] = {
-				data: XML_DECL + externalLinkDesc.stringify({
-					...elOpts,
-					bookRId
-				}, ctx),
-				path: `xl/externalLinks/externalLink${elIdx}.xml`
-			};
-			extRefs.push({ rId: `rId${elRid}` });
+	const hyperlinkBase = ctx.hyperlinks.length;
+	let resolvedDrawingXml = drawingDesc.stringify({
+		images: drawingImages,
+		charts: drawingCharts,
+		smartArts: drawingSmartArts,
+		shapes: shapeOpts,
+		connectors: connectorOpts,
+		groups: groupOpts
+	}, ctx);
+	const hlinkRidByUrl = /* @__PURE__ */ new Map();
+	for (const h of ctx.hyperlinks.slice(hyperlinkBase)) {
+		let hlinkRid = hlinkRidByUrl.get(h.url);
+		if (hlinkRid === void 0) {
+			drawingRels.addRelationship(rid, RELATIONSHIP_TYPES.hyperlink, h.url, "External");
+			hlinkRid = rid;
+			hlinkRidByUrl.set(h.url, hlinkRid);
+			rid++;
 		}
-		const extRefsXml = buildExternalReferencesXml(extRefs);
-		wbXml = wbXml.replace("<!--EXTERNAL_REFS-->", extRefsXml);
-	} else wbXml = wbXml.replace("<!--EXTERNAL_REFS-->", "");
-	mapping["Workbook"] = {
-		data: XML_DECL + wbXml,
-		path: "xl/workbook.xml"
-	};
-	if (ctx.sharedStrings.count > 0) {
-		ctx.workbookRels.addRelationship(ctx.workbookRels.nextRelationshipId, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/sharedStrings", "sharedStrings.xml");
-		const ssXml = sharedStringsDesc.stringify(ctx.sharedStrings.toDescriptorOptions(), ctx);
-		mapping["SharedStrings"] = {
-			data: XML_DECL + ssXml,
-			path: "xl/sharedStrings.xml"
-		};
+		resolvedDrawingXml = resolvedDrawingXml.split(`r:id="{hlink:${h.key}}"`).join(`r:id="rId${hlinkRid}"`);
 	}
-	const stylesXml = stylesDesc.stringify({ styles: ctx.styles }, ctx);
-	mapping["Styles"] = {
-		data: XML_DECL + stylesXml,
-		path: "xl/styles.xml"
+	resolvedDrawingXml = bindMediaPlaceholders(resolvedDrawingXml, ctx.media, drawingRels);
+	const drawingIdx = i + 1;
+	mapping[`Drawing${i}`] = {
+		data: XML_DECL$2 + resolvedDrawingXml,
+		path: `xl/drawings/drawing${drawingIdx}.xml`
 	};
-	const themeRels = new Relationships();
-	const themeXml = options.theme ? bindMediaPlaceholders(buildThemeXml(options.theme, ctx), ctx.media, themeRels) : createThemeXml$1();
-	mapping["Theme"] = {
-		data: XML_DECL + themeXml,
-		path: "xl/theme/theme1.xml"
-	};
-	if (themeRels.relationshipCount > 0) mapping["ThemeRels"] = {
-		data: XML_DECL + themeRels.serialize(),
-		path: "xl/theme/_rels/theme1.xml.rels"
+	mapping[`DrawingRels${i}`] = {
+		data: XML_DECL$2 + drawingRels.serialize(),
+		path: `xl/drawings/_rels/drawing${drawingIdx}.xml.rels`
 	};
-	for (const [i, chartData] of ctx.charts.array.entries()) {
-		mapping[`Chart${i}`] = {
-			data: XML_DECL + chartData.chartSpaceXml,
-			path: `xl/charts/chart${i + 1}.xml`
-		};
-		if (chartData.userShapes) {
-			const rid = chartData.userShapes.relationshipId;
-			mapping[`ChartUserShapes${i}`] = {
-				data: XML_DECL + chartData.userShapes.xml,
-				path: `xl/charts/userShapes${i + 1}.xml`
-			};
-			mapping[`ChartRels${i}`] = {
-				data: XML_DECL + `<Relationships xmlns="${PKG_REL_NS}"><Relationship Id="${escapeXml(rid)}" Type="${CHART_USER_SHAPES_REL}" Target="userShapes${i + 1}.xml"/></Relationships>`,
-				path: `xl/charts/_rels/chart${i + 1}.xml.rels`
-			};
-		}
-	}
-	const calcChainCells = options.calcChain ?? state.calcCells;
-	const srcReferencesCalcChain = (options.passthroughRelationships ?? []).some((r) => r.source === "xl/workbook.xml" && r.relationshipType.endsWith("/calcChain"));
-	if (calcChainCells.length > 0 && !(srcReferencesCalcChain && options.calcChain === void 0)) {
-		mapping["CalcChain"] = {
-			data: calcChainDesc.stringify({ cells: calcChainCells }, ctx) ?? "",
-			path: "xl/calcChain.xml"
-		};
-		const calcChainRid = ctx.workbookRels.nextRelationshipId;
-		ctx.workbookRels.addRelationship(calcChainRid, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/calcChain", "calcChain.xml");
-	}
-	if (options.revisionLog) compileRevisionLogs(options.revisionLog, ctx, mapping);
-	for (const rel of options.passthroughRelationships ?? []) {
-		if (rel.source !== "xl/workbook.xml") continue;
-		if (ctx.workbookRels.hasRelationship(rel.relationshipType, rel.target)) continue;
-		ctx.workbookRels.add(rel.relationshipType, rel.target);
-	}
-	mapping["WorkbookRelationships"] = {
-		data: XML_DECL + ctx.workbookRels.serialize(),
-		path: "xl/_rels/workbook.xml.rels"
-	};
-	const mediaFiles = [];
-	for (const img of ctx.media.array) mediaFiles.push({
-		data: img.data,
-		path: `xl/media/${img.fileName}`
-	});
-	const files = compileMapping(mapping, overrides, mediaFiles, mediaLevel);
-	const passthroughSkipped = /* @__PURE__ */ new Set();
-	for (const part of options.rawParts ?? []) {
-		if (files[part.path] !== void 0) {
-			passthroughSkipped.add(part.path);
-			continue;
-		}
-		files[part.path] = toUint8Array(part.data);
-	}
-	const contentTypesInput = deriveContentTypes(Object.keys(files), {
-		resolve: XLSX_CONTENT_TYPE_RESOLVER$1,
-		mediaContentTypes: XLSX_MEDIA_CONTENT_TYPES,
-		source: options.contentTypes,
-		verbatimPaths: new Set((options.rawParts ?? []).map((p) => p.path))
-	});
-	const coveredExt = new Set(contentTypesInput.defaults.map((d) => d.extension.toLowerCase()));
-	for (const part of options.rawParts ?? []) {
-		if (part.contentType === void 0 || passthroughSkipped.has(part.path)) continue;
-		const dot = part.path.lastIndexOf(".");
-		const ext = dot > part.path.lastIndexOf("/") ? part.path.slice(dot + 1).toLowerCase() : void 0;
-		if (ext && coveredExt.has(ext)) continue;
-		contentTypesInput.overrides.push({
-			partName: `/${part.path}`,
-			contentType: part.contentType
-		});
-	}
-	files["[Content_Types].xml"] = encoder.encode(XML_DECL + (contentTypesDesc.stringify(contentTypesInput, ctx) ?? ""));
-	dropDanglingPassthroughRels(files, options.passthroughRelationships);
-	return files;
+	return editSheetTailMarker(sheetXml, "<!--DRAWING-->", `<drawing r:id="rId${wsRels.add(RELATIONSHIP_TYPES.drawing, `../drawings/drawing${drawingIdx}.xml`)}"/>`);
 }
+//#endregion
+//#region src/compile/sheet-pivots.ts
 /**
-* Compile one worksheet: sheet XML, calcChain cells, drawing/media,
-* comments + VML, background, pivots, tables, query tables and
-* single-cell XML tables, with their worksheet-level relationships.
-* Rel registration order is significant (rIds are assigned sequentially).
+* Worksheet pivot compile phase: pivot cache definitions/records, pivot
+* table parts with their relationships, and the rendered pivot grid
+* spliced into the sheet's sheetData.
+*
+* @module
 */
-function compileWorksheetPart(wsOpts, i, worksheetConfigs, ctx, mapping, wsContext, state, passthroughRelationships) {
-	const imgOpts = wsOpts.images ?? [];
-	const chartOpts = wsOpts.charts ?? [];
-	const smartArtOpts = wsOpts.smartArts ?? [];
-	const shapeOpts = wsOpts.shapes ?? [];
-	const connectorOpts = wsOpts.connectors ?? [];
-	const groupOpts = wsOpts.groups ?? [];
-	const hlOpts = wsOpts.hyperlinks ?? [];
-	const sheetName = wsOpts.name ?? `Sheet${i + 1}`;
-	const sheetIdx = wsOpts.sheetId ?? i + 1;
-	const wsRows = wsOpts.rows ?? [];
-	for (let ri = 0; ri < wsRows.length; ri++) {
-		const rowOpts = wsRows[ri];
-		const rowNumber = rowOpts.rowNumber ?? ri + 1;
-		const cells = rowOpts.cells;
-		if (!cells) continue;
-		for (let ci = 0; ci < cells.length; ci++) {
-			const cell = cells[ci];
-			if (!cell.formula) continue;
-			const ref = cell.reference ?? columnToLetter(ci + 1) + rowNumber;
-			state.calcCells.push({
-				reference: ref,
-				sheetIndex: sheetIdx,
-				array: typeof cell.formula === "object" && cell.formula.type === "array"
-			});
-		}
-	}
-	const hasMedia = imgOpts.length > 0 || chartOpts.length > 0 || smartArtOpts.length > 0 || shapeOpts.length > 0 || connectorOpts.length > 0 || groupOpts.length > 0;
-	const hasExternalHyperlinks = hlOpts.some((h) => h.url !== void 0);
-	const commentOpts = wsOpts.comments ?? [];
-	const hasComments = commentOpts.length > 0;
+const XML_DECL$1 = OOXML_XML_DECLARATION;
+/** Compile a sheet's pivot tables: cache parts (deduped by source reference),
+* pivot table parts with their rels, workbook-level cache registration, and
+* the worksheet rel entry. Rendering the grid into sheetData happens later
+* via renderPivotSheetData (it must run after the sheet XML is built). */
+function compileSheetPivots(wsOpts, worksheetConfigs, ctx, mapping, state, wsRels, sheetName) {
 	const pivotOpts = wsOpts.pivotTables ?? [];
-	const hasPivots = pivotOpts.length > 0;
-	const tableOpts = wsOpts.tables ?? [];
-	const hasTables = tableOpts.length > 0;
-	const queryTableOpts = wsOpts.queryTables ?? [];
-	const hasQueryTables = queryTableOpts.length > 0;
-	const singleXmlCellOpts = wsOpts.singleXmlCells ?? [];
-	const bgImg = wsOpts.backgroundImage;
-	const wsPath = `xl/worksheets/sheet${i + 1}.xml`;
-	let wsRels;
-	if (hasMedia || hasExternalHyperlinks || hasComments || hasPivots || hasTables || hasQueryTables || singleXmlCellOpts.length > 0 || bgImg) {
-		wsRels = new Relationships();
-		wsRels.reserveSourceRids(wsPath, passthroughRelationships ?? []);
-	}
-	const resolvePassthroughRid = (typeFragment, originalRid) => {
-		if (!wsRels) return originalRid;
-		const rel = (passthroughRelationships ?? []).find((r) => r.source === wsPath && r.rId === originalRid && r.relationshipType.endsWith(typeFragment));
-		if (!rel) return originalRid;
-		const existing = wsRels.idOf(rel.relationshipType, rel.target);
-		if (existing) return existing;
-		if (wsRels.hasId(originalRid)) return `rId${wsRels.add(rel.relationshipType, rel.target)}`;
-		wsRels.addRelationship(originalRid, rel.relationshipType, rel.target);
-		return originalRid;
-	};
-	const resolveEmbeddingRid = (originalRid) => {
-		const rid = resolvePassthroughRid("/oleObject", originalRid);
-		return rid === originalRid ? resolvePassthroughRid("/package", originalRid) : rid;
-	};
-	let xmlOpts = wsOpts;
-	if (wsRels && (passthroughRelationships?.length ?? 0) > 0) {
-		const oleObjects = wsOpts.oleObjects?.map((ole) => ({
-			...ole,
-			rId: ole.rId ? resolveEmbeddingRid(ole.rId) : ole.rId,
-			properties: ole.properties?.iconRid !== void 0 ? {
-				...ole.properties,
-				iconRid: resolvePassthroughRid("/image", ole.properties.iconRid)
-			} : ole.properties
-		}));
-		const controls = wsOpts.controls?.map((c) => ({
-			...c,
-			rId: resolvePassthroughRid("/controls", c.rId),
-			iconRid: c.iconRid !== void 0 ? resolvePassthroughRid("/image", c.iconRid) : c.iconRid
-		}));
-		const pageSetup = wsOpts.pageSetup?.printerSettingsRId ? {
-			...wsOpts.pageSetup,
-			printerSettingsRId: resolvePassthroughRid("/printerSettings", wsOpts.pageSetup.printerSettingsRId)
-		} : wsOpts.pageSetup;
-		const pivotSelection = wsOpts.pivotSelection?.rId ? {
-			...wsOpts.pivotSelection,
-			rId: resolvePassthroughRid("/pivotTable", wsOpts.pivotSelection.rId)
-		} : wsOpts.pivotSelection;
-		const legacyDrawingHF = wsOpts.legacyDrawingHF ? resolvePassthroughRid("/vmlDrawing", wsOpts.legacyDrawingHF) : wsOpts.legacyDrawingHF;
-		const customProperties = wsOpts.customProperties?.map((cp) => ({
-			...cp,
-			rId: resolvePassthroughRid("/customXml", cp.rId)
-		}));
-		xmlOpts = {
-			...wsOpts,
-			...oleObjects ? { oleObjects } : {},
-			...controls ? { controls } : {},
-			...pageSetup !== wsOpts.pageSetup ? { pageSetup } : {},
-			...pivotSelection !== wsOpts.pivotSelection ? { pivotSelection } : {},
-			...legacyDrawingHF !== wsOpts.legacyDrawingHF ? { legacyDrawingHF } : {},
-			...customProperties ? { customProperties } : {}
-		};
-	}
-	let sheetXml = stringifyWorksheet(xmlOpts, wsContext);
-	if (hasExternalHyperlinks) for (const hl of hlOpts) {
-		if (hl.url === void 0) continue;
-		wsRels.add("http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink", hl.url, "External");
-	}
-	if (hasMedia) {
-		const drawingImages = [];
-		const drawingCharts = [];
-		const drawingSmartArts = [];
-		const drawingRels = new Relationships();
-		let rid = 1;
-		for (const img of imgOpts) {
-			let embedRid;
-			let linkRid;
-			if (img.data !== void 0) {
-				const ext = img.type === "jpg" ? "jpeg" : img.type;
-				const rawBytes = toUint8Array(img.data, { encoding: "base64" });
-				const target = `../media/${ctx.media.addMedia(rawBytes, ext, (fileName) => ({
-					fileName,
-					type: ext,
-					data: rawBytes,
-					width: 0,
-					height: 0
-				})).fileName}`;
-				embedRid = drawingRels.idOf(IMAGE_REL, target);
-				if (embedRid === void 0) {
-					drawingRels.addRelationship(rid, IMAGE_REL, target);
-					embedRid = `rId${rid}`;
-					rid++;
-				}
-				state.globalMediaIdx++;
-			}
-			if (img.sourceUrl !== void 0) {
-				drawingRels.addRelationship(rid, IMAGE_REL, img.sourceUrl, "External");
-				linkRid = `rId${rid}`;
-				rid++;
-			}
-			drawingImages.push({
-				...pickAnchorOptions(img),
-				rId: embedRid ?? "",
-				...linkRid ? { linkRId: linkRid } : {},
-				...pickNonVisualDrawingProperties(img),
-				...img.properties ? { properties: img.properties } : {},
-				...img.blackWhiteMode ? { blackWhiteMode: img.blackWhiteMode } : {},
-				...img.sourceRectangle ? { sourceRectangle: img.sourceRectangle } : {},
-				...img.preferRelativeResize !== void 0 ? { preferRelativeResize: img.preferRelativeResize } : {},
-				...img.blipEffects ? { blipEffects: img.blipEffects } : {},
-				...img.useLocalDpi !== void 0 ? { useLocalDpi: img.useLocalDpi } : {},
-				...img.blipExt !== void 0 ? { blipExt: img.blipExt } : {},
-				...img.locking ? { locking: img.locking } : {},
-				...img.hyperlink ? { hyperlink: img.hyperlink } : {},
-				...img.zOrder !== void 0 ? { zOrder: img.zOrder } : {},
-				...img.shapeId !== void 0 ? { shapeId: img.shapeId } : {}
-			});
-		}
-		for (const chart of chartOpts) {
-			const chartKey = `chart_${state.globalChartIdx}`;
-			const userShapes = chart.userShapes ? buildUserShapesData(chart.userShapes) : void 0;
-			ctx.charts.addChart(chartKey, {
-				key: chartKey,
-				chartSpaceXml: chartSpaceDesc.stringify(chart, ctx) ?? "",
-				...userShapes ? { userShapes } : {}
-			});
-			drawingRels.addRelationship(rid, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart", `../charts/chart${state.globalChartIdx + 1}.xml`);
-			const chartCnvPr = pickNonVisualDrawingProperties({
-				...chart,
-				title: void 0,
-				ext: void 0
-			});
-			drawingCharts.push({
-				...pickAnchorOptions(chart),
-				...chartCnvPr,
-				rId: `rId${rid}`,
-				...chart.frameLocks ? { frameLocks: chart.frameLocks } : {},
-				...chart.macro !== void 0 ? { macro: chart.macro } : {},
-				...chart.hyperlink ? { hyperlink: chart.hyperlink } : {},
-				...chart.zOrder !== void 0 ? { zOrder: chart.zOrder } : {},
-				...chart.shapeId !== void 0 ? { shapeId: chart.shapeId } : {}
-			});
-			rid++;
-			state.globalChartIdx++;
-		}
-		for (const sa of smartArtOpts) {
-			const relTarget = (path) => path.startsWith("xl/") ? `../${path.slice(3)}` : path;
-			const addDiagRel = (relType, path) => {
-				const target = relTarget(path);
-				const existing = drawingRels.idOf(relType, target);
-				if (existing !== void 0) return existing;
-				drawingRels.addRelationship(rid, relType, target);
-				return `rId${rid++}`;
-			};
-			const relBase = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
-			drawingSmartArts.push({
-				...pickAnchorOptions(sa),
-				...pickNonVisualDrawingProperties(sa),
-				dataRId: addDiagRel(`${relBase}/diagramData`, sa.dataPath),
-				layoutRId: addDiagRel(`${relBase}/diagramLayout`, sa.layoutPath),
-				quickStyleRId: addDiagRel(`${relBase}/diagramQuickStyle`, sa.quickStylePath),
-				colorsRId: addDiagRel(`${relBase}/diagramColors`, sa.colorsPath),
-				...sa.frameLocks ? { frameLocks: sa.frameLocks } : {},
-				...sa.macro !== void 0 ? { macro: sa.macro } : {},
-				...sa.zOrder !== void 0 ? { zOrder: sa.zOrder } : {},
-				...sa.shapeId !== void 0 ? { shapeId: sa.shapeId } : {}
-			});
-		}
-		const hyperlinkBase = ctx.hyperlinks.length;
-		let resolvedDrawingXml = drawingDesc.stringify({
-			images: drawingImages,
-			charts: drawingCharts,
-			smartArts: drawingSmartArts,
-			shapes: shapeOpts,
-			connectors: connectorOpts,
-			groups: groupOpts
-		}, ctx);
-		const hlinkRidByUrl = /* @__PURE__ */ new Map();
-		for (const h of ctx.hyperlinks.slice(hyperlinkBase)) {
-			let hlinkRid = hlinkRidByUrl.get(h.url);
-			if (hlinkRid === void 0) {
-				drawingRels.addRelationship(rid, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink", h.url, "External");
-				hlinkRid = rid;
-				hlinkRidByUrl.set(h.url, hlinkRid);
-				rid++;
-			}
-			resolvedDrawingXml = resolvedDrawingXml.split(`r:id="{hlink:${h.key}}"`).join(`r:id="rId${hlinkRid}"`);
-		}
-		resolvedDrawingXml = bindMediaPlaceholders(resolvedDrawingXml, ctx.media, drawingRels);
-		const drawingIdx = i + 1;
-		mapping[`Drawing${i}`] = {
-			data: XML_DECL + resolvedDrawingXml,
-			path: `xl/drawings/drawing${drawingIdx}.xml`
-		};
-		mapping[`DrawingRels${i}`] = {
-			data: XML_DECL + drawingRels.serialize(),
-			path: `xl/drawings/_rels/drawing${drawingIdx}.xml.rels`
-		};
-		const drawingRid = wsRels.add("http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing", `../drawings/drawing${drawingIdx}.xml`);
-		sheetXml = editSheetTailMarker(sheetXml, "<!--DRAWING-->", `<drawing r:id="rId${drawingRid}"/>`);
-	}
-	if (hasComments) {
-		const commentsIdx = i + 1;
-		const commentsXml = commentsDesc.stringify({ comments: commentOpts }, ctx);
-		mapping[`Comments${i}`] = {
-			data: XML_DECL + commentsXml,
-			path: `xl/comments${commentsIdx}.xml`
-		};
-		const vmlXml = vmlNotesDesc.stringify({ comments: commentOpts }, ctx);
-		mapping[`VmlDrawing${i}`] = {
-			data: XML_DECL + vmlXml,
-			path: `xl/drawings/vmlDrawing${commentsIdx}.vml`
-		};
-		wsRels.add("http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments", `../comments${commentsIdx}.xml`);
-		const vmlRid = wsRels.add("http://schemas.openxmlformats.org/officeDocument/2006/relationships/vmlDrawing", `../drawings/vmlDrawing${commentsIdx}.vml`);
-		sheetXml = editSheetTailMarker(sheetXml, "<!--LEGACY_DRAWING-->", `<legacyDrawing r:id="rId${vmlRid}"/>`);
-	}
-	if (bgImg) {
-		const ext = bgImg.type === "jpg" ? "jpeg" : bgImg.type;
-		const rawBytes = toUint8Array(bgImg.data, { encoding: "base64" });
-		const entry = ctx.media.addMedia(rawBytes, ext, (fileName) => ({
-			fileName,
-			type: ext,
-			data: rawBytes,
-			width: 0,
-			height: 0
-		}));
-		state.globalMediaIdx++;
-		const bgRid = wsRels.add(IMAGE_REL, `../media/${entry.fileName}`);
-		sheetXml = editSheetTailMarker(sheetXml, "<!--BACKGROUND_PICTURE-->", `<picture r:id="rId${bgRid}"/>`);
-	}
-	if (wsOpts.drawingRid) {
-		const rid = escapeXml(resolvePassthroughRid("/drawing", wsOpts.drawingRid));
-		sheetXml = editSheetTailMarker(sheetXml, "<!--DRAWING-->", `<drawing r:id="${rid}"/>`);
-	}
-	if (wsOpts.legacyDrawingRid) {
-		const rid = escapeXml(resolvePassthroughRid("/vmlDrawing", wsOpts.legacyDrawingRid));
-		sheetXml = editSheetTailMarker(sheetXml, "<!--LEGACY_DRAWING-->", `<legacyDrawing r:id="${rid}"/>`);
-	}
-	if (hasPivots) for (const pt of pivotOpts) {
+	for (const pt of pivotOpts) {
 		state.globalPivotIdx++;
 		const pivotIdx = state.globalPivotIdx;
 		const sourceSheet = pt.sourceSheet ?? sheetName;
@@ -11045,8 +10624,8 @@ function compileWorksheetPart(wsOpts, i, worksheetConfigs, ctx, mapping, wsConte
 				cacheIdx
 			});
 			const cacheDefRels = new Relationships();
-			cacheDefRels.addRelationship(1, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotCacheRecords", "pivotCacheRecords1.xml");
-			const cacheDefXml = XML_DECL + pivotCacheDefDesc.stringify({
+			cacheDefRels.addRelationship(1, RELATIONSHIP_TYPES.pivotCacheRecords, "pivotCacheRecords1.xml");
+			const cacheDefXml = XML_DECL$1 + pivotCacheDefDesc.stringify({
 				sourceRef: pt.source.split(":")[0] ? pt.source : "A1",
 				sourceSheet,
 				sourceData,
@@ -11057,22 +10636,22 @@ function compileWorksheetPart(wsOpts, i, worksheetConfigs, ctx, mapping, wsConte
 				path: `xl/pivotCache/pivotCacheDefinition${cacheIdx}.xml`
 			};
 			mapping[`PivotCacheDefRels${cacheIdx}`] = {
-				data: XML_DECL + cacheDefRels.serialize(),
+				data: XML_DECL$1 + cacheDefRels.serialize(),
 				path: `xl/pivotCache/_rels/pivotCacheDefinition${cacheIdx}.xml.rels`
 			};
-			const cacheRecordsXml = XML_DECL + pivotCacheRecordsDesc.stringify({ sourceData }, ctx);
+			const cacheRecordsXml = XML_DECL$1 + pivotCacheRecordsDesc.stringify({ sourceData }, ctx);
 			mapping[`PivotCacheRecords${cacheIdx}`] = {
 				data: cacheRecordsXml,
 				path: `xl/pivotCache/pivotCacheRecords${cacheIdx}.xml`
 			};
 			const wbPivotRid = ctx.workbookRels.nextRelationshipId;
-			ctx.workbookRels.addRelationship(wbPivotRid, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotCacheDefinition", `pivotCache/pivotCacheDefinition${cacheIdx}.xml`);
+			ctx.workbookRels.addRelationship(wbPivotRid, RELATIONSHIP_TYPES.pivotCacheDefinition, `pivotCache/pivotCacheDefinition${cacheIdx}.xml`);
 			ctx.pivotCacheRefs.push({
 				cacheId,
 				rId: `rId${wbPivotRid}`
 			});
 		}
-		const pivotTableXml = XML_DECL + pivotTableDesc.stringify({
+		const pivotTableXml = XML_DECL$1 + pivotTableDesc.stringify({
 			options: pt,
 			sourceData,
 			cacheId
@@ -11082,225 +10661,43 @@ function compileWorksheetPart(wsOpts, i, worksheetConfigs, ctx, mapping, wsConte
 			path: `xl/pivotTables/pivotTable${pivotIdx}.xml`
 		};
 		const ptRels = new Relationships();
-		ptRels.addRelationship(1, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotCacheDefinition", `../pivotCache/pivotCacheDefinition${cacheIdx}.xml`);
+		ptRels.addRelationship(1, RELATIONSHIP_TYPES.pivotCacheDefinition, `../pivotCache/pivotCacheDefinition${cacheIdx}.xml`);
 		mapping[`PivotTableRels${pivotIdx}`] = {
-			data: XML_DECL + ptRels.serialize(),
+			data: XML_DECL$1 + ptRels.serialize(),
 			path: `xl/pivotTables/_rels/pivotTable${pivotIdx}.xml.rels`
 		};
-		wsRels.add("http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotTable", `../pivotTables/pivotTable${pivotIdx}.xml`);
-	}
-	const wsTableParts = [];
-	if (hasTables) for (const tbl of tableOpts) {
-		state.globalTableIdx++;
-		const tableIdx = state.globalTableIdx;
-		if (!tbl.columns?.length) continue;
-		const tableXmlStr = XML_DECL + tableDesc.stringify({
-			...tbl,
-			id: tbl.id ?? tableIdx
-		}, ctx);
-		mapping[`Table${tableIdx}`] = {
-			data: tableXmlStr,
-			path: `xl/tables/table${tableIdx}.xml`
-		};
-		const tblRid = wsRels.add("http://schemas.openxmlformats.org/officeDocument/2006/relationships/table", `../tables/table${tableIdx}.xml`);
-		wsTableParts.push({ rId: `rId${tblRid}` });
-		state.allTableParts.push({ rId: `rId${tblRid}` });
-	}
-	if (hasQueryTables) for (const qt of queryTableOpts) {
-		state.globalQueryTableIdx++;
-		mapping[`QueryTable${state.globalQueryTableIdx}`] = {
-			data: XML_DECL + queryTableDesc.stringify(qt, ctx),
-			path: `xl/queryTables/queryTable${state.globalQueryTableIdx}.xml`
-		};
-		wsRels.add("http://schemas.openxmlformats.org/officeDocument/2006/relationships/queryTable", `../queryTables/queryTable${state.globalQueryTableIdx}.xml`);
+		wsRels.add(RELATIONSHIP_TYPES.pivotTable, `../pivotTables/pivotTable${pivotIdx}.xml`);
 	}
-	if (singleXmlCellOpts.length > 0) {
-		state.globalSingleXmlCellsIdx++;
-		mapping[`TableSingleCells${state.globalSingleXmlCellsIdx}`] = {
-			data: XML_DECL + singleXmlCellsDesc.stringify({ cells: singleXmlCellOpts }, ctx),
-			path: `xl/tables/tableSingleCells${state.globalSingleXmlCellsIdx}.xml`
-		};
-		wsRels.add("http://schemas.openxmlformats.org/officeDocument/2006/relationships/tableSingleCells", `../tables/tableSingleCells${state.globalSingleXmlCellsIdx}.xml`);
+}
+function extractPivotSourceData(rows, sourceRef) {
+	const parts = sourceRef.split(":");
+	const start = parseA1Cell(parts[0] ?? "");
+	if (!start) return {
+		fieldNames: [],
+		records: []
+	};
+	const end = parts[1] !== void 0 ? parseA1Cell(parts[1]) : void 0;
+	const startRow = start.row - 1;
+	const endRow = (end?.row ?? start.row) - 1;
+	const startCol = start.col - 1;
+	const endCol = (end?.col ?? start.col) - 1;
+	const colCount = endCol - startCol + 1;
+	const headerRow = rows[startRow];
+	const fieldNames = [];
+	if (headerRow?.cells) for (let c = startCol; c <= endCol && c < headerRow.cells.length; c++) {
+		const hv = headerRow.cells[c]?.value;
+		fieldNames.push(typeof hv === "string" ? hv : typeof hv === "number" || typeof hv === "boolean" ? String(hv) : `Col${c}`);
 	}
-	if (hasPivots) {
-		const rendered = renderPivotSheetData(pivotOpts, worksheetConfigs, ctx.sharedStrings, sheetName);
-		if (rendered.sheetData.length > 0) {
-			sheetXml = sheetXml.replace(/<sheetData\/>|<sheetData><\/sheetData>/, rendered.sheetData);
-			if (!sheetXml.includes("<dimension")) sheetXml = sheetXml.replace("<sheetViews", `<dimension ref="${rendered.dimensionRef}"/><sheetViews`);
-		}
-	}
-	if (wsTableParts.length > 0) sheetXml = editSheetTailMarker(sheetXml, "<!--TABLE_PARTS-->", buildTablePartsXml(wsTableParts));
-	sheetXml = stripWorksheetPlaceholders(sheetXml);
-	if (wsRels) for (const rel of passthroughRelationships ?? []) {
-		if (rel.source !== wsPath) continue;
-		wsRels.claimSourceRel(rel);
-	}
-	if (wsRels) mapping[`WorksheetRels${i}`] = {
-		data: XML_DECL + wsRels.serialize(),
-		path: `xl/worksheets/_rels/sheet${i + 1}.xml.rels`
-	};
-	mapping[`Worksheet${i}`] = {
-		data: sheetXml,
-		path: `xl/worksheets/sheet${i + 1}.xml`
-	};
-}
-/** Full-page default frame for a fresh chartsheet chart (≈9.70×6.35 in). */
-const CHARTSHEET_DEFAULT_CX = 9308969;
-const CHARTSHEET_DEFAULT_CY = 6096e3;
-/** Compile all chartsheets: chart part, chartsheet/drawing XML and rels. */
-function compileChartsheets(chartsheetConfigs, ctx, mapping, passthroughRelationships) {
-	for (const [i, csOpts] of chartsheetConfigs.entries()) {
-		const chartDef = csOpts.chart;
-		if (!chartDef) continue;
-		const csChartGlobalIdx = ctx.charts.array.length;
-		const csChartKey = `cs_chart_${csChartGlobalIdx}`;
-		const csUserShapes = chartDef.userShapes ? buildUserShapesData(chartDef.userShapes) : void 0;
-		ctx.charts.addChart(csChartKey, {
-			key: csChartKey,
-			chartSpaceXml: chartSpaceDesc.stringify(chartDef, ctx) ?? "",
-			...csUserShapes ? { userShapes: csUserShapes } : {}
-		});
-		const csRels = new Relationships();
-		const csDrawingIdx = i + 1;
-		csRels.addRelationship(1, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing", `../drawings/drawing${csDrawingIdx}.xml`);
-		let csNextRid = 2;
-		for (const rel of passthroughRelationships ?? []) {
-			if (rel.source !== `xl/chartsheets/sheet${i + 1}.xml`) continue;
-			if (csRels.hasRelationship(rel.relationshipType, rel.target)) continue;
-			csRels.addRelationship(csNextRid++, rel.relationshipType, rel.target);
-		}
-		const csDrawingRels = new Relationships();
-		csDrawingRels.addRelationship(1, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart", `../charts/chart${csChartGlobalIdx + 1}.xml`);
-		const frame = graphicFrameXml(csOpts.shapeId ?? 1, void 0, `Chart ${i + 1}`, "rId1", 0, 0, ctx, {
-			frameLocks: csOpts.frameLocks,
-			macro: csOpts.macro
-		});
-		const anchor = wrapAnchor({
-			anchorType: "absolute",
-			col: 1,
-			row: 1,
-			absoluteX: csOpts.absoluteX ?? 0,
-			absoluteY: csOpts.absoluteY ?? 0,
-			extentCx: csOpts.extentCx ?? CHARTSHEET_DEFAULT_CX,
-			extentCy: csOpts.extentCy ?? CHARTSHEET_DEFAULT_CY
-		}, `${frame}<xdr:clientData/>`);
-		const csDrawingXml = `<xdr:wsDr xmlns:xdr="${XDR_NS}" xmlns:a="${A_NS}" xmlns:r="${R_NS$1}">${anchor}</xdr:wsDr>`;
-		mapping[`ChartsheetDrawing${i}`] = {
-			data: csDrawingXml,
-			path: `xl/drawings/drawing${csDrawingIdx}.xml`
-		};
-		mapping[`ChartsheetDrawingRels${i}`] = {
-			data: XML_DECL + csDrawingRels.serialize(),
-			path: `xl/drawings/_rels/drawing${csDrawingIdx}.xml.rels`
-		};
-		mapping[`ChartsheetRels${i}`] = {
-			data: XML_DECL + csRels.serialize(),
-			path: `xl/chartsheets/_rels/sheet${i + 1}.xml.rels`
-		};
-		let csPageSetup = csOpts.pageSetup;
-		if (csPageSetup?.printerSettingsRId) {
-			const srcRid = csPageSetup.printerSettingsRId;
-			const rel = (passthroughRelationships ?? []).find((r) => r.source === `xl/chartsheets/sheet${i + 1}.xml` && r.rId === srcRid && r.relationshipType.endsWith("/printerSettings"));
-			const rid = rel ? csRels.idOf(rel.relationshipType, rel.target) ?? srcRid : srcRid;
-			if (rid !== srcRid) csPageSetup = {
-				...csPageSetup,
-				printerSettingsRId: rid
-			};
-		}
-		mapping[`Chartsheet${i}`] = {
-			data: XML_DECL + chartsheetDesc.stringify({
-				...csOpts,
-				drawingRId: "rId1",
-				pageSetup: csPageSetup
-			}, ctx),
-			path: `xl/chartsheets/sheet${i + 1}.xml`
-		};
-	}
-}
-/** Compile all dialog sheets (legacy Excel 5.0 dialog sheets). */
-function compileDialogsheets(dialogsheetConfigs, ctx, mapping) {
-	for (const [i, dsOpts] of dialogsheetConfigs.entries()) mapping[`Dialogsheet${i}`] = {
-		data: XML_DECL + dialogsheetDesc.stringify(dsOpts, ctx),
-		path: `xl/dialogSheets/sheet${i + 1}.xml`
-	};
-}
-/**
-* Compile shared-workbook revisions (xl/revisionHeaders.xml +
-* xl/revisions/revisionN.xml + xl/users.xml). CT_Workbook has no revision
-* element — parts are discovered via workbook.xml.rels + [Content_Types].
-*/
-function compileRevisionLogs(rl, ctx, mapping) {
-	const REV_HEADERS_REL = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/revisionHeaders";
-	const REV_LOG_REL = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/revisionLog";
-	const USERS_REL = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/users";
-	mapping["RevisionHeaders"] = {
-		data: XML_DECL + (revisionHeadersDesc.stringify(rl.headers, ctx) ?? ""),
-		path: "xl/revisionHeaders.xml"
-	};
-	ctx.workbookRels.addRelationship(ctx.workbookRels.nextRelationshipId, REV_HEADERS_REL, "revisionHeaders.xml");
-	const revHeadersRels = new Relationships();
-	for (const [i, log] of rl.logs.entries()) {
-		mapping[`RevisionLog${i}`] = {
-			data: XML_DECL + (revisionLogDesc.stringify(log, ctx) ?? ""),
-			path: `xl/revisions/revision${i + 1}.xml`
-		};
-		revHeadersRels.addRelationship(i + 1, REV_LOG_REL, `revisions/revision${i + 1}.xml`);
-	}
-	mapping["RevisionHeadersRels"] = {
-		data: XML_DECL + revHeadersRels.serialize(),
-		path: "xl/_rels/revisionHeaders.xml.rels"
-	};
-	if (rl.users) {
-		const usersXml = usersDesc.stringify(rl.users, ctx);
-		if (usersXml) {
-			mapping["Users"] = {
-				data: XML_DECL + usersXml,
-				path: "xl/users.xml"
-			};
-			ctx.workbookRels.addRelationship(ctx.workbookRels.nextRelationshipId, USERS_REL, "users.xml");
-		}
-	}
-}
-function buildWorkbookRelationships(rels, wsCount, csCount, dsCount = 0) {
-	let rid = 1;
-	for (let i = 0; i < wsCount; i++) rels.addRelationship(rid++, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet", `worksheets/sheet${i + 1}.xml`);
-	for (let i = 0; i < csCount; i++) rels.addRelationship(rid++, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chartsheet", `chartsheets/sheet${i + 1}.xml`);
-	for (let i = 0; i < dsCount; i++) rels.addRelationship(rid++, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/dialogsheet", `dialogSheets/sheet${i + 1}.xml`);
-	rels.addRelationship(rid++, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles", "styles.xml");
-	rels.addRelationship(rid++, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme", "theme/theme1.xml");
-}
-function hasMetadataContent(metadata) {
-	return (metadata.types?.length ?? 0) > 0 || (metadata.strings?.length ?? 0) > 0 || (metadata.mdx?.length ?? 0) > 0 || (metadata.futureMetadata?.length ?? 0) > 0 || (metadata.cellMetadata?.length ?? 0) > 0 || (metadata.valueMetadata?.length ?? 0) > 0;
-}
-function extractPivotSourceData(rows, sourceRef) {
-	const parts = sourceRef.split(":");
-	const start = parseA1Cell(parts[0] ?? "");
-	if (!start) return {
-		fieldNames: [],
-		records: []
-	};
-	const end = parts[1] !== void 0 ? parseA1Cell(parts[1]) : void 0;
-	const startRow = start.row - 1;
-	const endRow = (end?.row ?? start.row) - 1;
-	const startCol = start.col - 1;
-	const endCol = (end?.col ?? start.col) - 1;
-	const colCount = endCol - startCol + 1;
-	const headerRow = rows[startRow];
-	const fieldNames = [];
-	if (headerRow?.cells) for (let c = startCol; c <= endCol && c < headerRow.cells.length; c++) {
-		const hv = headerRow.cells[c]?.value;
-		fieldNames.push(typeof hv === "string" ? hv : typeof hv === "number" || typeof hv === "boolean" ? String(hv) : `Col${c}`);
-	}
-	const records = [];
-	for (let r = startRow + 1; r <= endRow; r++) {
-		const row = rows[r];
-		if (!row?.cells) continue;
-		const record = [];
-		for (let c = startCol; c <= endCol; c++) {
-			const val = row.cells[c]?.value;
-			if (typeof val === "number") record.push(val);
-			else if (val instanceof Date) record.push(val.getTime());
-			else record.push(typeof val === "string" ? val : typeof val === "boolean" ? String(val) : "");
+	const records = [];
+	for (let r = startRow + 1; r <= endRow; r++) {
+		const row = rows[r];
+		if (!row?.cells) continue;
+		const record = [];
+		for (let c = startCol; c <= endCol; c++) {
+			const val = row.cells[c]?.value;
+			if (typeof val === "number") record.push(val);
+			else if (val instanceof Date) record.push(val.getTime());
+			else record.push(typeof val === "string" ? val : typeof val === "boolean" ? String(val) : "");
 		}
 		if (record.length === colCount) records.push(record);
 	}
@@ -11540,6 +10937,629 @@ function colIndexToLetter(col) {
 	return columnToLetter(col + 1);
 }
 //#endregion
+//#region src/compiler.ts
+/**
+* XLSX Compiler — compiles WorkbookOptions into a Zippable structure.
+*
+* Accepts pure JSON WorkbookOptions — no intermediate File class needed.
+* Uses XlsxWriteContext for shared state (strings, styles, media, charts).
+*
+* @module
+*/
+const XML_DECL = OOXML_XML_DECLARATION;
+const IMAGE_REL = RELATIONSHIP_TYPES.image;
+/** XLSX part path → content type, derived from the part registry. Matches
+* actual file paths, so the dense/sequential xlsx part naming is handled. */
+const XLSX_CONTENT_TYPE_RESOLVER$1 = resolverFromRegistry(XLSX_PARTS);
+/** Chart part → user-shapes part relationship (c:userShapes bridge). */
+const CHART_USER_SHAPES_REL = RELATIONSHIP_TYPES.chartUserShapes;
+const PKG_REL_NS = "http://schemas.openxmlformats.org/package/2006/relationships";
+/** Extension → MIME for image and VML Default entries. Declared only for
+* extensions actually present in the package. VML backs legacy comment
+* anchors (xl/drawings/vmlDrawing${i}.vml). */
+const XLSX_MEDIA_CONTENT_TYPES = {
+	...IMAGE_MEDIA_CONTENT_TYPES,
+	vml: "application/vnd.openxmlformats-officedocument.vmlDrawing"
+};
+/** UTF-8 encoder for serializing the derived [Content_Types].xml into the package. */
+const encoder = new TextEncoder();
+/**
+* Compile workbook options into a Zippable structure.
+*/
+function compileWorkbook(options, overrides = [], mediaLevel = 0) {
+	const ctx = new XlsxWriteContext();
+	const mapping = {};
+	if (options.sharedStrings) ctx.sharedStrings.loadEntries(options.sharedStrings);
+	const worksheetConfigs = options.worksheets ?? [];
+	const chartsheetConfigs = options.chartsheets ?? [];
+	const dialogsheetConfigs = options.dialogsheets ?? [];
+	const hasCustomProperties = !!options.customProperties && options.customProperties.length > 0;
+	mapping["Properties"] = {
+		data: XML_DECL + buildCorePropertiesXmlString(options),
+		path: "docProps/core.xml"
+	};
+	mapping["AppProperties"] = {
+		data: XML_DECL + (appPropertiesDesc.stringify(options.appProperties ?? {}, ctx) ?? ""),
+		path: "docProps/app.xml"
+	};
+	if (hasCustomProperties) mapping["CustomProperties"] = {
+		data: XML_DECL + (customPropertiesDesc.stringify({ properties: options.customProperties ?? [] }, ctx) ?? ""),
+		path: "docProps/custom.xml"
+	};
+	const fileRels = buildRootRelationships("xl/workbook.xml", hasCustomProperties, options.passthroughRelationships);
+	mapping["FileRelationships"] = {
+		data: XML_DECL + fileRels.serialize(),
+		path: "_rels/.rels"
+	};
+	if (options.dxfs !== void 0) ctx.styles.setDxfs(options.dxfs);
+	if (options.fonts !== void 0) ctx.styles.adopt({
+		fonts: options.fonts,
+		fills: options.fills ?? [],
+		borders: options.borders ?? [],
+		cellXfs: options.cellXfs ?? [],
+		numFmts: options.numFmts
+	});
+	if (options.colors) ctx.styles.setColors(options.colors);
+	if (options.tableStyles) ctx.styles.setTableStyles(options.tableStyles);
+	if (options.cellStyles !== void 0) ctx.styles.setCustomCellStyles(options.cellStyles);
+	if (options.cellStyleXfs !== void 0) ctx.styles.setCellStyleXfs(options.cellStyleXfs);
+	if (options.styleExtensions) ctx.styles.setExtensions(options.styleExtensions);
+	buildWorkbookRelationships(ctx.workbookRels, worksheetConfigs.length, chartsheetConfigs.length, dialogsheetConfigs.length);
+	const sheets = [];
+	let sheetId = 1;
+	const nextSheetId = (explicit) => {
+		const id = explicit ?? sheetId;
+		if (id >= sheetId) sheetId = id + 1;
+		return id;
+	};
+	let rId = 1;
+	for (const ws of worksheetConfigs) sheets.push({
+		name: ws.name ?? `Sheet${sheetId}`,
+		sheetId: nextSheetId(ws.sheetId),
+		state: ws.state,
+		rId: `rId${rId++}`
+	});
+	for (const cs of chartsheetConfigs) sheets.push({
+		name: cs.name ?? `Chart${sheetId}`,
+		sheetId: nextSheetId(cs.sheetId),
+		state: cs.state,
+		rId: `rId${rId++}`
+	});
+	for (const ds of dialogsheetConfigs) sheets.push({
+		name: ds.name ?? `Dialog${sheetId}`,
+		sheetId: nextSheetId(ds.sheetId),
+		state: ds.state,
+		rId: `rId${rId++}`
+	});
+	const wsContext = {
+		sharedStrings: ctx.sharedStrings,
+		styles: ctx.styles
+	};
+	const state = {
+		globalMediaIdx: 0,
+		globalChartIdx: 0,
+		globalPivotIdx: 0,
+		globalPivotCacheIdx: 0,
+		globalTableIdx: 0,
+		globalQueryTableIdx: 0,
+		globalSingleXmlCellsIdx: 0,
+		pivotCacheDataMap: /* @__PURE__ */ new Map(),
+		calcCells: [],
+		allTableParts: []
+	};
+	for (const [i, wsOpts] of worksheetConfigs.entries()) compileWorksheetPart(wsOpts, i, worksheetConfigs, ctx, mapping, wsContext, state, options.passthroughRelationships);
+	compileChartsheets(chartsheetConfigs, ctx, mapping, options.passthroughRelationships);
+	compileDialogsheets(dialogsheetConfigs, ctx, mapping);
+	let rtPivotRefs;
+	if (options.pivotCacheRefs && options.pivotCacheRefs.length > 0) {
+		rtPivotRefs = [];
+		for (const ref of options.pivotCacheRefs) {
+			const rel = (options.passthroughRelationships ?? []).find((r) => r.source === "xl/workbook.xml" && r.rId === ref.rId);
+			if (!rel) continue;
+			let rid = ctx.workbookRels.idOf(rel.relationshipType, rel.target);
+			if (rid === void 0) {
+				ctx.workbookRels.add(rel.relationshipType, rel.target);
+				rid = ctx.workbookRels.idOf(rel.relationshipType, rel.target);
+			}
+			if (rid) rtPivotRefs.push({
+				cacheId: ref.cacheId,
+				rId: rid
+			});
+		}
+	}
+	let wbXml = workbookDesc.stringify({
+		sheets,
+		pivotCaches: ctx.pivotCacheRefs.length > 0 ? ctx.pivotCacheRefs : rtPivotRefs ?? [],
+		protection: options.workbookProtection,
+		customViews: options.customWorkbookViews,
+		fileRecovery: options.fileRecovery,
+		functionGroups: options.functionGroups,
+		webPublishing: options.webPublishing,
+		fileSharing: options.fileSharing,
+		webPublishObjects: options.webPublishObjects,
+		definedNames: options.definedNames,
+		properties: options.properties,
+		calculation: options.calculation,
+		oleSize: options.oleSize,
+		bookView: options.bookView,
+		...options.absPath !== void 0 ? { absPath: options.absPath } : {},
+		...options.revisionPtr ? { revisionPtr: options.revisionPtr } : {},
+		...options.extensions ? { extensions: options.extensions } : {}
+	}, ctx) ?? "";
+	if (options.connections && options.connections.length > 0) {
+		const cRid = ctx.workbookRels.nextRelationshipId;
+		ctx.workbookRels.addRelationship(cRid, RELATIONSHIP_TYPES.connections, "connections.xml");
+		mapping["Connections"] = {
+			data: XML_DECL + connectionsDesc.stringify({ connections: options.connections }, ctx),
+			path: "xl/connections.xml"
+		};
+	}
+	if (options.metadata && hasMetadataContent(options.metadata)) {
+		const mRid = ctx.workbookRels.nextRelationshipId;
+		ctx.workbookRels.addRelationship(mRid, RELATIONSHIP_TYPES.sheetMetadata, "metadata.xml");
+		mapping["Metadata"] = {
+			data: XML_DECL + metadataDesc.stringify(options.metadata, ctx),
+			path: "xl/metadata.xml"
+		};
+	}
+	if (options.xmlMaps) {
+		const xRid = ctx.workbookRels.nextRelationshipId;
+		ctx.workbookRels.addRelationship(xRid, RELATIONSHIP_TYPES.xmlMaps, "xmlMaps.xml");
+		mapping["XmlMaps"] = {
+			data: XML_DECL + mapInfoDesc.stringify(options.xmlMaps, ctx),
+			path: "xl/xmlMaps.xml"
+		};
+	}
+	if (options.volTypes && options.volTypes.length > 0) {
+		const vRid = ctx.workbookRels.nextRelationshipId;
+		ctx.workbookRels.addRelationship(vRid, RELATIONSHIP_TYPES.volTypes, "volTypes.xml");
+		mapping["VolTypes"] = {
+			data: XML_DECL + buildVolTypesXml(options.volTypes),
+			path: "xl/volTypes.xml"
+		};
+	}
+	const extLinks = options.externalLinks ?? [];
+	if (extLinks.length > 0) {
+		const extRefs = [];
+		for (let ei = 0; ei < extLinks.length; ei++) {
+			const elIdx = ei + 1;
+			const elRid = ctx.workbookRels.nextRelationshipId;
+			ctx.workbookRels.addRelationship(elRid, RELATIONSHIP_TYPES.externalLink, `externalLinks/externalLink${elIdx}.xml`);
+			const elOpts = extLinks[ei];
+			if (!elOpts) continue;
+			let bookRId;
+			if (elOpts.externalBook?.target) {
+				const elRels = new Relationships();
+				elRels.addRelationship(1, RELATIONSHIP_TYPES.externalLinkPath, elOpts.externalBook.target, TargetModeType.EXTERNAL);
+				bookRId = "rId1";
+				mapping[`ExternalLinkRels${elIdx}`] = {
+					data: XML_DECL + elRels.serialize(),
+					path: `xl/externalLinks/_rels/externalLink${elIdx}.xml.rels`
+				};
+			}
+			mapping[`ExternalLink${elIdx}`] = {
+				data: XML_DECL + externalLinkDesc.stringify({
+					...elOpts,
+					bookRId
+				}, ctx),
+				path: `xl/externalLinks/externalLink${elIdx}.xml`
+			};
+			extRefs.push({ rId: `rId${elRid}` });
+		}
+		const extRefsXml = buildExternalReferencesXml(extRefs);
+		wbXml = wbXml.replace("<!--EXTERNAL_REFS-->", extRefsXml);
+	} else wbXml = wbXml.replace("<!--EXTERNAL_REFS-->", "");
+	mapping["Workbook"] = {
+		data: XML_DECL + wbXml,
+		path: "xl/workbook.xml"
+	};
+	if (ctx.sharedStrings.count > 0) {
+		ctx.workbookRels.addRelationship(ctx.workbookRels.nextRelationshipId, RELATIONSHIP_TYPES.sharedStrings, "sharedStrings.xml");
+		const ssXml = sharedStringsDesc.stringify(ctx.sharedStrings.toDescriptorOptions(), ctx);
+		mapping["SharedStrings"] = {
+			data: XML_DECL + ssXml,
+			path: "xl/sharedStrings.xml"
+		};
+	}
+	const stylesXml = stylesDesc.stringify({ styles: ctx.styles }, ctx);
+	mapping["Styles"] = {
+		data: XML_DECL + stylesXml,
+		path: "xl/styles.xml"
+	};
+	const themeRels = new Relationships();
+	const themeXml = options.theme ? bindMediaPlaceholders(buildThemeXml(options.theme, ctx), ctx.media, themeRels) : createThemeXml$1();
+	mapping["Theme"] = {
+		data: XML_DECL + themeXml,
+		path: "xl/theme/theme1.xml"
+	};
+	if (themeRels.relationshipCount > 0) mapping["ThemeRels"] = {
+		data: XML_DECL + themeRels.serialize(),
+		path: "xl/theme/_rels/theme1.xml.rels"
+	};
+	for (const [i, chartData] of ctx.charts.array.entries()) {
+		mapping[`Chart${i}`] = {
+			data: XML_DECL + chartData.chartSpaceXml,
+			path: `xl/charts/chart${i + 1}.xml`
+		};
+		if (chartData.userShapes) {
+			const rid = chartData.userShapes.relationshipId;
+			mapping[`ChartUserShapes${i}`] = {
+				data: XML_DECL + chartData.userShapes.xml,
+				path: `xl/charts/userShapes${i + 1}.xml`
+			};
+			mapping[`ChartRels${i}`] = {
+				data: XML_DECL + `<Relationships xmlns="${PKG_REL_NS}"><Relationship Id="${escapeXml(rid)}" Type="${CHART_USER_SHAPES_REL}" Target="userShapes${i + 1}.xml"/></Relationships>`,
+				path: `xl/charts/_rels/chart${i + 1}.xml.rels`
+			};
+		}
+	}
+	const calcChainCells = options.calcChain ?? state.calcCells;
+	const srcReferencesCalcChain = (options.passthroughRelationships ?? []).some((r) => r.source === "xl/workbook.xml" && r.relationshipType.endsWith("/calcChain"));
+	if (calcChainCells.length > 0 && !(srcReferencesCalcChain && options.calcChain === void 0)) {
+		mapping["CalcChain"] = {
+			data: calcChainDesc.stringify({ cells: calcChainCells }, ctx) ?? "",
+			path: "xl/calcChain.xml"
+		};
+		const calcChainRid = ctx.workbookRels.nextRelationshipId;
+		ctx.workbookRels.addRelationship(calcChainRid, RELATIONSHIP_TYPES.calcChain, "calcChain.xml");
+	}
+	if (options.revisionLog) compileRevisionLogs(options.revisionLog, ctx, mapping);
+	for (const rel of options.passthroughRelationships ?? []) {
+		if (rel.source !== "xl/workbook.xml") continue;
+		if (ctx.workbookRels.hasRelationship(rel.relationshipType, rel.target)) continue;
+		ctx.workbookRels.add(rel.relationshipType, rel.target);
+	}
+	mapping["WorkbookRelationships"] = {
+		data: XML_DECL + ctx.workbookRels.serialize(),
+		path: "xl/_rels/workbook.xml.rels"
+	};
+	const mediaFiles = [];
+	for (const img of ctx.media.array) mediaFiles.push({
+		data: img.data,
+		path: `xl/media/${img.fileName}`
+	});
+	const files = compileMapping(mapping, overrides, mediaFiles, mediaLevel);
+	files["[Content_Types].xml"] = encoder.encode(finalizeContentTypes(files, {
+		resolve: XLSX_CONTENT_TYPE_RESOLVER$1,
+		mediaContentTypes: XLSX_MEDIA_CONTENT_TYPES,
+		source: options.contentTypes,
+		rawParts: options.rawParts
+	}, ctx));
+	dropDanglingPassthroughRels(files, options.passthroughRelationships);
+	return files;
+}
+/**
+* Compile one worksheet: sheet XML, calcChain cells, drawing/media,
+* comments + VML, background, pivots, tables, query tables and
+* single-cell XML tables, with their worksheet-level relationships.
+* Rel registration order is significant (rIds are assigned sequentially).
+*/
+function compileWorksheetPart(wsOpts, i, worksheetConfigs, ctx, mapping, wsContext, state, passthroughRelationships) {
+	const imgOpts = wsOpts.images ?? [];
+	const chartOpts = wsOpts.charts ?? [];
+	const smartArtOpts = wsOpts.smartArts ?? [];
+	const shapeOpts = wsOpts.shapes ?? [];
+	const connectorOpts = wsOpts.connectors ?? [];
+	const groupOpts = wsOpts.groups ?? [];
+	const hlOpts = wsOpts.hyperlinks ?? [];
+	const sheetName = wsOpts.name ?? `Sheet${i + 1}`;
+	const sheetIdx = wsOpts.sheetId ?? i + 1;
+	const wsRows = wsOpts.rows ?? [];
+	for (let ri = 0; ri < wsRows.length; ri++) {
+		const rowOpts = wsRows[ri];
+		const rowNumber = rowOpts.rowNumber ?? ri + 1;
+		const cells = rowOpts.cells;
+		if (!cells) continue;
+		for (let ci = 0; ci < cells.length; ci++) {
+			const cell = cells[ci];
+			if (!cell.formula) continue;
+			const ref = cell.reference ?? columnToLetter(ci + 1) + rowNumber;
+			state.calcCells.push({
+				reference: ref,
+				sheetIndex: sheetIdx,
+				array: typeof cell.formula === "object" && cell.formula.type === "array"
+			});
+		}
+	}
+	const hasMedia = imgOpts.length > 0 || chartOpts.length > 0 || smartArtOpts.length > 0 || shapeOpts.length > 0 || connectorOpts.length > 0 || groupOpts.length > 0;
+	const hasExternalHyperlinks = hlOpts.some((h) => h.url !== void 0);
+	const commentOpts = wsOpts.comments ?? [];
+	const hasComments = commentOpts.length > 0;
+	const pivotOpts = wsOpts.pivotTables ?? [];
+	const hasPivots = pivotOpts.length > 0;
+	const tableOpts = wsOpts.tables ?? [];
+	const hasTables = tableOpts.length > 0;
+	const queryTableOpts = wsOpts.queryTables ?? [];
+	const hasQueryTables = queryTableOpts.length > 0;
+	const singleXmlCellOpts = wsOpts.singleXmlCells ?? [];
+	const bgImg = wsOpts.backgroundImage;
+	const wsPath = `xl/worksheets/sheet${i + 1}.xml`;
+	let wsRels;
+	if (hasMedia || hasExternalHyperlinks || hasComments || hasPivots || hasTables || hasQueryTables || singleXmlCellOpts.length > 0 || bgImg) {
+		wsRels = new Relationships();
+		wsRels.reserveSourceRids(wsPath, passthroughRelationships ?? []);
+	}
+	const resolvePassthroughRid = (typeFragment, originalRid) => {
+		if (!wsRels) return originalRid;
+		const rel = (passthroughRelationships ?? []).find((r) => r.source === wsPath && r.rId === originalRid && r.relationshipType.endsWith(typeFragment));
+		if (!rel) return originalRid;
+		const existing = wsRels.idOf(rel.relationshipType, rel.target);
+		if (existing) return existing;
+		if (wsRels.hasId(originalRid)) return `rId${wsRels.add(rel.relationshipType, rel.target)}`;
+		wsRels.addRelationship(originalRid, rel.relationshipType, rel.target);
+		return originalRid;
+	};
+	const resolveEmbeddingRid = (originalRid) => {
+		const rid = resolvePassthroughRid("/oleObject", originalRid);
+		return rid === originalRid ? resolvePassthroughRid("/package", originalRid) : rid;
+	};
+	let xmlOpts = wsOpts;
+	if (wsRels && (passthroughRelationships?.length ?? 0) > 0) {
+		const oleObjects = wsOpts.oleObjects?.map((ole) => ({
+			...ole,
+			rId: ole.rId ? resolveEmbeddingRid(ole.rId) : ole.rId,
+			properties: ole.properties?.iconRid !== void 0 ? {
+				...ole.properties,
+				iconRid: resolvePassthroughRid("/image", ole.properties.iconRid)
+			} : ole.properties
+		}));
+		const controls = wsOpts.controls?.map((c) => ({
+			...c,
+			rId: resolvePassthroughRid("/controls", c.rId),
+			iconRid: c.iconRid !== void 0 ? resolvePassthroughRid("/image", c.iconRid) : c.iconRid
+		}));
+		const pageSetup = wsOpts.pageSetup?.printerSettingsRId ? {
+			...wsOpts.pageSetup,
+			printerSettingsRId: resolvePassthroughRid("/printerSettings", wsOpts.pageSetup.printerSettingsRId)
+		} : wsOpts.pageSetup;
+		const pivotSelection = wsOpts.pivotSelection?.rId ? {
+			...wsOpts.pivotSelection,
+			rId: resolvePassthroughRid("/pivotTable", wsOpts.pivotSelection.rId)
+		} : wsOpts.pivotSelection;
+		const legacyDrawingHF = wsOpts.legacyDrawingHF ? resolvePassthroughRid("/vmlDrawing", wsOpts.legacyDrawingHF) : wsOpts.legacyDrawingHF;
+		const customProperties = wsOpts.customProperties?.map((cp) => ({
+			...cp,
+			rId: resolvePassthroughRid("/customXml", cp.rId)
+		}));
+		xmlOpts = {
+			...wsOpts,
+			...oleObjects ? { oleObjects } : {},
+			...controls ? { controls } : {},
+			...pageSetup !== wsOpts.pageSetup ? { pageSetup } : {},
+			...pivotSelection !== wsOpts.pivotSelection ? { pivotSelection } : {},
+			...legacyDrawingHF !== wsOpts.legacyDrawingHF ? { legacyDrawingHF } : {},
+			...customProperties ? { customProperties } : {}
+		};
+	}
+	let sheetXml = stringifyWorksheet(xmlOpts, wsContext);
+	if (hasExternalHyperlinks) for (const hl of hlOpts) {
+		if (hl.url === void 0) continue;
+		wsRels.add(RELATIONSHIP_TYPES.hyperlink, hl.url, "External");
+	}
+	if (hasMedia) sheetXml = compileSheetDrawing(wsOpts, i, sheetXml, ctx, mapping, state, wsRels);
+	if (hasComments) {
+		const commentsIdx = i + 1;
+		const commentsXml = commentsDesc.stringify({ comments: commentOpts }, ctx);
+		mapping[`Comments${i}`] = {
+			data: XML_DECL + commentsXml,
+			path: `xl/comments${commentsIdx}.xml`
+		};
+		const vmlXml = vmlNotesDesc.stringify({ comments: commentOpts }, ctx);
+		mapping[`VmlDrawing${i}`] = {
+			data: XML_DECL + vmlXml,
+			path: `xl/drawings/vmlDrawing${commentsIdx}.vml`
+		};
+		wsRels.add(RELATIONSHIP_TYPES.comments, `../comments${commentsIdx}.xml`);
+		const vmlRid = wsRels.add(RELATIONSHIP_TYPES.vmlDrawing, `../drawings/vmlDrawing${commentsIdx}.vml`);
+		sheetXml = editSheetTailMarker(sheetXml, "<!--LEGACY_DRAWING-->", `<legacyDrawing r:id="rId${vmlRid}"/>`);
+	}
+	if (bgImg) {
+		const ext = bgImg.type === "jpg" ? "jpeg" : bgImg.type;
+		const rawBytes = toUint8Array(bgImg.data, { encoding: "base64" });
+		const entry = ctx.media.addMedia(rawBytes, ext, (fileName) => ({
+			fileName,
+			type: ext,
+			data: rawBytes,
+			width: 0,
+			height: 0
+		}));
+		state.globalMediaIdx++;
+		const bgRid = wsRels.add(IMAGE_REL, `../media/${entry.fileName}`);
+		sheetXml = editSheetTailMarker(sheetXml, "<!--BACKGROUND_PICTURE-->", `<picture r:id="rId${bgRid}"/>`);
+	}
+	if (wsOpts.drawingRid) {
+		const rid = escapeXml(resolvePassthroughRid("/drawing", wsOpts.drawingRid));
+		sheetXml = editSheetTailMarker(sheetXml, "<!--DRAWING-->", `<drawing r:id="${rid}"/>`);
+	}
+	if (wsOpts.legacyDrawingRid) {
+		const rid = escapeXml(resolvePassthroughRid("/vmlDrawing", wsOpts.legacyDrawingRid));
+		sheetXml = editSheetTailMarker(sheetXml, "<!--LEGACY_DRAWING-->", `<legacyDrawing r:id="${rid}"/>`);
+	}
+	if (hasPivots) compileSheetPivots(wsOpts, worksheetConfigs, ctx, mapping, state, wsRels, sheetName);
+	const wsTableParts = [];
+	if (hasTables) for (const tbl of tableOpts) {
+		state.globalTableIdx++;
+		const tableIdx = state.globalTableIdx;
+		if (!tbl.columns?.length) continue;
+		const tableXmlStr = XML_DECL + tableDesc.stringify({
+			...tbl,
+			id: tbl.id ?? tableIdx
+		}, ctx);
+		mapping[`Table${tableIdx}`] = {
+			data: tableXmlStr,
+			path: `xl/tables/table${tableIdx}.xml`
+		};
+		const tblRid = wsRels.add(RELATIONSHIP_TYPES.table, `../tables/table${tableIdx}.xml`);
+		wsTableParts.push({ rId: `rId${tblRid}` });
+		state.allTableParts.push({ rId: `rId${tblRid}` });
+	}
+	if (hasQueryTables) for (const qt of queryTableOpts) {
+		state.globalQueryTableIdx++;
+		mapping[`QueryTable${state.globalQueryTableIdx}`] = {
+			data: XML_DECL + queryTableDesc.stringify(qt, ctx),
+			path: `xl/queryTables/queryTable${state.globalQueryTableIdx}.xml`
+		};
+		wsRels.add(RELATIONSHIP_TYPES.queryTable, `../queryTables/queryTable${state.globalQueryTableIdx}.xml`);
+	}
+	if (singleXmlCellOpts.length > 0) {
+		state.globalSingleXmlCellsIdx++;
+		mapping[`TableSingleCells${state.globalSingleXmlCellsIdx}`] = {
+			data: XML_DECL + singleXmlCellsDesc.stringify({ cells: singleXmlCellOpts }, ctx),
+			path: `xl/tables/tableSingleCells${state.globalSingleXmlCellsIdx}.xml`
+		};
+		wsRels.add(RELATIONSHIP_TYPES.tableSingleCells, `../tables/tableSingleCells${state.globalSingleXmlCellsIdx}.xml`);
+	}
+	if (hasPivots) {
+		const rendered = renderPivotSheetData(pivotOpts, worksheetConfigs, ctx.sharedStrings, sheetName);
+		if (rendered.sheetData.length > 0) {
+			sheetXml = sheetXml.replace(/<sheetData\/>|<sheetData><\/sheetData>/, rendered.sheetData);
+			if (!sheetXml.includes("<dimension")) sheetXml = sheetXml.replace("<sheetViews", `<dimension ref="${rendered.dimensionRef}"/><sheetViews`);
+		}
+	}
+	if (wsTableParts.length > 0) sheetXml = editSheetTailMarker(sheetXml, "<!--TABLE_PARTS-->", buildTablePartsXml(wsTableParts));
+	sheetXml = stripWorksheetPlaceholders(sheetXml);
+	if (wsRels) for (const rel of passthroughRelationships ?? []) {
+		if (rel.source !== wsPath) continue;
+		wsRels.claimSourceRel(rel);
+	}
+	if (wsRels) mapping[`WorksheetRels${i}`] = {
+		data: XML_DECL + wsRels.serialize(),
+		path: `xl/worksheets/_rels/sheet${i + 1}.xml.rels`
+	};
+	mapping[`Worksheet${i}`] = {
+		data: sheetXml,
+		path: `xl/worksheets/sheet${i + 1}.xml`
+	};
+}
+/** Full-page default frame for a fresh chartsheet chart (≈9.70×6.35 in). */
+const CHARTSHEET_DEFAULT_CX = 9308969;
+const CHARTSHEET_DEFAULT_CY = 6096e3;
+/** Compile all chartsheets: chart part, chartsheet/drawing XML and rels. */
+function compileChartsheets(chartsheetConfigs, ctx, mapping, passthroughRelationships) {
+	for (const [i, csOpts] of chartsheetConfigs.entries()) {
+		const chartDef = csOpts.chart;
+		if (!chartDef) continue;
+		const csChartGlobalIdx = ctx.charts.array.length;
+		const csChartKey = `cs_chart_${csChartGlobalIdx}`;
+		const csUserShapes = chartDef.userShapes ? buildUserShapesData(chartDef.userShapes) : void 0;
+		ctx.charts.addChart(csChartKey, {
+			key: csChartKey,
+			chartSpaceXml: chartSpaceDesc.stringify(chartDef, ctx) ?? "",
+			...csUserShapes ? { userShapes: csUserShapes } : {}
+		});
+		const csRels = new Relationships();
+		const csDrawingIdx = i + 1;
+		csRels.addRelationship(1, RELATIONSHIP_TYPES.drawing, `../drawings/drawing${csDrawingIdx}.xml`);
+		let csNextRid = 2;
+		for (const rel of passthroughRelationships ?? []) {
+			if (rel.source !== `xl/chartsheets/sheet${i + 1}.xml`) continue;
+			if (csRels.hasRelationship(rel.relationshipType, rel.target)) continue;
+			csRels.addRelationship(csNextRid++, rel.relationshipType, rel.target);
+		}
+		const csDrawingRels = new Relationships();
+		csDrawingRels.addRelationship(1, RELATIONSHIP_TYPES.chart, `../charts/chart${csChartGlobalIdx + 1}.xml`);
+		const frame = graphicFrameXml(csOpts.shapeId ?? 1, void 0, `Chart ${i + 1}`, "rId1", 0, 0, ctx, {
+			frameLocks: csOpts.frameLocks,
+			macro: csOpts.macro
+		});
+		const anchor = wrapAnchor({
+			anchorType: "absolute",
+			col: 1,
+			row: 1,
+			absoluteX: csOpts.absoluteX ?? 0,
+			absoluteY: csOpts.absoluteY ?? 0,
+			extentCx: csOpts.extentCx ?? CHARTSHEET_DEFAULT_CX,
+			extentCy: csOpts.extentCy ?? CHARTSHEET_DEFAULT_CY
+		}, `${frame}<xdr:clientData/>`);
+		const csDrawingXml = `<xdr:wsDr xmlns:xdr="${XDR_NS}" xmlns:a="${A_NS}" xmlns:r="${R_NS$1}">${anchor}</xdr:wsDr>`;
+		mapping[`ChartsheetDrawing${i}`] = {
+			data: csDrawingXml,
+			path: `xl/drawings/drawing${csDrawingIdx}.xml`
+		};
+		mapping[`ChartsheetDrawingRels${i}`] = {
+			data: XML_DECL + csDrawingRels.serialize(),
+			path: `xl/drawings/_rels/drawing${csDrawingIdx}.xml.rels`
+		};
+		mapping[`ChartsheetRels${i}`] = {
+			data: XML_DECL + csRels.serialize(),
+			path: `xl/chartsheets/_rels/sheet${i + 1}.xml.rels`
+		};
+		let csPageSetup = csOpts.pageSetup;
+		if (csPageSetup?.printerSettingsRId) {
+			const srcRid = csPageSetup.printerSettingsRId;
+			const rel = (passthroughRelationships ?? []).find((r) => r.source === `xl/chartsheets/sheet${i + 1}.xml` && r.rId === srcRid && r.relationshipType.endsWith("/printerSettings"));
+			const rid = rel ? csRels.idOf(rel.relationshipType, rel.target) ?? srcRid : srcRid;
+			if (rid !== srcRid) csPageSetup = {
+				...csPageSetup,
+				printerSettingsRId: rid
+			};
+		}
+		mapping[`Chartsheet${i}`] = {
+			data: XML_DECL + chartsheetDesc.stringify({
+				...csOpts,
+				drawingRId: "rId1",
+				pageSetup: csPageSetup
+			}, ctx),
+			path: `xl/chartsheets/sheet${i + 1}.xml`
+		};
+	}
+}
+/** Compile all dialog sheets (legacy Excel 5.0 dialog sheets). */
+function compileDialogsheets(dialogsheetConfigs, ctx, mapping) {
+	for (const [i, dsOpts] of dialogsheetConfigs.entries()) mapping[`Dialogsheet${i}`] = {
+		data: XML_DECL + dialogsheetDesc.stringify(dsOpts, ctx),
+		path: `xl/dialogSheets/sheet${i + 1}.xml`
+	};
+}
+/**
+* Compile shared-workbook revisions (xl/revisionHeaders.xml +
+* xl/revisions/revisionN.xml + xl/users.xml). CT_Workbook has no revision
+* element — parts are discovered via workbook.xml.rels + [Content_Types].
+*/
+function compileRevisionLogs(rl, ctx, mapping) {
+	const REV_HEADERS_REL = RELATIONSHIP_TYPES.revisionHeaders;
+	const REV_LOG_REL = RELATIONSHIP_TYPES.revisionLog;
+	const USERS_REL = RELATIONSHIP_TYPES.users;
+	mapping["RevisionHeaders"] = {
+		data: XML_DECL + (revisionHeadersDesc.stringify(rl.headers, ctx) ?? ""),
+		path: "xl/revisionHeaders.xml"
+	};
+	ctx.workbookRels.addRelationship(ctx.workbookRels.nextRelationshipId, REV_HEADERS_REL, "revisionHeaders.xml");
+	const revHeadersRels = new Relationships();
+	for (const [i, log] of rl.logs.entries()) {
+		mapping[`RevisionLog${i}`] = {
+			data: XML_DECL + (revisionLogDesc.stringify(log, ctx) ?? ""),
+			path: `xl/revisions/revision${i + 1}.xml`
+		};
+		revHeadersRels.addRelationship(i + 1, REV_LOG_REL, `revisions/revision${i + 1}.xml`);
+	}
+	mapping["RevisionHeadersRels"] = {
+		data: XML_DECL + revHeadersRels.serialize(),
+		path: "xl/_rels/revisionHeaders.xml.rels"
+	};
+	if (rl.users) {
+		const usersXml = usersDesc.stringify(rl.users, ctx);
+		if (usersXml) {
+			mapping["Users"] = {
+				data: XML_DECL + usersXml,
+				path: "xl/users.xml"
+			};
+			ctx.workbookRels.addRelationship(ctx.workbookRels.nextRelationshipId, USERS_REL, "users.xml");
+		}
+	}
+}
+function buildWorkbookRelationships(rels, wsCount, csCount, dsCount = 0) {
+	let rid = 1;
+	for (let i = 0; i < wsCount; i++) rels.addRelationship(rid++, RELATIONSHIP_TYPES.worksheet, `worksheets/sheet${i + 1}.xml`);
+	for (let i = 0; i < csCount; i++) rels.addRelationship(rid++, RELATIONSHIP_TYPES.chartsheet, `chartsheets/sheet${i + 1}.xml`);
+	for (let i = 0; i < dsCount; i++) rels.addRelationship(rid++, RELATIONSHIP_TYPES.dialogsheet, `dialogSheets/sheet${i + 1}.xml`);
+	rels.addRelationship(rid++, RELATIONSHIP_TYPES.styles, "styles.xml");
+	rels.addRelationship(rid++, RELATIONSHIP_TYPES.theme, "theme/theme1.xml");
+}
+function hasMetadataContent(metadata) {
+	return (metadata.types?.length ?? 0) > 0 || (metadata.strings?.length ?? 0) > 0 || (metadata.mdx?.length ?? 0) > 0 || (metadata.futureMetadata?.length ?? 0) > 0 || (metadata.cellMetadata?.length ?? 0) > 0 || (metadata.valueMetadata?.length ?? 0) > 0;
+}
+//#endregion
 //#region src/stream.ts
 /**
 * Streaming XLSX compilation — writes parts into a {@link ZipStreamWriter} as
@@ -11662,10 +11682,10 @@ function streamWorkbook(options, ondata, compression = {}) {
 	if (hasVolTypes) writeString("xl/volTypes.xml", OOXML_XML_DECLARATION + buildVolTypesXml(options.volTypes ?? []));
 	const wbRels = new Relationships();
 	let rid = 1;
-	for (let i = 0; i < sheets.length; i++) wbRels.addRelationship(rid++, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet", `worksheets/sheet${i + 1}.xml`);
-	wbRels.addRelationship(rid++, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles", "styles.xml");
-	wbRels.addRelationship(rid++, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme", "theme/theme1.xml");
-	if (hasVolTypes) wbRels.addRelationship(rid++, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/volTypes", "volTypes.xml");
+	for (let i = 0; i < sheets.length; i++) wbRels.addRelationship(rid++, RELATIONSHIP_TYPES.worksheet, `worksheets/sheet${i + 1}.xml`);
+	wbRels.addRelationship(rid++, RELATIONSHIP_TYPES.styles, "styles.xml");
+	wbRels.addRelationship(rid++, RELATIONSHIP_TYPES.theme, "theme/theme1.xml");
+	if (hasVolTypes) wbRels.addRelationship(rid++, RELATIONSHIP_TYPES.volTypes, "volTypes.xml");
 	writeString("xl/_rels/workbook.xml.rels", OOXML_XML_DECLARATION + wbRels.serialize());
 	for (const [i, ws] of worksheets.entries()) {
 		const rows = ws.rows ?? [];