@shbernal/ts-pptx 2.0.0 → 3.1.0

package/dist/{presentation-CVaTZw1V.d.ts → presentation-DyIRDKkp.d.ts}

@@ -1,42 +1,36 @@
-import { t as CustomPropertyValue } from "./pres-GU-jjBEx.js";
-import { c as ImportSlideMastersOptions, d as LayoutHandle, f as SlideSize, l as ImportSlideOptions, o as FromTemplateOptions, p as SlideSource, r as EmbeddedFontInfo, s as ImportShapeOptions, t as AppendSlidesOptions, u as ImportedSlideMaster } from "./presentation-types-BVw0EknS.js";
+import { t as CustomPropertyValue } from "./pres-BgvxhQ_m.js";
+import { c as ImportSlideMastersOptions, d as LayoutHandle, f as SlideSize, l as ImportSlideOptions, o as FromTemplateOptions, p as SlideSource, r as EmbeddedFontInfo, s as ImportShapeOptions, t as AppendSlidesOptions, u as ImportedSlideMaster } from "./presentation-types-Dj4riuDs.js";
 import { a as Part, i as Relationships, n as OpcPackage, o as Element, t as OpcInput } from "./package-CaOLXSNi.js";
 //#region src/read/oxml/theme.d.ts
 /**
  * The colour-resolution context: the two maps that turn a DrawingML colour
  * reference into a literal hex — the effective colour map (token → `clrScheme`
  * slot, honouring any slide `clrMapOvr`) and the resolved colour scheme (slot →
- * 6-hex RGB). Shared by the read-model colour getters and {@link FlattenContext}.
+ * 6-hex RGB). Shared by the read-model colour getters and {@link ThemeContext}.
  */
 interface ColorContext {
   clrMap: Map<string, string>;
   clrScheme: Map<string, string>;
 }
 /**
- * Everything {@link flattenSlide} needs from the slide's source theme subgraph:
- * the {@link ColorContext} maps plus the live `a:fmtScheme` element (for
- * style-matrix resolution).
+ * The source theme subgraph a slide, notes slide, layout or master resolves against: the
+ * {@link ColorContext} maps, the live `a:fmtScheme` for style-matrix resolution, and the roots
+ * of the inheritance chain a placeholder reads through.
+ *
+ * Every root here is **read-only** — nothing in this module or in `placeholder-inherit.ts`
+ * mutates one. The import-time flatten pass extends this with the one field it needs to write
+ * from (see `FlattenContext` in `read/api/ops/flatten.ts`).
  */
-interface FlattenContext extends ColorContext {
+interface ThemeContext extends ColorContext {
   fmtScheme: Element | null;
   /**
-   * The slide's effective background inherited from the *source*
-   * `slideLayout`/`slideMaster` (the raw `p:bg` element), or `null` when the
-   * slide carries its own. Applied onto the slide before flattening so the
-   * background survives rebinding to the destination master. See
-   * {@link flattenSlide}.
-   */
-  inheritedBackground?: Element | null;
-  /**
-   * The source `slideLayout` root element, for resolving placeholder-inherited
-   * run colours (gap 1). Read-only — never mutated. `null`/absent disables the
-   * placeholder run-colour pass for the layout tier.
+   * The source `slideLayout` root element, for resolving what a placeholder inherits.
+   * `null`/absent disables the layout tier.
    */
   layoutRoot?: Element | null;
   /**
-   * The source `slideMaster` root element, for resolving placeholder-inherited
-   * run colours via its placeholder `a:lstStyle` and `p:txStyles`. Read-only —
-   * never mutated.
+   * The source `slideMaster` root element, for resolving placeholder inheritance via its
+   * placeholder `a:lstStyle` and `p:txStyles`.
    */
   masterRoot?: Element | null;
   /**
@@ -304,89 +298,436 @@ interface ShapeProperties {
   lnAfter: string[] | null;
 }
 //#endregion
-//#region src/read/api/text.d.ts
+//#region src/read/api/pattern-fill.d.ts
 /**
- * What a {@link Run}'s text body needs to resolve an *inherited* run
- * colour/size/face/bold: which placeholder the text lives in (or `null` for a
- * non-placeholder shape, which still resolves its `p:style/a:fontRef` and the
- * presentation `p:defaultTextStyle`), the slide theme context (with the
- * layout/master roots) to resolve against, and the shape's resolved
- * `p:style/a:fontRef` text tier. The owning slide's text body `a:lstStyle` is added
- * per text frame. Absent only for text reached without a theme context (table cells).
+ * A pattern fill (`a:pattFill`) — a two-colour preset hatch. The write-side
+ * `fill: { type: 'pattern', pattern: { preset, fgColor, bgColor } }` emits the same element,
+ * so the {@link preset} name and both colours round-trip. Colours resolve against the theme
+ * (a scheme token → literal hex) the same way a solid fill does.
  */
-interface PlaceholderTextContext {
-  ph: PlaceholderRef | null;
-  flatten: FlattenContext;
-  /** The shape's resolved `p:style/a:fontRef` colour + face tier, or `null` when it has none. */
-  fontRef?: StyleFontRef | null;
+interface PatternFill {
+  /** Preset pattern name (`@prst`, e.g. `pct50`/`diagCross`/`ltUpDiag`), or `null` when unset. */
+  preset: string | null;
+  /** Foreground colour (`a:fgClr`) resolved against the theme, or `null`. */
+  foreground: ResolvedColor | null;
+  /** Background colour (`a:bgClr`) resolved against the theme, or `null`. */
+  background: ResolvedColor | null;
+}
+//#endregion
+//#region src/read/api/shapes/types.d.ts
+/** Discriminator for the concrete `Shape` subclass. */
+type ShapeType = 'autoShape' | 'picture' | 'connector' | 'graphicFrame' | 'group';
+/** One end of a connector/line (`a:ln/a:headEnd` or `a:tailEnd`), as read from a shape. */
+interface LineEnd {
+  /** Arrowhead type (`@type`: `none`/`triangle`/`stealth`/`diamond`/`oval`/`arrow`). */
+  type: string;
+  /** Width class (`@w`: `sm`/`med`/`lg`), or `null` when unset. */
+  width: string | null;
+  /** Length class (`@len`: `sm`/`med`/`lg`), or `null` when unset. */
+  length: string | null;
+}
+/** Both ends of a shape's line/border, when either carries an arrowhead. */
+interface LineEnds {
+  head: LineEnd | null;
+  tail: LineEnd | null;
 }
 /**
- * A run's click hyperlink (`a:rPr/a:hlinkClick`): a link on a span of text. A URL
- * link carries an external {@link url}; a slide jump carries the internal
- * {@link targetPartName} (the linked slide's part) alongside its `hlinksldjump`
- * {@link action}. `tooltip` and `relId` are surfaced when present.
+ * One bound end of a connector (`p:nvCxnSpPr/p:cNvCxnSpPr/a:stCxn` or `a:endCxn`),
+ * as read. A connector authored with `startShape`/`endShape` attaches each end to
+ * a shape by that shape's `p:cNvPr/@id` plus a connection-site index; an unbound
+ * end (the writer emits a bare `p:cNvCxnSpPr`) reports no site at all — see
+ * {@link Connector.startConnection}. This is the read counterpart of the write
+ * API's `startShape`/`startShapeIdx` split, which binds by `objectName` and
+ * resolves the name → id at serialize time.
  */
-interface RunHyperlink {
-  /** External URL target (its `@r:id` resolves to a `TargetMode="External"` rel), or `null` for an internal/action-only link. */
-  url: string | null;
-  /** Absolute partname of an internal target (e.g. the slide a jump points at), or `null`. */
-  targetPartName: string | null;
-  /** Navigation action token (`@action`, e.g. `ppaction://hlinksldjump`), or `null` when absent/empty. */
-  action: string | null;
-  /** Tooltip text (`@tooltip`), or `null` when absent/empty. */
-  tooltip: string | null;
-  /** The relationship id (`@r:id`) backing the link, or `null` when the link is action-only. */
-  relId: string | null;
+interface ConnectionSite {
+  /** The bound shape's drawing id (`@id`, i.e. its `p:cNvPr/@id`). */
+  shapeId: number;
+  /** Connection-site index on the bound shape (`@idx`; 0-based, preset-dependent). */
+  siteIndex: number;
+  /**
+   * The bound shape resolved to a read-model shape via {@link Slide.shapeByIdDeep},
+   * which descends into groups — so a connector bound to a shape nested in a group
+   * resolves the same as one bound to a top-level shape. `null` only when no shape
+   * anywhere on the slide carries that id (a genuinely dangling binding), which is
+   * faithful degradation and does not throw.
+   */
+  boundShape: AnyShape | null;
 }
 /**
- * A paragraph's line spacing (`a:pPr/a:lnSpc`), in whichever of the two OOXML
- * forms the file uses: an exact point height (`a:spcPts`) or a percentage of the
- * single-line height (`a:spcPct` — e.g. `percent: 150` for 1.5× spacing).
+ * A shape's outer drop shadow (`spPr/a:effectLst/a:outerShdw`), as read from a
+ * shape and resolved against the slide theme. Distances are in points (the EMU
+ * source ÷ 12700) and the direction in degrees (the `60000`ths source ÷ 60000),
+ * matching the write-side {@link ShadowProps} convention so it round-trips.
  */
-type LineSpacing = {
-  type: 'points';
-  valuePt: number;
+interface OuterShadow {
+  /** Effective shadow colour as 6-hex (theme-resolved, transforms applied), or `null`. */
+  color: string | null;
+  /** Theme colour token when the shadow colour was a scheme colour (e.g. `accent1`), else `undefined`. */
+  colorToken?: string;
+  /** Shadow opacity 0–1 (from the colour's `a:alpha`), or `undefined` when fully opaque. */
+  alpha?: number;
+  /** Blur radius in points (`@blurRad` ÷ 12700), or `undefined` when unset. */
+  blurPt?: number;
+  /** Offset distance in points (`@dist` ÷ 12700), or `undefined` when unset. */
+  offsetPt?: number;
+  /** Offset direction in degrees, clockwise from 3 o'clock (`@dir` ÷ 60000), or `undefined` when unset. */
+  angleDeg?: number;
+}
+/**
+ * A shape's inner shadow (`spPr/a:effectLst/a:innerShdw`), resolved against the
+ * slide theme. Identical fields to {@link OuterShadow} — CT_InnerShadowEffect
+ * carries the same `blurRad`/`dist`/`dir` + colour — but a distinct type so a
+ * consumer can tell an inset shadow from a drop shadow. Distances in points,
+ * direction in degrees, matching the write-side `shadow: { type: 'inner' }`.
+ */
+interface InnerShadow {
+  /** Effective shadow colour as 6-hex (theme-resolved, transforms applied), or `null`. */
+  color: string | null;
+  /** Theme colour token when the shadow colour was a scheme colour (e.g. `accent1`), else `undefined`. */
+  colorToken?: string;
+  /** Shadow opacity 0–1 (from the colour's `a:alpha`), or `undefined` when fully opaque. */
+  alpha?: number;
+  /** Blur radius in points (`@blurRad` ÷ 12700), or `undefined` when unset. */
+  blurPt?: number;
+  /** Offset distance in points (`@dist` ÷ 12700), or `undefined` when unset. */
+  offsetPt?: number;
+  /** Offset direction in degrees, clockwise from 3 o'clock (`@dir` ÷ 60000), or `undefined` when unset. */
+  angleDeg?: number;
+}
+/**
+ * A shape's glow effect (`spPr/a:effectLst/a:glow`) — a coloured halo — resolved
+ * against the slide theme. The write-side text glow (`glow: { size, color,
+ * opacity }`) emits the same element, so {@link radiusPt} (`@rad` ÷ 12700) and the
+ * colour round-trip.
+ */
+interface Glow {
+  /** Effective glow colour as 6-hex (theme-resolved, transforms applied), or `null`. */
+  color: string | null;
+  /** Theme colour token when the glow colour was a scheme colour (e.g. `accent1`), else `undefined`. */
+  colorToken?: string;
+  /** Glow opacity 0–1 (from the colour's `a:alpha`), or `undefined` when fully opaque. */
+  alpha?: number;
+  /** Glow radius in points (`@rad` ÷ 12700), or `undefined` when unset. */
+  radiusPt?: number;
+}
+/**
+ * A shape's reflection effect (`spPr/a:effectLst/a:reflection`) — a mirrored fade
+ * beneath the shape. This library's writer authors none, so this is a **read-only**
+ * surface: a consumer that finds one should carry the part verbatim rather than
+ * regenerate it. Only the attributes a faithful replica needs are decoded —
+ * distances in points (÷ 12700), directions in degrees (÷ 60000), and the start/end
+ * alpha and position pairs as 0–1 fractions (the `1000`ths-of-a-percent source
+ * ÷ 100000). All fields are optional; an attribute absent from the source is omitted.
+ */
+interface Reflection {
+  /** Blur radius in points (`@blurRad` ÷ 12700). */
+  blurPt?: number;
+  /** Start opacity 0–1 (`@stA` ÷ 100000). */
+  startAlpha?: number;
+  /** Start position along the reflection 0–1 (`@stPos` ÷ 100000). */
+  startPos?: number;
+  /** End opacity 0–1 (`@endA` ÷ 100000). */
+  endAlpha?: number;
+  /** End position along the reflection 0–1 (`@endPos` ÷ 100000). */
+  endPos?: number;
+  /** Offset distance in points (`@dist` ÷ 12700). */
+  distPt?: number;
+  /** Offset direction in degrees (`@dir` ÷ 60000). */
+  angleDeg?: number;
+  /** Fade direction in degrees (`@fadeDir` ÷ 60000). */
+  fadeAngleDeg?: number;
+}
+/**
+ * A shape's soft-edge effect (`spPr/a:effectLst/a:softEdge`) — a feathered border.
+ * Like {@link Reflection}, the writer authors none, so carry it verbatim. `@rad`
+ * (the feather radius) ÷ 12700 → points.
+ */
+interface SoftEdge {
+  /** Feather radius in points (`@rad` ÷ 12700). */
+  radiusPt: number;
+}
+/**
+ * One segment of a custom-geometry path (`a:path`), as read from a shape. The
+ * command verbs mirror the write-side `GeometryPoint` DSL (`src/types/`)
+ * so a consumer can map a `GeometryCommand[]` to `GeometryPoint[]` one-to-one.
+ *
+ * Coordinates (`x`/`y`/`x1`…) are raw path-unit integers in the path's own
+ * `0..w` / `0..h` space (see {@link CustomGeometryPath.w}); they are not EMU and
+ * must be scaled by the consumer against the shape's box. `arcTo` angles are in
+ * **degrees** (the raw `60000`ths-of-a-degree values divided by 60000), matching
+ * the write DSL's degree input.
+ */
+type GeometryCommand = {
+  cmd: 'moveTo';
+  x: number;
+  y: number;
 } | {
-  type: 'percent';
-  percent: number;
+  cmd: 'lnTo';
+  x: number;
+  y: number;
+} | {
+  cmd: 'cubicBezTo';
+  x1: number;
+  y1: number;
+  x2: number;
+  y2: number;
+  x: number;
+  y: number;
+} | {
+  cmd: 'quadBezTo';
+  x1: number;
+  y1: number;
+  x: number;
+  y: number;
+} | {
+  cmd: 'arcTo';
+  wR: number;
+  hR: number;
+  stAng: number;
+  swAng: number;
+} | {
+  cmd: 'close';
 };
-/** One text run (`a:r`): a span of text with uniform character formatting. */
-declare class Run {
-  #private;
-  private readonly element;
-  private readonly part;
-  /** The owning slide's theme context (colour maps + `fontScheme`), for the `resolved*` getters; absent when the run was reached without one. */
-  private readonly themeContext?;
-  /**
-   * Resolves the colour this run inherits from its placeholder/list-style chain
-   * when it sets none of its own (item A). Built by the owning {@link Paragraph}
-   * for placeholder text; absent for non-placeholder runs. Called lazily.
-   */
-  private readonly inheritedColor?;
-  /**
-   * Resolves the point size this run inherits from the same chain when it sets no
-   * own `@sz`. Built by the owning {@link Paragraph} for placeholder text; absent
-   * for non-placeholder runs. Called lazily.
-   */
-  private readonly inheritedSize?;
-  /**
-   * Resolves the typeface this run inherits from the same chain (a `+mj-*`/`+mn-*`
-   * theme token already resolved to a literal face) when it sets no own `a:latin`.
-   * Built by the owning {@link Paragraph} for placeholder text; absent otherwise.
-   * Called lazily.
-   */
-  private readonly inheritedFace?;
-  /**
-   * Resolves whether this run inherits bold from the same chain when it sets no
-   * own `@b`. Built by the owning {@link Paragraph} for placeholder text; absent
-   * for non-placeholder runs. Called lazily.
-   */
-  private readonly inheritedBold?;
-  /**
-   * 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
-   * reached without them (e.g. table-cell or notes text), in which case
-   * {@link hyperlink} still reports the raw `@r:id`/`@action`/`@tooltip`.
+/** One `<a:path>` of a custom geometry, with its path-unit viewport and render attrs. */
+interface CustomGeometryPath {
+  /** Path-unit width (`a:path/@w`); the `x` denominator for this path's coords. Default `0`. */
+  w: number;
+  /** Path-unit height (`a:path/@h`); the `y` denominator for this path's coords. Default `0`. */
+  h: number;
+  /** Fill mode (`a:path/@fill`, `ST_PathFillMode`, e.g. `norm`/`none`/`lighten`). Default `norm`. */
+  fill: string;
+  /** Whether the path is stroked (`a:path/@stroke`). Default `true`. */
+  stroke: boolean;
+  /** The path's segments in document order — order *is* the geometry. */
+  commands: GeometryCommand[];
+}
+/**
+ * Custom freeform geometry (`spPr/a:custGeom/a:pathLst`), as read from a shape.
+ * Faithfully exposes every `a:path` rather than flattening to a single command
+ * list: the schema allows repeatable `a:path`, each with independent
+ * `fill`/`stroke`. Desktop PowerPoint's own freeforms only ever emit one
+ * `a:path` (a hole is one path with two `moveTo`…`close` contours), but
+ * multi-`a:path` input is schema-legal (e.g. SVG import) and preserved here.
+ */
+interface CustomGeometry {
+  paths: CustomGeometryPath[];
+}
+/** A shape's resolved position and size in slide-absolute EMU. */
+interface AbsoluteFrame {
+  left: number;
+  top: number;
+  width: number;
+  height: number;
+  /** Effective clockwise rotation in degrees after composing enclosing group rotations. */
+  rotation: number;
+  /** Effective horizontal flip after XOR-composing enclosing group flips. */
+  flipH: boolean;
+  /** Effective vertical flip after XOR-composing enclosing group flips. */
+  flipV: boolean;
+}
+/**
+ * A group shape's own child coordinate space (`p:grpSpPr/a:xfrm/a:chOff` and
+ * `a:chExt`) in EMU — the space its children's `a:off`/`a:ext` are authored in.
+ *
+ * Named after the OOXML attributes rather than in the `left`/`top`/`width`/
+ * `height` vocabulary the rest of the read model uses, because this is not a
+ * frame on the slide: it is the source rectangle of the
+ * `off + (p - chOff) * (ext / chExt)` mapping, and nothing about it is
+ * positional. A consumer reaching for it is rebuilding that mapping, so the
+ * names it needs are the ones the mapping is written in.
+ */
+interface ChildFrame {
+  /** `a:chOff/@x`. */
+  offsetX: number;
+  /** `a:chOff/@y`. */
+  offsetY: number;
+  /** `a:chExt/@cx`. */
+  extentX: number;
+  /** `a:chExt/@cy`. */
+  extentY: number;
+}
+/**
+ * A colour reference inside a picture recolour effect, split by colour model
+ * (mirrors {@link GradientStop}). At most one field is non-`null`.
+ */
+interface RecolorColor {
+  /** Explicit RGB as 6-hex (`a:srgbClr/@val`), or `null`. */
+  color: string | null;
+  /** Theme colour token (`a:schemeClr/@val`, e.g. `accent1`), or `null`. */
+  schemeColor: string | null;
+  /** Preset colour name (`a:prstClr/@val`, e.g. `black`/`white` — the duotone icon-tint stops), or `null`. */
+  presetColor: string | null;
+}
+/**
+ * A picture's blip recolour effect (`p:blipFill/a:blip` recolour child), as read.
+ * A small discriminated union over the effects a faithful reader needs to
+ * reproduce a recoloured image. Colours use the same `color`/`schemeColor`/
+ * `presetColor` split as {@link GradientStop}, so theme tokens can resolve through
+ * {@link Slide.themeContext}. `threshold`/`amount` are 0–1 fractions.
+ */
+type Recolor = {
+  kind: 'duotone';
+  stops: RecolorColor[];
+} | {
+  kind: 'clrChange';
+  from: RecolorColor | null;
+  to: RecolorColor | null;
+} | {
+  kind: 'grayscale';
+} | {
+  kind: 'biLevel';
+  threshold: number | null;
+} | {
+  kind: 'alphaModFix';
+  amount: number;
+};
+//#endregion
+//#region src/read/api/text.d.ts
+/**
+ * What a {@link Run}'s text body needs to resolve an *inherited* run
+ * colour/size/face/bold: which placeholder the text lives in (or `null` for a
+ * non-placeholder shape, which still resolves its `p:style/a:fontRef` and the
+ * presentation `p:defaultTextStyle`), the slide theme context (with the
+ * layout/master roots) to resolve against, and the shape's resolved
+ * `p:style/a:fontRef` text tier. The owning slide's text body `a:lstStyle` is added
+ * per text frame. Absent only for text reached without a theme context (table cells).
+ */
+interface PlaceholderTextContext {
+  ph: PlaceholderRef | null;
+  flatten: ThemeContext;
+  /** The shape's resolved `p:style/a:fontRef` colour + face tier, or `null` when it has none. */
+  fontRef?: StyleFontRef | null;
+}
+/**
+ * A run's click hyperlink (`a:rPr/a:hlinkClick`): a link on a span of text. A URL
+ * link carries an external {@link url}; a slide jump carries the internal
+ * {@link targetPartName} (the linked slide's part) alongside its `hlinksldjump`
+ * {@link action}. `tooltip` and `relId` are surfaced when present.
+ */
+interface RunHyperlink {
+  /** External URL target (its `@r:id` resolves to a `TargetMode="External"` rel), or `null` for an internal/action-only link. */
+  url: string | null;
+  /** Absolute partname of an internal target (e.g. the slide a jump points at), or `null`. */
+  targetPartName: string | null;
+  /** Navigation action token (`@action`, e.g. `ppaction://hlinksldjump`), or `null` when absent/empty. */
+  action: string | null;
+  /** Tooltip text (`@tooltip`), or `null` when absent/empty. */
+  tooltip: string | null;
+  /** The relationship id (`@r:id`) backing the link, or `null` when the link is action-only. */
+  relId: string | null;
+}
+/**
+ * A paragraph's line spacing (`a:pPr/a:lnSpc`), in whichever of the two OOXML
+ * forms the file uses: an exact point height (`a:spcPts`) or a percentage of the
+ * single-line height (`a:spcPct` — e.g. `percent: 150` for 1.5× spacing).
+ */
+type LineSpacing = {
+  type: 'points';
+  valuePt: number;
+} | {
+  type: 'percent';
+  percent: number;
+};
+/**
+ * The bullet's own font, size and colour (`a:buFont` / `a:buSzPct` / `a:buSzPts` /
+ * `a:buClr`) — the properties that style the glyph or number itself rather than
+ * the text after it. Every field is `null` when the paragraph leaves it to be
+ * inherited from the list style.
+ *
+ * These are siblings of the bullet kind in `a:pPr`, not children of it, so they
+ * are carried alongside each kind rather than inside it.
+ */
+interface BulletStyle {
+  /** `a:buFont/@typeface` — the face the glyph is drawn in (a symbol font such as `Wingdings`), or `null`. */
+  font: string | null;
+  /** `a:buSzPct/@val` as a percentage of the run size (e.g. `80`; the raw attribute is thousandths of a percent), or `null`. */
+  sizePct: number | null;
+  /** `a:buSzPts/@val` as an absolute point size (the raw attribute is hundredths of a point), or `null`. The alternative to {@link sizePct}; at most one is set. */
+  sizePt: number | null;
+  /** Explicit RGB bullet colour as 6-hex (`a:buClr/a:srgbClr/@val`), or `null`. */
+  color: string | null;
+  /** Theme colour token when the bullet colour is a scheme colour (`a:buClr/a:schemeClr/@val`), or `null`. */
+  schemeColor: string | null;
+  /** The bullet colour resolved against the slide theme with its transforms applied, or `null` when unset or not resolvable to a literal. */
+  resolvedColor: ResolvedColor | null;
+}
+/**
+ * A paragraph's bullet, as the structured counterpart of the `a:pPr` bullet
+ * children. Discriminated on {@link kind}, which is one of the four mutually
+ * exclusive choices the schema allows:
+ *
+ * - `'none'`    — `a:buNone`, the bullet explicitly suppressed. Carries no style,
+ *                 because there is no glyph to style.
+ * - `'char'`    — `a:buChar`, a literal glyph.
+ * - `'autoNum'` — `a:buAutoNum`, an auto-numbered list.
+ * - `'picture'` — `a:buBlip`, an image used as the glyph.
+ *
+ * A paragraph that names none of them inherits its bullet from the list style and
+ * reports `null` rather than a member of this union.
+ */
+type BulletDetail = {
+  kind: 'none';
+} | ({
+  kind: 'char';
+  /** The glyph itself (`a:buChar/@char`) — a bare character, never a tagged string. */
+  char: string;
+} & BulletStyle) | ({
+  kind: 'autoNum';
+  /** The numbering scheme (`a:buAutoNum/@type`, e.g. `arabicPeriod`). */
+  scheme: string;
+  /**
+   * The number this list starts at (`a:buAutoNum/@startAt`), or `null` when
+   * unset (the schema default is 1). Content rather than styling: a list
+   * continuing "5. Deploy" that restarts at 1 is a different slide.
+   */
+  startAt: number | null;
+} & BulletStyle) | ({
+  kind: 'picture';
+  /**
+   * Absolute partname of the image used as the glyph (`a:buBlip/a:blip/@r:embed`,
+   * resolved through the owning part's relationships), or `null` when the
+   * paragraph was reached without them or the blip carries no `r:embed`.
+   */
+  imagePartName: string | null;
+} & BulletStyle);
+/** One text run (`a:r`): a span of text with uniform character formatting. */
+declare class Run {
+  #private;
+  private readonly element;
+  private readonly part;
+  /** The owning slide's theme context (colour maps + `fontScheme`), for the `resolved*` getters; absent when the run was reached without one. */
+  private readonly themeContext?;
+  /**
+   * Resolves the colour this run inherits from its placeholder/list-style chain
+   * when it sets none of its own (item A). Built by the owning {@link Paragraph}
+   * for placeholder text; absent for non-placeholder runs. Called lazily.
+   */
+  private readonly inheritedColor?;
+  /**
+   * Resolves the point size this run inherits from the same chain when it sets no
+   * own `@sz`. Built by the owning {@link Paragraph} for placeholder text; absent
+   * for non-placeholder runs. Called lazily.
+   */
+  private readonly inheritedSize?;
+  /**
+   * Resolves the typeface this run inherits from the same chain (a `+mj-*`/`+mn-*`
+   * theme token already resolved to a literal face) when it sets no own `a:latin`.
+   * Built by the owning {@link Paragraph} for placeholder text; absent otherwise.
+   * Called lazily.
+   */
+  private readonly inheritedFace?;
+  /**
+   * Resolves whether this run inherits bold from the same chain when it sets no
+   * own `@b`. Built by the owning {@link Paragraph} for placeholder text; absent
+   * for non-placeholder runs. Called lazily.
+   */
+  private readonly inheritedBold?;
+  /**
+   * 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
+   * reached without them (e.g. table-cell or notes text), in which case
+   * {@link hyperlink} still reports the raw `@r:id`/`@action`/`@tooltip`.
    */
   private readonly relationships?;
   /**
@@ -398,7 +739,7 @@ declare class Run {
   private readonly fontRef?;
   constructor(element: Element, part: Part,
   /** The owning slide's theme context (colour maps + `fontScheme`), for the `resolved*` getters; absent when the run was reached without one. */
-  themeContext?: FlattenContext | undefined,
+  themeContext?: ThemeContext | undefined,
   /**
    * Resolves the colour this run inherits from its placeholder/list-style chain
    * when it sets none of its own (item A). Built by the owning {@link Paragraph}
@@ -437,7 +778,7 @@ declare class Run {
    * below the run's own `a:rPr` and above the placeholder/`p:defaultTextStyle`
    * chain. Absent when the shape has no `p:style/a:fontRef`.
    */
-  fontRef?: (StyleFontRef | null) | undefined);
+  fontRef?: StyleFontRef | null | undefined);
   /** The run's text (`a:t`), verbatim — whitespace is not normalized. */
   get text(): string;
   set text(value: string);
@@ -520,487 +861,228 @@ declare class Run {
    * The point size this run effectively renders. It is the run's own `@sz`
    * ({@link fontSizePt}) when set; otherwise, for a run inside a placeholder, the
    * size 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 size and inherits none — the
-   * resolved counterpart of {@link fontSizePt}, which reports only the run's own value.
-   */
-  get resolvedSizePt(): number | null;
-  /**
-   * The typeface this run effectively renders, resolved to a literal face name. It
-   * is the run's own `a:latin` ({@link fontName}) when set; otherwise the face named
-   * by the shape's `p:style/a:fontRef` (`idx` → theme major/minor font), then — for a
-   * run inside a placeholder — the face it inherits from the placeholder/list-style
-   * chain, then the presentation's `p:defaultTextStyle`. A `+mj-*`/`+mn-*`
-   * major/minor theme-font token — on the run itself or reached through the chain —
-   * is resolved through the theme `fontScheme` to its concrete face. `null` when the
-   * run names no face and inherits none, or a token cannot be resolved — the resolved
-   * counterpart of {@link fontName}, which reports the raw `@typeface` (possibly a token).
-   */
-  get resolvedFontFace(): string | null;
-  /**
-   * Whether this run effectively renders bold. It is the run's own `@b`
-   * ({@link bold}) when set; otherwise, for a run inside a placeholder, the bold
-   * 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 `@b` and inherits none — the
-   * resolved counterpart of {@link bold}, which reports only the run's own value.
-   */
-  get resolvedBold(): 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_}. */
-  markDirty(): void;
-}
-/** One paragraph (`a:p`) of a text frame. */
-declare class Paragraph {
-  #private;
-  private readonly element;
-  private readonly part;
-  /** The owning slide's theme context (colour maps + `fontScheme`), threaded to each {@link Run} for the `resolved*` getters. */
-  private readonly themeContext?;
-  /**
-   * Placeholder + slide-list-style context for resolving a placeholder-inherited
-   * run colour/size/face; absent for non-placeholder text. The owning
-   * {@link TextFrame} supplies the placeholder identity and the text body's
-   * `a:lstStyle`.
-   */
-  private readonly inherit?;
-  /** The owning part's relationships, threaded to each {@link Run} for hyperlink `@r:id` resolution; absent when reached without them. */
-  private readonly relationships?;
-  constructor(element: Element, part: Part,
-  /** The owning slide's theme context (colour maps + `fontScheme`), threaded to each {@link Run} for the `resolved*` getters. */
-  themeContext?: FlattenContext | undefined,
-  /**
-   * Placeholder + slide-list-style context for resolving a placeholder-inherited
-   * run colour/size/face; absent for non-placeholder text. The owning
-   * {@link TextFrame} supplies the placeholder identity and the text body's
-   * `a:lstStyle`.
-   */
-  inherit?: {
-    placeholder: PlaceholderTextContext;
-    slideLstStyle: Element | null;
-  } | undefined,
-  /** The owning part's relationships, threaded to each {@link Run} for hyperlink `@r:id` resolution; absent when reached without them. */
-  relationships?: Relationships | undefined);
-  /** The runs (`a:r`) in document order. Fields (`a:fld`) and breaks are not runs; see `text`. */
-  get runs(): Run[];
-  /** Indent level (`a:pPr/@lvl`), 0 when unset. */
-  get level(): number;
-  /**
-   * Horizontal alignment token (`a:pPr/@algn`: `l` | `ctr` | `r` | `just` |
-   * `dist` | `thaiDist`), or `null` when unset (inherited from the list style).
-   */
-  get align(): string | null;
-  /**
-   * Space before the paragraph in points (`a:pPr/a:spcBef/a:spcPts/@val` is
-   * hundredths of a point), or `null` when unset or expressed as a percentage
-   * (`a:spcPct`, which has no fixed point value).
-   */
-  get spaceBeforePt(): number | null;
-  /** Space after the paragraph in points; see {@link spaceBeforePt} for the percentage caveat. */
-  get spaceAfterPt(): number | null;
-  /**
-   * The paragraph's line spacing (`a:pPr/a:lnSpc`), as an exact point height
-   * (`a:spcPts`) or a percentage of the single-line height (`a:spcPct`), or
-   * `null` when unset (inherited from the list style). See {@link LineSpacing}.
-   */
-  get lineSpacing(): LineSpacing | null;
-  /** Left margin of the paragraph in points (`a:pPr/@marL` is EMU; 12700 EMU = 1pt), or `null` when unset. */
-  get marginLeftPt(): number | null;
-  /** First-line indent in points (`a:pPr/@indent` is EMU; negative for a hanging indent), or `null` when unset. */
-  get indentPt(): number | null;
-  /**
-   * Bullet description for this paragraph, derived from the `a:pPr` bullet
-   * children, or `null` when unset (inherited from the list style):
-   * - `'none'`          — explicit `a:buNone` (bullet suppressed)
-   * - `'char:•'`        — `a:buChar/@char` (the literal glyph follows the colon)
-   * - `'autoNum:arabicPeriod'` — `a:buAutoNum/@type` (auto-numbered)
-   */
-  get bullet(): string | null;
-  /**
-   * The paragraph's text: run (`a:r`) and field (`a:fld`) text concatenated in
-   * document order, with each line break (`a:br`) rendered as `\n`.
-   */
-  get text(): 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_}. */
-  markDirty(): void;
-}
-/** A shape's text frame (`p:txBody`): an ordered list of paragraphs. */
-/**
- * A text frame's body properties (`a:bodyPr`), as read from a shape. Carries the
- * inset/anchor/vertical-text settings that govern where text sits inside its box
- * — the difference between a label that clears a left rail and one that overlaps
- * it. Only **explicitly set** attributes are reported; an absent inset means the
- * PowerPoint default (`lIns`/`rIns` = 0.1", `tIns`/`bIns` = 0.05").
- */
-interface BodyProperties {
-  /** Text direction (`@vert`: `horz`/`vert`/`vert270`/`eaVert`/`wordArtVert`…), or `null` when horizontal/unset. */
-  vert: string | null;
-  /** Vertical anchor (`@anchor`: `t`/`ctr`/`b`), or `null` when unset (defaults to top). */
-  anchor: string | null;
-  /** Wrap mode (`@wrap`: `square`/`none`), or `null` when unset. */
-  wrap: string | null;
-  /** Explicitly-set text insets in points (`@lIns`/`@rIns`/`@tIns`/`@bIns` ÷ 12700); a missing side uses the PowerPoint default. */
-  insetsPt: {
-    left?: number;
-    right?: number;
-    top?: number;
-    bottom?: number;
-  };
-}
-/**
- * A text frame's vertical-autofit mode, read from its `a:bodyPr` autofit child:
- * - `'none'`       — `a:noAutofit`, or no autofit child at all (the box has a fixed
- *                    size and text can overflow); write-side `fit: 'none'`.
- * - `'normAutofit'`— `a:normAutofit` (shrink text to fit); write-side `fit: 'shrink'`.
- * - `'spAutoFit'`  — `a:spAutoFit` (resize the shape to fit text); write-side `fit: 'resize'`.
- */
-type AutofitMode = 'none' | 'normAutofit' | 'spAutoFit';
-declare class TextFrame {
-  #private;
-  private readonly txBody;
-  private readonly part;
-  /** The owning slide's theme context (colour maps + `fontScheme`), threaded to each {@link Paragraph}/{@link Run} for the `resolved*` getters. */
-  private readonly themeContext?;
-  /**
-   * The placeholder this text body lives in, when any — enables
-   * placeholder-inherited run colour/size/face resolution. Absent for ordinary
-   * text boxes and table cells.
-   */
-  private readonly placeholder?;
-  /** The owning part's relationships, threaded to each {@link Paragraph}/{@link Run} for hyperlink `@r:id` resolution; absent when reached without them. */
-  private readonly relationships?;
-  constructor(txBody: Element, part: Part,
-  /** The owning slide's theme context (colour maps + `fontScheme`), threaded to each {@link Paragraph}/{@link Run} for the `resolved*` getters. */
-  themeContext?: FlattenContext | undefined,
-  /**
-   * The placeholder this text body lives in, when any — enables
-   * placeholder-inherited run colour/size/face resolution. Absent for ordinary
-   * text boxes and table cells.
-   */
-  placeholder?: PlaceholderTextContext | undefined,
-  /** The owning part's relationships, threaded to each {@link Paragraph}/{@link Run} for hyperlink `@r:id` resolution; absent when reached without them. */
-  relationships?: Relationships | undefined);
-  /** Paragraphs (`a:p`) in document order. */
-  get paragraphs(): Paragraph[];
-  /**
-   * The frame's body properties (`a:bodyPr`: insets, anchor, vertical text), or
-   * `null` when there is no `a:bodyPr`. Only explicitly-set insets are reported
-   * (a missing side is the PowerPoint default — see {@link BodyProperties}).
-   */
-  get bodyProperties(): BodyProperties | null;
-  /**
-   * The effective vertical anchor (`t`/`ctr`/`b`): the frame's own
-   * `a:bodyPr/@anchor` when set, else the anchor it inherits from its
-   * layout → master placeholder `a:bodyPr`. `null` when nothing in the chain sets
-   * one (PowerPoint then defaults to top). Unlike {@link bodyProperties}'s
-   * `anchor` (own attribute only), this surfaces the inherited anchor a
-   * placeholder title relies on — the difference between a top- and
-   * centre-anchored title that own-attribute reads alone cannot see.
-   */
-  get resolvedAnchor(): string | null;
-  /**
-   * The frame's vertical-autofit mode (`a:bodyPr` autofit child), or `null` when
-   * there is no `a:bodyPr`. A `bodyPr` with no autofit child — or an explicit
-   * `a:noAutofit` — reads `'none'`. See {@link AutofitMode}. This is the deep-model
-   * counterpart of `inspectPptx`'s per-shape `autofit`; unlike the shallow surface
-   * it hangs off the navigable text frame.
-   */
-  get autofit(): AutofitMode | null;
-  /**
-   * The baked shrink scale of a `normAutofit` frame as a percent (62.5 = 62.5%),
-   * or `null` when the frame has no `a:normAutofit` or bakes no scale. A bare
-   * `<a:normAutofit/>` (write-side `fit: 'shrink'`) carries no scale — PowerPoint
-   * computes it on edit and draws at 100% until then — so it too reads `null`; an
-   * explicit scale comes from `fit: { type: 'shrink', fontScale }`.
-   */
-  get autofitFontScale(): number | null;
-  /**
-   * The baked line-spacing reduction of a `normAutofit` frame as a percent
-   * (`a:normAutofit/@lnSpcReduction` ÷ 1000), or `null` when unset. The companion
-   * to {@link autofitFontScale} (write-side `fit: { type: 'shrink', lnSpcReduction }`).
-   */
-  get autofitLineSpaceReduction(): number | null;
-  /** All paragraph text joined by `\n` (mirrors python-pptx `TextFrame.text`). */
-  get text(): string;
-  /**
-   * Replace the frame's text with a single paragraph and run, preserving the
-   * character formatting (`a:rPr`) of the frame's first existing run when there
-   * is one. For multiple runs or per-run formatting, edit
-   * `paragraphs[].runs[]` directly.
-   */
-  set text(value: string);
-  /** Escape hatch: the underlying `p:txBody` 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_}. */
-  markDirty(): void;
-}
-//#endregion
-//#region src/read/api/pattern-fill.d.ts
-/**
- * A pattern fill (`a:pattFill`) — a two-colour preset hatch. The write-side
- * `fill: { type: 'pattern', pattern: { preset, fgColor, bgColor } }` emits the same element,
- * so the {@link preset} name and both colours round-trip. Colours resolve against the theme
- * (a scheme token → literal hex) the same way a solid fill does.
- */
-interface PatternFill {
-  /** Preset pattern name (`@prst`, e.g. `pct50`/`diagCross`/`ltUpDiag`), or `null` when unset. */
-  preset: string | null;
-  /** Foreground colour (`a:fgClr`) resolved against the theme, or `null`. */
-  foreground: ResolvedColor | null;
-  /** Background colour (`a:bgClr`) resolved against the theme, or `null`. */
-  background: ResolvedColor | null;
-}
-//#endregion
-//#region src/read/api/shapes/types.d.ts
-/** Discriminator for the concrete `Shape` subclass. */
-type ShapeType = 'autoShape' | 'picture' | 'connector' | 'graphicFrame' | 'group';
-/** One end of a connector/line (`a:ln/a:headEnd` or `a:tailEnd`), as read from a shape. */
-interface LineEnd {
-  /** Arrowhead type (`@type`: `none`/`triangle`/`stealth`/`diamond`/`oval`/`arrow`). */
-  type: string;
-  /** Width class (`@w`: `sm`/`med`/`lg`), or `null` when unset. */
-  width: string | null;
-  /** Length class (`@len`: `sm`/`med`/`lg`), or `null` when unset. */
-  length: string | null;
-}
-/** Both ends of a shape's line/border, when either carries an arrowhead. */
-interface LineEnds {
-  head: LineEnd | null;
-  tail: LineEnd | null;
-}
-/**
- * One bound end of a connector (`p:nvCxnSpPr/p:cNvCxnSpPr/a:stCxn` or `a:endCxn`),
- * as read. A connector authored with `startShape`/`endShape` attaches each end to
- * a shape by that shape's `p:cNvPr/@id` plus a connection-site index; an unbound
- * end (the writer emits a bare `p:cNvCxnSpPr`) reports no site at all — see
- * {@link Connector.startConnection}. This is the read counterpart of the write
- * API's `startShape`/`startShapeIdx` split, which binds by `objectName` and
- * resolves the name → id at serialize time.
- */
-interface ConnectionSite {
-  /** The bound shape's drawing id (`@id`, i.e. its `p:cNvPr/@id`). */
-  shapeId: number;
-  /** Connection-site index on the bound shape (`@idx`; 0-based, preset-dependent). */
-  siteIndex: number;
-  /**
-   * The bound shape resolved to a read-model shape via {@link Slide.shapeByIdDeep},
-   * which descends into groups — so a connector bound to a shape nested in a group
-   * resolves the same as one bound to a top-level shape. `null` only when no shape
-   * anywhere on the slide carries that id (a genuinely dangling binding), which is
-   * faithful degradation and does not throw.
-   */
-  boundShape: AnyShape | null;
-}
-/**
- * A shape's outer drop shadow (`spPr/a:effectLst/a:outerShdw`), as read from a
- * shape and resolved against the slide theme. Distances are in points (the EMU
- * source ÷ 12700) and the direction in degrees (the `60000`ths source ÷ 60000),
- * matching the write-side {@link ShadowProps} convention so it round-trips.
- */
-interface OuterShadow {
-  /** Effective shadow colour as 6-hex (theme-resolved, transforms applied), or `null`. */
-  color: string | null;
-  /** Theme colour token when the shadow colour was a scheme colour (e.g. `accent1`), else `undefined`. */
-  colorToken?: string;
-  /** Shadow opacity 0–1 (from the colour's `a:alpha`), or `undefined` when fully opaque. */
-  alpha?: number;
-  /** Blur radius in points (`@blurRad` ÷ 12700), or `undefined` when unset. */
-  blurPt?: number;
-  /** Offset distance in points (`@dist` ÷ 12700), or `undefined` when unset. */
-  offsetPt?: number;
-  /** Offset direction in degrees, clockwise from 3 o'clock (`@dir` ÷ 60000), or `undefined` when unset. */
-  angleDeg?: number;
-}
-/**
- * A shape's inner shadow (`spPr/a:effectLst/a:innerShdw`), resolved against the
- * slide theme. Identical fields to {@link OuterShadow} — CT_InnerShadowEffect
- * carries the same `blurRad`/`dist`/`dir` + colour — but a distinct type so a
- * consumer can tell an inset shadow from a drop shadow. Distances in points,
- * direction in degrees, matching the write-side `shadow: { type: 'inner' }`.
- */
-interface InnerShadow {
-  /** Effective shadow colour as 6-hex (theme-resolved, transforms applied), or `null`. */
-  color: string | null;
-  /** Theme colour token when the shadow colour was a scheme colour (e.g. `accent1`), else `undefined`. */
-  colorToken?: string;
-  /** Shadow opacity 0–1 (from the colour's `a:alpha`), or `undefined` when fully opaque. */
-  alpha?: number;
-  /** Blur radius in points (`@blurRad` ÷ 12700), or `undefined` when unset. */
-  blurPt?: number;
-  /** Offset distance in points (`@dist` ÷ 12700), or `undefined` when unset. */
-  offsetPt?: number;
-  /** Offset direction in degrees, clockwise from 3 o'clock (`@dir` ÷ 60000), or `undefined` when unset. */
-  angleDeg?: number;
-}
-/**
- * A shape's glow effect (`spPr/a:effectLst/a:glow`) — a coloured halo — resolved
- * against the slide theme. The write-side text glow (`glow: { size, color,
- * opacity }`) emits the same element, so {@link radiusPt} (`@rad` ÷ 12700) and the
- * colour round-trip.
- */
-interface Glow {
-  /** Effective glow colour as 6-hex (theme-resolved, transforms applied), or `null`. */
-  color: string | null;
-  /** Theme colour token when the glow colour was a scheme colour (e.g. `accent1`), else `undefined`. */
-  colorToken?: string;
-  /** Glow opacity 0–1 (from the colour's `a:alpha`), or `undefined` when fully opaque. */
-  alpha?: number;
-  /** Glow radius in points (`@rad` ÷ 12700), or `undefined` when unset. */
-  radiusPt?: number;
-}
-/**
- * A shape's reflection effect (`spPr/a:effectLst/a:reflection`) — a mirrored fade
- * beneath the shape. This library's writer authors none, so this is a **read-only**
- * surface: a consumer that finds one should carry the part verbatim rather than
- * regenerate it. Only the attributes a faithful replica needs are decoded —
- * distances in points (÷ 12700), directions in degrees (÷ 60000), and the start/end
- * alpha and position pairs as 0–1 fractions (the `1000`ths-of-a-percent source
- * ÷ 100000). All fields are optional; an attribute absent from the source is omitted.
- */
-interface Reflection {
-  /** Blur radius in points (`@blurRad` ÷ 12700). */
-  blurPt?: number;
-  /** Start opacity 0–1 (`@stA` ÷ 100000). */
-  startAlpha?: number;
-  /** Start position along the reflection 0–1 (`@stPos` ÷ 100000). */
-  startPos?: number;
-  /** End opacity 0–1 (`@endA` ÷ 100000). */
-  endAlpha?: number;
-  /** End position along the reflection 0–1 (`@endPos` ÷ 100000). */
-  endPos?: number;
-  /** Offset distance in points (`@dist` ÷ 12700). */
-  distPt?: number;
-  /** Offset direction in degrees (`@dir` ÷ 60000). */
-  angleDeg?: number;
-  /** Fade direction in degrees (`@fadeDir` ÷ 60000). */
-  fadeAngleDeg?: number;
-}
-/**
- * A shape's soft-edge effect (`spPr/a:effectLst/a:softEdge`) — a feathered border.
- * Like {@link Reflection}, the writer authors none, so carry it verbatim. `@rad`
- * (the feather radius) ÷ 12700 → points.
- */
-interface SoftEdge {
-  /** Feather radius in points (`@rad` ÷ 12700). */
-  radiusPt: number;
-}
-/**
- * One segment of a custom-geometry path (`a:path`), as read from a shape. The
- * command verbs mirror the write-side `GeometryPoint` DSL (`src/types/`)
- * so a consumer can map a `GeometryCommand[]` to `GeometryPoint[]` one-to-one.
- *
- * Coordinates (`x`/`y`/`x1`…) are raw path-unit integers in the path's own
- * `0..w` / `0..h` space (see {@link CustomGeometryPath.w}); they are not EMU and
- * must be scaled by the consumer against the shape's box. `arcTo` angles are in
- * **degrees** (the raw `60000`ths-of-a-degree values divided by 60000), matching
- * the write DSL's degree input.
- */
-type GeometryCommand = {
-  cmd: 'moveTo';
-  x: number;
-  y: number;
-} | {
-  cmd: 'lnTo';
-  x: number;
-  y: number;
-} | {
-  cmd: 'cubicBezTo';
-  x1: number;
-  y1: number;
-  x2: number;
-  y2: number;
-  x: number;
-  y: number;
-} | {
-  cmd: 'quadBezTo';
-  x1: number;
-  y1: number;
-  x: number;
-  y: number;
-} | {
-  cmd: 'arcTo';
-  wR: number;
-  hR: number;
-  stAng: number;
-  swAng: number;
-} | {
-  cmd: 'close';
-};
-/** One `<a:path>` of a custom geometry, with its path-unit viewport and render attrs. */
-interface CustomGeometryPath {
-  /** Path-unit width (`a:path/@w`); the `x` denominator for this path's coords. Default `0`. */
-  w: number;
-  /** Path-unit height (`a:path/@h`); the `y` denominator for this path's coords. Default `0`. */
-  h: number;
-  /** Fill mode (`a:path/@fill`, `ST_PathFillMode`, e.g. `norm`/`none`/`lighten`). Default `norm`. */
-  fill: string;
-  /** Whether the path is stroked (`a:path/@stroke`). Default `true`. */
-  stroke: boolean;
-  /** The path's segments in document order — order *is* the geometry. */
-  commands: GeometryCommand[];
-}
-/**
- * Custom freeform geometry (`spPr/a:custGeom/a:pathLst`), as read from a shape.
- * Faithfully exposes every `a:path` rather than flattening to a single command
- * list: the schema allows repeatable `a:path`, each with independent
- * `fill`/`stroke`. Desktop PowerPoint's own freeforms only ever emit one
- * `a:path` (a hole is one path with two `moveTo`…`close` contours), but
- * multi-`a:path` input is schema-legal (e.g. SVG import) and preserved here.
- */
-interface CustomGeometry {
-  paths: CustomGeometryPath[];
+   * slide `a:lstStyle` → layout → master placeholder `a:lstStyle` → master
+   * `p:txStyles`). `null` when the run sets no size and inherits none — the
+   * resolved counterpart of {@link fontSizePt}, which reports only the run's own value.
+   */
+  get resolvedSizePt(): number | null;
+  /**
+   * The typeface this run effectively renders, resolved to a literal face name. It
+   * is the run's own `a:latin` ({@link fontName}) when set; otherwise the face named
+   * by the shape's `p:style/a:fontRef` (`idx` → theme major/minor font), then — for a
+   * run inside a placeholder — the face it inherits from the placeholder/list-style
+   * chain, then the presentation's `p:defaultTextStyle`. A `+mj-*`/`+mn-*`
+   * major/minor theme-font token — on the run itself or reached through the chain —
+   * is resolved through the theme `fontScheme` to its concrete face. `null` when the
+   * run names no face and inherits none, or a token cannot be resolved — the resolved
+   * counterpart of {@link fontName}, which reports the raw `@typeface` (possibly a token).
+   */
+  get resolvedFontFace(): string | null;
+  /**
+   * Whether this run effectively renders bold. It is the run's own `@b`
+   * ({@link bold}) when set; otherwise, for a run inside a placeholder, the bold
+   * 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 `@b` and inherits none — the
+   * resolved counterpart of {@link bold}, which reports only the run's own value.
+   */
+  get resolvedBold(): 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_}. */
+  markDirty(): void;
 }
-/** A shape's resolved position and size in slide-absolute EMU. */
-interface AbsoluteFrame {
-  left: number;
-  top: number;
-  width: number;
-  height: number;
-  /** Effective clockwise rotation in degrees after composing enclosing group rotations. */
-  rotation: number;
-  /** Effective horizontal flip after XOR-composing enclosing group flips. */
-  flipH: boolean;
-  /** Effective vertical flip after XOR-composing enclosing group flips. */
-  flipV: boolean;
+/** One paragraph (`a:p`) of a text frame. */
+declare class Paragraph {
+  #private;
+  private readonly element;
+  private readonly part;
+  /** The owning slide's theme context (colour maps + `fontScheme`), threaded to each {@link Run} for the `resolved*` getters. */
+  private readonly themeContext?;
+  /**
+   * Placeholder + slide-list-style context for resolving a placeholder-inherited
+   * run colour/size/face; absent for non-placeholder text. The owning
+   * {@link TextFrame} supplies the placeholder identity and the text body's
+   * `a:lstStyle`.
+   */
+  private readonly inherit?;
+  /** The owning part's relationships, threaded to each {@link Run} for hyperlink `@r:id` resolution; absent when reached without them. */
+  private readonly relationships?;
+  constructor(element: Element, part: Part,
+  /** The owning slide's theme context (colour maps + `fontScheme`), threaded to each {@link Run} for the `resolved*` getters. */
+  themeContext?: ThemeContext | undefined,
+  /**
+   * Placeholder + slide-list-style context for resolving a placeholder-inherited
+   * run colour/size/face; absent for non-placeholder text. The owning
+   * {@link TextFrame} supplies the placeholder identity and the text body's
+   * `a:lstStyle`.
+   */
+  inherit?: {
+    placeholder: PlaceholderTextContext;
+    slideLstStyle: Element | null;
+  } | undefined,
+  /** The owning part's relationships, threaded to each {@link Run} for hyperlink `@r:id` resolution; absent when reached without them. */
+  relationships?: Relationships | undefined);
+  /** The runs (`a:r`) in document order. Fields (`a:fld`) and breaks are not runs; see `text`. */
+  get runs(): Run[];
+  /** Indent level (`a:pPr/@lvl`), 0 when unset. */
+  get level(): number;
+  /**
+   * Horizontal alignment token (`a:pPr/@algn`: `l` | `ctr` | `r` | `just` |
+   * `dist` | `thaiDist`), or `null` when unset (inherited from the list style).
+   */
+  get align(): string | null;
+  /**
+   * Space before the paragraph in points (`a:pPr/a:spcBef/a:spcPts/@val` is
+   * hundredths of a point), or `null` when unset or expressed as a percentage
+   * (`a:spcPct`, which has no fixed point value).
+   */
+  get spaceBeforePt(): number | null;
+  /** Space after the paragraph in points; see {@link spaceBeforePt} for the percentage caveat. */
+  get spaceAfterPt(): number | null;
+  /**
+   * The paragraph's line spacing (`a:pPr/a:lnSpc`), as an exact point height
+   * (`a:spcPts`) or a percentage of the single-line height (`a:spcPct`), or
+   * `null` when unset (inherited from the list style). See {@link LineSpacing}.
+   */
+  get lineSpacing(): LineSpacing | null;
+  /** Left margin of the paragraph in points (`a:pPr/@marL` is EMU; 12700 EMU = 1pt), or `null` when unset. */
+  get marginLeftPt(): number | null;
+  /** First-line indent in points (`a:pPr/@indent` is EMU; negative for a hanging indent), or `null` when unset. */
+  get indentPt(): number | null;
+  /**
+   * This paragraph's bullet — its kind, and for a drawn bullet the glyph, the
+   * numbering start, and the bullet's own font/size/colour. `null` when the
+   * paragraph names no bullet at all and inherits one from the list style.
+   *
+   * Structured rather than a tagged string, which is not merely tidier. The
+   * previous `bullet` accessor reported `'none'` / `'char:•'` /
+   * `'autoNum:arabicPeriod'`, and that shape is ambiguous when the glyph is
+   * itself a colon; worse, it reads as a bare glyph, which is exactly how the
+   * script converter first consumed it — `'none'.codePointAt(0)` put a literal
+   * `n` bullet on every converted deck, silently. See {@link BulletDetail}.
+   */
+  get bulletDetail(): BulletDetail | null;
+  /**
+   * The paragraph's text: run (`a:r`) and field (`a:fld`) text concatenated in
+   * document order, with each line break (`a:br`) rendered as `\n`.
+   */
+  get text(): 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_}. */
+  markDirty(): void;
 }
+/** A shape's text frame (`p:txBody`): an ordered list of paragraphs. */
 /**
- * A colour reference inside a picture recolour effect, split by colour model
- * (mirrors {@link GradientStop}). At most one field is non-`null`.
+ * A text frame's body properties (`a:bodyPr`), as read from a shape. Carries the
+ * inset/anchor/vertical-text settings that govern where text sits inside its box
+ * — the difference between a label that clears a left rail and one that overlaps
+ * it. Only **explicitly set** attributes are reported; an absent inset means the
+ * PowerPoint default (`lIns`/`rIns` = 0.1", `tIns`/`bIns` = 0.05").
  */
-interface RecolorColor {
-  /** Explicit RGB as 6-hex (`a:srgbClr/@val`), or `null`. */
-  color: string | null;
-  /** Theme colour token (`a:schemeClr/@val`, e.g. `accent1`), or `null`. */
-  schemeColor: string | null;
-  /** Preset colour name (`a:prstClr/@val`, e.g. `black`/`white` — the duotone icon-tint stops), or `null`. */
-  presetColor: string | null;
+interface BodyProperties {
+  /** Text direction (`@vert`: `horz`/`vert`/`vert270`/`eaVert`/`wordArtVert`…), or `null` when horizontal/unset. */
+  vert: string | null;
+  /** Vertical anchor (`@anchor`: `t`/`ctr`/`b`), or `null` when unset (defaults to top). */
+  anchor: string | null;
+  /** Wrap mode (`@wrap`: `square`/`none`), or `null` when unset. */
+  wrap: string | null;
+  /** Explicitly-set text insets in points (`@lIns`/`@rIns`/`@tIns`/`@bIns` ÷ 12700); a missing side uses the PowerPoint default. */
+  insetsPt: {
+    left?: number;
+    right?: number;
+    top?: number;
+    bottom?: number;
+  };
 }
 /**
- * A picture's blip recolour effect (`p:blipFill/a:blip` recolour child), as read.
- * A small discriminated union over the effects a faithful reader needs to
- * reproduce a recoloured image. Colours use the same `color`/`schemeColor`/
- * `presetColor` split as {@link GradientStop}, so theme tokens can resolve through
- * {@link Slide.themeContext}. `threshold`/`amount` are 0–1 fractions.
+ * A text frame's vertical-autofit mode, read from its `a:bodyPr` autofit child:
+ * - `'none'`       — `a:noAutofit`, or no autofit child at all (the box has a fixed
+ *                    size and text can overflow); write-side `fit: 'none'`.
+ * - `'normAutofit'`— `a:normAutofit` (shrink text to fit); write-side `fit: 'shrink'`.
+ * - `'spAutoFit'`  — `a:spAutoFit` (resize the shape to fit text); write-side `fit: 'resize'`.
  */
-type Recolor = {
-  kind: 'duotone';
-  stops: RecolorColor[];
-} | {
-  kind: 'clrChange';
-  from: RecolorColor | null;
-  to: RecolorColor | null;
-} | {
-  kind: 'grayscale';
-} | {
-  kind: 'biLevel';
-  threshold: number | null;
-} | {
-  kind: 'alphaModFix';
-  amount: number;
-};
+type AutofitMode = 'none' | 'normAutofit' | 'spAutoFit';
+declare class TextFrame {
+  #private;
+  private readonly txBody;
+  private readonly part;
+  /** The owning slide's theme context (colour maps + `fontScheme`), threaded to each {@link Paragraph}/{@link Run} for the `resolved*` getters. */
+  private readonly themeContext?;
+  /**
+   * The placeholder this text body lives in, when any — enables
+   * placeholder-inherited run colour/size/face resolution. Absent for ordinary
+   * text boxes and table cells.
+   */
+  private readonly placeholder?;
+  /** The owning part's relationships, threaded to each {@link Paragraph}/{@link Run} for hyperlink `@r:id` resolution; absent when reached without them. */
+  private readonly relationships?;
+  constructor(txBody: Element, part: Part,
+  /** The owning slide's theme context (colour maps + `fontScheme`), threaded to each {@link Paragraph}/{@link Run} for the `resolved*` getters. */
+  themeContext?: ThemeContext | undefined,
+  /**
+   * The placeholder this text body lives in, when any — enables
+   * placeholder-inherited run colour/size/face resolution. Absent for ordinary
+   * text boxes and table cells.
+   */
+  placeholder?: PlaceholderTextContext | undefined,
+  /** The owning part's relationships, threaded to each {@link Paragraph}/{@link Run} for hyperlink `@r:id` resolution; absent when reached without them. */
+  relationships?: Relationships | undefined);
+  /** Paragraphs (`a:p`) in document order. */
+  get paragraphs(): Paragraph[];
+  /**
+   * The frame's body properties (`a:bodyPr`: insets, anchor, vertical text), or
+   * `null` when there is no `a:bodyPr`. Only explicitly-set insets are reported
+   * (a missing side is the PowerPoint default — see {@link BodyProperties}).
+   */
+  get bodyProperties(): BodyProperties | null;
+  /**
+   * The effective vertical anchor (`t`/`ctr`/`b`): the frame's own
+   * `a:bodyPr/@anchor` when set, else the anchor it inherits from its
+   * layout → master placeholder `a:bodyPr`. `null` when nothing in the chain sets
+   * one (PowerPoint then defaults to top). Unlike {@link bodyProperties}'s
+   * `anchor` (own attribute only), this surfaces the inherited anchor a
+   * placeholder title relies on — the difference between a top- and
+   * centre-anchored title that own-attribute reads alone cannot see.
+   */
+  get resolvedAnchor(): string | null;
+  /**
+   * The frame's vertical-autofit mode (`a:bodyPr` autofit child), or `null` when
+   * there is no `a:bodyPr`. A `bodyPr` with no autofit child — or an explicit
+   * `a:noAutofit` — reads `'none'`. See {@link AutofitMode}. This is the deep-model
+   * counterpart of `inspectPptx`'s per-shape `autofit`; unlike the shallow surface
+   * it hangs off the navigable text frame.
+   */
+  get autofit(): AutofitMode | null;
+  /**
+   * The baked shrink scale of a `normAutofit` frame as a percent (62.5 = 62.5%),
+   * or `null` when the frame has no `a:normAutofit` or bakes no scale. A bare
+   * `<a:normAutofit/>` (write-side `fit: 'shrink'`) carries no scale — PowerPoint
+   * computes it on edit and draws at 100% until then — so it too reads `null`; an
+   * explicit scale comes from `fit: { type: 'shrink', fontScale }`.
+   */
+  get autofitFontScale(): number | null;
+  /**
+   * The baked line-spacing reduction of a `normAutofit` frame as a percent
+   * (`a:normAutofit/@lnSpcReduction` ÷ 1000), or `null` when unset. The companion
+   * to {@link autofitFontScale} (write-side `fit: { type: 'shrink', lnSpcReduction }`).
+   */
+  get autofitLineSpaceReduction(): number | null;
+  /** All paragraph text joined by `\n` (mirrors python-pptx `TextFrame.text`). */
+  get text(): string;
+  /**
+   * Replace the frame's text with a single paragraph and run, preserving the
+   * character formatting (`a:rPr`) of the frame's first existing run when there
+   * is one. For multiple runs or per-run formatting, edit
+   * `paragraphs[].runs[]` directly.
+   */
+  set text(value: string);
+  /** Escape hatch: the underlying `p:txBody` 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_}. */
+  markDirty(): void;
+}
 //#endregion
 //#region src/read/api/shapes/base.d.ts
 /** Common base for every shape in a slide's shape tree. */
@@ -1149,10 +1231,23 @@ declare abstract class Shape {
   /** Theme colour token when the fill is a scheme colour (`a:solidFill/a:schemeClr/@val`, e.g. `accent2`), or `null`. */
   get fillSchemeColor(): string | null;
   set fillSchemeColor(value: string | null);
+  /**
+   * `true` when the shape sets an explicit no-fill (`spPr/a:noFill`) — a
+   * deliberately transparent surface. The fill-side counterpart of
+   * {@link lineNoFill}, and the only accessor that separates it from a shape
+   * carrying no fill child at all (one inheriting through `p:style/a:fillRef`):
+   * every other fill accessor — {@link fillColor}, {@link fillSchemeColor},
+   * {@link resolvedFill}, {@link gradientFill}, {@link patternFill},
+   * {@link pictureFill} — reports `null` for both. The two paint completely
+   * differently, so a consumer that cannot tell them apart paints a transparent
+   * shape in the theme's accent colour.
+   */
+  get fillNoFill(): boolean;
   /**
    * Set an explicit `<a:noFill/>` on the shape — a transparent surface. This is
    * distinct from clearing the fill (`fillColor = null`), which removes the
    * `a:solidFill` and lets the fill inherit from the shape's style/placeholder.
+   * Read it back with {@link fillNoFill}.
    */
   noFill(): void;
   /** Explicit RGB line/border colour (`spPr/a:ln/a:solidFill/a:srgbClr/@val`), or `null`. */
@@ -1178,6 +1273,26 @@ declare abstract class Shape {
    * to know the border was explicitly suppressed.
    */
   get lineNoFill(): boolean;
+  /**
+   * The line end cap (`spPr/a:ln/@cap`) as the raw OOXML token — `'flat'`,
+   * `'rnd'` (round) or `'sq'` (square) — or `null` when unset (PowerPoint's
+   * default is `flat`). The write API authors this attribute through
+   * `ShapeLineProps.cap`, so without the accessor a deck this library produced
+   * could not be read back without losing it.
+   *
+   * Not cosmetic on a thick dashed rule: the cap decides whether each dash reads
+   * as a rectangle or a lozenge, and it extends every dash by the stroke width.
+   * SVG's `stroke-linecap` is the exact equivalent (`flat`→`butt`, `rnd`→`round`,
+   * `sq`→`square`).
+   */
+  get lineCap(): string | null;
+  /**
+   * The line alignment (`spPr/a:ln/@algn`) as the raw OOXML token — `'ctr'`
+   * (centred on the shape's outline) or `'in'` (inset, drawn wholly inside it) —
+   * or `null` when unset. It shifts a thick outline by half its width, so it
+   * changes where the border sits relative to the fill.
+   */
+  get lineAlign(): string | null;
   /**
    * Preset geometry name (`spPr/a:prstGeom/@prst`, e.g. `rect`), or `null` for
    * custom geometry or none. Not an auto-shape-only property: PowerPoint gives a
@@ -1329,7 +1444,7 @@ declare abstract class Shape {
 //#region src/read/api/shapes/autoshape.d.ts
 /** An auto shape, text box, or placeholder (`p:sp`). The only kind that holds text. */
 declare class AutoShape extends Shape {
-  readonly shapeType: "autoShape";
+  readonly shapeType: 'autoShape';
   protected xfrm(): Element | null;
   protected getOrAddXfrm(): Element;
   get hasTextFrame(): boolean;
@@ -1355,7 +1470,7 @@ declare class AutoShape extends Shape {
 /** A picture (`p:pic`). */
 declare class Picture extends Shape {
   #private;
-  readonly shapeType: "picture";
+  readonly shapeType: 'picture';
   protected xfrm(): Element | null;
   protected getOrAddXfrm(): Element;
   protected get supportsFill(): boolean;
@@ -1467,7 +1582,7 @@ declare class Picture extends Shape {
 /** A connector / line (`p:cxnSp`). */
 declare class Connector extends Shape {
   #private;
-  readonly shapeType: "connector";
+  readonly shapeType: 'connector';
   protected xfrm(): Element | null;
   protected getOrAddXfrm(): Element;
   /**
@@ -1809,12 +1924,12 @@ declare class ChartExAxis {
 //#region src/read/api/table-edit.d.ts
 /** The four edges plus the two diagonals, keyed as {@link TableCellEdge} names them. */
 declare const EDGE_QNAMES: {
-  readonly left: "a:lnL";
-  readonly right: "a:lnR";
-  readonly top: "a:lnT";
-  readonly bottom: "a:lnB";
-  readonly tlToBr: "a:lnTlToBr";
-  readonly blToTr: "a:lnBlToTr";
+  readonly left: 'a:lnL';
+  readonly right: 'a:lnR';
+  readonly top: 'a:lnT';
+  readonly bottom: 'a:lnB';
+  readonly tlToBr: 'a:lnTlToBr';
+  readonly blToTr: 'a:lnBlToTr';
 };
 /** Which border of a cell an edit addresses. */
 type TableCellEdge = keyof typeof EDGE_QNAMES;
@@ -1882,7 +1997,7 @@ interface TableCellStyleContext {
   flags: TableConditionFlags;
   rowCount: number;
   colCount: number;
-  ctx: FlattenContext;
+  ctx: ThemeContext;
 }
 /**
  * One edge border of a table cell (`a:tcPr/a:lnL|lnR|lnT|lnB|lnTlToBr|lnBlToTr`).
@@ -1953,7 +2068,7 @@ declare class Table {
   private readonly rels?;
   constructor(tbl: Element, part: Part,
   /** The owning slide's theme colour context, threaded to each cell's text for `Run.resolvedColor`. */
-  themeColors?: FlattenContext | undefined,
+  themeColors?: ThemeContext | undefined,
   /** The deck package, for resolving `a:tableStyleId` against `tableStyles.xml` (style-graph cell fills). */
   opc?: OpcPackage | undefined,
   /** The owning slide's relationships, for resolving a cell picture fill's `r:embed` to a partname. */
@@ -2107,9 +2222,9 @@ declare class TableRow {
   private readonly rels?;
   constructor(tr: Element, part: Part,
   /** The owning slide's theme colour context, threaded to each {@link TableCell}. */
-  themeColors?: FlattenContext | undefined,
+  themeColors?: ThemeContext | undefined,
   /** The table's style-resolution context, threaded to each cell for {@link TableCell.resolvedFill}. */
-  style?: (TableCellStyleContext | null) | undefined,
+  style?: TableCellStyleContext | null | undefined,
   /** This row's zero-based index in the table, for style-graph banding/edge conditions. */
   rowIndex?: number,
   /** The owning slide's relationships, threaded to each cell for {@link TableCell.pictureFill}. */
@@ -2140,9 +2255,9 @@ declare class TableCell {
   private readonly rels?;
   constructor(tc: Element, part: Part,
   /** The owning slide's theme colour context, threaded to the cell's text for `Run.resolvedColor`. */
-  themeColors?: FlattenContext | undefined,
+  themeColors?: ThemeContext | undefined,
   /** The table's style-resolution context, for the {@link resolvedFill} style-graph fallback. */
-  style?: (TableCellStyleContext | null) | undefined,
+  style?: TableCellStyleContext | null | undefined,
   /** This cell's zero-based row index in the table. */
   rowIndex?: number,
   /** This cell's zero-based column index in its row. */
@@ -2269,6 +2384,24 @@ declare class TableCell {
    * `a:tcPr` is empty or absent, whatever the style graph would render it as.
    */
   get hasOwnFill(): boolean;
+  /**
+   * `true` when the cell sets an explicit no-fill (`a:tcPr/a:noFill`) — a deliberately
+   * transparent cell showing the table background (or the slide) through. The cell-side
+   * counterpart of {@link import('./shapes.js').AutoShape.fillNoFill}, and what
+   * {@link noFill} writes.
+   *
+   * {@link hasOwnFill} is not this question: it is `true` for *any* `EG_FillProperties`
+   * child, so on its own it cannot separate a suppressed fill from a gradient or an image
+   * one — and every colour accessor ({@link resolvedFill}, {@link fillColor},
+   * {@link fillSchemeColor}) reports `null` for a no-fill cell exactly as it does for a
+   * cell that inherits its shading from the table style. Deriving it as "has a fill of its
+   * own, and no accessor recognises it" instead of reading it has two failure modes: it
+   * folds `a:grpFill` in with `a:noFill`, and its meaning changes silently the day a
+   * further fill kind gets an accessor. The two paint completely differently — an
+   * inherited banding colour versus nothing at all — so a consumer that cannot tell them
+   * apart paints a transparent cell in the style's shading.
+   */
+  get fillNoFill(): boolean;
   /**
    * The cell's picture (image) fill (`a:tcPr/a:blipFill`), or `null` when the cell
    * is not image-filled. The cell counterpart of
@@ -2390,7 +2523,7 @@ declare class TableCell {
 /** A graphic frame (`p:graphicFrame`) — host for tables and charts. */
 declare class GraphicFrame extends Shape {
   #private;
-  readonly shapeType: "graphicFrame";
+  readonly shapeType: 'graphicFrame';
   protected xfrm(): Element | null;
   protected getOrAddXfrm(): Element;
   protected getOrAddProperties(): ShapeProperties;
@@ -2422,11 +2555,25 @@ declare class GraphicFrame extends Shape {
  */
 declare class GroupShape extends Shape {
   #private;
-  readonly shapeType: "group";
+  readonly shapeType: 'group';
   protected xfrm(): Element | null;
   protected getOrAddXfrm(): Element;
   protected properties(): Element | null;
   protected getOrAddProperties(): ShapeProperties;
+  /**
+   * The group's own child coordinate space (`p:grpSpPr/a:xfrm/a:chOff` and
+   * `a:chExt`) in EMU, or `null` when the group has no transform or either
+   * element is incomplete.
+   *
+   * Most consumers should not need this: {@link Shape.absoluteFrame} already
+   * composes the whole ancestor chain — child space, group flips and rotations —
+   * and doing that arithmetic per consumer is how a shape in a nested group ends
+   * up subtly displaced. It is here for a *replica* consumer rather than a
+   * *paint* one: rebuilding this group and its children as OOXML needs the
+   * source child space to reproduce the scaling, and without it only groups whose
+   * child space is the identity can be rebuilt.
+   */
+  get childFrame(): ChildFrame | null;
   /** The shapes nested directly inside this group, in document order. */
   get shapes(): AnyShape[];
 }
@@ -2470,7 +2617,7 @@ declare class NotesPlaceholder {
   private readonly relationships;
   constructor(sp: Element, part: Part,
   /** The notes theme context (notesMaster → `theme2.xml`), threaded to {@link textFrame}. */
-  themeContext: FlattenContext,
+  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. */
@@ -2526,7 +2673,7 @@ declare class NotesSlide {
    * The notes theme context, resolved through the notesMaster → `theme2.xml` chain
    * and cached. Backs {@link NotesPlaceholder.textFrame}'s `Run.resolvedColor`.
    */
-  themeContext(): FlattenContext;
+  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. */
@@ -2708,7 +2855,7 @@ declare class Placeholder {
   private readonly relationships;
   constructor(sp: Element, part: Part,
   /** The owning master/layout theme context, threaded to {@link textFrame}. */
-  themeContext: FlattenContext,
+  themeContext: ThemeContext,
   /** The owning part's relationships, threaded to {@link textFrame} for hyperlink resolution. */
   relationships: Relationships);
   /** Placeholder type (`p:ph/@type`: `title` | `body` | `sldNum` | …), or `null` when absent (a body placeholder). */
@@ -2780,7 +2927,7 @@ declare class SlideMaster {
    * The master's colour/font context (its `p:clrMap` + theme), resolved once and
    * cached. Backs each {@link Placeholder}'s text frame.
    */
-  themeContext(): FlattenContext;
+  themeContext(): ThemeContext;
 }
 /**
  * A deck's slide layout (`slideLayoutN.xml`) as a modeled object — the gallery entry
@@ -2824,7 +2971,7 @@ declare class SlideLayout {
    * The layout's colour/font context (walked layout → master → theme), resolved once
    * and cached. Backs each {@link Placeholder}'s text frame.
    */
-  themeContext(): FlattenContext;
+  themeContext(): ThemeContext;
 }
 //#endregion
 //#region src/read/api/transition.d.ts
@@ -2953,7 +3100,7 @@ declare class Slide {
    * font token included) resolves to a literal value. The maps/roots are empty when
    * the theme chain is incomplete, in which case tokens simply stay unresolved.
    */
-  themeContext(): FlattenContext;
+  themeContext(): ThemeContext;
   /** Authoring name of the slide (`p:cSld/@name`), or `null` if unnamed. */
   get name(): string | null;
   /**
@@ -3543,5 +3690,5 @@ declare class Presentation {
   save(): Promise<Uint8Array>;
 }
 //#endregion
-export { Chart as $, GroupShape as A, Run as At, Table as B, GradientStop as Bt, CommentAuthor as C, ShapeType as Ct, NotesPlaceholder as D, BodyProperties as Dt, ModernCommentAuthor as E, AutofitMode as Et, isPicture as F, SlideBackground as Ft, TableConditionFlags as G, TableCellBorderEdit as H, resolveColorElement as Ht, GraphicFrame as I, FillRect as It, ChartExAxis as J, TableCellEdge as K, CellBorder as L, PictureFill as Lt, isConnector as M, TextFrame as Mt, isGraphicFrame as N, BackgroundFill as Nt, NotesSlide as O, LineSpacing as Ot, isGroupShape as P, BackgroundSource as Pt, AxisNumberFormat as Q, CellBorders as R, PictureFillTile as Rt, Comment as S, Reflection as St, ModernComment as T, PatternFill as Tt, TableRow as U, ColorContext as Ut, TableCell as V, ResolvedColor as Vt, ResolvedTableStyle as W, ChartExLegend as X, ChartExDataLabels as Y, ChartExSeries as Z, ThemeColorSlot as _, LineEnd as _t, readCustomProperties as a, ChartSeries as at, Tag as b, Recolor as bt, Slide as c, AutoShape as ct, TransitionSpeed as d, ConnectionSite as dt, ChartAxis as et, ColorMapToken as f, CustomGeometry as ft, Theme as g, InnerShadow as gt, SlideMaster as h, Glow as ht, readCoreProperties as i, ChartLine as it, isAutoShape as j, RunHyperlink as jt, AnyShape as k, Paragraph as kt, TransitionInfo as l, Shape as lt, SlideLayout as m, GeometryCommand as mt, CoreProperties as n, ChartFill as nt, AddPictureOptions as o, Connector as ot, Placeholder as p, CustomGeometryPath as pt, ChartEx as q, CustomProperty as r, ChartLegend as rt, AddTextBoxOptions as s, Picture as st, Presentation as t, ChartDataLabels as tt, TransitionInput as u, AbsoluteFrame as ut, ThemeFontFace as v, LineEnds as vt, CommentSchema as w, SoftEdge as wt, readTagsForPart as x, RecolorColor as xt, ThemeFontScheme as y, OuterShadow as yt, CellThreeD as z, GradientFill as zt };
-//# sourceMappingURL=presentation-CVaTZw1V.d.ts.map
+export { Chart as $, GroupShape as A, Recolor as At, Table as B, PictureFill as Bt, CommentAuthor as C, CustomGeometryPath as Ct, NotesPlaceholder as D, LineEnd as Dt, ModernCommentAuthor as E, InnerShadow as Et, isPicture as F, PatternFill as Ft, TableConditionFlags as G, resolveColorElement as Gt, TableCellBorderEdit as H, GradientFill as Ht, GraphicFrame as I, BackgroundFill as It, ChartExAxis as J, TableCellEdge as K, ColorContext as Kt, CellBorder as L, BackgroundSource as Lt, isConnector as M, Reflection as Mt, isGraphicFrame as N, ShapeType as Nt, NotesSlide as O, LineEnds as Ot, isGroupShape as P, SoftEdge as Pt, AxisNumberFormat as Q, CellBorders as R, SlideBackground as Rt, Comment as S, CustomGeometry as St, ModernComment as T, Glow as Tt, TableRow as U, GradientStop as Ut, TableCell as V, PictureFillTile as Vt, ResolvedTableStyle as W, ResolvedColor as Wt, ChartExLegend as X, ChartExDataLabels as Y, ChartExSeries as Z, ThemeColorSlot as _, RunHyperlink as _t, readCustomProperties as a, ChartSeries as at, Tag as b, ChildFrame as bt, Slide as c, AutoShape as ct, TransitionSpeed as d, BodyProperties as dt, ChartAxis as et, ColorMapToken as f, BulletDetail as ft, Theme as g, Run as gt, SlideMaster as h, Paragraph as ht, readCoreProperties as i, ChartLine as it, isAutoShape as j, RecolorColor as jt, AnyShape as k, OuterShadow as kt, TransitionInfo as l, Shape as lt, SlideLayout as m, LineSpacing as mt, CoreProperties as n, ChartFill as nt, AddPictureOptions as o, Connector as ot, Placeholder as p, BulletStyle as pt, ChartEx as q, CustomProperty as r, ChartLegend as rt, AddTextBoxOptions as s, Picture as st, Presentation as t, ChartDataLabels as tt, TransitionInput as u, AutofitMode as ut, ThemeFontFace as v, TextFrame as vt, CommentSchema as w, GeometryCommand as wt, readTagsForPart as x, ConnectionSite as xt, ThemeFontScheme as y, AbsoluteFrame as yt, CellThreeD as z, FillRect as zt };
+//# sourceMappingURL=presentation-DyIRDKkp.d.ts.map