@shbernal/pptxgenjs 5.0.1 → 5.0.2

package/dist/{pptxgen-D4hSJlcN.js → pptxgen-1VITjpGE.js}

@@ -1,4 +1,5 @@
-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-BkfumA6H.js";
+import { c as inchesToEmu, i as STANDARD_LAYOUTS } from "./units-Bmst2HBb.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-CZn5br4v.js";
 import JSZip from "jszip";
 //#region src/gen-utils.ts
 /**
@@ -143,6 +144,51 @@ function createGlowElement(options, defaults) {
 	strXml += "</a:glow>";
 	return strXml;
 }
+function boolToXml(value) {
+	return value ? "1" : "0";
+}
+function normalizeGradientAngle(angle) {
+	const degrees = angle ?? 0;
+	if (typeof degrees !== "number" || !Number.isFinite(degrees)) throw new Error("Gradient angle must be a finite number.");
+	return convertRotationDegrees((degrees % 360 + 360) % 360);
+}
+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)}"/>`;
+	return internalElements;
+}
+function normalizeGradientStops(stops) {
+	if (!Array.isArray(stops) || stops.length < 2) throw new Error("Gradient fill requires at least two stops.");
+	return stops.map((stop) => {
+		if (!stop || typeof stop.position !== "number" || !Number.isFinite(stop.position)) throw new Error("Gradient stop position must be a finite number from 0 to 100.");
+		if (stop.position < 0 || stop.position > 100) throw new Error("Gradient stop position must be from 0 to 100.");
+		return stop;
+	}).sort((a, b) => a.position - b.position);
+}
+/**
+* Create a native DrawingML gradient fill.
+* @param {GradientFillProps} gradient gradient fill options
+* @returns XML string
+*/
+function genXmlGradientFill(gradient) {
+	if (!gradient || gradient.kind !== "linear") throw new Error("Gradient fill currently supports only linear gradients.");
+	if (typeof gradient.rotateWithShape !== "undefined" && typeof gradient.rotateWithShape !== "boolean") throw new Error("Gradient rotateWithShape must be a boolean.");
+	if (typeof gradient.scaled !== "undefined" && typeof gradient.scaled !== "boolean") throw new Error("Gradient scaled must be a boolean.");
+	const stops = normalizeGradientStops(gradient.stops);
+	const rotWithShape = gradient.rotateWithShape ?? true;
+	const scaledAttr = typeof gradient.scaled === "boolean" ? ` scaled="${boolToXml(gradient.scaled)}"` : "";
+	let strXml = `<a:gradFill rotWithShape="${boolToXml(rotWithShape)}">`;
+	strXml += "<a:gsLst>";
+	stops.forEach((stop) => {
+		const position = Math.round(stop.position * 1e3);
+		strXml += `<a:gs pos="${position}">${createColorElement(stop.color, gradientStopColorAdjustments(stop))}</a:gs>`;
+	});
+	strXml += "</a:gsLst>";
+	strXml += `<a:lin ang="${normalizeGradientAngle(gradient.angle)}"${scaledAttr}/>`;
+	strXml += "</a:gradFill>";
+	return strXml;
+}
 /**
 * Create color selection
 * @param {Color | ShapeFillProps | ShapeLineProps} props fill props
@@ -165,6 +211,9 @@ function genXmlColorSelection(props) {
 			case "solid":
 				outText += `<a:solidFill>${createColorElement(colorVal, internalElements)}</a:solidFill>`;
 				break;
+			case "gradient":
+				outText += genXmlGradientFill(typeof props === "string" ? void 0 : props.gradient);
+				break;
 			default:
 				outText += "";
 				break;
@@ -372,7 +421,7 @@ function getSlidesForTableRows(tableRows = [], tableProps = {}, presLayout, mast
 			if (typeof tableProps.autoPageSlideStartY === "number") emuSlideTabH = (tablePropH || presLayout.height) - inch2Emu(tableProps.autoPageSlideStartY + arrInchMargins[2]);
 			else if (typeof tableProps.newSlideStartY === "number") emuSlideTabH = (tablePropH || presLayout.height) - inch2Emu(tableProps.newSlideStartY + arrInchMargins[2]);
 			else if (tablePropY) {
-				emuSlideTabH = (tablePropH || presLayout.height) - inch2Emu((tablePropY / 914400 < arrInchMargins[0] ? tablePropY / EMU : arrInchMargins[0]) + arrInchMargins[2]);
+				emuSlideTabH = (tablePropH || presLayout.height) - inch2Emu((tablePropY / EMU < arrInchMargins[0] ? tablePropY / EMU : arrInchMargins[0]) + arrInchMargins[2]);
 				if (emuSlideTabH < tablePropH) emuSlideTabH = tablePropH;
 			}
 		}
@@ -427,7 +476,7 @@ function getSlidesForTableRows(tableRows = [], tableProps = {}, presLayout, mast
 		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}`);
 	}
-	emuSlideTabW = tableCalcW || inch2Emu((tablePropX ? tablePropX / 914400 : arrInchMargins[1]) + arrInchMargins[3]);
+	emuSlideTabW = tableCalcW || inch2Emu((tablePropX ? tablePropX / EMU : arrInchMargins[1]) + arrInchMargins[3]);
 	if (tableProps.verbose) console.log(`| emuSlideTabW .................................... = ${(emuSlideTabW / EMU).toFixed(1)}`);
 	if (!tableProps.colW || !Array.isArray(tableProps.colW)) if (tableProps.colW && !isNaN(Number(tableProps.colW))) {
 		const arrColW = [];
@@ -1454,8 +1503,8 @@ function addTableDefinition(target, tableRows, options, slideLayout, presLayout,
 		}
 		arrRows.push(newRow);
 	});
-	opt.x = getSmartParseNumber(opt.x || (opt.x === 0 ? 0 : 914400 / 2), "X", presLayout);
-	opt.y = getSmartParseNumber(opt.y || (opt.y === 0 ? 0 : 914400 / 2), "Y", presLayout);
+	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);
 	opt.fontSize = opt.fontSize || 12;
 	opt.margin = opt.margin === 0 || opt.margin ? opt.margin : DEF_CELL_MARGIN_IN;
@@ -2947,7 +2996,9 @@ function makeChartType(chartType, data, opts, valAxisId, catAxisId) {
 */
 function makeCatAxis(opts, axisId, valAxisId) {
 	let strXml = "";
-	if (opts._type === "scatter" || opts._type === "bubble" || opts._type === "bubble3D") strXml += "<c:valAx>";
+	const usesValueAxisForCategories = opts._type === "scatter" || opts._type === "bubble" || opts._type === "bubble3D";
+	const usesCategoryAxis = !usesValueAxisForCategories && !opts.catLabelFormatCode;
+	if (usesValueAxisForCategories) strXml += "<c:valAx>";
 	else strXml += "<c:" + (opts.catLabelFormatCode ? "dateAx" : "catAx") + ">";
 	strXml += "  <c:axId val=\"" + axisId + "\"/>";
 	strXml += "  <c:scaling>";
@@ -2998,12 +3049,16 @@ function makeCatAxis(opts, axisId, valAxisId) {
 	strXml += "  </a:p>";
 	strXml += " </c:txPr>";
 	strXml += " <c:crossAx val=\"" + valAxisId + "\"/>";
-	strXml += ` <c:${typeof opts.valAxisCrossesAt === "number" ? "crossesAt" : "crosses"} val="${opts.valAxisCrossesAt || "autoZero"}"/>`;
-	strXml += " <c:auto val=\"1\"/>";
-	strXml += " <c:lblAlgn val=\"ctr\"/>";
-	strXml += ` <c:noMultiLvlLbl val="${opts.catAxisMultiLevelLabels ? 0 : 1}"/>`;
-	if (opts.catAxisLabelFrequency) strXml += " <c:tickLblSkip val=\"" + opts.catAxisLabelFrequency + "\"/>";
-	if (opts.catLabelFormatCode || opts._type === "scatter" || opts._type === "bubble" || opts._type === "bubble3D") {
+	const valAxisCrossTag = typeof opts.valAxisCrossesAt === "number" ? "crossesAt" : "crosses";
+	const valAxisCrossValue = typeof opts.valAxisCrossesAt === "number" ? opts.valAxisCrossesAt : opts.valAxisCrossesAt || "autoZero";
+	strXml += ` <c:${valAxisCrossTag} val="${valAxisCrossValue}"/>`;
+	if (!usesValueAxisForCategories) strXml += " <c:auto val=\"1\"/>";
+	if (usesCategoryAxis) {
+		strXml += " <c:lblAlgn val=\"ctr\"/>";
+		if (opts.catAxisLabelFrequency) strXml += " <c:tickLblSkip val=\"" + opts.catAxisLabelFrequency + "\"/>";
+		strXml += ` <c:noMultiLvlLbl val="${opts.catAxisMultiLevelLabels ? 0 : 1}"/>`;
+	}
+	if (opts.catLabelFormatCode || usesValueAxisForCategories) {
 		if (opts.catLabelFormatCode) {
 			[
 				"catAxisBaseTimeUnit",
@@ -3023,7 +3078,7 @@ function makeCatAxis(opts, axisId, valAxisId) {
 		if (opts.catAxisMajorUnit) strXml += `<c:majorUnit val="${opts.catAxisMajorUnit}"/>`;
 		if (opts.catAxisMinorUnit) strXml += `<c:minorUnit val="${opts.catAxisMinorUnit}"/>`;
 	}
-	if (opts._type === "scatter" || opts._type === "bubble" || opts._type === "bubble3D") strXml += "</c:valAx>";
+	if (usesValueAxisForCategories) strXml += "</c:valAx>";
 	else strXml += "</c:" + (opts.catLabelFormatCode ? "dateAx" : "catAx") + ">";
 	return strXml;
 }
@@ -3367,7 +3422,7 @@ function slideObjectToXml(slide) {
 	let strSlideXml = slide._name ? "<p:cSld name=\"" + slide._name + "\">" : "<p:cSld>";
 	let intTableNum = 1;
 	if (slide._bkgdImgRid) strSlideXml += `<p:bg><p:bgPr><a:blipFill dpi="0" rotWithShape="1"><a:blip r:embed="rId${slide._bkgdImgRid}"><a:lum/></a:blip><a:srcRect/><a:stretch><a:fillRect/></a:stretch></a:blipFill><a:effectLst/></p:bgPr></p:bg>`;
-	else if (slide.background?.color) strSlideXml += `<p:bg><p:bgPr>${genXmlColorSelection(slide.background)}<a:effectLst/></p:bgPr></p:bg>`;
+	else if (slide.background?.color || slide.background?.type === "gradient") strSlideXml += `<p:bg><p:bgPr>${genXmlColorSelection(slide.background)}<a:effectLst/></p:bgPr></p:bg>`;
 	else if (!slide.bkgd && slide._name && slide._name === "DEFAULT") strSlideXml += "<p:bg><p:bgRef idx=\"1001\"><a:schemeClr val=\"bg1\"/></p:bgRef></p:bg>";
 	strSlideXml += "<p:spTree>";
 	strSlideXml += "<p:nvGrpSpPr><p:cNvPr id=\"1\" name=\"\"/><p:cNvGrpSpPr/><p:nvPr/></p:nvGrpSpPr>";
@@ -3416,7 +3471,7 @@ function slideObjectToXml(slide) {
 				});
 				strXml = `<p:graphicFrame><p:nvGraphicFramePr><p:cNvPr id="${intTableNum * slide._slideNum + 1}" name="${slideItemObj.options.objectName}"/>`;
 				strXml += "<p:cNvGraphicFramePr><a:graphicFrameLocks noGrp=\"1\"/></p:cNvGraphicFramePr>  <p:nvPr><p:extLst><p:ext uri=\"{D42A27DB-BD31-4B8C-83A1-F6EECF244321}\"><p14:modId xmlns:p14=\"http://schemas.microsoft.com/office/powerpoint/2010/main\" val=\"1579011935\"/></p:ext></p:extLst></p:nvPr></p:nvGraphicFramePr>";
-				strXml += `<p:xfrm><a:off x="${x || (x === 0 ? 0 : 914400)}" y="${y || (y === 0 ? 0 : 914400)}"/><a:ext cx="${cx || (cx === 0 ? 0 : 914400)}" cy="${cy || 914400}"/></p:xfrm>`;
+				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/>";
 				if (Array.isArray(objTabOpts.colW)) {
 					strXml += "<a:tblGrid>";
@@ -3666,7 +3721,7 @@ function slideObjectToXml(slide) {
 					strSlideXml += ` <a:${shadowType}Shdw ${shadowType === "outer" ? "sx=\"100000\" sy=\"100000\" kx=\"0\" ky=\"0\" algn=\"bl\" rotWithShape=\"0\"" : ""} blurRad="${shadowBlur}" dist="${shadowOffset}" dir="${shadowAngle}">`;
 					strSlideXml += ` <a:srgbClr val="${shadowColor}">`;
 					strSlideXml += ` <a:alpha val="${shadowOpacity}"/></a:srgbClr>`;
-					strSlideXml += " </a:outerShdw>";
+					strSlideXml += ` </a:${shadowType}Shdw>`;
 					strSlideXml += "</a:effectLst>";
 				}
 				strSlideXml += "</p:spPr>";
@@ -4309,7 +4364,7 @@ function makeXmlApp(slides, company) {
 			${slides.map((_slideObj, idx) => `<vt:lpstr>Slide ${idx + 1}</vt:lpstr>`).join("")}
 		</vt:vector>
 	</TitlesOfParts>
-	<Company>${company}</Company>
+	<Company>${encodeXmlEntities(company)}</Company>
 	<LinksUpToDate>false</LinksUpToDate>
 	<SharedDoc>false</SharedDoc>
 	<HyperlinksChanged>false</HyperlinksChanged>
@@ -4623,7 +4678,14 @@ 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.0.1";
+const VERSION = "5.0.2";
+function standardLayoutToPresLayout(layout) {
+	return {
+		name: layout.name,
+		width: layout.widthEmu,
+		height: layout.heightEmu
+	};
+}
 var PptxGenJS = class {
 	/**
 	* Presentation layout name
@@ -4631,7 +4693,7 @@ var PptxGenJS = class {
 	* - 'LAYOUT_4x3'   (10"    x 7.5")
 	* - 'LAYOUT_16x9'  (10"    x 5.625")
 	* - 'LAYOUT_16x10' (10"    x 6.25")
-	* - 'LAYOUT_WIDE'  (13.33" x 7.5")
+	* - 'LAYOUT_WIDE'  (13.333" x 7.5")
 	* Custom layouts:
 	* Use `pptx.defineLayout()` to create custom layouts (e.g.: 'A4')
 	* @type {string}
@@ -4817,31 +4879,11 @@ var PptxGenJS = class {
 	_runtime;
 	constructor(runtime) {
 		this._runtime = runtime;
-		const layout4x3 = {
-			name: "screen4x3",
-			width: 9144e3,
-			height: 6858e3
-		};
-		const layout16x9 = {
-			name: "screen16x9",
-			width: 9144e3,
-			height: 5143500
-		};
-		const layout16x10 = {
-			name: "screen16x10",
-			width: 9144e3,
-			height: 5715e3
-		};
-		const layoutWide = {
-			name: "custom",
-			width: 12192e3,
-			height: 6858e3
-		};
 		this.LAYOUTS = {
-			LAYOUT_4x3: layout4x3,
-			LAYOUT_16x9: layout16x9,
-			LAYOUT_16x10: layout16x10,
-			LAYOUT_WIDE: layoutWide
+			LAYOUT_4x3: standardLayoutToPresLayout(STANDARD_LAYOUTS.LAYOUT_4x3),
+			LAYOUT_16x9: standardLayoutToPresLayout(STANDARD_LAYOUTS.LAYOUT_16x9),
+			LAYOUT_16x10: standardLayoutToPresLayout(STANDARD_LAYOUTS.LAYOUT_16x10),
+			LAYOUT_WIDE: standardLayoutToPresLayout(STANDARD_LAYOUTS.LAYOUT_WIDE)
 		};
 		this._author = "PptxGenJS";
 		this._company = "PptxGenJS";
@@ -5132,10 +5174,10 @@ var PptxGenJS = class {
 		else if (typeof layout.width !== "number") console.warn("defineLayout `width` should be a number (inches)");
 		this.LAYOUTS[layout.name] = {
 			name: layout.name,
-			_sizeW: Math.round(Number(layout.width) * EMU),
-			_sizeH: Math.round(Number(layout.height) * EMU),
-			width: Math.round(Number(layout.width) * EMU),
-			height: Math.round(Number(layout.height) * EMU)
+			_sizeW: inchesToEmu(Number(layout.width)),
+			_sizeH: inchesToEmu(Number(layout.height)),
+			width: inchesToEmu(Number(layout.width)),
+			height: inchesToEmu(Number(layout.height))
 		};
 	}
 	/**
@@ -5176,4 +5218,4 @@ var PptxGenJS = class {
 //#endregion
 export { PptxGenJS as t };
 
-//# sourceMappingURL=pptxgen-D4hSJlcN.js.map
+//# sourceMappingURL=pptxgen-1VITjpGE.js.map