@office-open/xlsx 0.6.4 → 0.6.6

package/dist/index.js

@@ -0,0 +1,1628 @@
+import { AppProperties, BaseXmlComponent, ChartCollection, ChartSpace, Formatter, IgnoreIfEmptyXmlComponent, OoxmlMimeType, Relationships, buildCorePropertiesXml, compileMapping, createPacker, parseArchive, parseCorePropsElement, strFromU8, toJson, unzipSync, zipAndConvert } from "@office-open/core";
+import { attr, attrNum, attrs, escapeXml, findChild, js2xml, selfCloseElement, textOf } from "@office-open/xml";
+import { toUint8Array } from "undio";
+//#region src/file/content-types.ts
+/**
+* Content Types module for XLSX packages.
+*
+* @module
+*/
+const XLSX_MAIN = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml";
+const XLSX_WORKSHEET = "application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml";
+const XLSX_STYLES = "application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml";
+const XLSX_SHARED_STRINGS = "application/vnd.openxmlformats-officedocument.spreadsheetml.sharedStrings+xml";
+const XLSX_THEME = "application/vnd.openxmlformats-officedocument.theme+xml";
+const XLSX_CHART = "application/vnd.openxmlformats-officedocument.drawingml.chart+xml";
+const STATIC_CHILDREN = [{ _attr: { xmlns: "http://schemas.openxmlformats.org/package/2006/content-types" } }, ...[
+	{
+		type: "Default",
+		contentType: "application/vnd.openxmlformats-package.relationships+xml",
+		key: "rels"
+	},
+	{
+		type: "Default",
+		contentType: "application/xml",
+		key: "xml"
+	},
+	{
+		type: "Default",
+		contentType: "image/png",
+		key: "png"
+	},
+	{
+		type: "Default",
+		contentType: "image/jpeg",
+		key: "jpeg"
+	},
+	{
+		type: "Override",
+		contentType: XLSX_MAIN,
+		key: "/xl/workbook.xml"
+	},
+	{
+		type: "Override",
+		contentType: "application/vnd.openxmlformats-package.core-properties+xml",
+		key: "/docProps/core.xml"
+	},
+	{
+		type: "Override",
+		contentType: "application/vnd.openxmlformats-officedocument.extended-properties+xml",
+		key: "/docProps/app.xml"
+	}
+].map((e) => {
+	if (e.type === "Default") return { Default: { _attr: {
+		ContentType: e.contentType,
+		Extension: e.key
+	} } };
+	return { Override: { _attr: {
+		ContentType: e.contentType,
+		PartName: e.key
+	} } };
+})];
+var ContentTypes = class extends BaseXmlComponent {
+	dynamicEntries = [];
+	constructor() {
+		super("Types");
+	}
+	addWorksheet(index) {
+		this.dynamicEntries.push({
+			type: "Override",
+			contentType: XLSX_WORKSHEET,
+			key: `/xl/worksheets/sheet${index}.xml`
+		});
+	}
+	addStyles() {
+		this.dynamicEntries.push({
+			type: "Override",
+			contentType: XLSX_STYLES,
+			key: "/xl/styles.xml"
+		});
+	}
+	addSharedStrings() {
+		this.dynamicEntries.push({
+			type: "Override",
+			contentType: XLSX_SHARED_STRINGS,
+			key: "/xl/sharedStrings.xml"
+		});
+	}
+	addTheme(index = 1) {
+		this.dynamicEntries.push({
+			type: "Override",
+			contentType: XLSX_THEME,
+			key: `/xl/theme/theme${index}.xml`
+		});
+	}
+	addChart(index) {
+		this.dynamicEntries.push({
+			type: "Override",
+			contentType: XLSX_CHART,
+			key: `/xl/charts/chart${index}.xml`
+		});
+	}
+	addDrawing(index) {
+		this.dynamicEntries.push({
+			type: "Override",
+			contentType: "application/vnd.openxmlformats-officedocument.drawing+xml",
+			key: `/xl/drawings/drawing${index}.xml`
+		});
+	}
+	prepForXml(_context) {
+		const children = [...STATIC_CHILDREN];
+		for (const e of this.dynamicEntries) if (e.type === "Default") children.push({ Default: { _attr: {
+			ContentType: e.contentType,
+			Extension: e.key
+		} } });
+		else children.push({ Override: { _attr: {
+			ContentType: e.contentType,
+			PartName: e.key
+		} } });
+		return { Types: children };
+	}
+};
+//#endregion
+//#region src/file/core-properties.ts
+/**
+* Core Properties module for SpreadsheetML documents.
+*
+* @module
+*/
+var CoreProperties = class extends BaseXmlComponent {
+	options;
+	constructor(options) {
+		super("cp:coreProperties");
+		this.options = options;
+	}
+	prepForXml(_context) {
+		return buildCorePropertiesXml(this.options);
+	}
+};
+//#endregion
+//#region src/file/media/media.ts
+var Media = class {
+	map = /* @__PURE__ */ new Map();
+	addImage(key, data) {
+		this.map.set(key, data);
+	}
+	get array() {
+		return [...this.map.values()];
+	}
+};
+//#endregion
+//#region src/file/shared-strings.ts
+/**
+* Shared Strings Table — generates xl/sharedStrings.xml.
+*
+* XLSX stores repeated string values in a central table to reduce file size.
+* Cells reference strings by index into this table.
+*
+* @module
+*/
+var SharedStrings = class extends BaseXmlComponent {
+	strings = [];
+	indexMap = /* @__PURE__ */ new Map();
+	constructor() {
+		super("sst");
+	}
+	/**
+	* Register a string and return its index.
+	* Returns existing index if the string is already registered.
+	*/
+	register(s) {
+		const existing = this.indexMap.get(s);
+		if (existing !== void 0) return existing;
+		const idx = this.strings.length;
+		this.strings.push(s);
+		this.indexMap.set(s, idx);
+		return idx;
+	}
+	get count() {
+		return this.strings.length;
+	}
+	/**
+	* Zero-allocation fast path: directly concatenate XML string.
+	* Bypasses the IXmlableObject intermediate tree entirely.
+	*/
+	toXml(_context) {
+		const p = ["<sst xmlns=\"http://schemas.openxmlformats.org/spreadsheetml/2006/main\"", ` count="${this.strings.length}" uniqueCount="${this.indexMap.size}">`];
+		for (const s of this.strings) p.push(`<si><t>${escapeXml(s)}</t></si>`);
+		p.push("</sst>");
+		return p.join("");
+	}
+	prepForXml(_context) {
+		const children = [{ _attr: {
+			xmlns: "http://schemas.openxmlformats.org/spreadsheetml/2006/main",
+			count: this.strings.length,
+			uniqueCount: this.indexMap.size
+		} }];
+		for (const s of this.strings) children.push({ si: [{ t: [s] }] });
+		return { sst: children };
+	}
+};
+//#endregion
+//#region src/file/styles.ts
+/**
+* Styles component — generates xl/styles.xml.
+*
+* XLSX uses an index-based style system: cells reference style entries
+* via the `s` attribute, which is an index into `cellXfs`.
+*
+* @module
+*/
+function fontKey(f) {
+	return `b${f.bold ? 1 : 0}i${f.italic ? 1 : 0}u${f.underline ? 1 : 0}s${f.strike ? 1 : 0}z${f.size ?? 0}c${f.color ?? ""}n${f.fontName ?? ""}`;
+}
+function fillKey(f) {
+	return `t${f.type ?? ""}c${f.color ?? ""}p${f.patternType ?? ""}`;
+}
+function borderKey(b) {
+	const sk = (o) => `${o?.style ?? ""}_${o?.color ?? ""}`;
+	return `t${sk(b.top)}b${sk(b.bottom)}l${sk(b.left)}r${sk(b.right)}d${sk(b.diagonal)}`;
+}
+const BUILTIN_NUMFMTS = {
+	General: 0,
+	"0": 1,
+	"0.00": 2,
+	"#,##0": 3,
+	"#,##0.00": 4,
+	"0%": 9,
+	"0.00%": 10,
+	"0.00E+00": 11,
+	"mm-dd-yy": 14,
+	"d-mmm-yy": 15,
+	"d-mmm": 16,
+	"mmm-yy": 17,
+	"h:mm AM/PM": 18,
+	"h:mm:ss AM/PM": 19,
+	"h:mm": 20,
+	"h:mm:ss": 21,
+	"m/d/yy h:mm": 22,
+	"#,##0 ;(#,##0)": 37,
+	"#,##0 ;[Red](#,##0)": 38,
+	"#,##0.00;(#,##0.00)": 39,
+	"#,##0.00;[Red](#,##0.00)": 40,
+	"mm:ss": 45,
+	"[h]:mm:ss": 46,
+	"mmss.0": 47,
+	"##0.0E+0": 48,
+	"@": 49
+};
+var Styles = class extends BaseXmlComponent {
+	fonts = [{
+		size: 11,
+		fontName: "Calibri"
+	}];
+	fontKeys = /* @__PURE__ */ new Map();
+	fills = [{ patternType: "none" }, { patternType: "gray125" }];
+	fillKeys = /* @__PURE__ */ new Map();
+	borders = [{}];
+	borderKeys = /* @__PURE__ */ new Map();
+	customNumFmts = /* @__PURE__ */ new Map();
+	nextCustomNumFmtId = 164;
+	cellXfs = [{
+		fontId: 0,
+		fillId: 0,
+		borderId: 0,
+		numFmtId: 0
+	}];
+	cellXfKeys = /* @__PURE__ */ new Map();
+	constructor() {
+		super("styleSheet");
+		this.fontKeys.set(fontKey(this.fonts[0]), 0);
+		this.fillKeys.set(fillKey(this.fills[0]), 0);
+		this.fillKeys.set(fillKey(this.fills[1]), 1);
+		this.borderKeys.set(borderKey(this.borders[0]), 0);
+		this.cellXfKeys.set(this.cellXfKey(this.cellXfs[0]), 0);
+	}
+	/**
+	* Register a style and return its index (for the cell `s` attribute).
+	* Deduplicates across fonts, fills, borders, numFmts, and cellXfs.
+	*/
+	register(opts) {
+		const xf = {
+			fontId: this.registerFont(opts.font),
+			fillId: this.registerFill(opts.fill),
+			borderId: this.registerBorder(opts.border),
+			numFmtId: this.registerNumFmt(opts.numFmt),
+			alignment: opts.alignment
+		};
+		const key = this.cellXfKey(xf);
+		const existing = this.cellXfKeys.get(key);
+		if (existing !== void 0) return existing;
+		const idx = this.cellXfs.length;
+		this.cellXfs.push(xf);
+		this.cellXfKeys.set(key, idx);
+		return idx;
+	}
+	registerFont(opts) {
+		if (!opts) return 0;
+		const key = fontKey(opts);
+		const existing = this.fontKeys.get(key);
+		if (existing !== void 0) return existing;
+		const idx = this.fonts.length;
+		this.fonts.push(opts);
+		this.fontKeys.set(key, idx);
+		return idx;
+	}
+	registerFill(opts) {
+		if (!opts) return 0;
+		const key = fillKey(opts);
+		const existing = this.fillKeys.get(key);
+		if (existing !== void 0) return existing;
+		const idx = this.fills.length;
+		this.fills.push(opts);
+		this.fillKeys.set(key, idx);
+		return idx;
+	}
+	registerBorder(opts) {
+		if (!opts) return 0;
+		const key = borderKey(opts);
+		const existing = this.borderKeys.get(key);
+		if (existing !== void 0) return existing;
+		const idx = this.borders.length;
+		this.borders.push(opts);
+		this.borderKeys.set(key, idx);
+		return idx;
+	}
+	registerNumFmt(fmt) {
+		if (!fmt) return 0;
+		const builtin = BUILTIN_NUMFMTS[fmt];
+		if (builtin !== void 0) return builtin;
+		const existing = this.customNumFmts.get(fmt);
+		if (existing !== void 0) return existing;
+		const id = this.nextCustomNumFmtId++;
+		this.customNumFmts.set(fmt, id);
+		return id;
+	}
+	cellXfKey(xf) {
+		const a = xf.alignment;
+		const ak = a ? `h${a.horizontal ?? ""}v${a.vertical ?? ""}w${a.wrapText ? 1 : 0}r${a.textRotation ?? ""}i${a.indent ?? ""}` : "";
+		return `${xf.fontId}|${xf.fillId}|${xf.borderId}|${xf.numFmtId}|${ak}`;
+	}
+	/**
+	* Zero-allocation fast path: directly concatenate XML string.
+	* Bypasses the IXmlableObject intermediate tree entirely.
+	*/
+	toXml(_context) {
+		const p = ["<styleSheet xmlns=\"http://schemas.openxmlformats.org/spreadsheetml/2006/main\">"];
+		if (this.customNumFmts.size > 0) {
+			p.push(`<numFmts count="${this.customNumFmts.size}">`);
+			for (const [fmt, id] of this.customNumFmts) p.push(`<numFmt numFmtId="${id}" formatCode="${escapeXml(fmt)}"/>`);
+			p.push("</numFmts>");
+		}
+		p.push(`<fonts count="${this.fonts.length}">`);
+		for (const f of this.fonts) p.push(`<font>${this.fontXmlStr(f)}</font>`);
+		p.push("</fonts>");
+		p.push(`<fills count="${this.fills.length}">`);
+		for (const f of this.fills) {
+			const patternAttrs = attrs({ patternType: f.patternType ?? "solid" });
+			const fgColor = f.color ? `<fgColor rgb="FF${f.color}"/>` : "";
+			p.push(`<fill><patternFill${patternAttrs}>${fgColor}</patternFill></fill>`);
+		}
+		p.push("</fills>");
+		p.push(`<borders count="${this.borders.length}">`);
+		for (const b of this.borders) p.push(`<border>${this.borderXmlStr(b)}</border>`);
+		p.push("</borders>");
+		p.push("<cellStyleXfs count=\"1\"><xf numFmtId=\"0\" fontId=\"0\" fillId=\"0\" borderId=\"0\"/></cellStyleXfs>");
+		p.push(`<cellXfs count="${this.cellXfs.length}">`);
+		for (const xf of this.cellXfs) {
+			const xAttrs = {
+				numFmtId: xf.numFmtId,
+				fontId: xf.fontId,
+				fillId: xf.fillId,
+				borderId: xf.borderId
+			};
+			if (xf.alignment) xAttrs.applyAlignment = 1;
+			if (xf.fontId > 0) xAttrs.applyFont = 1;
+			if (xf.fillId > 0) xAttrs.applyFill = 1;
+			if (xf.borderId > 0) xAttrs.applyBorder = 1;
+			const alignStr = xf.alignment ? this.alignmentXmlStr(xf.alignment) : "";
+			p.push(`<xf${attrs(xAttrs)}>${alignStr}</xf>`);
+		}
+		p.push("</cellXfs>");
+		p.push("<cellStyles count=\"1\"><cellStyle name=\"Normal\" xfId=\"0\" builtinId=\"0\"/></cellStyles>");
+		p.push("</styleSheet>");
+		return p.join("");
+	}
+	fontXmlStr(f) {
+		const parts = [];
+		if (f.bold) parts.push("<b/>");
+		if (f.italic) parts.push("<i/>");
+		if (f.underline) parts.push("<u/>");
+		if (f.strike) parts.push("<strike/>");
+		if (f.size) parts.push(`<sz val="${f.size}"/>`);
+		if (f.color) parts.push(`<color rgb="FF${f.color}"/>`);
+		if (f.fontName) parts.push(`<name val="${escapeXml(f.fontName)}"/>`);
+		return parts.join("");
+	}
+	borderXmlStr(b) {
+		const parts = [];
+		for (const side of [
+			"left",
+			"right",
+			"top",
+			"bottom",
+			"diagonal"
+		]) {
+			const opts = b[side];
+			if (opts && opts.style && opts.style !== "none") {
+				const colorStr = opts.color ? `<color rgb="FF${opts.color}"/>` : "";
+				parts.push(`<${side} style="${opts.style}">${colorStr}</${side}>`);
+			} else parts.push(`<${side}/>`);
+		}
+		return parts.join("");
+	}
+	alignmentXmlStr(a) {
+		const aAttrs = {};
+		if (a.horizontal) aAttrs.horizontal = a.horizontal;
+		if (a.vertical) aAttrs.vertical = a.vertical;
+		if (a.wrapText) aAttrs.wrapText = 1;
+		if (a.textRotation !== void 0) aAttrs.textRotation = a.textRotation;
+		if (a.indent !== void 0) aAttrs.indent = a.indent;
+		return `<alignment${attrs(aAttrs)}/>`;
+	}
+	prepForXml(_context) {
+		const children = [{ _attr: { xmlns: "http://schemas.openxmlformats.org/spreadsheetml/2006/main" } }];
+		if (this.customNumFmts.size > 0) {
+			const fmtElements = [{ _attr: { count: this.customNumFmts.size } }];
+			for (const [fmt, id] of this.customNumFmts) fmtElements.push({ numFmt: { _attr: {
+				numFmtId: id,
+				formatCode: fmt
+			} } });
+			children.push({ numFmts: fmtElements });
+		}
+		children.push(this.buildFonts());
+		children.push(this.buildFills());
+		children.push(this.buildBorders());
+		children.push({ cellStyleXfs: [{ _attr: { count: 1 } }, { xf: [{ _attr: {
+			numFmtId: 0,
+			fontId: 0,
+			fillId: 0,
+			borderId: 0
+		} }] }] });
+		children.push(this.buildCellXfs());
+		children.push({ cellStyles: [{ _attr: { count: 1 } }, { cellStyle: [{ _attr: {
+			name: "Normal",
+			xfId: 0,
+			builtinId: 0
+		} }] }] });
+		return { styleSheet: children };
+	}
+	buildFonts() {
+		const elements = [{ _attr: { count: this.fonts.length } }];
+		for (const f of this.fonts) elements.push({ font: this.fontXml(f) });
+		return { fonts: elements };
+	}
+	fontXml(f) {
+		const parts = [];
+		if (f.bold) parts.push({ b: [] });
+		if (f.italic) parts.push({ i: [] });
+		if (f.underline) parts.push({ u: [] });
+		if (f.strike) parts.push({ strike: [] });
+		if (f.size) parts.push({ sz: [{ _attr: { val: f.size } }] });
+		if (f.color) parts.push({ color: [{ _attr: { rgb: `FF${f.color}` } }] });
+		if (f.fontName) parts.push({ name: [{ _attr: { val: f.fontName } }] });
+		return parts;
+	}
+	buildFills() {
+		const elements = [{ _attr: { count: this.fills.length } }];
+		for (const f of this.fills) elements.push({ fill: [{ patternFill: [{ _attr: { patternType: f.patternType ?? "solid" } }, ...f.color ? [{ fgColor: [{ _attr: { rgb: `FF${f.color}` } }] }] : []] }] });
+		return { fills: elements };
+	}
+	buildBorders() {
+		const elements = [{ _attr: { count: this.borders.length } }];
+		for (const b of this.borders) elements.push({ border: this.borderXml(b) });
+		return { borders: elements };
+	}
+	borderXml(b) {
+		const parts = [];
+		for (const side of [
+			"left",
+			"right",
+			"top",
+			"bottom",
+			"diagonal"
+		]) {
+			const opts = b[side];
+			if (opts && opts.style && opts.style !== "none") {
+				const children = [{ _attr: { style: opts.style } }];
+				if (opts.color) children.push({ color: [{ _attr: { rgb: `FF${opts.color}` } }] });
+				parts.push({ [side]: children });
+			} else parts.push({ [side]: [] });
+		}
+		return parts;
+	}
+	buildCellXfs() {
+		const elements = [{ _attr: { count: this.cellXfs.length } }];
+		for (const xf of this.cellXfs) {
+			const attrs = {
+				numFmtId: xf.numFmtId,
+				fontId: xf.fontId,
+				fillId: xf.fillId,
+				borderId: xf.borderId
+			};
+			if (xf.alignment) attrs.applyAlignment = 1;
+			if (xf.fontId > 0) attrs.applyFont = 1;
+			if (xf.fillId > 0) attrs.applyFill = 1;
+			if (xf.borderId > 0) attrs.applyBorder = 1;
+			const children = [{ _attr: attrs }];
+			if (xf.alignment) children.push(this.alignmentXml(xf.alignment));
+			elements.push({ xf: children });
+		}
+		return { cellXfs: elements };
+	}
+	alignmentXml(a) {
+		const attrs = {};
+		if (a.horizontal) attrs.horizontal = a.horizontal;
+		if (a.vertical) attrs.vertical = a.vertical;
+		if (a.wrapText) attrs.wrapText = 1;
+		if (a.textRotation !== void 0) attrs.textRotation = a.textRotation;
+		if (a.indent !== void 0) attrs.indent = a.indent;
+		return { alignment: [{ _attr: attrs }] };
+	}
+};
+//#endregion
+//#region src/file/theme.ts
+/**
+* Default theme for XLSX files — matches Microsoft Office's output structure.
+* Produces xl/theme/theme1.xml that Excel accepts without repair warnings.
+*
+* The theme XML is completely static — identical for every XLSX file.
+* Pre-serialized as a string constant to avoid building the IXmlableObject
+* tree and re-serializing on every compile.
+*
+* @module
+*/
+const THEME_XML = "<a:theme xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\" name=\"Office Theme\"><a:themeElements><a:clrScheme name=\"Office\"><a:dk1><a:sysClr val=\"windowText\" lastClr=\"000000\"/></a:dk1><a:lt1><a:sysClr val=\"window\" lastClr=\"FFFFFF\"/></a:lt1><a:dk2><a:srgbClr val=\"44546A\"/></a:dk2><a:lt2><a:srgbClr val=\"E7E6E6\"/></a:lt2><a:accent1><a:srgbClr val=\"5B9BD5\"/></a:accent1><a:accent2><a:srgbClr val=\"ED7D31\"/></a:accent2><a:accent3><a:srgbClr val=\"A5A5A5\"/></a:accent3><a:accent4><a:srgbClr val=\"FFC000\"/></a:accent4><a:accent5><a:srgbClr val=\"4472C4\"/></a:accent5><a:accent6><a:srgbClr val=\"70AD47\"/></a:accent6><a:hlink><a:srgbClr val=\"0563C1\"/></a:hlink><a:folHlink><a:srgbClr val=\"954F72\"/></a:folHlink></a:clrScheme><a:fontScheme name=\"Office\"><a:majorFont><a:latin typeface=\"Calibri Light\" panose=\"020F0302020204030204\"/><a:ea typeface=\"\"/><a:cs typeface=\"\"/></a:majorFont><a:minorFont><a:latin typeface=\"Calibri\" panose=\"020F0502020204030204\"/><a:ea typeface=\"\"/><a:cs typeface=\"\"/></a:minorFont></a:fontScheme><a:fmtScheme name=\"Office\"><a:fillStyleLst><a:solidFill><a:schemeClr val=\"phClr\"/></a:solidFill><a:gradFill rotWithShape=\"1\"><a:gsLst><a:gs pos=\"0\"><a:schemeClr val=\"phClr\"><a:lumMod val=\"110000\"/><a:satMod val=\"105000\"/><a:tint val=\"67000\"/></a:schemeClr></a:gs><a:gs pos=\"50000\"><a:schemeClr val=\"phClr\"><a:lumMod val=\"105000\"/><a:satMod val=\"103000\"/><a:tint val=\"73000\"/></a:schemeClr></a:gs><a:gs pos=\"100000\"><a:schemeClr val=\"phClr\"><a:lumMod val=\"105000\"/><a:satMod val=\"109000\"/><a:tint val=\"81000\"/></a:schemeClr></a:gs></a:gsLst><a:lin ang=\"5400000\" scaled=\"0\"/></a:gradFill><a:gradFill rotWithShape=\"1\"><a:gsLst><a:gs pos=\"0\"><a:schemeClr val=\"phClr\"><a:lumMod val=\"102000\"/><a:satMod val=\"103000\"/><a:tint val=\"94000\"/></a:schemeClr></a:gs><a:gs pos=\"50000\"><a:schemeClr val=\"phClr\"><a:lumMod val=\"100000\"/><a:satMod val=\"110000\"/><a:shade val=\"100000\"/></a:schemeClr></a:gs><a:gs pos=\"100000\"><a:schemeClr val=\"phClr\"><a:lumMod val=\"99000\"/><a:satMod val=\"120000\"/><a:shade val=\"78000\"/></a:schemeClr></a:gs></a:gsLst><a:lin ang=\"5400000\" scaled=\"0\"/></a:gradFill></a:fillStyleLst><a:lnStyleLst><a:ln w=\"6350\" cap=\"flat\" cmpd=\"sng\" algn=\"ctr\"><a:solidFill><a:schemeClr val=\"phClr\"/></a:solidFill><a:prstDash val=\"solid\"/><a:miter lim=\"800000\"/></a:ln><a:ln w=\"12700\" cap=\"flat\" cmpd=\"sng\" algn=\"ctr\"><a:solidFill><a:schemeClr val=\"phClr\"/></a:solidFill><a:prstDash val=\"solid\"/><a:miter lim=\"800000\"/></a:ln><a:ln w=\"19050\" cap=\"flat\" cmpd=\"sng\" algn=\"ctr\"><a:solidFill><a:schemeClr val=\"phClr\"/></a:solidFill><a:prstDash val=\"solid\"/><a:miter lim=\"800000\"/></a:ln></a:lnStyleLst><a:effectStyleLst><a:effectStyle><a:effectLst/></a:effectStyle><a:effectStyle><a:effectLst/></a:effectStyle><a:effectStyle><a:effectLst><a:outerShdw blurRad=\"57150\" dist=\"19050\" dir=\"5400000\" algn=\"ctr\" rotWithShape=\"0\"><a:srgbClr val=\"000000\"><a:alpha val=\"63000\"/></a:srgbClr></a:outerShdw></a:effectLst></a:effectStyle></a:effectStyleLst><a:bgFillStyleLst><a:solidFill><a:schemeClr val=\"phClr\"/></a:solidFill><a:solidFill><a:schemeClr val=\"phClr\"><a:tint val=\"95000\"/><a:satMod val=\"170000\"/></a:schemeClr></a:solidFill><a:gradFill rotWithShape=\"1\"><a:gsLst><a:gs pos=\"0\"><a:schemeClr val=\"phClr\"><a:lumMod val=\"102000\"/><a:satMod val=\"150000\"/><a:tint val=\"93000\"/><a:shade val=\"98000\"/></a:schemeClr></a:gs><a:gs pos=\"50000\"><a:schemeClr val=\"phClr\"><a:lumMod val=\"103000\"/><a:satMod val=\"130000\"/><a:tint val=\"98000\"/><a:shade val=\"90000\"/></a:schemeClr></a:gs><a:gs pos=\"100000\"><a:schemeClr val=\"phClr\"><a:satMod val=\"120000\"/><a:shade val=\"63000\"/></a:schemeClr></a:gs></a:gsLst><a:lin ang=\"5400000\" scaled=\"0\"/></a:gradFill></a:bgFillStyleLst></a:fmtScheme></a:themeElements><a:objectDefaults/><a:extraClrSchemeLst/></a:theme>";
+var DefaultTheme = class extends BaseXmlComponent {
+	constructor() {
+		super("a:theme");
+	}
+	/** Return pre-cached static theme XML — zero allocation. */
+	toXml(_context) {
+		return THEME_XML;
+	}
+	prepForXml(_context) {
+		return { "a:theme": [{ _attr: {
+			"xmlns:a": "http://schemas.openxmlformats.org/drawingml/2006/main",
+			name: "Office Theme"
+		} }] };
+	}
+};
+//#endregion
+//#region src/file/workbook.ts
+/**
+* Workbook component — generates xl/workbook.xml.
+*
+* @module
+*/
+var WorkbookXml = class extends BaseXmlComponent {
+	sheets;
+	constructor(sheets) {
+		super("workbook");
+		this.sheets = sheets;
+	}
+	prepForXml(_context) {
+		const sheetElements = [];
+		for (const s of this.sheets) {
+			const attrs = {
+				name: s.name,
+				sheetId: String(s.sheetId),
+				"r:id": s.rId
+			};
+			if (s.state && s.state !== "visible") attrs.state = s.state;
+			sheetElements.push({ sheet: { _attr: attrs } });
+		}
+		return { workbook: [{ _attr: {
+			xmlns: "http://schemas.openxmlformats.org/spreadsheetml/2006/main",
+			"xmlns:r": "http://schemas.openxmlformats.org/officeDocument/2006/relationships"
+		} }, { sheets: sheetElements }] };
+	}
+};
+//#endregion
+//#region src/file/worksheet.ts
+/**
+* Worksheet component — generates xl/worksheets/sheet{n}.xml.
+*
+* @module
+*/
+var Worksheet = class extends IgnoreIfEmptyXmlComponent {
+	rows;
+	columns;
+	mergeCells;
+	freezePanes;
+	autoFilter;
+	images;
+	chartOptions;
+	dataValidations;
+	conditionalFormats;
+	constructor(options) {
+		super("worksheet");
+		this.rows = options.children ?? [];
+		this.columns = options.columns ?? [];
+		this.mergeCells = options.mergeCells ?? [];
+		this.freezePanes = options.freezePanes;
+		this.autoFilter = options.autoFilter;
+		this.images = options.images ?? [];
+		this.chartOptions = options.charts ?? [];
+		this.dataValidations = options.dataValidations ?? [];
+		this.conditionalFormats = options.conditionalFormats ?? [];
+	}
+	get imageOptions() {
+		return this.images;
+	}
+	get charts() {
+		return this.chartOptions;
+	}
+	prepForXml(context) {
+		const fileData = context.fileData;
+		const sharedStrings = fileData?.sharedStrings;
+		const styles = fileData?.styles;
+		const children = [{ _attr: {
+			xmlns: "http://schemas.openxmlformats.org/spreadsheetml/2006/main",
+			"xmlns:r": "http://schemas.openxmlformats.org/officeDocument/2006/relationships"
+		} }];
+		if (this.freezePanes) {
+			const fp = this.freezePanes;
+			const ySplit = fp.row ? fp.row : 0;
+			const xSplit = fp.col ? fp.col : 0;
+			const topRow = fp.row ? fp.row + 1 : 1;
+			const leftCol = fp.col ? fp.col + 1 : 1;
+			const attr = {
+				ySplit,
+				xSplit,
+				topLeftCell: this.defaultCellRef(topRow, leftCol),
+				activePane: ySplit > 0 && xSplit > 0 ? "bottomRight" : ySplit > 0 ? "bottomLeft" : "topRight",
+				state: "frozen"
+			};
+			children.push({ sheetViews: [{ sheetView: [{ _attr: {
+				tabSelected: 1,
+				workbookViewId: 0
+			} }, { pane: { _attr: attr } }] }] });
+		}
+		if (this.columns.length > 0) {
+			const colElements = [];
+			for (const col of this.columns) {
+				const colAttrs = {
+					min: col.min,
+					max: col.max
+				};
+				if (col.width !== void 0) {
+					colAttrs.width = col.width;
+					colAttrs.customWidth = 1;
+				}
+				if (col.hidden) colAttrs.hidden = 1;
+				colElements.push({ col: { _attr: colAttrs } });
+			}
+			children.push({ cols: colElements });
+		}
+		const sheetDataChildren = [];
+		for (let i = 0; i < this.rows.length; i++) {
+			const rowOpts = this.rows[i];
+			const rowNumber = rowOpts.rowNumber ?? i + 1;
+			const rowAttrs = { r: rowNumber };
+			if (rowOpts.height !== void 0) {
+				rowAttrs.ht = rowOpts.height;
+				rowAttrs.customHeight = 1;
+			}
+			if (rowOpts.hidden) rowAttrs.hidden = 1;
+			const cellElements = [];
+			if (rowOpts.cells) for (let j = 0; j < rowOpts.cells.length; j++) {
+				const cell = rowOpts.cells[j];
+				const ref = cell.reference ?? this.defaultCellRef(rowNumber, j + 1);
+				const cellObj = this.buildCell(ref, cell, sharedStrings, styles);
+				if (cellObj) cellElements.push(cellObj);
+			}
+			sheetDataChildren.push({ row: [{ _attr: rowAttrs }, ...cellElements] });
+		}
+		children.push({ sheetData: sheetDataChildren });
+		if (this.autoFilter) children.push({ autoFilter: { _attr: { ref: this.autoFilter } } });
+		if (this.mergeCells.length > 0) {
+			const mergeElements = [{ _attr: { count: this.mergeCells.length } }];
+			for (const mc of this.mergeCells) {
+				const fromRef = this.defaultCellRef(mc.from.row, mc.from.col);
+				const toRef = this.defaultCellRef(mc.to.row, mc.to.col);
+				mergeElements.push({ mergeCell: { _attr: { ref: `${fromRef}:${toRef}` } } });
+			}
+			children.push({ mergeCells: mergeElements });
+		}
+		if (this.conditionalFormats.length > 0) for (const cf of this.conditionalFormats) {
+			const rules = [];
+			for (let ri = 0; ri < cf.rules.length; ri++) {
+				const rule = cf.rules[ri];
+				const ruleAttrs = {
+					type: rule.type,
+					priority: rule.priority ?? ri + 1
+				};
+				if (rule.operator) ruleAttrs.operator = rule.operator;
+				if (rule.dxfId !== void 0) ruleAttrs.dxfId = rule.dxfId;
+				const ruleChildren = [{ _attr: ruleAttrs }];
+				if (rule.formulas) for (const f of rule.formulas) ruleChildren.push({ formula: [f] });
+				rules.push({ cfRule: ruleChildren });
+			}
+			children.push({ conditionalFormatting: [{ _attr: { sqref: cf.sqref } }, ...rules] });
+		}
+		if (this.dataValidations.length > 0) {
+			const dvElements = [{ _attr: { count: this.dataValidations.length } }];
+			for (const dv of this.dataValidations) {
+				const dvAttrs = { sqref: dv.sqref };
+				if (dv.type && dv.type !== "none") dvAttrs.type = dv.type;
+				if (dv.operator) dvAttrs.operator = dv.operator;
+				if (dv.allowBlank) dvAttrs.allowBlank = 1;
+				if (dv.showErrorMessage) dvAttrs.showErrorMessage = 1;
+				if (dv.showInputMessage) dvAttrs.showInputMessage = 1;
+				if (dv.errorTitle) dvAttrs.errorTitle = dv.errorTitle;
+				if (dv.error) dvAttrs.error = dv.error;
+				if (dv.promptTitle) dvAttrs.promptTitle = dv.promptTitle;
+				if (dv.prompt) dvAttrs.prompt = dv.prompt;
+				const dvChildren = [{ _attr: dvAttrs }];
+				if (dv.formula1 !== void 0) dvChildren.push({ formula1: [dv.formula1] });
+				if (dv.formula2 !== void 0) dvChildren.push({ formula2: [dv.formula2] });
+				dvElements.push({ dataValidation: dvChildren });
+			}
+			children.push({ dataValidations: dvElements });
+		}
+		return { worksheet: children };
+	}
+	/**
+	* Zero-allocation fast path: directly concatenate XML string.
+	* Bypasses the IXmlableObject intermediate tree entirely.
+	*/
+	toXml(context) {
+		const fileData = context.fileData;
+		const sharedStrings = fileData?.sharedStrings;
+		const styles = fileData?.styles;
+		const p = ["<worksheet xmlns=\"http://schemas.openxmlformats.org/spreadsheetml/2006/main\" xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\">"];
+		if (this.freezePanes) {
+			const fp = this.freezePanes;
+			const ySplit = fp.row ? fp.row : 0;
+			const xSplit = fp.col ? fp.col : 0;
+			const topRow = fp.row ? fp.row + 1 : 1;
+			const leftCol = fp.col ? fp.col + 1 : 1;
+			const topLeftCell = this.defaultCellRef(topRow, leftCol);
+			const activePane = ySplit > 0 && xSplit > 0 ? "bottomRight" : ySplit > 0 ? "bottomLeft" : "topRight";
+			p.push("<sheetViews><sheetView tabSelected=\"1\" workbookViewId=\"0\">", `<pane ySplit="${ySplit}" xSplit="${xSplit}" topLeftCell="${topLeftCell}" activePane="${activePane}" state="frozen"/>`, "</sheetView></sheetViews>");
+		}
+		if (this.columns.length > 0) {
+			p.push("<cols>");
+			for (const col of this.columns) {
+				const colAttrs = {
+					min: col.min,
+					max: col.max
+				};
+				if (col.width !== void 0) {
+					colAttrs.width = col.width;
+					colAttrs.customWidth = 1;
+				}
+				if (col.hidden) colAttrs.hidden = 1;
+				p.push(selfCloseElement("col", attrs(colAttrs)));
+			}
+			p.push("</cols>");
+		}
+		p.push("<sheetData>");
+		for (let i = 0; i < this.rows.length; i++) {
+			const rowOpts = this.rows[i];
+			const rowNumber = rowOpts.rowNumber ?? i + 1;
+			const rowAttrs = { r: rowNumber };
+			if (rowOpts.height !== void 0) {
+				rowAttrs.ht = rowOpts.height;
+				rowAttrs.customHeight = 1;
+			}
+			if (rowOpts.hidden) rowAttrs.hidden = 1;
+			if (rowOpts.cells) {
+				const rowParts = [];
+				for (let j = 0; j < rowOpts.cells.length; j++) {
+					const cell = rowOpts.cells[j];
+					const ref = cell.reference ?? this.defaultCellRef(rowNumber, j + 1);
+					const cellStr = this.buildCellString(ref, cell, sharedStrings, styles);
+					if (cellStr) rowParts.push(cellStr);
+				}
+				p.push(`<row${attrs(rowAttrs)}>`, ...rowParts, "</row>");
+			} else p.push(`<row${attrs(rowAttrs)}></row>`);
+		}
+		p.push("</sheetData>");
+		if (this.autoFilter) p.push(selfCloseElement("autoFilter", attrs({ ref: this.autoFilter })));
+		if (this.mergeCells.length > 0) {
+			p.push(`<mergeCells count="${this.mergeCells.length}">`);
+			for (const mc of this.mergeCells) {
+				const fromRef = this.defaultCellRef(mc.from.row, mc.from.col);
+				const toRef = this.defaultCellRef(mc.to.row, mc.to.col);
+				p.push(selfCloseElement("mergeCell", attrs({ ref: `${fromRef}:${toRef}` })));
+			}
+			p.push("</mergeCells>");
+		}
+		if (this.conditionalFormats.length > 0) for (const cf of this.conditionalFormats) {
+			p.push(`<conditionalFormatting sqref="${cf.sqref}">`);
+			for (let ri = 0; ri < cf.rules.length; ri++) {
+				const rule = cf.rules[ri];
+				const ruleAttrs = {
+					type: rule.type,
+					priority: rule.priority ?? ri + 1
+				};
+				if (rule.operator) ruleAttrs.operator = rule.operator;
+				if (rule.dxfId !== void 0) ruleAttrs.dxfId = rule.dxfId;
+				if (rule.formulas && rule.formulas.length > 0) {
+					const formulaParts = rule.formulas.map((f) => `<formula>${escapeXml(f)}</formula>`);
+					p.push(`<cfRule${attrs(ruleAttrs)}>`, ...formulaParts, "</cfRule>");
+				} else p.push(selfCloseElement("cfRule", attrs(ruleAttrs)));
+			}
+			p.push("</conditionalFormatting>");
+		}
+		if (this.dataValidations.length > 0) {
+			p.push(`<dataValidations count="${this.dataValidations.length}">`);
+			for (const dv of this.dataValidations) {
+				const dvAttrs = { sqref: dv.sqref };
+				if (dv.type && dv.type !== "none") dvAttrs.type = dv.type;
+				if (dv.operator) dvAttrs.operator = dv.operator;
+				if (dv.allowBlank) dvAttrs.allowBlank = 1;
+				if (dv.showErrorMessage) dvAttrs.showErrorMessage = 1;
+				if (dv.showInputMessage) dvAttrs.showInputMessage = 1;
+				if (dv.errorTitle) dvAttrs.errorTitle = dv.errorTitle;
+				if (dv.error) dvAttrs.error = dv.error;
+				if (dv.promptTitle) dvAttrs.promptTitle = dv.promptTitle;
+				if (dv.prompt) dvAttrs.prompt = dv.prompt;
+				const inner = [];
+				if (dv.formula1 !== void 0) inner.push(`<formula1>${escapeXml(dv.formula1)}</formula1>`);
+				if (dv.formula2 !== void 0) inner.push(`<formula2>${escapeXml(dv.formula2)}</formula2>`);
+				if (inner.length > 0) p.push(`<dataValidation${attrs(dvAttrs)}>`, ...inner, "</dataValidation>");
+				else p.push(selfCloseElement("dataValidation", attrs(dvAttrs)));
+			}
+			p.push("</dataValidations>");
+		}
+		p.push("</worksheet>");
+		return p.join("");
+	}
+	/**
+	* Direct string serialization of a single cell — zero intermediate objects.
+	*/
+	buildCellString(ref, cell, sharedStrings, styles) {
+		const cellAttrs = { r: ref };
+		if (cell.style !== void 0 && styles) cellAttrs.s = styles.register(cell.style);
+		else if (cell.styleIndex !== void 0) cellAttrs.s = cell.styleIndex;
+		const value = cell.value;
+		if (value === null || value === void 0) {
+			if (cell.styleIndex !== void 0) return selfCloseElement("c", attrs(cellAttrs));
+			return "";
+		}
+		if (typeof value === "string") {
+			if (sharedStrings) {
+				cellAttrs.t = "s";
+				const idx = sharedStrings.register(value);
+				return `<c${attrs(cellAttrs)}><v>${idx}</v></c>`;
+			}
+			cellAttrs.t = "inlineStr";
+			return `<c${attrs(cellAttrs)}><is><t>${escapeXml(value)}</t></is></c>`;
+		}
+		if (typeof value === "number") return `<c${attrs(cellAttrs)}><v>${value}</v></c>`;
+		if (typeof value === "boolean") {
+			cellAttrs.t = "b";
+			return `<c${attrs(cellAttrs)}><v>${value ? 1 : 0}</v></c>`;
+		}
+		if (value instanceof Date) {
+			const serial = this.dateToSerialNumber(value);
+			return `<c${attrs(cellAttrs)}><v>${serial}</v></c>`;
+		}
+		return "";
+	}
+	defaultCellRef(row, col) {
+		return this.columnToLetter(col) + row;
+	}
+	columnToLetter(col) {
+		let result = "";
+		let n = col;
+		while (n > 0) {
+			const remainder = (n - 1) % 26;
+			result = String.fromCharCode(65 + remainder) + result;
+			n = Math.floor((n - 1) / 26);
+		}
+		return result;
+	}
+	buildCell(ref, cell, sharedStrings, styles) {
+		const attrs = { r: ref };
+		if (cell.style !== void 0 && styles) attrs.s = styles.register(cell.style);
+		else if (cell.styleIndex !== void 0) attrs.s = cell.styleIndex;
+		const value = cell.value;
+		if (value === null || value === void 0) {
+			if (cell.styleIndex !== void 0) return { c: [{ _attr: attrs }] };
+			return;
+		}
+		if (typeof value === "string") {
+			if (sharedStrings) {
+				attrs.t = "s";
+				const idx = sharedStrings.register(value);
+				return { c: [{ _attr: attrs }, { v: [idx] }] };
+			}
+			attrs.t = "inlineStr";
+			return { c: [{ _attr: attrs }, { is: [{ t: [value] }] }] };
+		}
+		if (typeof value === "number") return { c: [{ _attr: attrs }, { v: [value] }] };
+		if (typeof value === "boolean") {
+			attrs.t = "b";
+			return { c: [{ _attr: attrs }, { v: [value ? 1 : 0] }] };
+		}
+		if (value instanceof Date) {
+			const serial = this.dateToSerialNumber(value);
+			return { c: [{ _attr: attrs }, { v: [serial] }] };
+		}
+	}
+	dateToSerialNumber(date) {
+		const epoch = new Date(1899, 11, 30);
+		return (date.getTime() - epoch.getTime()) / 864e5;
+	}
+};
+//#endregion
+//#region src/file/file.ts
+/**
+* File class (exported as Workbook) — the top-level container for XLSX documents.
+*
+* @module
+*/
+var File = class {
+	worksheetOptions;
+	corePropsOptions;
+	_coreProperties;
+	_appProperties;
+	_contentTypes;
+	_styles;
+	_theme;
+	_workbookXml;
+	_worksheets;
+	_sharedStrings;
+	_media;
+	_fileRels;
+	_workbookRels;
+	_charts;
+	constructor(options) {
+		this.worksheetOptions = options.worksheets ?? [];
+		this.corePropsOptions = options;
+	}
+	get coreProperties() {
+		return this._coreProperties ??= new CoreProperties(this.corePropsOptions);
+	}
+	get appProperties() {
+		return this._appProperties ??= new AppProperties();
+	}
+	get contentTypes() {
+		if (!this._contentTypes) {
+			this._contentTypes = new ContentTypes();
+			for (let i = 0; i < this.worksheetOptions.length; i++) this._contentTypes.addWorksheet(i + 1);
+			this._contentTypes.addStyles();
+			this._contentTypes.addSharedStrings();
+			this._contentTypes.addTheme();
+		}
+		return this._contentTypes;
+	}
+	get styles() {
+		return this._styles ??= new Styles();
+	}
+	get theme() {
+		return this._theme ??= new DefaultTheme();
+	}
+	get workbookXml() {
+		if (!this._workbookXml) {
+			const sheets = this.worksheetOptions.map((ws, i) => ({
+				name: ws.name ?? `Sheet${i + 1}`,
+				sheetId: i + 1,
+				rId: `rId${i + 1}`
+			}));
+			this._workbookXml = new WorkbookXml(sheets);
+		}
+		return this._workbookXml;
+	}
+	get sharedStrings() {
+		return this._sharedStrings ??= new SharedStrings();
+	}
+	get media() {
+		return this._media ??= new Media();
+	}
+	get charts() {
+		return this._charts ??= new ChartCollection();
+	}
+	get worksheets() {
+		if (!this._worksheets) this._worksheets = this.worksheetOptions.map((ws) => new Worksheet(ws));
+		return this._worksheets;
+	}
+	get fileRelationships() {
+		if (!this._fileRels) {
+			this._fileRels = new Relationships();
+			this._fileRels.addRelationship(1, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument", "xl/workbook.xml");
+			this._fileRels.addRelationship(2, "http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties", "docProps/core.xml");
+			this._fileRels.addRelationship(3, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/extended-properties", "docProps/app.xml");
+		}
+		return this._fileRels;
+	}
+	get workbookRelationships() {
+		if (!this._workbookRels) {
+			this._workbookRels = new Relationships();
+			let rid = 1;
+			for (let i = 0; i < this.worksheetOptions.length; i++) this._workbookRels.addRelationship(rid++, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet", `worksheets/sheet${i + 1}.xml`);
+			this._workbookRels.addRelationship(rid++, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles", "styles.xml");
+			this._workbookRels.addRelationship(rid++, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme", "theme/theme1.xml");
+			this._workbookRels.addRelationship(rid++, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/sharedStrings", "sharedStrings.xml");
+		}
+		return this._workbookRels;
+	}
+};
+//#endregion
+//#region src/file/drawing/drawing.ts
+/**
+* XLSX Drawing component — generates xl/drawings/drawing{n}.xml.
+*
+* Uses the spreadsheetDrawing namespace (default, no prefix) for anchoring
+* images and charts to worksheet cells.
+*
+* @module
+*/
+const XDR_NS = "http://schemas.openxmlformats.org/drawingml/2006/spreadsheetDrawing";
+const A_NS = "http://schemas.openxmlformats.org/drawingml/2006/main";
+const R_NS = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+const C_URI = "http://schemas.openxmlformats.org/drawingml/2006/chart";
+var Drawing = class extends BaseXmlComponent {
+	images;
+	charts;
+	constructor(images, charts = []) {
+		super("wsDr");
+		this.images = images;
+		this.charts = charts;
+	}
+	prepForXml(_context) {
+		const children = [{ _attr: {
+			xmlns: XDR_NS,
+			"xmlns:a": A_NS,
+			"xmlns:r": R_NS
+		} }];
+		let nextId = 1;
+		for (const img of this.images) children.push(this.buildImageAnchor(img, nextId++));
+		for (const chart of this.charts) children.push(this.buildChartAnchor(chart, nextId++));
+		return { wsDr: children };
+	}
+	buildFromAnchor(col, row, colOffset, rowOffset) {
+		return { from: [
+			{ col: [col - 1] },
+			{ colOff: [colOffset ?? 0] },
+			{ row: [row - 1] },
+			{ rowOff: [rowOffset ?? 0] }
+		] };
+	}
+	buildToAnchor(col, row) {
+		return { to: [
+			{ col: [col] },
+			{ colOff: [0] },
+			{ row: [row] },
+			{ rowOff: [0] }
+		] };
+	}
+	buildImageAnchor(img, id) {
+		return { twoCellAnchor: [
+			{ _attr: { editAs: "oneCell" } },
+			this.buildFromAnchor(img.col, img.row, img.colOffset, img.rowOffset),
+			this.buildToAnchor(img.col, img.row),
+			{ pic: [
+				{ nvPicPr: [{ cNvPr: { _attr: {
+					id,
+					name: `Picture ${id}`
+				} } }, { cNvPicPr: [{ _attr: { preferRelativeResize: 1 } }] }] },
+				{ blipFill: [{ "a:blip": { _attr: { "r:embed": img.rId } } }, { "a:stretch": [{ "a:fillRect": [] }] }] },
+				{ spPr: [{ "a:xfrm": [{ "a:off": { _attr: {
+					x: 0,
+					y: 0
+				} } }, { "a:ext": { _attr: {
+					cx: 4e5,
+					cy: 3e5
+				} } }] }, { "a:prstGeom": [{ _attr: { prst: "rect" } }, { "a:avLst": [] }] }] }
+			] },
+			{ clientData: [] }
+		] };
+	}
+	buildChartAnchor(chart, id) {
+		return { twoCellAnchor: [
+			{ _attr: { editAs: "oneCell" } },
+			this.buildFromAnchor(chart.col, chart.row, chart.colOffset, chart.rowOffset),
+			this.buildToAnchor(chart.col + 8, chart.row + 15),
+			{ graphicFrame: [
+				{ nvGraphicFramePr: [{ cNvPr: { _attr: {
+					id,
+					name: `Chart ${id}`
+				} } }, { cNvGraphicFramePr: [{ "a:graphicFrameLocks": { _attr: { noGrp: 1 } } }] }] },
+				{ xfrm: [{ "a:off": { _attr: {
+					x: 0,
+					y: 0
+				} } }, { "a:ext": { _attr: {
+					cx: 0,
+					cy: 0
+				} } }] },
+				{ "a:graphic": [{ "a:graphicData": [{ _attr: { uri: C_URI } }, { "c:chart": { _attr: {
+					"xmlns:c": "http://schemas.openxmlformats.org/drawingml/2006/chart",
+					"xmlns:r": R_NS,
+					"r:id": chart.rId
+				} } }] }] }
+			] },
+			{ clientData: [] }
+		] };
+	}
+};
+//#endregion
+//#region src/export/packer/next-compiler.ts
+/**
+* XLSX Compiler — compiles a File object into a Zippable structure.
+*
+* @module
+*/
+var Compiler = class {
+	formatter = new Formatter();
+	compile(file, overrides = []) {
+		const context = {
+			fileData: file,
+			stack: []
+		};
+		const f = this.formatter;
+		const mapping = {};
+		const fmt = (component, declaration) => f.formatToXml(component, context, declaration);
+		mapping["Properties"] = {
+			data: fmt(file.coreProperties, true),
+			path: "docProps/core.xml"
+		};
+		mapping["AppProperties"] = {
+			data: fmt(file.appProperties, true),
+			path: "docProps/app.xml"
+		};
+		mapping["FileRelationships"] = {
+			data: fmt(file.fileRelationships),
+			path: "_rels/.rels"
+		};
+		mapping["Workbook"] = {
+			data: fmt(file.workbookXml, true),
+			path: "xl/workbook.xml"
+		};
+		mapping["WorkbookRelationships"] = {
+			data: fmt(file.workbookRelationships),
+			path: "xl/_rels/workbook.xml.rels"
+		};
+		const worksheets = file.worksheets;
+		let globalMediaIdx = 0;
+		let globalChartIdx = 0;
+		for (let i = 0; i < worksheets.length; i++) {
+			const ws = worksheets[i];
+			const imgOpts = ws.imageOptions;
+			const chartOpts = ws.charts;
+			let sheetXml = fmt(ws, true);
+			if (imgOpts.length > 0 || chartOpts.length > 0) {
+				const drawingImages = [];
+				const drawingCharts = [];
+				const drawingRels = new Relationships();
+				let rid = 1;
+				for (const img of imgOpts) {
+					const mediaKey = `image_${globalMediaIdx}`;
+					const ext = img.type === "jpeg" || img.type === "jpg" ? "jpeg" : "png";
+					file.media.addImage(mediaKey, {
+						fileName: `image${globalMediaIdx + 1}.${ext}`,
+						type: ext,
+						data: img.data,
+						width: 0,
+						height: 0
+					});
+					drawingRels.addRelationship(rid, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image", `../media/image${globalMediaIdx + 1}.${ext}`);
+					drawingImages.push({
+						col: img.col,
+						row: img.row,
+						rId: `rId${rid}`
+					});
+					rid++;
+					globalMediaIdx++;
+				}
+				for (const chart of chartOpts) {
+					const chartKey = `chart_${globalChartIdx}`;
+					file.charts.addChart(chartKey, {
+						key: chartKey,
+						chartSpace: new ChartSpace(chart)
+					});
+					drawingRels.addRelationship(rid, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart", `../charts/chart${globalChartIdx + 1}.xml`);
+					drawingCharts.push({
+						col: chart.col,
+						row: chart.row,
+						rId: `rId${rid}`
+					});
+					rid++;
+					globalChartIdx++;
+				}
+				const drawing = new Drawing(drawingImages, drawingCharts);
+				const drawingIdx = i + 1;
+				mapping[`Drawing${i}`] = {
+					data: fmt(drawing, true),
+					path: `xl/drawings/drawing${drawingIdx}.xml`
+				};
+				mapping[`DrawingRels${i}`] = {
+					data: fmt(drawingRels),
+					path: `xl/drawings/_rels/drawing${drawingIdx}.xml.rels`
+				};
+				sheetXml = sheetXml.slice(0, -12) + `<drawing r:id="rId${rid}"/></worksheet>`;
+				const wsRels = new Relationships();
+				wsRels.addRelationship(rid, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing", `../drawings/drawing${drawingIdx}.xml`);
+				mapping[`WorksheetRels${i}`] = {
+					data: fmt(wsRels),
+					path: `xl/worksheets/_rels/sheet${i + 1}.xml.rels`
+				};
+				file.contentTypes.addDrawing(drawingIdx);
+			}
+			mapping[`Worksheet${i}`] = {
+				data: sheetXml,
+				path: `xl/worksheets/sheet${i + 1}.xml`
+			};
+		}
+		const sharedStrings = file.sharedStrings;
+		if (sharedStrings.count > 0) mapping["SharedStrings"] = {
+			data: fmt(sharedStrings, true),
+			path: "xl/sharedStrings.xml"
+		};
+		mapping["Styles"] = {
+			data: fmt(file.styles, true),
+			path: "xl/styles.xml"
+		};
+		mapping["Theme"] = {
+			data: fmt(file.theme, true),
+			path: "xl/theme/theme1.xml"
+		};
+		for (let i = 0; i < file.charts.array.length; i++) {
+			const chartData = file.charts.array[i];
+			mapping[`Chart${i}`] = {
+				data: fmt(chartData.chartSpace, true),
+				path: `xl/charts/chart${i + 1}.xml`
+			};
+			file.contentTypes.addChart(i + 1);
+		}
+		mapping["ContentTypes"] = {
+			data: fmt(file.contentTypes),
+			path: "[Content_Types].xml"
+		};
+		return compileMapping(mapping, overrides, file.media.array.map((img) => ({
+			data: img.data,
+			path: `xl/media/${img.fileName}`
+		})));
+	}
+};
+//#endregion
+//#region src/export/packer/packer.ts
+/**
+* Packer module — export API for XLSX files.
+*
+* @module
+*/
+const compiler = new Compiler();
+const Packer = createPacker({
+	compile: (file, overrides) => compiler.compile(file, overrides),
+	mimeType: OoxmlMimeType.XLSX
+});
+//#endregion
+//#region src/util/index.ts
+/**
+* Convert a 1-based column number to Excel column letter(s).
+* 1 → "A", 26 → "Z", 27 → "AA", 28 → "AB"
+*/
+function columnToLetter(col) {
+	let result = "";
+	let n = col;
+	while (n > 0) {
+		const remainder = (n - 1) % 26;
+		result = String.fromCharCode(65 + remainder) + result;
+		n = Math.floor((n - 1) / 26);
+	}
+	return result;
+}
+/**
+* Convert Excel column letter(s) to a 1-based column number.
+* "A" → 1, "Z" → 26, "AA" → 27
+*/
+function letterToColumn(s) {
+	let result = 0;
+	for (let i = 0; i < s.length; i++) result = result * 26 + (s.charCodeAt(i) - 64);
+	return result;
+}
+/**
+* Convert a JavaScript Date to an Excel serial number.
+* Excel epoch: January 1, 1900 = 1 (with the 1900 leap year bug).
+*/
+function dateToSerialNumber(date) {
+	const epoch = new Date(1899, 11, 30);
+	return (date.getTime() - epoch.getTime()) / 864e5;
+}
+//#endregion
+//#region src/parse.ts
+/**
+* XLSX parsing — parse .xlsx files into structured data.
+*
+* @module
+*/
+function sortByNumber(paths) {
+	return paths.sort((a, b) => {
+		return parseInt(a.match(/(\d+)/)?.[1] ?? "0", 10) - parseInt(b.match(/(\d+)/)?.[1] ?? "0", 10);
+	});
+}
+/**
+* Parse raw .xlsx data into a low-level XlsxDocument.
+*/
+function parseXlsx(data) {
+	const doc = parseArchive(toUint8Array(data));
+	const workbook = doc.get("xl/workbook.xml");
+	const styles = doc.get("xl/styles.xml");
+	const sharedStrings = doc.get("xl/sharedStrings.xml");
+	const worksheets = [];
+	const charts = [];
+	const drawings = [];
+	const media = [];
+	const wbRels = doc.get("xl/_rels/workbook.xml.rels");
+	if (wbRels) for (const child of wbRels.elements ?? []) {
+		if (child.name !== "Relationship") continue;
+		const type = attr(child, "Type") ?? "";
+		const target = attr(child, "Target") ?? "";
+		if (!target) continue;
+		if (type.includes("/worksheet")) worksheets.push(target.startsWith("/") ? target.slice(1) : `xl/${target}`);
+	}
+	sortByNumber(worksheets);
+	drawings.push(...doc.keys("xl/drawings/").filter((k) => k.endsWith(".xml")));
+	charts.push(...doc.keys("xl/charts/").filter((k) => k.endsWith(".xml")));
+	media.push(...doc.keys("xl/media/"));
+	sortByNumber(drawings);
+	sortByNumber(charts);
+	let coreProps;
+	let appProps;
+	const rootRels = doc.get("_rels/.rels");
+	if (rootRels) for (const child of rootRels.elements ?? []) {
+		if (child.name !== "Relationship") continue;
+		const type = attr(child, "Type") ?? "";
+		const target = attr(child, "Target") ?? "";
+		if (type.includes("/core-properties")) coreProps = target;
+		else if (type.includes("/extended-properties")) appProps = target;
+	}
+	return {
+		doc,
+		workbook,
+		worksheets,
+		styles,
+		sharedStrings,
+		partRefs: {
+			worksheets,
+			charts,
+			media,
+			drawings
+		},
+		coreProps,
+		appProps
+	};
+}
+function parseSharedStrings(el) {
+	if (!el) return [];
+	const strings = [];
+	for (const si of el.elements ?? []) {
+		if (si.name !== "si") continue;
+		const t = findChild(si, "t");
+		if (t) strings.push(textOf(t) ?? "");
+		else {
+			const parts = [];
+			for (const r of si.elements ?? []) {
+				if (r.name !== "r") continue;
+				const rt = findChild(r, "t");
+				if (rt) parts.push(textOf(rt) ?? "");
+			}
+			strings.push(parts.join(""));
+		}
+	}
+	return strings;
+}
+function colFromRef(ref) {
+	const match = ref.match(/^([A-Z]+)/);
+	return match ? letterToColumn(match[1]) : 1;
+}
+function rowFromRef(ref) {
+	const match = ref.match(/(\d+)$/);
+	return match ? parseInt(match[1], 10) : 1;
+}
+function parseWorksheetElement(wsEl, strings) {
+	const opts = {};
+	const colsEl = findChild(wsEl, "cols") ?? findChildByLocalName(wsEl, "cols");
+	if (colsEl) {
+		const columns = [];
+		for (const col of colsEl.elements ?? []) {
+			if (localName$1(col) !== "col") continue;
+			const min = attrNum(col, "min");
+			const max = attrNum(col, "max");
+			if (min === void 0 || max === void 0) continue;
+			const colOpts = {
+				min,
+				max
+			};
+			const width = attrNum(col, "width");
+			if (width !== void 0) colOpts.width = width;
+			if (attr(col, "hidden") === "1") colOpts.hidden = true;
+			columns.push(colOpts);
+		}
+		if (columns.length > 0) opts.columns = columns;
+	}
+	const sheetViews = findChildByLocalName(wsEl, "sheetViews");
+	if (sheetViews) {
+		const sheetView = findChildByLocalName(sheetViews, "sheetView");
+		if (sheetView) {
+			const pane = findChildByLocalName(sheetView, "pane");
+			if (pane) {
+				if (attr(pane, "state") === "frozen") {
+					const freezePanes = {};
+					const ySplit = attrNum(pane, "ySplit");
+					const xSplit = attrNum(pane, "xSplit");
+					if (ySplit && ySplit > 0) freezePanes.row = ySplit;
+					if (xSplit && xSplit > 0) freezePanes.col = xSplit;
+					if (Object.keys(freezePanes).length > 0) opts.freezePanes = freezePanes;
+				}
+			}
+		}
+	}
+	const sheetData = findChildByLocalName(wsEl, "sheetData");
+	const rows = [];
+	if (sheetData) for (const rowEl of sheetData.elements ?? []) {
+		if (localName$1(rowEl) !== "row") continue;
+		const rowNumber = attrNum(rowEl, "r");
+		const rowOpts = {};
+		if (rowNumber !== void 0) rowOpts.rowNumber = rowNumber;
+		const ht = attrNum(rowEl, "ht");
+		if (ht !== void 0) rowOpts.height = ht;
+		if (attr(rowEl, "hidden") === "1") rowOpts.hidden = true;
+		const cells = [];
+		for (const cellEl of rowEl.elements ?? []) {
+			if (localName$1(cellEl) !== "c") continue;
+			const ref = attr(cellEl, "r");
+			const type = attr(cellEl, "t");
+			const cellOpts = {};
+			if (ref) cellOpts.reference = ref;
+			const styleIdx = attrNum(cellEl, "s");
+			if (styleIdx !== void 0) cellOpts.styleIndex = styleIdx;
+			const vEl = findChildByLocalName(cellEl, "v");
+			const isEl = findChildByLocalName(cellEl, "is");
+			if (type === "s" && vEl) cellOpts.value = strings[parseInt(textOf(vEl) ?? "", 10)] ?? "";
+			else if (type === "b" && vEl) cellOpts.value = textOf(vEl) === "1";
+			else if (type === "inlineStr" && isEl) cellOpts.value = textOf(findChildByLocalName(isEl, "t")) ?? "";
+			else if (vEl) {
+				const raw = textOf(vEl) ?? "";
+				const num = Number(raw);
+				cellOpts.value = isNaN(num) ? raw : num;
+			}
+			cells.push(cellOpts);
+		}
+		rowOpts.cells = cells;
+		rows.push(rowOpts);
+	}
+	opts.children = rows;
+	const mergeCellsEl = findChildByLocalName(wsEl, "mergeCells");
+	if (mergeCellsEl) {
+		const mergeCells = [];
+		for (const mc of mergeCellsEl.elements ?? []) {
+			if (localName$1(mc) !== "mergeCell") continue;
+			const ref = attr(mc, "ref");
+			if (!ref) continue;
+			const parts = ref.split(":");
+			if (parts.length === 2) mergeCells.push({
+				from: {
+					row: rowFromRef(parts[0]),
+					col: colFromRef(parts[0])
+				},
+				to: {
+					row: rowFromRef(parts[1]),
+					col: colFromRef(parts[1])
+				}
+			});
+		}
+		if (mergeCells.length > 0) opts.mergeCells = mergeCells;
+	}
+	const autoFilterEl = findChildByLocalName(wsEl, "autoFilter");
+	if (autoFilterEl) {
+		const ref = attr(autoFilterEl, "ref");
+		if (ref) opts.autoFilter = ref;
+	}
+	return opts;
+}
+function localName$1(el) {
+	const name = el.name ?? "";
+	const colonIdx = name.indexOf(":");
+	return colonIdx >= 0 ? name.slice(colonIdx + 1) : name;
+}
+function findChildByLocalName(parent, name) {
+	return (parent.elements ?? []).find((el) => localName$1(el) === name);
+}
+/**
+* Parse a .xlsx file and convert it into WorkbookOptions.
+*
+* The returned options can be passed to `new Workbook(parsed)`.
+*/
+function parseWorkbook(data) {
+	const xlsx = parseXlsx(data);
+	const opts = {};
+	if (xlsx.coreProps) {
+		const corePropsEl = xlsx.doc.get(xlsx.coreProps);
+		if (corePropsEl) {
+			const cp = parseCorePropsElement(corePropsEl);
+			if (cp.title) opts.title = cp.title;
+			if (cp.subject) opts.subject = cp.subject;
+			if (cp.creator) opts.creator = cp.creator;
+			if (cp.keywords) opts.keywords = cp.keywords;
+			if (cp.description) opts.description = cp.description;
+			if (cp.lastModifiedBy) opts.lastModifiedBy = cp.lastModifiedBy;
+			if (cp.revision) opts.revision = parseInt(cp.revision, 10);
+		}
+	}
+	const strings = parseSharedStrings(xlsx.sharedStrings);
+	const sheetNames = [];
+	if (xlsx.workbook) {
+		const sheetsEl = findChildByLocalName(xlsx.workbook, "sheets");
+		if (sheetsEl) for (const s of sheetsEl.elements ?? []) {
+			if (localName$1(s) !== "sheet") continue;
+			sheetNames.push(attr(s, "name") ?? "");
+		}
+	}
+	const worksheets = [];
+	for (let i = 0; i < xlsx.worksheets.length; i++) {
+		const wsPath = xlsx.worksheets[i];
+		const wsEl = xlsx.doc.get(wsPath);
+		if (!wsEl) continue;
+		const wsOpts = parseWorksheetElement(wsEl, strings);
+		if (sheetNames[i]) wsOpts.name = sheetNames[i];
+		worksheets.push(wsOpts);
+	}
+	opts.worksheets = worksheets;
+	return opts;
+}
+//#endregion
+//#region src/patcher.ts
+/**
+* XLSX patching — replace placeholders in existing .xlsx files.
+*
+* Unlike DOCX/PPTX (paragraph-based), XLSX patching targets cell values:
+* - Replaces placeholders in the shared strings table (most common)
+* - Replaces placeholders in inline strings within worksheet cells
+*
+* @module
+*/
+/** Reusable TextEncoder (stateless, safe to share). */
+const encoder = new TextEncoder();
+const PatchType = { CELL: "cell" };
+/**
+* Patch an existing .xlsx workbook by replacing placeholder text in cells.
+*
+* Placeholders are matched in shared strings and inline strings.
+* For string replacements, the shared string value is updated in-place.
+* For non-string replacements, the cell type and value are updated.
+*/
+const patchWorkbook = async ({ outputType, data, patches, placeholderDelimiters = {
+	start: "{{",
+	end: "}}"
+} }) => {
+	const zipContent = unzipSync(toUint8Array(data));
+	const xmlMap = /* @__PURE__ */ new Map();
+	const binaryMap = /* @__PURE__ */ new Map();
+	for (const [key, value] of Object.entries(zipContent)) if (key.endsWith(".xml") || key.endsWith(".rels")) xmlMap.set(key, toJson(strFromU8(value)));
+	else binaryMap.set(key, value);
+	const { start, end } = placeholderDelimiters;
+	const patchMap = /* @__PURE__ */ new Map();
+	for (const [key, patch] of Object.entries(patches)) patchMap.set(`${start}${key}${end}`, patch);
+	const sst = xmlMap.get("xl/sharedStrings.xml");
+	if (sst) patchSharedStrings(sst, patchMap);
+	const worksheetKeys = Object.keys(zipContent).filter((k) => k.startsWith("xl/worksheets/sheet") && k.endsWith(".xml"));
+	for (const wsKey of worksheetKeys) {
+		const ws = xmlMap.get(wsKey);
+		if (ws) patchWorksheetInlineStrings(ws, patchMap);
+	}
+	const files = {};
+	for (const [key, value] of xmlMap) files[key] = encoder.encode(js2xml(value));
+	for (const [key, value] of binaryMap) files[key] = value;
+	return await zipAndConvert(files, outputType, OoxmlMimeType.XLSX);
+};
+function patchSharedStrings(sst, patchMap) {
+	const root = sst.name ? sst : sst.elements?.[0];
+	if (!root) return;
+	for (const si of root.elements ?? []) {
+		if (si.name !== "si") continue;
+		const t = findLocalChild(si, "t");
+		if (t) patchTextElement(t, patchMap);
+		else for (const r of si.elements ?? []) {
+			if (r.name !== "r") continue;
+			const rt = findLocalChild(r, "t");
+			if (rt) patchTextElement(rt, patchMap);
+		}
+	}
+}
+function patchWorksheetInlineStrings(ws, patchMap) {
+	const root = ws.name ? ws : ws.elements?.[0];
+	if (!root) return;
+	const sheetData = findLocalChild(root, "sheetData");
+	if (!sheetData) return;
+	for (const row of sheetData.elements ?? []) {
+		if (localName(row) !== "row") continue;
+		for (const cell of row.elements ?? []) {
+			if (localName(cell) !== "c") continue;
+			const isEl = findLocalChild(cell, "is");
+			if (isEl) {
+				const t = findLocalChild(isEl, "t");
+				if (t) patchTextElement(t, patchMap);
+			}
+		}
+	}
+}
+function patchTextElement(tEl, patchMap) {
+	const text = tEl.elements?.[0]?.text;
+	if (typeof text !== "string") return;
+	for (const [placeholder, patch] of patchMap) if (text.includes(placeholder)) {
+		const newValue = String(patch.value);
+		const replaced = text.replace(placeholder, newValue);
+		if (tEl.elements) tEl.elements[0] = {
+			...tEl.elements[0],
+			text: replaced
+		};
+	}
+}
+function localName(el) {
+	const name = el.name ?? "";
+	const colonIdx = name.indexOf(":");
+	return colonIdx >= 0 ? name.slice(colonIdx + 1) : name;
+}
+function findLocalChild(parent, name) {
+	return (parent.elements ?? []).find((el) => localName(el) === name);
+}
+//#endregion
+export { File, File as Workbook, Packer, PatchType, SharedStrings, Styles, columnToLetter, dateToSerialNumber, letterToColumn, parseWorkbook, parseXlsx, patchWorkbook };
+
+//# sourceMappingURL=index.js.map