@shbernal/ts-pptx 4.0.1 → 4.2.0

package/dist/{text-sN64Otf_.js → text-CU08xJGs.js}

@@ -1,18 +1,19 @@
-import { l as warn, n as InvalidOptionError, r as MediaError, t as InternalError, u as warnOnce } from "./errors-C4oENPcu.js";
-import { F as DEF_PRES_LAYOUT_NAME, J as SLDNUM_PLACEHOLDER_TEXT, P as DEF_PRES_LAYOUT, R as DEF_SLIDE_MARGIN_IN, U as LEVEL_MARGINS_EMU, V as LAYOUT_IDX_SERIES_BASE, X as MIN_SLIDE_MASTER_ID, a as convertRotationDegrees, n as clampRangedInput, q as SLDNUMFLDID, s as getSmartParseNumber, u as mapStated, v as resolveInsetsEmu } from "./units-internal-XJlf-hOl.js";
-import { A as inchesToEmu, D as emuToInches, F as EMU_PER_INCH, T as STANDARD_LAYOUTS } from "./table-cell-margins-EVg0EwxT.js";
-import { $t as THEME_REL, Bt as PRES_PROPS_CONTENT_TYPE, Dt as MS_MEDIA_REL, E as EMBEDDED_FONT_SLOTS, Ft as OFFICE_DOCUMENT_REL, Gt as SLIDE_LAYOUT_CONTENT_TYPE, Ht as RELATIONSHIPS_CONTENT_TYPE, Jt as SLIDE_MASTER_REL, Kt as SLIDE_LAYOUT_REL, Nt as NOTES_SLIDE_REL, Qt as THEME_CONTENT_TYPE, Vt as PRES_PROPS_REL, Wt as SLIDE_CONTENT_TYPE, Xt as TABLE_STYLES_CONTENT_TYPE, Yt as SLIDE_REL, Zt as TABLE_STYLES_REL, _t as CORE_PROPS_REL, a as textAlignToken, an as PML_ROOT_NS, at as CHARTEX_REL, bt as EXTENDED_PROPS_CONTENT_TYPE, c as checkEnumOrThrow, cn as decodeBase64ToBytes, d as xsdBool, dn as toMediaDataUri, en as VIDEO_REL, f as xsdBoolIfTrue, gt as CORE_PROPS_CONTENT_TYPE, h as stripHash, ht as COMMENT_AUTHORS_REL, in as OOXML_NS, jt as NOTES_MASTER_REL, l as checkEnumOrWarn, lt as CHART_REL, nn as VIEW_PROPS_REL, nt as TRANSITION_VARIANT_ATTRIBUTES, p as isHexColor, pt as COMMENTS_REL, qt as SLIDE_MASTER_CONTENT_TYPE, rt as AUDIO_REL, sn as bytesToBase64, tn as VIEW_PROPS_CONTENT_TYPE, tt as TRANSITION_TYPES, vt as CUSTOM_PROPS_CONTENT_TYPE, w as DEFAULT_COLOR_MAP, wt as IMAGE_REL, xt as EXTENDED_PROPS_REL, yt as CUSTOM_PROPS_REL, zt as PRESENTATION_MAIN_CONTENT_TYPE } from "./image-size-CvN2iCA4.js";
-import { a as avContentType, i as audioExtensionForSubtype, o as dataUriMediaType, s as imageContentType } from "./text-anchor-CrYXAfUu.js";
-import { At as getDuplicateObjectNames, C as targetBetweenPptSubparts, Ct as FONT_DATA_CONTENT_TYPE, D as cNvPrEl, Dt as serializeEmbeddedFontLst, Et as flattenEmbeddedFaces, G as clampParaMarginInchesEmu, It as preencodedPath, K as buAutoNumEl, N as spTreeEl, Nt as isHyperlinkRel, Ot as XML_DECL, Pt as isPreencodedPath, R as prstGeomRect, Rt as encodeXmlAttrValue, S as slidePath, St as voidEl, T as targetFromPresentation, Tt as FONT_REL_TYPE, U as clampFontSizeSz, W as clampParaIndentInchesEmu, _ as fontPath, at as fillNamesPaint, b as relsPath, bt as elOrVoid, c as themeFontDefRPr, f as relationshipsPart, g as commentPath, h as SLIDE_MASTER_PATH, ht as createColorElement, i as makeXmlNotesSlide, j as grpXfrmEl, jt as getNewRelId, kt as bracedGuid, l as externalHyperlinkRel, m as PRESENTATION_PATH, n as makeXmlNotesMaster, ot as genXmlColorSelection, p as NOTES_MASTER_PATH, q as buCharEl, s as lvlPPr, t as buildNotesSlideRels, u as relationshipEl, ut as STRETCH_FILL_RECT, v as notesSlidePath, vt as rejectEmptyColor, w as targetFromPptSubpart, wt as FONT_DATA_EXTENSION, x as slideLayoutPath, xt as raw, y as overrideName, yt as el } from "./notes-Dh12JAbn.js";
-import { A as renderedSlideObjects, B as pushMediaRel, C as msMediaRid, D as findLayoutPlaceholder, E as placeholderOptionsForSlide, F as warnUnauthoredChild, I as SLIDE_METHOD_FAMILIES, L as composeFamilies, M as shapeIdCount, N as addChildDefinition, O as resolveTextAnchor, P as isGroupableObject, R as familyMethodUnavailable, S as alternateContentEl, T as addTextDefinition, V as resolveImageSource, _ as chartPartNames, a as mediaFamily, b as GROUP_SHAPE_LOCK_ATTRS, c as commentsFamily, d as textFamily, f as shapeFamily, g as makeXmlCore, h as groupFamily, i as model3dFamily, j as resolveObjectNameToId, k as collectSlideShapeIds, l as chartFamily, m as imageFamily, n as tableFamily, o as measureFamily, p as notesFamily, r as oleFamily, s as connectorFamily, t as zoomFamily, u as animationsFamily, v as FMT_SCHEME_XML, w as previewRid, x as genXmlObjectLock, y as resolveImageExtent, z as requirePresentationAuthor } from "./zoom-DPUHh85d.js";
-import { n as setOrClear, t as pickDefined } from "./options-internal-WqgMf720.js";
-import { b as isFontCollection, g as FontMetricsRegistry, t as applyMeasuredFit, y as parseFontMetrics } from "./fit-Cb7naFj6.js";
-import { t as ZipWriter } from "./zip-CKd8ihcf.js";
-import { t as transitionSpeedForDuration } from "./transition-speed-kUEWDWTx.js";
-import { n as presentationFormatLabel, r as slideSizeType } from "./slide-size-BalTjFuv.js";
-//#region src/gen/define/background.ts
-/**
-* ts-pptx: Background Definition
+import { d as warnOnce, i as MediaError, n as InternalError, r as InvalidOptionError, u as warn } from "./entry-errors-JMthgJ2g.js";
+import { F as DEF_PRES_LAYOUT_NAME, J as SLDNUM_PLACEHOLDER_TEXT, P as DEF_PRES_LAYOUT, R as DEF_SLIDE_MARGIN_IN, S as transparencyToAlpha, U as LEVEL_MARGINS_EMU, V as LAYOUT_IDX_SERIES_BASE, X as MIN_SLIDE_MASTER_ID, a as convertRotationDegrees, n as clampRangedInput, q as SLDNUMFLDID, s as getSmartParseNumber, u as mapStated, v as resolveInsetsEmu } from "./units-internal-BR3a4cIi.js";
+import { A as inchesToEmu, D as emuToInches, F as EMU_PER_INCH, T as STANDARD_LAYOUTS, o as PlaceholderType } from "./enums-BP9wsb9Q.js";
+import { $ as SLIDE_LAYOUT_CONTENT_TYPE, C as COMMENT_AUTHORS_REL, Ct as DEFAULT_COLOR_MAP, D as CUSTOM_PROPS_REL, E as CUSTOM_PROPS_CONTENT_TYPE, F as MS_MEDIA_REL, Gt as TEXT_CAPS_TYPES, J as PRES_PROPS_CONTENT_TYPE, M as IMAGE_REL, O as EXTENDED_PROPS_CONTENT_TYPE, Q as SLIDE_CONTENT_TYPE, T as CORE_PROPS_REL, Tt as EMBEDDED_FONT_SLOTS, U as OFFICE_DOCUMENT_REL, V as NOTES_SLIDE_REL, X as RELATIONSHIPS_CONTENT_TYPE, Xt as TEXT_UNDERLINE_TYPES, Y as PRES_PROPS_REL, Zt as TEXT_VERTICAL, _ as CHART_REL, an as checkEnumOrWarn, at as TABLE_STYLES_REL, cn as xsdBoolIfTrue, ct as VIDEO_REL, d as AUDIO_REL, dn as stripHash, et as SLIDE_LAYOUT_REL, fn as bytesToBase64, ft as OOXML_NS, gn as toMediaDataUri, in as checkEnumOrThrow, it as TABLE_STYLES_CONTENT_TYPE, k as EXTENDED_PROPS_REL, ln as isHexColor, lt as VIEW_PROPS_CONTENT_TYPE, nn as TRANSITION_TYPES, nt as SLIDE_MASTER_REL, ot as THEME_CONTENT_TYPE, p as CHARTEX_REL, pn as decodeBase64ToBytes, pt as PML_ROOT_NS, q as PRESENTATION_MAIN_CONTENT_TYPE, qt as TEXT_SHAPE_TYPES, rn as TRANSITION_VARIANT_ATTRIBUTES, rt as SLIDE_REL, s as textAlignToken, sn as xsdBool, st as THEME_REL, tt as SLIDE_MASTER_CONTENT_TYPE, ut as VIEW_PROPS_REL, w as CORE_PROPS_CONTENT_TYPE, x as COMMENTS_REL, z as NOTES_MASTER_REL } from "./chart-metadata-CwiTTcJq.js";
+import { c as audioExtensionForSubtype, d as imageContentType, l as avContentType, n as GROUP_SHAPE_LOCK_ATTRS, u as dataUriMediaType } from "./lock-attrs-CSQnFDHP.js";
+import { $ as buAutoNumEl, A as cNvPrEl, C as relsPath, Ct as resolveFillKind, D as targetFromPptSubpart, E as targetBetweenPptSubparts, Et as genXmlImageCropRect, Ft as voidEl, H as prstGeomRect, Ht as isPreencodedPath, It as XML_DECL, J as clampFontSizeSz, Kt as encodeXmlAttrValue, L as spTreeEl, Lt as bracedGuid, Mt as el, Nt as elOrVoid, O as targetFromPresentation, Ot as createColorElement, P as grpXfrmEl, Pt as raw, Q as clampParaMarginInchesEmu, Rt as getDuplicateObjectNames, S as overrideName, T as slidePath, Tt as STRETCH_FILL_RECT, Vt as isHyperlinkRel, Wt as preencodedPath, X as clampParaIndentInchesEmu, Y as clampParaIndentEmu, Z as clampParaMarginEmu, _ as PRESENTATION_PATH, _t as flattenEmbeddedFaces, a as makeXmlNotesMaster, b as fontPath, bt as genXmlColorSelection, d as themeFontDefRPr, dt as withLineDefaults, et as buCharEl, f as externalHyperlinkRel, g as NOTES_MASTER_PATH, gt as FONT_REL_TYPE, h as relationshipsPart, ht as FONT_DATA_EXTENSION, i as buildNotesSlideRels, jt as rejectEmptyColor, mt as FONT_DATA_CONTENT_TYPE, p as relationshipEl, q as underlineProps, s as makeXmlNotesSlide, u as lvlPPr, v as SLIDE_MASTER_PATH, vt as serializeEmbeddedFontLst, w as slideLayoutPath, wt as solidPaint, x as notesSlidePath, y as commentPath, yt as fillNamesPaint, zt as getNewRelId } from "./comments-CKIZYRbZ.js";
+import { A as statedPlaceholderBinding, B as composeFamilies, C as msMediaRid, D as checkPlaceholderBinding, E as placeholderOptionsForSlide, F as shapeIdCount, H as requirePresentationAuthor, I as addChildDefinition, L as isGroupableObject, M as collectSlideShapeIds, N as renderedSlideObjects, O as findLayoutPlaceholder, P as resolveObjectNameToId, R as warnUnauthoredChild, S as alternateContentEl, T as addTextDefinition, U as pushMediaRel, V as familyMethodUnavailable, W as resolveImageSource, _ as makeXmlCore, a as mediaFamily, b as resolveImageExtent, c as commentsFamily, d as textFamily, f as shapeFamily, g as makeXmlTableStyles, h as groupFamily, i as model3dFamily, j as resolveTextAnchor, k as layoutPlaceholderName, l as chartFamily, m as imageFamily, n as tableFamily, o as measureFamily, p as notesFamily, r as oleFamily, s as connectorFamily, t as zoomFamily, u as animationsFamily, v as chartPartNames, w as previewRid, x as genXmlObjectLock, y as FMT_SCHEME_XML, z as SLIDE_METHOD_FAMILIES } from "./zoom-CSSeOwM8.js";
+import { n as setOrClear, t as pickDefined } from "./options-internal-BWgmLPdx.js";
+import { b as isFontCollection, g as FontMetricsRegistry, t as applyMeasuredFit, y as parseFontMetrics } from "./fit-Bpmzep6O.js";
+import { t as ZipWriter } from "./zip-7JTh61LX.js";
+import { t as ANIM_PRESET_IDENTITY } from "./anim-presets-Qbgh8uut.js";
+import { t as transitionSpeedForDuration } from "./transition-speed-CNJ0fSpQ.js";
+import { n as presentationFormatLabel, r as slideSizeType } from "./slide-size-SkScz1ig.js";
+// src/gen/define/background.ts
+/**
+* pptx-ts: Background Definition
 *
 * Registers an `addBackground()` image as a slide media rel (color backgrounds carry no rel);
 * the `<p:bg>` XML is emitted later at slide / layout serialize time.
@@ -21,7 +22,7 @@ import { n as presentationFormatLabel, r as slideSizeType } from "./slide-size-B
 * Adds a background image or color to a slide definition.
 *
 * Only an image background does anything here: it is the one that needs a media relationship.
-* A colour — object or the bare-string shorthand — carries no rel and is emitted straight from
+* A colour (object or the bare-string shorthand) carries no rel and is emitted straight from
 * `slide.background` at serialize time.
 *
 * The rel id and the part name come from the shared allocators. This used to take the id as
@@ -49,11 +50,12 @@ import { n as presentationFormatLabel, r as slideSizeType } from "./slide-size-B
 * @param {SlideLayoutInternal} target - slide or layout that the background is set on
 */
 function addBackgroundDefinition(props, target) {
-	if (!(props && typeof props === "object" && (props.path || props.data))) {
+	const image = backgroundImage(props);
+	if (!image) {
 		delete target._bkgdImgRid;
 		return;
 	}
-	const source = resolveImageSource(props);
+	const source = resolveImageSource(image);
 	if (typeof source === "string") {
 		warn("background/missing-base64-header", "background `data` value lacks a base64 header (ex: 'image/png;base64,...'); ignoring the background image.");
 		delete target._bkgdImgRid;
@@ -87,8 +89,24 @@ function addBackgroundDefinition(props, target) {
 	});
 	target._bkgdImgRid = rId;
 }
-//#endregion
-//#region src/slide.ts
+/**
+* The picture a background names, in either of its two spellings: `{ data }` / `{ path }` from
+* `DataOrPathProps`, or `{ image: { data, crop } }` from `ShapeFillProps`, which `BackgroundProps`
+* also extends. The second used to type-check and register nothing, so the background was written
+* as `<a:noFill/>` and its crop was lost with it.
+*
+* The top-level spelling wins, as it always has. The `image` one follows the fill rule that an
+* explicit `type` other than `'image'` wins over a sub-object.
+* @param props - the background option
+* @returns the picture's source, or `null` when the background names none
+*/
+function backgroundImage(props) {
+	if (!props || typeof props !== "object") return null;
+	if (props.path || props.data) return props;
+	const image = props.image;
+	return resolveFillKind(props) === "image" && image && (image.path || image.data) ? image : null;
+}
+// src/slide.ts
 /**
 * Project one authored render-object onto the public {@link SlideObjectInfo}, recursing into a
 * group's children.
@@ -139,7 +157,7 @@ var SlideBuilder = class {
 	constructor(params) {
 		this.addSlide = params.addSlide;
 		this.getSlide = params.getSlide;
-		this.getSections = params.getSections ?? (() => []);
+		this.getSections = params.getSections;
 		this._name = `Slide ${params.slideNumber}`;
 		this._presLayout = params.presLayout;
 		this._rId = params.slideRId;
@@ -148,7 +166,7 @@ var SlideBuilder = class {
 		this._relsMedia = [];
 		this._setSlideNum = params.setSlideNum;
 		this._slideId = params.slideId;
-		this._slideLayout = params.slideLayout || null;
+		this._slideLayout = params.slideLayout;
 		this._slideNum = params.slideNumber;
 		this._slideObjects = [];
 		this._childAuthors = params.childAuthors;
@@ -157,7 +175,7 @@ var SlideBuilder = class {
 		* `defineSlideMaster` and `addNewSlide.slideNumber` will add {slideNumber} to `this.masterSlide` and `this.slideLayouts`
 		* so, lastly, add to the Slide now.
 		*/
-		this._slideNumberProps = this._slideLayout?._slideNumberProps ? this._slideLayout._slideNumberProps : null;
+		this._slideNumberProps = params.slideLayout._slideNumberProps ?? null;
 	}
 	/**
 	* Put this presentation's family methods on the slide.
@@ -269,10 +287,9 @@ var SlideBuilder = class {
 		return emuToInches(this._presLayout.height);
 	}
 };
-//#endregion
-//#region src/font-source.ts
+// src/font-source.ts
 /**
-* ts-pptx: getting font bytes out of whatever the caller handed over.
+* pptx-ts: getting font bytes out of whatever the caller handed over.
 *
 * `registerFontMetrics` and `embedFont` are two public methods on one class, forty lines apart,
 * and each resolved its source itself. They agreed on `Uint8Array` and `ArrayBuffer` and
@@ -310,8 +327,11 @@ async function resolveFontBytes(source, runtime, opts, label) {
 	}
 	throw new InvalidOptionError("font/missing-source", `${label} must be a font path, raw bytes, or base64 data`);
 }
-//#endregion
-//#region src/gen/define/master.ts
+// src/gen/define/master.ts
+/** Whether a definition's `type` is one of the six friendly ones the `p:ph` writer maps itself. */
+function isFriendlyPlaceholderType(type) {
+	return Object.hasOwn(PlaceholderType, type) || Object.values(PlaceholderType).includes(type);
+}
 /**
 * Transforms a slide definition to a slide object that is then passed to the XML transformation process.
 * @param {SlideMasterProps} props - slide definition
@@ -323,40 +343,59 @@ function createSlideMaster(props, target, children) {
 		const tgt = target;
 		if (addChildDefinition(tgt, object, children)) {} else if ("placeholder" in object) {
 			const placeholder = object.placeholder;
-			const { name, type, ...rawPlaceholderOptions } = placeholder.options;
+			const { name, type, idx: statedIdx, ...rawPlaceholderOptions } = placeholder.options;
+			checkPlaceholderBinding({
+				...statedIdx === void 0 ? {} : { idx: statedIdx },
+				...isFriendlyPlaceholderType(type) ? {} : { type }
+			}, "defineSlideMaster");
 			const placeholderOptions = rawPlaceholderOptions;
 			placeholderOptions.placeholder = name;
 			placeholderOptions._placeholderType = type;
-			placeholderOptions._placeholderIdx = 100 + idx;
+			placeholderOptions._placeholderIdx = statedIdx ?? 100 + idx;
 			const placeholderRun = placeholder.text === void 0 ? {} : { text: placeholder.text };
 			addTextDefinition(tgt, [placeholderRun], placeholderOptions, true);
 		} else warnUnauthoredChild(object, "defineSlideMaster()");
 	});
 	if (props.slideNumber && typeof props.slideNumber === "object") target._slideNumberProps = props.slideNumber;
 }
-//#endregion
-//#region src/gen/define/placeholder.ts
+// src/gen/define/placeholder.ts
 /**
 * Adds placeholder objects to slide
 * @param {PresSlideInternal} slide - slide object containing layouts
 */
 function addPlaceholdersToSlideLayouts(slide) {
 	if (!slide._slideLayout) return;
-	(slide._slideLayout._slideObjects || []).forEach((slideLayoutObj) => {
+	slide._slideLayout._slideObjects.forEach((slideLayoutObj) => {
 		if (slideLayoutObj._type === "placeholder") {
 			const slideLayoutOptions = slideLayoutObj.options || {};
-			if (!slide._slideObjects.some((slideObj) => slideObj.options && slideObj.options.placeholder === slideLayoutOptions.placeholder)) addTextDefinition(slide, [{ text: "" }], placeholderOptionsForSlide(slideLayoutOptions), true);
+			const fills = (slideObj) => {
+				if (layoutPlaceholderName(slideObj.options?.placeholder) === slideLayoutOptions.placeholder) return true;
+				const binding = statedPlaceholderBinding(slideObj.options?.placeholder);
+				if (!binding || slideLayoutOptions._placeholderIdx === void 0) return false;
+				if (binding.idx !== void 0) return binding.idx === slideLayoutOptions._placeholderIdx;
+				return slideLayoutOptions._placeholderIdx === 0 && binding.type === slideLayoutOptions._placeholderType;
+			};
+			if (!slide._slideObjects.some(fills)) {
+				addTextDefinition(slide, [{ text: "" }], placeholderOptionsForSlide(slideLayoutOptions), true);
+				const seeded = slide._slideObjects.at(-1);
+				if (seeded) {
+					seeded._seeded = true;
+					seeded.text = [];
+					const options = seeded.options ?? (seeded.options = {});
+					const line = options.line;
+					options.line = line?.type === "none" ? { type: "none" } : line && fillNamesPaint(line) ? withLineDefaults(line, "line.color") : { type: "inherit" };
+				}
+			}
 		}
 	});
 }
-//#endregion
-//#region src/media/placeholders.ts
+// src/media/placeholders.ts
 /**
 * The base64 placeholder images the library falls back to when a real asset is unavailable.
 *
 * Their own module because of where the bundler puts them, not because they group naturally.
 * The chunker splits by module, so a constant is pulled into every chunk that reaches the module
-* declaring it — and these lived in `constants-internal.ts` beside `XML_DECL`, `DEF_FONT_SIZE`
+* declaring it, and these lived in `constants-internal.ts` beside `XML_DECL`, `DEF_FONT_SIZE`
 * and the rest of the vocabulary all of `src/gen/` imports. The rule that follows: a payload
 * measured in kilobytes does not share a module with vocabulary, however tidy that grouping reads.
 *
@@ -368,10 +407,9 @@ function addPlaceholdersToSlideLayouts(slide) {
 const IMG_BROKEN = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAGQAAAB3CAYAAAD1oOVhAAAGAUlEQVR4Xu2dT0xcRRzHf7tAYSsc0EBSIq2xEg8mtTGebVzEqOVIolz0siRE4gGTStqKwdpWsXoyGhMuyAVJOHBgqyvLNgonDkabeCBYW/8kTUr0wsJC+Wfm0bfuvn37Znbem9mR9303mJnf/Pb7ed95M7PDI5JIJPYJV5EC7e3t1N/fT62trdqViQCIu+bVgpIHEo/Hqbe3V/sdYVKHyWSSZmZm8ilVA0oeyNjYmEnaVC2Xvr6+qg5fAOJAz4DU1dURGzFSqZRVqtMpAFIGyMjICC0vL9PExIRWKADiAYTNshYWFrRCARAOEFZcCKWtrY0GBgaUTYkBRACIE4rKZwqACALR5RQAqQCIDqcASIVAVDsFQCSAqHQKgEgCUeUUAPEBRIVTAMQnEBvK5OQkbW9vk991CoAEAMQJxc86BUACAhKUUwAkQCBBOAVAAgbi1ykAogCIH6cAiCIgsk4BEIVAZJwCIIqBVLqiBxANQFgXS0tLND4+zl08AogmIG5OSSQS1gGKwgtANAIRcQqAaAbCe6YASBWA2E6xDyeyDUl7+AKQMkDYYevm5mZHabA/Li4uUiaTsYLau8QA4gLE/hU7wajyYtv1hReDAiAOxQcHBymbzark4BkbQKom/X8dp9Npmpqasn4BIAYAYSnYp+4BBEAMUcCwNOCQsAKZnp62NtQOw8WmwT09PUo+ijaHsOMx7GppaaH6+nolH0Z10K2tLVpdXbW6UfV3mNqBdHd3U1NTk2rtlMRfW1uj2dlZAFGirkRQAJEQTWUTAFGprkRsAJEQTWUTAFGprkRsAJEQTWUTAFGprkRsAJEQTWUTAFGprkRsAJEQTWUTAFGprkRsAJEQTWUTAGHqrm8caPzQ0WC1logbeiC7X3xJm0PvUmRzh45cuki1588FAmVn9BO6P3yF9utrqGH0MtW82S8UN9RA9v/4k7InjhcJFTs/TLVXLwmJV67S7vD7tHF5pKi46fYdosdOcOOGG8j1OcqefbFEJD9Q3GCwDhqT31HklS4A8VRgfYM2Op6k3bt/BQJl58J7lPvwg5JYNccepaMry0LPqFA7hCm39+NNyp2J0172b19QysGINj5CsRtpij57musOViH0QPJQXn6J9u7dlYJSFkbrMYolrwvDAJAC+WWdEpQz7FTgECeUCpzi6YxvvqXoM6eEhqnCSgDikEzUKUE7Aw7xuHctKB5OYU3dZlNR9syQdAaAcAYTC0pXF+39c09o2Ik+3EqxVKqiB7hbYAxZkk4pbBaEM+AQofv+wTrFwylBOQNABIGwavdfe4O2pg5elO+86l99nY58/VUF0byrYsjiSFluNlXYrOHcBar7+EogUADEQ0YRGHbzoKAASBkg2+9cpM1rV0tK2QOcXW7bLEFAARAXIF4w2DrDWoeUWaf4hQIgDiA8GPZ2iNfi0Q8UACkAIgrDbrJ385eDxaPLLrEsFAB5oG6lMPJQPLZZZKAACBGVhcG2Q+bmuLu2nk55e4jqPv1IeEoceiBeX7s2zCa5MAqdstl91vfXwaEGsv/rb5TtOFk6tWXOuJGh6KmnhO9sayrMninPx103JBtXblHkice58cINZP4Hyr5wpkgkdiChEmc4FWazLzenNKa/p0jncwDiqcD6BuWePk07t1asatZGoYQzSqA4nFJ7soNiP/+EUyfc25GI2GG53dHPrKo1g/1Cw4pIXLrzO+1c+/wg7tBbFDle/EbQcjFCPWQJCau5EoBoFpzXHYDwFNJcDiCaBed1ByA8hTSXA4hmwXndAQhPIc3lAKJZcF53AMJTSHM5gGgWnNcdgPAU0lwOIJoF53UHIDyFNJcfSiCdnZ0Ui8U0SxlMd7lcjubn561gh+Y1scFIU/0o/3sgeLO12E2k7UXKYumgFoAYdg8ACIAYpoBh6cAhAGKYAoalA4cAiGEKGJYOHAIghilgWDpwCIAYpoBh6cAhAGKYAoalA4cAiGEKGJYOHAIghilgWDpwCIAYpoBh6ZQ4JB6PKzviYthnNy4d9h+1M5mMlVckkUjsG5dhiBMCEMPg/wuOfrZZ/RSywQAAAABJRU5ErkJggg==";
 /** 1x1 transparent PNG, standing in for an SVG the runtime could not rasterize. */
 const IMG_SVG_PLACEHOLDER = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==";
-//#endregion
-//#region src/gen/media.ts
+// src/gen/media.ts
 /**
-* ts-pptx: Media Methods
+* pptx-ts: Media Methods
 */
 function hasEncodingPath(rel) {
 	return typeof rel.path === "string" && rel.path.length > 0 && !isPreencodedPath(rel.path);
@@ -398,14 +436,14 @@ async function writeSvgPreview(rel, runtime, onMediaError) {
 * Encode Image/Audio/Video into base64
 * @param {PresSlideInternal | SlideLayoutInternal | SlideMasterInternal} layout - slide, layout or master
 * @param {RuntimeAdapter} runtime - runtime adapter (Node/browser media loader)
-* @param {'throw' | 'placeholder'} onMediaError - failure policy: reject the export (default) or substitute a placeholder and warn
+* @param {'throw' | 'placeholder'} onMediaError - failure policy: reject the export or substitute a placeholder and warn
 * @return {Promise} promise
 */
-function encodeSlideMediaRels(layout, runtime, onMediaError = "throw") {
+function encodeSlideMediaRels(layout, runtime, onMediaError) {
 	const imageProms = [];
 	const defaultCoverRels = layout._relsMedia.filter((rel) => rel.isDefaultCover && !rel.data);
 	if (defaultCoverRels.length > 0) imageProms.push((async () => {
-		const { IMG_PLAYBTN } = await import("./playbtn-CUqQdoDf.js");
+		const { IMG_PLAYBTN } = await import("./playbtn-BQZFJir9.js");
 		for (const rel of defaultCoverRels) rel.data = IMG_PLAYBTN;
 		return "done";
 	})());
@@ -445,24 +483,23 @@ function encodeSlideMediaRels(layout, runtime, onMediaError = "throw") {
 	});
 	return imageProms;
 }
-//#endregion
-//#region src/gen/prepare.ts
+// src/gen/prepare.ts
 /**
-* ts-pptx: the pre-serialization pass
+* pptx-ts: the pre-serialization pass
 *
 * Everything that must happen to authored slide state *before* any XML is built. Two callers
 * reach serialization and both need it:
 *
-*   - `package/assemble.ts` — the normal `write`/`stream`/`writeFile` path, building a
+*   - `package/assemble.ts`: the normal `write`/`stream`/`writeFile` path, building a
 *     complete `.pptx`.
-*   - `PresentationCore.extractSlides()` — serializes slide bodies only, for splicing into
+*   - `PresentationCore.extractSlides()`: serializes slide bodies only, for splicing into
 *     an already-loaded deck via `Presentation.appendSlides()` (`pptx-ts/read`).
 *
 * The second used to reimplement the first inline, kept in step by a comment that said
 * "exactly as ... does". Nothing failed when they drifted: `extractSlides` would simply emit
 * slides that did not match what a normal write produces, and no test compares the two.
 *
-* Three steps rather than one combined pass, because the package path has work of its own that
+* Separate steps rather than one combined pass, because the package path has work of its own that
 * must land between the last two: it de-duplicates identical media across the deck (which needs
 * the encoded bytes {@link encodeMediaForTargets} produces) and assigns package-unique chart part
 * filenames, both before any text is measured. Exposing the steps lets `assemble` keep that work
@@ -470,7 +507,9 @@ function encodeSlideMediaRels(layout, runtime, onMediaError = "throw") {
 *
 * The order is load-bearing:
 *
-* 1. **Backfill placeholders first**, so a slide carries its layout's placeholder objects before
+* 0. **Register transition sounds**, before media encoding loads their bytes and before
+*    backfill, so a slide's rel ids come out the same on both paths.
+* 1. **Backfill placeholders**, so a slide carries its layout's placeholder objects before
 *    anything reads its media. A seeded placeholder can register media of its own, an image fill,
 *    and when backfill ran after encoding that image was never loaded and its rel named a part
 *    that was never written.
@@ -482,7 +521,7 @@ function encodeSlideMediaRels(layout, runtime, onMediaError = "throw") {
 *
 * The functions take different target sets on purpose: media lives on layouts and the master as
 * well as on slides, while placeholder backfill and measured fit apply only to slides.
-* `extractSlides` passes only its slides to all three, because it emits no layout or master
+* `extractSlides` passes only its slides to every step, because it emits no layout or master
 * parts.
 */
 /**
@@ -518,10 +557,19 @@ function requireSlideLinksInDeck(slides, layouts = [], master) {
 			part: master
 		}] : []
 	];
+	const refuse = (label, target) => {
+		throw new InvalidOptionError("slide/link-past-last-slide", `${label} links to slide ${String(target)}, but the deck has ${slides.length} slide${slides.length === 1 ? "" : "s"}.`);
+	};
 	for (const { label, part } of sources) for (const rel of part._rels) {
 		if (!isHyperlinkRel(rel) || rel.data !== "slide") continue;
-		if (!(Number(rel.Target) > slides.length)) continue;
-		throw new InvalidOptionError("slide/link-past-last-slide", `${label} links to slide ${String(rel.Target)}, but the deck has ${slides.length} slide${slides.length === 1 ? "" : "s"}.`);
+		if (Number(rel.Target) > slides.length) refuse(label, rel.Target);
+	}
+	for (const slide of slides) for (const obj of slide._slideObjects) {
+		if (obj._type !== "notes") continue;
+		for (const run of obj.text ?? []) {
+			const target = run.options?.hyperlink?.slide;
+			if (target !== void 0 && target > slides.length) refuse(`The notes of slide ${slide._slideNum}`, target);
+		}
 	}
 }
 /**
@@ -536,6 +584,61 @@ async function encodeMediaForTargets(targets, runtime, onMediaError) {
 	await Promise.all(promises);
 }
 /**
+* Each slide's registered transition sound.
+*
+* Kept per slide, never on the transition: one transition object can be assigned to several slides,
+* and a relationship id means something only inside the slide part that declares it. Kept across
+* writes as well, so a deck written twice registers each sound once. An entry is reused only while
+* the slide still holds its relationship and still has the same sound assigned.
+*/
+const registeredTransitionSounds = /* @__PURE__ */ new WeakMap();
+/**
+* Step 0: register an audio media part + relationship for each slide-transition start sound
+* (`transition.sound` with `data`/`path`), and return the relationship id each slide's
+* `p:sndAc/p:snd r:embed` refers to. Runs before media encoding so the bytes are loaded. Re-export
+* is safe: a slide whose sound is already registered reuses that relationship. The stop-previous
+* form (`sound.stopPrevious`) needs no part and is skipped.
+*
+* Registered here, at write time, rather than when `slide.transition` is assigned. A slide's rel
+* ids and media part names are handed out in registration order, and a transition is often set
+* before the slide's pictures and media are added; registering the sound then would move every
+* later rel id and part name on the slide.
+*/
+function registerTransitionSounds(slides) {
+	const soundRIds = /* @__PURE__ */ new Map();
+	slides.forEach((slide) => {
+		const transition = slide.transition;
+		if (!transition || !TRANSITION_TYPES.includes(transition.type)) return;
+		const sound = transition.sound;
+		if (!sound || sound.stopPrevious) return;
+		if (!sound.data && !sound.path) return;
+		const registered = registeredTransitionSounds.get(slide);
+		if (registered && slide._relsMedia.includes(registered.rel) && registered.data === sound.data && registered.path === sound.path) {
+			soundRIds.set(slide, registered.rel.rId);
+			return;
+		}
+		const dataMime = dataUriMediaType(sound.data ?? "");
+		const pathFile = sound.path ? (sound.path.split("/").pop() ?? "").split("?")[0] ?? "" : "";
+		const extn = dataMime?.startsWith("audio/") ? audioExtensionForSubtype(dataMime.slice(6)) : (pathFile.split(".").pop() ?? "wav").toLowerCase();
+		const rId = getNewRelId(slide);
+		const rel = pushMediaRel(slide, {
+			kind: "audio",
+			extn,
+			type: `audio/${extn}`,
+			path: sound.path,
+			data: sound.data,
+			rId
+		});
+		registeredTransitionSounds.set(slide, {
+			rel,
+			data: sound.data,
+			path: sound.path
+		});
+		soundRIds.set(slide, rId);
+	});
+	return soundRIds;
+}
+/**
 * Step 1: seed each slide with the layout placeholders it leaves empty.
 * @param {PresSlideInternal[]} slides - the slides to prepare
 */
@@ -551,10 +654,9 @@ function backfillPlaceholders(slides) {
 function bakeMeasuredFit(slides, fontMetrics) {
 	return applyMeasuredFit(slides, fontMetrics);
 }
-//#endregion
-//#region src/gen/anim/animation.ts
+// src/gen/anim/animation.ts
 /**
-* Resolved animation target's shape id (`spid`), or `null` when it cannot be resolved — in which
+* Resolved animation target's shape id (`spid`), or `null` when it cannot be resolved. In that
 * case the effect is dropped, so every `null` warns rather than leaving the animation silently
 * missing from the deck.
 *
@@ -566,10 +668,10 @@ function bakeMeasuredFit(slides, fontMetrics) {
 *
 * `shapeIndex` is a 0-based index into the top-level objects that RENDER, which is the same
 * sequence `collectSlideShapeIds` allocates along; group children take ids past that range. It
-* counted `_slideObjects` itself, and four of that array's members draw nothing — so `addNotes`
+* counted `_slideObjects` itself, and four of that array's members draw nothing, so `addNotes`
 * before the first shape shifted every index by one and `shapeIndex: 0` addressed the notes.
 * An index outside `[0, renderedCount)` would emit a `<p:spTgt spid>` naming no shape on the
-* slide — a dangling spid PowerPoint reports as a repair (0x80070570) — so it warns and drops,
+* slide (a dangling spid PowerPoint reports as a repair, 0x80070570), so it warns and drops,
 * exactly like an unresolvable `objectName` does.
 * @param shapeIds - the slide's shape ids, from `collectSlideShapeIds`
 * @param slideObjects - the slide's top-level objects, which a `shapeIndex` addresses
@@ -670,38 +772,23 @@ const ANIM_FLY_AXIS = (direction, axis, spid, dur, next) => {
 };
 const ANIM_PRESETS = {
 	fadeIn: {
-		presetID: 10,
-		presetClass: "entr",
-		presetSubtype: 0,
-		defaultDurationMs: 500,
+		...ANIM_PRESET_IDENTITY.fadeIn,
 		behaviors: (spid, dur, next) => ANIM_SET_VISIBLE(spid, next) + ANIM_FADE("in", spid, dur, next)
 	},
 	flyIn: {
-		presetID: 2,
-		presetClass: "entr",
-		presetSubtype: 4,
-		defaultDurationMs: 500,
+		...ANIM_PRESET_IDENTITY.flyIn,
 		behaviors: (spid, dur, next) => ANIM_SET_VISIBLE(spid, next) + ANIM_FLY_AXIS("in", "x", spid, dur, next) + ANIM_FLY_AXIS("in", "y", spid, dur, next)
 	},
 	appear: {
-		presetID: 1,
-		presetClass: "entr",
-		presetSubtype: 0,
-		defaultDurationMs: 500,
+		...ANIM_PRESET_IDENTITY.appear,
 		behaviors: (spid, _dur, next) => ANIM_SET_VISIBLE(spid, next)
 	},
 	wipe: {
-		presetID: 22,
-		presetClass: "entr",
-		presetSubtype: 4,
-		defaultDurationMs: 500,
+		...ANIM_PRESET_IDENTITY.wipe,
 		behaviors: (spid, dur, next) => ANIM_SET_VISIBLE(spid, next) + ANIM_EFFECT("in", "wipe(down)", spid, dur, next)
 	},
 	grow: {
-		presetID: 6,
-		presetClass: "emph",
-		presetSubtype: 0,
-		defaultDurationMs: 2e3,
+		...ANIM_PRESET_IDENTITY.grow,
 		behaviors: (spid, dur, next) => el("p:animScale", null, [raw(el("p:cBhvr", null, [raw(voidEl("p:cTn", {
 			id: next(),
 			dur,
@@ -712,10 +799,7 @@ const ANIM_PRESETS = {
 		}))])
 	},
 	spin: {
-		presetID: 8,
-		presetClass: "emph",
-		presetSubtype: 0,
-		defaultDurationMs: 2e3,
+		...ANIM_PRESET_IDENTITY.spin,
 		behaviors: (spid, dur, next) => el("p:animRot", { by: 216e5 }, [raw(el("p:cBhvr", null, [
 			raw(voidEl("p:cTn", {
 				id: next(),
@@ -727,17 +811,11 @@ const ANIM_PRESETS = {
 		]))])
 	},
 	fadeOut: {
-		presetID: 10,
-		presetClass: "exit",
-		presetSubtype: 0,
-		defaultDurationMs: 500,
+		...ANIM_PRESET_IDENTITY.fadeOut,
 		behaviors: (spid, dur, next) => ANIM_FADE("out", spid, dur, next) + ANIM_SET_HIDDEN(spid, dur, next)
 	},
 	flyOut: {
-		presetID: 2,
-		presetClass: "exit",
-		presetSubtype: 4,
-		defaultDurationMs: 500,
+		...ANIM_PRESET_IDENTITY.flyOut,
 		behaviors: (spid, dur, next) => ANIM_FLY_AXIS("out", "x", spid, dur, next) + ANIM_FLY_AXIS("out", "y", spid, dur, next) + ANIM_SET_HIDDEN(spid, dur, next)
 	}
 };
@@ -847,8 +925,7 @@ function buildBldList(animations) {
 	}
 	return el("p:bldLst", null, raw(bldPs.join("")));
 }
-//#endregion
-//#region src/gen/anim/timing.ts
+// src/gen/anim/timing.ts
 /**
 * Build the slide-level `<p:timing>` tree that makes embedded media loop.
 * - PowerPoint stores playback looping as `repeatCount` on the media node's `<p:cTn>`
@@ -863,7 +940,7 @@ function buildBldList(animations) {
 function slideTimingToXml(slide) {
 	const loopMedia = slide._slideObjects.filter((obj) => obj._type === "media" && obj.mtype !== "online" && typeof obj.mediaRid === "number" && (obj.loop === true || typeof obj.loopCount === "number" && obj.loopCount > 0));
 	const shapeIds = collectSlideShapeIds(slide._slideObjects);
-	const animations = (slide._animations ?? []).filter((anim) => hasKnownAnimationPreset(anim)).map((anim) => ({
+	const animations = slide._animations.filter((anim) => hasKnownAnimationPreset(anim)).map((anim) => ({
 		anim,
 		spid: resolveAnimationSpid(shapeIds, slide._slideObjects, anim)
 	})).filter((entry) => entry.spid !== null);
@@ -901,8 +978,7 @@ function slideTimingToXml(slide) {
 		nodeType: "tmRoot"
 	}, raw(el("p:childTnLst", null, raw(seq + mediaNodes))))))))), raw(bldLst)]);
 }
-//#endregion
-//#region src/gen/anim/transition.ts
+// src/gen/anim/transition.ts
 /**
 * The attributes of a transition's type element, from the caller's `variant`.
 *
@@ -919,7 +995,7 @@ function transitionVariantAttrs(type, variant) {
 			attrs[name] = value;
 			continue;
 		}
-		warnOnce("transition/unknown-variant", `slide transition \`${type}\` variant \`${name}\` is not an attribute of <p:${type}> and is ignored — ${allowed.length > 0 ? `use ${allowed.join(", ")}` : "it takes none"}.`, {
+		warnOnce("transition/unknown-variant", `slide transition \`${type}\` variant \`${name}\` is not an attribute of <p:${type}> and is ignored; ${allowed.length > 0 ? `use ${allowed.join(", ")}` : "it takes none"}.`, {
 			received: name,
 			valid: allowed
 		});
@@ -982,9 +1058,8 @@ function slideTransitionToXml(slide, soundRId) {
 		fallback: el("p:transition", baseAttrs, [raw(typeEl), raw(sndAc)])
 	});
 }
-//#endregion
-//#region src/gen/slide/object.ts
-/** The four axes that make up an explicit group frame. All or nothing — see `givenGroupFrameAxes`. */
+// src/gen/slide/object.ts
+/** The four axes that make up an explicit group frame. All or nothing; see `givenGroupFrameAxes`. */
 const GROUP_FRAME_AXES = [
 	"x",
 	"y",
@@ -996,14 +1071,14 @@ const GROUP_FRAME_AXES = [
 *
 * A group frame is explicit only when **all four** are given; anything less falls back to
 * auto-bounds on every axis. Partial frames used to be honoured per-axis, which let the unset ones
-* take the shared per-object defaults (`x=0`, `y=0`, `cx=75%` of the layout width, `cy=0`) — so
+* take the shared per-object defaults (`x=0`, `y=0`, `cx=75%` of the layout width, `cy=0`), so
 * `addGroup([rect], { x: 5, y: 2 })` emitted a zero-height group whose width was a silent
 * slide-width fraction, and every child of it then re-read as `null` through the read path's
 * degenerate-`chExt` guard.
 *
 * Per-axis fallback was the other candidate, but it cannot mean what it reads like: the writer keeps
 * an identity child space (`chOff/chExt == off/ext`), so a group's frame never moves or scales its
-* children — it only places the selection handle and the rotate pivot. `{ x: 5 }` would leave the
+* children; it only places the selection handle and the rotate pivot. `{ x: 5 }` would leave the
 * children where they were and put the group's box somewhere they are not. Falling back whole, with
 * a warning, keeps the group box around its content and says so out loud.
 * @param options - the group object's options
@@ -1023,7 +1098,7 @@ const hasCompleteGroupFrame = (options) => givenGroupFrameAxes(options).length =
 * `<a:ext cx>`/`<a:ext cy>` are `ST_PositiveCoordinate` (ECMA-376 Part 1, `CT_PositiveSize2D`), so a
 * negative extent is schema-invalid. PowerPoint rejects the *whole* presentation with "The file or
 * directory is corrupted and unreadable" (0x80070570) and names no shape, part, or slide, while
-* LibreOffice renders the same package happily — so the defect is invisible until the deck reaches
+* LibreOffice renders the same package happily, so the defect is invisible until the deck reaches
 * PowerPoint.
 *
 * A signed delta is the natural way to write "draw from A to B" (`{ x: x0, y: y0, w: x1 - x0, h: y1 - y0 }`),
@@ -1075,7 +1150,7 @@ function resolveObjectFrame(obj, slide) {
 	const layout = slide._presLayout;
 	const placeholder = findLayoutPlaceholder(slide._slideLayout, itemOpts.placeholder);
 	const phOpts = placeholder?.options ?? {};
-	const inherited = (own, ph) => own !== void 0 ? own : ph ?? void 0;
+	const inherited = (own, ph) => own ?? ph ?? void 0;
 	const ownX = inherited(itemOpts.x, phOpts.x);
 	const ownY = inherited(itemOpts.y, phOpts.y);
 	const ownW = inherited(itemOpts.w, phOpts.w);
@@ -1096,7 +1171,7 @@ function resolveObjectFrame(obj, slide) {
 * Whether this part has a real slide number to cache in a `slidenum` field.
 *
 * Only a slide does. A master leaves `_slideNum` null and a layout carries the internal 1000+
-* counter that keeps layout media keys from colliding with slide media — neither is a page
+* counter that keeps layout media keys from colliding with slide media. Neither is a page
 * number, and neither belongs in the field's cached text.
 */
 function hasRealSlideNumber(slide) {
@@ -1107,7 +1182,7 @@ function hasRealSlideNumber(slide) {
 *
 * Unique `objectName` values are what consumers (e.g. semantic manifests) rely on, so
 * collisions are flagged loudly. Deliberately NOT `warnOnce`: this runs per emit, and two
-* `write()` calls are two separate exports — a caller capturing diagnostics around the second
+* `write()` calls are two separate exports, and a caller capturing diagnostics around the second
 * would otherwise be told its deck is clean because the first one had already said otherwise. Groups are recursed into: a group's children are
 * `<p:cNvPr>`-named on this same slide, so a child colliding with a top-level object (or with a
 * child of another group) is a collision the Selection Pane shows, and checking only the top
@@ -1126,14 +1201,32 @@ function warnDuplicateObjectNames(slide) {
 * mutually exclusive because a master carrying both a `color` and a `path` must still produce a
 * single `<p:bg>`.
 */
+/**
+* The `<a:srcRect>` of a picture background: the crop an `image: { crop }` background states, else
+* the empty, uncropped form every picture background wrote before it could have one.
+*/
+function backgroundSrcRect(background) {
+	const image = backgroundImage(background);
+	const crop = image && "crop" in image ? image.crop : void 0;
+	return crop ? genXmlImageCropRect(crop, "background image", "") : voidEl("a:srcRect");
+}
+/**
+* The children of a picture background's `<a:blip>`: its `transparency` as `a:alphaModFix`, as a
+* shape's picture fill writes it and PowerPoint writes Format Background's picture transparency
+* (#98), then the `a:lum` every picture background has always carried.
+*/
+function backgroundBlipEffects(background) {
+	const transparency = typeof background === "object" ? background.transparency : void 0;
+	return (transparency ? voidEl("a:alphaModFix", { amt: transparencyToAlpha(transparency) }) : "") + voidEl("a:lum");
+}
 function slideBackgroundXml(slide) {
 	let strSlideXml = "";
 	if (slide._bkgdImgRid) strSlideXml += el("p:bg", null, raw(el("p:bgPr", null, [raw(el("a:blipFill", {
 		dpi: "0",
 		rotWithShape: "1"
 	}, [
-		raw(el("a:blip", { "r:embed": `rId${slide._bkgdImgRid}` }, raw(voidEl("a:lum")))),
-		raw(voidEl("a:srcRect")),
+		raw(el("a:blip", { "r:embed": `rId${slide._bkgdImgRid}` }, raw(backgroundBlipEffects(slide.background)))),
+		raw(backgroundSrcRect(slide.background)),
 		raw(STRETCH_FILL_RECT)
 	])), raw(voidEl("a:effectLst"))])));
 	else if (fillNamesPaint(slide.background)) strSlideXml += el("p:bg", null, raw(el("p:bgPr", null, [raw(genXmlColorSelection(slide.background)), raw(voidEl("a:effectLst"))])));
@@ -1144,7 +1237,7 @@ function slideBackgroundXml(slide) {
 * The slide-number placeholder shape.
 *
 * Emitted after every authored object, so its `<p:cNvPr>` id can come from the same monotonic
-* counter the walk has been advancing — the caller allocates it and passes it in.
+* counter the walk has been advancing; the caller allocates it and passes it in.
 *
 * @param slide - the slide, layout or master being emitted
 * @param snProps - the part's slide-number properties, read but never written: a serializer
@@ -1178,19 +1271,21 @@ function slideNumberPlaceholderXml(slide, snProps, slideNumberId) {
 	})))), { openPrefix: " " }) + "</p:spPr>";
 	strSlideXml += "<p:txBody>";
 	const snInsets = resolveInsetsEmu(snProps.margin);
-	strSlideXml += voidEl("a:bodyPr", {
+	const snWarp = checkEnumOrWarn(snProps.textWarp, TEXT_SHAPE_TYPES, "text/invalid-warp", "slideNumber: textWarp");
+	strSlideXml += elOrVoid("a:bodyPr", {
 		lIns: snInsets?.l ?? null,
 		tIns: snInsets?.t ?? null,
 		rIns: snInsets?.r ?? null,
 		bIns: snInsets?.b ?? null,
-		anchor: resolveTextAnchor(snProps.valign)
-	});
+		anchor: resolveTextAnchor(snProps.valign),
+		vert: checkEnumOrWarn(snProps.textDirection, TEXT_VERTICAL, "text/invalid-vertical", "slideNumber: textDirection")
+	}, snWarp ? el("a:prstTxWarp", { prst: snWarp }, raw(voidEl("a:avLst"))) : "");
 	let defRPr = "";
 	rejectEmptyColor(snProps.color, "slideNumber color");
 	if (snProps.fontFace || snProps.fontSize || snProps.color) {
 		const face = snProps.fontFace;
 		defRPr = el("a:defRPr", { sz: clampFontSizeSz(snProps.fontSize || 12) }, [
-			snProps.color ? raw(genXmlColorSelection(snProps.color)) : null,
+			snProps.color ? raw(genXmlColorSelection(solidPaint(snProps.color, snProps.transparency))) : null,
 			face ? raw(voidEl("a:latin", { typeface: face })) : null,
 			face ? raw(voidEl("a:ea", { typeface: face })) : null,
 			face ? raw(voidEl("a:cs", { typeface: face })) : null
@@ -1200,20 +1295,47 @@ function slideNumberPlaceholderXml(slide, snProps, slideNumberId) {
 	const snAlignRaw = snProps.align ?? "left";
 	const snAlign = snAlignRaw.startsWith("c") ? "ctr" : snAlignRaw.startsWith("r") ? "r" : "l";
 	strSlideXml += el("a:p", null, [
-		raw(voidEl("a:pPr", { algn: snAlign })),
+		raw(voidEl("a:pPr", {
+			algn: snAlign,
+			marL: paragraphMarginEmu(snProps.paraMarginLeft, clampParaMarginEmu),
+			indent: paragraphMarginEmu(snProps.paraIndent, clampParaIndentEmu)
+		})),
 		raw(el("a:fld", {
 			id: SLDNUMFLDID,
 			type: "slidenum"
-		}, [raw(voidEl("a:rPr", {
-			b: xsdBool(snProps.bold),
-			lang: "en-US"
-		})), raw(el("a:t", null, hasRealSlideNumber(slide) ? String(slide._slideNum) : SLDNUM_PLACEHOLDER_TEXT))])),
+		}, [raw(slideNumberRunProperties(snProps)), raw(el("a:t", null, hasRealSlideNumber(slide) ? String(slide._slideNum) : SLDNUM_PLACEHOLDER_TEXT))])),
 		raw(voidEl("a:endParaRPr", { lang: "en-US" }))
 	]);
 	strSlideXml += "</p:txBody></p:sp>";
 	return strSlideXml;
 }
 /**
+* The slide-number field's own `a:rPr`: `b` and `lang` as it has always written them, then the
+* character options `addText` writes on a run's `a:rPr` (`genXmlTextRunProperties`). Colour, face
+* and size stay on the list style's `a:defRPr`, where they were written first.
+* @param snProps - the part's slide-number properties
+*/
+function slideNumberRunProperties(snProps) {
+	const underline = underlineProps(snProps.underline);
+	rejectEmptyColor(snProps.highlight, "slideNumber highlight");
+	rejectEmptyColor(underline?.color, "slideNumber underline.color");
+	return elOrVoid("a:rPr", {
+		b: xsdBool(snProps.bold),
+		lang: snProps.lang || "en-US",
+		i: xsdBoolIfTrue(snProps.italic),
+		cap: snProps.caps ? checkEnumOrWarn(snProps.caps, TEXT_CAPS_TYPES, "text/invalid-caps", "slideNumber `caps`") : null,
+		u: underline?.style ? checkEnumOrWarn(underline.style, TEXT_UNDERLINE_TYPES, "text/invalid-underline", "slideNumber `underline.style`") : null
+	}, [
+		snProps.highlight ? el("a:highlight", null, raw(createColorElement(snProps.highlight))) : "",
+		underline?.color ? el("a:uFill", null, raw(genXmlColorSelection(underline.color))) : "",
+		snProps.fontFaceEA ? voidEl("a:ea", { typeface: snProps.fontFaceEA }) : ""
+	].join(""));
+}
+/** `paraMarginLeft` / `paraIndent` in EMU through the attribute's clamp, or `null` to write none. */
+function paragraphMarginEmu(option, clamp) {
+	return option === void 0 || option === "inherit" ? null : clamp(option);
+}
+/**
 * Transforms a slide or slideLayout to resulting XML string - Creates `ppt/slide*.xml`
 * @param slide - slide object created within createSlideObject
 * @param renderers - which renderer emits each shape family; see {@link RendererTable} for why
@@ -1379,8 +1501,8 @@ function slideObjectToXml(slide, renderers) {
 function defaultRelIdStart(slide) {
 	let lastRid = 0;
 	for (const rel of slide._rels) lastRid = Math.max(lastRid, rel.rId);
-	for (const rel of slide._relsChart || []) lastRid = Math.max(lastRid, rel.rId);
-	for (const rel of slide._relsMedia || []) lastRid = Math.max(lastRid, rel.rId);
+	for (const rel of slide._relsChart) lastRid = Math.max(lastRid, rel.rId);
+	for (const rel of slide._relsMedia) lastRid = Math.max(lastRid, rel.rId);
 	return lastRid + 1;
 }
 /**
@@ -1390,7 +1512,7 @@ function defaultRelIdStart(slide) {
 * `selfPath` is the emitting part's own path, and it is required because a relationship target
 * resolves against the part that states it. An internal slide link used to be written
 * `slide${n}.xml` whatever the part, which is right from `ppt/slides/` and names nothing from
-* `ppt/slideLayouts/` or `ppt/slideMasters/` — so a `hyperlink: { slide }` on an object given to
+* `ppt/slideLayouts/` or `ppt/slideMasters/`, so a `hyperlink: { slide }` on an object given to
 * `defineSlideMaster({ objects })` wrote a dangling relationship.
 * @param {PresSlideInternal | SlideLayoutInternal | SlideMasterInternal} slide - slide, layout or master whose relations are being transformed
 * @param {{ target: string; type: string }[]} defaultRels - array of default relations
@@ -1405,7 +1527,7 @@ function slideObjectRelationsToXml(slide, defaultRels, selfPath) {
 	* told from the first by the first already being there.
 	*
 	* Two things about the shape. It holds raw Targets rather than escaped ones, because this
-	* asks about the model and not about markup — the probe used to substring-scan the emitted
+	* asks about the model and not about markup. The probe used to substring-scan the emitted
 	* XML for ` Target="…"`, which forced the caller to escape by hand with the same escaper the
 	* builder uses or the two drifted apart, and cost O(rels squared) in string scanning.
 	*
@@ -1422,10 +1544,11 @@ function slideObjectRelationsToXml(slide, defaultRels, selfPath) {
 			else rels.push(externalHyperlinkRel(rel.rId, rel.Target));
 		}
 	});
-	(slide._relsChart || []).forEach((rel) => {
+	slide._relsChart.forEach((rel) => {
 		rels.push(relationshipEl(rel.rId, rel.isChartEx ? CHARTEX_REL : CHART_REL, rel.Target));
 	});
-	(slide._relsMedia || []).forEach((rel) => {
+	slide._relsMedia.forEach((rel) => {
+		if (rel.chartOwned) return;
 		const relType = rel.type.toLowerCase();
 		const seen = mediaTargets.has(rel.Target);
 		mediaTargets.add(rel.Target);
@@ -1443,10 +1566,9 @@ function slideObjectRelationsToXml(slide, defaultRels, selfPath) {
 	});
 	return relationshipsPart(rels);
 }
-//#endregion
-//#region src/gen/slide/slide.ts
+// src/gen/slide/slide.ts
 /**
-* ts-pptx: slide part + slide/layout rels
+* pptx-ts: slide part + slide/layout rels
 *
 * Emit a slide (`ppt/slides/slideN.xml`) and the relationship files for slides
 * and layouts (`slideN.xml.rels`, `slideLayoutN.xml.rels`).
@@ -1462,7 +1584,7 @@ function slideObjectRelationsToXml(slide, defaultRels, selfPath) {
 function makeXmlSlide(slide, renderers, transitionSoundRId) {
 	return XML_DECL + "\r\n" + el("p:sld", {
 		...PML_ROOT_NS,
-		show: slide?.hidden ? "0" : null
+		show: slide.hidden ? "0" : null
 	}, [
 		raw(slideObjectToXml(slide, renderers)),
 		raw(el("p:clrMapOvr", null, raw(voidEl("a:masterClrMapping")))),
@@ -1501,7 +1623,7 @@ function makeXmlSlideRel(slides, slideLayouts, slideNumber) {
 		target: targetFromPptSubpart(notesSlidePath(slideNumber)),
 		type: NOTES_SLIDE_REL
 	}];
-	if ((slide._comments || []).length > 0) defaultRels.push({
+	if (slide._comments.length > 0) defaultRels.push({
 		target: targetFromPptSubpart(commentPath(slideNumber)),
 		type: COMMENTS_REL
 	});
@@ -1518,10 +1640,9 @@ function getLayoutIdxForSlide(slides, slideLayouts, slideNumber) {
 	for (let i = 0; i < slideLayouts.length; i++) if (slideLayouts[i]?._name === slides[slideNumber - 1]?._slideLayout?._name) return i + 1;
 	return 1;
 }
-//#endregion
-//#region src/gen/pres/theme.ts
+// src/gen/pres/theme.ts
 /**
-* ts-pptx: `ppt/theme/theme1.xml`
+* pptx-ts: `ppt/theme/theme1.xml`
 *
 * Emit the Office theme: the `<a:clrScheme>` (with any caller color overrides
 * over the default Office scheme) plus the fixed font/format schemes.
@@ -1572,13 +1693,13 @@ function buildThemeClrScheme(scheme) {
 }
 /**
 * The per-script theme font fallback table (`a:fontScheme`'s CT_TextFont lists), in OOXML
-* document order. Static Office defaults — no caller data, no escaping risk — unlike the
+* document order. Static Office defaults (no caller data, no escaping risk), unlike the
 * `<a:latin>`/`<a:ea>`/`<a:cs>` slots above.
 *
 * Forty-one of the forty-seven scripts take the same face in the major and minor lists, so the
 * shared table below is the whole thing and the two override maps hold the six-odd rows that
 * actually differ. Written out twice, ninety-four lines said less than these do, and one row
-* mistyped in one copy produces a theme that opens fine and paints a script in the wrong face —
+* mistyped in one copy produces a theme that opens fine and paints a script in the wrong face:
 * a difference nobody reviewing a diff of two 47-row tables would see.
 */
 const THEME_FONT_LIST = [
@@ -1703,15 +1824,14 @@ function makeXmlTheme(pres) {
 		raw(extLst)
 	]);
 }
-//#endregion
-//#region src/gen/extract-slides.ts
+// src/gen/extract-slides.ts
 /**
 * Embedded audio/video. addMedia (`gen/define/media.ts`) pushes three consecutive
 * _relsMedia entries per item off `mediaRid`: the ECMA audio/video rel
 * (rId=mediaRid), the MS-2007 `media` rel (mediaRid+1, sharing one Target),
 * and the preview image rel (mediaRid+2). The body references all three; we
 * surface the descriptor so appendSlides can reproduce the rel graph. Online
-* media (external link) is excluded — it has a different rel shape and no part.
+* media (external link) is excluded: it has a different rel shape and no part.
 */
 function avMediaOf(slide, relByRid) {
 	return slide._slideObjects.filter((obj) => obj._type === "media" && obj.mtype !== "online" && typeof obj.mediaRid === "number").map((obj) => {
@@ -1720,8 +1840,8 @@ function avMediaOf(slide, relByRid) {
 		const mediaRel = relByRid.get(mediaRid);
 		const previewRel = relByRid.get(previewRid(mediaRid));
 		if (!mediaRel || !previewRel) return null;
-		const mediaBytes = decodeBase64ToBytes(typeof mediaRel.data === "string" ? mediaRel.data : "");
-		const previewBytes = decodeBase64ToBytes(typeof previewRel.data === "string" ? previewRel.data : "");
+		const mediaBytes = decodeBase64ToBytes(mediaRel.data);
+		const previewBytes = decodeBase64ToBytes(previewRel.data);
 		if (!mediaBytes || !previewBytes) return null;
 		const mediaExtn = relExtension(mediaRel, "mp4");
 		const previewExtn = relExtension(previewRel, "png");
@@ -1756,9 +1876,8 @@ function relExtension(rel, fallback) {
 * excluded here rather than surfaced twice.
 */
 function imageMediaOf(slide, avPreviewRids) {
-	return slide._relsMedia.filter((rel) => rel.type.toLowerCase().includes("image") && !avPreviewRids.has(rel.rId)).map((rel) => {
-		const data = rel.data && typeof rel.data === "string" ? rel.data : "";
-		const bytes = decodeBase64ToBytes(data);
+	return slide._relsMedia.filter((rel) => rel.type.toLowerCase().includes("image") && !avPreviewRids.has(rel.rId) && !rel.chartOwned).map((rel) => {
+		const bytes = decodeBase64ToBytes(rel.data);
 		const extn = relExtension(rel, "png");
 		return bytes ? {
 			rId: rel.rId,
@@ -1769,6 +1888,23 @@ function imageMediaOf(slide, avPreviewRids) {
 	}).filter((m) => m !== null);
 }
 /**
+* A transition's start sound: the audio part behind `p:sndAc/p:stSnd/p:snd r:embed`, under the
+* `rId` {@link registerTransitionSounds} gave it. `undefined` when the slide has no start sound.
+*/
+function transitionSoundOf(rId, relByRid) {
+	const rel = rId === void 0 ? void 0 : relByRid.get(rId);
+	if (!rel || rId === void 0) return void 0;
+	const bytes = decodeBase64ToBytes(rel.data);
+	if (!bytes) return void 0;
+	const extn = relExtension(rel, "wav");
+	return {
+		rId,
+		bytes,
+		extn,
+		contentType: avContentType(extn, "audio")
+	};
+}
+/**
 * Online (external-link) video. addMedia type:'online' pushes three rels off
 * mediaRid: the ECMA video rel (mediaRid, External), the MS-2007 media rel
 * (mediaRid+1, External, sharing the link Target), and the poster image rel
@@ -1801,10 +1937,10 @@ function hyperlinksOf(slide) {
 * A Target that does not read as a slide number throws rather than passing `NaN` on to the
 * append path's rel-graph rebuild, where it surfaces as "links to source slide NaN" a whole
 * subsystem later. `addText` writes this Target itself, so the condition is a defect on this
-* side rather than bad input — an {@link InternalError}, like the chart router's own.
+* side rather than bad input: an {@link InternalError}, like the chart router's own.
 */
-function slideLinksOf(slide) {
-	return slide._rels.filter((rel) => isHyperlinkRel(rel) && rel.data === "slide").map((rel) => {
+function slideLinksOf(rels) {
+	return rels.filter((rel) => isHyperlinkRel(rel) && rel.data === "slide").map((rel) => {
 		const sourceSlideNumber = Number(rel.Target);
 		if (!Number.isInteger(sourceSlideNumber) || sourceSlideNumber < 1) throw new InternalError("slide/link-target-not-a-number", `Internal slide link rId${rel.rId} targets "${String(rel.Target)}", which is not a slide number`);
 		return {
@@ -1823,10 +1959,11 @@ function notesOf(slide) {
 	const notes = buildNotesSlideRels(slide);
 	return {
 		xml: makeXmlNotesSlide(slide, notes),
-		hyperlinks: notes.rels.filter((rel) => typeof rel.Target === "string" && rel.Target).map((rel) => ({
+		hyperlinks: notes.rels.filter((rel) => rel.data !== "slide" && typeof rel.Target === "string" && rel.Target).map((rel) => ({
 			rId: rel.rId,
 			target: rel.Target
-		}))
+		})),
+		slideLinks: slideLinksOf(notes.rels)
 	};
 }
 /**
@@ -1839,6 +1976,7 @@ async function extractSlides(source, opts = {}) {
 	const { presentation } = source;
 	const deckSlides = presentation.slides;
 	requireSlideLinksInDeck(deckSlides);
+	const transitionSoundRIds = registerTransitionSounds(deckSlides);
 	backfillPlaceholders(deckSlides);
 	await encodeMediaForTargets(deckSlides, source.runtime, onMediaError);
 	const restoreAuthoredFit = bakeMeasuredFit(deckSlides, source.fontMetrics);
@@ -1848,15 +1986,19 @@ async function extractSlides(source, opts = {}) {
 			const relByRid = new Map(slide._relsMedia.map((rel) => [rel.rId, rel]));
 			const avMedia = avMediaOf(slide, relByRid);
 			const notes = notesOf(slide);
+			const soundRId = transitionSoundRIds.get(slide);
+			const transitionSound = transitionSoundOf(soundRId, relByRid);
 			return {
-				xml: makeXmlSlide(slide, source.renderers),
+				xml: makeXmlSlide(slide, source.renderers, soundRId),
 				media: imageMediaOf(slide, new Set(avMedia.map((item) => item.previewRid))),
 				hyperlinks: hyperlinksOf(slide),
 				charts: source.extract.charts?.(slide) ?? [],
-				slideLinks: slideLinksOf(slide),
+				slideLinks: slideLinksOf(slide._rels),
 				avMedia,
 				onlineMedia: onlineMediaOf(slide, relByRid),
-				...notes ? { notes } : {}
+				...notes ? { notes } : {},
+				...transitionSound ? { transitionSound } : {},
+				...slide._comments.length ? { comments: slide._comments } : {}
 			};
 		});
 	} finally {
@@ -1874,10 +2016,9 @@ async function extractSlides(source, opts = {}) {
 		...notesMaster ? { notesMaster } : {}
 	};
 }
-//#endregion
-//#region src/gen/opc/app.ts
+// src/gen/opc/app.ts
 /**
-* ts-pptx: `docProps/app.xml`
+* pptx-ts: `docProps/app.xml`
 *
 * Emit the extended-properties part (application, slide/notes counts, heading
 * pairs, titles of parts, company).
@@ -1957,34 +2098,25 @@ function makeXmlApp(slides, company, presLayout) {
 		raw(el("AppVersion", null, "16.0000", PROP))
 	], { closePrefix: INDENT_1 });
 }
-//#endregion
-//#region src/gen/opc/content-types.ts
+// src/gen/opc/content-types.ts
 /**
-* ts-pptx: `[Content_Types].xml`
+* pptx-ts: `[Content_Types].xml`
 *
 * Emit the package content-types part: Default entries for the media extensions
 * actually used by the deck (plus the font default when faces are embedded) and
 * Override entries for every part the package skeleton writes.
 *
 * Entries that exist only because a construct family put a part in the package arrive as
-* {@link ContentTypeContributions} — already resolved to data and grouped by where they land.
+* {@link ContentTypeContributions}, already resolved to data and grouped by where they land.
 * The order below is a property of the format, not of whoever assembled that list, so a deck
 * written by a program that links three families and one that links ten emit the same bytes.
 */
 /**
 * Some Override entries have always been emitted with a leading space. It is insignificant
 * whitespace, but it is in the bytes this library has shipped for years, so it is reproduced
-* verbatim rather than normalized (see AGENTS.md "Byte identity": whitespace diffs are a STOP).
+* verbatim rather than normalized (see "Byte identity" in `docs/contributing/testing.md`: whitespace diffs fail the gate).
 */
 const LEADING_SPACE = { openPrefix: " " };
-/** Nothing beyond the skeleton — the shape a deck written with no construct families contributes. */
-const NO_CONTENT_TYPE_CONTRIBUTIONS = Object.freeze({
-	defaults: [],
-	presentation: [],
-	perSlide: [],
-	perLayout: [],
-	trailing: []
-});
 function contentDefault(extension, contentType) {
 	return voidEl("Default", {
 		Extension: extension,
@@ -2007,16 +2139,15 @@ function contributedOverride(entry) {
 * @returns XML
 */
 function makeXmlContTypes(opts) {
-	const { slides, slideLayouts, masterSlide, hasCustomProps, embeddedFonts } = opts;
-	const contributions = opts.contributions ?? NO_CONTENT_TYPE_CONTRIBUTIONS;
+	const { slides, slideLayouts, masterSlide, hasCustomProps, embeddedFonts, contributions } = opts;
 	const parts = [contentDefault("xml", "application/xml"), contentDefault("rels", RELATIONSHIPS_CONTENT_TYPE)];
 	const extnTypeMap = /* @__PURE__ */ new Map();
 	const ctTargets = [];
-	(slides || []).forEach((s) => ctTargets.push(s));
-	(slideLayouts || []).forEach((l) => ctTargets.push(l));
-	if (masterSlide) ctTargets.push(masterSlide);
+	slides.forEach((s) => ctTargets.push(s));
+	slideLayouts.forEach((l) => ctTargets.push(l));
+	ctTargets.push(masterSlide);
 	ctTargets.forEach((target) => {
-		(target._relsMedia || []).forEach((rel) => {
+		target._relsMedia.forEach((rel) => {
 			if (rel.type === "online" || !rel.extn || !rel.type) return;
 			const contentType = rel.type.startsWith("audio/") ? avContentType(rel.extn, "audio") : rel.type.startsWith("video/") ? avContentType(rel.extn, "video") : rel.type;
 			if (!extnTypeMap.has(rel.extn)) extnTypeMap.set(rel.extn, contentType);
@@ -2030,7 +2161,7 @@ function makeXmlContTypes(opts) {
 		extnTypeMap.set(entry.extension, entry.contentType);
 		parts.push(contentDefault(entry.extension, entry.contentType));
 	});
-	if ((embeddedFonts || []).some((font) => font.faces.some((face) => face.bytes))) parts.push(contentDefault(FONT_DATA_EXTENSION, FONT_DATA_CONTENT_TYPE));
+	if (embeddedFonts.some((font) => font.faces.some((face) => face.bytes))) parts.push(contentDefault(FONT_DATA_EXTENSION, FONT_DATA_CONTENT_TYPE));
 	parts.push(override(overrideName(PRESENTATION_PATH), PRESENTATION_MAIN_CONTENT_TYPE));
 	contributions.presentation.forEach((entry) => parts.push(contributedOverride(entry)));
 	parts.push(override(overrideName(SLIDE_MASTER_PATH), SLIDE_MASTER_CONTENT_TYPE));
@@ -2053,10 +2184,9 @@ function makeXmlContTypes(opts) {
 	if (hasCustomProps) parts.push(override("/docProps/custom.xml", CUSTOM_PROPS_CONTENT_TYPE, LEADING_SPACE));
 	return XML_DECL + "\r\n" + el("Types", { xmlns: OOXML_NS.ct }, parts.map(raw));
 }
-//#endregion
-//#region src/gen/opc/custom-props.ts
+// src/gen/opc/custom-props.ts
 /**
-* ts-pptx: `docProps/custom.xml`
+* pptx-ts: `docProps/custom.xml`
 *
 * Emit the custom-properties part from caller-supplied name/value pairs (bool,
 * date, number and string value types).
@@ -2086,10 +2216,9 @@ function makeXmlCustomProperties(props) {
 	}, raw(valueEl(value)))));
 	return XML_DECL + "\r\n" + el("Properties", PROPS_NS, properties);
 }
-//#endregion
-//#region src/gen/opc/root-rels.ts
+// src/gen/opc/root-rels.ts
 /**
-* ts-pptx: `_rels/.rels`
+* pptx-ts: `_rels/.rels`
 *
 * Emit the package root relationships (app/core/presentation, plus custom-props
 * when present).
@@ -2109,8 +2238,7 @@ function makeXmlRootRels(hasCustomProps) {
 	if (hasCustomProps) rels.push(relationshipEl("rId4", CUSTOM_PROPS_REL, "docProps/custom.xml", INDENTED));
 	return relationshipsPart(rels, { closePrefix: "\n		" });
 }
-//#endregion
-//#region src/gen/pres/presentation-rels.ts
+// src/gen/pres/presentation-rels.ts
 /**
 * Creates `ppt/_rels/presentation.xml.rels`
 * @param {PresSlideInternal[]} slides - Presenation Slides
@@ -2124,16 +2252,16 @@ function makeXmlRootRels(hasCustomProps) {
 * theme1/tableStyles, then commentAuthors when the deck has any comment, then the embedded
 * fonts.
 *
-* The rels writer and `makeXmlPresentation` both need these numbers — the presentation part
-* names the notesMaster and each embedded face by `r:id` — and each derived them separately,
+* The rels writer and `makeXmlPresentation` both need these numbers (the presentation part
+* names the notesMaster and each embedded face by `r:id`), and each derived them separately,
 * one as `slides.length + 2` under a comment saying it copied the other's logic. Inserting a
 * relationship before `notesMaster` then broke the presentation's own reference with no
 * signal.
 * @param slides - the deck's slides, whose count and comments decide the layout
 */
 function presentationFixedRelIds(slides) {
-	const first = (slides?.length ?? 0) + 2;
-	const hasComments = (slides || []).some((slide) => (slide._comments || []).length > 0);
+	const first = slides.length + 2;
+	const hasComments = slides.some((slide) => slide._comments.length > 0);
 	return {
 		notesMaster: first,
 		presProps: first + 1,
@@ -2145,7 +2273,7 @@ function presentationFixedRelIds(slides) {
 	};
 }
 /**
-* The first relationship id free for embedded-font rels — {@link presentationFixedRelIds}'
+* The first relationship id free for embedded-font rels: {@link presentationFixedRelIds}'
 * `fontStart`, kept as its own name because that is what the two font walks ask for.
 */
 function presentationFontRelStart(slides) {
@@ -2157,13 +2285,12 @@ function makeXmlPresentationRels(slides, embeddedFonts) {
 	for (let idx = 1; idx <= slides.length; idx++) rels.push(relationshipEl(idx + 1, SLIDE_REL, targetFromPresentation(slidePath(idx))));
 	rels.push(relationshipEl(fixed.notesMaster, NOTES_MASTER_REL, targetFromPresentation(NOTES_MASTER_PATH)), relationshipEl(fixed.presProps, PRES_PROPS_REL, "presProps.xml"), relationshipEl(fixed.viewProps, VIEW_PROPS_REL, "viewProps.xml"), relationshipEl(fixed.theme, THEME_REL, "theme/theme1.xml"), relationshipEl(fixed.tableStyles, TABLE_STYLES_REL, "tableStyles.xml"));
 	if (fixed.commentAuthors !== null) rels.push(relationshipEl(fixed.commentAuthors, COMMENT_AUTHORS_REL, "commentAuthors.xml"));
-	for (const face of flattenEmbeddedFaces(embeddedFonts || [], presentationFontRelStart(slides))) rels.push(relationshipEl(face.rId, FONT_REL_TYPE, targetFromPresentation(fontPath(face.partIndex))));
+	for (const face of flattenEmbeddedFaces(embeddedFonts, presentationFontRelStart(slides))) rels.push(relationshipEl(face.rId, FONT_REL_TYPE, targetFromPresentation(fontPath(face.partIndex))));
 	return relationshipsPart(rels);
 }
-//#endregion
-//#region src/gen/pres/presentation.ts
+// src/gen/pres/presentation.ts
 /**
-* ts-pptx: `ppt/presentation.xml` + presProps/viewProps
+* pptx-ts: `ppt/presentation.xml` + presProps/viewProps
 *
 * Emit the presentation part (masters/notes/slide id lists, sizes, embedded-font
 * list, default text styles, sections) and the small presProps/viewProps parts.
@@ -2191,7 +2318,7 @@ function sectionsExtLst(sections) {
 * @return {string} XML
 */
 function makeXmlPresentation(pres) {
-	const openTag = `<p:presentation xmlns:a="${OOXML_NS.a}" xmlns:r="${OOXML_NS.r}" xmlns:p="${OOXML_NS.p}" ${pres.rtlMode ? "rtl=\"1\"" : ""} ${(pres.embeddedFonts || []).some((font) => font.faces.some((face) => face.bytes)) ? "embedTrueTypeFonts=\"1\" saveSubsetFonts=\"0\"" : "saveSubsetFonts=\"1\""} autoCompressPictures="0"${pres.firstSlideNum !== 1 ? ` firstSlideNum="${pres.firstSlideNum}"` : ""}>`;
+	const openTag = `<p:presentation xmlns:a="${OOXML_NS.a}" xmlns:r="${OOXML_NS.r}" xmlns:p="${OOXML_NS.p}" ${pres.rtlMode ? "rtl=\"1\"" : ""} ${pres.embeddedFonts.some((font) => font.faces.some((face) => face.bytes)) ? "embedTrueTypeFonts=\"1\" saveSubsetFonts=\"0\"" : "saveSubsetFonts=\"1\""} autoCompressPictures="0"${pres.firstSlideNum !== 1 ? ` firstSlideNum="${pres.firstSlideNum}"` : ""}>`;
 	const sldMasterIdLst = el("p:sldMasterIdLst", null, raw(voidEl("p:sldMasterId", {
 		id: MIN_SLIDE_MASTER_ID,
 		"r:id": "rId1"
@@ -2211,12 +2338,12 @@ function makeXmlPresentation(pres) {
 		cx: pres.presLayout.height,
 		cy: pres.presLayout.width
 	});
-	const fonts = pres.embeddedFonts || [];
+	const fonts = pres.embeddedFonts;
 	const flat = flattenEmbeddedFaces(fonts, presentationFontRelStart(pres.slides));
 	const rIdOf = new Map(flat.map((face) => [`${face.fontIndex}:${face.slot}`, face.rId]));
 	const embeddedFontLst = serializeEmbeddedFontLst(fonts, (fontIndex, slot) => rIdOf.get(`${fontIndex}:${slot}`));
 	const defaultTextStyle = el("p:defaultTextStyle", null, LEVEL_MARGINS_EMU.map((marL, i) => raw(defaultTextStyleLevel(i + 1, marL))));
-	const extLst = pres.sections && pres.sections.length > 0 ? sectionsExtLst(pres.sections) : "";
+	const extLst = pres.sections.length > 0 ? sectionsExtLst(pres.sections) : "";
 	return XML_DECL + "\r\n" + openTag + sldMasterIdLst + notesMasterIdLst + sldIdLst + sldSz + notesSz + embeddedFontLst + defaultTextStyle + extLst + "</p:presentation>";
 }
 /**
@@ -2262,23 +2389,9 @@ function makeXmlViewProps() {
 		}))
 	]);
 }
-//#endregion
-//#region src/gen/pres/table-styles.ts
-/**
-* Create `ppt/tableStyles.xml`
-* @see: http://openxmldeveloper.org/discussions/formats/f/13/p/2398/8107.aspx
-* @return {string} XML
-*/
-function makeXmlTableStyles() {
-	return XML_DECL + "\r\n" + voidEl("a:tblStyleLst", {
-		"xmlns:a": OOXML_NS.a,
-		def: "{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}"
-	});
-}
-//#endregion
-//#region src/gen/slide/layout.ts
+// src/gen/slide/layout.ts
 /**
-* ts-pptx: slide-layout part
+* pptx-ts: slide-layout part
 *
 * Emit a slide layout (`ppt/slideLayouts/slideLayoutN.xml`) from a layout object.
 */
@@ -2297,10 +2410,9 @@ function makeXmlLayout(layout, renderers) {
 		childPrefix: "\n		"
 	});
 }
-//#endregion
-//#region src/gen/slide/master.ts
+// src/gen/slide/master.ts
 /**
-* ts-pptx: slide-master parts
+* pptx-ts: slide-master parts
 *
 * The slide master (`slideMaster1.xml`) and its `.rels`, plus the master text
 * styles (`<p:txStyles>`): per-level default values mirroring the built-in
@@ -2436,6 +2548,7 @@ function masterAlignAttr(align) {
 /** Build the bullet element for a master level: caller override wins over the level default. */
 function masterBulletXml(bulletOverride, base) {
 	if (bulletOverride === false) return voidEl("a:buNone");
+	if (bulletOverride === true && (base === "none" || base === void 0)) return masterBulletXml({}, base);
 	if (bulletOverride && typeof bulletOverride === "object") {
 		const font = bulletOverride.fontFace ? voidEl("a:buFont", { typeface: bulletOverride.fontFace }) : "";
 		if (bulletOverride.type === "number") {
@@ -2534,7 +2647,7 @@ function makeXmlMasterTxStyles(textStyles) {
 * The built-in Office master's `<p:txStyles>`, used verbatim when `defineSlideMaster({ textStyles })`
 * was never called. Deliberately NOT built via `masterLevelXml`: a configured title level always
 * carries `marL="0"` (from `MASTER_TITLE_DEFAULT.marL`), but the true unconfigured default titleStyle
-* has no `marL`/`indent` attribute at all — a pre-existing asymmetry between the two paths, preserved
+* has no `marL`/`indent` attribute at all: a pre-existing asymmetry between the two paths, preserved
 * exactly rather than unified.
 */
 function makeXmlMasterDefaultTxStyles() {
@@ -2624,8 +2737,7 @@ function makeXmlMasterRel(masterSlide, slideLayouts) {
 	});
 	return slideObjectRelationsToXml(masterSlide, defaultRels, SLIDE_MASTER_PATH);
 }
-//#endregion
-//#region src/package/parts/shared.ts
+// src/package/parts/shared.ts
 /**
 * The contributors in emission order. Sorting here rather than trusting the caller's array is the
 * whole point of {@link PartContributor.order}; the sort is stable, so two families that share a
@@ -2636,7 +2748,7 @@ function orderedContributors(contributors) {
 }
 /**
 * Ask every contributor for its content-type entries and flatten them into the slot-keyed data
-* `makeXmlContTypes` emits. Takes the contributors already ordered — within a slot the entries
+* `makeXmlContTypes` emits. Takes the contributors already ordered; within a slot the entries
 * come out in the order they are collected here.
 */
 function collectContentTypes(contributors, pres) {
@@ -2668,15 +2780,14 @@ function collectContentTypes(contributors, pres) {
 		trailing
 	};
 }
-//#endregion
-//#region src/package/assemble.ts
+// src/package/assemble.ts
 /**
 * Package assembly: turn an authored presentation's internal state into the full set of
 * OOXML package parts and hand the bytes to the ZIP writer. This is the write-side
-* "packaging" layer — `[Content_Types].xml`, the `_rels` graph, docProps, theme, the
-* per-slide/layout/master parts, and media rels — split out of the authoring class
-* (`TsPptx`) so that class stays a façade over slide authoring. The parts a construct
-* family adds on top of that skeleton — charts, comments, notes — come from the part
+* "packaging" layer (`[Content_Types].xml`, the `_rels` graph, docProps, theme, the
+* per-slide/layout/master parts, and media rels), split out of the authoring class
+* (`PptxTs`) so that class stays a façade over slide authoring. The parts a construct
+* family adds on top of that skeleton (charts, comments, notes) come from the part
 * contributors it is handed, so nothing here names a family.
 *
 * The entry point `writePackage` takes a structural {@link PackageSource} that the
@@ -2717,7 +2828,7 @@ const ALREADY_COMPRESSED_MEDIA_EXTN = /* @__PURE__ */ new Set([
 	"oga"
 ]);
 /**
-* Extensions whose payload is itself a ZIP archive — the embedded OPC packages an OLE object can
+* Extensions whose payload is itself a ZIP archive: the embedded OPC packages an OLE object can
 * carry (`addOleObject`). Deflating a zip inside a zip buys nothing, so these are STOREd like the
 * already-compressed media above. No media/image rel ever uses one of these extensions, so decks
 * without an OLE object are unaffected.
@@ -2731,61 +2842,6 @@ const ZIP_CONTAINER_EXTN = /* @__PURE__ */ new Set([
 	"pptm"
 ]);
 /**
-* Each slide's registered transition sound.
-*
-* Kept per slide, never on the transition: one transition object can be assigned to several slides,
-* and a relationship id means something only inside the slide part that declares it. Kept across
-* writes as well, so a deck written twice registers each sound once. An entry is reused only while
-* the slide still holds its relationship and still has the same sound assigned.
-*/
-const registeredTransitionSounds = /* @__PURE__ */ new WeakMap();
-/**
-* Register an audio media part + relationship for each slide-transition start sound
-* (`transition.sound` with `data`/`path`), and return the relationship id each slide's
-* `p:sndAc/p:snd r:embed` refers to. Runs before media encoding so the bytes are loaded. Re-export
-* is safe: a slide whose sound is already registered reuses that relationship. The stop-previous
-* form (`sound.stopPrevious`) needs no part and is skipped.
-*
-* Registered here, at write time, rather than when `slide.transition` is assigned. A slide's rel
-* ids and media part names are handed out in registration order, and a transition is often set
-* before the slide's pictures and media are added; registering the sound then would move every
-* later rel id and part name on the slide.
-*/
-function registerTransitionSounds(slides) {
-	const soundRIds = /* @__PURE__ */ new Map();
-	slides.forEach((slide) => {
-		const transition = slide.transition;
-		if (!transition || !TRANSITION_TYPES.includes(transition.type)) return;
-		const sound = transition.sound;
-		if (!sound || sound.stopPrevious) return;
-		if (!sound.data && !sound.path) return;
-		const registered = registeredTransitionSounds.get(slide);
-		if (registered && slide._relsMedia.includes(registered.rel) && registered.data === sound.data && registered.path === sound.path) {
-			soundRIds.set(slide, registered.rel.rId);
-			return;
-		}
-		const dataMime = dataUriMediaType(sound.data ?? "");
-		const pathFile = sound.path ? (sound.path.split("/").pop() ?? "").split("?")[0] ?? "" : "";
-		const extn = dataMime?.startsWith("audio/") ? audioExtensionForSubtype(dataMime.slice(6)) : (pathFile.split(".").pop() ?? "wav").toLowerCase();
-		const rId = getNewRelId(slide);
-		const rel = pushMediaRel(slide, {
-			kind: "audio",
-			extn,
-			type: `audio/${extn}`,
-			path: sound.path,
-			data: sound.data,
-			rId
-		});
-		registeredTransitionSounds.set(slide, {
-			rel,
-			data: sound.data,
-			path: sound.path
-		});
-		soundRIds.set(slide, rId);
-	});
-	return soundRIds;
-}
-/**
 * Write the media parts one target's rels point at. Images are how every deck carries a picture,
 * so this stays on the core path; the chart half of what used to be one function is a part
 * contributor (`parts/chart.ts`) and runs just before it, per target, so part order is unchanged.
@@ -2804,8 +2860,7 @@ function createMediaParts(slide, zip, written) {
 		if (rel.type !== "online" && rel.type !== "hyperlink") {
 			const path = rel.Target.replace("..", "ppt");
 			if (written.has(path)) return;
-			const data = rel.data && typeof rel.data === "string" ? rel.data : "";
-			const bytes = decodeBase64ToBytes(data);
+			const bytes = decodeBase64ToBytes(rel.data);
 			if (!bytes) return;
 			const extn = (rel.extn || rel.Target.split(".").pop() || "").toLowerCase();
 			zip.add(path, bytes, { store: ALREADY_COMPRESSED_MEDIA_EXTN.has(extn) || ZIP_CONTAINER_EXTN.has(extn) });
@@ -2819,7 +2874,7 @@ function createMediaParts(slide, zip, written) {
 * media de-dup, chart-part-id assignment, and measured-fit passes before the synchronous
 * XML pass reads slide state. The bytes are the same the ZIP writer would compress; splitting the
 * assembly from the zip lets the byte-identity harness (and a future parts API) read parts
-* directly. Only `onMediaError` is meaningful here — compression/output shape are zip concerns
+* directly. Only `onMediaError` is meaningful here; compression/output shape are zip concerns
 * handled by {@link zipPackageParts}.
 */
 async function buildPackageParts(source, props) {
@@ -2838,16 +2893,16 @@ async function buildPackageParts(source, props) {
 	];
 	return await encodeMediaForTargets(mediaTargets, source.runtime, onMediaError).then(async () => {
 		const canonicalMediaTargets = /* @__PURE__ */ new Map();
-		for (const target of mediaTargets) for (const rel of target._relsMedia || []) {
-			if (rel.type === "online" || rel.type === "hyperlink" || typeof rel.data !== "string" || !rel.data) continue;
+		for (const target of mediaTargets) for (const rel of target._relsMedia) {
+			if (rel.type === "online" || rel.type === "hyperlink" || !rel.data) continue;
 			if (rel.oleRelType) continue;
-			const key = (rel.extn || "") + "\0" + rel.data;
+			const key = rel.extn + "\0" + rel.data;
 			const canonical = canonicalMediaTargets.get(key);
 			if (canonical) rel.Target = canonical;
 			else canonicalMediaTargets.set(key, rel.Target);
 		}
 		let chartPartIdx = 0;
-		for (const target of mediaTargets) for (const rel of target._relsChart || []) {
+		for (const target of mediaTargets) for (const rel of target._relsChart) {
 			const chartId = ++chartPartIdx;
 			rel.globalId = chartId;
 			const { fileName, target } = chartPartNames(chartId, rel.isChartEx);
@@ -2876,7 +2931,7 @@ async function buildPackageParts(source, props) {
 			zip.add("ppt/theme/theme2.xml", themeXml);
 			zip.add(PRESENTATION_PATH, makeXmlPresentation(pres));
 			zip.add("ppt/presProps.xml", makeXmlPresProps());
-			zip.add("ppt/tableStyles.xml", makeXmlTableStyles());
+			zip.add("ppt/tableStyles.xml", makeXmlTableStyles(contributors.flatMap((contributor) => contributor.parts?.tableStyles?.(pres) ?? [])));
 			zip.add("ppt/viewProps.xml", makeXmlViewProps());
 			pres.slideLayouts.forEach((layout, idx) => {
 				zip.add(slideLayoutPath(idx + 1), makeXmlLayout(layout, source.renderers));
@@ -2909,7 +2964,7 @@ async function buildPackageParts(source, props) {
 }
 /**
 * Zip an ordered list of package parts into the output shape `props.outputType` selects. Re-adds
-* each part to a fresh {@link ZipWriter} in order — preserving each part's `store` hint — so the
+* each part to a fresh {@link ZipWriter} in order (preserving each part's `store` hint), so the
 * archive is byte-identical to assembling straight into one writer. Compression and output type
 * are the only zip-level knobs; part assembly happened in {@link buildPackageParts}.
 */
@@ -2928,23 +2983,22 @@ async function zipPackageParts(parts, props) {
 async function writePackage(source, props) {
 	return await zipPackageParts(await buildPackageParts(source, props), props);
 }
-//#endregion
-//#region src/presentation.ts
+// src/presentation.ts
 /**
-* ts-pptx: the presentation core
+* pptx-ts: the presentation core
 *
 * Home of {@link PresentationCore}, the class every entry point subclasses with a runtime
 * adapter (`index.ts`, `node.ts`, `browser.ts`). See the class doc below for the layout of
 * its body and where package assembly actually happens.
 *
-* Units: this library takes user coordinates in inches and converts to EMU on output — see
+* Units: this library takes user coordinates in inches and converts to EMU on output. See
 * `units.ts` for the conversions and `STANDARD_LAYOUTS` for the built-in slide sizes.
 *
 * Derived from PptxGenJS (C) 2015-present Brent Ely (MIT), which in turn took some code from
 * the OfficeGen project (Copyright 2013 Ziv Barber). This project is likewise MIT; the full
 * license text is in `LICENSE` at the repository root.
 */
-const VERSION = "4.0.1";
+const VERSION = "4.2.0";
 function standardLayoutToPresLayout(layout) {
 	return {
 		name: layout.name,
@@ -2973,8 +3027,8 @@ function layoutSideInches(value, side) {
 	return clampRangedInput(Number(value), 1, 56, "layout/size-out-of-range", `defineLayout ${side} (inches)`, "coord/non-finite");
 }
 /**
-* Main presentation class and package export flow — the public entry point consumers
-* instantiate (`new TsPptx()`). Owns presentation-level state and metadata, collects
+* Main presentation class and package export flow: the public entry point consumers
+* instantiate (`new PptxTs()`). Owns presentation-level state and metadata, collects
 * slides, and drives `write`/`writeFile`/`stream`. The actual OOXML string building is
 * delegated to the `gen-*` modules; runtime file/stream output goes through the injected
 * `RuntimeAdapter`. Enums (`AlignH`, `ChartType`, `ShapeType`, …) are imported from the
@@ -2983,12 +3037,12 @@ function layoutSideInches(value, side) {
 * Rough layout of the class body:
 *   - Metadata accessors      layout / author / company / title / theme / sections getters+setters
 *   - Private slide helpers    addNewSlide, getSlide, setSlideNumber
-*   - Public export methods    stream / write / writeFile — delegate packaging to `writePackage`
+*   - Public export methods    stream / write / writeFile; delegate packaging to `writePackage`
 *   - Public authoring methods addSlide / defineLayout / defineSlideMaster / defineTableStyle
 *
 * Package assembly (`[Content_Types].xml`, the rels graph, per-part XML, the ZIP) lives in
 * `package/assemble.ts`; this class provides the deck state via {@link PresentationCore.packageSource}.
-* The live-DOM `tableToSlides()` is NOT here — it is added by the browser entry subclass
+* The live-DOM `tableToSlides()` is NOT here; it is added by the browser entry subclass
 * (`browser.ts`) so it stays out of the Node build and out of the core chunk.
 */
 var PresentationCore = class {
@@ -3017,7 +3071,7 @@ var PresentationCore = class {
 		return this._layout;
 	}
 	/**
-	* ts-pptx Library Version
+	* pptx-ts Library Version
 	*/
 	_version = VERSION;
 	get version() {
@@ -3124,7 +3178,7 @@ var PresentationCore = class {
 	/**
 	* slide layout definition objects, used for generating slide layout files.
 	* `protected` (not `private`) so the browser entry subclass can resolve
-	* `tableToSlides({ masterTitle })` against them — that method lives on the
+	* `tableToSlides({ masterTitle })` against them. That method lives on the
 	* browser build only (it reads a live DOM), see `browser.ts`.
 	*/
 	_slideLayouts;
@@ -3153,7 +3207,7 @@ var PresentationCore = class {
 	LAYOUTS;
 	/**
 	* The built-in default layout, or a throw. `LAYOUTS` is a string-keyed map, so the lookup is
-	* typed as possibly-missing at every call site even though the constructor registers it — and
+	* typed as possibly-missing at every call site even though the constructor registers it, and
 	* the two callers that need it were spelling the same guard and the same message.
 	*/
 	#requireDefaultLayout() {
@@ -3191,11 +3245,11 @@ var PresentationCore = class {
 			LAYOUT_16x10: standardLayoutToPresLayout(STANDARD_LAYOUTS.LAYOUT_16x10),
 			LAYOUT_WIDE: standardLayoutToPresLayout(STANDARD_LAYOUTS.LAYOUT_WIDE)
 		};
-		this._author = "ts-pptx";
-		this._company = "ts-pptx";
+		this._author = "pptx-ts";
+		this._company = "pptx-ts";
 		this._revision = "1";
-		this._subject = "ts-pptx Presentation";
-		this._title = "ts-pptx Presentation";
+		this._subject = "pptx-ts Presentation";
+		this._title = "pptx-ts Presentation";
 		const defLayout = this.#requireDefaultLayout();
 		this._presLayout = {
 			name: defLayout.name,
@@ -3255,7 +3309,7 @@ var PresentationCore = class {
 	*/
 	getSections = () => this._sections;
 	/**
-	* Enables the `Slide` class to set ts-pptx [Presentation] master/layout slidenumbers
+	* Enables the `Slide` class to set pptx-ts [Presentation] master/layout slidenumbers
 	* @param {SlideNumberProps} slideNum - slide number config
 	*/
 	setSlideNumber = (slideNum) => {
@@ -3281,14 +3335,14 @@ var PresentationCore = class {
 	* Author + serialize this presentation's slides as injectable descriptors,
 	* WITHOUT producing a `.pptx` package. Runs the same media-encode, placeholder
 	* backfill, and measured-fit passes `write()` uses, then serializes each slide
-	* body and resolves its image media to decoded bytes — so a loaded deck can
+	* body and resolves its image media to decoded bytes, so a loaded deck can
 	* splice the slides in via `Presentation.appendSlides()` (see `pptx-ts/read`)
 	* while keeping its own masters/layouts/theme byte-identical.
 	*
 	* Returns the deck's slide size (EMU, for the destination size check) and one
 	* descriptor per authored slide. Charts, audio/video media, online media, and
 	* internal slide-to-slide hyperlinks are surfaced as descriptors alongside the
-	* serialized body — this method does not resolve them into a package; the append
+	* serialized body. This method does not resolve them into a package; the append
 	* path consumes each descriptor to reserve the parts and rebuild the rel graph.
 	*/
 	extractSlides = async (opts = {}) => extractSlides({
@@ -3391,11 +3445,11 @@ var PresentationCore = class {
 	}
 	/**
 	* Measure how tall text wraps at a given width, using the **same** calibrated wrap
-	* model the export-time autofit bake uses — so a layout-time prediction matches the
+	* model the export-time autofit bake uses, so a layout-time prediction matches the
 	* value `fit:'shrink'`/`'resize'` would bake. Synchronous: register the face's metrics
-	* first with {@link TsPptx.registerFontMetrics} (lookup is sync).
+	* first with {@link PptxTs.registerFontMetrics} (lookup is sync).
 	*
-	* Lets a consumer size its own geometry before export — grow a card to fit its text,
+	* Lets a consumer size its own geometry before export: grow a card to fit its text,
 	* reflow a grid, or detect overflow at layout time. Heights err **tall** (conservative),
 	* so the returned height is ≥ what PowerPoint/LibreOffice render.
 	* @param {string | TextProps[]} text - a string or run array (per-run options override the defaults in `opts`)
@@ -3410,7 +3464,7 @@ var PresentationCore = class {
 	/**
 	* Convenience overflow check: `true` if `text` does not fit a box of inner size
 	* `wIn`×`hIn` (inches) at full size. Because the model errs tall, this is a
-	* **conservative** (slightly over-reporting) check — appropriate for a build-time
+	* **conservative** (slightly over-reporting) check, appropriate for a build-time
 	* warning, not a hard gate. An unmeasurable (unnamed theme-default) face reports
 	* `false` (no overflow) so the linter does not false-positive on faces it cannot measure.
 	* @param {string | TextProps[]} text - a string or run array
@@ -3422,13 +3476,13 @@ var PresentationCore = class {
 	}
 	/**
 	* Compute the per-cell geometry of a table laid out at `opts.x`/`y`/`w`, without
-	* adding it to a slide — so a consumer can place images or shapes precisely over
+	* adding it to a slide, so a consumer can place images or shapes precisely over
 	* cells. Column widths (cell `x`/`w`) are exact, derived from the same logic the
 	* writer uses. Row heights (`y`/`h`) are exact when pinned by `rowH` (array or
 	* scalar) or table `h`; an auto-height row is estimated with the same conservative
-	* (tall) text model as {@link TsPptx.measureText} and flagged `heightExact:false`
-	* (register the cell font via {@link TsPptx.registerFontMetrics} for an exact
-	* estimate). Geometry is for a single, un-paginated table — `autoPage` paging is
+	* (tall) text model as {@link PptxTs.measureText} and flagged `heightExact:false`
+	* (register the cell font via {@link PptxTs.registerFontMetrics} for an exact
+	* estimate). Geometry is for a single, un-paginated table; `autoPage` paging is
 	* not modeled.
 	* @param {TableRow[]} rows - the same `rows` passed to `slide.addTable`
 	* @param {TableProps} opts - the same table options (`x`, `y`, `w`, `colW`, `rowH`, `h`, …)
@@ -3458,7 +3512,9 @@ var PresentationCore = class {
 	/**
 	* Export the current Presentation as ZIP content with the selected type
 	* @param {WriteProps} props output properties
-	* @returns {Promise<string | ArrayBuffer | Blob | Uint8Array>} file content in selected type
+	* @returns file content in the selected type: a `Blob` when `outputType` is left out, else
+	* the {@link WriteOutputMap} entry for it
+	* @example const bytes = await pptx.write({ outputType: 'uint8array' }) // Uint8Array, no cast
 	*/
 	async write(props) {
 		return await writePackage(this.packageSource(), pickDefined(props ?? {}, [
@@ -3468,7 +3524,7 @@ var PresentationCore = class {
 		]));
 	}
 	/**
-	* Assemble the current Presentation into its OOXML package parts WITHOUT zipping — the raw
+	* Assemble the current Presentation into its OOXML package parts WITHOUT zipping: the raw
 	* `path → bytes` contents `write()` would compress into the `.pptx`. Use this to stream parts
 	* into a custom container, inspect individual parts, or feed a pipeline that does its own
 	* archiving. To produce a real `.pptx` file, use {@link write} / {@link writeFile} instead.
@@ -3647,10 +3703,9 @@ var PresentationCore = class {
 		if (newLayout._slideNumberProps && !this._masterSlide._slideNumberProps) this._masterSlide._slideNumberProps = newLayout._slideNumberProps;
 	}
 };
-//#endregion
-//#region src/families/core.ts
+// src/families/core.ts
 /**
-* ts-pptx: the construct families every presentation carries
+* pptx-ts: the construct families every presentation carries
 *
 * The core tier. A composed presentation gets these whether it asks for them or not, so
 * `createPresentation()` with no families still authors text, shapes, images, groups and speaker
@@ -3669,10 +3724,9 @@ const CORE_CONSTRUCT_FAMILIES = [
 	groupFamily,
 	notesFamily
 ];
-//#endregion
-//#region src/entry-compose.ts
+// src/entry-compose.ts
 /**
-* ts-pptx: composing a presentation from the construct families it actually needs
+* pptx-ts: composing a presentation from the construct families it actually needs
 *
 * The body behind each entry's `createPresentation`, and the types that describe what comes back.
 * It lives beside `entry-surface.ts` for the same reason that does: `index.ts`, `node.ts` and
@@ -3683,7 +3737,7 @@ const CORE_CONSTRUCT_FAMILIES = [
 * three-condition treatment `.` gets, so three more source entries, three more `dist` files, three
 * more budget rows and a second place for the entries to diverge -- and it would buy nothing that
 * export-level shaking does not already give. `pptx-ts` is an intermediate module in a consumer's
-* graph: a program that imports only `createPresentation` drops the `TsPptx` class beside it and,
+* graph: a program that imports only `createPresentation` drops the `PptxTs` class beside it and,
 * with it, every family that class names.
 */
 /**
@@ -3697,13 +3751,12 @@ const CORE_CONSTRUCT_FAMILIES = [
 function composePresentation(runtime, opts) {
 	return new PresentationCore(runtime, [...CORE_CONSTRUCT_FAMILIES, ...opts?.use ?? []]);
 }
-//#endregion
-//#region src/entry-families.ts
+// src/entry-families.ts
 /**
-* ts-pptx: the construct families the three main entries are composed with
+* pptx-ts: the construct families the three main entries are composed with
 *
 * The full authoring surface, as a list: `index.ts`, `node.ts` and `browser.ts` each compose every
-* family, so `TsPptx` authors everything it ever has; the browser entry adds the table family's
+* family, so `PptxTs` authors everything it ever has; the browser entry adds the table family's
 * live-DOM half on top, because that one needs a `document` to read. The families a *composed*
 * presentation gets without asking are the shorter list in `families/core.ts`.
 *
@@ -3737,14 +3790,13 @@ const ALL_CONSTRUCT_FAMILIES = /* @__PURE__ */ Object.freeze([
 	tableFamily,
 	zoomFamily
 ]);
-//#endregion
-//#region src/runtime/fetch-media.ts
+// src/runtime/fetch-media.ts
 /**
 * The parts of a runtime adapter that are not runtime-specific.
 *
 * `fetch`, `btoa` and `TextEncoder` exist in Node, in every browser, and in the edge/worker
 * runtimes the neutral adapter serves, so the remote-load paths were the same code in all three
-* adapters — byte-identical in two of them and an inline branch in the third. What is genuinely
+* adapters: byte-identical in two of them and an inline branch in the third. What is genuinely
 * per-runtime stays in each adapter: `node:fs`, `FileReader`, the canvas rasterizer, the
 * `<a download>` writer.
 *
@@ -3753,13 +3805,13 @@ const ALL_CONSTRUCT_FAMILIES = /* @__PURE__ */ Object.freeze([
 /**
 * Whether `source` names something to `fetch` rather than something to read from a filesystem.
 *
-* A real scheme test, not `source.startsWith('http')`. That prefix matched a *relative path* —
-* `httpdocs/logo.png`, `http-icons/x.svg` — and sent it to `fetch`, which then failed with a
+* A real scheme test, not `source.startsWith('http')`. That prefix matched a *relative path*
+* (`httpdocs/logo.png`, `http-icons/x.svg`) and sent it to `fetch`, which then failed with a
 * fetch error naming a file that exists on disk. It was also case-sensitive, so
 * `HTTPS://example.com/f.ttf` missed and went to `fs.readFile`.
 *
 * Only `http:` and `https:` count. A `file:` or `data:` URL falls through to the adapter's
-* local branch, where it fails — the same as before this was tightened, and deliberately left
+* local branch, where it fails, the same as before this was tightened, and deliberately left
 * that way: making either work is a feature with its own decisions (what a `file:` URL means
 * off Node, whether a `data:` URL should bypass loading entirely), not a side effect of fixing
 * a prefix test.
@@ -3775,7 +3827,7 @@ async function fetchFontBytes(source) {
 	return new Uint8Array(await response.arrayBuffer());
 }
 /**
-* Fetch a media file as raw base64 (no `data:` prefix) — see {@link RuntimeAdapter.loadMedia}
+* Fetch a media file as raw base64 (no `data:` prefix). See {@link RuntimeAdapter.loadMedia}
 * for why both encodings are accepted.
 *
 * Encodes through `bytesToBase64` rather than `Buffer`, so the same function serves a runtime
@@ -3800,16 +3852,15 @@ async function placeholderSvgPreview(rel) {
 	rel.data = IMG_SVG_PLACEHOLDER;
 	return null;
 }
-//#endregion
-//#region src/clip.ts
+// src/clip.ts
 /**
-* ts-pptx: named clip silhouettes for images
+* pptx-ts: named clip silhouettes for images
 *
-* A `ClipShape` is declarative data — a named silhouette plus its options — and {@link clipPath}
+* A `ClipShape` is declarative data (a named silhouette plus its options), and {@link clipPath}
 * resolves it to the freeform `points` path `addImage` emits as the `<a:custGeom>` clip mask on
 * the `<p:pic>`. Paired with `sizing: { type: 'cover' }` (an `<a:srcRect>` crop) it reproduces
-* what a PowerPoint *picture placeholder* does — a layout `custGeom` clipping an inherited
-* blipFill — but standalone, with no placeholder involved.
+* what a PowerPoint *picture placeholder* does (a layout `custGeom` clipping an inherited
+* blipFill), but standalone, with no placeholder involved.
 *
 * These are silhouettes recurring often enough in real decks to be worth naming; hand-authored
 * `points` remain available for anything else. Nothing here is theme- or brand-aware: which
@@ -3939,7 +3990,7 @@ function halfDisc(w, h, flat, preset) {
 * to `addImage({ points })`.
 *
 * `w`/`h` are the image box's size **in inches** and must match the `w`/`h` the picture is drawn
-* at — the path is emitted in the box's own coordinate space, not normalized (see the module
+* at, because the path is emitted in the box's own coordinate space, not normalized (see the module
 * note above).
 * @param {ClipShape} shape - the named silhouette and its options
 * @param {number} w - image box width (inches)
@@ -3961,8 +4012,7 @@ function clipPath(shape, w, h) {
 		case "half-disc": return halfDisc(w, h, checkEnumOrThrow(shape.flat, FLAT_SIDES, "clipPath `flat`", "clip/invalid-shape"), checkEnumOrThrow(shape.preset ?? "deep", HALF_DISC_PRESETS, "clipPath `preset`", "clip/invalid-shape"));
 	}
 }
-//#endregion
-//#region src/types/text.ts
+// src/types/text.ts
 /** Factory for a single inline text run. Prevents `as never` casts when building mixed-style run arrays. */
 function textRun(text, options) {
 	return options !== void 0 ? {
@@ -3974,7 +4024,6 @@ function textRun(text, options) {
 function textRuns(runs) {
 	return runs;
 }
-//#endregion
 export { fetchMediaBase64 as a, ALL_CONSTRUCT_FAMILIES as c, IMG_SVG_PLACEHOLDER as d, fetchFontBytes as i, composePresentation as l, textRuns as n, isRemote as o, clipPath as r, placeholderSvgPreview as s, textRun as t, PresentationCore as u };
 
-//# sourceMappingURL=text-sN64Otf_.js.map
+//# sourceMappingURL=text-CU08xJGs.js.map