@shbernal/ts-pptx 3.4.0 → 3.6.0

package/dist/{presentation-types-D7cgT-eG.d.ts → presentation-types-DP_8jog7.d.ts}

@@ -1,4 +1,5 @@
-import { t as CustomPropertyValue } from "./pres-Dybf7ZUl.js";
+import { ct as ColorMapToken, ft as ThemeColorSlot } from "./slide-js0QpRV-.js";
+import { t as CustomPropertyValue } from "./pres-C5__xkDh.js";
 import { a as Part, i as Relationships, n as OpcPackage, o as Element, t as OpcInput } from "./package-CaOLXSNi.js";
 //#region src/embedded-fonts.d.ts
 /**
@@ -83,6 +84,28 @@ interface ThemeContext extends ColorContext {
   defaultTextStyle?: Element | null;
 }
 //#endregion
+//#region src/read/oxml/color-transform.d.ts
+/** A colour-transform modifier in its read-model form: tag local-name + raw `@val`. */
+interface ColorTransform {
+  name: string;
+  value: string | null;
+}
+/** The effective colour after applying transforms: final sRGB hex, plus opacity when an `alpha*` modifier was present. */
+interface EffectiveColor {
+  hex: string;
+  alpha?: number;
+}
+/**
+ * Apply an ordered list of DrawingML colour transforms to a base sRGB hex,
+ * returning the effective sRGB hex (and opacity, when an `alpha*` modifier set
+ * it). Pure: no DOM, no theme lookup — the caller has already resolved the base
+ * colour and extracted each modifier's `{ name, value }`.
+ *
+ * An unparseable base hex is returned unchanged (with no transforms applied); an
+ * unparseable/`null` modifier value is skipped.
+ */
+declare function applyColorTransforms(baseHex: string, transforms: ColorTransform[]): EffectiveColor;
+//#endregion
 //#region src/read/api/theme-context.d.ts
 /** Identifies a placeholder by its `p:ph` `type`/`idx` for inheritance lookups. */
 interface PlaceholderRef {
@@ -114,16 +137,14 @@ interface ResolvedFrame {
  */
 interface ResolvedColor {
   hex: string;
-  transforms: {
-    name: string;
-    value: string | null;
-  }[];
+  transforms: ColorTransform[];
   effectiveHex: string;
   alpha?: number;
 }
 /**
- * Resolve a DrawingML colour *element* (`a:srgbClr`/`a:schemeClr`/`a:sysClr`)
- * against `ctx` into a full {@link ResolvedColor} — base hex, raw transform list,
+ * Resolve a DrawingML colour *element* (every `a:EG_ColorChoice` member except
+ * `a:scrgbClr` — see `read/oxml/theme.ts`) against `ctx` into a full
+ * {@link ResolvedColor} — base hex, raw transform list,
  * and the `effectiveHex`/`alpha` after applying those transforms. `null` when the
  * element cannot be made literal (unmapped token, or a colour model we do not
  * resolve). Shared by the solid-fill and gradient-stop colour reads.
@@ -142,19 +163,47 @@ interface StyleFontRef {
 interface GradientStop {
   /** Stop offset along the gradient, 0–1 (from `@pos`, thousandths of a percent), or `null` if unset. */
   position: number | null;
-  /** Explicit RGB colour as 6-hex (`a:srgbClr/@val`), or `null` when the stop uses a scheme colour. */
+  /** Explicit RGB colour as 6-hex (`a:srgbClr/@val`), or `null` when the stop uses another colour model. */
   color: string | null;
-  /** Theme colour token (`a:schemeClr/@val`, e.g. `accent1`), or `null` when the stop uses an explicit colour. */
+  /** Theme colour token (`a:schemeClr/@val`, e.g. `accent1`), or `null` when the stop uses another colour model. */
   schemeColor: string | null;
+  /**
+   * Preset colour name (`a:prstClr/@val`, e.g. `black`/`cornflowerBlue` — the
+   * ECMA-376 §20.1.10.47 table), or `null` when the stop uses another colour
+   * model. The same raw/resolved split {@link import('./shapes/types.js').RecolorColor}
+   * uses; {@link import('../oxml/preset-color.js').presetColorHex}, exported from
+   * `ts-pptx/read`, makes one literal.
+   *
+   * These three raw fields name three of the five colour models the reader
+   * resolves. A stop written as `a:sysClr` or `a:hslClr` leaves all three `null`
+   * and is reported through {@link resolvedColor} alone, which is the only place
+   * its colour appears; `a:scrgbClr`, which the reader deliberately does not
+   * resolve, leaves {@link resolvedColor} `null` too.
+   */
+  presetColor: string | null;
+  /**
+   * The stop's colour as a full {@link ResolvedColor} — base `hex`, the raw
+   * `transforms` list (`lumMod`/`shade`/…) in document order, and the
+   * `effectiveHex`/`alpha` after applying them — exactly what a solid fill's
+   * `resolvedFill` gives. `null` when the colour cannot be made literal (an
+   * unmapped token, or a colour model we do not resolve).
+   *
+   * This is the field to read when re-authoring a stop against a *different*
+   * theme: {@link effectiveHex} alone is one theme baked in, so carrying it
+   * forward as a literal silently stops the stop tracking the theme it came from.
+   * `transforms` is what says whether there was anything to track, and an empty
+   * list here means the stop stated none — not that the reader could not see them.
+   */
+  resolvedColor: ResolvedColor | null;
   /**
    * The stop's colour resolved against the slide theme **with its colour
-   * transforms applied** — the final rendered hex (the gradient counterpart of
-   * {@link import('./theme-context.js').ResolvedColor.effectiveHex}). `null` when
-   * the colour cannot be made literal (an unmapped token, or a colour model we do
-   * not resolve).
+   * transforms applied** — the final rendered hex, i.e. exactly
+   * `resolvedColor?.effectiveHex ?? null`, kept as a flat field because painting a
+   * gradient is what most callers want. `null` when the colour cannot be made
+   * literal (an unmapped token, or a colour model we do not resolve).
    */
   effectiveHex: string | null;
-  /** The stop's opacity (0–1) when an `alpha*` transform set one, else `undefined`. */
+  /** The stop's opacity (0–1) when an `alpha*` transform set one, else `undefined`. Mirrors `resolvedColor.alpha`. */
   alpha?: number;
 }
 /**
@@ -454,7 +503,7 @@ interface Reflection {
   /** End position along the reflection 0–1 (`@endPos` ÷ 100000). */
   endPos?: number;
   /** Offset distance in points (`@dist` ÷ 12700). */
-  distPt?: number;
+  offsetPt?: number;
   /** Offset direction in degrees (`@dir` ÷ 60000). */
   angleDeg?: number;
   /** Fade direction in degrees (`@fadeDir` ÷ 60000). */
@@ -745,6 +794,12 @@ declare class Run {
    * for non-placeholder runs. Called lazily.
    */
   private readonly inheritedBold?;
+  /**
+   * Resolves whether this run inherits italic from the same chain when it sets no
+   * own `@i`. Built by the owning {@link Paragraph} for placeholder text; absent
+   * for non-placeholder runs. Called lazily.
+   */
+  private readonly inheritedItalic?;
   /**
    * The owning part's relationships, used to resolve a run hyperlink's `@r:id`
    * to its external URL or internal target partname. Absent when the run was
@@ -787,6 +842,12 @@ declare class Run {
    * for non-placeholder runs. Called lazily.
    */
   inheritedBold?: (() => boolean | null) | undefined,
+  /**
+   * Resolves whether this run inherits italic from the same chain when it sets no
+   * own `@i`. Built by the owning {@link Paragraph} for placeholder text; absent
+   * for non-placeholder runs. Called lazily.
+   */
+  inheritedItalic?: (() => boolean | null) | undefined,
   /**
    * The owning part's relationships, used to resolve a run hyperlink's `@r:id`
    * to its external URL or internal target partname. Absent when the run was
@@ -909,6 +970,17 @@ declare class Run {
    * resolved counterpart of {@link bold}, which reports only the run's own value.
    */
   get resolvedBold(): boolean | null;
+  /**
+   * Whether this run effectively renders italic. It is the run's own `@i`
+   * ({@link italic}) when set; otherwise, for a run inside a placeholder, the italic
+   * state it inherits from the placeholder/list-style chain (paragraph `a:defRPr` →
+   * slide `a:lstStyle` → layout → master placeholder `a:lstStyle` → master
+   * `p:txStyles`). `null` when the run sets no `@i` and inherits none — the
+   * resolved counterpart of {@link italic}, and the twin of {@link resolvedBold}:
+   * `@b` and `@i` are siblings a master text style states together, so a deck that
+   * can be authored with an inherited italic can be read back with one.
+   */
+  get resolvedItalic(): boolean | null;
   /** Escape hatch: the underlying `a:r` element. After mutating it call {@link markDirty}, or `save()` writes the original bytes. */
   get element_(): Element;
   /** Mark the owning part dirty so `save()` reserializes it. Call after mutating {@link element_}. */
@@ -990,6 +1062,13 @@ declare class Paragraph {
    * document order, with each line break (`a:br`) rendered as `\n`.
    */
   get text(): string;
+  /**
+   * Replace **this paragraph's** content with a single run, preserving the character
+   * formatting (`a:rPr`) of its first existing run and leaving its `a:pPr` (level,
+   * alignment, bullet) alone. Sibling paragraphs are untouched — the difference from
+   * {@link TextFrame.text}, which collapses the whole body to one paragraph.
+   */
+  set text(value: string);
   /** Escape hatch: the underlying `a:p` element. After mutating it call {@link markDirty}, or `save()` writes the original bytes. */
   get element_(): Element;
   /** Mark the owning part dirty so `save()` reserializes it. Call after mutating {@link element_}. */
@@ -2017,6 +2096,60 @@ interface DiagramConnection {
   /** The layout preset this edge belongs to (`@presId`), set on generated edges only. */
   presentationId: string | null;
 }
+/**
+ * Where a point's text is drawn in the fallback drawing part — the second copy of every
+ * string a diagram carries, and the only one a renderer without a SmartArt layout engine
+ * paints. See {@link DiagramPoint.drawnShape} for how a point reaches it.
+ */
+interface DiagramDrawnShape {
+  /** The drawing part (`/ppt/diagrams/drawing{N}.xml`) the shape lives in. */
+  readonly part: Part;
+  /** The `pres` point this shape draws (`dsp:sp/@modelId`) — never the authored point's own id. */
+  readonly modelId: string;
+  /** Which paragraph of {@link textFrame} carries this point's text (the `presOf` edge's `@destOrd`). */
+  readonly paragraphIndex: number;
+  /**
+   * The shape's `dsp:txBody`, bound to the **drawing** part rather than the data part, so
+   * an edit made through it marks the part that actually changed.
+   *
+   * One shape commonly draws several points — three of them in `mixed.pptx` — so writing
+   * `textFrame.text` here would delete the siblings' text. Replace paragraph
+   * {@link paragraphIndex} instead, which is what {@link DiagramPoint.text}'s setter does.
+   */
+  readonly textFrame: TextFrame;
+  /** Escape hatch: the underlying `dsp:sp`. After mutating it call `part.markDirty()`. */
+  readonly element_: Element;
+}
+/**
+ * The node → drawn-shape index of one diagram: the `presOf` edges of the data model and the
+ * `dsp:sp` elements of the drawing part, both keyed for lookup.
+ *
+ * Built once per {@link Diagram}, and only when a point is actually asked what draws it — the
+ * drawing part is a second XML DOM and a consumer reading node text should not pay to parse
+ * it. The consequence of that memo: a consumer who *adds* or *removes* shapes in the drawing
+ * part through the escape hatches must re-reach the diagram to see them here.
+ */
+declare class DrawingIndex {
+  #private;
+  private readonly drawingPart;
+  private readonly themeContext?;
+  constructor(root: Element | null, drawingPart: Part | null, themeContext?: ThemeContext | undefined);
+  /**
+   * Resolve one authored point to the `pres` point that presents it and to the drawn
+   * paragraph carrying its text.
+   *
+   * A point commonly has **several** `presOf` arms — an org-chart node's box and the
+   * connector beneath it are two presentations of one node — so the arm is chosen by what it
+   * reaches rather than by its `@srcOrd`: the first, in `@srcOrd` order, whose `pres` point
+   * draws a `dsp:sp` that has a `dsp:txBody`. That selector produced a unique hit for all 90
+   * authored points measured across five layout families, and it degrades to "no arm" rather
+   * than to "the wrong arm" on a layout that was not.
+   */
+  resolve(modelId: string | null): {
+    presentationId: string | null;
+    drawnShape: DiagramDrawnShape | null;
+  };
+}
 /** One point (`dgm:pt`) of a diagram's data model. */
 declare class DiagramPoint {
   #private;
@@ -2025,9 +2158,13 @@ declare class DiagramPoint {
   private readonly part;
   private readonly themeContext?;
   private readonly relationships?;
+  /** The owning diagram's drawing index, built on first use; absent when reached without one. */
+  private readonly drawing?;
   constructor(pt: Element,
   /** The diagram data part, so a text edit marks the right part dirty. */
-  part: Part, themeContext?: ThemeContext | undefined, relationships?: Relationships | undefined);
+  part: Part, themeContext?: ThemeContext | undefined, relationships?: Relationships | undefined,
+  /** The owning diagram's drawing index, built on first use; absent when reached without one. */
+  drawing?: (() => DrawingIndex) | undefined);
   /** This point's id (`@modelId`), which connections reference. */
   get modelId(): string | null;
   /** What kind of point this is (`@type`); `node` when absent, its schema default. */
@@ -2049,13 +2186,87 @@ declare class DiagramPoint {
    * This point's text body (`dgm:t`) as a {@link TextFrame}, or `null` when the point
    * carries none. It is an `a:CT_TextBody` like any other, so `paragraphs`, `runs` and the
    * `resolved*` getters all apply.
+   *
+   * **Writing through this edits the data model only**, and leaves the drawing cache
+   * holding the old string — which is what PowerPoint-less renderers draw. It is the escape
+   * hatch for run-level formatting, so it does exactly what it is told and nothing more;
+   * {@link text}'s setter is the path that mirrors.
    */
   get textFrame(): TextFrame | null;
+  /**
+   * The generated `pres` point that presents this one (`dgm:cxn[@type="presOf"]/@destId`),
+   * or `null` when nothing presents it — the normal state of an unlabelled transition point.
+   *
+   * Where a point has several `presOf` arms the one named here is the arm that draws text;
+   * see {@link drawnShape}, which resolves both.
+   */
+  get presentationId(): string | null;
+  /**
+   * The paragraph of the fallback drawing part (`dsp:drawing`) that carries this point's
+   * text, or `null` when nothing draws it.
+   *
+   * The mapping runs through the `pres` point rather than directly: a `dsp:sp/@modelId` is
+   * always a `pres` point's id, so a lookup keyed on the authored point's own id finds
+   * nothing at all. It is many-to-one in both directions — one shape draws several points
+   * (`@destOrd` says which paragraph is whose, and it can contradict document order), and
+   * one point has several presentations, of which at most one holds text.
+   *
+   * `null` is a defined outcome, not a failure, and covers four real cases: the package
+   * carries no drawing part; the point has no `presOf` edge (every unlabelled
+   * `parTrans`/`sibTrans`); the `pres` point draws no `dsp:sp`; and the shape it draws has
+   * no `dsp:txBody` (a connector, or a picture node's filled rectangle).
+   */
+  get drawnShape(): DiagramDrawnShape | null;
   /** This point's text, paragraphs joined by `\n`; `''` when it carries none. */
   get text(): string;
+  /**
+   * Replace this point's text, in the data model **and** in the drawing cache.
+   *
+   * A diagram stores every string twice. `dgm:t` is what PowerPoint reads, and it recomputes
+   * the drawing from the data model on open; the `dsp:drawing` part is what every other
+   * renderer paints, and none of them recompute anything. Writing only the first is an edit
+   * that is invisible in LibreOffice, Google Slides, thumbnailers and web previews until
+   * someone opens the deck in PowerPoint and saves it.
+   *
+   * The data-model write always happens. The mirror is best-effort: when the point resolves
+   * to no drawn paragraph (see {@link drawnShape} for the four ways that occurs) the cache
+   * keeps the old string and a `diagram/drawing-cache-not-updated` diagnostic says so.
+   * Throwing instead would make the common case unusable in order to report the rare one,
+   * and returning a status would be a shape no other text setter here has.
+   *
+   * Two things it deliberately does not do. It does **not** recompute geometry: the drawn
+   * shape keeps its cached position and size, so a much longer string overflows its box in
+   * those same renderers until PowerPoint re-lays the diagram out. And it does not *create*
+   * a place to draw text — a transition point whose layout has no label slot has no
+   * `dsp:sp`, and PowerPoint strips text put on one, so the honest outcome is the
+   * diagnostic. Like every other `text` setter here it collapses the point to one run,
+   * keeping the first run's `a:rPr`; use {@link textFrame} for run-level work.
+   */
+  set text(value: string);
   /** Escape hatch: the underlying `dgm:pt` element. After mutating it call {@link Diagram.markDirty}. */
   get element_(): Element;
 }
+/**
+ * One user-authored point in its place in the diagram's tree — a `node` or an `asst`, never a
+ * generated `pres` point or a transition label. See {@link Diagram.nodes}.
+ */
+declare class DiagramNode {
+  /** The point itself: its text, its type, and its link to what is drawn for it. */
+  readonly point: DiagramPoint;
+  /** The parent node, or `null` for a root. */
+  readonly parent: DiagramNode | null;
+  /** Depth below the root, `0` for a root. */
+  readonly level: number;
+  /** Child nodes, ordered by their `parOf` edge's `@srcOrd`. Empty for a leaf. */
+  readonly children: DiagramNode[];
+  constructor(
+  /** The point itself: its text, its type, and its link to what is drawn for it. */
+  point: DiagramPoint,
+  /** The parent node, or `null` for a root. */
+  parent: DiagramNode | null,
+  /** Depth below the root, `0` for a root. */
+  level: number);
+}
 /** A SmartArt graphic frame's diagram, backed by its `dgm:dataModel` part. */
 declare class Diagram {
   #private;
@@ -2079,9 +2290,31 @@ declare class Diagram {
   /**
    * Every point (`dgm:ptLst/dgm:pt`) in document order, unfiltered — generated `pres`
    * points and the `doc` root included. Filter on {@link DiagramPoint.type} for the user's
-   * nodes; {@link text} is the shortcut for the common case.
+   * nodes; {@link text} is the shortcut for the common case, {@link nodes} the structured one.
+   *
+   * Built per access like every other read proxy (`docs/reference/pptx-read.md`, "Object
+   * model"), so `points[0] !== points[0]` while both wrap the same `dgm:pt`. Key a `Map`
+   * on {@link DiagramPoint.modelId}, not on the point.
    */
   get points(): DiagramPoint[];
+  /**
+   * The authored tree — every `node` and `asst` point in its place, roots in `@srcOrd`
+   * order — as a view over {@link points} and {@link connections} rather than a replacement
+   * for either.
+   *
+   * A root is a content point whose `parOf` parent is not itself content, which in a
+   * PowerPoint-authored model means the `doc` point. Transition points are not members; see
+   * this module's header for that decision and the two beside it.
+   *
+   * @throws PackageReadError `diagram/parent-edge-cycle` when the `parOf` edges make a
+   * point its own ancestor, which is a corrupt model rather than a diagram shape.
+   */
+  get nodes(): DiagramNode[];
+  /**
+   * The point with this `@modelId`, or `null` — the lookup every connection getter implies,
+   * since a `DiagramConnection` names its ends by id and nothing else resolves them.
+   */
+  point(modelId: string): DiagramPoint | null;
   /** Every edge (`dgm:cxnLst/dgm:cxn`) in document order. */
   get connections(): DiagramConnection[];
   /**
@@ -2213,7 +2446,26 @@ interface CellBorder {
   widthPt: number | null;
   /** Dash style (`a:prstDash/@val`, e.g. `solid`/`sysDash`), or `null` when unset. */
   dash: string | null;
-  /** The stroke colour resolved against the table theme to a literal hex (`effectiveHex`), or `null`. */
+  /**
+   * The stroke colour as a full {@link ResolvedColor} — base `hex`, the raw
+   * `transforms` list (`lumMod`/`shade`/…) in document order, and the
+   * `effectiveHex`/`alpha` after applying them — the same object a shape's
+   * `resolvedLine` gives. `null` when the edge carries no solid fill, or the
+   * colour cannot be made literal.
+   *
+   * This is the field to read when re-authoring a border against a *different*
+   * theme: {@link color} alone is one theme baked in, so a `lumMod`-darkened
+   * accent carried forward as a literal hex silently stops tracking the theme it
+   * came from. `transforms` is what says whether there was anything to track, and
+   * an empty list here means the edge stated none — not that the reader could not
+   * see them.
+   */
+  resolvedColor: ResolvedColor | null;
+  /**
+   * The stroke colour resolved against the table theme to a literal hex — exactly
+   * `resolvedColor?.effectiveHex ?? null`, kept as a flat field because painting a
+   * rule is what most callers want. `null` when the edge has no resolvable colour.
+   */
   color: string | null;
   /** Raw `schemeClr` token of the stroke (`a:solidFill/a:schemeClr/@val`), or `null` for an srgb/absent colour. */
   schemeColor: string | null;
@@ -2636,7 +2888,8 @@ declare class TableCell {
   /**
    * The cell's edge borders (`a:tcPr/a:lnL|lnR|lnT|lnB|lnTlToBr|lnBlToTr`), or
    * `null` when the cell defines none. Each present edge decodes to a
-   * {@link CellBorder} (width / dash / resolved + raw colour / suppressed flag);
+   * {@link CellBorder} (width / dash / resolved colour + its raw token and transform
+   * list / suppressed flag);
    * absent edges are `null`. Cell borders are the biggest visible table gap — a
    * replica built only from geometry and fill draws every cell edge-to-edge with
    * no rule, so this surfaces the per-side stroke the writer's `border` option emits.
@@ -2819,187 +3072,7 @@ declare function isGraphicFrame(shape: Shape): shape is GraphicFrame;
 /** Narrow a shape to a {@link GroupShape} (`p:grpSp`). */
 declare function isGroupShape(shape: Shape): shape is GroupShape;
 //#endregion
-//#region src/read/api/notes.d.ts
-/**
- * One placeholder shape (`p:sp`) of a notes slide. A notes slide holds a fixed set:
- * the slide thumbnail (`type="sldImg"`), the notes body (`type="body"`), and the
- * slide number (`type="sldNum"`). Geometry getters read the placeholder's *own*
- * `a:xfrm` and are `null` when it inherits geometry from the notesMaster (the case
- * on an authored deck, whose `sldImg`/`sldNum` carry an empty `p:spPr`).
- */
-declare class NotesPlaceholder {
-  #private;
-  private readonly sp;
-  private readonly part;
-  /** The notes theme context (notesMaster → `theme2.xml`), threaded to {@link textFrame}. */
-  private readonly themeContext;
-  /** The notes part's relationships, threaded to {@link textFrame} for hyperlink resolution. */
-  private readonly relationships;
-  constructor(sp: Element, part: Part,
-  /** The notes theme context (notesMaster → `theme2.xml`), threaded to {@link textFrame}. */
-  themeContext: ThemeContext,
-  /** The notes part's relationships, threaded to {@link textFrame} for hyperlink resolution. */
-  relationships: Relationships);
-  /** Placeholder type (`p:ph/@type`: `sldImg` | `body` | `sldNum`), or `null` when absent. */
-  get type(): string | null;
-  /** Placeholder index (`p:ph/@idx`), or `null` when unset. */
-  get idx(): string | null;
-  /** Shape name (`p:cNvPr/@name`), or `''` when unnamed. */
-  get name(): string;
-  /** Drawing id (`p:cNvPr/@id`), or `null` when absent. */
-  get id(): number | null;
-  /** Left edge in EMU (`a:off/@x`), or `null` when geometry is inherited (no own `a:xfrm`). */
-  get left(): number | null;
-  /** Top edge in EMU (`a:off/@y`), or `null` when geometry is inherited. */
-  get top(): number | null;
-  /** Width in EMU (`a:ext/@cx`), or `null` when geometry is inherited. */
-  get width(): number | null;
-  /** Height in EMU (`a:ext/@cy`), or `null` when geometry is inherited. */
-  get height(): number | null;
-  /**
-   * The placeholder's text as a navigable {@link TextFrame} (`p:txBody`), or `null`
-   * when it carries no text body (the `sldImg` thumbnail). The body placeholder's
-   * runs round-trip a slide's authored notes; the `sldNum` placeholder's frame
-   * holds the slide-number `a:fld`, whose value surfaces through `TextFrame.text`.
-   */
-  get textFrame(): TextFrame | null;
-  /** The placeholder's flattened text (paragraphs joined by `\n`), or `''` when it has no text body. */
-  get text(): string;
-  /** Escape hatch: the underlying `p:sp` element. After mutating it call {@link markDirty}, or `save()` writes the original bytes. */
-  get element_(): Element;
-  /** Mark the owning notes-slide part dirty so `save()` reserializes it. Call after mutating {@link element_}. */
-  markDirty(): void;
-}
-/**
- * A slide's speaker-notes slide (`notesSlideN.xml`) as a modeled object — the deep
- * companion to {@link import('./slide.js').Slide.notesText}. Exposes the notes
- * shape tree as {@link NotesPlaceholder}s ({@link body}/{@link slideImage}/
- * {@link slideNumber}) plus the body {@link textFrame} the older getters flatten.
- *
- * The theme context (notesMaster → `theme2.xml`) is resolved once and shared across
- * every placeholder's text frame.
- */
-declare class NotesSlide {
-  #private;
-  private readonly opc;
-  /** The notes slide's OPC part (`/ppt/notesSlides/notesSlideN.xml`). */
-  readonly part: Part;
-  constructor(opc: OpcPackage,
-  /** The notes slide's OPC part (`/ppt/notesSlides/notesSlideN.xml`). */
-  part: Part);
-  /** Partname of the notes slide part. */
-  get partName(): string;
-  /**
-   * The notes theme context, resolved through the notesMaster → `theme2.xml` chain
-   * and cached. Backs {@link NotesPlaceholder.textFrame}'s `Run.resolvedColor`.
-   */
-  themeContext(): ThemeContext;
-  /** The placeholders (`p:sp`) in the notes shape tree, in document order. */
-  get placeholders(): NotesPlaceholder[];
-  /** The notes body placeholder (`p:ph type="body"`), or `null` when the notes slide has none. */
-  get body(): NotesPlaceholder | null;
-  /** The slide-thumbnail placeholder (`p:ph type="sldImg"`), or `null` when absent. */
-  get slideImage(): NotesPlaceholder | null;
-  /** The slide-number placeholder (`p:ph type="sldNum"`, carrying the slide-number field), or `null`. */
-  get slideNumber(): NotesPlaceholder | null;
-  /** The notes body as a navigable {@link TextFrame}, or `null` when there is no body text frame. */
-  get textFrame(): TextFrame | null;
-  /** The notes body text flattened (paragraphs joined by `\n`), or `''` when the body is empty/absent. */
-  get text(): string;
-}
-//#endregion
-//#region src/read/api/comments.d.ts
-/** One entry of the deck-wide comment-author registry (`p:cmAuthor`). */
-interface CommentAuthor {
-  /** Author id (`@id`), referenced by each comment's `@authorId`. */
-  id: number | null;
-  /** Display name (`@name`). */
-  name: string;
-  /** Initials shown in the comment marker (`@initials`). */
-  initials: string;
-  /** Highest per-author comment index used (`@lastIdx`). */
-  lastIdx: number | null;
-  /** Author colour slot (`@clrIdx`). */
-  clrIdx: number | null;
-}
-/** One legacy review comment (`p:cm`), with its author resolved via the registry. */
-interface Comment {
-  /** Resolved author display name (via `@authorId` → `commentAuthors.xml`), or `null` when unresolved. */
-  author: string | null;
-  /** Resolved author initials, or `null` when unresolved. */
-  authorInitials: string | null;
-  /** The comment's `@authorId`, or `null` when absent/unparseable. */
-  authorId: number | null;
-  /** The comment's per-author 1-based index (`@idx`), or `null` when absent. */
-  idx: number | null;
-  /** The comment body text (`p:text`). */
-  text: string;
-  /** Marker X position in EMU (`p:pos/@x`), or `null` when absent. */
-  x: number | null;
-  /** Marker Y position in EMU (`p:pos/@y`), or `null` when absent. */
-  y: number | null;
-  /** Authored timestamp (`@dt`, ISO-8601 as written), or `null` when absent. */
-  date: string | null;
-}
-/** One entry of the modern deck-wide author registry (`p188:author`). */
-interface ModernCommentAuthor {
-  /** Author id (`@id`) — a GUID string like `{E8A64ABA-…}`, referenced by each comment's `@authorId`. */
-  id: string | null;
-  /** Display name (`@name`). */
-  name: string;
-  /** Initials (`@initials`). */
-  initials: string;
-  /** Account identifier (`@userId`, e.g. an email), or `null`. */
-  userId: string | null;
-  /** Identity provider (`@providerId`, e.g. `Windows Live`), or `null`. */
-  providerId: string | null;
-}
-/** One modern comment or reply (`p188:cm` / `p188:reply`), with its author resolved via the registry. */
-interface ModernComment {
-  /** The comment's own GUID id (`@id`), or `null` when absent. */
-  id: string | null;
-  /** Resolved author display name (via `@authorId` → `authors.xml`), or `null` when unresolved. */
-  author: string | null;
-  /** Resolved author initials, or `null` when unresolved. */
-  authorInitials: string | null;
-  /** The comment's `@authorId` GUID, or `null` when absent. */
-  authorId: string | null;
-  /** Creation timestamp (`@created`, ISO-8601 as written), or `null` when absent. */
-  created: string | null;
-  /** The comment body text; multiple paragraphs are joined with `\n`. */
-  text: string;
-  /** Marker X position in EMU (`p188:pos/@x`), or `null` (replies carry no position). */
-  x: number | null;
-  /** Marker Y position in EMU (`p188:pos/@y`), or `null` (replies carry no position). */
-  y: number | null;
-  /** Nested replies in thread order; each is itself a {@link ModernComment} with no further replies. */
-  replies: ModernComment[];
-}
-/** Which comment schema a deck carries. `'none'` when it has neither part. */
-type CommentSchema = 'legacy' | 'modern' | 'none';
-//#endregion
-//#region src/read/api/tags.d.ts
-/** One programmatic tag (`p:tag`) — a name/value string pair. */
-interface Tag {
-  /** The tag's `@name`. */
-  name: string;
-  /** The tag's `@val`. */
-  val: string;
-}
-/**
- * Read every tag referenced by `ownerPartName` (a slide part or the presentation
- * part), resolving the owner's `tags` relationship(s) to their `ppt/tags/tagN.xml`
- * part(s) and flattening each part's `p:tag` children into `{ name, val }`. `[]`
- * when the owner references no tag part. Rel-driven rather than walking
- * `p:custDataLst`, so it is robust to element ordering in the owner.
- */
-declare function readTagsForPart(opc: OpcPackage, ownerPartName: string): Tag[];
-//#endregion
 //#region src/read/api/chrome.d.ts
-/** The 12 theme colour-scheme slots (`a:clrScheme` children), in schema order. */
-type ThemeColorSlot = 'dk1' | 'lt1' | 'dk2' | 'lt2' | 'accent1' | 'accent2' | 'accent3' | 'accent4' | 'accent5' | 'accent6' | 'hlink' | 'folHlink';
-/** The 12 colour-map tokens (`p:clrMap` attributes), each pointing at a {@link ThemeColorSlot}. */
-type ColorMapToken = 'bg1' | 'tx1' | 'bg2' | 'tx2' | 'accent1' | 'accent2' | 'accent3' | 'accent4' | 'accent5' | 'accent6' | 'hlink' | 'folHlink';
 /**
  * One theme font family (`a:majorFont` or `a:minorFont`): the primary Latin face
  * plus the East-Asian and complex-script faces. Each is `null` when the theme
@@ -3074,14 +3147,20 @@ declare class Theme {
  */
 declare class Placeholder {
   #private;
-  private readonly sp;
-  private readonly part;
-  /** The owning master/layout theme context, threaded to {@link textFrame}. */
-  private readonly themeContext;
+  /** The placeholder's `p:sp`. `protected` so {@link NotesPlaceholder} can read it. */
+  protected readonly sp: Element;
+  /** The part the `p:sp` lives in — a master, a layout, or a notes slide. */
+  protected readonly part: Part;
+  /** The owning part's theme context, threaded to {@link textFrame}. */
+  protected readonly themeContext: ThemeContext;
   /** The owning part's relationships, threaded to {@link textFrame} for hyperlink resolution. */
-  private readonly relationships;
-  constructor(sp: Element, part: Part,
-  /** The owning master/layout theme context, threaded to {@link textFrame}. */
+  protected readonly relationships: Relationships;
+  constructor(
+  /** The placeholder's `p:sp`. `protected` so {@link NotesPlaceholder} can read it. */
+  sp: Element,
+  /** The part the `p:sp` lives in — a master, a layout, or a notes slide. */
+  part: Part,
+  /** The owning part's theme context, threaded to {@link textFrame}. */
   themeContext: ThemeContext,
   /** The owning part's relationships, threaded to {@link textFrame} for hyperlink resolution. */
   relationships: Relationships);
@@ -3109,33 +3188,86 @@ declare class Placeholder {
   get textFrame(): TextFrame | null;
   /** Escape hatch: the underlying `p:sp` element. After mutating it call {@link markDirty}, or `save()` writes the original bytes. */
   get element_(): Element;
-  /** Mark the owning master/layout part dirty so `save()` reserializes it. Call after mutating {@link element_}. */
+  /** Mark the owning part dirty so `save()` reserializes it. Call after mutating {@link element_}. */
   markDirty(): void;
 }
 /**
- * A deck's slide master (`slideMasterN.xml`) as a modeled object. Exposes the
- * property tiers a bound slide inherits: the {@link colorMap} (token → theme slot),
- * its {@link theme}, its {@link shapes} and the {@link placeholders} subset of them,
- * its own {@link background}, and the {@link layouts} that build on it. Reachable
- * from {@link SlideLayout.master} and `Slide.master`.
+ * The shared body of a slide master and a slide layout — the two template tiers a slide
+ * inherits from.
+ *
+ * Both are an OPC part holding a `p:cSld` with a shape tree and a resolvable theme context, and
+ * both were written out in full, member for member: `partName`, `relationships`, `name`,
+ * `shapes`, `shapeByIdDeep`, `placeholders`, `themeContext` and the two DOM lookups behind them
+ * were character-for-character identical in the two classes. Nothing about that was broken, but
+ * it meant every accessor added to a template tier had to be added twice, and the ones meant to
+ * agree could quietly stop agreeing.
+ *
+ * What genuinely differs stays on the subclasses. `theme` differs because a layout has to walk
+ * to its master first. `background` differs in the tier label it decodes with and in where it
+ * finds the theme part. And the context itself differs, which is why {@link resolveThemeContext}
+ * is abstract: a master resolves its own `p:clrMap` + theme, a layout walks layout → master →
+ * theme. The caching around it is shared, so a subclass supplies the walk and nothing else.
+ *
+ * `Slide` deliberately does not extend this. It is a shape host too, but it is constructed from
+ * a `Presentation` rather than an `OpcPackage`, reaches its relationships through that, and
+ * reports an unnamed slide as `null` where a template tier reports `''` — three differences in
+ * the same handful of members, which is more contortion than the sharing is worth.
  */
-declare class SlideMaster implements ShapeHost {
+declare abstract class TemplatePart implements ShapeHost {
   #private;
-  /** The package the master belongs to, for reaching its layouts, theme, and media. */
+  /** The package this part belongs to, for reaching related parts (theme, master, media). */
   readonly opc: OpcPackage;
-  /** The master's OPC part (`/ppt/slideMasters/slideMasterN.xml`). */
+  /** This tier's OPC part. */
   readonly part: Part;
   constructor(
-  /** The package the master belongs to, for reaching its layouts, theme, and media. */
+  /** The package this part belongs to, for reaching related parts (theme, master, media). */
   opc: OpcPackage,
-  /** The master's OPC part (`/ppt/slideMasters/slideMasterN.xml`). */
+  /** This tier's OPC part. */
   part: Part);
-  /** Partname of the master part. */
+  /** Partname of this part. */
   get partName(): string;
-  /** This master part's relationships (its layouts, its theme, image embeds, …). */
+  /** This part's relationships (its theme or master, image embeds, hyperlinks, …). */
   get relationships(): Relationships;
-  /** The master's authoring name (`p:cSld/@name`), or `''` when unnamed (the writer's default). */
+  /** The authoring name (`p:cSld/@name`), or `''` when unnamed. */
   get name(): string;
+  /**
+   * Every shape in this tier's `p:cSld/p:spTree`, in document order — the same `AnyShape`
+   * union `Slide.shapes` returns, so shape-walking code applies unchanged.
+   *
+   * {@link placeholders} is the filtered view of the same tree.
+   */
+  get shapes(): AnyShape[];
+  /** The shape anywhere in this tier's tree with the given drawing id, or `undefined`. */
+  shapeByIdDeep(id: number): AnyShape | undefined;
+  /** This tier's placeholder shapes (`p:sp` carrying a `p:ph`), in document order. */
+  get placeholders(): Placeholder[];
+  /** This tier's colour/font context, resolved once and cached. Backs each {@link Placeholder}'s text frame. */
+  themeContext(): ThemeContext;
+  /** The theme this tier resolves against, or `null` when the chain is incomplete. */
+  abstract get theme(): Theme | null;
+  /** This tier's *own* background (`p:cSld/p:bg`), decoded, or `null` when it defines none. */
+  abstract get background(): SlideBackground | null;
+  /** Walk this tier's colour/font chain. Called once; {@link themeContext} caches the result. */
+  protected abstract resolveThemeContext(): ThemeContext;
+  /** The `p:cSld` of this part, or `null`. */
+  protected cSld(): Element | null;
+  /** The `p:cSld/p:spTree` of this part, or `null`. */
+  protected spTree(): Element | null;
+  /** The part this one's first relationship of `type` points at, or `null`. */
+  protected relTarget(type: string): Part | null;
+}
+/**
+ * A deck's slide master (`slideMasterN.xml`) as a modeled object. Exposes the
+ * property tiers a bound slide inherits: the {@link colorMap} (token → theme slot),
+ * its {@link theme}, its `shapes` and the `placeholders` subset of them, its own
+ * {@link background}, and the {@link layouts} that build on it. Reachable from
+ * {@link SlideLayout.master} and `Slide.master`.
+ *
+ * `shapes` is where a template's non-placeholder furniture lives: the header band, the
+ * rule under the title, the logo. Whether a given slide draws them is
+ * `Slide.showMasterSp` (and, for a layout, {@link SlideLayout.showMasterSp}).
+ */
+declare class SlideMaster extends TemplatePart {
   /** The master's theme (via its `theme` relationship), or `null` when absent. */
   get theme(): Theme | null;
   /**
@@ -3145,20 +3277,6 @@ declare class SlideMaster implements ShapeHost {
    * A token the map omits reads `null`.
    */
   get colorMap(): Record<ColorMapToken, string | null>;
-  /**
-   * Every shape in the master's `p:cSld/p:spTree`, in document order — the same
-   * `AnyShape` union `Slide.shapes` returns, so shape-walking code applies
-   * unchanged. This is where a template's non-placeholder furniture lives: the
-   * header band, the rule under the title, the logo. Whether a given slide draws
-   * them is `Slide.showMasterSp` (and, for a layout, {@link SlideLayout.showMasterSp}).
-   *
-   * {@link placeholders} is the filtered view of the same tree.
-   */
-  get shapes(): AnyShape[];
-  /** The shape anywhere in the master's tree with the given drawing id, or `undefined`. */
-  shapeByIdDeep(id: number): AnyShape | undefined;
-  /** The master's placeholder shapes (`p:sp` carrying a `p:ph`), in document order. */
-  get placeholders(): Placeholder[];
   /** The layouts built on this master (via `p:sldLayoutIdLst` → its relationships), in list order. */
   get layouts(): SlideLayout[];
   /**
@@ -3167,36 +3285,21 @@ declare class SlideMaster implements ShapeHost {
    * resolved through the slide → layout → master chain, is `Slide.background`.
    */
   get background(): SlideBackground | null;
-  /**
-   * The master's colour/font context (its `p:clrMap` + theme), resolved once and
-   * cached. Backs each {@link Placeholder}'s text frame.
-   */
-  themeContext(): ThemeContext;
+  /** A master's context is its own `p:clrMap` plus its theme — no walk beyond this part. */
+  protected resolveThemeContext(): ThemeContext;
 }
 /**
  * A deck's slide layout (`slideLayoutN.xml`) as a modeled object — the gallery entry
  * a slide binds to. Exposes its {@link name}, its {@link type} (import-only; the
  * writer authors none), its {@link master} (and, through it, the {@link theme}), its
- * {@link shapes} and the {@link placeholders} subset of them, and its own
- * {@link background}. Reachable from `Slide.layout` and {@link SlideMaster.layouts}.
+ * `shapes` and the `placeholders` subset of them, and its own {@link background}.
+ * Reachable from `Slide.layout` and {@link SlideMaster.layouts}.
+ *
+ * The write API authors non-placeholder shapes into a layout: every
+ * `defineSlideMaster({ objects })` member that is not a `placeholder` — a `rect`, a
+ * `line`, an `image`, a `chart`, a `text` box — lands in this tier's tree.
  */
-declare class SlideLayout implements ShapeHost {
-  #private;
-  /** The package the layout belongs to, for reaching its master, theme, and media. */
-  readonly opc: OpcPackage;
-  /** The layout's OPC part (`/ppt/slideLayouts/slideLayoutN.xml`). */
-  readonly part: Part;
-  constructor(
-  /** The package the layout belongs to, for reaching its master, theme, and media. */
-  opc: OpcPackage,
-  /** The layout's OPC part (`/ppt/slideLayouts/slideLayoutN.xml`). */
-  part: Part);
-  /** Partname of the layout part. */
-  get partName(): string;
-  /** This layout part's relationships (its master, image embeds, hyperlinks, …). */
-  get relationships(): Relationships;
-  /** The layout's authoring name (`p:cSld/@name`, e.g. `Title and Content`), or `''` when unnamed. */
-  get name(): string;
+declare class SlideLayout extends TemplatePart {
   /**
    * The layout type (`p:sldLayout/@type`, e.g. `title` | `obj` | `blank`), or `null`
    * when the layout declares none. Import-only: the writer authors no `@type`, so an
@@ -3216,20 +3319,6 @@ declare class SlideLayout implements ShapeHost {
   get master(): SlideMaster | null;
   /** The theme this layout resolves against, via its {@link master}, or `null`. */
   get theme(): Theme | null;
-  /**
-   * Every shape in the layout's `p:cSld/p:spTree`, in document order — the same
-   * `AnyShape` union `Slide.shapes` returns, so shape-walking code applies
-   * unchanged. The write API authors non-placeholder shapes here: every
-   * `defineSlideMaster({ objects })` member that is not a `placeholder` (a `rect`,
-   * a `line`, an `image`, a `chart`, a `text` box) lands in this tree.
-   *
-   * {@link placeholders} is the filtered view of the same tree.
-   */
-  get shapes(): AnyShape[];
-  /** The shape anywhere in the layout's tree with the given drawing id, or `undefined`. */
-  shapeByIdDeep(id: number): AnyShape | undefined;
-  /** The layout's placeholder shapes (`p:sp` carrying a `p:ph`), in document order. */
-  get placeholders(): Placeholder[];
   /**
    * The layout's *own* background (`p:cSld/p:bg`), decoded, or `null` when it defines
    * none. A layout usually authors one — an explicit fill (`p:bgPr`) or a
@@ -3237,12 +3326,161 @@ declare class SlideLayout implements ShapeHost {
    * `Slide.background`.
    */
   get background(): SlideBackground | null;
+  /** A layout's context is walked layout → master → theme, which is why it is not the master's. */
+  protected resolveThemeContext(): ThemeContext;
+}
+//#endregion
+//#region src/read/api/notes.d.ts
+/**
+ * One placeholder shape (`p:sp`) of a notes slide. A notes slide holds a fixed set:
+ * the slide thumbnail (`type="sldImg"`), the notes body (`type="body"`), and the
+ * slide number (`type="sldNum"`). Geometry getters read the placeholder's *own*
+ * `a:xfrm` and are `null` when it inherits geometry from the notesMaster (the case
+ * on an authored deck, whose `sldImg`/`sldNum` carry an empty `p:spPr`).
+ *
+ * A notes placeholder IS a {@link Placeholder} — identity, geometry and the escape hatch are
+ * the same twelve members read off the same `p:sp`, down to `p:ph` being found the same way —
+ * so it extends one rather than repeating it. Two things are its own: the flattened
+ * {@link text} convenience, and a {@link textFrame} that threads the notesMaster inheritance
+ * context onto the body frame.
+ */
+declare class NotesPlaceholder extends Placeholder {
   /**
-   * The layout's colour/font context (walked layout → master → theme), resolved once
-   * and cached. Backs each {@link Placeholder}'s text frame.
+   * The placeholder's text as a navigable {@link TextFrame} (`p:txBody`), or `null`
+   * when it carries no text body (the `sldImg` thumbnail). The body placeholder's
+   * runs round-trip a slide's authored notes; the `sldNum` placeholder's frame
+   * holds the slide-number `a:fld`, whose value surfaces through `TextFrame.text`.
+   *
+   * Overrides {@link Placeholder.textFrame} for the inheritance context alone — see below.
+   */
+  get textFrame(): TextFrame | null;
+  /** The placeholder's flattened text (paragraphs joined by `\n`), or `''` when it has no text body. */
+  get text(): string;
+}
+/**
+ * A slide's speaker-notes slide (`notesSlideN.xml`) as a modeled object — the deep
+ * companion to {@link import('./slide.js').Slide.notesText}. Exposes the notes
+ * shape tree as {@link NotesPlaceholder}s ({@link body}/{@link slideImage}/
+ * {@link slideNumber}) plus the body {@link textFrame} the older getters flatten.
+ *
+ * The theme context (notesMaster → `theme2.xml`) is resolved once and shared across
+ * every placeholder's text frame.
+ */
+declare class NotesSlide {
+  #private;
+  private readonly opc;
+  /** The notes slide's OPC part (`/ppt/notesSlides/notesSlideN.xml`). */
+  readonly part: Part;
+  constructor(opc: OpcPackage,
+  /** The notes slide's OPC part (`/ppt/notesSlides/notesSlideN.xml`). */
+  part: Part);
+  /** Partname of the notes slide part. */
+  get partName(): string;
+  /**
+   * The notes theme context, resolved through the notesMaster → `theme2.xml` chain
+   * and cached. Backs {@link NotesPlaceholder.textFrame}'s `Run.resolvedColor`.
    */
   themeContext(): ThemeContext;
+  /** The placeholders (`p:sp`) in the notes shape tree, in document order. */
+  get placeholders(): NotesPlaceholder[];
+  /** The notes body placeholder (`p:ph type="body"`), or `null` when the notes slide has none. */
+  get body(): NotesPlaceholder | null;
+  /** The slide-thumbnail placeholder (`p:ph type="sldImg"`), or `null` when absent. */
+  get slideImage(): NotesPlaceholder | null;
+  /** The slide-number placeholder (`p:ph type="sldNum"`, carrying the slide-number field), or `null`. */
+  get slideNumber(): NotesPlaceholder | null;
+  /** The notes body as a navigable {@link TextFrame}, or `null` when there is no body text frame. */
+  get textFrame(): TextFrame | null;
+  /** The notes body text flattened (paragraphs joined by `\n`), or `''` when the body is empty/absent. */
+  get text(): string;
+}
+//#endregion
+//#region src/read/api/comments.d.ts
+/** One entry of the deck-wide comment-author registry (`p:cmAuthor`). */
+interface CommentAuthor {
+  /** Author id (`@id`), referenced by each comment's `@authorId`. */
+  id: number | null;
+  /** Display name (`@name`). */
+  name: string;
+  /** Initials shown in the comment marker (`@initials`). */
+  initials: string;
+  /** Highest per-author comment index used (`@lastIdx`). */
+  lastIdx: number | null;
+  /** Author colour slot (`@clrIdx`). */
+  clrIdx: number | null;
+}
+/** One legacy review comment (`p:cm`), with its author resolved via the registry. */
+interface Comment {
+  /** Resolved author display name (via `@authorId` → `commentAuthors.xml`), or `null` when unresolved. */
+  author: string | null;
+  /** Resolved author initials, or `null` when unresolved. */
+  authorInitials: string | null;
+  /** The comment's `@authorId`, or `null` when absent/unparseable. */
+  authorId: number | null;
+  /** The comment's per-author 1-based index (`@idx`), or `null` when absent. */
+  idx: number | null;
+  /** The comment body text (`p:text`). */
+  text: string;
+  /** Marker X position in EMU (`p:pos/@x`), or `null` when absent. */
+  x: number | null;
+  /** Marker Y position in EMU (`p:pos/@y`), or `null` when absent. */
+  y: number | null;
+  /** Authored timestamp (`@dt`, ISO-8601 as written), or `null` when absent. */
+  date: string | null;
 }
+/** One entry of the modern deck-wide author registry (`p188:author`). */
+interface ModernCommentAuthor {
+  /** Author id (`@id`) — a GUID string like `{E8A64ABA-…}`, referenced by each comment's `@authorId`. */
+  id: string | null;
+  /** Display name (`@name`). */
+  name: string;
+  /** Initials (`@initials`). */
+  initials: string;
+  /** Account identifier (`@userId`, e.g. an email), or `null`. */
+  userId: string | null;
+  /** Identity provider (`@providerId`, e.g. `Windows Live`), or `null`. */
+  providerId: string | null;
+}
+/** One modern comment or reply (`p188:cm` / `p188:reply`), with its author resolved via the registry. */
+interface ModernComment {
+  /** The comment's own GUID id (`@id`), or `null` when absent. */
+  id: string | null;
+  /** Resolved author display name (via `@authorId` → `authors.xml`), or `null` when unresolved. */
+  author: string | null;
+  /** Resolved author initials, or `null` when unresolved. */
+  authorInitials: string | null;
+  /** The comment's `@authorId` GUID, or `null` when absent. */
+  authorId: string | null;
+  /** Creation timestamp (`@created`, ISO-8601 as written), or `null` when absent. */
+  created: string | null;
+  /** The comment body text; multiple paragraphs are joined with `\n`. */
+  text: string;
+  /** Marker X position in EMU (`p188:pos/@x`), or `null` (replies carry no position). */
+  x: number | null;
+  /** Marker Y position in EMU (`p188:pos/@y`), or `null` (replies carry no position). */
+  y: number | null;
+  /** Nested replies in thread order; each is itself a {@link ModernComment} with no further replies. */
+  replies: ModernComment[];
+}
+/** Which comment schema a deck carries. `'none'` when it has neither part. */
+type CommentSchema = 'legacy' | 'modern' | 'none';
+//#endregion
+//#region src/read/api/tags.d.ts
+/** One programmatic tag (`p:tag`) — a name/value string pair. */
+interface Tag {
+  /** The tag's `@name`. */
+  name: string;
+  /** The tag's `@val`. */
+  val: string;
+}
+/**
+ * Read every tag referenced by `ownerPartName` (a slide part or the presentation
+ * part), resolving the owner's `tags` relationship(s) to their `ppt/tags/tagN.xml`
+ * part(s) and flattening each part's `p:tag` children into `{ name, val }`. `[]`
+ * when the owner references no tag part. Rel-driven rather than walking
+ * `p:custDataLst`, so it is robust to element ordering in the owner.
+ */
+declare function readTagsForPart(opc: OpcPackage, ownerPartName: string): Tag[];
 //#endregion
 //#region src/read/api/transition.d.ts
 /** `ST_TransitionSpeed` — the coarse speed bucket (`spd`), default `fast`. */
@@ -4630,5 +4868,5 @@ interface FromTemplateOptions {
   keepTemplateContentType?: boolean;
 }
 //#endregion
-export { CellThreeD as $, ShapeType as $t, Theme as A, AutofitMode as At, ModernCommentAuthor as B, ChildFrame as Bt, TransitionInfo as C, ChartLine as Ct, Placeholder as D, AutoShape as Dt, ColorMapToken as E, Picture as Et, readTagsForPart as F, Paragraph as Ft, isAutoShape as G, Glow as Gt, NotesSlide as H, CustomGeometry as Ht, Comment as I, Run as It, isGroupShape as J, LineEnds as Jt, isConnector as K, InnerShadow as Kt, CommentAuthor as L, RunHyperlink as Lt, ThemeFontFace as M, BulletDetail as Mt, ThemeFontScheme as N, BulletStyle as Nt, SlideLayout as O, Shape as Ot, Tag as P, LineSpacing as Pt, CellBorders as Q, Reflection as Qt, CommentSchema as R, TextFrame as Rt, Slide as S, ChartLegend as St, TransitionSpeed as T, Connector as Tt, AnyShape as U, CustomGeometryPath as Ut, NotesPlaceholder as V, ConnectionSite as Vt, GroupShape as W, GeometryCommand as Wt, GraphicFrame as X, Recolor as Xt, isPicture as Y, OuterShadow as Yt, CellBorder as Z, RecolorColor as Zt, CustomProperty as _, AxisNumberFormat as _t, ExtractedSlides as a, FillRect as an, TableConditionFlags as at, AddPictureOptions as b, ChartDataLabels as bt, ImportSlideMastersOptions as c, GradientFill as cn, DiagramConnection as ct, ImportedSlideMaster as d, resolveColorElement as dn, DiagramPointType as dt, SoftEdge as en, Table as et, LayoutHandle as f, ColorContext as fn, ChartEx as ft, CoreProperties as g, ChartExSeries as gt, Presentation as h, ChartExLegend as ht, ExtractedSlide as i, SlideBackground as in, ResolvedTableStyle as it, ThemeColorSlot as j, BodyProperties as jt, SlideMaster as k, ShapeHost as kt, ImportSlideOptions as l, GradientStop as ln, DiagramConnectionType as lt, SlideSource as m, ChartExDataLabels as mt, EmbeddedFontFaceInfo as n, BackgroundFill as nn, TableCellBorderEdit as nt, FromTemplateOptions as o, PictureFill as on, TableCellEdge as ot, SlideSize as p, EmbeddedFontSlot as pn, ChartExAxis as pt, isGraphicFrame as q, LineEnd as qt, EmbeddedFontInfo as r, BackgroundSource as rn, TableRow as rt, ImportShapeOptions as s, PictureFillTile as sn, Diagram as st, AppendSlidesOptions as t, PatternFill as tn, TableCell as tt, ImportSlidesRequest as u, ResolvedColor as un, DiagramPoint as ut, readCoreProperties as v, Chart as vt, TransitionInput as w, ChartSeries as wt, AddTextBoxOptions as x, ChartFill as xt, readCustomProperties as y, ChartAxis as yt, ModernComment as z, AbsoluteFrame as zt };
-//# sourceMappingURL=presentation-types-D7cgT-eG.d.ts.map
+export { TableCell as $, ShapeType as $t, CommentSchema as A, AutofitMode as At, ThemeFontScheme as B, ChildFrame as Bt, TransitionInfo as C, ChartLine as Ct, readTagsForPart as D, AutoShape as Dt, Tag as E, Picture as Et, Placeholder as F, Paragraph as Ft, isGraphicFrame as G, Glow as Gt, GroupShape as H, CustomGeometry as Ht, SlideLayout as I, Run as It, GraphicFrame as J, LineEnds as Jt, isGroupShape as K, InnerShadow as Kt, SlideMaster as L, RunHyperlink as Lt, ModernCommentAuthor as M, BulletDetail as Mt, NotesPlaceholder as N, BulletStyle as Nt, Comment as O, Shape as Ot, NotesSlide as P, LineSpacing as Pt, Table as Q, Reflection as Qt, Theme as R, TextFrame as Rt, Slide as S, ChartLegend as St, TransitionSpeed as T, Connector as Tt, isAutoShape as U, CustomGeometryPath as Ut, AnyShape as V, ConnectionSite as Vt, isConnector as W, GeometryCommand as Wt, CellBorders as X, Recolor as Xt, CellBorder as Y, OuterShadow as Yt, CellThreeD as Z, RecolorColor as Zt, CustomProperty as _, AxisNumberFormat as _t, ExtractedSlides as a, FillRect as an, Diagram as at, AddPictureOptions as b, ChartDataLabels as bt, ImportSlideMastersOptions as c, GradientFill as cn, DiagramDrawnShape as ct, ImportedSlideMaster as d, resolveColorElement as dn, DiagramPointType as dt, SoftEdge as en, TableCellBorderEdit as et, LayoutHandle as f, ColorTransform as fn, ChartEx as ft, CoreProperties as g, EmbeddedFontSlot as gn, ChartExSeries as gt, Presentation as h, ColorContext as hn, ChartExLegend as ht, ExtractedSlide as i, SlideBackground as in, TableCellEdge as it, ModernComment as j, BodyProperties as jt, CommentAuthor as k, ShapeHost as kt, ImportSlideOptions as l, GradientStop as ln, DiagramNode as lt, SlideSource as m, applyColorTransforms as mn, ChartExDataLabels as mt, EmbeddedFontFaceInfo as n, BackgroundFill as nn, ResolvedTableStyle as nt, FromTemplateOptions as o, PictureFill as on, DiagramConnection as ot, SlideSize as p, EffectiveColor as pn, ChartExAxis as pt, isPicture as q, LineEnd as qt, EmbeddedFontInfo as r, BackgroundSource as rn, TableConditionFlags as rt, ImportShapeOptions as s, PictureFillTile as sn, DiagramConnectionType as st, AppendSlidesOptions as t, PatternFill as tn, TableRow as tt, ImportSlidesRequest as u, ResolvedColor as un, DiagramPoint as ut, readCoreProperties as v, Chart as vt, TransitionInput as w, ChartSeries as wt, AddTextBoxOptions as x, ChartFill as xt, readCustomProperties as y, ChartAxis as yt, ThemeFontFace as z, AbsoluteFrame as zt };
+//# sourceMappingURL=presentation-types-DP_8jog7.d.ts.map