@shbernal/ts-pptx 3.1.0 → 3.2.0

package/dist/{shapes-DMThLsZN.js → shapes-DoJBPrwN.js}

@@ -2632,28 +2632,29 @@ function setTextBodyText(txBody, value) {
 *
 * It owns everything a shape has regardless of kind: non-visual identity (id / name / hidden /
 * description / decorative), geometry through the subclass-supplied `a:xfrm`, and the `p:spPr`
-* surface — fill, line, gradient, effects — resolved against the slide's theme. Kind-specific
+* surface — fill, line, gradient, effects — resolved against the host's theme. Kind-specific
 * reads live on the subclasses in the sibling modules.
 *
-* A proxy holds a back-reference to its owning `Slide` so it can resolve relationships and theme
-* colours, and so a mutation can mark the slide part dirty.
+* A proxy holds a back-reference to its owning {@link ShapeHost} — a `Slide`, a `SlideLayout` or a
+* `SlideMaster` — so it can resolve relationships and theme colours, and so a mutation can mark
+* that host's part dirty.
 */
 const ADEC_NS = "http://schemas.microsoft.com/office/drawing/2017/decorative";
-/** Common base for every shape in a slide's shape tree. */
+/** Common base for every shape in a shape tree — a slide's, a layout's, or a master's. */
 var Shape = class {
 	element;
-	slide;
-	constructor(element, slide) {
+	host;
+	constructor(element, host) {
 		this.element = element;
-		this.slide = slide;
+		this.host = host;
 	}
 	/**
-	* Mark the owning slide part dirty so `save()` reserializes it. Public
+	* Mark the owning host's part dirty so `save()` reserializes it. Public
 	* because {@link element_} hands out the live DOM node: the hatch and the
 	* obligation that comes with it belong on the same object.
 	*/
 	markDirty() {
-		this.slide.part.markDirty();
+		this.host.part.markDirty();
 	}
 	/** Drawing id (`p:cNvPr/@id`), or `null` if absent. */
 	get id() {
@@ -2777,7 +2778,7 @@ var Shape = class {
 		};
 		const ph = this.placeholder;
 		if (!ph) return null;
-		return resolveInheritedFrame(ph, this.slide.themeContext());
+		return resolveInheritedFrame(ph, this.host.themeContext());
 	}
 	/**
 	* Clockwise rotation in degrees (`a:xfrm/@rot` ÷ 60000), or `null` when the
@@ -3070,7 +3071,7 @@ var Shape = class {
 	* when the gradient carries no stop list.
 	*/
 	#gradientStopsIn(container) {
-		return readGradientStops(container, this.slide.themeContext());
+		return readGradientStops(container, this.host.themeContext());
 	}
 	/**
 	* Read the full `a:gradFill` (stops + linear angle / path shape) from a
@@ -3078,7 +3079,7 @@ var Shape = class {
 	* container has no gradient.
 	*/
 	#gradientFillIn(container) {
-		return readGradientFill(container, this.slide.themeContext());
+		return readGradientFill(container, this.host.themeContext());
 	}
 	/**
 	* The shape's gradient fill with its geometry (`spPr/a:gradFill`), or `null`
@@ -3129,7 +3130,7 @@ var Shape = class {
 	}
 	/**
 	* The shape's outer drop shadow (`spPr/a:effectLst/a:outerShdw`), resolved
-	* against the slide theme, or `null` when the shape has no outer shadow. The
+	* against the host's theme, or `null` when the shape has no outer shadow. The
 	* soft brand shadows the eye reads as "floating" panels live here and are
 	* invisible in geometry/fill alone.
 	*/
@@ -3139,7 +3140,7 @@ var Shape = class {
 	}
 	/**
 	* The shape's **inner** shadow (`spPr/a:effectLst/a:innerShdw`), resolved against
-	* the slide theme, or `null` when the shape has no inner shadow. The inset
+	* the host's theme, or `null` when the shape has no inner shadow. The inset
 	* counterpart of {@link shadow}: the write-side `shadow: { type: 'inner' }`
 	* emits it, and it is invisible in geometry/fill alone.
 	*/
@@ -3148,7 +3149,7 @@ var Shape = class {
 		return shdw ? this.#readShadow(shdw) : null;
 	}
 	/**
-	* The shape's glow halo (`spPr/a:effectLst/a:glow`), resolved against the slide
+	* The shape's glow halo (`spPr/a:effectLst/a:glow`), resolved against the host's
 	* theme, or `null` when the shape has no glow. Same element the write-side text
 	* glow emits, so its {@link Glow.radiusPt} and colour round-trip.
 	*/
@@ -3197,13 +3198,13 @@ var Shape = class {
 	/**
 	* The shape's pattern (hatch) fill (`spPr/a:pattFill`), or `null` when the fill
 	* is not a pattern. Surfaces the {@link PatternFill.preset} name and both
-	* colours resolved against the slide theme — the pattern counterpart of
+	* colours resolved against the host's theme — the pattern counterpart of
 	* {@link resolvedFill}, which reports `null` for a non-solid fill and so drops a
 	* hatched surface entirely.
 	*/
 	get patternFill() {
 		const props = this.properties();
-		return props ? readPatternFill(props, this.slide.themeContext()) : null;
+		return props ? readPatternFill(props, this.host.themeContext()) : null;
 	}
 	/**
 	* The shape's picture (image) fill (`spPr/a:blipFill`), or `null` when the fill
@@ -3216,7 +3217,7 @@ var Shape = class {
 	*/
 	get pictureFill() {
 		const props = this.properties();
-		return props ? readPictureFill(props, this.slide.relationships) : null;
+		return props ? readPictureFill(props, this.host.relationships) : null;
 	}
 	/** A named child of the shape's effect list (`spPr/a:effectLst/<qname>`), or `null`. */
 	#effect(qname) {
@@ -3226,7 +3227,7 @@ var Shape = class {
 	}
 	/** Resolve `colorEl` against the theme and stamp `color`/`colorToken`/`alpha` onto an effect result. */
 	#applyEffectColor(out, colorEl) {
-		const resolved = resolveColorElement(colorEl, this.slide.themeContext());
+		const resolved = resolveColorElement(colorEl, this.host.themeContext());
 		if (resolved) {
 			out.color = resolved.effectiveHex;
 			if (resolved.alpha !== void 0) out.alpha = resolved.alpha;
@@ -3246,7 +3247,7 @@ var Shape = class {
 		return out;
 	}
 	/**
-	* The shape's solid fill resolved against the slide's theme
+	* The shape's solid fill resolved against the host's theme
 	* ({@link Slide.themeContext}) to a literal hex — the resolved counterpart of
 	* {@link fillColor}/{@link fillSchemeColor}, which report the raw reference.
 	* `null` when the shape has no `a:solidFill` (a gradient/none/inherited fill)
@@ -3260,13 +3261,13 @@ var Shape = class {
 	* matrix), resolved the same way the `theme: 'preserve'` flatten path bakes it.
 	*/
 	get resolvedFill() {
-		const ctx = this.slide.themeContext();
+		const ctx = this.host.themeContext();
 		const props = this.properties();
 		if (props && FILL_CHOICES.some((q) => firstChild(props, q))) return resolveSolidFillColor(props, ctx);
 		return resolveStyleFillColor(this.element, ctx);
 	}
 	/**
-	* The shape's line/border solid fill resolved against the slide's theme to a
+	* The shape's line/border solid fill resolved against the host's theme to a
 	* literal hex — the resolved counterpart of {@link lineColor}/{@link lineSchemeColor}.
 	* `null` when the shape has no `a:ln/a:solidFill` or it cannot be made literal.
 	* Like {@link resolvedFill}, the result carries `effectiveHex` (the base colour
@@ -3276,7 +3277,7 @@ var Shape = class {
 	* the shape inherits from its `p:style` `a:lnRef` (the theme style matrix).
 	*/
 	get resolvedLine() {
-		const ctx = this.slide.themeContext();
+		const ctx = this.host.themeContext();
 		const ln = this.#line();
 		return ln ? resolveSolidFillColor(ln, ctx) : resolveStyleLineColor(this.element, ctx);
 	}
@@ -3343,8 +3344,8 @@ var Shape = class {
 		return null;
 	}
 	/**
-	* Remove this shape from its parent (the slide's shape tree, or an enclosing
-	* group) and mark the owning slide part dirty. The proxy is dead afterwards.
+	* Remove this shape from its parent (the host's shape tree, or an enclosing
+	* group) and mark the owning host's part dirty. The proxy is dead afterwards.
 	*/
 	delete() {
 		const parent = this.element.parentNode;
@@ -3378,14 +3379,14 @@ var AutoShape = class extends Shape {
 	get textFrame() {
 		const txBody = firstChild(this.element, "p:txBody");
 		if (!txBody) return null;
-		const flatten = this.slide.themeContext();
+		const flatten = this.host.themeContext();
 		const ph = this.placeholder;
 		const fontRef = resolveStyleFontRef(this.element, flatten);
-		return new TextFrame(txBody, this.slide.part, flatten, {
+		return new TextFrame(txBody, this.host.part, flatten, {
 			ph,
 			flatten,
 			fontRef
-		}, this.slide.relationships);
+		}, this.host.relationships);
 	}
 	/**
 	* This shape's placeholder identity (`p:ph` `type`/`idx`), or `null` when it is
@@ -3486,7 +3487,7 @@ var Picture = class extends Shape {
 		return blip ? attr(blip, "r:embed") : null;
 	}
 	/**
-	* Repoint the blip at a relationship id already present in the slide's
+	* Repoint the blip at a relationship id already present in the owning part's
 	* relationships, without minting a new media part. The caller owns ensuring
 	* the id exists and targets an image; use {@link setImage} to add fresh bytes.
 	*/
@@ -3494,10 +3495,10 @@ var Picture = class extends Shape {
 		setAttr(this.#getOrAddBlip(), "r:embed", value);
 		this.markDirty();
 	}
-	/** Absolute partname of the embedded image, resolved via the slide's relationships, or `null`. */
+	/** Absolute partname of the embedded image, resolved via the owning part's relationships, or `null`. */
 	get imagePartName() {
 		const relId = this.imageRelId;
-		return relId ? this.slide.relationships.resolveTarget(relId) : null;
+		return relId ? this.host.relationships.resolveTarget(relId) : null;
 	}
 	/**
 	* Relationship id of the embedded **vector (SVG)** image, read from the
@@ -3511,10 +3512,10 @@ var Picture = class extends Shape {
 		const svg = this.#svgBlip();
 		return svg ? attr(svg, "r:embed") : null;
 	}
-	/** Absolute partname of the embedded SVG image, resolved via the slide's relationships, or `null`. */
+	/** Absolute partname of the embedded SVG image, resolved via the owning part's relationships, or `null`. */
 	get svgPartName() {
 		const relId = this.svgRelId;
-		return relId ? this.slide.relationships.resolveTarget(relId) : null;
+		return relId ? this.host.relationships.resolveTarget(relId) : null;
 	}
 	/**
 	* Which drawable media this picture carries:
@@ -3638,7 +3639,7 @@ var Picture = class extends Shape {
 	/**
 	* Replace this picture's image with new bytes. Mints a fresh media part under
 	* `/ppt/media/`, registers its content type, wires an `image` relationship
-	* from the owning slide, and repoints the blip's `@r:embed` at it.
+	* from the owning part, and repoints the blip's `@r:embed` at it.
 	*
 	* Copy-on-write: the previous media part is never mutated or removed, so any
 	* other picture sharing it (common after `importSlide`/dedup) is unaffected;
@@ -3665,10 +3666,10 @@ var Picture = class extends Shape {
 		const { contentType } = options;
 		if (!contentType) throw new InvalidOptionError("image/missing-content-type", "setImage requires a contentType (e.g. \"image/png\")");
 		const extension = (options.extension ?? extFromContentType(contentType)).toLowerCase().replace(/^\./, "");
-		const opc = this.slide.presentation.opc;
+		const opc = this.host.opc;
 		const mediaPartName = opc.reserveMediaPartName(extension);
 		opc.addPart(mediaPartName, contentType, bytes);
-		const relId = this.slide.relationships.add(IMAGE_REL, relativePartName(this.slide.partName, mediaPartName)).id;
+		const relId = this.host.relationships.add(IMAGE_REL, relativePartName(this.host.partName, mediaPartName)).id;
 		setAttr(this.#getOrAddBlip(), "r:embed", relId);
 		if (options.fit) this.#applyFit(options.fit, bytes);
 		this.markDirty();
@@ -3741,7 +3742,7 @@ var Connector = class extends Shape {
 	get endConnection() {
 		return this.#connection("a:endCxn");
 	}
-	/** Decode one `a:stCxn` / `a:endCxn` binding, resolving its `@id` to a slide shape. */
+	/** Decode one `a:stCxn` / `a:endCxn` binding, resolving its `@id` to a shape in the same tree. */
 	#connection(qname) {
 		const nvCxnSpPr = firstChild(this.element, "p:nvCxnSpPr");
 		const cNvCxnSpPr = nvCxnSpPr && firstChild(nvCxnSpPr, "p:cNvCxnSpPr");
@@ -3753,7 +3754,7 @@ var Connector = class extends Shape {
 		return {
 			shapeId,
 			siteIndex,
-			boundShape: this.slide.shapeByIdDeep(shapeId) ?? null
+			boundShape: this.host.shapeByIdDeep(shapeId) ?? null
 		};
 	}
 };
@@ -5713,7 +5714,7 @@ var GraphicFrame = class extends Shape {
 		const graphicData = this.#graphicData();
 		const tbl = graphicData && firstChild(graphicData, "a:tbl");
 		if (!tbl) return null;
-		return new Table(tbl, this.slide.part, this.slide.themeContext(), this.slide.presentation.opc, this.slide.relationships);
+		return new Table(tbl, this.host.part, this.host.themeContext(), this.host.opc, this.host.relationships);
 	}
 	/** The hosted chart, or `null` when this frame is not a chart or its part is missing. */
 	get chart() {
@@ -5722,8 +5723,8 @@ var GraphicFrame = class extends Shape {
 		const chartRef = graphicData && firstChild(graphicData, "c:chart");
 		const relId = chartRef && attr(chartRef, "r:id");
 		if (!relId) return null;
-		const partName = this.slide.relationships.resolveTarget(relId);
-		const part = this.slide.presentation.opc.part(partName);
+		const partName = this.host.relationships.resolveTarget(relId);
+		const part = this.host.opc.part(partName);
 		return part ? new Chart(part) : null;
 	}
 	/**
@@ -5737,8 +5738,8 @@ var GraphicFrame = class extends Shape {
 		const chartRef = graphicData && firstChild(graphicData, "cx:chart");
 		const relId = chartRef && attr(chartRef, "r:id");
 		if (!relId) return null;
-		const partName = this.slide.relationships.resolveTarget(relId);
-		const part = this.slide.presentation.opc.part(partName);
+		const partName = this.host.relationships.resolveTarget(relId);
+		const part = this.host.opc.part(partName);
 		return part ? new ChartEx(part) : null;
 	}
 	#graphicData() {
@@ -5753,13 +5754,14 @@ var GraphicFrame = class extends Shape {
 //#endregion
 //#region src/read/api/shapes.ts
 /**
-* Read-model proxies for the shapes on a slide.
+* Read-model proxies for the shapes in a `p:spTree`.
 *
 * The `p:spTree` holds five shape kinds; each wraps its element and exposes
 * non-visual identity (id/name), geometry (left/top/width/height in EMU), and
-* kind-specific reads. Proxies hold a back-reference to the owning `Slide` so
-* pictures can resolve their image relationship and so future edits can mark
-* the slide part dirty.
+* kind-specific reads. Proxies hold a back-reference to the owning
+* {@link ShapeHost} — the slide, layout, or master whose part carries the tree —
+* so pictures can resolve their image relationship and so edits can mark that
+* part dirty.
 *
 * This module is the entry point for that model: the `Shape` base and the four leaf kinds live in
 * `./shapes/`, and only the dispatch that turns an element into a proxy — plus `GroupShape`, which
@@ -5827,7 +5829,7 @@ var GroupShape = class extends Shape {
 	}
 	/** The shapes nested directly inside this group, in document order. */
 	get shapes() {
-		return buildShapes(this.element, this.slide);
+		return buildShapes(this.element, this.host);
 	}
 };
 /** Narrow a shape to an {@link AutoShape} (`p:sp` — auto shape, text box, or placeholder). */
@@ -5855,14 +5857,14 @@ function isGroupShape(shape) {
 * `p:grpSp`) in its concrete `Shape` proxy, or `null` if it is not a shape kind
 * (e.g. `p:nvGrpSpPr`, `p:grpSpPr`, `p:extLst`).
 */
-function wrapShapeElement(element, slide) {
+function wrapShapeElement(element, host) {
 	if (element.namespaceURI !== OOXML_NS.p) return null;
 	switch (element.localName) {
-		case "sp": return new AutoShape(element, slide);
-		case "pic": return new Picture(element, slide);
-		case "cxnSp": return new Connector(element, slide);
-		case "graphicFrame": return new GraphicFrame(element, slide);
-		case "grpSp": return new GroupShape(element, slide);
+		case "sp": return new AutoShape(element, host);
+		case "pic": return new Picture(element, host);
+		case "cxnSp": return new Connector(element, host);
+		case "graphicFrame": return new GraphicFrame(element, host);
+		case "grpSp": return new GroupShape(element, host);
 		default: return null;
 	}
 }
@@ -5874,11 +5876,11 @@ function wrapShapeElement(element, slide) {
 * chartEx chart's `p:graphicFrame`, a zoom frame, an inline-math shape. Returns
 * the wrapped inner shape, or `null` when neither branch holds one.
 */
-function unwrapAlternateContent(altContent, slide) {
+function unwrapAlternateContent(altContent, host) {
 	const branches = [...getElements(altContent, "mc:Choice"), ...getElements(altContent, "mc:Fallback")];
 	for (const branch of branches) for (let node = branch.firstChild; node; node = node.nextSibling) {
 		if (node.nodeType !== 1) continue;
-		const shape = wrapShapeElement(node, slide);
+		const shape = wrapShapeElement(node, host);
 		if (shape) return shape;
 	}
 	return null;
@@ -5889,22 +5891,38 @@ function unwrapAlternateContent(altContent, slide) {
 * `mc:AlternateContent` wrapper (chartEx charts, zoom frames, inline math) is
 * unwrapped to the shape inside its preferred branch.
 */
-function buildShapes(parent, slide) {
+function buildShapes(parent, host) {
 	const shapes = [];
 	for (let node = parent.firstChild; node; node = node.nextSibling) {
 		if (node.nodeType !== 1) continue;
 		const element = node;
 		if (element.namespaceURI === OOXML_NS.mc && element.localName === "AlternateContent") {
-			const unwrapped = unwrapAlternateContent(element, slide);
+			const unwrapped = unwrapAlternateContent(element, host);
 			if (unwrapped) shapes.push(unwrapped);
 			continue;
 		}
-		const shape = wrapShapeElement(element, slide);
+		const shape = wrapShapeElement(element, host);
 		if (shape) shapes.push(shape);
 	}
 	return shapes;
 }
+/**
+* The first shape in `shapes` with the given drawing id (`p:cNvPr/@id`), walked
+* pre-order so a group is visited before its children. Backs
+* {@link ShapeHost.shapeByIdDeep} on all three hosts — drawing ids are unique
+* within a part, so the first match is the only match and the walk order just
+* fixes a deterministic one.
+*/
+function findShapeByIdDeep(shapes, id) {
+	for (const shape of shapes) {
+		if (shape.id === id) return shape;
+		if (shape instanceof GroupShape) {
+			const found = findShapeByIdDeep(shape.shapes, id);
+			if (found) return found;
+		}
+	}
+}
 //#endregion
-export { resolveColor as $, resolveColorElement as A, getOrAddChild as At, placeholderInheritedColor as B, Paragraph as C, childElements as Ct, readPatternFill as D, firstChild as Dt, spPrXfrmEmu as E, escapeXmlAttribute as Et, resolveSlideThemeParts as F, removeAttr as Ft, slideDefinesColor as G, placeholderInheritedRunProps as H, applyColorTransforms as I, removeChildrenByQName as It, fmtEntry as J, slideDefinesProp as K, LST_STYLE_LEVELS as L, replaceInParent as Lt, resolveMasterColorContext as M, intValue as Mt, resolveNotesColorContext as N, ownerDocumentOf as Nt, readPictureFill as O, firstChildElement as Ot, resolveSlideColorContext as P, parseXml as Pt, parseClrScheme as Q, RUN_PROP_NAMES as R, serializeXml as Rt, Shape as S, boolValue as St, TextFrame as T, descendantsByTag as Tt, placeholderInheritedXfrm as U, placeholderInheritedListStyles as V, placeholderOf as W, isA as X, intAttr as Y, parseClrMap as Z, ChartAxis as _, resolveRelativePartName as _t, isGraphicFrame as a, RPR_FILL_AFTER as at, Picture as b, OOXML_NS as bt, wrapShapeElement as c, SPPR_EFFECT_AFTER as ct, TableCell as d, SPPR_SCENE3D_AFTER as dt, resolveSchemeToken as et, TableRow as f, SPPR_SP3D_AFTER as ft, Chart as g, relsPartNameFor as gt, ChartExSeries as h, relativePartName as ht, isConnector as i, FILL_CHOICES as it, resolveLayoutColorContext as j, insertInOrder as jt, readGradientFill as k, getElements as kt, GraphicFrame as l, SPPR_FILL_AFTER as lt, ChartExAxis as m, partNameToZipPath as mt, buildShapes as n, styleRefLine as nt, isGroupShape as o, SHAPE_AFTER_SPPR as ot, ChartEx as p, partNameExtension as pt, SCHEME_SLOTS as q, isAutoShape as r, substitutePhClr as rt, isPicture as s, SPPR_AFTER_XFRM as st, GroupShape as t, styleRefFill as tt, Table as u, SPPR_LN_AFTER as ut, ChartSeries as v, resolveSingleRel as vt, Run as w, createElement as wt, AutoShape as x, attr as xt, Connector as y, zipPathToPartName as yt, placeholderInheritedAnchor as z, setAttr as zt };
+export { parseClrScheme as $, readGradientFill as A, getElements as At, placeholderInheritedAnchor as B, setAttr as Bt, Shape as C, boolValue as Ct, spPrXfrmEmu as D, escapeXmlAttribute as Dt, TextFrame as E, descendantsByTag as Et, resolveSlideColorContext as F, parseXml as Ft, placeholderOf as G, placeholderInheritedListStyles as H, resolveSlideThemeParts as I, removeAttr as It, SCHEME_SLOTS as J, slideDefinesColor as K, applyColorTransforms as L, removeChildrenByQName as Lt, resolveLayoutColorContext as M, insertInOrder as Mt, resolveMasterColorContext as N, intValue as Nt, readPatternFill as O, firstChild as Ot, resolveNotesColorContext as P, ownerDocumentOf as Pt, parseClrMap as Q, LST_STYLE_LEVELS as R, replaceInParent as Rt, AutoShape as S, attr as St, Run as T, createElement as Tt, placeholderInheritedRunProps as U, placeholderInheritedColor as V, placeholderInheritedXfrm as W, intAttr as X, fmtEntry as Y, isA as Z, Chart as _, relsPartNameFor as _t, isConnector as a, FILL_CHOICES as at, Connector as b, zipPathToPartName as bt, isPicture as c, SPPR_AFTER_XFRM as ct, Table as d, SPPR_LN_AFTER as dt, resolveColor as et, TableCell as f, SPPR_SCENE3D_AFTER as ft, ChartExSeries as g, relativePartName as gt, ChartExAxis as h, partNameToZipPath as ht, isAutoShape as i, substitutePhClr as it, resolveColorElement as j, getOrAddChild as jt, readPictureFill as k, firstChildElement as kt, wrapShapeElement as l, SPPR_EFFECT_AFTER as lt, ChartEx as m, partNameExtension as mt, buildShapes as n, styleRefFill as nt, isGraphicFrame as o, RPR_FILL_AFTER as ot, TableRow as p, SPPR_SP3D_AFTER as pt, slideDefinesProp as q, findShapeByIdDeep as r, styleRefLine as rt, isGroupShape as s, SHAPE_AFTER_SPPR as st, GroupShape as t, resolveSchemeToken as tt, GraphicFrame as u, SPPR_FILL_AFTER as ut, ChartAxis as v, resolveRelativePartName as vt, Paragraph as w, childElements as wt, Picture as x, OOXML_NS as xt, ChartSeries as y, resolveSingleRel as yt, RUN_PROP_NAMES as z, serializeXml as zt };
 
-//# sourceMappingURL=shapes-DMThLsZN.js.map
+//# sourceMappingURL=shapes-DoJBPrwN.js.map