@office-open/pptx 0.4.4 → 0.4.6

package/dist/index.mjs

@@ -2,7 +2,7 @@ import { i as __toCommonJS, n as __exportAll, r as __reExport, t as __esmMin } f
 import { AppProperties, BaseXmlComponent, BuilderElement, Formatter, ImportedXmlComponent, NextAttributeComponent, OoxmlMimeType, PrettifyType, Relationships, StringContainer, XmlComponent, addSmartArtRelationships, buildCorePropertiesXml, collectPlaceholderKeys, convertEmuToInches, convertEmuToPixels, convertEmuToPoints, convertInchesToEmu, convertOutput, convertPixelsToEmu, convertPixelsToEmu as convertPixelsToEmu$1, convertPointsToEmu, convertPrettifyType, escapeRegex, formatId, getReferencedMedia, hasPlaceholders, hashedId, parseDocument, replaceChartPlaceholders, replaceImagePlaceholders, replaceSmartArtPlaceholders, uniqueId, uniqueNumericIdCreator, uniqueUuid } from "@office-open/core";
 import { BevelPresetType, CompoundLine, LineCap, LineJoin, PathShadeType, PenAlignment, PresetDash, PresetGeometry, PresetMaterialType, Stretch, TileFlipMode, buildFill, createBevel, createBlip, createBottomBevel, createColorElement, createColorTransforms, createEffectList, createEffectList as createEffectList$1, createGradientFill, createGradientStop, createGroupTransform2D, createOutline, createOutline as createOutline$1, createScene3D, createScene3D as createScene3D$1, createShape3D, createShape3D as createShape3D$1, createTransform2D, extractBlipFillMedia } from "@office-open/core/drawingml";
 import { ChartCollection, ChartSpace } from "@office-open/core/chart";
-import { attr, attrs, escapeXml, xml } from "@office-open/xml";
+import { attr, xml } from "@office-open/xml";
 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";
@@ -599,9 +599,6 @@ init_xml_components();
 function buildEndParagraphRunProperties(lang = "en-US") {
 	return { "a:endParaRPr": { _attr: { lang } } };
 }
-function buildEndParagraphRunPropertiesXml(lang = "en-US") {
-	return `<a:endParaRPr${attrs({ lang })}/>`;
-}
 /**
 * a:endParaRPr — End paragraph run properties.
 * Lazy: stores lang, builds XML object in prepForXml.
@@ -683,48 +680,7 @@ var ParagraphProperties = class extends XmlComponent {
 	prepForXml(_context) {
 		return buildParagraphProperties(this.options);
 	}
-	toXml() {
-		return buildParagraphPropertiesXml(this.options);
-	}
 };
-function buildBulletChildrenXml(options) {
-	if (options.type === "none") return "<a:buNone/>";
-	let s = "";
-	if (options.color) s += `<a:buClr><a:srgbClr${attrs({ val: options.color.replace("#", "") })}/></a:buClr>`;
-	if (options.size !== void 0) s += `<a:buSzPct${attrs({ val: `${options.size}%` })}/>`;
-	s += `<a:buFont${attrs({
-		typeface: "Arial",
-		panose: "020B0604020202020204",
-		pitchFamily: "34",
-		charset: "0"
-	})}/>`;
-	if (options.type === "char") s += `<a:buChar${attrs({ char: options.char ?? "•" })}/>`;
-	else if (options.type === "autoNum") {
-		const buAttrs = { type: options.format ?? "arabicPeriod" };
-		if (options.startAt !== void 0) buAttrs.startAt = options.startAt;
-		s += `<a:buAutoNum${attrs(buAttrs)}/>`;
-	}
-	return s;
-}
-function buildParagraphPropertiesXml(options) {
-	const attrStr = attrs({
-		algn: options.alignment ? TextAlignment[options.alignment] : void 0,
-		lvl: options.indentLevel,
-		marL: options.marginIndent,
-		marR: options.marginRight,
-		defTabSz: options.defTabSize
-	});
-	const body = [];
-	if (options.lineSpacing !== void 0) body.push(`<a:lnSpc><a:spcPct${attrs({ val: options.lineSpacing * 1e3 })}/></a:lnSpc>`);
-	if (options.lineSpacingPoints !== void 0) body.push(`<a:lnSpc><a:spcPts${attrs({ val: options.lineSpacingPoints * 100 })}/></a:lnSpc>`);
-	if (options.marginBottom !== void 0 || options.marginTop !== void 0) body.push(`<a:spcAft><a:spcPts${attrs({ val: options.marginBottom ?? 0 })}/></a:spcAft>`);
-	if (options.marginTop !== void 0) body.push(`<a:spcBef><a:spcPts${attrs({ val: options.marginTop })}/></a:spcBef>`);
-	if (options.bullet) body.push(buildBulletChildrenXml(options.bullet));
-	else if (options.bulletNone !== false) body.push("<a:buNone/>");
-	if (!attrStr && body.length === 0) return "";
-	if (body.length === 0) return `<a:pPr${attrStr}/>`;
-	return `<a:pPr${attrStr}>${body.join("")}</a:pPr>`;
-}
 //#endregion
 //#region src/file/shape/paragraph/run-properties.ts
 init_fill();
@@ -821,66 +777,7 @@ var RunProperties = class extends XmlComponent {
 		} }).prepForXml(context) ?? void 0;
 		return buildRunProperties(opts, hyperlinkKey, fillObj, effectListObj, outlineObj);
 	}
-	toXml(context) {
-		const opts = this.options;
-		let hyperlinkKey;
-		if (opts.hyperlink) {
-			hyperlinkKey = `hlink_${nextHyperlinkId++}`;
-			context.fileData?.Hyperlinks?.addHyperlink(hyperlinkKey, opts.hyperlink.url, opts.hyperlink.tooltip);
-		}
-		let fillObj;
-		if (opts.fill !== void 0) fillObj = buildFill(opts.fill).prepForXml(context) ?? void 0;
-		let outlineObj;
-		if (opts.outline) outlineObj = createOutline$1({
-			width: 12700,
-			type: "solidFill",
-			color: { value: "000000" }
-		}).prepForXml(context) ?? void 0;
-		let effectListObj;
-		if (opts.shadow) effectListObj = createEffectList$1({ outerShadow: {
-			blurRadius: 50800,
-			distance: 38100,
-			direction: 27e5,
-			color: {
-				value: "000000",
-				transforms: { alpha: 4e4 }
-			}
-		} }).prepForXml(context) ?? void 0;
-		return buildRunPropertiesXml(opts, hyperlinkKey, fillObj, effectListObj, outlineObj);
-	}
 };
-/**
-* String version of buildRunProperties for zero-allocation serialization.
-*/
-function buildRunPropertiesXml(options, hyperlinkKey, fillObject, effectListObject, outlineObject) {
-	const a = {};
-	if (options.fontSize) a.sz = options.fontSize * 100;
-	if (options.bold !== void 0) a.b = options.bold;
-	if (options.italic !== void 0) a.i = options.italic;
-	if (options.underline) a.u = UnderlineStyle[options.underline];
-	if (options.lang) a.lang = options.lang;
-	if (options.strike) a.strike = StrikeStyle[options.strike];
-	if (options.baseline !== void 0) a.baseline = options.baseline;
-	if (options.capitalization) a.cap = TextCapitalization[options.capitalization] ?? options.capitalization;
-	if (options.spacing !== void 0) a.spc = options.spacing;
-	if (options.noProof !== void 0) a.noProof = options.noProof;
-	if (options.dirty !== void 0) a.dirty = options.dirty;
-	const attrStr = attrs(a);
-	const body = [];
-	if (options.font) body.push(`<a:latin${attrs({ typeface: options.font })}/><a:ea${attrs({ typeface: options.font })}/>`);
-	if (options.hyperlink && hyperlinkKey) {
-		const h = { "r:id": `{hlink:${hyperlinkKey}}` };
-		if (options.hyperlink.tooltip) h.tooltip = options.hyperlink.tooltip;
-		body.push(`<a:hlinkClick${attrs(h)}/>`);
-	}
-	if (options.rightToLeft !== void 0) body.push(`<a:rtl${attrs({ val: options.rightToLeft ? 1 : 0 })}/>`);
-	if (fillObject) body.push(xml(fillObject));
-	if (outlineObject) body.push(xml(outlineObject));
-	if (effectListObject) body.push(xml(effectListObject));
-	if (!attrStr && body.length === 0) return "";
-	if (body.length === 0) return `<a:rPr${attrStr}/>`;
-	return `<a:rPr${attrStr}>${body.join("")}</a:rPr>`;
-}
 //#endregion
 //#region src/file/shape/paragraph/run.ts
 init_xml_components();
@@ -903,16 +800,6 @@ var TextRun = class extends XmlComponent {
 		if (this.options.text) children.push({ "a:t": [this.options.text] });
 		return { "a:r": children.length === 0 ? {} : children.length === 1 && "_attr" in children[0] ? children[0] : children };
 	}
-	toXml(context) {
-		let s = "<a:r>";
-		if (RunProperties.hasProperties(this.options)) {
-			const rp = new RunProperties(this.options);
-			s += rp.toXml(context);
-		}
-		if (this.options.text) s += `<a:t>${escapeXml(this.options.text)}</a:t>`;
-		s += "</a:r>";
-		return s;
-	}
 };
 //#endregion
 //#region src/file/shape/paragraph/paragraph.ts
@@ -942,16 +829,6 @@ var Paragraph = class extends XmlComponent {
 		children.push(buildEndParagraphRunProperties());
 		return { "a:p": children };
 	}
-	toXml(context) {
-		let s = "<a:p>";
-		const pPr = buildParagraphPropertiesXml(this.options.properties ?? {});
-		if (pPr) s += pPr;
-		if (this.options.text) s += new TextRun(this.options.text).toXml(context);
-		if (this.options.children) for (const child of this.options.children) s += child.toXml(context);
-		s += buildEndParagraphRunPropertiesXml();
-		s += "</a:p>";
-		return s;
-	}
 };
 //#endregion
 //#region src/file/table/table-cell-properties.ts
@@ -1072,25 +949,6 @@ function buildBodyPr(options) {
 	bodyPrContent.push(...bodyPrChildren);
 	return { "a:bodyPr": bodyPrContent.length === 1 && "_attr" in bodyPrContent[0] ? bodyPrContent[0] : bodyPrContent.length > 0 ? bodyPrContent : {} };
 }
-function buildBodyPrXml(options) {
-	let s = "<a:bodyPr";
-	const a = {};
-	if (options.vertical) a.vert = options.vertical;
-	if (options.anchor) a.anchor = VerticalAlignment[options.anchor];
-	if (options.wrap) a.wrap = options.wrap;
-	if (options.margins?.top !== void 0) a.tIns = options.margins.top;
-	if (options.margins?.bottom !== void 0) a.bIns = options.margins.bottom;
-	if (options.margins?.left !== void 0) a.lIns = options.margins.left;
-	if (options.margins?.right !== void 0) a.rIns = options.margins.right;
-	if (options.columns !== void 0) a.numCol = options.columns;
-	if (options.columnSpacing !== void 0) a.spcCol = options.columnSpacing * 100;
-	s += attrs(a);
-	let inner = "";
-	if (options.autoFit === "normal") inner += "<a:normAutofit/>";
-	else if (options.autoFit === "shape") inner += "<a:spAutoFit/>";
-	else if (options.autoFit === "none") inner += "<a:noAutofit/>";
-	return inner ? `${s}>${inner}</a:bodyPr>` : `${s}/>`;
-}
 /**
 * p:txBody — Text body within a shape.
 * Lazy: stores options, builds XML object in prepForXml.
@@ -1115,18 +973,6 @@ var TextBody = class extends XmlComponent {
 		}
 		return { "p:txBody": children };
 	}
-	toXml(context) {
-		let s = "<p:txBody>";
-		s += buildBodyPrXml(this.options);
-		s += "<a:lstStyle/>";
-		if (this.options.paragraphs) for (const p of this.options.paragraphs) {
-			const para = typeof p === "string" ? new Paragraph({ children: [new TextRun({ text: p })] }) : p;
-			s += para.toXml(context);
-		}
-		else s += new Paragraph().toXml(context);
-		s += "</p:txBody>";
-		return s;
-	}
 };
 //#endregion
 //#region src/file/notes/notes-slide.ts
@@ -2848,708 +2694,86 @@ var SlideTiming = class extends XmlComponent {
 	}
 };
 //#endregion
-//#region src/file/drawingml/transform-2d.ts
+//#region src/file/transition/transition.ts
 init_xml_components();
+const ORIENT_TYPES = new Set([
+	"blinds",
+	"checker",
+	"comb",
+	"randomBar"
+]);
+const SIDE_DIR_TYPES = new Set(["push", "wipe"]);
+const EIGHT_DIR_TYPES = new Set(["cover", "pull"]);
+function buildTransitionElement(type, dir, orient, thruBlk, spokes) {
+	const attrs = {};
+	if (ORIENT_TYPES.has(type) && dir) attrs.dir = dir;
+	else if (SIDE_DIR_TYPES.has(type) && dir) attrs.dir = dir;
+	else if (EIGHT_DIR_TYPES.has(type) && dir) attrs.dir = dir;
+	else if (type === "strips" && dir) attrs.dir = dir;
+	else if ((type === "fade" || type === "cut") && thruBlk !== void 0) attrs.thruBlk = thruBlk ? 1 : 0;
+	else if (type === "split") {
+		attrs.orient = orient ?? "horz";
+		attrs.dir = dir ?? "out";
+	} else if (type === "wheel") attrs.spokes = spokes ?? 4;
+	else if (type === "zoom" && dir) attrs.dir = dir;
+	return { [`p:${type}`]: Object.keys(attrs).length > 0 ? { _attr: attrs } : {} };
+}
+function buildTransition(options) {
+	const children = [];
+	const attrs = {};
+	if (options.speed) attrs.spd = options.speed;
+	if (options.advanceOnClick !== void 0) attrs.advClick = options.advanceOnClick ? 1 : 0;
+	if (options.advanceAfterTime !== void 0) attrs.advTm = options.advanceAfterTime;
+	if (Object.keys(attrs).length > 0) children.push({ _attr: attrs });
+	if (options.type) children.push(buildTransitionElement(options.type, options.dir, options.orient, options.thruBlk, options.spokes));
+	return { "p:transition": children.length === 0 ? {} : children };
+}
 /**
-* a:xfrm / p:xfrm — 2D transform for shapes and graphic frames (position + size in EMUs).
-* Delegates to core createTransform2D.
+* p:transition — Slide transition effect.
+* Lazy: stores options, builds XML object in prepForXml.
 */
-var Transform2D = class extends XmlComponent {
-	core;
-	constructor(options, prefix = "a") {
-		super(`${prefix}:xfrm`);
-		this.core = createTransform2D(options, `${prefix}:xfrm`);
+var Transition = class extends BaseXmlComponent {
+	options;
+	constructor(options = {}) {
+		super("p:transition");
+		this.options = options;
 	}
-	prepForXml(context) {
-		return this.core["prepForXml"]?.(context);
+	prepForXml(_context) {
+		return buildTransition(this.options);
 	}
 };
 //#endregion
-//#region src/file/media/audio-frame.ts
+//#region src/file/slide/slide.ts
 init_xml_components();
-const MEDIA_EXT_URI$1 = "{CF1602FD-DB20-4165-A070-5F299619DA56}";
+function isAnimatable(child) {
+	return "ShapeId" in child && "Animation" in child;
+}
+function collectAnimations(children) {
+	const entries = [];
+	for (const child of children) if (isAnimatable(child)) {
+		const anim = child.Animation;
+		if (anim) entries.push({
+			spid: child.ShapeId,
+			options: anim
+		});
+	}
+	return entries;
+}
 /**
-* p:pic — An audio frame on a slide.
-*
-* Uses a media relationship for the audio file (via {media:fileName} placeholder).
+* p:sld — A slide in a presentation.
+* Lazy: stores options, builds XML object in prepForXml.
 */
-var AudioFrame = class AudioFrame extends XmlComponent {
-	static nextId = 200;
-	audioData;
-	shapeId;
-	animationOptions;
-	constructor(options) {
-		super("p:pic");
-		const id = AudioFrame.nextId++;
-		this.shapeId = id;
-		this.animationOptions = options.animation;
-		const name = options.name ?? `Audio ${id}`;
-		const mediaFileName = `${name.replace(/\s+/g, "_")}.${options.type}`;
-		this.audioData = {
-			type: options.type,
-			fileName: mediaFileName,
-			transformation: {
-				pixels: {
-					x: options.width ?? 0,
-					y: options.height ?? 0
-				},
-				emus: {
-					x: convertPixelsToEmu$1(options.width ?? 0),
-					y: convertPixelsToEmu$1(options.height ?? 0)
-				}
-			},
-			data: options.data
-		};
-		this.root.push(new BuilderElement({
-			name: "p:nvPicPr",
-			children: [
-				new BuilderElement({
-					name: "a:cNvPr",
-					attributes: {
-						id: {
-							key: "id",
-							value: id
-						},
-						name: {
-							key: "name",
-							value: name
-						},
-						descr: {
-							key: "descr",
-							value: ""
-						}
-					}
-				}),
-				new BuilderElement({
-					name: "a:cNvPicPr",
-					children: [new BuilderElement({
-						name: "a:picLocks",
-						attributes: { noChangeAspect: {
-							key: "noChangeAspect",
-							value: "1"
-						} }
-					})]
-				}),
-				new BuilderElement({
-					name: "p:nvPr",
-					children: [new BuilderElement({
-						name: "p:extLst",
-						children: [new BuilderElement({
-							name: "p:ext",
-							attributes: { uri: {
-								key: "uri",
-								value: MEDIA_EXT_URI$1
-							} },
-							children: [new BuilderElement({
-								name: "p14:media",
-								attributes: {
-									"r:embed": {
-										key: "r:embed",
-										value: `{media:${mediaFileName}}`
-									},
-									"xmlns:p14": {
-										key: "xmlns:p14",
-										value: "http://schemas.microsoft.com/office/powerpoint/2010/main"
-									}
-								}
-							})]
-						})]
-					})]
-				})
-			]
-		}));
-		this.root.push(new BuilderElement({
-			name: "p:blipFill",
-			children: [new BuilderElement({
-				name: "a:stretch",
-				children: [new BuilderElement({ name: "a:fillRect" })]
-			})]
-		}));
-		this.root.push(new BuilderElement({
-			name: "p:spPr",
-			children: [new Transform2D({
-				x: convertPixelsToEmu$1(options.x ?? 0),
-				y: convertPixelsToEmu$1(options.y ?? 0),
-				width: convertPixelsToEmu$1(options.width ?? 0),
-				height: convertPixelsToEmu$1(options.height ?? 0)
-			}), new PresetGeometry({ preset: "rect" })]
-		}));
-	}
-	get ShapeId() {
-		return this.shapeId;
-	}
-	get Animation() {
-		return this.animationOptions;
-	}
-	prepForXml(context) {
-		context.fileData?.Media.addMedia(this.audioData.fileName, this.audioData);
-		return super.prepForXml(context);
-	}
-};
-//#endregion
-//#region src/file/media/video-frame.ts
-init_xml_components();
-const MEDIA_EXT_URI = "{DAA4B4D4-6D71-4841-9C94-3DE7FCFB9230}";
-/** Minimal 1x1 transparent PNG (67 bytes). */
-const MINIMAL_PNG = new Uint8Array([
-	137,
-	80,
-	78,
-	71,
-	13,
-	10,
-	26,
-	10,
-	0,
-	0,
-	0,
-	13,
-	73,
-	72,
-	68,
-	82,
-	0,
-	0,
-	0,
-	1,
-	0,
-	0,
-	0,
-	1,
-	8,
-	6,
-	0,
-	0,
-	0,
-	31,
-	21,
-	196,
-	137,
-	0,
-	0,
-	0,
-	13,
-	73,
-	68,
-	65,
-	84,
-	8,
-	215,
-	99,
-	24,
-	5,
-	163,
-	0,
-	0,
-	0,
-	2,
-	0,
-	1,
-	226,
-	33,
-	188,
-	51,
-	0,
-	0,
-	0,
-	0,
-	73,
-	69,
-	78,
-	68,
-	174,
-	66,
-	96,
-	130
-]);
-/**
-* p:pic — A video frame on a slide.
-*
-* Uses three relationships:
-* - Image relationship for poster frame (via {posterFileName} placeholder)
-* - Video relationship for video file (via {video:fileName} placeholder in a:videoFile r:link)
-* - Media relationship for video file (via {media:fileName} placeholder in p14:media r:embed)
-*/
-var VideoFrame = class VideoFrame extends XmlComponent {
-	static nextId = 100;
-	posterData;
-	videoData;
-	shapeId;
-	animationOptions;
-	constructor(options) {
-		super("p:pic");
-		const id = VideoFrame.nextId++;
-		this.shapeId = id;
-		this.animationOptions = options.animation;
-		const name = options.name ?? `Video ${id}`;
-		const mediaFileName = `${name.replace(/\s+/g, "_")}.${options.type}`;
-		const posterBytes = options.poster ?? MINIMAL_PNG;
-		const posterType = options.posterType ?? "png";
-		const posterFileName = `${name.replace(/\s+/g, "_")}_poster.${posterType}`;
-		this.videoData = {
-			type: options.type,
-			fileName: mediaFileName,
-			transformation: {
-				pixels: {
-					x: options.width ?? 0,
-					y: options.height ?? 0
-				},
-				emus: {
-					x: convertPixelsToEmu$1(options.width ?? 0),
-					y: convertPixelsToEmu$1(options.height ?? 0)
-				}
-			},
-			data: options.data
-		};
-		this.posterData = {
-			type: posterType === "jpg" ? "jpg" : "png",
-			fileName: posterFileName,
-			transformation: {
-				pixels: {
-					x: options.width ?? 0,
-					y: options.height ?? 0
-				},
-				emus: {
-					x: convertPixelsToEmu$1(options.width ?? 0),
-					y: convertPixelsToEmu$1(options.height ?? 0)
-				}
-			},
-			data: posterBytes
-		};
-		const nvPrChildren = [new BuilderElement({
-			name: "a:videoFile",
-			attributes: { "r:link": {
-				key: "r:link",
-				value: `{video:${mediaFileName}}`
-			} }
-		}), new BuilderElement({
-			name: "p:extLst",
-			children: [new BuilderElement({
-				name: "p:ext",
-				attributes: { uri: {
-					key: "uri",
-					value: MEDIA_EXT_URI
-				} },
-				children: [new BuilderElement({
-					name: "p14:media",
-					attributes: {
-						"r:embed": {
-							key: "r:embed",
-							value: `{media:${mediaFileName}}`
-						},
-						"xmlns:p14": {
-							key: "xmlns:p14",
-							value: "http://schemas.microsoft.com/office/powerpoint/2010/main"
-						}
-					}
-				})]
-			})]
-		})];
-		this.root.push(new BuilderElement({
-			name: "p:nvPicPr",
-			children: [
-				new BuilderElement({
-					name: "p:cNvPr",
-					attributes: {
-						id: {
-							key: "id",
-							value: id
-						},
-						name: {
-							key: "name",
-							value: name
-						},
-						descr: {
-							key: "descr",
-							value: ""
-						}
-					}
-				}),
-				new BuilderElement({
-					name: "p:cNvPicPr",
-					children: [new BuilderElement({
-						name: "a:picLocks",
-						attributes: { noChangeAspect: {
-							key: "noChangeAspect",
-							value: "1"
-						} }
-					})]
-				}),
-				new BuilderElement({
-					name: "p:nvPr",
-					children: nvPrChildren
-				})
-			]
-		}));
-		this.root.push(new BuilderElement({
-			name: "p:blipFill",
-			children: [new BuilderElement({
-				name: "a:blip",
-				attributes: { "r:embed": {
-					key: "r:embed",
-					value: `{${posterFileName}}`
-				} }
-			}), new BuilderElement({
-				name: "a:stretch",
-				children: [new BuilderElement({ name: "a:fillRect" })]
-			})]
-		}));
-		this.root.push(new BuilderElement({
-			name: "p:spPr",
-			children: [new Transform2D({
-				x: convertPixelsToEmu$1(options.x ?? 0),
-				y: convertPixelsToEmu$1(options.y ?? 0),
-				width: convertPixelsToEmu$1(options.width ?? 0),
-				height: convertPixelsToEmu$1(options.height ?? 0)
-			}), new PresetGeometry({ preset: "rect" })]
-		}));
-	}
-	get ShapeId() {
-		return this.shapeId;
-	}
-	get Animation() {
-		return this.animationOptions;
-	}
-	prepForXml(context) {
-		const file = context.fileData;
-		file?.Media.addImage(this.posterData.fileName, this.posterData);
-		file?.Media.addMedia(this.videoData.fileName, this.videoData);
-		return super.prepForXml(context);
-	}
-};
-//#endregion
-//#region src/file/drawingml/outline.ts
-const DASH_STYLE_MAP = {
-	solid: "SOLID",
-	dash: "DASH",
-	dashDot: "DASH_DOT",
-	lgDash: "LG_DASH",
-	sysDot: "SYS_DOT",
-	sysDash: "SYS_DASH"
-};
-const ARROWHEAD_MAP = {
-	triangle: "TRIANGLE",
-	stealth: "STEALTH",
-	diamond: "DIAMOND",
-	oval: "OVAL",
-	open: "ARROW"
-};
-const ARROWHEAD_SIZE_MAP = {
-	sm: "SMALL",
-	med: "MEDIUM",
-	lg: "LARGE"
-};
-function toCoreLineEnd(type, width, length) {
-	return {
-		type: ARROWHEAD_MAP[type] ?? "TRIANGLE",
-		...width ? { width: ARROWHEAD_SIZE_MAP[width] } : {},
-		...length ? { length: ARROWHEAD_SIZE_MAP[length] } : {}
-	};
-}
-/**
-* Creates an outline element using pptx's simplified API.
-*/
-const createOutlineCompat = (options = {}, arrowheads) => createOutline$1({
-	width: options.width,
-	...options.color ? {
-		type: "solidFill",
-		color: { value: options.color.replace("#", "") }
-	} : { type: "noFill" },
-	...options.dashStyle && { dash: DASH_STYLE_MAP[options.dashStyle] ?? "SOLID" },
-	...arrowheads?.endType ? { headEnd: toCoreLineEnd(arrowheads.endType, arrowheads.width, arrowheads.length) } : {},
-	...arrowheads?.beginType ? { tailEnd: toCoreLineEnd(arrowheads.beginType, arrowheads.width, arrowheads.length) } : {}
-});
-//#endregion
-//#region src/file/drawingml/shape-properties.ts
-init_xml_components();
-init_effects();
-init_fill();
-/**
-* p:spPr — Shape properties (transform, geometry, fill, outline, effects).
-* Lazy: stores options, builds XML object directly in prepForXml.
-*/
-var ShapeProperties = class extends BaseXmlComponent {
-	options;
-	constructor(options) {
-		super("p:spPr");
-		this.options = options;
-	}
-	prepForXml(context) {
-		const opts = this.options;
-		const children = [];
-		if (opts.x !== void 0 || opts.y !== void 0 || opts.width !== void 0 || opts.height !== void 0 || opts.flipHorizontal !== void 0 || opts.rotation !== void 0) {
-			const xfrmObj = new Transform2D(opts).prepForXml(context);
-			if (xfrmObj) children.push(xfrmObj);
-		}
-		const geomObj = new PresetGeometry({ preset: opts.geometry ?? "rect" }).prepForXml(context);
-		if (geomObj) children.push(geomObj);
-		const media = opts.fill ? extractBlipFillMedia(opts.fill) : void 0;
-		if (media) context.fileData?.Media.addImage(media.fileName, {
-			data: media.data,
-			fileName: media.fileName,
-			type: media.type,
-			transformation: {
-				pixels: {
-					x: 0,
-					y: 0
-				},
-				emus: {
-					x: 0,
-					y: 0
-				}
-			}
-		});
-		const fillObj = buildFill(opts.fill !== void 0 ? opts.fill : { type: "none" }).prepForXml(context);
-		if (fillObj) children.push(fillObj);
-		if (opts.outline) {
-			const outlineObj = createOutlineCompat(opts.outline).prepForXml(context);
-			if (outlineObj) children.push(outlineObj);
-		}
-		if (opts.effects) {
-			const effectObj = createPptxEffectList(opts.effects);
-			if (effectObj) {
-				const effectXmlObj = effectObj.prepForXml(context);
-				if (effectXmlObj) children.push(effectXmlObj);
-			}
-			const scene3d = buildScene3D(opts.effects);
-			if (scene3d) {
-				const sceneObj = scene3d.prepForXml(context);
-				if (sceneObj) children.push(sceneObj);
-			}
-			const shape3d = buildShape3D(opts.effects);
-			if (shape3d) {
-				const shapeObj = shape3d.prepForXml(context);
-				if (shapeObj) children.push(shapeObj);
-			}
-		}
-		if (opts.connectionSites && opts.connectionSites.length > 0) {
-			const cxnChildren = [];
-			for (const site of opts.connectionSites) {
-				const siteAttrs = { pos: `${site.x} ${site.y}` };
-				if (site.angle !== void 0) siteAttrs.ang = site.angle;
-				cxnChildren.push({ "a:cxn": { _attr: siteAttrs } });
-			}
-			children.push({ "a:cxnLst": cxnChildren });
-		}
-		return { "p:spPr": children };
-	}
-};
-//#endregion
-//#region src/file/shape/shape.ts
-init_xml_components();
-/**
-* Pure function: builds p:ph element for placeholder.
-*/
-function buildPlaceholder(type, index) {
-	const attrs = { type };
-	if (index !== void 0) attrs.idx = index;
-	return { "p:ph": { _attr: attrs } };
-}
-/**
-* p:sp — A shape on a slide.
-* Lazy: stores options, builds XML object in prepForXml.
-*
-* x/y/width/height accept pixel values and are internally converted to EMUs.
-*/
-var Shape = class Shape extends XmlComponent {
-	static nextId = 2;
-	shapeId;
-	animationOptions;
-	options;
-	constructor(options = {}) {
-		super("p:sp");
-		const id = options.id ?? Shape.nextId++;
-		this.shapeId = id;
-		this.animationOptions = options.animation;
-		this.options = {
-			...options,
-			id
-		};
-	}
-	get ShapeId() {
-		return this.shapeId;
-	}
-	get Animation() {
-		return this.animationOptions;
-	}
-	prepForXml(context) {
-		const opts = this.options;
-		const id = this.shapeId;
-		const name = opts.name ?? `Shape ${id}`;
-		const children = [];
-		const nvPrChildren = [];
-		if (opts.placeholder) nvPrChildren.push(buildPlaceholder(opts.placeholder, opts.placeholderIndex));
-		children.push({ "p:nvSpPr": [
-			{ "p:cNvPr": { _attr: {
-				id,
-				name
-			} } },
-			{ "p:cNvSpPr": {} },
-			{ "p:nvPr": nvPrChildren.length > 0 ? nvPrChildren : {} }
-		] });
-		const spPrObj = new ShapeProperties({
-			x: opts.x !== void 0 ? convertPixelsToEmu$1(opts.x) : void 0,
-			y: opts.y !== void 0 ? convertPixelsToEmu$1(opts.y) : void 0,
-			width: opts.width !== void 0 ? convertPixelsToEmu$1(opts.width) : void 0,
-			height: opts.height !== void 0 ? convertPixelsToEmu$1(opts.height) : void 0,
-			geometry: opts.geometry,
-			fill: opts.fill,
-			outline: opts.outline,
-			effects: opts.effects,
-			flipHorizontal: opts.flipHorizontal,
-			rotation: opts.rotation
-		}).prepForXml(context);
-		if (spPrObj) children.push(spPrObj);
-		const txBodyObj = new TextBody({
-			paragraphs: opts.paragraphs ?? (opts.text ? [new Paragraph({ text: opts.text })] : void 0),
-			vertical: opts.textVertical,
-			anchor: opts.textAnchor,
-			autoFit: opts.textAutoFit,
-			wrap: opts.textWrap,
-			margins: opts.textMargins,
-			columns: opts.textColumns,
-			columnSpacing: opts.textColumnSpacing
-		}).prepForXml(context);
-		if (txBodyObj) children.push(txBodyObj);
-		return { "p:sp": children };
-	}
-	toXml(context) {
-		const opts = this.options;
-		const id = this.shapeId;
-		const name = escapeXml(opts.name ?? `Shape ${id}`);
-		let s = "<p:sp><p:nvSpPr>";
-		s += `<p:cNvPr${attrs({
-			id,
-			name
-		})}/>`;
-		s += "<p:cNvSpPr/>";
-		if (opts.placeholder) {
-			const phAttrs = { type: opts.placeholder };
-			if (opts.placeholderIndex !== void 0) phAttrs.idx = opts.placeholderIndex;
-			s += `<p:nvPr><p:ph${attrs(phAttrs)}/></p:nvPr>`;
-		} else s += "<p:nvPr/>";
-		s += "</p:nvSpPr>";
-		const spPrObj = new ShapeProperties({
-			x: opts.x !== void 0 ? convertPixelsToEmu$1(opts.x) : void 0,
-			y: opts.y !== void 0 ? convertPixelsToEmu$1(opts.y) : void 0,
-			width: opts.width !== void 0 ? convertPixelsToEmu$1(opts.width) : void 0,
-			height: opts.height !== void 0 ? convertPixelsToEmu$1(opts.height) : void 0,
-			geometry: opts.geometry,
-			fill: opts.fill,
-			outline: opts.outline,
-			effects: opts.effects,
-			flipHorizontal: opts.flipHorizontal,
-			rotation: opts.rotation
-		}).prepForXml(context);
-		if (spPrObj) s += xml(spPrObj);
-		const txBodyOpts = {
-			paragraphs: opts.paragraphs ?? (opts.text ? [new Paragraph({ text: opts.text })] : void 0),
-			vertical: opts.textVertical,
-			anchor: opts.textAnchor,
-			autoFit: opts.textAutoFit,
-			wrap: opts.textWrap,
-			margins: opts.textMargins,
-			columns: opts.textColumns,
-			columnSpacing: opts.textColumnSpacing
-		};
-		s += new TextBody(txBodyOpts).toXml(context);
-		s += "</p:sp>";
-		return s;
-	}
-};
-//#endregion
-//#region src/file/transition/transition.ts
-init_xml_components();
-const ORIENT_TYPES = new Set([
-	"blinds",
-	"checker",
-	"comb",
-	"randomBar"
-]);
-const SIDE_DIR_TYPES = new Set(["push", "wipe"]);
-const EIGHT_DIR_TYPES = new Set(["cover", "pull"]);
-function buildTransitionElement(type, dir, orient, thruBlk, spokes) {
-	const attrs = {};
-	if (ORIENT_TYPES.has(type) && dir) attrs.dir = dir;
-	else if (SIDE_DIR_TYPES.has(type) && dir) attrs.dir = dir;
-	else if (EIGHT_DIR_TYPES.has(type) && dir) attrs.dir = dir;
-	else if (type === "strips" && dir) attrs.dir = dir;
-	else if ((type === "fade" || type === "cut") && thruBlk !== void 0) attrs.thruBlk = thruBlk ? 1 : 0;
-	else if (type === "split") {
-		attrs.orient = orient ?? "horz";
-		attrs.dir = dir ?? "out";
-	} else if (type === "wheel") attrs.spokes = spokes ?? 4;
-	else if (type === "zoom" && dir) attrs.dir = dir;
-	return { [`p:${type}`]: Object.keys(attrs).length > 0 ? { _attr: attrs } : {} };
-}
-function buildTransition(options) {
-	const children = [];
-	const attrs = {};
-	if (options.speed) attrs.spd = options.speed;
-	if (options.advanceOnClick !== void 0) attrs.advClick = options.advanceOnClick ? 1 : 0;
-	if (options.advanceAfterTime !== void 0) attrs.advTm = options.advanceAfterTime;
-	if (Object.keys(attrs).length > 0) children.push({ _attr: attrs });
-	if (options.type) children.push(buildTransitionElement(options.type, options.dir, options.orient, options.thruBlk, options.spokes));
-	return { "p:transition": children.length === 0 ? {} : children };
-}
-/**
-* p:transition — Slide transition effect.
-* Lazy: stores options, builds XML object in prepForXml.
-*/
-var Transition = class extends BaseXmlComponent {
-	options;
-	constructor(options = {}) {
-		super("p:transition");
-		this.options = options;
-	}
-	prepForXml(_context) {
-		return buildTransition(this.options);
-	}
-};
-//#endregion
-//#region src/file/slide/slide.ts
-init_xml_components();
-const NV_GRP_SP_PR = "<p:nvGrpSpPr><p:cNvPr id=\"1\" name=\"\"/><p:cNvGrpSpPr/><p:nvPr/></p:nvGrpSpPr>";
-const GRP_SP_PR = "<p:grpSpPr><a:xfrm><a:off x=\"0\" y=\"0\"/><a:ext cx=\"0\" cy=\"0\"/><a:chOff x=\"0\" y=\"0\"/><a:chExt cx=\"0\" cy=\"0\"/></a:xfrm></p:grpSpPr>";
-const CLR_MAP_OVR = "<p:clrMapOvr><a:masterClrMapping/></p:clrMapOvr>";
-const XMLNS = " 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\"";
-function collectAnimations(children) {
-	const entries = [];
-	for (const child of children) {
-		let anim;
-		let spid;
-		if (child instanceof Shape) {
-			anim = child.Animation;
-			spid = child.ShapeId;
-		} else if (child instanceof VideoFrame) {
-			anim = child.Animation;
-			spid = child.ShapeId;
-		} else if (child instanceof AudioFrame) {
-			anim = child.Animation;
-			spid = child.ShapeId;
-		}
-		if (anim && spid !== void 0) entries.push({
-			spid,
-			options: anim
-		});
-	}
-	return entries;
-}
-/**
-* p:sld — A slide in a presentation.
-* Lazy: stores options, builds XML object in prepForXml.
-*/
-var Slide = class extends XmlComponent {
-	children;
-	background;
-	transition;
-	HeaderFooter;
-	constructor(children, background, transition, headerFooter) {
-		super("p:sld");
-		this.children = children;
-		this.background = background;
-		this.transition = transition;
-		this.HeaderFooter = headerFooter;
+var Slide = class extends XmlComponent {
+	children;
+	background;
+	transition;
+	HeaderFooter;
+	constructor(children, background, transition, headerFooter) {
+		super("p:sld");
+		this.children = children;
+		this.background = background;
+		this.transition = transition;
+		this.HeaderFooter = headerFooter;
 	}
 	prepForXml(context) {
 		const children = [];
@@ -3606,35 +2830,6 @@ var Slide = class extends XmlComponent {
 		}
 		return { "p:sld": children };
 	}
-	toXml(context) {
-		let s = `<p:sld${XMLNS}>`;
-		s += "<p:cSld>";
-		if (this.background) {
-			const bgObj = this.background.prepForXml(context);
-			if (bgObj) s += xml(bgObj);
-		}
-		s += "<p:spTree>";
-		s += NV_GRP_SP_PR;
-		s += GRP_SP_PR;
-		for (const child of this.children) if (typeof child.toXml === "function") s += child.toXml(context);
-		else {
-			const obj = child.prepForXml(context);
-			if (obj) s += xml(obj);
-		}
-		s += "</p:spTree></p:cSld>";
-		s += CLR_MAP_OVR;
-		if (this.transition) {
-			const transObj = buildTransition(this.transition);
-			if (transObj) s += xml(transObj);
-		}
-		const animations = collectAnimations(this.children);
-		if (animations.length > 0) {
-			const timingObj = new SlideTiming(animations).prepForXml(context);
-			if (timingObj) s += xml(timingObj);
-		}
-		s += "</p:sld>";
-		return s;
-	}
 };
 //#endregion
 //#region src/file/table-styles.ts
@@ -4117,6 +3312,250 @@ var File = class {
 	}
 };
 //#endregion
+//#region src/file/drawingml/outline.ts
+const DASH_STYLE_MAP = {
+	solid: "SOLID",
+	dash: "DASH",
+	dashDot: "DASH_DOT",
+	lgDash: "LG_DASH",
+	sysDot: "SYS_DOT",
+	sysDash: "SYS_DASH"
+};
+const ARROWHEAD_MAP = {
+	triangle: "TRIANGLE",
+	stealth: "STEALTH",
+	diamond: "DIAMOND",
+	oval: "OVAL",
+	open: "ARROW"
+};
+const ARROWHEAD_SIZE_MAP = {
+	sm: "SMALL",
+	med: "MEDIUM",
+	lg: "LARGE"
+};
+function toCoreLineEnd(type, width, length) {
+	return {
+		type: ARROWHEAD_MAP[type] ?? "TRIANGLE",
+		...width ? { width: ARROWHEAD_SIZE_MAP[width] } : {},
+		...length ? { length: ARROWHEAD_SIZE_MAP[length] } : {}
+	};
+}
+/**
+* Creates an outline element using pptx's simplified API.
+*/
+const createOutlineCompat = (options = {}, arrowheads) => createOutline$1({
+	width: options.width,
+	...options.color ? {
+		type: "solidFill",
+		color: { value: options.color.replace("#", "") }
+	} : { type: "noFill" },
+	...options.dashStyle && { dash: DASH_STYLE_MAP[options.dashStyle] ?? "SOLID" },
+	...arrowheads?.endType ? { headEnd: toCoreLineEnd(arrowheads.endType, arrowheads.width, arrowheads.length) } : {},
+	...arrowheads?.beginType ? { tailEnd: toCoreLineEnd(arrowheads.beginType, arrowheads.width, arrowheads.length) } : {}
+});
+//#endregion
+//#region src/file/drawingml/transform-2d.ts
+init_xml_components();
+/**
+* a:xfrm / p:xfrm — 2D transform for shapes and graphic frames (position + size in EMUs).
+* Delegates to core createTransform2D.
+*/
+var Transform2D = class extends XmlComponent {
+	core;
+	constructor(options, prefix = "a") {
+		super(`${prefix}:xfrm`);
+		this.core = createTransform2D(options, `${prefix}:xfrm`);
+	}
+	prepForXml(context) {
+		return this.core["prepForXml"]?.(context);
+	}
+};
+//#endregion
+//#region src/file/drawingml/shape-properties.ts
+init_xml_components();
+init_effects();
+init_fill();
+/**
+* p:spPr — Shape properties (transform, geometry, fill, outline, effects).
+* Lazy: stores options, builds XML object directly in prepForXml.
+*/
+var ShapeProperties = class extends BaseXmlComponent {
+	options;
+	constructor(options) {
+		super("p:spPr");
+		this.options = options;
+	}
+	prepForXml(context) {
+		const opts = this.options;
+		const children = [];
+		if (opts.x !== void 0 || opts.y !== void 0 || opts.width !== void 0 || opts.height !== void 0 || opts.flipHorizontal !== void 0 || opts.rotation !== void 0) {
+			const xfrmObj = new Transform2D(opts).prepForXml(context);
+			if (xfrmObj) children.push(xfrmObj);
+		}
+		const geomObj = new PresetGeometry({ preset: opts.geometry ?? "rect" }).prepForXml(context);
+		if (geomObj) children.push(geomObj);
+		const media = opts.fill ? extractBlipFillMedia(opts.fill) : void 0;
+		if (media) context.fileData?.Media.addImage(media.fileName, {
+			data: media.data,
+			fileName: media.fileName,
+			type: media.type,
+			transformation: {
+				pixels: {
+					x: 0,
+					y: 0
+				},
+				emus: {
+					x: 0,
+					y: 0
+				}
+			}
+		});
+		const fillObj = buildFill(opts.fill !== void 0 ? opts.fill : { type: "none" }).prepForXml(context);
+		if (fillObj) children.push(fillObj);
+		if (opts.outline) {
+			const outlineObj = createOutlineCompat(opts.outline).prepForXml(context);
+			if (outlineObj) children.push(outlineObj);
+		}
+		if (opts.effects) {
+			const effectObj = createPptxEffectList(opts.effects);
+			if (effectObj) {
+				const effectXmlObj = effectObj.prepForXml(context);
+				if (effectXmlObj) children.push(effectXmlObj);
+			}
+			const scene3d = buildScene3D(opts.effects);
+			if (scene3d) {
+				const sceneObj = scene3d.prepForXml(context);
+				if (sceneObj) children.push(sceneObj);
+			}
+			const shape3d = buildShape3D(opts.effects);
+			if (shape3d) {
+				const shapeObj = shape3d.prepForXml(context);
+				if (shapeObj) children.push(shapeObj);
+			}
+		}
+		if (opts.connectionSites && opts.connectionSites.length > 0) {
+			const cxnChildren = [];
+			for (const site of opts.connectionSites) {
+				const siteAttrs = { pos: `${site.x} ${site.y}` };
+				if (site.angle !== void 0) siteAttrs.ang = site.angle;
+				cxnChildren.push({ "a:cxn": { _attr: siteAttrs } });
+			}
+			children.push({ "a:cxnLst": cxnChildren });
+		}
+		return { "p:spPr": children };
+	}
+};
+//#endregion
+//#region src/util/position.ts
+/**
+* Position/size conversion utilities for PPTX components.
+* @module
+*/
+/**
+* Converts pixel position/size values to EMU, defaulting missing values to 0.
+*
+* Used by components that always need a transform (ChartFrame, Picture,
+* TableFrame, SmartArtFrame, MediaFrameBase, etc.).
+*/
+function emuPosition(opts) {
+	return {
+		x: convertPixelsToEmu$1(opts.x ?? 0),
+		y: convertPixelsToEmu$1(opts.y ?? 0),
+		width: convertPixelsToEmu$1(opts.width ?? 0),
+		height: convertPixelsToEmu$1(opts.height ?? 0)
+	};
+}
+/**
+* Converts pixel position/size values to EMU, preserving undefined.
+*
+* Used by Shape which may omit position to let PowerPoint auto-layout.
+*/
+function emuPositionOptional(opts) {
+	return {
+		x: opts.x !== void 0 ? convertPixelsToEmu$1(opts.x) : void 0,
+		y: opts.y !== void 0 ? convertPixelsToEmu$1(opts.y) : void 0,
+		width: opts.width !== void 0 ? convertPixelsToEmu$1(opts.width) : void 0,
+		height: opts.height !== void 0 ? convertPixelsToEmu$1(opts.height) : void 0
+	};
+}
+//#endregion
+//#region src/file/shape/shape.ts
+init_xml_components();
+/**
+* Pure function: builds p:ph element for placeholder.
+*/
+function buildPlaceholder(type, index) {
+	const attrs = { type };
+	if (index !== void 0) attrs.idx = index;
+	return { "p:ph": { _attr: attrs } };
+}
+/**
+* p:sp — A shape on a slide.
+* Lazy: stores options, builds XML object in prepForXml.
+*
+* x/y/width/height accept pixel values and are internally converted to EMUs.
+*/
+var Shape = class Shape extends XmlComponent {
+	static nextId = 2;
+	shapeId;
+	animationOptions;
+	options;
+	constructor(options = {}) {
+		super("p:sp");
+		const id = options.id ?? Shape.nextId++;
+		this.shapeId = id;
+		this.animationOptions = options.animation;
+		this.options = {
+			...options,
+			id
+		};
+	}
+	get ShapeId() {
+		return this.shapeId;
+	}
+	get Animation() {
+		return this.animationOptions;
+	}
+	prepForXml(context) {
+		const opts = this.options;
+		const id = this.shapeId;
+		const name = opts.name ?? `Shape ${id}`;
+		const children = [];
+		const nvPrChildren = [];
+		if (opts.placeholder) nvPrChildren.push(buildPlaceholder(opts.placeholder, opts.placeholderIndex));
+		children.push({ "p:nvSpPr": [
+			{ "p:cNvPr": { _attr: {
+				id,
+				name
+			} } },
+			{ "p:cNvSpPr": {} },
+			{ "p:nvPr": nvPrChildren.length > 0 ? nvPrChildren : {} }
+		] });
+		const spPrObj = new ShapeProperties({
+			...emuPositionOptional(opts),
+			geometry: opts.geometry,
+			fill: opts.fill,
+			outline: opts.outline,
+			effects: opts.effects,
+			flipHorizontal: opts.flipHorizontal,
+			rotation: opts.rotation
+		}).prepForXml(context);
+		if (spPrObj) children.push(spPrObj);
+		const txBodyObj = new TextBody({
+			paragraphs: opts.paragraphs ?? (opts.text ? [new Paragraph({ text: opts.text })] : void 0),
+			vertical: opts.textVertical,
+			anchor: opts.textAnchor,
+			autoFit: opts.textAutoFit,
+			wrap: opts.textWrap,
+			margins: opts.textMargins,
+			columns: opts.textColumns,
+			columnSpacing: opts.textColumnSpacing
+		}).prepForXml(context);
+		if (txBodyObj) children.push(txBodyObj);
+		return { "p:sp": children };
+	}
+};
+//#endregion
 //#region src/file/shape/paragraph/text.ts
 init_xml_components();
 /**
@@ -4502,6 +3941,281 @@ var ConnectorShape = class ConnectorShape extends XmlComponent {
 	}
 };
 //#endregion
+//#region src/file/media/media-frame-base.ts
+/**
+* Shared base class for media frames (video, audio) on slides.
+* @module
+*/
+init_xml_components();
+/**
+* Builds an IMediaData object from pixel dimensions and raw data.
+* Generic parameter preserves the specific type literal for correct union narrowing.
+*/
+function buildMediaData(type, fileName, width, height, data) {
+	return {
+		type,
+		fileName,
+		transformation: {
+			pixels: {
+				x: width,
+				y: height
+			},
+			emus: {
+				x: convertPixelsToEmu$1(width),
+				y: convertPixelsToEmu$1(height)
+			}
+		},
+		data
+	};
+}
+/**
+* Base class for media frames (video, audio) on slides.
+*
+* Encapsulates the common structure: ID assignment, media data building,
+* p:spPr (Transform2D + PresetGeometry), p:blipFill, p:nvPicPr parts,
+* and media registration in prepForXml.
+*/
+var MediaFrameBase = class extends XmlComponent {
+	shapeId;
+	animationOptions;
+	mediaData;
+	posterData;
+	constructor(options, id, mediaFileName, params) {
+		super("p:pic");
+		this.shapeId = id;
+		this.animationOptions = options.animation;
+		const name = options.name ?? `Media ${id}`;
+		const w = options.width ?? 0;
+		const h = options.height ?? 0;
+		this.mediaData = buildMediaData(options.type, mediaFileName, w, h, options.data);
+		if (params.posterBytes) {
+			const pt = params.posterType ?? "png";
+			const pfn = params.posterFileName ?? `${name.replace(/\s+/g, "_")}_poster.${pt}`;
+			this.posterData = buildMediaData(pt === "jpg" ? "jpg" : "png", pfn, w, h, params.posterBytes);
+		}
+		const nvPrChildren = [...params.nvPrExtraChildren ?? []];
+		nvPrChildren.push(new BuilderElement({
+			name: "p:extLst",
+			children: [new BuilderElement({
+				name: "p:ext",
+				attributes: { uri: {
+					key: "uri",
+					value: params.extUri
+				} },
+				children: [new BuilderElement({
+					name: "p14:media",
+					attributes: {
+						"r:embed": {
+							key: "r:embed",
+							value: `{media:${mediaFileName}}`
+						},
+						"xmlns:p14": {
+							key: "xmlns:p14",
+							value: "http://schemas.microsoft.com/office/powerpoint/2010/main"
+						}
+					}
+				})]
+			})]
+		}));
+		this.root.push(new BuilderElement({
+			name: "p:nvPicPr",
+			children: [
+				new BuilderElement({
+					name: `${params.cNvPrPrefix}:cNvPr`,
+					attributes: {
+						id: {
+							key: "id",
+							value: id
+						},
+						name: {
+							key: "name",
+							value: name
+						},
+						descr: {
+							key: "descr",
+							value: ""
+						}
+					}
+				}),
+				new BuilderElement({
+					name: `${params.cNvPrPrefix}:cNvPicPr`,
+					children: [new BuilderElement({
+						name: "a:picLocks",
+						attributes: { noChangeAspect: {
+							key: "noChangeAspect",
+							value: "1"
+						} }
+					})]
+				}),
+				new BuilderElement({
+					name: "p:nvPr",
+					children: nvPrChildren
+				})
+			]
+		}));
+		const blipFillChildren = [];
+		if (this.posterData) blipFillChildren.push(new BuilderElement({
+			name: "a:blip",
+			attributes: { "r:embed": {
+				key: "r:embed",
+				value: `{${this.posterData.fileName}}`
+			} }
+		}));
+		blipFillChildren.push(new BuilderElement({
+			name: "a:stretch",
+			children: [new BuilderElement({ name: "a:fillRect" })]
+		}));
+		this.root.push(new BuilderElement({
+			name: "p:blipFill",
+			children: blipFillChildren
+		}));
+		this.root.push(new BuilderElement({
+			name: "p:spPr",
+			children: [new Transform2D({ ...emuPosition(options) }), new PresetGeometry({ preset: "rect" })]
+		}));
+	}
+	get ShapeId() {
+		return this.shapeId;
+	}
+	get Animation() {
+		return this.animationOptions;
+	}
+	prepForXml(context) {
+		const file = context.fileData;
+		if (this.posterData) file?.Media.addImage(this.posterData.fileName, this.posterData);
+		file?.Media.addMedia(this.mediaData.fileName, this.mediaData);
+		return super.prepForXml(context);
+	}
+};
+//#endregion
+//#region src/file/media/video-frame.ts
+init_xml_components();
+const MEDIA_EXT_URI$1 = "{DAA4B4D4-6D71-4841-9C94-3DE7FCFB9230}";
+/** Minimal 1x1 transparent PNG (67 bytes). */
+const MINIMAL_PNG = new Uint8Array([
+	137,
+	80,
+	78,
+	71,
+	13,
+	10,
+	26,
+	10,
+	0,
+	0,
+	0,
+	13,
+	73,
+	72,
+	68,
+	82,
+	0,
+	0,
+	0,
+	1,
+	0,
+	0,
+	0,
+	1,
+	8,
+	6,
+	0,
+	0,
+	0,
+	31,
+	21,
+	196,
+	137,
+	0,
+	0,
+	0,
+	13,
+	73,
+	68,
+	65,
+	84,
+	8,
+	215,
+	99,
+	24,
+	5,
+	163,
+	0,
+	0,
+	0,
+	2,
+	0,
+	1,
+	226,
+	33,
+	188,
+	51,
+	0,
+	0,
+	0,
+	0,
+	73,
+	69,
+	78,
+	68,
+	174,
+	66,
+	96,
+	130
+]);
+/**
+* p:pic — A video frame on a slide.
+*
+* Uses three relationships:
+* - Image relationship for poster frame (via {posterFileName} placeholder)
+* - Video relationship for video file (via {video:fileName} placeholder in a:videoFile r:link)
+* - Media relationship for video file (via {media:fileName} placeholder in p14:media r:embed)
+*/
+var VideoFrame = class VideoFrame extends MediaFrameBase {
+	static nextId = 100;
+	constructor(options) {
+		const id = VideoFrame.nextId++;
+		const name = options.name ?? `Video ${id}`;
+		const mediaFileName = `${name.replace(/\s+/g, "_")}.${options.type}`;
+		const posterBytes = options.poster ?? MINIMAL_PNG;
+		const posterType = options.posterType ?? "png";
+		const posterFileName = `${name.replace(/\s+/g, "_")}_poster.${posterType}`;
+		super(options, id, mediaFileName, {
+			extUri: MEDIA_EXT_URI$1,
+			cNvPrPrefix: "p",
+			nvPrExtraChildren: [new BuilderElement({
+				name: "a:videoFile",
+				attributes: { "r:link": {
+					key: "r:link",
+					value: `{video:${mediaFileName}}`
+				} }
+			})],
+			posterBytes,
+			posterType,
+			posterFileName
+		});
+	}
+};
+//#endregion
+//#region src/file/media/audio-frame.ts
+const MEDIA_EXT_URI = "{CF1602FD-DB20-4165-A070-5F299619DA56}";
+/**
+* p:pic — An audio frame on a slide.
+*
+* Uses a media relationship for the audio file (via {media:fileName} placeholder).
+*/
+var AudioFrame = class AudioFrame extends MediaFrameBase {
+	static nextId = 200;
+	constructor(options) {
+		const id = AudioFrame.nextId++;
+		const mediaFileName = `${(options.name ?? `Audio ${id}`).replace(/\s+/g, "_")}.${options.type}`;
+		super(options, id, mediaFileName, {
+			extUri: MEDIA_EXT_URI,
+			cNvPrPrefix: "a"
+		});
+	}
+};
+//#endregion
 //#region src/file/shape-tree/shape-tree.ts
 init_xml_components();
 /**
@@ -4673,12 +4387,7 @@ var Picture = class Picture extends XmlComponent {
 		this.root.push(new BlipFill(fileName));
 		this.root.push(new BuilderElement({
 			name: "p:spPr",
-			children: [new Transform2D({
-				x: convertPixelsToEmu$1(options.x ?? 0),
-				y: convertPixelsToEmu$1(options.y ?? 0),
-				width: convertPixelsToEmu$1(options.width ?? 0),
-				height: convertPixelsToEmu$1(options.height ?? 0)
-			}), new PresetGeometry({ preset: "rect" })]
+			children: [new Transform2D({ ...emuPosition(options) }), new PresetGeometry({ preset: "rect" })]
 		}));
 	}
 	prepForXml(context) {
@@ -4873,12 +4582,7 @@ var TableFrame = class extends XmlComponent {
 	constructor(options) {
 		super("p:graphicFrame");
 		this.root.push(new GraphicFrameNonVisual$2());
-		this.root.push(new Transform2D({
-			x: convertPixelsToEmu$1(options.x ?? 0),
-			y: convertPixelsToEmu$1(options.y ?? 0),
-			width: convertPixelsToEmu$1(options.width ?? 0),
-			height: convertPixelsToEmu$1(options.height ?? 0)
-		}, "p"));
+		this.root.push(new Transform2D({ ...emuPosition(options) }, "p"));
 		const table = new Table(options);
 		this.root.push(new Graphic(table));
 	}
@@ -4902,12 +4606,7 @@ var ChartFrame = class extends XmlComponent {
 		this.chartKey = `chart_${nextChartFrameId++}`;
 		const id = nextChartFrameId++;
 		this.root.push(new GraphicFrameNonVisual$1(id));
-		this.root.push(new Transform2D({
-			x: convertPixelsToEmu$1(options.x ?? 0),
-			y: convertPixelsToEmu$1(options.y ?? 0),
-			width: convertPixelsToEmu$1(options.width ?? 0),
-			height: convertPixelsToEmu$1(options.height ?? 0)
-		}, "p"));
+		this.root.push(new Transform2D({ ...emuPosition(options) }, "p"));
 		this.root.push(new ChartGraphic(this.chartKey));
 	}
 	prepForXml(context) {
@@ -5009,12 +4708,7 @@ var SmartArtFrame = class extends XmlComponent {
 		const id = nextSmartArtFrameId++;
 		const name = options.name ?? `Diagram ${id}`;
 		this.root.push(new GraphicFrameNonVisual(id, name));
-		this.root.push(new Transform2D({
-			x: convertPixelsToEmu$1(options.x ?? 0),
-			y: convertPixelsToEmu$1(options.y ?? 0),
-			width: convertPixelsToEmu$1(options.width ?? 0),
-			height: convertPixelsToEmu$1(options.height ?? 0)
-		}, "p"));
+		this.root.push(new Transform2D({ ...emuPosition(options) }, "p"));
 		this.root.push(new SmartArtGraphic(this.smartArtKey));
 	}
 	prepForXml(context) {