@shbernal/ts-pptx 3.5.0 → 3.6.0

package/dist/{presentation-types-CpkTx9Xa.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_}. */
@@ -2374,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;
@@ -2797,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.
@@ -2980,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
@@ -3235,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);
@@ -3270,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;
   /**
@@ -3306,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[];
   /**
@@ -3328,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
@@ -3377,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
@@ -3398,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 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 layout's colour/font context (walked layout → master → theme), resolved once
-   * and cached. Backs each {@link Placeholder}'s text frame.
+   * 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`. */
@@ -4791,5 +4868,5 @@ interface FromTemplateOptions {
   keepTemplateContentType?: boolean;
 }
 //#endregion
-export { CellThreeD as $, RecolorColor as $t, Theme as A, Shape as At, ModernCommentAuthor as B, TextFrame as Bt, TransitionInfo as C, ChartFill as Ct, Placeholder as D, Connector as Dt, ColorMapToken as E, ChartSeries as Et, readTagsForPart as F, BulletStyle as Ft, isAutoShape as G, CustomGeometryPath as Gt, NotesSlide as H, ChildFrame as Ht, Comment as I, LineSpacing as It, isGroupShape as J, InnerShadow as Jt, isConnector as K, GeometryCommand as Kt, CommentAuthor as L, Paragraph as Lt, ThemeFontFace as M, AutofitMode as Mt, ThemeFontScheme as N, BodyProperties as Nt, SlideLayout as O, Picture as Ot, Tag as P, BulletDetail as Pt, CellBorders as Q, Recolor as Qt, CommentSchema as R, Run as Rt, Slide as S, ChartDataLabels as St, TransitionSpeed as T, ChartLine as Tt, AnyShape as U, ConnectionSite as Ut, NotesPlaceholder as V, AbsoluteFrame as Vt, GroupShape as W, CustomGeometry as Wt, GraphicFrame as X, LineEnds as Xt, isPicture as Y, LineEnd as Yt, CellBorder as Z, OuterShadow as Zt, CustomProperty as _, ChartExLegend as _t, ExtractedSlides as a, BackgroundSource as an, TableConditionFlags as at, AddPictureOptions as b, Chart as bt, ImportSlideMastersOptions as c, PictureFill as cn, DiagramConnection as ct, ImportedSlideMaster as d, GradientStop as dn, DiagramNode as dt, Reflection as en, Table as et, LayoutHandle as f, ResolvedColor as fn, DiagramPoint as ft, CoreProperties as g, ChartExDataLabels as gt, Presentation as h, EmbeddedFontSlot as hn, ChartExAxis as ht, ExtractedSlide as i, BackgroundFill as in, ResolvedTableStyle as it, ThemeColorSlot as j, ShapeHost as jt, SlideMaster as k, AutoShape as kt, ImportSlideOptions as l, PictureFillTile as ln, DiagramConnectionType as lt, SlideSource as m, ColorContext as mn, ChartEx as mt, EmbeddedFontFaceInfo as n, SoftEdge as nn, TableCellBorderEdit as nt, FromTemplateOptions as o, SlideBackground as on, TableCellEdge as ot, SlideSize as p, resolveColorElement as pn, DiagramPointType as pt, isGraphicFrame as q, Glow as qt, EmbeddedFontInfo as r, PatternFill as rn, TableRow as rt, ImportShapeOptions as s, FillRect as sn, Diagram as st, AppendSlidesOptions as t, ShapeType as tn, TableCell as tt, ImportSlidesRequest as u, GradientFill as un, DiagramDrawnShape as ut, readCoreProperties as v, ChartExSeries as vt, TransitionInput as w, ChartLegend as wt, AddTextBoxOptions as x, ChartAxis as xt, readCustomProperties as y, AxisNumberFormat as yt, ModernComment as z, RunHyperlink as zt };
-//# sourceMappingURL=presentation-types-CpkTx9Xa.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