@shbernal/ts-pptx 3.2.0 → 3.4.0

package/dist/{presentation-CxnUVhK9.js → presentation-3rAKKRfm.js}

@@ -1,9 +1,9 @@
 import { i as PackageReadError, n as InvalidOptionError, o as UnsupportedFeatureError, t as InternalError } from "./errors-Bvln0H-7.js";
-import { d as emuToInches } from "./units-C7QM1KgH.js";
-import { _ as SLIDE_LAYOUT_REL, b as THEME_REL, d as IMAGE_REL, f as NOTES_MASTER_REL, m as OFFICE_DOCUMENT_REL, p as NOTES_SLIDE_REL, v as SLIDE_MASTER_REL, y as SLIDE_REL } from "./st-enums-evQG2A7Z.js";
-import { i as FONT_REL_TYPE, n as FONT_DATA_CONTENT_TYPE, r as FONT_DATA_EXTENSION, t as EMBEDDED_FONT_SLOTS } from "./embedded-fonts-MaynAHa9.js";
+import { mt as emuToInches } from "./units-internal-DNvK2I6o.js";
+import { D as voidEl, E as raw, T as el, g as FONT_REL_TYPE, h as FONT_DATA_EXTENSION, m as FONT_DATA_CONTENT_TYPE, n as makeXmlNotesMaster, o as makeXmlNotesSlideSkeleton, p as EMBEDDED_FONT_SLOTS } from "./notes-bWApshah.js";
+import { _ as THEME_REL, a as NOTES_MASTER_REL, c as OFFICE_DOCUMENT_REL, d as SLIDE_LAYOUT_CONTENT_TYPE, f as SLIDE_LAYOUT_REL, g as THEME_CONTENT_TYPE, h as SLIDE_REL, i as NOTES_MASTER_CONTENT_TYPE, l as OFFICE_REL, m as SLIDE_MASTER_REL, o as NOTES_SLIDE_CONTENT_TYPE, p as SLIDE_MASTER_CONTENT_TYPE, r as IMAGE_REL, s as NOTES_SLIDE_REL, t as OOXML_NS } from "./namespaces-Sy_m7Nhd.js";
 import { ZipWriter, readZip } from "./zip.js";
-import { $ as parseClrScheme, A as readGradientFill, At as getElements, B as placeholderInheritedAnchor, Bt as setAttr, Ct as boolValue, D as spPrXfrmEmu, Dt as escapeXmlAttribute, E as TextFrame, Et as descendantsByTag, F as resolveSlideColorContext, Ft as parseXml, G as placeholderOf, H as placeholderInheritedListStyles, I as resolveSlideThemeParts, It as removeAttr, J as SCHEME_SLOTS, K as slideDefinesColor, Lt as removeChildrenByQName, M as resolveLayoutColorContext, Mt as insertInOrder, N as resolveMasterColorContext, Nt as intValue, O as readPatternFill, Ot as firstChild, P as resolveNotesColorContext, Pt as ownerDocumentOf, Q as parseClrMap, R as LST_STYLE_LEVELS, Rt as replaceInParent, S as AutoShape, St as attr, Tt as createElement, U as placeholderInheritedRunProps, V as placeholderInheritedColor, W as placeholderInheritedXfrm, X as intAttr, Y as fmtEntry, Z as isA, _t as relsPartNameFor, at as FILL_CHOICES, bt as zipPathToPartName, ct as SPPR_AFTER_XFRM, dt as SPPR_LN_AFTER, et as resolveColor, ft as SPPR_SCENE3D_AFTER, gt as relativePartName, ht as partNameToZipPath, it as substitutePhClr, j as resolveColorElement, jt as getOrAddChild, k as readPictureFill, kt as firstChildElement, l as wrapShapeElement, lt as SPPR_EFFECT_AFTER, mt as partNameExtension, n as buildShapes, nt as styleRefFill, ot as RPR_FILL_AFTER, pt as SPPR_SP3D_AFTER, q as slideDefinesProp, r as findShapeByIdDeep, rt as styleRefLine, st as SHAPE_AFTER_SPPR, t as GroupShape, tt as resolveSchemeToken, u as GraphicFrame, ut as SPPR_FILL_AFTER, vt as resolveRelativePartName, wt as childElements, x as Picture, xt as OOXML_NS, yt as resolveSingleRel, z as RUN_PROP_NAMES, zt as serializeXml } from "./shapes-DoJBPrwN.js";
+import { $ as collectElements, A as readPatternFill, At as zipPathToPartName, B as LST_STYLE_LEVELS, Bt as getOrAddChild, C as Picture, Ct as SPPR_SP3D_AFTER, Dt as relsPartNameFor, Et as relativePartName, F as resolveMasterColorContext, Ft as descendantsByTag, G as placeholderInheritedRunProps, Gt as removeAttr, H as placeholderInheritedAnchor, Ht as intValue, I as resolveNotesColorContext, It as escapeXmlAttribute, J as slideDefinesColor, Jt as serializeXml, K as placeholderInheritedXfrm, Kt as removeChildrenByQName, L as resolveSlideColorContext, Lt as firstChild, M as readGradientFill, Mt as boolValue, N as resolveColorElement, Nt as childElements, O as TextFrame, Ot as resolveRelativePartName, P as resolveLayoutColorContext, Pt as createElement, Q as carriedDecorations, R as resolveSlideThemeParts, Rt as firstChildElement, St as SPPR_SCENE3D_AFTER, Tt as partNameToZipPath, U as placeholderInheritedColor, Ut as ownerDocumentOf, V as RUN_PROP_NAMES, Vt as insertInOrder, W as placeholderInheritedListStyles, Wt as parseXml, X as cSldName, Y as slideDefinesProp, Yt as setAttr, Z as cSldOf, _t as SHAPE_AFTER_SPPR, at as fmtEntry, bt as SPPR_FILL_AFTER, ct as parseClrMap, dt as resolveSchemeToken, et as firstShapeChild, ft as styleRefFill, gt as RPR_FILL_AFTER, ht as FILL_CHOICES, it as SCHEME_SLOTS, j as readPictureFill, jt as attr, k as spPrXfrmEmu, kt as resolveSingleRel, l as wrapShapeElement, lt as parseClrScheme, mt as substitutePhClr, n as buildShapes, nt as nvPrOf, ot as intAttr, pt as styleRefLine, q as placeholderOf, qt as replaceInParent, r as findShapeByIdDeep, rt as spTreeOf, st as isA, t as GroupShape, tt as nthShapeChild, u as GraphicFrame, ut as resolveColor, vt as SPPR_AFTER_XFRM, w as AutoShape, wt as partNameExtension, xt as SPPR_LN_AFTER, yt as SPPR_EFFECT_AFTER, zt as getElements } from "./shapes-Dyw5bxwO.js";
 //#region src/read/opc/content-types.ts
 /**
 * Overlay over `[Content_Types].xml`, used to resolve part content types at
@@ -78,7 +78,7 @@ var ContentTypes = class ContentTypes {
 //#endregion
 //#region src/read/opc/part.ts
 const textDecoder$1 = new TextDecoder("utf-8");
-const textEncoder$4 = new TextEncoder();
+const textEncoder$5 = new TextEncoder();
 const XML_DECLARATION_RE = /^\uFEFF?<\?xml[^>]*\?>\s*/;
 /**
 * One OPC part. Holds the original bytes from the zip for its whole life;
@@ -135,7 +135,7 @@ var Part = class {
 		if (!this.#dirty) return this.#bytes;
 		let xml = serializeXml(this.dom);
 		if (!xml.startsWith("<?xml")) xml = (XML_DECLARATION_RE.exec(textDecoder$1.decode(this.#bytes))?.[0] ?? "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\r\n") + xml;
-		return textEncoder$4.encode(xml);
+		return textEncoder$5.encode(xml);
 	}
 };
 //#endregion
@@ -275,7 +275,7 @@ var Relationships = class Relationships {
 const CONTENT_TYPES_ZIP_PATH = "[Content_Types].xml";
 const RELATIONSHIPS_CONTENT_TYPE = "application/vnd.openxmlformats-package.relationships+xml";
 const textDecoder = new TextDecoder("utf-8");
-const textEncoder$3 = new TextEncoder();
+const textEncoder$4 = new TextEncoder();
 /**
 * An OPC package loaded from `.pptx` bytes.
 *
@@ -415,7 +415,7 @@ var OpcPackage = class OpcPackage {
 		for (const relationships of this.#relationshipsCache.values()) {
 			if (!relationships.isDirty) continue;
 			const relsPartName = relsPartNameFor(relationships.sourcePartName);
-			const bytes = textEncoder$3.encode(relationships.serialize());
+			const bytes = textEncoder$4.encode(relationships.serialize());
 			this.#parts.set(relsPartName, new Part(relsPartName, RELATIONSHIPS_CONTENT_TYPE, bytes));
 		}
 	}
@@ -594,7 +594,7 @@ function reverseClrMap(clrMap) {
 function applyInheritedBackground(slideRoot, ctx) {
 	const inherited = ctx.inheritedBackground;
 	if (!inherited) return;
-	const cSld = firstChild(slideRoot, "p:cSld");
+	const cSld = cSldOf(slideRoot);
 	if (!cSld || firstChild(cSld, "p:bg")) return;
 	const bg = ownerDocumentOf(slideRoot).importNode(inherited, true);
 	insertInOrder(cSld, bg, [
@@ -644,6 +644,28 @@ function resolveSchemeColors(root, ctx) {
 * re-bind to the destination styles.
 */
 function resolvePlaceholderRunColors(slideRoot, ctx) {
+	bakePlaceholderRunProperty(slideRoot, ctx, placeholderInheritedColor, (run, color, pPr, slideLst, level) => {
+		if (slideDefinesColor(run, pPr, slideLst, level)) return;
+		writeRunColor(run, color);
+	});
+}
+/**
+* The traversal both run-property passes share: every placeholder shape's text body, every
+* paragraph in it, every `a:r` and `a:fld` in that paragraph.
+*
+* `resolve` is asked once per *list level* per shape and memoized, because walking the
+* layout/master style chain is the expensive half and every paragraph at the same level gets
+* the same answer. `write` then runs per run, and owns the decision to skip a run the slide
+* already fixes — the two passes ask that question differently (one colour check versus three
+* independent property checks), so it stays on their side of the boundary rather than becoming
+* a predicate parameter only one caller could use.
+*
+* @param slideRoot - the slide part's root element
+* @param ctx - the flatten context, carrying the source layout/master roots
+* @param resolve - the inherited value for a placeholder type/idx at a list level, or `null`
+* @param write - apply a resolved value to one run
+*/
+function bakePlaceholderRunProperty(slideRoot, ctx, resolve, write) {
 	if (!ctx.layoutRoot && !ctx.masterRoot) return;
 	for (const sp of descendantsByTag(slideRoot, OOXML_NS.p, "sp")) {
 		const ph = placeholderOf(sp);
@@ -659,16 +681,13 @@ function resolvePlaceholderRunColors(slideRoot, ctx) {
 			const level = (pPr && intValue(attr(pPr, "lvl"))) ?? 0;
 			const runs = [...getElements(p, "a:r"), ...getElements(p, "a:fld")];
 			if (runs.length === 0) continue;
-			let color = byLevel.get(level);
-			if (color === void 0) {
-				color = placeholderInheritedColor(type, idx, level, ctx);
-				byLevel.set(level, color);
-			}
-			if (!color) continue;
-			for (const run of runs) {
-				if (slideDefinesColor(run, pPr, slideLst, level)) continue;
-				writeRunColor(run, color);
+			let value = byLevel.get(level);
+			if (value === void 0) {
+				value = resolve(type, idx, level, ctx);
+				byLevel.set(level, value);
 			}
+			if (!value) continue;
+			for (const run of runs) write(run, value, pPr, slideLst, level);
 		}
 	}
 }
@@ -788,8 +807,7 @@ function resolvePlaceholderListStyle(shapeRoot, ctx) {
 */
 function demotePlaceholders(shapeRoot) {
 	for (const sp of descendantsByTag(shapeRoot, OOXML_NS.p, "sp")) {
-		const nvSpPr = firstChild(sp, "p:nvSpPr");
-		const nvPr = nvSpPr && firstChild(nvSpPr, "p:nvPr");
+		const nvPr = nvPrOf(sp);
 		if (nvPr) removeChildrenByQName(nvPr, ["p:ph"]);
 	}
 }
@@ -803,30 +821,7 @@ function demotePlaceholders(shapeRoot) {
 * is left to re-bind to the destination theme, as the colour pass does for the `fontRef`.
 */
 function resolvePlaceholderRunSizes(slideRoot, ctx) {
-	if (!ctx.layoutRoot && !ctx.masterRoot) return;
-	for (const sp of descendantsByTag(slideRoot, OOXML_NS.p, "sp")) {
-		const ph = placeholderOf(sp);
-		if (!ph) continue;
-		const txBody = firstChild(sp, "p:txBody");
-		if (!txBody) continue;
-		const type = attr(ph, "type");
-		const idx = attr(ph, "idx") ?? "0";
-		const slideLst = firstChild(txBody, "a:lstStyle");
-		const byLevel = /* @__PURE__ */ new Map();
-		for (const p of getElements(txBody, "a:p")) {
-			const pPr = firstChild(p, "a:pPr");
-			const level = (pPr && intValue(attr(pPr, "lvl"))) ?? 0;
-			const runs = [...getElements(p, "a:r"), ...getElements(p, "a:fld")];
-			if (runs.length === 0) continue;
-			let props = byLevel.get(level);
-			if (props === void 0) {
-				props = placeholderInheritedRunProps(type, idx, level, ctx);
-				byLevel.set(level, props);
-			}
-			if (!props) continue;
-			for (const run of runs) writeRunProps(run, props, pPr, slideLst, level);
-		}
-	}
+	bakePlaceholderRunProperty(slideRoot, ctx, placeholderInheritedRunProps, writeRunProps);
 }
 /** Write each resolved run property onto a run's `a:rPr`, skipping ones the slide already fixes. */
 function writeRunProps(run, props, pPr, slideLst, level) {
@@ -907,7 +902,7 @@ function neutralizeRef(ref) {
 */
 /** The `p:cSld/p:bg` element of a slide/layout/master root, or `null`. */
 function backgroundElementOf(root) {
-	const cSld = root && firstChild(root, "p:cSld");
+	const cSld = cSldOf(root);
 	return cSld ? firstChild(cSld, "p:bg") : null;
 }
 /**
@@ -1012,8 +1007,7 @@ var NotesPlaceholder = class {
 		this.relationships = relationships;
 	}
 	#ph() {
-		const nvSpPr = firstChild(this.sp, "p:nvSpPr");
-		const nvPr = nvSpPr && firstChild(nvSpPr, "p:nvPr");
+		const nvPr = nvPrOf(this.sp);
 		return nvPr ? firstChild(nvPr, "p:ph") : null;
 	}
 	#cNvPr() {
@@ -1147,149 +1141,854 @@ var NotesSlide = class {
 		return this.placeholders.find((ph) => ph.type === type) ?? null;
 	}
 	#spTree() {
-		const root = this.part.dom.documentElement;
-		const cSld = root && firstChild(root, "p:cSld");
-		return cSld ? firstChild(cSld, "p:spTree") : null;
+		return spTreeOf(this.part.dom.documentElement);
 	}
 };
 //#endregion
-//#region src/read/api/comments.ts
-/** The slide → comments-part relationship type (legacy comments). */
-const COMMENTS_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments";
-/** The presentation → commentAuthors-part relationship type. */
-const COMMENT_AUTHORS_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/commentAuthors";
-/** Content type of a legacy per-slide comments part (`ppt/comments/commentN.xml`). */
-const LEGACY_COMMENTS_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.presentationml.comments+xml";
-/** The slide → modern-comments-part relationship type (2018 schema). */
-const MODERN_COMMENTS_REL_TYPE = "http://schemas.microsoft.com/office/2018/10/relationships/comments";
-/** The presentation → modern-authors-part relationship type (2018 schema). */
-const MODERN_AUTHORS_REL_TYPE = "http://schemas.microsoft.com/office/2018/10/relationships/authors";
-/** Content type of the modern per-slide comments part (`ppt/comments/modernComment_*.xml`). */
-const MODERN_COMMENTS_CONTENT_TYPE = "application/vnd.ms-powerpoint.comments+xml";
-/** Parse a `p:cmAuthorLst` root element into the author registry. */
-function parseCommentAuthors(root) {
-	if (!root) return [];
-	return getElements(root, "p:cmAuthor").map((el) => ({
-		id: intValue(attr(el, "id")),
-		name: attr(el, "name") ?? "",
-		initials: attr(el, "initials") ?? "",
-		lastIdx: intValue(attr(el, "lastIdx")),
-		clrIdx: intValue(attr(el, "clrIdx"))
-	}));
-}
+//#region src/read/api/ops/deck-target.ts
 /**
-* Read the deck-wide comment authors from `ppt/commentAuthors.xml`, resolved via the
-* presentation part's `commentAuthors` relationship. `[]` when the deck has no comments.
+* `ppt/_rels/presentation.xml.rels` -- the deck's own relationship part.
+*
+* Every part that masters, layouts, the notes master and embedded fonts hang off
+* is reached through here, so the two-step `dest.presentationPart` ->
+* `dest.opc.relationshipsFor(part.partName)` was written out at every one of
+* those wiring sites. Naming it once means a call site says which rels it wants
+* rather than how to find them.
+* @param {DeckTarget} dest - the destination deck
+* @returns {Relationships} the presentation part's relationships
 */
-function readCommentAuthors(opc, presentationPartName) {
-	const rels = opc.relationshipsFor(presentationPartName);
-	const rel = rels.byType(COMMENT_AUTHORS_REL_TYPE)[0];
-	if (!rel) return [];
-	return parseCommentAuthors(opc.part(rels.resolveTarget(rel.id))?.dom.documentElement ?? null);
+function presentationRels(dest) {
+	return dest.opc.relationshipsFor(dest.presentationPart.partName);
 }
+//#endregion
+//#region src/read/api/ops/master-registry.ts
 /**
-* Read one slide's legacy comments from its `comments/commentN.xml` part (resolved
-* via the slide's `comments` relationship), resolving each comment's `@authorId`
-* against `authors` (typically {@link readCommentAuthors}). `[]` when the slide has
-* no comments part.
+* Slide-master bookkeeping in `presentation.xml` and in a master's own
+* `p:sldLayoutIdLst`: registering a master so renderers treat it as active,
+* promoting masters to the front of the id list, allocating ids out of the shared
+* master/layout id space, and emptying a freshly-copied master's layout list.
+*
+* These are the destination-side half of the import machinery -- they read and
+* write only this deck, never a source package and never the copy registry -- so
+* they take a structural {@link DeckTarget} rather than a `Presentation`. The
+* source-side half that drives most of them is `part-copy.ts`.
 */
-function readSlideComments(opc, slidePart, authors) {
-	const rels = opc.relationshipsFor(slidePart.partName);
-	const rel = rels.byType(COMMENTS_REL_TYPE)[0];
-	if (!rel) return [];
-	const root = opc.part(rels.resolveTarget(rel.id))?.dom.documentElement;
-	if (!root) return [];
-	const byId = new Map(authors.map((a) => [a.id, a]));
-	return getElements(root, "p:cm").map((cm) => {
-		const authorId = intValue(attr(cm, "authorId"));
-		const author = authorId !== null ? byId.get(authorId) ?? null : null;
-		const pos = firstChild(cm, "p:pos");
-		const textEl = firstChild(cm, "p:text");
-		return {
-			author: author ? author.name : null,
-			authorInitials: author ? author.initials : null,
-			authorId,
-			idx: intValue(attr(cm, "idx")),
-			text: textEl?.textContent ?? "",
-			x: pos ? intValue(attr(pos, "x")) : null,
-			y: pos ? intValue(attr(pos, "y")) : null,
-			date: attr(cm, "dt") ?? null
-		};
-	});
-}
-/** Concatenate a `p188:txBody`'s paragraphs into plain text, joining paragraphs with `\n`. */
-function modernCommentText(el) {
-	const txBody = firstChild(el, "p188:txBody");
-	if (!txBody) return "";
-	const paras = getElements(txBody, "a:p");
-	if (paras.length === 0) return txBody.textContent ?? "";
-	return paras.map((p) => p.textContent ?? "").join("\n");
-}
 /**
-* Decode one `p188:cm` (or `p188:reply`) element. Only the top-level comment
-* carries a position and a reply list; replies pass `withThread: false` so they
-* report `x`/`y` as `null` and never recurse (the schema forbids nested replies).
+* Wire a freshly-copied slide master into `presentation.xml`: add a
+* presentation→master relationship and a `p:sldMasterId` entry in
+* `p:sldMasterIdLst`. A master that is reachable only through the
+* slide→layout→master rel chain but absent from `p:sldMasterIdLst` is treated
+* as inactive by renderers, so its background/graphics never paint. No-op when
+* the master is already registered (shared across imports from one source).
 */
-function parseModernComment(el, byId, withThread) {
-	const authorId = attr(el, "authorId");
-	const author = authorId !== null ? byId.get(authorId) ?? null : null;
-	const pos = withThread ? firstChild(el, "p188:pos") : null;
-	const replyLst = withThread ? firstChild(el, "p188:replyLst") : null;
-	return {
-		id: attr(el, "id"),
-		author: author ? author.name : null,
-		authorInitials: author ? author.initials : null,
-		authorId,
-		created: attr(el, "created"),
-		text: modernCommentText(el),
-		x: pos ? intValue(attr(pos, "x")) : null,
-		y: pos ? intValue(attr(pos, "y")) : null,
-		replies: replyLst ? getElements(replyLst, "p188:reply").map((r) => parseModernComment(r, byId, false)) : []
-	};
+function registerMaster(dest, masterPartName) {
+	const presPart = dest.presentationPart;
+	const presRels = presentationRels(dest);
+	for (const rel of presRels.byType(SLIDE_MASTER_REL)) if (presRels.resolveTarget(rel.id) === masterPartName) return;
+	const relId = presRels.add(SLIDE_MASTER_REL, relativePartName(presPart.partName, masterPartName)).id;
+	const root = presPart.dom.documentElement;
+	if (!root) throw new PackageReadError("package/part-has-no-root", "presentation.xml has no document element to register a master in");
+	const lst = getOrAddChild(root, "p:sldMasterIdLst", [
+		"p:notesMasterIdLst",
+		"p:handoutMasterIdLst",
+		"p:sldIdLst",
+		"p:sldSz",
+		"p:notesSz",
+		"p:embeddedFontLst",
+		"p:custShowLst",
+		"p:photoAlbum",
+		"p:custDataLst",
+		"p:kinsoku",
+		"p:defaultTextStyle",
+		"p:modifyVerifier",
+		"p:extLst"
+	]);
+	const entry = createElement(presPart.dom, "p:sldMasterId");
+	setAttr(entry, "id", String(nextMasterLayoutId(dest)));
+	setAttr(entry, "r:id", relId);
+	lst.appendChild(entry);
+	presPart.markDirty();
 }
 /**
-* Read the deck-wide modern comment authors from `ppt/authors.xml`, resolved via
-* the presentation part's 2018 `authors` relationship. `[]` when the deck has no
-* modern authors part.
+* Move the `p:sldMasterId` entries for `masterPartNames` to the front of
+* `p:sldMasterIdLst`, preserving their existing relative order, so the first of
+* them becomes the deck's `Designs(1)` — the theme PowerPoint's Design tab shows.
+* Reorders the id list only; relationships, ids, and all other parts are left as
+* they are. A no-op when the named masters already lead (idempotent re-call).
 */
-function readModernCommentAuthors(opc, presentationPartName) {
-	const rels = opc.relationshipsFor(presentationPartName);
-	const rel = rels.byType(MODERN_AUTHORS_REL_TYPE)[0];
-	if (!rel) return [];
-	const root = opc.part(rels.resolveTarget(rel.id))?.dom.documentElement;
-	if (!root) return [];
-	return getElements(root, "p188:author").map((el) => ({
-		id: attr(el, "id"),
-		name: attr(el, "name") ?? "",
-		initials: attr(el, "initials") ?? "",
-		userId: attr(el, "userId"),
-		providerId: attr(el, "providerId")
-	}));
+function promoteMasters(dest, masterPartNames) {
+	if (masterPartNames.length === 0) return;
+	const presPart = dest.presentationPart;
+	const root = presPart.dom.documentElement;
+	const lst = root && firstChild(root, "p:sldMasterIdLst");
+	if (!lst) return;
+	const rels = presentationRels(dest);
+	const promote = new Set(masterPartNames);
+	const entries = getElements(lst, "p:sldMasterId");
+	const isPromoted = (entry) => {
+		const relId = attr(entry, "r:id");
+		return relId ? promote.has(rels.resolveTarget(relId)) : false;
+	};
+	const desired = [...entries.filter(isPromoted), ...entries.filter((e) => !isPromoted(e))];
+	if (desired.every((entry, i) => entry === entries[i])) return;
+	for (const entry of desired) lst.appendChild(entry);
+	presPart.markDirty();
 }
 /**
-* Read one slide's modern comments from its `modernComment_*.xml` part (resolved
-* via the slide's 2018 `comments` relationship), resolving each comment's and
-* reply's `@authorId` GUID against `authors` (typically
-* {@link readModernCommentAuthors}). Replies are nested, not flattened. `[]` when
-* the slide has no modern comments part.
+* The next free id in the presentation-wide slide-master / slide-layout id space.
+*
+* `p:sldMasterId/@id` and every master's `p:sldLayoutId/@id` draw from ONE shared
+* id space (both ST_SlideMasterId/ST_SlideLayoutId, floor 2147483648) and must be
+* unique across the WHOLE presentation, not just within their own list. A duplicate
+* anywhere in this space makes PowerPoint report the file as corrupt on open
+* ("found a problem with content" / 0x80070570), even though LibreOffice silently
+* tolerates it — so an imported master AND each of its layouts must take an id past
+* the max of both the master-id list and every layout-id list. Recomputed per
+* allocation so ids appended earlier in the same import are counted.
 */
-function readModernSlideComments(opc, slidePart, authors) {
-	const rels = opc.relationshipsFor(slidePart.partName);
-	const rel = rels.byType(MODERN_COMMENTS_REL_TYPE)[0];
-	if (!rel) return [];
-	const root = opc.part(rels.resolveTarget(rel.id))?.dom.documentElement;
-	if (!root) return [];
-	const byId = new Map(authors.map((a) => [a.id, a]));
-	return getElements(root, "p188:cm").map((cm) => parseModernComment(cm, byId, true));
+function nextMasterLayoutId(dest) {
+	let max = 2147483647;
+	const root = dest.presentationPart.dom.documentElement;
+	const masterLst = root && firstChild(root, "p:sldMasterIdLst");
+	if (masterLst) for (const entry of getElements(masterLst, "p:sldMasterId")) {
+		const id = intValue(attr(entry, "id"));
+		if (id !== null && id > max) max = id;
+	}
+	const presRels = presentationRels(dest);
+	for (const rel of presRels.byType(SLIDE_MASTER_REL)) {
+		const masterRoot = dest.opc.part(presRels.resolveTarget(rel.id))?.dom.documentElement;
+		const layoutLst = masterRoot && firstChild(masterRoot, "p:sldLayoutIdLst");
+		if (!layoutLst) continue;
+		for (const entry of getElements(layoutLst, "p:sldLayoutId")) {
+			const id = intValue(attr(entry, "id"));
+			if (id !== null && id > max) max = id;
+		}
+	}
+	return max + 1;
+}
+/** Empty a freshly-copied master's `p:sldLayoutIdLst`; copied layouts repopulate it. */
+function clearLayoutIdList(dest, masterPartName) {
+	const masterPart = dest.opc.part(masterPartName);
+	const root = masterPart?.dom.documentElement;
+	const lst = root && firstChild(root, "p:sldLayoutIdLst");
+	if (!masterPart || !lst) return;
+	removeChildrenByQName(lst, ["p:sldLayoutId"]);
+	masterPart.markDirty();
 }
 /**
-* Report which comment schema a deck uses: `'modern'` when it carries any 2018
-* `modernComment_*` part, else `'legacy'` when it carries any classic
-* `commentN.xml` part, else `'none'`. Lets a consumer pick the right accessor
-* ({@link readModernSlideComments} vs {@link readSlideComments}) without probing
-* both.
+* Append a `p:sldLayoutId` entry for `layoutPartName` to `masterPartName`'s
+* `p:sldLayoutIdLst`, adding the master→layout relationship it points at. The
+* destination-side half of linking a copied layout into its copied master; the
+* caller resolves which master that is from the source-side rels.
 */
-function commentSchema(opc) {
+function addLayoutToMaster(dest, masterPartName, layoutPartName) {
+	const masterPart = dest.opc.part(masterPartName);
+	const root = masterPart?.dom.documentElement;
+	if (!masterPart || !root) return;
+	const relId = dest.opc.relationshipsFor(masterPartName).add(SLIDE_LAYOUT_REL, relativePartName(masterPartName, layoutPartName)).id;
+	const lst = getOrAddChild(root, "p:sldLayoutIdLst", [
+		"p:transition",
+		"p:timing",
+		"p:hf",
+		"p:txStyles",
+		"p:extLst"
+	]);
+	const entry = createElement(masterPart.dom, "p:sldLayoutId");
+	setAttr(entry, "id", String(nextMasterLayoutId(dest)));
+	setAttr(entry, "r:id", relId);
+	lst.appendChild(entry);
+	masterPart.markDirty();
+}
+//#endregion
+//#region src/read/api/ops/page-owned.ts
+/** Relationship types whose target two copies of one page may point at together. */
+const SHARED_BY_PAGE_COPIES = /* @__PURE__ */ new Set([
+	SLIDE_LAYOUT_REL,
+	SLIDE_MASTER_REL,
+	NOTES_MASTER_REL,
+	THEME_REL,
+	OFFICE_REL + "themeOverride",
+	OFFICE_REL + "handoutMaster",
+	OFFICE_REL + "presProps",
+	OFFICE_REL + "viewProps",
+	OFFICE_REL + "tableStyles",
+	OFFICE_REL + "commentAuthors",
+	"http://schemas.microsoft.com/office/2018/10/relationships/authors",
+	IMAGE_REL,
+	OFFICE_REL + "audio",
+	OFFICE_REL + "video",
+	"http://schemas.microsoft.com/office/2007/relationships/media",
+	"http://schemas.microsoft.com/office/2017/06/relationships/model3d",
+	OFFICE_REL + "font",
+	SLIDE_REL,
+	OFFICE_REL + "hyperlink"
+]);
+/**
+* Whether a page copy may point at this relationship's target rather than taking
+* a copy of it. Everything not listed is owned by the page and copied — see the
+* module comment for why that is the safe default.
+*/
+function isSharedByPageCopies(relType) {
+	return SHARED_BY_PAGE_COPIES.has(relType);
+}
+/**
+* Give a just-cloned page its own copy of every part the source page owned,
+* within one package. The clone's relationships start as a byte copy of the
+* source page's, so this walks them and repoints the owned ones at fresh parts;
+* shared targets are left alone.
+*
+* The subtree under each owned part is copied the same way, so a chart's workbook
+* and user-shapes drawing come along while the image inside that drawing stays
+* shared. A relationship *back* to the source page — a notes slide names the
+* slide it annotates — is repointed at the clone, which is what makes the copied
+* notes belong to it.
+*
+* A dangling relationship is left dangling rather than made to throw: cloning a
+* damaged deck is not this function's problem to discover.
+*
+* @param opc               the package both pages live in
+* @param sourcePartName    partname of the page that was cloned
+* @param clonePartName     partname of the clone, whose rels are still the source's
+*/
+function duplicateOwnedTargets(opc, sourcePartName, clonePartName) {
+	const copies = /* @__PURE__ */ new Map([[sourcePartName, clonePartName]]);
+	const rels = opc.relationshipsFor(clonePartName);
+	for (const rel of Array.from(rels)) {
+		if (rel.targetMode === "External" || isSharedByPageCopies(rel.type)) continue;
+		const target = rels.resolveTarget(rel.id);
+		const fresh = duplicateSubtree(opc, target, copies);
+		if (fresh === target) continue;
+		rels.remove(rel.id);
+		rels.addWithId(rel.id, rel.type, relativePartName(clonePartName, fresh));
+	}
+}
+/**
+* Copy `partName` and, recursively, every part it owns, into fresh partnames.
+* `copies` dedupes within the one page copy, so a part two of the page's
+* relationships reach is copied once here even though the next page copy gets its
+* own. Returns the copy's partname, or `partName` unchanged when there is no such
+* part to copy.
+*/
+function duplicateSubtree(opc, partName, copies) {
+	const already = copies.get(partName);
+	if (already !== void 0) return already;
+	const part = opc.part(partName);
+	if (!part) return partName;
+	const fresh = opc.reservePartNameLike(partName);
+	opc.addPart(fresh, part.contentType, part.bytes);
+	copies.set(partName, fresh);
+	const sourceRels = opc.relationshipsFor(partName);
+	const freshRels = opc.relationshipsFor(fresh);
+	for (const rel of sourceRels) {
+		if (rel.targetMode === "External") {
+			freshRels.addWithId(rel.id, rel.type, rel.target, "External");
+			continue;
+		}
+		const target = sourceRels.resolveTarget(rel.id);
+		const newTarget = isSharedByPageCopies(rel.type) ? copies.get(target) ?? target : duplicateSubtree(opc, target, copies);
+		freshRels.addWithId(rel.id, rel.type, relativePartName(fresh, newTarget));
+	}
+	return fresh;
+}
+//#endregion
+//#region src/read/api/ops/part-copy.ts
+/** Open an ownership scope for one page copy. */
+function newOwnedScope() {
+	return /* @__PURE__ */ new Map();
+}
+/**
+* Copy one slide page across as a part of its own, deduping everything under it
+* but never the page itself. This is the `theme: 'copy'` arm of
+* {@link Presentation.importSlide}.
+*
+* The page is the one part an import is *not* allowed to share. `copyPart`'s
+* registry idempotence is right for a theme, master, layout or image, where a
+* second copy is waste; applied to the slide it made a repeated import of the
+* same source page return the first copy's partname, and the caller then wired a
+* second `p:sldId` to a part that already had one — a package PowerPoint refuses
+* to open (0x80070570), with nothing in the read model to show for it. So the
+* page goes into the selection plan `copyPart` already honours for a batch, which
+* re-materializes exactly the named pages and leaves the dedup of their
+* dependencies alone.
+*
+* @param ctx             the open import out of the source package
+* @param sourcePartName  partname of the source slide to bring across
+* @return                partname of the new slide part in `ctx.dest`
+*/
+function copySlidePart(ctx, sourcePartName) {
+	const destinations = /* @__PURE__ */ new Map([[sourcePartName, ctx.dest.opc.reservePartNameLike(sourcePartName)]]);
+	return copyPart({
+		...ctx,
+		selection: { destinations }
+	}, sourcePartName);
+}
+/**
+* Copy `sourcePartName` (and, recursively, every internal part it references)
+* from `ctx.source` into `ctx.dest`, returning the new partname. Idempotent
+* per source package via the copy registry. Relationship ids are preserved so
+* the copied part body's `r:id`/`r:embed` references stay valid; targets are
+* rewritten to the freshly-allocated partnames. Notes relationships are
+* dropped. A copied `slideMaster` does not drag in all its sibling layouts —
+* each imported `slideLayout` wires itself into the master instead (see
+* {@link linkLayoutIntoMaster}).
+*
+* With `ctx.selection`, partnames for the selected slides were already reserved
+* by the caller ({@link Presentation.importSlides}); this traversal wires their
+* relationships to each other instead of re-copying them. The batch's rule that
+* a `slide → slide` link may not leave the selection is enforced ahead of the
+* copy by {@link checkSelectionCopyable}, which also proves every part this
+* traversal will reach exists — so once copying starts there is nothing left to
+* throw, and a rejected batch never leaves a half-copied deck behind.
+*
+* Idempotence stops at the page's own parts. Reaching a page opens an
+* {@link OwnedScope}, and everything under it that {@link isSharedByPageCopies}
+* does not clear for sharing — a chart, a diagram, an OLE embedding, each with
+* its own subtree — is copied into that scope instead of the registry, so the
+* next copy of the page gets parts of its own. Pass `owned` to open the scope
+* from outside, as the rebinding import paths do for the page they build
+* themselves.
+*/
+function copyPart(ctx, sourcePartName, owned) {
+	if (owned) {
+		const alreadyOwned = owned.get(sourcePartName);
+		if (alreadyOwned !== void 0) return alreadyOwned;
+	} else {
+		const existing = ctx.registry.get(sourcePartName);
+		const selectedDest = ctx.selection?.destinations.get(sourcePartName);
+		if (existing && (selectedDest === void 0 || existing === selectedDest)) return existing;
+	}
+	const sourcePart = ctx.source.part(sourcePartName);
+	if (!sourcePart) throw new PackageReadError("package/part-missing", `importSlide: source package has no part ${sourcePartName}`);
+	const newPartName = owned ? ctx.dest.opc.reservePartNameLike(sourcePartName) : ctx.selection?.destinations.get(sourcePartName) ?? ctx.dest.opc.reservePartNameLike(sourcePartName);
+	if (!ctx.dest.opc.part(newPartName)) ctx.dest.opc.addPart(newPartName, sourcePart.contentType, sourcePart.bytes);
+	if (owned) owned.set(sourcePartName, newPartName);
+	else ctx.registry.set(sourcePartName, newPartName);
+	const scope = owned ?? (ctx.selection?.destinations.has(sourcePartName) ? newOwnedScope() : void 0);
+	const isMaster = sourcePart.contentType === SLIDE_MASTER_CONTENT_TYPE;
+	const sourceRels = ctx.source.relationshipsFor(sourcePartName);
+	const targetRels = ctx.dest.opc.relationshipsFor(newPartName);
+	for (const rel of sourceRels) {
+		if (rel.type === "http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesSlide") continue;
+		if (isMaster && rel.type === "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideLayout") continue;
+		if (rel.targetMode === "External") {
+			targetRels.addWithId(rel.id, rel.type, rel.target, "External");
+			continue;
+		}
+		const newTargetPartName = copyPart(ctx, sourceRels.resolveTarget(rel.id), isSharedByPageCopies(rel.type) ? void 0 : scope);
+		targetRels.addWithId(rel.id, rel.type, relativePartName(newPartName, newTargetPartName));
+	}
+	if (isMaster) {
+		clearLayoutIdList(ctx.dest, newPartName);
+		registerMaster(ctx.dest, newPartName);
+	}
+	if (sourcePart.contentType === "application/vnd.openxmlformats-officedocument.presentationml.slideLayout+xml") linkLayoutIntoMaster(ctx, sourceRels, newPartName);
+	return newPartName;
+}
+const NO_NOTES = {
+	pages: /* @__PURE__ */ new Set(),
+	copyMaster: false
+};
+/**
+* Dry-run {@link copyPart} over one source's batch selection, reading only the
+* *source* package: walk the graph the copy will walk, under the same
+* relationship-skipping rules, and throw what the copy would throw — a source
+* part that is missing, XML that will not parse, or a `slide → slide` link that
+* escapes the selection.
+*
+* This is what makes a rejected batch leave the destination byte-identical.
+* `importSlides` reserves partnames and mutates the destination only after this
+* passes, at which point the copy has no reachable failure left; a check that
+* lived inside the traversal instead would fire with parts already added, a
+* master already registered in `presentation.xml`, and no way back.
+*
+* Keep this in step with `copyPart`: the two must skip the same relationships
+* and stop at the same registry hits, or the guarantee is only as good as the
+* drift between them. With `notes` the same obligation extends to `carryNotes`,
+* which runs after the copy and is the batch's other way to reach a source part.
+*
+* @param source     the package the pages are coming from
+* @param registry   the copy registry for that source (parts already in `dest`)
+* @param selected   source partnames of the pages this batch selected
+* @param notes      the pages of `selected` whose notes travel too; none by default
+*/
+function checkSelectionCopyable(source, registry, selected, notes = NO_NOTES) {
+	const visited = /* @__PURE__ */ new Set();
+	const walk = (partName) => {
+		if (visited.has(partName)) return;
+		if (registry.has(partName) && !selected.has(partName)) return;
+		visited.add(partName);
+		const part = source.part(partName);
+		if (!part) throw new PackageReadError("package/part-missing", `importSlides: source package has no part ${partName}`);
+		const isMaster = part.contentType === SLIDE_MASTER_CONTENT_TYPE;
+		const isNotesSlide = part.contentType === NOTES_SLIDE_CONTENT_TYPE;
+		if (isMaster || part.contentType === "application/vnd.openxmlformats-officedocument.presentationml.slideLayout+xml") part.dom;
+		const rels = source.relationshipsFor(partName);
+		for (const rel of rels) {
+			if (rel.type === "http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesSlide") {
+				if (notes.pages.has(partName)) walk(rels.resolveTarget(rel.id));
+				continue;
+			}
+			if (isNotesSlide) {
+				if (rel.type === "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide") continue;
+				if (rel.type === "http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesMaster" && !notes.copyMaster) continue;
+			}
+			if (isMaster && rel.type === "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideLayout") continue;
+			if (rel.targetMode === "External") continue;
+			const targetPartName = rels.resolveTarget(rel.id);
+			if (rel.type === "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide" && !selected.has(targetPartName) && !registry.has(targetPartName)) throw new InvalidOptionError("import/unresolved-slide-link", `importSlides: source slide ${partName} links to ${targetPartName}, which is not among the selected imported pages`);
+			walk(targetPartName);
+		}
+	};
+	for (const partName of selected) walk(partName);
+}
+/**
+* Wire a just-copied layout into its (already-copied) master. Resolves which
+* destination master that is by running the layout's *source* master rel through
+* the copy registry, then hands the destination-side wiring to
+* {@link addLayoutToMaster}. Called once per copied layout, so the master
+* accumulates exactly the imported layouts.
+*/
+function linkLayoutIntoMaster(ctx, layoutSourceRels, layoutPartName) {
+	const masterRel = layoutSourceRels.byType(SLIDE_MASTER_REL)[0];
+	if (!masterRel) return;
+	const masterPartName = ctx.registry.get(layoutSourceRels.resolveTarget(masterRel.id));
+	if (!masterPartName) return;
+	addLayoutToMaster(ctx.dest, masterPartName, layoutPartName);
+}
+//#endregion
+//#region src/read/api/ops/notes-master.ts
+/**
+* Carrying speaker notes and the deck's single notes master across an import or an append.
+*
+* A `notesSlide` is not self-contained: it back-references the slide it annotates and forward-
+* references the deck's notes master. `CT_NotesMasterIdList` allows at most one master per
+* presentation, so a deck that already has one keeps it — the destination's notes styling wins —
+* and a source master is copied only into a deck that has none. That single rule is why both the
+* `Presentation`-to-`Presentation` path and the generator-XML path funnel through
+* `registerNotesMaster`: they differ only in how the *part* comes into being.
+*/
+const textEncoder$3 = new TextEncoder();
+/**
+* Carry the source slide's speaker notes onto the just-imported slide (the
+* `importNotes` option). The slide copy itself dropped the `notesSlide` rel, so
+* this copies the source `notesSlide` part into a fresh partname, wires a
+* `slide → notesSlide` rel on the new slide, and rebuilds the copied notesSlide's
+* own relationships:
+*
+* - its `slide` back-rel is repointed at the new slide (`newSlidePartName`) — the
+*   source slide is *not* copied (that would be circular);
+* - its `notesMaster` rel is resolved through {@link ensureNotesMaster}, which
+*   reuses this deck's notesMaster when it has one and copies the source's only
+*   when it has none (a deck may have at most one notesMaster);
+* - any other internal target (media, etc.) is copied via {@link copyPart}, under an
+*   ownership scope so a second copy of the page gets notes parts of its own.
+*
+* No-op when the source slide has no notes. Content-type registration for the
+* copied parts is handled by `addPart`/{@link copyPart}.
+*/
+function carryNotes(dest, source, ctx, sourceSlidePartName, newSlidePartName) {
+	const sourceSlideRels = source.opc.relationshipsFor(sourceSlidePartName);
+	const notesRel = sourceSlideRels.byType(NOTES_SLIDE_REL)[0];
+	if (!notesRel) return;
+	const sourceNotesPartName = sourceSlideRels.resolveTarget(notesRel.id);
+	const sourceNotesPart = source.opc.part(sourceNotesPartName);
+	if (!sourceNotesPart) return;
+	const newNotesPartName = dest.opc.reservePartNameLike(sourceNotesPartName);
+	dest.opc.addPart(newNotesPartName, sourceNotesPart.contentType, sourceNotesPart.bytes);
+	dest.opc.relationshipsFor(newSlidePartName).add(NOTES_SLIDE_REL, relativePartName(newSlidePartName, newNotesPartName));
+	const owned = newOwnedScope();
+	owned.set(sourceNotesPartName, newNotesPartName);
+	const notesSourceRels = source.opc.relationshipsFor(sourceNotesPartName);
+	const notesTargetRels = dest.opc.relationshipsFor(newNotesPartName);
+	for (const rel of notesSourceRels) {
+		if (rel.type === "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide") {
+			notesTargetRels.addWithId(rel.id, SLIDE_REL, relativePartName(newNotesPartName, newSlidePartName));
+			continue;
+		}
+		if (rel.type === "http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesMaster") {
+			const notesMaster = ensureNotesMaster(dest, ctx, notesSourceRels.resolveTarget(rel.id));
+			notesTargetRels.addWithId(rel.id, NOTES_MASTER_REL, relativePartName(newNotesPartName, notesMaster));
+			continue;
+		}
+		if (rel.targetMode === "External") {
+			notesTargetRels.addWithId(rel.id, rel.type, rel.target, "External");
+			continue;
+		}
+		const newTarget = copyPart(ctx, notesSourceRels.resolveTarget(rel.id), isSharedByPageCopies(rel.type) ? void 0 : owned);
+		notesTargetRels.addWithId(rel.id, rel.type, relativePartName(newNotesPartName, newTarget));
+	}
+}
+/**
+* Resolve the notesMaster an imported `notesSlide` should bind to, honouring the
+* single-notesMaster-per-presentation rule (`p:notesMasterIdLst` holds 0..1
+* `p:notesMasterId`). If this deck already has a notesMaster it is reused and the
+* source's is *not* copied (the destination's notes styling wins); otherwise the
+* source notesMaster (and, via {@link copyPart}, its theme) is copied and
+* registered in `presentation.xml`. Returns the destination notesMaster partname.
+*/
+function ensureNotesMaster(dest, ctx, sourceNotesMasterPartName) {
+	const presRels = presentationRels(dest);
+	const existing = presRels.byType(NOTES_MASTER_REL)[0];
+	if (existing) return presRels.resolveTarget(existing.id);
+	return registerNotesMaster(dest, copyPart(ctx, sourceNotesMasterPartName));
+}
+/**
+* Wire an already-added notesMaster part into `presentation.xml`: a `notesMaster`
+* relationship plus the single `p:notesMasterId` entry that `CT_NotesMasterIdList`
+* allows. Returns the partname, so callers can use it as a rel target.
+*
+* Split out of {@link ensureNotesMaster} because the two ways a notesMaster arrives
+* — copied from another `Presentation`, or authored by a generator and injected by
+* {@link Presentation.appendSlides} — differ only in how the *part* is created, not in how it is
+* registered.
+*/
+function registerNotesMaster(dest, notesMasterPartName) {
+	const presPart = dest.presentationPart;
+	const relId = presentationRels(dest).add(NOTES_MASTER_REL, relativePartName(presPart.partName, notesMasterPartName)).id;
+	const root = presPart.dom.documentElement;
+	if (!root) throw new PackageReadError("package/part-has-no-root", "presentation.xml has no document element to register a notes master in");
+	const lst = getOrAddChild(root, "p:notesMasterIdLst", [
+		"p:handoutMasterIdLst",
+		"p:sldIdLst",
+		"p:sldSz",
+		"p:notesSz",
+		"p:embeddedFontLst",
+		"p:custShowLst",
+		"p:photoAlbum",
+		"p:custDataLst",
+		"p:kinsoku",
+		"p:defaultTextStyle",
+		"p:modifyVerifier",
+		"p:extLst"
+	]);
+	removeChildrenByQName(lst, ["p:notesMasterId"]);
+	const entry = createElement(presPart.dom, "p:notesMasterId");
+	setAttr(entry, "r:id", relId);
+	lst.appendChild(entry);
+	presPart.markDirty();
+	return notesMasterPartName;
+}
+/**
+* Resolve the notesMaster an *appended* slide's notes should bind to. Same
+* single-notesMaster rule as {@link ensureNotesMaster}: this deck's own wins when it
+* has one, so the destination's notes styling is preserved and `master.xml` is
+* discarded. Otherwise the generator's notes master is installed, together with the
+* theme its `.rels` requires (the normal write path emits that as `theme2.xml`).
+*/
+function ensureNotesMasterFromXml(dest, master) {
+	const presRels = presentationRels(dest);
+	const existing = presRels.byType(NOTES_MASTER_REL)[0];
+	if (existing) return presRels.resolveTarget(existing.id);
+	const masterPartName = dest.opc.reservePartNameLike("/ppt/notesMasters/notesMaster1.xml");
+	dest.opc.addPart(masterPartName, NOTES_MASTER_CONTENT_TYPE, textEncoder$3.encode(master.xml));
+	const themePartName = dest.opc.reservePartNameLike("/ppt/theme/theme1.xml");
+	dest.opc.addPart(themePartName, THEME_CONTENT_TYPE, textEncoder$3.encode(master.themeXml));
+	dest.opc.relationshipsFor(masterPartName).add(THEME_REL, relativePartName(masterPartName, themePartName));
+	return registerNotesMaster(dest, masterPartName);
+}
+/**
+* Resolve the notesMaster a *newly authored* notes slide should bind to
+* ({@link Slide.addNotes} on a loaded deck). Same single-notesMaster rule as
+* {@link ensureNotesMaster} and {@link ensureNotesMasterFromXml}: this deck's own
+* wins when it has one. The third way a notesMaster arrives, and the only one with
+* no source deck and no generator instance behind it, so it has to build both parts
+* itself.
+*
+* The *theme* is where it differs from the append path. `ensureNotesMasterFromXml`
+* installs the generator's `theme2.xml` because a generator deck's notes were
+* authored against it; there is no such theme here, so the deck's **own** theme
+* (reached through the annotated slide's layout → master → theme chain) is cloned
+* into a fresh part instead. That is both the closer match to "the destination's
+* notes styling wins" and the safer package: the notesMaster gets a theme part of
+* its own rather than a second relationship onto the slide master's, which is the
+* arrangement PowerPoint writes (`theme1.xml` for the master, `theme2.xml` for the
+* notes master).
+*
+* Throws when the deck has no theme to clone — a package that malformed cannot be
+* given a valid notesMaster, and silently emitting one without a resolvable theme
+* is what PowerPoint reports as a repair prompt rather than a bad edit.
+* @param {Presentation} dest - the deck being authored onto
+* @param {string} slidePartName - the slide whose notes are being authored, used to find the theme
+* @return {string} the destination notesMaster partname
+*/
+function ensureNotesMasterForAuthoring(dest, slidePartName) {
+	const presRels = presentationRels(dest);
+	const existing = presRels.byType(NOTES_MASTER_REL)[0];
+	if (existing) return presRels.resolveTarget(existing.id);
+	const themePartName = resolveSlideThemeParts(dest.opc, slidePartName).themePartName;
+	const themePart = themePartName ? dest.opc.part(themePartName) : void 0;
+	if (!themePart) throw new PackageReadError("package/part-missing", `addNotes: no theme reachable from ${slidePartName} to bind a new notes master to`);
+	const masterPartName = dest.opc.reservePartNameLike("/ppt/notesMasters/notesMaster1.xml");
+	dest.opc.addPart(masterPartName, NOTES_MASTER_CONTENT_TYPE, textEncoder$3.encode(makeXmlNotesMaster()));
+	const notesThemePartName = dest.opc.reservePartNameLike("/ppt/theme/theme1.xml");
+	dest.opc.addPart(notesThemePartName, themePart.contentType, themePart.bytes);
+	dest.opc.relationshipsFor(masterPartName).add(THEME_REL, relativePartName(masterPartName, notesThemePartName));
+	return registerNotesMaster(dest, masterPartName);
+}
+//#endregion
+//#region src/read/api/ops/notes-author.ts
+/**
+* Authoring speaker notes onto a slide of a *loaded* deck ({@link Slide.addNotes}).
+*
+* The third way a notes slide comes into being, after the two in `notes-master.ts`
+* (carried from another `Presentation` by `importSlide({ importNotes: true })`, or
+* emitted by the generator and spliced on by `appendSlides`). Those two both *move*
+* an existing part; this one has no source part to move, so it builds one.
+*
+* The part it builds is the generator's, not a second design: the fixed three-
+* placeholder frame comes from {@link makeXmlNotesSlideSkeleton}, and the body
+* paragraphs carry the same elements and attributes the write path emits for a plain
+* `pptx.addSlide().addNotes(text)`. `test/read/add-notes.test.js` asserts that
+* equivalence, so the two cannot drift apart unnoticed — the same guarantee
+* `src/ooxml/` gives the constants both halves share.
+*
+* The one difference is empty-element *spelling*: the write path emits `a:rPr` as an
+* open/close pair and this emits it self-closed, because a part the read model
+* authors is reserialized through `read/oxml/dom.ts`, which self-closes every empty
+* element. Writing the open/close form here would not survive the first save, so the
+* form that does is written in the first place and the test normalizes the spelling
+* rather than pretending the bytes match.
+*
+* Notes text is split on `\n` into paragraphs, matching the write-side `addNotes`;
+* runs carry no formatting of their own. Per-run formatting, hyperlinks, and
+* multi-run paragraphs are reached afterwards through `slide.notesTextFrame`, which
+* is the read model's normal text-editing surface.
+*/
+const textEncoder$2 = new TextEncoder();
+/**
+* The `a:p` children of a notes body, one per `\n`-separated line: the write path's
+* output for an unformatted note, modulo the empty-element spelling described above.
+* An empty line yields a paragraph with no run, exactly as `genXmlNotesParagraphs`
+* does.
+* @param {string} text - the note, `\n` separating paragraphs
+* @return {string} concatenated `a:p` XML
+*/
+function notesParagraphsXml(text) {
+	return text.split("\n").map((line) => line.replace(/\r/g, "")).map((line) => el("a:p", null, [raw(line === "" ? "" : el("a:r", null, [raw(voidEl("a:rPr", {
+		lang: "en-US",
+		dirty: 0
+	})), raw(el("a:t", null, line))])), raw(voidEl("a:endParaRPr", {
+		lang: "en-US",
+		dirty: 0
+	}))])).join("");
+}
+/**
+* Replace a notes body's paragraphs with `text`, in the body's own document.
+*
+* The path taken when the slide *already* has a notes part — an imported one, or one
+* an earlier `addNotes` wrote. Only the `a:p` children are replaced, so the part's
+* geometry, its `a:bodyPr`/`a:lstStyle`, and its other two placeholders survive. The
+* body's hyperlink relationships are deliberately *not* pruned: a caller replacing
+* text has not asked for its rels to be rewritten, and a now-unreferenced notes
+* hyperlink rel is inert (nothing resolves it on save).
+* @param {Element} txBody - the body placeholder's `p:txBody`
+* @param {string} text - the note, `\n` separating paragraphs
+*/
+function replaceNotesParagraphs(txBody, text) {
+	const doc = txBody.ownerDocument;
+	if (!doc) throw new InternalError("oxml/node-has-no-document", "Notes body has no owner document");
+	removeChildrenByQName(txBody, ["a:p"]);
+	const wrapper = parseXml(`<w xmlns:a="${OOXML_NS.a}">${notesParagraphsXml(text)}</w>`).documentElement;
+	if (!wrapper) throw new InternalError("oxml/node-has-no-document", "Authored notes paragraphs did not parse to a root");
+	for (const paragraph of Array.from(wrapper.childNodes)) txBody.appendChild(doc.importNode(paragraph, true));
+}
+/**
+* The `p:txBody` of a notes slide's body placeholder (`p:ph type="body"`), or `null`
+* when the part carries none. A raw walk rather than a `NotesSlide`/`TextFrame` hop,
+* because the caller needs the element itself to rewrite and the modeled surface
+* would resolve a notes theme context it has no use for.
+* @param {Element | null} root - the notes slide's `p:notes` root
+* @return {Element | null} the body placeholder's text body
+*/
+function notesBodyTxBody(root) {
+	const spTree = spTreeOf(root);
+	if (!spTree) return null;
+	for (const sp of getElements(spTree, "p:sp")) {
+		const nvPr = nvPrOf(sp);
+		const ph = nvPr && firstChild(nvPr, "p:ph");
+		if (ph && attr(ph, "type") === "body") return firstChild(sp, "p:txBody");
+	}
+	return null;
+}
+/**
+* Give `slide` the speaker notes `text`, creating its notes slide part when it has
+* none, and return the notes part's name.
+*
+* When the slide already has a notes part, only the body paragraphs are rewritten
+* (see {@link replaceNotesParagraphs}). When it has none, the part is built and
+* wired: `slide → notesSlide`, and on the new part the two relationships a notes
+* slide always carries — `notesMaster` as rId1 and a `slide` back-reference as rId2,
+* the ids and order the write path reserves.
+*
+* The notes master is resolved through {@link ensureNotesMasterForAuthoring}: this
+* deck's own when it has one, otherwise a fresh one bound to a clone of the deck's
+* theme. That is the single-notesMaster-per-presentation rule the import and append
+* paths already follow, so the three cannot produce a second master between them.
+* @param {Slide} slide - the slide to annotate
+* @param {string} text - the note, `\n` separating paragraphs
+* @return {string} the notes slide's partname
+*/
+function authorNotes(slide, text) {
+	const opc = slide.presentation.opc;
+	const existingRel = slide.relationships.byType(NOTES_SLIDE_REL)[0];
+	if (existingRel) {
+		const partName = slide.relationships.resolveTarget(existingRel.id);
+		const part = opc.part(partName);
+		if (!part) throw new PackageReadError("package/part-missing", `addNotes: slide ${slide.partName} has a notesSlide rel to a missing part ${partName}`);
+		const txBody = notesBodyTxBody(part.dom.documentElement);
+		if (!txBody) throw new PackageReadError("package/part-has-no-root", `addNotes: notes slide ${partName} has no body placeholder to write into`);
+		replaceNotesParagraphs(txBody, text);
+		part.markDirty();
+		return partName;
+	}
+	const slideNum = slide.index + 1;
+	const partName = opc.reservePartNameLike("/ppt/notesSlides/notesSlide1.xml");
+	opc.addPart(partName, NOTES_SLIDE_CONTENT_TYPE, textEncoder$2.encode(makeXmlNotesSlideSkeleton(notesParagraphsXml(text), slideNum)));
+	slide.relationships.add(NOTES_SLIDE_REL, relativePartName(slide.partName, partName));
+	const notesRels = opc.relationshipsFor(partName);
+	const masterPartName = ensureNotesMasterForAuthoring(slide.presentation, slide.partName);
+	notesRels.addWithId("rId1", NOTES_MASTER_REL, relativePartName(partName, masterPartName));
+	notesRels.addWithId("rId2", SLIDE_REL, relativePartName(partName, slide.partName));
+	return partName;
+}
+//#endregion
+//#region src/read/api/comments.ts
+/** The slide → comments-part relationship type (legacy comments). */
+const COMMENTS_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments";
+/** The presentation → commentAuthors-part relationship type. */
+const COMMENT_AUTHORS_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/commentAuthors";
+/** Content type of a legacy per-slide comments part (`ppt/comments/commentN.xml`). */
+const LEGACY_COMMENTS_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.presentationml.comments+xml";
+/** The slide → modern-comments-part relationship type (2018 schema). */
+const MODERN_COMMENTS_REL_TYPE = "http://schemas.microsoft.com/office/2018/10/relationships/comments";
+/** The presentation → modern-authors-part relationship type (2018 schema). */
+const MODERN_AUTHORS_REL_TYPE = "http://schemas.microsoft.com/office/2018/10/relationships/authors";
+/** Content type of the modern per-slide comments part (`ppt/comments/modernComment_*.xml`). */
+const MODERN_COMMENTS_CONTENT_TYPE = "application/vnd.ms-powerpoint.comments+xml";
+/** Parse a `p:cmAuthorLst` root element into the author registry. */
+function parseCommentAuthors(root) {
+	if (!root) return [];
+	return getElements(root, "p:cmAuthor").map((el) => ({
+		id: intValue(attr(el, "id")),
+		name: attr(el, "name") ?? "",
+		initials: attr(el, "initials") ?? "",
+		lastIdx: intValue(attr(el, "lastIdx")),
+		clrIdx: intValue(attr(el, "clrIdx"))
+	}));
+}
+/**
+* Read the deck-wide comment authors from `ppt/commentAuthors.xml`, resolved via the
+* presentation part's `commentAuthors` relationship. `[]` when the deck has no comments.
+*/
+function readCommentAuthors(opc, presentationPartName) {
+	const rels = opc.relationshipsFor(presentationPartName);
+	const rel = rels.byType(COMMENT_AUTHORS_REL_TYPE)[0];
+	if (!rel) return [];
+	return parseCommentAuthors(opc.part(rels.resolveTarget(rel.id))?.dom.documentElement ?? null);
+}
+/**
+* Read one slide's legacy comments from its `comments/commentN.xml` part (resolved
+* via the slide's `comments` relationship), resolving each comment's `@authorId`
+* against `authors` (typically {@link readCommentAuthors}). `[]` when the slide has
+* no comments part.
+*/
+function readSlideComments(opc, slidePart, authors) {
+	const rels = opc.relationshipsFor(slidePart.partName);
+	const rel = rels.byType(COMMENTS_REL_TYPE)[0];
+	if (!rel) return [];
+	const root = opc.part(rels.resolveTarget(rel.id))?.dom.documentElement;
+	if (!root) return [];
+	const byId = new Map(authors.map((a) => [a.id, a]));
+	return getElements(root, "p:cm").map((cm) => {
+		const authorId = intValue(attr(cm, "authorId"));
+		const author = authorId !== null ? byId.get(authorId) ?? null : null;
+		const pos = firstChild(cm, "p:pos");
+		const textEl = firstChild(cm, "p:text");
+		return {
+			author: author ? author.name : null,
+			authorInitials: author ? author.initials : null,
+			authorId,
+			idx: intValue(attr(cm, "idx")),
+			text: textEl?.textContent ?? "",
+			x: pos ? intValue(attr(pos, "x")) : null,
+			y: pos ? intValue(attr(pos, "y")) : null,
+			date: attr(cm, "dt") ?? null
+		};
+	});
+}
+/** Concatenate a `p188:txBody`'s paragraphs into plain text, joining paragraphs with `\n`. */
+function modernCommentText(el) {
+	const txBody = firstChild(el, "p188:txBody");
+	if (!txBody) return "";
+	const paras = getElements(txBody, "a:p");
+	if (paras.length === 0) return txBody.textContent ?? "";
+	return paras.map((p) => p.textContent ?? "").join("\n");
+}
+/**
+* Decode one `p188:cm` (or `p188:reply`) element. Only the top-level comment
+* carries a position and a reply list; replies pass `withThread: false` so they
+* report `x`/`y` as `null` and never recurse (the schema forbids nested replies).
+*/
+function parseModernComment(el, byId, withThread) {
+	const authorId = attr(el, "authorId");
+	const author = authorId !== null ? byId.get(authorId) ?? null : null;
+	const pos = withThread ? firstChild(el, "p188:pos") : null;
+	const replyLst = withThread ? firstChild(el, "p188:replyLst") : null;
+	return {
+		id: attr(el, "id"),
+		author: author ? author.name : null,
+		authorInitials: author ? author.initials : null,
+		authorId,
+		created: attr(el, "created"),
+		text: modernCommentText(el),
+		x: pos ? intValue(attr(pos, "x")) : null,
+		y: pos ? intValue(attr(pos, "y")) : null,
+		replies: replyLst ? getElements(replyLst, "p188:reply").map((r) => parseModernComment(r, byId, false)) : []
+	};
+}
+/**
+* Read the deck-wide modern comment authors from `ppt/authors.xml`, resolved via
+* the presentation part's 2018 `authors` relationship. `[]` when the deck has no
+* modern authors part.
+*/
+function readModernCommentAuthors(opc, presentationPartName) {
+	const rels = opc.relationshipsFor(presentationPartName);
+	const rel = rels.byType(MODERN_AUTHORS_REL_TYPE)[0];
+	if (!rel) return [];
+	const root = opc.part(rels.resolveTarget(rel.id))?.dom.documentElement;
+	if (!root) return [];
+	return getElements(root, "p188:author").map((el) => ({
+		id: attr(el, "id"),
+		name: attr(el, "name") ?? "",
+		initials: attr(el, "initials") ?? "",
+		userId: attr(el, "userId"),
+		providerId: attr(el, "providerId")
+	}));
+}
+/**
+* Read one slide's modern comments from its `modernComment_*.xml` part (resolved
+* via the slide's 2018 `comments` relationship), resolving each comment's and
+* reply's `@authorId` GUID against `authors` (typically
+* {@link readModernCommentAuthors}). Replies are nested, not flattened. `[]` when
+* the slide has no modern comments part.
+*/
+function readModernSlideComments(opc, slidePart, authors) {
+	const rels = opc.relationshipsFor(slidePart.partName);
+	const rel = rels.byType(MODERN_COMMENTS_REL_TYPE)[0];
+	if (!rel) return [];
+	const root = opc.part(rels.resolveTarget(rel.id))?.dom.documentElement;
+	if (!root) return [];
+	const byId = new Map(authors.map((a) => [a.id, a]));
+	return getElements(root, "p188:cm").map((cm) => parseModernComment(cm, byId, true));
+}
+/**
+* Report which comment schema a deck uses: `'modern'` when it carries any 2018
+* `modernComment_*` part, else `'legacy'` when it carries any classic
+* `commentN.xml` part, else `'none'`. Lets a consumer pick the right accessor
+* ({@link readModernSlideComments} vs {@link readSlideComments}) without probing
+* both.
+*/
+function commentSchema(opc) {
 	if (opc.partsByContentType(MODERN_COMMENTS_CONTENT_TYPE).length > 0) return "modern";
 	if (opc.partsByContentType(LEGACY_COMMENTS_CONTENT_TYPE).length > 0) return "legacy";
 	return "none";
@@ -1624,12 +2323,10 @@ var SlideMaster = class {
 		return rel ? this.opc.part(rels.resolveTarget(rel.id)) ?? null : null;
 	}
 	#cSld() {
-		const root = this.part.dom.documentElement;
-		return root ? firstChild(root, "p:cSld") : null;
+		return cSldOf(this.part.dom.documentElement);
 	}
 	#spTree() {
-		const cSld = this.#cSld();
-		return cSld ? firstChild(cSld, "p:spTree") : null;
+		return spTreeOf(this.part.dom.documentElement);
 	}
 };
 /**
@@ -1735,12 +2432,10 @@ var SlideLayout = class {
 		return this.#themeContext ??= resolveLayoutColorContext(this.opc, this.partName);
 	}
 	#cSld() {
-		const root = this.part.dom.documentElement;
-		return root ? firstChild(root, "p:cSld") : null;
+		return cSldOf(this.part.dom.documentElement);
 	}
 	#spTree() {
-		const cSld = this.#cSld();
-		return cSld ? firstChild(cSld, "p:spTree") : null;
+		return spTreeOf(this.part.dom.documentElement);
 	}
 };
 //#endregion
@@ -2399,9 +3094,14 @@ var Slide = class {
 	* All text on the slide, flattened in document order — the read-model
 	* counterpart to {@link TextFrame.text} one level up. Every text-bearing shape
 	* contributes its text, recursing into groups ({@link GroupShape}) and reading
-	* table cells ({@link GraphicFrame.table}); text-free shapes (pictures,
-	* connectors, empty boxes) contribute nothing. Blocks are joined by `\n`; within
-	* a table, cells in a row are joined by `\t` and rows by `\n`.
+	* table cells ({@link GraphicFrame.table}) and SmartArt node text
+	* ({@link GraphicFrame.diagram}); text-free shapes (pictures, connectors, empty
+	* boxes) contribute nothing. Blocks are joined by `\n`; within a table, cells in
+	* a row are joined by `\t` and rows by `\n`.
+	*
+	* A diagram contributes for the same reason a table does: its nodes are body text
+	* PowerPoint itself searches and spell-checks, so a slide whose whole message is a
+	* SmartArt graphic would otherwise flatten to the empty string.
 	*
 	* This is deliberately scoped to the slide's own shape tree. It does **not**
 	* include speaker notes (read those via {@link notesText}) or chart data labels
@@ -2415,11 +3115,16 @@ var Slide = class {
 			for (const shape of shapes) if (shape instanceof GroupShape) walk(shape.shapes);
 			else if (shape instanceof GraphicFrame) {
 				const table = shape.table;
-				if (!table) continue;
-				for (const row of table.rows) {
-					const cells = row.cells.map((cell) => cell.text);
-					if (cells.some((cell) => cell.length > 0)) blocks.push(cells.join("	"));
+				if (table) {
+					for (const row of table.rows) {
+						const cells = row.cells.map((cell) => cell.text);
+						if (cells.some((cell) => cell.length > 0)) blocks.push(cells.join("	"));
+					}
+					continue;
 				}
+				const diagram = shape.diagram;
+				const diagramText = diagram ? diagram.text : "";
+				if (diagramText.length > 0) blocks.push(diagramText);
 			} else {
 				const text = shape.text;
 				if (text.length > 0) blocks.push(text);
@@ -2700,6 +3405,34 @@ var Slide = class {
 		return new Picture(pic, this);
 	}
 	/**
+	* Give this slide the speaker notes `text`, and return the resulting
+	* {@link NotesSlide}. A `
+	` starts a new paragraph, matching the write-side
+	* `addNotes`; the runs carry no formatting of their own, so style them
+	* afterwards through {@link notesTextFrame}.
+	*
+	* The counterpart to the read side's `notesText`/`notesTextFrame`/`notesSlide`
+	* getters, and the way to annotate a slide that has **no notes part at all** —
+	* the state an `importSlide` without `{ importNotes: true }` leaves behind, and
+	* the one a `notesTextFrame` edit cannot reach because there is no frame to
+	* hand back. Calling it on a slide that already has notes replaces the body
+	* text and leaves the rest of the part (its geometry, its other two
+	* placeholders) alone.
+	*
+	* Creating the part pulls in what a notes slide must bind to: a `notesMaster`,
+	* of which a presentation may hold at most one. This deck's own is reused when
+	* it has one; otherwise one is installed, bound to a clone of this deck's theme
+	* so it resolves against the destination palette. That is the same
+	* single-master rule `importSlide({ importNotes: true })` and `appendSlides`
+	* follow, so mixing the three cannot produce a second notes master.
+	*/
+	addNotes(text) {
+		const partName = authorNotes(this, text);
+		const part = this.presentation.opc.part(partName);
+		if (!part) throw new InternalError("import/part-went-missing", `Authored notes part went missing: ${partName}`);
+		return new NotesSlide(this.presentation.opc, part);
+	}
+	/**
 	* @internal The slide's shape tree (`p:cSld/p:spTree`), or `null` if absent.
 	* Exposed for cross-slide composition (`Presentation.importShape`).
 	*/
@@ -2730,12 +3463,10 @@ var Slide = class {
 		return max + 1;
 	}
 	#cSld() {
-		const root = this.part.dom.documentElement;
-		return root ? firstChild(root, "p:cSld") : null;
+		return cSldOf(this.part.dom.documentElement);
 	}
 	#spTree() {
-		const cSld = this.#cSld();
-		return cSld ? firstChild(cSld, "p:spTree") : null;
+		return spTreeOf(this.part.dom.documentElement);
 	}
 };
 function requireFinite(value, name) {
@@ -2745,39 +3476,53 @@ function requirePositive(value, name) {
 	requireFinite(value, name);
 	if (value <= 0) throw new InvalidOptionError("coord/not-positive", `${name} must be positive, got ${value}`);
 }
-/** Build a minimal, schema-valid text-box `p:sp` element (not yet attached). */
-function buildTextBox(doc, spec) {
-	const make = (qname) => createElement(doc, qname);
-	const append = (parent, qname) => {
-		const child = make(qname);
-		parent.appendChild(child);
-		return child;
-	};
-	const sp = make("p:sp");
-	const nvSpPr = append(sp, "p:nvSpPr");
-	const cNvPr = append(nvSpPr, "p:cNvPr");
-	setAttr(cNvPr, "id", String(spec.id));
-	setAttr(cNvPr, "name", spec.name);
-	const cNvSpPr = append(nvSpPr, "p:cNvSpPr");
-	setAttr(cNvSpPr, "txBox", "1");
-	append(nvSpPr, "p:nvPr");
-	const spPr = append(sp, "p:spPr");
-	const xfrm = append(spPr, "a:xfrm");
-	const off = append(xfrm, "a:off");
+/**
+* Create `qname` in the parent's document and append it.
+*
+* The builders below are uniformly parent-then-child, so this is the only shape
+* of element creation they need; `ownerDocumentOf` is what lets it take the
+* parent alone rather than threading a `Document` through every call.
+*/
+function appendEl(parent, qname) {
+	const child = createElement(ownerDocumentOf(parent), qname);
+	parent.appendChild(child);
+	return child;
+}
+/**
+* Append the `p:spPr` a built `p:sp` and `p:pic` share: the spec's box as an
+* `a:xfrm`, then a rect `prstGeom` with the empty `a:avLst` the schema requires.
+*/
+function appendSpPr(parent, spec) {
+	const spPr = appendEl(parent, "p:spPr");
+	const xfrm = appendEl(spPr, "a:xfrm");
+	const off = appendEl(xfrm, "a:off");
 	setAttr(off, "x", String(spec.left));
 	setAttr(off, "y", String(spec.top));
-	const ext = append(xfrm, "a:ext");
+	const ext = appendEl(xfrm, "a:ext");
 	setAttr(ext, "cx", String(spec.width));
 	setAttr(ext, "cy", String(spec.height));
-	const prstGeom = append(spPr, "a:prstGeom");
+	const prstGeom = appendEl(spPr, "a:prstGeom");
 	setAttr(prstGeom, "prst", "rect");
-	append(prstGeom, "a:avLst");
-	const txBody = append(sp, "p:txBody");
-	append(txBody, "a:bodyPr");
-	append(txBody, "a:lstStyle");
-	const p = append(txBody, "a:p");
+	appendEl(prstGeom, "a:avLst");
+	return spPr;
+}
+/** Build a minimal, schema-valid text-box `p:sp` element (not yet attached). */
+function buildTextBox(doc, spec) {
+	const sp = createElement(doc, "p:sp");
+	const nvSpPr = appendEl(sp, "p:nvSpPr");
+	const cNvPr = appendEl(nvSpPr, "p:cNvPr");
+	setAttr(cNvPr, "id", String(spec.id));
+	setAttr(cNvPr, "name", spec.name);
+	const cNvSpPr = appendEl(nvSpPr, "p:cNvSpPr");
+	setAttr(cNvSpPr, "txBox", "1");
+	appendEl(nvSpPr, "p:nvPr");
+	appendSpPr(sp, spec);
+	const txBody = appendEl(sp, "p:txBody");
+	appendEl(txBody, "a:bodyPr");
+	appendEl(txBody, "a:lstStyle");
+	const p = appendEl(txBody, "a:p");
 	if (spec.text !== "") {
-		const t = append(append(p, "a:r"), "a:t");
+		const t = appendEl(appendEl(p, "a:r"), "a:t");
 		t.textContent = spec.text;
 		if (spec.text !== spec.text.trim()) setAttr(t, "xml:space", "preserve");
 	}
@@ -2785,35 +3530,19 @@ function buildTextBox(doc, spec) {
 }
 /** Build a minimal, schema-valid `p:pic` element (not yet attached). */
 function buildPicture(doc, spec) {
-	const make = (qname) => createElement(doc, qname);
-	const append = (parent, qname) => {
-		const child = make(qname);
-		parent.appendChild(child);
-		return child;
-	};
-	const pic = make("p:pic");
-	const nvPicPr = append(pic, "p:nvPicPr");
-	const cNvPr = append(nvPicPr, "p:cNvPr");
+	const pic = createElement(doc, "p:pic");
+	const nvPicPr = appendEl(pic, "p:nvPicPr");
+	const cNvPr = appendEl(nvPicPr, "p:cNvPr");
 	setAttr(cNvPr, "id", String(spec.id));
 	setAttr(cNvPr, "name", spec.name);
-	const picLocks = append(append(nvPicPr, "p:cNvPicPr"), "a:picLocks");
+	const picLocks = appendEl(appendEl(nvPicPr, "p:cNvPicPr"), "a:picLocks");
 	setAttr(picLocks, "noChangeAspect", "1");
-	append(nvPicPr, "p:nvPr");
-	const blipFill = append(pic, "p:blipFill");
-	const blip = append(blipFill, "a:blip");
+	appendEl(nvPicPr, "p:nvPr");
+	const blipFill = appendEl(pic, "p:blipFill");
+	const blip = appendEl(blipFill, "a:blip");
 	setAttr(blip, "r:embed", spec.relId);
-	append(append(blipFill, "a:stretch"), "a:fillRect");
-	const spPr = append(pic, "p:spPr");
-	const xfrm = append(spPr, "a:xfrm");
-	const off = append(xfrm, "a:off");
-	setAttr(off, "x", String(spec.left));
-	setAttr(off, "y", String(spec.top));
-	const ext = append(xfrm, "a:ext");
-	setAttr(ext, "cx", String(spec.width));
-	setAttr(ext, "cy", String(spec.height));
-	const prstGeom = append(spPr, "a:prstGeom");
-	setAttr(prstGeom, "prst", "rect");
-	append(prstGeom, "a:avLst");
+	appendEl(appendEl(blipFill, "a:stretch"), "a:fillRect");
+	appendSpPr(pic, spec);
 	return pic;
 }
 //#endregion
@@ -2925,70 +3654,6 @@ function readCustomProperties(opc) {
 	return out;
 }
 //#endregion
-//#region src/read/oxml/slide-dom.ts
-/** The `p:cSld@name` of a slide/layout/master part (`''` when absent). */
-function cSldName(part) {
-	const root = part?.dom.documentElement;
-	const cSld = root && firstChild(root, "p:cSld");
-	return (cSld && attr(cSld, "name")) ?? "";
-}
-/** Whether `el` is a `p:spTree`'s own group properties (`p:nvGrpSpPr`/`p:grpSpPr`), not a shape. */
-function isSpTreeProperty(el) {
-	return el.namespaceURI === OOXML_NS.p && (el.localName === "nvGrpSpPr" || el.localName === "grpSpPr");
-}
-/** Whether a `p:spTree` child is a placeholder shape (its `*nvPr` carries a `p:ph`). */
-function isPlaceholderShape(shape) {
-	const nv = firstChildElement(shape);
-	const nvPr = nv && firstChild(nv, "p:nvPr");
-	return !!(nvPr && firstChild(nvPr, "p:ph"));
-}
-/** The decorative shapes on a layout/master `p:spTree`: every shape child except placeholders. */
-function carriedDecorations(root) {
-	if (!root) return [];
-	const cSld = firstChild(root, "p:cSld");
-	const spTree = cSld && firstChild(cSld, "p:spTree");
-	if (!spTree) return [];
-	const out = [];
-	for (let node = spTree.firstChild; node; node = node.nextSibling) {
-		if (node.nodeType !== 1) continue;
-		const el = node;
-		if (isSpTreeProperty(el) || isPlaceholderShape(el)) continue;
-		out.push(el);
-	}
-	return out;
-}
-/**
-* The `n`-th shape child of a `p:spTree` in document (z-)order, skipping the
-* tree's own `nvGrpSpPr`/`grpSpPr` and any trailing `p:extLst`. Returns `null`
-* when `n` is past the last shape (the caller then appends).
-*/
-function nthShapeChild(spTree, n) {
-	let i = 0;
-	for (let node = spTree.firstChild; node; node = node.nextSibling) {
-		if (node.nodeType !== 1) continue;
-		const el = node;
-		if (isSpTreeProperty(el)) continue;
-		if (el.namespaceURI === OOXML_NS.p && el.localName === "extLst") continue;
-		if (i === n) return el;
-		i++;
-	}
-	return null;
-}
-/** The first shape child of a `p:spTree` (skipping `nvGrpSpPr`/`grpSpPr`), or `null`. */
-function firstShapeChild(spTree) {
-	for (let node = spTree.firstChild; node; node = node.nextSibling) {
-		if (node.nodeType !== 1) continue;
-		const el = node;
-		if (!isSpTreeProperty(el)) return el;
-	}
-	return null;
-}
-/** Collect `node` and all its descendant elements (document order) into `out`. */
-function collectElements(node, out) {
-	out.push(node);
-	for (let child = node.firstChild; child; child = child.nextSibling) if (child.nodeType === 1) collectElements(child, out);
-}
-//#endregion
 //#region src/read/api/ops/rescale.ts
 /** Build the EMU transform mapping source-canvas coordinates onto the target canvas (see {@link ImportSlideOptions.rescale}). */
 function computeRescale(source, target, mode) {
@@ -3081,7 +3746,7 @@ function rescaleTableGrid(graphicFrame, t) {
 const TABLE_STYLES_REL = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/tableStyles";
 const TABLE_STYLES_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.presentationml.tableStyles+xml";
 const TABLE_STYLES_DEFAULT_GUID = "{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}";
-const textEncoder$2 = new TextEncoder();
+const textEncoder$1 = new TextEncoder();
 /**
 * Copy any table style the restyled slide references from the source
 * `tableStyles.xml` into this deck's (the `remapLiterals` table leg). A restyled
@@ -3114,268 +3779,72 @@ function copySourceTableStyles(dest, sourceOpc, slideRoot) {
 	if (addTableStyles(destList, referenced)) destPart.markDirty();
 }
 /**
-* Append each source `<a:tblStyle>` this deck does not already define, keyed by
-* `styleId` — the shared core of {@link copySourceTableStyles} (which offers only
-* the styles a restyled slide references) and {@link carryTableStyles} (which
-* offers the source's whole list). Destination-wins per id: a style this deck
-* already defines is left untouched, so a re-call adds nothing. Returns whether
-* anything was added.
-*/
-function addTableStyles(destList, styles) {
-	const present = new Set(getElements(destList, "a:tblStyle").map((st) => attr(st, "styleId")));
-	let added = false;
-	for (const style of styles) {
-		const id = attr(style, "styleId");
-		if (!id || present.has(id)) continue;
-		destList.appendChild(ownerDocumentOf(destList).importNode(style, true));
-		present.add(id);
-		added = true;
-	}
-	return added;
-}
-/**
-* Copy the source deck's **whole** `tableStyles.xml` into this deck: every
-* `<a:tblStyle>` it defines, plus its `a:tblStyleLst@def` (the default table
-* style). Presentation-level, so a separate traversal from the master/layout copy
-* chain — and whole-deck, since `tableStyles.xml` does not record which style
-* belongs to which master. See `ImportSlideMastersOptions.tableStyles`.
-*
-* Styles union by `styleId` (destination-wins per id, via {@link addTableStyles}),
-* but `def` is **source-wins**: a caller asking for the source's table styling
-* wants its default too, and the destination's `def` is typically a generator stub
-* rather than a deliberate choice. Carrying the styles without the `def` would be
-* the worse half-measure — the standard default GUID is one most templates also
-* define, so a new table would silently resolve to the wrong style rather than
-* visibly to none. Idempotent: a re-call re-adds nothing and re-sets `def` to the
-* same value.
-*/
-function carryTableStyles(dest, sourceOpc) {
-	const sourceList = tableStyleList(sourceOpc);
-	if (!sourceList) return;
-	const destPart = ensureTableStylesPart(dest);
-	const destList = destPart.dom.documentElement;
-	if (!destList) return;
-	let changed = addTableStyles(destList, getElements(sourceList, "a:tblStyle"));
-	const sourceDef = attr(sourceList, "def");
-	if (sourceDef && attr(destList, "def") !== sourceDef) {
-		destList.setAttribute("def", sourceDef);
-		changed = true;
-	}
-	if (changed) destPart.markDirty();
-}
-/** The `a:tblStyleLst` root of a package's `tableStyles.xml`, or `null` when it has none. */
-function tableStyleList(opc) {
-	const part = opc.partsByContentType(TABLE_STYLES_CONTENT_TYPE)[0];
-	return part ? part.dom.documentElement : null;
-}
-/**
-* The deck's `tableStyles.xml` part, creating an empty one (and wiring its
-* `presentation.xml` relationship + content type) when the deck has none.
-*/
-function ensureTableStylesPart(dest) {
-	const existing = dest.opc.partsByContentType(TABLE_STYLES_CONTENT_TYPE)[0];
-	if (existing) return existing;
-	const partName = dest.opc.reservePartNameLike("/ppt/tableStyles.xml");
-	const xml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\r\n<a:tblStyleLst xmlns:a="${OOXML_NS.a}" def="${TABLE_STYLES_DEFAULT_GUID}"/>`;
-	const part = dest.opc.addPart(partName, TABLE_STYLES_CONTENT_TYPE, textEncoder$2.encode(xml));
-	dest.opc.relationshipsFor(dest.presentationPart.partName).add(TABLE_STYLES_REL, relativePartName(dest.presentationPart.partName, partName));
-	return part;
-}
-//#endregion
-//#region src/read/api/ops/master-registry.ts
-/**
-* Slide-master bookkeeping in `presentation.xml` and in a master's own
-* `p:sldLayoutIdLst`: registering a master so renderers treat it as active,
-* promoting masters to the front of the id list, allocating ids out of the shared
-* master/layout id space, and emptying a freshly-copied master's layout list.
-*
-* These are the destination-side half of the import machinery -- they read and
-* write only this deck, never a source package and never the copy registry -- so
-* they take a structural {@link DeckTarget} rather than a `Presentation`. The
-* source-side half that drives most of them is `part-copy.ts`.
-*/
-/**
-* Wire a freshly-copied slide master into `presentation.xml`: add a
-* presentation→master relationship and a `p:sldMasterId` entry in
-* `p:sldMasterIdLst`. A master that is reachable only through the
-* slide→layout→master rel chain but absent from `p:sldMasterIdLst` is treated
-* as inactive by renderers, so its background/graphics never paint. No-op when
-* the master is already registered (shared across imports from one source).
-*/
-function registerMaster(dest, masterPartName) {
-	const presPart = dest.presentationPart;
-	const presRels = dest.opc.relationshipsFor(presPart.partName);
-	for (const rel of presRels.byType(SLIDE_MASTER_REL)) if (presRels.resolveTarget(rel.id) === masterPartName) return;
-	const relId = presRels.add(SLIDE_MASTER_REL, relativePartName(presPart.partName, masterPartName)).id;
-	const root = presPart.dom.documentElement;
-	if (!root) throw new PackageReadError("package/part-has-no-root", "presentation.xml has no document element to register a master in");
-	const lst = getOrAddChild(root, "p:sldMasterIdLst", [
-		"p:notesMasterIdLst",
-		"p:handoutMasterIdLst",
-		"p:sldIdLst",
-		"p:sldSz",
-		"p:notesSz",
-		"p:embeddedFontLst",
-		"p:custShowLst",
-		"p:photoAlbum",
-		"p:custDataLst",
-		"p:kinsoku",
-		"p:defaultTextStyle",
-		"p:modifyVerifier",
-		"p:extLst"
-	]);
-	const entry = createElement(presPart.dom, "p:sldMasterId");
-	setAttr(entry, "id", String(nextMasterLayoutId(dest)));
-	setAttr(entry, "r:id", relId);
-	lst.appendChild(entry);
-	presPart.markDirty();
-}
-/**
-* Move the `p:sldMasterId` entries for `masterPartNames` to the front of
-* `p:sldMasterIdLst`, preserving their existing relative order, so the first of
-* them becomes the deck's `Designs(1)` — the theme PowerPoint's Design tab shows.
-* Reorders the id list only; relationships, ids, and all other parts are left as
-* they are. A no-op when the named masters already lead (idempotent re-call).
-*/
-function promoteMasters(dest, masterPartNames) {
-	if (masterPartNames.length === 0) return;
-	const presPart = dest.presentationPart;
-	const root = presPart.dom.documentElement;
-	const lst = root && firstChild(root, "p:sldMasterIdLst");
-	if (!lst) return;
-	const rels = dest.opc.relationshipsFor(presPart.partName);
-	const promote = new Set(masterPartNames);
-	const entries = getElements(lst, "p:sldMasterId");
-	const isPromoted = (entry) => {
-		const relId = attr(entry, "r:id");
-		return relId ? promote.has(rels.resolveTarget(relId)) : false;
-	};
-	const desired = [...entries.filter(isPromoted), ...entries.filter((e) => !isPromoted(e))];
-	if (desired.every((entry, i) => entry === entries[i])) return;
-	for (const entry of desired) lst.appendChild(entry);
-	presPart.markDirty();
-}
-/**
-* The next free id in the presentation-wide slide-master / slide-layout id space.
-*
-* `p:sldMasterId/@id` and every master's `p:sldLayoutId/@id` draw from ONE shared
-* id space (both ST_SlideMasterId/ST_SlideLayoutId, floor 2147483648) and must be
-* unique across the WHOLE presentation, not just within their own list. A duplicate
-* anywhere in this space makes PowerPoint report the file as corrupt on open
-* ("found a problem with content" / 0x80070570), even though LibreOffice silently
-* tolerates it — so an imported master AND each of its layouts must take an id past
-* the max of both the master-id list and every layout-id list. Recomputed per
-* allocation so ids appended earlier in the same import are counted.
-*/
-function nextMasterLayoutId(dest) {
-	let max = 2147483647;
-	const presPart = dest.presentationPart;
-	const root = presPart.dom.documentElement;
-	const masterLst = root && firstChild(root, "p:sldMasterIdLst");
-	if (masterLst) for (const entry of getElements(masterLst, "p:sldMasterId")) {
-		const id = intValue(attr(entry, "id"));
-		if (id !== null && id > max) max = id;
-	}
-	const presRels = dest.opc.relationshipsFor(presPart.partName);
-	for (const rel of presRels.byType(SLIDE_MASTER_REL)) {
-		const masterRoot = dest.opc.part(presRels.resolveTarget(rel.id))?.dom.documentElement;
-		const layoutLst = masterRoot && firstChild(masterRoot, "p:sldLayoutIdLst");
-		if (!layoutLst) continue;
-		for (const entry of getElements(layoutLst, "p:sldLayoutId")) {
-			const id = intValue(attr(entry, "id"));
-			if (id !== null && id > max) max = id;
-		}
-	}
-	return max + 1;
-}
-/** Empty a freshly-copied master's `p:sldLayoutIdLst`; copied layouts repopulate it. */
-function clearLayoutIdList(dest, masterPartName) {
-	const masterPart = dest.opc.part(masterPartName);
-	const root = masterPart?.dom.documentElement;
-	const lst = root && firstChild(root, "p:sldLayoutIdLst");
-	if (!masterPart || !lst) return;
-	removeChildrenByQName(lst, ["p:sldLayoutId"]);
-	masterPart.markDirty();
-}
-/**
-* Append a `p:sldLayoutId` entry for `layoutPartName` to `masterPartName`'s
-* `p:sldLayoutIdLst`, adding the master→layout relationship it points at. The
-* destination-side half of linking a copied layout into its copied master; the
-* caller resolves which master that is from the source-side rels.
-*/
-function addLayoutToMaster(dest, masterPartName, layoutPartName) {
-	const masterPart = dest.opc.part(masterPartName);
-	const root = masterPart?.dom.documentElement;
-	if (!masterPart || !root) return;
-	const relId = dest.opc.relationshipsFor(masterPartName).add(SLIDE_LAYOUT_REL, relativePartName(masterPartName, layoutPartName)).id;
-	const lst = getOrAddChild(root, "p:sldLayoutIdLst", [
-		"p:transition",
-		"p:timing",
-		"p:hf",
-		"p:txStyles",
-		"p:extLst"
-	]);
-	const entry = createElement(masterPart.dom, "p:sldLayoutId");
-	setAttr(entry, "id", String(nextMasterLayoutId(dest)));
-	setAttr(entry, "r:id", relId);
-	lst.appendChild(entry);
-	masterPart.markDirty();
-}
-//#endregion
-//#region src/read/api/ops/part-copy.ts
-const SLIDE_MASTER_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.presentationml.slideMaster+xml";
-const SLIDE_LAYOUT_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.presentationml.slideLayout+xml";
-/**
-* Copy `sourcePartName` (and, recursively, every internal part it references)
-* from `ctx.source` into `ctx.dest`, returning the new partname. Idempotent
-* per source package via the copy registry. Relationship ids are preserved so
-* the copied part body's `r:id`/`r:embed` references stay valid; targets are
-* rewritten to the freshly-allocated partnames. Notes relationships are
-* dropped. A copied `slideMaster` does not drag in all its sibling layouts —
-* each imported `slideLayout` wires itself into the master instead (see
-* {@link linkLayoutIntoMaster}).
+* Append each source `<a:tblStyle>` this deck does not already define, keyed by
+* `styleId` — the shared core of {@link copySourceTableStyles} (which offers only
+* the styles a restyled slide references) and {@link carryTableStyles} (which
+* offers the source's whole list). Destination-wins per id: a style this deck
+* already defines is left untouched, so a re-call adds nothing. Returns whether
+* anything was added.
 */
-function copyPart(ctx, sourcePartName) {
-	const existing = ctx.registry.get(sourcePartName);
-	if (existing) return existing;
-	const sourcePart = ctx.source.part(sourcePartName);
-	if (!sourcePart) throw new PackageReadError("package/part-missing", `importSlide: source package has no part ${sourcePartName}`);
-	const newPartName = ctx.dest.opc.reservePartNameLike(sourcePartName);
-	ctx.dest.opc.addPart(newPartName, sourcePart.contentType, sourcePart.bytes);
-	ctx.registry.set(sourcePartName, newPartName);
-	const isMaster = sourcePart.contentType === SLIDE_MASTER_CONTENT_TYPE;
-	const sourceRels = ctx.source.relationshipsFor(sourcePartName);
-	const targetRels = ctx.dest.opc.relationshipsFor(newPartName);
-	for (const rel of sourceRels) {
-		if (rel.type === "http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesSlide") continue;
-		if (isMaster && rel.type === "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideLayout") continue;
-		if (rel.targetMode === "External") {
-			targetRels.addWithId(rel.id, rel.type, rel.target, "External");
-			continue;
-		}
-		const newTargetPartName = copyPart(ctx, sourceRels.resolveTarget(rel.id));
-		targetRels.addWithId(rel.id, rel.type, relativePartName(newPartName, newTargetPartName));
+function addTableStyles(destList, styles) {
+	const present = new Set(getElements(destList, "a:tblStyle").map((st) => attr(st, "styleId")));
+	let added = false;
+	for (const style of styles) {
+		const id = attr(style, "styleId");
+		if (!id || present.has(id)) continue;
+		destList.appendChild(ownerDocumentOf(destList).importNode(style, true));
+		present.add(id);
+		added = true;
 	}
-	if (isMaster) {
-		clearLayoutIdList(ctx.dest, newPartName);
-		registerMaster(ctx.dest, newPartName);
+	return added;
+}
+/**
+* Copy the source deck's **whole** `tableStyles.xml` into this deck: every
+* `<a:tblStyle>` it defines, plus its `a:tblStyleLst@def` (the default table
+* style). Presentation-level, so a separate traversal from the master/layout copy
+* chain — and whole-deck, since `tableStyles.xml` does not record which style
+* belongs to which master. See `ImportSlideMastersOptions.tableStyles`.
+*
+* Styles union by `styleId` (destination-wins per id, via {@link addTableStyles}),
+* but `def` is **source-wins**: a caller asking for the source's table styling
+* wants its default too, and the destination's `def` is typically a generator stub
+* rather than a deliberate choice. Carrying the styles without the `def` would be
+* the worse half-measure — the standard default GUID is one most templates also
+* define, so a new table would silently resolve to the wrong style rather than
+* visibly to none. Idempotent: a re-call re-adds nothing and re-sets `def` to the
+* same value.
+*/
+function carryTableStyles(dest, sourceOpc) {
+	const sourceList = tableStyleList(sourceOpc);
+	if (!sourceList) return;
+	const destPart = ensureTableStylesPart(dest);
+	const destList = destPart.dom.documentElement;
+	if (!destList) return;
+	let changed = addTableStyles(destList, getElements(sourceList, "a:tblStyle"));
+	const sourceDef = attr(sourceList, "def");
+	if (sourceDef && attr(destList, "def") !== sourceDef) {
+		destList.setAttribute("def", sourceDef);
+		changed = true;
 	}
-	if (sourcePart.contentType === SLIDE_LAYOUT_CONTENT_TYPE) linkLayoutIntoMaster(ctx, sourceRels, newPartName);
-	return newPartName;
+	if (changed) destPart.markDirty();
+}
+/** The `a:tblStyleLst` root of a package's `tableStyles.xml`, or `null` when it has none. */
+function tableStyleList(opc) {
+	const part = opc.partsByContentType(TABLE_STYLES_CONTENT_TYPE)[0];
+	return part ? part.dom.documentElement : null;
 }
 /**
-* Wire a just-copied layout into its (already-copied) master. Resolves which
-* destination master that is by running the layout's *source* master rel through
-* the copy registry, then hands the destination-side wiring to
-* {@link addLayoutToMaster}. Called once per copied layout, so the master
-* accumulates exactly the imported layouts.
+* The deck's `tableStyles.xml` part, creating an empty one (and wiring its
+* `presentation.xml` relationship + content type) when the deck has none.
 */
-function linkLayoutIntoMaster(ctx, layoutSourceRels, layoutPartName) {
-	const masterRel = layoutSourceRels.byType(SLIDE_MASTER_REL)[0];
-	if (!masterRel) return;
-	const masterPartName = ctx.registry.get(layoutSourceRels.resolveTarget(masterRel.id));
-	if (!masterPartName) return;
-	addLayoutToMaster(ctx.dest, masterPartName, layoutPartName);
+function ensureTableStylesPart(dest) {
+	const existing = dest.opc.partsByContentType(TABLE_STYLES_CONTENT_TYPE)[0];
+	if (existing) return existing;
+	const partName = dest.opc.reservePartNameLike("/ppt/tableStyles.xml");
+	const xml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\r\n<a:tblStyleLst xmlns:a="${OOXML_NS.a}" def="${TABLE_STYLES_DEFAULT_GUID}"/>`;
+	const part = dest.opc.addPart(partName, TABLE_STYLES_CONTENT_TYPE, textEncoder$1.encode(xml));
+	dest.opc.relationshipsFor(dest.presentationPart.partName).add(TABLE_STYLES_REL, relativePartName(dest.presentationPart.partName, partName));
+	return part;
 }
 //#endregion
 //#region src/read/api/ops/carried-rels.ts
@@ -3401,8 +3870,9 @@ function linkLayoutIntoMaster(ctx, layoutSourceRels, layoutPartName) {
 * @param {string} destPartName - partname of the destination part the subtree is being placed in
 * @param {Relationships} destRels - relationships of that destination part
 * @param {Map<string, string>} relIdMap - per-call cache (source part + source id → new id) deduping references shared within one import
+* @param {OwnedScope} [owned] - ownership scope of the thing being carried, so the chart or diagram under a carried shape is copied for it rather than shared with an earlier copy
 */
-function rewriteCarriedRels(node, ctx, sourceRels, destPartName, destRels, relIdMap) {
+function rewriteCarriedRels(node, ctx, sourceRels, destPartName, destRels, relIdMap, owned) {
 	const elements = [];
 	collectElements(node, elements);
 	for (const el of elements) {
@@ -3417,7 +3887,7 @@ function rewriteCarriedRels(node, ctx, sourceRels, destPartName, destRels, relId
 				id: a.value
 			});
 		}
-		for (const { local, id } of refs) setAttr(el, `r:${local}`, carryRel(ctx, sourceRels, id, destPartName, destRels, relIdMap));
+		for (const { local, id } of refs) setAttr(el, `r:${local}`, carryRel(ctx, sourceRels, id, destPartName, destRels, relIdMap, owned));
 	}
 }
 /**
@@ -3428,16 +3898,20 @@ function rewriteCarriedRels(node, ctx, sourceRels, destPartName, destRels, relId
 * @param {string} destPartName - partname of the destination part
 * @param {Relationships} destRels - relationships of that destination part
 * @param {Map<string, string>} relIdMap - per-call dedupe cache
+* @param {OwnedScope} [owned] - ownership scope of the carried content, for the parts it owns
 * @return {string} the new relationship id on the destination part
 */
-function carryRel(ctx, sourceRels, id, destPartName, destRels, relIdMap) {
-	const key = `${sourceRels.sourcePartName}|${id}`;
-	const cached = relIdMap.get(key);
-	if (cached) return cached;
+function carryRel(ctx, sourceRels, id, destPartName, destRels, relIdMap, owned) {
 	const rel = sourceRels.get(id);
 	if (!rel) throw new InvalidOptionError("relationship/not-found", `Relationships of ${sourceRels.sourcePartName}: no relationship with id ${id}`);
-	const newId = rel.targetMode === "External" ? destRels.add(rel.type, rel.target, "External").id : destRels.add(rel.type, relativePartName(destPartName, copyPart(ctx, sourceRels.resolveTarget(id)))).id;
-	relIdMap.set(key, newId);
+	const ownsIt = owned !== void 0 && rel.targetMode !== "External" && !isSharedByPageCopies(rel.type);
+	const key = `${sourceRels.sourcePartName}|${id}`;
+	if (!ownsIt) {
+		const cached = relIdMap.get(key);
+		if (cached) return cached;
+	}
+	const newId = rel.targetMode === "External" ? destRels.add(rel.type, rel.target, "External").id : destRels.add(rel.type, relativePartName(destPartName, copyPart(ctx, sourceRels.resolveTarget(id), ownsIt ? owned : void 0))).id;
+	if (!ownsIt) relIdMap.set(key, newId);
 	return newId;
 }
 //#endregion
@@ -3590,7 +4064,7 @@ function mergeEmbeddedFontEntries(dest, entries) {
 	const presPart = dest.presentationPart;
 	const presRoot = presPart.dom.documentElement;
 	if (!presRoot) throw new PackageReadError("package/part-has-no-root", "presentation.xml has no document element to carry embedded fonts into");
-	const presRels = dest.opc.relationshipsFor(presPart.partName);
+	const presRels = presentationRels(dest);
 	const targetLst = getOrAddChild(presRoot, "p:embeddedFontLst", PRESENTATION_EMBEDDED_FONT_LST_SUCCESSORS);
 	const targetByTypeface = /* @__PURE__ */ new Map();
 	for (const entry of getElements(targetLst, "p:embeddedFont")) {
@@ -3637,21 +4111,16 @@ function mergeEmbeddedFontEntries(dest, entries) {
 * Pure with respect to the destination deck: it reads only the source package. It was a
 * private method on `Presentation` that used no instance state.
 */
-/** The `p:cSld/p:bg` element of a slide/layout/master root, or `null`. */
-function backgroundOf(root) {
-	const cSld = firstChild(root, "p:cSld");
-	return cSld ? firstChild(cSld, "p:bg") : null;
-}
 /**
 * The background the slide effectively inherits from its source subgraph: the layout's
 * `p:bg`, else the master's. Returns `null` when the slide carries its own `p:bg` (it stays
 * on the slide and is flattened directly) or when none exists.
 */
 function effectiveBackground(sourceOpc, slideRoot, layoutPartName, masterPartName) {
-	if (slideRoot && backgroundOf(slideRoot)) return null;
+	if (slideRoot && backgroundElementOf(slideRoot)) return null;
 	const layoutRoot = layoutPartName ? sourceOpc.part(layoutPartName)?.dom.documentElement ?? null : null;
 	const masterRoot = masterPartName ? sourceOpc.part(masterPartName)?.dom.documentElement ?? null : null;
-	return (layoutRoot && backgroundOf(layoutRoot)) ?? (masterRoot && backgroundOf(masterRoot)) ?? null;
+	return (layoutRoot && backgroundElementOf(layoutRoot)) ?? (masterRoot && backgroundElementOf(masterRoot)) ?? null;
 }
 /**
 * Gather the flatten context for a source slide: walk slide → layout → master → theme,
@@ -3819,6 +4288,7 @@ function importSlideRebind(dest, ctx, source, sourceSlide, carryGraphics) {
 	if (!slideRoot) throw new PackageReadError("package/part-has-no-root", `Imported slide ${newPartName} has no root element`);
 	const sourceRels = source.opc.relationshipsFor(sourceSlide.partName);
 	const targetRels = dest.opc.relationshipsFor(newPartName);
+	const owned = newOwnedScope();
 	for (const rel of sourceRels) {
 		if (rel.type === "http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesSlide") continue;
 		if (rel.type === "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideLayout") {
@@ -3829,10 +4299,10 @@ function importSlideRebind(dest, ctx, source, sourceSlide, carryGraphics) {
 			targetRels.addWithId(rel.id, rel.type, rel.target, "External");
 			continue;
 		}
-		const newTarget = copyPart(ctx, sourceRels.resolveTarget(rel.id));
+		const newTarget = copyPart(ctx, sourceRels.resolveTarget(rel.id), isSharedByPageCopies(rel.type) ? void 0 : owned);
 		targetRels.addWithId(rel.id, rel.type, relativePartName(newPartName, newTarget));
 	}
-	if (carryGraphics) carryMasterGraphics(dest, ctx, slideRoot, newPartName, sourceSlide.partName);
+	if (carryGraphics) carryMasterGraphics(dest, ctx, slideRoot, newPartName, sourceSlide.partName, owned);
 	return {
 		newPartName,
 		slideRoot,
@@ -3853,13 +4323,13 @@ function importSlideRebind(dest, ctx, source, sourceSlide, carryGraphics) {
 * @param {Element} slideRoot - root element of the new slide part (mutated in place)
 * @param {string} newPartName - partname of the new slide part
 * @param {string} slidePartName - partname of the source slide, for resolving its layout/master
+* @param {OwnedScope} owned - the page's ownership scope, so a decoration's own parts land in it
 */
-function carryMasterGraphics(dest, ctx, slideRoot, newPartName, slidePartName) {
+function carryMasterGraphics(dest, ctx, slideRoot, newPartName, slidePartName, owned) {
 	const sourceOpc = ctx.source;
 	const layoutPartName = resolveSingleRel(sourceOpc, slidePartName, SLIDE_LAYOUT_REL);
 	const masterPartName = layoutPartName ? resolveSingleRel(sourceOpc, layoutPartName, SLIDE_MASTER_REL) : null;
-	const cSld = firstChild(slideRoot, "p:cSld");
-	const spTree = cSld && firstChild(cSld, "p:spTree");
+	const spTree = spTreeOf(slideRoot);
 	if (!spTree) return;
 	const doc = ownerDocumentOf(slideRoot);
 	const slideRels = dest.opc.relationshipsFor(newPartName);
@@ -3872,7 +4342,7 @@ function carryMasterGraphics(dest, ctx, slideRoot, newPartName, slidePartName) {
 		const sourceRels = sourceOpc.relationshipsFor(partName);
 		for (const deco of decorations) {
 			const imported = doc.importNode(deco, true);
-			rewriteCarriedRels(imported, ctx, sourceRels, newPartName, slideRels, relIdMap);
+			rewriteCarriedRels(imported, ctx, sourceRels, newPartName, slideRels, relIdMap, owned);
 			spTree.insertBefore(imported, anchor);
 		}
 	}
@@ -3895,138 +4365,6 @@ function destinationLayoutPartName(dest) {
 	return masterRels.resolveTarget(layoutRel.id);
 }
 //#endregion
-//#region src/read/api/ops/notes-master.ts
-/**
-* Carrying speaker notes and the deck's single notes master across an import or an append.
-*
-* A `notesSlide` is not self-contained: it back-references the slide it annotates and forward-
-* references the deck's notes master. `CT_NotesMasterIdList` allows at most one master per
-* presentation, so a deck that already has one keeps it — the destination's notes styling wins —
-* and a source master is copied only into a deck that has none. That single rule is why both the
-* `Presentation`-to-`Presentation` path and the generator-XML path funnel through
-* `registerNotesMaster`: they differ only in how the *part* comes into being.
-*/
-const NOTES_MASTER_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.presentationml.notesMaster+xml";
-const THEME_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.theme+xml";
-const textEncoder$1 = new TextEncoder();
-/**
-* Carry the source slide's speaker notes onto the just-imported slide (the
-* `importNotes` option). The slide copy itself dropped the `notesSlide` rel, so
-* this copies the source `notesSlide` part into a fresh partname, wires a
-* `slide → notesSlide` rel on the new slide, and rebuilds the copied notesSlide's
-* own relationships:
-*
-* - its `slide` back-rel is repointed at the new slide (`newSlidePartName`) — the
-*   source slide is *not* copied (that would be circular);
-* - its `notesMaster` rel is resolved through {@link ensureNotesMaster}, which
-*   reuses this deck's notesMaster when it has one and copies the source's only
-*   when it has none (a deck may have at most one notesMaster);
-* - any other internal target (media, etc.) is copied via {@link copyPart}.
-*
-* No-op when the source slide has no notes. Content-type registration for the
-* copied parts is handled by `addPart`/{@link copyPart}.
-*/
-function carryNotes(dest, source, ctx, sourceSlidePartName, newSlidePartName) {
-	const sourceSlideRels = source.opc.relationshipsFor(sourceSlidePartName);
-	const notesRel = sourceSlideRels.byType(NOTES_SLIDE_REL)[0];
-	if (!notesRel) return;
-	const sourceNotesPartName = sourceSlideRels.resolveTarget(notesRel.id);
-	const sourceNotesPart = source.opc.part(sourceNotesPartName);
-	if (!sourceNotesPart) return;
-	const newNotesPartName = dest.opc.reservePartNameLike(sourceNotesPartName);
-	dest.opc.addPart(newNotesPartName, sourceNotesPart.contentType, sourceNotesPart.bytes);
-	dest.opc.relationshipsFor(newSlidePartName).add(NOTES_SLIDE_REL, relativePartName(newSlidePartName, newNotesPartName));
-	const notesSourceRels = source.opc.relationshipsFor(sourceNotesPartName);
-	const notesTargetRels = dest.opc.relationshipsFor(newNotesPartName);
-	for (const rel of notesSourceRels) {
-		if (rel.type === "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide") {
-			notesTargetRels.addWithId(rel.id, SLIDE_REL, relativePartName(newNotesPartName, newSlidePartName));
-			continue;
-		}
-		if (rel.type === "http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesMaster") {
-			const notesMaster = ensureNotesMaster(dest, ctx, notesSourceRels.resolveTarget(rel.id));
-			notesTargetRels.addWithId(rel.id, NOTES_MASTER_REL, relativePartName(newNotesPartName, notesMaster));
-			continue;
-		}
-		if (rel.targetMode === "External") {
-			notesTargetRels.addWithId(rel.id, rel.type, rel.target, "External");
-			continue;
-		}
-		const newTarget = copyPart(ctx, notesSourceRels.resolveTarget(rel.id));
-		notesTargetRels.addWithId(rel.id, rel.type, relativePartName(newNotesPartName, newTarget));
-	}
-}
-/**
-* Resolve the notesMaster an imported `notesSlide` should bind to, honouring the
-* single-notesMaster-per-presentation rule (`p:notesMasterIdLst` holds 0..1
-* `p:notesMasterId`). If this deck already has a notesMaster it is reused and the
-* source's is *not* copied (the destination's notes styling wins); otherwise the
-* source notesMaster (and, via {@link copyPart}, its theme) is copied and
-* registered in `presentation.xml`. Returns the destination notesMaster partname.
-*/
-function ensureNotesMaster(dest, ctx, sourceNotesMasterPartName) {
-	const presPart = dest.presentationPart;
-	const presRels = dest.opc.relationshipsFor(presPart.partName);
-	const existing = presRels.byType(NOTES_MASTER_REL)[0];
-	if (existing) return presRels.resolveTarget(existing.id);
-	return registerNotesMaster(dest, copyPart(ctx, sourceNotesMasterPartName));
-}
-/**
-* Wire an already-added notesMaster part into `presentation.xml`: a `notesMaster`
-* relationship plus the single `p:notesMasterId` entry that `CT_NotesMasterIdList`
-* allows. Returns the partname, so callers can use it as a rel target.
-*
-* Split out of {@link ensureNotesMaster} because the two ways a notesMaster arrives
-* — copied from another `Presentation`, or authored by a generator and injected by
-* {@link Presentation.appendSlides} — differ only in how the *part* is created, not in how it is
-* registered.
-*/
-function registerNotesMaster(dest, notesMasterPartName) {
-	const presPart = dest.presentationPart;
-	const relId = dest.opc.relationshipsFor(presPart.partName).add(NOTES_MASTER_REL, relativePartName(presPart.partName, notesMasterPartName)).id;
-	const root = presPart.dom.documentElement;
-	if (!root) throw new PackageReadError("package/part-has-no-root", "presentation.xml has no document element to register a notes master in");
-	const lst = getOrAddChild(root, "p:notesMasterIdLst", [
-		"p:handoutMasterIdLst",
-		"p:sldIdLst",
-		"p:sldSz",
-		"p:notesSz",
-		"p:embeddedFontLst",
-		"p:custShowLst",
-		"p:photoAlbum",
-		"p:custDataLst",
-		"p:kinsoku",
-		"p:defaultTextStyle",
-		"p:modifyVerifier",
-		"p:extLst"
-	]);
-	removeChildrenByQName(lst, ["p:notesMasterId"]);
-	const entry = createElement(presPart.dom, "p:notesMasterId");
-	setAttr(entry, "r:id", relId);
-	lst.appendChild(entry);
-	presPart.markDirty();
-	return notesMasterPartName;
-}
-/**
-* Resolve the notesMaster an *appended* slide's notes should bind to. Same
-* single-notesMaster rule as {@link ensureNotesMaster}: this deck's own wins when it
-* has one, so the destination's notes styling is preserved and `master.xml` is
-* discarded. Otherwise the generator's notes master is installed, together with the
-* theme its `.rels` requires (the normal write path emits that as `theme2.xml`).
-*/
-function ensureNotesMasterFromXml(dest, master) {
-	const presPart = dest.presentationPart;
-	const presRels = dest.opc.relationshipsFor(presPart.partName);
-	const existing = presRels.byType(NOTES_MASTER_REL)[0];
-	if (existing) return presRels.resolveTarget(existing.id);
-	const masterPartName = dest.opc.reservePartNameLike("/ppt/notesMasters/notesMaster1.xml");
-	dest.opc.addPart(masterPartName, NOTES_MASTER_CONTENT_TYPE, textEncoder$1.encode(master.xml));
-	const themePartName = dest.opc.reservePartNameLike("/ppt/theme/theme1.xml");
-	dest.opc.addPart(themePartName, THEME_CONTENT_TYPE, textEncoder$1.encode(master.themeXml));
-	dest.opc.relationshipsFor(masterPartName).add(THEME_REL, relativePartName(masterPartName, themePartName));
-	return registerNotesMaster(dest, masterPartName);
-}
-//#endregion
 //#region src/read/api/ops/prune.ts
 /**
 * Orphan pruning after a part stops being referenced.
@@ -4044,11 +4382,11 @@ function ensureNotesMasterFromXml(dest, master) {
 * orphan, even while momentarily unreferenced.
 */
 const SHARED_CHROME_CONTENT_TYPES = /* @__PURE__ */ new Set([
-	"application/vnd.openxmlformats-officedocument.presentationml.slideMaster+xml",
-	"application/vnd.openxmlformats-officedocument.presentationml.slideLayout+xml",
-	"application/vnd.openxmlformats-officedocument.theme+xml",
+	SLIDE_MASTER_CONTENT_TYPE,
+	SLIDE_LAYOUT_CONTENT_TYPE,
+	THEME_CONTENT_TYPE,
 	"application/vnd.openxmlformats-officedocument.themeOverride+xml",
-	"application/vnd.openxmlformats-officedocument.presentationml.notesMaster+xml",
+	NOTES_MASTER_CONTENT_TYPE,
 	"application/vnd.openxmlformats-officedocument.presentationml.handoutMaster+xml",
 	"application/vnd.openxmlformats-officedocument.presentationml.presProps+xml",
 	"application/vnd.openxmlformats-officedocument.presentationml.viewProps+xml",
@@ -4121,9 +4459,7 @@ function rescalePartGeometry(dest, rescaledParts, partName, transform) {
 	if (rescaledParts.has(partName)) return;
 	rescaledParts.add(partName);
 	const part = dest.opc.part(partName);
-	const root = part?.dom.documentElement;
-	const cSld = root && firstChild(root, "p:cSld");
-	const spTree = cSld && firstChild(cSld, "p:spTree");
+	const spTree = spTreeOf(part?.dom.documentElement);
 	if (!part || !spTree) return;
 	rescaleSpTree(spTree, transform);
 	part.markDirty();
@@ -4144,13 +4480,18 @@ function rescalePartGeometry(dest, rescaledParts, partName, transform) {
 */
 const HYPERLINK_REL = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink";
 const CHART_REL = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart";
+const CHARTEX_REL = "http://schemas.microsoft.com/office/2014/relationships/chartEx";
+const CHART_STYLE_REL = "http://schemas.microsoft.com/office/2011/relationships/chartStyle";
+const CHART_COLOR_STYLE_REL = "http://schemas.microsoft.com/office/2011/relationships/chartColorStyle";
 const PACKAGE_REL = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/package";
 const AUDIO_REL = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/audio";
 const VIDEO_REL = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/video";
 const MS_MEDIA_REL = "http://schemas.microsoft.com/office/2007/relationships/media";
 const SLIDE_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.presentationml.slide+xml";
-const NOTES_SLIDE_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.presentationml.notesSlide+xml";
 const CHART_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.drawingml.chart+xml";
+const CHARTEX_CONTENT_TYPE = "application/vnd.ms-office.chartex+xml";
+const CHART_STYLE_CONTENT_TYPE = "application/vnd.ms-office.chartstyle+xml";
+const CHART_COLOR_STYLE_CONTENT_TYPE = "application/vnd.ms-office.chartcolorstyle+xml";
 const XLSX_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
 /** Content type of the main part in an editable `.pptx` package. */
 const PRESENTATION_MAIN_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.presentationml.presentation.main+xml";
@@ -4380,12 +4721,17 @@ var Presentation = class Presentation {
 	* Duplicate the slide at `index` and insert the copy at `options.at` (deck
 	* order; `0` = first), defaulting to appending at the end when `at` is omitted
 	* or out of range. Returns the new slide. The new slide part copies the source
-	* bytes verbatim and shares the source's relationship targets (layout, images,
-	* …) by copying its `.rels`; a new presentation→slide relationship and a
-	* `p:sldId` entry are wired up. Marks the presentation part dirty.
+	* bytes verbatim and shares the source's deck-wide relationship targets
+	* (layout, images, media) by copying its `.rels`; a new presentation→slide
+	* relationship and a `p:sldId` entry are wired up. Marks the presentation part
+	* dirty.
 	*
-	* Note: relationships are copied as-is, so a source slide that owns a
-	* one-to-one part (e.g. a notes slide) would end up shared with the clone.
+	* What the source page *owns* is copied rather than shared: its notes slide,
+	* charts, SmartArt diagrams and OLE embeddings, each with the subtree under it
+	* (a chart's embedded workbook comes along; the image inside its user-shapes
+	* drawing stays shared). PowerPoint refuses to open a deck where two slides
+	* resolve to one chart or diagram, so this is not tidiness — see
+	* `page-owned.ts` for the rule and the evidence behind it.
 	*/
 	cloneSlide(index, options = {}) {
 		const source = this.slides[index];
@@ -4394,8 +4740,10 @@ var Presentation = class Presentation {
 		const sourcePart = source.part;
 		const newPartName = opc.reservePartNameLike(sourcePart.partName);
 		const newPart = opc.addPart(newPartName, sourcePart.contentType, sourcePart.bytes);
-		const sourceRels = opc.part(relsPartNameFor(sourcePart.partName));
-		if (sourceRels) opc.addPart(relsPartNameFor(newPartName), sourceRels.contentType, sourceRels.bytes);
+		const sourceRels = opc.relationshipsFor(sourcePart.partName);
+		const cloneRels = opc.relationshipsFor(newPartName);
+		for (const rel of sourceRels) cloneRels.addWithId(rel.id, rel.type, rel.target, rel.targetMode);
+		duplicateOwnedTargets(opc, sourcePart.partName, newPartName);
 		return this.#insertSlidePart(newPart, options.at);
 	}
 	/**
@@ -4417,7 +4765,7 @@ var Presentation = class Presentation {
 		const slideRels = this.opc.relationshipsFor(partName);
 		const formerTargets = [...slideRels].filter((rel) => rel.targetMode !== "External").map((rel) => slideRels.resolveTarget(rel.id));
 		const presPart = this.presentationPart;
-		const presRels = this.opc.relationshipsFor(presPart.partName);
+		const presRels = presentationRels(this);
 		const root = presPart.dom.documentElement;
 		const sldIdLst = root && firstChild(root, "p:sldIdLst");
 		if (sldIdLst) for (const sldId of getElements(sldIdLst, "p:sldId")) {
@@ -4448,7 +4796,10 @@ var Presentation = class Presentation {
 	* Only the layout(s) actually used by imported slides are copied; the imported
 	* master's `p:sldLayoutIdLst` is pruned to exactly those, mirroring how
 	* PowerPoint's "Reuse Slides" brings a slide across. Parts shared by repeated
-	* imports from the same source deck are copied once and reused.
+	* imports from the same source deck are copied once and reused — every part
+	* except the page itself. Importing the same source slide twice yields two
+	* independent copies over one shared layout/master/theme, which is what lets a
+	* deck show one page twice (verbatim, then edited).
 	*
 	* With `{ theme: 'preserve' }` the slide's source theme is instead *flattened*
 	* into the slide XML and the slide is bound to this deck's existing
@@ -4473,7 +4824,7 @@ var Presentation = class Presentation {
 		}
 		if (sizesDiffer && options.rescale && (!target || !incoming)) throw new InvalidOptionError("import/slide-size-unknown", "importSlide rescale requires both decks to declare a slide size (p:sldSz)");
 		const importCtx = this.#importContext(source.opc);
-		const newPartName = options.theme === "preserve" ? importSlidePreserve(this, importCtx, source, sourceSlide, options.carryMasterGraphics === true) : options.theme === "restyle" ? importSlideRestyle(this, importCtx, source, sourceSlide, options.carryMasterGraphics === true, options.remapLiterals === true) : copyPart(importCtx, sourceSlide.partName);
+		const newPartName = options.theme === "preserve" ? importSlidePreserve(this, importCtx, source, sourceSlide, options.carryMasterGraphics === true) : options.theme === "restyle" ? importSlideRestyle(this, importCtx, source, sourceSlide, options.carryMasterGraphics === true, options.remapLiterals === true) : copySlidePart(importCtx, sourceSlide.partName);
 		const newPart = this.opc.part(newPartName);
 		if (!newPart) throw new InternalError("import/part-went-missing", `Imported slide part went missing: ${newPartName}`);
 		if (sizesDiffer && options.rescale && target && incoming) rescaleImportedGeometry(this, this.#rescaledParts, newPartName, options.theme, incoming, target, options.rescale === true ? "fit" : options.rescale);
@@ -4483,6 +4834,140 @@ var Presentation = class Presentation {
 		return slide;
 	}
 	/**
+	* Import selected pages from one or more loaded source presentations as one
+	* batch. Each imported page lands at its `outputIndex` in the complete
+	* destination slide list after the batch, and the returned array is parallel
+	* to `requests` — `result[i]` is the page `requests[i]` asked for, whatever
+	* order the output positions were given in.
+	*
+	* Everything is checked before a single byte of this deck moves: every request
+	* names an existing source page, final output positions are unique, each source
+	* has this deck's slide size, and a read-only dry run of the copy proves every
+	* part it would reach is present. A batch therefore either applies in full or
+	* leaves this deck byte-identical, where a per-page loop of
+	* {@link importSlide} can leave a half-stitched deck behind.
+	*
+	* The batch also decides what a `slide → slide` link means: an internal link
+	* on a selected page must target another **selected** page (or one this deck
+	* already contains via an earlier import from that source), and is rewritten
+	* to the fresh partname — importing page 3 of 10 does not drag pages 1–2
+	* across as dependencies, and never strands the link. This mirrors
+	* `appendSlides`' `import/unresolved-slide-link`, which the write side already
+	* enforces for generator decks.
+	*
+	* One request is one output page, so naming the same source page in several
+	* requests is how you ask for several independent copies of it — the page part
+	* is the one thing an import never shares, exactly as in {@link importSlide}.
+	* Everything under it (layout, master, theme, media) is still copied once and
+	* shared. Where such a page is the target of a `slide → slide` link, the link
+	* resolves to one of its copies: pages duplicated together are copied in
+	* lockstep and link to their round-mates, and a link into a page requested only
+	* once always lands on that single copy.
+	*
+	* Speaker notes travel per request: `{ importNotes: true }` carries that page's
+	* `notesSlide` part across, wired to the new page and bound to a single
+	* `notesMaster` under the same 0..1 rule {@link importSlide} and
+	* {@link appendSlides} follow — the destination's own master wins when it has
+	* one. Notes are part of the up-front dry run too, so a batch that would fail
+	* carrying them is refused with the deck still byte-identical. A page named in
+	* several requests gets its own copy of its notes each time, as of everything
+	* else that page owns.
+	*
+	* Scope: pages come across under `'copy'` theme semantics (their own layout →
+	* master → theme subgraph, shared parts deduped via the copy registry).
+	* Embedded fonts are not carried, and sizes must match, since there is no batch
+	* spelling for `embedFonts` or `rescale`. Use {@link importSlide} when you need
+	* either of those.
+	*/
+	importSlides(requests) {
+		const resolved = requests.map((request, requestIndex) => {
+			if (!Number.isInteger(request.sourceIndex) || request.sourceIndex < 0) throw new InvalidOptionError("slide/index-out-of-range", `importSlides: sourceIndex must be a non-negative integer; received ${request.sourceIndex}`);
+			if (!Number.isInteger(request.outputIndex) || request.outputIndex < 0) throw new InvalidOptionError("import/output-index-out-of-range", `importSlides: outputIndex must be a non-negative integer; received ${request.outputIndex}`);
+			const sourceSlide = request.source.slides[request.sourceIndex];
+			if (!sourceSlide) throw new InvalidOptionError("slide/index-out-of-range", `importSlides: no slide at index ${request.sourceIndex} to import`);
+			return {
+				...request,
+				requestIndex,
+				sourceSlide
+			};
+		});
+		if (resolved.length === 0) return [];
+		if (!this.presentationPart.dom.documentElement) throw new PackageReadError("package/part-has-no-root", "presentation.xml has no document element to insert slides into");
+		const finalSlideCount = this.slides.length + resolved.length;
+		const selectedPages = /* @__PURE__ */ new Map();
+		const notesPages = /* @__PURE__ */ new Map();
+		for (const request of resolved) {
+			let pages = selectedPages.get(request.source.opc);
+			if (!pages) {
+				pages = /* @__PURE__ */ new Set();
+				selectedPages.set(request.source.opc, pages);
+			}
+			pages.add(request.sourceSlide.partName);
+			if (!request.importNotes) continue;
+			let withNotes = notesPages.get(request.source.opc);
+			if (!withNotes) {
+				withNotes = /* @__PURE__ */ new Set();
+				notesPages.set(request.source.opc, withNotes);
+			}
+			withNotes.add(request.sourceSlide.partName);
+		}
+		const target = this.slideSize;
+		const outputIndexes = /* @__PURE__ */ new Set();
+		for (const request of resolved) {
+			if (request.outputIndex >= finalSlideCount) throw new InvalidOptionError("import/output-index-out-of-range", `importSlides: outputIndex ${request.outputIndex} is outside the final slide list of ${finalSlideCount} slides`);
+			if (outputIndexes.has(request.outputIndex)) throw new InvalidOptionError("import/output-index-conflict", `importSlides: outputIndex ${request.outputIndex} is requested more than once`);
+			outputIndexes.add(request.outputIndex);
+			const incoming = request.source.slideSize;
+			if (!target || !incoming || target.widthEmu !== incoming.widthEmu || target.heightEmu !== incoming.heightEmu) {
+				const fmt = (size) => size ? `${size.widthEmu}×${size.heightEmu} EMU` : "unknown";
+				throw new InvalidOptionError("import/slide-size-mismatch", `importSlides requires equal slide sizes; target is ${fmt(target)}, source is ${fmt(incoming)}`);
+			}
+		}
+		const copyMaster = this.opc.relationshipsFor(this.presentationPart.partName).byType(NOTES_MASTER_REL).length === 0;
+		for (const [sourceOpc, pages] of selectedPages) checkSelectionCopyable(sourceOpc, this.#importContext(sourceOpc).registry, pages, {
+			pages: notesPages.get(sourceOpc) ?? /* @__PURE__ */ new Set(),
+			copyMaster
+		});
+		const destinationsBySource = /* @__PURE__ */ new Map();
+		const planned = resolved.map((request) => {
+			let destinations = destinationsBySource.get(request.source.opc);
+			if (!destinations) {
+				destinations = /* @__PURE__ */ new Map();
+				destinationsBySource.set(request.source.opc, destinations);
+			}
+			const sourcePart = request.sourceSlide.part;
+			const newPartName = this.opc.reservePartNameLike(request.sourceSlide.partName);
+			const destPart = this.opc.addPart(newPartName, sourcePart.contentType, sourcePart.bytes);
+			const reserved = destinations.get(request.sourceSlide.partName);
+			if (reserved) reserved.push(newPartName);
+			else destinations.set(request.sourceSlide.partName, [newPartName]);
+			return {
+				...request,
+				destPart
+			};
+		});
+		for (const [sourceOpc, destinations] of destinationsBySource) {
+			const base = this.#importContext(sourceOpc);
+			const rounds = Math.max(...[...destinations.values()].map((reserved) => reserved.length));
+			for (let round = 0; round < rounds; round++) {
+				const plan = /* @__PURE__ */ new Map();
+				for (const [sourcePartName, reserved] of destinations) plan.set(sourcePartName, reserved[round] ?? reserved[0]);
+				const ctx = {
+					...base,
+					selection: { destinations: plan }
+				};
+				for (const [sourcePartName, reserved] of destinations) if (round < reserved.length) copyPart(ctx, sourcePartName);
+			}
+		}
+		for (const request of planned) {
+			if (!request.importNotes) continue;
+			carryNotes(this, request.source, this.#importContext(request.source.opc), request.sourceSlide.partName, request.destPart.partName);
+		}
+		const added = [];
+		for (const request of [...planned].sort((left, right) => left.outputIndex - right.outputIndex)) added[request.requestIndex] = this.#insertSlidePart(request.destPart, request.outputIndex);
+		return added;
+	}
+	/**
 	* Graft slide master(s) from another open package into this one and return what
 	* was copied. Unlike {@link importSlide} — which brings a master across only as
 	* the dependency of an imported *slide* and prunes it to the one layout that
@@ -4592,7 +5077,10 @@ var Presentation = class Presentation {
 	*
 	* Charts and internal slide-to-slide hyperlinks are carried across: chart parts
 	* (chart XML + `.rels` + embedded workbook) are injected under fresh names, and a
-	* `slide:N` link is repointed at the Nth appended slide's new partname.
+	* `slide:N` link is repointed at the Nth appended slide's new partname. A chartEx
+	* (Office 2016 — waterfall, funnel, treemap, ...) chart carries too, as its own
+	* `chartEx{N}.xml` part behind the MS chartEx rel, with the style and color-style
+	* sidecars PowerPoint requires alongside it.
 	*
 	* The generator's presentation-level embedded fonts (`pptx.embedFont`) are also
 	* carried into this deck and merged into its `p:embeddedFontLst`, de-duped by
@@ -4688,13 +5176,23 @@ var Presentation = class Presentation {
 				for (const h of slide.notes.hyperlinks) notesRels.addWithId(`rId${h.rId}`, HYPERLINK_REL, h.target, "External");
 			}
 			for (const c of slide.charts) {
-				const chartPartName = this.opc.reservePartNameLike("/ppt/charts/chart1.xml");
-				this.opc.addPart(chartPartName, CHART_CONTENT_TYPE, textEncoder.encode(c.chartXml));
+				const isChartEx = c.chartEx !== void 0;
+				const chartPartName = this.opc.reservePartNameLike(isChartEx ? "/ppt/charts/chartEx1.xml" : "/ppt/charts/chart1.xml");
+				this.opc.addPart(chartPartName, isChartEx ? CHARTEX_CONTENT_TYPE : CHART_CONTENT_TYPE, textEncoder.encode(c.chartXml));
 				const embeddingPartName = this.opc.reservePartNameLike("/ppt/embeddings/Microsoft_Excel_Worksheet1.xlsx");
 				this.opc.contentTypes.ensureDefault("xlsx", XLSX_CONTENT_TYPE);
 				this.opc.addPart(embeddingPartName, XLSX_CONTENT_TYPE, c.embeddingBytes);
-				this.opc.relationshipsFor(chartPartName).addWithId("rId1", PACKAGE_REL, relativePartName(chartPartName, embeddingPartName));
-				rels.addWithId(`rId${c.rId}`, CHART_REL, relativePartName(partName, chartPartName));
+				const chartRels = this.opc.relationshipsFor(chartPartName);
+				chartRels.addWithId("rId1", PACKAGE_REL, relativePartName(chartPartName, embeddingPartName));
+				if (c.chartEx) {
+					const colorsPartName = this.opc.reservePartNameLike("/ppt/charts/colors1.xml");
+					this.opc.addPart(colorsPartName, CHART_COLOR_STYLE_CONTENT_TYPE, textEncoder.encode(c.chartEx.colorsXml));
+					chartRels.addWithId("rId2", CHART_COLOR_STYLE_REL, relativePartName(chartPartName, colorsPartName));
+					const stylePartName = this.opc.reservePartNameLike("/ppt/charts/style1.xml");
+					this.opc.addPart(stylePartName, CHART_STYLE_CONTENT_TYPE, textEncoder.encode(c.chartEx.styleXml));
+					chartRels.addWithId("rId3", CHART_STYLE_REL, relativePartName(chartPartName, stylePartName));
+				}
+				rels.addWithId(`rId${c.rId}`, isChartEx ? CHARTEX_REL : CHART_REL, relativePartName(partName, chartPartName));
 			}
 			for (const link of slide.slideLinks) {
 				const targetPartName = partBySourceNumber.get(link.sourceSlideNumber);
@@ -4777,7 +5275,7 @@ var Presentation = class Presentation {
 		const result = [];
 		for (const shapeEl of sourceElements) {
 			const imported = targetDoc.importNode(shapeEl, true);
-			rewriteCarriedRels(imported, importCtx, sourceRels, target.partName, targetRels, relIdMap);
+			rewriteCarriedRels(imported, importCtx, sourceRels, target.partName, targetRels, relIdMap, newOwnedScope());
 			if (ctx) {
 				const holder = createElement(targetDoc, "p:spTree");
 				holder.appendChild(imported);
@@ -4839,7 +5337,13 @@ var Presentation = class Presentation {
 	*/
 	#insertSlidePart(newPart, at) {
 		const presPart = this.presentationPart;
-		const relId = this.opc.relationshipsFor(presPart.partName).add(SLIDE_REL, relativePartName(presPart.partName, newPart.partName)).id;
+		const presRels = presentationRels(this);
+		for (const rel of presRels) {
+			if (rel.type !== "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide" || rel.targetMode === "External") continue;
+			if (presRels.resolveTarget(rel.id) !== newPart.partName) continue;
+			throw new InternalError("slide/part-already-in-deck", `Slide part ${newPart.partName} is already in this deck's slide list; a second p:sldId entry for it would make the package unopenable`);
+		}
+		const relId = presRels.add(SLIDE_REL, relativePartName(presPart.partName, newPart.partName)).id;
 		const root = presPart.dom.documentElement;
 		if (!root) throw new PackageReadError("package/part-has-no-root", "presentation.xml has no document element to append a slide to");
 		const sldIdLst = getOrAddChild(root, "p:sldIdLst", PRESENTATION_SLD_ID_LST_SUCCESSORS);
@@ -4873,4 +5377,4 @@ var Presentation = class Presentation {
 //#endregion
 export { Placeholder as a, Theme as c, NotesSlide as d, OpcPackage as f, ContentTypes as h, Slide as i, readTagsForPart as l, Part as m, readCoreProperties as n, SlideLayout as o, Relationships as p, readCustomProperties as r, SlideMaster as s, Presentation as t, NotesPlaceholder as u };
 
-//# sourceMappingURL=presentation-CxnUVhK9.js.map
+//# sourceMappingURL=presentation-3rAKKRfm.js.map