@office-open/pptx 0.4.0 → 0.4.2

package/dist/index.mjs

@@ -6,6 +6,92 @@ import { attr, attrNum, attrs, escapeXml, findChild, xml } from "@office-open/xm
 import { DEFAULT_DRAWING_XML, SmartArtCollection, createDataModel, getColorXml, getLayoutXml, getStyleXml } from "@office-open/core/smartart";
 import { Zip, ZipDeflate, ZipPassThrough, zipSync } from "fflate";
 export * from "@office-open/core/values";
+//#region src/file/comment/comment-author-list.ts
+/**
+* p:cmAuthorLst — Comment author list stored in `ppt/commentAuthors.xml`.
+*/
+var CommentAuthorList = class extends XmlComponent {
+	constructor(authors) {
+		super("p:cmAuthorLst");
+		this.root.push(new NextAttributeComponent({ "xmlns:p": {
+			key: "xmlns:p",
+			value: "http://schemas.openxmlformats.org/presentationml/2006/main"
+		} }));
+		for (const author of authors) this.root.push(new BuilderElement({
+			name: "p:cmAuthor",
+			attributes: {
+				id: {
+					key: "id",
+					value: author.id
+				},
+				name: {
+					key: "name",
+					value: author.name
+				},
+				initials: {
+					key: "initials",
+					value: author.initials
+				},
+				clrIdx: {
+					key: "clrIdx",
+					value: author.clrIdx
+				},
+				lastIdx: {
+					key: "lastIdx",
+					value: author.lastIdx
+				}
+			}
+		}));
+	}
+};
+//#endregion
+//#region src/file/comment/slide-comment-list.ts
+/**
+* p:cmLst — Comment list stored in `ppt/comments/slideN.xml`.
+*/
+var SlideCommentList = class extends XmlComponent {
+	constructor(comments) {
+		super("p:cmLst");
+		this.root.push(new NextAttributeComponent({ "xmlns:p": {
+			key: "xmlns:p",
+			value: "http://schemas.openxmlformats.org/presentationml/2006/main"
+		} }));
+		for (const comment of comments) this.root.push(new BuilderElement({
+			name: "p:cm",
+			attributes: {
+				authorId: {
+					key: "authorId",
+					value: comment.authorId
+				},
+				idx: {
+					key: "idx",
+					value: comment.idx
+				},
+				...comment.date != null ? { dt: {
+					key: "dt",
+					value: comment.date
+				} } : {}
+			},
+			children: [new BuilderElement({
+				name: "p:pos",
+				attributes: {
+					x: {
+						key: "x",
+						value: comment.x
+					},
+					y: {
+						key: "y",
+						value: comment.y
+					}
+				}
+			}), new BuilderElement({
+				name: "p:text",
+				children: [comment.text]
+			})]
+		}));
+	}
+};
+//#endregion
 //#region src/file/content-types/content-types.ts
 /**
 * Content Types module for PPTX packages.
@@ -18,6 +104,8 @@ const PPTX_SLIDE_MASTER = "application/vnd.openxmlformats-officedocument.present
 const PPTX_SLIDE_LAYOUT = "application/vnd.openxmlformats-officedocument.presentationml.slideLayout+xml";
 const PPTX_THEME = "application/vnd.openxmlformats-officedocument.theme+xml";
 const PPTX_NOTES = "application/vnd.openxmlformats-officedocument.presentationml.notesSlide+xml";
+const PPTX_COMMENTS = "application/vnd.openxmlformats-officedocument.presentationml.comments+xml";
+const PPTX_COMMENT_AUTHORS = "application/vnd.openxmlformats-officedocument.presentationml.commentAuthors+xml";
 const PPTX_CHART = "application/vnd.openxmlformats-officedocument.drawingml.chart+xml";
 const STATIC_CHILDREN = [{ _attr: { xmlns: "http://schemas.openxmlformats.org/package/2006/content-types" } }, ...[
 	{
@@ -119,6 +207,20 @@ var ContentTypes = class extends BaseXmlComponent {
 			key: `/ppt/notesSlides/notesSlide${index}.xml`
 		});
 	}
+	addComments(index) {
+		this.dynamicEntries.push({
+			type: "Override",
+			contentType: PPTX_COMMENTS,
+			key: `/ppt/comments/comment${index}.xml`
+		});
+	}
+	addCommentAuthors() {
+		this.dynamicEntries.push({
+			type: "Override",
+			contentType: PPTX_COMMENT_AUTHORS,
+			key: "/ppt/commentAuthors.xml"
+		});
+	}
 	addChart(index) {
 		this.dynamicEntries.push({
 			type: "Override",
@@ -1373,7 +1475,7 @@ var DefaultSlideMaster = class DefaultSlideMaster extends ImportedXmlComponent {
 };
 //#endregion
 //#region src/file/animation/timing.ts
-const PRESET_IDS = {
+const ENTR_PRESET_IDS = {
 	appear: 1,
 	fade: 10,
 	fly: 2,
@@ -1389,6 +1491,42 @@ const PRESET_IDS = {
 	push: 19,
 	strips: 23
 };
+const EXIT_PRESET_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_PRESET_IDS = {
+	growShrink: 53,
+	spin: 54,
+	growWithTurn: 56,
+	colorChange: 29,
+	transparency: 57,
+	boldFlash: 50,
+	wave: 55,
+	pulse: 58
+};
+const PATH_PRESET_IDS = {
+	customPath: 200,
+	arc: 201,
+	bounce: 202,
+	circle: 203,
+	curve: 204,
+	figureEight: 205,
+	line: 206,
+	loop: 207
+};
 const DIRECTION_SUBTYPES = {
 	left: 4,
 	right: 8,
@@ -1461,169 +1599,522 @@ const DIRECTION_FILTER = {
 	},
 	wheel: {}
 };
-/**
-* p:timing — Slide timing for shape animations.
-*/
-var SlideTiming = class extends XmlComponent {
-	constructor(entries) {
-		super("p:timing");
-		if (entries.length === 0) return;
-		let id = 1;
-		const rootCtnId = id++;
-		const seqCtnId = id++;
-		const animationNodes = [];
-		let clickGroupDelay = 0;
-		for (let i = 0; i < entries.length; i++) {
-			const { spid, options } = entries[i];
-			const nodeType = options.trigger === "withPrevious" ? "withEffect" : options.trigger === "afterPrevious" ? "afterEffect" : "clickEffect";
-			if (options.trigger === "afterPrevious" && i > 0) clickGroupDelay += (options.duration ?? 500) + (options.delay ?? 0);
-			if (options.trigger === "onClick" || options.trigger === void 0) clickGroupDelay = 0;
-			const groupCtnId = id++;
-			const effectCtnId = id++;
-			const setCtnId = id++;
-			const effectCtnId2 = id++;
-			const presetId = PRESET_IDS[options.type];
-			const presetSubtype = options.direction ? DIRECTION_SUBTYPES[options.direction] ?? 0 : 0;
-			const effectChildren = [];
-			effectChildren.push(new BuilderElement({
-				name: "p:set",
+const PATH_STRINGS = {
+	customPath: "",
+	arc: "M 0 0 C 50 -100 100 -100 150 0",
+	bounce: "M 0 0 L 50 0 C 50 -30 30 -50 0 -50 C -30 -50 -50 -30 -50 0 L 50 0",
+	circle: "M 0 0 C 50 -50 100 0 50 50 C 0 100 -50 50 0 0",
+	curve: "M 0 0 C 50 -80 100 -80 150 0 C 200 80 250 80 300 0",
+	figureEight: "M 0 0 C 50 -50 100 0 50 50 C 0 100 -50 50 0 0 C -50 -50 -100 0 -50 50 C 0 100 50 50 0 0",
+	line: "M 0 0 L 200 0",
+	loop: "M 0 0 C 50 -80 100 0 50 80 C 0 160 -50 80 0 0"
+};
+function resolvePresetId(options) {
+	const cls = options.class ?? "entr";
+	if (cls === "emph" && options.emphasisType) return EMPH_PRESET_IDS[options.emphasisType] ?? 0;
+	if (options.pathType) return PATH_PRESET_IDS[options.pathType] ?? 200;
+	const type = options.type ?? "appear";
+	return (cls === "exit" ? EXIT_PRESET_IDS : ENTR_PRESET_IDS)[type] ?? 0;
+}
+function resolvePresetClass(options) {
+	if (options.pathType) return "emph";
+	return options.class ?? "entr";
+}
+function resolvePresetSubtype(options) {
+	if (options.direction) return DIRECTION_SUBTYPES[options.direction] ?? 0;
+	return 0;
+}
+function buildEntrOrExitEffects(options, spid, ids) {
+	const children = [];
+	const cls = options.class ?? "entr";
+	const visibility = cls === "exit" ? "hidden" : "visible";
+	children.push(new BuilderElement({
+		name: "p:set",
+		children: [new BuilderElement({
+			name: "p:cBhvr",
+			children: [
+				new BuilderElement({
+					name: "p:cTn",
+					attributes: {
+						id: {
+							key: "id",
+							value: ids.set
+						},
+						dur: {
+							key: "dur",
+							value: "1"
+						},
+						fill: {
+							key: "fill",
+							value: "hold"
+						}
+					},
+					children: [new BuilderElement({
+						name: "p:stCondLst",
+						children: [new BuilderElement({
+							name: "p:cond",
+							attributes: { delay: {
+								key: "delay",
+								value: "0"
+							} }
+						})]
+					})]
+				}),
+				new BuilderElement({
+					name: "p:tgtEl",
+					children: [new BuilderElement({
+						name: "p:spTgt",
+						attributes: { spid: {
+							key: "spid",
+							value: spid
+						} }
+					})]
+				}),
+				new BuilderElement({
+					name: "p:attrNameLst",
+					children: [new StringContainer("p:attrName", "style.visibility")]
+				})
+			]
+		}), new BuilderElement({
+			name: "p:to",
+			children: [new BuilderElement({
+				name: "p:strVal",
+				attributes: { val: {
+					key: "val",
+					value: visibility
+				} }
+			})]
+		})]
+	}));
+	if (options.type !== "appear") {
+		const filterBase = FILTER_MAP[options.type ?? "fade"];
+		const dirMap = DIRECTION_FILTER[options.type ?? "fade"];
+		const dirFilter = options.direction && dirMap ? dirMap[options.direction] : void 0;
+		let filter = filterBase;
+		if (options.type === "wheel") filter = "wheel(4)";
+		else if (options.type === "split") filter = `split(${options.direction ?? "horizontal"})`;
+		else if (dirFilter) filter = `${filterBase}(${dirFilter})`;
+		const transition = cls === "exit" ? "out" : "in";
+		children.push(new BuilderElement({
+			name: "p:animEffect",
+			attributes: {
+				transition: {
+					key: "transition",
+					value: transition
+				},
+				filter: {
+					key: "filter",
+					value: filter
+				}
+			},
+			children: [new BuilderElement({
+				name: "p:cBhvr",
+				children: [new BuilderElement({
+					name: "p:cTn",
+					attributes: {
+						id: {
+							key: "id",
+							value: ids.effect
+						},
+						dur: {
+							key: "dur",
+							value: String(options.duration ?? 500)
+						},
+						fill: {
+							key: "fill",
+							value: "hold"
+						}
+					}
+				}), new BuilderElement({
+					name: "p:tgtEl",
+					children: [new BuilderElement({
+						name: "p:spTgt",
+						attributes: { spid: {
+							key: "spid",
+							value: spid
+						} }
+					})]
+				})]
+			})]
+		}));
+	}
+	return children;
+}
+function buildEmphasisEffects(options, spid, ids) {
+	const emphType = options.emphasisType ?? "growShrink";
+	const children = [];
+	const dur = String(options.duration ?? 500);
+	const tgtEl = new BuilderElement({
+		name: "p:tgtEl",
+		children: [new BuilderElement({
+			name: "p:spTgt",
+			attributes: { spid: {
+				key: "spid",
+				value: spid
+			} }
+		})]
+	});
+	switch (emphType) {
+		case "growShrink":
+			children.push(new BuilderElement({
+				name: "p:animScale",
 				children: [new BuilderElement({
 					name: "p:cBhvr",
-					children: [
-						new BuilderElement({
-							name: "p:cTn",
-							attributes: {
-								id: {
-									key: "id",
-									value: setCtnId
-								},
-								dur: {
-									key: "dur",
-									value: "1"
-								},
-								fill: {
-									key: "fill",
-									value: "hold"
-								}
+					children: [new BuilderElement({
+						name: "p:cTn",
+						attributes: {
+							id: {
+								key: "id",
+								value: ids.effect
+							},
+							dur: {
+								key: "dur",
+								value: dur
+							},
+							fill: {
+								key: "fill",
+								value: "hold"
 							},
+							...options.autoReverse ? { autoRev: {
+								key: "autoRev",
+								value: 1
+							} } : {}
+						},
+						children: [new BuilderElement({
+							name: "p:stCondLst",
 							children: [new BuilderElement({
-								name: "p:stCondLst",
-								children: [new BuilderElement({
-									name: "p:cond",
-									attributes: { delay: {
-										key: "delay",
-										value: "0"
-									} }
-								})]
+								name: "p:cond",
+								attributes: { delay: {
+									key: "delay",
+									value: "0"
+								} }
 							})]
-						}),
-						new BuilderElement({
-							name: "p:tgtEl",
+						})]
+					}), tgtEl]
+				}), new BuilderElement({
+					name: "p:by",
+					attributes: {
+						x: {
+							key: "x",
+							value: "150000"
+						},
+						y: {
+							key: "y",
+							value: "150000"
+						}
+					}
+				})]
+			}));
+			break;
+		case "spin":
+			children.push(new BuilderElement({
+				name: "p:animRot",
+				attributes: { by: {
+					key: "by",
+					value: "3600000"
+				} },
+				children: [new BuilderElement({
+					name: "p:cBhvr",
+					children: [new BuilderElement({
+						name: "p:cTn",
+						attributes: {
+							id: {
+								key: "id",
+								value: ids.effect
+							},
+							dur: {
+								key: "dur",
+								value: dur
+							},
+							fill: {
+								key: "fill",
+								value: "hold"
+							}
+						},
+						children: [new BuilderElement({
+							name: "p:stCondLst",
 							children: [new BuilderElement({
-								name: "p:spTgt",
-								attributes: { spid: {
-									key: "spid",
-									value: spid
+								name: "p:cond",
+								attributes: { delay: {
+									key: "delay",
+									value: "0"
 								} }
 							})]
-						}),
-						new BuilderElement({
-							name: "p:attrNameLst",
-							children: [new StringContainer("p:attrName", "style.visibility")]
-						})
-					]
+						})]
+					}), tgtEl]
+				})]
+			}));
+			break;
+		case "colorChange": {
+			const color = options.color ?? "FF0000";
+			children.push(new BuilderElement({
+				name: "p:animClr",
+				children: [new BuilderElement({
+					name: "p:cBhvr",
+					children: [new BuilderElement({
+						name: "p:cTn",
+						attributes: {
+							id: {
+								key: "id",
+								value: ids.effect
+							},
+							dur: {
+								key: "dur",
+								value: dur
+							},
+							fill: {
+								key: "fill",
+								value: "hold"
+							}
+						},
+						children: [new BuilderElement({
+							name: "p:stCondLst",
+							children: [new BuilderElement({
+								name: "p:cond",
+								attributes: { delay: {
+									key: "delay",
+									value: "0"
+								} }
+							})]
+						})]
+					}), tgtEl]
 				}), new BuilderElement({
 					name: "p:to",
 					children: [new BuilderElement({
-						name: "p:strVal",
+						name: "a:srgbClr",
 						attributes: { val: {
 							key: "val",
-							value: "visible"
+							value: color
 						} }
 					})]
 				})]
 			}));
-			if (options.type !== "appear") {
-				const filterBase = FILTER_MAP[options.type];
-				const dirMap = DIRECTION_FILTER[options.type];
-				const dirFilter = options.direction && dirMap ? dirMap[options.direction] : void 0;
-				let filter = filterBase;
-				if (options.type === "wheel") filter = "wheel(4)";
-				else if (options.type === "split") filter = `split(${options.direction ?? "horizontal"})`;
-				else if (dirFilter) filter = `${filterBase}(${dirFilter})`;
-				effectChildren.push(new BuilderElement({
-					name: "p:animEffect",
-					attributes: {
-						transition: {
-							key: "transition",
-							value: "in"
-						},
-						filter: {
-							key: "filter",
-							value: filter
-						}
+			break;
+		}
+		case "transparency":
+			children.push(new BuilderElement({
+				name: "p:anim",
+				attributes: {
+					calcmode: {
+						key: "calcmode",
+						value: "lin"
 					},
-					children: [new BuilderElement({
-						name: "p:cBhvr",
-						children: [new BuilderElement({
+					valueType: {
+						key: "valueType",
+						value: "num"
+					},
+					from: {
+						key: "from",
+						value: "0"
+					},
+					to: {
+						key: "to",
+						value: "1"
+					}
+				},
+				children: [new BuilderElement({
+					name: "p:cBhvr",
+					children: [
+						new BuilderElement({
 							name: "p:cTn",
 							attributes: {
 								id: {
 									key: "id",
-									value: effectCtnId2
+									value: ids.effect
 								},
 								dur: {
 									key: "dur",
-									value: String(options.duration ?? 500)
+									value: dur
 								},
 								fill: {
 									key: "fill",
 									value: "hold"
 								}
 							}
-						}), new BuilderElement({
-							name: "p:tgtEl",
-							children: [new BuilderElement({
-								name: "p:spTgt",
-								attributes: { spid: {
-									key: "spid",
-									value: spid
-								} }
-							})]
-						})]
-					})]
-				}));
+						}),
+						tgtEl,
+						new BuilderElement({
+							name: "p:attrNameLst",
+							children: [new StringContainer("p:attrName", "style.opacity")]
+						})
+					]
+				})]
+			}));
+			break;
+		default:
+			children.push(new BuilderElement({
+				name: "p:animEffect",
+				attributes: {
+					transition: {
+						key: "transition",
+						value: "in"
+					},
+					filter: {
+						key: "filter",
+						value: emphType
+					}
+				},
+				children: [new BuilderElement({
+					name: "p:cBhvr",
+					children: [new BuilderElement({
+						name: "p:cTn",
+						attributes: {
+							id: {
+								key: "id",
+								value: ids.effect
+							},
+							dur: {
+								key: "dur",
+								value: dur
+							},
+							fill: {
+								key: "fill",
+								value: "hold"
+							}
+						}
+					}), tgtEl]
+				})]
+			}));
+			break;
+	}
+	return children;
+}
+function buildPathEffects(options, spid, ids) {
+	const pathStr = options.path ?? PATH_STRINGS[options.pathType ?? "customPath"] ?? "";
+	const dur = String(options.duration ?? 1e3);
+	return [new BuilderElement({
+		name: "p:animMotion",
+		attributes: {
+			origin: {
+				key: "origin",
+				value: "layout"
+			},
+			path: {
+				key: "path",
+				value: pathStr
 			}
+		},
+		children: [new BuilderElement({
+			name: "p:cBhvr",
+			children: [new BuilderElement({
+				name: "p:cTn",
+				attributes: {
+					id: {
+						key: "id",
+						value: ids.effect
+					},
+					dur: {
+						key: "dur",
+						value: dur
+					},
+					fill: {
+						key: "fill",
+						value: "hold"
+					}
+				},
+				children: [new BuilderElement({
+					name: "p:stCondLst",
+					children: [new BuilderElement({
+						name: "p:cond",
+						attributes: { delay: {
+							key: "delay",
+							value: "0"
+						} }
+					})]
+				})]
+			}), new BuilderElement({
+				name: "p:tgtEl",
+				children: [new BuilderElement({
+					name: "p:spTgt",
+					attributes: { spid: {
+						key: "spid",
+						value: spid
+					} }
+				})]
+			})]
+		})]
+	})];
+}
+/**
+* p:timing — Slide timing for shape animations.
+*/
+var SlideTiming = class extends XmlComponent {
+	constructor(entries) {
+		super("p:timing");
+		if (entries.length === 0) return;
+		let id = 1;
+		const rootCtnId = id++;
+		const seqCtnId = id++;
+		const animationNodes = [];
+		let clickGroupDelay = 0;
+		for (let i = 0; i < entries.length; i++) {
+			const { spid, options } = entries[i];
+			const nodeType = options.trigger === "withPrevious" ? "withEffect" : options.trigger === "afterPrevious" ? "afterEffect" : "clickEffect";
+			if (options.trigger === "afterPrevious" && i > 0) clickGroupDelay += (options.duration ?? 500) + (options.delay ?? 0);
+			if (options.trigger === "onClick" || options.trigger === void 0) clickGroupDelay = 0;
+			const groupCtnId = id++;
+			const effectCtnId = id++;
+			const setCtnId = id++;
+			const effectCtnId2 = id++;
+			const presetId = resolvePresetId(options);
+			const presetClass = resolvePresetClass(options);
+			const presetSubtype = resolvePresetSubtype(options);
+			let effectChildren;
+			if (options.pathType) effectChildren = buildPathEffects(options, spid, {
+				set: setCtnId,
+				effect: effectCtnId2
+			});
+			else if (presetClass === "emph") effectChildren = buildEmphasisEffects(options, spid, {
+				set: setCtnId,
+				effect: effectCtnId2
+			});
+			else effectChildren = buildEntrOrExitEffects(options, spid, {
+				set: setCtnId,
+				effect: effectCtnId2
+			});
+			const cTnAttrs = {
+				id: {
+					key: "id",
+					value: effectCtnId
+				},
+				presetID: {
+					key: "presetID",
+					value: presetId
+				},
+				presetClass: {
+					key: "presetClass",
+					value: presetClass
+				},
+				presetSubtype: {
+					key: "presetSubtype",
+					value: presetSubtype
+				},
+				fill: {
+					key: "fill",
+					value: "hold"
+				},
+				nodeType: {
+					key: "nodeType",
+					value: nodeType
+				}
+			};
+			if (options.speed !== void 0) cTnAttrs.spd = {
+				key: "spd",
+				value: String(options.speed)
+			};
+			if (options.repeatCount !== void 0) cTnAttrs.repeatCount = {
+				key: "repeatCount",
+				value: String(options.repeatCount)
+			};
+			if (options.autoReverse) cTnAttrs.autoRev = {
+				key: "autoRev",
+				value: 1
+			};
 			const innerPar = new BuilderElement({
 				name: "p:par",
 				children: [new BuilderElement({
 					name: "p:cTn",
-					attributes: {
-						id: {
-							key: "id",
-							value: effectCtnId
-						},
-						presetID: {
-							key: "presetID",
-							value: presetId
-						},
-						presetClass: {
-							key: "presetClass",
-							value: "entr"
-						},
-						presetSubtype: {
-							key: "presetSubtype",
-							value: presetSubtype
-						},
-						fill: {
-							key: "fill",
-							value: "hold"
-						},
-						nodeType: {
-							key: "nodeType",
-							value: nodeType
-						}
-					},
+					attributes: cTnAttrs,
 					children: [new BuilderElement({
 						name: "p:stCondLst",
 						children: [new BuilderElement({
@@ -2434,6 +2925,10 @@ function buildRelationships(entries) {
 	for (const e of entries) rels.addRelationship(e.id, e.type, e.target, e.mode);
 	return rels;
 }
+function deriveInitials(name) {
+	const parts = name.trim().split(/\s+/);
+	return parts.length >= 2 ? (parts[0][0] + parts[parts.length - 1][0]).toUpperCase() : name.slice(0, 2).toUpperCase();
+}
 var File = class {
 	slideOptions;
 	corePropsOptions;
@@ -2460,6 +2955,8 @@ var File = class {
 	slides;
 	slideWrappers;
 	notesSlides;
+	commentAuthorList;
+	slideCommentLists;
 	fileRels;
 	constructor(options) {
 		const slides = options.slides ?? [];
@@ -2478,10 +2975,16 @@ var File = class {
 	get ContentTypes() {
 		if (!this.contentTypes) {
 			this.contentTypes = new ContentTypes();
+			let hasComments = false;
 			for (let i = 0; i < this.slideOptions.length; i++) {
 				this.contentTypes.addSlide(i + 1);
 				if (this.slideOptions[i].notes) this.contentTypes.addNotesSlide(i + 1);
+				if (this.slideOptions[i].comments && this.slideOptions[i].comments.length > 0) {
+					this.contentTypes.addComments(i + 1);
+					hasComments = true;
+				}
 			}
+			if (hasComments) this.contentTypes.addCommentAuthors();
 		}
 		return this.contentTypes;
 	}
@@ -2608,6 +3111,58 @@ var File = class {
 	get NotesMasterRelationships() {
 		return this.notesMasterRels ??= new Relationships();
 	}
+	get CommentAuthorList() {
+		if (!this.commentAuthorList && !this.slideCommentLists) this.buildComments();
+		return this.commentAuthorList;
+	}
+	get SlideCommentLists() {
+		if (!this.slideCommentLists) this.buildComments();
+		return this.slideCommentLists;
+	}
+	buildComments() {
+		const authorMap = /* @__PURE__ */ new Map();
+		let nextAuthorId = 0;
+		this.slideCommentLists = Array.from({ length: this.slideOptions.length });
+		for (let i = 0; i < this.slideOptions.length; i++) {
+			const slideComments = this.slideOptions[i].comments;
+			if (!slideComments || slideComments.length === 0) continue;
+			const commentEntries = [];
+			for (const c of slideComments) {
+				let author = authorMap.get(c.author);
+				if (!author) {
+					const id = nextAuthorId++;
+					author = {
+						id,
+						name: c.author,
+						initials: c.initials || deriveInitials(c.author),
+						clrIdx: id,
+						commentCount: 0
+					};
+					authorMap.set(c.author, author);
+				}
+				author.commentCount++;
+				commentEntries.push({
+					authorId: author.id,
+					idx: author.commentCount,
+					date: c.date,
+					x: c.x,
+					y: c.y,
+					text: c.text
+				});
+			}
+			this.slideCommentLists[i] = new SlideCommentList(commentEntries);
+		}
+		if (authorMap.size > 0) {
+			const authors = [...authorMap.values()].map((a) => ({
+				id: a.id,
+				name: a.name,
+				initials: a.initials,
+				clrIdx: a.clrIdx,
+				lastIdx: a.commentCount
+			}));
+			this.commentAuthorList = new CommentAuthorList(authors);
+		}
+	}
 };
 //#endregion
 //#region src/file/shape/paragraph/text.ts
@@ -10971,6 +11526,7 @@ var Compiler = class {
 				path: "ppt/notesMasters/_rels/notesMaster1.xml.rels"
 			};
 		}
+		if (file.CommentAuthorList) file.PresentationWrapper.Relationships.addRelationship(file.PresentationWrapper.Relationships.RelationshipCount + 1, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/commentAuthors", "commentAuthors.xml");
 		const presentationXml = this.formatter.formatToXml(file.PresentationWrapper.View, context, declaration);
 		let currentImageCount = 0;
 		const mediaData = getReferencedMedia(presentationXml, file.Media.Array);
@@ -11050,6 +11606,7 @@ var Compiler = class {
 				data: replacedSlideXml,
 				path: `ppt/slides/slide${i + 1}.xml`
 			};
+			if (file.SlideCommentLists[i]) slideWrapper.Relationships.addRelationship(slideWrapper.Relationships.RelationshipCount + 1, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments", `../comments/comment${i + 1}.xml`);
 			mapping[`SlideRelationships${i}`] = {
 				data: xml(this.formatter.format(slideWrapper.Relationships, context), { declaration: false }),
 				path: `ppt/slides/_rels/slide${i + 1}.xml.rels`
@@ -11108,6 +11665,15 @@ var Compiler = class {
 				standalone: "yes"
 			} })), { level: 0 }];
 		}
+		if (file.CommentAuthorList) files["ppt/commentAuthors.xml"] = [textToUint8Array(xml(this.formatter.format(file.CommentAuthorList, context), {
+			declaration,
+			indent
+		})), { level: 0 }];
+		const commentLists = file.SlideCommentLists;
+		for (let i = 0; i < commentLists.length; i++) if (commentLists[i]) files[`ppt/comments/comment${i + 1}.xml`] = [textToUint8Array(xml(this.formatter.format(commentLists[i], context), {
+			declaration,
+			indent
+		})), { level: 0 }];
 		for (const image of file.Media.Array) {
 			files[`ppt/media/${image.fileName}`] = [image.data, { level: 0 }];
 			if (image.type === "svg" && "fallback" in image) {