@office-kit/pptx 0.17.0 → 0.18.1

package/dist/{api-DTHZaBPq.js → api-DlzYhUxG.js}

@@ -1682,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);
@@ -1838,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");
@@ -1877,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) {
@@ -1887,7 +2208,7 @@ const applyFormatToAllRuns = (txBody, format) => {
 				rPr = elem(NAME_RPR$6);
 				r.children.unshift(rPr);
 			}
-			applyRunFormat(rPr, format);
+			applyValidatedRunFormat(rPr, format);
 		}
 	}
 };
@@ -2026,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: "•"
@@ -2042,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)] });
@@ -2055,7 +2380,35 @@ 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 ALIGNMENT_TOKENS = [
+	"l",
+	"ctr",
+	"r",
+	"just",
+	"dist",
+	"justLow",
+	"thaiDist"
+];
+/**
+* Parses an `algn` attribute value from a file. A value outside
+* `ST_TextAlignType` is malformed input and reads as unset.
+*/
+const parseAlignmentToken = (value) => ALIGNMENT_TOKENS.find((token) => token === value) ?? null;
+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";
@@ -2075,8 +2428,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);
@@ -2118,32 +2473,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);
 	}
 };
 /**
@@ -2159,7 +2521,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);
@@ -2168,6 +2531,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);
 	}
 };
@@ -2176,21 +2540,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 }));
@@ -2350,6 +2714,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) => {
@@ -2534,6 +2904,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)] }));
@@ -2551,8 +2922,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));
@@ -2561,6 +2954,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));
@@ -2572,12 +2970,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));
@@ -3487,6 +3897,12 @@ 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: [
@@ -4125,12 +4541,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"));
@@ -4267,10 +4691,15 @@ 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";
@@ -5381,6 +5810,218 @@ 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);
@@ -9267,6 +9908,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));
@@ -9348,6 +9990,7 @@ const resolveChartPartName = (slide, shape) => {
 * fresh data."
 */
 const setChartSpec = (chart, spec) => {
+	validateChartSpecEnums(spec, "setChartSpec");
 	validateChartSpecColors(spec);
 	validateChartSpecAxes(spec);
 	const slide = chart.shape[SHAPE_SLIDE];
@@ -10855,6 +11498,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;
@@ -10882,7 +11526,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);
 };
@@ -11086,6 +11730,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)) {
@@ -11118,6 +11765,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));
@@ -11143,10 +11791,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);
@@ -11294,12 +11947,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. */
@@ -11308,10 +11963,12 @@ const getTableCellPosition = (cell) => ({
 	col: cell[CELL_COL]
 });
 /**
-* Reads the horizontal alignment from the cell's first paragraph
-* (`l`, `ctr`, `r`, `just`, `dist`, `justLow`, `thaiDist`). Returns
-* `null` when the cell has no `<a:txBody>` or its first paragraph
-* has no explicit `algn` attribute (PowerPoint then defaults to `l`).
+* Reads the horizontal alignment from the cell's first paragraph as its
+* spec token (`l`, `ctr`, `r`, `just`, `dist`, `justLow`, `thaiDist`) — so
+* `setTableCellAlignment(cell, 'center')` reads back as `'ctr'`. Returns
+* `null` when the cell has no `<a:txBody>`, or its first paragraph has no
+* valid `algn` attribute (PowerPoint then defaults to `l`). For a
+* plain-English name per paragraph, use `getTableCellParagraphs`.
 */
 const getTableCellAlignment = (cell) => {
 	const txBody = firstChildElement(cell[CELL_ELEMENT], NAME_A_TX_BODY_TBL);
@@ -11320,7 +11977,7 @@ const getTableCellAlignment = (cell) => {
 		if (p.kind !== "element" || p.name.namespaceURI !== NS.dml || p.name.localName !== "p") continue;
 		const pPr = firstChildElement(p, qname("a", "pPr", NS.dml));
 		if (!pPr) return null;
-		return getAttrValue(pPr, qname("", "algn", "")) ?? null;
+		return parseAlignmentToken(getAttrValue(pPr, qname("", "algn", "")));
 	}
 	return null;
 };
@@ -12014,8 +12671,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);
 };
@@ -12588,6 +13246,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));
@@ -13740,35 +14399,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:
 *
@@ -13779,18 +14426,24 @@ 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);
 };
 /**
-* Reads the paragraph's horizontal alignment. Returns `null` when no
-* `algn` attribute is present (inherits from layout / master).
+* Reads the paragraph's own `algn` as its spec token (`l`, `ctr`, `r`,
+* `just`, `dist`, `justLow`, `thaiDist`) — so `setParagraphAlignment(…,
+* 'center')` reads back as `'ctr'`. Returns `null` when the attribute is
+* absent (the paragraph inherits from its layout / master) or is not a
+* valid token. For the inherited value under a plain-English name, use
+* `getParagraphPropertiesEffective`.
 */
 const getParagraphAlignment = (shape, paragraphIndex) => {
 	const pPr = firstChildElement(requireParagraph(shape, paragraphIndex), NAME_A_PPR);
 	if (pPr === null) return null;
-	return getAttrValue(pPr, ATTR_ALGN_FN) ?? null;
+	return parseAlignmentToken(getAttrValue(pPr, ATTR_ALGN_FN));
 };
 /**
 * Reads the paragraph's nesting level (`lvl` attribute), or `0` when
@@ -16459,8 +17112,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);
 };
 /**
@@ -16503,6 +17155,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"));
@@ -16530,9 +17183,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);
 };
@@ -16725,6 +17387,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));
@@ -16841,13 +17504,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));
@@ -16911,7 +17579,7 @@ const setShapeAlignment = (shape, align) => {
 * updates compose.
 */
 const setShapeTextFormat = (shape, format) => {
-	applyFormatToAllRuns(requireTxBody(shape), format);
+	applyFormatToAllRuns(requireTxBody(shape), format, "setShapeTextFormat");
 	commitAndRefresh(shape);
 };
 /**
@@ -18824,8 +19492,8 @@ const getShapeMedia = (shape) => {
 const findShapesWithMedia = (slide) => slide[SLIDE_SHAPES].filter((shape) => getShapeMedia(shape) !== null);
 //#endregion
 //#region src/api/index.ts
-const VERSION = "0.17.0";
+const VERSION = "0.18.1";
 //#endregion
 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-DTHZaBPq.js.map
+//# sourceMappingURL=api-DlzYhUxG.js.map