@office-kit/pptx 0.16.1 → 0.18.0

package/dist/{api-Dt6q_IAv.js → api-0CdoUwvg.js}

@@ -27,6 +27,9 @@ const STORE_BY_EXTENSION = new Set([
 	"wmv",
 	"mov",
 	"avi",
+	"webm",
+	"ogg",
+	"wma",
 	"pdf",
 	"zip",
 	"gz",
@@ -825,7 +828,7 @@ const emptyContentTypes = () => ({
 const REL_NS = NS.relationships;
 const NAME_RELATIONSHIPS = qname("", "Relationships", REL_NS);
 const NAME_RELATIONSHIP = qname("", "Relationship", REL_NS);
-const ATTR_ID$14 = qname("", "Id", "");
+const ATTR_ID$16 = qname("", "Id", "");
 const ATTR_TYPE$7 = qname("", "Type", "");
 const ATTR_TARGET = qname("", "Target", "");
 const ATTR_TARGET_MODE = qname("", "TargetMode", "");
@@ -863,7 +866,7 @@ const serializeRels = (rels) => {
 	const children = rels.items.map((r) => {
 		const attrs = [
 			{
-				name: ATTR_ID$14,
+				name: ATTR_ID$16,
 				value: r.id
 			},
 			{
@@ -1060,6 +1063,79 @@ const contentTypeForFormat = (format) => {
 	}
 };
 //#endregion
+//#region src/internal/opc/media-format.ts
+const VIDEO_CONTENT_TYPES = {
+	mp4: "video/mp4",
+	m4v: "video/mp4",
+	mov: "video/quicktime",
+	webm: "video/webm",
+	avi: "video/x-msvideo",
+	wmv: "video/x-ms-wmv"
+};
+const AUDIO_CONTENT_TYPES = {
+	mp3: "audio/mpeg",
+	wav: "audio/x-wav",
+	m4a: "audio/mp4",
+	ogg: "audio/ogg",
+	wma: "audio/x-ms-wma"
+};
+const contentTypeForVideoFormat = (format) => VIDEO_CONTENT_TYPES[format];
+const contentTypeForAudioFormat = (format) => AUDIO_CONTENT_TYPES[format];
+const hasBytesAt = (bytes, at, signature) => {
+	if (bytes.length < at + signature.length) return false;
+	for (let i = 0; i < signature.length; i++) if (bytes[at + i] !== signature[i]) return false;
+	return true;
+};
+const hasAsciiAt = (bytes, at, text) => hasBytesAt(bytes, at, Array.from(text, (ch) => ch.charCodeAt(0)));
+const isoBrand = (bytes) => hasAsciiAt(bytes, 4, "ftyp") && bytes.length >= 12 ? String.fromCharCode(bytes[8], bytes[9], bytes[10], bytes[11]) : null;
+const isRiff = (bytes, form) => hasAsciiAt(bytes, 0, "RIFF") && hasAsciiAt(bytes, 8, form);
+const ASF_HEADER = [
+	48,
+	38,
+	178,
+	117,
+	142,
+	102,
+	207,
+	17
+];
+const EBML_HEADER = [
+	26,
+	69,
+	223,
+	163
+];
+const EBML_DOCTYPE_WINDOW = 64;
+const isWebm = (bytes) => {
+	if (!hasBytesAt(bytes, 0, EBML_HEADER)) return false;
+	const limit = Math.min(bytes.length, EBML_DOCTYPE_WINDOW) - 4;
+	for (let i = 4; i <= limit; i++) if (hasAsciiAt(bytes, i, "webm")) return true;
+	return false;
+};
+/** Detects a video container, or `null` when no known signature matches. */
+const detectVideoFormat = (bytes) => {
+	const brand = isoBrand(bytes);
+	if (brand !== null) {
+		if (brand === "qt  ") return "mov";
+		if (brand === "M4V ") return "m4v";
+		return "mp4";
+	}
+	if (isWebm(bytes)) return "webm";
+	if (isRiff(bytes, "AVI ")) return "avi";
+	if (hasBytesAt(bytes, 0, ASF_HEADER)) return "wmv";
+	return null;
+};
+/** Detects an audio container, or `null` when no known signature matches. */
+const detectAudioFormat = (bytes) => {
+	if (isoBrand(bytes) !== null) return "m4a";
+	if (isRiff(bytes, "WAVE")) return "wav";
+	if (hasAsciiAt(bytes, 0, "OggS")) return "ogg";
+	if (hasBytesAt(bytes, 0, ASF_HEADER)) return "wma";
+	if (hasAsciiAt(bytes, 0, "ID3")) return "mp3";
+	if (bytes.length >= 2 && bytes[0] === 255 && (bytes[1] & 224) === 224) return "mp3";
+	return null;
+};
+//#endregion
 //#region src/internal/parts/package.ts
 const TEXT_DECODER$1 = new TextDecoder();
 const TEXT_ENCODER$3 = new TextEncoder();
@@ -1382,7 +1458,7 @@ const savePresentation = (pres) => {
 //#region src/internal/presentationml/relationship-types.ts
 const OFFICE_DOC = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
 const PACKAGE = "http://schemas.openxmlformats.org/package/2006/relationships";
-const MS_2010 = "http://schemas.microsoft.com/office/2010/relationships";
+const MS_2007 = "http://schemas.microsoft.com/office/2007/relationships";
 const MS_2015 = "http://schemas.microsoft.com/office/2015/relationships";
 const REL_TYPES = {
 	officeDocument: `${OFFICE_DOC}/officeDocument`,
@@ -1411,10 +1487,10 @@ const REL_TYPES = {
 	diagramLayout: `${OFFICE_DOC}/diagramLayout`,
 	diagramQuickStyle: `${OFFICE_DOC}/diagramQuickStyle`,
 	diagramColors: `${OFFICE_DOC}/diagramColors`,
-	media: `${MS_2010}/media`,
-	video: `${MS_2010}/video`,
-	audio: `${MS_2010}/audio`,
-	font: `${MS_2010}/font`,
+	media: `${MS_2007}/media`,
+	video: `${OFFICE_DOC}/video`,
+	audio: `${OFFICE_DOC}/audio`,
+	font: `${OFFICE_DOC}/font`,
 	authors: `${MS_2015}/authors`,
 	modernComment: `${MS_2015}/comments`,
 	comments: `${OFFICE_DOC}/comments`,
@@ -1431,13 +1507,13 @@ const NAME_NOTES_MASTER_ID_LST = qname("p", "notesMasterIdLst", NS.pml);
 const NAME_NOTES_MASTER_ID = qname("p", "notesMasterId", NS.pml);
 const NAME_SLD_SZ = qname("p", "sldSz", NS.pml);
 const NAME_NOTES_SZ = qname("p", "notesSz", NS.pml);
-const ATTR_ID$13 = qname("", "id", "");
-const ATTR_R_ID$3 = qname("r", "id", NS.officeDocRels);
+const ATTR_ID$15 = qname("", "id", "");
+const ATTR_R_ID$4 = qname("r", "id", NS.officeDocRels);
 const ATTR_CX$9 = qname("", "cx", "");
 const ATTR_CY$9 = qname("", "cy", "");
 const ATTR_TYPE$6 = qname("", "type", "");
 const requireRId = (element, context) => {
-	const value = getAttrValue(element, ATTR_R_ID$3);
+	const value = getAttrValue(element, ATTR_R_ID$4);
 	if (value === null) throw new Error(`${context}: missing r:id attribute`);
 	return value;
 };
@@ -1463,7 +1539,7 @@ const readPresentationPart = (root) => {
 	const sldMasters = [];
 	const sldMasterLst = firstChildElement(root, NAME_SLD_MASTER_ID_LST$1);
 	if (sldMasterLst !== null) for (const item of allChildElements(sldMasterLst, NAME_SLD_MASTER_ID)) {
-		const idRaw = getAttrValue(item, ATTR_ID$13);
+		const idRaw = getAttrValue(item, ATTR_ID$15);
 		if (idRaw === null) throw new Error("<p:sldMasterId>: missing id attribute");
 		sldMasters.push({
 			id: Number.parseInt(idRaw, 10),
@@ -1473,7 +1549,7 @@ const readPresentationPart = (root) => {
 	const slides = [];
 	const sldLst = firstChildElement(root, NAME_SLD_ID_LST$2);
 	if (sldLst !== null) for (const item of allChildElements(sldLst, NAME_SLD_ID$2)) {
-		const idRaw = getAttrValue(item, ATTR_ID$13);
+		const idRaw = getAttrValue(item, ATTR_ID$15);
 		if (idRaw === null) throw new Error("<p:sldId>: missing id attribute");
 		slides.push({
 			id: Number.parseInt(idRaw, 10),
@@ -1551,7 +1627,15 @@ const RANGES = {
 	overlap: [-100, 100],
 	gapAmount: [0, 500],
 	holeSize: [1, 90],
-	firstSliceAng: [0, 360]
+	firstSliceAng: [0, 360],
+	rotX: [-90, 90],
+	rotY: [0, 360],
+	perspective: [0, 240],
+	depthPercent: [20, 2e3],
+	heightPercent: [5, 500],
+	secondPieSize: [5, 200],
+	bubbleScale: [0, 300],
+	percent100000: [0, 1e5]
 };
 const boundedInt = (value, key, field) => {
 	if (!Number.isFinite(value)) throw new RangeError(`${field}: expected a finite number, got ${value}`);
@@ -1598,6 +1682,310 @@ const oneOf = (value, allowed, field) => {
 	return value;
 };
 //#endregion
+//#region src/internal/enum-values.ts
+const SHAPE_PRESETS = [
+	"line",
+	"lineInv",
+	"triangle",
+	"rtTriangle",
+	"rect",
+	"diamond",
+	"parallelogram",
+	"trapezoid",
+	"nonIsoscelesTrapezoid",
+	"pentagon",
+	"hexagon",
+	"heptagon",
+	"octagon",
+	"decagon",
+	"dodecagon",
+	"star4",
+	"star5",
+	"star6",
+	"star7",
+	"star8",
+	"star10",
+	"star12",
+	"star16",
+	"star24",
+	"star32",
+	"roundRect",
+	"round1Rect",
+	"round2SameRect",
+	"round2DiagRect",
+	"snipRoundRect",
+	"snip1Rect",
+	"snip2SameRect",
+	"snip2DiagRect",
+	"plaque",
+	"ellipse",
+	"teardrop",
+	"homePlate",
+	"chevron",
+	"pieWedge",
+	"pie",
+	"blockArc",
+	"donut",
+	"noSmoking",
+	"rightArrow",
+	"leftArrow",
+	"upArrow",
+	"downArrow",
+	"stripedRightArrow",
+	"notchedRightArrow",
+	"bentUpArrow",
+	"leftRightArrow",
+	"upDownArrow",
+	"leftUpArrow",
+	"leftRightUpArrow",
+	"quadArrow",
+	"leftArrowCallout",
+	"rightArrowCallout",
+	"upArrowCallout",
+	"downArrowCallout",
+	"leftRightArrowCallout",
+	"upDownArrowCallout",
+	"quadArrowCallout",
+	"bentArrow",
+	"uturnArrow",
+	"circularArrow",
+	"leftCircularArrow",
+	"leftRightCircularArrow",
+	"curvedRightArrow",
+	"curvedLeftArrow",
+	"curvedUpArrow",
+	"curvedDownArrow",
+	"swooshArrow",
+	"cube",
+	"can",
+	"lightningBolt",
+	"heart",
+	"sun",
+	"moon",
+	"smileyFace",
+	"irregularSeal1",
+	"irregularSeal2",
+	"foldedCorner",
+	"bevel",
+	"frame",
+	"halfFrame",
+	"corner",
+	"diagStripe",
+	"chord",
+	"arc",
+	"leftBracket",
+	"rightBracket",
+	"leftBrace",
+	"rightBrace",
+	"bracketPair",
+	"bracePair",
+	"straightConnector1",
+	"bentConnector2",
+	"bentConnector3",
+	"bentConnector4",
+	"bentConnector5",
+	"curvedConnector2",
+	"curvedConnector3",
+	"curvedConnector4",
+	"curvedConnector5",
+	"callout1",
+	"callout2",
+	"callout3",
+	"accentCallout1",
+	"accentCallout2",
+	"accentCallout3",
+	"borderCallout1",
+	"borderCallout2",
+	"borderCallout3",
+	"accentBorderCallout1",
+	"accentBorderCallout2",
+	"accentBorderCallout3",
+	"wedgeRectCallout",
+	"wedgeRoundRectCallout",
+	"wedgeEllipseCallout",
+	"cloudCallout",
+	"cloud",
+	"ribbon",
+	"ribbon2",
+	"ellipseRibbon",
+	"ellipseRibbon2",
+	"leftRightRibbon",
+	"verticalScroll",
+	"horizontalScroll",
+	"wave",
+	"doubleWave",
+	"plus",
+	"flowChartProcess",
+	"flowChartDecision",
+	"flowChartInputOutput",
+	"flowChartPredefinedProcess",
+	"flowChartInternalStorage",
+	"flowChartDocument",
+	"flowChartMultidocument",
+	"flowChartTerminator",
+	"flowChartPreparation",
+	"flowChartManualInput",
+	"flowChartManualOperation",
+	"flowChartConnector",
+	"flowChartPunchedCard",
+	"flowChartPunchedTape",
+	"flowChartSummingJunction",
+	"flowChartOr",
+	"flowChartCollate",
+	"flowChartSort",
+	"flowChartExtract",
+	"flowChartMerge",
+	"flowChartOfflineStorage",
+	"flowChartOnlineStorage",
+	"flowChartMagneticTape",
+	"flowChartMagneticDisk",
+	"flowChartMagneticDrum",
+	"flowChartDisplay",
+	"flowChartDelay",
+	"flowChartAlternateProcess",
+	"flowChartOffpageConnector",
+	"actionButtonBlank",
+	"actionButtonHome",
+	"actionButtonHelp",
+	"actionButtonInformation",
+	"actionButtonForwardNext",
+	"actionButtonBackPrevious",
+	"actionButtonEnd",
+	"actionButtonBeginning",
+	"actionButtonReturn",
+	"actionButtonDocument",
+	"actionButtonSound",
+	"actionButtonMovie",
+	"gear6",
+	"gear9",
+	"funnel",
+	"mathPlus",
+	"mathMinus",
+	"mathMultiply",
+	"mathDivide",
+	"mathEqual",
+	"mathNotEqual",
+	"cornerTabs",
+	"squareTabs",
+	"plaqueTabs",
+	"chartX",
+	"chartStar",
+	"chartPlus"
+];
+const LINE_DASHES = [
+	"solid",
+	"dot",
+	"dash",
+	"lgDash",
+	"dashDot",
+	"lgDashDot",
+	"lgDashDotDot",
+	"sysDash",
+	"sysDot",
+	"sysDashDot",
+	"sysDashDotDot"
+];
+const TEXT_DIRECTIONS = [
+	"horz",
+	"vert",
+	"vert270",
+	"wordArtVert",
+	"eaVert",
+	"mongolianVert",
+	"wordArtVertRtl"
+];
+const AUTO_NUMBER_SCHEMES = [
+	"alphaLcParenBoth",
+	"alphaUcParenBoth",
+	"alphaLcParenR",
+	"alphaUcParenR",
+	"alphaLcPeriod",
+	"alphaUcPeriod",
+	"arabicParenBoth",
+	"arabicParenR",
+	"arabicPeriod",
+	"arabicPlain",
+	"romanLcParenBoth",
+	"romanUcParenBoth",
+	"romanLcParenR",
+	"romanUcParenR",
+	"romanLcPeriod",
+	"romanUcPeriod",
+	"circleNumDbPlain",
+	"circleNumWdBlackPlain",
+	"circleNumWdWhitePlain",
+	"arabicDbPeriod",
+	"arabicDbPlain",
+	"ea1ChsPeriod",
+	"ea1ChsPlain",
+	"ea1ChtPeriod",
+	"ea1ChtPlain",
+	"ea1JpnChsDbPeriod",
+	"ea1JpnKorPlain",
+	"ea1JpnKorPeriod",
+	"arabic1Minus",
+	"arabic2Minus",
+	"hebrew2Minus",
+	"thaiAlphaPeriod",
+	"thaiAlphaParenR",
+	"thaiAlphaParenBoth",
+	"thaiNumPeriod",
+	"thaiNumParenR",
+	"thaiNumParenBoth",
+	"hindiAlphaPeriod",
+	"hindiNumPeriod",
+	"hindiNumParenR",
+	"hindiAlpha1Period"
+];
+const UNDERLINES = [
+	"none",
+	"words",
+	"sng",
+	"dbl",
+	"heavy",
+	"dotted",
+	"dottedHeavy",
+	"dash",
+	"dashHeavy",
+	"dashLong",
+	"dashLongHeavy",
+	"dotDash",
+	"dotDashHeavy",
+	"dotDotDash",
+	"dotDotDashHeavy",
+	"wavy",
+	"wavyHeavy",
+	"wavyDbl"
+];
+const STRIKES = [
+	"noStrike",
+	"sngStrike",
+	"dblStrike"
+];
+const SLIDE_SIZE_TYPES = [
+	"screen4x3",
+	"letter",
+	"A4",
+	"35mm",
+	"overhead",
+	"banner",
+	"custom",
+	"ledger",
+	"A3",
+	"B4ISO",
+	"B5ISO",
+	"B4JIS",
+	"B5JIS",
+	"hagakiCard",
+	"screen16x9",
+	"screen16x10"
+];
+const TEXT_ANCHORS = {
+	top: "t",
+	center: "ctr",
+	bottom: "b"
+};
+//#endregion
 //#region src/internal/drawingml/color.ts
 const NAME_SRGB_CLR$4 = qname("a", "srgbClr", NS.dml);
 const NAME_SCHEME_CLR$2 = qname("a", "schemeClr", NS.dml);
@@ -1754,8 +2142,21 @@ const setHighlight = (rPr, value) => {
 	if (parsed === null) throw new Error(`unrecognized highlight color: ${value}`);
 	insertChildByRank(rPr, elem(NAME_HIGHLIGHT, { children: [parsed.kind === "srgb" ? elem(NAME_SRGB_CLR$3, { attrs: [attr(ATTR_VAL$8, parsed.hex)] }) : elem(NAME_SCHEME_CLR$1, { attrs: [attr(ATTR_VAL$8, parsed.token)] })] }), rprChildRank);
 };
+const validateFormatEnums = (format, caller) => {
+	if (format.underline != null && typeof format.underline !== "boolean") oneOf(format.underline, UNDERLINES, `${caller}: underline`);
+	if (format.strike != null && typeof format.strike !== "boolean") oneOf(format.strike, STRIKES, `${caller}: strike`);
+	if (format.cap != null) oneOf(format.cap, [
+		"none",
+		"small",
+		"all"
+	], `${caller}: cap`);
+};
 /** Mutates `rPr` in place per `format`. */
-const applyRunFormat = (rPr, format) => {
+const applyRunFormat = (rPr, format, caller = "setShapeRunFormat") => {
+	validateFormatEnums(format, caller);
+	applyValidatedRunFormat(rPr, format);
+};
+const applyValidatedRunFormat = (rPr, format) => {
 	let attrs = rPr.attrs;
 	if (format.size !== void 0) {
 		const sz = fontSizeHundredthPt(format.size * 100, "setShapeRunFormat: size");
@@ -1793,7 +2194,11 @@ const applyRunFormat = (rPr, format) => {
 * supplied format. Existing run-property attributes not addressed by
 * `format` are preserved.
 */
-const applyFormatToAllRuns = (txBody, format) => {
+const applyFormatToAllRuns = (txBody, format, caller = "setShapeTextFormat") => {
+	validateFormatEnums(format, caller);
+	applyValidatedFormatToAllRuns(txBody, format);
+};
+const applyValidatedFormatToAllRuns = (txBody, format) => {
 	for (const p of txBody.children) {
 		if (p.kind !== "element" || p.name.namespaceURI !== NS.dml || p.name.localName !== "p") continue;
 		for (const r of p.children) {
@@ -1803,7 +2208,7 @@ const applyFormatToAllRuns = (txBody, format) => {
 				rPr = elem(NAME_RPR$6);
 				r.children.unshift(rPr);
 			}
-			applyRunFormat(rPr, format);
+			applyValidatedRunFormat(rPr, format);
 		}
 	}
 };
@@ -1942,7 +2347,12 @@ const replaceTextInTree = (root, from, to) => {
 	});
 	return count;
 };
-const normalizeBulletStyle = (s) => {
+const normalizeBulletStyle = (s, caller) => {
+	if (typeof s === "string") oneOf(s, [
+		"bullet",
+		"number",
+		"none"
+	], `${caller}: bullets`);
 	if (s === "bullet") return {
 		kind: "char",
 		char: "•"
@@ -1958,11 +2368,10 @@ const normalizeBulletStyle = (s) => {
 	};
 	return {
 		kind: "autoNum",
-		type: s.autoNum
+		type: oneOf(s.autoNum, AUTO_NUMBER_SCHEMES, `${caller}: bullets.autoNum`)
 	};
 };
-const buildBulletElement = (style) => {
-	const n = normalizeBulletStyle(style);
+const buildBulletElement = (n) => {
 	switch (n.kind) {
 		case "char": return elem(NAME_BU_CHAR, { attrs: [attr(ATTR_CHAR, n.char)] });
 		case "autoNum": return elem(NAME_BU_AUTO_NUM, { attrs: [attr(ATTR_START_AT, "1"), attr(ATTR_BU_TYPE, n.type)] });
@@ -1971,7 +2380,21 @@ const buildBulletElement = (style) => {
 };
 const NAME_PPR_FOR_BULLET = qname("a", "pPr", NS.dml);
 const NAME_P_FOR_BULLET = qname("a", "p", NS.dml);
-const alignToken = (a) => {
+const alignToken = (a, caller) => {
+	oneOf(a, [
+		"left",
+		"center",
+		"right",
+		"justify",
+		"distribute",
+		"l",
+		"ctr",
+		"r",
+		"just",
+		"dist",
+		"justLow",
+		"thaiDist"
+	], `${caller}: align`);
 	switch (a) {
 		case "left":
 		case "l": return "l";
@@ -1991,8 +2414,10 @@ const ATTR_ALGN$1 = qname("", "algn", "");
 * Sets `<a:pPr algn="...">` on every paragraph in `txBody`. Existing
 * pPr attributes other than `algn` are preserved.
 */
-const applyAlignmentToAllParagraphs = (txBody, align) => {
-	const token = alignToken(align);
+const applyAlignmentToAllParagraphs = (txBody, align, caller = "setShapeAlignment") => {
+	applyAlignmentTokenToAllParagraphs(txBody, alignToken(align, caller));
+};
+const applyAlignmentTokenToAllParagraphs = (txBody, token) => {
 	for (const p of txBody.children) {
 		if (p.kind !== "element" || p.name.namespaceURI !== NAME_P_FOR_BULLET.namespaceURI || p.name.localName !== "p") continue;
 		let pPr = firstChildElement(p, NAME_PPR_FOR_BULLET);
@@ -2034,32 +2459,39 @@ const BULLET_INDENT_BY_LEVEL = [
 const bulletIndentForLevel = (lvl) => BULLET_INDENT_BY_LEVEL[Math.min(lvl, BULLET_INDENT_BY_LEVEL.length - 1)];
 const ATTR_MAR_L$1 = qname("", "marL", "");
 const ATTR_INDENT$1 = qname("", "indent", "");
+const updateBulletIndentForLevel = (pPr, previousLevel, level) => {
+	const previous = bulletIndentForLevel(previousLevel);
+	const marL = pPr.attrs.find((a) => a.name.namespaceURI === "" && a.name.localName === "marL");
+	const indent = pPr.attrs.find((a) => a.name.namespaceURI === "" && a.name.localName === "indent");
+	if (marL?.value !== String(previous.marL) || indent?.value !== String(previous.indent)) return;
+	const next = bulletIndentForLevel(level);
+	pPr.attrs = pPr.attrs.map((a) => a === marL ? attr(a.name, String(next.marL)) : a === indent ? attr(a.name, String(next.indent)) : a);
+};
 const hasAttr = (el, local) => el.attrs.some((a) => a.name.namespaceURI === "" && a.name.localName === local);
-const applyBulletToParagraph = (paragraph, style) => {
+const applyNormalizedBullet = (paragraph, style) => {
 	let pPr = firstChildElement(paragraph, NAME_PPR_FOR_BULLET);
 	if (pPr === null) {
 		pPr = elem(NAME_PPR_FOR_BULLET);
 		paragraph.children.unshift(pPr);
 	}
 	pPr.children = pPr.children.filter((c) => !(c.kind === "element" && c.name.namespaceURI === NS.dml && (c.name.localName === "buChar" || c.name.localName === "buAutoNum" || c.name.localName === "buNone" || c.name.localName === "buFont")));
-	if (style !== "none") {
+	if (style.kind !== "none") {
 		const lvl = Number.parseInt(pPr.attrs.find((a) => a.name.localName === "lvl")?.value ?? "0", 10);
 		const { marL, indent } = bulletIndentForLevel(Number.isFinite(lvl) ? lvl : 0);
 		if (!hasAttr(pPr, "marL")) pPr.attrs.push(attr(ATTR_MAR_L$1, String(marL)));
 		if (!hasAttr(pPr, "indent")) pPr.attrs.push(attr(ATTR_INDENT$1, String(indent)));
 	}
-	if (normalizeBulletStyle(style).kind === "autoNum") pPr.children.push(elem(NAME_BU_FONT, { attrs: [attr(ATTR_TYPEFACE$2, "+mj-lt")] }));
+	if (style.kind === "autoNum") pPr.children.push(elem(NAME_BU_FONT, { attrs: [attr(ATTR_TYPEFACE$2, "+mj-lt")] }));
 	pPr.children.push(buildBulletElement(style));
 };
-/**
-* Sets the bullet style on every paragraph in `txBody`. Drops any
-* existing bullet child element (`a:buChar`, `a:buAutoNum`, `a:buNone`)
-* before inserting the new one. Creates `<a:pPr>` if absent.
-*/
+const applyBulletToParagraph = (paragraph, style) => {
+	applyNormalizedBullet(paragraph, normalizeBulletStyle(style, "setParagraphBullet"));
+};
 const applyBulletToAllParagraphs = (txBody, style) => {
+	const normalized = normalizeBulletStyle(style, "setShapeBullets");
 	for (const p of txBody.children) {
 		if (p.kind !== "element" || p.name.namespaceURI !== NAME_P_FOR_BULLET.namespaceURI || p.name.localName !== "p") continue;
-		applyBulletToParagraph(p, style);
+		applyNormalizedBullet(p, normalized);
 	}
 };
 /**
@@ -2075,7 +2507,8 @@ const applyBulletToAllParagraphs = (txBody, style) => {
 *
 * The `bodyPr` and `lstStyle` children (if any) are preserved untouched.
 */
-const setTextBody = (txBody, value) => {
+const setTextBody = (txBody, value, bullets) => {
+	const normalized = bullets === void 0 ? void 0 : normalizeBulletStyle(bullets, "setShapeText");
 	const rPrTemplate = findFirstRunProperties(txBody);
 	const pPrTemplate = findFirstParagraphProperties(txBody);
 	removeAllParagraphs(txBody);
@@ -2084,6 +2517,7 @@ const setTextBody = (txBody, value) => {
 		const t = elem(NAME_T$5, { children: line.length > 0 ? [text(line)] : [] });
 		const r = elem(NAME_R$4, { children: rPrTemplate !== null ? [cloneElement(rPrTemplate), t] : [t] });
 		const p = elem(NAME_P$5, { children: pPrTemplate !== null ? [cloneElement(pPrTemplate), r] : [r] });
+		if (normalized !== void 0) applyNormalizedBullet(p, normalized);
 		txBody.children.push(p);
 	}
 };
@@ -2092,21 +2526,21 @@ const setTextBody = (txBody, value) => {
 * here, so a caller that builds before it touches the tree leaves the
 * existing text intact when a value is rejected.
 */
-const buildTextBodyParagraphs = (paragraphs) => {
+const buildTextBodyParagraphs = (paragraphs, caller = "setShapeParagraphs") => {
 	if (paragraphs.length === 0) throw new Error("setTextBodyParagraphs: at least one paragraph is required");
 	const built = [];
 	for (const para of paragraphs) {
 		const children = [];
-		if (para.align !== void 0) children.push(elem(NAME_PPR$1, { attrs: [attr(ATTR_ALGN$1, alignToken(para.align))] }));
+		if (para.align !== void 0) children.push(elem(NAME_PPR$1, { attrs: [attr(ATTR_ALGN$1, alignToken(para.align, caller))] }));
 		for (const run of para.runs) {
 			const rPr = elem(NAME_RPR$5);
-			if (run.format !== void 0) applyRunFormat(rPr, run.format);
+			if (run.format !== void 0) applyRunFormat(rPr, run.format, caller);
 			const t = elem(NAME_T$5, { children: run.text.length > 0 ? [text(run.text)] : [] });
 			children.push(elem(NAME_R$4, { children: [rPr, t] }));
 		}
 		if (para.endFormat !== void 0) {
 			const endParaRPr = elem(NAME_END_PARA_RPR);
-			applyRunFormat(endParaRPr, para.endFormat);
+			applyRunFormat(endParaRPr, para.endFormat, caller);
 			children.push(endParaRPr);
 		}
 		built.push(elem(NAME_P$5, { children }));
@@ -2266,6 +2700,12 @@ const setPatternFill = (host, options) => {
 };
 /** Sets `<a:gradFill>` on `host`, replacing any previous fill choice. */
 const setGradientFill = (host, options) => {
+	if (options.path !== void 0) oneOf(options.path, [
+		"linear",
+		"circle",
+		"rect",
+		"shape"
+	], "setShapeGradientFill: path");
 	if (options.stops.length < 2) throw new Error("gradient fill requires at least two stops");
 	removeAnyFill(host);
 	const stops = options.stops.map((s) => {
@@ -2450,6 +2890,7 @@ const ATTR_VAL$6 = qname("", "val", "");
 * `<a:ln>` if absent. Replacing the dash choice on subsequent calls.
 */
 const setStrokeDash = (spPr, dash) => {
+	oneOf(dash, LINE_DASHES, "setShapeStrokeDash: dash");
 	const ln = ensureLn(spPr);
 	ln.children = ln.children.filter((c) => !(c.kind === "element" && c.name.namespaceURI === NS.dml && c.name.localName === "prstDash"));
 	insertLnChild(ln, elem(NAME_PRST_DASH, { attrs: [attr(ATTR_VAL$6, dash)] }));
@@ -2467,8 +2908,30 @@ const ATTR_LEN = qname("", "len", "");
 * behavior).
 */
 const setStrokeArrow = (spPr, end, options) => {
+	oneOf(end, ["head", "tail"], "setShapeStrokeArrow: end");
+	oneOf(options.type, [
+		"none",
+		"triangle",
+		"stealth",
+		"diamond",
+		"oval",
+		"arrow"
+	], "setShapeStrokeArrow: type");
+	if (options.width !== void 0) oneOf(options.width, [
+		"sm",
+		"med",
+		"lg"
+	], "setShapeStrokeArrow: width");
+	if (options.length !== void 0) oneOf(options.length, [
+		"sm",
+		"med",
+		"lg"
+	], "setShapeStrokeArrow: length");
 	const ln = ensureLn(spPr);
-	const localName = end === "head" ? "headEnd" : "tailEnd";
+	const localName = {
+		head: "headEnd",
+		tail: "tailEnd"
+	}[end];
 	ln.children = ln.children.filter((c) => !(c.kind === "element" && c.name.namespaceURI === NS.dml && c.name.localName === localName));
 	const attrs = [attr(ATTR_TYPE$5, options.type)];
 	if (options.width !== void 0) attrs.push(attr(ATTR_W$3, options.width));
@@ -2477,6 +2940,11 @@ const setStrokeArrow = (spPr, end, options) => {
 };
 /** Sets `<a:ln cap="…"/>`. Pass `null` to clear the attribute. */
 const setStrokeCap = (spPr, cap) => {
+	if (cap !== null) oneOf(cap, [
+		"rnd",
+		"sq",
+		"flat"
+	], "setShapeStrokeCap: cap");
 	const ln = ensureLn(spPr);
 	ln.attrs = ln.attrs.filter((a) => !(a.name.namespaceURI === "" && a.name.localName === "cap"));
 	if (cap !== null) ln.attrs.push(attr(qname("", "cap", ""), cap));
@@ -2488,12 +2956,24 @@ const JOIN_LOCALS = new Set([
 ]);
 /** Replaces the join child of `<a:ln>`. Pass `null` to remove it. */
 const setStrokeJoin = (spPr, join) => {
+	if (join !== null) oneOf(join, [
+		"round",
+		"bevel",
+		"miter"
+	], "setShapeStrokeJoin: join");
 	const ln = ensureLn(spPr);
 	removeChildrenIn(ln, JOIN_LOCALS);
 	if (join !== null) insertLnChild(ln, elem(qname("a", join, NS.dml)));
 };
 /** Sets `<a:ln cmpd="…"/>`. Pass `null` to clear the attribute. */
 const setStrokeCompound = (spPr, cmpd) => {
+	if (cmpd !== null) oneOf(cmpd, [
+		"sng",
+		"dbl",
+		"thickThin",
+		"thinThick",
+		"tri"
+	], "setShapeStrokeCompound: cmpd");
 	const ln = ensureLn(spPr);
 	ln.attrs = ln.attrs.filter((a) => !(a.name.namespaceURI === "" && a.name.localName === "cmpd"));
 	if (cmpd !== null) ln.attrs.push(attr(qname("", "cmpd", ""), cmpd));
@@ -2518,7 +2998,7 @@ const ATTR_WR = qname("", "wR", "");
 const ATTR_HR = qname("", "hR", "");
 const ATTR_ST_ANG = qname("", "stAng", "");
 const ATTR_SW_ANG = qname("", "swAng", "");
-const ATTR_FILL$1 = qname("", "fill", "");
+const ATTR_FILL$2 = qname("", "fill", "");
 const ATTR_STROKE = qname("", "stroke", "");
 const NAME_AV_LST$5 = qname("a", "avLst", NS.dml);
 const NAME_GD_LST = qname("a", "gdLst", NS.dml);
@@ -2667,7 +3147,7 @@ const isPathFillMode = (s) => FILL_MODES.has(s);
 const parsePath = (pathEl, guides) => {
 	const w = parseIntOrNull(getAttrValue(pathEl, ATTR_W$2));
 	const h = parseIntOrNull(getAttrValue(pathEl, ATTR_H$1));
-	const fillRaw = getAttrValue(pathEl, ATTR_FILL$1);
+	const fillRaw = getAttrValue(pathEl, ATTR_FILL$2);
 	const fill = fillRaw !== null && isPathFillMode(fillRaw) ? fillRaw : "norm";
 	const strokeRaw = getAttrValue(pathEl, ATTR_STROKE);
 	const stroke = !(strokeRaw === "0" || strokeRaw === "false");
@@ -2760,8 +3240,8 @@ const parseCustomGeometry = (custGeom, shapeW, shapeH) => {
 //#region src/internal/drawingml/hyperlink.ts
 NS.dml;
 const NAME_RPR$4 = qname("a", "rPr", NS.dml);
-const NAME_HLINK_CLICK = qname("a", "hlinkClick", NS.dml);
-const ATTR_R_ID$2 = qname("r", "id", NS.officeDocRels);
+const NAME_HLINK_CLICK$1 = qname("a", "hlinkClick", NS.dml);
+const ATTR_R_ID$3 = qname("r", "id", NS.officeDocRels);
 /**
 * Sets `<a:hlinkClick r:id="rIdN" [tooltip="…"]/>` inside the `<a:rPr>`
 * of every run in `txBody`. Pass `null` for `rId` to remove an existing
@@ -2781,9 +3261,9 @@ const applyHyperlinkToAllRuns = (txBody, rId, tooltip) => {
 			}
 			rPr.children = rPr.children.filter((c) => !(c.kind === "element" && c.name.namespaceURI === NS.dml && c.name.localName === "hlinkClick"));
 			if (rId !== null) {
-				const attrs = [attr(ATTR_R_ID$2, rId)];
+				const attrs = [attr(ATTR_R_ID$3, rId)];
 				if (tooltip !== void 0) attrs.push(attr(qname("", "tooltip", ""), tooltip));
-				rPr.children.push(elem(NAME_HLINK_CLICK, { attrs }));
+				rPr.children.push(elem(NAME_HLINK_CLICK$1, { attrs }));
 			}
 		}
 	}
@@ -2792,7 +3272,7 @@ const applyHyperlinkToAllRuns = (txBody, rId, tooltip) => {
 //#region src/internal/drawingml/picture-mutation.ts
 const NAME_BLIP_FILL$1 = qname("p", "blipFill", NS.pml);
 const NAME_BLIP$1 = qname("a", "blip", NS.dml);
-const ATTR_R_EMBED$1 = qname("r", "embed", NS.officeDocRels);
+const ATTR_R_EMBED$2 = qname("r", "embed", NS.officeDocRels);
 /**
 * Returns the `r:embed` rId on this picture shape's `a:blip`. Returns null
 * if the shape has no blip fill, no blip, or no embed attribute (which
@@ -2803,7 +3283,7 @@ const getPictureEmbedRId = (picElement) => {
 	if (blipFill === null) return null;
 	const blip = firstChildElement(blipFill, NAME_BLIP$1);
 	if (blip === null) return null;
-	return getAttrValue(blip, ATTR_R_EMBED$1);
+	return getAttrValue(blip, ATTR_R_EMBED$2);
 };
 //#endregion
 //#region src/internal/drawingml/geometry.ts
@@ -2812,7 +3292,7 @@ const NAME_GRP_SP_PR$4 = qname("p", "grpSpPr", NS.pml);
 const NAME_A_XFRM$6 = qname("a", "xfrm", NS.dml);
 const NAME_P_XFRM$2 = qname("p", "xfrm", NS.pml);
 const NAME_OFF$8 = qname("a", "off", NS.dml);
-const NAME_EXT$8 = qname("a", "ext", NS.dml);
+const NAME_EXT$9 = qname("a", "ext", NS.dml);
 const ATTR_X$8 = qname("", "x", "");
 const ATTR_Y$8 = qname("", "y", "");
 const ATTR_CX$8 = qname("", "cx", "");
@@ -2853,7 +3333,7 @@ const readPosition = (shape, kind) => {
 const readSize = (shape, kind) => {
 	const xfrm = findTransform(shape, kind);
 	if (xfrm === null) return null;
-	const ext = firstChildElement(xfrm, NAME_EXT$8);
+	const ext = firstChildElement(xfrm, NAME_EXT$9);
 	if (ext === null) return null;
 	const w = parseIntOr(getAttrValue(ext, ATTR_CX$8));
 	const h = parseIntOr(getAttrValue(ext, ATTR_CY$8));
@@ -2893,7 +3373,7 @@ const NAME_GRP_SP_PR$3 = qname("p", "grpSpPr", NS.pml);
 const NAME_A_XFRM$5 = qname("a", "xfrm", NS.dml);
 const NAME_P_XFRM$1 = qname("p", "xfrm", NS.pml);
 const NAME_OFF$7 = qname("a", "off", NS.dml);
-const NAME_EXT$7 = qname("a", "ext", NS.dml);
+const NAME_EXT$8 = qname("a", "ext", NS.dml);
 const ATTR_X$7 = qname("", "x", "");
 const ATTR_Y$7 = qname("", "y", "");
 const ATTR_CX$7 = qname("", "cx", "");
@@ -2939,9 +3419,9 @@ const setPosition = (shape, kind, x, y) => {
 /** Sets the shape's `<a:ext>` to `(w, h)` in EMU. */
 const setSize = (shape, kind, w, h) => {
 	const xfrm = ensureTransform(shape, kind);
-	let ext = firstChildElement(xfrm, NAME_EXT$7);
+	let ext = firstChildElement(xfrm, NAME_EXT$8);
 	if (ext === null) {
-		ext = elem(NAME_EXT$7);
+		ext = elem(NAME_EXT$8);
 		const offIdx = xfrm.children.findIndex((c) => c.kind === "element" && c.name.localName === "off" && c.name.namespaceURI === NS.dml);
 		if (offIdx >= 0) xfrm.children.splice(offIdx + 1, 0, ext);
 		else xfrm.children.push(ext);
@@ -3013,21 +3493,21 @@ const setAdjustValues = (shape, values) => {
 const NAME_CSLD$4 = qname("p", "cSld", NS.pml);
 const NAME_SP_TREE$3 = qname("p", "spTree", NS.pml);
 const NAME_NV_SP_PR$4 = qname("p", "nvSpPr", NS.pml);
-const NAME_NV_PIC_PR$1 = qname("p", "nvPicPr", NS.pml);
+const NAME_NV_PIC_PR$2 = qname("p", "nvPicPr", NS.pml);
 const NAME_NV_GRP_SP_PR$3 = qname("p", "nvGrpSpPr", NS.pml);
 const NAME_NV_GRAPHIC_FRAME_PR$2 = qname("p", "nvGraphicFramePr", NS.pml);
 const NAME_NV_CXN_SP_PR$1 = qname("p", "nvCxnSpPr", NS.pml);
-const NAME_C_NV_PR$8 = qname("p", "cNvPr", NS.pml);
-const NAME_NV_PR$9 = qname("p", "nvPr", NS.pml);
+const NAME_C_NV_PR$9 = qname("p", "cNvPr", NS.pml);
+const NAME_NV_PR$10 = qname("p", "nvPr", NS.pml);
 const NAME_PH$2 = qname("p", "ph", NS.pml);
 const NAME_TX_BODY$9 = qname("p", "txBody", NS.pml);
-const ATTR_ID$12 = qname("", "id", "");
+const ATTR_ID$14 = qname("", "id", "");
 const ATTR_NAME$11 = qname("", "name", "");
 const ATTR_TYPE$4 = qname("", "type", "");
 const ATTR_IDX$6 = qname("", "idx", "");
 const NV_BY_KIND = {
 	shape: NAME_NV_SP_PR$4,
-	picture: NAME_NV_PIC_PR$1,
+	picture: NAME_NV_PIC_PR$2,
 	group: NAME_NV_GRP_SP_PR$3,
 	graphicFrame: NAME_NV_GRAPHIC_FRAME_PR$2,
 	connector: NAME_NV_CXN_SP_PR$1
@@ -3050,14 +3530,14 @@ const extractShape = (element, kind) => {
 	let placeholderType = null;
 	let placeholderIdx = null;
 	if (nvContainer !== null) {
-		const cNvPr = firstChildElement(nvContainer, NAME_C_NV_PR$8);
+		const cNvPr = firstChildElement(nvContainer, NAME_C_NV_PR$9);
 		if (cNvPr !== null) {
-			const idRaw = getAttrValue(cNvPr, ATTR_ID$12);
+			const idRaw = getAttrValue(cNvPr, ATTR_ID$14);
 			if (idRaw !== null) id = Number.parseInt(idRaw, 10);
 			const nameRaw = getAttrValue(cNvPr, ATTR_NAME$11);
 			if (nameRaw !== null) name = nameRaw;
 		}
-		const nvPr = firstChildElement(nvContainer, NAME_NV_PR$9);
+		const nvPr = firstChildElement(nvContainer, NAME_NV_PR$10);
 		if (nvPr !== null) {
 			const ph = firstChildElement(nvPr, NAME_PH$2);
 			if (ph !== null) {
@@ -3165,9 +3645,9 @@ const NAME_SLD = qname("p", "sld", NS.pml);
 const NAME_CSLD$2 = qname("p", "cSld", NS.pml);
 const NAME_SP_TREE$2 = qname("p", "spTree", NS.pml);
 const NAME_NV_GRP_SP_PR$2 = qname("p", "nvGrpSpPr", NS.pml);
-const NAME_C_NV_PR$7 = qname("p", "cNvPr", NS.pml);
+const NAME_C_NV_PR$8 = qname("p", "cNvPr", NS.pml);
 const NAME_C_NV_GRP_SP_PR$2 = qname("p", "cNvGrpSpPr", NS.pml);
-const NAME_NV_PR$8 = qname("p", "nvPr", NS.pml);
+const NAME_NV_PR$9 = qname("p", "nvPr", NS.pml);
 const NAME_GRP_SP_PR$2 = qname("p", "grpSpPr", NS.pml);
 const NAME_SP$3 = qname("p", "sp", NS.pml);
 const NAME_NV_SP_PR$3 = qname("p", "nvSpPr", NS.pml);
@@ -3179,7 +3659,7 @@ const NAME_BODY_PR$4 = qname("a", "bodyPr", NS.dml);
 const NAME_LST_STYLE$4 = qname("a", "lstStyle", NS.dml);
 const NAME_P$4 = qname("a", "p", NS.dml);
 const NAME_SP_LOCKS$1 = qname("a", "spLocks", NS.dml);
-const ATTR_ID$11 = qname("", "id", "");
+const ATTR_ID$13 = qname("", "id", "");
 const ATTR_NAME$9 = qname("", "name", "");
 const ATTR_TYPE$2 = qname("", "type", "");
 const ATTR_IDX$5 = qname("", "idx", "");
@@ -3200,7 +3680,7 @@ const buildSlideFromLayout = (layoutSpTree) => {
 		if (child.name.namespaceURI !== NS.pml || child.name.localName !== "sp") continue;
 		const nvSpPr = firstChildElement(child, NAME_NV_SP_PR$3);
 		if (nvSpPr === null) continue;
-		const nvPr = firstChildElement(nvSpPr, NAME_NV_PR$8);
+		const nvPr = firstChildElement(nvSpPr, NAME_NV_PR$9);
 		if (nvPr === null) continue;
 		const ph = firstChildElement(nvPr, NAME_PH$1);
 		if (ph === null) continue;
@@ -3240,21 +3720,21 @@ const buildSlideFromLayout = (layoutSpTree) => {
 	};
 };
 const buildNvGrpSpPr = (id) => elem(NAME_NV_GRP_SP_PR$2, { children: [
-	elem(NAME_C_NV_PR$7, { attrs: [attr(ATTR_ID$11, String(id)), attr(ATTR_NAME$9, "")] }),
+	elem(NAME_C_NV_PR$8, { attrs: [attr(ATTR_ID$13, String(id)), attr(ATTR_NAME$9, "")] }),
 	elem(NAME_C_NV_GRP_SP_PR$2),
-	elem(NAME_NV_PR$8)
+	elem(NAME_NV_PR$9)
 ] });
 const buildGrpSpPr = () => elem(NAME_GRP_SP_PR$2);
 const buildPlaceholderStub = (id, phType, phIdx) => {
 	const phAttrs = [];
 	if (phType !== null) phAttrs.push(attr(ATTR_TYPE$2, phType));
 	if (phIdx !== null) phAttrs.push(attr(ATTR_IDX$5, phIdx));
-	const nvPr = elem(NAME_NV_PR$8, { children: [elem(NAME_PH$1, { attrs: phAttrs })] });
+	const nvPr = elem(NAME_NV_PR$9, { children: [elem(NAME_PH$1, { attrs: phAttrs })] });
 	const cNvSpPr = elem(NAME_C_NV_SP_PR$3, { children: [elem(NAME_SP_LOCKS$1, { attrs: [attr(ATTR_NO_GRP$2, "1")] })] });
 	const name = inferPlaceholderName(id, phType);
 	return elem(NAME_SP$3, { children: [
 		elem(NAME_NV_SP_PR$3, { children: [
-			elem(NAME_C_NV_PR$7, { attrs: [attr(ATTR_ID$11, String(id)), attr(ATTR_NAME$9, name)] }),
+			elem(NAME_C_NV_PR$8, { attrs: [attr(ATTR_ID$13, String(id)), attr(ATTR_NAME$9, name)] }),
 			cNvSpPr,
 			nvPr
 		] }),
@@ -3290,14 +3770,14 @@ const inferPlaceholderName = (id, phType) => {
 //#region src/internal/presentationml/text-box-builder.ts
 const NAME_SP$2 = qname("p", "sp", NS.pml);
 const NAME_NV_SP_PR$2 = qname("p", "nvSpPr", NS.pml);
-const NAME_C_NV_PR$6 = qname("p", "cNvPr", NS.pml);
+const NAME_C_NV_PR$7 = qname("p", "cNvPr", NS.pml);
 const NAME_C_NV_SP_PR$2 = qname("p", "cNvSpPr", NS.pml);
-const NAME_NV_PR$7 = qname("p", "nvPr", NS.pml);
+const NAME_NV_PR$8 = qname("p", "nvPr", NS.pml);
 const NAME_SP_PR$4 = qname("p", "spPr", NS.pml);
 const NAME_TX_BODY$7 = qname("p", "txBody", NS.pml);
 const NAME_A_XFRM$4 = qname("a", "xfrm", NS.dml);
 const NAME_OFF$6 = qname("a", "off", NS.dml);
-const NAME_EXT$6 = qname("a", "ext", NS.dml);
+const NAME_EXT$7 = qname("a", "ext", NS.dml);
 const NAME_PRST_GEOM$3 = qname("a", "prstGeom", NS.dml);
 const NAME_AV_LST$3 = qname("a", "avLst", NS.dml);
 const NAME_NO_FILL = qname("a", "noFill", NS.dml);
@@ -3307,7 +3787,7 @@ const NAME_P$3 = qname("a", "p", NS.dml);
 const NAME_R$3 = qname("a", "r", NS.dml);
 const NAME_RPR$3 = qname("a", "rPr", NS.dml);
 const NAME_T$4 = qname("a", "t", NS.dml);
-const ATTR_ID$10 = qname("", "id", "");
+const ATTR_ID$12 = qname("", "id", "");
 const ATTR_NAME$8 = qname("", "name", "");
 const ATTR_TX_BOX$1 = qname("", "txBox", "");
 const ATTR_X$6 = qname("", "x", "");
@@ -3328,12 +3808,12 @@ NS.xml;
 const buildTextBox = (opts) => {
 	const name = opts.name ?? `TextBox ${opts.id}`;
 	const nvSpPr = elem(NAME_NV_SP_PR$2, { children: [
-		elem(NAME_C_NV_PR$6, { attrs: [attr(ATTR_ID$10, String(opts.id)), attr(ATTR_NAME$8, name)] }),
+		elem(NAME_C_NV_PR$7, { attrs: [attr(ATTR_ID$12, String(opts.id)), attr(ATTR_NAME$8, name)] }),
 		elem(NAME_C_NV_SP_PR$2, { attrs: [attr(ATTR_TX_BOX$1, "1")] }),
-		elem(NAME_NV_PR$7)
+		elem(NAME_NV_PR$8)
 	] });
 	const spPr = elem(NAME_SP_PR$4, { children: [
-		elem(NAME_A_XFRM$4, { children: [elem(NAME_OFF$6, { attrs: [attr(ATTR_X$6, String(emuCoordinate(opts.x, "addSlideTextBox: x"))), attr(ATTR_Y$6, String(emuCoordinate(opts.y, "addSlideTextBox: y")))] }), elem(NAME_EXT$6, { attrs: [attr(ATTR_CX$6, String(emuExtent(opts.w, "addSlideTextBox: w"))), attr(ATTR_CY$6, String(emuExtent(opts.h, "addSlideTextBox: h")))] })] }),
+		elem(NAME_A_XFRM$4, { children: [elem(NAME_OFF$6, { attrs: [attr(ATTR_X$6, String(emuCoordinate(opts.x, "addSlideTextBox: x"))), attr(ATTR_Y$6, String(emuCoordinate(opts.y, "addSlideTextBox: y")))] }), elem(NAME_EXT$7, { attrs: [attr(ATTR_CX$6, String(emuExtent(opts.w, "addSlideTextBox: w"))), attr(ATTR_CY$6, String(emuExtent(opts.h, "addSlideTextBox: h")))] })] }),
 		elem(NAME_PRST_GEOM$3, {
 			attrs: [attr(ATTR_PRST$3, "rect")],
 			children: [elem(NAME_AV_LST$3)]
@@ -3358,14 +3838,14 @@ const buildTextBox = (opts) => {
 //#region src/internal/presentationml/shape-builder.ts
 const NAME_SP$1 = qname("p", "sp", NS.pml);
 const NAME_NV_SP_PR$1 = qname("p", "nvSpPr", NS.pml);
-const NAME_C_NV_PR$5 = qname("p", "cNvPr", NS.pml);
+const NAME_C_NV_PR$6 = qname("p", "cNvPr", NS.pml);
 const NAME_C_NV_SP_PR$1 = qname("p", "cNvSpPr", NS.pml);
-const NAME_NV_PR$6 = qname("p", "nvPr", NS.pml);
+const NAME_NV_PR$7 = qname("p", "nvPr", NS.pml);
 const NAME_SP_PR$3 = qname("p", "spPr", NS.pml);
 const NAME_TX_BODY$6 = qname("p", "txBody", NS.pml);
 const NAME_A_XFRM$3 = qname("a", "xfrm", NS.dml);
 const NAME_OFF$5 = qname("a", "off", NS.dml);
-const NAME_EXT$5 = qname("a", "ext", NS.dml);
+const NAME_EXT$6 = qname("a", "ext", NS.dml);
 const NAME_PRST_GEOM$2 = qname("a", "prstGeom", NS.dml);
 const NAME_AV_LST$2 = qname("a", "avLst", NS.dml);
 const NAME_BODY_PR$2 = qname("a", "bodyPr", NS.dml);
@@ -3374,7 +3854,7 @@ const NAME_P$2 = qname("a", "p", NS.dml);
 const NAME_R$2 = qname("a", "r", NS.dml);
 const NAME_RPR$2 = qname("a", "rPr", NS.dml);
 const NAME_T$3 = qname("a", "t", NS.dml);
-const ATTR_ID$9 = qname("", "id", "");
+const ATTR_ID$11 = qname("", "id", "");
 const ATTR_NAME$7 = qname("", "name", "");
 const ATTR_X$5 = qname("", "x", "");
 const ATTR_Y$5 = qname("", "y", "");
@@ -3403,13 +3883,19 @@ const buildTextBody = (text$1, anchor) => {
 	] });
 };
 const buildShape = (opts) => {
+	oneOf(opts.preset, SHAPE_PRESETS, "addSlideShape: preset");
+	if (opts.textAnchor !== void 0) oneOf(opts.textAnchor, [
+		"t",
+		"ctr",
+		"b"
+	], "addSlideShape: textAnchor");
 	const name = opts.name ?? `${opts.preset} ${opts.id}`;
 	const anchor = opts.textAnchor ?? "ctr";
 	const children = [elem(NAME_NV_SP_PR$1, { children: [
-		elem(NAME_C_NV_PR$5, { attrs: [attr(ATTR_ID$9, String(opts.id)), attr(ATTR_NAME$7, name)] }),
+		elem(NAME_C_NV_PR$6, { attrs: [attr(ATTR_ID$11, String(opts.id)), attr(ATTR_NAME$7, name)] }),
 		elem(NAME_C_NV_SP_PR$1),
-		elem(NAME_NV_PR$6)
-	] }), elem(NAME_SP_PR$3, { children: [elem(NAME_A_XFRM$3, { children: [elem(NAME_OFF$5, { attrs: [attr(ATTR_X$5, String(emuCoordinate(opts.x, "addSlideShape: x"))), attr(ATTR_Y$5, String(emuCoordinate(opts.y, "addSlideShape: y")))] }), elem(NAME_EXT$5, { attrs: [attr(ATTR_CX$5, String(emuExtent(opts.w, "addSlideShape: w"))), attr(ATTR_CY$5, String(emuExtent(opts.h, "addSlideShape: h")))] })] }), elem(NAME_PRST_GEOM$2, {
+		elem(NAME_NV_PR$7)
+	] }), elem(NAME_SP_PR$3, { children: [elem(NAME_A_XFRM$3, { children: [elem(NAME_OFF$5, { attrs: [attr(ATTR_X$5, String(emuCoordinate(opts.x, "addSlideShape: x"))), attr(ATTR_Y$5, String(emuCoordinate(opts.y, "addSlideShape: y")))] }), elem(NAME_EXT$6, { attrs: [attr(ATTR_CX$5, String(emuExtent(opts.w, "addSlideShape: w"))), attr(ATTR_CY$5, String(emuExtent(opts.h, "addSlideShape: h")))] })] }), elem(NAME_PRST_GEOM$2, {
 		attrs: [attr(ATTR_PRST$2, opts.preset)],
 		children: [elem(NAME_AV_LST$2)]
 	})] })];
@@ -3421,13 +3907,13 @@ const buildShape = (opts) => {
 //#region src/internal/presentationml/connector-builder.ts
 const NAME_CXN_SP = qname("p", "cxnSp", NS.pml);
 const NAME_NV_CXN_SP_PR = qname("p", "nvCxnSpPr", NS.pml);
-const NAME_C_NV_PR$4 = qname("p", "cNvPr", NS.pml);
+const NAME_C_NV_PR$5 = qname("p", "cNvPr", NS.pml);
 const NAME_C_NV_CXN_SP_PR = qname("p", "cNvCxnSpPr", NS.pml);
-const NAME_NV_PR$5 = qname("p", "nvPr", NS.pml);
+const NAME_NV_PR$6 = qname("p", "nvPr", NS.pml);
 const NAME_SP_PR$2 = qname("p", "spPr", NS.pml);
 const NAME_A_XFRM$2 = qname("a", "xfrm", NS.dml);
 const NAME_OFF$4 = qname("a", "off", NS.dml);
-const NAME_EXT$4 = qname("a", "ext", NS.dml);
+const NAME_EXT$5 = qname("a", "ext", NS.dml);
 const NAME_PRST_GEOM$1 = qname("a", "prstGeom", NS.dml);
 const NAME_AV_LST$1 = qname("a", "avLst", NS.dml);
 const NAME_LN = qname("a", "ln", NS.dml);
@@ -3440,7 +3926,7 @@ const NAME_FONT_REF = qname("a", "fontRef", NS.dml);
 const NAME_SCHEME_CLR = qname("a", "schemeClr", NS.dml);
 const ATTR_IDX$4 = qname("", "idx", "");
 const ATTR_VAL$5 = qname("", "val", "");
-const ATTR_ID$8 = qname("", "id", "");
+const ATTR_ID$10 = qname("", "id", "");
 const ATTR_NAME$6 = qname("", "name", "");
 const ATTR_X$4 = qname("", "x", "");
 const ATTR_Y$4 = qname("", "y", "");
@@ -3454,9 +3940,9 @@ const ATTR_FLIP_V = qname("", "flipV", "");
 const buildConnector = (opts) => {
 	const name = opts.name ?? `Straight Connector ${opts.id}`;
 	const nvCxnSpPr = elem(NAME_NV_CXN_SP_PR, { children: [
-		elem(NAME_C_NV_PR$4, { attrs: [attr(ATTR_ID$8, String(opts.id)), attr(ATTR_NAME$6, name)] }),
+		elem(NAME_C_NV_PR$5, { attrs: [attr(ATTR_ID$10, String(opts.id)), attr(ATTR_NAME$6, name)] }),
 		elem(NAME_C_NV_CXN_SP_PR),
-		elem(NAME_NV_PR$5)
+		elem(NAME_NV_PR$6)
 	] });
 	const x = Math.min(opts.from.x, opts.to.x);
 	const y = Math.min(opts.from.y, opts.to.y);
@@ -3469,7 +3955,7 @@ const buildConnector = (opts) => {
 	if (flipV) xfrmAttrs.push(attr(ATTR_FLIP_V, "1"));
 	const xfrm = elem(NAME_A_XFRM$2, {
 		attrs: xfrmAttrs,
-		children: [elem(NAME_OFF$4, { attrs: [attr(ATTR_X$4, String(emuCoordinate(x, "addSlideLine: x"))), attr(ATTR_Y$4, String(emuCoordinate(y, "addSlideLine: y")))] }), elem(NAME_EXT$4, { attrs: [attr(ATTR_CX$4, String(emuExtent(cx, "addSlideLine: width"))), attr(ATTR_CY$4, String(emuExtent(cy, "addSlideLine: height")))] })]
+		children: [elem(NAME_OFF$4, { attrs: [attr(ATTR_X$4, String(emuCoordinate(x, "addSlideLine: x"))), attr(ATTR_Y$4, String(emuCoordinate(y, "addSlideLine: y")))] }), elem(NAME_EXT$5, { attrs: [attr(ATTR_CX$4, String(emuExtent(cx, "addSlideLine: width"))), attr(ATTR_CY$4, String(emuExtent(cy, "addSlideLine: height")))] })]
 	});
 	const prstGeom = elem(NAME_PRST_GEOM$1, {
 		attrs: [attr(ATTR_PRST$1, "line")],
@@ -3503,16 +3989,16 @@ const buildConnector = (opts) => {
 //#region src/internal/presentationml/group-builder.ts
 const NAME_GRP_SP = qname("p", "grpSp", NS.pml);
 const NAME_NV_GRP_SP_PR$1 = qname("p", "nvGrpSpPr", NS.pml);
-const NAME_C_NV_PR$3 = qname("p", "cNvPr", NS.pml);
+const NAME_C_NV_PR$4 = qname("p", "cNvPr", NS.pml);
 const NAME_C_NV_GRP_SP_PR$1 = qname("p", "cNvGrpSpPr", NS.pml);
-const NAME_NV_PR$4 = qname("p", "nvPr", NS.pml);
+const NAME_NV_PR$5 = qname("p", "nvPr", NS.pml);
 const NAME_GRP_SP_PR$1 = qname("p", "grpSpPr", NS.pml);
 const NAME_A_XFRM$1 = qname("a", "xfrm", NS.dml);
 const NAME_OFF$3 = qname("a", "off", NS.dml);
-const NAME_EXT$3 = qname("a", "ext", NS.dml);
+const NAME_EXT$4 = qname("a", "ext", NS.dml);
 const NAME_CH_OFF = qname("a", "chOff", NS.dml);
 const NAME_CH_EXT = qname("a", "chExt", NS.dml);
-const ATTR_ID$7 = qname("", "id", "");
+const ATTR_ID$9 = qname("", "id", "");
 const ATTR_NAME$5 = qname("", "name", "");
 const ATTR_X$3 = qname("", "x", "");
 const ATTR_Y$3 = qname("", "y", "");
@@ -3522,9 +4008,9 @@ const ATTR_CY$3 = qname("", "cy", "");
 const buildGroup = (opts) => {
 	const name = opts.name ?? `Group ${opts.id}`;
 	const nvGrpSpPr = elem(NAME_NV_GRP_SP_PR$1, { children: [
-		elem(NAME_C_NV_PR$3, { attrs: [attr(ATTR_ID$7, String(opts.id)), attr(ATTR_NAME$5, name)] }),
+		elem(NAME_C_NV_PR$4, { attrs: [attr(ATTR_ID$9, String(opts.id)), attr(ATTR_NAME$5, name)] }),
 		elem(NAME_C_NV_GRP_SP_PR$1),
-		elem(NAME_NV_PR$4)
+		elem(NAME_NV_PR$5)
 	] });
 	const x = emuCoordinate(opts.x, "groupShapes: x");
 	const y = emuCoordinate(opts.y, "groupShapes: y");
@@ -3534,7 +4020,7 @@ const buildGroup = (opts) => {
 		nvGrpSpPr,
 		elem(NAME_GRP_SP_PR$1, { children: [elem(NAME_A_XFRM$1, { children: [
 			elem(NAME_OFF$3, { attrs: [attr(ATTR_X$3, String(x)), attr(ATTR_Y$3, String(y))] }),
-			elem(NAME_EXT$3, { attrs: [attr(ATTR_CX$3, String(cx)), attr(ATTR_CY$3, String(cy))] }),
+			elem(NAME_EXT$4, { attrs: [attr(ATTR_CX$3, String(cx)), attr(ATTR_CY$3, String(cy))] }),
 			elem(NAME_CH_OFF, { attrs: [attr(ATTR_X$3, String(x)), attr(ATTR_Y$3, String(y))] }),
 			elem(NAME_CH_EXT, { attrs: [attr(ATTR_CX$3, String(cx)), attr(ATTR_CY$3, String(cy))] })
 		] })] }),
@@ -3544,10 +4030,10 @@ const buildGroup = (opts) => {
 //#endregion
 //#region src/internal/presentationml/picture-builder.ts
 const NAME_PIC = qname("p", "pic", NS.pml);
-const NAME_NV_PIC_PR = qname("p", "nvPicPr", NS.pml);
-const NAME_C_NV_PR$2 = qname("p", "cNvPr", NS.pml);
+const NAME_NV_PIC_PR$1 = qname("p", "nvPicPr", NS.pml);
+const NAME_C_NV_PR$3 = qname("p", "cNvPr", NS.pml);
 const NAME_C_NV_PIC_PR = qname("p", "cNvPicPr", NS.pml);
-const NAME_NV_PR$3 = qname("p", "nvPr", NS.pml);
+const NAME_NV_PR$4 = qname("p", "nvPr", NS.pml);
 const NAME_BLIP_FILL = qname("p", "blipFill", NS.pml);
 const NAME_BLIP = qname("a", "blip", NS.dml);
 const NAME_STRETCH = qname("a", "stretch", NS.dml);
@@ -3555,37 +4041,175 @@ const NAME_FILL_RECT = qname("a", "fillRect", NS.dml);
 const NAME_SP_PR$1 = qname("p", "spPr", NS.pml);
 const NAME_A_XFRM = qname("a", "xfrm", NS.dml);
 const NAME_OFF$2 = qname("a", "off", NS.dml);
-const NAME_EXT$2 = qname("a", "ext", NS.dml);
+const NAME_EXT$3 = qname("a", "ext", NS.dml);
 const NAME_PRST_GEOM = qname("a", "prstGeom", NS.dml);
 const NAME_AV_LST = qname("a", "avLst", NS.dml);
 const NAME_PIC_LOCKS = qname("a", "picLocks", NS.dml);
-const ATTR_ID$6 = qname("", "id", "");
+const ATTR_ID$8 = qname("", "id", "");
 const ATTR_NAME$4 = qname("", "name", "");
 const ATTR_X$2 = qname("", "x", "");
 const ATTR_Y$2 = qname("", "y", "");
 const ATTR_CX$2 = qname("", "cx", "");
 const ATTR_CY$2 = qname("", "cy", "");
 const ATTR_PRST = qname("", "prst", "");
-const ATTR_R_EMBED = qname("r", "embed", NS.officeDocRels);
+const ATTR_R_EMBED$1 = qname("r", "embed", NS.officeDocRels);
 const ATTR_NO_CHANGE_ASPECT$1 = qname("", "noChangeAspect", "");
 /** Returns a `<p:pic>` element ready to be appended to a slide's `<p:spTree>`. */
 const buildPicture = (opts) => {
 	const name = opts.name ?? `Picture ${opts.id}`;
 	const cNvPicPr = elem(NAME_C_NV_PIC_PR, { children: [elem(NAME_PIC_LOCKS, { attrs: opts.lockAspect ?? true ? [attr(ATTR_NO_CHANGE_ASPECT$1, "1")] : [] })] });
 	return elem(NAME_PIC, { children: [
-		elem(NAME_NV_PIC_PR, { children: [
-			elem(NAME_C_NV_PR$2, { attrs: [attr(ATTR_ID$6, String(opts.id)), attr(ATTR_NAME$4, name)] }),
+		elem(NAME_NV_PIC_PR$1, { children: [
+			elem(NAME_C_NV_PR$3, { attrs: [attr(ATTR_ID$8, String(opts.id)), attr(ATTR_NAME$4, name)] }),
 			cNvPicPr,
-			elem(NAME_NV_PR$3)
+			elem(NAME_NV_PR$4)
 		] }),
-		elem(NAME_BLIP_FILL, { children: [elem(NAME_BLIP, { attrs: [attr(ATTR_R_EMBED, opts.rEmbed)] }), elem(NAME_STRETCH, { children: [elem(NAME_FILL_RECT)] })] }),
-		elem(NAME_SP_PR$1, { children: [elem(NAME_A_XFRM, { children: [elem(NAME_OFF$2, { attrs: [attr(ATTR_X$2, String(emuCoordinate(opts.x, "addSlideImage: x"))), attr(ATTR_Y$2, String(emuCoordinate(opts.y, "addSlideImage: y")))] }), elem(NAME_EXT$2, { attrs: [attr(ATTR_CX$2, String(emuExtent(opts.w, "addSlideImage: w"))), attr(ATTR_CY$2, String(emuExtent(opts.h, "addSlideImage: h")))] })] }), elem(NAME_PRST_GEOM, {
+		elem(NAME_BLIP_FILL, { children: [elem(NAME_BLIP, { attrs: [attr(ATTR_R_EMBED$1, opts.rEmbed)] }), elem(NAME_STRETCH, { children: [elem(NAME_FILL_RECT)] })] }),
+		elem(NAME_SP_PR$1, { children: [elem(NAME_A_XFRM, { children: [elem(NAME_OFF$2, { attrs: [attr(ATTR_X$2, String(emuCoordinate(opts.x, "addSlideImage: x"))), attr(ATTR_Y$2, String(emuCoordinate(opts.y, "addSlideImage: y")))] }), elem(NAME_EXT$3, { attrs: [attr(ATTR_CX$2, String(emuExtent(opts.w, "addSlideImage: w"))), attr(ATTR_CY$2, String(emuExtent(opts.h, "addSlideImage: h")))] })] }), elem(NAME_PRST_GEOM, {
 			attrs: [attr(ATTR_PRST, "rect")],
 			children: [elem(NAME_AV_LST)]
 		})] })
 	] });
 };
 //#endregion
+//#region src/internal/presentationml/media-builder.ts
+const NAME_NV_PIC_PR = qname("p", "nvPicPr", NS.pml);
+const NAME_C_NV_PR$2 = qname("p", "cNvPr", NS.pml);
+const NAME_NV_PR$3 = qname("p", "nvPr", NS.pml);
+const NAME_HLINK_CLICK = qname("a", "hlinkClick", NS.dml);
+const NAME_VIDEO_FILE = qname("a", "videoFile", NS.dml);
+const NAME_AUDIO_FILE = qname("a", "audioFile", NS.dml);
+const NAME_EXT_LST$2 = qname("p", "extLst", NS.pml);
+const NAME_EXT$2 = qname("p", "ext", NS.pml);
+const NAME_P14_MEDIA = qname("p14", "media", NS.p14);
+const NAME_TIMING$2 = qname("p", "timing", NS.pml);
+const NAME_TN_LST$2 = qname("p", "tnLst", NS.pml);
+const NAME_PAR$2 = qname("p", "par", NS.pml);
+const NAME_C_TN$2 = qname("p", "cTn", NS.pml);
+const NAME_CHILD_TN_LST$2 = qname("p", "childTnLst", NS.pml);
+const NAME_VIDEO = qname("p", "video", NS.pml);
+const NAME_AUDIO = qname("p", "audio", NS.pml);
+const NAME_C_MEDIA_NODE = qname("p", "cMediaNode", NS.pml);
+const NAME_ST_COND_LST$1 = qname("p", "stCondLst", NS.pml);
+const NAME_COND$1 = qname("p", "cond", NS.pml);
+const NAME_TGT_EL$1 = qname("p", "tgtEl", NS.pml);
+const NAME_SP_TGT$1 = qname("p", "spTgt", NS.pml);
+const ATTR_R_ID$2 = qname("r", "id", NS.officeDocRels);
+const ATTR_R_LINK = qname("r", "link", NS.officeDocRels);
+const ATTR_R_EMBED = qname("r", "embed", NS.officeDocRels);
+const ATTR_ACTION = qname("", "action", "");
+const ATTR_URI$2 = qname("", "uri", "");
+const ATTR_ID$7 = qname("", "id", "");
+const ATTR_DUR$1 = qname("", "dur", "");
+const ATTR_RESTART$1 = qname("", "restart", "");
+const ATTR_NODE_TYPE$1 = qname("", "nodeType", "");
+const ATTR_VOL = qname("", "vol", "");
+const ATTR_FILL$1 = qname("", "fill", "");
+const ATTR_DISPLAY = qname("", "display", "");
+const ATTR_DELAY$1 = qname("", "delay", "");
+const ATTR_SPID$1 = qname("", "spid", "");
+const MEDIA_ACTION = "ppaction://media";
+const P14_MEDIA_EXT_URI = "{DAA4B4D4-6D71-4841-9C94-3DE7FCFB9230}";
+const DEFAULT_MEDIA_VOLUME = "80000";
+/** Returns a media `<p:pic>`; `opts.rEmbed` is the poster image relationship. */
+const buildMediaPicture = (opts) => {
+	const pic = buildPicture(opts);
+	const nvPicPr = firstChildElement(pic, NAME_NV_PIC_PR);
+	const cNvPr = firstChildElement(nvPicPr, NAME_C_NV_PR$2);
+	const nvPr = firstChildElement(nvPicPr, NAME_NV_PR$3);
+	cNvPr.children.push(elem(NAME_HLINK_CLICK, { attrs: [attr(ATTR_R_ID$2, ""), attr(ATTR_ACTION, MEDIA_ACTION)] }));
+	nvPr.children.push(elem(opts.kind === "video" ? NAME_VIDEO_FILE : NAME_AUDIO_FILE, { attrs: [attr(ATTR_R_LINK, opts.rLink)] }));
+	if (opts.rMedia !== void 0) {
+		const media = elem(NAME_P14_MEDIA, {
+			attrs: [attr(ATTR_R_EMBED, opts.rMedia)],
+			prefixDecls: new Map([["p14", NS.p14]])
+		});
+		const ext = elem(NAME_EXT$2, {
+			attrs: [attr(ATTR_URI$2, P14_MEDIA_EXT_URI)],
+			children: [media]
+		});
+		nvPr.children.push(elem(NAME_EXT_LST$2, { children: [ext] }));
+	}
+	return pic;
+};
+/** Returns the `<p:video>` / `<p:audio>` time node that targets shape `spid`. */
+const buildMediaTimingNode = (kind, spid, cTnId) => {
+	const cTn = elem(NAME_C_TN$2, {
+		attrs: [
+			attr(ATTR_ID$7, String(cTnId)),
+			attr(ATTR_FILL$1, "hold"),
+			attr(ATTR_DISPLAY, "0")
+		],
+		children: [elem(NAME_ST_COND_LST$1, { children: [elem(NAME_COND$1, { attrs: [attr(ATTR_DELAY$1, "indefinite")] })] })]
+	});
+	const tgtEl = elem(NAME_TGT_EL$1, { children: [elem(NAME_SP_TGT$1, { attrs: [attr(ATTR_SPID$1, String(spid))] })] });
+	const cMediaNode = elem(NAME_C_MEDIA_NODE, {
+		attrs: [attr(ATTR_VOL, DEFAULT_MEDIA_VOLUME)],
+		children: [cTn, tgtEl]
+	});
+	return elem(kind === "video" ? NAME_VIDEO : NAME_AUDIO, { children: [cMediaNode] });
+};
+/**
+* Returns a `<p:timing>` holding only the root time node, with `nodes` as its
+* children. `nodes` must be non-empty (`<p:childTnLst>` requires a child).
+*/
+const buildTimingRoot = (nodes) => {
+	return elem(NAME_TIMING$2, { children: [elem(NAME_TN_LST$2, { children: [elem(NAME_PAR$2, { children: [elem(NAME_C_TN$2, {
+		attrs: [
+			attr(ATTR_ID$7, "1"),
+			attr(ATTR_DUR$1, "indefinite"),
+			attr(ATTR_RESTART$1, "never"),
+			attr(ATTR_NODE_TYPE$1, "tmRoot")
+		],
+		children: [elem(NAME_CHILD_TN_LST$2, { children: [...nodes] })]
+	})] })] })] });
+};
+/** `true` for a `<p:video>` / `<p:audio>` time node. */
+const isMediaTimingNode = (el) => el.name.namespaceURI === NS.pml && (el.name.localName === "video" || el.name.localName === "audio");
+/** Shape id a media time node targets, or `null` when it has no `<p:spTgt>`. */
+const mediaTimingNodeTarget = (node) => {
+	const cMediaNode = firstChildElement(node, NAME_C_MEDIA_NODE);
+	const tgtEl = cMediaNode ? firstChildElement(cMediaNode, NAME_TGT_EL$1) : null;
+	const spTgt = tgtEl ? firstChildElement(tgtEl, NAME_SP_TGT$1) : null;
+	const raw = spTgt ? getAttrValue(spTgt, ATTR_SPID$1) : null;
+	if (raw === null) return null;
+	const spid = Number.parseInt(raw, 10);
+	return Number.isFinite(spid) ? spid : null;
+};
+const MEDIA_FILE_ELEMENTS = {
+	videoFile: "video",
+	quickTimeFile: "video",
+	audioFile: "audio",
+	wavAudioFile: "audio"
+};
+/** Reads the media reference off a `<p:pic>`, or `null` for a plain picture. */
+const readPictureMediaRef = (pic) => {
+	const nvPicPr = firstChildElement(pic, NAME_NV_PIC_PR);
+	const nvPr = nvPicPr ? firstChildElement(nvPicPr, NAME_NV_PR$3) : null;
+	if (!nvPr) return null;
+	for (const child of nvPr.children) {
+		if (child.kind !== "element" || child.name.namespaceURI !== NS.dml) continue;
+		const kind = MEDIA_FILE_ELEMENTS[child.name.localName];
+		if (kind === void 0) continue;
+		return {
+			kind,
+			fileRId: child.name.localName === "wavAudioFile" ? getAttrValue(child, ATTR_R_EMBED) : getAttrValue(child, ATTR_R_LINK),
+			mediaRId: readP14MediaRId(nvPr)
+		};
+	}
+	return null;
+};
+const readP14MediaRId = (nvPr) => {
+	const extLst = firstChildElement(nvPr, NAME_EXT_LST$2);
+	if (!extLst) return null;
+	for (const ext of extLst.children) {
+		if (ext.kind !== "element") continue;
+		const media = firstChildElement(ext, NAME_P14_MEDIA);
+		if (media) return getAttrValue(media, ATTR_R_EMBED);
+	}
+	return null;
+};
+//#endregion
 //#region src/internal/presentationml/table-builder.ts
 const TABLE_URI = "http://schemas.openxmlformats.org/drawingml/2006/table";
 const DEFAULT_TABLE_STYLE_ID = "{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}";
@@ -3625,7 +4249,7 @@ const ATTR_MAR_R = qname("", "marR", "");
 const ATTR_MAR_T = qname("", "marT", "");
 const ATTR_MAR_B = qname("", "marB", "");
 const ATTR_INDENT = qname("", "indent", "");
-const ATTR_ID$5 = qname("", "id", "");
+const ATTR_ID$6 = qname("", "id", "");
 const ATTR_NAME$3 = qname("", "name", "");
 const ATTR_NO_GRP$1 = qname("", "noGrp", "");
 const ATTR_X$1 = qname("", "x", "");
@@ -3701,7 +4325,7 @@ const buildTable = (opts) => {
 	if (rowHeights.length !== rows.length) throw new Error(`addSlideTable: rowHeights has ${rowHeights.length} entries; expected ${rows.length}`);
 	const name = opts.name ?? `Table ${opts.id}`;
 	const nvGraphicFramePr = elem(NAME_NV_GRAPHIC_FRAME_PR$1, { children: [
-		elem(NAME_C_NV_PR$1, { attrs: [attr(ATTR_ID$5, String(opts.id)), attr(ATTR_NAME$3, name)] }),
+		elem(NAME_C_NV_PR$1, { attrs: [attr(ATTR_ID$6, String(opts.id)), attr(ATTR_NAME$3, name)] }),
 		elem(NAME_C_NV_GRAPHIC_FRAME_PR$1, { children: [elem(NAME_GRAPHIC_FRAME_LOCKS, { attrs: [attr(ATTR_NO_GRP$1, "1")] })] }),
 		elem(NAME_NV_PR$2)
 	] });
@@ -3749,7 +4373,7 @@ const NAME_R = qname("a", "r", NS.dml);
 const NAME_RPR = qname("a", "rPr", NS.dml);
 const NAME_T$1 = qname("a", "t", NS.dml);
 const NAME_SP_LOCKS = qname("a", "spLocks", NS.dml);
-const ATTR_ID$4 = qname("", "id", "");
+const ATTR_ID$5 = qname("", "id", "");
 const ATTR_NAME$2 = qname("", "name", "");
 const ATTR_NO_GRP = qname("", "noGrp", "");
 const ATTR_NO_ROT = qname("", "noRot", "");
@@ -3759,14 +4383,14 @@ const ATTR_IDX$3 = qname("", "idx", "");
 const ATTR_LANG = qname("", "lang", "");
 const buildRootGroup = () => {
 	return elem(NAME_NV_GRP_SP_PR, { children: [
-		elem(NAME_C_NV_PR, { attrs: [attr(ATTR_ID$4, "1"), attr(ATTR_NAME$2, "")] }),
+		elem(NAME_C_NV_PR, { attrs: [attr(ATTR_ID$5, "1"), attr(ATTR_NAME$2, "")] }),
 		elem(NAME_C_NV_GRP_SP_PR),
 		elem(NAME_NV_PR$1)
 	] });
 };
 const buildSldImgPlaceholder = (id) => {
 	return elem(NAME_SP, { children: [elem(NAME_NV_SP_PR, { children: [
-		elem(NAME_C_NV_PR, { attrs: [attr(ATTR_ID$4, String(id)), attr(ATTR_NAME$2, `Slide Image Placeholder ${id - 1}`)] }),
+		elem(NAME_C_NV_PR, { attrs: [attr(ATTR_ID$5, String(id)), attr(ATTR_NAME$2, `Slide Image Placeholder ${id - 1}`)] }),
 		elem(NAME_C_NV_SP_PR, { children: [elem(NAME_SP_LOCKS, { attrs: [
 			attr(ATTR_NO_GRP, "1"),
 			attr(ATTR_NO_ROT, "1"),
@@ -3783,7 +4407,7 @@ const buildNotesParagraphs = (notes) => {
 };
 const buildNotesBodyPlaceholder = (id, notes) => {
 	const nvSpPr = elem(NAME_NV_SP_PR, { children: [
-		elem(NAME_C_NV_PR, { attrs: [attr(ATTR_ID$4, String(id)), attr(ATTR_NAME$2, `Notes Placeholder ${id - 1}`)] }),
+		elem(NAME_C_NV_PR, { attrs: [attr(ATTR_ID$5, String(id)), attr(ATTR_NAME$2, `Notes Placeholder ${id - 1}`)] }),
 		elem(NAME_C_NV_SP_PR, { children: [elem(NAME_SP_LOCKS, { attrs: [attr(ATTR_NO_GRP, "1")] })] }),
 		elem(NAME_NV_PR$1, { children: [elem(NAME_PH, { attrs: [attr(ATTR_TYPE$1, "body"), attr(ATTR_IDX$3, "1")] })] })
 	] });
@@ -3903,12 +4527,20 @@ const buildEffectElement = (opts) => {
 			attrs.push(attr(ATTR_DIR, opts.direction));
 		}
 	}
-	if (opts.orientation !== void 0 && opts.effect === "split") attrs.push(attr(ATTR_ORIENT, opts.orientation));
+	if (opts.orientation !== void 0 && opts.effect === "split") {
+		oneOf(opts.orientation, ["horz", "vert"], "setSlideTransition: orientation");
+		attrs.push(attr(ATTR_ORIENT, opts.orientation));
+	}
 	if (opts.thruBlack && THRU_BLK_EFFECTS.has(opts.effect)) attrs.push(attr(ATTR_THRU_BLK, "1"));
 	return elem(name, { attrs });
 };
 /** Returns a complete `<p:transition>` element. */
 const buildTransition = (opts) => {
+	if (opts.speed !== void 0) oneOf(opts.speed, [
+		"slow",
+		"med",
+		"fast"
+	], "setSlideTransition: speed");
 	const attrs = [];
 	if (opts.speed !== void 0) attrs.push(attr(ATTR_SPD, opts.speed));
 	if (opts.advanceOnClick === false) attrs.push(attr(ATTR_ADV_CLICK, "0"));
@@ -3924,11 +4556,11 @@ const buildTransition = (opts) => {
 };
 //#endregion
 //#region src/internal/presentationml/animation-builder.ts
-const NAME_TIMING = qname("p", "timing", NS.pml);
-const NAME_TN_LST = qname("p", "tnLst", NS.pml);
-const NAME_PAR = qname("p", "par", NS.pml);
-const NAME_C_TN = qname("p", "cTn", NS.pml);
-const NAME_CHILD_TN_LST = qname("p", "childTnLst", NS.pml);
+const NAME_TIMING$1 = qname("p", "timing", NS.pml);
+const NAME_TN_LST$1 = qname("p", "tnLst", NS.pml);
+const NAME_PAR$1 = qname("p", "par", NS.pml);
+const NAME_C_TN$1 = qname("p", "cTn", NS.pml);
+const NAME_CHILD_TN_LST$1 = qname("p", "childTnLst", NS.pml);
 const NAME_SEQ = qname("p", "seq", NS.pml);
 const NAME_ST_COND_LST = qname("p", "stCondLst", NS.pml);
 const NAME_PREV_COND_LST = qname("p", "prevCondLst", NS.pml);
@@ -3950,7 +4582,7 @@ const NAME_TAV_LST = qname("p", "tavLst", NS.pml);
 const NAME_TAV = qname("p", "tav", NS.pml);
 const NAME_BLD_LST = qname("p", "bldLst", NS.pml);
 const NAME_BLD_P = qname("p", "bldP", NS.pml);
-const ATTR_ID$3 = qname("", "id", "");
+const ATTR_ID$4 = qname("", "id", "");
 const ATTR_DUR = qname("", "dur", "");
 const ATTR_RESTART = qname("", "restart", "");
 const ATTR_NODE_TYPE = qname("", "nodeType", "");
@@ -3998,9 +4630,9 @@ const buildSetVisibility = (spid, visible) => {
 		data: "style.visibility"
 	}] })] });
 	return elem(NAME_SET, { children: [elem(NAME_C_BHVR, { children: [
-		elem(NAME_C_TN, {
+		elem(NAME_C_TN$1, {
 			attrs: [
-				attr(ATTR_ID$3, "6"),
+				attr(ATTR_ID$4, "6"),
 				attr(ATTR_DUR, "1"),
 				attr(ATTR_FILL, "hold")
 			],
@@ -4016,8 +4648,8 @@ const buildOpacityAnim = (spid, durationMs, fadeIn) => {
 		kind: "text",
 		data: "style.opacity"
 	}] })] });
-	const cTn = elem(NAME_C_TN, { attrs: [
-		attr(ATTR_ID$3, "7"),
+	const cTn = elem(NAME_C_TN$1, { attrs: [
+		attr(ATTR_ID$4, "7"),
 		attr(ATTR_DUR, String(durationMs)),
 		attr(ATTR_FILL, "hold")
 	] });
@@ -4045,19 +4677,24 @@ const buildOpacityAnim = (spid, durationMs, fadeIn) => {
 };
 /**
 * Builds the complete `<p:timing>` element for a single click-effect on
-* the given shape id. Returns null for unsupported effect kinds.
+* the given shape id.
 */
 const buildSingleEffectTiming = (spid, opts) => {
-	const preset = PRESETS[opts.effect];
+	const preset = PRESETS[oneOf(opts.effect, [
+		"fadeIn",
+		"fadeOut",
+		"appear",
+		"disappear"
+	], "setShapeAnimation: effect")];
 	const duration = opts.durationMs === void 0 ? 500 : unsignedIntMs(opts.durationMs, "setShapeAnimation: durationMs");
 	const isFade = opts.effect === "fadeIn" || opts.effect === "fadeOut";
 	const isEntrance = preset.presetClass === "entr";
 	const effectChildren = [];
 	effectChildren.push(buildSetVisibility(spid, isEntrance));
 	if (isFade) effectChildren.push(buildOpacityAnim(spid, duration, isEntrance));
-	const effectPar = elem(NAME_PAR, { children: [elem(NAME_C_TN, {
+	const effectPar = elem(NAME_PAR$1, { children: [elem(NAME_C_TN$1, {
 		attrs: [
-			attr(ATTR_ID$3, "5"),
+			attr(ATTR_ID$4, "5"),
 			attr(ATTR_PRESET_ID, String(preset.presetId)),
 			attr(ATTR_PRESET_CLASS, preset.presetClass),
 			attr(ATTR_PRESET_SUBTYPE, String(preset.presetSubtype)),
@@ -4065,23 +4702,23 @@ const buildSingleEffectTiming = (spid, opts) => {
 			attr(ATTR_GRP_ID, "0"),
 			attr(ATTR_NODE_TYPE, "clickEffect")
 		],
-		children: [elem(NAME_ST_COND_LST, { children: [elem(NAME_COND, { attrs: [attr(ATTR_DELAY, "0")] })] }), elem(NAME_CHILD_TN_LST, { children: effectChildren })]
+		children: [elem(NAME_ST_COND_LST, { children: [elem(NAME_COND, { attrs: [attr(ATTR_DELAY, "0")] })] }), elem(NAME_CHILD_TN_LST$1, { children: effectChildren })]
 	})] });
-	const clickWrapperPar = elem(NAME_PAR, { children: [elem(NAME_C_TN, {
-		attrs: [attr(ATTR_ID$3, "4"), attr(ATTR_FILL, "hold")],
-		children: [elem(NAME_ST_COND_LST, { children: [elem(NAME_COND, { attrs: [attr(ATTR_DELAY, "0")] })] }), elem(NAME_CHILD_TN_LST, { children: [effectPar] })]
+	const clickWrapperPar = elem(NAME_PAR$1, { children: [elem(NAME_C_TN$1, {
+		attrs: [attr(ATTR_ID$4, "4"), attr(ATTR_FILL, "hold")],
+		children: [elem(NAME_ST_COND_LST, { children: [elem(NAME_COND, { attrs: [attr(ATTR_DELAY, "0")] })] }), elem(NAME_CHILD_TN_LST$1, { children: [effectPar] })]
 	})] });
-	const indefinitePar = elem(NAME_PAR, { children: [elem(NAME_C_TN, {
-		attrs: [attr(ATTR_ID$3, "3"), attr(ATTR_FILL, "hold")],
-		children: [elem(NAME_ST_COND_LST, { children: [elem(NAME_COND, { attrs: [attr(ATTR_DELAY, "indefinite")] })] }), elem(NAME_CHILD_TN_LST, { children: [clickWrapperPar] })]
+	const indefinitePar = elem(NAME_PAR$1, { children: [elem(NAME_C_TN$1, {
+		attrs: [attr(ATTR_ID$4, "3"), attr(ATTR_FILL, "hold")],
+		children: [elem(NAME_ST_COND_LST, { children: [elem(NAME_COND, { attrs: [attr(ATTR_DELAY, "indefinite")] })] }), elem(NAME_CHILD_TN_LST$1, { children: [clickWrapperPar] })]
 	})] });
-	const mainSeqCTn = elem(NAME_C_TN, {
+	const mainSeqCTn = elem(NAME_C_TN$1, {
 		attrs: [
-			attr(ATTR_ID$3, "2"),
+			attr(ATTR_ID$4, "2"),
 			attr(ATTR_DUR, "indefinite"),
 			attr(ATTR_NODE_TYPE, "mainSeq")
 		],
-		children: [elem(NAME_CHILD_TN_LST, { children: [indefinitePar] })]
+		children: [elem(NAME_CHILD_TN_LST$1, { children: [indefinitePar] })]
 	});
 	const prevCond = elem(NAME_PREV_COND_LST, { children: [elem(NAME_COND, {
 		attrs: [attr(ATTR_EVT, "onPrev"), attr(ATTR_DELAY, "0")],
@@ -4099,14 +4736,14 @@ const buildSingleEffectTiming = (spid, opts) => {
 			nextCond
 		]
 	});
-	return elem(NAME_TIMING, { children: [elem(NAME_TN_LST, { children: [elem(NAME_PAR, { children: [elem(NAME_C_TN, {
+	return elem(NAME_TIMING$1, { children: [elem(NAME_TN_LST$1, { children: [elem(NAME_PAR$1, { children: [elem(NAME_C_TN$1, {
 		attrs: [
-			attr(ATTR_ID$3, "1"),
+			attr(ATTR_ID$4, "1"),
 			attr(ATTR_DUR, "indefinite"),
 			attr(ATTR_RESTART, "never"),
 			attr(ATTR_NODE_TYPE, "tmRoot")
 		],
-		children: [elem(NAME_CHILD_TN_LST, { children: [seq] })]
+		children: [elem(NAME_CHILD_TN_LST$1, { children: [seq] })]
 	})] })] }), elem(NAME_BLD_LST, { children: [elem(NAME_BLD_P, { attrs: [attr(ATTR_SPID, String(spid)), attr(ATTR_GRP_ID, "0")] })] })] });
 };
 //#endregion
@@ -4117,7 +4754,7 @@ const NAME_CM_LST = qname("p", "cmLst", NS.pml);
 const NAME_CM = qname("p", "cm", NS.pml);
 const NAME_POS = qname("p", "pos", NS.pml);
 const NAME_TEXT = qname("p", "text", NS.pml);
-const ATTR_ID$2 = qname("", "id", "");
+const ATTR_ID$3 = qname("", "id", "");
 const ATTR_NAME$1 = qname("", "name", "");
 const ATTR_INITIALS = qname("", "initials", "");
 const ATTR_LAST_IDX = qname("", "lastIdx", "");
@@ -4131,7 +4768,7 @@ const readCommentAuthorList = (root) => {
 	if (root.name.namespaceURI !== NS.pml || root.name.localName !== "cmAuthorLst") throw new Error(`expected <p:cmAuthorLst> root, got <${root.name.prefix}:${root.name.localName}>`);
 	const authors = [];
 	for (const el of allChildElements(root, NAME_CM_AUTHOR)) {
-		const idRaw = getAttrValue(el, ATTR_ID$2);
+		const idRaw = getAttrValue(el, ATTR_ID$3);
 		const nameVal = getAttrValue(el, ATTR_NAME$1);
 		const initialsVal = getAttrValue(el, ATTR_INITIALS);
 		const lastIdxRaw = getAttrValue(el, ATTR_LAST_IDX);
@@ -4191,7 +4828,7 @@ const readCommentList = (root) => {
 };
 const commentAuthorElement = (a) => {
 	return elem(NAME_CM_AUTHOR, { attrs: [
-		attr(ATTR_ID$2, String(a.id)),
+		attr(ATTR_ID$3, String(a.id)),
 		attr(ATTR_NAME$1, a.name),
 		attr(ATTR_INITIALS, a.initials),
 		attr(ATTR_LAST_IDX, String(a.lastIdx)),
@@ -4255,7 +4892,7 @@ const NAME_SLD_ID_LST$1 = qname("p", "sldIdLst", NS.pml);
 const NAME_SLD_ID$1 = qname("p", "sldId", NS.pml);
 const NAME_CSLD = qname("p", "cSld", NS.pml);
 const NAME_SP_TREE = qname("p", "spTree", NS.pml);
-const ATTR_ID$1 = qname("", "id", "");
+const ATTR_ID$2 = qname("", "id", "");
 const ATTR_R_ID$1 = qname("r", "id", NS.officeDocRels);
 const SLD_ID_MAX = 2147482623;
 const commitSlideData = (slide) => {
@@ -5159,6 +5796,348 @@ const setShapeClickAction = (shape, action) => {
 	commitAndRefresh(shape);
 };
 //#endregion
+//#region src/internal/chartml/enum-validation.ts
+const LABEL_POSITIONS = [
+	"ctr",
+	"inEnd",
+	"outEnd",
+	"inBase",
+	"t",
+	"b",
+	"l",
+	"r",
+	"bestFit"
+];
+const DISPLAY_UNITS = [
+	"hundreds",
+	"thousands",
+	"tenThousands",
+	"hundredThousands",
+	"millions",
+	"tenMillions",
+	"hundredMillions",
+	"billions",
+	"trillions"
+];
+const LABEL_ALIGNMENTS = [
+	"ctr",
+	"l",
+	"r"
+];
+const DISPLAY_BLANKS = [
+	"gap",
+	"zero",
+	"span"
+];
+const SCATTER_STYLES = [
+	"none",
+	"line",
+	"lineMarker",
+	"marker",
+	"smooth",
+	"smoothMarker"
+];
+const RADAR_STYLES = [
+	"standard",
+	"marker",
+	"filled"
+];
+const BAR_3D_SHAPES = [
+	"box",
+	"cone",
+	"coneToMax",
+	"cylinder",
+	"pyramid",
+	"pyramidToMax"
+];
+const OF_PIE_TYPES = ["pie", "bar"];
+const SPLIT_TYPES = [
+	"auto",
+	"cust",
+	"percent",
+	"pos",
+	"val"
+];
+const LAYOUT_TARGETS = ["inner", "outer"];
+const AXIS_CROSSES = [
+	"autoZero",
+	"min",
+	"max"
+];
+const LEGEND_POSITIONS = [
+	"r",
+	"t",
+	"b",
+	"l",
+	"tr"
+];
+const MARKER_SYMBOLS = [
+	"none",
+	"auto",
+	"circle",
+	"square",
+	"diamond",
+	"triangle",
+	"star",
+	"x",
+	"plus",
+	"dash",
+	"dot",
+	"picture"
+];
+const TRENDLINE_TYPES = [
+	"linear",
+	"exp",
+	"log",
+	"poly",
+	"power",
+	"movingAvg"
+];
+const ERROR_BAR_TYPES = [
+	"both",
+	"plus",
+	"minus"
+];
+const ERROR_VALUE_TYPES = [
+	"fixedVal",
+	"percentage",
+	"stdDev",
+	"stdErr",
+	"cust"
+];
+const GROUPINGS = [
+	"clustered",
+	"stacked",
+	"percentStacked",
+	"standard"
+];
+const TICK_MARKS = [
+	"in",
+	"out",
+	"cross",
+	"none"
+];
+const TICK_LABEL_POSITIONS = [
+	"none",
+	"low",
+	"high",
+	"nextTo"
+];
+const ORIENTATIONS = ["minMax", "maxMin"];
+const CROSS_BETWEEN = ["between", "midCat"];
+const TIME_UNITS$1 = [
+	"days",
+	"months",
+	"years"
+];
+const validateLabels = (labels, field) => {
+	if (labels?.position !== void 0) oneOf(labels.position, LABEL_POSITIONS, `${field}.position`);
+};
+const validateScaling = (scaling, field) => {
+	if (scaling?.displayUnits !== void 0) oneOf(scaling.displayUnits, DISPLAY_UNITS, `${field}.displayUnits`);
+};
+/** Validate before chart XML or its embedded workbook is changed. */
+const validateChartSpecEnums = (spec, caller) => {
+	oneOf(spec.kind, [
+		"bar",
+		"column",
+		"line",
+		"pie",
+		"doughnut",
+		"area",
+		"scatter",
+		"radar",
+		"bubble",
+		"stock",
+		"surface"
+	], `${caller}: kind`);
+	if (spec.grouping !== void 0) oneOf(spec.grouping, GROUPINGS, `${caller}: grouping`);
+	if (spec.valueAxisMajorTickMark !== void 0) oneOf(spec.valueAxisMajorTickMark, TICK_MARKS, `${caller}: valueAxisMajorTickMark`);
+	if (spec.valueAxisMinorTickMark !== void 0) oneOf(spec.valueAxisMinorTickMark, TICK_MARKS, `${caller}: valueAxisMinorTickMark`);
+	if (spec.categoryAxisMajorTickMark !== void 0) oneOf(spec.categoryAxisMajorTickMark, TICK_MARKS, `${caller}: categoryAxisMajorTickMark`);
+	if (spec.categoryAxisMinorTickMark !== void 0) oneOf(spec.categoryAxisMinorTickMark, TICK_MARKS, `${caller}: categoryAxisMinorTickMark`);
+	if (spec.valueAxisTickLabelPos !== void 0) oneOf(spec.valueAxisTickLabelPos, TICK_LABEL_POSITIONS, `${caller}: valueAxisTickLabelPos`);
+	if (spec.categoryAxisTickLabelPos !== void 0) oneOf(spec.categoryAxisTickLabelPos, TICK_LABEL_POSITIONS, `${caller}: categoryAxisTickLabelPos`);
+	if (spec.categoryAxisLabelAlign !== void 0) oneOf(spec.categoryAxisLabelAlign, LABEL_ALIGNMENTS, `${caller}: categoryAxisLabelAlign`);
+	if (spec.categoryAxisOrientation !== void 0) oneOf(spec.categoryAxisOrientation, ORIENTATIONS, `${caller}: categoryAxisOrientation`);
+	if (spec.valueAxisOrientation !== void 0) oneOf(spec.valueAxisOrientation, ORIENTATIONS, `${caller}: valueAxisOrientation`);
+	if (spec.valueAxisCrossBetween !== void 0) oneOf(spec.valueAxisCrossBetween, CROSS_BETWEEN, `${caller}: valueAxisCrossBetween`);
+	if (spec.dispBlanksAs !== void 0) oneOf(spec.dispBlanksAs, DISPLAY_BLANKS, `${caller}: dispBlanksAs`);
+	if (spec.scatterStyle !== void 0) oneOf(spec.scatterStyle, SCATTER_STYLES, `${caller}: scatterStyle`);
+	if (spec.radarStyle !== void 0) oneOf(spec.radarStyle, RADAR_STYLES, `${caller}: radarStyle`);
+	if (spec.bubbleSizeRepresents !== void 0) oneOf(spec.bubbleSizeRepresents, ["area", "width"], `${caller}: bubbleSizeRepresents`);
+	if (spec.bar3DShape !== void 0) oneOf(spec.bar3DShape, BAR_3D_SHAPES, `${caller}: bar3DShape`);
+	if (spec.secondaryValueAxis?.majorTickMark !== void 0) oneOf(spec.secondaryValueAxis.majorTickMark, TICK_MARKS, `${caller}: secondaryValueAxis.majorTickMark`);
+	if (spec.secondaryValueAxis?.minorTickMark !== void 0) oneOf(spec.secondaryValueAxis.minorTickMark, TICK_MARKS, `${caller}: secondaryValueAxis.minorTickMark`);
+	if (spec.secondaryValueAxis?.tickLabelPos !== void 0) oneOf(spec.secondaryValueAxis.tickLabelPos, TICK_LABEL_POSITIONS, `${caller}: secondaryValueAxis.tickLabelPos`);
+	if (spec.secondaryValueAxis?.crossBetween !== void 0) oneOf(spec.secondaryValueAxis.crossBetween, CROSS_BETWEEN, `${caller}: secondaryValueAxis.crossBetween`);
+	if (spec.seriesAxis?.orientation !== void 0) oneOf(spec.seriesAxis.orientation, ORIENTATIONS, `${caller}: seriesAxis.orientation`);
+	if (spec.seriesAxis?.tickLabelPos !== void 0) oneOf(spec.seriesAxis.tickLabelPos, TICK_LABEL_POSITIONS, `${caller}: seriesAxis.tickLabelPos`);
+	if (spec.categoryAxisDate?.baseTimeUnit !== void 0) oneOf(spec.categoryAxisDate.baseTimeUnit, TIME_UNITS$1, `${caller}: categoryAxisDate.baseTimeUnit`);
+	if (spec.categoryAxisDate?.majorTimeUnit !== void 0) oneOf(spec.categoryAxisDate.majorTimeUnit, TIME_UNITS$1, `${caller}: categoryAxisDate.majorTimeUnit`);
+	if (spec.categoryAxisDate?.minorTimeUnit !== void 0) oneOf(spec.categoryAxisDate.minorTimeUnit, TIME_UNITS$1, `${caller}: categoryAxisDate.minorTimeUnit`);
+	if (spec.ofPie?.type !== void 0) oneOf(spec.ofPie.type, OF_PIE_TYPES, `${caller}: ofPie.type`);
+	if (spec.ofPie?.splitType !== void 0) oneOf(spec.ofPie.splitType, SPLIT_TYPES, `${caller}: ofPie.splitType`);
+	if (spec.plotAreaLayout?.target !== void 0) oneOf(spec.plotAreaLayout.target, LAYOUT_TARGETS, `${caller}: plotAreaLayout.target`);
+	if (spec.legend?.layout?.target !== void 0) oneOf(spec.legend.layout.target, LAYOUT_TARGETS, `${caller}: legend.layout.target`);
+	if (spec.valueAxisCrosses !== void 0 && typeof spec.valueAxisCrosses !== "object") oneOf(spec.valueAxisCrosses, AXIS_CROSSES, `${caller}: valueAxisCrosses`);
+	if (spec.legend?.position != null) oneOf(spec.legend.position, LEGEND_POSITIONS, `${caller}: legend.position`);
+	validateLabels(spec.dataLabels, `${caller}: dataLabels`);
+	validateScaling(spec.valueAxis, `${caller}: valueAxis`);
+	validateScaling(spec.categoryAxisScaling, `${caller}: categoryAxisScaling`);
+	validateScaling(spec.secondaryValueAxis?.scaling, `${caller}: secondaryValueAxis.scaling`);
+	for (const [index, series] of spec.series.entries()) {
+		const field = `${caller}: series[${index}]`;
+		if (series.chartKind !== void 0) oneOf(series.chartKind, [
+			"bar",
+			"column",
+			"line",
+			"area"
+		], `${field}.chartKind`);
+		if (series.lineDash !== void 0) oneOf(series.lineDash, LINE_DASHES, `${field}.lineDash`);
+		if (series.markerSymbol !== void 0) oneOf(series.markerSymbol, MARKER_SYMBOLS, `${field}.markerSymbol`);
+		if (series.trendline !== void 0) oneOf(series.trendline.type, TRENDLINE_TYPES, `${field}.trendline.type`);
+		validateLabels(series.dataLabels, `${field}.dataLabels`);
+		for (const [point, labels] of (series.pointDataLabels ?? []).entries()) validateLabels(labels, `${field}.pointDataLabels[${point}]`);
+		for (const direction of ["errorBars", "xErrorBars"]) {
+			const bars = series[direction];
+			if (bars === void 0) continue;
+			oneOf(bars.barType, ERROR_BAR_TYPES, `${field}.${direction}.barType`);
+			oneOf(bars.amount.type, ERROR_VALUE_TYPES, `${field}.${direction}.amount.type`);
+		}
+	}
+};
+//#endregion
+//#region src/internal/chartml/embedded-xlsx.ts
+const TEXT_ENCODER = new TextEncoder();
+const encode = (s) => TEXT_ENCODER.encode(s);
+const xmlEscape = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+const colLetter = (col) => {
+	let n = col;
+	let out = "";
+	while (true) {
+		out = String.fromCharCode(65 + n % 26) + out;
+		if (n < 26) return out;
+		n = Math.floor(n / 26) - 1;
+	}
+};
+const cellRef = (row, col) => `${colLetter(col)}${row + 1}`;
+/**
+* Builds the bytes of a fresh xlsx whose only sheet holds `grid`, row by
+* row from A1. Which cell means what is the caller's business — see
+* `layoutChartSheet`, which also produces the `<c:f>` formulas that point
+* back into this grid.
+*/
+const buildEmbeddedXlsx = (grid) => {
+	const sheetXmlParts = [];
+	sheetXmlParts.push("<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n", "<worksheet xmlns=\"http://schemas.openxmlformats.org/spreadsheetml/2006/main\">", "<sheetData>");
+	grid.forEach((row, r) => {
+		sheetXmlParts.push(`<row r="${r + 1}">`);
+		row.forEach((cell, col) => {
+			if (cell === null) return;
+			sheetXmlParts.push(typeof cell === "number" ? `<c r="${cellRef(r, col)}"><v>${cell}</v></c>` : `<c r="${cellRef(r, col)}" t="inlineStr"><is><t>${xmlEscape(cell)}</t></is></c>`);
+		});
+		sheetXmlParts.push("</row>");
+	});
+	sheetXmlParts.push("</sheetData></worksheet>");
+	const sheetXml = sheetXmlParts.join("");
+	return writeZip([
+		{
+			name: "[Content_Types].xml",
+			data: encode("<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<Types xmlns=\"http://schemas.openxmlformats.org/package/2006/content-types\"><Default Extension=\"rels\" ContentType=\"application/vnd.openxmlformats-package.relationships+xml\"/><Default Extension=\"xml\" ContentType=\"application/xml\"/><Override PartName=\"/xl/workbook.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml\"/><Override PartName=\"/xl/worksheets/sheet1.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml\"/></Types>")
+		},
+		{
+			name: "_rels/.rels",
+			data: encode("<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<Relationships xmlns=\"http://schemas.openxmlformats.org/package/2006/relationships\"><Relationship Id=\"rId1\" Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument\" Target=\"xl/workbook.xml\"/></Relationships>")
+		},
+		{
+			name: "xl/workbook.xml",
+			data: encode("<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<workbook xmlns=\"http://schemas.openxmlformats.org/spreadsheetml/2006/main\" xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\"><sheets><sheet name=\"Sheet1\" sheetId=\"1\" r:id=\"rId1\"/></sheets></workbook>")
+		},
+		{
+			name: "xl/_rels/workbook.xml.rels",
+			data: encode("<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<Relationships xmlns=\"http://schemas.openxmlformats.org/package/2006/relationships\"><Relationship Id=\"rId1\" Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet\" Target=\"worksheets/sheet1.xml\"/></Relationships>")
+		},
+		{
+			name: "xl/worksheets/sheet1.xml",
+			data: encode(sheetXml)
+		}
+	]);
+};
+/**
+* Returns the spreadsheet-cell reference span used by chart `<c:f>`
+* formulas. Example: `cellRange('Sheet1', 1, 0, 4)` →
+* `"Sheet1!$A$2:$A$5"` (column A, rows 2–5 inclusive, 0-indexed input).
+*/
+const cellRange = (sheet, startRow, col, count, endCol = col) => `${sheet}!$${colLetter(col)}$${startRow + 1}:$${colLetter(endCol)}$${startRow + count}`;
+/** Single-cell reference, e.g. `cellAddr('Sheet1', 0, 1)` → `"Sheet1!$B$1"`. */
+const cellAddr = (sheet, row, col) => `${sheet}!$${colLetter(col)}$${row + 1}`;
+//#endregion
+//#region src/internal/chartml/sheet-layout.ts
+const SHEET = "Sheet1";
+const isXyKind = (spec) => spec.kind === "scatter" || spec.kind === "bubble";
+/** Parses a date-axis category; the caller has validated it is numeric. */
+const dateSerial = (category) => Number(category);
+const layoutCategorySheet = (spec) => {
+	const outerLevels = [...spec.categoryGroupLevels ?? []].reverse();
+	const levelCount = outerLevels.length + 1;
+	const rowCount = spec.categories.length;
+	const isDateAxis = spec.categoryAxisDate !== void 0;
+	const grid = [[...Array.from({ length: levelCount }, () => ""), ...spec.series.map((s) => s.name)]];
+	for (let r = 0; r < rowCount; r++) {
+		const category = spec.categories[r] ?? "";
+		const row = outerLevels.map((level) => {
+			const label = level[r] ?? "";
+			return label === "" ? null : label;
+		});
+		row.push(isDateAxis ? dateSerial(category) : category);
+		for (const s of spec.series) row.push(s.values[r] ?? null);
+		grid.push(row);
+	}
+	return {
+		grid,
+		categories: cellRange(SHEET, 1, 0, rowCount, levelCount - 1),
+		series: spec.series.map((_, i) => ({
+			name: cellAddr(SHEET, 0, levelCount + i),
+			values: cellRange(SHEET, 1, levelCount + i, rowCount)
+		}))
+	};
+};
+const layoutXySheet = (spec) => {
+	const isBubble = spec.kind === "bubble";
+	const stride = isBubble ? 3 : 2;
+	const rowCount = Math.max(0, ...spec.series.map((s) => Math.max(s.values.length, s.xValues?.length ?? 0, s.bubbleSizes?.length ?? 0)));
+	const header = [];
+	for (const s of spec.series) {
+		header.push("X", s.name);
+		if (isBubble) header.push("Size");
+	}
+	const grid = [header];
+	for (let r = 0; r < rowCount; r++) {
+		const row = [];
+		for (const s of spec.series) {
+			row.push(s.xValues?.[r] ?? null, s.values[r] ?? null);
+			if (isBubble) row.push(s.bubbleSizes?.[r] ?? null);
+		}
+		grid.push(row);
+	}
+	return {
+		grid,
+		series: spec.series.map((s, i) => {
+			const base = i * stride;
+			const pointCount = s.values.length;
+			return {
+				name: cellAddr(SHEET, 0, base + 1),
+				xValues: cellRange(SHEET, 1, base, pointCount),
+				values: cellRange(SHEET, 1, base + 1, pointCount),
+				...isBubble ? { bubbleSizes: cellRange(SHEET, 1, base + 2, pointCount) } : {}
+			};
+		})
+	};
+};
+/** Lays `spec` out as a sheet grid plus the formulas that address it. */
+const layoutChartSheet = (spec) => isXyKind(spec) ? layoutXySheet(spec) : layoutCategorySheet(spec);
+//#endregion
 //#region src/internal/chartml/chart-builder.ts
 const NS_C$1 = NS.chart;
 const NS_A$1 = NS.dml;
@@ -5177,20 +6156,21 @@ const strRef = (formula, points) => {
 	const strCache = elem(c("strCache"), { children: [valNode(c("ptCount"), points.length), ...points.map((p, i) => ptNode(i, p))] });
 	return elem(c("strRef"), { children: [elem(c("f"), { children: [text(formula)] }), strCache] });
 };
-const numRef = (formula, points) => {
-	const numCache = elem(c("numCache"), { children: [
-		elem(c("formatCode"), { children: [text("General")] }),
-		valNode(c("ptCount"), points.length),
-		...points.map((v, i) => v === null ? null : ptNode(i, String(v))).filter((n) => n !== null)
-	] });
-	return elem(c("numRef"), { children: [elem(c("f"), { children: [text(formula)] }), numCache] });
-};
-const solidFillSpPr = (color) => {
-	const srgbClr = elem(a("srgbClr"), { attrs: [attr(qname("", "val", ""), color.replace(/^#/, "").toUpperCase())] });
-	const solidFill = elem(a("solidFill"), { children: [srgbClr] });
-	return elem(c("spPr"), { children: [solidFill] });
-};
-const lineSpPr = (color, widthEmu, field) => {
+const numDataChildren = (points, formatCode) => [
+	elem(c("formatCode"), { children: [text(formatCode)] }),
+	valNode(c("ptCount"), points.length),
+	...points.map((v, i) => v === null ? null : ptNode(i, String(v))).filter((n) => n !== null)
+];
+const numRef = (formula, points, formatCode = "General") => elem(c("numRef"), { children: [elem(c("f"), { children: [text(formula)] }), elem(c("numCache"), { children: numDataChildren(points, formatCode) })] });
+const multiLvlStrRef = (formula, levels, pointCount) => elem(c("multiLvlStrRef"), { children: [elem(c("f"), { children: [text(formula)] }), elem(c("multiLvlStrCache"), { children: [valNode(c("ptCount"), pointCount), ...levels.map((level, depth) => elem(c("lvl"), { children: level.map((label, i) => depth > 0 && label === "" ? null : ptNode(i, label)).filter((n) => n !== null) }))] })] });
+const hexOf = (color) => color.replace(/^#/, "").toUpperCase();
+const solidFill = (color, opacity) => elem(a("solidFill"), { children: [elem(a("srgbClr"), {
+	attrs: [attr(ATTR_VAL$1, hexOf(color))],
+	children: opacity !== void 0 ? [valNode(a("alpha"), boundedInt(opacity * 1e5, "percent100000", "chart series: fillOpacity"))] : []
+})] });
+const solidFillSpPr = (color, opacity) => elem(c("spPr"), { children: [solidFill(color, opacity)] });
+const lineSpPr = (color, widthEmu, field, hidden = false) => {
+	if (hidden) return elem(c("spPr"), { children: [elem(a("ln"), { children: [elem(a("noFill"))] })] });
 	if (color === void 0 && widthEmu === void 0) return null;
 	const ln = elem(a("ln"), {
 		attrs: widthEmu !== void 0 ? [attr(qname("", "w", ""), String(lineWidthEmu(widthEmu, field)))] : [],
@@ -5216,14 +6196,14 @@ const DEFAULT_ACCENT_COLORS = [
 	"5B9BD5",
 	"70AD47"
 ];
-const seriesSpPr = (color, lineColor, lineWidthEmu$1, lineDash) => {
-	const lnChildren = [elem(a("solidFill"), { children: [elem(a("srgbClr"), { attrs: [attr(qname("", "val", ""), lineColor)] })] })];
-	if (lineDash !== void 0) lnChildren.push(elem(a("prstDash"), { attrs: [attr(qname("", "val", ""), lineDash)] }));
+const seriesSpPr = (color, lineColor, lineWidthEmu$1, lineDash, fillOpacity) => {
+	const lnChildren = [lineColor === null ? elem(a("noFill")) : solidFill(lineColor)];
+	if (lineColor !== null && lineDash !== void 0) lnChildren.push(elem(a("prstDash"), { attrs: [attr(qname("", "val", ""), lineDash)] }));
 	const ln = lineWidthEmu$1 !== void 0 ? elem(a("ln"), {
 		attrs: [attr(qname("", "w", ""), String(lineWidthEmu(lineWidthEmu$1, "chart series: lineWidthEmu")))],
 		children: lnChildren
 	}) : elem(a("ln"), { children: lnChildren });
-	return elem(c("spPr"), { children: [elem(a("solidFill"), { children: [elem(a("srgbClr"), { attrs: [attr(qname("", "val", ""), color)] })] }), ln] });
+	return elem(c("spPr"), { children: [solidFill(color, fillOpacity), ln] });
 };
 const markerElement = (symbol, sizePt, color, lineColor) => {
 	const children = [];
@@ -5235,7 +6215,7 @@ const markerElement = (symbol, sizePt, color, lineColor) => {
 	}
 	return elem(c("marker"), { children });
 };
-const dPtElements = (colors, explosions) => {
+const dPtElements = (colors, explosions, fillOpacity, bubble3D) => {
 	const out = [];
 	const colorLen = colors?.length ?? 0;
 	const explLen = explosions?.length ?? 0;
@@ -5244,12 +6224,9 @@ const dPtElements = (colors, explosions) => {
 		const color = colors?.[i] ?? null;
 		const expl = explosions?.[i] ?? null;
 		if (color === null && (expl === null || !Number.isFinite(expl))) continue;
-		const children = [valNode(c("idx"), i), valNode(c("bubble3D"), "0")];
+		const children = [valNode(c("idx"), i), valNode(c("bubble3D"), bubble3D ? "1" : "0")];
 		if (expl !== null) children.push(valNode(c("explosion"), Math.round(expl)));
-		if (color !== null) {
-			const hex = color.replace(/^#/, "").toUpperCase();
-			children.push(solidFillSpPr(hex));
-		}
+		if (color !== null) children.push(solidFillSpPr(color, fillOpacity));
 		out.push(elem(c("dPt"), { children }));
 	}
 	return out;
@@ -5271,39 +6248,121 @@ const trendlineElement = (tl) => {
 	if (tl.displayEquation) children.push(valNode(c("dispEq"), "1"));
 	return elem(c("trendline"), { children });
 };
-const seriesElement = (spec, seriesIdx, sheet) => {
+const errBarsElement = (bars, direction) => {
+	const children = [];
+	if (direction !== null) children.push(valNode(c("errDir"), direction));
+	children.push(valNode(c("errBarType"), bars.barType), valNode(c("errValType"), bars.amount.type));
+	if (bars.noEndCap !== void 0) children.push(valNode(c("noEndCap"), bars.noEndCap ? "1" : "0"));
+	if (bars.amount.type === "cust") {
+		const literal = (name, points) => elem(c(name), { children: [elem(c("numLit"), { children: numDataChildren(points, "General") })] });
+		if (bars.amount.plus !== void 0) children.push(literal("plus", bars.amount.plus));
+		if (bars.amount.minus !== void 0) children.push(literal("minus", bars.amount.minus));
+	} else if (bars.amount.type !== "stdErr") children.push(valNode(c("val"), bars.amount.value));
+	const spPr = lineSpPr(bars.color, bars.lineWidthEmu, "chart series: errorBars.lineWidthEmu");
+	if (spPr !== null) children.push(spPr);
+	return elem(c("errBars"), { children });
+};
+const SERIES_SHAPE = {
+	bar: "bar",
+	column: "bar",
+	line: "line",
+	stock: "line",
+	area: "area",
+	pie: "pie",
+	doughnut: "pie",
+	scatter: "scatter",
+	bubble: "bubble",
+	radar: "radar",
+	surface: "surface"
+};
+const SHAPES_WITH_MARKER = new Set([
+	"line",
+	"scatter",
+	"radar"
+]);
+const SHAPES_WITH_TRENDLINE = new Set([
+	"bar",
+	"line",
+	"area",
+	"scatter",
+	"bubble"
+]);
+const SHAPES_WITH_ERR_BARS = SHAPES_WITH_TRENDLINE;
+const SHAPES_WITH_INVERT = new Set(["bar", "bubble"]);
+const SCATTER_STYLES_WITH_LINE = new Set([
+	"line",
+	"lineMarker",
+	"smooth",
+	"smoothMarker"
+]);
+const SCATTER_STYLES_WITH_MARKER = new Set([
+	"marker",
+	"lineMarker",
+	"smoothMarker"
+]);
+const categoryChannel = (spec, formula) => {
+	if (spec.categoryAxisDate !== void 0) return elem(c("cat"), { children: [numRef(formula, spec.categories.map(dateSerial), spec.categoryAxisNumberFormat ?? "General")] });
+	if (spec.categoryGroupLevels !== void 0 && spec.categoryGroupLevels.length > 0) return elem(c("cat"), { children: [multiLvlStrRef(formula, [spec.categories, ...spec.categoryGroupLevels], spec.categories.length)] });
+	return elem(c("cat"), { children: [strRef(formula, spec.categories)] });
+};
+const padTo = (values, length) => Array.from({ length }, (_, i) => values?.[i] ?? null);
+const seriesElement = (spec, seriesIdx, layout) => {
 	const series = spec.series[seriesIdx];
-	if (!series) throw new Error("seriesElement: out of range");
-	const headerCellFormula = `${sheet}!$${String.fromCharCode(66 + seriesIdx)}$1`;
-	const catRange = `${sheet}!$A$2:$A$${spec.categories.length + 1}`;
-	const valRange = `${sheet}!$${String.fromCharCode(66 + seriesIdx)}$2:$${String.fromCharCode(66 + seriesIdx)}$${spec.categories.length + 1}`;
-	const color = series.color !== void 0 ? series.color.replace(/^#/, "").toUpperCase() : DEFAULT_ACCENT_COLORS[seriesIdx % DEFAULT_ACCENT_COLORS.length] ?? "4472C4";
-	const paddedValues = [];
-	for (let i = 0; i < spec.categories.length; i++) paddedValues.push(i < series.values.length ? series.values[i] ?? null : null);
+	const refs = layout.series[seriesIdx];
+	if (!series || !refs) throw new Error("seriesElement: out of range");
+	const color = series.color !== void 0 ? hexOf(series.color) : DEFAULT_ACCENT_COLORS[seriesIdx % DEFAULT_ACCENT_COLORS.length] ?? "4472C4";
 	const kind = series.chartKind ?? spec.kind;
+	const shape = SERIES_SHAPE[kind];
 	const children = [
 		valNode(c("idx"), seriesIdx),
 		valNode(c("order"), seriesIdx),
-		elem(c("tx"), { children: [strRef(headerCellFormula, [series.name])] })
+		elem(c("tx"), { children: [strRef(refs.name, [series.name])] })
 	];
-	if (kind === "line" || series.lineWidthEmu !== void 0 || series.lineColor !== void 0 || series.lineDash !== void 0) {
-		const lineColor = series.lineColor !== void 0 ? series.lineColor.replace(/^#/, "").toUpperCase() : color;
-		children.push(seriesSpPr(color, lineColor, series.lineWidthEmu, series.lineDash));
-	} else children.push(solidFillSpPr(color));
-	if (series.invertIfNegative === true && (kind === "bar" || kind === "column")) children.push(valNode(c("invertIfNegative"), "1"));
-	if (kind === "line" || kind === "scatter" || kind === "radar") {
-		const markerColor = series.markerColor !== void 0 ? series.markerColor.replace(/^#/, "").toUpperCase() : color;
-		const markerLineColor = series.markerLineColor !== void 0 ? series.markerLineColor.replace(/^#/, "").toUpperCase() : markerColor;
-		children.push(markerElement(series.markerSymbol, series.markerSizePt, markerColor, markerLineColor));
-	}
-	for (const dPt of dPtElements(series.pointColors, series.pointExplosions)) children.push(dPt);
+	const isXy = shape === "scatter" || shape === "bubble";
+	const pointCount = isXy ? series.values.length : spec.categories.length;
+	const channels = [];
+	if (isXy) {
+		if (refs.xValues === void 0) throw new Error("seriesElement: xy series without an x range");
+		channels.push(elem(c("xVal"), { children: [numRef(refs.xValues, padTo(series.xValues, pointCount))] }), elem(c("yVal"), { children: [numRef(refs.values, padTo(series.values, pointCount))] }));
+		if (shape === "bubble") {
+			if (refs.bubbleSizes === void 0) throw new Error("seriesElement: bubble series without a size range");
+			channels.push(elem(c("bubbleSize"), { children: [numRef(refs.bubbleSizes, padTo(series.bubbleSizes, pointCount))] }), valNode(c("bubble3D"), spec.bubble3D === true ? "1" : "0"));
+		}
+	} else {
+		if (layout.categories === void 0) throw new Error("seriesElement: category series without a category range");
+		channels.push(categoryChannel(spec, layout.categories), elem(c("val"), { children: [numRef(refs.values, padTo(series.values, pointCount))] }));
+	}
+	if (shape === "surface") return elem(c("ser"), { children: [...children, ...channels] });
+	const scatterStyle = spec.scatterStyle ?? "marker";
+	const lineHidden = spec.kind === "stock" || shape === "scatter" && !SCATTER_STYLES_WITH_LINE.has(scatterStyle);
+	if (lineHidden || shape === "line" || shape === "scatter" || shape === "radar" || series.lineWidthEmu !== void 0 || series.lineColor !== void 0 || series.lineDash !== void 0) {
+		const lineColor = lineHidden ? null : series.lineColor !== void 0 ? hexOf(series.lineColor) : color;
+		children.push(seriesSpPr(color, lineColor, series.lineWidthEmu, series.lineDash, series.fillOpacity));
+	} else children.push(solidFillSpPr(color, series.fillOpacity));
+	if (series.invertIfNegative === true && SHAPES_WITH_INVERT.has(shape)) children.push(valNode(c("invertIfNegative"), "1"));
+	if (SHAPES_WITH_MARKER.has(shape)) {
+		const markerColor = series.markerColor !== void 0 ? hexOf(series.markerColor) : color;
+		const markerLineColor = series.markerLineColor !== void 0 ? hexOf(series.markerLineColor) : markerColor;
+		const markersOff = spec.kind === "stock" || shape === "scatter" && !SCATTER_STYLES_WITH_MARKER.has(scatterStyle) || shape === "radar" && spec.radarStyle !== "marker";
+		children.push(markerElement(series.markerSymbol ?? (markersOff ? "none" : void 0), series.markerSizePt, markerColor, markerLineColor));
+	}
+	for (const dPt of dPtElements(series.pointColors, series.pointExplosions, series.fillOpacity, spec.bubble3D === true)) children.push(dPt);
 	if (series.pointDataLabels !== void 0 && series.dataLabels === void 0) throw new Error(`chart: series '${series.name}' sets pointDataLabels without dataLabels; add the series-level dataLabels the overrides fall back to`);
 	const serDLbls = buildDLblsFromLabels(series.dataLabels, series.pointDataLabels);
 	if (serDLbls !== null) children.push(serDLbls);
-	if (series.trendline && kind !== "pie" && kind !== "doughnut" && kind !== "radar") children.push(trendlineElement(series.trendline));
-	children.push(elem(c("cat"), { children: [strRef(catRange, spec.categories)] }));
-	children.push(elem(c("val"), { children: [numRef(valRange, paddedValues)] }));
-	if (kind === "line") children.push(valNode(c("smooth"), series.smooth === true ? "1" : "0"));
+	if (series.trendline && SHAPES_WITH_TRENDLINE.has(shape) && spec.kind !== "stock") children.push(trendlineElement(series.trendline));
+	if (series.errorBars !== void 0 || series.xErrorBars !== void 0) {
+		if (!SHAPES_WITH_ERR_BARS.has(shape)) throw new Error(`chart: series '${series.name}' sets error bars, which a ${kind} series cannot carry (bar / column / line / area / scatter / bubble only)`);
+		if (series.xErrorBars !== void 0 && !isXy) throw new Error(`chart: series '${series.name}' sets xErrorBars, which only scatter / bubble series have an x channel for`);
+		if (series.xErrorBars !== void 0) children.push(errBarsElement(series.xErrorBars, "x"));
+		if (series.errorBars !== void 0) children.push(errBarsElement(series.errorBars, isXy ? "y" : null));
+	}
+	children.push(...channels);
+	if (shape === "line") children.push(valNode(c("smooth"), series.smooth === true ? "1" : "0"));
+	else if (shape === "scatter") {
+		const smooth = series.smooth ?? (scatterStyle === "smooth" || scatterStyle === "smoothMarker");
+		children.push(valNode(c("smooth"), smooth ? "1" : "0"));
+	}
 	return elem(c("ser"), { children });
 };
 const CAT_AX_ID = 111111111;
@@ -5369,9 +6428,13 @@ const axisTxPrElement = (style, rotationDeg) => {
 };
 const catAxis = (spec) => {
 	const catOrientation = spec.categoryAxisOrientation ?? "minMax";
+	const dateAxis = spec.categoryAxisDate;
+	const scalingChildren = [valNode(c("orientation"), catOrientation)];
+	if (spec.categoryAxisScaling?.max !== void 0) scalingChildren.push(valNode(c("max"), spec.categoryAxisScaling.max));
+	if (spec.categoryAxisScaling?.min !== void 0) scalingChildren.push(valNode(c("min"), spec.categoryAxisScaling.min));
 	const children = [
 		valNode(c("axId"), CAT_AX_ID),
-		elem(c("scaling"), { children: [valNode(c("orientation"), catOrientation)] }),
+		elem(c("scaling"), { children: scalingChildren }),
 		valNode(c("delete"), spec.categoryAxisHidden ? "1" : "0"),
 		valNode(c("axPos"), isHorizontalBar(spec) ? "l" : "b")
 	];
@@ -5382,11 +6445,21 @@ const catAxis = (spec) => {
 	if (spec.categoryAxisMajorTickMark !== void 0) children.push(valNode(c("majorTickMark"), spec.categoryAxisMajorTickMark));
 	if (spec.categoryAxisMinorTickMark !== void 0) children.push(valNode(c("minorTickMark"), spec.categoryAxisMinorTickMark));
 	if (spec.categoryAxisTickLabelPos !== void 0) children.push(valNode(c("tickLblPos"), spec.categoryAxisTickLabelPos));
-	const catLine = lineSpPr(spec.categoryAxisLineColor, spec.categoryAxisLineWidthEmu, "chart: categoryAxisLineWidthEmu");
+	const catLine = lineSpPr(spec.categoryAxisLineColor, spec.categoryAxisLineWidthEmu, "chart: categoryAxisLineWidthEmu", spec.categoryAxisLineHidden === true);
 	if (catLine !== null) children.push(catLine);
 	const catTxPr = axisTxPrElement(spec.categoryAxisLabelStyle, spec.categoryAxisLabelRotationDeg);
 	if (catTxPr) children.push(catTxPr);
 	children.push(valNode(c("crossAx"), VAL_AX_ID));
+	if (dateAxis !== void 0) {
+		children.push(valNode(c("auto"), "0"));
+		if (spec.categoryAxisLabelOffset !== void 0) children.push(valNode(c("lblOffset"), spec.categoryAxisLabelOffset));
+		if (dateAxis.baseTimeUnit !== void 0) children.push(valNode(c("baseTimeUnit"), dateAxis.baseTimeUnit));
+		if (dateAxis.majorUnit !== void 0) children.push(valNode(c("majorUnit"), dateAxis.majorUnit));
+		if (dateAxis.majorTimeUnit !== void 0) children.push(valNode(c("majorTimeUnit"), dateAxis.majorTimeUnit));
+		if (dateAxis.minorUnit !== void 0) children.push(valNode(c("minorUnit"), dateAxis.minorUnit));
+		if (dateAxis.minorTimeUnit !== void 0) children.push(valNode(c("minorTimeUnit"), dateAxis.minorTimeUnit));
+		return elem(c("dateAx"), { children });
+	}
 	if (spec.categoryAxisLabelAlign !== void 0) children.push(valNode(c("lblAlgn"), spec.categoryAxisLabelAlign));
 	if (spec.categoryAxisLabelOffset !== void 0) children.push(valNode(c("lblOffset"), spec.categoryAxisLabelOffset));
 	if (spec.categoryAxisTickLabelSkip !== void 0) children.push(valNode(c("tickLblSkip"), spec.categoryAxisTickLabelSkip));
@@ -5413,7 +6486,7 @@ const valueAxisElement = (f, ids) => {
 	if (f.majorTickMark !== void 0) children.push(valNode(c("majorTickMark"), f.majorTickMark));
 	if (f.minorTickMark !== void 0) children.push(valNode(c("minorTickMark"), f.minorTickMark));
 	if (f.tickLabelPos !== void 0) children.push(valNode(c("tickLblPos"), f.tickLabelPos));
-	const axisLine = lineSpPr(f.lineColor, f.lineWidthEmu, `chart: ${f.widthFields.line}`);
+	const axisLine = lineSpPr(f.lineColor, f.lineWidthEmu, `chart: ${f.widthFields.line}`, f.lineHidden === true);
 	if (axisLine !== null) children.push(axisLine);
 	const valTxPr = axisTxPrElement(f.labelStyle, f.labelRotationDeg);
 	if (valTxPr) children.push(valTxPr);
@@ -5424,7 +6497,7 @@ const valueAxisElement = (f, ids) => {
 	if (f.crossBetween !== void 0) children.push(valNode(c("crossBetween"), f.crossBetween));
 	if (f.scaling?.majorUnit !== void 0) children.push(valNode(c("majorUnit"), f.scaling.majorUnit));
 	if (f.scaling?.minorUnit !== void 0) children.push(valNode(c("minorUnit"), f.scaling.minorUnit));
-	if (f.scaling?.displayUnits !== void 0) children.push(elem(c("dispUnits"), { children: [valNode(c("builtInUnit"), f.scaling.displayUnits)] }));
+	if (f.scaling?.displayUnits !== void 0) children.push(elem(c("dispUnits"), { children: [valNode(c("builtInUnit"), f.scaling.displayUnits), ...f.scaling.displayUnitsLabel === true ? [elem(c("dispUnitsLbl"))] : []] }));
 	return elem(c("valAx"), { children });
 };
 const isHorizontalBar = (spec) => spec.kind === "bar";
@@ -5446,6 +6519,7 @@ const valAxis = (spec) => valueAxisElement({
 	tickLabelPos: spec.valueAxisTickLabelPos,
 	lineColor: spec.valueAxisLineColor,
 	lineWidthEmu: spec.valueAxisLineWidthEmu,
+	lineHidden: spec.valueAxisLineHidden,
 	widthFields: {
 		majorGridline: "valueAxisMajorGridlineWidthEmu",
 		minorGridline: "valueAxisMinorGridlineWidthEmu",
@@ -5460,11 +6534,78 @@ const valAxis = (spec) => valueAxisElement({
 	crossAxId: CAT_AX_ID,
 	axPos: isHorizontalBar(spec) ? "b" : "l"
 });
+/**
+* The horizontal axis of a scatter / bubble chart. Both of their axes are
+* `<c:valAx>`; this one takes the spec's `categoryAxis*` fields, so an
+* author formats "the axis along the bottom" the same way for every kind.
+* It keeps the category axis' id, which the y axis already crosses.
+*/
+const xValAxis = (spec) => valueAxisElement({
+	scaling: {
+		...spec.categoryAxisScaling,
+		...spec.categoryAxisNumberFormat !== void 0 ? { numberFormat: spec.categoryAxisNumberFormat } : {}
+	},
+	orientation: spec.categoryAxisOrientation,
+	hidden: spec.categoryAxisHidden,
+	majorGridlines: spec.categoryAxisMajorGridlines,
+	majorGridlineColor: spec.categoryAxisMajorGridlineColor,
+	majorGridlineWidthEmu: spec.categoryAxisMajorGridlineWidthEmu,
+	minorGridlines: spec.categoryAxisMinorGridlines,
+	minorGridlineColor: spec.categoryAxisMinorGridlineColor,
+	minorGridlineWidthEmu: spec.categoryAxisMinorGridlineWidthEmu,
+	title: spec.categoryAxisTitle,
+	titleStyle: spec.categoryAxisTitleStyle,
+	titleRotationDeg: spec.categoryAxisTitleRotationDeg,
+	majorTickMark: spec.categoryAxisMajorTickMark,
+	minorTickMark: spec.categoryAxisMinorTickMark,
+	tickLabelPos: spec.categoryAxisTickLabelPos,
+	lineColor: spec.categoryAxisLineColor,
+	lineWidthEmu: spec.categoryAxisLineWidthEmu,
+	lineHidden: spec.categoryAxisLineHidden,
+	widthFields: {
+		majorGridline: "categoryAxisMajorGridlineWidthEmu",
+		minorGridline: "categoryAxisMinorGridlineWidthEmu",
+		line: "categoryAxisLineWidthEmu"
+	},
+	labelStyle: spec.categoryAxisLabelStyle,
+	labelRotationDeg: spec.categoryAxisLabelRotationDeg,
+	crosses: void 0,
+	crossBetween: "midCat"
+}, {
+	axId: CAT_AX_ID,
+	crossAxId: VAL_AX_ID,
+	axPos: "b"
+});
+const SER_AX_ID = 555555555;
+/** `<c:serAx>` — the depth axis of a 3-D or surface chart; it crosses the value axis. */
+const serAxis = (spec) => {
+	const s = spec.seriesAxis ?? {};
+	const children = [
+		valNode(c("axId"), SER_AX_ID),
+		elem(c("scaling"), { children: [valNode(c("orientation"), s.orientation ?? "minMax")] }),
+		valNode(c("delete"), s.hidden ? "1" : "0"),
+		valNode(c("axPos"), "b")
+	];
+	if (s.majorGridlines) children.push(elem(c("majorGridlines")));
+	if (s.title !== void 0) children.push(titleElement(s.title, s.titleStyle));
+	if (s.tickLabelPos !== void 0) children.push(valNode(c("tickLblPos"), s.tickLabelPos));
+	const line = lineSpPr(s.lineColor, void 0, "chart: seriesAxis");
+	if (line !== null) children.push(line);
+	const txPr = axisTxPrElement(s.labelStyle, void 0);
+	if (txPr !== null) children.push(txPr);
+	children.push(valNode(c("crossAx"), VAL_AX_ID));
+	if (s.tickLabelSkip !== void 0) children.push(valNode(c("tickLblSkip"), s.tickLabelSkip));
+	return elem(c("serAx"), { children });
+};
 const buildDLblsFromLabels = (dl, pointLabels = void 0) => {
 	const children = [];
 	pointLabels?.forEach((pl, i) => {
 		if (pl === null) return;
-		children.push(elem(c("dLbl"), { children: [valNode(c("idx"), i), ...dLblGroupChildren(pl)] }));
+		children.push(elem(c("dLbl"), { children: [
+			valNode(c("idx"), i),
+			...pl.text !== void 0 ? [elem(c("tx"), { children: [richText(pl.text)] })] : [],
+			...dLblGroupChildren(pl)
+		] }));
 	});
 	if (dl) {
 		children.push(...dLblGroupChildren(dl));
@@ -5475,93 +6616,220 @@ const buildDLblsFromLabels = (dl, pointLabels = void 0) => {
 const dLblGroupChildren = (dl) => {
 	const children = [];
 	if (dl.numberFormat !== void 0) children.push(elem(c("numFmt"), { attrs: [attr(qname("", "formatCode", ""), dl.numberFormat), attr(qname("", "sourceLinked", ""), "0")] }));
+	if (dl.fillColor !== void 0) children.push(solidFillSpPr(dl.fillColor));
 	if (dl.textStyle !== void 0) {
 		const txPr = axisTxPrElement(dl.textStyle, void 0);
 		if (txPr !== null) children.push(txPr);
 	}
 	if (dl.position !== void 0) children.push(valNode(c("dLblPos"), dl.position));
-	children.push(valNode(c("showLegendKey"), "0"), valNode(c("showVal"), dl.showValue ? "1" : "0"), valNode(c("showCatName"), dl.showCategory ? "1" : "0"), valNode(c("showSerName"), dl.showSeriesName ? "1" : "0"), valNode(c("showPercent"), dl.showPercent ? "1" : "0"), valNode(c("showBubbleSize"), "0"));
+	children.push(valNode(c("showLegendKey"), dl.showLegendKey ? "1" : "0"), valNode(c("showVal"), dl.showValue ? "1" : "0"), valNode(c("showCatName"), dl.showCategory ? "1" : "0"), valNode(c("showSerName"), dl.showSeriesName ? "1" : "0"), valNode(c("showPercent"), dl.showPercent ? "1" : "0"), valNode(c("showBubbleSize"), dl.showBubbleSize ? "1" : "0"));
 	if (dl.separator !== void 0) children.push(elem(c("separator"), { children: [text(dl.separator)] }));
 	return children;
 };
 const dLblsElement = (spec) => buildDLblsFromLabels(spec.dataLabels);
-const buildBarChart = (spec, sheet, direction, seriesIndices, axes) => {
-	const ser = seriesIndices.map((i) => seriesElement(spec, i, sheet));
-	const dl = dLblsElement(spec);
+const groupSeries = (g) => g.seriesIndices.map((i) => seriesElement(g.spec, i, g.layout));
+const groupDLbls = (g) => {
+	const dl = dLblsElement(g.spec);
+	return dl ? [dl] : [];
+};
+const isThreeD = (spec) => spec.view3D !== void 0;
+/**
+* Whether the chart carries a series (depth) axis. `<c:line3DChart>` and
+* the surface elements require three axes; 3-D bar / area charts only lay
+* their series out in depth — and so only have the axis — under the
+* `standard` grouping.
+*/
+const hasSeriesAxis = (spec) => {
+	if (spec.kind === "surface") return true;
+	if (!isThreeD(spec)) return false;
+	if (spec.kind === "line") return true;
+	return (spec.kind === "bar" || spec.kind === "column" || spec.kind === "area") && spec.grouping === "standard";
+};
+const axIdNodes = (g) => [
+	valNode(c("axId"), g.axes.cat),
+	valNode(c("axId"), g.axes.val),
+	...hasSeriesAxis(g.spec) ? [valNode(c("axId"), SER_AX_ID)] : []
+];
+const gapDepthNodes = (spec) => spec.gapDepthPct !== void 0 ? [valNode(c("gapDepth"), gapAmountPercent(spec.gapDepthPct, "chart: gapDepthPct"))] : [];
+const buildBarChart = (g, direction) => {
+	const { spec } = g;
 	const grouping = spec.grouping ?? "clustered";
 	const children = [
 		valNode(c("barDir"), direction),
 		valNode(c("grouping"), grouping),
 		valNode(c("varyColors"), spec.varyColors ? "1" : "0"),
-		...ser,
-		...dl ? [dl] : []
+		...groupSeries(g),
+		...groupDLbls(g)
 	];
 	if (spec.gapWidthPct !== void 0) children.push(valNode(c("gapWidth"), gapAmountPercent(spec.gapWidthPct, "chart: gapWidthPct")));
+	if (isThreeD(spec)) {
+		children.push(...gapDepthNodes(spec));
+		if (spec.bar3DShape !== void 0) children.push(valNode(c("shape"), spec.bar3DShape));
+		children.push(...axIdNodes(g));
+		return elem(c("bar3DChart"), { children });
+	}
 	const overlapPct = spec.overlapPct ?? (grouping === "stacked" || grouping === "percentStacked" ? 100 : void 0);
 	if (overlapPct !== void 0) children.push(valNode(c("overlap"), overlapPercent(overlapPct, "chart: overlapPct")));
-	children.push(valNode(c("axId"), axes.cat), valNode(c("axId"), axes.val));
-	return elem(c(direction === "col" ? "barChart" : "barChart"), { children });
+	children.push(...axIdNodes(g));
+	return elem(c("barChart"), { children });
 };
 const lineAreaGrouping = (spec) => spec.grouping === "stacked" || spec.grouping === "percentStacked" ? spec.grouping : "standard";
-const buildLineChart = (spec, sheet, seriesIndices, axes) => {
-	const ser = seriesIndices.map((i) => seriesElement(spec, i, sheet));
-	const dl = dLblsElement(spec);
+const upDownBarsElement = (bars) => {
+	const bar = (name, color) => elem(c(name), { children: color !== void 0 ? [solidFillSpPr(color)] : [] });
+	return elem(c("upDownBars"), { children: [
+		...bars.gapWidthPct !== void 0 ? [valNode(c("gapWidth"), gapAmountPercent(bars.gapWidthPct, "chart: upDownBars.gapWidthPct"))] : [],
+		bar("upBars", bars.upColor),
+		bar("downBars", bars.downColor)
+	] });
+};
+const buildLineChart = (g) => {
+	const { spec } = g;
 	const children = [
 		valNode(c("grouping"), lineAreaGrouping(spec)),
 		valNode(c("varyColors"), spec.varyColors ? "1" : "0"),
-		...ser,
-		...dl ? [dl] : []
+		...groupSeries(g),
+		...groupDLbls(g)
 	];
 	if (spec.dropLines) children.push(elem(c("dropLines")));
+	if (isThreeD(spec)) {
+		if (spec.hiLowLines || spec.upDownBars !== void 0) throw new Error("chart: hiLowLines / upDownBars are not available on a 3-D line chart");
+		children.push(...gapDepthNodes(spec), ...axIdNodes(g));
+		return elem(c("line3DChart"), { children });
+	}
 	if (spec.hiLowLines) children.push(elem(c("hiLowLines")));
-	children.push(valNode(c("marker"), spec.lineMarkers === false ? "0" : "1"), valNode(c("axId"), axes.cat), valNode(c("axId"), axes.val));
+	if (spec.upDownBars !== void 0) children.push(upDownBarsElement(spec.upDownBars));
+	children.push(valNode(c("marker"), spec.lineMarkers === false ? "0" : "1"), ...axIdNodes(g));
 	return elem(c("lineChart"), { children });
 };
-const buildPieChart = (spec, sheet) => {
-	if (spec.series.length !== 1) throw new Error("pie chart requires exactly one series");
-	const ser = seriesElement(spec, 0, sheet);
-	const dl = dLblsElement(spec);
+const buildAreaChart = (g) => {
+	const { spec } = g;
 	const children = [
-		valNode(c("varyColors"), "1"),
-		ser,
-		...dl ? [dl] : []
+		valNode(c("grouping"), lineAreaGrouping(spec)),
+		valNode(c("varyColors"), spec.varyColors ? "1" : "0"),
+		...groupSeries(g),
+		...groupDLbls(g)
 	];
-	if (spec.firstSliceAngleDeg !== void 0) children.push(valNode(c("firstSliceAng"), firstSliceAngle(spec.firstSliceAngleDeg, "chart: firstSliceAngleDeg")));
-	return elem(c("pieChart"), { children });
+	if (spec.dropLines && spec.kind === "area") children.push(elem(c("dropLines")));
+	if (isThreeD(spec)) {
+		children.push(...gapDepthNodes(spec), ...axIdNodes(g));
+		return elem(c("area3DChart"), { children });
+	}
+	children.push(...axIdNodes(g));
+	return elem(c("areaChart"), { children });
 };
-const buildDoughnutChart = (spec, sheet) => {
-	if (spec.series.length !== 1) throw new Error("doughnut chart requires exactly one series");
-	const ser = seriesElement(spec, 0, sheet);
-	const dl = dLblsElement(spec);
+const requireSingleSeries = (spec) => {
+	if (spec.series.length !== 1) throw new Error(`${spec.kind} chart requires exactly one series`);
+};
+const firstSliceAngNodes = (spec) => spec.firstSliceAngleDeg !== void 0 ? [valNode(c("firstSliceAng"), firstSliceAngle(spec.firstSliceAngleDeg, "chart: firstSliceAngleDeg"))] : [];
+const buildOfPieChart = (g, ofPie) => {
 	const children = [
+		valNode(c("ofPieType"), ofPie.type),
 		valNode(c("varyColors"), "1"),
-		ser,
-		...dl ? [dl] : []
+		...groupSeries(g),
+		...groupDLbls(g)
 	];
-	if (spec.firstSliceAngleDeg !== void 0) children.push(valNode(c("firstSliceAng"), firstSliceAngle(spec.firstSliceAngleDeg, "chart: firstSliceAngleDeg")));
-	children.push(valNode(c("holeSize"), holeSizePercent(spec.holeSizePct ?? 50, "chart: holeSizePct")));
-	return elem(c("doughnutChart"), { children });
-};
-const buildAreaChart = (spec, sheet, seriesIndices, axes) => {
-	const ser = seriesIndices.map((i) => seriesElement(spec, i, sheet));
-	const dl = dLblsElement(spec);
-	return elem(c("areaChart"), { children: [
-		valNode(c("grouping"), lineAreaGrouping(spec)),
-		valNode(c("varyColors"), spec.varyColors ? "1" : "0"),
-		...ser,
-		...dl ? [dl] : [],
-		valNode(c("axId"), axes.cat),
-		valNode(c("axId"), axes.val)
+	if (ofPie.gapWidthPct !== void 0) children.push(valNode(c("gapWidth"), gapAmountPercent(ofPie.gapWidthPct, "chart: ofPie.gapWidthPct")));
+	if (ofPie.customSplit !== void 0 && ofPie.splitType !== "cust") throw new Error("chart: ofPie.customSplit requires ofPie.splitType 'cust'");
+	if (ofPie.splitType !== void 0) children.push(valNode(c("splitType"), ofPie.splitType));
+	if (ofPie.splitPos !== void 0) children.push(valNode(c("splitPos"), ofPie.splitPos));
+	if (ofPie.customSplit !== void 0) children.push(elem(c("custSplit"), { children: ofPie.customSplit.map((idx) => valNode(c("secondPiePt"), idx)) }));
+	if (ofPie.secondPieSizePct !== void 0) children.push(valNode(c("secondPieSize"), boundedInt(ofPie.secondPieSizePct, "secondPieSize", "chart: ofPie.secondPieSizePct")));
+	if (ofPie.seriesLines) children.push(elem(c("serLines")));
+	return elem(c("ofPieChart"), { children });
+};
+const buildPieChart = (g) => {
+	const { spec } = g;
+	requireSingleSeries(spec);
+	if (spec.ofPie !== void 0) {
+		if (isThreeD(spec)) throw new Error("chart: ofPie and view3D cannot be combined");
+		return buildOfPieChart(g, spec.ofPie);
+	}
+	const children = [
+		valNode(c("varyColors"), "1"),
+		...groupSeries(g),
+		...groupDLbls(g)
+	];
+	if (isThreeD(spec)) {
+		if (spec.firstSliceAngleDeg !== void 0) throw new Error("chart: a 3-D pie has no firstSliceAngleDeg; rotate it with view3D.rotY");
+		return elem(c("pie3DChart"), { children });
+	}
+	children.push(...firstSliceAngNodes(spec));
+	return elem(c("pieChart"), { children });
+};
+const buildDoughnutChart = (g) => {
+	const { spec } = g;
+	requireSingleSeries(spec);
+	return elem(c("doughnutChart"), { children: [
+		valNode(c("varyColors"), "1"),
+		...groupSeries(g),
+		...groupDLbls(g),
+		...firstSliceAngNodes(spec),
+		valNode(c("holeSize"), holeSizePercent(spec.holeSizePct ?? 50, "chart: holeSizePct"))
 	] });
 };
-/** One combo plot group, dispatched by its effective kind. */
-const buildComboGroupChart = (spec, sheet, kind, seriesIndices, axes) => {
+const buildScatterChart = (g) => elem(c("scatterChart"), { children: [
+	valNode(c("scatterStyle"), g.spec.scatterStyle ?? "marker"),
+	valNode(c("varyColors"), g.spec.varyColors ? "1" : "0"),
+	...groupSeries(g),
+	...groupDLbls(g),
+	...axIdNodes(g)
+] });
+const buildBubbleChart = (g) => {
+	const { spec } = g;
+	const children = [
+		valNode(c("varyColors"), spec.varyColors ? "1" : "0"),
+		...groupSeries(g),
+		...groupDLbls(g)
+	];
+	if (spec.bubbleScale !== void 0) children.push(valNode(c("bubbleScale"), boundedInt(spec.bubbleScale, "bubbleScale", "chart: bubbleScale")));
+	if (spec.showNegativeBubbles !== void 0) children.push(valNode(c("showNegBubbles"), spec.showNegativeBubbles ? "1" : "0"));
+	if (spec.bubbleSizeRepresents !== void 0) children.push(valNode(c("sizeRepresents"), spec.bubbleSizeRepresents === "width" ? "w" : "area"));
+	children.push(...axIdNodes(g));
+	return elem(c("bubbleChart"), { children });
+};
+const buildRadarChart = (g) => elem(c("radarChart"), { children: [
+	valNode(c("radarStyle"), g.spec.radarStyle ?? "standard"),
+	valNode(c("varyColors"), g.spec.varyColors ? "1" : "0"),
+	...groupSeries(g),
+	...groupDLbls(g),
+	...axIdNodes(g)
+] });
+const STOCK_SERIES_WITH_OPEN = 4;
+const STOCK_SERIES_WITHOUT_OPEN = 3;
+const buildStockChart = (g) => {
+	const { spec } = g;
+	const count = spec.series.length;
+	if (count !== STOCK_SERIES_WITHOUT_OPEN && count !== STOCK_SERIES_WITH_OPEN) throw new Error(`stock chart requires 3 series (high, low, close) or 4 (open, high, low, close); got ${count}`);
+	const children = [...groupSeries(g), ...groupDLbls(g)];
+	if (spec.dropLines) children.push(elem(c("dropLines")));
+	if (spec.hiLowLines !== false) children.push(elem(c("hiLowLines")));
+	if (spec.upDownBars !== void 0 && count !== STOCK_SERIES_WITH_OPEN) throw new Error("stock chart: upDownBars require the 4-series form (open, high, low, close)");
+	if (count === STOCK_SERIES_WITH_OPEN) children.push(upDownBarsElement(spec.upDownBars ?? {}));
+	children.push(...axIdNodes(g));
+	return elem(c("stockChart"), { children });
+};
+const buildSurfaceChart = (g) => {
+	const { spec } = g;
+	const children = [];
+	if (spec.surfaceWireframe !== void 0) children.push(valNode(c("wireframe"), spec.surfaceWireframe ? "1" : "0"));
+	children.push(...groupSeries(g), ...axIdNodes(g));
+	return elem(c(spec.surfaceContour === true ? "surfaceChart" : "surface3DChart"), { children });
+};
+/** One plot group, dispatched by its effective kind. */
+const buildPlotGroup = (g, kind) => {
 	switch (kind) {
-		case "column": return buildBarChart(spec, sheet, "col", seriesIndices, axes);
-		case "bar": return buildBarChart(spec, sheet, "bar", seriesIndices, axes);
-		case "line": return buildLineChart(spec, sheet, seriesIndices, axes);
-		case "area": return buildAreaChart(spec, sheet, seriesIndices, axes);
-		default: throw new Error(`combo chart: series chartKind '${kind}' is not authorable`);
+		case "column": return buildBarChart(g, "col");
+		case "bar": return buildBarChart(g, "bar");
+		case "line": return buildLineChart(g);
+		case "area": return buildAreaChart(g);
+		case "pie": return buildPieChart(g);
+		case "doughnut": return buildDoughnutChart(g);
+		case "scatter": return buildScatterChart(g);
+		case "bubble": return buildBubbleChart(g);
+		case "radar": return buildRadarChart(g);
+		case "stock": return buildStockChart(g);
+		case "surface": return buildSurfaceChart(g);
+		default: throw new Error(`unsupported chart kind: ${String(kind)}`);
 	}
 };
 /**
@@ -5590,6 +6858,7 @@ const secondaryValAxis = (spec) => {
 		tickLabelPos: s.tickLabelPos,
 		lineColor: s.lineColor,
 		lineWidthEmu: s.lineWidthEmu,
+		lineHidden: void 0,
 		widthFields: {
 			majorGridline: "secondaryValueAxis.majorGridlineWidthEmu",
 			minorGridline: "secondaryValueAxis.minorGridlineWidthEmu",
@@ -5640,7 +6909,20 @@ const rPrAttrsFromStyle = (style) => {
 		children
 	};
 };
-const titleElement = (title, style, rotationDeg) => {
+const manualLayoutElement = (position, size, target) => elem(c("layout"), { children: [elem(c("manualLayout"), { children: [
+	...target !== void 0 ? [valNode(c("layoutTarget"), target)] : [],
+	valNode(c("xMode"), "edge"),
+	valNode(c("yMode"), "edge"),
+	valNode(c("x"), position.x),
+	valNode(c("y"), position.y),
+	...size !== void 0 ? [valNode(c("w"), size.w), valNode(c("h"), size.h)] : []
+] })] });
+const richText = (value) => elem(c("rich"), { children: [
+	elem(a("bodyPr")),
+	elem(a("lstStyle")),
+	elem(a("p"), { children: [elem(a("r"), { children: [elem(a("t"), { children: [text(value)] })] })] })
+] });
+const titleElement = (title, style, rotationDeg, placement) => {
 	const pPr = elem(a("pPr"), { children: [elem(a("defRPr"))] });
 	const { attrs: runAttrs, children: runChildren } = rPrAttrsFromStyle(style);
 	const runRPr = elem(a("rPr"), {
@@ -5662,7 +6944,95 @@ const titleElement = (title, style, rotationDeg) => {
 		elem(a("lstStyle")),
 		para
 	] });
-	return elem(c("title"), { children: [elem(c("tx"), { children: [rich] }), valNode(c("overlay"), "0")] });
+	return elem(c("title"), { children: [
+		elem(c("tx"), { children: [rich] }),
+		...placement?.layout !== void 0 ? [manualLayoutElement(placement.layout)] : [],
+		valNode(c("overlay"), placement?.overlay === true ? "1" : "0")
+	] });
+};
+const view3DDefaults = (spec) => {
+	if (spec.kind === "surface" && spec.surfaceContour === true) return {
+		rotX: 90,
+		rotY: 0,
+		rightAngleAxes: false,
+		perspective: 0
+	};
+	if (spec.kind === "pie") return {
+		rotX: 30,
+		rotY: 0,
+		rightAngleAxes: false
+	};
+	if (spec.kind === "surface") return {
+		rotX: 15,
+		rotY: 20,
+		rightAngleAxes: false,
+		perspective: 30
+	};
+	return {
+		rotX: 15,
+		rotY: 20,
+		rightAngleAxes: true
+	};
+};
+const view3DElement = (spec) => {
+	const v = {
+		...view3DDefaults(spec),
+		...spec.view3D
+	};
+	const children = [];
+	if (v.rotX !== void 0) children.push(valNode(c("rotX"), boundedInt(v.rotX, "rotX", "chart: view3D.rotX")));
+	if (v.heightPercent !== void 0) children.push(valNode(c("hPercent"), boundedInt(v.heightPercent, "heightPercent", "chart: view3D.heightPercent")));
+	if (v.rotY !== void 0) children.push(valNode(c("rotY"), boundedInt(v.rotY, "rotY", "chart: view3D.rotY")));
+	if (v.depthPercent !== void 0) children.push(valNode(c("depthPercent"), boundedInt(v.depthPercent, "depthPercent", "chart: view3D.depthPercent")));
+	if (v.rightAngleAxes !== void 0) children.push(valNode(c("rAngAx"), v.rightAngleAxes ? "1" : "0"));
+	if (v.perspective !== void 0) children.push(valNode(c("perspective"), boundedInt(v.perspective, "perspective", "chart: view3D.perspective")));
+	return elem(c("view3D"), { children });
+};
+const KINDS_WITH_VIEW_3D = new Set([
+	"bar",
+	"column",
+	"line",
+	"area",
+	"pie",
+	"surface"
+]);
+const AXISLESS_KINDS = new Set(["pie", "doughnut"]);
+const XY_KINDS = new Set(["scatter", "bubble"]);
+const validateSpec = (spec, usesComboFields) => {
+	if (usesComboFields && !COMBO_KINDS.has(spec.kind)) throw new Error(`chart kind '${spec.kind}' does not support per-series chartKind / secondaryAxis (combo charts require a bar / column / line / area base kind)`);
+	if (spec.view3D !== void 0) {
+		if (!KINDS_WITH_VIEW_3D.has(spec.kind)) throw new Error(`chart kind '${spec.kind}' has no 3-D variant; view3D applies to bar / column / line / area / pie / surface`);
+		if (usesComboFields) throw new Error("chart: view3D cannot be combined with a combo chart");
+	}
+	if ((spec.bar3DShape !== void 0 || spec.gapDepthPct !== void 0) && spec.view3D === void 0) throw new Error("chart: bar3DShape / gapDepthPct require view3D");
+	if (spec.ofPie !== void 0 && spec.kind !== "pie") throw new Error(`chart: ofPie applies to kind 'pie', not '${spec.kind}'`);
+	if (spec.dataTable !== void 0 && (AXISLESS_KINDS.has(spec.kind) || XY_KINDS.has(spec.kind))) throw new Error(`chart kind '${spec.kind}' cannot show a data table`);
+	if (spec.categoryAxisDate !== void 0) {
+		if (AXISLESS_KINDS.has(spec.kind) || XY_KINDS.has(spec.kind)) throw new Error(`chart kind '${spec.kind}' has no category axis to make a date axis of`);
+		if (spec.categoryGroupLevels !== void 0) throw new Error("chart: a date axis cannot have categoryGroupLevels");
+		spec.categories.forEach((category, i) => {
+			if (category.trim() === "" || !Number.isFinite(Number(category))) throw new Error(`chart: categories[${i}] is ${JSON.stringify(category)}; a date axis needs date serial numbers (e.g. "45292" for 2024-01-01)`);
+		});
+	}
+	if (spec.categoryAxisScaling !== void 0 && spec.categoryAxisDate === void 0 && !XY_KINDS.has(spec.kind)) throw new Error("chart: categoryAxisScaling needs a numeric horizontal axis — a scatter / bubble chart or a date axis");
+	spec.categoryGroupLevels?.forEach((level, i) => {
+		if (level.length !== spec.categories.length) throw new Error(`chart: categoryGroupLevels[${i}] has ${level.length} entries for ${spec.categories.length} categories`);
+	});
+	if (XY_KINDS.has(spec.kind)) spec.series.forEach((series) => {
+		if (series.xValues === void 0) throw new Error(`chart: ${spec.kind} series '${series.name}' needs xValues`);
+		if (spec.kind === "bubble" && series.bubbleSizes === void 0) throw new Error(`chart: bubble series '${series.name}' needs bubbleSizes`);
+	});
+};
+const dataTableElement = (table) => {
+	const children = [
+		valNode(c("showHorzBorder"), table.showHorizontalBorder === false ? "0" : "1"),
+		valNode(c("showVertBorder"), table.showVerticalBorder === false ? "0" : "1"),
+		valNode(c("showOutline"), table.showOutline === false ? "0" : "1"),
+		valNode(c("showKeys"), table.showKeys === false ? "0" : "1")
+	];
+	const txPr = axisTxPrElement(table.textStyle, void 0);
+	if (txPr !== null) children.push(txPr);
+	return elem(c("dTable"), { children });
 };
 /**
 * Builds a complete `<c:chartSpace>` document for `spec`. The caller
@@ -5670,55 +7040,48 @@ const titleElement = (title, style, rotationDeg) => {
 * `r:id="rId1"` for the embedded workbook.
 */
 const buildChartSpaceDoc = (spec) => {
-	const sheet = "Sheet1";
 	const usesComboFields = spec.series.some((series) => series.chartKind !== void 0 || series.secondaryAxis === true);
-	if (usesComboFields && !COMBO_KINDS.has(spec.kind)) throw new Error(`chart kind '${spec.kind}' does not support per-series chartKind / secondaryAxis (combo charts require a bar / column / line / area base kind)`);
-	const allIndices = spec.series.map((_, i) => i);
+	validateSpec(spec, usesComboFields);
+	const layout = layoutChartSheet(spec);
 	let plottedGroups;
 	let hasSecondary = false;
-	switch (spec.kind) {
-		case "column":
-		case "bar":
-		case "line":
-		case "area":
-			if (usesComboFields) {
-				const groups = comboPlotGroups(spec);
-				hasSecondary = groups.some((group) => group.secondary);
-				plottedGroups = groups.map((group) => buildComboGroupChart(spec, sheet, group.kind, group.indices, group.secondary ? SECONDARY_AXES : PRIMARY_AXES));
-			} else plottedGroups = [buildComboGroupChart(spec, sheet, spec.kind, allIndices, PRIMARY_AXES)];
-			break;
-		case "pie":
-			plottedGroups = [buildPieChart(spec, sheet)];
-			break;
-		case "doughnut":
-			plottedGroups = [buildDoughnutChart(spec, sheet)];
-			break;
-		case "scatter":
-		case "radar":
-		case "bubble": throw new Error(`chart kind '${spec.kind}' is read-only; authoring scatter / radar / bubble charts is not yet supported`);
-		default: {
-			const exhaustive = spec.kind;
-			throw new Error(`unsupported chart kind: ${String(exhaustive)}`);
-		}
-	}
-	const axisless = spec.kind === "pie" || spec.kind === "doughnut";
-	const plotAreaChildren = [elem(c("layout")), ...plottedGroups];
-	if (!axisless) {
-		plotAreaChildren.push(catAxis(spec), valAxis(spec));
+	if (usesComboFields) {
+		const groups = comboPlotGroups(spec);
+		hasSecondary = groups.some((group) => group.secondary);
+		plottedGroups = groups.map((group) => buildPlotGroup({
+			spec,
+			layout,
+			seriesIndices: group.indices,
+			axes: group.secondary ? SECONDARY_AXES : PRIMARY_AXES
+		}, group.kind));
+	} else plottedGroups = [buildPlotGroup({
+		spec,
+		layout,
+		seriesIndices: spec.series.map((_, i) => i),
+		axes: PRIMARY_AXES
+	}, spec.kind)];
+	const plotLayout = spec.plotAreaLayout;
+	const plotAreaChildren = [plotLayout !== void 0 ? manualLayoutElement(plotLayout, plotLayout, plotLayout.target) : elem(c("layout")), ...plottedGroups];
+	if (!AXISLESS_KINDS.has(spec.kind)) {
+		plotAreaChildren.push(XY_KINDS.has(spec.kind) ? xValAxis(spec) : catAxis(spec), valAxis(spec));
+		if (hasSeriesAxis(spec)) plotAreaChildren.push(serAxis(spec));
 		if (hasSecondary) plotAreaChildren.push(secondaryValAxis(spec), secondaryCatAxis(spec));
 	}
+	if (spec.dataTable !== void 0) plotAreaChildren.push(dataTableElement(spec.dataTable));
 	if (spec.plotAreaFill !== void 0 || spec.plotAreaStrokeColor !== void 0) plotAreaChildren.push(spPrChildren(spec.plotAreaFill, spec.plotAreaStrokeColor));
 	const plotArea = elem(c("plotArea"), { children: plotAreaChildren });
 	const chartChildren = [];
-	if (spec.title !== void 0) {
-		const titleEl = titleElement(spec.title, spec.titleStyle);
-		if (spec.titleOverlay !== void 0) titleEl.children = [...titleEl.children.filter((c2) => !(c2.kind === "element" && c2.name.namespaceURI === NS_C$1 && c2.name.localName === "overlay")), valNode(c("overlay"), spec.titleOverlay ? "1" : "0")];
-		chartChildren.push(titleEl);
-	}
-	chartChildren.push(valNode(c("autoTitleDeleted"), spec.title !== void 0 ? "0" : "1"), plotArea);
+	if (spec.title !== void 0) chartChildren.push(titleElement(spec.title, spec.titleStyle, void 0, {
+		...spec.titleOverlay !== void 0 ? { overlay: spec.titleOverlay } : {},
+		...spec.titleLayout !== void 0 ? { layout: spec.titleLayout } : {}
+	}));
+	chartChildren.push(valNode(c("autoTitleDeleted"), spec.title !== void 0 ? "0" : "1"));
+	if (spec.view3D !== void 0 || spec.kind === "surface") chartChildren.push(view3DElement(spec));
+	chartChildren.push(plotArea);
 	if (spec.legend !== void 0 && spec.legend.position !== null) {
 		const legendChildren = [valNode(c("legendPos"), spec.legend.position)];
 		for (const idx of spec.legend.hiddenIndices ?? []) legendChildren.push(elem(c("legendEntry"), { children: [valNode(c("idx"), idx), valNode(c("delete"), "1")] }));
+		if (spec.legend.layout !== void 0) legendChildren.push(manualLayoutElement(spec.legend.layout, spec.legend.layout));
 		legendChildren.push(valNode(c("overlay"), spec.legend.overlay ? "1" : "0"));
 		if (spec.legend.textStyle !== void 0) {
 			const txPr = axisTxPrElement(spec.legend.textStyle, void 0);
@@ -5852,15 +7215,15 @@ const KIND_MAP = [
 	},
 	{
 		localName: "stockChart",
-		kind: "line"
+		kind: "stock"
 	},
 	{
 		localName: "surfaceChart",
-		kind: "column"
+		kind: "surface"
 	},
 	{
 		localName: "surface3DChart",
-		kind: "column"
+		kind: "surface"
 	}
 ];
 const findFirst = (parent, names) => {
@@ -6293,6 +7656,10 @@ const readDataLabelsGroup = (host, inherited) => {
 	const separator = readDataLabelSeparator(host);
 	const txPrEl = firstChildElement(host, qname("c", "txPr", NS_C));
 	const textStyle = txPrEl ? readLabelStyle(txPrEl) : void 0;
+	const showBubbleSize = readToggle("showBubbleSize", inherited?.showBubbleSize ?? false);
+	const showLegendKey = readToggle("showLegendKey", inherited?.showLegendKey ?? false);
+	const spPr = firstChildElement(host, NAME_SP_PR_C);
+	const fillColor = spPr !== null ? readSolidSrgb(spPr) : void 0;
 	return {
 		showValue: readToggle("showVal", inherited?.showValue ?? false),
 		showCategory: readToggle("showCatName", inherited?.showCategory ?? false),
@@ -6301,9 +7668,28 @@ const readDataLabelsGroup = (host, inherited) => {
 		...numberFormat !== void 0 ? { numberFormat } : {},
 		...position !== void 0 ? { position } : {},
 		...separator !== void 0 ? { separator } : {},
-		...textStyle !== void 0 ? { textStyle } : {}
+		...textStyle !== void 0 ? { textStyle } : {},
+		...showBubbleSize ? { showBubbleSize } : {},
+		...showLegendKey ? { showLegendKey } : {},
+		...fillColor !== void 0 ? { fillColor } : {}
 	};
 };
+const readRichText = (host) => {
+	const tx = firstChildElement(host, NAME_TX);
+	const rich = tx !== null ? firstChildElement(tx, NAME_RICH) : null;
+	if (rich === null) return void 0;
+	const paragraphs = [];
+	for (const p of allChildElements(rich, NAME_P_DML)) {
+		let line = "";
+		for (const r of allChildElements(p, NAME_R_DML)) {
+			const t = firstChildElement(r, NAME_T);
+			if (t === null) continue;
+			for (const child of t.children) if (child.kind === "text" || child.kind === "cdata") line += child.data;
+		}
+		paragraphs.push(line);
+	}
+	return paragraphs.join("\n");
+};
 const readSeriesLevelDataLabels = (dLbls) => {
 	const group = readDataLabelsGroup(dLbls, void 0);
 	const leaderEl = firstChildElement(dLbls, qname("c", "showLeaderLines", NS_C));
@@ -6326,7 +7712,15 @@ const readPointDataLabels = (dLbls, pointCount, seriesLabels) => {
 		const idx = readPointIndex(dLbl, pointCount);
 		if (idx === null) continue;
 		const deleteEl = firstChildElement(dLbl, qname("c", "delete", NS_C));
-		out[idx] = deleteEl !== null && readXmlBool(deleteEl) ? DELETED_POINT_LABEL : readDataLabelsGroup(dLbl, seriesLabels);
+		if (deleteEl !== null && readXmlBool(deleteEl)) out[idx] = DELETED_POINT_LABEL;
+		else {
+			const group = readDataLabelsGroup(dLbl, seriesLabels);
+			const literal = readRichText(dLbl);
+			out[idx] = literal !== void 0 ? {
+				...group,
+				text: literal
+			} : group;
+		}
 		any = true;
 	}
 	if (!any) return void 0;
@@ -6340,6 +7734,7 @@ const readValueAxisScaling = (valAx) => {
 	let minorUnit;
 	let logBase;
 	let displayUnits;
+	let displayUnitsLabel = false;
 	const scaling = firstChildElement(valAx, qname("c", "scaling", NS_C));
 	const readNumOn = (parent, local) => {
 		const el = firstChildElement(parent, qname("c", local, NS_C));
@@ -6376,23 +7771,300 @@ const readValueAxisScaling = (valAx) => {
 					break;
 			}
 		}
+		displayUnitsLabel = firstChildElement(dispUnits, qname("c", "dispUnitsLbl", NS_C)) !== null;
+	}
+	let numberFormat;
+	const nfEl = firstChildElement(valAx, qname("c", "numFmt", NS_C));
+	if (nfEl) {
+		const fc = getAttrValue(nfEl, qname("", "formatCode", ""));
+		if (fc !== null && fc.length > 0 && fc !== "General") numberFormat = fc;
+	}
+	if (min !== void 0 || max !== void 0 || majorUnit !== void 0 || minorUnit !== void 0 || numberFormat !== void 0 || logBase !== void 0 || displayUnits !== void 0) return {
+		...min !== void 0 ? { min } : {},
+		...max !== void 0 ? { max } : {},
+		...majorUnit !== void 0 ? { majorUnit } : {},
+		...minorUnit !== void 0 ? { minorUnit } : {},
+		...numberFormat !== void 0 ? { numberFormat } : {},
+		...logBase !== void 0 ? { logBase } : {},
+		...displayUnits !== void 0 ? { displayUnits } : {},
+		...displayUnits !== void 0 && displayUnitsLabel ? { displayUnitsLabel } : {}
+	};
+};
+const childVal = (parent, local) => {
+	const el = firstChildElement(parent, qname("c", local, NS_C));
+	return el !== null ? getAttrValue(el, ATTR_VAL) : null;
+};
+const childNumber = (parent, local) => {
+	const raw = childVal(parent, local);
+	if (raw === null) return void 0;
+	const n = Number.parseFloat(raw);
+	return Number.isFinite(n) ? n : void 0;
+};
+const childBool = (parent, local) => {
+	const el = firstChildElement(parent, qname("c", local, NS_C));
+	return el !== null ? readXmlBool(el) : void 0;
+};
+const childToken = (parent, local, allowed) => {
+	const raw = childVal(parent, local);
+	return allowed.find((token) => token === raw);
+};
+const ALPHA_OPAQUE = 1e5;
+const readSeriesFillOpacity = (ser) => {
+	const spPr = firstChildElement(ser, NAME_SP_PR_C);
+	const fill = spPr !== null ? firstChildElement(spPr, NAME_SOLID_FILL$1) : null;
+	const srgb = fill !== null ? firstChildElement(fill, NAME_SRGB_CLR) : null;
+	const alpha = srgb !== null ? firstChildElement(srgb, qname("a", "alpha", NS_A)) : null;
+	const raw = alpha !== null ? getAttrValue(alpha, ATTR_VAL) : null;
+	if (raw === null || !/^\d+$/.test(raw)) return void 0;
+	const n = Number.parseInt(raw, 10);
+	return n <= ALPHA_OPAQUE ? n / ALPHA_OPAQUE : void 0;
+};
+const readErrorBarAmount = (errBars) => {
+	const type = childToken(errBars, "errValType", [
+		"cust",
+		"fixedVal",
+		"percentage",
+		"stdDev",
+		"stdErr"
+	]);
+	if (type === void 0) return void 0;
+	if (type === "stdErr") return { type };
+	if (type === "cust") {
+		const side = (local) => {
+			const el = firstChildElement(errBars, qname("c", local, NS_C));
+			return el !== null ? readNumChannel(el) ?? void 0 : void 0;
+		};
+		const plus = side("plus");
+		const minus = side("minus");
+		return {
+			type,
+			...plus !== void 0 ? { plus } : {},
+			...minus !== void 0 ? { minus } : {}
+		};
 	}
-	let numberFormat;
-	const nfEl = firstChildElement(valAx, qname("c", "numFmt", NS_C));
-	if (nfEl) {
-		const fc = getAttrValue(nfEl, qname("", "formatCode", ""));
-		if (fc !== null && fc.length > 0 && fc !== "General") numberFormat = fc;
+	const value = childNumber(errBars, "val");
+	return value !== void 0 ? {
+		type,
+		value
+	} : void 0;
+};
+const readErrorBars = (ser) => {
+	const out = {};
+	for (const el of allChildElements(ser, qname("c", "errBars", NS_C))) {
+		const barType = childToken(el, "errBarType", [
+			"both",
+			"minus",
+			"plus"
+		]);
+		const amount = readErrorBarAmount(el);
+		if (barType === void 0 || amount === void 0) continue;
+		const noEndCap = childBool(el, "noEndCap");
+		const spPr = firstChildElement(el, NAME_SP_PR_C);
+		const ln = spPr !== null ? firstChildElement(spPr, qname("a", "ln", NS_A)) : null;
+		const color = readSolidSrgb(ln);
+		const w = ln !== null ? getAttrValue(ln, qname("", "w", "")) : null;
+		const bars = {
+			barType,
+			amount,
+			...noEndCap !== void 0 ? { noEndCap } : {},
+			...color !== void 0 ? { color } : {},
+			...w !== null && /^\d+$/.test(w) ? { lineWidthEmu: Number.parseInt(w, 10) } : {}
+		};
+		if (childVal(el, "errDir") === "x") out.xErrorBars ??= bars;
+		else out.errorBars ??= bars;
 	}
-	if (min !== void 0 || max !== void 0 || majorUnit !== void 0 || minorUnit !== void 0 || numberFormat !== void 0 || logBase !== void 0 || displayUnits !== void 0) return {
-		...min !== void 0 ? { min } : {},
-		...max !== void 0 ? { max } : {},
+	return out;
+};
+const readView3D = (chart) => {
+	const el = firstChildElement(chart, qname("c", "view3D", NS_C));
+	if (el === null) return void 0;
+	const rotX = childNumber(el, "rotX");
+	const rotY = childNumber(el, "rotY");
+	const rightAngleAxes = childBool(el, "rAngAx");
+	const perspective = childNumber(el, "perspective");
+	const depthPercent = childNumber(el, "depthPercent");
+	const heightPercent = childNumber(el, "hPercent");
+	return {
+		...rotX !== void 0 ? { rotX } : {},
+		...rotY !== void 0 ? { rotY } : {},
+		...rightAngleAxes !== void 0 ? { rightAngleAxes } : {},
+		...perspective !== void 0 ? { perspective } : {},
+		...depthPercent !== void 0 ? { depthPercent } : {},
+		...heightPercent !== void 0 ? { heightPercent } : {}
+	};
+};
+const readOfPie = (group) => {
+	const type = childToken(group, "ofPieType", ["pie", "bar"]);
+	if (type === void 0) return void 0;
+	const splitType = childToken(group, "splitType", [
+		"auto",
+		"cust",
+		"percent",
+		"pos",
+		"val"
+	]);
+	const splitPos = childNumber(group, "splitPos");
+	const secondPieSizePct = childNumber(group, "secondPieSize");
+	const gapWidthPct = childNumber(group, "gapWidth");
+	const custSplit = firstChildElement(group, qname("c", "custSplit", NS_C));
+	const customSplit = [];
+	if (custSplit !== null) for (const pt of allChildElements(custSplit, qname("c", "secondPiePt", NS_C))) {
+		const idx = parsePointIndex(getAttrValue(pt, ATTR_VAL), MAX_PT_COUNT);
+		if (idx !== null) customSplit.push(idx);
+	}
+	const seriesLines = firstChildElement(group, qname("c", "serLines", NS_C)) !== null;
+	return {
+		type,
+		...splitType !== void 0 ? { splitType } : {},
+		...splitPos !== void 0 ? { splitPos } : {},
+		...custSplit !== null ? { customSplit } : {},
+		...secondPieSizePct !== void 0 ? { secondPieSizePct } : {},
+		...gapWidthPct !== void 0 ? { gapWidthPct } : {},
+		...seriesLines ? { seriesLines } : {}
+	};
+};
+const readUpDownBars = (group) => {
+	const el = firstChildElement(group, qname("c", "upDownBars", NS_C));
+	if (el === null) return void 0;
+	const barColor = (local) => {
+		const bar = firstChildElement(el, qname("c", local, NS_C));
+		return readSolidSrgb(bar !== null ? firstChildElement(bar, NAME_SP_PR_C) : null);
+	};
+	const gapWidthPct = childNumber(el, "gapWidth");
+	const upColor = barColor("upBars");
+	const downColor = barColor("downBars");
+	return {
+		...gapWidthPct !== void 0 ? { gapWidthPct } : {},
+		...upColor !== void 0 ? { upColor } : {},
+		...downColor !== void 0 ? { downColor } : {}
+	};
+};
+const readDataTable = (plotArea) => {
+	const el = firstChildElement(plotArea, qname("c", "dTable", NS_C));
+	if (el === null) return void 0;
+	const showHorizontalBorder = childBool(el, "showHorzBorder");
+	const showVerticalBorder = childBool(el, "showVertBorder");
+	const showOutline = childBool(el, "showOutline");
+	const showKeys = childBool(el, "showKeys");
+	const txPr = firstChildElement(el, qname("c", "txPr", NS_C));
+	const textStyle = txPr !== null ? readLabelStyle(txPr) : void 0;
+	return {
+		...showHorizontalBorder !== void 0 ? { showHorizontalBorder } : {},
+		...showVerticalBorder !== void 0 ? { showVerticalBorder } : {},
+		...showOutline !== void 0 ? { showOutline } : {},
+		...showKeys !== void 0 ? { showKeys } : {},
+		...textStyle !== void 0 ? { textStyle } : {}
+	};
+};
+const TIME_UNITS = [
+	"days",
+	"months",
+	"years"
+];
+const readDateAxis = (dateAx) => {
+	const baseTimeUnit = childToken(dateAx, "baseTimeUnit", TIME_UNITS);
+	const majorUnit = childNumber(dateAx, "majorUnit");
+	const majorTimeUnit = childToken(dateAx, "majorTimeUnit", TIME_UNITS);
+	const minorUnit = childNumber(dateAx, "minorUnit");
+	const minorTimeUnit = childToken(dateAx, "minorTimeUnit", TIME_UNITS);
+	return {
+		...baseTimeUnit !== void 0 ? { baseTimeUnit } : {},
 		...majorUnit !== void 0 ? { majorUnit } : {},
+		...majorTimeUnit !== void 0 ? { majorTimeUnit } : {},
 		...minorUnit !== void 0 ? { minorUnit } : {},
-		...numberFormat !== void 0 ? { numberFormat } : {},
-		...logBase !== void 0 ? { logBase } : {},
-		...displayUnits !== void 0 ? { displayUnits } : {}
+		...minorTimeUnit !== void 0 ? { minorTimeUnit } : {}
+	};
+};
+const withoutNumberFormat = (scaling) => {
+	if (scaling === void 0) return void 0;
+	const { numberFormat: _numberFormat, ...rest } = scaling;
+	return Object.keys(rest).length > 0 ? rest : void 0;
+};
+const minMaxOnly = (scaling) => {
+	if (scaling?.min === void 0 && scaling?.max === void 0) return void 0;
+	return {
+		...scaling.min !== void 0 ? { min: scaling.min } : {},
+		...scaling.max !== void 0 ? { max: scaling.max } : {}
+	};
+};
+const isAxisLineHidden = (axis) => {
+	const spPr = firstChildElement(axis, NAME_SP_PR_C);
+	const ln = spPr !== null ? firstChildElement(spPr, qname("a", "ln", NS_A)) : null;
+	return ln !== null && firstChildElement(ln, qname("a", "noFill", NS_A)) !== null;
+};
+const readSeriesAxis = (plotArea) => {
+	const el = firstChildElement(plotArea, qname("c", "serAx", NS_C));
+	if (el === null) return void 0;
+	const hidden = childBool(el, "delete");
+	const title = readTitle(el);
+	const titleEl = firstChildElement(el, NAME_TITLE);
+	const titleStyle = titleEl !== null ? readTitleStyleOf(titleEl) : void 0;
+	const txPr = firstChildElement(el, qname("c", "txPr", NS_C));
+	const labelStyle = txPr !== null ? readLabelStyle(txPr) : void 0;
+	const majorGridlines = firstChildElement(el, qname("c", "majorGridlines", NS_C)) !== null;
+	const scaling = firstChildElement(el, qname("c", "scaling", NS_C));
+	const orientation = scaling !== null ? childToken(scaling, "orientation", ["minMax", "maxMin"]) : void 0;
+	const tickLabelPos = childToken(el, "tickLblPos", [
+		"none",
+		"low",
+		"high",
+		"nextTo"
+	]);
+	const tickLabelSkip = childNumber(el, "tickLblSkip");
+	const spPr = firstChildElement(el, NAME_SP_PR_C);
+	const lineColor = readSolidSrgb(spPr !== null ? firstChildElement(spPr, qname("a", "ln", NS_A)) : null);
+	const fields = {
+		...hidden === true ? { hidden } : {},
+		...title !== void 0 ? { title } : {},
+		...titleStyle !== void 0 ? { titleStyle } : {},
+		...labelStyle !== void 0 ? { labelStyle } : {},
+		...majorGridlines ? { majorGridlines } : {},
+		...orientation === "maxMin" ? { orientation } : {},
+		...tickLabelPos !== void 0 ? { tickLabelPos } : {},
+		...tickLabelSkip !== void 0 ? { tickLabelSkip } : {},
+		...lineColor !== void 0 ? { lineColor } : {}
+	};
+	return Object.keys(fields).length > 0 ? fields : void 0;
+};
+const readManualLayout = (host) => {
+	const layout = firstChildElement(host, qname("c", "layout", NS_C));
+	const manual = layout !== null ? firstChildElement(layout, qname("c", "manualLayout", NS_C)) : null;
+	if (manual === null) return void 0;
+	if (childVal(manual, "xMode") !== "edge" || childVal(manual, "yMode") !== "edge") return void 0;
+	const sizeMode = (local) => (childVal(manual, local) ?? "factor") === "factor";
+	if (!sizeMode("wMode") || !sizeMode("hMode")) return void 0;
+	const x = childNumber(manual, "x");
+	const y = childNumber(manual, "y");
+	if (x === void 0 || y === void 0) return void 0;
+	const w = childNumber(manual, "w");
+	const h = childNumber(manual, "h");
+	const target = childToken(manual, "layoutTarget", ["inner", "outer"]);
+	return {
+		x,
+		y,
+		...w !== void 0 ? { w } : {},
+		...h !== void 0 ? { h } : {},
+		...target !== void 0 ? { target } : {}
+	};
+};
+const readBoxLayout = (host) => {
+	const layout = readManualLayout(host);
+	if (layout === void 0 || layout.w === void 0 || layout.h === void 0) return void 0;
+	return {
+		x: layout.x,
+		y: layout.y,
+		w: layout.w,
+		h: layout.h,
+		...layout.target !== void 0 ? { target: layout.target } : {}
 	};
 };
+const readCategoryGroupLevels = (cat) => {
+	const multi = firstChildElement(cat, NAME_MULTI_LVL_STR_REF);
+	const cache = multi !== null ? firstChildElement(multi, NAME_MULTI_LVL_STR_CACHE) : null;
+	if (cache === null) return void 0;
+	const outer = allChildElements(cache, NAME_LVL).slice(1).map((lvl) => readPtArray(lvl, cache));
+	return outer.length > 0 ? outer : void 0;
+};
 /**
 * Parses a `<c:chartSpace>` element into a typed `ChartSpec`. Throws if
 * the root or any required child is missing. Returns `null` only when
@@ -6445,6 +8117,7 @@ const readChartSpec = (root) => {
 	const groupUsesSecondaryAxis = (group) => groupAxisIds(group).some((id) => secondaryValAxisIds.has(id));
 	const series = [];
 	let categoriesFromFirst = null;
+	let categoryGroupLevels;
 	const serEntries = [];
 	for (const group of plotGroups) {
 		const secondary = groupUsesSecondaryAxis(group.element);
@@ -6459,6 +8132,7 @@ const readChartSpec = (root) => {
 		const cat = firstChildElement(ser, NAME_CAT);
 		if (cat !== null && categoriesFromFirst === null) {
 			categoriesFromFirst = readStringRef(cat) ?? null;
+			categoryGroupLevels = readCategoryGroupLevels(cat);
 			if (categoriesFromFirst === null) {
 				const nums = readNumRef(cat);
 				if (nums !== null) categoriesFromFirst = nums.map((n) => n === null || !Number.isFinite(n) ? "" : String(n));
@@ -6481,6 +8155,8 @@ const readChartSpec = (root) => {
 		const smoothEl = firstChildElement(ser, qname("c", "smooth", NS_C));
 		const smooth = smoothEl !== null && readXmlBool(smoothEl);
 		const trendline = readTrendline(ser);
+		const fillOpacity = readSeriesFillOpacity(ser);
+		const { errorBars, xErrorBars } = readErrorBars(ser);
 		const serDLblsEl = firstChildElement(ser, NAME_D_LBLS);
 		const serDataLabels = serDLblsEl !== null && hasDataLabelGroupChild(serDLblsEl) ? readSeriesLevelDataLabels(serDLblsEl) : void 0;
 		const pointDataLabels = serDLblsEl !== null ? readPointDataLabels(serDLblsEl, pointCount, serDataLabels) : void 0;
@@ -6505,7 +8181,10 @@ const readChartSpec = (root) => {
 			...pointDataLabels !== void 0 ? { pointDataLabels } : {},
 			...smoothEl !== null ? { smooth } : {},
 			...trendline !== void 0 ? { trendline } : {},
-			...serDataLabels !== void 0 ? { dataLabels: serDataLabels } : {}
+			...serDataLabels !== void 0 ? { dataLabels: serDataLabels } : {},
+			...fillOpacity !== void 0 ? { fillOpacity } : {},
+			...errorBars !== void 0 ? { errorBars } : {},
+			...xErrorBars !== void 0 ? { xErrorBars } : {}
 		});
 	}
 	const categories = categoriesFromFirst ?? [];
@@ -6525,6 +8204,22 @@ const readChartSpec = (root) => {
 		valAx = secValAx;
 		secValAx = null;
 	}
+	const isXyKind = kind === "scatter" || kind === "bubble";
+	let xValAx = null;
+	if (isXyKind) {
+		const [xId, yId] = groupAxisIds(plotted);
+		const valAxById = /* @__PURE__ */ new Map();
+		for (const el of allChildElements(plotArea, NAME_VAL_AX)) {
+			const id = childVal(el, "axId");
+			if (id !== null) valAxById.set(id, el);
+		}
+		const x = xId !== void 0 ? valAxById.get(xId) : void 0;
+		const y = yId !== void 0 ? valAxById.get(yId) : void 0;
+		if (x !== void 0 && y !== void 0) {
+			xValAx = x;
+			valAx = y;
+		}
+	}
 	const valueAxis = valAx !== null ? readValueAxisScaling(valAx) : void 0;
 	let grouping;
 	if (kind === "column" || kind === "bar" || kind === "area" || kind === "line") {
@@ -6641,11 +8336,7 @@ const readChartSpec = (root) => {
 		const v = getAttrValue(srgb, ATTR_VAL);
 		return v !== null ? `#${v.toUpperCase()}` : void 0;
 	};
-	const catAx = findFirst(plotArea, [
-		"catAx",
-		"dateAx",
-		"serAx"
-	]);
+	const catAx = xValAx ?? findFirst(plotArea, ["catAx", "dateAx"]);
 	const isHidden = (axis) => {
 		const d = firstChildElement(axis, qname("c", "delete", NS_C));
 		if (!d) return void 0;
@@ -6939,9 +8630,12 @@ const readChartSpec = (root) => {
 			const n = Number.parseInt(idxV, 10);
 			if (Number.isFinite(n) && n >= 0) hiddenIndices.push(n);
 		}
+		const position = tok === "r" || tok === "t" || tok === "b" || tok === "l" || tok === "tr" ? tok : "r";
+		const legendLayout = readBoxLayout(legendEl);
 		legend = {
-			position: tok === "r" || tok === "t" || tok === "b" || tok === "l" || tok === "tr" ? tok : "r",
+			position,
 			...overlay ? { overlay } : {},
+			...legendLayout !== void 0 ? { layout: legendLayout } : {},
 			...textStyle !== void 0 ? { textStyle } : {},
 			...hiddenIndices.length > 0 ? { hiddenIndices } : {}
 		};
@@ -7012,6 +8706,38 @@ const readChartSpec = (root) => {
 			else if (v === "w") bubbleSizeRepresents = "width";
 		}
 	}
+	const plottedName = plotted.name.localName;
+	const view3DEl = readView3D(chart);
+	const view3D = plottedName.endsWith("3DChart") || kind === "surface" ? view3DEl : void 0;
+	const bar3DShape = plottedName === "bar3DChart" ? childToken(plotted, "shape", [
+		"box",
+		"cone",
+		"coneToMax",
+		"cylinder",
+		"pyramid",
+		"pyramidToMax"
+	]) : void 0;
+	const gapDepthPct = view3D !== void 0 ? childNumber(plotted, "gapDepth") : void 0;
+	const bubble3D = kind === "bubble" && allChildElements(plotted, NAME_SER).some((ser) => childBool(ser, "bubble3D") === true);
+	const showNegativeBubbles = kind === "bubble" ? childBool(plotted, "showNegBubbles") : void 0;
+	const ofPie = plottedName === "ofPieChart" ? readOfPie(plotted) : void 0;
+	const surfaceContour = plottedName === "surfaceChart";
+	const surfaceWireframe = kind === "surface" ? childBool(plotted, "wireframe") : void 0;
+	const upDownBars = readUpDownBars(plotted);
+	const dataTable = readDataTable(plotArea);
+	const seriesAxis = readSeriesAxis(plotArea);
+	const plotAreaLayout = readBoxLayout(plotArea);
+	const chartTitleEl = firstChildElement(chart, NAME_TITLE);
+	const titlePosition = chartTitleEl !== null ? readManualLayout(chartTitleEl) : void 0;
+	const titleLayout = titlePosition !== void 0 ? {
+		x: titlePosition.x,
+		y: titlePosition.y
+	} : void 0;
+	const categoryAxisDate = catAx !== null && catAx.name.localName === "dateAx" ? readDateAxis(catAx) : void 0;
+	const horizontalScaling = catAx !== null ? readValueAxisScaling(catAx) : void 0;
+	const categoryAxisScaling = isXyKind ? withoutNumberFormat(horizontalScaling) : categoryAxisDate !== void 0 ? minMaxOnly(horizontalScaling) : void 0;
+	const valueAxisLineHidden = valAx !== null && isAxisLineHidden(valAx);
+	const categoryAxisLineHidden = catAx !== null && isAxisLineHidden(catAx);
 	return {
 		kind,
 		categories,
@@ -7089,80 +8815,28 @@ const readChartSpec = (root) => {
 		...scatterStyle !== void 0 ? { scatterStyle } : {},
 		...radarStyle !== void 0 ? { radarStyle } : {},
 		...bubbleScale !== void 0 ? { bubbleScale } : {},
-		...bubbleSizeRepresents !== void 0 ? { bubbleSizeRepresents } : {}
+		...bubbleSizeRepresents !== void 0 ? { bubbleSizeRepresents } : {},
+		...bubble3D === true ? { bubble3D } : {},
+		...showNegativeBubbles !== void 0 ? { showNegativeBubbles } : {},
+		...view3D !== void 0 ? { view3D } : {},
+		...bar3DShape !== void 0 ? { bar3DShape } : {},
+		...gapDepthPct !== void 0 ? { gapDepthPct } : {},
+		...seriesAxis !== void 0 ? { seriesAxis } : {},
+		...ofPie !== void 0 ? { ofPie } : {},
+		...surfaceContour ? { surfaceContour } : {},
+		...surfaceWireframe !== void 0 ? { surfaceWireframe } : {},
+		...upDownBars !== void 0 ? { upDownBars } : {},
+		...dataTable !== void 0 ? { dataTable } : {},
+		...categoryAxisDate !== void 0 ? { categoryAxisDate } : {},
+		...categoryAxisScaling !== void 0 ? { categoryAxisScaling } : {},
+		...categoryGroupLevels !== void 0 ? { categoryGroupLevels } : {},
+		...plotAreaLayout !== void 0 ? { plotAreaLayout } : {},
+		...titleLayout !== void 0 ? { titleLayout } : {},
+		...valueAxisLineHidden ? { valueAxisLineHidden } : {},
+		...categoryAxisLineHidden ? { categoryAxisLineHidden } : {}
 	};
 };
 //#endregion
-//#region src/internal/chartml/embedded-xlsx.ts
-const TEXT_ENCODER = new TextEncoder();
-const encode = (s) => TEXT_ENCODER.encode(s);
-const xmlEscape = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
-const colLetter = (col) => {
-	let n = col;
-	let out = "";
-	while (true) {
-		out = String.fromCharCode(65 + n % 26) + out;
-		if (n < 26) return out;
-		n = Math.floor(n / 26) - 1;
-	}
-};
-const cellRef = (row, col) => `${colLetter(col)}${row + 1}`;
-/**
-* Builds the bytes of a fresh xlsx whose only sheet is laid out as
-*
-*   |       | seriesNames[0] | seriesNames[1] | ...
-*   |-------|----------------|----------------|----
-*   | row0  | row0.values[0] | row0.values[1] | ...
-*   | row1  | row1.values[0] | ...            | ...
-*
-* Header row is row 1 in the sheet (1-indexed). The first column carries
-* category labels; subsequent columns carry series values.
-*/
-const buildEmbeddedXlsx = (seriesNames, rows) => {
-	const sheetXmlParts = [];
-	sheetXmlParts.push("<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n", "<worksheet xmlns=\"http://schemas.openxmlformats.org/spreadsheetml/2006/main\">", "<sheetData>");
-	sheetXmlParts.push("<row r=\"1\">");
-	sheetXmlParts.push(`<c r="${cellRef(0, 0)}" t="inlineStr"><is><t></t></is></c>`);
-	for (let i = 0; i < seriesNames.length; i++) sheetXmlParts.push(`<c r="${cellRef(0, i + 1)}" t="inlineStr"><is><t>${xmlEscape(seriesNames[i] ?? "")}</t></is></c>`);
-	sheetXmlParts.push("</row>");
-	for (let r = 0; r < rows.length; r++) {
-		const row = rows[r];
-		const rowIdx = r + 1;
-		sheetXmlParts.push(`<row r="${rowIdx + 1}">`);
-		sheetXmlParts.push(`<c r="${cellRef(rowIdx, 0)}" t="inlineStr"><is><t>${xmlEscape(row.label)}</t></is></c>`);
-		for (let i = 0; i < row.values.length; i++) {
-			const v = row.values[i];
-			if (v === null || v === void 0) continue;
-			sheetXmlParts.push(`<c r="${cellRef(rowIdx, i + 1)}"><v>${v}</v></c>`);
-		}
-		sheetXmlParts.push("</row>");
-	}
-	sheetXmlParts.push("</sheetData></worksheet>");
-	const sheetXml = sheetXmlParts.join("");
-	return writeZip([
-		{
-			name: "[Content_Types].xml",
-			data: encode("<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<Types xmlns=\"http://schemas.openxmlformats.org/package/2006/content-types\"><Default Extension=\"rels\" ContentType=\"application/vnd.openxmlformats-package.relationships+xml\"/><Default Extension=\"xml\" ContentType=\"application/xml\"/><Override PartName=\"/xl/workbook.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml\"/><Override PartName=\"/xl/worksheets/sheet1.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml\"/></Types>")
-		},
-		{
-			name: "_rels/.rels",
-			data: encode("<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<Relationships xmlns=\"http://schemas.openxmlformats.org/package/2006/relationships\"><Relationship Id=\"rId1\" Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument\" Target=\"xl/workbook.xml\"/></Relationships>")
-		},
-		{
-			name: "xl/workbook.xml",
-			data: encode("<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<workbook xmlns=\"http://schemas.openxmlformats.org/spreadsheetml/2006/main\" xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\"><sheets><sheet name=\"Sheet1\" sheetId=\"1\" r:id=\"rId1\"/></sheets></workbook>")
-		},
-		{
-			name: "xl/_rels/workbook.xml.rels",
-			data: encode("<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<Relationships xmlns=\"http://schemas.openxmlformats.org/package/2006/relationships\"><Relationship Id=\"rId1\" Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet\" Target=\"worksheets/sheet1.xml\"/></Relationships>")
-		},
-		{
-			name: "xl/worksheets/sheet1.xml",
-			data: encode(sheetXml)
-		}
-	]);
-};
-//#endregion
 //#region src/api/fn/slide-background.ts
 const setSlideBackgroundXml = (slide, configure) => {
 	const cSld = firstChildElement(slide[SLIDE_DOCUMENT].root, NAME_CSLD);
@@ -8138,12 +9812,22 @@ const validateChartSpecColors = (spec) => {
 	checkChartColor(spec.categoryAxisLineColor, "addSlideChart: categoryAxisLineColor");
 	checkChartColor(spec.secondaryValueAxis?.majorGridlineColor, "addSlideChart: secondaryValueAxis.majorGridlineColor");
 	checkChartColor(spec.secondaryValueAxis?.lineColor, "addSlideChart: secondaryValueAxis.lineColor");
+	checkChartColor(spec.dataLabels?.fillColor, "addSlideChart: dataLabels.fillColor");
+	checkChartColor(spec.upDownBars?.upColor, "addSlideChart: upDownBars.upColor");
+	checkChartColor(spec.upDownBars?.downColor, "addSlideChart: upDownBars.downColor");
+	checkChartColor(spec.seriesAxis?.lineColor, "addSlideChart: seriesAxis.lineColor");
 	spec.series.forEach((series, i) => {
 		checkChartColor(series.color, `addSlideChart: series[${i}].color`);
 		checkChartColor(series.lineColor, `addSlideChart: series[${i}].lineColor`);
 		checkChartColor(series.markerColor, `addSlideChart: series[${i}].markerColor`);
 		checkChartColor(series.markerLineColor, `addSlideChart: series[${i}].markerLineColor`);
 		checkChartColor(series.trendline?.color, `addSlideChart: series[${i}].trendline.color`);
+		checkChartColor(series.errorBars?.color, `addSlideChart: series[${i}].errorBars.color`);
+		checkChartColor(series.xErrorBars?.color, `addSlideChart: series[${i}].xErrorBars.color`);
+		checkChartColor(series.dataLabels?.fillColor, `addSlideChart: series[${i}].dataLabels.fillColor`);
+		series.pointDataLabels?.forEach((label, j) => {
+			checkChartColor(label?.fillColor, `addSlideChart: series[${i}].pointDataLabels[${j}].fillColor`);
+		});
 		series.pointColors?.forEach((c, j) => {
 			checkChartColor(c, `addSlideChart: series[${i}].pointColors[${j}]`);
 		});
@@ -8154,9 +9838,10 @@ const validateChartSpecAxes = (spec) => {
 };
 /**
 * Adds a chart to the slide. Returns the new shape handle (kind
-* `graphicFrame`). Authorable chart kinds: `bar`, `column`, `line`,
-* `pie`, `doughnut`, `area`. `scatter`, `radar` and `bubble` are read +
-* render only and are rejected here — see `ChartKind`.
+* `graphicFrame`). Every `ChartKind` is authorable, and the `view3D` /
+* `ofPie` / `surfaceContour` modifiers reach the remaining plot-group
+* elements (3-D bar / line / area / pie, pie-of-pie, contour) — see the
+* table on `ChartKind`.
 *
 * Side effects:
 *
@@ -8170,9 +9855,15 @@ const validateChartSpecAxes = (spec) => {
 *
 * Constraints:
 *
-*   - `pie` charts require exactly one series.
-*   - All series should have at most `categories.length` values; missing
-*     values are treated as blanks (gaps in the visualization).
+*   - `pie` / `doughnut` charts require exactly one series; `stock`
+*     charts exactly three (high, low, close) or four (open first).
+*   - `scatter` / `bubble` series carry their own `xValues` (and
+*     `bubbleSizes`); `categories` is unused for them.
+*   - All other series should have at most `categories.length` values;
+*     missing values are treated as blanks (gaps in the visualization).
+*   - A spec whose fields contradict each other (e.g. `view3D` on a
+*     scatter chart, error bars on a pie) throws instead of writing a
+*     chart PowerPoint would repair.
 */
 const withChartDefaultTextColor = (spec, color) => {
 	if (color === null) return spec;
@@ -8203,6 +9894,7 @@ const withChartDefaultTextColor = (spec, color) => {
 	};
 };
 const addSlideChart = (slide, opts) => {
+	validateChartSpecEnums(opts.spec, "addSlideChart");
 	validateChartSpecColors(opts.spec);
 	validateChartSpecAxes(opts.spec);
 	const spec = withChartDefaultTextColor(opts.spec, resolveDeckBodyTextColor(slide));
@@ -8210,11 +9902,7 @@ const addSlideChart = (slide, opts) => {
 	const chartN = allocateChartIndex(pkg);
 	const chartPartName = partName(`/ppt/charts/chart${chartN}.xml`);
 	const xlsxPartName = partName(`/ppt/embeddings/Microsoft_Excel_Worksheet${chartN}.xlsx`);
-	const xlsxRows = spec.categories.map((label, i) => ({
-		label,
-		values: spec.series.map((s) => s.values[i] ?? null)
-	}));
-	const xlsxBytes = buildEmbeddedXlsx(spec.series.map((s) => s.name), xlsxRows);
+	const xlsxBytes = buildEmbeddedXlsx(layoutChartSheet(spec).grid);
 	const chartBytes = encode$1(serializeXml(buildChartSpaceDoc(spec)));
 	pkg.addPart(chartPartName, CHART_CONTENT_TYPE, chartBytes);
 	pkg.addPart(xlsxPartName, EMBEDDED_XLSX_CONTENT_TYPE, xlsxBytes);
@@ -8288,6 +9976,7 @@ const resolveChartPartName = (slide, shape) => {
 * fresh data."
 */
 const setChartSpec = (chart, spec) => {
+	validateChartSpecEnums(spec, "setChartSpec");
 	validateChartSpecColors(spec);
 	validateChartSpecAxes(spec);
 	const slide = chart.shape[SHAPE_SLIDE];
@@ -8304,12 +9993,7 @@ const setChartSpec = (chart, spec) => {
 		if (xlsxRel) {
 			const xlsxName = xlsxRel.target.startsWith("/") ? partName(xlsxRel.target) : resolveTarget(resolved.partName, xlsxRel.target);
 			const xlsxPart = pkg.getPart(xlsxName);
-			const rows = spec.categories.map((label, i) => ({
-				label,
-				values: spec.series.map((s) => s.values[i] ?? null)
-			}));
-			const xlsxBytes = buildEmbeddedXlsx(spec.series.map((s) => s.name), rows);
-			if (xlsxPart) xlsxPart.data = xlsxBytes;
+			if (xlsxPart) xlsxPart.data = buildEmbeddedXlsx(layoutChartSheet(spec).grid);
 		}
 	}
 };
@@ -8464,7 +10148,9 @@ const getPresentationChartKindCounts = (pres) => {
 		area: 0,
 		scatter: 0,
 		radar: 0,
-		bubble: 0
+		bubble: 0,
+		stock: 0,
+		surface: 0
 	};
 	for (const slide of getSlides(pres)) for (const chart of getSlideCharts(slide)) {
 		if (chart.spec === null) continue;
@@ -9798,6 +11484,7 @@ const ensureCellTxBody = (cell) => {
 		txBody = elem(NAME_A_TX_BODY_TBL);
 		txBody.children.push(elem(qname("a", "bodyPr", NS.dml)));
 		txBody.children.push(elem(qname("a", "lstStyle", NS.dml)));
+		txBody.children.push(elem(qname("a", "p", NS.dml)));
 		tc.children.unshift(txBody);
 	}
 	return txBody;
@@ -9825,7 +11512,7 @@ const setTableCellText = (cell, text) => {
 * `getTableCellParagraphs`.
 */
 const setTableCellParagraphs = (cell, paragraphs) => {
-	const built = buildTextBodyParagraphs(paragraphs);
+	const built = buildTextBodyParagraphs(paragraphs, "setTableCellParagraphs");
 	replaceTextBodyParagraphs(ensureCellTxBody(cell), built);
 	commitTableCell(cell);
 };
@@ -10029,6 +11716,9 @@ const writeBorderLn = (tcPr, local, border) => {
 * cardinal four — a strikethrough cell can have only a diagonal.
 */
 const setTableCellBorders = (cell, sides) => {
+	if (sides !== null) {
+		for (const [side, border] of Object.entries(sides)) if (border?.dash != null) oneOf(border.dash, LINE_DASHES, `setTableCellBorders: ${side}.dash`);
+	}
 	const tcPr = ensureCellTcPr(cell);
 	if (sides === null) for (const local of Object.values(BORDER_SIDE_LOCALS)) writeBorderLn(tcPr, local, null);
 	else for (const [key, local] of Object.entries(BORDER_SIDE_LOCALS)) {
@@ -10061,6 +11751,7 @@ const getTableCellTextDirection = (cell) => {
 * default horizontal direction. Creates `<a:tcPr>` if absent.
 */
 const setTableCellTextDirection = (cell, direction) => {
+	if (direction !== null) oneOf(direction, TEXT_DIRECTIONS, "setTableCellTextDirection: direction");
 	const tcPr = ensureCellTcPr(cell);
 	tcPr.attrs = tcPr.attrs.filter((a) => !(a.name.namespaceURI === "" && a.name.localName === "vert"));
 	if (direction !== null && direction !== "horz") tcPr.attrs.push(attr(qname("", "vert", ""), direction));
@@ -10086,10 +11777,15 @@ const getTableCellAnchor = (cell) => {
 * default (`ctr`). Creates `<a:tcPr>` if absent.
 */
 const setTableCellAnchor = (cell, anchor) => {
+	if (anchor !== null) oneOf(anchor, [
+		"top",
+		"center",
+		"bottom"
+	], "setTableCellAnchor: anchor");
 	const tcPr = ensureCellTcPr(cell);
 	tcPr.attrs = tcPr.attrs.filter((a) => !(a.name.namespaceURI === "" && a.name.localName === "anchor"));
 	if (anchor !== null) {
-		const mapped = anchor === "top" ? "t" : anchor === "center" ? "ctr" : "b";
+		const mapped = TEXT_ANCHORS[anchor];
 		tcPr.attrs.push(attr(qname("", "anchor", ""), mapped));
 	}
 	commitTableCell(cell);
@@ -10237,12 +11933,14 @@ const getTableCellFill = (cell) => {
 };
 /** Applies a TextFormat to every run in the cell's text. */
 const setTableCellTextFormat = (cell, format) => {
-	applyFormatToAllRuns(ensureCellTxBody(cell), format);
+	validateFormatEnums(format, "setTableCellTextFormat");
+	applyValidatedFormatToAllRuns(ensureCellTxBody(cell), format);
 	commitTableCell(cell);
 };
 /** Sets horizontal alignment on every paragraph in the cell. */
 const setTableCellAlignment = (cell, align) => {
-	applyAlignmentToAllParagraphs(ensureCellTxBody(cell), align);
+	const token = alignToken(align, "setTableCellAlignment");
+	applyAlignmentTokenToAllParagraphs(ensureCellTxBody(cell), token);
 	commitTableCell(cell);
 };
 /** Zero-based (row, col) of the cell. */
@@ -10397,7 +12095,7 @@ const PRES_PART = partName("/ppt/presentation.xml");
 const PRES_RELS = partName("/ppt/_rels/presentation.xml.rels");
 const NAME_SLD_ID_LST = qname("p", "sldIdLst", NS.pml);
 const NAME_SLD_ID = qname("p", "sldId", NS.pml);
-const ATTR_ID = qname("", "id", "");
+const ATTR_ID$1 = qname("", "id", "");
 const ATTR_R_ID = qname("r", "id", NS.officeDocRels);
 const decoder = new TextDecoder();
 const decode = (b) => decoder.decode(b);
@@ -10444,7 +12142,7 @@ const validatePresentationPackage = (pkg) => {
 	const seenRIds = /* @__PURE__ */ new Set();
 	const slidePartNames = [];
 	if (sldIdLst !== null) for (const sldId of allChildElements(sldIdLst, NAME_SLD_ID)) {
-		const idRaw = getAttrValue(sldId, ATTR_ID);
+		const idRaw = getAttrValue(sldId, ATTR_ID$1);
 		const rIdRaw = getAttrValue(sldId, ATTR_R_ID);
 		if (idRaw === null) {
 			issues.push({
@@ -10548,7 +12246,7 @@ const validatePresentationPackage = (pkg) => {
 		});
 		for (const rel of slideRels.items) {
 			if (rel.targetMode === "External") continue;
-			if (rel.type !== REL_TYPES.image && rel.type !== REL_TYPES.chart && rel.type !== REL_TYPES.notesSlide && rel.type !== REL_TYPES.comments && rel.type !== REL_TYPES.oleObject && rel.type !== REL_TYPES.package) continue;
+			if (rel.type !== REL_TYPES.image && rel.type !== REL_TYPES.media && rel.type !== REL_TYPES.video && rel.type !== REL_TYPES.audio && rel.type !== REL_TYPES.chart && rel.type !== REL_TYPES.notesSlide && rel.type !== REL_TYPES.comments && rel.type !== REL_TYPES.oleObject && rel.type !== REL_TYPES.package) continue;
 			const targetName = targetPartName(slideName, rel);
 			if (pkg.getPart(targetName) === null) issues.push({
 				severity: "error",
@@ -10582,7 +12280,7 @@ const validatePresentationPackage = (pkg) => {
 				if (!nvHost) continue;
 				const cNvPr = firstChildElement(nvHost, qname("p", "cNvPr", NS.pml));
 				if (!cNvPr) continue;
-				const id = getAttrValue(cNvPr, ATTR_ID);
+				const id = getAttrValue(cNvPr, ATTR_ID$1);
 				if (id === null) continue;
 				seenShapeIds.set(id, (seenShapeIds.get(id) ?? 0) + 1);
 			}
@@ -10593,6 +12291,23 @@ const validatePresentationPackage = (pkg) => {
 			message: `duplicate shape id="${id}" appears ${count}× in slide ${slideName}`,
 			partName: slideName
 		});
+		const timing = firstChildElement(slideRoot, qname("p", "timing", NS.pml));
+		const checkMediaNodes = (host) => {
+			for (const child of host.children) {
+				if (child.kind !== "element") continue;
+				if (!isMediaTimingNode(child)) {
+					checkMediaNodes(child);
+					continue;
+				}
+				const target = mediaTimingNodeTarget(child);
+				if (target !== null && !seenShapeIds.has(String(target))) issues.push({
+					severity: "error",
+					message: `media time node in slide ${slideName} targets missing shape id="${target}"`,
+					partName: slideName
+				});
+			}
+		};
+		if (timing) checkMediaNodes(timing);
 	}
 	for (const part of pkg.parts) {
 		if (part.contentType !== "application/vnd.openxmlformats-officedocument.drawingml.chart+xml") continue;
@@ -10940,8 +12655,9 @@ const getSlideTransition = (slide) => {
 };
 /** Sets the slide's transition effect. */
 const setSlideTransition = (slide, options) => {
+	const transition = buildTransition(options);
 	removeTransition(slide);
-	insertAfterClrMapOvr(slide, buildTransition(options));
+	insertAfterClrMapOvr(slide, transition);
 	commitSlideData(slide);
 	refreshSlideData(slide);
 };
@@ -11514,6 +13230,7 @@ const NAME_SLD_ID_LST_FN = qname("p", "sldIdLst", NS.pml);
 * §19.2.1.26; we insert at the correct position when bootstrapping.
 */
 const setSlideSize = (pres, opts) => {
+	if (opts.type !== void 0) oneOf(opts.type, SLIDE_SIZE_TYPES, "setSlideSize: type");
 	const presPart = pres[INTERNAL_PACKAGE].getPart(PRES_PART_NAME);
 	if (!presPart) throw new Error("presentation.xml is missing");
 	const doc = parseXml(decode$1(presPart.data));
@@ -12066,6 +13783,83 @@ const setShapeImageCrop = (shape, crop) => {
 	commitAndRefresh(shape);
 };
 //#endregion
+//#region src/api/fn/_media-timing.ts
+const NAME_TIMING = qname("p", "timing", NS.pml);
+const NAME_TN_LST = qname("p", "tnLst", NS.pml);
+const NAME_PAR = qname("p", "par", NS.pml);
+const NAME_C_TN = qname("p", "cTn", NS.pml);
+const NAME_CHILD_TN_LST = qname("p", "childTnLst", NS.pml);
+const NAME_EXT_LST$1 = qname("p", "extLst", NS.pml);
+const ATTR_ID = qname("", "id", "");
+const findSlideTiming = (slide) => firstChildElement(slide[SLIDE_DOCUMENT].root, NAME_TIMING);
+const insertSlideTiming = (slide, timing) => {
+	const root = slide[SLIDE_DOCUMENT].root;
+	const extLst = firstChildElement(root, NAME_EXT_LST$1);
+	if (extLst === null) root.children.push(timing);
+	else root.children.splice(root.children.indexOf(extLst), 0, timing);
+};
+/** The root time node's `<p:childTnLst>` — where media nodes and sequences live. */
+const rootChildTnLst = (timing) => {
+	const tnLst = firstChildElement(timing, NAME_TN_LST);
+	const par = tnLst ? firstChildElement(tnLst, NAME_PAR) : null;
+	const cTn = par ? firstChildElement(par, NAME_C_TN) : null;
+	return cTn ? firstChildElement(cTn, NAME_CHILD_TN_LST) : null;
+};
+const maxCTnId = (el) => {
+	let max = 0;
+	const walk = (e) => {
+		if (e.name.namespaceURI === NS.pml && e.name.localName === "cTn") {
+			const n = Number.parseInt(getAttrValue(e, ATTR_ID) ?? "", 10);
+			if (Number.isFinite(n) && n > max) max = n;
+		}
+		for (const c of e.children) if (c.kind === "element") walk(c);
+	};
+	walk(el);
+	return max;
+};
+/** Adds the media time node for shape `spid`. The caller commits the slide. */
+const addMediaTimingNode = (slide, kind, spid) => {
+	const timing = findSlideTiming(slide);
+	if (timing === null) {
+		insertSlideTiming(slide, buildTimingRoot([buildMediaTimingNode(kind, spid, 2)]));
+		return;
+	}
+	const node = buildMediaTimingNode(kind, spid, maxCTnId(timing) + 1);
+	const childTnLst = rootChildTnLst(timing);
+	if (childTnLst !== null) {
+		childTnLst.children.push(node);
+		return;
+	}
+	const fresh = buildTimingRoot([node]);
+	const rest = timing.children.filter((c) => !(c.kind === "element" && c.name.namespaceURI === NS.pml && c.name.localName === "tnLst"));
+	timing.children = [...fresh.children, ...rest];
+};
+/**
+* Removes the media nodes targeting any of `spids`, and the whole `<p:timing>`
+* when that leaves the root without children (an empty `<p:childTnLst>` is
+* schema-invalid and an empty root animates nothing). The caller commits.
+*/
+const removeMediaTimingNodes = (slide, spids) => {
+	const timing = findSlideTiming(slide);
+	const childTnLst = timing ? rootChildTnLst(timing) : null;
+	if (timing === null || childTnLst === null) return;
+	childTnLst.children = childTnLst.children.filter((c) => {
+		if (c.kind !== "element" || !isMediaTimingNode(c)) return true;
+		const target = mediaTimingNodeTarget(c);
+		return target === null || !spids.has(target);
+	});
+	if (!childTnLst.children.some((c) => c.kind === "element")) {
+		const root = slide[SLIDE_DOCUMENT].root;
+		root.children = root.children.filter((c) => c !== timing);
+	}
+};
+/** Media nodes at the timing root, in document order. */
+const mediaTimingNodes = (timing) => {
+	const childTnLst = rootChildTnLst(timing);
+	if (childTnLst === null) return [];
+	return childTnLst.children.filter((c) => c.kind === "element" && isMediaTimingNode(c));
+};
+//#endregion
 //#region src/api/fn/shape-animation.ts
 NS.pml;
 const ATTR_ID_FN = qname("", "id", "");
@@ -12085,18 +13879,6 @@ const findDescendant = (el, pred) => {
 	return null;
 };
 const isPml = (el, local) => el.name.namespaceURI === NS.pml && el.name.localName === local;
-const maxCTnId = (el) => {
-	let max = 0;
-	const walk = (e) => {
-		if (isPml(e, "cTn")) {
-			const n = Number.parseInt(getAttrValue(e, ATTR_ID_FN) ?? "", 10);
-			if (Number.isFinite(n) && n > max) max = n;
-		}
-		for (const c of e.children) if (c.kind === "element") walk(c);
-	};
-	walk(el);
-	return max;
-};
 const shiftCTnIds = (el, offset) => {
 	const walk = (e) => {
 		if (isPml(e, "cTn")) {
@@ -12130,29 +13912,40 @@ const setGrpId = (el, grpId) => {
 		value: grpId
 	} : a);
 };
+const isMainSeqCTn = (e) => isPml(e, "cTn") && getAttrValue(e, qname("", "nodeType", "")) === "mainSeq";
 const mergeEffectInto = (existing, fresh) => {
-	const existingMainSeqChildTnLst = (() => {
-		const mainSeq = findDescendant(existing, (e) => isPml(e, "cTn") && getAttrValue(e, qname("", "nodeType", "")) === "mainSeq");
-		return mainSeq ? firstChildElement(mainSeq, qname("p", "childTnLst", NS.pml)) : null;
-	})();
-	if (!existingMainSeqChildTnLst) return false;
-	const freshMainSeq = findDescendant(fresh, (e) => isPml(e, "cTn") && getAttrValue(e, qname("", "nodeType", "")) === "mainSeq");
+	const freshMainSeq = findDescendant(fresh, isMainSeqCTn);
 	const freshChildTnLst = freshMainSeq ? firstChildElement(freshMainSeq, qname("p", "childTnLst", NS.pml)) : null;
 	const newPar = freshChildTnLst ? freshChildTnLst.children.find((c) => c.kind === "element" && isPml(c, "par")) : null;
 	const freshBldP = findDescendant(fresh, (e) => isPml(e, "bldP"));
 	if (!newPar || !freshBldP) return false;
-	const offset = maxCTnId(existing) - 2;
-	if (offset > 0) shiftCTnIds(newPar, offset);
 	const newGrpId = String(maxGrpId(existing) + 1);
 	const effectCTn = findDescendant(newPar, (e) => getAttrValue(e, qname("", "presetID", "")) !== null);
+	const existingMainSeq = findDescendant(existing, isMainSeqCTn);
+	const existingMainSeqChildTnLst = existingMainSeq ? firstChildElement(existingMainSeq, qname("p", "childTnLst", NS.pml)) : null;
+	if (existingMainSeqChildTnLst) {
+		const offset = maxCTnId(existing) - 2;
+		if (offset > 0) shiftCTnIds(newPar, offset);
+		existingMainSeqChildTnLst.children.push(newPar);
+	} else {
+		const rootList = rootChildTnLst(existing);
+		const freshSeq = rootChildTnLst(fresh)?.children.find((c) => c.kind === "element" && isPml(c, "seq"));
+		if (!rootList || !freshSeq) return false;
+		shiftCTnIds(freshSeq, maxCTnId(existing) - 1);
+		rootList.children.unshift(freshSeq);
+	}
 	if (effectCTn) setGrpId(effectCTn, newGrpId);
 	setGrpId(freshBldP, newGrpId);
-	existingMainSeqChildTnLst.children.push(newPar);
 	const existingBldLst = findDescendant(existing, (e) => isPml(e, "bldLst"));
 	if (existingBldLst) existingBldLst.children.push(freshBldP);
-	else existing.children.push(elem(qname("p", "bldLst", NS.pml), { children: [freshBldP] }));
+	else insertBldLst(existing, elem(qname("p", "bldLst", NS.pml), { children: [freshBldP] }));
 	return true;
 };
+const insertBldLst = (timing, bldLst) => {
+	const extLst = firstChildElement(timing, qname("p", "extLst", NS.pml));
+	if (extLst === null) timing.children.push(bldLst);
+	else timing.children.splice(timing.children.indexOf(extLst), 0, bldLst);
+};
 /**
 * Sets a single click-triggered animation effect on the given shape.
 *
@@ -12240,7 +14033,12 @@ const findShapesWithAnimation = (slide) => {
 	return out;
 };
 const clearSlideAnimations = (slide) => {
-	removeExistingTiming(slide);
+	const existing = findTiming(slide);
+	const mediaNodes = existing ? mediaTimingNodes(existing) : [];
+	if (existing !== null && mediaNodes.length > 0) {
+		const root = slide[SLIDE_DOCUMENT].root;
+		root.children[root.children.indexOf(existing)] = buildTimingRoot(mediaNodes);
+	} else removeExistingTiming(slide);
 	commitSlideData(slide);
 	refreshSlideData(slide);
 };
@@ -12585,35 +14383,23 @@ const ensurePPr = (paragraph) => {
 	paragraph.children.unshift(fresh);
 	return fresh;
 };
-const alignTokenForFn = (a) => {
-	switch (a) {
-		case "left":
-		case "l": return "l";
-		case "center":
-		case "ctr": return "ctr";
-		case "right":
-		case "r": return "r";
-		case "justify":
-		case "just": return "just";
-		case "distribute":
-		case "dist": return "dist";
-		default: return a;
-	}
-};
 /**
 * Sets the horizontal alignment of a single paragraph. Same token set
 * as `setShapeAlignment`. Other paragraphs are untouched.
 */
 const setParagraphAlignment = (shape, paragraphIndex, align) => {
+	const token = alignToken(align, "setParagraphAlignment");
 	const pPr = ensurePPr(requireParagraph(shape, paragraphIndex));
 	pPr.attrs = pPr.attrs.filter((a) => a.name.localName !== "algn");
-	pPr.attrs.push(attr(ATTR_ALGN_FN, alignTokenForFn(align)));
+	pPr.attrs.push(attr(ATTR_ALGN_FN, token));
 	commitAndRefresh(shape);
 };
 /**
 * Sets the paragraph's nesting level (`<a:pPr lvl="N"/>`). Levels are
 * 0-indexed; PowerPoint accepts 0 through 8. Pass `0` to clear an
 * existing level — `<a:pPr lvl="0"/>` is the same as omitting the attr.
+* Indents matching the previous level's default bullet pair follow the level;
+* other indent values are preserved.
 *
 * Used in tandem with bullets to author nested lists:
 *
@@ -12624,8 +14410,10 @@ const setParagraphAlignment = (shape, paragraphIndex, align) => {
 const setParagraphLevel = (shape, paragraphIndex, level) => {
 	if (!Number.isInteger(level) || level < 0 || level > 8) throw new RangeError(`paragraph level must be an integer in [0, 8], got ${level}`);
 	const pPr = ensurePPr(requireParagraph(shape, paragraphIndex));
+	const previousLevel = Number.parseInt(getAttrValue(pPr, ATTR_LVL) ?? "0", 10);
 	pPr.attrs = pPr.attrs.filter((a) => a.name.localName !== "lvl");
 	if (level > 0) pPr.attrs.push(attr(ATTR_LVL, String(level)));
+	updateBulletIndentForLevel(pPr, Number.isFinite(previousLevel) ? previousLevel : 0, level);
 	commitAndRefresh(shape);
 };
 /**
@@ -15304,8 +17092,7 @@ const setShapeText = (shape, value, options = {}) => {
 	if (shape[SHAPE_SNAPSHOT].kind !== "shape") throw new Error(`setShapeText only works on text-bearing shapes; ${shape[SHAPE_SNAPSHOT].kind} is not one`);
 	const txBody = firstChildElement(shape[SHAPE_ELEMENT], NAME_TX_BODY);
 	if (txBody === null) throw new Error(`shape "${shape[SHAPE_SNAPSHOT].name}" has no <p:txBody>`);
-	setTextBody(txBody, value);
-	if (options.bullets !== void 0) applyBulletToAllParagraphs(txBody, options.bullets);
+	setTextBody(txBody, value, options.bullets);
 	commitAndRefresh(shape);
 };
 /**
@@ -15348,6 +17135,7 @@ const requireBodyPr = (shape) => {
 * Throws for non-text-bearing shape kinds.
 */
 const setShapeTextWrap = (shape, wrap) => {
+	oneOf(wrap, ["none", "square"], "setShapeTextWrap: wrap");
 	const bodyPr = requireBodyPr(shape);
 	const ATTR_WRAP = qname("", "wrap", "");
 	bodyPr.attrs = bodyPr.attrs.filter((a) => !(a.name.namespaceURI === "" && a.name.localName === "wrap"));
@@ -15375,9 +17163,18 @@ const getShapeTextWrap = (shape) => {
 * non-text-bearing shape kinds.
 */
 const setShapeTextAutoFit = (shape, mode) => {
+	oneOf(mode, [
+		"none",
+		"normal",
+		"shape"
+	], "setShapeTextAutoFit: mode");
 	const bodyPr = requireBodyPr(shape);
 	bodyPr.children = bodyPr.children.filter((c) => !(c.kind === "element" && c.name.namespaceURI === NS.dml && AUTO_FIT_LOCALS.has(c.name.localName)));
-	const local = mode === "none" ? "noAutofit" : mode === "normal" ? "normAutofit" : "spAutoFit";
+	const local = {
+		none: "noAutofit",
+		normal: "normAutofit",
+		shape: "spAutoFit"
+	}[mode];
 	bodyPr.children.push(elem(qname("a", local, NS.dml)));
 	commitAndRefresh(shape);
 };
@@ -15570,6 +17367,7 @@ const getShapeTextDirection = (shape) => {
 * horizontal direction. Throws for non-text-bearing shape kinds.
 */
 const setShapeTextDirection = (shape, direction) => {
+	if (direction !== null) oneOf(direction, TEXT_DIRECTIONS, "setShapeTextDirection: direction");
 	const bodyPr = requireBodyPr(shape);
 	bodyPr.attrs = bodyPr.attrs.filter((a) => !(a.name.namespaceURI === "" && a.name.localName === "vert"));
 	if (direction !== null && direction !== "horz") bodyPr.attrs.push(attr(qname("", "vert", ""), direction));
@@ -15686,13 +17484,18 @@ const getShapeBodyPrEffective = (pres, shape) => {
 	return result;
 };
 const setShapeTextAnchor = (shape, anchor) => {
+	oneOf(anchor, [
+		"top",
+		"center",
+		"bottom"
+	], "setShapeTextAnchor: anchor");
 	const txBody = requireTxBody(shape);
 	let bodyPr = firstChildElement(txBody, NAME_A_BODY_PR);
 	if (bodyPr === null) {
 		bodyPr = elem(NAME_A_BODY_PR);
 		txBody.children.unshift(bodyPr);
 	}
-	const token = anchor === "top" ? "t" : anchor === "center" ? "ctr" : "b";
+	const token = TEXT_ANCHORS[anchor];
 	const ATTR_ANCHOR = qname("", "anchor", "");
 	bodyPr.attrs = bodyPr.attrs.filter((a) => !(a.name.namespaceURI === "" && a.name.localName === "anchor"));
 	bodyPr.attrs.push(attr(ATTR_ANCHOR, token));
@@ -15756,7 +17559,7 @@ const setShapeAlignment = (shape, align) => {
 * updates compose.
 */
 const setShapeTextFormat = (shape, format) => {
-	applyFormatToAllRuns(requireTxBody(shape), format);
+	applyFormatToAllRuns(requireTxBody(shape), format, "setShapeTextFormat");
 	commitAndRefresh(shape);
 };
 /**
@@ -15791,7 +17594,8 @@ const copyShape = (targetSlide, sourceShape) => {
 	const pkg = targetSlide[INTERNAL_PACKAGE];
 	const sourceEl = sourceShape[SHAPE_ELEMENT];
 	const cloned = cloneXmlElement(sourceEl);
-	rewriteCNvPrId(cloned, nextShapeId(targetSlide));
+	const newId = nextShapeId(targetSlide);
+	rewriteCNvPrId(cloned, newId);
 	const sourceRels = pkg.getRels(sourceSlide[SLIDE_PART_NAME]);
 	if (sourceRels) {
 		const targetRels = pkg.getRels(targetSlide[SLIDE_PART_NAME]) ?? emptyRels();
@@ -15811,6 +17615,8 @@ const copyShape = (targetSlide, sourceShape) => {
 		});
 		pkg.setRels(targetSlide[SLIDE_PART_NAME], targetRels);
 	}
+	const media = cloned.name.localName === "pic" ? readPictureMediaRef(cloned) : null;
+	if (media !== null) addMediaTimingNode(targetSlide, media.kind, newId);
 	return appendAndReturnNewShape(targetSlide, cloned);
 };
 /** Recursively clone an XML element (no parent, deep). */
@@ -15995,7 +17801,13 @@ const sendShapeBackward = (shape) => {
 */
 const clearSlideShapes = (slide) => {
 	const spTree = requireSpTree(slide);
-	spTree.children = spTree.children.filter((c) => !(c.kind === "element" && c.name.namespaceURI === NS.pml && SHAPE_CHILD_LOCALS.has(c.name.localName)));
+	const removedIds = /* @__PURE__ */ new Set();
+	spTree.children = spTree.children.filter((c) => {
+		const isShape = c.kind === "element" && c.name.namespaceURI === NS.pml && SHAPE_CHILD_LOCALS.has(c.name.localName);
+		if (isShape) collectShapeIds(c, removedIds);
+		return !isShape;
+	});
+	removeMediaTimingNodes(slide, removedIds);
 	commitSlideData(slide);
 	rebuildShapesFromDocument(slide);
 };
@@ -16009,9 +17821,20 @@ const removeShape = (shape) => {
 	const idx = spTree.children.indexOf(shape[SHAPE_ELEMENT]);
 	if (idx < 0) return;
 	spTree.children.splice(idx, 1);
+	const removedIds = /* @__PURE__ */ new Set();
+	collectShapeIds(shape[SHAPE_ELEMENT], removedIds);
+	removeMediaTimingNodes(slide, removedIds);
 	commitSlideData(slide);
 	rebuildShapesFromDocument(slide);
 };
+const collectShapeIds = (el, into) => {
+	if (el.name.namespaceURI === NS.pml && el.name.localName === "cNvPr") {
+		const id = Number.parseInt(getAttrValue(el, qname("", "id", "")) ?? "", 10);
+		if (Number.isFinite(id)) into.add(id);
+		return;
+	}
+	for (const c of el.children) if (c.kind === "element") collectShapeIds(c, into);
+};
 //#endregion
 //#region src/api/fn/shape-authoring.ts
 /**
@@ -16839,7 +18662,7 @@ const ensureSldIdLst = (presentationRoot) => {
 const allocateSldId = (sldIdLst) => {
 	let max = 255;
 	for (const sldId of allChildElements(sldIdLst, NAME_SLD_ID$1)) {
-		const raw = getAttrValue(sldId, ATTR_ID$1);
+		const raw = getAttrValue(sldId, ATTR_ID$2);
 		if (raw === null) continue;
 		const n = Number.parseInt(raw, 10);
 		if (Number.isFinite(n) && n > max) max = n;
@@ -16970,7 +18793,7 @@ const addSlide = (pres, options) => {
 		targetMode: "Internal"
 	});
 	pkg.setRels(PRES_PART_NAME, presRels);
-	sldIdLst.children.push(elem(NAME_SLD_ID$1, { attrs: [attr(ATTR_ID$1, String(newSldId)), attr(ATTR_R_ID$1, newRId)] }));
+	sldIdLst.children.push(elem(NAME_SLD_ID$1, { attrs: [attr(ATTR_ID$2, String(newSldId)), attr(ATTR_R_ID$1, newRId)] }));
 	presPart.data = encode$1(serializeXml(presDoc));
 	pres._slidesCache = null;
 	const slides = getSlides(pres);
@@ -17149,7 +18972,7 @@ const duplicateSlide = (pres, slide) => {
 		targetMode: "Internal"
 	});
 	pkg.setRels(PRES_PART_NAME, presRels);
-	sldIdLst.children.push(elem(NAME_SLD_ID$1, { attrs: [attr(ATTR_ID$1, String(newSldId)), attr(ATTR_R_ID$1, newRId)] }));
+	sldIdLst.children.push(elem(NAME_SLD_ID$1, { attrs: [attr(ATTR_ID$2, String(newSldId)), attr(ATTR_R_ID$1, newRId)] }));
 	presPart.data = encode$1(serializeXml(presDoc));
 	pres._slidesCache = null;
 	const slides = getSlides(pres);
@@ -17179,6 +19002,12 @@ const collectRelRefs = (el, into) => {
 	for (const a of el.attrs) if (a.name.namespaceURI === NS.officeDocRels) into.add(a.value);
 	for (const c of el.children) if (c.kind === "element") collectRelRefs(c, into);
 };
+const IMPORTED_MEDIA_REL_TYPES = new Set([
+	REL_TYPES.image,
+	REL_TYPES.media,
+	REL_TYPES.video,
+	REL_TYPES.audio
+]);
 const pruneDanglingGraphicFrames = (el, keptRelIds) => {
 	el.children = el.children.filter((c) => {
 		if (c.kind !== "element") return true;
@@ -17200,8 +19029,8 @@ const pruneDanglingGraphicFrames = (el, keptRelIds) => {
 *
 * Limitations (v1):
 *
-*   - Only `image` rels are copied across. Other rels (charts, embedded
-*     workbooks, oleObjects, comments) are dropped from the imported
+*   - Only image / video / audio rels are copied across. Other rels (charts,
+*     embedded workbooks, oleObjects, comments) are dropped from the imported
 *     slide. A diagnostic message is appended for each dropped rel.
 *   - Hyperlinks (external URLs) are preserved.
 *   - Slide → notesSlide is dropped (notes don't follow imports).
@@ -17233,31 +19062,42 @@ const importSlide = (targetPres, sourceSlide, targetLayout) => {
 		target: `../slideLayouts/${basename(layoutPartName)}`,
 		targetMode: "Internal"
 	});
+	const importedMedia = /* @__PURE__ */ new Map();
 	if (sourceRels !== null) for (const rel of sourceRels.items) {
 		if (rel.type === REL_TYPES.slideLayout) continue;
 		if (rel.type === REL_TYPES.notesSlide) continue;
-		if (rel.type === REL_TYPES.image && rel.targetMode === "Internal") {
+		if (IMPORTED_MEDIA_REL_TYPES.has(rel.type)) {
+			if (rel.targetMode === "External") {
+				newRels.items.push({ ...rel });
+				continue;
+			}
 			const mediaName = rel.target.startsWith("/") ? partName(rel.target) : resolveTarget(sourcePartName, rel.target);
-			const mediaPart = sourcePkg.getPart(mediaName);
-			if (!mediaPart) continue;
-			const dotIdx = mediaName.lastIndexOf(".");
-			const extension = dotIdx >= 0 ? mediaName.slice(dotIdx + 1) : "bin";
-			let nextN = 1;
-			const re = /^\/ppt\/media\/image(\d+)\./;
-			for (const p of targetPkg.parts) {
-				const m = p.name.match(re);
-				if (m?.[1] !== void 0) {
-					const n = Number.parseInt(m[1], 10);
-					if (Number.isFinite(n) && n >= nextN) nextN = n + 1;
+			let target = importedMedia.get(mediaName);
+			if (target === void 0) {
+				const mediaPart = sourcePkg.getPart(mediaName);
+				if (!mediaPart) continue;
+				const dotIdx = mediaName.lastIndexOf(".");
+				const extension = dotIdx >= 0 ? mediaName.slice(dotIdx + 1) : "bin";
+				const stem = rel.type === REL_TYPES.image ? "image" : "media";
+				let nextN = 1;
+				const re = new RegExp(`^/ppt/media/${stem}(\\d+)\\.`);
+				for (const p of targetPkg.parts) {
+					const m = p.name.match(re);
+					if (m?.[1] !== void 0) {
+						const n = Number.parseInt(m[1], 10);
+						if (Number.isFinite(n) && n >= nextN) nextN = n + 1;
+					}
 				}
+				const newMediaName = partName(`/ppt/media/${stem}${nextN}.${extension}`);
+				setOpcDefault(targetPkg, extension.toLowerCase(), mediaPart.contentType);
+				targetPkg.addPart(newMediaName, mediaPart.contentType, new Uint8Array(mediaPart.data));
+				target = `../media/${stem}${nextN}.${extension}`;
+				importedMedia.set(mediaName, target);
 			}
-			const newMediaName = partName(`/ppt/media/image${nextN}.${extension}`);
-			setOpcDefault(targetPkg, extension.toLowerCase(), mediaPart.contentType);
-			targetPkg.addPart(newMediaName, mediaPart.contentType, new Uint8Array(mediaPart.data));
 			newRels.items.push({
 				id: rel.id,
-				type: REL_TYPES.image,
-				target: `../media/image${nextN}.${extension}`,
+				type: rel.type,
+				target,
 				targetMode: "Internal"
 			});
 			continue;
@@ -17293,7 +19133,7 @@ const importSlide = (targetPres, sourceSlide, targetLayout) => {
 		targetMode: "Internal"
 	});
 	targetPkg.setRels(PRES_PART_NAME, presRels);
-	sldIdLst.children.push(elem(NAME_SLD_ID$1, { attrs: [attr(ATTR_ID$1, String(newSldId)), attr(ATTR_R_ID$1, newRId)] }));
+	sldIdLst.children.push(elem(NAME_SLD_ID$1, { attrs: [attr(ATTR_ID$2, String(newSldId)), attr(ATTR_R_ID$1, newRId)] }));
 	presPart.data = encode$1(serializeXml(presDoc));
 	targetPres._slidesCache = null;
 	const slides = getSlides(targetPres);
@@ -17436,9 +19276,204 @@ const ungroupShapes = (group) => {
 	});
 };
 //#endregion
+//#region src/api/fn/media.ts
+const DEFAULT_POSTER_BASE64 = "iVBORw0KGgoAAAANSUhEUgAAAUAAAAC0AQMAAADfKmdSAAAABlBMVEUmJib///+/9FOwAAAAvUlEQVR42u3XMQ7DIBAEQOfnfhpP4QmUFAgiJUqdKa6xtFtPA8J36+tKkiRJkiR5RF4Mm8KucCrcCg/DpnAoXAq3wnMr7AqnwqXwMGwKu8KpcCukK//ApnAoXAq3QjnNF3aFU+FSeBg2hUPhVLgV/r/yH2wKRzls1YfZ5Rc+yh9F+cOd5R/XXT0AVvmQatWDlEczD3teH7yQypcmr2Fe7FoVuHxwneGCxJWrvBZy0eTqymU4fxhJkiRJkjwqbzMmJGbQfp8bAAAAAElFTkSuQmCC";
+const defaultPoster = () => Uint8Array.from(atob(DEFAULT_POSTER_BASE64), (ch) => ch.charCodeAt(0));
+const YOUTUBE_HOSTS = new Set([
+	"youtube.com",
+	"www.youtube.com",
+	"m.youtube.com"
+]);
+const YOUTUBE_SHORT_HOST = "youtu.be";
+const YOUTUBE_ID = /^[A-Za-z0-9_-]+$/;
+const youtubeVideoId = (url) => {
+	const segments = url.pathname.split("/").filter((s) => s !== "");
+	if (url.hostname === YOUTUBE_SHORT_HOST) return segments[0] ?? null;
+	if (!YOUTUBE_HOSTS.has(url.hostname)) return null;
+	if (segments[0] === "watch") return url.searchParams.get("v");
+	if (segments[0] === "shorts" || segments[0] === "live") return segments[1] ?? null;
+	return null;
+};
+const resolveOnlineVideoUrl = (input) => {
+	let url;
+	try {
+		url = new URL(input);
+	} catch {
+		throw new Error(`addSlideMedia: url is not an absolute URL: ${JSON.stringify(input)}`);
+	}
+	if (url.protocol !== "http:" && url.protocol !== "https:") throw new Error(`addSlideMedia: url must be http(s), got ${JSON.stringify(input)}`);
+	const id = youtubeVideoId(url);
+	if (id === null || !YOUTUBE_ID.test(id)) return url.href;
+	return `https://www.youtube.com/embed/${id}?feature=oembed`;
+};
+const MEDIA_DIR = "/ppt/media/";
+const nextMediaPartName = (pkg, stem, extension) => {
+	let nextN = 1;
+	const pattern = new RegExp(`^/ppt/media/${stem}(\\d+)\\.`);
+	for (const p of pkg.parts) {
+		const m = p.name.match(pattern);
+		if (m?.[1] !== void 0) {
+			const n = Number.parseInt(m[1], 10);
+			if (n >= nextN) nextN = n + 1;
+		}
+	}
+	return partName(`${MEDIA_DIR}${stem}${nextN}.${extension}`);
+};
+const bytesEqual = (a, b) => {
+	if (a.length !== b.length) return false;
+	for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) return false;
+	return true;
+};
+const internClipPart = (pkg, extension, contentType, bytes) => {
+	for (const p of pkg.parts) if (p.name.startsWith(MEDIA_DIR) && p.contentType === contentType && bytesEqual(p.data, bytes)) return p.name;
+	const name = nextMediaPartName(pkg, "media", extension);
+	setOpcDefault(pkg, extension, contentType);
+	pkg.addPart(name, contentType, bytes);
+	return name;
+};
+const resolveSource = (source) => {
+	switch (source.kind) {
+		case "online": return { url: resolveOnlineVideoUrl(source.url) };
+		case "video": {
+			const format = source.format ?? detectVideoFormat(source.data);
+			if (format === null) throw new Error("addSlideMedia: could not detect the video format. Pass options.format explicitly.");
+			const contentType = contentTypeForVideoFormat(format);
+			return {
+				data: source.data,
+				extension: format,
+				contentType
+			};
+		}
+		case "audio": {
+			const format = source.format ?? detectAudioFormat(source.data);
+			if (format === null) throw new Error("addSlideMedia: could not detect the audio format. Pass options.format explicitly.");
+			const contentType = contentTypeForAudioFormat(format);
+			return {
+				data: source.data,
+				extension: format,
+				contentType
+			};
+		}
+	}
+};
+const DEFAULT_NAME_PREFIX = {
+	video: "Video",
+	audio: "Audio",
+	online: "Online Media"
+};
+/**
+* Adds a video, an audio clip or an online (URL) video to the slide. Returns
+* the new picture shape — the clip's poster frame.
+*
+* Embedded clips are stored once per package: adding the same bytes again
+* reuses the existing `/ppt/media/mediaN.<ext>` part. The container format is
+* detected from the bytes (mp4 / m4v / mov / webm / avi / wmv, mp3 / wav / m4a /
+* ogg / wma); pass `format` for anything the signature check cannot tell.
+* Whether a clip plays depends on the codecs of the viewing application.
+*
+* The shape is an ordinary picture: `getShapeImageBytes` / `setShapeImage`
+* read and replace the poster, `getShapeMedia` reads the clip.
+*/
+const addSlideMedia = (slide, opts) => {
+	const x = emuCoordinate(opts.x, "addSlideMedia: x");
+	const y = emuCoordinate(opts.y, "addSlideMedia: y");
+	const w = emuExtent(opts.w, "addSlideMedia: w");
+	const h = emuExtent(opts.h, "addSlideMedia: h");
+	const source = resolveSource(opts);
+	const poster = opts.poster ?? defaultPoster();
+	const posterFormat = opts.posterFormat ?? detectImageFormat(poster);
+	if (posterFormat === null) throw new Error("addSlideMedia: could not detect the poster image format. Pass options.posterFormat explicitly.");
+	const pkg = slide[INTERNAL_PACKAGE];
+	const slidePartName = slide[SLIDE_PART_NAME];
+	const rels = pkg.getRels(slidePartName) ?? emptyRels();
+	const usedIds = rels.items.map((r) => r.id);
+	const relate = (type, target, targetMode) => {
+		const existing = rels.items.find((r) => r.type === type && r.target === target && r.targetMode === targetMode);
+		if (existing) return existing.id;
+		const id = nextRelId(usedIds);
+		usedIds.push(id);
+		rels.items.push({
+			id,
+			type,
+			target,
+			targetMode
+		});
+		return id;
+	};
+	const relativeTarget = (name) => `../media/${name.slice(11)}`;
+	const kind = opts.kind === "audio" ? "audio" : "video";
+	const fileRelType = kind === "audio" ? REL_TYPES.audio : REL_TYPES.video;
+	let rLink;
+	let rMedia;
+	if ("url" in source) rLink = relate(fileRelType, source.url, "External");
+	else {
+		const clipPart = internClipPart(pkg, source.extension, source.contentType, source.data);
+		rMedia = relate(REL_TYPES.media, relativeTarget(clipPart), "Internal");
+		rLink = relate(fileRelType, relativeTarget(clipPart), "Internal");
+	}
+	const posterExtension = extensionForFormat(posterFormat);
+	const posterContentType = contentTypeForFormat(posterFormat);
+	const posterPart = nextMediaPartName(pkg, "image", posterExtension);
+	setOpcDefault(pkg, posterExtension, posterContentType);
+	pkg.addPart(posterPart, posterContentType, poster);
+	const rPoster = relate(REL_TYPES.image, relativeTarget(posterPart), "Internal");
+	pkg.setRels(slidePartName, rels);
+	const id = nextShapeId(slide);
+	const pic = buildMediaPicture({
+		id,
+		name: opts.name ?? `${DEFAULT_NAME_PREFIX[opts.kind]} ${id}`,
+		kind,
+		rLink,
+		...rMedia !== void 0 ? { rMedia } : {},
+		rEmbed: rPoster,
+		x,
+		y,
+		w,
+		h
+	});
+	addMediaTimingNode(slide, kind, id);
+	return appendAndReturnNewShape(slide, pic);
+};
+/**
+* Returns the clip behind a media picture, or `null` when the shape is not
+* one. Reads PowerPoint-, PptxGenJS- and python-pptx-authored media alike: the
+* embedded part is taken from `<p14:media r:embed>` when present and from the
+* DrawingML `r:link` otherwise; a relationship with an external target is
+* reported as `'online'`.
+*/
+const getShapeMedia = (shape) => {
+	if (shape[SHAPE_SNAPSHOT].kind !== "picture") return null;
+	const ref = readPictureMediaRef(shape[SHAPE_ELEMENT]);
+	if (ref === null) return null;
+	const slide = shape[SHAPE_SLIDE];
+	const pkg = slide[INTERNAL_PACKAGE];
+	const rels = pkg.getRels(slide[SLIDE_PART_NAME]);
+	if (rels === null) return null;
+	const relsById = new Map(rels.items.map((r) => [r.id, r]));
+	for (const rId of [ref.mediaRId, ref.fileRId]) {
+		const rel = rId === null ? void 0 : relsById.get(rId);
+		if (rel === void 0) continue;
+		if (rel.targetMode === "External") return {
+			kind: "online",
+			url: rel.target
+		};
+		const name = rel.target.startsWith("/") ? partName(rel.target) : resolveTarget(slide[SLIDE_PART_NAME], rel.target);
+		const part = pkg.getPart(name);
+		if (part) return {
+			kind: ref.kind,
+			partName: part.name,
+			contentType: part.contentType,
+			bytes: part.data
+		};
+	}
+	return null;
+};
+/** Every shape on the slide that `getShapeMedia` reports a clip for. */
+const findShapesWithMedia = (slide) => slide[SLIDE_SHAPES].filter((shape) => getShapeMedia(shape) !== null);
+//#endregion
 //#region src/api/index.ts
-const VERSION = "0.16.1";
+const VERSION = "0.18.0";
 //#endregion
-export { slideHasAnimations as $, getTableCellMargins as $a, clearSlideHyperlinks as $i, getShapeText as $n, getSlideLayouts as $o, getShapeRunCount as $r, getCommentAuthor as $s, getShapeStrokeColorResolved as $t, getPresentationTextLength as A, clearSlideTransition as Aa, getShapeImageContrast as Ai, findShapesAtPoint as An, setTableStyleFlags as Ao, setShapeSize as Ar, getSlideLayoutBackgroundImageBytes as As, setShapeTextBodyRotationDeg as At, getSlideText as B, listPackageParts as Ba, isShapeImageGrayscale as Bi, getShapeCenter as Bn, setCoreProperties as Bo, getParagraphAlignment as Br, setSlideBackgroundImage as Bs, getShapeEffectsEffective as Bt, findSlideByTitle as C, getSlidesWithOverlap as Ca, pt as Cc, findSlidesByLayoutName as Ci, getSlideLayout as Cn, setTableCellMargins as Co, setShapeGradientFill as Cr, getSlideBackground as Cs, getShapeTextWrap as Ct, getOutlineText as D, removeSlideNotes as Da, getShapeImageBiLevelThreshold as Di, setSlideLayout as Dn, setTableCellTextFormat as Do, setShapePatternFill as Dr, getSlideColorMapOverride as Ds, setShapeText as Dt, getAllShapes as E, hasSlideNotes as Ea, getPresentationImageCountsBySlide as Ei, replaceTokensInSlide as En, setTableCellTextDirection as Eo, setShapeNoStroke as Er, getSlideBackgroundPatternFill as Es, setShapeParagraphs as Et, getSlideIndex as F, getMediaParts as Fa, getShapeImageLinkUrl as Fi, getMaxShapeIdInPresentation as Fn, getCoreProperties as Fo, setShapeStrokeDash as Fr, getSlideMasterBackgroundGradientFill as Fs, setShapeTextWrap as Ft, isSlideHidden as G, clearTableCellFill as Ga, SLIDE_SIZE_16_10 as Gi, getShapeKind as Gn, findSlideLayoutByPartName as Go, getParagraphIndent as Gr, clearAllSlideComments as Gs, getShapeFill as Gt, getSlideXmlString as H, setMediaPartBytes as Ha, setShapeImageContrast as Hi, getShapeDescription as Hn, touchModified as Ho, getParagraphBulletImageBytes as Hr, setShapeClickAction as Hs, setShapeShadow as Ht, getSlideInfo as I, getOrphanMediaPartNames as Ia, getShapeImageOpacity as Ii, getShapeAdjustValues as In, getExtendedProperties as Io, setShapeStrokeJoin as Ir, getSlideMasterBackgroundImageBytes as Is, clearShapeEffects as It, replaceTextInSlide as J, getTableCell as Ja, getSlideSize as Ji, getShapePlaceholderType as Jn, getSlideLayoutPartName as Jo, getParagraphSpacing as Jr, findCommentsAfter as Js, getShapeFillEffective as Jt, replaceTextInNotes as K, getPresentationTableCountsBySlide as Ka, SLIDE_SIZE_16_9 as Ki, getShapeName as Kn, findSlideLayoutByType as Ko, getParagraphLevel as Kr, clearSlideComments as Ks, getShapeFillColor as Kt, getSlideLayoutCount as L, getPackageSize as La, getShapeImagePartName as Li, getShapeAltTitle as Ln, getPresentationCreated as Lo, getShapeRunFormat as Lr, getSlideMasterBackgroundPatternFill as Ls, findShapesByEffect as Lt, getShapeAt as M, setSlideTransition as Ma, getShapeImageDuotone as Mi, getGroupChildren as Mn, getThumbnail as Mo, setShapeStrokeArrow as Mr, getSlideLayoutBackgroundShapes as Ms, setShapeTextDirection as Mt, getSlideAt as N, _internalPackageOf as Na, getShapeImageFillBytes as Ni, getGroupTransform as Nn, removeThumbnail as No, setShapeStrokeCap as Nr, getSlideLayoutShapes as Ns, setShapeTextFormat as Nt, getPresentationShapeCountsBySlide as O, replaceHyperlink as Oa, getShapeImageBrightness as Oi, translateShapes as On, setTableColumnWidth as Oo, setShapePosition as Or, getSlideLayoutBackground as Os, setShapeTextAnchor as Ot, getSlideCount as P, compactPackage as Pa, getShapeImageFormat as Pi, getMaxShapeId as Pn, setThumbnail as Po, setShapeStrokeCompound as Pr, getSlideMasterBackground as Ps, setShapeTextMargins as Pt, setSlideHidden as Q, getTableCellFill as Qa, clearAllSlideNotes as Qi, getShapeSize as Qn, getSlideLayoutUsageCountsByType as Qo, getShapeRunClickAction as Qr, findSlidesWithCommentsByAuthor as Qs, getShapeStrokeColor as Qt, getSlideOutline as R, getPresentationSummary as Ra, hasShapeImage as Ri, getShapeBounds as Rn, getPresentationModified as Ro, resolveDrawingColor as Rr, getSlideMasterShapes as Rs, getShapeEffect as Rt, findSlideByText as S, getSlidesWithNotes as Sa, mm as Sc, findShapesOutsideCanvas as Si, getShapesBounds as Sn, setTableCellFill as So, setShapeFlip as Sr, clearSlideBackground as Ss, getShapeTextMargins as St, findSlidesByText as T, getVisibleSlides as Ta, findSlidesByLayoutType as Ti, getSlidesWithEmptyPlaceholders as Tn, setTableCellText as To, setShapeNoFill as Tr, getSlideBackgroundImageBytes as Ts, setShapeBullets as Tt, getSlides as U, slidesUsingMediaPart as Ua, setShapeImageCrop as Ui, getShapeFlip as Un, findLayoutsWithPlaceholderType as Uo, getParagraphBulletStyle as Ur, setShapeImage as Us, getShapeGradientFill as Ut, getSlideTextLength as V, readPackagePart as Va, setShapeImageBrightness as Vi, getShapeCustomGeometry as Vn, setExtendedProperties as Vo, getParagraphBullet as Vr, getShapeClickAction as Vs, setShapeGlow as Vt, getSlidesByLayout as W, validatePresentation as Wa, setShapeImageOpacity as Wi, getShapeId as Wn, findSlideLayout as Wo, getParagraphEndFormat as Wr, addSlideComment as Ws, getShapeGradientFillEffective as Wt, replaceTokensInPresentation as X, getTableCellAnchor as Xa, appendSlideNotes as Xi, getShapePreset as Xn, getSlideLayoutType as Xo, getShapeParagraphCount as Xr, findCommentsByAuthor as Xs, getShapeStroke as Xt, replaceTextInSlideNotes as Y, getTableCellAlignment as Ya, setSlideSize as Yi, getShapePosition as Yn, getSlideLayoutPlaceholders as Yo, getShapeHyperlinkTooltip as Yr, findCommentsBefore as Ys, getShapeFillOpacity as Yt, searchSlides as Z, getTableCellBorders as Za, clearAllHyperlinks as Zi, getShapeRotation as Zn, getSlideLayoutUsageCounts as Zo, getShapeParagraphElements as Zr, findCommentsByText as Zs, getShapeStrokeCap as Zt, sortSlides as _, getSlideNotesLength as _a, loadPresentation as _c, findShapesWithAnimation as _i, findSlidePlaceholderByIdx as _n, removeTableColumn as _o, getShapePatternFill as _r, getShapeChartSpec as _s, getShapeTextAutoFit as _t, addContentSlide as a, getAllHyperlinks as aa, getCommentsSortedByDate as ac, setParagraphBullet as ai, findEmptyPlaceholders as an, getTableCells as ao, isShapeHidden as ar, setShapeRunFormat as as, bringShapeForward as at, setSlideSections as b, getSlidesWithHyperlinks as ba, emu as bc, findFlippedShapes as bi, getShapeSlide as bn, setTableCellAnchor as bo, setShapeAdjustValues as br, getEffectiveColorMap as bs, getShapeTextColumns as bt, addSlideAt as c, getAllTables as ca, getPresentationCommenters as cc, setParagraphSpacing as ci, findShapeByText as cn, getTableRowHeights as co, pointInShape as cr, findChartsBySeriesName as cs, copyShape as ct, duplicateSlideAt as d, getHiddenSlides as da, removeSlideComment as dc, getSlideBody as di, findShapesByKind as dn, getTableStyleId as do, setShapeBounds as dr, getPresentationChartCountsBySlide as ds, sendShapeBackward as dt, findSlidesByHyperlink as ea, getCommentAuthors as ec, getShapeRunHyperlink as ei, getShapeStrokeCompound as en, getTableCellParagraphs as eo, getSlideMasterCount as er, getUnusedSlideLayouts as es, addSlideImage as et, importSlide as f, getPresentationHyperlinkCountsBySlide as fa, getPresentationFonts as fc, getSlideTitle as fi, findShapesByName as fn, insertTableColumn as fo, setShapeDescription as fr, getPresentationChartKindCounts as fs, sendShapeToBack as ft, reverseSlides as g, getSlideNotes as ga, createPresentation as gc, clearSlideAnimations as gi, findSlidePlaceholder as gn, mergeTableCells as go, clearShapeStroke as gr, getShapeChartSeriesValues as gs, getShapeTextAnchor as gt, removeSlide as h, getPresentationNotesText as ha, setPresentationTheme as hc, setSlideTitle as hi, findShapesWithHyperlinks as hn, isTableShape as ho, clearShapeFill as hr, getShapeChartSeriesNames as hs, getShapeBodyPrEffective as ht, addBlankSlide as i, getAllComments as ia, getCommentText as ic, setParagraphAlignment as ii, getShapeStrokeWidth as in, getTableCellTextDirection as io, getUnusedSlideMasters as ir, setShapeHyperlink as is, addSlideTextBox as it, getPresentationTextLengthsBySlide as j, getSlideTransition as ja, getShapeImageCrop as ji, findShapesInRect as jn, setTableStyleId as jo, setShapeStroke as jr, getSlideLayoutBackgroundPatternFill as js, setShapeTextColumns as jt, getPresentationText as k, setSlideNotes as ka, getShapeImageBytes as ki, centerShapeOnSlide as kn, setTableRowHeight as ko, setShapeRotation as kr, getSlideLayoutBackgroundGradientFill as ks, setShapeTextAutoFit as kt, addTitleSlide as l, getDistinctHyperlinkUrls as la, getSlideCommentAuthors as lc, setShapeRunHyperlink as li, findShapeInPresentation as ln, getTableSize as lo, renameShape as lr, findChartsWithDataLabels as ls, getShapeZIndex as lt, moveSlide as m, getPresentationNotesLengthsBySlide as ma, setPresentationFonts as mc, setSlidePlaceholders as mi, findShapesByText as mn, isChartShape as mo, shapesOverlap as mr, getShapeChartKind as ms, appendShapeText as mt, groupShapes as n, findSlidesWithChartTrendlines as na, getCommentPosition as nc, getShapeRunText as ni, getShapeStrokeJoin as nn, getTableCellSpan as no, getSlideMasterPartNames as nr, getShapeHyperlink as ns, addSlideShape as nt, addSectionHeaderSlide as o, getAllImages as oa, getPresentationCommentCountsByAuthor as oc, setParagraphLevel as oi, findShapeById as on, getTableColumnWidths as oo, isShapePlaceholder as or, addSlideChart as os, bringShapeToFront as ot, mergePresentations as p, getPresentationNotesLength as pa, getPresentationTheme as pc, setSlideBody as pi, findShapesByPreset as pn, insertTableRow as po, setShapeHidden as pr, getShapeChartCategories as ps, setShapeZIndex as pt, replaceTextInPresentation as q, getSlideTables as qa, SLIDE_SIZE_4_3 as qi, getShapePlaceholderIdx as qn, getSlideLayoutName as qo, getParagraphLineSpacing as qr, findCommentAuthorByName as qs, getShapeFillColorResolved as qt, ungroupShapes as r, getAllCharts as ra, getCommentSlide as rc, isParagraphBulletPicture as ri, getShapeStrokeOpacity as rn, getTableCellText as ro, getSlideMasterUsageCounts as rr, getShapeRunFormatEffective as rs, addSlideTable as rt, addSlide as s, getAllNotes as sa, getPresentationCommentCountsBySlide as sc, setParagraphLineSpacing as si, findShapeByName as sn, getTableDimensions as so, isShapeTextBox as sr, findChartByKind as ss, clearSlideShapes as st, VERSION as t, findSlidesWithChartKind as ta, getCommentDate as tc, getShapeRunHyperlinkTooltip as ti, getShapeStrokeEffective as tn, getTableCellPosition as to, getSlideMasterPartName as tr, getParagraphPropertiesEffective as ts, addSlideLine as tt, duplicateSlide as u, getEmptySlides as ua, getSlideComments as uc, setShapeRunText as ui, findShapesByHyperlink as un, getTableStyleFlags as uo, setShapeAltTitle as ur, findChartsWithTrendlines as us, removeShape as ut, swapSlides as v, getSlidesWithCharts as va, savePresentation as vc, getShapeAnimation as vi, findSlidePlaceholders as vn, removeTableRow as vo, getShapeStrokeArrow as vr, getSlideCharts as vs, getShapeTextAutoFitParams as vt, findSlidesByNotes as w, getSlidesWithTables as wa, findSlidesByLayoutPartName as wi, getSlideShapes as wn, setTableCellParagraphs as wo, setShapeImageFill as wr, getSlideBackgroundGradientFill as ws, setShapeAlignment as wt, findSlideByPartName as x, getSlidesWithImages as xa, inches as xc, findOverlappingShapePairs as xi, getShapeXmlString as xn, setTableCellBorders as xo, setShapeFill as xr, resolveDeckBodyTextColor as xs, getShapeTextDirection as xt, getSlideSections as y, getSlidesWithComments as ya, cm as yc, setShapeAnimation as yi, getShapeIndex as yn, setTableCellAlignment as yo, getShapeStrokeDash as yr, setChartSpec as ys, getShapeTextBodyRotationDeg as yt, getSlidePartName as z, getSlideMediaPartNames as za, hasShapeText as zi, getShapeBoundsResolved as zn, incrementRevision as zo, resolveDrawingColorOpacity as zr, setSlideBackground as zs, getShapeEffects as zt };
+export { replaceTokensInPresentation as $, getTableCellAnchor as $a, appendSlideNotes as $i, getShapePreset as $n, getSlideLayoutType as $o, getShapeParagraphCount as $r, findCommentsByAuthor as $s, getShapeStroke as $t, getOutlineText as A, removeSlideNotes as Aa, getShapeImageBiLevelThreshold as Ai, setSlideLayout as An, setTableCellTextFormat as Ao, setShapePatternFill as Ar, getSlideColorMapOverride as As, setShapeText as At, getSlideLayoutCount as B, getPackageSize as Ba, getShapeImagePartName as Bi, getShapeAltTitle as Bn, getPresentationCreated as Bo, getShapeRunFormat as Br, getSlideMasterBackgroundPatternFill as Bs, findShapesByEffect as Bt, setSlideSections as C, getSlidesWithHyperlinks as Ca, emu as Cc, findFlippedShapes as Ci, getShapeSlide as Cn, setTableCellAnchor as Co, setShapeAdjustValues as Cr, getEffectiveColorMap as Cs, getShapeTextColumns as Ct, findSlidesByNotes as D, getSlidesWithTables as Da, findSlidesByLayoutPartName as Di, getSlideShapes as Dn, setTableCellParagraphs as Do, setShapeImageFill as Dr, getSlideBackgroundGradientFill as Ds, setShapeAlignment as Dt, findSlideByTitle as E, getSlidesWithOverlap as Ea, pt as Ec, findSlidesByLayoutName as Ei, getSlideLayout as En, setTableCellMargins as Eo, setShapeGradientFill as Er, getSlideBackground as Es, getShapeTextWrap as Et, getShapeAt as F, setSlideTransition as Fa, getShapeImageDuotone as Fi, getGroupChildren as Fn, getThumbnail as Fo, setShapeStrokeArrow as Fr, getSlideLayoutBackgroundShapes as Fs, setShapeTextDirection as Ft, getSlideXmlString as G, setMediaPartBytes as Ga, setShapeImageContrast as Gi, getShapeDescription as Gn, touchModified as Go, getParagraphBulletImageBytes as Gr, setShapeClickAction as Gs, setShapeShadow as Gt, getSlidePartName as H, getSlideMediaPartNames as Ha, hasShapeText as Hi, getShapeBoundsResolved as Hn, incrementRevision as Ho, resolveDrawingColorOpacity as Hr, setSlideBackground as Hs, getShapeEffects as Ht, getSlideAt as I, _internalPackageOf as Ia, getShapeImageFillBytes as Ii, getGroupTransform as In, removeThumbnail as Io, setShapeStrokeCap as Ir, getSlideLayoutShapes as Is, setShapeTextFormat as It, isSlideHidden as J, clearTableCellFill as Ja, SLIDE_SIZE_16_10 as Ji, getShapeKind as Jn, findSlideLayoutByPartName as Jo, getParagraphIndent as Jr, clearAllSlideComments as Js, getShapeFill as Jt, getSlides as K, slidesUsingMediaPart as Ka, setShapeImageCrop as Ki, getShapeFlip as Kn, findLayoutsWithPlaceholderType as Ko, getParagraphBulletStyle as Kr, setShapeImage as Ks, getShapeGradientFill as Kt, getSlideCount as L, compactPackage as La, getShapeImageFormat as Li, getMaxShapeId as Ln, setThumbnail as Lo, setShapeStrokeCompound as Lr, getSlideMasterBackground as Ls, setShapeTextMargins as Lt, getPresentationText as M, setSlideNotes as Ma, getShapeImageBytes as Mi, centerShapeOnSlide as Mn, setTableRowHeight as Mo, setShapeRotation as Mr, getSlideLayoutBackgroundGradientFill as Ms, setShapeTextAutoFit as Mt, getPresentationTextLength as N, clearSlideTransition as Na, getShapeImageContrast as Ni, findShapesAtPoint as Nn, setTableStyleFlags as No, setShapeSize as Nr, getSlideLayoutBackgroundImageBytes as Ns, setShapeTextBodyRotationDeg as Nt, findSlidesByText as O, getVisibleSlides as Oa, findSlidesByLayoutType as Oi, getSlidesWithEmptyPlaceholders as On, setTableCellText as Oo, setShapeNoFill as Or, getSlideBackgroundImageBytes as Os, setShapeBullets as Ot, getPresentationTextLengthsBySlide as P, getSlideTransition as Pa, getShapeImageCrop as Pi, findShapesInRect as Pn, setTableStyleId as Po, setShapeStroke as Pr, getSlideLayoutBackgroundPatternFill as Ps, setShapeTextColumns as Pt, replaceTextInSlideNotes as Q, getTableCellAlignment as Qa, setSlideSize as Qi, getShapePosition as Qn, getSlideLayoutPlaceholders as Qo, getShapeHyperlinkTooltip as Qr, findCommentsBefore as Qs, getShapeFillOpacity as Qt, getSlideIndex as R, getMediaParts as Ra, getShapeImageLinkUrl as Ri, getMaxShapeIdInPresentation as Rn, getCoreProperties as Ro, setShapeStrokeDash as Rr, getSlideMasterBackgroundGradientFill as Rs, setShapeTextWrap as Rt, getSlideSections as S, getSlidesWithComments as Sa, cm as Sc, setShapeAnimation as Si, getShapeIndex as Sn, setTableCellAlignment as So, getShapeStrokeDash as Sr, setChartSpec as Ss, getShapeTextBodyRotationDeg as St, findSlideByText as T, getSlidesWithNotes as Ta, mm as Tc, findShapesOutsideCanvas as Ti, getShapesBounds as Tn, setTableCellFill as To, setShapeFlip as Tr, clearSlideBackground as Ts, getShapeTextMargins as Tt, getSlideText as U, listPackageParts as Ua, isShapeImageGrayscale as Ui, getShapeCenter as Un, setCoreProperties as Uo, getParagraphAlignment as Ur, setSlideBackgroundImage as Us, getShapeEffectsEffective as Ut, getSlideOutline as V, getPresentationSummary as Va, hasShapeImage as Vi, getShapeBounds as Vn, getPresentationModified as Vo, resolveDrawingColor as Vr, getSlideMasterShapes as Vs, getShapeEffect as Vt, getSlideTextLength as W, readPackagePart as Wa, setShapeImageBrightness as Wi, getShapeCustomGeometry as Wn, setExtendedProperties as Wo, getParagraphBullet as Wr, getShapeClickAction as Ws, setShapeGlow as Wt, replaceTextInPresentation as X, getSlideTables as Xa, SLIDE_SIZE_4_3 as Xi, getShapePlaceholderIdx as Xn, getSlideLayoutName as Xo, getParagraphLineSpacing as Xr, findCommentAuthorByName as Xs, getShapeFillColorResolved as Xt, replaceTextInNotes as Y, getPresentationTableCountsBySlide as Ya, SLIDE_SIZE_16_9 as Yi, getShapeName as Yn, findSlideLayoutByType as Yo, getParagraphLevel as Yr, clearSlideComments as Ys, getShapeFillColor as Yt, replaceTextInSlide as Z, getTableCell as Za, getSlideSize as Zi, getShapePlaceholderType as Zn, getSlideLayoutPartName as Zo, getParagraphSpacing as Zr, findCommentsAfter as Zs, getShapeFillEffective as Zt, moveSlide as _, getPresentationNotesLengthsBySlide as _a, setPresentationFonts as _c, setSlidePlaceholders as _i, findShapesByText as _n, isChartShape as _o, shapesOverlap as _r, getShapeChartKind as _s, appendShapeText as _t, groupShapes as a, findSlidesWithChartTrendlines as aa, getCommentPosition as ac, getShapeRunText as ai, getShapeStrokeJoin as an, getTableCellSpan as ao, getSlideMasterPartNames as ar, getShapeHyperlink as as, addSlideShape as at, sortSlides as b, getSlideNotesLength as ba, loadPresentation as bc, findShapesWithAnimation as bi, findSlidePlaceholderByIdx as bn, removeTableColumn as bo, getShapePatternFill as br, getShapeChartSpec as bs, getShapeTextAutoFit as bt, addContentSlide as c, getAllHyperlinks as ca, getCommentsSortedByDate as cc, setParagraphBullet as ci, findEmptyPlaceholders as cn, getTableCells as co, isShapeHidden as cr, setShapeRunFormat as cs, bringShapeForward as ct, addSlideAt as d, getAllTables as da, getPresentationCommenters as dc, setParagraphSpacing as di, findShapeByText as dn, getTableRowHeights as do, pointInShape as dr, findChartsBySeriesName as ds, copyShape as dt, clearAllHyperlinks as ea, findCommentsByText as ec, getShapeParagraphElements as ei, getShapeStrokeCap as en, getTableCellBorders as eo, getShapeRotation as er, getSlideLayoutUsageCounts as es, searchSlides as et, addTitleSlide as f, getDistinctHyperlinkUrls as fa, getSlideCommentAuthors as fc, setShapeRunHyperlink as fi, findShapeInPresentation as fn, getTableSize as fo, renameShape as fr, findChartsWithDataLabels as fs, getShapeZIndex as ft, mergePresentations as g, getPresentationNotesLength as ga, getPresentationTheme as gc, setSlideBody as gi, findShapesByPreset as gn, insertTableRow as go, setShapeHidden as gr, getShapeChartCategories as gs, setShapeZIndex as gt, importSlide as h, getPresentationHyperlinkCountsBySlide as ha, getPresentationFonts as hc, getSlideTitle as hi, findShapesByName as hn, insertTableColumn as ho, setShapeDescription as hr, getPresentationChartKindCounts as hs, sendShapeToBack as ht, getShapeMedia as i, findSlidesWithChartKind as ia, getCommentDate as ic, getShapeRunHyperlinkTooltip as ii, getShapeStrokeEffective as in, getTableCellPosition as io, getSlideMasterPartName as ir, getParagraphPropertiesEffective as is, addSlideLine as it, getPresentationShapeCountsBySlide as j, replaceHyperlink as ja, getShapeImageBrightness as ji, translateShapes as jn, setTableColumnWidth as jo, setShapePosition as jr, getSlideLayoutBackground as js, setShapeTextAnchor as jt, getAllShapes as k, hasSlideNotes as ka, getPresentationImageCountsBySlide as ki, replaceTokensInSlide as kn, setTableCellTextDirection as ko, setShapeNoStroke as kr, getSlideBackgroundPatternFill as ks, setShapeParagraphs as kt, addSectionHeaderSlide as l, getAllImages as la, getPresentationCommentCountsByAuthor as lc, setParagraphLevel as li, findShapeById as ln, getTableColumnWidths as lo, isShapePlaceholder as lr, addSlideChart as ls, bringShapeToFront as lt, duplicateSlideAt as m, getHiddenSlides as ma, removeSlideComment as mc, getSlideBody as mi, findShapesByKind as mn, getTableStyleId as mo, setShapeBounds as mr, getPresentationChartCountsBySlide as ms, sendShapeBackward as mt, addSlideMedia as n, clearSlideHyperlinks as na, getCommentAuthor as nc, getShapeRunCount as ni, getShapeStrokeColorResolved as nn, getTableCellMargins as no, getShapeText as nr, getSlideLayouts as ns, slideHasAnimations as nt, ungroupShapes as o, getAllCharts as oa, getCommentSlide as oc, isParagraphBulletPicture as oi, getShapeStrokeOpacity as on, getTableCellText as oo, getSlideMasterUsageCounts as or, getShapeRunFormatEffective as os, addSlideTable as ot, duplicateSlide as p, getEmptySlides as pa, getSlideComments as pc, setShapeRunText as pi, findShapesByHyperlink as pn, getTableStyleFlags as po, setShapeAltTitle as pr, findChartsWithTrendlines as ps, removeShape as pt, getSlidesByLayout as q, validatePresentation as qa, setShapeImageOpacity as qi, getShapeId as qn, findSlideLayout as qo, getParagraphEndFormat as qr, addSlideComment as qs, getShapeGradientFillEffective as qt, findShapesWithMedia as r, findSlidesByHyperlink as ra, getCommentAuthors as rc, getShapeRunHyperlink as ri, getShapeStrokeCompound as rn, getTableCellParagraphs as ro, getSlideMasterCount as rr, getUnusedSlideLayouts as rs, addSlideImage as rt, addBlankSlide as s, getAllComments as sa, getCommentText as sc, setParagraphAlignment as si, getShapeStrokeWidth as sn, getTableCellTextDirection as so, getUnusedSlideMasters as sr, setShapeHyperlink as ss, addSlideTextBox as st, VERSION as t, clearAllSlideNotes as ta, findSlidesWithCommentsByAuthor as tc, getShapeRunClickAction as ti, getShapeStrokeColor as tn, getTableCellFill as to, getShapeSize as tr, getSlideLayoutUsageCountsByType as ts, setSlideHidden as tt, addSlide as u, getAllNotes as ua, getPresentationCommentCountsBySlide as uc, setParagraphLineSpacing as ui, findShapeByName as un, getTableDimensions as uo, isShapeTextBox as ur, findChartByKind as us, clearSlideShapes as ut, removeSlide as v, getPresentationNotesText as va, setPresentationTheme as vc, setSlideTitle as vi, findShapesWithHyperlinks as vn, isTableShape as vo, clearShapeFill as vr, getShapeChartSeriesNames as vs, getShapeBodyPrEffective as vt, findSlideByPartName as w, getSlidesWithImages as wa, inches as wc, findOverlappingShapePairs as wi, getShapeXmlString as wn, setTableCellBorders as wo, setShapeFill as wr, resolveDeckBodyTextColor as ws, getShapeTextDirection as wt, swapSlides as x, getSlidesWithCharts as xa, savePresentation as xc, getShapeAnimation as xi, findSlidePlaceholders as xn, removeTableRow as xo, getShapeStrokeArrow as xr, getSlideCharts as xs, getShapeTextAutoFitParams as xt, reverseSlides as y, getSlideNotes as ya, createPresentation as yc, clearSlideAnimations as yi, findSlidePlaceholder as yn, mergeTableCells as yo, clearShapeStroke as yr, getShapeChartSeriesValues as ys, getShapeTextAnchor as yt, getSlideInfo as z, getOrphanMediaPartNames as za, getShapeImageOpacity as zi, getShapeAdjustValues as zn, getExtendedProperties as zo, setShapeStrokeJoin as zr, getSlideMasterBackgroundImageBytes as zs, clearShapeEffects as zt };
 
-//# sourceMappingURL=api-Dt6q_IAv.js.map
+//# sourceMappingURL=api-0CdoUwvg.js.map