@shbernal/pptxgenjs 5.1.0 → 5.2.0

package/dist/{pptxgen-3gNqxx8n.js → pptxgen--5RWzhb4.js}

@@ -1,5 +1,5 @@
 import { a as emuToInches, c as inchesToEmu, i as STANDARD_LAYOUTS } from "./units-DmzbVUNp.js";
-import { A as EMU, B as PLACEHOLDER_TYPES, C as DEF_PRES_LAYOUT_NAME, D as DEF_SLIDE_MARGIN_IN, F as LINEH_MODIFIER, H as SCHEME_COLOR_NAMES, K as SchemeColor, L as ONEPT, N as LAYOUT_IDX_SERIES_BASE, O as DEF_TEXT_GLOW, P as LETTERS, R as OutputType, S as DEF_PRES_LAYOUT, T as DEF_SHAPE_SHADOW, U as SHAPE_TYPE, V as REGEX_HEX_COLOR, W as SLDNUMFLDID, _ as DEF_CHART_BORDER, a as AXIS_ID_VALUE_SECONDARY, c as BARCHART_COLORS, f as ChartType, h as DEF_CELL_MARGIN_IN, i as AXIS_ID_VALUE_PRIMARY, j as IMG_BROKEN, k as DEF_TEXT_SHADOW, m as DEF_CELL_BORDER, n as AXIS_ID_CATEGORY_SECONDARY, o as AlignH, q as ShapeType, r as AXIS_ID_SERIES_PRIMARY, s as AlignV, t as AXIS_ID_CATEGORY_PRIMARY, u as CHART_TYPE, v as DEF_CHART_GRIDLINE, y as DEF_FONT_COLOR, z as PIECHART_COLORS } from "./core-enums-BCaI1VAf.js";
+import { A as DEF_TEXT_GLOW, B as ONEPT, D as DEF_SHAPE_SHADOW, G as SCHEME_COLOR_NAMES, H as PIECHART_COLORS, I as LAYOUT_IDX_SERIES_BASE, K as SHAPE_TYPE, L as LETTERS, M as EMU, N as IMG_BROKEN, R as LINEH_MODIFIER, T as DEF_PRES_LAYOUT_NAME, U as PLACEHOLDER_TYPES, V as OutputType, W as REGEX_HEX_COLOR, X as ShapeType, Y as SchemeColor, _ as DEF_CELL_MARGIN_IN, a as AXIS_ID_SERIES_PRIMARY, b as DEF_CHART_GRIDLINE, c as AlignH, f as CHART_TYPE, g as DEF_CELL_BORDER, i as AXIS_ID_CATEGORY_SECONDARY, j as DEF_TEXT_SHADOW, k as DEF_SLIDE_MARGIN_IN, l as AlignV, m as ChartType, o as AXIS_ID_VALUE_PRIMARY, q as SLDNUMFLDID, r as AXIS_ID_CATEGORY_PRIMARY, s as AXIS_ID_VALUE_SECONDARY, u as BARCHART_COLORS, w as DEF_PRES_LAYOUT, x as DEF_FONT_COLOR, y as DEF_CHART_BORDER } from "./core-interfaces-vUc0ElZs.js";
 import JSZip from "jszip";
 //#region src/gen-utils.ts
 /**
@@ -244,6 +244,17 @@ function genXmlGradientFill(gradient) {
 	return strXml;
 }
 /**
+* Create a native DrawingML pattern fill.
+* @param {PatternFillProps} pattern pattern fill options
+* @returns XML string
+*/
+function genXmlPatternFill(pattern) {
+	if (!pattern) throw new Error("Pattern fill requires a pattern object.");
+	const fgColor = pattern.fgColor ?? "000000";
+	const bgColor = pattern.bgColor ?? "FFFFFF";
+	return `<a:pattFill prst="${pattern.preset}"><a:fgClr>${createColorElement(fgColor)}</a:fgClr><a:bgClr>${createColorElement(bgColor)}</a:bgClr></a:pattFill>`;
+}
+/**
 * Create color selection
 * @param {Color | ShapeFillProps | ShapeLineProps} props fill props
 * @returns XML string
@@ -268,6 +279,9 @@ function genXmlColorSelection(props) {
 			case "gradient":
 				outText += genXmlGradientFill(typeof props === "string" ? void 0 : props.gradient);
 				break;
+			case "pattern":
+				outText += genXmlPatternFill(typeof props === "string" ? void 0 : props.pattern);
+				break;
 			default:
 				outText += "";
 				break;
@@ -333,6 +347,123 @@ function svgMarkupToDataUri(svg) {
 	for (let i = 0; i < bytes.length; i++) binary += String.fromCharCode(bytes[i]);
 	return `data:image/svg+xml;base64,${btoa(binary)}`;
 }
+/**
+* Decode a base64 image payload (raw base64 or a `data:` URI) to bytes.
+* - tolerant of the `data:[mime];base64,` prefix and of whitespace in the payload
+* @param {string} b64 - base64 string or data URI
+* @returns {Uint8Array | null} decoded bytes, or `null` when the payload is empty/undecodable
+*/
+function decodeBase64ToBytes(b64) {
+	if (!b64) return null;
+	const comma = b64.indexOf("base64,");
+	const payload = (comma >= 0 ? b64.slice(comma + 7) : b64).replace(/\s/g, "");
+	if (!payload) return null;
+	try {
+		const binary = atob(payload);
+		const bytes = new Uint8Array(binary.length);
+		for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+		return bytes;
+	} catch {
+		return null;
+	}
+}
+/**
+* Read the intrinsic pixel dimensions of a raster image from its header bytes.
+* - synchronous: parses only file-format headers, never decodes pixels
+* - supports PNG, JPEG, GIF, BMP, and WebP (VP8 / VP8L / VP8X)
+* - vector (SVG) and unrecognized formats return `null` (no intrinsic pixel size)
+*
+* Used by image `sizing: 'cover' | 'contain'` to compute an aspect-correct
+* `<a:srcRect>` crop from the *natural* image ratio rather than the displayed box.
+* @param {string} dataB64 - base64 image payload or `data:` URI
+* @returns {{ w: number, h: number } | null} natural pixel size, or `null` when unmeasurable
+*/
+function getImageSizeFromBase64(dataB64) {
+	const b = decodeBase64ToBytes(dataB64);
+	if (!b || b.length < 24) return null;
+	if (b[0] === 137 && b[1] === 80 && b[2] === 78 && b[3] === 71) {
+		const w = b[16] << 24 | b[17] << 16 | b[18] << 8 | b[19];
+		const h = b[20] << 24 | b[21] << 16 | b[22] << 8 | b[23];
+		return w > 0 && h > 0 ? {
+			w,
+			h
+		} : null;
+	}
+	if (b[0] === 71 && b[1] === 73 && b[2] === 70) {
+		const w = b[6] | b[7] << 8;
+		const h = b[8] | b[9] << 8;
+		return w > 0 && h > 0 ? {
+			w,
+			h
+		} : null;
+	}
+	if (b[0] === 66 && b[1] === 77) {
+		const w = b[18] | b[19] << 8 | b[20] << 16 | b[21] << 24;
+		const h = b[22] | b[23] << 8 | b[24] << 16 | b[25] << 24;
+		const aw = Math.abs(w);
+		const ah = Math.abs(h);
+		return aw > 0 && ah > 0 ? {
+			w: aw,
+			h: ah
+		} : null;
+	}
+	if (b[0] === 82 && b[1] === 73 && b[2] === 70 && b[3] === 70 && b[8] === 87 && b[9] === 69 && b[10] === 66 && b[11] === 80) {
+		const fourCC = String.fromCharCode(b[12], b[13], b[14], b[15]);
+		if (fourCC === "VP8 " && b.length >= 30) {
+			const w = (b[26] | b[27] << 8) & 16383;
+			const h = (b[28] | b[29] << 8) & 16383;
+			return w > 0 && h > 0 ? {
+				w,
+				h
+			} : null;
+		}
+		if (fourCC === "VP8L" && b.length >= 25) {
+			const bits = b[21] | b[22] << 8 | b[23] << 16 | b[24] << 24;
+			const w = (bits & 16383) + 1;
+			const h = (bits >> 14 & 16383) + 1;
+			return w > 0 && h > 0 ? {
+				w,
+				h
+			} : null;
+		}
+		if (fourCC === "VP8X" && b.length >= 30) {
+			const w = (b[24] | b[25] << 8 | b[26] << 16) + 1;
+			const h = (b[27] | b[28] << 8 | b[29] << 16) + 1;
+			return w > 0 && h > 0 ? {
+				w,
+				h
+			} : null;
+		}
+		return null;
+	}
+	if (b[0] === 255 && b[1] === 216) {
+		let i = 2;
+		while (i + 9 < b.length) {
+			if (b[i] !== 255) {
+				i++;
+				continue;
+			}
+			const marker = b[i + 1];
+			if (marker >= 192 && marker <= 207 && marker !== 196 && marker !== 200 && marker !== 204) {
+				const h = b[i + 5] << 8 | b[i + 6];
+				const w = b[i + 7] << 8 | b[i + 8];
+				return w > 0 && h > 0 ? {
+					w,
+					h
+				} : null;
+			}
+			if (marker >= 208 && marker <= 217 || marker === 1) {
+				i += 2;
+				continue;
+			}
+			const segLen = b[i + 2] << 8 | b[i + 3];
+			if (segLen < 2) break;
+			i += 2 + segLen;
+		}
+		return null;
+	}
+	return null;
+}
 //#endregion
 //#region src/gen-tables.ts
 /**
@@ -386,52 +517,62 @@ function parseTextToLines(cell, colWidth, verbose) {
 	*/
 	let newLine = [];
 	inputCells.forEach((cell) => {
-		if (typeof cell.text === "string") {
-			if (cell.text.split("\n").length > 1) cell.text.split("\n").forEach((textLine) => {
-				newLine.push({
+		if (typeof cell.text !== "string") return;
+		if (cell.text.includes("\n")) {
+			const parts = cell.text.split("\n");
+			parts.forEach((part, partIdx) => {
+				if (partIdx === parts.length - 1) newLine.push({
 					_type: "tablecell",
-					text: textLine,
-					options: {
-						...cell.options,
-						breakLine: true
-					}
+					text: part,
+					options: cell.options
 				});
+				else {
+					newLine.push({
+						_type: "tablecell",
+						text: part,
+						options: {
+							...cell.options,
+							breakLine: true
+						}
+					});
+					inputLines1.push(newLine);
+					newLine = [];
+				}
 			});
-			else newLine.push({
-				_type: "tablecell",
-				text: cell.text.trim(),
-				options: cell.options
-			});
-			if (cell.options?.breakLine) {
-				if (verbose) console.log(`inputCells: new line > ${JSON.stringify(newLine)}`);
-				inputLines1.push(newLine);
-				newLine = [];
-			}
-		}
-		if (newLine.length > 0) {
+		} else newLine.push({
+			_type: "tablecell",
+			text: cell.text.trim(),
+			options: cell.options
+		});
+		if (cell.options?.breakLine) {
+			if (verbose) console.log(`inputCells: new line > ${JSON.stringify(newLine)}`);
 			inputLines1.push(newLine);
 			newLine = [];
 		}
 	});
+	if (newLine.length > 0) {
+		inputLines1.push(newLine);
+		newLine = [];
+	}
 	if (verbose) {
 		console.log(`[2/4] inputLines1 (${inputLines1.length})`);
 		inputLines1.forEach((line, idx) => console.log(`[2/4] [${idx + 1}] line: ${JSON.stringify(line)}`));
 	}
 	inputLines1.forEach((line) => {
+		const lineTokens = [];
 		line.forEach((cell) => {
-			const lineCells = [];
 			const lineWords = String(cell.text).split(" ");
 			lineWords.forEach((word, idx) => {
 				const cellProps = { ...cell.options };
 				if (cellProps?.breakLine) cellProps.breakLine = idx + 1 === lineWords.length;
-				lineCells.push({
+				lineTokens.push({
 					_type: "tablecell",
 					text: word + (idx + 1 < lineWords.length ? " " : ""),
 					options: cellProps
 				});
 			});
-			inputLines2.push(lineCells);
 		});
+		inputLines2.push(lineTokens);
 	});
 	if (verbose) {
 		console.log(`[3/4] inputLines2 (${inputLines2.length})`);
@@ -539,6 +680,7 @@ function getSlidesForTableRows(tableRows = [], tableProps = {}, presLayout, mast
 		numCols += Number(cellOpts?.colspan ? cellOpts.colspan : 1);
 	});
 	if (tableProps.verbose) console.log(`| numCols ......................................... = ${numCols}`);
+	const colSpanDepths = new Array(numCols).fill(0);
 	if (!tablePropW && tableProps.colW) {
 		tableCalcW = Array.isArray(tableProps.colW) ? tableProps.colW.reduce((p, n) => p + n) * EMU : tableProps.colW * numCols || 0;
 		if (tableProps.verbose) console.log(`| tableCalcW ...................................... = ${tableCalcW / EMU}`);
@@ -559,6 +701,7 @@ function getSlidesForTableRows(tableRows = [], tableProps = {}, presLayout, mast
 	}
 	let newTableRowSlide = { rows: [] };
 	tableRows.forEach((row, iRow) => {
+		const hasActiveRowSpan = colSpanDepths.some((d) => d > 0);
 		const rowCellLines = [];
 		let maxCellMarTopEmu = 0;
 		let maxCellMarBtmEmu = 0;
@@ -655,7 +798,7 @@ function getSlidesForTableRows(tableRows = [], tableProps = {}, presLayout, mast
 			rowCellLines.forEach((cell) => {
 				if (cell._lineHeight >= emuLineMaxH) emuLineMaxH = cell._lineHeight;
 			});
-			if (emuTabCurrH + emuLineMaxH > emuSlideTabH) {
+			if (emuTabCurrH + emuLineMaxH > emuSlideTabH && !hasActiveRowSpan) {
 				if (tableProps.verbose) {
 					console.log("\n|-----------------------------------------------------------------------|");
 					console.log(`|-- NEW SLIDE CREATED (currTabH+currLineH > maxH) => ${(emuTabCurrH / EMU).toFixed(2)} + ${(srcCell._lineHeight / EMU).toFixed(2)} > ${emuSlideTabH / EMU}`);
@@ -699,6 +842,16 @@ function getSlidesForTableRows(tableRows = [], tableProps = {}, presLayout, mast
 			if (rowCellLines.map((cell) => cell._lines.length).reduce((prev, next) => prev + next) === 0) isDone = true;
 		}
 		if (currTableRow.length > 0) newTableRowSlide.rows.push(currTableRow);
+		const occupiedBefore = [...colSpanDepths];
+		let colCursor = 0;
+		row.forEach((cell) => {
+			while (colCursor < numCols && occupiedBefore[colCursor] > 0) colCursor++;
+			const cellColspan = cell.options?.colspan ?? 1;
+			const cellRowspan = cell.options?.rowspan ?? 1;
+			if (cellRowspan > 1) for (let c = 0; c < cellColspan && colCursor + c < numCols; c++) colSpanDepths[colCursor + c] = cellRowspan;
+			colCursor += cellColspan;
+		});
+		for (let c = 0; c < numCols; c++) if (colSpanDepths[c] > 0) colSpanDepths[c]--;
 		if (tableProps.verbose) console.log(`- SLIDE [${tableRowSlides.length}]: ROW [${iRow}]: ...COMPLETE ...... emuTabCurrH = ${(emuTabCurrH / EMU).toFixed(2)} ( emuSlideTabH = ${(emuSlideTabH / EMU).toFixed(2)} )`);
 	});
 	tableRowSlides.push(newTableRowSlide);
@@ -954,6 +1107,7 @@ function createSlideMaster(props, target) {
 		else if ("image" in object) addImageDefinition(tgt, object.image);
 		else if ("line" in object) addShapeDefinition(tgt, "line", object.line);
 		else if ("rect" in object) addShapeDefinition(tgt, "rect", object.rect);
+		else if ("roundRect" in object) addShapeDefinition(tgt, "roundRect", object.roundRect);
 		else if ("text" in object) addTextDefinition(tgt, [{ text: object.text.text }], object.text.options || {}, false);
 		else if ("placeholder" in object) {
 			const placeholder = object.placeholder;
@@ -1295,6 +1449,7 @@ function addImageDefinition(target, opt) {
 		flipV: opt.flipV || false,
 		flipH: opt.flipH || false,
 		transparency: opt.transparency || 0,
+		duotone: opt.duotone,
 		objectName,
 		shadow: correctShadowOptions(opt.shadow)
 	};
@@ -1344,7 +1499,7 @@ function addImageDefinition(target, opt) {
 			type: "hyperlink",
 			data: objHyperlink.slide ? "slide" : "dummy",
 			rId: imageRelId,
-			Target: objHyperlink.url || String(objHyperlink.slide)
+			Target: objHyperlink.url ? encodeXmlEntities(objHyperlink.url) : String(objHyperlink.slide)
 		});
 		objHyperlink._rId = imageRelId;
 		newObject.hyperlink = objHyperlink;
@@ -2102,7 +2257,7 @@ async function createExcelWorksheet(chartObject, zip) {
 			if (chartObject.opts._type === "bubble" || chartObject.opts._type === "bubble3D") strSharedStrings += `<sst xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" count="${intBubbleCols}" uniqueCount="${intBubbleCols}">`;
 			else if (chartObject.opts._type === "scatter") strSharedStrings += `<sst xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" count="${data.length}" uniqueCount="${data.length}">`;
 			else if (IS_MULTI_CAT_AXES) {
-				let totCount = data.length;
+				let totCount = data.length + 1;
 				data[0].labels.forEach((arrLabel) => totCount += arrLabel.filter((label) => label && label !== "").length);
 				strSharedStrings += `<sst xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" count="${totCount}" uniqueCount="${totCount}">`;
 				strSharedStrings += "<si><t/></si>";
@@ -2170,7 +2325,7 @@ async function createExcelWorksheet(chartObject, zip) {
 			strSheetXml += "<worksheet xmlns=\"http://schemas.openxmlformats.org/spreadsheetml/2006/main\" xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\" xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\" mc:Ignorable=\"x14ac\" xmlns:x14ac=\"http://schemas.microsoft.com/office/spreadsheetml/2009/9/ac\">";
 			if (chartObject.opts._type === "bubble" || chartObject.opts._type === "bubble3D") strSheetXml += `<dimension ref="A1:${getExcelColName(intBubbleCols)}${data[0].values.length + 1}"/>`;
 			else if (chartObject.opts._type === "scatter") strSheetXml += `<dimension ref="A1:${getExcelColName(data.length)}${data[0].values.length + 1}"/>`;
-			else strSheetXml += `<dimension ref="A1:${getExcelColName(data.length + 1)}${data[0].values.length + 1}"/>`;
+			else strSheetXml += `<dimension ref="A1:${getExcelColName(data.length + data[0].labels.length)}${data[0].values.length + 1}"/>`;
 			strSheetXml += "<sheetViews><sheetView tabSelected=\"1\" workbookViewId=\"0\"><selection activeCell=\"B1\" sqref=\"B1\"/></sheetView></sheetViews>";
 			strSheetXml += "<sheetFormatPr baseColWidth=\"10\" defaultRowHeight=\"16\"/>";
 			if (chartObject.opts._type === "bubble" || chartObject.opts._type === "bubble3D") {
@@ -2222,82 +2377,28 @@ async function createExcelWorksheet(chartObject, zip) {
 						strSheetXml += "</row>";
 					});
 				} else {
-					strSheetXml += `<row r="1" spans="1:${data.length + data[0].labels.length}">`;
-					for (let idx = 0; idx < data[0].labels.length; idx++) strSheetXml += `<c r="${getExcelColName(idx + 1)}1" t="s"><v>0</v></c>`;
-					for (let idx = data[0].labels.length - 1; idx < data.length + data[0].labels.length - 1; idx++) strSheetXml += `<c r="${getExcelColName(idx + data[0].labels.length)}1" t="s"><v>${idx}</v></c>`;
-					strSheetXml += "</row>";
-					/**
-					* @example INPUT
-					* const LABELS = [
-					*   ["Gear", "Berg", "Motr", "Swch", "Plug", "Cord", "Pump", "Leak", "Seal"],
-					*   ["Mech", "", "", "Elec", "", "", "Hydr", "", ""],
-					* ];
-					* const arrDataRegions = [
-					*   { name: "West", labels: LABELS, values: [11, 8, 3, 0, 11, 3, 0, 0, 0] },
-					*   { name: "Ctrl", labels: LABELS, values: [0, 11, 6, 19, 12, 5, 0, 0, 0] },
-					*   { name: "East", labels: LABELS, values: [0, 3, 2, 0, 0, 0, 4, 3, 1] },
-					* ];
-					*/
-					/**
-					* @example OUTPUT EXCEL SHEET
-					* |/|---A--|---B--|---C--|---D--|---E--|
-					* |1|      |      | West | Ctrl | East |
-					* |2| Mech | Gear |  ##  |  ##  |  ##  |
-					* |3|      | Brng |  ##  |  ##  |  ##  |
-					* |4|      | Motr |  ##  |  ##  |  ##  |
-					* |5| Elec | Swch |  ##  |  ##  |  ##  |
-					* |6|      | Plug |  ##  |  ##  |  ##  |
-					* |7|      | Cord |  ##  |  ##  |  ##  |
-					* |8| Hydr | Pump |  ##  |  ##  |  ##  |
-					* |9|      | Leak |  ##  |  ##  |  ##  |
-					*|10|      | Seal |  ##  |  ##  |  ##  |
-					*/
-					/**
-					* @example OUTPUT EXCEL SHEET XML
-					* <row r="1" spans="1:5">
-					*   <c r="A1" t="s"><v>0</v></c>
-					*   <c r="B1" t="s"><v>0</v></c>
-					*   <c r="C1" t="s"><v>1</v></c>
-					*   <c r="D1" t="s"><v>2</v></c>
-					*   <c r="E1" t="s"><v>3</v></c>
-					* </row>
-					* <row r="2" spans="1:5">
-					*   <c r="A2" t="s"><v>4</v></c>
-					*   <c r="B2" t="s"><v>7</v></c>
-					*   <c r="C2"      ><v>###</v></c>
-					* </row>
-					* <row r="3" spans="1:5">
-					*   <c r="A3" />
-					*   <c r="B3" t="s"><v>8</v></c>
-					*   <c r="C3"      ><v>###</v></c>
-					* </row>
-					*/
-					/**
-					* @example SHARED-STRINGS
-					* 1=West, 2=Ctrl, 3=East, 4=Mech, 5=Elec, 6=Mydr, 7=Gear, 8=Brng, [...], 15=Seal
-					*/
-					/**
-					* const LABELS = [
-					*   ["Gear", "Berg", "Motr", "Swch", "Plug", "Cord", "Pump", "Leak", "Seal"],
-					*   ["Mech",     "",     "", "Elec",     "",     "", "Hydr",     "",     ""],
-					*   ["2010",     "",     "",     "",     "",     "",     "",     "",     ""],
-					* ];
-					*/
 					const TOT_SER = data.length;
 					const TOT_CAT = data[0].labels[0].length;
 					const TOT_LVL = data[0].labels.length;
+					const revLabelGroups = data[0].labels.slice().reverse();
+					const ssLabelMap = /* @__PURE__ */ new Map();
+					let ssIdx = TOT_SER + 1;
+					revLabelGroups.forEach((labelsGroup, revLevelIdx) => {
+						labelsGroup.forEach((label, rowIdx) => {
+							if (label && label !== "") ssLabelMap.set(`${revLevelIdx}:${rowIdx}`, ssIdx++);
+						});
+					});
+					strSheetXml += `<row r="1" spans="1:${TOT_SER + TOT_LVL}">`;
+					for (let col = 1; col <= TOT_LVL; col++) strSheetXml += `<c r="${getExcelColName(col)}1" t="s"><v>0</v></c>`;
+					for (let ser = 0; ser < TOT_SER; ser++) strSheetXml += `<c r="${getExcelColName(TOT_LVL + ser + 1)}1" t="s"><v>${ser + 1}</v></c>`;
+					strSheetXml += "</row>";
 					for (let idx = 0; idx < TOT_CAT; idx++) {
 						strSheetXml += `<row r="${idx + 2}" spans="1:${TOT_SER + TOT_LVL}">`;
-						let totLabels = TOT_SER;
-						const revLabelGroups = data[0].labels.slice().reverse();
 						revLabelGroups.forEach((labelsGroup, idy) => {
-							if (labelsGroup[idx]) {
-								const totGrpLbls = idy === 0 ? 1 : revLabelGroups[idy - 1].filter((label) => label && label !== "").length;
-								totLabels += totGrpLbls;
-								strSheetXml += `<c r="${getExcelColName(idx + 1 + idy)}${idx + 2}" t="s"><v>${totLabels}</v></c>`;
-							}
+							const colLabel = labelsGroup[idx];
+							if (colLabel && colLabel !== "") strSheetXml += `<c r="${getExcelColName(idy + 1)}${idx + 2}" t="s"><v>${ssLabelMap.get(`${idy}:${idx}`)}</v></c>`;
 						});
-						for (let idy = 0; idy < TOT_SER; idy++) strSheetXml += `<c r="${getExcelColName(TOT_LVL + idy + 1)}${idx + 2}"><v>${data[idy].values[idx] || 0}</v></c>`;
+						for (let idy = 0; idy < TOT_SER; idy++) strSheetXml += `<c r="${getExcelColName(TOT_LVL + idy + 1)}${idx + 2}"><v>${data[idy].values[idx] ?? ""}</v></c>`;
 						strSheetXml += "</row>";
 					}
 				}
@@ -2440,6 +2541,13 @@ function makeXmlCharts(rel) {
 	if (rel.opts.showLegend) {
 		strXml += "<c:legend>";
 		strXml += "<c:legendPos val=\"" + rel.opts.legendPos + "\"/>";
+		if (Array.isArray(rel.opts._type)) {
+			let seriesIdx = 0;
+			rel.opts._type.forEach((type) => {
+				if (type.options?.showLegend === false) for (let i = 0; i < type.data.length; i++) strXml += `<c:legendEntry><c:idx val="${seriesIdx + i}"/><c:delete val="1"/></c:legendEntry>`;
+				seriesIdx += type.data.length;
+			});
+		}
 		strXml += "<c:overlay val=\"0\"/>";
 		if (rel.opts.legendFontFace || rel.opts.legendFontSize || rel.opts.legendColor) {
 			strXml += "<c:txPr>";
@@ -2515,17 +2623,20 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 				strXml += "      <c:strCache><c:ptCount val=\"1\"/><c:pt idx=\"0\"><c:v>" + encodeXmlEntities(obj.name) + "</c:v></c:pt></c:strCache>";
 				strXml += "    </c:strRef>";
 				strXml += "  </c:tx>";
-				const seriesColor = opts.chartColors ? opts.chartColors[colorIndex % opts.chartColors.length] : null;
+				const seriesOverride = opts.seriesOptions?.[obj._dataIndex];
+				const seriesColor = seriesOverride?.color ?? (opts.chartColors ? opts.chartColors[colorIndex % opts.chartColors.length] : null);
 				strXml += "  <c:spPr>";
 				if (seriesColor === "transparent") strXml += "<a:noFill/>";
 				else if (opts.chartColorsOpacity) strXml += "<a:solidFill>" + createColorElement(seriesColor, `<a:alpha val="${Math.round(opts.chartColorsOpacity * 1e3)}"/>`) + "</a:solidFill>";
 				else strXml += "<a:solidFill>" + createColorElement(seriesColor) + "</a:solidFill>";
-				if (chartType === "line" || chartType === "radar") if (opts.lineSize === 0) strXml += "<a:ln><a:noFill/></a:ln>";
-				else {
-					strXml += `<a:ln w="${valToPts(opts.lineSize)}" cap="${createLineCap(opts.lineCap)}"><a:solidFill>${createColorElement(seriesColor)}</a:solidFill>`;
-					strXml += `<a:prstDash val="${opts.lineDashValues?.[colorIndex] ?? opts.lineDash ?? "solid"}"/><a:round/></a:ln>`;
-				}
-				else if (opts.dataBorder) strXml += `<a:ln w="${valToPts(opts.dataBorder.pt)}" cap="${createLineCap(opts.lineCap)}"><a:solidFill>${createColorElement(opts.dataBorder.color)}</a:solidFill><a:prstDash val="solid"/><a:round/></a:ln>`;
+				if (chartType === "line" || chartType === "radar") {
+					const effectiveLineSize = seriesOverride?.lineSize ?? opts.lineSize;
+					if (effectiveLineSize === 0) strXml += "<a:ln><a:noFill/></a:ln>";
+					else {
+						strXml += `<a:ln w="${valToPts(effectiveLineSize)}" cap="${createLineCap(opts.lineCap)}"><a:solidFill>${createColorElement(seriesColor)}</a:solidFill>`;
+						strXml += `<a:prstDash val="${opts.lineDashValues?.[colorIndex] ?? opts.lineDash ?? "solid"}"/><a:round/></a:ln>`;
+					}
+				} else if (opts.dataBorder) strXml += `<a:ln w="${valToPts(opts.dataBorder.pt)}" cap="${createLineCap(opts.lineCap)}"><a:solidFill>${createColorElement(opts.dataBorder.color)}</a:solidFill><a:prstDash val="solid"/><a:round/></a:ln>`;
 				strXml += createShadowElement(opts.shadow, DEF_SHAPE_SHADOW);
 				strXml += "  </c:spPr>";
 				if (chartType !== "line" && chartType !== "radar") strXml += "  <c:invertIfNegative val=\"0\"/>";
@@ -2544,13 +2655,18 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 					strXml += "</c:marker>";
 				}
 				if (chartType !== "radar") {
+					const lblColor = seriesOverride?.dataLabelColor ?? opts.dataLabelColor ?? "000000";
+					const lblBold = seriesOverride?.dataLabelFontBold ?? opts.dataLabelFontBold ?? false;
+					const lblItalic = seriesOverride?.dataLabelFontItalic ?? opts.dataLabelFontItalic ?? false;
+					const lblSize = seriesOverride?.dataLabelFontSize ?? opts.dataLabelFontSize ?? 12;
+					const lblFace = seriesOverride?.dataLabelFontFace ?? opts.dataLabelFontFace ?? "Arial";
 					strXml += "<c:dLbls>";
 					strXml += `<c:numFmt formatCode="${encodeXmlEntities(opts.dataLabelFormatCode) || "General"}" sourceLinked="0"/>`;
 					if (opts.dataLabelBkgrdColors) strXml += `<c:spPr><a:solidFill>${createColorElement(seriesColor)}</a:solidFill></c:spPr>`;
 					strXml += "<c:txPr><a:bodyPr/><a:lstStyle/><a:p><a:pPr>";
-					strXml += `<a:defRPr b="${opts.dataLabelFontBold ? 1 : 0}" i="${opts.dataLabelFontItalic ? 1 : 0}" strike="noStrike" sz="${Math.round((opts.dataLabelFontSize || 12) * 100)}" u="none">`;
-					strXml += `<a:solidFill>${createColorElement(opts.dataLabelColor || "000000")}</a:solidFill>`;
-					strXml += `<a:latin typeface="${opts.dataLabelFontFace || "Arial"}"/>`;
+					strXml += `<a:defRPr b="${lblBold ? 1 : 0}" i="${lblItalic ? 1 : 0}" strike="noStrike" sz="${Math.round(lblSize * 100)}" u="none">`;
+					strXml += `<a:solidFill>${createColorElement(lblColor)}</a:solidFill>`;
+					strXml += `<a:latin typeface="${lblFace}"/>`;
 					strXml += "</a:defRPr></a:pPr></a:p></c:txPr>";
 					if (opts.dataLabelPosition) strXml += `<c:dLblPos val="${opts.dataLabelPosition}"/>`;
 					strXml += "<c:showLegendKey val=\"0\"/>";
@@ -3524,6 +3640,15 @@ const ImageSizingXml = {
 		const r = imgSize.w - (boxDim.x + boxDim.w);
 		const t = boxDim.y;
 		const b = imgSize.h - (boxDim.y + boxDim.h);
+		if (l < 0 || r < 0 || t < 0 || b < 0) {
+			const over = [
+				l < 0 && `x (${l < 0 ? -l : 0} past left edge)`,
+				r < 0 && `x+w (${-r} past right edge)`,
+				t < 0 && `y (${-t} past top edge)`,
+				b < 0 && `y+h (${-b} past bottom edge)`
+			].filter(Boolean).join(", ");
+			throw new Error(`addImage sizing.type 'crop': crop window overflows image bounds — ${over}. Ensure x≥0, y≥0, x+w≤w, y+h≤h.`);
+		}
 		return `<a:srcRect l="${Math.round(1e5 * (l / imgSize.w))}" r="${Math.round(1e5 * (r / imgSize.w))}" t="${Math.round(1e5 * (t / imgSize.h))}" b="${Math.round(1e5 * (b / imgSize.h))}"/><a:stretch/>`;
 	}
 };
@@ -3536,10 +3661,16 @@ const ImageSizingXml = {
 * @param {number} cy - shape height (EMU), used to scale `rectRadius`
 * @return {string} `<a:prstGeom>` XML
 */
+const RECT_RADIUS_ADJ1_SHAPES = new Set(["round2SameRect", "round2DiagRect"]);
 function genXmlPresetGeom(shapeName, options, cx, cy) {
 	let strXml = `<a:prstGeom prst="${shapeName}"><a:avLst>`;
-	if (options.rectRadius) strXml += `<a:gd name="adj" fmla="val ${Math.round(options.rectRadius * EMU * 1e5 / Math.min(cx, cy))}"/>`;
-	else if (options.angleRange) {
+	if (options.rectRadius) {
+		const adjVal = Math.round(options.rectRadius * EMU * 1e5 / Math.min(cx, cy));
+		if (RECT_RADIUS_ADJ1_SHAPES.has(shapeName)) {
+			strXml += `<a:gd name="adj1" fmla="val ${adjVal}"/>`;
+			strXml += "<a:gd name=\"adj2\" fmla=\"val 0\"/>";
+		} else strXml += `<a:gd name="adj" fmla="val ${adjVal}"/>`;
+	} else if (options.angleRange) {
 		for (let i = 0; i < 2; i++) {
 			const angle = options.angleRange[i];
 			strXml += `<a:gd name="adj${i + 1}" fmla="val ${convertRotationDegrees(angle)}" />`;
@@ -3660,7 +3791,11 @@ function slideObjectToXml(slide) {
 				strXml = `<p:graphicFrame><p:nvGraphicFramePr><p:cNvPr id="${intTableNum * slide._slideNum + 1}" name="${slideItemObj.options.objectName}" descr="${encodeXmlEntities(slideItemObj.options.altText || "")}"/>`;
 				strXml += "<p:cNvGraphicFramePr><a:graphicFrameLocks noGrp=\"1\"/></p:cNvGraphicFramePr>  <p:nvPr><p:extLst><p:ext uri=\"{D42A27DB-BD31-4B8C-83A1-F6EECF244321}\"><p14:modId xmlns:p14=\"http://schemas.microsoft.com/office/powerpoint/2010/main\" val=\"1579011935\"/></p:ext></p:extLst></p:nvPr></p:nvGraphicFramePr>";
 				strXml += `<p:xfrm><a:off x="${x || (x === 0 ? 0 : EMU)}" y="${y || (y === 0 ? 0 : EMU)}"/><a:ext cx="${cx || (cx === 0 ? 0 : EMU)}" cy="${cy || EMU}"/></p:xfrm>`;
-				strXml += "<a:graphic><a:graphicData uri=\"http://schemas.openxmlformats.org/drawingml/2006/table\"><a:tbl><a:tblPr/>";
+				{
+					const tblPrAttrs = (objTabOpts.hasHeader ? " firstRow=\"1\"" : "") + (objTabOpts.hasFooter ? " lastRow=\"1\"" : "") + (objTabOpts.hasBandedRows ? " bandRow=\"1\"" : "") + (objTabOpts.hasBandedColumns ? " bandCol=\"1\"" : "") + (objTabOpts.hasFirstColumn ? " firstCol=\"1\"" : "") + (objTabOpts.hasLastColumn ? " lastCol=\"1\"" : "");
+					const tblPr = objTabOpts.tableStyle ? `<a:tblPr${tblPrAttrs}><a:tableStyleId>${objTabOpts.tableStyle}</a:tableStyleId></a:tblPr>` : `<a:tblPr${tblPrAttrs}/>`;
+					strXml += `<a:graphic><a:graphicData uri="http://schemas.openxmlformats.org/drawingml/2006/table"><a:tbl>${tblPr}`;
+				}
 				if (Array.isArray(objTabOpts.colW)) {
 					strXml += "<a:tblGrid>";
 					for (let col = 0; col < intColCnt; col++) {
@@ -3883,6 +4018,7 @@ function slideObjectToXml(slide) {
 				if ((slide._relsMedia || []).find((rel) => rel.rId === slideItemObj.imageRid)?.extn === "svg") {
 					strSlideXml += `<a:blip r:embed="rId${slideItemObj.imageRid - 1}">`;
 					strSlideXml += slideItemObj.options.transparency ? ` <a:alphaModFix amt="${Math.round((100 - slideItemObj.options.transparency) * 1e3)}"/>` : "";
+					strSlideXml += slideItemObj.options.duotone ? `<a:duotone>${createColorElement(slideItemObj.options.duotone.shadow)}${createColorElement(slideItemObj.options.duotone.highlight)}</a:duotone>` : "";
 					strSlideXml += " <a:extLst>";
 					strSlideXml += "  <a:ext uri=\"{96DAC541-7B7A-43D3-8B79-37D633B846F1}\">";
 					strSlideXml += `   <asvg:svgBlip xmlns:asvg="http://schemas.microsoft.com/office/drawing/2016/SVG/main" r:embed="rId${slideItemObj.imageRid}"/>`;
@@ -3892,6 +4028,7 @@ function slideObjectToXml(slide) {
 				} else {
 					strSlideXml += `<a:blip r:embed="rId${slideItemObj.imageRid}">`;
 					strSlideXml += slideItemObj.options.transparency ? `<a:alphaModFix amt="${Math.round((100 - slideItemObj.options.transparency) * 1e3)}"/>` : "";
+					strSlideXml += slideItemObj.options.duotone ? `<a:duotone>${createColorElement(slideItemObj.options.duotone.shadow)}${createColorElement(slideItemObj.options.duotone.highlight)}</a:duotone>` : "";
 					strSlideXml += "</a:blip>";
 				}
 				if (sizing?.type) {
@@ -3899,10 +4036,17 @@ function slideObjectToXml(slide) {
 					const boxH = sizing.h ? getSmartParseNumber(sizing.h, "Y", slide._presLayout) : cy;
 					const boxX = getSmartParseNumber(sizing.x || 0, "X", slide._presLayout);
 					const boxY = getSmartParseNumber(sizing.y || 0, "Y", slide._presLayout);
-					strSlideXml += ImageSizingXml[sizing.type]({
+					let cropSize = {
 						w: imgWidth,
 						h: imgHeight
-					}, {
+					};
+					if (sizing.type === "cover" || sizing.type === "contain") {
+						const relData = (slide._relsMedia || []).find((rel) => rel.rId === slideItemObj.imageRid)?.data;
+						const natural = typeof relData === "string" ? getImageSizeFromBase64(relData) : null;
+						if (natural) cropSize = natural;
+						else console.warn(`Warning: sizing '${sizing.type}' could not measure natural dimensions for image "${slideItemObj.options.objectName}"; falling back to displayed aspect ratio (crop may be inexact). Provide a raster image (PNG/JPEG/GIF/BMP/WebP) to enable an aspect-correct crop.`);
+					}
+					strSlideXml += ImageSizingXml[sizing.type](cropSize, {
 						w: boxW,
 						h: boxH,
 						x: boxX,
@@ -4298,14 +4442,19 @@ function genXmlTextBody(slideObj) {
 		itext.options = itext.options || opts || {};
 		if (idx === 0 && itext.options && !itext.options.bullet && opts.bullet) itext.options.bullet = opts.bullet;
 		if (typeof itext.text === "string" || typeof itext.text === "number") itext.text = itext.text.toString().replace(/\r*\n/g, "\r\n");
-		if (itext.text.includes("\r\n") && itext.text.match(/\n$/g) === null) itext.text.split("\r\n").forEach((line) => {
-			itext.options.breakLine = true;
-			arrTextObjects.push({
-				text: line,
-				options: itext.options
+		if (itext.text.includes("\r\n") && itext.text.match(/\n$/g) === null) {
+			const lines = itext.text.split("\r\n");
+			lines.forEach((line, lineIdx) => {
+				const isLast = lineIdx === lines.length - 1;
+				arrTextObjects.push({
+					text: line,
+					options: {
+						...itext.options,
+						breakLine: isLast ? itext.options.breakLine : true
+					}
+				});
 			});
-		});
-		else arrTextObjects.push(itext);
+		} else arrTextObjects.push(itext);
 	});
 	const arrLines = [];
 	let arrTexts = [];
@@ -4407,7 +4556,7 @@ function genXmlPlaceholder(placeholderObj) {
 * @param {PresSlideInternal} masterSlide - master slide
 * @returns XML
 */
-function makeXmlContTypes(slides, slideLayouts, masterSlide) {
+function makeXmlContTypes(slides, slideLayouts, masterSlide, hasCustomProps) {
 	let strXml = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\r\n";
 	strXml += "<Types xmlns=\"http://schemas.openxmlformats.org/package/2006/content-types\">";
 	strXml += "<Default Extension=\"xml\" ContentType=\"application/xml\"/>";
@@ -4457,6 +4606,7 @@ function makeXmlContTypes(slides, slideLayouts, masterSlide) {
 	});
 	strXml += " <Override PartName=\"/docProps/core.xml\" ContentType=\"application/vnd.openxmlformats-package.core-properties+xml\"/>";
 	strXml += " <Override PartName=\"/docProps/app.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.extended-properties+xml\"/>";
+	if (hasCustomProps) strXml += " <Override PartName=\"/docProps/custom.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.custom-properties+xml\"/>";
 	strXml += "</Types>";
 	return strXml;
 }
@@ -4464,13 +4614,15 @@ function makeXmlContTypes(slides, slideLayouts, masterSlide) {
 * Creates `_rels/.rels`
 * @returns XML
 */
-function makeXmlRootRels() {
-	return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\r
+function makeXmlRootRels(hasCustomProps) {
+	let xml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\r
 <Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
 		<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/extended-properties" Target="docProps/app.xml"/>
 		<Relationship Id="rId2" Type="http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties" Target="docProps/core.xml"/>
-		<Relationship Id="rId3" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" Target="ppt/presentation.xml"/>
-		</Relationships>`;
+		<Relationship Id="rId3" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" Target="ppt/presentation.xml"/>`;
+	if (hasCustomProps) xml += "\n		<Relationship Id=\"rId4\" Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/custom-properties\" Target=\"docProps/custom.xml\"/>";
+	xml += "\n		</Relationships>";
+	return xml;
 }
 /**
 * Creates `docProps/app.xml`
@@ -4536,6 +4688,23 @@ function makeXmlCore(title, subject, author, revision) {
 		<dcterms:modified xsi:type="dcterms:W3CDTF">${(/* @__PURE__ */ new Date()).toISOString().replace(/\.\d\d\dZ/, "Z")}</dcterms:modified>
 	</cp:coreProperties>`;
 }
+const CUSTOM_PROPS_FMTID = "{D5CDD505-2E9C-101B-9397-08002B2CF9AE}";
+/**
+* Creates `docProps/custom.xml`
+* @param props - custom property name/value pairs
+* @returns XML
+*/
+function makeXmlCustomProperties(props) {
+	return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\r
+<Properties xmlns="http://schemas.openxmlformats.org/officeDocument/2006/custom-properties" xmlns:vt="http://schemas.openxmlformats.org/officeDocument/2006/docPropsVTypes">${props.map(({ name, value }, idx) => {
+		let valueXml;
+		if (typeof value === "boolean") valueXml = `<vt:bool>${value}</vt:bool>`;
+		else if (value instanceof Date) valueXml = `<vt:filetime>${value.toISOString().replace(/\.\d{3}Z$/, "Z")}</vt:filetime>`;
+		else if (typeof value === "number") valueXml = Number.isInteger(value) ? `<vt:i4>${value}</vt:i4>` : `<vt:r8>${value}</vt:r8>`;
+		else valueXml = `<vt:lpwstr>${encodeXmlEntities(String(value))}</vt:lpwstr>`;
+		return `<property fmtid="${CUSTOM_PROPS_FMTID}" pid="${idx + 2}" name="${encodeXmlEntities(name)}">${valueXml}</property>`;
+	}).join("")}</Properties>`;
+}
 /**
 * Creates `ppt/_rels/presentation.xml.rels`
 * @param {PresSlideInternal[]} slides - Presenation Slides
@@ -4712,7 +4881,7 @@ function makeXmlTheme(pres) {
 */
 function makeXmlPresentation(pres) {
 	let strXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\r
-<p:presentation xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main" ${pres.rtlMode ? "rtl=\"1\"" : ""} saveSubsetFonts="1" autoCompressPictures="0">`;
+<p:presentation xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main" ${pres.rtlMode ? "rtl=\"1\"" : ""} saveSubsetFonts="1" autoCompressPictures="0"${pres.firstSlideNum !== 1 ? ` firstSlideNum="${pres.firstSlideNum}"` : ""}>`;
 	strXml += "<p:sldMasterIdLst><p:sldMasterId id=\"2147483648\" r:id=\"rId1\"/></p:sldMasterIdLst>";
 	strXml += `<p:notesMasterIdLst><p:notesMasterId r:id="rId${pres.slides.length + 2}"/></p:notesMasterIdLst>`;
 	strXml += "<p:sldIdLst>";
@@ -4751,9 +4920,96 @@ function makeXmlPresProps() {
 * @see: http://openxmldeveloper.org/discussions/formats/f/13/p/2398/8107.aspx
 * @return {string} XML
 */
-function makeXmlTableStyles() {
-	return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\r
-<a:tblStyleLst xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" def="{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}"/>`;
+function makeXmlTableStyles(tableStyles = []) {
+	const open = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\r
+<a:tblStyleLst xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" def="{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}"`;
+	if (!tableStyles || tableStyles.length === 0) return `${open}/>`;
+	let strXml = `${open}>`;
+	tableStyles.forEach(({ guid, def }) => {
+		strXml += `<a:tblStyle styleId="${guid}" styleName="${encodeXmlEntities(def.name)}">`;
+		[
+			["wholeTbl", def.wholeTbl],
+			["band1H", def.band1H],
+			["band2H", def.band2H],
+			["band1V", def.band1V],
+			["band2V", def.band2V],
+			["lastCol", def.lastCol],
+			["firstCol", def.firstCol],
+			["lastRow", def.lastRow],
+			["firstRow", def.firstRow]
+		].forEach(([name, region]) => {
+			if (region) strXml += genXmlTableStyleRegion(name, region);
+		});
+		strXml += "</a:tblStyle>";
+	});
+	strXml += "</a:tblStyleLst>";
+	return strXml;
+}
+/**
+* Build one `CT_TablePartStyle` region (e.g. `firstRow`, `band1H`) for a custom table style.
+* Emits `tcTxStyle` (text) before `tcStyle` (cell fill/borders) per the schema sequence.
+* @param {string} name - region element name
+* @param {TableStyleRegionProps} region - region styling
+* @return {string} XML
+*/
+function genXmlTableStyleRegion(name, region) {
+	let xml = `<a:${name}>`;
+	if (region.bold !== void 0 || region.italic !== void 0 || region.color) {
+		const b = region.bold ? " b=\"on\"" : "";
+		const i = region.italic ? " i=\"on\"" : "";
+		xml += `<a:tcTxStyle${b}${i}><a:fontRef idx="minor"/>`;
+		xml += region.color ? createColorElement(region.color) : "";
+		xml += "</a:tcTxStyle>";
+	}
+	if (region.border !== void 0 || region.fill !== void 0) {
+		xml += "<a:tcStyle>";
+		if (region.border !== void 0) xml += genXmlTableStyleBorders(region.border);
+		if (region.fill !== void 0) xml += `<a:fill><a:solidFill>${createColorElement(region.fill)}</a:solidFill></a:fill>`;
+		xml += "</a:tcStyle>";
+	}
+	xml += `</a:${name}>`;
+	return xml;
+}
+/**
+* Build the `tcBdr` border block for a custom table style region.
+* A single `BorderProps` styles all four sides plus the interior grid lines; a
+* TRBL array styles only the four outer sides. Sides are emitted in schema order.
+* @param {BorderProps | BorderProps[]} border - border definition
+* @return {string} XML
+*/
+function genXmlTableStyleBorders(border) {
+	let sides;
+	if (Array.isArray(border)) {
+		const [top, right, bottom, left] = border;
+		sides = [
+			["left", left],
+			["right", right],
+			["top", top],
+			["bottom", bottom]
+		];
+	} else sides = [
+		["left", border],
+		["right", border],
+		["top", border],
+		["bottom", border],
+		["insideH", border],
+		["insideV", border]
+	];
+	let xml = "<a:tcBdr>";
+	sides.forEach(([side, b]) => {
+		if (!b) return;
+		xml += `<a:${side}>`;
+		if (b.type === "none") xml += "<a:ln><a:noFill/></a:ln>";
+		else {
+			xml += `<a:ln w="${valToPts(b.pt ?? 1)}" cap="flat" cmpd="sng" algn="ctr">`;
+			xml += `<a:solidFill>${createColorElement(b.color ?? "666666")}</a:solidFill>`;
+			xml += `<a:prstDash val="${b.type === "dash" ? "sysDash" : "solid"}"/>`;
+			xml += "</a:ln>";
+		}
+		xml += `</a:${side}>`;
+	});
+	xml += "</a:tcBdr>";
+	return xml;
 }
 /**
 * Creates `ppt/viewProps.xml`
@@ -4823,7 +5079,7 @@ function makeXmlViewProps() {
 * @see https://docs.microsoft.com/en-us/office/open-xml/structure-of-a-presentationml-document
 * @see https://docs.microsoft.com/en-us/previous-versions/office/developer/office-2010/hh273476(v=office.14)
 */
-const VERSION = "5.1.0";
+const VERSION = "5.2.0";
 function standardLayoutToPresLayout(layout) {
 	return {
 		name: layout.name,
@@ -4924,6 +5180,14 @@ var PptxGenJS = class {
 	get title() {
 		return this._title;
 	}
+	/** Slide number shown on the first slide (maps to firstSlideNum in presentation.xml) */
+	_firstSlideNum;
+	set firstSlideNum(value) {
+		this._firstSlideNum = value;
+	}
+	get firstSlideNum() {
+		return this._firstSlideNum;
+	}
 	/**
 	* Whether Right-to-Left (RTL) mode is enabled
 	* @type {boolean}
@@ -4950,6 +5214,9 @@ var PptxGenJS = class {
 	get sections() {
 		return this._sections;
 	}
+	/** custom document properties stored in docProps/custom.xml */
+	_customProperties;
+	_tableStyles;
 	/** slide layout definition objects, used for generating slide layout files */
 	_slideLayouts;
 	get slideLayouts() {
@@ -4959,6 +5226,7 @@ var PptxGenJS = class {
 		return {
 			author: this.author,
 			company: this.company,
+			firstSlideNum: this.firstSlideNum,
 			layout: this.layout,
 			masterSlide: this._masterSlide,
 			presLayout: this.presLayout,
@@ -5043,6 +5311,7 @@ var PptxGenJS = class {
 			width: this.LAYOUTS[DEF_PRES_LAYOUT].width,
 			height: this.LAYOUTS[DEF_PRES_LAYOUT].height
 		};
+		this._firstSlideNum = 1;
 		this._rtlMode = false;
 		this._slideLayouts = [{
 			_margin: DEF_SLIDE_MARGIN_IN,
@@ -5058,6 +5327,8 @@ var PptxGenJS = class {
 		}];
 		this._slides = [];
 		this._sections = [];
+		this._customProperties = [];
+		this._tableStyles = [];
 		this._masterSlide = {
 			addChart: null,
 			addImage: null,
@@ -5086,7 +5357,8 @@ var PptxGenJS = class {
 	*/
 	addNewSlide = (options) => {
 		const nextOptions = options || {};
-		nextOptions.sectionTitle = this._sections.length > 0 && this._sections[this._sections.length - 1]._slides.some((slide) => slide._slideNum === this._slides[this._slides.length - 1]._slideNum) ? this._sections[this._sections.length - 1].title : null;
+		const lastSlide = this._slides[this._slides.length - 1];
+		nextOptions.sectionTitle = this._sections.find((sect) => sect._slides.some((s) => s._slideNum === lastSlide._slideNum))?.title ?? null;
 		return this.addSlide(nextOptions);
 	};
 	/**
@@ -5156,16 +5428,18 @@ var PptxGenJS = class {
 			zip.folder("ppt/theme");
 			zip.folder("ppt/notesMasters").folder("_rels");
 			zip.folder("ppt/notesSlides").folder("_rels");
-			zip.file("[Content_Types].xml", makeXmlContTypes(this._slides, this._slideLayouts, this._masterSlide));
-			zip.file("_rels/.rels", makeXmlRootRels());
+			const hasCustomProps = this._customProperties.length > 0;
+			zip.file("[Content_Types].xml", makeXmlContTypes(this._slides, this._slideLayouts, this._masterSlide, hasCustomProps));
+			zip.file("_rels/.rels", makeXmlRootRels(hasCustomProps));
 			zip.file("docProps/app.xml", makeXmlApp(this._slides, this.company));
 			zip.file("docProps/core.xml", makeXmlCore(this.title, this.subject, this.author, this.revision));
+			if (hasCustomProps) zip.file("docProps/custom.xml", makeXmlCustomProperties(this._customProperties));
 			zip.file("ppt/_rels/presentation.xml.rels", makeXmlPresentationRels(this._slides));
 			zip.file("ppt/theme/theme1.xml", makeXmlTheme(this.internalPresentation));
 			zip.file("ppt/theme/theme2.xml", makeXmlTheme(this.internalPresentation));
 			zip.file("ppt/presentation.xml", makeXmlPresentation(this.internalPresentation));
 			zip.file("ppt/presProps.xml", makeXmlPresProps());
-			zip.file("ppt/tableStyles.xml", makeXmlTableStyles());
+			zip.file("ppt/tableStyles.xml", makeXmlTableStyles(this._tableStyles));
 			zip.file("ppt/viewProps.xml", makeXmlViewProps());
 			this._slideLayouts.forEach((layout, idx) => {
 				zip.file(`ppt/slideLayouts/slideLayout${idx + 1}.xml`, makeXmlLayout(layout));
@@ -5245,6 +5519,19 @@ var PptxGenJS = class {
 		return await this._runtime.writeFile(fileName, data);
 	}
 	/**
+	* Set a custom document property stored in `docProps/custom.xml`.
+	* Calling with the same name replaces the existing value.
+	* @param name - property name
+	* @param value - string, integer/float number, boolean, or Date
+	*/
+	setCustomProperty(name, value) {
+		this._customProperties = this._customProperties.filter((p) => p.name !== name);
+		this._customProperties.push({
+			name,
+			value
+		});
+	}
+	/**
 	* Add a new Section to Presentation
 	* @param {ISectionProps} section - section properties
 	* @example pptx.addSection({ title:'Charts' });
@@ -5353,6 +5640,31 @@ var PptxGenJS = class {
 		if (newLayout._slideNumberProps && !this._masterSlide._slideNumberProps) this._masterSlide._slideNumberProps = newLayout._slideNumberProps;
 	}
 	/**
+	* Register a reusable custom table style and return its GUID.
+	* The style is written to `ppt/tableStyles.xml` and is editable in PowerPoint's
+	* Table Styles gallery. Pass the returned GUID as `TableProps.tableStyle`, and use
+	* the `has*` flags (`hasHeader`, `hasBandedRows`, …) to activate the matching regions.
+	* @param {TableStyleProps} props - custom table style definition (requires `name`)
+	* @returns {string} braced GUID to use as `tableStyle`
+	* @example
+	* const brand = pptx.defineTableStyle({
+	*   name: 'Brand Banded',
+	*   firstRow: { fill:'1A2B3C', color:'FFFFFF', bold:true },
+	*   band1H:   { fill:'EAF1F8' },
+	* })
+	* slide.addTable(rows, { tableStyle: brand, hasHeader:true, hasBandedRows:true })
+	*/
+	defineTableStyle(props) {
+		if (!props || typeof props !== "object") throw new Error("defineTableStyle() requires a `{ name, ... }` object argument");
+		if (!props.name || typeof props.name !== "string") throw new Error("defineTableStyle() requires a non-empty `name`");
+		const guid = `{${getUuid("xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx").toUpperCase()}}`;
+		this._tableStyles.push({
+			guid,
+			def: props
+		});
+		return guid;
+	}
+	/**
 	* Reproduces an HTML table as a PowerPoint table - including column widths, style, etc. - creates 1 or more slides as needed
 	* @param {string} eleId - table HTML element ID
 	* @param {TableToSlidesProps} options - generation options
@@ -5364,4 +5676,4 @@ var PptxGenJS = class {
 //#endregion
 export { PptxGenJS as t };
 
-//# sourceMappingURL=pptxgen-3gNqxx8n.js.map
+//# sourceMappingURL=pptxgen--5RWzhb4.js.map