@shbernal/pptxgenjs 5.1.0 → 5.3.0

package/dist/{pptxgen-3gNqxx8n.js → pptxgen-B-mAxCRC.js}

@@ -1,32 +1,25 @@
-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 coordToEmu, i as STANDARD_LAYOUTS, l as inchesToEmu, o as emuToInches } from "./units-BMrBTU0-.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, et as VALID_SHAPE_PRESETS, 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-BFXQk67T.js";
 import JSZip from "jszip";
 //#region src/gen-utils.ts
 /**
 * PptxGenJS: Utility Methods
 */
 /**
-* Translates any type of `x`/`y`/`w`/`h` prop to EMU
-* - guaranteed to return a result regardless of undefined, null, etc. (0)
-* - {number} - 12800 (EMU)
-* - {number} - 0.5 (inches)
-* - {string} - "75%"
-* @param {number|string} size - numeric ("5.5") or percentage ("90%")
-* @param {'X' | 'Y'} xyDir - direction
-* @param {PresLayout} layout - presentation layout
-* @returns {number} calculated size
+* Resolve a user `Coord` (x/y/w/h) to EMU — the single user-coordinate → EMU boundary.
+* - bare `number` → **inches** (no magnitude guessing); `"<n>%"` → percent of the slide axis;
+*   `"<n>in"`/`"<n>pt"`/`"<n>emu"` → explicit units (see {@link Coord} / {@link coordToEmu})
+* - `null`/`undefined` → 0 (callers may omit a coordinate)
+* - throws on a non-finite number rather than silently collapsing the object to zero size
+* @param {Coord|null|undefined} size - user coordinate
+* @param {'X' | 'Y'} xyDir - axis (selects slide width vs height for percentages)
+* @param {PresLayout} layout - presentation layout (EMU dimensions)
+* @returns {Emu} resolved EMU value
 */
 function getSmartParseNumber(size, xyDir, layout) {
-	if (typeof size === "string" && !isNaN(Number(size))) size = Number(size);
+	if (size === null || size === void 0) return 0;
 	if (typeof size === "number" && !isFinite(size)) throw new Error(`Invalid ${xyDir || "coordinate"} value: expected a finite number but received ${String(size)}. This usually means a layout dimension was read from a missing property (e.g. \`layout.width\` returning \`undefined\`). Use \`slide.width\`/\`slide.height\` or \`STANDARD_LAYOUTS.<NAME>.width\`/\`.height\` (inches).`);
-	if (typeof size === "number" && size < 100) return inch2Emu(size);
-	if (typeof size === "number" && size >= 100) return size;
-	if (typeof size === "string" && size.includes("%")) {
-		if (xyDir && xyDir === "X") return Math.round(parseFloat(size) / 100 * layout.width);
-		if (xyDir && xyDir === "Y") return Math.round(parseFloat(size) / 100 * layout.height);
-		return Math.round(parseFloat(size) / 100 * layout.width);
-	}
-	return 0;
+	return coordToEmu(size, xyDir === "Y" ? layout.height : layout.width);
 }
 /**
 * Basic UUID Generator Adapted
@@ -99,14 +92,16 @@ function getDuplicateObjectNames(names) {
 	return Array.from(dupes);
 }
 /**
-* Convert inches into EMU
-* @param {number|string} inches - as string or number
-* @returns {number} EMU value
+* Convert inches into EMU.
+* - accepts a number (inches) or a numeric/`"<n>in"` string
+* - no magnitude guessing: values are always treated as inches (use {@link coordToEmu} for
+*   user coordinates that may carry other units)
+* @param {number|string} inches - inches as number or string
+* @returns {Emu} EMU value
 */
 function inch2Emu(inches) {
-	if (typeof inches === "number" && inches > 100) return inches;
 	if (typeof inches === "string") inches = Number(inches.replace(/in*/gi, ""));
-	return Math.round(EMU * inches);
+	return inchesToEmu(inches);
 }
 /**
 * Convert `pt` into points (using `ONEPT`)
@@ -118,6 +113,33 @@ function valToPts(pt) {
 	return isNaN(points) ? 0 : Math.round(points * ONEPT);
 }
 /**
+* Convert a transparency percentage (0-100) into a schema-valid `<a:alpha>` value
+* (ST_PositiveFixedPercentage, 0-100000). Out-of-range transparency yields an
+* alpha that PowerPoint rejects as needing repair, so clamp into range and warn.
+*/
+function transparencyToAlpha(transparency) {
+	const pct = Math.min(100, Math.max(0, transparency));
+	if (pct !== transparency) console.warn(`Warning: transparency ${transparency} is outside the valid range 0-100; using ${pct}.`);
+	return Math.round((100 - pct) * 1e3);
+}
+/** Convert an opacity (0-1) into a schema-valid `<a:alpha>` value (0-100000); clamps + warns on out-of-range input. */
+function opacityToAlpha(opacity) {
+	const o = Math.min(1, Math.max(0, opacity));
+	if (o !== opacity) console.warn(`Warning: opacity ${opacity} is outside the valid range 0-1; using ${o}.`);
+	return Math.round(o * 1e5);
+}
+/**
+* Convert a line width (points) to EMU clamped into ST_LineWidth (0..20116800 EMU,
+* i.e. 0-1584pt). Out-of-range widths make PowerPoint report the package as needing
+* repair, so clamp into range and warn.
+*/
+function lineWidthToEmu(widthPts) {
+	const raw = valToPts(widthPts);
+	const clamped = Math.min(20116800, Math.max(0, raw));
+	if (clamped !== raw) console.warn(`Warning: line width ${widthPts} is outside the valid range 0-1584pt; using ${clamped / ONEPT}.`);
+	return clamped;
+}
+/**
 * Convert degrees (0..360) to PowerPoint `rot` value
 * @param {number} d degrees
 * @returns {number} calculated `rot` value
@@ -165,8 +187,10 @@ function createColorElement(colorStr, innerElements) {
 	}
 	let colorVal = (colorStr || "").replace("#", "");
 	if (/^[0-9a-fA-F]{8}$/.test(colorVal)) {
-		const alphaHex = colorVal.slice(6, 8);
-		innerElements = `<a:alpha val="${Math.round(parseInt(alphaHex, 16) / 255 * 1e5)}"/>${innerElements || ""}`;
+		if (!innerElements?.includes("<a:alpha")) {
+			const alphaHex = colorVal.slice(6, 8);
+			innerElements = `<a:alpha val="${Math.round(parseInt(alphaHex, 16) / 255 * 1e5)}"/>${innerElements || ""}`;
+		}
 		colorVal = colorVal.slice(0, 6);
 	}
 	if (!REGEX_HEX_COLOR.test(colorVal) && colorVal !== "bg1" && colorVal !== "bg2" && colorVal !== "tx1" && colorVal !== "tx2" && colorVal !== "accent1" && colorVal !== "accent2" && colorVal !== "accent3" && colorVal !== "accent4" && colorVal !== "accent5" && colorVal !== "accent6") {
@@ -192,12 +216,38 @@ function createGlowElement(options, defaults) {
 	};
 	const size = Math.round(opts.size * ONEPT);
 	const color = opts.color || "000000";
-	const opacity = Math.round((opts.opacity ?? 0) * 1e5);
+	const opacity = opacityToAlpha(opts.opacity ?? 0);
 	strXml += `<a:glow rad="${size}">`;
 	strXml += createColorElement(color, `<a:alpha val="${opacity}"/>`);
 	strXml += "</a:glow>";
 	return strXml;
 }
+/**
+* Creates an `a:outerShdw`/`a:innerShdw` element for a text run or shape.
+* Returns the shadow element only (no wrapping `a:effectLst`) so callers can
+* combine it with other effects (e.g. glow) inside a single `a:effectLst`.
+* @param {ShadowProps} options shadow properties
+* @param {ShadowProps} defaults defaults for unspecified properties in `options`
+* @see http://officeopenxml.com/drwSp-effects.php
+* @returns {string} XML string, or '' when type is 'none'
+*/
+function createShadowElement$1(options, defaults) {
+	const opts = {
+		...defaults,
+		...options
+	};
+	if (opts.type === "none") return "";
+	const type = opts.type || "outer";
+	const blur = valToPts(opts.blur ?? 0);
+	const offset = valToPts(opts.offset ?? 0);
+	const angle = Math.round((opts.angle ?? 0) * 6e4);
+	const opacity = Math.round((opts.opacity ?? .75) * 1e5);
+	const color = opts.color || "000000";
+	let strXml = `<a:${type}Shdw ${type === "outer" ? "sx=\"100000\" sy=\"100000\" kx=\"0\" ky=\"0\" algn=\"bl\" rotWithShape=\"0\" " : ""}blurRad="${blur}" dist="${offset}" dir="${angle}">`;
+	strXml += createColorElement(color, `<a:alpha val="${opacity}"/>`);
+	strXml += `</a:${type}Shdw>`;
+	return strXml;
+}
 function boolToXml(value) {
 	return value ? "1" : "0";
 }
@@ -208,8 +258,8 @@ function normalizeGradientAngle(angle) {
 }
 function gradientStopColorAdjustments(stop) {
 	let internalElements = "";
-	if (stop.alpha) internalElements += `<a:alpha val="${Math.round((100 - stop.alpha) * 1e3)}"/>`;
-	if (stop.transparency) internalElements += `<a:alpha val="${Math.round((100 - stop.transparency) * 1e3)}"/>`;
+	if (stop.alpha) internalElements += `<a:alpha val="${transparencyToAlpha(stop.alpha)}"/>`;
+	if (stop.transparency) internalElements += `<a:alpha val="${transparencyToAlpha(stop.transparency)}"/>`;
 	return internalElements;
 }
 function normalizeGradientStops(stops) {
@@ -244,10 +294,32 @@ 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
 */
+/**
+* Map a friendly `LineCap` value to the OOXML `cap` attribute value (`flat`/`sq`/`rnd`).
+* @param {LineCap} [lineCap] - line cap style (defaults to `flat`)
+* @returns {string} value for the `cap` attribute on `<a:ln>`
+*/
+function createLineCap(lineCap) {
+	if (!lineCap || lineCap === "flat") return "flat";
+	else if (lineCap === "square") return "sq";
+	else if (lineCap === "round") return "rnd";
+	else throw new Error(`Invalid line cap: ${String(lineCap)}`);
+}
 function genXmlColorSelection(props) {
 	let fillType = "solid";
 	let colorVal = "";
@@ -258,8 +330,8 @@ function genXmlColorSelection(props) {
 		else {
 			if (props.type) fillType = props.type;
 			if (props.color) colorVal = props.color;
-			if (props.alpha) internalElements += `<a:alpha val="${Math.round((100 - props.alpha) * 1e3)}"/>`;
-			if (props.transparency) internalElements += `<a:alpha val="${Math.round((100 - props.transparency) * 1e3)}"/>`;
+			if (props.alpha) internalElements += `<a:alpha val="${transparencyToAlpha(props.alpha)}"/>`;
+			if (props.transparency) internalElements += `<a:alpha val="${transparencyToAlpha(props.transparency)}"/>`;
 		}
 		switch (fillType) {
 			case "solid":
@@ -268,6 +340,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 +408,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 +578,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 +741,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 +762,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 +859,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 +903,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);
@@ -711,6 +925,28 @@ function getSlidesForTableRows(tableRows = [], tableProps = {}, presLayout, mast
 	return tableRowSlides;
 }
 /**
+* Convert a computed CSS border (width string + color string) from `getComputedStyle` into a
+* pptx `BorderProps`.
+*
+* Preserves *fractional* widths: a hairline CSS border such as `0.5px` must not be rounded to
+* `0pt` and silently vanish — the table serializer (`valToPts`) emits fractional points just
+* fine, so there is no reason to integer-round here (upstream gitbrent/PptxGenJS#1235). A
+* computed width of `0` (or a non-finite value) yields `{ type: 'none' }` so we never emit a
+* zero-width line.
+* @param {string} widthStr - computed `border-<side>-width`, e.g. `"0.5px"`
+* @param {string} colorStr - computed `border-<side>-color`, e.g. `"rgb(102, 102, 102)"`
+* @returns {BorderProps} border props for the cell side
+*/
+function htmlBorderToProps(widthStr, colorStr) {
+	const pt = Number(String(widthStr).replace("px", ""));
+	if (!isFinite(pt) || pt <= 0) return { type: "none" };
+	const arrRGB = String(colorStr).replace(/\s+/gi, "").replace("rgba(", "").replace("rgb(", "").replace(")", "").split(",");
+	return {
+		pt,
+		color: rgbToHex(Number(arrRGB[0]), Number(arrRGB[1]), Number(arrRGB[2]))
+	};
+}
+/**
 * Reproduces an HTML table as a PowerPoint table - including column widths, style, etc. - creates 1 or more slides as needed
 * @param {TableToSlidesHost} pptx - pptxgenjs instance
 * @param {string} tabEleId - HTMLElementID of the table
@@ -858,12 +1094,8 @@ function genTableToSlides(pptx, tabEleId, options = {}, masterSlide) {
 						"bottom",
 						"left"
 					].forEach((val, idxb) => {
-						const intBorderW = Math.round(Number(window.getComputedStyle(cell).getPropertyValue("border-" + val + "-width").replace("px", "")));
-						const arrRGB = window.getComputedStyle(cell).getPropertyValue("border-" + val + "-color").replace(/\s+/gi, "").replace("rgba(", "").replace("rgb(", "").replace(")", "").split(",");
-						cellBorder[idxb] = {
-							pt: intBorderW,
-							color: rgbToHex(Number(arrRGB[0]), Number(arrRGB[1]), Number(arrRGB[2]))
-						};
+						const style = window.getComputedStyle(cell);
+						cellBorder[idxb] = htmlBorderToProps(style.getPropertyValue("border-" + val + "-width"), style.getPropertyValue("border-" + val + "-color"));
 					});
 					cellOpts.border = cellBorder;
 				}
@@ -933,6 +1165,8 @@ function genTableToSlides(pptx, tabEleId, options = {}, masterSlide) {
 */
 /** counter for included charts (used for index in their filenames) */
 let _chartCounter = 0;
+/** DPI PowerPoint assumes when sizing an inserted raster image (natural pixels / 96 == inches) */
+const IMAGE_NATURAL_DPI = 96;
 function normalizeBorderTuple(border) {
 	return Array.isArray(border) ? border : [
 		border,
@@ -954,6 +1188,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;
@@ -968,6 +1203,26 @@ function createSlideMaster(props, target) {
 	if (props.slideNumber && typeof props.slideNumber === "object") target._slideNumberProps = props.slideNumber;
 }
 /**
+* Round and clamp an integer chart percentage/angle option into a schema-valid range.
+*
+* Several chart attributes are bounded integer types whose out-of-range values make
+* PowerPoint report the package as needing repair: `<c:overlap>` (ST_Overlap, -100..100),
+* `<c:gapWidth>`/`<c:gapDepth>` (ST_GapAmount, 0..500), `<c:holeSize>` (ST_HoleSize, 10..90)
+* and `<c:firstSliceAng>` (ST_FirstSliceAng, 0..360). Missing/non-numeric input returns
+* `undefined` so the caller can apply its own default; an out-of-range value is clamped
+* and a warning is emitted (per the library's warn-rather-than-degrade policy).
+* @param value - caller-supplied option value
+* @param min - inclusive lower bound
+* @param max - inclusive upper bound
+* @param name - option name, for the warning message
+*/
+function clampChartPct(value, min, max, name) {
+	if (typeof value !== "number" || isNaN(value)) return void 0;
+	const clamped = Math.min(max, Math.max(min, Math.round(value)));
+	if (clamped !== value) console.warn(`Warning: ${name} ${value} is outside the valid range ${min}-${max}; using ${clamped}.`);
+	return clamped;
+}
+/**
 * Generate the chart based on input data.
 * OOXML Chart Spec: ISO/IEC 29500-1:2016(E)
 *
@@ -1139,7 +1394,13 @@ function addChartDefinition(target, type, data, opt) {
 		"marker",
 		"filled"
 	].includes(options.radarStyle || "")) options.radarStyle = "standard";
-	options.lineDataSymbolSize = options.lineDataSymbolSize && !isNaN(options.lineDataSymbolSize) ? options.lineDataSymbolSize : 6;
+	{
+		const rawSymbolSize = options.lineDataSymbolSize;
+		const hasSymbolSize = rawSymbolSize != null && !isNaN(rawSymbolSize);
+		const symbolSize = Math.min(72, Math.max(2, Math.round(hasSymbolSize ? rawSymbolSize : 6)));
+		if (hasSymbolSize && symbolSize !== rawSymbolSize) console.warn(`Warning: lineDataSymbolSize ${rawSymbolSize} is outside the valid marker size range (integer 2-72); using ${symbolSize}.`);
+		options.lineDataSymbolSize = symbolSize;
+	}
 	options.lineDataSymbolLineSize = options.lineDataSymbolLineSize && !isNaN(options.lineDataSymbolLineSize) ? valToPts(options.lineDataSymbolLineSize) : valToPts(.75);
 	const chartLayout = options.layout;
 	if (chartLayout) [
@@ -1189,8 +1450,11 @@ function addChartDefinition(target, type, data, opt) {
 	options.v3DRotY = typeof options.v3DRotY === "number" && !isNaN(options.v3DRotY) && options.v3DRotY >= 0 && options.v3DRotY <= 360 ? options.v3DRotY : 30;
 	options.v3DRAngAx = options.v3DRAngAx || !options.v3DRAngAx ? options.v3DRAngAx : true;
 	options.v3DPerspective = typeof options.v3DPerspective === "number" && !isNaN(options.v3DPerspective) && options.v3DPerspective >= 0 && options.v3DPerspective <= 240 ? options.v3DPerspective : 30;
-	options.barGapWidthPct = typeof options.barGapWidthPct === "number" && !isNaN(options.barGapWidthPct) && options.barGapWidthPct >= 0 && options.barGapWidthPct <= 1e3 ? options.barGapWidthPct : 150;
-	options.barGapDepthPct = typeof options.barGapDepthPct === "number" && !isNaN(options.barGapDepthPct) && options.barGapDepthPct >= 0 && options.barGapDepthPct <= 1e3 ? options.barGapDepthPct : 150;
+	options.barGapWidthPct = clampChartPct(options.barGapWidthPct, 0, 500, "barGapWidthPct") ?? 150;
+	options.barGapDepthPct = clampChartPct(options.barGapDepthPct, 0, 500, "barGapDepthPct") ?? 150;
+	options.barOverlapPct = clampChartPct(options.barOverlapPct, -100, 100, "barOverlapPct");
+	options.holeSize = clampChartPct(options.holeSize, 10, 90, "holeSize");
+	options.firstSliceAng = clampChartPct(options.firstSliceAng, 0, 360, "firstSliceAng");
 	options.chartColors = Array.isArray(options.chartColors) ? options.chartColors : options._type === "pie" || options._type === "doughnut" ? PIECHART_COLORS : BARCHART_COLORS;
 	options.chartColorsOpacity = options.chartColorsOpacity && !isNaN(options.chartColorsOpacity) ? options.chartColorsOpacity : void 0;
 	options.border = options.border && typeof options.border === "object" ? options.border : void 0;
@@ -1279,23 +1543,38 @@ function addImageDefinition(target, opt) {
 	else if (strImageData?.toLowerCase().includes("image/svg+xml")) strImgExtn = "svg";
 	newObject._type = "image";
 	newObject.image = strImagePath || "preencoded.png";
+	let defWidth = intWidth;
+	let defHeight = intHeight;
+	if ((!intWidth || !intHeight) && strImageData && strImgExtn !== "svg") {
+		const natural = getImageSizeFromBase64(strImageData);
+		if (natural) {
+			if (!intWidth && !intHeight) {
+				defWidth = natural.w / IMAGE_NATURAL_DPI;
+				defHeight = natural.h / IMAGE_NATURAL_DPI;
+			} else if (typeof intWidth === "number" && intWidth && !intHeight) defHeight = intWidth * (natural.h / natural.w);
+			else if (typeof intHeight === "number" && intHeight && !intWidth) defWidth = intHeight * (natural.w / natural.h);
+		}
+	}
 	const objectOptions = {
 		x: intPosX || 0,
 		y: intPosY || 0,
-		w: intWidth || 1,
-		h: intHeight || 1,
+		w: defWidth || 1,
+		h: defHeight || 1,
 		altText: opt.altText || "",
 		rounding: typeof opt.rounding === "boolean" ? opt.rounding : false,
 		shape: opt.shape,
 		points: opt.points,
 		rectRadius: opt.rectRadius,
+		shapeAdjust: opt.shapeAdjust,
 		sizing,
 		placeholder: opt.placeholder,
 		rotate: opt.rotate || 0,
 		flipV: opt.flipV || false,
 		flipH: opt.flipH || false,
 		transparency: opt.transparency || 0,
+		duotone: opt.duotone,
 		objectName,
+		objectLock: opt.objectLock,
 		shadow: correctShadowOptions(opt.shadow)
 	};
 	newObject.options = objectOptions;
@@ -1325,7 +1604,10 @@ function addImageDefinition(target, opt) {
 		});
 		newObject.imageRid = imageRelId + 1;
 	} else {
-		const dupeItem = target._relsMedia.find((item) => item.path && item.path === strImagePath && item.type === "image/" + strImgExtn && !item.isDuplicate);
+		const dupeItem = target._relsMedia.find((item) => {
+			if (item.isDuplicate || !item.Target || item.type !== "image/" + strImgExtn) return false;
+			return strImagePath ? item.path === strImagePath : !!strImageData && item.data === strImageData;
+		});
 		target._relsMedia.push({
 			path: strImagePath || "preencoded." + strImgExtn,
 			type: "image/" + strImgExtn,
@@ -1344,7 +1626,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;
@@ -1383,6 +1665,7 @@ function addMediaDefinition(target, opt) {
 	slideData.options.h = intSizeY;
 	slideData.options.objectName = objectName;
 	if (opt.altText) slideData.options.altText = opt.altText;
+	if (opt.objectLock) slideData.options.objectLock = opt.objectLock;
 	/**
 	* NOTE:
 	* - rId starts at 2 (hence the intRels+1 below) as slideLayout.xml is rId=1!
@@ -1412,7 +1695,10 @@ function addMediaDefinition(target, opt) {
 			Target: `../media/image-${target._slideNum}-${target._relsMedia.length + 1}.png`
 		});
 	} else {
-		const dupeItem = target._relsMedia.find((item) => item.path && item.path === strPath && item.type === strType + "/" + strExtn && !item.isDuplicate);
+		const dupeItem = target._relsMedia.find((item) => {
+			if (item.isDuplicate || !item.Target || item.type !== strType + "/" + strExtn) return false;
+			return strPath ? item.path === strPath : !!strData && item.data === strData;
+		});
 		const relId1 = getNewRelId(target);
 		target._relsMedia.push({
 			path: strPath || "preencoded" + strExtn,
@@ -1477,12 +1763,14 @@ function addShapeDefinition(target, shapeName, opts) {
 	const options = typeof opts === "object" ? opts : {};
 	options.line = options.line || { type: "none" };
 	options.shadow = correctShadowOptions(options.shadow);
+	const resolvedShapeName = typeof shapeName === "string" && SHAPE_NAME_ALIASES[shapeName] ? SHAPE_NAME_ALIASES[shapeName] : shapeName;
 	const newObject = {
 		_type: "text",
-		shape: (typeof shapeName === "string" && SHAPE_NAME_ALIASES[shapeName] ? SHAPE_NAME_ALIASES[shapeName] : shapeName) || "rect",
+		shape: resolvedShapeName || "rect",
 		options
 	};
 	if (!shapeName) throw new Error("Missing/Invalid shape parameter! Example: `addShape(pptxgen.shapes.LINE, {x:1, y:1, w:1, h:1});`");
+	if (!VALID_SHAPE_PRESETS.has(resolvedShapeName)) throw new Error(`Invalid shape "${String(shapeName)}"! Use a value from \`pptxgen.shapes.*\` (e.g. \`pptxgen.shapes.RECTANGLE\`). PowerPoint can't render unknown preset geometries and will drop the shape during repair.`);
 	const newLineOpts = {
 		type: options.line.type || "solid",
 		color: options.line.color || "333333",
@@ -1579,9 +1867,8 @@ function addTableDefinition(target, tableRows, options, slideLayout, presLayout,
 		}
 		arrRows.push(newRow);
 	});
-	opt.x = getSmartParseNumber(opt.x || (opt.x === 0 ? 0 : EMU / 2), "X", presLayout);
-	opt.y = getSmartParseNumber(opt.y || (opt.y === 0 ? 0 : EMU / 2), "Y", presLayout);
-	if (opt.h) opt.h = getSmartParseNumber(opt.h, "Y", presLayout);
+	if (opt.x === void 0 || opt.x === null) opt.x = .5;
+	if (opt.y === void 0 || opt.y === null) opt.y = .5;
 	opt.fontSize = opt.fontSize || 12;
 	opt.margin = opt.margin === 0 || opt.margin ? opt.margin : DEF_CELL_MARGIN_IN;
 	if (typeof opt.margin === "number") opt.margin = [
@@ -1650,12 +1937,7 @@ function addTableDefinition(target, tableRows, options, slideLayout, presLayout,
 			console.warn("addTable: mismatch: (colW.length != data.length) Therefore, defaulting to evenly distributed col widths.");
 			opt.colW = void 0;
 		}
-	} else if (opt.w) opt.w = getSmartParseNumber(opt.w, "X", presLayout);
-	else opt.w = Math.floor((presLayout._sizeW || presLayout.width) / EMU - arrTableMargin[1] - arrTableMargin[3]);
-	if (opt.x && opt.x < 20) opt.x = inch2Emu(opt.x);
-	if (opt.y && opt.y < 20) opt.y = inch2Emu(opt.y);
-	if (opt.w && typeof opt.w === "number" && opt.w < 20) opt.w = inch2Emu(opt.w);
-	if (opt.h && typeof opt.h === "number" && opt.h < 20) opt.h = inch2Emu(opt.h);
+	} else if (opt.w) {} else opt.w = Math.floor((presLayout._sizeW || presLayout.width) / EMU - arrTableMargin[1] - arrTableMargin[3]);
 	arrRows.forEach((row) => {
 		row.forEach((cell, idy) => {
 			if (typeof cell === "number" || typeof cell === "string") row[idy] = {
@@ -1683,7 +1965,7 @@ function addTableDefinition(target, tableRows, options, slideLayout, presLayout,
 		if (opt.autoPageRepeatHeader) opt._arrObjTabHeadRows = arrRows.filter((_row, idx) => idx < (opt.autoPageHeaderRows || 1));
 		getSlidesForTableRows(arrRows, opt, presLayout, slideLayout).forEach((slide, idx) => {
 			if (!getSlide(target._slideNum + idx)) slides.push(addSlide({ masterName: slideLayout?._name || void 0 }));
-			if (idx > 0) opt.y = inch2Emu(opt.autoPageSlideStartY || opt.newSlideStartY || arrTableMargin[0]);
+			if (idx > 0) opt.y = opt.autoPageSlideStartY || opt.newSlideStartY || arrTableMargin[0];
 			{
 				const newSlide = getSlide(target._slideNum + idx);
 				opt.autoPage = false;
@@ -1755,6 +2037,10 @@ function addTextDefinition(target, text, opts, isPlaceholder) {
 		itemOpts._bodyProp.anchor = !itemOpts.placeholder ? "ctr" : void 0;
 		itemOpts._bodyProp.vert = itemOpts.vert;
 		itemOpts._bodyProp.wrap = typeof itemOpts.wrap === "boolean" ? itemOpts.wrap : true;
+		if (itemOpts.columns !== void 0) if (typeof itemOpts.columns !== "number" || isNaN(itemOpts.columns) || itemOpts.columns < 1 || itemOpts.columns > 16) console.warn("Warning: text `columns` must be a number 1-16 (ignoring value)");
+		else itemOpts._bodyProp.numCol = Math.round(itemOpts.columns);
+		if (itemOpts.columnSpacing !== void 0) if (typeof itemOpts.columnSpacing !== "number" || isNaN(itemOpts.columnSpacing) || itemOpts.columnSpacing < 0) console.warn("Warning: text `columnSpacing` must be a number >= 0 (ignoring value)");
+		else itemOpts._bodyProp.spcCol = valToPts(itemOpts.columnSpacing);
 		if (itemOpts.inset && !isNaN(Number(itemOpts.inset)) || itemOpts.inset === 0) {
 			itemOpts._bodyProp.lIns = inch2Emu(itemOpts.inset);
 			itemOpts._bodyProp.rIns = inch2Emu(itemOpts.inset);
@@ -2102,7 +2388,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 +2456,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 +2508,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>";
 					}
 				}
@@ -2318,6 +2550,22 @@ async function createExcelWorksheet(chartObject, zip) {
 	});
 }
 /**
+* Emit the `<a:latin>/<a:ea>/<a:cs>` font trio for a chart text run.
+*
+* In DrawingML run properties a typeface applies only to the script class of
+* its element: `<a:latin>` covers Latin/ASCII, `<a:ea>` covers East Asian, and
+* `<a:cs>` covers complex scripts. Emitting `<a:latin>` alone leaves East Asian
+* (e.g. Chinese) and complex-script glyphs falling back to the theme font, so a
+* user-specified font never takes effect for that text — most visibly on
+* PowerPoint for Mac. Stamping the same typeface onto all three classes is what
+* choosing a font in PowerPoint's UI does (upstream gitbrent/PptxGenJS#1420).
+* @param {string} typeface - font face name
+* @return {string} `<a:latin/><a:ea/><a:cs/>` XML
+*/
+function createChartTextFonts(typeface) {
+	return `<a:latin typeface="${typeface}"/><a:ea typeface="${typeface}"/><a:cs typeface="${typeface}"/>`;
+}
+/**
 * Main entry point method for create charts
 * @see: http://www.datypic.com/sc/ooxml/s-dml-chart.xsd.html
 * @param {ISlideRelChart} rel - chart object
@@ -2327,6 +2575,10 @@ function makeXmlCharts(rel) {
 	let strXml = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>";
 	let usesSecondaryValAxis = false;
 	let usesSecondaryCatAxis = false;
+	let primaryCatAxisValType = null;
+	let secondaryCatAxisValType = null;
+	let primaryCatAxisHasCategoryChart = false;
+	let secondaryCatAxisHasCategoryChart = false;
 	strXml += "<c:chartSpace xmlns:c=\"http://schemas.openxmlformats.org/drawingml/2006/chart\" xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\" xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\">";
 	strXml += "<c:date1904 val=\"0\"/>";
 	strXml += `<c:roundedCorners val="${rel.opts.chartArea.roundedCorners ? "1" : "0"}"/>`;
@@ -2339,6 +2591,8 @@ function makeXmlCharts(rel) {
 			fontSize: rel.opts.titleFontSize || 18,
 			titleAlign: rel.opts.titleAlign,
 			titleBold: rel.opts.titleBold,
+			titleItalic: rel.opts.titleItalic,
+			titleUnderline: rel.opts.titleUnderline,
 			titlePos: rel.opts.titlePos,
 			titleRotate: rel.opts.titleRotate
 		}, rel.opts.x, rel.opts.y);
@@ -2371,18 +2625,37 @@ function makeXmlCharts(rel) {
 		const catAxisId = options.secondaryCatAxis ? AXIS_ID_CATEGORY_SECONDARY : AXIS_ID_CATEGORY_PRIMARY;
 		usesSecondaryValAxis = usesSecondaryValAxis || options.secondaryValAxis;
 		usesSecondaryCatAxis = usesSecondaryCatAxis || options.secondaryCatAxis;
+		const usesValueXAxis = type.type === "scatter" || type.type === "bubble" || type.type === "bubble3D";
+		if (options.secondaryCatAxis) if (usesValueXAxis) secondaryCatAxisValType = type.type;
+		else secondaryCatAxisHasCategoryChart = true;
+		else if (usesValueXAxis) primaryCatAxisValType = type.type;
+		else primaryCatAxisHasCategoryChart = true;
 		strXml += makeChartType(type.type, type.data, options, valAxisId, catAxisId);
 	});
 	else strXml += makeChartType(rel.opts._type, rel.data, rel.opts, AXIS_ID_VALUE_PRIMARY, AXIS_ID_CATEGORY_PRIMARY);
 	if (rel.opts._type !== "pie" && rel.opts._type !== "doughnut") {
 		if (rel.opts.valAxes && rel.opts.valAxes.length > 1 && !usesSecondaryValAxis) throw new Error("Secondary axis must be used by one of the multiple charts");
+		const comboCatAxisType = (isSecondary) => {
+			const valType = isSecondary ? secondaryCatAxisValType : primaryCatAxisValType;
+			const hasCategoryChart = isSecondary ? secondaryCatAxisHasCategoryChart : primaryCatAxisHasCategoryChart;
+			if (!valType) return {};
+			if (hasCategoryChart) {
+				console.warn(`A category-based chart and a scatter/bubble chart cannot share the same ${isSecondary ? "secondary" : "primary"} category axis; emitting a category axis. Put the scatter/bubble series on a separate axis.`);
+				return {};
+			}
+			return { _type: valType };
+		};
 		if (rel.opts.catAxes) {
 			if (!rel.opts.valAxes || rel.opts.valAxes.length !== rel.opts.catAxes.length) throw new Error("There must be the same number of value and category axes.");
 			strXml += makeCatAxis({
 				...rel.opts,
-				...rel.opts.catAxes[0]
+				...rel.opts.catAxes[0],
+				...comboCatAxisType(false)
 			}, AXIS_ID_CATEGORY_PRIMARY, AXIS_ID_VALUE_PRIMARY);
-		} else strXml += makeCatAxis(rel.opts, AXIS_ID_CATEGORY_PRIMARY, AXIS_ID_VALUE_PRIMARY);
+		} else strXml += makeCatAxis({
+			...rel.opts,
+			...comboCatAxisType(false)
+		}, AXIS_ID_CATEGORY_PRIMARY, AXIS_ID_VALUE_PRIMARY);
 		if (rel.opts.valAxes) {
 			strXml += makeValAxis({
 				...rel.opts,
@@ -2399,9 +2672,13 @@ function makeXmlCharts(rel) {
 		}
 		if (rel.opts?.catAxes && rel.opts?.catAxes[1]) strXml += makeCatAxis({
 			...rel.opts,
-			...rel.opts.catAxes[1]
+			...rel.opts.catAxes[1],
+			...comboCatAxisType(true)
+		}, AXIS_ID_CATEGORY_SECONDARY, AXIS_ID_VALUE_SECONDARY);
+		else if (usesSecondaryCatAxis && (!rel.opts.catAxes || !rel.opts.catAxes[1])) strXml += makeCatAxis({
+			...rel.opts,
+			...comboCatAxisType(true)
 		}, AXIS_ID_CATEGORY_SECONDARY, AXIS_ID_VALUE_SECONDARY);
-		else if (usesSecondaryCatAxis && (!rel.opts.catAxes || !rel.opts.catAxes[1])) strXml += makeCatAxis(rel.opts, AXIS_ID_CATEGORY_SECONDARY, AXIS_ID_VALUE_SECONDARY);
 	}
 	if (rel.opts.showDataTable) {
 		strXml += "<c:dTable>";
@@ -2440,6 +2717,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>";
@@ -2449,8 +2733,7 @@ function makeXmlCharts(rel) {
 			strXml += "    <a:pPr>";
 			strXml += rel.opts.legendFontSize ? `<a:defRPr sz="${Math.round(Number(rel.opts.legendFontSize) * 100)}">` : "<a:defRPr>";
 			if (rel.opts.legendColor) strXml += genXmlColorSelection(rel.opts.legendColor);
-			if (rel.opts.legendFontFace) strXml += "<a:latin typeface=\"" + rel.opts.legendFontFace + "\"/>";
-			if (rel.opts.legendFontFace) strXml += "<a:cs    typeface=\"" + rel.opts.legendFontFace + "\"/>";
+			if (rel.opts.legendFontFace) strXml += createChartTextFonts(rel.opts.legendFontFace);
 			strXml += "      </a:defRPr>";
 			strXml += "    </a:pPr>";
 			strXml += "    <a:endParaRPr lang=\"en-US\"/>";
@@ -2488,6 +2771,7 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 	let idxColLtr = 1;
 	let optsChartData;
 	let strXml = "";
+	const valFmtCode = encodeXmlEntities(opts.valLabelFormatCode || opts.dataTableFormatCode || opts.dataLabelFormatCode || "General");
 	switch (chartType) {
 		case "area":
 		case "bar":
@@ -2515,20 +2799,23 @@ 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\"/>";
+				if (chartType === "bar" || chartType === "bar3D") strXml += "  <c:invertIfNegative val=\"0\"/>";
 				if (chartType === "line" || chartType === "radar") {
 					strXml += "<c:marker>";
 					strXml += "  <c:symbol val=\"" + opts.lineDataSymbol + "\"/>";
@@ -2543,14 +2830,26 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 					strXml += "  </c:spPr>";
 					strXml += "</c:marker>";
 				}
+				{
+					const barVaryColors = (chartType === "bar" || chartType === "bar3D") && data.length === 1 && (opts.chartColors && opts.chartColors !== BARCHART_COLORS && opts.chartColors.length > 1 || opts.invertedColors?.length) ? opts.chartColors || BARCHART_COLORS : null;
+					strXml += makeSeriesDataPointsXml(chartType, obj, opts, barVaryColors);
+				}
 				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>";
+					if (obj.customLabels?.length) obj.customLabels.forEach((lbl, idx) => {
+						if (lbl) strXml += makeCustomDLblXml(idx, lbl, opts);
+					});
 					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 += createChartTextFonts(lblFace);
 					strXml += "</a:defRPr></a:pPr></a:p></c:txPr>";
 					if (opts.dataLabelPosition) strXml += `<c:dLblPos val="${opts.dataLabelPosition}"/>`;
 					strXml += "<c:showLegendKey val=\"0\"/>";
@@ -2559,29 +2858,6 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 					strXml += `<c:showLeaderLines val="${opts.showLeaderLines ? "1" : "0"}"/>`;
 					strXml += "</c:dLbls>";
 				}
-				if ((chartType === "bar" || chartType === "bar3D") && data.length === 1 && (opts.chartColors && opts.chartColors !== BARCHART_COLORS && opts.chartColors.length > 1 || opts.invertedColors?.length)) obj.values.forEach((value, index) => {
-					const arrColors = value < 0 ? opts.invertedColors || opts.chartColors || BARCHART_COLORS : opts.chartColors || [];
-					strXml += "  <c:dPt>";
-					strXml += `    <c:idx val="${index}"/>`;
-					strXml += "      <c:invertIfNegative val=\"0\"/>";
-					strXml += "    <c:bubble3D val=\"0\"/>";
-					strXml += "    <c:spPr>";
-					if (opts.lineSize === 0) strXml += "<a:ln><a:noFill/></a:ln>";
-					else if (chartType === "bar") {
-						strXml += "<a:solidFill>";
-						strXml += "  <a:srgbClr val=\"" + arrColors[index % arrColors.length] + "\"/>";
-						strXml += "</a:solidFill>";
-					} else {
-						strXml += "<a:ln>";
-						strXml += "  <a:solidFill>";
-						strXml += "   <a:srgbClr val=\"" + arrColors[index % arrColors.length] + "\"/>";
-						strXml += "  </a:solidFill>";
-						strXml += "</a:ln>";
-					}
-					strXml += createShadowElement(opts.shadow, DEF_SHAPE_SHADOW);
-					strXml += "    </c:spPr>";
-					strXml += "  </c:dPt>";
-				});
 				strXml += "<c:cat>";
 				if (opts.catLabelFormatCode) {
 					strXml += "  <c:numRef>";
@@ -2618,10 +2894,10 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 				strXml += "  <c:numRef>";
 				strXml += `<c:f>Sheet1!$${getExcelColName(obj._dataIndex + obj.labels.length + 1)}$2:$${getExcelColName(obj._dataIndex + obj.labels.length + 1)}$${obj.labels[0].length + 1}</c:f>`;
 				strXml += "    <c:numCache>";
-				strXml += "      <c:formatCode>" + (opts.valLabelFormatCode || opts.dataTableFormatCode || "General") + "</c:formatCode>";
+				strXml += "      <c:formatCode>" + valFmtCode + "</c:formatCode>";
 				strXml += `      <c:ptCount val="${obj.labels[0].length}"/>`;
 				obj.values.forEach((value, idx) => {
-					if (value != null) strXml += `<c:pt idx="${idx}"><c:v>${value}</c:v></c:pt>`;
+					strXml += numCachePt(idx, value);
 				});
 				strXml += "    </c:numCache>";
 				strXml += "  </c:numRef>";
@@ -2637,7 +2913,7 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 			strXml += "      <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 += "          " + createChartTextFonts(opts.dataLabelFontFace || "Arial");
 			strXml += "        </a:defRPr>";
 			strXml += "      </a:pPr></a:p>";
 			strXml += "    </c:txPr>";
@@ -2653,6 +2929,7 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 			if (chartType === "bar") {
 				strXml += `  <c:gapWidth val="${opts.barGapWidthPct}"/>`;
 				strXml += `  <c:overlap val="${opts.barOverlapPct != null ? opts.barOverlapPct : (opts.barGrouping || "").includes("tacked") ? 100 : 0}"/>`;
+				strXml += createSerLinesElement(opts.barSeriesLine);
 			} else if (chartType === "bar3D") {
 				strXml += `  <c:gapWidth val="${opts.barGapWidthPct}"/>`;
 				strXml += `  <c:gapDepth val="${opts.barGapDepthPct}"/>`;
@@ -2704,6 +2981,10 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 				strXml += "<a:effectLst/>";
 				strXml += "</c:spPr>";
 				strXml += "</c:marker>";
+				{
+					const scatterVaryColors = data.length === 1 && opts.chartColors !== BARCHART_COLORS ? opts.chartColors || BARCHART_COLORS : null;
+					strXml += makeSeriesDataPointsXml(chartType, obj, opts, scatterVaryColors);
+				}
 				if (opts.showLabel) {
 					const chartUuid = getUuid("-xxxx-xxxx-xxxx-xxxxxxxxxxxx");
 					if (obj.labels[0] && (opts.dataLabelFormatScatter === "custom" || opts.dataLabelFormatScatter === "customXY")) {
@@ -2722,13 +3003,13 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 								strXml += "                <a:pPr>";
 								strXml += `                    <a:defRPr sz="${Math.round((opts.dataLabelFontSize || 12) * 100)}" b="${opts.dataLabelFontBold ? "1" : "0"}" i="${opts.dataLabelFontItalic ? "1" : "0"}" u="none" strike="noStrike">`;
 								strXml += "                        <a:solidFill>" + createColorElement(opts.dataLabelColor || "000000") + "</a:solidFill>";
-								strXml += `                        <a:latin typeface="${opts.dataLabelFontFace || "Arial"}"/>`;
+								strXml += "                        " + createChartTextFonts(opts.dataLabelFontFace || "Arial");
 								strXml += "                    </a:defRPr>";
 								strXml += "                </a:pPr>";
 								strXml += "              <a:r>";
 								strXml += `                    <a:rPr lang="${opts.lang || "en-US"}" sz="${Math.round((opts.dataLabelFontSize || 12) * 100)}" b="${opts.dataLabelFontBold ? "1" : "0"}" i="${opts.dataLabelFontItalic ? "1" : "0"}" u="none" strike="noStrike" dirty="0">`;
 								strXml += "                        <a:solidFill>" + createColorElement(opts.dataLabelColor || "000000") + "</a:solidFill>";
-								strXml += `                        <a:latin typeface="${opts.dataLabelFontFace || "Arial"}"/>`;
+								strXml += "                        " + createChartTextFonts(opts.dataLabelFontFace || "Arial");
 								strXml += "                    </a:rPr>";
 								strXml += "                    <a:t>" + encodeXmlEntities(label) + "</a:t>";
 								strXml += "              </a:r>";
@@ -2808,7 +3089,7 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 						strXml += "            <a:pPr>";
 						strXml += `                <a:defRPr sz="${Math.round((opts.dataLabelFontSize || 12) * 100)}" b="${opts.dataLabelFontBold ? "1" : "0"}" i="${opts.dataLabelFontItalic ? "1" : "0"}" u="none" strike="noStrike">`;
 						strXml += "                    <a:solidFill>" + createColorElement(opts.dataLabelColor || "000000") + "</a:solidFill>";
-						strXml += `                    <a:latin typeface="${opts.dataLabelFontFace || "Arial"}"/>`;
+						strXml += "                    " + createChartTextFonts(opts.dataLabelFontFace || "Arial");
 						strXml += "                </a:defRPr>";
 						strXml += "            </a:pPr>";
 						strXml += `            <a:endParaRPr lang="${opts.lang || "en-US"}"/>`;
@@ -2829,31 +3110,14 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 						strXml += "</c:dLbls>";
 					}
 				}
-				if (data.length === 1 && opts.chartColors !== BARCHART_COLORS) obj.values.forEach((value, index) => {
-					const arrColors = value < 0 ? opts.invertedColors || opts.chartColors || BARCHART_COLORS : opts.chartColors || [];
-					strXml += "  <c:dPt>";
-					strXml += `    <c:idx val="${index}"/>`;
-					strXml += "      <c:invertIfNegative val=\"0\"/>";
-					strXml += "    <c:bubble3D val=\"0\"/>";
-					strXml += "    <c:spPr>";
-					if (opts.lineSize === 0) strXml += "<a:ln><a:noFill/></a:ln>";
-					else {
-						strXml += "<a:solidFill>";
-						strXml += " <a:srgbClr val=\"" + arrColors[index % arrColors.length] + "\"/>";
-						strXml += "</a:solidFill>";
-					}
-					strXml += createShadowElement(opts.shadow, DEF_SHAPE_SHADOW);
-					strXml += "    </c:spPr>";
-					strXml += "  </c:dPt>";
-				});
 				strXml += "<c:xVal>";
 				strXml += "  <c:numRef>";
 				strXml += `    <c:f>Sheet1!$A$2:$A$${data[0].values.length + 1}</c:f>`;
 				strXml += "    <c:numCache>";
-				strXml += "      <c:formatCode>General</c:formatCode>";
+				strXml += "      <c:formatCode>" + valFmtCode + "</c:formatCode>";
 				strXml += `      <c:ptCount val="${data[0].values.length}"/>`;
 				data[0].values.forEach((value, idx) => {
-					if (value != null) strXml += `<c:pt idx="${idx}"><c:v>${value}</c:v></c:pt>`;
+					strXml += numCachePt(idx, value);
 				});
 				strXml += "    </c:numCache>";
 				strXml += "  </c:numRef>";
@@ -2862,10 +3126,10 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 				strXml += "  <c:numRef>";
 				strXml += `    <c:f>Sheet1!$${getExcelColName(idx + 2)}$2:$${getExcelColName(idx + 2)}$${data[0].values.length + 1}</c:f>`;
 				strXml += "    <c:numCache>";
-				strXml += "      <c:formatCode>General</c:formatCode>";
+				strXml += "      <c:formatCode>" + valFmtCode + "</c:formatCode>";
 				strXml += `      <c:ptCount val="${data[0].values.length}"/>`;
 				data[0].values.forEach((_value, idx) => {
-					if (obj.values[idx] != null) strXml += `<c:pt idx="${idx}"><c:v>${obj.values[idx]}</c:v></c:pt>`;
+					strXml += numCachePt(idx, obj.values[idx]);
 				});
 				strXml += "    </c:numCache>";
 				strXml += "  </c:numRef>";
@@ -2881,7 +3145,7 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 			strXml += "      <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 += "          " + createChartTextFonts(opts.dataLabelFontFace || "Arial");
 			strXml += "        </a:defRPr>";
 			strXml += "      </a:pPr></a:p>";
 			strXml += "    </c:txPr>";
@@ -2931,10 +3195,10 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 				strXml += "  <c:numRef>";
 				strXml += `    <c:f>Sheet1!$A$2:$A$${data[0].values.length + 1}</c:f>`;
 				strXml += "    <c:numCache>";
-				strXml += "      <c:formatCode>General</c:formatCode>";
+				strXml += "      <c:formatCode>" + valFmtCode + "</c:formatCode>";
 				strXml += `      <c:ptCount val="${data[0].values.length}"/>`;
 				data[0].values.forEach((value, idx) => {
-					strXml += `<c:pt idx="${idx}"><c:v>${value || value === 0 ? value : ""}</c:v></c:pt>`;
+					strXml += numCachePt(idx, value);
 				});
 				strXml += "    </c:numCache>";
 				strXml += "  </c:numRef>";
@@ -2944,10 +3208,10 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 				strXml += `<c:f>Sheet1!$${getExcelColName(idxColLtr + 1)}$2:$${getExcelColName(idxColLtr + 1)}$${data[0].values.length + 1}</c:f>`;
 				idxColLtr++;
 				strXml += "    <c:numCache>";
-				strXml += "      <c:formatCode>General</c:formatCode>";
+				strXml += "      <c:formatCode>" + valFmtCode + "</c:formatCode>";
 				strXml += `      <c:ptCount val="${data[0].values.length}"/>`;
 				data[0].values.forEach((_value, idx) => {
-					strXml += `<c:pt idx="${idx}"><c:v>${obj.values[idx] || obj.values[idx] === 0 ? obj.values[idx] : ""}</c:v></c:pt>`;
+					strXml += numCachePt(idx, obj.values[idx]);
 				});
 				strXml += "    </c:numCache>";
 				strXml += "  </c:numRef>";
@@ -2960,7 +3224,7 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 				strXml += "        <c:formatCode>General</c:formatCode>";
 				strXml += `           <c:ptCount val="${obj.sizes.length}"/>`;
 				obj.sizes.forEach((value, idx) => {
-					strXml += `<c:pt idx="${idx}"><c:v>${value ?? ""}</c:v></c:pt>`;
+					strXml += numCachePt(idx, value);
 				});
 				strXml += "      </c:numCache>";
 				strXml += "    </c:numRef>";
@@ -2973,12 +3237,12 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 			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(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 += createChartTextFonts(opts.dataLabelFontFace || "Arial");
 			strXml += "</a:defRPr></a:pPr></a:p></c:txPr>";
 			if (opts.dataLabelPosition) strXml += `<c:dLblPos val="${opts.dataLabelPosition}"/>`;
 			strXml += "<c:showLegendKey val=\"0\"/>";
 			strXml += `<c:showVal val="${opts.showValue ? "1" : "0"}"/>`;
-			strXml += `<c:showCatName val="0"/><c:showSerName val="${opts.showSerName ? "1" : "0"}"/><c:showPercent val="0"/><c:showBubbleSize val="0"/>`;
+			strXml += `<c:showCatName val="0"/><c:showSerName val="${opts.showSerName ? "1" : "0"}"/><c:showPercent val="0"/><c:showBubbleSize val="${opts.showBubbleSize ? "1" : "0"}"/>`;
 			strXml += "<c:extLst>";
 			strXml += "  <c:ext uri=\"{CE6537A1-D6FC-4f65-9D91-7224C49458BB}\" xmlns:c15=\"http://schemas.microsoft.com/office/drawing/2012/chart\">";
 			strXml += "    <c15:showLeaderLines val=\"" + (opts.showLeaderLines ? "1" : "0") + "\"/>";
@@ -3012,33 +3276,37 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 			else strXml += createShadowElement(opts.shadow, DEF_SHAPE_SHADOW);
 			strXml += "  </c:spPr>";
 			optsChartData.labels[0].forEach((_label, idx) => {
+				const ptStyle = optsChartData.pointStyles?.[idx];
 				strXml += "<c:dPt>";
 				strXml += ` <c:idx val="${idx}"/>`;
 				strXml += " <c:bubble3D val=\"0\"/>";
 				strXml += " <c:spPr>";
-				strXml += `<a:solidFill>${createColorElement(opts.chartColors[idx + 1 > opts.chartColors.length ? Math.floor(Math.random() * opts.chartColors.length) : idx])}</a:solidFill>`;
-				if (opts.dataBorder) strXml += `<a:ln w="${valToPts(opts.dataBorder.pt)}" cap="flat"><a:solidFill>${createColorElement(opts.dataBorder.color)}</a:solidFill><a:prstDash val="solid"/><a:round/></a:ln>`;
+				strXml += `<a:solidFill>${createColorElement(ptStyle?.fill || opts.chartColors[idx + 1 > opts.chartColors.length ? Math.floor(Math.random() * opts.chartColors.length) : idx])}</a:solidFill>`;
+				if (ptStyle?.border) strXml += createChartBorderLine(ptStyle.border);
+				else if (opts.dataBorder) strXml += `<a:ln w="${valToPts(opts.dataBorder.pt)}" cap="flat"><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>";
 				strXml += "</c:dPt>";
 			});
 			strXml += "<c:dLbls>";
 			optsChartData.labels[0].forEach((_label, idx) => {
+				const customLbl = optsChartData.customLabels?.[idx];
 				strXml += "<c:dLbl>";
 				strXml += ` <c:idx val="${idx}"/>`;
+				if (customLbl) strXml += `<c:tx><c:rich><a:bodyPr/><a:lstStyle/><a:p><a:r><a:rPr lang="${opts.lang || "en-US"}" dirty="0"/><a:t>${encodeXmlEntities(customLbl)}</a:t></a:r></a:p></c:rich></c:tx>`;
 				strXml += `  <c:numFmt formatCode="${encodeXmlEntities(opts.dataLabelFormatCode) || "General"}" sourceLinked="0"/>`;
 				strXml += "  <c:spPr/><c:txPr>";
 				strXml += "   <a:bodyPr/><a:lstStyle/>";
 				strXml += "   <a:p><a:pPr>";
 				strXml += `   <a:defRPr sz="${Math.round((opts.dataLabelFontSize || 12) * 100)}" b="${opts.dataLabelFontBold ? 1 : 0}" i="${opts.dataLabelFontItalic ? 1 : 0}" u="none" strike="noStrike">`;
 				strXml += "    <a:solidFill>" + createColorElement(opts.dataLabelColor || "000000") + "</a:solidFill>";
-				strXml += `    <a:latin typeface="${opts.dataLabelFontFace || "Arial"}"/>`;
+				strXml += "    " + createChartTextFonts(opts.dataLabelFontFace || "Arial");
 				strXml += "   </a:defRPr>";
 				strXml += "      </a:pPr></a:p>";
 				strXml += "    </c:txPr>";
 				if (chartType === "pie" && opts.dataLabelPosition) strXml += `<c:dLblPos val="${opts.dataLabelPosition}"/>`;
 				strXml += "    <c:showLegendKey val=\"0\"/>";
-				strXml += "    <c:showVal val=\"" + (opts.showValue ? "1" : "0") + "\"/>";
+				strXml += "    <c:showVal val=\"" + (customLbl ? "0" : opts.showValue ? "1" : "0") + "\"/>";
 				strXml += "    <c:showCatName val=\"" + (opts.showLabel ? "1" : "0") + "\"/>";
 				strXml += "    <c:showSerName val=\"" + (opts.showSerName ? "1" : "0") + "\"/>";
 				strXml += "    <c:showPercent val=\"" + (opts.showPercent ? "1" : "0") + "\"/>";
@@ -3053,7 +3321,7 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 			strXml += "        <a:pPr>";
 			strXml += `          <a:defRPr sz="${Math.round((opts.dataLabelFontSize || 12) * 100)}" b="${opts.dataLabelFontBold ? "1" : "0"}" i="${opts.dataLabelFontItalic ? "1" : "0"}" u="none" strike="noStrike">`;
 			strXml += "            <a:solidFill>" + createColorElement(opts.dataLabelColor || "000000") + "</a:solidFill>";
-			strXml += `            <a:latin typeface="${opts.dataLabelFontFace || "Arial"}"/>`;
+			strXml += "            " + createChartTextFonts(opts.dataLabelFontFace || "Arial");
 			strXml += "          </a:defRPr>";
 			strXml += "        </a:pPr>";
 			strXml += "      </a:p>";
@@ -3082,6 +3350,7 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 			strXml += "    <c:numRef>";
 			strXml += `      <c:f>Sheet1!$B$2:$B$${optsChartData.labels[0].length + 1}</c:f>`;
 			strXml += "      <c:numCache>";
+			strXml += "        <c:formatCode>" + valFmtCode + "</c:formatCode>";
 			strXml += `           <c:ptCount val="${optsChartData.labels[0].length}"/>`;
 			optsChartData.values.forEach((value, idx) => {
 				strXml += `<c:pt idx="${idx}"><c:v>${value || value === 0 ? value : ""}</c:v></c:pt>`;
@@ -3157,7 +3426,7 @@ function makeCatAxis(opts, axisId, valAxisId) {
 	strXml += "    <a:pPr>";
 	strXml += `      <a:defRPr sz="${Math.round((opts.catAxisLabelFontSize || 12) * 100)}" b="${opts.catAxisLabelFontBold ? 1 : 0}" i="${opts.catAxisLabelFontItalic ? 1 : 0}" u="none" strike="noStrike">`;
 	strXml += "      <a:solidFill>" + createColorElement(opts.catAxisLabelColor || "000000") + "</a:solidFill>";
-	strXml += "      <a:latin typeface=\"" + (opts.catAxisLabelFontFace || "Arial") + "\"/>";
+	strXml += "      " + createChartTextFonts(opts.catAxisLabelFontFace || "Arial");
 	strXml += "   </a:defRPr>";
 	strXml += "  </a:pPr>";
 	strXml += "  <a:endParaRPr lang=\"" + (opts.lang || "en-US") + "\"/>";
@@ -3250,7 +3519,7 @@ function makeValAxis(opts, valAxisId) {
 	strXml += "    <a:pPr>";
 	strXml += `      <a:defRPr sz="${Math.round((opts.valAxisLabelFontSize || 12) * 100)}" b="${opts.valAxisLabelFontBold ? 1 : 0}" i="${opts.valAxisLabelFontItalic ? 1 : 0}" u="none" strike="noStrike">`;
 	strXml += "        <a:solidFill>" + createColorElement(opts.valAxisLabelColor || "000000") + "</a:solidFill>";
-	strXml += "        <a:latin typeface=\"" + (opts.valAxisLabelFontFace || "Arial") + "\"/>";
+	strXml += "        " + createChartTextFonts(opts.valAxisLabelFontFace || "Arial");
 	strXml += "      </a:defRPr>";
 	strXml += "    </a:pPr>";
 	strXml += "  <a:endParaRPr lang=\"" + (opts.lang || "en-US") + "\"/>";
@@ -3306,7 +3575,7 @@ function makeSerAxis(opts, axisId, valAxisId) {
 	strXml += "    <a:pPr>";
 	strXml += `    <a:defRPr sz="${Math.round((opts.serAxisLabelFontSize || 12) * 100)}" b="${opts.serAxisLabelFontBold ? "1" : "0"}" i="${opts.serAxisLabelFontItalic ? "1" : "0"}" u="none" strike="noStrike">`;
 	strXml += `      <a:solidFill>${createColorElement(opts.serAxisLabelColor || "000000")}</a:solidFill>`;
-	strXml += `      <a:latin typeface="${opts.serAxisLabelFontFace || "Arial"}"/>`;
+	strXml += "      " + createChartTextFonts(opts.serAxisLabelFontFace || "Arial");
 	strXml += "   </a:defRPr>";
 	strXml += "  </a:pPr>";
 	strXml += "  <a:endParaRPr lang=\"" + (opts.lang || "en-US") + "\"/>";
@@ -3346,17 +3615,31 @@ function genXmlTitle(opts, chartX, chartY) {
 	const rotate = opts.titleRotate ? `<a:bodyPr rot="${convertRotationDegrees(opts.titleRotate)}"/>` : "<a:bodyPr/>";
 	const sizeAttr = opts.fontSize ? `sz="${Math.round(opts.fontSize * 100)}"` : "";
 	const titleBold = opts.titleBold ? 1 : 0;
+	const titleItalic = opts.titleItalic ? 1 : 0;
+	const titleUnderline = opts.titleUnderline ? "sng" : "none";
 	let layout = "<c:layout/>";
-	if (opts.titlePos && typeof opts.titlePos.x === "number" && typeof opts.titlePos.y === "number") {
-		const totalX = opts.titlePos.x + chartX;
-		const totalY = opts.titlePos.y + chartY;
-		let valX = totalX === 0 ? 0 : totalX * (totalX / 5) / 10;
-		if (valX >= 1) valX = valX / 10;
-		if (valX >= .1) valX = valX / 10;
-		let valY = totalY === 0 ? 0 : totalY * (totalY / 5) / 10;
-		if (valY >= 1) valY = valY / 10;
-		if (valY >= .1) valY = valY / 10;
-		layout = `<c:layout><c:manualLayout><c:xMode val="edge"/><c:yMode val="edge"/><c:x val="${valX}"/><c:y val="${valY}"/></c:manualLayout></c:layout>`;
+	const hasX = opts.titlePos && typeof opts.titlePos.x === "number";
+	const hasY = opts.titlePos && typeof opts.titlePos.y === "number";
+	if (hasX || hasY) {
+		let modes = "";
+		let vals = "";
+		if (hasX) {
+			const totalX = opts.titlePos.x + chartX;
+			let valX = totalX === 0 ? 0 : totalX * (totalX / 5) / 10;
+			if (valX >= 1) valX = valX / 10;
+			if (valX >= .1) valX = valX / 10;
+			modes += "<c:xMode val=\"edge\"/>";
+			vals += `<c:x val="${valX}"/>`;
+		}
+		if (hasY) {
+			const totalY = opts.titlePos.y + chartY;
+			let valY = totalY === 0 ? 0 : totalY * (totalY / 5) / 10;
+			if (valY >= 1) valY = valY / 10;
+			if (valY >= .1) valY = valY / 10;
+			modes += "<c:yMode val=\"edge\"/>";
+			vals += `<c:y val="${valY}"/>`;
+		}
+		layout = `<c:layout><c:manualLayout>${modes}${vals}</c:manualLayout></c:layout>`;
 	}
 	return `<c:title>
       <c:tx>
@@ -3365,15 +3648,15 @@ function genXmlTitle(opts, chartX, chartY) {
           <a:lstStyle/>
           <a:p>
             ${align}
-            <a:defRPr ${sizeAttr} b="${titleBold}" i="0" u="none" strike="noStrike">
+            <a:defRPr ${sizeAttr} b="${titleBold}" i="${titleItalic}" u="${titleUnderline}" strike="noStrike">
               <a:solidFill>${createColorElement(opts.color || "000000")}</a:solidFill>
-              <a:latin typeface="${opts.fontFace || "Arial"}"/>
+              ${createChartTextFonts(opts.fontFace || "Arial")}
             </a:defRPr>
           </a:pPr>
           <a:r>
-            <a:rPr ${sizeAttr} b="${titleBold}" i="0" u="none" strike="noStrike">
+            <a:rPr ${sizeAttr} b="${titleBold}" i="${titleItalic}" u="${titleUnderline}" strike="noStrike">
               <a:solidFill>${createColorElement(opts.color || "000000")}</a:solidFill>
-              <a:latin typeface="${opts.fontFace || "Arial"}"/>
+              ${createChartTextFonts(opts.fontFace || "Arial")}
             </a:rPr>
             <a:t>${encodeXmlEntities(opts.title) || ""}</a:t>
           </a:r>
@@ -3447,11 +3730,105 @@ function createGridLineElement(glOpts) {
 	strXml += "</c:majorGridlines>";
 	return strXml;
 }
-function createLineCap(lineCap) {
-	if (!lineCap || lineCap === "flat") return "flat";
-	else if (lineCap === "square") return "sq";
-	else if (lineCap === "round") return "rnd";
-	else throw new Error(`Invalid chart line cap: ${lineCap}`);
+/**
+* Build a `<c:pt>` numeric-cache data point, or '' to leave a gap.
+*
+* `<c:v>` inside a `<c:numCache>` is an `xsd:double`; emitting `NaN`, `Infinity`
+* or an empty string yields an invalid value that makes PowerPoint report the
+* package as needing repair. Null/undefined are intentional gaps and are skipped
+* silently (a sparse, idx-keyed cache is valid); other non-finite numbers are
+* skipped with a warning, per the library's "warn rather than emit a degenerate
+* result" policy.
+* @param idx - zero-based data-point index (emitted as `idx`)
+* @param value - numeric value (or null/undefined gap)
+*/
+function numCachePt(idx, value) {
+	if (value == null) return "";
+	if (!Number.isFinite(value)) {
+		console.warn(`Warning: chart value "${value}" at index ${idx} is not a finite number; data point omitted.`);
+		return "";
+	}
+	return `<c:pt idx="${idx}"><c:v>${value}</c:v></c:pt>`;
+}
+/**
+* Build a `<c:serLines>` ("Series Lines") element for a bar chart.
+* @param opt - `true` for PowerPoint automatic styling, an {@link OptsChartGridLine}
+*   to customize the line, or falsy / `{ style: 'none' }` to omit the element.
+*/
+function createSerLinesElement(opt) {
+	if (!opt) return "";
+	if (opt === true) return "<c:serLines/>";
+	if (opt.style === "none") return "";
+	let strXml = "<c:serLines><c:spPr>";
+	strXml += `<a:ln w="${valToPts(opt.size || DEF_CHART_GRIDLINE.size)}" cap="${createLineCap(opt.cap || DEF_CHART_GRIDLINE.cap)}">`;
+	strXml += `<a:solidFill><a:srgbClr val="${opt.color || DEF_CHART_GRIDLINE.color}"/></a:solidFill>`;
+	strXml += `<a:prstDash val="${opt.style || DEF_CHART_GRIDLINE.style}"/><a:round/>`;
+	strXml += "</a:ln></c:spPr></c:serLines>";
+	return strXml;
+}
+function makeCustomDLblXml(idx, text, opts) {
+	const sz = Math.round((opts.dataLabelFontSize || 12) * 100);
+	const bold = opts.dataLabelFontBold ? "1" : "0";
+	const italic = opts.dataLabelFontItalic ? "1" : "0";
+	const color = createColorElement(opts.dataLabelColor || "000000");
+	const face = opts.dataLabelFontFace || "Arial";
+	const lang = opts.lang || "en-US";
+	return `<c:dLbl><c:idx val="${idx}"/><c:tx><c:rich><a:bodyPr/><a:lstStyle/><a:p><a:pPr><a:defRPr sz="${sz}" b="${bold}" i="${italic}" u="none" strike="noStrike"><a:solidFill>${color}</a:solidFill>${createChartTextFonts(face)}</a:defRPr></a:pPr><a:r><a:rPr lang="${lang}" sz="${sz}" b="${bold}" i="${italic}" u="none" strike="noStrike" dirty="0"><a:solidFill>${color}</a:solidFill>${createChartTextFonts(face)}</a:rPr><a:t>${encodeXmlEntities(text)}</a:t></a:r></a:p></c:rich></c:tx><c:showLegendKey val="0"/><c:showVal val="0"/><c:showCatName val="0"/><c:showSerName val="0"/><c:showPercent val="0"/><c:showBubbleSize val="0"/></c:dLbl>`;
+}
+/**
+* Build an `<a:ln>` border element from a per-data-point `BorderProps`.
+* @param border - point border style (`type`, `color`, `pt`)
+*/
+function createChartBorderLine(border) {
+	if (border.type === "none") return "<a:ln><a:noFill/></a:ln>";
+	const dash = border.type === "dash" ? "dash" : "solid";
+	return `<a:ln w="${valToPts(border.pt ?? 1)}" cap="flat"><a:solidFill>${createColorElement(border.color || "666666")}</a:solidFill><a:prstDash val="${dash}"/><a:round/></a:ln>`;
+}
+/**
+* Build `<c:dPt>` entries for a series in the bar/line/area/scatter loops.
+*
+* Merges two sources into a single `c:dPt` per index so we never emit a
+* duplicate `<c:idx>` (which corrupts the chart):
+* - legacy single-series color-vary fills (bar/scatter), supplied via `varyColors`
+* - per-point `pointStyles` border/fill overrides
+*
+* Must be emitted in schema position *before* `c:dLbls` (CT_*Ser order).
+* RADAR is skipped: extra per-point markup historically corrupts the chart.
+*
+* @param chartType  - series chart type
+* @param obj        - series data (reads `values`, `pointStyles`)
+* @param opts       - chart options (fill/shadow/lineSize context)
+* @param varyColors - color array when single-series color-vary applies, else `null`
+*/
+function makeSeriesDataPointsXml(chartType, obj, opts, varyColors) {
+	if (chartType === "radar") return "";
+	const pointStyles = obj.pointStyles;
+	if (!varyColors && !pointStyles?.length) return "";
+	const isBar = chartType === "bar" || chartType === "bar3D";
+	const isScatter = chartType === "scatter";
+	let xml = "";
+	obj.values.forEach((value, index) => {
+		const ptStyle = pointStyles?.[index];
+		const arrColors = varyColors ? value < 0 ? opts.invertedColors || opts.chartColors || BARCHART_COLORS : varyColors : null;
+		const fillColor = ptStyle?.fill || (arrColors ? arrColors[index % arrColors.length] : null);
+		const border = ptStyle?.border;
+		if (!fillColor && !border) return;
+		xml += "<c:dPt>";
+		xml += `<c:idx val="${index}"/>`;
+		if (isBar) xml += "<c:invertIfNegative val=\"0\"/>";
+		xml += "<c:bubble3D val=\"0\"/>";
+		xml += "<c:spPr>";
+		if ((isBar || isScatter) && opts.lineSize === 0 && !border && !ptStyle?.fill) xml += "<a:ln><a:noFill/></a:ln>";
+		else {
+			if (fillColor) if (chartType === "bar3D") xml += `<a:ln><a:solidFill>${createColorElement(fillColor)}</a:solidFill></a:ln>`;
+			else xml += `<a:solidFill>${createColorElement(fillColor)}</a:solidFill>`;
+			if (border) xml += createChartBorderLine(border);
+		}
+		xml += createShadowElement(opts.shadow, DEF_SHAPE_SHADOW);
+		xml += "</c:spPr>";
+		xml += "</c:dPt>";
+	});
+	return xml;
 }
 //#endregion
 //#region src/gen-media.ts
@@ -3500,6 +3877,37 @@ function encodeSlideMediaRels(layout, runtime) {
 /**
 * PptxGenJS: XML Generation
 */
+const _warnedTextRangeMsgs = /* @__PURE__ */ new Set();
+function warnTextRangeOnce(msg) {
+	if (_warnedTextRangeMsgs.has(msg)) return;
+	_warnedTextRangeMsgs.add(msg);
+	console.warn(msg);
+}
+/**
+* Clamp a font size (points) into ST_TextFontSize (1-4000pt) and return it in
+* hundredths of a point for the `sz` attribute. Out-of-range sizes make
+* PowerPoint report the package as needing repair (e.g. `sz` > 400000 or < 100).
+*/
+function clampFontSizeSz(fontSizePts) {
+	const raw = Math.round(fontSizePts * 100);
+	const clamped = Math.min(4e5, Math.max(100, raw));
+	if (clamped !== raw) warnTextRangeOnce(`Warning: fontSize ${fontSizePts} is outside the valid range 1-4000pt; using ${clamped / 100}.`);
+	return clamped;
+}
+/** Clamp character spacing (points) into ST_TextPoint (-4000..4000pt); returns hundredths for the `spc` attribute. */
+function clampCharSpacingSpc(charSpacingPts) {
+	const raw = Math.round(charSpacingPts * 100);
+	const clamped = Math.min(4e5, Math.max(-4e5, raw));
+	if (clamped !== raw) warnTextRangeOnce(`Warning: charSpacing ${charSpacingPts} is outside the valid range -4000..4000pt; using ${clamped / 100}.`);
+	return clamped;
+}
+/** Clamp line spacing (points) into ST_TextSpacingPoint (0..1584pt); returns hundredths for `<a:spcPts val>`. */
+function clampLineSpacingPts(lineSpacingPts) {
+	const raw = Math.round(lineSpacingPts * 100);
+	const clamped = Math.min(158400, Math.max(0, raw));
+	if (clamped !== raw) warnTextRangeOnce(`Warning: lineSpacing ${lineSpacingPts} is outside the valid range 0-1584pt; using ${clamped / 100}.`);
+	return clamped;
+}
 const ImageSizingXml = {
 	cover: function(imgSize, boxDim) {
 		const imgRatio = imgSize.h / imgSize.w;
@@ -3524,6 +3932,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,18 +3953,91 @@ 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"]);
+const SHAPE_LOCK_ATTRS = [
+	"noGrp",
+	"noSelect",
+	"noRot",
+	"noChangeAspect",
+	"noMove",
+	"noResize",
+	"noEditPoints",
+	"noAdjustHandles",
+	"noChangeArrowheads",
+	"noChangeShapeType",
+	"noTextEdit"
+];
+const PICTURE_LOCK_ATTRS = [
+	"noGrp",
+	"noSelect",
+	"noRot",
+	"noChangeAspect",
+	"noMove",
+	"noResize",
+	"noEditPoints",
+	"noAdjustHandles",
+	"noChangeArrowheads",
+	"noChangeShapeType",
+	"noCrop"
+];
+const GRAPHIC_FRAME_LOCK_ATTRS = [
+	"noGrp",
+	"noDrilldown",
+	"noSelect",
+	"noChangeAspect",
+	"noMove",
+	"noResize"
+];
+/**
+* Serialize an object-lock element (`a:spLocks` / `a:picLocks` / `a:graphicFrameLocks`).
+* Only flags set to `true` AND valid for this element type are emitted; a flag set on an
+* unsupported element type is dropped with a warning (silent coercion is a footgun).
+* @param tag - locking element tag, e.g. `'a:spLocks'`
+* @param allowed - attribute names this element type supports, in desired emit order
+* @param locks - merged lock flags (callers fold any hard-coded default in first)
+* @param objectName - for the warning message
+* @returns the locking element string, or `''` when no applicable flag is set
+*/
+function genXmlObjectLock(tag, allowed, locks, objectName) {
+	if (!locks) return "";
+	const lockMap = locks;
+	for (const key of Object.keys(lockMap)) if (lockMap[key] && !allowed.includes(key)) console.warn(`Warning: objectLock.${key} is not supported on <${tag}> (object "${objectName ?? ""}") and was ignored.`);
+	const attrs = allowed.filter((name) => lockMap[name] === true).map((name) => `${name}="1"`);
+	return attrs.length > 0 ? `<${tag} ${attrs.join(" ")}/>` : "";
+}
 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 (!VALID_SHAPE_PRESETS.has(shapeName)) throw new Error(`Invalid shape "${String(shapeName)}"! Use a value from \`pptxgen.shapes.*\` (e.g. \`pptxgen.shapes.RECTANGLE\`). PowerPoint can't render unknown preset geometries and will drop the shape during repair.`);
+	let avLst = "";
+	const emittedAdjNames = /* @__PURE__ */ new Set();
+	const emitGuide = (name, fmlaVal) => {
+		avLst += `<a:gd name="${name}" fmla="val ${fmlaVal}"/>`;
+		emittedAdjNames.add(name);
+	};
+	if (options.rectRadius) {
+		const adjVal = Math.round(options.rectRadius * EMU * 1e5 / Math.min(cx, cy));
+		if (RECT_RADIUS_ADJ1_SHAPES.has(shapeName)) {
+			emitGuide("adj1", adjVal);
+			emitGuide("adj2", 0);
+		} else emitGuide("adj", 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)}" />`;
+			emitGuide(`adj${i + 1}`, convertRotationDegrees(angle));
 		}
-		if (options.arcThicknessRatio) strXml += `<a:gd name="adj3" fmla="val ${Math.round(options.arcThicknessRatio * 5e4)}" />`;
+		if (options.arcThicknessRatio) emitGuide("adj3", Math.round(options.arcThicknessRatio * 5e4));
 	}
-	strXml += "</a:avLst></a:prstGeom>";
-	return strXml;
+	if (options.shapeAdjust) (Array.isArray(options.shapeAdjust) ? options.shapeAdjust : [options.shapeAdjust]).forEach((adj) => {
+		if (!adj || typeof adj.name !== "string" || adj.name.length === 0 || typeof adj.value !== "number" || !isFinite(adj.value)) {
+			console.warn(`Warning: shapeAdjust entry ${JSON.stringify(adj)} is invalid (needs { name:string, value:number }) and was ignored.`);
+			return;
+		}
+		if (emittedAdjNames.has(adj.name)) {
+			console.warn(`Warning: shapeAdjust "${adj.name}" was ignored because rectRadius/angleRange already set that handle.`);
+			return;
+		}
+		emitGuide(adj.name, Math.round(adj.value * 1e5));
+	});
+	return `<a:prstGeom prst="${shapeName}"><a:avLst>${avLst}</a:avLst></a:prstGeom>`;
 }
 /**
 * Emit an `<a:custGeom>` for a freeform path built from `points`.
@@ -3600,6 +4090,45 @@ function genXmlCustGeom(points, cx, cy, layout) {
 }
 const PLACEHOLDER_TYPE_MAP = PLACEHOLDER_TYPES;
 /**
+* Emit the `<a:lnL>/<a:lnR>/<a:lnT>/<a:lnB>` border children of an `<a:tcPr>` for a table cell.
+* Shared by normal cells and the dummy span (`_hmerge`/`_vmerge`) cells so a merged region's
+* outer edges render with the same border as its origin cell (Issue #680).
+* @param {BorderProps[]} cellBorder - 4-tuple of border props in [top, right, bottom, left] order
+* @return {string} concatenated border element XML, in the LRTB document order PowerPoint expects
+*/
+function genTableCellBorderXml(cellBorder) {
+	let strXml = "";
+	[
+		{
+			idx: 3,
+			name: "lnL"
+		},
+		{
+			idx: 1,
+			name: "lnR"
+		},
+		{
+			idx: 0,
+			name: "lnT"
+		},
+		{
+			idx: 2,
+			name: "lnB"
+		}
+	].forEach((obj) => {
+		const border = cellBorder[obj.idx];
+		if (!border) return;
+		const cap = createLineCap(border.cap);
+		if (border.type !== "none") {
+			strXml += `<a:${obj.name} w="${valToPts(border.pt)}" cap="${cap}" cmpd="sng" algn="ctr">`;
+			strXml += `<a:solidFill>${createColorElement(border.color)}</a:solidFill>`;
+			strXml += `<a:prstDash val="${border.type === "dash" ? "sysDash" : "solid"}"/><a:round/><a:headEnd type="none" w="med" len="med"/><a:tailEnd type="none" w="med" len="med"/>`;
+			strXml += `</a:${obj.name}>`;
+		} else strXml += `<a:${obj.name} w="0" cap="${cap}" cmpd="sng" algn="ctr"><a:noFill/></a:${obj.name}>`;
+	});
+	return strXml;
+}
+/**
 * Transforms a slide or slideLayout to resulting XML string - Creates `ppt/slide*.xml`
 * @param {PresSlideInternal|SlideLayoutInternal} slideObject - slide object created within createSlideObject
 * @return {string} XML string with <p:cSld> as the root
@@ -3658,9 +4187,16 @@ function slideObjectToXml(slide) {
 					intColCnt += cellOpts?.colspan ? Number(cellOpts.colspan) : 1;
 				});
 				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:cNvGraphicFramePr>${genXmlObjectLock("a:graphicFrameLocks", GRAPHIC_FRAME_LOCK_ATTRS, {
+					noGrp: true,
+					...slideItemObj.options.objectLock
+				}, slideItemObj.options.objectName)}</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++) {
@@ -3686,7 +4222,8 @@ function slideObjectToXml(slide) {
 								return {
 									_type: "tablecell",
 									options: { rowspan },
-									_hmerge: true
+									_hmerge: true,
+									_spanOrigin: cell
 								};
 							});
 							cells.splice(cIdx + 1, 0, ...vMergeCells);
@@ -3702,12 +4239,14 @@ function slideObjectToXml(slide) {
 						const colspan = cell.options?.colspan;
 						const _hmerge = cell._hmerge;
 						if (rowspan && rowspan > 1) {
+							const _spanOrigin = cell._spanOrigin || cell;
 							const hMergeCell = {
 								_type: "tablecell",
 								options: { colspan },
 								_rowContinue: rowspan - 1,
 								_vmerge: true,
-								_hmerge
+								_hmerge,
+								_spanOrigin
 							};
 							nextRow.splice(cIdx, 0, hMergeCell);
 						}
@@ -3717,7 +4256,7 @@ function slideObjectToXml(slide) {
 					let intRowH = 0;
 					if (Array.isArray(objTabOpts.rowH) && objTabOpts.rowH[rIdx]) intRowH = inch2Emu(Number(objTabOpts.rowH[rIdx]));
 					else if (objTabOpts.rowH && !isNaN(Number(objTabOpts.rowH))) intRowH = inch2Emu(Number(objTabOpts.rowH));
-					else if (slideItemObj.options.cy || slideItemObj.options.h) intRowH = Math.round((slideItemObj.options.h ? inch2Emu(slideItemObj.options.h) : typeof slideItemObj.options.cy === "number" ? slideItemObj.options.cy : 1) / arrTabRows.length);
+					else if (slideItemObj.options.cy || slideItemObj.options.h) intRowH = Math.round((slideItemObj.options.h ? cy : typeof slideItemObj.options.cy === "number" ? slideItemObj.options.cy : 1) / arrTabRows.length);
 					strXml += `<a:tr h="${intRowH}">`;
 					cells.forEach((cellObj) => {
 						const cell = cellObj;
@@ -3730,7 +4269,17 @@ function slideObjectToXml(slide) {
 						let cellSpanAttrStr = Object.entries(cellSpanAttrs).filter(([, v]) => !!v).map(([k, v]) => `${String(k)}="${String(v)}"`).join(" ");
 						if (cellSpanAttrStr) cellSpanAttrStr = " " + cellSpanAttrStr;
 						if (cell._hmerge || cell._vmerge) {
-							strXml += `<a:tc${cellSpanAttrStr}><a:tcPr/></a:tc>`;
+							const origin = cell._spanOrigin;
+							let spanPrXml = "";
+							if (origin) {
+								const originOpts = origin.options || {};
+								const originBorder = Array.isArray(originOpts.border) ? originOpts.border : null;
+								if (originBorder) spanPrXml += genTableCellBorderXml(originBorder);
+								let spanFill = origin._optImp?.fill?.color ? origin._optImp.fill.color : origin._optImp?.fill && typeof origin._optImp.fill === "string" ? origin._optImp.fill : "";
+								spanFill = spanFill || originOpts.fill ? originOpts.fill : "";
+								if (spanFill) spanPrXml += genXmlColorSelection(spanFill);
+							}
+							strXml += `<a:tc${cellSpanAttrStr}><a:tcPr>${spanPrXml}</a:tcPr></a:tc>`;
 							return;
 						}
 						const cellOpts = cell.options || {};
@@ -3774,32 +4323,7 @@ function slideObjectToXml(slide) {
 						else cellMarginXml = ` marL="${inch2Emu(cellMargin[3])}" marR="${inch2Emu(cellMargin[1])}" marT="${inch2Emu(cellMargin[0])}" marB="${inch2Emu(cellMargin[2])}"`;
 						strXml += `<a:tc${cellSpanAttrStr}>${genXmlTextBody(cell)}<a:tcPr${cellMarginXml}${cellValign}${cellTextDir}>`;
 						const cellBorder = Array.isArray(cellOpts.border) ? cellOpts.border : null;
-						if (cellBorder) [
-							{
-								idx: 3,
-								name: "lnL"
-							},
-							{
-								idx: 1,
-								name: "lnR"
-							},
-							{
-								idx: 0,
-								name: "lnT"
-							},
-							{
-								idx: 2,
-								name: "lnB"
-							}
-						].forEach((obj) => {
-							const border = cellBorder[obj.idx];
-							if (border.type !== "none") {
-								strXml += `<a:${obj.name} w="${valToPts(border.pt)}" cap="flat" cmpd="sng" algn="ctr">`;
-								strXml += `<a:solidFill>${createColorElement(border.color)}</a:solidFill>`;
-								strXml += `<a:prstDash val="${border.type === "dash" ? "sysDash" : "solid"}"/><a:round/><a:headEnd type="none" w="med" len="med"/><a:tailEnd type="none" w="med" len="med"/>`;
-								strXml += `</a:${obj.name}>`;
-							} else strXml += `<a:${obj.name} w="0" cap="flat" cmpd="sng" algn="ctr"><a:noFill/></a:${obj.name}>`;
-						});
+						if (cellBorder) strXml += genTableCellBorderXml(cellBorder);
 						strXml += cellFill;
 						strXml += "  </a:tcPr>";
 						strXml += " </a:tc>";
@@ -3818,10 +4342,10 @@ function slideObjectToXml(slide) {
 				if (!slideItemObj.options.line && cy === 0) cy = EMU * .3;
 				if (!slideItemObj.options._bodyProp) slideItemObj.options._bodyProp = {};
 				if (slideItemObj.options.margin && Array.isArray(slideItemObj.options.margin)) {
-					slideItemObj.options._bodyProp.lIns = valToPts(slideItemObj.options.margin[0] || 0);
+					slideItemObj.options._bodyProp.tIns = valToPts(slideItemObj.options.margin[0] || 0);
 					slideItemObj.options._bodyProp.rIns = valToPts(slideItemObj.options.margin[1] || 0);
 					slideItemObj.options._bodyProp.bIns = valToPts(slideItemObj.options.margin[2] || 0);
-					slideItemObj.options._bodyProp.tIns = valToPts(slideItemObj.options.margin[3] || 0);
+					slideItemObj.options._bodyProp.lIns = valToPts(slideItemObj.options.margin[3] || 0);
 				} else if (typeof slideItemObj.options.margin === "number") {
 					slideItemObj.options._bodyProp.lIns = valToPts(slideItemObj.options.margin);
 					slideItemObj.options._bodyProp.rIns = valToPts(slideItemObj.options.margin);
@@ -3833,7 +4357,11 @@ function slideObjectToXml(slide) {
 				if (slideItemObj.options.hyperlink?.url) strSlideXml += `<a:hlinkClick r:id="rId${slideItemObj.options.hyperlink._rId}" tooltip="${slideItemObj.options.hyperlink.tooltip ? encodeXmlEntities(slideItemObj.options.hyperlink.tooltip) : ""}"/>`;
 				if (slideItemObj.options.hyperlink?.slide) strSlideXml += `<a:hlinkClick r:id="rId${slideItemObj.options.hyperlink._rId}" tooltip="${slideItemObj.options.hyperlink.tooltip ? encodeXmlEntities(slideItemObj.options.hyperlink.tooltip) : ""}" action="ppaction://hlinksldjump"/>`;
 				strSlideXml += "</p:cNvPr>";
-				strSlideXml += "<p:cNvSpPr" + (slideItemObj.options?.isTextBox ? " txBox=\"1\"/>" : "/>");
+				{
+					const spLockXml = genXmlObjectLock("a:spLocks", SHAPE_LOCK_ATTRS, slideItemObj.options.objectLock, slideItemObj.options.objectName);
+					strSlideXml += "<p:cNvSpPr" + (slideItemObj.options?.isTextBox ? " txBox=\"1\"" : "");
+					strSlideXml += spLockXml ? `>${spLockXml}</p:cNvSpPr>` : "/>";
+				}
 				strSlideXml += `<p:nvPr>${slideItemObj._type === "placeholder" ? genXmlPlaceholder(slideItemObj) : genXmlPlaceholder(placeholderObj)}</p:nvPr>`;
 				strSlideXml += "</p:nvSpPr><p:spPr>";
 				strSlideXml += `<a:xfrm${locationAttr}>`;
@@ -3843,7 +4371,8 @@ function slideObjectToXml(slide) {
 				else strSlideXml += genXmlPresetGeom(slideItemObj.shape, slideItemObj.options, cx, cy);
 				strSlideXml += slideItemObj.options.fill ? genXmlColorSelection(slideItemObj.options.fill) : "<a:noFill/>";
 				if (slideItemObj.options.line) {
-					strSlideXml += slideItemObj.options.line.width ? `<a:ln w="${valToPts(slideItemObj.options.line.width)}">` : "<a:ln>";
+					const lnAttrs = (slideItemObj.options.line.width ? ` w="${lineWidthToEmu(slideItemObj.options.line.width)}"` : "") + (slideItemObj.options.line.cap ? ` cap="${createLineCap(slideItemObj.options.line.cap)}"` : "");
+					strSlideXml += `<a:ln${lnAttrs}>`;
 					if (slideItemObj.options.line.color) strSlideXml += genXmlColorSelection(slideItemObj.options.line);
 					if (slideItemObj.options.line.dashType) strSlideXml += `<a:prstDash val="${slideItemObj.options.line.dashType}"/>`;
 					if (slideItemObj.options.line.beginArrowType) strSlideXml += `<a:headEnd type="${slideItemObj.options.line.beginArrowType}"/>`;
@@ -3876,13 +4405,17 @@ function slideObjectToXml(slide) {
 				if (slideItemObj.hyperlink?.url) strSlideXml += `<a:hlinkClick r:id="rId${slideItemObj.hyperlink._rId}" tooltip="${slideItemObj.hyperlink.tooltip ? encodeXmlEntities(slideItemObj.hyperlink.tooltip) : ""}"/>`;
 				if (slideItemObj.hyperlink?.slide) strSlideXml += `<a:hlinkClick r:id="rId${slideItemObj.hyperlink._rId}" tooltip="${slideItemObj.hyperlink.tooltip ? encodeXmlEntities(slideItemObj.hyperlink.tooltip) : ""}" action="ppaction://hlinksldjump"/>`;
 				strSlideXml += "    </p:cNvPr>";
-				strSlideXml += "    <p:cNvPicPr><a:picLocks noChangeAspect=\"1\"/></p:cNvPicPr>";
+				strSlideXml += `    <p:cNvPicPr>${genXmlObjectLock("a:picLocks", PICTURE_LOCK_ATTRS, {
+					noChangeAspect: true,
+					...slideItemObj.options.objectLock
+				}, slideItemObj.options.objectName)}</p:cNvPicPr>`;
 				strSlideXml += "    <p:nvPr>" + genXmlPlaceholder(placeholderObj) + "</p:nvPr>";
 				strSlideXml += "  </p:nvPicPr>";
 				strSlideXml += "<p:blipFill>";
 				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 +4425,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 +4433,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,
@@ -3942,7 +4483,7 @@ function slideObjectToXml(slide) {
 					strSlideXml += "<p:pic>";
 					strSlideXml += " <p:nvPicPr>";
 					strSlideXml += `<p:cNvPr id="${slideItemObj.mediaRid + 2}" name="${slideItemObj.options.objectName}" descr="${encodeXmlEntities(slideItemObj.options.altText || "")}"/>`;
-					strSlideXml += " <p:cNvPicPr/>";
+					strSlideXml += ` <p:cNvPicPr>${genXmlObjectLock("a:picLocks", PICTURE_LOCK_ATTRS, slideItemObj.options.objectLock, slideItemObj.options.objectName)}</p:cNvPicPr>`;
 					strSlideXml += " <p:nvPr>";
 					strSlideXml += `  <a:videoFile r:link="rId${slideItemObj.mediaRid}"/>`;
 					strSlideXml += " </p:nvPr>";
@@ -3957,7 +4498,10 @@ function slideObjectToXml(slide) {
 					strSlideXml += "<p:pic>";
 					strSlideXml += " <p:nvPicPr>";
 					strSlideXml += `<p:cNvPr id="${slideItemObj.mediaRid + 2}" name="${slideItemObj.options.objectName}" descr="${encodeXmlEntities(slideItemObj.options.altText || "")}"><a:hlinkClick r:id="" action="ppaction://media"/></p:cNvPr>`;
-					strSlideXml += " <p:cNvPicPr><a:picLocks noChangeAspect=\"1\"/></p:cNvPicPr>";
+					strSlideXml += ` <p:cNvPicPr>${genXmlObjectLock("a:picLocks", PICTURE_LOCK_ATTRS, {
+						noChangeAspect: true,
+						...slideItemObj.options.objectLock
+					}, slideItemObj.options.objectName)}</p:cNvPicPr>`;
 					strSlideXml += " <p:nvPr>";
 					strSlideXml += `  <a:videoFile r:link="rId${slideItemObj.mediaRid}"/>`;
 					strSlideXml += "  <p:extLst>";
@@ -4021,7 +4565,7 @@ function slideObjectToXml(slide) {
 		strSlideXml += "/>";
 		strSlideXml += "  <a:lstStyle><a:lvl1pPr>";
 		if (slide._slideNumberProps.fontFace || slide._slideNumberProps.fontSize || slide._slideNumberProps.color) {
-			strSlideXml += `<a:defRPr sz="${Math.round((slide._slideNumberProps.fontSize || 12) * 100)}">`;
+			strSlideXml += `<a:defRPr sz="${clampFontSizeSz(slide._slideNumberProps.fontSize || 12)}">`;
 			if (slide._slideNumberProps.color) strSlideXml += genXmlColorSelection(slide._slideNumberProps.color);
 			if (slide._slideNumberProps.fontFace) strSlideXml += `<a:latin typeface="${slide._slideNumberProps.fontFace}"/><a:ea typeface="${slide._slideNumberProps.fontFace}"/><a:cs typeface="${slide._slideNumberProps.fontFace}"/>`;
 			strSlideXml += "</a:defRPr>";
@@ -4110,7 +4654,7 @@ function genXmlParagraphProperties(textObj, isDefault) {
 			paragraphPropXml += "";
 			break;
 	}
-	if (textObj.options.lineSpacing) strXmlLnSpc = `<a:lnSpc><a:spcPts val="${Math.round(textObj.options.lineSpacing * 100)}"/></a:lnSpc>`;
+	if (textObj.options.lineSpacing) strXmlLnSpc = `<a:lnSpc><a:spcPts val="${clampLineSpacingPts(textObj.options.lineSpacing)}"/></a:lnSpc>`;
 	else if (textObj.options.lineSpacingMultiple) strXmlLnSpc = `<a:lnSpc><a:spcPct val="${Math.round(textObj.options.lineSpacingMultiple * 1e5)}"/></a:lnSpc>`;
 	if (textObj.options.indentLevel && !isNaN(Number(textObj.options.indentLevel)) && textObj.options.indentLevel > 0) paragraphPropXml += ` lvl="${textObj.options.indentLevel}"`;
 	if (textObj.options.paraSpaceBefore && !isNaN(Number(textObj.options.paraSpaceBefore)) && textObj.options.paraSpaceBefore > 0) strXmlParaSpc += `<a:spcBef><a:spcPts val="${Math.round(textObj.options.paraSpaceBefore * 100)}"/></a:spcBef>`;
@@ -4164,7 +4708,7 @@ function genXmlTextRunProperties(opts, isDefault) {
 	let runProps = "";
 	const runPropsTag = isDefault ? "a:defRPr" : "a:rPr";
 	runProps += "<" + runPropsTag + " lang=\"" + (opts.lang ? opts.lang : "en-US") + "\"" + (opts.lang ? " altLang=\"en-US\"" : "");
-	runProps += opts.fontSize ? ` sz="${Math.round(opts.fontSize * 100)}"` : "";
+	runProps += opts.fontSize ? ` sz="${clampFontSizeSz(opts.fontSize)}"` : "";
 	runProps += opts?.bold ? ` b="${opts.bold ? "1" : "0"}"` : "";
 	runProps += opts?.italic ? ` i="${opts.italic ? "1" : "0"}"` : "";
 	runProps += opts?.strike ? ` strike="${typeof opts.strike === "string" ? opts.strike : "sngStrike"}"` : "";
@@ -4175,17 +4719,23 @@ function genXmlTextRunProperties(opts, isDefault) {
 	if (opts.baseline) runProps += ` baseline="${Math.round(opts.baseline * 50)}"`;
 	else if (opts.subscript) runProps += " baseline=\"-40000\"";
 	else if (opts.superscript) runProps += " baseline=\"30000\"";
-	runProps += opts.charSpacing ? ` spc="${Math.round(opts.charSpacing * 100)}" kern="0"` : "";
+	runProps += opts.charSpacing ? ` spc="${clampCharSpacingSpc(opts.charSpacing)}" kern="0"` : "";
 	runProps += " dirty=\"0\">";
-	if (opts.color || opts.fontFace || opts.outline || typeof opts.underline === "object" && opts.underline.color) {
-		if (opts.outline && typeof opts.outline === "object") runProps += `<a:ln w="${valToPts(opts.outline.size || .75)}">${genXmlColorSelection(opts.outline.color || "FFFFFF")}</a:ln>`;
+	const hasShadow = !!opts.shadow && opts.shadow.type !== "none";
+	if (opts.color || opts.fontFace || opts.outline || opts.glow || hasShadow || typeof opts.underline === "object" && opts.underline.color) {
+		if (opts.outline && typeof opts.outline === "object") runProps += `<a:ln w="${lineWidthToEmu(opts.outline.size || .75)}">${genXmlColorSelection(opts.outline.color || "FFFFFF")}</a:ln>`;
 		if (opts.color) runProps += genXmlColorSelection({
 			color: opts.color,
 			transparency: opts.transparency
 		});
+		if (opts.glow || hasShadow) {
+			runProps += "<a:effectLst>";
+			if (opts.glow) runProps += createGlowElement(opts.glow, DEF_TEXT_GLOW);
+			if (hasShadow) runProps += createShadowElement$1(opts.shadow, DEF_TEXT_SHADOW);
+			runProps += "</a:effectLst>";
+		}
 		if (opts.highlight) runProps += `<a:highlight>${createColorElement(opts.highlight)}</a:highlight>`;
 		if (typeof opts.underline === "object" && opts.underline.color) runProps += `<a:uFill>${genXmlColorSelection(opts.underline.color)}</a:uFill>`;
-		if (opts.glow) runProps += `<a:effectLst>${createGlowElement(opts.glow, DEF_TEXT_GLOW)}</a:effectLst>`;
 		if (opts.fontFace) runProps += `<a:latin typeface="${opts.fontFace}" pitchFamily="34" charset="0"/><a:ea typeface="${opts.fontFace}" pitchFamily="34" charset="-122"/><a:cs typeface="${opts.fontFace}" pitchFamily="34" charset="-120"/>`;
 	}
 	if (opts.hyperlink) {
@@ -4215,6 +4765,28 @@ function genXmlTextRun(textObj) {
 	return `<a:r>${genXmlTextRunProperties(textObj.options, false)}<a:t>${encodeXmlEntities(String(textObj.text))}</a:t></a:r>`;
 }
 /**
+* Builds `<a:normAutofit>` with explicit fontScale/lnSpcReduction for "shrink text on overflow"
+* @param {TextFitShrinkProps} fit - shrink fit options
+* @return {string} XML string (`<a:normAutofit .../>`)
+* @see ECMA-376 CT_TextNormAutofit (attributes in 1000ths of a percent)
+*/
+function genXmlNormAutofit(fit) {
+	let attrs = "";
+	const pct = (val, name) => {
+		if (val === void 0 || val === null) return null;
+		if (typeof val !== "number" || isNaN(val) || val < 0 || val > 100) {
+			console.warn(`Warning: fit.${name} must be a number between 0 and 100 (percent); received ${String(val)} - attribute ignored.`);
+			return null;
+		}
+		return Math.round(val * 1e3);
+	};
+	const fontScale = pct(fit.fontScale, "fontScale");
+	if (fontScale !== null) attrs += ` fontScale="${fontScale}"`;
+	const lnSpcReduction = pct(fit.lnSpcReduction, "lnSpcReduction");
+	if (lnSpcReduction !== null) attrs += ` lnSpcReduction="${lnSpcReduction}"`;
+	return `<a:normAutofit${attrs}/>`;
+}
+/**
 * Builds `<a:bodyPr></a:bodyPr>` tag for "genXmlTextBody()"
 * @param {ISlideObject | TableCell} slideObject - various options
 * @return {string} XML string
@@ -4227,6 +4799,8 @@ function genXmlBodyProperties(slideObject) {
 		if (slideObject.options._bodyProp.tIns || slideObject.options._bodyProp.tIns === 0) bodyProperties += ` tIns="${slideObject.options._bodyProp.tIns}"`;
 		if (slideObject.options._bodyProp.rIns || slideObject.options._bodyProp.rIns === 0) bodyProperties += ` rIns="${slideObject.options._bodyProp.rIns}"`;
 		if (slideObject.options._bodyProp.bIns || slideObject.options._bodyProp.bIns === 0) bodyProperties += ` bIns="${slideObject.options._bodyProp.bIns}"`;
+		if (slideObject.options._bodyProp.numCol) bodyProperties += ` numCol="${slideObject.options._bodyProp.numCol}"`;
+		if (slideObject.options._bodyProp.spcCol) bodyProperties += ` spcCol="${slideObject.options._bodyProp.spcCol}"`;
 		bodyProperties += " rtlCol=\"0\"";
 		if (slideObject.options._bodyProp.anchor) bodyProperties += " anchor=\"" + slideObject.options._bodyProp.anchor + "\"";
 		if (slideObject.options._bodyProp.vert) bodyProperties += " vert=\"" + slideObject.options._bodyProp.vert + "\"";
@@ -4237,9 +4811,11 @@ function genXmlBodyProperties(slideObject) {
 		* @see: http://www.datypic.com/sc/ooxml/g-a_EG_TextAutofit.html
 		*/
 		if (slideObject.options.fit) {
-			if (slideObject.options.fit === "none") bodyProperties += "";
-			else if (slideObject.options.fit === "shrink") bodyProperties += "<a:normAutofit/>";
-			else if (slideObject.options.fit === "resize") bodyProperties += "<a:spAutoFit/>";
+			const fit = slideObject.options.fit;
+			if (fit === "none") bodyProperties += "";
+			else if (fit === "shrink") bodyProperties += "<a:normAutofit/>";
+			else if (fit === "resize") bodyProperties += "<a:spAutoFit/>";
+			else if (typeof fit === "object" && fit.type === "shrink") bodyProperties += genXmlNormAutofit(fit);
 		}
 		if (slideObject.options.shrinkText) bodyProperties += "<a:normAutofit/>";
 		bodyProperties += slideObject.options._bodyProp.autoFit ? "<a:spAutoFit/>" : "";
@@ -4298,14 +4874,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 = [];
@@ -4370,13 +4951,13 @@ function genXmlTextBody(slideObj) {
 			}
 		});
 		if (slideObj._type === "tablecell" && (opts.fontSize || opts.fontFace)) if (opts.fontFace) {
-			strSlideXml += `<a:endParaRPr lang="${opts.lang || "en-US"}"` + (opts.fontSize ? ` sz="${Math.round(opts.fontSize * 100)}"` : "") + " dirty=\"0\">";
+			strSlideXml += `<a:endParaRPr lang="${opts.lang || "en-US"}"` + (opts.fontSize ? ` sz="${clampFontSizeSz(opts.fontSize)}"` : "") + " dirty=\"0\">";
 			strSlideXml += `<a:latin typeface="${opts.fontFace}" charset="0"/>`;
 			strSlideXml += `<a:ea typeface="${opts.fontFace}" charset="0"/>`;
 			strSlideXml += `<a:cs typeface="${opts.fontFace}" charset="0"/>`;
 			strSlideXml += "</a:endParaRPr>";
-		} else strSlideXml += `<a:endParaRPr lang="${opts.lang || "en-US"}"` + (opts.fontSize ? ` sz="${Math.round(opts.fontSize * 100)}"` : "") + " dirty=\"0\"/>";
-		else if (reqsClosingFontSize) strSlideXml += `<a:endParaRPr lang="${opts.lang || "en-US"}"` + (opts.fontSize ? ` sz="${Math.round(opts.fontSize * 100)}"` : "") + " dirty=\"0\"/>";
+		} else strSlideXml += `<a:endParaRPr lang="${opts.lang || "en-US"}"` + (opts.fontSize ? ` sz="${clampFontSizeSz(opts.fontSize)}"` : "") + " dirty=\"0\"/>";
+		else if (reqsClosingFontSize) strSlideXml += `<a:endParaRPr lang="${opts.lang || "en-US"}"` + (opts.fontSize ? ` sz="${clampFontSizeSz(opts.fontSize)}"` : "") + " dirty=\"0\"/>";
 		else strSlideXml += `<a:endParaRPr lang="${opts.lang || "en-US"}" dirty="0"/>`;
 		strSlideXml += "</a:p>";
 	});
@@ -4407,7 +4988,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 +5038,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 +5046,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 +5120,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 +5313,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 +5352,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="${lineWidthToEmu(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 +5511,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.3.0";
 function standardLayoutToPresLayout(layout) {
 	return {
 		name: layout.name,
@@ -4924,6 +5612,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 +5646,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 +5658,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 +5743,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 +5759,8 @@ var PptxGenJS = class {
 		}];
 		this._slides = [];
 		this._sections = [];
+		this._customProperties = [];
+		this._tableStyles = [];
 		this._masterSlide = {
 			addChart: null,
 			addImage: null,
@@ -5086,7 +5789,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);
 	};
 	/**
@@ -5139,6 +5843,18 @@ var PptxGenJS = class {
 		});
 		arrMediaPromises = arrMediaPromises.concat(encodeSlideMediaRels(this._masterSlide, this._runtime));
 		return await Promise.all(arrMediaPromises).then(async () => {
+			const canonicalMediaTargets = /* @__PURE__ */ new Map();
+			for (const target of [
+				...this._slides,
+				...this._slideLayouts,
+				this._masterSlide
+			]) for (const rel of target._relsMedia || []) {
+				if (rel.type === "online" || rel.type === "hyperlink" || typeof rel.data !== "string" || !rel.data) continue;
+				const key = (rel.extn || "") + "\0" + rel.data;
+				const canonical = canonicalMediaTargets.get(key);
+				if (canonical) rel.Target = canonical;
+				else canonicalMediaTargets.set(key, rel.Target);
+			}
 			this._slides.forEach((slide) => {
 				if (slide._slideLayout) addPlaceholdersToSlideLayouts(slide);
 			});
@@ -5156,16 +5872,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 +5963,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 +6084,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 +6120,4 @@ var PptxGenJS = class {
 //#endregion
 export { PptxGenJS as t };
 
-//# sourceMappingURL=pptxgen-3gNqxx8n.js.map
+//# sourceMappingURL=pptxgen-B-mAxCRC.js.map