@cj-tech-master/excelts 4.2.3-canary.20260115111903.b80904d → 4.2.3-canary.20260122073152.a9bb6b0

package/dist/iife/excelts.iife.js

@@ -1,5 +1,5 @@
 /*!
- * @cj-tech-master/excelts v4.2.3-canary.20260115111903.b80904d
+ * @cj-tech-master/excelts v4.2.3-canary.20260122073152.a9bb6b0
  * TypeScript Excel Workbook Manager - Read and Write xlsx and csv Files.
  * (c) 2026 cjnoname
  * Released under the MIT License
@@ -6216,7 +6216,8 @@ var ExcelTS = (function(exports) {
 				tables: Object.values(this.tables).map((table) => table.model),
 				pivotTables: this.pivotTables,
 				conditionalFormattings: this.conditionalFormattings,
-				formControls: this.formControls.map((fc) => fc.model)
+				formControls: this.formControls.map((fc) => fc.model),
+				drawing: this._drawing
 			};
 			model.cols = Column.toModel(this.columns || []);
 			const rows = model.rows = [];
@@ -6271,6 +6272,7 @@ var ExcelTS = (function(exports) {
 			this.pivotTables = value.pivotTables;
 			this.conditionalFormattings = value.conditionalFormattings;
 			this.formControls = [];
+			this._drawing = value.drawing;
 		}
 	};
 
@@ -10406,28 +10408,26 @@ var ExcelTS = (function(exports) {
 					ContentType: "application/vnd.openxmlformats-officedocument.drawing+xml"
 				});
 			});
-			if (model.commentRefs) {
-				xmlStream.leafNode("Default", {
-					Extension: "vml",
-					ContentType: "application/vnd.openxmlformats-officedocument.vmlDrawing"
-				});
-				model.commentRefs.forEach(({ commentName }) => {
-					xmlStream.leafNode("Override", {
-						PartName: toContentTypesPartName(commentsPathFromName(commentName)),
-						ContentType: "application/vnd.openxmlformats-officedocument.spreadsheetml.comments+xml"
-					});
-				});
-			}
-			if (model.formControlRefs) {
-				if (!model.commentRefs) xmlStream.leafNode("Default", {
-					Extension: "vml",
-					ContentType: "application/vnd.openxmlformats-officedocument.vmlDrawing"
-				});
-				for (const ctrlPropId of model.formControlRefs) xmlStream.leafNode("Override", {
-					PartName: toContentTypesPartName(ctrlPropPath(ctrlPropId)),
-					ContentType: "application/vnd.ms-excel.controlproperties+xml"
+			const hasComments = model.commentRefs && model.commentRefs.length > 0;
+			const hasFormControls = model.formControlRefs && model.formControlRefs.length > 0;
+			if (hasComments || hasFormControls) xmlStream.leafNode("Default", {
+				Extension: "vml",
+				ContentType: "application/vnd.openxmlformats-officedocument.vmlDrawing"
+			});
+			if (hasComments) model.commentRefs.forEach(({ commentName }) => {
+				xmlStream.leafNode("Override", {
+					PartName: toContentTypesPartName(commentsPathFromName(commentName)),
+					ContentType: "application/vnd.openxmlformats-officedocument.spreadsheetml.comments+xml"
 				});
-			}
+			});
+			if (hasFormControls) for (const ctrlPropId of model.formControlRefs) xmlStream.leafNode("Override", {
+				PartName: toContentTypesPartName(ctrlPropPath(ctrlPropId)),
+				ContentType: "application/vnd.ms-excel.controlproperties+xml"
+			});
+			if (model.passthroughContentTypes) for (const { partName, contentType } of model.passthroughContentTypes) xmlStream.leafNode("Override", {
+				PartName: toContentTypesPartName(partName),
+				ContentType: contentType
+			});
 			xmlStream.leafNode("Override", {
 				PartName: toContentTypesPartName(OOXML_PATHS.docPropsCore),
 				ContentType: "application/vnd.openxmlformats-package.core-properties+xml"
@@ -13862,6 +13862,17 @@ var ExcelTS = (function(exports) {
 					vmlDrawing: `vmlDrawing${model.id}`
 				});
 			}
+			if (model.drawing && model.drawing.anchors) {
+				const drawing = model.drawing;
+				drawing.rId = nextRid(rels);
+				if (!drawing.name) drawing.name = `drawing${++options.drawingsCount}`;
+				options.drawings.push(drawing);
+				rels.push({
+					Id: drawing.rId,
+					Type: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing",
+					Target: drawingRelTargetFromWorksheet(drawing.name)
+				});
+			}
 			const drawingRelsHash = [];
 			let bookImage;
 			model.media.forEach((medium) => {
@@ -14199,17 +14210,25 @@ var ExcelTS = (function(exports) {
 				const match = rels[model.drawing.rId].Target.match(/\/drawings\/([a-zA-Z0-9]+)[.][a-zA-Z]{3,4}$/);
 				if (match) {
 					const drawingName = match[1];
-					options.drawings[drawingName].anchors.forEach((anchor) => {
-						if (anchor.medium) {
-							const image = {
-								type: "image",
-								imageId: anchor.medium.index,
-								range: anchor.range,
-								hyperlinks: anchor.picture.hyperlinks
-							};
-							model.media.push(image);
-						}
-					});
+					const drawing = options.drawings[drawingName];
+					if (drawing) {
+						model.drawing = {
+							...drawing,
+							name: drawingName,
+							rels: options.drawingRels?.[drawingName] || drawing.rels || []
+						};
+						drawing.anchors.forEach((anchor) => {
+							if (anchor.medium) {
+								const image = {
+									type: "image",
+									imageId: anchor.medium.index,
+									range: anchor.range,
+									hyperlinks: anchor.picture.hyperlinks
+								};
+								model.media.push(image);
+							}
+						});
+					}
 				}
 			}
 			const backgroundRel = model.background && rels[model.background.rId];
@@ -15961,18 +15980,27 @@ var ExcelTS = (function(exports) {
 	var PivotTableXform = class PivotTableXform extends BaseXform {
 		constructor() {
 			super();
+			this.state = {
+				inPivotFields: false,
+				inRowFields: false,
+				inColFields: false,
+				inDataFields: false,
+				inRowItems: false,
+				inColItems: false,
+				inLocation: false,
+				inItems: false,
+				inPivotTableStyleInfo: false,
+				inChartFormats: false,
+				inPivotArea: false
+			};
+			this.currentPivotField = null;
+			this.currentRowItem = null;
+			this.currentColItem = null;
+			this.currentChartFormat = null;
+			this.pivotAreaXmlBuffer = [];
+			this.pivotAreaDepth = 0;
 			this.map = {};
 			this.model = null;
-			this.inPivotFields = false;
-			this.inRowFields = false;
-			this.inColFields = false;
-			this.inDataFields = false;
-			this.inRowItems = false;
-			this.inColItems = false;
-			this.inLocation = false;
-			this.currentPivotField = null;
-			this.inItems = false;
-			this.inPivotTableStyleInfo = false;
 		}
 		prepare(_model) {}
 		get tag() {
@@ -15980,16 +16008,15 @@ var ExcelTS = (function(exports) {
 		}
 		reset() {
 			this.model = null;
-			this.inPivotFields = false;
-			this.inRowFields = false;
-			this.inColFields = false;
-			this.inDataFields = false;
-			this.inRowItems = false;
-			this.inColItems = false;
-			this.inLocation = false;
+			Object.keys(this.state).forEach((key) => {
+				this.state[key] = false;
+			});
 			this.currentPivotField = null;
-			this.inItems = false;
-			this.inPivotTableStyleInfo = false;
+			this.currentRowItem = null;
+			this.currentColItem = null;
+			this.currentChartFormat = null;
+			this.pivotAreaXmlBuffer = [];
+			this.pivotAreaDepth = 0;
 		}
 		/**
 		* Render pivot table XML.
@@ -16088,8 +16115,7 @@ var ExcelTS = (function(exports) {
 		* Render loaded pivot table (preserving original structure)
 		*/
 		renderLoaded(xmlStream, model) {
-			xmlStream.openXml(XmlStream.StdDocAttributes);
-			xmlStream.openNode(this.tag, {
+			const attrs = {
 				...PivotTableXform.PIVOT_TABLE_ATTRIBUTES,
 				name: model.name || "PivotTable1",
 				cacheId: model.cacheId,
@@ -16098,7 +16124,7 @@ var ExcelTS = (function(exports) {
 				applyFontFormats: model.applyFontFormats || "0",
 				applyPatternFormats: model.applyPatternFormats || "0",
 				applyAlignmentFormats: model.applyAlignmentFormats || "0",
-				applyWidthHeightFormats: model.applyWidthHeightFormats || "0",
+				applyWidthHeightFormats: model.applyWidthHeightFormats ?? "0",
 				dataCaption: model.dataCaption || "Values",
 				updatedVersion: model.updatedVersion || "8",
 				minRefreshableVersion: model.minRefreshableVersion || "3",
@@ -16106,10 +16132,15 @@ var ExcelTS = (function(exports) {
 				itemPrintTitles: model.itemPrintTitles ? "1" : "0",
 				createdVersion: model.createdVersion || "8",
 				indent: model.indent !== void 0 ? String(model.indent) : "0",
-				compact: model.compact ? "1" : "0",
-				compactData: model.compactData ? "1" : "0",
 				multipleFieldFilters: model.multipleFieldFilters ? "1" : "0"
-			});
+			};
+			if (model.outline) attrs.outline = "1";
+			if (model.outlineData) attrs.outlineData = "1";
+			if (model.chartFormat !== void 0) attrs.chartFormat = String(model.chartFormat);
+			if (model.compact) attrs.compact = "1";
+			if (model.compactData) attrs.compactData = "1";
+			xmlStream.openXml(XmlStream.StdDocAttributes);
+			xmlStream.openNode(this.tag, attrs);
 			if (model.location) xmlStream.leafNode("location", {
 				ref: model.location.ref,
 				firstHeaderRow: model.location.firstHeaderRow,
@@ -16126,30 +16157,46 @@ var ExcelTS = (function(exports) {
 				for (const fieldIndex of model.rowFields) xmlStream.leafNode("field", { x: fieldIndex });
 				xmlStream.closeNode();
 			}
-			xmlStream.writeXml(`
-      <rowItems count="1">
-        <i t="grand"><x /></i>
-      </rowItems>`);
+			if (model.rowItems && model.rowItems.length > 0) {
+				xmlStream.openNode("rowItems", { count: model.rowItems.length });
+				for (const item of model.rowItems) this.renderRowColItem(xmlStream, item);
+				xmlStream.closeNode();
+			} else xmlStream.writeXml("<rowItems count=\"1\"><i t=\"grand\"><x/></i></rowItems>");
 			const colFieldCount = model.colFields.length === 0 ? 1 : model.colFields.length;
 			xmlStream.openNode("colFields", { count: colFieldCount });
 			if (model.colFields.length === 0) xmlStream.leafNode("field", { x: -2 });
 			else for (const fieldIndex of model.colFields) xmlStream.leafNode("field", { x: fieldIndex });
 			xmlStream.closeNode();
-			xmlStream.writeXml(`
-      <colItems count="1">
-        <i t="grand"><x /></i>
-      </colItems>`);
+			if (model.colItems && model.colItems.length > 0) {
+				xmlStream.openNode("colItems", { count: model.colItems.length });
+				for (const item of model.colItems) this.renderRowColItem(xmlStream, item);
+				xmlStream.closeNode();
+			} else xmlStream.writeXml("<colItems count=\"1\"><i t=\"grand\"><x/></i></colItems>");
 			if (model.dataFields.length > 0) {
 				xmlStream.openNode("dataFields", { count: model.dataFields.length });
 				for (const dataField of model.dataFields) {
-					const attrs = {
+					const dfAttrs = {
 						name: dataField.name,
 						fld: dataField.fld,
 						baseField: dataField.baseField ?? 0,
 						baseItem: dataField.baseItem ?? 0
 					};
-					if (dataField.subtotal && dataField.subtotal !== "sum") attrs.subtotal = dataField.subtotal;
-					xmlStream.leafNode("dataField", attrs);
+					if (dataField.subtotal && dataField.subtotal !== "sum") dfAttrs.subtotal = dataField.subtotal;
+					xmlStream.leafNode("dataField", dfAttrs);
+				}
+				xmlStream.closeNode();
+			}
+			if (model.chartFormats && model.chartFormats.length > 0) {
+				xmlStream.openNode("chartFormats", { count: model.chartFormats.length });
+				for (const cf of model.chartFormats) {
+					xmlStream.openNode("chartFormat", {
+						chart: cf.chart,
+						format: cf.format,
+						series: cf.series ? "1" : void 0
+					});
+					if (cf.pivotAreaXml) xmlStream.writeXml(cf.pivotAreaXml);
+					else xmlStream.writeXml(`<pivotArea type="data" outline="0" fieldPosition="0"><references count="1"><reference field="4294967294" count="1" selected="0"><x v="0"/></reference></references></pivotArea>`);
+					xmlStream.closeNode();
 				}
 				xmlStream.closeNode();
 			}
@@ -16161,47 +16208,35 @@ var ExcelTS = (function(exports) {
 				showColStripes: "0",
 				showLastColumn: "1"
 			});
-			xmlStream.writeXml(`
-      <extLst>
-        <ext
-          uri="{962EF5D1-5CA2-4c93-8EF4-DBF5C05439D2}"
-          xmlns:x14="http://schemas.microsoft.com/office/spreadsheetml/2009/9/main"
-        >
-          <x14:pivotTableDefinition
-            hideValuesRow="1"
-            xmlns:xm="http://schemas.microsoft.com/office/excel/2006/main"
-          />
-        </ext>
-        <ext
-          uri="{747A6164-185A-40DC-8AA5-F01512510D54}"
-          xmlns:xpdl="http://schemas.microsoft.com/office/spreadsheetml/2016/pivotdefaultlayout"
-        >
-          <xpdl:pivotTableDefinition16
-            EnabledSubtotalsDefault="0"
-            SubtotalsOnTopDefault="0"
-          />
-        </ext>
-      </extLst>
-    `);
+			xmlStream.writeXml(`<extLst><ext uri="{962EF5D1-5CA2-4c93-8EF4-DBF5C05439D2}" xmlns:x14="http://schemas.microsoft.com/office/spreadsheetml/2009/9/main"><x14:pivotTableDefinition hideValuesRow="1" xmlns:xm="http://schemas.microsoft.com/office/excel/2006/main"/></ext><ext uri="{747A6164-185A-40DC-8AA5-F01512510D54}" xmlns:xpdl="http://schemas.microsoft.com/office/spreadsheetml/2016/pivotdefaultlayout"><xpdl:pivotTableDefinition16/></ext></extLst>`);
 			xmlStream.closeNode();
 		}
 		/**
+		* Render a row or column item element
+		*/
+		renderRowColItem(xmlStream, item) {
+			const attrs = {};
+			if (item.t) attrs.t = item.t;
+			if (item.x && item.x.length > 0) {
+				xmlStream.openNode("i", attrs);
+				for (const x of item.x) if (x.v && x.v !== 0) xmlStream.leafNode("x", { v: x.v });
+				else xmlStream.leafNode("x");
+				xmlStream.closeNode();
+			} else xmlStream.leafNode("i", attrs);
+		}
+		/**
 		* Render a loaded pivot field
 		*/
 		renderPivotFieldLoaded(xmlStream, field) {
-			const attrs = {
-				compact: field.compact ? "1" : "0",
-				outline: field.outline ? "1" : "0",
-				showAll: field.showAll ? "1" : "0",
-				defaultSubtotal: field.defaultSubtotal ? "1" : "0"
-			};
+			const attrs = {};
 			if (field.axis) attrs.axis = field.axis;
 			if (field.dataField) attrs.dataField = "1";
+			attrs.showAll = field.showAll ? "1" : "0";
 			if (field.items && field.items.length > 0) {
 				xmlStream.openNode("pivotField", attrs);
 				xmlStream.openNode("items", { count: field.items.length + 1 });
 				for (const itemIndex of field.items) xmlStream.leafNode("item", { x: itemIndex });
-				xmlStream.writeXml("<item t=\"default\" />");
+				xmlStream.writeXml("<item t=\"default\"/>");
 				xmlStream.closeNode();
 				xmlStream.closeNode();
 			} else xmlStream.leafNode("pivotField", attrs);
@@ -16235,6 +16270,12 @@ var ExcelTS = (function(exports) {
 						compact: attributes.compact === "1",
 						compactData: attributes.compactData === "1",
 						multipleFieldFilters: attributes.multipleFieldFilters === "1",
+						outline: attributes.outline === "1",
+						outlineData: attributes.outlineData === "1",
+						chartFormat: attributes.chartFormat ? parseInt(attributes.chartFormat, 10) : void 0,
+						rowItems: [],
+						colItems: [],
+						chartFormats: [],
 						isLoaded: true
 					};
 					break;
@@ -16247,10 +16288,10 @@ var ExcelTS = (function(exports) {
 					};
 					break;
 				case "pivotFields":
-					this.inPivotFields = true;
+					this.state.inPivotFields = true;
 					break;
 				case "pivotField":
-					if (this.inPivotFields) this.currentPivotField = {
+					if (this.state.inPivotFields) this.currentPivotField = {
 						axis: attributes.axis,
 						dataField: attributes.dataField === "1",
 						items: [],
@@ -16261,35 +16302,77 @@ var ExcelTS = (function(exports) {
 					};
 					break;
 				case "items":
-					if (this.currentPivotField) this.inItems = true;
+					if (this.currentPivotField) this.state.inItems = true;
 					break;
 				case "item":
-					if (this.inItems && this.currentPivotField && attributes.x !== void 0) this.currentPivotField.items.push(parseInt(attributes.x, 10));
+					if (this.state.inItems && this.currentPivotField && attributes.x !== void 0) this.currentPivotField.items.push(parseInt(attributes.x, 10));
 					break;
 				case "rowFields":
-					this.inRowFields = true;
+					this.state.inRowFields = true;
 					break;
 				case "colFields":
-					this.inColFields = true;
+					this.state.inColFields = true;
 					break;
 				case "dataFields":
-					this.inDataFields = true;
+					this.state.inDataFields = true;
 					break;
 				case "rowItems":
-					this.inRowItems = true;
+					this.state.inRowItems = true;
 					break;
 				case "colItems":
-					this.inColItems = true;
+					this.state.inColItems = true;
+					break;
+				case "i":
+					if (this.state.inRowItems && this.model) this.currentRowItem = {
+						t: attributes.t,
+						x: []
+					};
+					else if (this.state.inColItems && this.model) this.currentColItem = {
+						t: attributes.t,
+						x: []
+					};
+					break;
+				case "x":
+					if (this.state.inPivotArea) {
+						const xAttrs = Object.entries(attributes).map(([k, v]) => `${k}="${v}"`).join(" ");
+						this.pivotAreaXmlBuffer.push(xAttrs ? `<x ${xAttrs}/>` : "<x/>");
+					} else if (this.currentRowItem) this.currentRowItem.x.push({ v: attributes.v ? parseInt(attributes.v, 10) : 0 });
+					else if (this.currentColItem) this.currentColItem.x.push({ v: attributes.v ? parseInt(attributes.v, 10) : 0 });
+					break;
+				case "chartFormats":
+					this.state.inChartFormats = true;
+					break;
+				case "chartFormat":
+					if (this.state.inChartFormats && this.model) this.currentChartFormat = {
+						chart: attributes.chart ? parseInt(attributes.chart, 10) : 0,
+						format: attributes.format ? parseInt(attributes.format, 10) : 0,
+						series: attributes.series === "1"
+					};
+					break;
+				case "pivotArea":
+					if (this.currentChartFormat) {
+						this.state.inPivotArea = true;
+						const attrsStr = Object.entries(attributes).map(([k, v]) => `${k}="${v}"`).join(" ");
+						this.pivotAreaXmlBuffer = [attrsStr ? `<pivotArea ${attrsStr}>` : "<pivotArea>"];
+					}
+					break;
+				case "references":
+				case "reference":
+					if (this.state.inPivotArea) {
+						this.pivotAreaDepth++;
+						const attrsStr = Object.entries(attributes).map(([k, v]) => `${k}="${v}"`).join(" ");
+						this.pivotAreaXmlBuffer.push(`<${name}${attrsStr ? " " + attrsStr : ""}>`);
+					}
 					break;
 				case "field":
 					if (this.model) {
 						const fieldIndex = parseInt(attributes.x || "0", 10);
-						if (this.inRowFields) this.model.rowFields.push(fieldIndex);
-						else if (this.inColFields) this.model.colFields.push(fieldIndex);
+						if (this.state.inRowFields) this.model.rowFields.push(fieldIndex);
+						else if (this.state.inColFields) this.model.colFields.push(fieldIndex);
 					}
 					break;
 				case "dataField":
-					if (this.inDataFields && this.model) this.model.dataFields.push({
+					if (this.state.inDataFields && this.model) this.model.dataFields.push({
 						name: xmlDecode(attributes.name || ""),
 						fld: parseInt(attributes.fld || "0", 10),
 						baseField: attributes.baseField ? parseInt(attributes.baseField, 10) : 0,
@@ -16305,10 +16388,25 @@ var ExcelTS = (function(exports) {
 		}
 		parseText(_text) {}
 		parseClose(name) {
+			if (this.state.inPivotArea) {
+				if (name === "pivotArea") {
+					this.pivotAreaXmlBuffer.push("</pivotArea>");
+					if (this.currentChartFormat) this.currentChartFormat.pivotAreaXml = this.pivotAreaXmlBuffer.join("");
+					this.state.inPivotArea = false;
+					this.pivotAreaXmlBuffer = [];
+					this.pivotAreaDepth = 0;
+					return true;
+				} else if (name === "references" || name === "reference") {
+					this.pivotAreaXmlBuffer.push(`</${name}>`);
+					this.pivotAreaDepth--;
+					return true;
+				}
+				return true;
+			}
 			switch (name) {
 				case this.tag: return false;
 				case "pivotFields":
-					this.inPivotFields = false;
+					this.state.inPivotFields = false;
 					break;
 				case "pivotField":
 					if (this.currentPivotField && this.model) {
@@ -16317,22 +16415,40 @@ var ExcelTS = (function(exports) {
 					}
 					break;
 				case "items":
-					this.inItems = false;
+					this.state.inItems = false;
 					break;
 				case "rowFields":
-					this.inRowFields = false;
+					this.state.inRowFields = false;
 					break;
 				case "colFields":
-					this.inColFields = false;
+					this.state.inColFields = false;
 					break;
 				case "dataFields":
-					this.inDataFields = false;
+					this.state.inDataFields = false;
 					break;
 				case "rowItems":
-					this.inRowItems = false;
+					this.state.inRowItems = false;
 					break;
 				case "colItems":
-					this.inColItems = false;
+					this.state.inColItems = false;
+					break;
+				case "i":
+					if (this.currentRowItem && this.model) {
+						this.model.rowItems.push(this.currentRowItem);
+						this.currentRowItem = null;
+					} else if (this.currentColItem && this.model) {
+						this.model.colItems.push(this.currentColItem);
+						this.currentColItem = null;
+					}
+					break;
+				case "chartFormats":
+					this.state.inChartFormats = false;
+					break;
+				case "chartFormat":
+					if (this.currentChartFormat && this.model) {
+						this.model.chartFormats.push(this.currentChartFormat);
+						this.currentChartFormat = null;
+					}
 					break;
 			}
 			return true;
@@ -20205,6 +20321,115 @@ var ExcelTS = (function(exports) {
 		}
 	};
 
+//#endregion
+//#region src/modules/excel/utils/passthrough-manager.ts
+/**
+	* Content type definitions for passthrough files
+	*/
+	const PASSTHROUGH_CONTENT_TYPES = new Map([
+		[/^xl\/charts\/chart\d+\.xml$/, "application/vnd.openxmlformats-officedocument.drawingml.chart+xml"],
+		[/^xl\/charts\/style\d+\.xml$/, "application/vnd.ms-office.chartstyle+xml"],
+		[/^xl\/charts\/colors\d+\.xml$/, "application/vnd.ms-office.chartcolorstyle+xml"]
+	]);
+	/**
+	* Passthrough path prefixes that should be preserved
+	*/
+	const PASSTHROUGH_PREFIXES = ["xl/charts/"];
+	/**
+	* PassthroughManager handles storage and retrieval of passthrough files
+	* that need to be preserved during Excel read/write cycles.
+	*/
+	var PassthroughManager = class PassthroughManager {
+		constructor() {
+			this.files = /* @__PURE__ */ new Map();
+		}
+		/**
+		* Check if a path should be treated as passthrough
+		*/
+		static isPassthroughPath(path) {
+			return PASSTHROUGH_PREFIXES.some((prefix) => path.startsWith(prefix));
+		}
+		/**
+		* Get the content type for a passthrough file path
+		* @returns Content type string or undefined if unknown
+		*/
+		static getContentType(path) {
+			if (path.startsWith("xl/charts/_rels/")) return;
+			for (const [regex, contentType] of PASSTHROUGH_CONTENT_TYPES) if (regex.test(path)) return contentType;
+		}
+		/**
+		* Add a file to passthrough storage
+		*/
+		add(path, data) {
+			this.files.set(path, data);
+		}
+		/**
+		* Get a file from passthrough storage
+		*/
+		get(path) {
+			return this.files.get(path);
+		}
+		/**
+		* Check if a file exists in passthrough storage
+		*/
+		has(path) {
+			return this.files.has(path);
+		}
+		/**
+		* Get all stored paths
+		*/
+		getPaths() {
+			return [...this.files.keys()];
+		}
+		/**
+		* Get all files as a record (for serialization)
+		*/
+		toRecord() {
+			const record = {};
+			for (const [path, data] of this.files) record[path] = data;
+			return record;
+		}
+		/**
+		* Load files from a record (for deserialization)
+		*/
+		fromRecord(record) {
+			this.files.clear();
+			for (const [path, data] of Object.entries(record)) this.files.set(path, data);
+		}
+		/**
+		* Get content types for all stored files that have known types
+		*/
+		getContentTypes() {
+			const contentTypes = [];
+			for (const path of this.files.keys()) {
+				const contentType = PassthroughManager.getContentType(path);
+				if (contentType) contentTypes.push({
+					partName: path,
+					contentType
+				});
+			}
+			return contentTypes;
+		}
+		/**
+		* Write all passthrough files to a ZIP writer
+		*/
+		writeToZip(zip$1) {
+			for (const [path, data] of this.files) zip$1.append(data, { name: path });
+		}
+		/**
+		* Clear all stored files
+		*/
+		clear() {
+			this.files.clear();
+		}
+		/**
+		* Get the number of stored files
+		*/
+		get size() {
+			return this.files.size;
+		}
+	};
+
 //#endregion
 //#region src/modules/excel/xlsx/xlsx.browser.ts
 /**
@@ -20355,6 +20580,7 @@ var ExcelTS = (function(exports) {
 			this.addDrawings(zip$1, model);
 			this.addTables(zip$1, model);
 			this.addPivotTables(zip$1, model);
+			this.addPassthrough(zip$1, model);
 			await Promise.all([this.addThemes(zip$1, model), this.addStyles(zip$1, model)]);
 			await this.addFeaturePropertyBag(zip$1, model);
 			await this.addMedia(zip$1, model);
@@ -20428,8 +20654,12 @@ var ExcelTS = (function(exports) {
 		* This is the foundation for TRUE streaming reads on platforms that have a
 		* streaming ZIP parser (e.g. Node.js `modules/archive` Parse).
 		*/
-		async loadFromZipEntries(entries, options) {
-			const model = {
+		/**
+		* Create an empty model for parsing XLSX files.
+		* Shared by loadFromZipEntries and loadFromFiles.
+		*/
+		createEmptyModel() {
+			return {
 				worksheets: [],
 				worksheetHash: {},
 				worksheetRels: [],
@@ -20438,6 +20668,7 @@ var ExcelTS = (function(exports) {
 				mediaIndex: {},
 				drawings: {},
 				drawingRels: {},
+				rawDrawings: {},
 				comments: {},
 				tables: {},
 				vmlDrawings: {},
@@ -20445,8 +20676,93 @@ var ExcelTS = (function(exports) {
 				pivotTableRels: {},
 				pivotCacheDefinitions: {},
 				pivotCacheDefinitionRels: {},
-				pivotCacheRecords: {}
+				pivotCacheRecords: {},
+				passthrough: {}
 			};
+		}
+		/**
+		* Collect all data from a stream into a single Uint8Array.
+		* Reusable helper for passthrough and drawing processing.
+		*/
+		async collectStreamData(stream) {
+			const chunks = [];
+			await new Promise((resolve, reject) => {
+				stream.on("data", (chunk) => {
+					if (typeof chunk === "string") chunks.push(new TextEncoder().encode(chunk));
+					else if (chunk instanceof Uint8Array) chunks.push(chunk);
+					else chunks.push(new Uint8Array(chunk));
+				});
+				stream.on("end", () => resolve());
+				stream.on("error", reject);
+			});
+			return concatUint8Arrays$2(chunks);
+		}
+		/**
+		* Check if a drawing has chart references in its relationships
+		*/
+		drawingHasChartReference(drawing) {
+			return drawing.rels && drawing.rels.some((rel) => rel.Target && rel.Target.includes("/charts/"));
+		}
+		/**
+		* Check if a drawing rels list references charts.
+		* Used to decide whether we need to keep raw drawing XML for passthrough.
+		*/
+		drawingRelsHasChartReference(drawingRels) {
+			return Array.isArray(drawingRels) && drawingRels.some((rel) => typeof rel?.Target === "string" && rel.Target.includes("/charts/"));
+		}
+		/**
+		* Process a known OOXML entry (workbook, styles, shared strings, etc.)
+		* Returns true if handled, false if should be passed to _processDefaultEntry
+		*/
+		async _processKnownEntry(stream, model, entryName, options) {
+			const sheetNo = getWorksheetNoFromWorksheetPath(entryName);
+			if (sheetNo !== void 0) {
+				await this._processWorksheetEntry(stream, model, sheetNo, options, entryName);
+				return true;
+			}
+			switch (entryName) {
+				case OOXML_PATHS.rootRels:
+					model.globalRels = await this.parseRels(stream);
+					return true;
+				case OOXML_PATHS.xlWorkbook: {
+					const workbook = await this.parseWorkbook(stream);
+					model.sheets = workbook.sheets;
+					model.definedNames = workbook.definedNames;
+					model.views = workbook.views;
+					model.properties = workbook.properties;
+					model.calcProperties = workbook.calcProperties;
+					model.pivotCaches = workbook.pivotCaches;
+					return true;
+				}
+				case OOXML_PATHS.xlSharedStrings:
+					model.sharedStrings = new SharedStringsXform();
+					await model.sharedStrings.parseStream(stream);
+					return true;
+				case OOXML_PATHS.xlWorkbookRels:
+					model.workbookRels = await this.parseRels(stream);
+					return true;
+				case OOXML_PATHS.docPropsApp: {
+					const appProperties = await new AppXform().parseStream(stream);
+					if (appProperties) {
+						model.company = appProperties.company;
+						model.manager = appProperties.manager;
+					}
+					return true;
+				}
+				case OOXML_PATHS.docPropsCore: {
+					const coreProperties = await new CoreXform().parseStream(stream);
+					Object.assign(model, coreProperties);
+					return true;
+				}
+				case OOXML_PATHS.xlStyles:
+					model.styles = new StylesXform();
+					await model.styles.parseStream(stream);
+					return true;
+				default: return false;
+			}
+		}
+		async loadFromZipEntries(entries, options) {
+			const model = this.createEmptyModel();
 			for await (const entry of entries) {
 				let drained = false;
 				const drainEntry = async () => {
@@ -20461,52 +20777,8 @@ var ExcelTS = (function(exports) {
 				const entryName = normalizeZipPath(entry.name);
 				const stream = entry.stream;
 				try {
-					const sheetNo = getWorksheetNoFromWorksheetPath(entryName);
-					if (sheetNo !== void 0) {
-						await this._processWorksheetEntry(stream, model, sheetNo, options, entryName);
-						continue;
-					}
-					switch (entryName) {
-						case OOXML_PATHS.rootRels:
-							model.globalRels = await this.parseRels(stream);
-							break;
-						case OOXML_PATHS.xlWorkbook: {
-							const workbook = await this.parseWorkbook(stream);
-							model.sheets = workbook.sheets;
-							model.definedNames = workbook.definedNames;
-							model.views = workbook.views;
-							model.properties = workbook.properties;
-							model.calcProperties = workbook.calcProperties;
-							model.pivotCaches = workbook.pivotCaches;
-							break;
-						}
-						case OOXML_PATHS.xlSharedStrings:
-							model.sharedStrings = new SharedStringsXform();
-							await model.sharedStrings.parseStream(stream);
-							break;
-						case OOXML_PATHS.xlWorkbookRels:
-							model.workbookRels = await this.parseRels(stream);
-							break;
-						case OOXML_PATHS.docPropsApp: {
-							const appProperties = await new AppXform().parseStream(stream);
-							if (appProperties) {
-								model.company = appProperties.company;
-								model.manager = appProperties.manager;
-							}
-							break;
-						}
-						case OOXML_PATHS.docPropsCore: {
-							const coreProperties = await new CoreXform().parseStream(stream);
-							Object.assign(model, coreProperties);
-							break;
-						}
-						case OOXML_PATHS.xlStyles:
-							model.styles = new StylesXform();
-							await model.styles.parseStream(stream);
-							break;
-						default:
-							if (!await this._processDefaultEntry(stream, model, entryName)) await drainEntry();
-							break;
+					if (!await this._processKnownEntry(stream, model, entryName, options)) {
+						if (!await this._processDefaultEntry(stream, model, entryName)) await drainEntry();
 					}
 				} finally {
 					try {
@@ -20595,6 +20867,10 @@ var ExcelTS = (function(exports) {
 					drawingXform.reconcile(drawing, drawingOptions);
 				}
 			});
+			if (model.rawDrawings && model.drawingRels) for (const name of Object.keys(model.rawDrawings)) {
+				const drawingRel = model.drawingRels[name];
+				if (drawingRel && !this.drawingRelsHasChartReference(drawingRel)) delete model.rawDrawings[name];
+			}
 			const tableOptions = { styles: model.styles };
 			Object.values(model.tables).forEach((table) => {
 				tableXform.reconcile(table, tableOptions);
@@ -20607,6 +20883,7 @@ var ExcelTS = (function(exports) {
 				mediaIndex: model.mediaIndex,
 				date1904: model.properties && model.properties.date1904,
 				drawings: model.drawings,
+				drawingRels: model.drawingRels,
 				comments: model.comments,
 				tables: model.tables,
 				vmlDrawings: model.vmlDrawings,
@@ -20763,8 +21040,12 @@ var ExcelTS = (function(exports) {
 			}
 		}
 		async _processDrawingEntry(entry, model, name) {
-			const drawing = await new DrawingXform().parseStream(entry);
+			const rawData = await this.collectStreamData(entry);
+			const xform$1 = new DrawingXform();
+			const xmlString = this.bufferToString(rawData);
+			const drawing = await xform$1.parseStream(this.createTextStream(xmlString));
 			model.drawings[name] = drawing;
+			model.rawDrawings[name] = rawData;
 		}
 		async _processDrawingRelsEntry(entry, model, name) {
 			const relationships = await new RelationshipsXform().parseStream(entry);
@@ -20819,24 +21100,7 @@ var ExcelTS = (function(exports) {
 			if (cacheRecords) model.pivotCacheRecords[name] = cacheRecords;
 		}
 		async loadFromFiles(zipData, options) {
-			const model = {
-				worksheets: [],
-				worksheetHash: {},
-				worksheetRels: [],
-				themes: {},
-				media: [],
-				mediaIndex: {},
-				drawings: {},
-				drawingRels: {},
-				comments: {},
-				tables: {},
-				vmlDrawings: {},
-				pivotTables: {},
-				pivotTableRels: {},
-				pivotCacheDefinitions: {},
-				pivotCacheDefinitionRels: {},
-				pivotCacheRecords: {}
-			};
+			const model = this.createEmptyModel();
 			const entries = Object.keys(zipData).map((name) => ({
 				name,
 				dir: name.endsWith("/"),
@@ -20845,48 +21109,7 @@ var ExcelTS = (function(exports) {
 			for (const entry of entries) if (!entry.dir) {
 				const entryName = normalizeZipPath(entry.name);
 				const stream = isBinaryEntryPath(entryName) ? this.createBinaryStream(entry.data) : this.createTextStream(this.bufferToString(entry.data));
-				const sheetNo = getWorksheetNoFromWorksheetPath(entryName);
-				if (sheetNo !== void 0) await this._processWorksheetEntry(stream, model, sheetNo, options, entryName);
-				else switch (entryName) {
-					case OOXML_PATHS.rootRels:
-						model.globalRels = await this.parseRels(stream);
-						break;
-					case OOXML_PATHS.xlWorkbook: {
-						const workbook = await this.parseWorkbook(stream);
-						model.sheets = workbook.sheets;
-						model.definedNames = workbook.definedNames;
-						model.views = workbook.views;
-						model.properties = workbook.properties;
-						model.calcProperties = workbook.calcProperties;
-						model.pivotCaches = workbook.pivotCaches;
-						break;
-					}
-					case OOXML_PATHS.xlSharedStrings:
-						model.sharedStrings = new SharedStringsXform();
-						await model.sharedStrings.parseStream(stream);
-						break;
-					case OOXML_PATHS.xlWorkbookRels:
-						model.workbookRels = await this.parseRels(stream);
-						break;
-					case OOXML_PATHS.docPropsApp: {
-						const appProperties = await new AppXform().parseStream(stream);
-						if (appProperties) {
-							model.company = appProperties.company;
-							model.manager = appProperties.manager;
-						}
-						break;
-					}
-					case OOXML_PATHS.docPropsCore: {
-						const coreProperties = await new CoreXform().parseStream(stream);
-						Object.assign(model, coreProperties);
-						break;
-					}
-					case OOXML_PATHS.xlStyles:
-						model.styles = new StylesXform();
-						await model.styles.parseStream(stream);
-						break;
-					default: await this._processDefaultEntry(stream, model, entryName);
-				}
+				if (!await this._processKnownEntry(stream, model, entryName, options)) await this._processDefaultEntry(stream, model, entryName, entry.data);
 			}
 			this.reconcile(model, options);
 			this.workbook.model = model;
@@ -20894,11 +21117,11 @@ var ExcelTS = (function(exports) {
 		}
 		/**
 		* Process default entries (drawings, comments, tables, etc.)
+		* @param rawData Optional raw entry data for passthrough preservation (used by loadFromFiles)
 		*/
-		async _processDefaultEntry(stream, model, entryName) {
-			const worksheetRelsSheetNo = getWorksheetNoFromWorksheetRelsPath(entryName);
-			if (worksheetRelsSheetNo !== void 0) {
-				const sheetNo = worksheetRelsSheetNo;
+		async _processDefaultEntry(stream, model, entryName, rawData) {
+			const sheetNo = getWorksheetNoFromWorksheetRelsPath(entryName);
+			if (sheetNo !== void 0) {
 				await this._processWorksheetRelsEntry(stream, model, sheetNo);
 				return true;
 			}
@@ -20910,6 +21133,7 @@ var ExcelTS = (function(exports) {
 			const drawingName = getDrawingNameFromPath(entryName);
 			if (drawingName) {
 				await this._processDrawingEntry(stream, model, drawingName);
+				if (rawData) model.rawDrawings[drawingName] = rawData;
 				return true;
 			}
 			const drawingRelsName = getDrawingNameFromRelsPath(entryName);
@@ -20962,8 +21186,21 @@ var ExcelTS = (function(exports) {
 				await this._processPivotCacheRecordsEntry(stream, model, pivotCacheRecordsName);
 				return true;
 			}
+			if (PassthroughManager.isPassthroughPath(entryName)) {
+				if (rawData) model.passthrough[entryName] = rawData;
+				else await this._processPassthroughEntry(stream, model, entryName);
+				return true;
+			}
 			return false;
 		}
+		/**
+		* Store a passthrough file for preservation during read/write cycles.
+		* These files are not parsed but stored as raw bytes to be written back unchanged.
+		*/
+		async _processPassthroughEntry(stream, model, entryName) {
+			const data = await this.collectStreamData(stream);
+			model.passthrough[entryName] = data;
+		}
 		async addContentTypes(zip$1, model) {
 			const xml = new ContentTypesXform().toXml(model);
 			zip$1.append(xml, { name: OOXML_PATHS.contentTypes });
@@ -21100,14 +21337,29 @@ var ExcelTS = (function(exports) {
 		addDrawings(zip$1, model) {
 			const drawingXform = new DrawingXform();
 			const relsXform = new RelationshipsXform();
+			const rawDrawings = model.rawDrawings || {};
 			model.worksheets.forEach((worksheet) => {
 				const { drawing } = worksheet;
 				if (drawing) {
-					drawingXform.prepare(drawing);
-					let xml = drawingXform.toXml(drawing);
-					zip$1.append(xml, { name: drawingPath(drawing.name) });
-					xml = relsXform.toXml(drawing.rels);
-					zip$1.append(xml, { name: drawingRelsPath(drawing.name) });
+					if (this.drawingHasChartReference(drawing) && rawDrawings[drawing.name]) zip$1.append(rawDrawings[drawing.name], { name: drawingPath(drawing.name) });
+					else {
+						const filteredAnchors = (drawing.anchors || []).filter((a) => {
+							if (a == null) return false;
+							if (a.range?.br && a.shape) return true;
+							if (!a.br && !a.picture) return false;
+							if (a.br && !a.picture && !a.shape) return false;
+							return true;
+						});
+						const drawingForWrite = drawing.anchors ? {
+							...drawing,
+							anchors: filteredAnchors
+						} : drawing;
+						drawingXform.prepare(drawingForWrite);
+						const xml = drawingXform.toXml(drawingForWrite);
+						zip$1.append(xml, { name: drawingPath(drawing.name) });
+					}
+					const relsXml = relsXform.toXml(drawing.rels);
+					zip$1.append(relsXml, { name: drawingRelsPath(drawing.name) });
 				}
 			});
 		}
@@ -21122,6 +21374,15 @@ var ExcelTS = (function(exports) {
 				});
 			});
 		}
+		/**
+		* Write passthrough files (charts, etc.) that were preserved during read.
+		* These files are written back unchanged to preserve unsupported features.
+		*/
+		addPassthrough(zip$1, model) {
+			const passthroughManager = new PassthroughManager();
+			passthroughManager.fromRecord(model.passthrough || {});
+			passthroughManager.writeToZip(zip$1);
+		}
 		addPivotTables(zip$1, model) {
 			if (!model.pivotTables.length) return;
 			const pivotCacheRecordsXform = new PivotCacheRecordsXform();
@@ -21204,6 +21465,10 @@ var ExcelTS = (function(exports) {
 				worksheetXform.prepare(worksheet, worksheetOptions);
 			});
 			model.hasCheckboxes = model.styles.hasCheckboxes;
+			const passthrough = model.passthrough || {};
+			const passthroughManager = new PassthroughManager();
+			passthroughManager.fromRecord(passthrough);
+			model.passthroughContentTypes = passthroughManager.getContentTypes();
 		}
 	};
 
@@ -22405,7 +22670,7 @@ var ExcelTS = (function(exports) {
 			else str = String(content);
 			const worksheet = this.workbook.addWorksheet(options?.sheetName);
 			const dateFormats = options?.dateFormats ?? DEFAULT_DATE_FORMATS;
-			const map = options?.map || createDefaultValueMapper(dateFormats, { decimalSeparator: options?.valueMapperOptions?.decimalSeparator ?? options?.parserOptions?.decimalSeparator });
+			const map = options?.map || createDefaultValueMapper(dateFormats, { decimalSeparator: options?.valueMapperOptions?.decimalSeparator });
 			const rows = parseCsv(str, options?.parserOptions);
 			for (const row of rows) worksheet.addRow(row.map(map));
 			return worksheet;
@@ -22433,7 +22698,7 @@ var ExcelTS = (function(exports) {
 		async read(stream, options) {
 			const worksheet = this.workbook.addWorksheet(options?.sheetName);
 			const dateFormats = options?.dateFormats ?? DEFAULT_DATE_FORMATS;
-			const map = options?.map || createDefaultValueMapper(dateFormats, { decimalSeparator: options?.valueMapperOptions?.decimalSeparator ?? options?.parserOptions?.decimalSeparator });
+			const map = options?.map || createDefaultValueMapper(dateFormats, { decimalSeparator: options?.valueMapperOptions?.decimalSeparator });
 			const parser = new CsvParserStream(options?.parserOptions);
 			return new Promise((resolve, reject) => {
 				parser.on("data", (row) => worksheet.addRow(row.map(map)));
@@ -22485,7 +22750,7 @@ var ExcelTS = (function(exports) {
 		createWriteStream(options) {
 			const worksheet = this.workbook.addWorksheet(options?.sheetName);
 			const dateFormats = options?.dateFormats ?? DEFAULT_DATE_FORMATS;
-			const map = options?.map || createDefaultValueMapper(dateFormats, { decimalSeparator: options?.valueMapperOptions?.decimalSeparator ?? options?.parserOptions?.decimalSeparator });
+			const map = options?.map || createDefaultValueMapper(dateFormats, { decimalSeparator: options?.valueMapperOptions?.decimalSeparator });
 			const parser = new CsvParserStream(options?.parserOptions);
 			parser.on("data", (row) => worksheet.addRow(row.map(map)));
 			return parser;
@@ -25486,6 +25751,8 @@ onmessage = async (ev) => {
 			this.views = [];
 			this.media = [];
 			this.pivotTables = [];
+			this._passthrough = {};
+			this._rawDrawings = {};
 			this._definedNames = new DefinedNames();
 		}
 		/**
@@ -25658,7 +25925,9 @@ onmessage = async (ev) => {
 				themes: this._themes,
 				media: this.media,
 				pivotTables: this.pivotTables,
-				calcProperties: this.calcProperties
+				calcProperties: this.calcProperties,
+				passthrough: this._passthrough,
+				rawDrawings: this._rawDrawings
 			};
 		}
 		set model(value) {
@@ -25697,6 +25966,8 @@ onmessage = async (ev) => {
 			this._themes = value.themes;
 			this.media = value.media || [];
 			this.pivotTables = value.pivotTables || value.loadedPivotTables || [];
+			this._passthrough = value.passthrough || {};
+			this._rawDrawings = value.rawDrawings || {};
 		}
 	};