@office-open/pptx 0.6.2 → 0.6.3

package/dist/index.mjs

@@ -4,6 +4,7 @@ import { BevelPresetType, CompoundLine, LineCap, LineJoin, PathShadeType, PenAli
 import { ChartCollection, ChartSpace } from "@office-open/core/chart";
 import { DEFAULT_DRAWING_XML, SmartArtCollection, createDataModel, getColorXml, getLayoutXml, getStyleXml } from "@office-open/core/smartart";
 import { attr, attrBool, attrNum, children, findChild, findDeep, textOf, xml } from "@office-open/xml";
+import { toUint8Array } from "undio";
 export * from "@office-open/core/values";
 //#region src/file/drawingml/effects.ts
 /** Convert PPTX simple color to core SolidFillOptions. */
@@ -5191,6 +5192,274 @@ var ParseContext = class {
 	}
 };
 //#endregion
+//#region src/parse/animation.ts
+/**
+* Animation parser for PPTX documents.
+*
+* Parses p:timing elements and maps animations to their target shapes.
+*
+* @module
+*/
+const ENTR_PRESET_TO_TYPE = /* @__PURE__ */ new Map();
+const EXIT_PRESET_TO_TYPE = /* @__PURE__ */ new Map();
+const EMPH_PRESET_TO_ID = /* @__PURE__ */ new Map();
+const PATH_PRESET_TO_TYPE = /* @__PURE__ */ new Map();
+const ENTR_IDS = {
+	appear: 1,
+	fade: 10,
+	fly: 2,
+	wipe: 22,
+	dissolve: 34,
+	split: 21,
+	blinds: 25,
+	checker: 26,
+	randomBars: 24,
+	wheel: 27,
+	zoom: 10,
+	cover: 28,
+	push: 19,
+	strips: 23
+};
+const EXIT_IDS = {
+	appear: 53,
+	fade: 59,
+	fly: 51,
+	wipe: 72,
+	dissolve: 84,
+	split: 71,
+	blinds: 75,
+	checker: 76,
+	randomBars: 74,
+	wheel: 77,
+	zoom: 60,
+	cover: 78,
+	push: 69,
+	strips: 73
+};
+const EMPH_IDS = {
+	growShrink: 53,
+	spin: 54,
+	growWithTurn: 56,
+	colorChange: 29,
+	transparency: 57,
+	boldFlash: 50,
+	wave: 55,
+	pulse: 58
+};
+const PATH_IDS = {
+	customPath: 200,
+	arc: 201,
+	bounce: 202,
+	circle: 203,
+	curve: 204,
+	figureEight: 205,
+	line: 206,
+	loop: 207
+};
+for (const [k, v] of Object.entries(ENTR_IDS)) ENTR_PRESET_TO_TYPE.set(v, k);
+for (const [k, v] of Object.entries(EXIT_IDS)) EXIT_PRESET_TO_TYPE.set(v, k);
+for (const [k, v] of Object.entries(EMPH_IDS)) EMPH_PRESET_TO_ID.set(v, k);
+for (const [k, v] of Object.entries(PATH_IDS)) PATH_PRESET_TO_TYPE.set(v, k);
+const SUBTYPE_TO_DIRECTION = /* @__PURE__ */ new Map();
+for (const [k, v] of Object.entries({
+	left: 4,
+	right: 8,
+	up: 2,
+	down: 1,
+	horizontal: 16,
+	vertical: 32
+})) SUBTYPE_TO_DIRECTION.set(v, k);
+/**
+* Parse p:timing element and return a map of shape ID → AnimationOptions.
+*/
+function parseTiming(el) {
+	const result = /* @__PURE__ */ new Map();
+	const tnLst = findChild(el, "p:tnLst");
+	if (!tnLst) return result;
+	const mainPar = findChild(tnLst, "p:par");
+	if (!mainPar) return result;
+	const mainCTn = findChild(mainPar, "p:cTn");
+	if (!mainCTn) return result;
+	const childTnLst = findChild(mainCTn, "p:childTnLst");
+	if (!childTnLst) return result;
+	const seq = findChild(childTnLst, "p:seq");
+	if (!seq) return result;
+	const seqCTn = findChild(seq, "p:cTn");
+	const seqChildTnLst = seqCTn ? findChild(seqCTn, "p:childTnLst") : void 0;
+	if (!seqChildTnLst) return result;
+	for (const parEl of seqChildTnLst.elements ?? []) {
+		if (parEl.name !== "p:par") continue;
+		const parCTn = findChild(parEl, "p:cTn");
+		if (!parCTn) continue;
+		const parChildTnLst = findChild(parCTn, "p:childTnLst");
+		if (!parChildTnLst) continue;
+		for (const effectEl of parChildTnLst.elements ?? []) {
+			const anim = parseAnimationEffect(effectEl);
+			if (!anim) continue;
+			const shapeId = extractTargetShapeId(effectEl);
+			if (shapeId !== void 0) result.set(shapeId, anim);
+		}
+	}
+	return result;
+}
+function parseAnimationEffect(el) {
+	const opts = {};
+	const cTn = findChild(el, "p:cTn") ?? el;
+	const nodeType = attr(cTn, "nodeType");
+	if (nodeType === "clickEffect") opts.trigger = "onClick";
+	else if (nodeType === "withEffect") opts.trigger = "withPrevious";
+	else if (nodeType === "afterEffect") opts.trigger = "afterPrevious";
+	const presetClass = attr(cTn, "presetClass");
+	if (presetClass) opts.class = presetClass;
+	const presetID = attrNum(cTn, "presetID");
+	const dur = attr(cTn, "dur");
+	if (dur) {
+		const ms = parseDuration(dur);
+		if (ms !== void 0) opts.duration = ms;
+	}
+	const stCondLst = findChild(cTn, "p:stCondLst");
+	if (stCondLst) {
+		const cond = findChild(stCondLst, "p:cond");
+		if (cond) {
+			const delay = attr(cond, "delay");
+			if (delay) {
+				const ms = parseDuration(delay);
+				if (ms !== void 0) opts.delay = ms;
+			}
+		}
+	}
+	const presetSubtype = attrNum(cTn, "presetSubtype");
+	if (presetSubtype !== void 0) {
+		const dir = SUBTYPE_TO_DIRECTION.get(presetSubtype);
+		if (dir) opts.direction = dir;
+	}
+	if (presetID !== void 0) {
+		const cls = presetClass ?? "entr";
+		if (cls === "entr") {
+			const type = ENTR_PRESET_TO_TYPE.get(presetID);
+			if (type) opts.type = type;
+		} else if (cls === "exit") {
+			const type = EXIT_PRESET_TO_TYPE.get(presetID);
+			if (type) opts.type = type;
+		} else if (cls === "emph") {
+			const emphType = EMPH_PRESET_TO_ID.get(presetID);
+			if (emphType) {
+				opts.emphasisType = emphType;
+				opts.type = "appear";
+			}
+		} else if (cls === "mediacall") {
+			opts.mediaType = "play";
+			opts.type = "appear";
+		}
+	}
+	const childTnLst = findChild(cTn, "p:childTnLst");
+	if (childTnLst) for (const sub of childTnLst.elements ?? []) switch (sub.name) {
+		case "p:animEffect": {
+			const subCTn = findChild(sub, "p:cTn");
+			if (subCTn) {
+				const subDur = attr(subCTn, "dur");
+				if (subDur) {
+					const ms = parseDuration(subDur);
+					if (ms !== void 0) opts.duration = ms;
+				}
+			}
+			break;
+		}
+		case "p:anim": {
+			const subCTn = findChild(sub, "p:cTn");
+			if (subCTn) {
+				const attrName = findChild(subCTn, "p:attrNameLst");
+				if (attrName) {
+					const name = findChild(attrName, "p:attrName");
+					if (name) {
+						const text = name.elements?.[0]?.text;
+						if (text) opts.attributeName = text;
+					}
+				}
+			}
+			const from = findChild(sub, "p:cb");
+			if (from) {
+				const val = findChild(from, "p:val");
+				if (val) {
+					const v = attr(val, "val");
+					if (v) opts.from = v;
+				}
+			}
+			const toEl = findChild(sub, "p:tavLst");
+			if (toEl) {
+				const tav = findChild(toEl, "p:tav");
+				if (tav) {
+					const toVal = findChild(tav, "p:val");
+					if (toVal) {
+						const v = attr(toVal, "val");
+						if (v) opts.to = v;
+					}
+				}
+			}
+			break;
+		}
+		case "p:animMotion": {
+			opts.pathType = "customPath";
+			const path = attr(sub, "path");
+			if (path) opts.path = path;
+			break;
+		}
+		case "p:animScale":
+			opts.emphasisType = "growShrink";
+			break;
+		case "p:animRot":
+			opts.emphasisType = "spin";
+			break;
+		case "p:animClr":
+			opts.emphasisType = "colorChange";
+			break;
+		case "p:cmd":
+			if (attr(sub, "type") === "call") opts.mediaType = "play";
+			break;
+	}
+	return Object.keys(opts).length > 0 ? opts : void 0;
+}
+function extractTargetShapeId(el) {
+	const cBhvr = findDeep$1(el, "p:cBhvr")[0];
+	if (!cBhvr) return void 0;
+	const tgtEl = findChild(cBhvr, "p:tgtEl");
+	if (!tgtEl) return void 0;
+	const spTgt = findChild(tgtEl, "p:spTgt");
+	if (!spTgt) return void 0;
+	return attrNum(spTgt, "spid");
+}
+function findDeep$1(parent, name) {
+	const results = [];
+	function walk(el) {
+		if (el.name === name) {
+			results.push(el);
+			return;
+		}
+		for (const child of el.elements ?? []) walk(child);
+	}
+	for (const child of parent.elements ?? []) walk(child);
+	return results;
+}
+/**
+* Parse OOXML duration string to milliseconds.
+* Format: "PT#H#M#S" or "###ms" or just a number string
+*/
+function parseDuration(val) {
+	if (val.startsWith("PT")) {
+		let ms = 0;
+		const sMatch = val.match(/(\d+\.?\d*)S/);
+		if (sMatch) ms += Math.round(parseFloat(sMatch[1]) * 1e3);
+		const mMatch = val.match(/(\d+\.?\d*)M/);
+		if (mMatch) ms += Math.round(parseFloat(mMatch[1]) * 6e4);
+		const hMatch = val.match(/(\d+\.?\d*)H/);
+		if (hMatch) ms += Math.round(parseFloat(hMatch[1]) * 36e5);
+		return ms;
+	}
+	if (val === "indefinite") return void 0;
+	const num = parseInt(val, 10);
+	return isNaN(num) ? void 0 : num;
+}
+//#endregion
 //#region src/parse/slide.ts
 /**
 * Slide parser for PPTX documents.
@@ -5217,9 +5486,31 @@ function parseSlide(el, ctx) {
 			}
 			if (slideChildren.length > 0) opts.children = slideChildren;
 		}
+		const hf = findChild(cSld, "p:hf");
+		if (hf) {
+			const hfOpts = {};
+			if (findChild(hf, "p:sldNum")) hfOpts.slideNumber = true;
+			if (findChild(hf, "p:dt")) hfOpts.dateTime = true;
+			if (findChild(hf, "p:ftr")) hfOpts.footer = true;
+			if (findChild(hf, "p:hdr")) hfOpts.header = true;
+			if (Object.keys(hfOpts).length > 0) opts.headerFooter = hfOpts;
+		}
 	}
 	const transition = findChild(el, "p:transition");
 	if (transition) opts.transition = parseTransition(transition);
+	const timing = findChild(el, "p:timing");
+	if (timing) {
+		const animMap = parseTiming(timing);
+		if (animMap.size > 0 && opts.children) {
+			const children = opts.children;
+			for (let i = 0; i < children.length; i++) {
+				const child = children[i];
+				const inner = child[Object.keys(child)[0]] ?? {};
+				const shapeId = inner.id;
+				if (shapeId !== void 0 && animMap.has(shapeId)) inner.animation = animMap.get(shapeId);
+			}
+		}
+	}
 	for (const [, path] of ctx.slideRels) {
 		if (!path.includes("notesSlides")) continue;
 		const notesEl = ctx.pptx.doc.get(path);
@@ -5232,8 +5523,18 @@ function parseSlide(el, ctx) {
 }
 function parseSlideChild(el, ctx) {
 	switch (el.name) {
-		case "p:sp": return { shape: parseShape(el, ctx) };
-		case "p:pic": return { picture: parsePicture(el, ctx) };
+		case "p:sp": {
+			const spPr = findChild(el, "p:spPr");
+			const prstGeom = spPr ? findChild(spPr, "a:prstGeom") : void 0;
+			if ((prstGeom ? attr(prstGeom, "prst") : void 0) === "line") return { line: parseLineShape(el) };
+			return { shape: parseShape(el, ctx) };
+		}
+		case "p:pic": {
+			const mediaType = detectMediaType(el);
+			if (mediaType === "video") return { video: parseMediaFrame(el, ctx, "video") };
+			if (mediaType === "audio") return { audio: parseMediaFrame(el, ctx, "audio") };
+			return { picture: parsePicture(el, ctx) };
+		}
 		case "p:graphicFrame": return parseGraphicFrame(el, ctx);
 		case "p:cxnSp": return { connector: parseConnector(el) };
 		case "p:grpSp": return { group: parseGroup(el, ctx) };
@@ -5352,6 +5653,48 @@ function parseShape(el, _ctx) {
 	if (txBody) parseTextBody(txBody, opts);
 	return opts;
 }
+function parseLineShape(el) {
+	const opts = {};
+	const nvSpPr = findChild(el, "p:nvSpPr");
+	if (nvSpPr) {
+		const cNvPr = findChild(nvSpPr, "p:cNvPr");
+		if (cNvPr) {
+			const id = attrNum(cNvPr, "id");
+			if (id !== void 0) opts.id = id;
+			const name = attr(cNvPr, "name");
+			if (name) opts.name = name;
+		}
+	}
+	const spPr = findChild(el, "p:spPr");
+	if (spPr) {
+		const xfrm = findChild(spPr, "a:xfrm");
+		if (xfrm) {
+			const off = findChild(xfrm, "a:off");
+			const ext = findChild(xfrm, "a:ext");
+			const flipH = attrBool(xfrm, "flipH");
+			const flipV = attrBool(xfrm, "flipV");
+			if (off && ext) {
+				const offX = attrNum(off, "x") ?? 0;
+				const offY = attrNum(off, "y") ?? 0;
+				const cx = attrNum(ext, "cx") ?? 0;
+				const cy = attrNum(ext, "cy") ?? 0;
+				const x1 = flipH ? offX + cx : offX;
+				const y1 = flipV ? offY + cy : offY;
+				const x2 = flipH ? offX : offX + cx;
+				const y2 = flipV ? offY : offY + cy;
+				opts.x1 = convertEmuToPixels$1(x1);
+				opts.y1 = convertEmuToPixels$1(y1);
+				opts.x2 = convertEmuToPixels$1(x2);
+				opts.y2 = convertEmuToPixels$1(y2);
+			}
+		}
+		const fill = parseFillFromElement(spPr);
+		if (fill) opts.fill = fill;
+		const outline = parseOutlineFromElement(spPr);
+		if (outline) opts.outline = outline;
+	}
+	return opts;
+}
 function parsePicture(el, ctx) {
 	const opts = {};
 	const spPr = findChild(el, "p:spPr");
@@ -5604,6 +5947,24 @@ function parseTableFrame(el, tbl) {
 		if (attrBool(tblPr, "firstCol")) opts.firstCol = true;
 		if (attrBool(tblPr, "lastCol")) opts.lastCol = true;
 		if (attrBool(tblPr, "bandCol")) opts.bandCol = true;
+		const borders = {};
+		for (const [elName, key] of [
+			["a:lnL", "left"],
+			["a:lnR", "right"],
+			["a:lnT", "top"],
+			["a:lnB", "bottom"]
+		]) {
+			const borderEl = findChild(tblPr, elName);
+			if (borderEl) {
+				const borderOpts = {};
+				const w = attrNum(borderEl, "w");
+				if (w !== void 0) borderOpts.width = w;
+				const fill = parseFillFromElement(borderEl);
+				if (typeof fill === "string") borderOpts.color = fill;
+				if (Object.keys(borderOpts).length > 0) borders[key] = borderOpts;
+			}
+		}
+		if (Object.keys(borders).length > 0) opts.borders = borders;
 	}
 	const tblGrid = findChild(tbl, "a:tblGrid");
 	if (tblGrid) {
@@ -6027,6 +6388,34 @@ function parseFillFromElement(parent) {
 		};
 	}
 	if (findChild(parent, "a:noFill")) return { type: "none" };
+	const pattFill = findChild(parent, "a:pattFill");
+	if (pattFill) {
+		const result = {
+			type: "pattern",
+			pattern: attr(pattFill, "prst") ?? ""
+		};
+		const fgClr = findChild(pattFill, "a:fgClr");
+		if (fgClr) {
+			const srgbClr = findChild(fgClr, "a:srgbClr");
+			if (srgbClr) {
+				const val = attr(srgbClr, "val");
+				if (val) result.foregroundColor = val;
+			}
+		}
+		const bgClr = findChild(pattFill, "a:bgClr");
+		if (bgClr) {
+			const srgbClr = findChild(bgClr, "a:srgbClr");
+			if (srgbClr) {
+				const val = attr(srgbClr, "val");
+				if (val) result.backgroundColor = val;
+			}
+		}
+		return result;
+	}
+	const blipFill = findChild(parent, "a:blipFill");
+	if (blipFill) {
+		if (findChild(blipFill, "a:blip")) return { type: "blip" };
+	}
 	const gradFill = findChild(parent, "a:gradFill");
 	if (gradFill) {
 		const stops = [];
@@ -6068,6 +6457,11 @@ function parseOutlineFromElement(parent) {
 			if (val) opts.color = val;
 		}
 	}
+	const prstDash = findChild(ln, "a:prstDash");
+	if (prstDash) {
+		const val = attr(prstDash, "val");
+		if (val) opts.dashStyle = val;
+	}
 	return Object.keys(opts).length > 0 ? opts : void 0;
 }
 function parseEffectsFromElement(parent) {
@@ -6209,6 +6603,96 @@ function imageTypeFromPath(path) {
 		default: return "png";
 	}
 }
+const VIDEO_EXT_URI = "{DAA4B4D4-6D71-4841-9C94-3DE7FCFB9230}";
+const AUDIO_EXT_URI = "{CF1602FD-DB20-4165-A070-5F299619DA56}";
+/**
+* Check if a p:pic element is actually a video or audio frame
+* by looking for media extension URIs in nvPr > extLst.
+*/
+function detectMediaType(el) {
+	const nvPicPr = findChild(el, "p:nvPicPr");
+	if (!nvPicPr) return void 0;
+	const nvPr = findChild(nvPicPr, "p:nvPr");
+	if (!nvPr) return void 0;
+	const extLst = findChild(nvPr, "p:extLst");
+	if (!extLst) return void 0;
+	for (const ext of extLst.elements ?? []) {
+		if (ext.name !== "p:ext") continue;
+		const uri = attr(ext, "uri");
+		if (uri === VIDEO_EXT_URI) return "video";
+		if (uri === AUDIO_EXT_URI) return "audio";
+	}
+}
+function parseMediaFrame(el, ctx, mediaKind) {
+	const opts = {};
+	const spPr = findChild(el, "p:spPr");
+	if (spPr) parseTransformFromSpPr(spPr, opts);
+	const nvPicPr = findChild(el, "p:nvPicPr");
+	if (nvPicPr) {
+		const cNvPr = findChild(nvPicPr, "p:cNvPr");
+		if (cNvPr) {
+			const name = attr(cNvPr, "name");
+			if (name) opts.name = name;
+		}
+	}
+	const blip = findDeep(el, "a:blip")[0];
+	if (blip) {
+		const rEmbed = attr(blip, "r:embed");
+		if (rEmbed) {
+			const mediaPath = ctx.slideRels.get(rEmbed);
+			if (mediaPath) {
+				const data = ctx.pptx.doc.getRaw(mediaPath);
+				if (data) {
+					opts.data = data;
+					opts.type = mediaTypeFromPath(mediaPath, mediaKind);
+				}
+			}
+		}
+	}
+	if (mediaKind === "video") {
+		const blipFill = findChild(el, "p:blipFill");
+		if (blipFill) {
+			const posterBlip = findChild(blipFill, "a:blip");
+			if (posterBlip) {
+				const rEmbed = attr(posterBlip, "r:embed");
+				if (rEmbed) {
+					const posterPath = ctx.slideRels.get(rEmbed);
+					if (posterPath) {
+						const posterData = ctx.pptx.doc.getRaw(posterPath);
+						if (posterData) {
+							opts.poster = posterData;
+							opts.posterType = imageTypeFromPath(posterPath);
+						}
+					}
+				}
+			}
+		}
+	}
+	return opts;
+}
+function mediaTypeFromPath(path, kind) {
+	const ext = path.split(".").pop()?.toLowerCase() ?? "";
+	if (kind === "video") switch (ext) {
+		case "mp4": return "mp4";
+		case "mov":
+		case "qt": return "mov";
+		case "wmv": return "wmv";
+		case "avi": return "avi";
+		default: return "mp4";
+	}
+	else switch (ext) {
+		case "mp3": return "mp3";
+		case "wav": return "wav";
+		case "wma": return "wma";
+		case "aac": return "aac";
+		default: return "mp3";
+	}
+}
+/**
+* Parse a:blipFill from a shape's spPr.
+* Used when a shape has an image fill (not a picture element).
+* Returns { type: "blip", data } if found.
+*/
 //#endregion
 //#region src/parse/slide-layout.ts
 const NAME_TO_TYPE = {
@@ -6361,7 +6845,7 @@ function parseSlideRels(doc, slidePaths, refs) {
 	}
 }
 function parsePptx(data) {
-	const doc = parseArchive(data);
+	const doc = parseArchive(toUint8Array(data));
 	const presentation = doc.get("ppt/presentation.xml");
 	const relsXml = doc.get("ppt/_rels/presentation.xml.rels");
 	const slides = [];
@@ -6535,12 +7019,27 @@ function parsePresentation(data) {
 		masterDefs.push(masterDef);
 	}
 	if (masterCount > 1) opts.masters = masterDefs;
+	const commentAuthors = /* @__PURE__ */ new Map();
+	if (pptx.partRefs.commentAuthors) {
+		const authorsEl = pptx.doc.get(pptx.partRefs.commentAuthors);
+		if (authorsEl) for (const child of authorsEl.elements ?? []) {
+			if (child.name !== "p:cmAuthor") continue;
+			const id = attrNum(child, "id");
+			const name = attr(child, "name");
+			const initials = attr(child, "initials");
+			if (id !== void 0) commentAuthors.set(id, {
+				name: name ?? "",
+				initials: initials ?? ""
+			});
+		}
+	}
 	const result = [];
 	for (let si = 0; si < pptx.slides.length; si++) {
 		const slidePath = pptx.slides[si];
 		const slideEl = pptx.doc.get(slidePath);
 		if (!slideEl) continue;
-		const slideOpts = parseSlide(slideEl, new ParseContext(pptx, parseSlideRelMap(pptx.doc, slidePath)));
+		const slideRels = parseSlideRelMap(pptx.doc, slidePath);
+		const slideOpts = parseSlide(slideEl, new ParseContext(pptx, slideRels));
 		const layoutPath = slideLayoutPaths.get(slidePath);
 		if (layoutPath) {
 			const layoutEl = pptx.doc.get(layoutPath);
@@ -6551,11 +7050,57 @@ function parsePresentation(data) {
 				if (masterIdx >= 0 && masterDefs[masterIdx]) slideOpts.master = masterDefs[masterIdx].name;
 			}
 		}
+		for (const [, relPath] of slideRels) {
+			if (!relPath.includes("/comments/")) continue;
+			const commentsEl = pptx.doc.get(relPath);
+			if (!commentsEl) continue;
+			const comments = [];
+			for (const cm of commentsEl.elements ?? []) {
+				if (cm.name !== "p:cm") continue;
+				const authorId = attrNum(cm, "authorId");
+				const dt = attr(cm, "dt");
+				const idx = attrNum(cm, "idx");
+				const author = authorId !== void 0 ? commentAuthors.get(authorId) : void 0;
+				const pos = findChild(cm, "p:pos");
+				const x = pos ? attrNum(pos, "x") : void 0;
+				const y = pos ? attrNum(pos, "y") : void 0;
+				const txBody = findChild(cm, "p:txBody");
+				const text = txBody ? extractCommentText(txBody) : "";
+				const commentEntry = {};
+				if (authorId !== void 0) commentEntry.authorId = authorId;
+				if (author) commentEntry.author = author.name;
+				if (idx !== void 0) commentEntry.idx = idx;
+				if (dt) commentEntry.date = dt;
+				if (x !== void 0) commentEntry.x = x;
+				if (y !== void 0) commentEntry.y = y;
+				if (text) commentEntry.text = text;
+				comments.push(commentEntry);
+			}
+			if (comments.length > 0) slideOpts.comments = comments;
+			break;
+		}
 		result.push(slideOpts);
 	}
 	opts.slides = result;
 	return opts;
 }
+/**
+* Extract plain text from a p:txBody in a comment element.
+*/
+function extractCommentText(txBody) {
+	const parts = [];
+	for (const p of txBody.elements ?? []) {
+		if (p.name !== "a:p") continue;
+		for (const r of p.elements ?? []) {
+			if (r.name !== "a:r") continue;
+			for (const t of r.elements ?? []) if (t.name === "a:t") {
+				const text = textOf(t);
+				if (text) parts.push(text);
+			}
+		}
+	}
+	return parts.join("");
+}
 __reExport(/* @__PURE__ */ __exportAll({
 	AppProperties: () => AppProperties,
 	AudioFrame: () => AudioFrame,