@office-kit/pptx 0.20.0 → 0.22.0

package/dist/{index-CfANfMvY.d.ts → index-Dnzhy4tZ.d.ts}

@@ -192,6 +192,11 @@ interface XmlDocument {
 //#endregion
 //#region src/internal/enum-values.d.ts
 declare const PLACEHOLDER_TYPES: readonly ["title", "body", "ctrTitle", "subTitle", "dt", "sldNum", "ftr", "hdr", "obj", "chart", "tbl", "clipArt", "dgm", "media", "sldImg", "pic"];
+declare const CAMERA_PRESETS: readonly ["legacyObliqueTopLeft", "legacyObliqueTop", "legacyObliqueTopRight", "legacyObliqueLeft", "legacyObliqueFront", "legacyObliqueRight", "legacyObliqueBottomLeft", "legacyObliqueBottom", "legacyObliqueBottomRight", "legacyPerspectiveTopLeft", "legacyPerspectiveTop", "legacyPerspectiveTopRight", "legacyPerspectiveLeft", "legacyPerspectiveFront", "legacyPerspectiveRight", "legacyPerspectiveBottomLeft", "legacyPerspectiveBottom", "legacyPerspectiveBottomRight", "orthographicFront", "isometricTopUp", "isometricTopDown", "isometricBottomUp", "isometricBottomDown", "isometricLeftUp", "isometricLeftDown", "isometricRightUp", "isometricRightDown", "isometricOffAxis1Left", "isometricOffAxis1Right", "isometricOffAxis1Top", "isometricOffAxis2Left", "isometricOffAxis2Right", "isometricOffAxis2Top", "isometricOffAxis3Left", "isometricOffAxis3Right", "isometricOffAxis3Bottom", "isometricOffAxis4Left", "isometricOffAxis4Right", "isometricOffAxis4Bottom", "obliqueTopLeft", "obliqueTop", "obliqueTopRight", "obliqueLeft", "obliqueRight", "obliqueBottomLeft", "obliqueBottom", "obliqueBottomRight", "perspectiveFront", "perspectiveLeft", "perspectiveRight", "perspectiveAbove", "perspectiveBelow", "perspectiveAboveLeftFacing", "perspectiveAboveRightFacing", "perspectiveContrastingLeftFacing", "perspectiveContrastingRightFacing", "perspectiveHeroicLeftFacing", "perspectiveHeroicRightFacing", "perspectiveHeroicExtremeLeftFacing", "perspectiveHeroicExtremeRightFacing", "perspectiveRelaxed", "perspectiveRelaxedModerately"];
+declare const LIGHT_RIG_TYPES: readonly ["legacyFlat1", "legacyFlat2", "legacyFlat3", "legacyFlat4", "legacyNormal1", "legacyNormal2", "legacyNormal3", "legacyNormal4", "legacyHarsh1", "legacyHarsh2", "legacyHarsh3", "legacyHarsh4", "threePt", "balanced", "soft", "harsh", "flood", "contrasting", "morning", "sunrise", "sunset", "chilly", "freezing", "flat", "twoPt", "glow", "brightRoom"];
+declare const LIGHT_RIG_DIRECTIONS: readonly ["tl", "t", "tr", "l", "r", "bl", "b", "br"];
+declare const BEVEL_PRESETS: readonly ["relaxedInset", "circle", "slope", "cross", "angle", "softRound", "convex", "coolSlant", "divot", "riblet", "hardEdge", "artDeco"];
+declare const PRESET_MATERIALS: readonly ["legacyMatte", "legacyPlastic", "legacyMetal", "legacyWireframe", "matte", "plastic", "metal", "warmMatte", "translucentPowder", "powder", "dkEdge", "softEdge", "clear", "flat", "softmetal"];
 //#endregion
 //#region src/internal/presentationml/slide-part.d.ts
 type ShapeKind = 'shape' | 'picture' | 'group' | 'graphicFrame' | 'connector';
@@ -260,6 +265,15 @@ interface SlideLayoutPart {
  */
 type PresetShape = 'rect' | 'roundRect' | 'ellipse' | 'triangle' | 'rtTriangle' | 'diamond' | 'parallelogram' | 'trapezoid' | 'pentagon' | 'hexagon' | 'heptagon' | 'octagon' | 'decagon' | 'star4' | 'star5' | 'star6' | 'star7' | 'star8' | 'star10' | 'star12' | 'star16' | 'star24' | 'star32' | 'rightArrow' | 'leftArrow' | 'upArrow' | 'downArrow' | 'leftRightArrow' | 'upDownArrow' | 'bentArrow' | 'curvedRightArrow' | 'curvedLeftArrow' | 'curvedUpArrow' | 'curvedDownArrow' | 'cloud' | 'heart' | 'lightningBolt' | 'sun' | 'moon' | 'bracketPair' | 'bracePair' | 'leftBracket' | 'rightBracket' | 'leftBrace' | 'rightBrace' | 'cube' | 'can' | 'donut' | 'noSmoking' | 'plus' | 'mathPlus' | 'mathMinus' | 'mathMultiply' | 'mathDivide' | 'mathEqual' | 'mathNotEqual';
 //#endregion
+//#region src/internal/drawingml/color-transforms.d.ts
+/** Ordered DrawingML color adjustments. Percentages are fractions; hue angles are degrees. */
+type ColorTransform = {
+  readonly kind: 'comp' | 'inv' | 'gray' | 'gamma' | 'invGamma';
+} | {
+  readonly kind: 'tint' | 'shade' | 'alpha' | 'alphaOff' | 'alphaMod' | 'hue' | 'hueOff' | 'hueMod' | 'sat' | 'satOff' | 'satMod' | 'lum' | 'lumOff' | 'lumMod' | 'red' | 'redOff' | 'redMod' | 'green' | 'greenOff' | 'greenMod' | 'blue' | 'blueOff' | 'blueMod';
+  readonly value: number;
+};
+//#endregion
 //#region src/internal/drawingml/color.d.ts
 declare const SCHEME_COLOR_TOKENS: readonly ["bg1", "tx1", "bg2", "tx2", "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "hlink", "folHlink", "phClr", "lt1", "dk1", "lt2", "dk2"];
 /** A theme color slot (`<a:schemeClr val="..."/>`). */
@@ -290,6 +304,178 @@ type Color = HexColor | SchemeColorToken | `scheme:${SchemeColorToken}`;
  */
 declare const asColor: (value: string) => Color | null;
 //#endregion
+//#region src/internal/drawingml/effects.d.ts
+interface ShadowOptions {
+  /** `#RRGGBB`, bare `RRGGBB`, or scheme token. Defaults to black. */
+  readonly color?: Color;
+  /**
+   * Ordered adjustments to `color` (`<a:lumMod>`, `<a:tint>`, ...), written
+   * as its children — the same field gradient stops take. Requires `color`.
+   * An `opacity` that differs from the one these transforms state wins.
+   */
+  readonly colorTransforms?: readonly ColorTransform[];
+  /** Edge blur in EMU. Defaults to 50800 (4pt). */
+  readonly blurEmu?: number;
+  /** Offset distance in EMU. Defaults to 38100 (3pt). */
+  readonly offsetEmu?: number;
+  /**
+   * Direction in degrees, measured clockwise from the right (3 o'clock).
+   * Defaults to 45° (down-right).
+   */
+  readonly angleDeg?: number;
+  /** Opacity (0–1). Defaults to fully opaque. */
+  readonly opacity?: number;
+  /** Transform anchor; defaults to top left (`tl`) for authored shadows. */
+  readonly alignment?: 'tl' | 't' | 'tr' | 'l' | 'ctr' | 'r' | 'bl' | 'b' | 'br';
+  /** Whether the shadow rotates with its shape; defaults to false. */
+  readonly rotateWithShape?: boolean;
+}
+/** Character or shape inner-shadow parameters from `<a:innerShdw>`. */
+interface InnerShadowOptions {
+  /** `#RRGGBB`, bare `RRGGBB`, or scheme token. Defaults to black. */
+  readonly color?: Color;
+  /**
+   * Ordered adjustments to `color` (`<a:lumMod>`, `<a:tint>`, ...), written
+   * as its children — the same field gradient stops take. Requires `color`.
+   * An `opacity` that differs from the one these transforms state wins.
+   */
+  readonly colorTransforms?: readonly ColorTransform[];
+  /** Edge blur in EMU. Defaults to 50800 (4pt). */
+  readonly blurEmu?: number;
+  /** Offset distance in EMU. Defaults to 38100 (3pt). */
+  readonly offsetEmu?: number;
+  /** Direction in degrees, measured clockwise from the right. Defaults to 45°. */
+  readonly angleDeg?: number;
+  /** Opacity (0–1). Defaults to fully opaque. */
+  readonly opacity?: number;
+}
+interface GlowOptions {
+  /** `#RRGGBB`, bare `RRGGBB`, or scheme token. */
+  readonly color: Color;
+  /**
+   * Ordered adjustments to `color` (`<a:lumMod>`, `<a:tint>`, ...), written
+   * as its children — the same field gradient stops take. Requires `color`.
+   * An `opacity` that differs from the one these transforms state wins.
+   */
+  readonly colorTransforms?: readonly ColorTransform[];
+  /** Glow radius in EMU. Defaults to 63500 (5pt). */
+  readonly radiusEmu?: number;
+  /** Opacity (0–1). Defaults to fully opaque. */
+  readonly opacity?: number;
+}
+/** Character reflection parameters from DrawingML's `<a:reflection>`. */
+interface ReflectionOptions {
+  /** Blur radius in EMU; defaults to zero. */
+  readonly blurEmu?: number;
+  /** Offset distance in EMU; defaults to zero. */
+  readonly offsetEmu?: number;
+  /** Offset direction in clockwise degrees from right; defaults to zero. */
+  readonly angleDeg?: number;
+  /** Ending opacity (0–1); defaults to zero (`endA`). */
+  readonly opacity?: number;
+  /** Starting opacity (0–1); defaults to one. */
+  readonly startOpacity?: number;
+  /** Starting fade position (0–1); defaults to zero. */
+  readonly startPosition?: number;
+  /** Ending fade position (0–1); defaults to one. */
+  readonly endPosition?: number;
+  /** Fade direction in clockwise degrees from right; defaults to 90. */
+  readonly fadeDirection?: number;
+  /** Horizontal scale; defaults to one. Negative values mirror horizontally. */
+  readonly scaleX?: number;
+  /** Vertical scale; defaults to one. Negative values mirror vertically. */
+  readonly scaleY?: number;
+  /** Horizontal skew in degrees, strictly between -90 and 90. */
+  readonly skewX?: number;
+  /** Vertical skew in degrees, strictly between -90 and 90. */
+  readonly skewY?: number;
+  /** Transform anchor; defaults to bottom center (`b`). */
+  readonly alignment?: 'tl' | 't' | 'tr' | 'l' | 'ctr' | 'r' | 'bl' | 'b' | 'br';
+  /** Whether the effect rotates with its shape; defaults to true. */
+  readonly rotateWithShape?: boolean;
+}
+//#endregion
+//#region src/internal/drawingml/fill.d.ts
+/** One stop in a linear gradient. */
+interface GradientStop {
+  /** Position on the gradient axis, 0-1. */
+  readonly offset: number;
+  /** `#RRGGBB`, the `#RGB` shorthand, or a theme color token. */
+  readonly color: Color;
+  /** Ordered imported color adjustments. Brightness and opacity override their corresponding transforms when changed. */
+  readonly colorTransforms?: readonly ColorTransform[];
+  /** Opacity from 0 (transparent) to 1 (opaque). */
+  readonly opacity?: number;
+  /** PowerPoint brightness from -1 (black) to 1 (white); 0 leaves the color unchanged. */
+  readonly brightness?: number;
+}
+interface GradientFillOptions {
+  /** Two or more color stops along the axis. */
+  readonly stops: ReadonlyArray<GradientStop>;
+  /**
+   * Gradient axis angle, in degrees. ECMA-376 measures clockwise from
+   * the right (3 o'clock); `0` is a left-to-right gradient, `90` is
+   * top-to-bottom, `180` right-to-left, `270` bottom-to-top. Defaults
+   * to `90` (top → bottom). Only meaningful for linear gradients.
+   */
+  readonly angleDeg?: number;
+  /** Rotate the gradient with the shape. Defaults to true. */
+  readonly rotateWithShape?: boolean;
+  /** Scale a linear gradient with the shape's aspect ratio. Defaults to false. */
+  readonly scaled?: boolean;
+  /**
+   * Non-linear gradient path. `circle` paints concentric circles,
+   * `rect` paints nested rectangles, `shape` follows the shape's
+   * outline. Absent / `'linear'` → linear gradient using `angleDeg`.
+   * Mirrors ECMA-376 §20.1.8.33 `<a:path path="…"/>`.
+   */
+  readonly path?: 'linear' | 'circle' | 'rect' | 'shape';
+  /**
+   * Focus rectangle for non-linear gradients, expressed as fractional insets
+   * from each corresponding edge (1 = 100%). Four 0.5 insets describe
+   * a point at the center; left/top 1 and right/bottom 0 describe the
+   * bottom-right corner. Mirrors `<a:fillToRect>`.
+   */
+  readonly focus?: {
+    readonly left: number;
+    readonly top: number;
+    readonly right: number;
+    readonly bottom: number;
+  };
+  /**
+   * Gradient tile bounds as fractional insets from the shape's edges.
+   * Negative values extend the tile beyond that edge. Mac PowerPoint uses
+   * right/bottom -1 for its bottom-right radial direction. Mirrors `<a:tileRect>`.
+   */
+  readonly tileRect?: GradientFillOptions['focus'];
+}
+/**
+ * A gradient read back from a deck. Stop colors widen to `string`: the
+ * readers surface a scheme token verbatim, including one outside the theme,
+ * rather than dropping it.
+ */
+type ReadGradientStop = Omit<GradientStop, 'color'> & {
+  readonly color: string; /** Theme- and transform-resolved color, supplied by the effective shape reader. */
+  readonly resolvedColor?: string;
+};
+type ReadGradientFill = Omit<GradientFillOptions, 'stops'> & {
+  readonly stops: ReadonlyArray<ReadGradientStop>;
+};
+/** Every `ST_PresetPatternVal` token (ECMA-376 dml-main.xsd). */
+declare const PATTERN_PRESETS: readonly ["pct5", "pct10", "pct20", "pct25", "pct30", "pct40", "pct50", "pct60", "pct70", "pct75", "pct80", "pct90", "horz", "vert", "ltHorz", "ltVert", "dkHorz", "dkVert", "narHorz", "narVert", "dashHorz", "dashVert", "cross", "dnDiag", "upDiag", "ltDnDiag", "ltUpDiag", "dkDnDiag", "dkUpDiag", "wdDnDiag", "wdUpDiag", "dashDnDiag", "dashUpDiag", "diagCross", "smCheck", "lgCheck", "smGrid", "lgGrid", "dotGrid", "smConfetti", "lgConfetti", "horzBrick", "diagBrick", "solidDmnd", "openDmnd", "dotDmnd", "plaid", "sphere", "weave", "divot", "shingle", "wave", "trellis", "zigZag"];
+/** One of ECMA-376's `ST_PresetPatternVal` tokens (`pct50`, `dkUpDiag`, ...). */
+type PatternPreset = (typeof PATTERN_PRESETS)[number];
+interface PatternFillOptions {
+  /** Preset pattern token, e.g. `'pct50'`, `'dkUpDiag'`, `'wave'`. */
+  readonly preset: PatternPreset;
+  /** Foreground (pattern stroke) color. `#RRGGBB`, bare `RRGGBB`, or scheme token. */
+  readonly foreground: string;
+  /** Background (fill behind the pattern) color. */
+  readonly background: string;
+  readonly foregroundTransforms?: readonly ColorTransform[];
+  readonly backgroundTransforms?: readonly ColorTransform[];
+}
+//#endregion
 //#region src/internal/drawingml/text-format.d.ts
 interface TextFormat {
   /** Latin font family (`Calibri`, `Arial`, ...). Sets `<a:latin>`. */
@@ -314,6 +500,18 @@ interface TextFormat {
    * (`tx1`, `accent1`, ...), or `null` to clear.
    */
   color?: Color | null;
+  /**
+   * Ordered adjustments to `color` (`<a:lumMod>`, `<a:tint>`, `<a:alpha>`,
+   * ...), written as children of its color element — PowerPoint's theme
+   * tints, such as Accent 2 Lighter 60%. Same field as on gradient stops;
+   * requires `color`, and replaces any transforms the run's color had.
+   */
+  colorTransforms?: readonly ColorTransform[];
+  /**
+   * Non-solid glyph fill. The `color` field remains the shorthand for a solid
+   * fill. Both are the same OOXML fill choice, so supplying both is rejected.
+   */
+  textFill?: TextFill;
   bold?: boolean;
   italic?: boolean;
   /**
@@ -322,6 +520,12 @@ interface TextFormat {
    * `'dash'`, ...).
    */
   underline?: boolean | string;
+  /**
+   * Underline color. `null` explicitly follows the run's text color via
+   * `<a:uFillTx>`; omit the property to leave an existing underline fill
+   * untouched.
+   */
+  underlineColor?: Color | null;
   /**
    * Strikethrough style. `true` is shorthand for `'sngStrike'` (single
    * line). Pass the exact `ST_TextStrikeType` token (`'sngStrike'`,
@@ -336,9 +540,12 @@ interface TextFormat {
   /**
    * Kerning threshold in 1/100 points (`ST_TextNonNegativePoint`, the same
    * unit as `spc`): `0` disables kerning, `1200` = apply kerning for runs
-   * ≥12pt. Mirrors `<a:rPr kern="…"/>`.
+   * ≥12pt. Mirrors `<a:rPr kern="…"/>`. Mac PowerPoint was observed to
+   * save the value as `kern="0"` when its Use kerning checkbox is cleared.
    */
   kern?: number;
+  /** Normalize character heights (`<a:rPr normalizeH>`; PowerPoint's Equalize character height). */
+  normalizeHeight?: boolean;
   /**
    * Baseline offset as a fraction of 1 (`0.3` = superscript ~30% up,
    * `-0.25` = subscript). PowerPoint emits ST_Percentage; this getter
@@ -355,16 +562,85 @@ interface TextFormat {
    * format as `color`. Mirrors `<a:rPr><a:highlight>…</a:highlight></a:rPr>`.
    */
   highlight?: Color | null;
+  /**
+   * Outline drawn around the glyphs — `<a:rPr><a:ln>`, the character-level
+   * twin of `setShapeStroke`. `null` removes it, which is not the same as
+   * an outline of width 0: removing restores what the run inherits.
+   */
+  outline?: TextOutline | null;
+  /**
+   * Drop shadow behind the glyphs — `<a:outerShdw>` in the run's own
+   * `<a:effectLst>`. `null` removes it.
+   */
+  shadow?: ShadowOptions | null;
+  /** Inner shadow inside the glyphs — `<a:innerShdw>` in the run's effect list. */
+  innerShadow?: InnerShadowOptions | null;
+  /**
+   * Glow around the glyphs — `<a:glow>` in the run's own `<a:effectLst>`.
+   * `null` removes it.
+   */
+  glow?: GlowOptions | null;
+  /** Reflection below the glyphs — `<a:reflection>` in the run's effect list. */
+  reflection?: ReflectionOptions | null;
+}
+type TextFill = ({
+  readonly kind: 'gradient';
+} & GradientFillOptions) | ({
+  readonly kind: 'pattern';
+} & PatternFillOptions);
+type ReadTextFill = ({
+  readonly kind: 'gradient';
+} & ReadGradientFill) | {
+  readonly kind: 'pattern';
+  readonly preset: PatternFillOptions['preset'];
+  readonly foreground: string;
+  readonly background: string;
+  readonly foregroundTransforms?: PatternFillOptions['foregroundTransforms'];
+  readonly backgroundTransforms?: PatternFillOptions['backgroundTransforms'];
+};
+/** A run's outline: `CT_LineProperties` as far as text uses it. */
+interface TextOutline {
+  /** Same accepted forms as `TextFormat.color`. */
+  readonly color?: Color;
+  /** Ordered adjustments to `color`, as on `TextFormat.colorTransforms`. Requires `color`. */
+  readonly colorTransforms?: readonly ColorTransform[];
+  /** Line width in EMU. PowerPoint's thinnest visible text outline is 9525 (0.75pt). */
+  readonly widthEmu?: number;
 }
 /**
  * A run format read back from a deck. `color` and `highlight` widen to
  * `string`: when no theme is supplied, or a token is not in the scheme, the
  * readers surface the raw `<a:schemeClr val>` token as-is.
  */
-type ReadTextFormat = Omit<TextFormat, 'color' | 'highlight'> & {
+type ReadTextFormat = Omit<TextFormat, 'color' | 'textFill' | 'underlineColor' | 'highlight' | 'outline' | 'shadow' | 'innerShadow' | 'glow' | 'reflection'> & {
   color?: string | null;
+  underlineColor?: string | null;
   highlight?: string | null;
+  outline?: ReadTextOutline | null;
+  shadow?: (Omit<ShadowOptions, 'color'> & {
+    readonly color?: string;
+  }) | null;
+  innerShadow?: (Omit<InnerShadowOptions, 'color'> & {
+    readonly color?: string;
+  }) | null;
+  glow?: (Omit<GlowOptions, 'color'> & {
+    readonly color: string;
+  }) | null;
+  reflection?: ReflectionOptions | null;
+  textFill?: ReadTextFill;
+};
+/** A run outline read back from a deck. `color` widens for the same reason. */
+type ReadTextOutline = Omit<TextOutline, 'color'> & {
+  readonly color?: string;
 };
+/**
+ * Converts a format read back from a deck into one a writer accepts. The
+ * readers widen every color to `string`, because a deck can hold a scheme
+ * token that is not in its theme; this checks each one and drops the property
+ * (or, for a glow, the whole effect) when the writer would reject it, so the
+ * round trip never writes a color the schema has no room for.
+ */
+declare const toWritableTextFormat: (format: ReadTextFormat) => TextFormat;
 //#endregion
 //#region src/internal/drawingml/text-body-mutation.d.ts
 /**
@@ -418,89 +694,63 @@ interface ParagraphSpec {
   readonly endFormat?: TextFormat;
 }
 //#endregion
-//#region src/internal/drawingml/fill.d.ts
-/** One stop in a linear gradient. */
-interface GradientStop {
-  /** Position on the gradient axis, 0-1. */
-  readonly offset: number;
-  /** `#RRGGBB`, the `#RGB` shorthand, or a theme color token. */
-  readonly color: Color;
+//#region src/internal/drawingml/text-3d.d.ts
+/** ECMA-376 `ST_PresetCameraType`; PowerPoint's flat WordArt uses `'orthographicFront'`. */
+type CameraPreset = (typeof CAMERA_PRESETS)[number];
+/** ECMA-376 `ST_LightRigType` (`'threePt'`, `'soft'`, `'harsh'`, ...). */
+type LightRigType = (typeof LIGHT_RIG_TYPES)[number];
+/** ECMA-376 `ST_LightRigDirection`: where the light rig sits relative to the scene. */
+type LightRigDirection = (typeof LIGHT_RIG_DIRECTIONS)[number];
+/** ECMA-376 `ST_BevelPresetType` (`'circle'`, `'angle'`, `'softRound'`, ...). */
+type BevelPreset = (typeof BEVEL_PRESETS)[number];
+/** ECMA-376 `ST_PresetMaterialType` (`'matte'`, `'softEdge'`, `'metal'`, ...). */
+type PresetMaterial = (typeof PRESET_MATERIALS)[number];
+/** `CT_SphereCoords`: a rotation in degrees, each in `[0, 360)`. */
+interface Rotation3D {
+  readonly latitudeDeg: number;
+  readonly longitudeDeg: number;
+  readonly revolutionDeg: number;
 }
-interface GradientFillOptions {
-  /** Two or more color stops along the axis. */
-  readonly stops: ReadonlyArray<GradientStop>;
-  /**
-   * Gradient axis angle, in degrees. ECMA-376 measures clockwise from
-   * the right (3 o'clock); `0` is a left-to-right gradient, `90` is
-   * top-to-bottom, `180` right-to-left, `270` bottom-to-top. Defaults
-   * to `90` (top → bottom). Only meaningful for linear gradients.
-   */
-  readonly angleDeg?: number;
-  /**
-   * Non-linear gradient path. `circle` paints concentric circles,
-   * `rect` paints nested rectangles, `shape` follows the shape's
-   * outline. Absent / `'linear'` → linear gradient using `angleDeg`.
-   * Mirrors ECMA-376 §20.1.8.33 `<a:path path="…"/>`.
-   */
-  readonly path?: 'linear' | 'circle' | 'rect' | 'shape';
-  /**
-   * Focus rectangle for non-linear gradients, in unit coordinates
-   * (0 = left/top, 1 = right/bottom). When omitted, defaults to a
-   * single point at the rectangle's center. Mirrors `<a:fillToRect>`.
-   */
-  readonly focus?: {
-    readonly left: number;
-    readonly top: number;
-    readonly right: number;
-    readonly bottom: number;
-  };
+/** `<a:lightRig>`. */
+interface LightRig {
+  readonly type: LightRigType;
+  readonly direction: LightRigDirection;
+  /** `<a:rot>`; omitted, the rig keeps its preset orientation. */
+  readonly rotation?: Rotation3D;
 }
-/**
- * A gradient read back from a deck. Stop colors widen to `string`: the
- * readers surface a scheme token verbatim, including one outside the theme,
- * rather than dropping it.
- */
-type ReadGradientStop = Omit<GradientStop, 'color'> & {
-  readonly color: string;
-};
-type ReadGradientFill = Omit<GradientFillOptions, 'stops'> & {
-  readonly stops: ReadonlyArray<ReadGradientStop>;
-};
-/** Every `ST_PresetPatternVal` token (ECMA-376 dml-main.xsd). */
-declare const PATTERN_PRESETS: readonly ["pct5", "pct10", "pct20", "pct25", "pct30", "pct40", "pct50", "pct60", "pct70", "pct75", "pct80", "pct90", "horz", "vert", "ltHorz", "ltVert", "dkHorz", "dkVert", "narHorz", "narVert", "dashHorz", "dashVert", "cross", "dnDiag", "upDiag", "ltDnDiag", "ltUpDiag", "dkDnDiag", "dkUpDiag", "wdDnDiag", "wdUpDiag", "dashDnDiag", "dashUpDiag", "diagCross", "smCheck", "lgCheck", "smGrid", "lgGrid", "dotGrid", "smConfetti", "lgConfetti", "horzBrick", "diagBrick", "solidDmnd", "openDmnd", "dotDmnd", "plaid", "sphere", "weave", "divot", "shingle", "wave", "trellis", "zigZag"];
-/** One of ECMA-376's `ST_PresetPatternVal` tokens (`pct50`, `dkUpDiag`, ...). */
-type PatternPreset = (typeof PATTERN_PRESETS)[number];
-interface PatternFillOptions {
-  /** Preset pattern token, e.g. `'pct50'`, `'dkUpDiag'`, `'wave'`. */
-  readonly preset: PatternPreset;
-  /** Foreground (pattern stroke) color. `#RRGGBB`, bare `RRGGBB`, or scheme token. */
-  readonly foreground: string;
-  /** Background (fill behind the pattern) color. */
-  readonly background: string;
+/** `<a:scene3d>`: the camera and light the 3-D text is rendered with. */
+interface Scene3D {
+  readonly camera: CameraPreset;
+  readonly lightRig: LightRig;
 }
-//#endregion
-//#region src/internal/drawingml/effects.d.ts
-interface ShadowOptions {
-  /** `#RRGGBB`, bare `RRGGBB`, or scheme token. Defaults to black. */
-  readonly color?: Color;
-  /** Edge blur in EMU. Defaults to 50800 (4pt). */
-  readonly blurEmu?: number;
-  /** Offset distance in EMU. Defaults to 38100 (3pt). */
-  readonly offsetEmu?: number;
-  /**
-   * Direction in degrees, measured clockwise from the right (3 o'clock).
-   * Defaults to 45° (down-right).
-   */
-  readonly angleDeg?: number;
-  /** Opacity (0–1). Defaults to fully opaque. */
-  readonly opacity?: number;
+/** `CT_Bevel`. Omitted fields take the schema defaults: `circle`, 76200 × 76200 EMU. */
+interface Bevel {
+  readonly preset?: BevelPreset;
+  readonly widthEmu?: number;
+  readonly heightEmu?: number;
 }
-interface GlowOptions {
-  /** `#RRGGBB`, bare `RRGGBB`, or scheme token. */
-  readonly color: Color;
-  /** Glow radius in EMU. Defaults to 63500 (5pt). */
-  readonly radiusEmu?: number;
+/**
+ * 3-D on a text body — what PowerPoint writes for WordArt bevels. `scene`
+ * becomes `<a:scene3d>`; the other fields become `<a:sp3d>`, written when any
+ * of them is set.
+ */
+interface Text3D {
+  readonly scene?: Scene3D;
+  /** Top bevel (`<a:bevelT>`). */
+  readonly bevelTop?: Bevel;
+  /** Extrusion depth (`extrusionH`) in EMU. */
+  readonly extrusionHeightEmu?: number;
+  /** Surface material (`prstMaterial`). */
+  readonly material?: PresetMaterial;
+  /** Contour color (`<a:contourClr>`). Same accepted forms as `TextFormat.color`. */
+  readonly contourColor?: Color;
+  /** Ordered adjustments to `contourColor`. Requires `contourColor`. */
+  readonly contourColorTransforms?: readonly ColorTransform[];
 }
+/** A text body's 3-D read back from a deck; `contourColor` is the raw `#RRGGBB` or scheme token. */
+type ReadText3D = Omit<Text3D, 'contourColor'> & {
+  readonly contourColor?: string;
+};
 //#endregion
 //#region src/internal/drawingml/stroke.d.ts
 /**
@@ -567,8 +817,24 @@ interface GeomPath {
   readonly stroke: boolean;
   readonly commands: readonly GeomCommand[];
 }
+/**
+ * `<a:rect>` (§20.1.9.22) — the rectangle a shape lays its text into,
+ * in EMU from the shape's own top-left corner.
+ *
+ * Unlike the path commands above, this is written in the guide coordinate
+ * space rather than a path's, so a value is either a literal EMU number or a
+ * guide name; both are already resolved here. Custom shapes that omit it lay
+ * text into the whole box, which is what `null` means.
+ */
+interface GeomTextRect {
+  readonly l: number;
+  readonly t: number;
+  readonly r: number;
+  readonly b: number;
+}
 interface CustomGeometry {
   readonly paths: readonly GeomPath[];
+  readonly textRect: GeomTextRect | null;
 }
 //#endregion
 //#region src/internal/drawingml/geometry.d.ts
@@ -615,6 +881,8 @@ interface TransitionOptions {
    * `direction` is ignored.
    */
   direction?: string;
+  /** For `wheel`: number of spokes (unsigned integer). Omitted means 4. */
+  spokes?: number;
   /** For `split`: orientation token (`horz` / `vert`). */
   orientation?: 'horz' | 'vert';
   /** For `fade`: pass `true` to fade through black. */
@@ -626,6 +894,13 @@ interface TransitionOptions {
    * advance.
    */
   advanceAfterMs?: number;
+  /**
+   * Effect duration in milliseconds (PowerPoint 2010's `p14:dur`). ECMA-376
+   * only has the three `speed` steps, so the transition is written as
+   * PowerPoint writes it: an `mc:AlternateContent` whose `p14` choice carries
+   * the duration and whose fallback carries the nearest `speed`.
+   */
+  durationMs?: number;
 }
 /**
  * A transition read back from a deck. `effect` widens to `string` because a
@@ -637,13 +912,55 @@ type SlideTransition = Omit<TransitionOptions, 'effect'> & {
 };
 //#endregion
 //#region src/internal/presentationml/animation-builder.d.ts
-/** What kind of effect to apply. v1 covers the four most-used presets. */
-type AnimationEffect = 'fadeIn' | 'fadeOut' | 'appear' | 'disappear';
+/**
+ * What kind of effect to apply.
+ *
+ * Entrance effects put the shape on the slide and exit effects take it off.
+ * `spin` is the one emphasis effect modelled here: it turns a shape that is
+ * already on the slide and leaves it exactly where it was, so it never decides
+ * whether the shape is shown.
+ */
+type AnimationEffect = 'appear' | 'fadeIn' | 'flyIn' | 'zoomIn' | 'disappear' | 'fadeOut' | 'flyOut' | 'zoomOut' | 'spin';
+/**
+ * Which edge of the slide a `flyIn` comes from, or a `flyOut` leaves by —
+ * PowerPoint's "From Bottom" / Google Slides' "Fly in from bottom".
+ */
+type AnimationDirection = 'top' | 'right' | 'bottom' | 'left';
+/** When an effect runs relative to the one before it. */
+type AnimationStartCondition = 'click' | 'withPrevious' | 'afterPrevious';
 interface AnimationOptions {
   /** Which preset effect to apply. */
   readonly effect: AnimationEffect;
-  /** Animation length in milliseconds. Defaults to 500ms. */
+  /**
+   * Which edge of the slide a `'flyIn'` comes from, or a `'flyOut'` leaves by.
+   * Defaults to `'bottom'`, PowerPoint's own default for the preset. Passing it
+   * for an effect that does not fly is an error rather than a no-op: it would
+   * otherwise read as a direction the file never records.
+   */
+  readonly direction?: AnimationDirection;
+  /**
+   * Animation length in milliseconds. Defaults to 500ms. `'appear'` and
+   * `'disappear'` are instantaneous by definition of the preset and write no
+   * timed behaviour at all, so it does not reach them.
+   */
   readonly durationMs?: number;
+  /**
+   * What starts the effect. Defaults to `'click'` — the effect waits for the
+   * viewer's next click. `'withPrevious'` runs it alongside the effect before
+   * it, `'afterPrevious'` once that effect has finished. When the effect is
+   * the slide's first, neither has a predecessor to follow, so both start as
+   * soon as the slide appears instead of waiting for a click.
+   */
+  readonly start?: AnimationStartCondition;
+  /** How long to wait once the start condition is met. Defaults to 0ms. */
+  readonly delayMs?: number;
+  /**
+   * Reveal the shape's text one paragraph at a time instead of animating the
+   * shape as a whole — PowerPoint's "By paragraph", Google Slides' "By
+   * paragraph". Each paragraph gets its own effect with the same `start`, so
+   * the default `'click'` advances one paragraph per click.
+   */
+  readonly byParagraph?: boolean;
 }
 //#endregion
 //#region src/internal/presentationml/comments-part.d.ts
@@ -662,6 +979,10 @@ interface CommentPosition {
   readonly y: number;
 }
 interface SlideComment {
+  readonly parent?: {
+    readonly authorId: number;
+    readonly idx: number;
+  };
   /** Author id (matches `CommentAuthor.id`). */
   readonly authorId: number;
   /** Per-author monotonic index. */
@@ -672,6 +993,11 @@ interface SlideComment {
   readonly position: CommentPosition | null;
 }
 //#endregion
+//#region src/internal/presentationml/modern-comments-part.d.ts
+/** `ST_CommentStatus` — the three states a thread can be in. */
+type CommentStatus = 'active' | 'resolved' | 'closed';
+declare const COMMENT_STATUSES: readonly CommentStatus[];
+//#endregion
 //#region src/api/_internal-symbols.d.ts
 declare const INTERNAL_PACKAGE: unique symbol;
 declare const SLIDE_PART_NAME: unique symbol;
@@ -683,8 +1009,11 @@ declare const SHAPE_ELEMENT: unique symbol;
 declare const SHAPE_SNAPSHOT: unique symbol;
 declare const LAYOUT_PART_NAME: unique symbol;
 declare const LAYOUT_PART: unique symbol;
+declare const LAYOUT_DOCUMENT: unique symbol;
+declare const COMMENT_PARENT: unique symbol;
 declare const COMMENT_SLIDE: unique symbol;
 declare const COMMENT_SNAPSHOT: unique symbol;
+declare const COMMENT_MODERN: unique symbol;
 declare const CELL_TABLE: unique symbol;
 declare const CELL_ELEMENT: unique symbol;
 declare const CELL_ROW: unique symbol;
@@ -713,18 +1042,44 @@ interface SlideShapeData {
   [SHAPE_ELEMENT]: XmlElement;
   [SHAPE_SNAPSHOT]: SlidePart['shapes'][number];
 }
-/** Data shape backing every `SlideLayout` value. */
+/**
+ * Data shape backing every `SlideLayout` value. Carries the parsed
+ * document, not just the typed view, so a layout handle can be edited
+ * and written back the way a slide handle can.
+ */
 interface SlideLayoutData {
+  readonly [INTERNAL_PACKAGE]: OpcPackage;
   readonly [LAYOUT_PART_NAME]: PartName;
-  readonly [LAYOUT_PART]: SlideLayoutPart;
+  [LAYOUT_DOCUMENT]: XmlDocument;
+  [LAYOUT_PART]: SlideLayoutPart;
+}
+/** Where a modern comment handle points: its thread, and itself within it. */
+interface ModernCommentRef {
+  /** Id of the `<p188:cm>`; equal to `id` when the handle is the thread itself. */
+  readonly threadId: string;
+  readonly id: string;
+  readonly status: CommentStatus | null;
+  readonly authorId: string;
 }
 /**
  * Opaque handle for one comment on a slide. The `author` is resolved
- * on read against the package-level `commentAuthors.xml`.
+ * on read: against the package-level `commentAuthors.xml` for an
+ * ECMA-376 `<p:cm>`, and against `authors.xml` for a modern one.
  */
 interface SlideCommentData {
+  [COMMENT_PARENT]: SlideCommentData | null;
   readonly [COMMENT_SLIDE]: SlideData;
-  readonly [COMMENT_SNAPSHOT]: SlideComment;
+  /**
+   * For a modern comment this is a projection, not what is on disk: `text`,
+   * `dt` (the thread's `created`) and `position` are real, while `authorId`
+   * and `idx` are the author's place in the modern author list and the
+   * comment's place in its part. They exist so the deck-wide queries read
+   * one shape whatever the file uses; nothing is ever written back through
+   * them. `COMMENT_MODERN` is what every modern mutation goes through.
+   */
+  [COMMENT_SNAPSHOT]: SlideComment;
+  /** Set for a modern comment; `null` for an ECMA-376 one. */
+  [COMMENT_MODERN]: ModernCommentRef | null;
   readonly author: CommentAuthor;
 }
 /**
@@ -813,8 +1168,7 @@ declare const getShapeId: (shape: SlideShapeData) => number;
  * `'rightArrow'`, ...) for shapes whose body carries a
  * `<a:prstGeom prst="…"/>`. Returns `null` for:
  *
- *   - non-`'shape'` kinds (pictures, connectors, group shapes, tables,
- *     charts — they have their own geometry tags or no geometry),
+ *   - group shapes, tables, and charts (they have no preset geometry),
  *   - shapes using custom geometry (`<a:custGeom>`),
  *   - shapes whose preset is missing (malformed but possible).
  *
@@ -895,15 +1249,14 @@ declare const getSlideMasterCount: (pres: PresentationData) => number;
  * are missing.
  */
 /**
- * Returns the part name of the slide master a slide inherits from
- * (`/ppt/slideMasters/slideMaster1.xml`), or `null` when the slide
- * has no layout or its layout has no master rel.
+ * Returns the part name of the slide master a slide or layout inherits from
+ * (`/ppt/slideMasters/slideMaster1.xml`), or `null` when it has no master rel.
  *
  * Useful for multi-master decks where different slides live under
  * different brand templates and the caller needs to scope theme /
  * fontScheme / clrMap lookups to the correct master.
  */
-declare const getSlideMasterPartName: (slide: SlideData) => string | null;
+declare const getSlideMasterPartName: (value: SlideData | SlideLayoutData) => string | null;
 declare const getSlideMasterPartNames: (pres: PresentationData) => ReadonlyArray<string>;
 /**
  * Histogram of master part name → number of slides whose layout chains
@@ -963,7 +1316,8 @@ declare const isShapeHidden: (shape: SlideShapeData) => boolean;
  * Sets or clears `<p:cNvPr hidden="...">` on the shape. Hidden
  * shapes remain in the document but PowerPoint doesn't render them.
  */
-declare const setShapeHidden: (shape: SlideShapeData, hidden: boolean) => void;
+declare function setShapeHidden(shape: SlideShapeData, hidden: boolean): void;
+declare function setShapeHidden(shapes: readonly SlideShapeData[], hidden: boolean): void;
 declare const renameShape: (shape: SlideShapeData, newName: string) => void;
 declare const getShapePlaceholderType: (shape: SlideShapeData) => string | null;
 declare const getShapePlaceholderIdx: (shape: SlideShapeData) => number | null;
@@ -1281,6 +1635,8 @@ type ShapeFill = {
   readonly kind: 'pattern';
 } | {
   readonly kind: 'image';
+} | {
+  readonly kind: 'background';
 } | {
   readonly kind: 'none';
 } | {
@@ -1334,25 +1690,25 @@ declare const getShapeStrokeColorResolved: (pres: PresentationData, shape: Slide
  * alpha transform (PowerPoint draws it fully opaque). Companion to
  * `getShapeStrokeColorResolved`, which never carries the alpha channel.
  */
-declare const getShapeStrokeOpacity: (shape: SlideShapeData) => number | null;
+declare const getShapeStrokeOpacity: (shape: SlideShapeData, pres?: PresentationData) => number | null;
 /**
  * Reads the stroke's line cap style — `'rnd'` (round), `'sq'` (square),
  * `'flat'`, or `null` when the attribute isn't set. Per ECMA-376
  * §20.1.2.3.10 (`ST_LineCap`).
  */
-declare const getShapeStrokeCap: (shape: SlideShapeData) => "rnd" | "sq" | "flat" | null;
+declare const getShapeStrokeCap: (shape: SlideShapeData, pres?: PresentationData) => "rnd" | "sq" | "flat" | null;
 /**
  * Reads the stroke's line join style — `'round'` / `'bevel'` / `'miter'`,
  * or `null` when no explicit join element is present. Maps from the
  * three child-element variants `<a:round/>`, `<a:bevel/>`, `<a:miter/>`.
  */
-declare const getShapeStrokeJoin: (shape: SlideShapeData) => "round" | "bevel" | "miter" | null;
+declare const getShapeStrokeJoin: (shape: SlideShapeData, pres?: PresentationData) => "round" | "bevel" | "miter" | null;
 /**
  * Reads the stroke's compound-line style (`<a:ln cmpd="…">`) — single,
  * double, triple, or thick/thin / thin/thick parallel lines. ECMA-376
  * §20.1.2.3.11 (`ST_CompoundLine`).
  */
-declare const getShapeStrokeCompound: (shape: SlideShapeData) => "sng" | "dbl" | "thickThin" | "thinThick" | "tri" | null;
+declare const getShapeStrokeCompound: (shape: SlideShapeData, pres?: PresentationData) => "sng" | "dbl" | "thickThin" | "thinThick" | "tri" | null;
 /**
  * Same as `getShapeStroke` but walks the layout → master placeholder
  * cascade when the shape itself reports `'inherit'`. First non-inherit
@@ -1381,14 +1737,15 @@ declare const getShapeFillColor: (shape: SlideShapeData) => string | null;
  */
 declare const getShapeFillColorResolved: (pres: PresentationData, shape: SlideShapeData) => string | null;
 /**
- * Returns the opacity (`0`–`1`) of the shape's own solid fill, read from
+ * Returns the opacity (`0`–`1`) of the shape's solid fill, read from
  * the `<a:alpha>` / `<a:alphaMod>` / `<a:alphaOff>` children of its color
  * element, or `null` when the fill isn't solid or carries no alpha
  * transform (PowerPoint paints it fully opaque). Companion to
  * `getShapeFillColorResolved`, which never carries the alpha channel —
- * OOXML encodes color and alpha independently.
+ * OOXML encodes color and alpha independently. Pass `pres` to resolve the
+ * shape's theme fill reference when no direct fill is present.
  */
-declare const getShapeFillOpacity: (shape: SlideShapeData) => number | null;
+declare const getShapeFillOpacity: (shape: SlideShapeData, pres?: PresentationData) => number | null;
 /**
  * Same as `getShapeFill` but walks the layout → master placeholder
  * cascade when the shape itself reports `'inherit'`. Returns the first
@@ -1399,6 +1756,105 @@ declare const getShapeFillOpacity: (shape: SlideShapeData) => number | null;
 declare const getShapeFillEffective: (pres: PresentationData, shape: SlideShapeData) => ShapeFill;
 declare const getShapeFill: (shape: SlideShapeData) => ShapeFill;
 //#endregion
+//#region src/api/fn/theme.d.ts
+/**
+ * The named color scheme on a presentation's theme. Each slot is a
+ * `#RRGGBB` string — `sysClr` slots are flattened to their cached
+ * `lastClr` value.
+ */
+interface PresentationTheme {
+  readonly name: string;
+  readonly dark1: string;
+  readonly light1: string;
+  readonly dark2: string;
+  readonly light2: string;
+  readonly accent1: string;
+  readonly accent2: string;
+  readonly accent3: string;
+  readonly accent4: string;
+  readonly accent5: string;
+  readonly accent6: string;
+  readonly hyperlink: string;
+  readonly followedHyperlink: string;
+}
+/**
+ * Returns the deck's color scheme as `#RRGGBB` strings, or `null` if
+ * the package carries no theme. Each accent slot maps directly to the
+ * `accent1`–`accent6` chart palette defaults.
+ *
+ * The deck's theme is the one its first slide master references. A
+ * package usually holds more themes than that — notes and handout
+ * masters carry their own, and Google Slides exports name the notes
+ * theme `theme1.xml` ahead of the slide theme `theme2.xml` — so the
+ * slide master relationship decides, not the part name. Multi-master
+ * decks surface the first master's theme only; per-master theme lookup
+ * will land if a concrete user need shows up.
+ */
+declare const getPresentationTheme: (pres: PresentationData) => PresentationTheme | null;
+/**
+ * The theme's font scheme, flattened to the typefaces the runs in a
+ * deck inherit by default. `major*` is the heading font (slide
+ * titles, chart titles); `minor*` is the body font.
+ *
+ * Each field carries the Latin / East-Asian / Complex-Script
+ * typeface name as written on the theme. Empty values are
+ * normalized to `null`.
+ */
+interface PresentationFonts {
+  readonly majorLatin: string | null;
+  readonly majorEastAsian: string | null;
+  readonly majorComplexScript: string | null;
+  readonly minorLatin: string | null;
+  readonly minorEastAsian: string | null;
+  readonly minorComplexScript: string | null;
+}
+/**
+ * Returns the deck theme's font scheme, or `null` when the package
+ * carries no theme. This is the presentation-level fallback; shape text
+ * resolution uses `fontsFromThemeRoot` with the shape's owning master theme.
+ */
+declare const getPresentationFonts: (pres: PresentationData) => PresentationFonts | null;
+/**
+ * Overwrites the named slots of the deck theme's color
+ * scheme (`<a:clrScheme>`), leaving every other slot untouched. Slot
+ * values are `#RRGGBB` (or 3-digit `#RGB`) strings; every branded
+ * `srgbClr`/`sysClr` slot is normalized to a plain `<a:srgbClr>` on
+ * write, since a theme slot is never a scheme-color reference.
+ *
+ * As with `getPresentationTheme`, multi-master decks are branded via
+ * their first slide master's theme only.
+ *
+ * Throws if the presentation has no theme part, or if a provided color
+ * isn't a valid `#RRGGBB` string.
+ */
+declare const setPresentationTheme: (pres: PresentationData, theme: Partial<Omit<PresentationTheme, "name">> & {
+  name?: string;
+}) => void;
+/**
+ * Typeface overrides for {@link setPresentationFonts}. Unlike
+ * `PresentationFonts` (the read side, where an empty typeface value
+ * flattens to `null`), every field here is a plain string — the
+ * underlying `<a:latin>` / `<a:ea>` / `<a:cs>` elements are mandatory on
+ * a valid theme, so there's no "clear this typeface" operation.
+ */
+interface PresentationFontsInput {
+  readonly majorLatin?: string;
+  readonly majorEastAsian?: string;
+  readonly majorComplexScript?: string;
+  readonly minorLatin?: string;
+  readonly minorEastAsian?: string;
+  readonly minorComplexScript?: string;
+}
+/**
+ * Overwrites the named typefaces of the deck theme's font scheme
+ * (major = headings, minor = body), leaving unset fields untouched. As
+ * with `setPresentationTheme`, only the first slide master's theme is
+ * branded.
+ *
+ * Throws if the presentation has no theme part.
+ */
+declare const setPresentationFonts: (pres: PresentationData, fonts: PresentationFontsInput) => void;
+//#endregion
 //#region src/api/fn/shape-gradient-read.d.ts
 /**
  * Returns the full gradient definition (`stops` + `angleDeg`) when the
@@ -1409,19 +1865,25 @@ declare const getShapeFill: (shape: SlideShapeData) => ShapeFill;
 declare const getShapeGradientFill: (shape: SlideShapeData) => ReadGradientFill | null;
 /**
  * Same as `getShapeGradientFill` but walks the layout → master
- * placeholder cascade when the shape itself carries no `<a:gradFill>`.
- * Returns the first gradient found, or `null` when neither the shape
- * nor its inherited placeholder defines one.
+ * placeholder cascade when the shape carries no explicit fill choice.
+ * Stop `resolvedColor` values include the theme, color map, and color transforms.
+ * Returns the first gradient in the placeholder cascade, or `null` when an
+ * explicit non-gradient fill masks the cascade or no layer defines one.
  *
- * Resolves only gradients authored as a literal `<a:gradFill>` on the
- * shape or its placeholder ancestors. Gradients referenced through the
- * theme style matrix (`<p:style><a:fillRef>` → `<a:fillStyleLst>`) are
- * not modelled by the core yet, so those still report `inherit` and
- * fall through here.
+ * Resolves literal gradients on the shape or its placeholder ancestors, and
+ * the shape's own theme style-matrix fill reference. Style references on
+ * placeholder ancestors are not resolved.
  */
 declare const getShapeGradientFillEffective: (pres: PresentationData, shape: SlideShapeData) => ReadGradientFill | null;
 //#endregion
 //#region src/api/fn/shape-fill-stroke.d.ts
+/**
+ * Replace the preset or custom geometry of a shape, picture, or connector.
+ * Picture geometry clips the image without modifying its bytes or crop.
+ * Existing adjust guides are removed; use `setShapeAdjustValues` afterward
+ * to customize the new preset. Position, size, fill, and effects are preserved.
+ */
+declare const setShapePreset: (shape: SlideShapeData, preset: PresetShape) => void;
 /** Sets the shape's position in EMU. Companion to `setShapeSize`. */
 declare const setShapePosition: (shape: SlideShapeData, x: Emu, y: Emu) => void;
 /** Sets the shape's size in EMU. */
@@ -1452,8 +1914,22 @@ declare const setShapeFlip: (shape: SlideShapeData, options: {
   horizontal?: boolean;
   vertical?: boolean;
 }) => void;
-/** Sets a solid fill on the shape (color in `#RRGGBB` or scheme token). */
-declare const setShapeFill: (shape: SlideShapeData, color: Color) => void;
+/**
+ * Paints a shape with the slide background at its position, covering objects
+ * behind it. This is different from a transparent fill. Only ordinary shapes
+ * support the PresentationML `useBgFill` attribute; other kinds throw.
+ */
+declare const setShapeSlideBackgroundFill: (shape: SlideShapeData) => void;
+/**
+ * Sets a solid fill. A color string replaces the fill; an options object edits
+ * only supplied properties and preserves existing opacity when changing color.
+ * Opacity ranges from 0 (transparent) to 1 (opaque). Opacity-only edits require
+ * an existing solid fill and preserve its theme reference and color transforms.
+ */
+declare const setShapeFill: (shape: SlideShapeData, color: Color | {
+  color?: Color;
+  opacity?: number;
+}) => void;
 /**
  * Sets a linear gradient fill on the shape. Stops must lie in `[0, 1]`;
  * `angleDeg` defaults to `90` (top → bottom).
@@ -1471,20 +1947,28 @@ declare const setShapeGradientFill: (shape: SlideShapeData, options: GradientFil
  *
  * `foreground` is the pattern stroke color; `background` fills behind
  * the pattern. Both accept `#RRGGBB`, bare `RRGGBB`, or scheme tokens
- * (`accent1`, `bg1`, ...).
+ * (`accent1`, `bg1`, ...). Omitted settings preserve existing pattern XML,
+ * including theme references and color transforms. A new pattern defaults to
+ * `pct5`, foreground `accent1` and background `bg1`, as in Mac PowerPoint.
  */
-declare const setShapePatternFill: (shape: SlideShapeData, options: PatternFillOptions) => void;
+declare const setShapePatternFill: (shape: SlideShapeData, options: Partial<PatternFillOptions>) => void;
 /**
  * Reads back the pattern fill on a shape: returns the preset token
  * plus the foreground / background colors resolved against the theme.
+ * With `preserveTheme`, untransformed scheme colors remain theme tokens.
+ * Transformed colors still resolve to RGB to preserve their appearance.
  * Returns `null` when the shape has no `<a:pattFill>`.
  *
- * The preset string is the literal `ST_PresetPatternVal` token from
- * §20.1.10.49 — e.g. `'pct50'`, `'dkUpDiag'`, `'cross'`, `'wave'`.
- * Renderers can map it onto an SVG `<pattern>` definition.
+ * The preset is the literal `ST_PresetPatternVal` token from §20.1.10.49 —
+ * e.g. `'pct50'`, `'dkUpDiag'`, `'cross'`, `'wave'`. Renderers can map it onto
+ * an SVG `<pattern>` definition, and the result can be handed straight back to
+ * `setShapePatternFill`. A missing or unrecognised `prst` reads as `'pct50'`,
+ * which is what PowerPoint paints when the attribute is absent.
  */
-declare const getShapePatternFill: (pres: PresentationData, shape: SlideShapeData) => {
-  preset: string;
+declare const getShapePatternFill: (pres: PresentationData, shape: SlideShapeData, options?: {
+  readonly preserveTheme?: boolean;
+}) => {
+  preset: PatternPreset;
   foreground: string;
   background: string;
 } | null;
@@ -1509,20 +1993,25 @@ declare const setShapeNoFill: (shape: SlideShapeData) => void;
  * from the layout / master placeholder it descends from.
  */
 declare const clearShapeFill: (shape: SlideShapeData) => void;
-/** Sets a solid-color outline on the shape. */
+/** Updates outline color, width and/or opacity (0–1); omitted properties are preserved. */
 declare const setShapeStroke: (shape: SlideShapeData, options: {
   color?: Color;
   widthEmu?: number;
+  opacity?: number;
 }) => void;
 /** Sets an explicit "no outline" on the shape. */
 declare const setShapeNoStroke: (shape: SlideShapeData) => void;
-/** Reads back the shape's stroke dash style, or `null` if none. */
-declare const getShapeStrokeDash: (shape: SlideShapeData) => LineDash | null;
+/**
+ * Reads back the shape's stroke dash style, or `null` if none. When `pres` is
+ * supplied, a direct partial line is overlaid on the shape's `lnRef` style.
+ */
+declare const getShapeStrokeDash: (shape: SlideShapeData, pres?: PresentationData) => LineDash | null;
 /**
  * Reads back the shape's arrowhead on one end of `<a:ln>`, or `null`
- * when no `<a:headEnd>` / `<a:tailEnd>` is present.
+ * when no `<a:headEnd>` / `<a:tailEnd>` is present. When `pres` is supplied,
+ * a direct partial line is overlaid on the shape's `lnRef` style.
  */
-declare const getShapeStrokeArrow: (shape: SlideShapeData, end: "head" | "tail") => ArrowOptions | null;
+declare const getShapeStrokeArrow: (shape: SlideShapeData, end: "head" | "tail", pres?: PresentationData) => ArrowOptions | null;
 /**
  * Sets the dash pattern for the shape's outline (`<a:prstDash>`). One
  * of ECMA-376's `ST_PresetLineDashVal` tokens:
@@ -1609,6 +2098,8 @@ type ShapeEffect = {
  */
 type ShapeEffectAny = {
   readonly kind: 'outerShdw';
+  readonly alignment?: ShadowOptions['alignment'];
+  readonly rotateWithShape?: boolean;
   readonly color: string;
   readonly opacity?: number;
   readonly blurEmu: number;
@@ -1630,7 +2121,15 @@ type ShapeEffectAny = {
   readonly kind: 'reflection';
   readonly opacity?: number;
   readonly startOpacity?: number;
+  readonly startPosition?: number;
+  readonly endPosition?: number;
+  readonly fadeDirection?: number;
+  readonly scaleX?: number;
+  readonly alignment?: 'tl' | 't' | 'tr' | 'l' | 'ctr' | 'r' | 'bl' | 'b' | 'br';
+  readonly rotateWithShape?: boolean;
   readonly scaleY?: number;
+  readonly skewX?: number;
+  readonly skewY?: number;
   readonly blurEmu: number;
   readonly distEmu: number;
   readonly angleDeg: number;
@@ -1642,6 +2141,15 @@ type ShapeEffectAny = {
   readonly radiusEmu: number;
 };
 declare const getShapeEffect: (shape: SlideShapeData) => ShapeEffect | null;
+/**
+ * Returns every effect attached to the shape's `<a:effectLst>` in
+ * document order — outer shadow, inner shadow, glow, reflection,
+ * soft edge, blur. Empty array when no effects apply.
+ *
+ * Companion to `getShapeEffect`, which is the v1 "first effect only"
+ * helper. `getShapeEffects` is what renderers want because PowerPoint
+ * composes multiple effects in a single filter (shadow + glow, etc.).
+ */
 declare const getShapeEffects: (pres: PresentationData, shape: SlideShapeData) => readonly ShapeEffectAny[];
 /**
  * Every shape on the slide whose `<a:effectLst>` carries an effect
@@ -1663,27 +2171,67 @@ declare const getShapeEffectsEffective: (pres: PresentationData, shape: SlideSha
 /**
  * Sets an outer drop shadow on the shape. Defaults: black, 4pt blur,
  * 3pt offset, 45° (down-right). Pass `opacity` (0–1) to soften the
- * shadow.
+ * shadow. Replaces an existing drop shadow and leaves the shape's other
+ * effects in place; `clearShapeEffects` is the way to remove them all.
  */
 declare const setShapeShadow: (shape: SlideShapeData, options?: ShadowOptions) => void;
 /**
  * Sets a glow around the shape. The radius is in EMU (default 5pt =
- * 63500). Mutually exclusive with `setShapeShadow` in v1 — calling
- * either replaces the prior `<a:effectLst>` entirely.
+ * 63500). Replaces an existing glow and composes with a shadow, in the
+ * order `CT_EffectList` states.
  */
 declare const setShapeGlow: (shape: SlideShapeData, options: GlowOptions) => void;
 /** Removes any effects (shadow / glow / future presets) from the shape. */
 declare const clearShapeEffects: (shape: SlideShapeData) => void;
 //#endregion
+//#region src/internal/drawingml/text-body-edit.d.ts
+type TextCase = 'sentence' | 'lower' | 'upper' | 'title' | 'toggle';
+//#endregion
 //#region src/api/fn/shape-text.d.ts
 /**
  * Replaces the shape's visible text with `value`. Newlines start a new
- * paragraph. Existing run/paragraph properties are preserved so font,
- * color, size, alignment, and bullet style stay intact. The paragraph-end
- * format (`<a:endParaRPr>`) is not kept; author it with `setShapeParagraphs`.
- */
-declare const setShapeText: (shape: SlideShapeData, value: string, options?: {
+ * paragraph by default; `newlines: 'break'` inserts paragraph-internal `<a:br>` instead.
+ * By default, new paragraphs inherit the first existing run and
+ * paragraph properties (font, color, size, alignment and bullets). The paragraph-end
+ * format (`<a:endParaRPr>`) is not kept by default; author it with `setShapeParagraphs`.
+ * Set `preserveFormatting` for incremental editing: unchanged prefix/suffix runs
+ * and paragraphs retain their XML; inserted text inherits the insertion point's
+ * format. Multiple disjoint changes should be applied separately to retain the
+ * formatting between them. With `range`, `value` replaces exactly that UTF-16
+ * selection and unaffected formatting is always preserved.
+ * Pass `{ case: 'upper' | 'lower' | 'sentence' | 'title' | 'toggle' }` to apply
+ * PowerPoint-style Change Case to the whole text or to `options.range`.
+ */
+declare const setShapeText: (shape: SlideShapeData, value: string | {
+  case: TextCase;
+}, options?: {
+  newlines?: "paragraph" | "break";
   bullets?: BulletStyle;
+  preserveFormatting?: boolean;
+  range?: {
+    start: number;
+    end: number;
+  };
+}) => void;
+/**
+ * Replaces the shape's text with a single field — text PowerPoint fills in
+ * when it opens the deck, rather than text the file states. `type` is an
+ * ECMA-376 `ST_TextFieldType` token: `'slidenum'` for the slide's number,
+ * `'datetime'` (and its `datetime1`…`datetime13` variants) for the current
+ * date, `'footer'`, `'headerfooter'`, … Unrecognised tokens are written
+ * through, since the list is open and renderers differ on what they honour.
+ *
+ * `options.text` is the cached value stored in `<a:t>`, which is what a reader
+ * that does not evaluate fields shows — PowerPoint overwrites it on open, so
+ * it matters only for other consumers. The shape's first run's formatting is
+ * carried onto the field, the way PowerPoint keeps a placeholder's look when
+ * it inserts one.
+ *
+ * This replaces the whole text body: a field placeholder holds the field and
+ * nothing else, which is how PowerPoint writes slide numbers and dates.
+ */
+declare const setShapeTextField: (shape: SlideShapeData, type: string, options?: {
+  text?: string;
 }) => void;
 /**
  * Appends `value` to the shape's existing text on a new line. The
@@ -1736,6 +2284,23 @@ declare const getShapeTextWrap: (shape: SlideShapeData) => TextWrap | null;
  * non-text-bearing shape kinds.
  */
 declare const setShapeTextAutoFit: (shape: SlideShapeData, mode: TextAutoFit) => void;
+/**
+ * Sets the 3-D on the shape's text body — `<a:scene3d>` and `<a:sp3d>` in
+ * `<a:bodyPr>`, where PowerPoint writes its WordArt bevels. `value.scene`
+ * writes the camera and light rig; `bevelTop`, `extrusionHeightEmu`,
+ * `material` and `contourColor` write `<a:sp3d>` (replacing `<a:flatTx>`).
+ * A field left out removes what it describes; settings this API does not
+ * model (camera field of view, bottom bevel, extrusion color, ...) are kept
+ * while their element remains. `null` removes both elements. Throws for
+ * non-text-bearing shape kinds.
+ */
+declare const setShapeText3D: (shape: SlideShapeData, value: Text3D | null) => void;
+/**
+ * Reads the 3-D on the shape's own text body (see `setShapeText3D`), or
+ * `null` when its `<a:bodyPr>` has neither `<a:scene3d>` nor `<a:sp3d>`.
+ * Inherited body properties are not consulted.
+ */
+declare const getShapeText3D: (shape: SlideShapeData) => ReadText3D | null;
 /**
  * Reads back the bodyPr auto-fit child, or `null` when none is
  * present (PowerPoint applies a layout-inherited default in that case).
@@ -1786,9 +2351,9 @@ declare const getShapeTextColumns: (shape: SlideShapeData) => {
 /**
  * Sets the multi-column layout on the shape's text body — writes
  * `<a:bodyPr numCol="N" [spcCol="EMU"]/>`. Pass `null` to clear both
- * attributes so the text body falls back to PowerPoint's default
- * single column. `count` must be in `2..16` (ST_TextColumnCount caps at
- * 16, and single column is the `null` default). `gapEmu`, when omitted,
+ * attributes so the text body inherits its column settings (one column
+ * when no layout/master supplies them). `count` must be in `1..16`;
+ * use `1` to override inherited columns explicitly. `gapEmu`, when omitted,
  * removes any prior `spcCol`. Throws for non-text-bearing shape kinds.
  */
 declare const setShapeTextColumns: (shape: SlideShapeData, columns: {
@@ -1823,7 +2388,7 @@ declare const setShapeTextBodyRotationDeg: (shape: SlideShapeData, rotationDeg:
  *
  *   - `horz` — default left-to-right, top-to-bottom (returns `null`).
  *   - `vert` — 90° rotation, lines run top-to-bottom, columns right-to-left.
- *   - `vert270` — 270° rotation, lines top-to-bottom, columns left-to-right.
+ *   - `vert270` — 270° rotation, lines bottom-to-top, columns left-to-right.
  *   - `wordArtVert` — characters not rotated, stacked vertically.
  *   - `eaVert` — East-Asian vertical: characters upright, columns right-to-left.
  *   - `mongolianVert` — Mongolian: rotated 90°, columns left-to-right.
@@ -1836,8 +2401,8 @@ declare const getShapeTextDirection: (shape: SlideShapeData) => "vert" | "vert27
 /**
  * Sets the shape's text-direction via `<a:bodyPr vert="…"/>`. See
  * `getShapeTextDirection` for the meaning of each value. Passing `null`
- * (or `'horz'`) clears the attribute so the shape uses the default
- * horizontal direction. Throws for non-text-bearing shape kinds.
+ * clears the attribute, restoring layout/master inheritance. `'horz'` writes
+ * an explicit horizontal override. Throws for non-text-bearing shape kinds.
  */
 declare const setShapeTextDirection: (shape: SlideShapeData, direction: "horz" | "vert" | "vert270" | "wordArtVert" | "eaVert" | "mongolianVert" | "wordArtVertRtl" | null) => void;
 declare const getShapeTextMargins: (shape: SlideShapeData) => {
@@ -1848,7 +2413,7 @@ declare const getShapeTextMargins: (shape: SlideShapeData) => {
 } | null;
 /**
  * Resolves the effective `<a:bodyPr>` properties — anchor, wrap, vertical
- * direction, and inset margins — by walking the layout / master cascade
+ * direction, inset margins, columns and autofit — by walking the layout / master cascade
  * the same way `getShapeRunFormatEffective` walks rPr. Returns the
  * innermost value that the cascade supplies, or `null` for properties
  * neither the shape nor any inherited placeholder authors.
@@ -1859,6 +2424,10 @@ declare const getShapeTextMargins: (shape: SlideShapeData) => {
  */
 declare const getShapeBodyPrEffective: (pres: PresentationData, shape: SlideShapeData) => {
   anchor: TextAnchor | null;
+  anchorCentered: boolean | null;
+  autoFit: TextAutoFit | null;
+  autoFitParams: ReturnType<typeof getShapeTextAutoFitParams>;
+  columns: ReturnType<typeof getShapeTextColumns>;
   wrap: TextWrap | null;
   vert: ReturnType<typeof getShapeTextDirection>;
   margins: {
@@ -1868,41 +2437,244 @@ declare const getShapeBodyPrEffective: (pres: PresentationData, shape: SlideShap
     bottom: number | null;
   };
 };
-declare const setShapeTextAnchor: (shape: SlideShapeData, anchor: TextAnchor) => void;
 /**
- * Sets the internal margins of the shape's text frame in EMU. Each
- * side is independent; omitted sides keep their current value (or the
- * layout-inherited default when the attribute is absent).
+ * Sets vertical anchoring. `centered` centers the text block without changing
+ * paragraph alignment (PowerPoint's Top / Middle / Bottom Centered options).
+ * Omit it to preserve centering; pass null to restore inherited centering.
+ */
+declare const setShapeTextAnchor: (shape: SlideShapeData, anchor: TextAnchor, options?: {
+  centered?: boolean | null;
+}) => void;
+/**
+ * Sets the internal margins of the shape's text frame in EMU. Each
+ * side is independent; omitted sides keep their current value (or the
+ * layout-inherited default when the attribute is absent).
+ *
+ * PowerPoint's defaults for a textbox: left/right 91440 (0.1in),
+ * top/bottom 45720 (0.05in).
+ *
+ *   setShapeTextMargins(shape, { left: 0, right: 0 }); // flush-left text
+ */
+declare const setShapeTextMargins: (shape: SlideShapeData, margins: {
+  left?: number;
+  top?: number;
+  right?: number;
+  bottom?: number;
+}) => void;
+/** Sets the bullet style on every paragraph in the shape's text body. */
+declare const setShapeBulletStyle: (shape: SlideShapeData, style: BulletStyle) => void;
+/** Sets the horizontal alignment of every paragraph in the shape's text. */
+declare const setShapeAlignment: (shape: SlideShapeData, align: ParagraphAlignment) => void;
+/**
+ * Applies `format` to every run in the shape's text. Run-property
+ * attributes not addressed by `format` are preserved, so partial
+ * updates compose. Optional `range` selects UTF-16 offsets in `getShapeText`,
+ * with an exclusive end. Paragraph separators and line breaks each count as one
+ * character. Empty ranges do nothing; invalid or split-surrogate boundaries throw.
+ * Partially selected fields become literal runs; fully selected fields stay fields.
+ * Pass a zero-based `paragraphEnd` instead of `range` to update a paragraph's end mark
+ * without rebuilding its runs or paragraph properties.
+ * With `reset`, clears direct visual run properties before applying `format`,
+ * restoring inherited fonts and appearance while keeping links and language.
+ * Without either target, also clears text-body and paragraph run-format defaults.
+ * Blank autoshapes receive a text body and paragraph-end formatting for future input.
+ */
+declare const setShapeTextFormat: (shape: SlideShapeData, format: TextFormat, options?: {
+  range?: {
+    start: number;
+    end: number;
+  };
+  reset?: boolean;
+  paragraphEnd?: never;
+} | {
+  paragraphEnd: number;
+  reset?: boolean;
+  range?: never;
+}) => void;
+/**
+ * Replaces the shape's text with explicitly structured paragraphs, each
+ * carrying its own runs and per-run formats. `setShapeText` yields one run
+ * per paragraph; use this when a paragraph mixes formats (a bold lead-in
+ * followed by plain text, for example). Read back with
+ * `getShapeParagraphElements`.
+ * Pass `{ source, range? }` to copy existing paragraph XML, including fields,
+ * run formatting, bullets and remapped relationships. The optional range uses
+ * UTF-16 offsets with an exclusive end; omitted range copies all source text.
+ * Pass an array of targets and `{ source, ranges }` to distribute ranges in one
+ * batch. All ranges are read before any target changes, including when the source
+ * is a target. Each target must have a corresponding range.
+ * Pass `{ sources }` to concatenate complete paragraph sequences in order,
+ * preserving fields, paragraph properties and relationships across slides.
+ * A single target with `{ source, ranges }` concatenates those ranges in order.
+ * Target body properties and list styles remain unchanged.
+ */
+declare function setShapeParagraphs(shape: SlideShapeData, paragraphs: ReadonlyArray<ParagraphSpec> | {
+  source: SlideShapeData;
+  range?: {
+    start: number;
+    end: number;
+  };
+} | {
+  sources: ReadonlyArray<SlideShapeData>;
+} | {
+  source: SlideShapeData;
+  ranges: ReadonlyArray<{
+    start: number;
+    end: number;
+  }>;
+}): void;
+declare function setShapeParagraphs(shapes: ReadonlyArray<SlideShapeData>, paragraphs: {
+  source: SlideShapeData;
+  ranges: ReadonlyArray<{
+    start: number;
+    end: number;
+  }>;
+}): void;
+//#endregion
+//#region src/api/fn/shape-paragraph.d.ts
+/**
+ * Resolves a run's effective character properties by walking the
+ * ECMA-376 §21.1.2.4.7 inheritance chain — run rPr →
+ * pPr defRPr → text-body lstStyle → shape Quick Style → layout placeholder
+ * lstStyle → master placeholder lstStyle + master txStyles → owning theme
+ * fontScheme.
+ *
+ * Each property (font, size, color, bold, italic, underline) is
+ * resolved independently: the innermost layer that supplies a value
+ * wins for that one property.
+ *
+ * Returns a non-null `TextFormat`; fields the cascade couldn't
+ * resolve are simply absent (the renderer falls back to placeholder
+ * defaults).
+ *
+ * Use `getShapeRunFormat` if you only want the literal `<a:rPr>` on
+ * the run without inheritance. Numeric indices count only regular runs;
+ * `{ fieldIndex }` and `{ breakIndex }` count fields and line breaks separately;
+ * null resolves the paragraph end mark.
+ * `inheritanceSource` supplies the original
+ * placeholder and slide context when reading a detached editing preview;
+ * paragraph and run properties are still read from `shape`.
+ */
+declare const getShapeRunFormatEffective: (pres: PresentationData, shape: SlideShapeData, paragraphIndex: number, runIndex: number | null | {
+  readonly fieldIndex: number;
+} | {
+  readonly breakIndex: number;
+}, options?: {
+  inheritanceSource?: SlideShapeData;
+}) => ReadTextFormat;
+/** A custom paragraph tab stop. */
+interface ParagraphTabStop {
+  /** Position relative to the left margin, in EMU. */
+  positionEmu: number;
+  alignment: 'left' | 'center' | 'right' | 'decimal';
+}
+/** Effective bullet detail returned by `getParagraphPropertiesEffective`. */
+interface ParagraphBulletDetail {
+  color: string | null;
+  colorFollowText: boolean;
+  sizePct: number | null;
+  sizePts: number | null;
+  sizeFollowText: boolean;
+  font: string | null;
+  fontFollowText: boolean;
+}
+/** Effective paragraph properties returned by `getParagraphPropertiesEffective`. */
+interface ParagraphProperties {
+  /** Custom tab stops; an empty list explicitly clears inherited stops. */
+  tabStops?: ParagraphTabStop[];
+  /** Distance between automatic tab stops, in EMU. */
+  defaultTabSizeEmu?: number;
+  /** Horizontal alignment per `ParagraphAlignment`. */
+  align: ParagraphAlignment | null;
+  /** East Asian line-breaking rules; absent when not authored or inherited. */
+  asianLineBreak?: boolean;
+  /** Allow a Latin word to break across lines. */
+  latinLineBreak?: boolean;
+  /** Allow punctuation to extend beyond the text margin. */
+  hangingPunctuation?: boolean;
+  /** Vertical alignment of differently sized characters within a line. */
+  fontAlignment?: 'auto' | 'top' | 'center' | 'baseline' | 'bottom';
+  /** Outline level (0..8). 0 = top-level paragraph. */
+  level: number;
+  /** Left indent in EMU. */
+  marL: number | null;
+  /** Right indent in EMU. */
+  marR: number | null;
+  /** First-line indent in EMU; negative for hanging indents. */
+  indent: number | null;
+  /** Line spacing — either a percent multiplier or a fixed point value. */
+  lineSpacing: {
+    readonly kind: 'pct';
+    readonly value: number;
+  } | {
+    readonly kind: 'pts';
+    readonly value: number;
+  } | null;
+  /** Space before the paragraph in points. */
+  spcBefPts: number | null;
+  /** Space after the paragraph in points. */
+  spcAftPts: number | null;
+  /** Right-to-left paragraph (`<a:pPr rtl="1"/>`). */
+  rtl: boolean | null;
+  /**
+   * Bullet resolved through the cascade (`<a:buChar>` / `<a:buAutoNum>` /
+   * `<a:buNone>`). Master `bodyStyle` levels author the PowerPoint default
+   * "•", so body placeholders get their bullet from here even when no
+   * slide-level `<a:pPr>` carries one.
+   */
+  bullet: BulletStyle | null;
+  /** Bullet color, size, and font after paragraph/layout/master inheritance. */
+  bulletDetail?: ParagraphBulletDetail;
+}
+/**
+ * Resolves a paragraph's effective properties by walking the same
+ * inheritance chain `getShapeRunFormatEffective` uses, but for the
+ * paragraph-level surface:
+ *
+ *   - alignment, indent (left / right / first-line), line spacing,
+ *     paragraph spacing (before / after), rtl.
+ *
+ * Each property is resolved independently; the innermost layer that
+ * sets it wins. Fields the cascade can't resolve come through as `null`
+ * so renderers know to fall back to their own defaults.
+ *
+ * Companion to `getParagraphAlignment` / `getParagraphLineSpacing` /
+ * `getParagraphIndent` / `getParagraphSpacing`, which only surface the
+ * literal `<a:pPr>` and skip the layout / master cascade.
+ * `inheritanceSource` preserves the original placeholder and slide context
+ * when resolving a detached shape preview. Table cells use their own text body.
+ */
+declare const getParagraphPropertiesEffective: (pres: PresentationData, shape: SlideShapeData | TableCellData, paragraphIndex: number, options?: {
+  inheritanceSource?: SlideShapeData;
+}) => ParagraphProperties;
+/**
+ * Applies `format` to a single run. Run-property attributes not
+ * addressed by `format` are preserved — partial updates compose.
  *
- * PowerPoint's defaults for a textbox: left/right 91440 (0.1in),
- * top/bottom 45720 (0.05in).
+ * Example: bold the second word of the first paragraph:
  *
- *   setShapeTextMargins(shape, { left: 0, right: 0 }); // flush-left text
+ *   setShapeRunFormat(shape, 0, 1, { bold: true, color: '#FF0000' });
  */
-declare const setShapeTextMargins: (shape: SlideShapeData, margins: {
-  left?: number;
-  top?: number;
-  right?: number;
-  bottom?: number;
-}) => void;
-/** Sets the bullet style on every paragraph in the shape's text body. */
-declare const setShapeBulletStyle: (shape: SlideShapeData, style: BulletStyle) => void;
-/** Sets the horizontal alignment of every paragraph in the shape's text. */
-declare const setShapeAlignment: (shape: SlideShapeData, align: ParagraphAlignment) => void;
+declare const setShapeRunFormat: (shape: SlideShapeData, paragraphIndex: number, runIndex: number, format: TextFormat) => void;
 /**
- * Applies `format` to every run in the shape's text. Run-property
- * attributes not addressed by `format` are preserved, so partial
- * updates compose.
+ * Reads the external URL the first run in the shape's text-body links
+ * to (set via `setShapeHyperlink`). Returns `null` when no run carries
+ * an `<a:hlinkClick r:id=…/>` or the rId resolves to a non-hyperlink
+ * target.
  */
-declare const setShapeTextFormat: (shape: SlideShapeData, format: TextFormat) => void;
+declare const getShapeHyperlink: (shape: SlideShapeData) => string | null;
 /**
- * Replaces the shape's text with explicitly structured paragraphs, each
- * carrying its own runs and per-run formats. `setShapeText` yields one run
- * per paragraph; use this when a paragraph mixes formats (a bold lead-in
- * followed by plain text, for example). Read back with
- * `getShapeParagraphElements`.
+ * Sets an external hyperlink on every run in the shape's text. Allocates
+ * (or reuses) a `hyperlink` relationship on the slide's `.rels`. Pass
+ * `null` to clear. Optional `range` limits the change to UTF-16 offsets in
+ * getShapeText, preserving text and formatting outside the selection.
  */
-declare const setShapeParagraphs: (shape: SlideShapeData, paragraphs: ReadonlyArray<ParagraphSpec>) => void;
+declare const setShapeHyperlink: (shape: SlideShapeData, url: string | null, tooltip?: string, options?: {
+  range?: {
+    start: number;
+    end: number;
+  };
+}) => void;
 //#endregion
 //#region src/api/fn/comments.d.ts
 /**
@@ -1990,22 +2762,13 @@ declare const getCommentsSortedByDate: (pres: PresentationData) => ReadonlyArray
 declare const getSlideCommentAuthors: (slide: SlideData) => ReadonlyArray<CommentAuthor>;
 /**
  * Returns every comment attached to the slide, with the author already
- * resolved. The list is read-only — use `addSlideComment` /
+ * resolved. Both formats are read: the ECMA-376 `<p:cm>` list first, then
+ * the modern threads. The list is read-only — use `addSlideComment` /
  * `removeSlideComment` to mutate.
  */
 declare const getSlideComments: (slide: SlideData) => ReadonlyArray<SlideCommentData>;
-/**
- * Adds a comment to the slide. Returns the new comment handle.
- *
- * Author handling: if an author with the given `name`+`initials` already
- * exists in `commentAuthors.xml`, the existing record is reused (and its
- * `lastIdx` is bumped). Otherwise a new author is allocated. `initials`
- * defaults to the first character of `name`.
- *
- * `position` is in EMU; pass `null` to omit the `<p:pos>` element.
- * `date` defaults to the current time.
- */
-declare const addSlideComment: (slide: SlideData, opts: {
+/** Options shared by both comment formats. */
+interface AddCommentOptions {
   author: {
     name: string;
     initials?: string;
@@ -2013,9 +2776,35 @@ declare const addSlideComment: (slide: SlideData, opts: {
   text: string;
   position?: CommentPosition | null;
   date?: Date;
-}) => SlideCommentData;
+  /** Existing comment on this slide to reply to. */
+  replyTo?: SlideCommentData;
+}
+/**
+ * Adds a comment to the slide. Returns the new comment handle.
+ *
+ * Which format it is written in follows the file rather than the caller: a
+ * reply joins its own thread, and a new thread goes where the slide — or,
+ * failing that, the deck — already keeps its comments. Only a deck with no
+ * comments at all starts an ECMA-376 `<p:cm>` list, which everything can
+ * read.
+ *
+ * Author handling: if an author with the given `name`+`initials` already
+ * exists in the relevant author list, the existing record is reused (and, in
+ * the legacy list, its `lastIdx` is bumped). Otherwise a new author is
+ * allocated. `initials` defaults to the first character of `name`.
+ *
+ * `position` is the comment pin, in EMU. The legacy schema makes `<p:pos>`
+ * mandatory, so a legacy comment added without one is pinned to the slide's
+ * origin rather than written without the element; the modern schema makes it
+ * optional, so a modern comment added without one has no pin.
+ *
+ * `date` defaults to the current time.
+ */
+declare const addSlideComment: (slide: SlideData, opts: AddCommentOptions) => SlideCommentData;
+/** Updates comment text while retaining author, date, position, and extension XML. */
+declare const setCommentText: (comment: SlideCommentData, text: string) => void;
 /**
- * Removes the comment from its slide's comments part. If the comment
+ * Removes the comment and all its replies from its slide's comments part. If the comment
  * was the last one on the slide, the comments part and the
  * slide → comments rel are also removed. The author entry in
  * `commentAuthors.xml` is left intact (an author may have comments on
@@ -2025,7 +2814,7 @@ declare const removeSlideComment: (comment: SlideCommentData) => void;
 /**
  * Strips every comment from every slide in the deck. Returns the
  * number of comments removed. Built on `writeCommentsForSlide`,
- * so each slide's modern comment part is rewritten with an empty
+ * so each slide's legacy comment part is rewritten with an empty
  * list. The `commentAuthors.xml` registry is left intact for any
  * caller that still needs author identity.
  *
@@ -2049,6 +2838,30 @@ declare const getCommentPosition: (comment: SlideCommentData) => CommentPosition
  * slide each hit came from.
  */
 declare const getCommentSlide: (comment: SlideCommentData) => SlideData;
+/** Parent handle from the same read, or null for roots and missing parents. */
+declare const getCommentParent: (comment: SlideCommentData) => SlideCommentData | null;
+/**
+ * Which of the two comment formats this handle came from. `'legacy'` is the
+ * ECMA-376 `<p:cm>` list every reader understands; `'modern'` is the
+ * `<p188:cm>` thread PowerPoint 2021 and Microsoft 365 write.
+ */
+declare const getCommentFormat: (comment: SlideCommentData) => "legacy" | "modern";
+/**
+ * Whether the thread has been resolved. `null` where the question does not
+ * apply or cannot be answered: a legacy comment, which has nowhere to record
+ * it, or a modern one whose file states a status this schema version does not
+ * define.
+ */
+declare const getCommentStatus: (comment: SlideCommentData) => CommentStatus | null;
+/**
+ * Resolves a thread, reopens it (`'active'`), or closes it. Replies carry a
+ * status of their own, so this works on any modern comment.
+ *
+ * Throws for a legacy comment: the ECMA-376 schema has no place to put it,
+ * and quietly doing nothing would leave the caller believing a thread had
+ * been resolved.
+ */
+declare const setCommentStatus: (comment: SlideCommentData, status: CommentStatus) => void;
 //#endregion
 //#region src/api/fn/shape-image.d.ts
 /**
@@ -2061,9 +2874,9 @@ declare const getCommentSlide: (comment: SlideCommentData) => SlideData;
  */
 type ImageFit = 'fill' | 'contain';
 /**
- * Replaces a picture's media with `bytes`. Same-format replacements
- * write in place; cross-format replacements allocate a new media part
- * and repoint the rel. The geometry — crop, transform — is preserved.
+ * Replaces only this picture's media with `bytes`, detaching shared media
+ * or relationships when necessary. Unshared same-format media is updated
+ * in place. The geometry — crop, transform — is preserved.
  *
  * Pass `options.fit: 'contain'` to re-fit the picture's extent to the
  * replacement image's aspect ratio, inscribed and centered in the shape's
@@ -2092,6 +2905,14 @@ type ShapeClickAction = {
   readonly kind: 'firstSlide';
 } | {
   readonly kind: 'lastSlide';
+} | {
+  readonly kind: 'lastSlideViewed';
+} | {
+  readonly kind: 'endShow';
+} | {
+  readonly kind: 'customShow';
+  readonly id: number;
+  readonly returnToShow: boolean;
 };
 /**
  * Reads the click action attached to the shape's cNvPr, or `null` if
@@ -2101,6 +2922,7 @@ type ShapeClickAction = {
  *   - `{ kind: 'slide', slide }` — `slide` rel + `ppaction://hlinksldjump`
  *   - `{ kind: 'nextSlide' | 'prevSlide' | 'firstSlide' | 'lastSlide' }`
  *     — preset show-navigation `ppaction`.
+ *   - `{ kind: 'customShow', id, returnToShow }` — a named custom show.
  *
  * For `kind: 'slide'`, the matching slide is resolved by part name.
  * Returns `null` for unknown `ppaction` strings.
@@ -2115,14 +2937,24 @@ declare const getShapeClickAction: (shape: SlideShapeData) => ShapeClickAction |
  *   - For `kind: 'slide'`, a `slide` rel is added pointing at the
  *     target slide's part. The `<a:hlinkClick>` carries
  *     `action="ppaction://hlinksldjump"`.
- *   - For the preset navigations (`nextSlide`, `prevSlide`, ...), no rel
- *     is allocated; just the `action` attribute carries the preset.
+ *   - For preset navigations and `customShow`, no rel is allocated; just the
+ *     `action` attribute carries the destination.
  *   - `null` removes any existing `<a:hlinkClick>`.
  *
+ * Optional `range` applies the action to selected UTF-16 text offsets instead
+ * of the whole shape, preserving links and formatting outside the range.
+ * Optional `tooltip` sets the link description; omission clears an old description.
+ *
  * The shape must be one of `shape | picture | connector | graphicFrame`.
  * Groups don't carry their own click action in our model.
  */
-declare const setShapeClickAction: (shape: SlideShapeData, action: ShapeClickAction | null) => void;
+declare const setShapeClickAction: (shape: SlideShapeData, action: ShapeClickAction | null, options?: {
+  range?: {
+    start: number;
+    end: number;
+  };
+  tooltip?: string;
+}) => void;
 //#endregion
 //#region src/internal/chartml/types.d.ts
 /**
@@ -2673,8 +3505,13 @@ interface ChartSecondaryValueAxis {
   readonly tickLabelPos?: 'none' | 'low' | 'high' | 'nextTo';
   readonly crossBetween?: 'between' | 'midCat';
 }
-/** Full chart specification. */
-interface ChartSpec {
+/**
+ * Every field a chart can carry, with no cross-field rules applied — the
+ * shape `readChartSpec` returns. A deck authored elsewhere can combine
+ * fields that this library would never write together, so the read type
+ * stays permissive; `ChartSpec` is the closed, write-side domain.
+ */
+interface ReadChartSpec {
   readonly kind: ChartKind;
   /** Category labels along the x-axis (or pie slice labels for `kind: 'pie'`). */
   readonly categories: ReadonlyArray<string>;
@@ -3143,6 +3980,182 @@ interface ChartSpec {
   readonly categoryAxisLineHidden?: boolean;
 }
 //#endregion
+//#region src/internal/chartml/chart-spec.d.ts
+/** Field of a chart whose availability depends on the kind. */
+type SpecField = Exclude<keyof ReadChartSpec, 'kind' | 'series'>;
+/**
+ * A kind's field set: `K` as declared on `ReadChartSpec`, and every other
+ * field closed off. The `?: never` arms are what turn a field the kind
+ * cannot draw into a compile error.
+ */
+type Fields<K extends SpecField> = Pick<ReadChartSpec, K> & { readonly [P in Exclude<SpecField, K>]?: never };
+/** Per-variant field sets; the variant types below are derived from these. */
+declare const VARIANT_FIELDS: {
+  readonly combo: readonly ["categories", "title", "titleStyle", "titleOverlay", "titleLayout", "dataLabels", "legend", "plotAreaLayout", "plotAreaFill", "plotAreaStrokeColor", "chartAreaFill", "chartAreaStrokeColor", "plotVisibleCellsOnly", "dispBlanksAs", "date1904", "language", "roundedCorners", "chartStyle", "varyColors", "valueAxis", "valueAxisTitle", "valueAxisTitleStyle", "valueAxisTitleRotationDeg", "valueAxisLabelStyle", "valueAxisLabelRotationDeg", "valueAxisHidden", "valueAxisMajorGridlines", "valueAxisMinorGridlines", "valueAxisMajorGridlineColor", "valueAxisMinorGridlineColor", "valueAxisMajorGridlineWidthEmu", "valueAxisMinorGridlineWidthEmu", "valueAxisMajorTickMark", "valueAxisMinorTickMark", "valueAxisTickLabelPos", "valueAxisLineColor", "valueAxisLineWidthEmu", "valueAxisLineHidden", "valueAxisOrientation", "valueAxisCrosses", "valueAxisCrossBetween", "categoryAxisTitle", "categoryAxisTitleStyle", "categoryAxisTitleRotationDeg", "categoryAxisLabelStyle", "categoryAxisLabelRotationDeg", "categoryAxisHidden", "categoryAxisMajorGridlines", "categoryAxisMinorGridlines", "categoryAxisMajorGridlineColor", "categoryAxisMinorGridlineColor", "categoryAxisMajorGridlineWidthEmu", "categoryAxisMinorGridlineWidthEmu", "categoryAxisMajorTickMark", "categoryAxisMinorTickMark", "categoryAxisTickLabelPos", "categoryAxisLineColor", "categoryAxisLineWidthEmu", "categoryAxisLineHidden", "categoryAxisOrientation", "categoryAxisNumberFormat", "categoryAxisTickLabelSkip", "categoryAxisTickMarkSkip", "categoryAxisLabelOffset", "categoryAxisLabelAlign", "categoryAxisNoMultiLevelLabel", "categoryAxisDate", "categoryAxisScaling", "categoryGroupLevels", "dataTable", "grouping", "gapWidthPct", "overlapPct", "dropLines", "hiLowLines", "lineMarkers", "upDownBars", "secondaryValueAxis"];
+  readonly bar3D: readonly ["categories", "title", "titleStyle", "titleOverlay", "titleLayout", "dataLabels", "legend", "plotAreaLayout", "plotAreaFill", "plotAreaStrokeColor", "chartAreaFill", "chartAreaStrokeColor", "plotVisibleCellsOnly", "dispBlanksAs", "date1904", "language", "roundedCorners", "chartStyle", "varyColors", "valueAxis", "valueAxisTitle", "valueAxisTitleStyle", "valueAxisTitleRotationDeg", "valueAxisLabelStyle", "valueAxisLabelRotationDeg", "valueAxisHidden", "valueAxisMajorGridlines", "valueAxisMinorGridlines", "valueAxisMajorGridlineColor", "valueAxisMinorGridlineColor", "valueAxisMajorGridlineWidthEmu", "valueAxisMinorGridlineWidthEmu", "valueAxisMajorTickMark", "valueAxisMinorTickMark", "valueAxisTickLabelPos", "valueAxisLineColor", "valueAxisLineWidthEmu", "valueAxisLineHidden", "valueAxisOrientation", "valueAxisCrosses", "valueAxisCrossBetween", "categoryAxisTitle", "categoryAxisTitleStyle", "categoryAxisTitleRotationDeg", "categoryAxisLabelStyle", "categoryAxisLabelRotationDeg", "categoryAxisHidden", "categoryAxisMajorGridlines", "categoryAxisMinorGridlines", "categoryAxisMajorGridlineColor", "categoryAxisMinorGridlineColor", "categoryAxisMajorGridlineWidthEmu", "categoryAxisMinorGridlineWidthEmu", "categoryAxisMajorTickMark", "categoryAxisMinorTickMark", "categoryAxisTickLabelPos", "categoryAxisLineColor", "categoryAxisLineWidthEmu", "categoryAxisLineHidden", "categoryAxisOrientation", "categoryAxisNumberFormat", "categoryAxisTickLabelSkip", "categoryAxisTickMarkSkip", "categoryAxisLabelOffset", "categoryAxisLabelAlign", "categoryAxisNoMultiLevelLabel", "categoryAxisDate", "categoryAxisScaling", "categoryGroupLevels", "dataTable", "grouping", "gapWidthPct", "gapDepthPct", "bar3DShape", "seriesAxis", "view3D"];
+  readonly lineArea3D: readonly ["categories", "title", "titleStyle", "titleOverlay", "titleLayout", "dataLabels", "legend", "plotAreaLayout", "plotAreaFill", "plotAreaStrokeColor", "chartAreaFill", "chartAreaStrokeColor", "plotVisibleCellsOnly", "dispBlanksAs", "date1904", "language", "roundedCorners", "chartStyle", "varyColors", "valueAxis", "valueAxisTitle", "valueAxisTitleStyle", "valueAxisTitleRotationDeg", "valueAxisLabelStyle", "valueAxisLabelRotationDeg", "valueAxisHidden", "valueAxisMajorGridlines", "valueAxisMinorGridlines", "valueAxisMajorGridlineColor", "valueAxisMinorGridlineColor", "valueAxisMajorGridlineWidthEmu", "valueAxisMinorGridlineWidthEmu", "valueAxisMajorTickMark", "valueAxisMinorTickMark", "valueAxisTickLabelPos", "valueAxisLineColor", "valueAxisLineWidthEmu", "valueAxisLineHidden", "valueAxisOrientation", "valueAxisCrosses", "valueAxisCrossBetween", "categoryAxisTitle", "categoryAxisTitleStyle", "categoryAxisTitleRotationDeg", "categoryAxisLabelStyle", "categoryAxisLabelRotationDeg", "categoryAxisHidden", "categoryAxisMajorGridlines", "categoryAxisMinorGridlines", "categoryAxisMajorGridlineColor", "categoryAxisMinorGridlineColor", "categoryAxisMajorGridlineWidthEmu", "categoryAxisMinorGridlineWidthEmu", "categoryAxisMajorTickMark", "categoryAxisMinorTickMark", "categoryAxisTickLabelPos", "categoryAxisLineColor", "categoryAxisLineWidthEmu", "categoryAxisLineHidden", "categoryAxisOrientation", "categoryAxisNumberFormat", "categoryAxisTickLabelSkip", "categoryAxisTickMarkSkip", "categoryAxisLabelOffset", "categoryAxisLabelAlign", "categoryAxisNoMultiLevelLabel", "categoryAxisDate", "categoryAxisScaling", "categoryGroupLevels", "dataTable", "grouping", "dropLines", "gapDepthPct", "seriesAxis", "view3D"];
+  readonly pie: readonly ["categories", "title", "titleStyle", "titleOverlay", "titleLayout", "dataLabels", "legend", "plotAreaLayout", "plotAreaFill", "plotAreaStrokeColor", "chartAreaFill", "chartAreaStrokeColor", "plotVisibleCellsOnly", "dispBlanksAs", "date1904", "language", "roundedCorners", "chartStyle", "varyColors", "firstSliceAngleDeg"];
+  readonly ofPie: readonly ["categories", "title", "titleStyle", "titleOverlay", "titleLayout", "dataLabels", "legend", "plotAreaLayout", "plotAreaFill", "plotAreaStrokeColor", "chartAreaFill", "chartAreaStrokeColor", "plotVisibleCellsOnly", "dispBlanksAs", "date1904", "language", "roundedCorners", "chartStyle", "varyColors", "ofPie"];
+  readonly pie3D: readonly ["categories", "title", "titleStyle", "titleOverlay", "titleLayout", "dataLabels", "legend", "plotAreaLayout", "plotAreaFill", "plotAreaStrokeColor", "chartAreaFill", "chartAreaStrokeColor", "plotVisibleCellsOnly", "dispBlanksAs", "date1904", "language", "roundedCorners", "chartStyle", "varyColors", "view3D"];
+  readonly doughnut: readonly ["categories", "title", "titleStyle", "titleOverlay", "titleLayout", "dataLabels", "legend", "plotAreaLayout", "plotAreaFill", "plotAreaStrokeColor", "chartAreaFill", "chartAreaStrokeColor", "plotVisibleCellsOnly", "dispBlanksAs", "date1904", "language", "roundedCorners", "chartStyle", "varyColors", "firstSliceAngleDeg", "holeSizePct"];
+  readonly scatter: readonly ["categories", "title", "titleStyle", "titleOverlay", "titleLayout", "dataLabels", "legend", "plotAreaLayout", "plotAreaFill", "plotAreaStrokeColor", "chartAreaFill", "chartAreaStrokeColor", "plotVisibleCellsOnly", "dispBlanksAs", "date1904", "language", "roundedCorners", "chartStyle", "varyColors", "valueAxis", "valueAxisTitle", "valueAxisTitleStyle", "valueAxisTitleRotationDeg", "valueAxisLabelStyle", "valueAxisLabelRotationDeg", "valueAxisHidden", "valueAxisMajorGridlines", "valueAxisMinorGridlines", "valueAxisMajorGridlineColor", "valueAxisMinorGridlineColor", "valueAxisMajorGridlineWidthEmu", "valueAxisMinorGridlineWidthEmu", "valueAxisMajorTickMark", "valueAxisMinorTickMark", "valueAxisTickLabelPos", "valueAxisLineColor", "valueAxisLineWidthEmu", "valueAxisLineHidden", "valueAxisOrientation", "valueAxisCrosses", "valueAxisCrossBetween", "categoryAxisTitle", "categoryAxisTitleStyle", "categoryAxisTitleRotationDeg", "categoryAxisLabelStyle", "categoryAxisLabelRotationDeg", "categoryAxisHidden", "categoryAxisMajorGridlines", "categoryAxisMinorGridlines", "categoryAxisMajorGridlineColor", "categoryAxisMinorGridlineColor", "categoryAxisMajorGridlineWidthEmu", "categoryAxisMinorGridlineWidthEmu", "categoryAxisMajorTickMark", "categoryAxisMinorTickMark", "categoryAxisTickLabelPos", "categoryAxisLineColor", "categoryAxisLineWidthEmu", "categoryAxisLineHidden", "categoryAxisOrientation", "categoryAxisNumberFormat", "categoryAxisScaling", "scatterStyle"];
+  readonly bubble: readonly ["categories", "title", "titleStyle", "titleOverlay", "titleLayout", "dataLabels", "legend", "plotAreaLayout", "plotAreaFill", "plotAreaStrokeColor", "chartAreaFill", "chartAreaStrokeColor", "plotVisibleCellsOnly", "dispBlanksAs", "date1904", "language", "roundedCorners", "chartStyle", "varyColors", "valueAxis", "valueAxisTitle", "valueAxisTitleStyle", "valueAxisTitleRotationDeg", "valueAxisLabelStyle", "valueAxisLabelRotationDeg", "valueAxisHidden", "valueAxisMajorGridlines", "valueAxisMinorGridlines", "valueAxisMajorGridlineColor", "valueAxisMinorGridlineColor", "valueAxisMajorGridlineWidthEmu", "valueAxisMinorGridlineWidthEmu", "valueAxisMajorTickMark", "valueAxisMinorTickMark", "valueAxisTickLabelPos", "valueAxisLineColor", "valueAxisLineWidthEmu", "valueAxisLineHidden", "valueAxisOrientation", "valueAxisCrosses", "valueAxisCrossBetween", "categoryAxisTitle", "categoryAxisTitleStyle", "categoryAxisTitleRotationDeg", "categoryAxisLabelStyle", "categoryAxisLabelRotationDeg", "categoryAxisHidden", "categoryAxisMajorGridlines", "categoryAxisMinorGridlines", "categoryAxisMajorGridlineColor", "categoryAxisMinorGridlineColor", "categoryAxisMajorGridlineWidthEmu", "categoryAxisMinorGridlineWidthEmu", "categoryAxisMajorTickMark", "categoryAxisMinorTickMark", "categoryAxisTickLabelPos", "categoryAxisLineColor", "categoryAxisLineWidthEmu", "categoryAxisLineHidden", "categoryAxisOrientation", "categoryAxisNumberFormat", "categoryAxisScaling", "bubbleScale", "bubbleSizeRepresents", "bubble3D", "showNegativeBubbles"];
+  readonly radar: readonly ["categories", "title", "titleStyle", "titleOverlay", "titleLayout", "dataLabels", "legend", "plotAreaLayout", "plotAreaFill", "plotAreaStrokeColor", "chartAreaFill", "chartAreaStrokeColor", "plotVisibleCellsOnly", "dispBlanksAs", "date1904", "language", "roundedCorners", "chartStyle", "varyColors", "valueAxis", "valueAxisTitle", "valueAxisTitleStyle", "valueAxisTitleRotationDeg", "valueAxisLabelStyle", "valueAxisLabelRotationDeg", "valueAxisHidden", "valueAxisMajorGridlines", "valueAxisMinorGridlines", "valueAxisMajorGridlineColor", "valueAxisMinorGridlineColor", "valueAxisMajorGridlineWidthEmu", "valueAxisMinorGridlineWidthEmu", "valueAxisMajorTickMark", "valueAxisMinorTickMark", "valueAxisTickLabelPos", "valueAxisLineColor", "valueAxisLineWidthEmu", "valueAxisLineHidden", "valueAxisOrientation", "valueAxisCrosses", "valueAxisCrossBetween", "categoryAxisTitle", "categoryAxisTitleStyle", "categoryAxisTitleRotationDeg", "categoryAxisLabelStyle", "categoryAxisLabelRotationDeg", "categoryAxisHidden", "categoryAxisMajorGridlines", "categoryAxisMinorGridlines", "categoryAxisMajorGridlineColor", "categoryAxisMinorGridlineColor", "categoryAxisMajorGridlineWidthEmu", "categoryAxisMinorGridlineWidthEmu", "categoryAxisMajorTickMark", "categoryAxisMinorTickMark", "categoryAxisTickLabelPos", "categoryAxisLineColor", "categoryAxisLineWidthEmu", "categoryAxisLineHidden", "categoryAxisOrientation", "categoryAxisNumberFormat", "categoryAxisTickLabelSkip", "categoryAxisTickMarkSkip", "categoryAxisLabelOffset", "categoryAxisLabelAlign", "categoryAxisNoMultiLevelLabel", "categoryAxisDate", "categoryAxisScaling", "categoryGroupLevels", "dataTable", "radarStyle"];
+  readonly stock: readonly ["categories", "title", "titleStyle", "titleOverlay", "titleLayout", "dataLabels", "legend", "plotAreaLayout", "plotAreaFill", "plotAreaStrokeColor", "chartAreaFill", "chartAreaStrokeColor", "plotVisibleCellsOnly", "dispBlanksAs", "date1904", "language", "roundedCorners", "chartStyle", "varyColors", "valueAxis", "valueAxisTitle", "valueAxisTitleStyle", "valueAxisTitleRotationDeg", "valueAxisLabelStyle", "valueAxisLabelRotationDeg", "valueAxisHidden", "valueAxisMajorGridlines", "valueAxisMinorGridlines", "valueAxisMajorGridlineColor", "valueAxisMinorGridlineColor", "valueAxisMajorGridlineWidthEmu", "valueAxisMinorGridlineWidthEmu", "valueAxisMajorTickMark", "valueAxisMinorTickMark", "valueAxisTickLabelPos", "valueAxisLineColor", "valueAxisLineWidthEmu", "valueAxisLineHidden", "valueAxisOrientation", "valueAxisCrosses", "valueAxisCrossBetween", "categoryAxisTitle", "categoryAxisTitleStyle", "categoryAxisTitleRotationDeg", "categoryAxisLabelStyle", "categoryAxisLabelRotationDeg", "categoryAxisHidden", "categoryAxisMajorGridlines", "categoryAxisMinorGridlines", "categoryAxisMajorGridlineColor", "categoryAxisMinorGridlineColor", "categoryAxisMajorGridlineWidthEmu", "categoryAxisMinorGridlineWidthEmu", "categoryAxisMajorTickMark", "categoryAxisMinorTickMark", "categoryAxisTickLabelPos", "categoryAxisLineColor", "categoryAxisLineWidthEmu", "categoryAxisLineHidden", "categoryAxisOrientation", "categoryAxisNumberFormat", "categoryAxisTickLabelSkip", "categoryAxisTickMarkSkip", "categoryAxisLabelOffset", "categoryAxisLabelAlign", "categoryAxisNoMultiLevelLabel", "categoryAxisDate", "categoryAxisScaling", "categoryGroupLevels", "dataTable", "dropLines", "hiLowLines"];
+  readonly candlestick: readonly ["categories", "title", "titleStyle", "titleOverlay", "titleLayout", "dataLabels", "legend", "plotAreaLayout", "plotAreaFill", "plotAreaStrokeColor", "chartAreaFill", "chartAreaStrokeColor", "plotVisibleCellsOnly", "dispBlanksAs", "date1904", "language", "roundedCorners", "chartStyle", "varyColors", "valueAxis", "valueAxisTitle", "valueAxisTitleStyle", "valueAxisTitleRotationDeg", "valueAxisLabelStyle", "valueAxisLabelRotationDeg", "valueAxisHidden", "valueAxisMajorGridlines", "valueAxisMinorGridlines", "valueAxisMajorGridlineColor", "valueAxisMinorGridlineColor", "valueAxisMajorGridlineWidthEmu", "valueAxisMinorGridlineWidthEmu", "valueAxisMajorTickMark", "valueAxisMinorTickMark", "valueAxisTickLabelPos", "valueAxisLineColor", "valueAxisLineWidthEmu", "valueAxisLineHidden", "valueAxisOrientation", "valueAxisCrosses", "valueAxisCrossBetween", "categoryAxisTitle", "categoryAxisTitleStyle", "categoryAxisTitleRotationDeg", "categoryAxisLabelStyle", "categoryAxisLabelRotationDeg", "categoryAxisHidden", "categoryAxisMajorGridlines", "categoryAxisMinorGridlines", "categoryAxisMajorGridlineColor", "categoryAxisMinorGridlineColor", "categoryAxisMajorGridlineWidthEmu", "categoryAxisMinorGridlineWidthEmu", "categoryAxisMajorTickMark", "categoryAxisMinorTickMark", "categoryAxisTickLabelPos", "categoryAxisLineColor", "categoryAxisLineWidthEmu", "categoryAxisLineHidden", "categoryAxisOrientation", "categoryAxisNumberFormat", "categoryAxisTickLabelSkip", "categoryAxisTickMarkSkip", "categoryAxisLabelOffset", "categoryAxisLabelAlign", "categoryAxisNoMultiLevelLabel", "categoryAxisDate", "categoryAxisScaling", "categoryGroupLevels", "dataTable", "dropLines", "hiLowLines", "upDownBars"];
+  readonly surface: readonly ["categories", "title", "titleStyle", "titleOverlay", "titleLayout", "dataLabels", "legend", "plotAreaLayout", "plotAreaFill", "plotAreaStrokeColor", "chartAreaFill", "chartAreaStrokeColor", "plotVisibleCellsOnly", "dispBlanksAs", "date1904", "language", "roundedCorners", "chartStyle", "varyColors", "valueAxis", "valueAxisTitle", "valueAxisTitleStyle", "valueAxisTitleRotationDeg", "valueAxisLabelStyle", "valueAxisLabelRotationDeg", "valueAxisHidden", "valueAxisMajorGridlines", "valueAxisMinorGridlines", "valueAxisMajorGridlineColor", "valueAxisMinorGridlineColor", "valueAxisMajorGridlineWidthEmu", "valueAxisMinorGridlineWidthEmu", "valueAxisMajorTickMark", "valueAxisMinorTickMark", "valueAxisTickLabelPos", "valueAxisLineColor", "valueAxisLineWidthEmu", "valueAxisLineHidden", "valueAxisOrientation", "valueAxisCrosses", "valueAxisCrossBetween", "categoryAxisTitle", "categoryAxisTitleStyle", "categoryAxisTitleRotationDeg", "categoryAxisLabelStyle", "categoryAxisLabelRotationDeg", "categoryAxisHidden", "categoryAxisMajorGridlines", "categoryAxisMinorGridlines", "categoryAxisMajorGridlineColor", "categoryAxisMinorGridlineColor", "categoryAxisMajorGridlineWidthEmu", "categoryAxisMinorGridlineWidthEmu", "categoryAxisMajorTickMark", "categoryAxisMinorTickMark", "categoryAxisTickLabelPos", "categoryAxisLineColor", "categoryAxisLineWidthEmu", "categoryAxisLineHidden", "categoryAxisOrientation", "categoryAxisNumberFormat", "categoryAxisTickLabelSkip", "categoryAxisTickMarkSkip", "categoryAxisLabelOffset", "categoryAxisLabelAlign", "categoryAxisNoMultiLevelLabel", "categoryAxisDate", "categoryAxisScaling", "categoryGroupLevels", "dataTable", "surfaceContour", "surfaceWireframe", "view3D", "seriesAxis"];
+};
+/** Name of one arm of {@link ChartSpec}. */
+type ChartVariant = keyof typeof VARIANT_FIELDS;
+type VariantField<V extends ChartVariant> = (typeof VARIANT_FIELDS)[V][number];
+/**
+ * Series channels and combo placement are the only parts of a series that
+ * depend on the chart kind; name, styling and per-point overrides are shared.
+ */
+type ChartSeriesCommon = Omit<ChartSeries, 'xValues' | 'bubbleSizes' | 'chartKind' | 'secondaryAxis'>;
+/** A series plotted as one value channel against the categories. */
+type PlainChartSeries = ChartSeriesCommon & {
+  readonly xValues?: never;
+  readonly bubbleSizes?: never;
+  readonly chartKind?: never;
+  readonly secondaryAxis?: never;
+};
+/**
+ * A series on a bar / column / line / area chart. Those four share a plot
+ * area, so a series can be drawn as another of them (`chartKind`) or moved
+ * to the secondary value axis.
+ */
+type ComboChartSeries = ChartSeriesCommon & {
+  readonly xValues?: never;
+  readonly bubbleSizes?: never;
+  readonly chartKind?: 'bar' | 'column' | 'line' | 'area';
+  readonly secondaryAxis?: boolean;
+};
+/** A scatter series: an x channel paired with the y channel. */
+type ScatterChartSeries = ChartSeriesCommon & {
+  readonly xValues: ReadonlyArray<number | null>;
+  readonly bubbleSizes?: never;
+  readonly chartKind?: never;
+  readonly secondaryAxis?: never;
+};
+/** A bubble series: x, y, and the size channel that scales each bubble. */
+type BubbleChartSeries = ChartSeriesCommon & {
+  readonly xValues: ReadonlyArray<number | null>;
+  readonly bubbleSizes: ReadonlyArray<number | null>;
+  readonly chartKind?: never;
+  readonly secondaryAxis?: never;
+};
+/**
+ * A category axis is either discrete — optionally grouped into outer
+ * levels — or a date axis. Only a numeric axis has a scale, so
+ * `categoryAxisScaling` rides with the date form.
+ */
+type CategoryAxisMode = {
+  readonly categoryAxisDate: ChartDateAxis; /** Date-serial range of the axis; only `min` / `max` apply. */
+  readonly categoryAxisScaling?: ChartAxisScaling;
+  readonly categoryGroupLevels?: never;
+} | {
+  readonly categoryAxisDate?: never;
+  readonly categoryAxisScaling?: never;
+  readonly categoryGroupLevels?: ReadonlyArray<ReadonlyArray<string>>;
+};
+/**
+ * A bar / column / line / area chart. Because the four share a plot area,
+ * every series-level and group-level control of the family is available
+ * whichever of them is the base kind — that is what makes a combo chart.
+ */
+type ComboChartSpec = Fields<VariantField<'combo'>> & CategoryAxisMode & {
+  readonly kind: 'bar' | 'column' | 'line' | 'area';
+  readonly series: ReadonlyArray<ComboChartSeries>;
+};
+/** A 3-D bar / column chart (`<c:bar3DChart>`). */
+type Bar3DChartSpec = Fields<VariantField<'bar3D'>> & CategoryAxisMode & {
+  readonly kind: 'bar' | 'column';
+  readonly series: ReadonlyArray<PlainChartSeries>; /** Its presence is what selects the 3-D element; a combo cannot be 3-D. */
+  readonly view3D: ChartView3D;
+};
+/**
+ * A 3-D line / area chart. High-low lines, up/down bars and point markers
+ * have no 3-D element to live in.
+ */
+type LineArea3DChartSpec = Fields<VariantField<'lineArea3D'>> & CategoryAxisMode & {
+  readonly kind: 'line' | 'area';
+  readonly series: ReadonlyArray<PlainChartSeries>;
+  readonly view3D: ChartView3D;
+};
+/** A pie chart. One series, one slice per category. */
+type PieChartSpec = Fields<VariantField<'pie'>> & {
+  readonly kind: 'pie';
+  readonly series: readonly [PlainChartSeries];
+};
+/** A pie-of-pie / bar-of-pie chart (`<c:ofPieChart>`). */
+type OfPieChartSpec = Fields<VariantField<'ofPie'>> & {
+  readonly kind: 'pie';
+  readonly series: readonly [PlainChartSeries];
+  readonly ofPie: ChartOfPie;
+};
+/** A 3-D pie (`<c:pie3DChart>`), which turns with the camera rather than `firstSliceAngleDeg`. */
+type Pie3DChartSpec = Fields<VariantField<'pie3D'>> & {
+  readonly kind: 'pie';
+  readonly series: readonly [PlainChartSeries];
+  readonly view3D: ChartView3D;
+};
+/** A doughnut chart. */
+type DoughnutChartSpec = Fields<VariantField<'doughnut'>> & {
+  readonly kind: 'doughnut';
+  readonly series: readonly [PlainChartSeries];
+};
+/** A scatter chart: both axes are numeric, so there are no categories to group. */
+type ScatterChartSpec = Fields<VariantField<'scatter'>> & {
+  readonly kind: 'scatter';
+  readonly series: ReadonlyArray<ScatterChartSeries>;
+};
+/** A bubble chart: a scatter chart whose third channel scales each marker. */
+type BubbleChartSpec = Fields<VariantField<'bubble'>> & {
+  readonly kind: 'bubble';
+  readonly series: ReadonlyArray<BubbleChartSeries>;
+};
+/** A radar chart. */
+type RadarChartSpec = Fields<VariantField<'radar'>> & CategoryAxisMode & {
+  readonly kind: 'radar';
+  readonly series: ReadonlyArray<PlainChartSeries>;
+};
+/** A stock chart plotted from high, low and close. */
+type StockChartSpec = Fields<VariantField<'stock'>> & CategoryAxisMode & {
+  readonly kind: 'stock';
+  readonly series: readonly [PlainChartSeries, PlainChartSeries, PlainChartSeries];
+};
+/**
+ * A candlestick chart: a stock chart with an open series, whose up / down
+ * bars span open → close.
+ */
+type CandlestickChartSpec = Fields<VariantField<'candlestick'>> & CategoryAxisMode & {
+  readonly kind: 'stock';
+  readonly series: readonly [PlainChartSeries, PlainChartSeries, PlainChartSeries, PlainChartSeries];
+};
+/** A surface chart. Its three axes make `view3D` a camera, not a subtype switch. */
+type SurfaceChartSpec = Fields<VariantField<'surface'>> & CategoryAxisMode & {
+  readonly kind: 'surface';
+  readonly series: ReadonlyArray<PlainChartSeries>;
+};
+/**
+ * A chart this library can draw. Each kind carries only the fields its
+ * OOXML element has, so a field the chart cannot show is a compile error
+ * rather than a value that serializes into nothing — or into a deck
+ * PowerPoint offers to repair.
+ *
+ * `readChartSpec` returns the permissive `ReadChartSpec` instead, because a
+ * deck authored elsewhere can combine fields no kind allows; narrow one back
+ * with {@link isChartSpec}.
+ */
+type ChartSpec = ComboChartSpec | Bar3DChartSpec | LineArea3DChartSpec | PieChartSpec | OfPieChartSpec | Pie3DChartSpec | DoughnutChartSpec | ScatterChartSpec | BubbleChartSpec | RadarChartSpec | StockChartSpec | CandlestickChartSpec | SurfaceChartSpec;
+/**
+ * Whether a spec read back from a deck also inhabits the write-side
+ * {@link ChartSpec}. A deck authored elsewhere can combine fields no kind
+ * draws, so a read-modify-write pass has to narrow before it writes.
+ */
+declare const isChartSpec: (spec: ReadChartSpec) => spec is ChartSpec;
+//#endregion
 //#region src/api/fn/charts.d.ts
 declare const addSlideChart: (slide: SlideData, opts: {
   spec: ChartSpec;
@@ -3160,7 +4173,7 @@ declare const addSlideChart: (slide: SlideData, opts: {
  */
 interface SlideChartData {
   readonly shape: SlideShapeData;
-  readonly spec: ChartSpec | null;
+  readonly spec: ReadChartSpec | null;
 }
 /**
  * Replaces the chart definition on an existing graphic-frame chart
@@ -3221,7 +4234,7 @@ declare const getShapeChartSeriesNames: (shape: SlideShapeData) => ReadonlyArray
  * `series[].bubbleSizes`).
  */
 declare const getShapeChartSeriesValues: (shape: SlideShapeData, seriesName: string) => ReadonlyArray<number | null> | null;
-declare const getShapeChartSpec: (shape: SlideShapeData) => ChartSpec | null;
+declare const getShapeChartSpec: (shape: SlideShapeData) => ReadChartSpec | null;
 /**
  * Returns every chart on the slide that carries a series whose name
  * equals `seriesName` exactly. Useful for "find the revenue chart"
@@ -3417,10 +4430,25 @@ declare const setTableRowHeight: (table: SlideShapeData, row: number, height: Em
  */
 declare const getTableCell: (table: SlideShapeData, row: number, col: number) => TableCellData;
 /**
- * Replaces a cell's text. `\n` starts a new paragraph. The paragraph-end
- * format (`<a:endParaRPr>`) is not kept; author it with `setTableCellParagraphs`.
- */
-declare const setTableCellText: (cell: TableCellData, text: string) => void;
+ * Replaces a cell's text. `\n` starts a new paragraph unless `newlines: 'break'`
+ * requests paragraph-internal `<a:br>` elements. The paragraph-end
+ * format (`<a:endParaRPr>`) is not kept unless `preserveFormatting` is enabled.
+ * That option preserves unaffected runs and paragraph properties during editing.
+ * With `range`, `text` replaces exactly that UTF-16 selection, always preserving
+ * the formatting of unaffected text. Pass `{ case: 'upper' | 'lower' | 'sentence' |
+ * 'title' | 'toggle' }` to change case in the whole cell or `options.range`
+ * without rebuilding its runs, fields, or paragraph properties.
+ */
+declare const setTableCellText: (cell: TableCellData, text: string | {
+  case: TextCase;
+}, options?: {
+  newlines?: "paragraph" | "break";
+  preserveFormatting?: boolean;
+  range?: {
+    start: number;
+    end: number;
+  };
+}) => void;
 /**
  * Replaces the cell's text with explicitly structured paragraphs and runs —
  * the table counterpart of `setShapeParagraphs`. Read back with
@@ -3468,7 +4496,8 @@ declare const getTableCellSpan: (cell: TableCellData) => {
  * leaves each covered cell's `<a:txBody>` in the XML; `'drop'` removes it,
  * so the covered cells carry no `<a:txBody>` at all (CT_TableCell allows
  * that), which is how PptxGenJS writes a merge; `getTableCellParagraphs`
- * reads them as `[]`.
+ * reads them as `[]`. `'append'` moves covered paragraphs into the anchor in
+ * row-major order, preserving their formatting and leaving covered cells empty.
  */
 declare const mergeTableCells: (table: SlideShapeData, block: {
   readonly row: number;
@@ -3476,8 +4505,14 @@ declare const mergeTableCells: (table: SlideShapeData, block: {
   readonly rowSpan: number;
   readonly colSpan: number;
 }, options?: {
-  readonly coveredText?: "keep" | "drop";
+  readonly coveredText?: "keep" | "drop" | "append";
 }) => void;
+/**
+ * Splits the merged region containing `cell`, including a covered cell.
+ * Retains each cell's text and properties; text removed during merging stays empty.
+ * An unmerged cell is unchanged. Malformed regions throw before any mutation.
+ */
+declare const splitTableCell: (cell: TableCellData) => void;
 /**
  * One side of a cell's border, as read from `<a:tcPr><a:ln{L|R|T|B}>`.
  * `widthEmu` is the line width in EMU; `color` is `#RRGGBB` or `null`
@@ -3585,7 +4620,10 @@ interface TableCellParagraph {
    */
   readonly align: ParagraphAlignment | null;
   /** Runs / fields / breaks in document order, with their literal `<a:rPr>` format. */
-  readonly elements: ReadonlyArray<ShapeParagraphElement>;
+  readonly elements: ReadonlyArray<ShapeParagraphElement & {
+    readonly clickAction?: ShapeClickAction;
+    readonly tooltip?: string;
+  }>;
   /**
    * Literal format of the paragraph-end mark (`<a:endParaRPr>`), or `null`
    * when absent — the only format a paragraph with no `elements` carries.
@@ -3607,6 +4645,20 @@ interface TableCellParagraph {
  * `undefined` for the caller to resolve.
  */
 declare const getTableCellParagraphs: (cell: TableCellData) => ReadonlyArray<TableCellParagraph>;
+/**
+ * Reads a table-cell run's effective character format. The literal
+ * `getTableCellParagraphs` format only contains properties authored on the
+ * run; this resolver also applies the cell text body's paragraph defaults and
+ * outline-level defaults (`a:pPr/defRPr` and `a:lstStyle`). Pass `null` as
+ * `runIndex` to resolve the paragraph end mark, including empty paragraphs.
+ * Pass `{ fieldIndex }` for a zero-based `a:fld` index; numeric indices count
+ * regular `a:r` runs only. Pass `{ breakIndex }` for a zero-based `a:br` index.
+ */
+declare const getTableCellRunFormatEffective: (pres: PresentationData, cell: TableCellData, paragraphIndex: number, runIndex: number | null | {
+  readonly fieldIndex: number;
+} | {
+  readonly breakIndex: number;
+}) => ReadTextFormat;
 /** Sets a solid background color on a cell (`<a:tcPr><a:solidFill>`). */
 declare const setTableCellFill: (cell: TableCellData, color: Color) => void;
 /** Removes any background fill from a cell. */
@@ -3618,8 +4670,44 @@ declare const clearTableCellFill: (cell: TableCellData) => void;
  * (gradient / pattern / image).
  */
 declare const getTableCellFill: (cell: TableCellData) => string | null;
-/** Applies a TextFormat to every run in the cell's text. */
-declare const setTableCellTextFormat: (cell: TableCellData, format: TextFormat) => void;
+/** Effective cell appearance after table-style and cell-property inheritance. */
+interface TableCellAppearanceEffective {
+  readonly fill: ShapeFill;
+  readonly borders: TableCellBorders;
+}
+/** Resolves table-style `tcStyle` fills and borders, then overlays local `tcPr`. */
+declare const getTableCellAppearanceEffective: (pres: PresentationData, cell: TableCellData) => TableCellAppearanceEffective;
+/** Applies a TextFormat to the cell's text, optionally within UTF-16 offsets
+ * in getTableCellText (exclusive end). Breaks count as one character; invalid
+ * ranges and split-surrogate boundaries throw without changing the text.
+ * `reset` restores inherited run appearance before applying `format`, retaining
+ * links and language. Without either target, run-format defaults are also cleared.
+ * Pass a zero-based `paragraphEnd` instead of `range` to update a paragraph's end mark. */
+declare const setTableCellTextFormat: (cell: TableCellData, format: TextFormat, options?: {
+  range?: {
+    start: number;
+    end: number;
+  };
+  reset?: boolean;
+  paragraphEnd?: never;
+} | {
+  paragraphEnd: number;
+  reset?: boolean;
+  range?: never;
+}) => void;
+/**
+ * Sets or removes a click link on cell text. Omitting range covers the whole
+ * cell; otherwise offsets are UTF-16 positions in getTableCellText, with an
+ * exclusive end. Formatting and links outside the range are preserved.
+ * Omitting tooltip clears the selected link's previous description.
+ */
+declare const setTableCellClickAction: (cell: TableCellData, action: ShapeClickAction | null, options?: {
+  range?: {
+    start: number;
+    end: number;
+  };
+  tooltip?: string;
+}) => void;
 /** Sets horizontal alignment on every paragraph in the cell. */
 declare const setTableCellAlignment: (cell: TableCellData, align: ParagraphAlignment) => void;
 /** Zero-based (row, col) of the cell. */
@@ -3799,13 +4887,28 @@ interface PresentationSummary {
 declare const getPresentationSummary: (pres: PresentationData) => PresentationSummary;
 //#endregion
 //#region src/api/fn/shape-image-effects.d.ts
+/** A color used by a two-color image recolor, with optional DrawingML transforms. */
+type ImageRecolorColor = Color | {
+  readonly color: Color;
+  readonly colorTransforms?: readonly ColorTransform[];
+};
 /**
- * Sets the picture's opacity (0–1 fraction; `1` is fully opaque, `0`
- * fully transparent). Pass `null` to remove an existing opacity
- * override and restore PowerPoint's default behavior.
- *
- * Throws for non-picture shapes and on opacities outside `[0, 1]`.
+ * A PowerPoint image recolor operation. Threshold is expressed as a percent
+ * (0..100), matching `getShapeImageBiLevelThreshold` and PowerPoint's UI.
  */
+type ImageRecolor = {
+  readonly kind: 'none';
+} | {
+  readonly kind: 'grayscale';
+} | {
+  readonly kind: 'duotone';
+  readonly colors: readonly [ImageRecolorColor, ImageRecolorColor];
+} | {
+  readonly kind: 'threshold';
+  readonly threshold: number;
+} | {
+  readonly kind: 'washout';
+};
 /**
  * Returns the embedded image bytes for a picture shape, or `null`
  * when the shape isn't a picture or has no `r:embed` reference
@@ -3925,12 +5028,36 @@ declare const getShapeImageBiLevelThreshold: (shape: SlideShapeData) => number |
  * Reads the picture's duotone color transform from `<a:blip><a:duotone>`.
  * PowerPoint emits two `<a:srgbClr>` (or scheme color) children for a
  * two-color duotone effect — typical "Picture Tools › Recolor".
- * Returns `null` when no duotone is set.
- */
-declare const getShapeImageDuotone: (pres: PresentationData, shape: SlideShapeData) => {
+ * By default colors are resolved to RGB for rendering. Pass
+ * `{ resolveColors: false }` to preserve authoring color models and
+ * transforms for a read-edit-write cycle. Only sRGB and scheme colors can
+ * retain their authoring model; other DrawingML models are returned as their
+ * resolved base color with the original transforms. Returns `null` when no
+ * duotone is set.
+ */
+declare function getShapeImageDuotone(pres: PresentationData, shape: SlideShapeData): {
+  firstColor: string | null;
+  secondColor: string | null;
+} | null;
+declare function getShapeImageDuotone(pres: PresentationData, shape: SlideShapeData, options: {
+  readonly resolveColors: false;
+}): Extract<ImageRecolor, {
+  kind: 'duotone';
+}> | null;
+declare function getShapeImageDuotone(pres: PresentationData, shape: SlideShapeData, options: {
+  readonly resolveColors: true;
+}): {
   firstColor: string | null;
   secondColor: string | null;
 } | null;
+declare function getShapeImageDuotone(pres: PresentationData, shape: SlideShapeData, options: {
+  readonly resolveColors: boolean;
+}): {
+  firstColor: string | null;
+  secondColor: string | null;
+} | Extract<ImageRecolor, {
+  kind: 'duotone';
+}> | null;
 declare const getShapeImageLinkUrl: (shape: SlideShapeData) => string | null;
 declare const getShapeImagePartName: (shape: SlideShapeData) => string | null;
 /**
@@ -3951,19 +5078,19 @@ declare const getShapeImageFillBytes: (shape: SlideShapeData) => Uint8Array | nu
  */
 declare const getShapeImageFormat: (shape: SlideShapeData) => ImageFormat | null;
 /**
- * Reads the picture's opacity (0–1 fraction). Returns `null` when no
+ * Reads the picture or image fill's opacity (0–1 fraction). Returns `null` when no
  * `<a:alphaModFix>` is present (PowerPoint treats absence as fully
  * opaque); returns `1` when an explicit alphaModFix sets full opacity.
  */
 declare const getShapeImageOpacity: (shape: SlideShapeData) => number | null;
 /**
- * Reads the picture's crop fractions. Returns `null` when no
+ * Reads a picture or image fill's crop fractions. Returns `null` when no
  * `<a:srcRect>` is present; otherwise returns a fully-populated object
  * with every side filled in (0 for omitted sides on disk).
  */
 declare const getShapeImageCrop: (shape: SlideShapeData) => ImageCrop | null;
 /**
- * Adjusts the picture's brightness via `<a:blip><a:lum bright="…"/>`. The value
+ * Adjusts a picture or image fill's brightness via `<a:blip><a:lum bright="…"/>`. The value
  * is a -1..1 fraction:
  *
  *   - `1`     → +100% brightness
@@ -3971,11 +5098,11 @@ declare const getShapeImageCrop: (shape: SlideShapeData) => ImageCrop | null;
  *   - `-1`    → -100% brightness
  *
  * Brightness and contrast share the one `<a:lum>` element, so setting one keeps
- * the other. Throws for non-picture shapes and on values outside [-1, 1].
+ * the other. Throws for shapes without an image and on values outside [-1, 1].
  */
 declare const setShapeImageBrightness: (shape: SlideShapeData, value: number | null) => void;
 /**
- * Adjusts the picture's contrast via `<a:blip><a:lum contrast="…"/>`. The value
+ * Adjusts a picture or image fill's contrast via `<a:blip><a:lum contrast="…"/>`. The value
  * is a -1..1 fraction (ECMA-376 `ST_FixedPercentage`):
  *
  *   - `0` or `null` → no contrast change (the `contrast` attribute is removed)
@@ -3983,19 +5110,37 @@ declare const setShapeImageBrightness: (shape: SlideShapeData, value: number | n
  *   - `-0.5`        → -50% contrast (washed out)
  *
  * Brightness and contrast share the one `<a:lum>` element, so setting one keeps
- * the other. Throws on non-picture shapes and on values outside [-1, 1].
+ * the other. Throws for shapes without an image and on values outside [-1, 1].
  */
 declare const setShapeImageContrast: (shape: SlideShapeData, value: number | null) => void;
 /**
- * Reads the picture's contrast (the `<a:lum contrast>` fraction in [-1, 1]).
+ * Reads a picture or image fill's contrast (the `<a:lum contrast>` fraction in [-1, 1]).
  * Returns `null` when no contrast adjustment is present.
  */
 declare const getShapeImageContrast: (shape: SlideShapeData) => number | null;
 /**
- * Reads the picture's brightness (the `<a:lum bright>` fraction in [-1, 1]).
+ * Reads a picture or image fill's brightness (the `<a:lum bright>` fraction in [-1, 1]).
  * Returns `null` when no brightness adjustment is present.
  */
 declare const getShapeImageBrightness: (shape: SlideShapeData) => number | null;
+/**
+ * Clears PowerPoint's image color corrections from a picture or image fill.
+ * This removes grayscale (`grayscl`), duotone, bi-level recolor, and
+ * brightness/contrast (`lum`) effects while preserving opacity, media
+ * references, and all other known or extension effects.
+ */
+declare const resetShapeImageColorEffects: (shape: SlideShapeData) => void;
+/**
+ * Applies a PowerPoint image recolor to a picture or image-filled shape.
+ * `none` removes the recolor while preserving opacity, media references, and
+ * unrelated DrawingML effects. Threshold is a percentage from 0 to 100.
+ */
+declare const setShapeImageRecolor: (shape: SlideShapeData, recolor: ImageRecolor) => void;
+/**
+ * Sets picture or image-fill opacity (0–1; `1` is fully opaque).
+ * Pass `null` to restore PowerPoint's default opacity.
+ * Rejects shapes without an image and values outside `[0, 1]` without changing them.
+ */
 declare const setShapeImageOpacity: (shape: SlideShapeData, opacity: number | null) => void;
 /** Crop a picture by fraction of each side. Omitted sides default to 0. */
 interface ImageCrop {
@@ -4005,45 +5150,182 @@ interface ImageCrop {
   readonly bottom?: number;
 }
 /**
- * Sets (or clears) a `<a:srcRect>` on a picture shape, cropping the
+ * Sets (or clears) a `<a:srcRect>` on a picture or image-filled shape, cropping the
  * embedded image by the given fraction on each side. Pass `null` to
  * remove an existing crop.
  *
- * Fractions are in `[0, 1)` per side. `{ left: 0.25 }` clips 25% off
- * the left edge; the visible image stretches to fill the original
- * frame. The shape's geometry (`<a:xfrm>`) is unchanged.
+ * Fractions use the signed `ST_Percentage` range per side. `{ left: 0.25 }`
+ * clips 25% off the left edge; negative values extend the source rectangle.
+ * Stretch fills fit the remaining image to the frame;
+ * tiled fills repeat the remaining image. The shape's geometry (`<a:xfrm>`) is unchanged.
  */
 declare const setShapeImageCrop: (shape: SlideShapeData, crop: ImageCrop | null) => void;
 //#endregion
+//#region src/api/fn/_animation-timing.d.ts
+/** When a step runs relative to the one before it. */
+type AnimationStart = 'click' | 'withPrevious' | 'afterPrevious' | 'unknown';
+/**
+ * What becomes of the value an effect animates once it has run, from the
+ * `fill` on its behaviours (ST_TLTimeNodeFillType: `remove | freeze | hold |
+ * transition`). `'unstated'` is not `'held'`: the schema gives the attribute
+ * no default, so a tree that omits it has not said.
+ */
+type AnimationValueAfterEnd = 'held' | 'removed' | 'unstated';
+/**
+ * What an effect animates. `unsupported` covers targets this library does not
+ * model — charts, OLE parts, sub-shapes, and composite effects whose
+ * behaviours do not all animate the same thing. The step is still listed so a
+ * caller can show it, but it cannot be edited.
+ */
+type AnimationTarget = {
+  readonly kind: 'shape';
+  readonly shapeId: number;
+} | {
+  readonly kind: 'paragraphs';
+  readonly shapeId: number;
+  readonly firstParagraph: number;
+  readonly lastParagraph: number;
+} | {
+  readonly kind: 'unsupported';
+  readonly shapeId: number | null;
+};
+/** One animation effect on a slide, as read from `<p:timing>`. */
+interface SlideAnimationStep {
+  /**
+   * How the editing APIs address this step: the effect's `<p:cTn id>`.
+   * `null` when the node carries no id, the id is not a plain integer, or the
+   * same id appears more than once in the tree — none of which is a safe
+   * handle, so such a step is read-only.
+   */
+  readonly id: number | null;
+  readonly target: AnimationTarget;
+  /**
+   * Every shape any of the step's behaviours animates, in document order.
+   * A composite effect that drives two shapes reports both here even though
+   * `target` refuses to name one of them as *the* target.
+   */
+  readonly targetShapeIds: readonly number[];
+  /** `null` for a preset outside the `AnimationEffect` tokens. */
+  readonly effect: AnimationEffect | null;
+  /**
+   * Which edge of the slide a fly comes from or leaves by. `null` for every
+   * other effect — the preset states no direction, so neither does this.
+   */
+  readonly direction: AnimationDirection | null;
+  readonly presetId: number | null;
+  readonly presetClass: string | null;
+  /** `'unknown'` when the node type is not one this library models. */
+  readonly start: AnimationStart;
+  /** `null` when the tree does not state one — never defaulted. */
+  readonly durationMs: number | null;
+  /** `null` when the tree does not state one, or the delay is indefinite. */
+  readonly delayMs: number | null;
+  /**
+   * What the tree says becomes of the value this effect animates once it has
+   * run. It decides nothing on its own — `playable` already requires that the
+   * behaviour saying whether the shape is on the slide keeps its value — but
+   * it is what two effects animating one object at the same time turn on: the
+   * one that ends first either stays above the other or gives way to it. A
+   * player that finds `'unstated'` there must not choose for the file.
+   */
+  readonly valueAfterEnd: AnimationValueAfterEnd;
+  /** `<p:bldP build="p">` — the text body is revealed paragraph by paragraph. */
+  readonly buildByParagraph: boolean;
+  readonly buildLevel: number | null;
+  /**
+   * Which `<p:seq>` the step lives in, named after its `nodeType`. Only
+   * `'mainSeq'` advances on the slide's own clicks: an `'interactiveSeq'`
+   * sequence fires when the viewer clicks the shape it is bound to, so a
+   * player that folded one into the click order would run it at the wrong
+   * time — and swallow a click the slide owes its main sequence.
+   */
+  readonly sequence: AnimationSequenceKind;
+  /**
+   * `true` when a player can run this step as part of the slide's click
+   * order: it is in the main sequence, starts in a way we model, animates a
+   * single target we model, and uses a preset we know how to render. A step
+   * that is not playable must be shown as such, never folded into the normal
+   * progression.
+   */
+  readonly playable: boolean;
+  /**
+   * `true` when this library can safely move, remove or retime the step:
+   * `playable`, plus a unique handle to address it by. Editability is not
+   * playability — a step can be one without the other as either side grows.
+   */
+  readonly editable: boolean;
+}
+/**
+ * Which `<p:seq>` an effect belongs to, named after its `nodeType`. The two
+ * tokens are ST_TLTimeNodeType values; `'other'` covers a sequence whose node
+ * type is absent or something else again.
+ */
+type AnimationSequenceKind = 'mainSeq' | 'interactiveSeq' | 'other';
+//#endregion
 //#region src/api/fn/shape-animation.d.ts
 /**
- * Sets a single click-triggered animation effect on the given shape.
+ * Adds a single animation effect to the given shape.
  *
  * The effect is *merged* into any existing `<p:timing>` on the slide rather
  * than replacing it: animating a second shape (or re-running on a template that
- * already has authored animations) preserves the existing effects and appends
- * this one as the next click stop, with cTn ids renumbered to stay unique. To
- * clear every animation first, call `clearSlideAnimations`.
+ * already has authored animations) preserves the existing effects, with cTn ids
+ * renumbered to stay unique. To clear every animation first, call
+ * `clearSlideAnimations`.
  *
  * Supported `effect` tokens:
  *
- *   - `'fadeIn'`   entrance fade
- *   - `'fadeOut'`  exit fade
- *   - `'appear'`   instant entrance
- *   - `'disappear'` instant exit
- *
- * `durationMs` defaults to 500ms (fades only — `appear`/`disappear`
- * are instantaneous).
+ *   - `'appear'` / `'disappear'` — instant entrance and exit
+ *   - `'fadeIn'` / `'fadeOut'` — entrance and exit fade
+ *   - `'flyIn'` / `'flyOut'` — entrance and exit that travel in from, or out
+ *     to, one edge of the slide. `direction` picks the edge (`'top'`,
+ *     `'right'`, `'bottom'` — the default — or `'left'`) and is an error for
+ *     any other effect.
+ *   - `'zoomIn'` / `'zoomOut'` — entrance that grows from nothing, exit that
+ *     shrinks back to it, both about the shape's centre
+ *   - `'spin'` — emphasis: one clockwise turn about the shape's centre,
+ *     leaving it exactly where it was. It never puts the shape on the slide or
+ *     takes it off, so a shape that is not already shown stays unshown.
+ *
+ * `durationMs` defaults to 500ms. `appear` and `disappear` are instantaneous by
+ * definition of the preset and write no timed behaviour at all.
+ *
+ * `start` decides where the effect lands. The default `'click'` gives it a
+ * click stop of its own, so the viewer sees it on the next click.
+ * `'withPrevious'` and `'afterPrevious'` join the stop the last effect is in,
+ * running alongside it or once it has finished — both off the same click. As
+ * the slide's first effect neither has a predecessor, so both run when the
+ * slide appears. `delayMs` waits that long once the start condition is met.
+ *
+ * `'afterPrevious'` throws when the slide's timing does not say when the effect
+ * before it ends — it runs indefinitely, states no duration, repeats, or starts
+ * from another node rather than at a fixed offset. The slide is left untouched;
+ * `'click'` and `'withPrevious'` need no such measurement.
+ *
+ * `byParagraph` reveals the shape's text one paragraph at a time rather than
+ * animating the shape as a whole: one effect per paragraph, each with the same
+ * `start`, so the default `'click'` advances a paragraph per click. They share
+ * a single `<p:bldP build="p">`, which is how PowerPoint and Google Slides both
+ * present the build as one animation. `getSlideAnimations` reports each
+ * paragraph as its own step, targeting a paragraph range.
+ *
+ * Reading the result back, including the order and start condition of every
+ * effect on the slide, is `getSlideAnimations`.
  */
 declare const setShapeAnimation: (shape: SlideShapeData, opts: AnimationOptions) => void;
 /**
  * Returns the animation effect bound to this shape via the slide's
- * `<p:timing>` tree, or `null` if the shape has no animation in the
- * v1 single-effect schema we model. Unknown presets are reported as a
- * raw `null` rather than guessing.
+ * `<p:timing>` tree, or `null` when the shape has none. A shape carrying
+ * several effects reports the first one in document order. Presets outside
+ * the four `AnimationEffect` tokens are reported as `null` rather than
+ * guessed at.
  */
 declare const getShapeAnimation: (shape: SlideShapeData) => AnimationEffect | null;
-/** Removes the slide's `<p:timing>` element entirely. */
+/**
+ * Every animation effect on the slide, in document order — the click order a
+ * viewer sees. Effects this library cannot author are still listed, with
+ * `editable: false`, so a caller can show them instead of losing them.
+ */
+declare const getSlideAnimations: (slide: SlideData) => readonly SlideAnimationStep[];
 /**
  * Returns every shape on the slide that has an authored animation
  * effect (i.e. `getShapeAnimation(shape)` is not `null`). Pair to
@@ -4052,6 +5334,7 @@ declare const getShapeAnimation: (shape: SlideShapeData) => AnimationEffect | nu
  * that doesn't honor PowerPoint's timing tree.
  */
 declare const findShapesWithAnimation: (slide: SlideData) => ReadonlyArray<SlideShapeData>;
+/** Removes every animation on the slide, keeping its media play controls. */
 declare const clearSlideAnimations: (slide: SlideData) => void;
 //#endregion
 //#region src/api/fn/slide-title.d.ts
@@ -4093,7 +5376,7 @@ declare const setSlidePlaceholders: (slide: SlideData, byType: Readonly<Partial<
 declare const setSlideBody: (slide: SlideData, text: string) => void;
 //#endregion
 //#region src/api/fn/shape-runs.d.ts
-/** Number of paragraphs in the shape's text body. Throws for non-text shapes. */
+/** Number of paragraphs; zero for an autoshape without a text body. Throws for non-text shapes. */
 declare const getShapeParagraphCount: (shape: SlideShapeData) => number;
 /**
  * One inline element in a paragraph as ordered: a literal text run
@@ -4128,9 +5411,11 @@ type ShapeParagraphElement = {
  * Returns the inline children of a paragraph in document order — runs,
  * field placeholders, and line breaks. Used by renderers that need to
  * reproduce the paragraph faithfully (the `<a:r>`-only run accessors
- * silently drop fields and breaks).
+ * silently drop fields and breaks). Omit the index to read all paragraphs in
+ * one pass.
  */
-declare const getShapeParagraphElements: (shape: SlideShapeData, paragraphIndex: number) => ReadonlyArray<ShapeParagraphElement>;
+declare function getShapeParagraphElements(shape: SlideShapeData): ReadonlyArray<ReadonlyArray<ShapeParagraphElement>>;
+declare function getShapeParagraphElements(shape: SlideShapeData, paragraphIndex: number): ReadonlyArray<ShapeParagraphElement>;
 /**
  * Reads the literal format of a paragraph's end mark (`<a:endParaRPr>`), or
  * `null` when the paragraph carries none. It is the only format a paragraph
@@ -4193,7 +5478,7 @@ declare const getShapeRunClickAction: (shape: SlideShapeData, paragraphIndex: nu
  * Sets the horizontal alignment of a single paragraph. Same token set
  * as `setShapeAlignment`. Other paragraphs are untouched.
  */
-declare const setParagraphAlignment: (shape: SlideShapeData, paragraphIndex: number, align: ParagraphAlignment) => void;
+declare const setParagraphAlignment: (shape: SlideShapeData | TableCellData, paragraphIndex: number, align: ParagraphAlignment) => void;
 /**
  * Sets the paragraph's nesting level (`<a:pPr lvl="N"/>`). Levels are
  * 0-indexed; PowerPoint accepts 0 through 8. Pass `0` to clear an
@@ -4201,13 +5486,22 @@ declare const setParagraphAlignment: (shape: SlideShapeData, paragraphIndex: num
  * Indents matching the previous level's default bullet pair follow the level;
  * other indent values are preserved.
  *
+ * A UTF-16 range selects all touched paragraphs (exclusive end; a caret selects
+ * its paragraph). Pass `{ offset }` to shift their existing levels, clamped to
+ * 0 through 8. Range updates preserve run XML and commit the text body once.
+ *
  * Used in tandem with bullets to author nested lists:
  *
  *   setShapeText(shape, 'Item 1\nNested\nItem 2');
  *   setShapeBulletStyle(shape, 'bullet');
  *   setParagraphLevel(shape, 1, 1);  // indent the second line
  */
-declare const setParagraphLevel: (shape: SlideShapeData, paragraphIndex: number, level: number) => void;
+declare const setParagraphLevel: (shape: SlideShapeData | TableCellData, paragraphIndex: number | {
+  start: number;
+  end: number;
+}, level: number | {
+  offset: number;
+}) => void;
 /**
  * Reads the paragraph's own `algn` as its spec token (`l`, `ctr`, `r`,
  * `just`, `dist`, `justLow`, `thaiDist`) — so `setParagraphAlignment(…,
@@ -4216,13 +5510,17 @@ declare const setParagraphLevel: (shape: SlideShapeData, paragraphIndex: number,
  * valid token. For the inherited value under a plain-English name, use
  * `getParagraphPropertiesEffective`.
  */
-declare const getParagraphAlignment: (shape: SlideShapeData, paragraphIndex: number) => ParagraphAlignmentToken | null;
+declare const getParagraphAlignment: (shape: SlideShapeData | TableCellData, paragraphIndex: number) => ParagraphAlignmentToken | null;
 /**
  * Reads the paragraph's nesting level (`lvl` attribute), or `0` when
- * absent — PowerPoint's default. Returns `null` for non-existent
- * paragraphs.
+ * absent — PowerPoint's default. A UTF-16 range returns the levels of all
+ * touched paragraphs in order. Invalid indices or ranges throw RangeError.
  */
-declare const getParagraphLevel: (shape: SlideShapeData, paragraphIndex: number) => number;
+declare function getParagraphLevel(shape: SlideShapeData | TableCellData, paragraphIndex: number): number;
+declare function getParagraphLevel(shape: SlideShapeData | TableCellData, range: {
+  start: number;
+  end: number;
+}): number[];
 /**
  * Sets the spacing before and/or after a paragraph, in points (where
  * a "point" is 1/72 inch). PowerPoint stores these as hundredths of a
@@ -4234,7 +5532,7 @@ declare const getParagraphLevel: (shape: SlideShapeData, paragraphIndex: number)
  * Omitting a side keeps the existing value (or layout default).
  * Passing a side as `null` removes that spacing element.
  */
-declare const setParagraphSpacing: (shape: SlideShapeData, paragraphIndex: number, opts: {
+declare const setParagraphSpacing: (shape: SlideShapeData | TableCellData, paragraphIndex: number, opts: {
   beforePts?: number | null;
   afterPts?: number | null;
 }) => void;
@@ -4244,7 +5542,7 @@ declare const setParagraphSpacing: (shape: SlideShapeData, paragraphIndex: numbe
  * is present or when the inner element isn't `<a:spcPts>` (percentage
  * spacing is reported as `null` for now).
  */
-declare const getParagraphSpacing: (shape: SlideShapeData, paragraphIndex: number) => {
+declare const getParagraphSpacing: (shape: SlideShapeData | TableCellData, paragraphIndex: number) => {
   readonly beforePts: number | null;
   readonly afterPts: number | null;
 };
@@ -4257,11 +5555,22 @@ declare const getParagraphSpacing: (shape: SlideShapeData, paragraphIndex: numbe
  * Returns `null` for sides the paragraph doesn't set (those inherit
  * from the layout / master).
  */
-declare const getParagraphIndent: (shape: SlideShapeData, paragraphIndex: number) => {
+declare const getParagraphIndent: (shape: SlideShapeData | TableCellData, paragraphIndex: number) => {
   leftEmu: number | null;
   rightEmu: number | null;
   firstLineEmu: number | null;
 };
+/**
+ * Sets paragraph indents in EMU. The first-line offset is relative to the
+ * left indent; negative values create a hanging indent. Omitted sides are
+ * preserved, and `null` removes an override to restore inheritance.
+ * Values are rounded to whole EMU and must satisfy the OOXML text bounds.
+ */
+declare const setParagraphIndent: (shape: SlideShapeData | TableCellData, paragraphIndex: number, opts: {
+  leftEmu?: number | null;
+  rightEmu?: number | null;
+  firstLineEmu?: number | null;
+}) => void;
 /**
  * Reads the paragraph's `<a:lnSpc>` line spacing. PowerPoint stores
  * line spacing two ways:
@@ -4275,7 +5584,7 @@ declare const getParagraphIndent: (shape: SlideShapeData, paragraphIndex: number
  * Returns `null` when no `<a:lnSpc>` is present (the paragraph
  * inherits line spacing from the layout / master).
  */
-declare const getParagraphLineSpacing: (shape: SlideShapeData, paragraphIndex: number) => {
+declare const getParagraphLineSpacing: (shape: SlideShapeData | TableCellData, paragraphIndex: number) => {
   readonly kind: "pct";
   readonly value: number;
 } | {
@@ -4293,7 +5602,7 @@ declare const getParagraphLineSpacing: (shape: SlideShapeData, paragraphIndex: n
  * Pass `null` to clear the override (the paragraph then inherits line
  * spacing from the layout / master).
  */
-declare const setParagraphLineSpacing: (shape: SlideShapeData, paragraphIndex: number, spacing: {
+declare const setParagraphLineSpacing: (shape: SlideShapeData | TableCellData, paragraphIndex: number, spacing: {
   readonly kind: "pct";
   readonly value: number;
 } | {
@@ -4305,7 +5614,7 @@ declare const setParagraphLineSpacing: (shape: SlideShapeData, paragraphIndex: n
  * no `<a:buChar>` / `<a:buAutoNum>` / `<a:buNone>` is present (the
  * paragraph inherits its bullet from the layout / master).
  */
-declare const getParagraphBullet: (shape: SlideShapeData, paragraphIndex: number) => BulletStyle | null;
+declare const getParagraphBullet: (shape: SlideShapeData | TableCellData, paragraphIndex: number) => BulletStyle | null;
 /**
  * Returns `true` when the paragraph uses an image as its bullet
  * (`<a:pPr><a:buBlip r:embed="…"/>`). Renderers without image
@@ -4316,7 +5625,7 @@ declare const getParagraphBullet: (shape: SlideShapeData, paragraphIndex: number
  * inherits from, which can be cumbersome. Knowing that the bullet
  * *is* an image is usually enough for the UI to pick a fallback.
  */
-declare const isParagraphBulletPicture: (shape: SlideShapeData, paragraphIndex: number) => boolean;
+declare const isParagraphBulletPicture: (shape: SlideShapeData | TableCellData, paragraphIndex: number) => boolean;
 /**
  * Returns the embedded image bytes backing a paragraph's picture bullet
  * (`<a:pPr><a:buBlip><a:blip r:embed="…"/>`), or `null` when the
@@ -4328,7 +5637,7 @@ declare const isParagraphBulletPicture: (shape: SlideShapeData, paragraphIndex:
  * layout/master paragraph isn't followed. The returned `Uint8Array` is a
  * live view into the package media part; treat it as read-only.
  */
-declare const getParagraphBulletImageBytes: (shape: SlideShapeData, paragraphIndex: number) => Uint8Array | null;
+declare const getParagraphBulletImageBytes: (shape: SlideShapeData | TableCellData, paragraphIndex: number) => Uint8Array | null;
 /**
  * Reads the bullet's per-paragraph color, size, and font overrides —
  * `<a:buClr>` (theme-resolved hex), `<a:buSzPct>` / `<a:buSzPts>`
@@ -4338,7 +5647,7 @@ declare const getParagraphBulletImageBytes: (shape: SlideShapeData, paragraphInd
  * when the paragraph doesn't override any of them (the bullet inherits
  * from the run / layout).
  */
-declare const getParagraphBulletStyle: (pres: PresentationData, shape: SlideShapeData, paragraphIndex: number) => {
+declare const getParagraphBulletStyle: (pres: PresentationData, shape: SlideShapeData | TableCellData, paragraphIndex: number) => {
   color: string | null;
   sizePct: number | null;
   sizePts: number | null;
@@ -4349,111 +5658,27 @@ declare const getParagraphBulletStyle: (pres: PresentationData, shape: SlideShap
  * as `setShapeBulletStyle` — pass `'bullet'` / `'number'` / `'none'` or an
  * object like `{ char: '◆' }` / `{ autoNum: 'romanLcPeriod' }`.
  */
-declare const setParagraphBullet: (shape: SlideShapeData, paragraphIndex: number, style: BulletStyle) => void;
+declare const setParagraphBullet: (shape: SlideShapeData | TableCellData, paragraphIndex: number, style: BulletStyle) => void;
 /**
  * Sets the text of a single run. Existing rPr (font, size, color, ...)
  * is preserved — only the visible characters change.
  */
-declare const setShapeRunText: (shape: SlideShapeData, paragraphIndex: number, runIndex: number, text: string) => void;
-//#endregion
-//#region src/api/fn/theme.d.ts
-/**
- * The named color scheme on a presentation's theme. Each slot is a
- * `#RRGGBB` string — `sysClr` slots are flattened to their cached
- * `lastClr` value.
- */
-interface PresentationTheme {
-  readonly name: string;
-  readonly dark1: string;
-  readonly light1: string;
-  readonly dark2: string;
-  readonly light2: string;
-  readonly accent1: string;
-  readonly accent2: string;
-  readonly accent3: string;
-  readonly accent4: string;
-  readonly accent5: string;
-  readonly accent6: string;
-  readonly hyperlink: string;
-  readonly followedHyperlink: string;
-}
-/**
- * Returns the deck's color scheme as `#RRGGBB` strings, or `null` if
- * the package carries no theme. Each accent slot maps directly to the
- * `accent1`–`accent6` chart palette defaults.
- *
- * The deck's theme is the one its first slide master references. A
- * package usually holds more themes than that — notes and handout
- * masters carry their own, and Google Slides exports name the notes
- * theme `theme1.xml` ahead of the slide theme `theme2.xml` — so the
- * slide master relationship decides, not the part name. Multi-master
- * decks surface the first master's theme only; per-master theme lookup
- * will land if a concrete user need shows up.
- */
-declare const getPresentationTheme: (pres: PresentationData) => PresentationTheme | null;
-/**
- * The theme's font scheme, flattened to the typefaces the runs in a
- * deck inherit by default. `major*` is the heading font (slide
- * titles, chart titles); `minor*` is the body font.
- *
- * Each field carries the Latin / East-Asian / Complex-Script
- * typeface name as written on the theme. Empty values are
- * normalized to `null`.
- */
-interface PresentationFonts {
-  readonly majorLatin: string | null;
-  readonly majorEastAsian: string | null;
-  readonly majorComplexScript: string | null;
-  readonly minorLatin: string | null;
-  readonly minorEastAsian: string | null;
-  readonly minorComplexScript: string | null;
-}
-/**
- * Returns the deck theme's font scheme, or `null` when the package
- * carries no theme. As with `getPresentationTheme`, the deck theme is
- * the first slide master's; per-master font lookup will land if needed.
- */
-declare const getPresentationFonts: (pres: PresentationData) => PresentationFonts | null;
-/**
- * Overwrites the named slots of the deck theme's color
- * scheme (`<a:clrScheme>`), leaving every other slot untouched. Slot
- * values are `#RRGGBB` (or 3-digit `#RGB`) strings; every branded
- * `srgbClr`/`sysClr` slot is normalized to a plain `<a:srgbClr>` on
- * write, since a theme slot is never a scheme-color reference.
- *
- * As with `getPresentationTheme`, multi-master decks are branded via
- * their first slide master's theme only.
- *
- * Throws if the presentation has no theme part, or if a provided color
- * isn't a valid `#RRGGBB` string.
- */
-declare const setPresentationTheme: (pres: PresentationData, theme: Partial<Omit<PresentationTheme, "name">> & {
-  name?: string;
-}) => void;
-/**
- * Typeface overrides for {@link setPresentationFonts}. Unlike
- * `PresentationFonts` (the read side, where an empty typeface value
- * flattens to `null`), every field here is a plain string — the
- * underlying `<a:latin>` / `<a:ea>` / `<a:cs>` elements are mandatory on
- * a valid theme, so there's no "clear this typeface" operation.
- */
-interface PresentationFontsInput {
-  readonly majorLatin?: string;
-  readonly majorEastAsian?: string;
-  readonly majorComplexScript?: string;
-  readonly minorLatin?: string;
-  readonly minorEastAsian?: string;
-  readonly minorComplexScript?: string;
-}
+declare const setShapeRunText: (shape: SlideShapeData, paragraphIndex: number, runIndex: number, text: string) => void;
 /**
- * Overwrites the named typefaces of the deck theme's font scheme
- * (major = headings, minor = body), leaving unset fields untouched. As
- * with `setPresentationTheme`, only the first slide master's theme is
- * branded.
- *
- * Throws if the presentation has no theme part.
+ * Update paragraph line-breaking rules and character alignment. Omitted fields
+ * are preserved; null removes the local override so the style can inherit.
  */
-declare const setPresentationFonts: (pres: PresentationData, fonts: PresentationFontsInput) => void;
+declare const setParagraphTypography: (shape: SlideShapeData | TableCellData, paragraphIndex: number, settings: {
+  asianLineBreak?: boolean | null;
+  latinLineBreak?: boolean | null;
+  hangingPunctuation?: boolean | null;
+  fontAlignment?: "auto" | "top" | "center" | "baseline" | "bottom" | null;
+}) => void;
+/** Set custom and automatic tab stops. Null restores inheritance; [] clears custom stops. */
+declare const setParagraphTabs: (shape: SlideShapeData | TableCellData, paragraphIndex: number, settings: {
+  tabStops?: readonly ParagraphTabStop[] | null;
+  defaultTabSizeEmu?: number | null;
+}) => void;
 //#endregion
 //#region src/api/fn/shape-color.d.ts
 /**
@@ -4492,123 +5717,40 @@ declare const resolveDrawingColorOpacity: (colorEl: XmlElement) => number | null
  */
 declare const getShapeRunFormat: (shape: SlideShapeData, paragraphIndex: number, runIndex: number) => ReadTextFormat | null;
 //#endregion
-//#region src/api/fn/shape-paragraph.d.ts
-declare const getShapeRunFormatEffective: (pres: PresentationData, shape: SlideShapeData, paragraphIndex: number, runIndex: number) => ReadTextFormat;
-/** Effective paragraph properties returned by `getParagraphPropertiesEffective`. */
-interface ParagraphProperties {
-  /** Horizontal alignment per `ParagraphAlignment`. */
-  align: ParagraphAlignment | null;
-  /** Outline level (0..8). 0 = top-level paragraph. */
-  level: number;
-  /** Left indent in EMU. */
-  marL: number | null;
-  /** Right indent in EMU. */
-  marR: number | null;
-  /** First-line indent in EMU; negative for hanging indents. */
-  indent: number | null;
-  /** Line spacing — either a percent multiplier or a fixed point value. */
-  lineSpacing: {
-    readonly kind: 'pct';
-    readonly value: number;
-  } | {
-    readonly kind: 'pts';
-    readonly value: number;
-  } | null;
-  /** Space before the paragraph in points. */
-  spcBefPts: number | null;
-  /** Space after the paragraph in points. */
-  spcAftPts: number | null;
-  /** Right-to-left paragraph (`<a:pPr rtl="1"/>`). */
-  rtl: boolean | null;
-  /**
-   * Bullet resolved through the cascade (`<a:buChar>` / `<a:buAutoNum>` /
-   * `<a:buNone>`). Master `bodyStyle` levels author the PowerPoint default
-   * "•", so body placeholders get their bullet from here even when no
-   * slide-level `<a:pPr>` carries one.
-   */
-  bullet: BulletStyle | null;
-}
-/**
- * Resolves a paragraph's effective properties by walking the same
- * inheritance chain `getShapeRunFormatEffective` uses, but for the
- * paragraph-level surface:
- *
- *   - alignment, indent (left / right / first-line), line spacing,
- *     paragraph spacing (before / after), rtl.
- *
- * Each property is resolved independently; the innermost layer that
- * sets it wins. Fields the cascade can't resolve come through as `null`
- * so renderers know to fall back to their own defaults.
- *
- * Companion to `getParagraphAlignment` / `getParagraphLineSpacing` /
- * `getParagraphIndent` / `getParagraphSpacing`, which only surface the
- * literal `<a:pPr>` and skip the layout / master cascade.
- */
-declare const getParagraphPropertiesEffective: (pres: PresentationData, shape: SlideShapeData, paragraphIndex: number) => ParagraphProperties;
-/**
- * Applies `format` to a single run. Run-property attributes not
- * addressed by `format` are preserved — partial updates compose.
- *
- * Example: bold the second word of the first paragraph:
- *
- *   setShapeRunFormat(shape, 0, 1, { bold: true, color: '#FF0000' });
- */
-declare const setShapeRunFormat: (shape: SlideShapeData, paragraphIndex: number, runIndex: number, format: TextFormat) => void;
-/**
- * Reads the external URL the first run in the shape's text-body links
- * to (set via `setShapeHyperlink`). Returns `null` when no run carries
- * an `<a:hlinkClick r:id=…/>` or the rId resolves to a non-hyperlink
- * target.
- */
-declare const getShapeHyperlink: (shape: SlideShapeData) => string | null;
-/**
- * Sets an external hyperlink on every run in the shape's text. Allocates
- * (or reuses) a `hyperlink` relationship on the slide's `.rels`. Pass
- * `null` to clear.
- */
-declare const setShapeHyperlink: (shape: SlideShapeData, url: string | null, tooltip?: string) => void;
-//#endregion
 //#region src/api/fn/shape-removal-zorder.d.ts
 /**
- * Copies a shape into `targetSlide`. The source XML is cloned and
- * appended to the target's `<p:spTree>`. Image rels on the source
- * shape are followed: the linked media part is referenced from the
- * target slide via a freshly allocated rId (no media bytes are
- * copied — both slides share the underlying part).
- *
- * v1 requires source and target to live in the same package
- * (`sourceShape`'s slide and `targetSlide` must share the same
- * `OpcPackage`). Cross-package copy is `importSlide` territory.
- *
- * Returns the new `SlideShapeData` on `targetSlide`.
- */
-declare const copyShape: (targetSlide: SlideData, sourceShape: SlideShapeData) => SlideShapeData;
-/** Move `shape` to the end of its spTree (render in front of all others). */
-declare const bringShapeToFront: (shape: SlideShapeData) => void;
-/**
- * Move `shape` behind every other shape on the slide. The
- * `<p:nvGrpSpPr>` / `<p:grpSpPr>` preface — required by the schema —
- * stays at the top.
+ * Copies a shape into `targetSlide`, including nested shapes and relationships.
+ * Within a presentation, media and other referenced parts remain shared.
+ * Across presentations, dependencies are cloned with collision-free part names,
+ * retaining embedded workbooks, unknown parts and external links.
+ * With `preserveGroupTransform`, a nested source retains its ancestor group
+ * transforms as wrappers, excluding sibling objects. Returns the outermost
+ * copied shape on the target slide.
  */
-declare const sendShapeToBack: (shape: SlideShapeData) => void;
-/** Swap `shape` with the next shape sibling (move one step forward). */
-declare const bringShapeForward: (shape: SlideShapeData) => void;
-/**
- * Returns the shape's z-index among the slide's "real" shape children
+declare const copyShape: (targetSlide: SlideData, sourceShape: SlideShapeData, opts?: {
+  readonly preserveGroupTransform?: boolean;
+}) => SlideShapeData;
+/** Move one shape or a selection in front of all siblings, preserving their stacking order. */
+declare const bringShapeToFront: (shape: SlideShapeData | readonly SlideShapeData[]) => void;
+/** Move one shape or a selection behind all siblings, preserving their stacking order. */
+declare const sendShapeToBack: (shape: SlideShapeData | readonly SlideShapeData[]) => void;
+/** Move one shape or a selection one step forward among siblings. */
+declare const bringShapeForward: (shape: SlideShapeData | readonly SlideShapeData[]) => void;
+/**
+ * Returns the shape's z-index among its parent container's "real" shape children
  * (`<p:sp>` / `<p:pic>` / `<p:cxnSp>` / `<p:graphicFrame>` / `<p:grpSp>`),
  * skipping the required `<p:nvGrpSpPr>` / `<p:grpSpPr>` preface.
  * Higher numbers render in front.
  */
 declare const getShapeZIndex: (shape: SlideShapeData) => number;
 /**
- * Moves the shape to a specific z-index among the slide's "real"
- * shape children. Index is clamped to the available range. Higher
- * numbers render in front. The required preface elements stay at the
- * top of `<p:spTree>`.
+ * Moves a shape or an ordered batch of siblings to a specific z-index.
+ * A batch is inserted contiguously in the supplied order, back to front.
+ * Index is clamped to the available range. Non-shape XML stays in place.
  */
-declare const setShapeZIndex: (shape: SlideShapeData, toIndex: number) => void;
-/** Swap `shape` with the previous shape sibling (move one step backward). */
-declare const sendShapeBackward: (shape: SlideShapeData) => void;
+declare const setShapeZIndex: (shape: SlideShapeData | readonly SlideShapeData[], toIndex: number) => void;
+/** Move one shape or a selection one step backward among siblings. */
+declare const sendShapeBackward: (shape: SlideShapeData | readonly SlideShapeData[]) => void;
 /**
  * Removes the shape from its slide's shape tree. Subsequent property
  * reads on this handle reflect the stale snapshot — discard it after.
@@ -4722,6 +5864,38 @@ declare const addSlideImage: (slide: SlideData, bytes: Uint8Array, opts: {
   fit?: ImageFit;
 }) => SlideShapeData;
 //#endregion
+//#region src/api/fn/layout-edit.d.ts
+/**
+ * Renames the layout. This is the name PowerPoint shows in the
+ * "New Slide" gallery and in the layout pane, so it is what an author
+ * picks a layout by — it is not an identifier, and nothing references
+ * it.
+ */
+declare const setSlideLayoutName: (layout: SlideLayoutData, name: string) => void;
+/**
+ * Gives the layout a solid background, replacing whatever it had.
+ * Every slide on this layout that does not set a background of its own
+ * follows.
+ *
+ * `color` takes the same forms as `setSlideBackground`: `#RRGGBB` or
+ * `scheme:accent1`.
+ */
+declare const setSlideLayoutBackground: (layout: SlideLayoutData, color: string) => void;
+/**
+ * Drops the layout's own background so it inherits the master's again.
+ */
+declare const clearSlideLayoutBackground: (layout: SlideLayoutData) => void;
+/**
+ * Moves and resizes one of the layout's placeholder slots, identified by
+ * its position in `getSlideLayoutPlaceholders`.
+ *
+ * Slides inherit the new box wherever they have not pushed the
+ * placeholder around themselves: a slide placeholder carrying its own
+ * `<a:xfrm>` keeps it, exactly as PowerPoint behaves when you edit a
+ * layout under slides that were already nudged.
+ */
+declare const setSlideLayoutPlaceholderBounds: (layout: SlideLayoutData, index: number, bounds: ShapeBounds) => void;
+//#endregion
 //#region src/api/fn/layouts.d.ts
 /** PowerPoint's user-visible layout name. */
 declare const getSlideLayoutName: (layout: SlideLayoutData) => string;
@@ -5198,11 +6372,24 @@ declare const getAllShapes: (pres: PresentationData) => ReadonlyArray<AllShapesE
  * but keeps them in the editing surface.
  */
 declare const isSlideHidden: (slide: SlideData) => boolean;
+/** Whether inherited master and layout decoration is hidden on this slide. */
+declare const isSlideBackgroundGraphicsHidden: (slide: SlideData) => boolean;
+/** Whether a layout suppresses its master's decoration, keeping its own shapes. */
+declare const isSlideLayoutBackgroundGraphicsHidden: (layout: SlideLayoutData) => boolean;
+/**
+ * Hide inherited decoration without removing shapes or changing background fills.
+ * PowerPoint's Hide Background Graphics suppresses layout decoration as well as
+ * master shapes, despite the attribute's name. Slide placeholders remain visible.
+ */
+declare const setSlideBackgroundGraphicsHidden: (slide: SlideData, hidden: boolean) => void;
 /**
- * Returns `true` when the slide carries a `<p:timing>` block — i.e.,
- * has at least one authored animation effect. Per-slide complement to
- * `getPresentationSummary().hasAnimations`, which only reports a
- * deck-wide flag.
+ * Returns `true` when the slide has at least one authored animation effect.
+ * Per-slide complement to `getPresentationSummary().hasAnimations`, which only
+ * reports a deck-wide flag.
+ *
+ * A slide holding only a video / audio clip also carries a `<p:timing>` block
+ * — that is where the clip's play controls live — so the element's presence
+ * alone is not an animation.
  */
 declare const slideHasAnimations: (slide: SlideData) => boolean;
 /**
@@ -5219,7 +6406,10 @@ declare const replaceTokensInPresentation: (pres: PresentationData, tokens: Reco
 /**
  * Replaces every occurrence of `from` in every slide's text with `to`.
  * `from` may be a string (treated as a literal) or a `RegExp`. Returns
- * the number of `<a:t>` elements mutated across the whole deck.
+ * the number of `<a:t>` elements mutated across the whole deck. Matches can
+ * span formatting runs within a paragraph, but not explicit line breaks.
+ * Inserted text inherits the first matched run’s formatting. `to` follows
+ * JavaScript replacement-string rules (`$$`, `$&`, capture groups).
  *
  * Use this for the broad "rename product X to Y" pattern; for
  * `{{token}}` style substitutions, prefer
@@ -5228,20 +6418,29 @@ declare const replaceTokensInPresentation: (pres: PresentationData, tokens: Reco
 declare const replaceTextInPresentation: (pres: PresentationData, from: string | RegExp, to: string) => number;
 /**
  * Replaces every occurrence of `from` in the slide's text with `to`.
- * Returns the number of `<a:t>` elements mutated on this slide.
+ * Matches span adjacent formatting runs, bounded by paragraphs and explicit
+ * line breaks. Inserted text inherits the first matched run’s formatting;
+ * `to` follows JavaScript replacement-string rules. Returns the number of
+ * `<a:t>` elements mutated on this slide.
  */
 declare const replaceTextInSlide: (slide: SlideData, from: string | RegExp, to: string) => number;
 //#endregion
-//#region src/api/fn/slide-deck.d.ts
+//#region src/api/fn/custom-shows.d.ts
+/** A named slide sequence. Repeated slides and empty sequences are supported. */
+interface CustomShow {
+  readonly id: number;
+  readonly name: string;
+  readonly slides: readonly SlideData[];
+}
+/** Reads custom shows in list order. Missing slide references are omitted. */
+declare function getCustomShows(pres: PresentationData): CustomShow[];
 /**
- * Adds a new slide bound to `layout`. Returns the new `SlideData`.
- *
- * Allocates a fresh part name, sldId, and rId; clones layout
- * placeholders into the slide; writes `[Content_Types].xml`, the
- * slide's `.rels`, presentation's `.rels`, and `<p:sldIdLst>`. The
- * deck-cache on `pres` is invalidated so the next `getSlides` call
- * sees the new entry.
+ * Replaces the custom-show list atomically, retaining metadata on surviving IDs.
+ * Slide handles must belong to this presentation. IDs are stable unsigned integers.
  */
+declare function setCustomShows(pres: PresentationData, shows: readonly CustomShow[]): void;
+//#endregion
+//#region src/api/fn/slide-deck.d.ts
 /**
  * Convenience over `addSlide` that picks a layout automatically:
  *
@@ -5280,12 +6479,23 @@ declare const addSectionHeaderSlide: (pres: PresentationData, title: string) =>
  * Throws when the package carries no layouts at all.
  */
 declare const addTitleSlide: (pres: PresentationData, title: string) => SlideData;
+/**
+ * Adds a new slide bound to `layout`. Returns the new `SlideData`.
+ *
+ * Allocates a fresh part name, sldId, and rId; clones layout
+ * placeholders into the slide; writes `[Content_Types].xml`, the
+ * slide's `.rels`, presentation's `.rels`, and `<p:sldIdLst>`. The
+ * deck cache is updated while existing slide handles remain valid.
+ * The layout must belong to this presentation.
+ */
 declare const addSlide: (pres: PresentationData, options: {
   layout: SlideLayoutData;
 }) => SlideData;
 /**
  * Removes the given slide from the deck. Removes the `<p:sldId>`, the
  * `presentation.xml.rels` entry, and the slide part + its `.rels` part.
+ * Links to this slide from other slides are cleared to prevent accidental
+ * retargeting when a slide part name is reused.
  *
  * Media parts are intentionally NOT cleaned up — they may be shared
  * with other slides. The freed `sldId` is NOT reused on subsequent
@@ -5329,39 +6539,35 @@ declare const moveSlide: (pres: PresentationData, slide: SlideData, toIndex: num
  */
 declare const duplicateSlide: (pres: PresentationData, slide: SlideData) => SlideData;
 /**
- * Convenience over `addSlide` + `moveSlide`. Inserts the new slide
- * at the given 0-based index (clamped to `[0, getSlides(pres).length]`).
+ * Inserts slides at a 0-based index, clamped to the presentation bounds.
+ * A list of layout options inserts a contiguous batch in the same order,
+ * allocating IDs and updating shared package parts once. Existing slide handles
+ * remain valid. All layouts must belong to the target presentation.
  */
-declare const addSlideAt: (pres: PresentationData, atIndex: number, options: {
+declare function addSlideAt(pres: PresentationData, atIndex: number, options: ReadonlyArray<{
   layout: SlideLayoutData;
-}) => SlideData;
+}>): SlideData[];
+declare function addSlideAt(pres: PresentationData, atIndex: number, options: {
+  layout: SlideLayoutData;
+}): SlideData;
 /**
  * Convenience over `duplicateSlide` + `moveSlide`. Duplicates `slide`
  * and inserts the duplicate at `atIndex` instead of at the end.
  */
 declare const duplicateSlideAt: (pres: PresentationData, atIndex: number, slide: SlideData) => SlideData;
 /**
- * Imports a slide from another presentation into `targetPres`. The
- * slide's part bytes are copied verbatim; image rels are followed and
- * the linked media is copied into the target package with fresh part
- * names. The new slide is bound to the supplied `targetLayout` so it
- * still renders without the original deck's layouts.
- *
- * Limitations (v1):
- *
- *   - Only image / video / audio rels are copied across. Other rels (charts,
- *     embedded workbooks, oleObjects, comments) are dropped from the imported
- *     slide. A diagnostic message is appended for each dropped rel.
- *   - Hyperlinks (external URLs) are preserved.
- *   - Slide → notesSlide is dropped (notes don't follow imports).
- *
- * Returns the new `SlideData` appended to `targetPres`.
+ * Imports a slide into `targetPres`. When `targetLayout` is supplied, rebinds
+ * the slide to it. Otherwise preserves the source layout, master and theme.
+ * Copies the complete relationship graph, including charts, workbooks, notes,
+ * media and unknown extension parts. Shared dependencies and cycles retain
+ * their relationships; external hyperlinks are preserved. Missing dependencies
+ * fail before writing any imported parts.
+ * Returns the new slide appended to the target presentation.
  */
-declare const importSlide: (targetPres: PresentationData, sourceSlide: SlideData, targetLayout: SlideLayoutData) => SlideData;
+declare const importSlide: (targetPres: PresentationData, sourceSlide: SlideData, targetLayout?: SlideLayoutData) => SlideData;
 /**
  * Appends every slide from `sourcePres` into `targetPres`, in source
- * order. Built on top of `importSlide`: media is propagated, charts
- * are dropped (not yet supported across decks), and the slide's
+ * order. Built on top of `importSlide`: dependencies are preserved, and the slide's
  * layout is rebound to `targetLayout` on the target side.
  *
  * `targetLayout` can be a single layout used for every imported
@@ -5372,38 +6578,177 @@ declare const importSlide: (targetPres: PresentationData, sourceSlide: SlideData
  */
 declare const mergePresentations: (targetPres: PresentationData, sourcePres: PresentationData, targetLayout: SlideLayoutData | ((sourceSlide: SlideData, index: number) => SlideLayoutData)) => ReadonlyArray<SlideData>;
 //#endregion
+//#region src/api/fn/slide-placeholder-geometry.d.ts
+/**
+ * Restore top-level placeholders' position, size, rotation and flips from the
+ * current layout (or its master when the layout inherits its geometry).
+ * Text, formatting, IDs, relationships and other shapes are preserved. Slots
+ * without matching layout geometry are left intact; deleted placeholders are
+ * not recreated.
+ *
+ * A placeholder inside a group is left where it is. The layout states a
+ * rectangle on the slide, while a grouped shape's own geometry is written in
+ * its group's coordinate space — so restoring it would mean either tearing the
+ * shape out of the arrangement it was grouped into, or inventing a rectangle
+ * the layout never described. Its formatting and appearance are still reset by
+ * the two functions below.
+ *
+ * Returns the number of placeholders restored.
+ */
+declare const resetSlidePlaceholderGeometry: (slide: SlideData) => number;
+/**
+ * Restore missing slide placeholders using the current layout.
+ * Existing content, geometry and formatting are untouched, including grouped
+ * placeholders. New slots inherit their layout's geometry and text style;
+ * layout prompt text and layout-only relationships are not copied.
+ * Returns the number of added placeholders. Repeated calls do not add duplicates.
+ */
+declare const addMissingSlidePlaceholders: (slide: SlideData) => number;
+/**
+ * Adds the single placeholder of `type` that the layout defines and the slide
+ * is missing — how an editor inserts a slide number, date or footer into a
+ * slide without also restoring every other slot the author deleted.
+ *
+ * `type` is an ECMA-376 `ST_PlaceholderType` token (`sldNum`, `dt`, `ftr`,
+ * `title`, `body`, …), matched as `findSlidePlaceholder` matches it. Returns
+ * the slide's placeholder of that type — the one just added or the one already
+ * there — or `null` when the layout reserves no such slot. Like the added slots
+ * of `addMissingSlidePlaceholders`, it starts empty and inherits its geometry
+ * and text style from the layout and master.
+ * Pass `source: 'master'` to create an unmatched slot that inherits directly
+ * from the master, without changing the layout (as PowerPoint does when
+ * demoting outline text into a Title Only slide). Returns null if absent there.
+ */
+declare const addSlidePlaceholder: (slide: SlideData, type: PlaceholderType, options?: {
+  source?: "layout" | "master";
+}) => SlideShapeData | null;
+/**
+ * Restore inherited text formatting on placeholders bound to the current
+ * layout, including placeholders inside a group. Clears direct run, paragraph
+ * and text-body appearance while preserving text, fields, hyperlinks,
+ * language, outline levels and unknown extensions. Geometry and shape
+ * appearance remain unchanged.
+ * Returns the number of matching text placeholders processed.
+ */
+declare const resetSlidePlaceholderTextFormatting: (slide: SlideData) => number;
+/**
+ * Reset the current slide's layout: restore deleted slots, reset top-level
+ * placeholder geometry and clear direct shape/text appearance to inherit the
+ * layout again. Content, picture crops, relationships, IDs and unrelated shapes
+ * remain intact.
+ *
+ * A placeholder inside a group has its appearance and text formatting reset
+ * like any other, but keeps its geometry: where it sits is a statement about
+ * the group's arrangement, and the layout has nothing to say about that.
+ *
+ * Returns the number of layout placeholders processed, including new slots.
+ */
+declare const resetSlideLayout: (slide: SlideData) => number;
+//#endregion
+//#region src/api/fn/shape-locks.d.ts
+/** Whether the object's movement and resizing are both locked, as in PowerPoint's Selection Pane. */
+declare const isShapeLocked: (shape: SlideShapeData) => boolean;
+/** Whether PowerPoint preserves this object's aspect ratio while resizing it. */
+declare const isShapeAspectRatioLocked: (shape: SlideShapeData) => boolean;
+/**
+ * Locks or unlocks object geometry like PowerPoint's Selection Pane. Text,
+ * selection, aspect-ratio constraints and extension data remain unchanged.
+ * Group children keep their own locks; pass all descendants for Lock All.
+ * Arrays are committed once per slide, including selections across slides.
+ */
+declare const setShapeLocked: (shapes: SlideShapeData | readonly SlideShapeData[], locked: boolean) => void;
+/**
+ * Sets the DrawingML `noChangeAspect` constraint without disturbing other
+ * nonvisual properties. An absent constraint and an explicit false value both
+ * read as unlocked; disabling the constraint removes only this attribute.
+ */
+declare const setShapeAspectRatioLocked: (shapes: SlideShapeData | readonly SlideShapeData[], locked: boolean) => void;
+//#endregion
+//#region src/api/fn/shape-custom-geometry.d.ts
+/** One path to write; `fill` defaults to `'norm'` and `stroke` to `true`, as in the schema. */
+interface CustomGeometryPathInput {
+  /** Path coordinate-space width and height (`ST_PositiveCoordinate`). */
+  readonly w: number;
+  readonly h: number;
+  readonly fill?: PathFillMode;
+  readonly stroke?: boolean;
+  readonly commands: readonly GeomCommand[];
+}
+interface CustomGeometryInput {
+  readonly paths: readonly CustomGeometryPathInput[];
+}
+/**
+ * Replaces the shape's geometry (preset or custom) with the given paths. The
+ * text rectangle is the whole shape, as PowerPoint writes for freeforms.
+ * Coordinates are rounded to integers, which the schema requires.
+ */
+declare const setShapeCustomGeometry: (shape: SlideShapeData, geometry: CustomGeometryInput) => void;
+//#endregion
+//#region src/api/fn/shape-text-language.d.ts
+/** Marks every run in the shape's text (and the end-of-paragraph marks) as `lang`, e.g. `en-US`. */
+declare const setShapeTextLanguage: (shape: SlideShapeData, lang: string) => void;
+/** The language of the shape's first run that names one, or `null`. */
+declare const getShapeTextLanguage: (shape: SlideShapeData) => string | null;
+//#endregion
+//#region src/api/fn/shape-style.d.ts
+/** One DrawingML style-list reference used by a shape quick style. */
+interface ShapeStyleReference {
+  /** 0 clears the reference; positive values index the theme format scheme. */
+  readonly idx: number;
+  /** Theme slot or sRGB color replacing the style list's `phClr`. */
+  readonly color?: Color;
+  /** Ordered DrawingML color transforms (for example PowerPoint's shade). */
+  readonly colorTransforms?: readonly ColorTransform[];
+}
+interface ShapeStyleFontReference {
+  readonly idx: 'major' | 'minor' | 'none';
+  readonly color?: Color;
+  readonly colorTransforms?: readonly ColorTransform[];
+}
+/** Complete OOXML shape style. Direct text runs and geometry are untouched. */
+interface ShapeStyleOptions {
+  readonly line: ShapeStyleReference;
+  readonly fill: ShapeStyleReference;
+  readonly effect: ShapeStyleReference;
+  readonly font: ShapeStyleFontReference;
+}
+/** Apply a complete native OOXML shape style while preserving geometry/text. */
+declare const setShapeStyle: (shape: SlideShapeData, options: ShapeStyleOptions) => void;
+//#endregion
 //#region src/api/fn/shape-grouping.d.ts
 /**
- * Groups two or more top-level shapes into a single `<p:grpSp>`,
+ * Groups two or more sibling shapes into a single `<p:grpSp>`,
  * returning the new group as a `SlideShapeData`. The group's
- * slide-space bounds are the union of its members' bounds; the members
+ * parent-space bounds are the union of its members' bounds; the members
  * keep their own relative position/size (nothing is rescaled). The
  * target slide is taken from the first shape — every shape must belong
  * to the same slide.
  *
  * Every shape must:
  *   - belong to the same slide as the others,
- *   - be a direct child of the slide's shape tree (not already nested
- *     inside another group — ungroup first, then re-group),
+ *   - share the same immediate parent (the slide or a group),
  *   - have an explicit `<a:xfrm>` (placeholders that inherit position
  *     from the layout have none and can't be grouped),
  *   - appear at most once in `shapes` (grouping the same shape twice
  *     would duplicate its id).
  *
  * The group replaces its members at the position of the earliest one in
- * z-order, so grouping doesn't change how the selection stacks against
- * shapes that weren't part of it.
+ * z-order, preserving member order regardless of selection order. Members
+ * become one contiguous block, which can change interleaving with unselected shapes.
  */
 declare const groupShapes: (shapes: ReadonlyArray<SlideShapeData>, opts?: {
   name?: string;
 }) => SlideShapeData;
 /**
  * Reverses `groupShapes`: removes the `<p:grpSp>` and re-inserts its
- * immediate children as top-level shapes at the group's former position,
+ * immediate children into its parent at the group's former position,
  * rescaling each child's own transform so it keeps its on-slide position
  * and size (matters when the group was moved/resized after creation, so
  * its `off`/`ext` diverged from its `chOff`/`chExt`). Returns the
  * children as fresh `SlideShapeData` handles, in their original order.
+ * Group rotation and flips are composed with each child transform. Exact
+ * preservation of rotated children requires uniform group scaling; anisotropic
+ * scaling can introduce shear, which a child shape transform cannot represent.
  *
  * Throws if `group` isn't a group shape, or its `<p:grpSpPr>` carries no
  * `<a:xfrm>` (malformed — every authored group has one).
@@ -5467,6 +6812,162 @@ declare const addSlideMedia: (slide: SlideData, opts: SlideMediaOptions) => Slid
 declare const getShapeMedia: (shape: SlideShapeData) => ShapeMedia | null;
 /** Every shape on the slide that `getShapeMedia` reports a clip for. */
 declare const findShapesWithMedia: (slide: SlideData) => ReadonlyArray<SlideShapeData>;
+/** Durations removed from the source clip, in milliseconds. */
+interface MediaTrim {
+  readonly startMs: number;
+  /** Duration removed from the end of the source clip. */
+  readonly endMs: number;
+}
+interface MediaFade {
+  readonly inMs: number;
+  readonly outMs: number;
+}
+/** A named position in an embedded media clip, measured from its beginning. */
+interface MediaBookmark {
+  readonly name: string;
+  readonly timeMs: number;
+}
+/**
+ * How a clip plays in the slide show — the attributes of its
+ * `<p:cMediaNode>` and the start condition of its time node.
+ *
+ * Trimming and fades are stored in the PowerPoint 2010 `p14:media` extension.
+ * `trim.endMs` is the duration removed from the end of the clip, matching the
+ * OOXML `p14:trim@end` meaning (it is not the playback end position).
+ */
+interface MediaPlayback {
+  /** Starts with the slide instead of waiting for a click. */
+  readonly autoplay: boolean;
+  /** Milliseconds to wait after the slide starts before automatic playback. */
+  readonly delayMs?: number;
+  /** Plays again from the beginning until the slide moves on. */
+  readonly loop: boolean;
+  /** Playback volume, 0–1. PowerPoint's own default is 0.8. */
+  readonly volume: number;
+  readonly muted: boolean;
+  /** Video only: plays filling the screen. */
+  readonly fullScreen: boolean;
+  /** Hides the clip once it has played (`showWhenStopped="0"`). */
+  readonly hideWhenStopped: boolean;
+  /** Number of slides across which the clip should keep playing (`numSld`).
+   * When absent, OOXML defaults to one slide. */
+  readonly slideCount?: number;
+  /** Returns playback to the beginning after natural completion (`fill="remove"`). */
+  readonly rewindAfterPlaying?: boolean;
+  readonly trim?: MediaTrim;
+  readonly fade?: MediaFade;
+  /** Named positions in the clip, in the order stored in the media extension. */
+  readonly bookmarks?: readonly MediaBookmark[];
+}
+/**
+ * Reads how the shape's clip plays, or `null` when the shape carries no media
+ * time node — which is what a picture that is not a clip looks like, and also
+ * what a clip pasted in without its node looks like (it shows no controls).
+ */
+declare const getShapeMediaPlayback: (shape: SlideShapeData) => MediaPlayback | null;
+/**
+ * Updates how the shape's clip plays. Omitted properties keep their current
+ * value. Throws when the shape has no media time node — `addSlideMedia` writes
+ * one, and a picture that is not a clip never plays.
+ *
+ * `delayMs` is a nonnegative safe integer and requires automatic playback.
+ * Setting `autoplay: true` alone preserves an existing automatic delay;
+ * switching from event playback starts immediately unless `delayMs` is supplied.
+ *
+ * `fullScreen` is a video attribute (`CT_TLMediaNodeVideo`); asking for it on
+ * an audio clip throws rather than writing an attribute the schema rejects.
+ */
+declare const setShapeMediaPlayback: (shape: SlideShapeData, options: Partial<MediaPlayback>) => void;
+//#endregion
+//#region src/api/fn/shape-video.d.ts
+/**
+ * Restores a video to PowerPoint's default shape formatting.
+ *
+ * This is deliberately restricted to video media pictures. It clears the
+ * image recolor/correction elements and the shape-level fill, line, effects,
+ * and 3-D style children, while preserving the poster/media relationship,
+ * crop, transform, and unknown extension XML.
+ */
+declare const resetShapeVideoFormatting: (shape: SlideShapeData) => void;
+//#endregion
+//#region src/api/fn/slide-animation-edit.d.ts
+/**
+ * What to change about an effect. Every field is optional; the ones left out
+ * keep what the slide already says.
+ *
+ * `byParagraph` is not an attribute flip: turning it on replaces the effect
+ * with one per paragraph of the shape's text, and turning it off replaces the
+ * whole build with a single effect on the shape. In both directions the id you
+ * passed stays on the effect that takes the original's place in the click
+ * order, and the other effects of a build are new — so a caller holding several
+ * handles into one build keeps only the one it addressed.
+ */
+interface AnimationPatch {
+  readonly effect?: AnimationEffect;
+  /**
+   * Which edge a fly comes from or leaves by. Changing it rewrites the effect
+   * the same way changing the preset does, because the direction is part of
+   * what the preset says. Passing it for an effect that does not fly is an
+   * error — including one this patch is turning into such an effect.
+   */
+  readonly direction?: AnimationDirection;
+  readonly durationMs?: number;
+  readonly start?: AnimationStartCondition;
+  readonly delayMs?: number;
+  readonly byParagraph?: boolean;
+}
+/**
+ * Changes one effect: its preset, how long it runs, when it starts, and whether
+ * the shape's text is revealed a paragraph at a time.
+ *
+ * The effect keeps the id it was addressed by. Everything after it in the click
+ * order is laid out again, because a longer effect moves what follows it and a
+ * new start condition moves the effect itself between click stops.
+ *
+ * An effect whose duration the slide never stated gets this library's default
+ * when it is rewritten; pass `durationMs` to say what it should be.
+ */
+declare const updateSlideAnimation: (slide: SlideData, id: number, patch: AnimationPatch) => void;
+/**
+ * Removes one effect. The effects after it move one place earlier in the click
+ * order and are retimed to match.
+ *
+ * A paragraph of a build is removed on its own: the build entry the rest of the
+ * paragraphs share stays, and goes only once the last of them is gone.
+ */
+declare const removeSlideAnimation: (slide: SlideData, id: number) => void;
+/**
+ * Moves one effect to `index` in the click order, counting only the slide's
+ * main sequence — the order `getSlideAnimations` reports for steps whose
+ * `sequence` is `'mainSeq'`.
+ *
+ * Each effect keeps the start condition it had, so moving a `'withPrevious'`
+ * effect to the front does not turn it into a click: it becomes the first thing
+ * that runs as the slide appears, which is what it already meant.
+ */
+declare const moveSlideAnimation: (slide: SlideData, id: number, index: number) => void;
+//#endregion
+//#region src/api/fn/_image-fill-layout.d.ts
+type ImageTileAlignment = 'tl' | 't' | 'tr' | 'l' | 'ctr' | 'r' | 'bl' | 'b' | 'br';
+type ImageTileFlip = 'none' | 'x' | 'y' | 'xy';
+/** Image placement inside its fill area; percentages use fractions (0.25 = 25%). */
+type ImageFillLayout = {
+  /** Omitted on write preserves the existing rotation setting. */rotateWithShape?: boolean;
+} & ({
+  mode: 'stretch';
+  left?: number;
+  top?: number;
+  right?: number;
+  bottom?: number;
+} | {
+  mode: 'tile';
+  offsetX?: Emu;
+  offsetY?: Emu;
+  scaleX?: number;
+  scaleY?: number;
+  alignment?: ImageTileAlignment;
+  flip?: ImageTileFlip;
+});
 //#endregion
 //#region src/api/fn/slide-background.d.ts
 /**
@@ -5478,6 +6979,7 @@ declare const findShapesWithMedia: (slide: SlideData) => ReadonlyArray<SlideShap
 type SlideBackground = {
   readonly kind: 'solid';
   readonly color: string;
+  readonly opacity?: number;
 } | {
   readonly kind: 'gradient';
 } | {
@@ -5564,7 +7066,9 @@ declare const getSlideMasterShapes: (pres: PresentationData, layout: SlideLayout
  * `<p:bgPr><a:pattFill>`. Same shape as `getSlideBackgroundPatternFill`
  * for slides.
  */
-declare const getSlideLayoutBackgroundPatternFill: (pres: PresentationData, layout: SlideLayoutData) => {
+declare const getSlideLayoutBackgroundPatternFill: (pres: PresentationData, layout: SlideLayoutData, options?: {
+  readonly preserveTheme?: boolean;
+}) => {
   preset: string;
   foreground: string;
   background: string;
@@ -5573,15 +7077,18 @@ declare const getSlideLayoutBackgroundPatternFill: (pres: PresentationData, layo
  * Reads the slide master's pattern background. Companion to
  * `getSlideLayoutBackgroundPatternFill`.
  */
-declare const getSlideMasterBackgroundPatternFill: (pres: PresentationData, layout: SlideLayoutData) => {
+declare const getSlideMasterBackgroundPatternFill: (pres: PresentationData, layout: SlideLayoutData, options?: {
+  readonly preserveTheme?: boolean;
+}) => {
   preset: string;
   foreground: string;
   background: string;
 } | null;
 /**
- * Reads the slide layout's gradient background when its `<p:bg>` is a
- * `<p:bgPr><a:gradFill>`. Same shape as `getSlideBackgroundGradientFill`
- * for slides.
+ * Reads the slide layout's gradient background from either `<p:bgPr><a:gradFill>`
+ * or a theme style referenced by `<p:bgRef>`. Same shape as `getSlideBackgroundGradientFill`
+ * for slides. Stop `resolvedColor` values include the presentation theme
+ * and DrawingML color transforms.
  */
 declare const getSlideLayoutBackgroundGradientFill: (layout: SlideLayoutData) => ReadGradientFill | null;
 /**
@@ -5590,6 +7097,7 @@ declare const getSlideLayoutBackgroundGradientFill: (layout: SlideLayoutData) =>
  * background kind. Useful for closing the bg cascade — slides that
  * report `'gradient'` inherit can now get the master's gradient
  * projected via `gradientDef`.
+ * Stop `resolvedColor` values include the presentation theme and color transforms.
  */
 declare const getSlideMasterBackgroundGradientFill: (pres: PresentationData, layout: SlideLayoutData) => ReadGradientFill | null;
 /**
@@ -5606,9 +7114,12 @@ declare const getSlideMasterBackground: (pres: PresentationData, layout: SlideLa
 declare const getSlideLayoutBackground: (layout: SlideLayoutData) => SlideBackground;
 /**
  * Returns the gradient stops + path when the slide carries a
- * `<p:bgPr><a:gradFill>` background. Returns `null` for any other
+ * literal `<p:bgPr><a:gradFill>` or theme-referenced `<p:bgRef>` gradient.
+ * Returns `null` for any other
  * background kind. Shape identical to `getShapeGradientFill` so renderers
  * can use the same projection logic for slide backgrounds.
+ * Stop `resolvedColor` values include the presentation theme, slide color map
+ * and DrawingML color transforms; `color` retains the authored token.
  */
 declare const getSlideBackgroundGradientFill: (slide: SlideData) => ReadGradientFill | null;
 /**
@@ -5616,7 +7127,9 @@ declare const getSlideBackgroundGradientFill: (slide: SlideData) => ReadGradient
  * carries a `<p:bgPr><a:pattFill>` background. Returns `null` for any
  * other background kind. Shape mirrors `getShapePatternFill`.
  */
-declare const getSlideBackgroundPatternFill: (pres: PresentationData, slide: SlideData) => {
+declare const getSlideBackgroundPatternFill: (pres: PresentationData, slide: SlideData, options?: {
+  readonly preserveTheme?: boolean;
+}) => {
   preset: string;
   foreground: string;
   background: string;
@@ -5643,8 +7156,58 @@ declare const getSlideLayoutBackgroundImageBytes: (pres: PresentationData, layou
  * master rel). Companion to `getSlideLayoutBackgroundImageBytes`.
  */
 declare const getSlideMasterBackgroundImageBytes: (pres: PresentationData, layout: SlideLayoutData) => Uint8Array | null;
-/** Sets a solid fill on the slide's background. */
-declare const setSlideBackground: (slide: SlideData, color: Color) => void;
+/** Sets a solid background; optional opacity is 0 (transparent) to 1 (opaque). */
+declare const setSlideBackground: (slide: SlideData, color: Color, opacity?: number) => void;
+/**
+ * Replaces the slide background with a gradient. Uses the same stop and direction
+ * settings as `setShapeGradientFill`; offsets and opacity range from 0 to 1.
+ * Invalid settings leave the previous background unchanged.
+ */
+declare const setSlideBackgroundGradientFill: (slide: SlideData, options: GradientFillOptions) => void;
+/** Natural background image size in EMUs, using fill DPI and embedded PNG/JPEG resolution.
+ * Reads inherited backgrounds. Returns null for missing or unsupported image bytes.
+ */
+declare const getSlideBackgroundImageIntrinsicSize: (slide: SlideData) => {
+  width: Emu;
+  height: Emu;
+} | null;
+/** Reads direct or inherited background image crop fractions, including negative outsets.
+ * Returns null when no source rectangle is specified or the background is not an image.
+ */
+declare const getSlideBackgroundImageCrop: (slide: SlideData) => ImageCrop | null;
+/** Reads direct or inherited image background placement; returns null for other fills. */
+declare const getSlideBackgroundImageFillLayout: (slide: SlideData) => ImageFillLayout | null;
+/**
+ * Changes background image placement while preserving media, crop and effects.
+ * An inherited image becomes a slide override, leaving its layout/master unchanged.
+ * Invalid settings or missing relationships leave the presentation unchanged.
+ */
+declare const setSlideBackgroundImageFillLayout: (slide: SlideData, layout: ImageFillLayout) => void;
+/** Reads direct or inherited background picture opacity; null means no explicit opacity. */
+declare const getSlideBackgroundImageOpacity: (slide: SlideData) => number | null;
+/** Sets background image opacity (0–1), preserving media and placement. Null restores the default.
+ * Inherited images become slide overrides. Invalid values leave the deck unchanged.
+ */
+declare const setSlideBackgroundImageOpacity: (slide: SlideData, opacity: number | null) => void;
+/**
+ * Updates a slide pattern background, preserving unspecified colors and transforms.
+ * Inherited patterns become a slide override; the layout and master stay unchanged.
+ * A new pattern uses Mac PowerPoint's defaults: pct5, accent1 foreground, bg1 background.
+ */
+declare const setSlideBackgroundPatternFill: (slide: SlideData, options: Partial<PatternFillOptions>) => void;
+/**
+ * Copies the source's effective background into a target slide, retaining its XML
+ * and referenced parts. Inherited fills become explicit on the target. Theme
+ * references use the target's theme; background graphics visibility is unchanged.
+ * Across presentations, dependencies are copied with collision-free names.
+ */
+declare const copySlideBackground: (targetSlide: SlideData, sourceSlide: SlideData) => void;
+/**
+ * Applies the source slide's effective background throughout its presentation.
+ * Like Mac PowerPoint, stores the fill on masters and clears slide/layout overrides.
+ * Theme colors and image relationships are preserved without flattening the fill.
+ */
+declare const applySlideBackgroundToAll: (pres: PresentationData, slide: SlideData) => void;
 /**
  * Sets a picture as the slide's background. Embeds `bytes` as a new
  * media part, wires a slide → image rel, and replaces any prior
@@ -5660,10 +7223,34 @@ declare const setSlideBackgroundImage: (slide: SlideData, bytes: Uint8Array, opt
 /** Clears any explicit slide background, restoring layout inheritance. */
 declare const clearSlideBackground: (slide: SlideData) => void;
 //#endregion
+//#region src/api/fn/master-background-style.d.ts
+/**
+ * Choose one of PowerPoint's twelve Background Styles (numbered row by row).
+ * Changes the owning master, so every slide using that master inherits the
+ * style. Existing slide and layout background overrides remain in place.
+ * The theme must provide the referenced background fill style.
+ */
+declare const setSlideMasterBackgroundStyle: (slide: SlideData, style: number) => void;
+/** A theme background preset; complex fill kinds without a gradient retain their kind. */
+interface SlideMasterBackgroundStyle {
+  readonly style: number;
+  readonly selected: boolean;
+  readonly fill: SlideBackground;
+  readonly gradient: ReadGradientFill | null;
+}
+/**
+ * Read the owning master's available Background Styles without changing the
+ * presentation. Solid colors and gradient stop resolvedColor values include
+ * the preset's color mapping and theme transforms. Missing theme rows are omitted.
+ * Selection describes the master, independently of slide/layout overrides.
+ */
+declare const getSlideMasterBackgroundStyles: (slide: SlideData) => SlideMasterBackgroundStyle[];
+//#endregion
 //#region src/api/fn/color-map.d.ts
 /**
  * The slide's effective color map: the master's `<p:clrMap>`, overlaid by a
- * per-slide `<p:clrMapOvr><a:overrideClrMapping>` when present. Falls back to
+ * layout or slide `<p:clrMapOvr><a:overrideClrMapping>` when present. An explicit
+ * slide `masterClrMapping` bypasses the layout override. Falls back to
  * the standard map for decks that omit it.
  *
  * Pass the result to color resolution / renderers so `schemeClr` tokens map to
@@ -5691,17 +7278,84 @@ declare const resolveDeckBodyTextColor: (slide: SlideData) => string | null;
  * `setSlideTransition` accepts.
  */
 declare const getSlideTransition: (slide: SlideData) => SlideTransition | null;
-/** Sets the slide's transition effect. */
+/**
+ * Sets the slide's transition effect. A sound set with
+ * `setSlideTransitionSound` is kept, as PowerPoint keeps it when the effect
+ * changes.
+ */
 declare const setSlideTransition: (slide: SlideData, options: TransitionOptions) => void;
-/** Removes any existing transition on the slide. */
+/** Removes any existing transition on the slide, including its sound. */
 declare const clearSlideTransition: (slide: SlideData) => void;
+/** What plays when the slide's transition starts. */
+type TransitionSound = {
+  readonly kind: 'stop';
+} | {
+  readonly kind: 'play';
+  readonly name: string;
+  readonly loop: boolean;
+};
+/**
+ * `stop` ends any sound still playing from an earlier slide ("Stop Previous
+ * Sound"); `play` embeds a WAV file, the only format `p:snd` allows
+ * (ECMA-376 §19.5.66, CT_EmbeddedWAVAudioFile).
+ */
+type TransitionSoundInput = {
+  readonly kind: 'stop';
+} | {
+  readonly kind: 'play';
+  readonly data: Uint8Array;
+  readonly name: string;
+  readonly loop?: boolean;
+};
+/** Reads the transition's sound, or `null` when it has none. */
+declare const getSlideTransitionSound: (slide: SlideData) => TransitionSound | null;
+/**
+ * Sets (or with `null` removes) the sound played when the slide's transition
+ * starts. A slide without a transition gets one with no effect, which is how
+ * PowerPoint stores a sound on a "None" transition.
+ */
+declare const setSlideTransitionSound: (slide: SlideData, sound: TransitionSoundInput | null) => void;
 //#endregion
 //#region src/api/fn/slide-notes.d.ts
+interface SlideNotesTextFormatOptions {
+  /** Resolve scheme colors through the notes master theme and color map. */
+  readonly resolveColors?: boolean;
+}
+/** Resolve a notes text color token through the notes master theme and map.
+ * Literal tokens remain unchanged in the notes format readers; this helper is
+ * for transient editor display state (such as a pending typing format).
+ */
+declare const resolveSlideNotesTextColor: (slide: SlideData, color: string) => string | null;
 /**
  * Returns the slide's speaker notes (`null` if none). Pulls plain text
  * from the `body` placeholder; multi-line notes use `\n`.
  */
 declare const getSlideNotes: (slide: SlideData) => string | null;
+/** Returns the kind and UTF-16 position of each visible notes line separator. */
+declare const getSlideNotesLineBreaks: (slide: SlideData) => ReadonlyArray<{
+  readonly position: number;
+  readonly kind: "paragraph" | "break";
+}>;
+/** A direct character-format range in a slide's speaker notes. */
+interface SlideNotesTextFormatRange {
+  readonly start: number;
+  readonly end: number;
+  readonly format: ReadTextFormat;
+}
+/**
+ * Reads run formatting from the notes body using the same UTF-16 offsets as
+ * `setSlideNotesFormat`. By default scheme colors remain literal references;
+ * pass `resolveColors` to resolve them through the notes master theme and
+ * color map. Paragraph and line-break separators are included in the offsets
+ * but are not returned as formatted ranges.
+ */
+declare const getSlideNotesTextFormats: (slide: SlideData, options?: SlideNotesTextFormatOptions) => ReadonlyArray<SlideNotesTextFormatRange>;
+/**
+ * Reads the paragraph-end character format used for typing at a notes caret.
+ * By default scheme colors remain literal references; pass `resolveColors` to
+ * resolve them through the notes master theme and color map.
+ */
+declare const getSlideNotesParagraphEndFormat: (slide: SlideData, paragraphIndex: number, options?: SlideNotesTextFormatOptions) => ReadTextFormat;
 /**
  * Sets the slide's speaker notes. Creates the `notesSlide` part and
  * wires up the rels (slide ↔ notesSlide ↔ notesMaster) on first call;
@@ -5963,7 +7617,50 @@ declare const getEmptySlides: (pres: PresentationData) => ReadonlyArray<SlideDat
  * minus the leading newline when there were no notes yet.
  */
 declare const appendSlideNotes: (slide: SlideData, text: string) => void;
-declare const setSlideNotes: (slide: SlideData, value: string) => void;
+/**
+ * Replaces speaker notes. With `range`, replaces that UTF-16 selection while
+ * retaining untouched run/paragraph XML and inheriting the insertion format.
+ * When inserting line-feed characters through a ranged edit, `newlines`
+ * selects whether those inserted separators become paragraph breaks
+ * (`'paragraph'`, the default) or paragraph-internal soft breaks (`'break'`).
+ * Existing separators outside the edited range keep their original OOXML
+ * kind; the option does not normalize the rest of the notes.
+ * `preserveFormatting` infers one changed range from the common prefix/suffix;
+ * apply disjoint edits separately to retain the formatting between them.
+ */
+declare const setSlideNotes: (slide: SlideData, value: string, options?: {
+  preserveFormatting?: boolean;
+  range?: {
+    start: number;
+    end: number;
+  };
+  newlines?: "paragraph" | "break";
+}) => void;
+/** Applies PowerPoint-style Change Case to a speaker-notes range. */
+declare const transformSlideNotesCase: (slide: SlideData, value: TextCase, options?: {
+  range?: {
+    start: number;
+    end: number;
+  };
+}) => void;
+/**
+ * Applies direct run formatting to a UTF-16 range in the slide's speaker notes.
+ * Unselected runs and paragraph XML are preserved. An empty range is a no-op.
+ * Use `paragraphEnd` instead of `range` to update the paragraph-end character
+ * formatting for subsequent typing, including in an empty notes body.
+ */
+declare const setSlideNotesFormat: (slide: SlideData, format: TextFormat, options: {
+  range: {
+    start: number;
+    end: number;
+  };
+  reset?: boolean;
+  paragraphEnd?: never;
+} | {
+  paragraphEnd: number;
+  reset?: boolean;
+  range?: never;
+}) => void;
 /**
  * Removes the slide's speaker-notes part entirely. Drops the
  * `notesSlide` part + its `.rels`, and unwires the slide → notesSlide
@@ -5994,14 +7691,27 @@ interface SlideSize {
 }
 /** Returns the slide canvas size, or `null` if `presentation.xml` omits it. */
 declare const getSlideSize: (pres: PresentationData) => SlideSize | null;
+/**
+ * The number PowerPoint prints on the first slide — `<p:presentation
+ * firstSlideNum="N"/>`, or `1` when the deck does not say. A `slidenum` field
+ * on the n-th slide shows this plus n − 1, so a renderer that substitutes live
+ * field values has to start counting here rather than at one.
+ */
+declare const getPresentationFirstSlideNumber: (pres: PresentationData) => number;
 /**
  * Sets the slide canvas size. Creates `<p:sldSz>` when absent, replaces
- * its attributes when present. The `type` hint is preserved as given.
+ * its attributes when present. Dimensions must be 1–56 inches in EMU;
+ * invalid dimensions throw before changing the presentation.
+ * The `type` hint is preserved as given. `content: 'fit'` uniformly scales
+ * content to fit the new page and centers it, including layout/master artwork
+ * and physical text formatting. The default keeps existing content unchanged.
  *
  * Schema ordering: `<p:sldSz>` follows `<p:sldIdLst>` per ECMA-376
  * §19.2.1.26; we insert at the correct position when bootstrapping.
  */
-declare const setSlideSize: (pres: PresentationData, opts: SlideSize) => void;
+declare const setSlideSize: (pres: PresentationData, opts: SlideSize, options?: {
+  content?: "keep" | "fit";
+}) => void;
 /** 10in × 7.5in (`screen4x3`). */
 declare const SLIDE_SIZE_4_3: SlideSize;
 /** 13.333in × 7.5in (`screen16x9`) — Office 2013+ default. */
@@ -6009,8 +7719,93 @@ declare const SLIDE_SIZE_16_9: SlideSize;
 /** 13.333in × 8.33in (`screen16x10`). */
 declare const SLIDE_SIZE_16_10: SlideSize;
 //#endregion
+//#region src/api/fn/guides.d.ts
+/** A presentation-level drawing guide. Position is in EMU from the left/top edge. */
+interface DrawingGuide {
+  id: number;
+  axis: 'x' | 'y';
+  position: number;
+  color: string;
+}
+/** Returns null when the presentation has no explicit guide list; [] means cleared. */
+declare function getDrawingGuides(presentation: PresentationData): DrawingGuide[] | null;
+/** Replaces presentation guides, retaining metadata/extensions on surviving guide IDs. */
+declare const setDrawingGuides: (presentation: PresentationData, guides: readonly DrawingGuide[]) => void;
+/** Whether drawing guides are visible in the presentation's slide editing view. */
+declare function getDrawingGuidesVisible(presentation: PresentationData): boolean;
+/** Persists slide-view guide visibility without changing other view preferences. */
+declare const setDrawingGuidesVisible: (presentation: PresentationData, visible: boolean) => void;
+/** Document grid snapping; null means no slide-view preferences are stored. */
+declare function getSnapToGrid(presentation: PresentationData): boolean | null;
+declare const setSnapToGrid: (presentation: PresentationData, enabled: boolean) => void;
+/** Grid spacing in EMU, or null when no document spacing is specified. */
+declare function getGridSpacing(presentation: PresentationData): {
+  x: number;
+  y: number;
+} | null;
+declare const setGridSpacing: (presentation: PresentationData, spacing: {
+  x: number;
+  y: number;
+}) => void;
+/** Slides whose bodies are collapsed in PowerPoint's outline view, in deck order. */
+declare function getCollapsedOutlineSlides(presentation: PresentationData): readonly SlideData[];
+/** Persists outline collapse and retains other view settings. */
+declare const setSlideOutlineCollapsed: (slide: SlideData | readonly SlideData[], collapsed: boolean) => void;
+//#endregion
+//#region src/api/fn/shape-image-fill-layout.d.ts
+/** Reads direct picture/image-fill placement; returns null when there is no image fill. */
+declare const getShapeImageFillLayout: (shape: SlideShapeData) => ImageFillLayout | null;
+/** Changes placement without replacing media, crop, or effects. Invalid inputs leave the shape unchanged. */
+declare const setShapeImageFillLayout: (shape: SlideShapeData, layout: ImageFillLayout) => void;
+/**
+ * Natural image-fill size before tile scaling, in EMUs. Reads PNG/JPEG dimensions,
+ * the fill's DPI override, and PNG pHYs/JPEG JFIF resolution. Missing resolution
+ * uses 96 DPI. Returns null for unavailable bytes or unsupported image headers.
+ */
+declare const getShapeImageIntrinsicSize: (shape: SlideShapeData) => {
+  width: Emu;
+  height: Emu;
+} | null;
+//#endregion
+//#region src/api/fn/show-properties.d.ts
+interface SlideShowProperties {
+  mode: {
+    kind: 'present';
+  } | {
+    kind: 'browse';
+    showScrollbar: boolean;
+  } | {
+    kind: 'kiosk';
+    restart: number;
+  };
+  slides: {
+    kind: 'all';
+  } | {
+    kind: 'range';
+    start: number;
+    end: number;
+  } | {
+    kind: 'customShow';
+    id: number;
+  };
+  loop: boolean;
+  showNarration: boolean;
+  showAnimation: boolean;
+  useTimings: boolean;
+  /**
+   * Show Media Controls: whether hovering a video or audio clip in the show
+   * reveals its play bar. PowerPoint 2010 stores it as `p14:showMediaCtrls`
+   * in the show properties' extension list; omit it to leave the file as is.
+   */
+  showMediaControls?: boolean;
+}
+/** Reads presentation-wide slideshow settings using the OOXML defaults. */
+declare function getSlideShowProperties(pres: PresentationData): SlideShowProperties;
+/** Replaces slideshow settings while preserving print/web options, pen color, and extensions. */
+declare function setSlideShowProperties(pres: PresentationData, settings: SlideShowProperties): void;
+//#endregion
 //#region src/api/index.d.ts
 declare const VERSION: string;
 //#endregion
-export { SlideBackground as $, getShapeChartSeriesValues as $a, getShapeCustomGeometry as $c, TableCellBorders as $i, PathFillMode as $l, addSlideLine as $n, appendShapeText as $o, setShapeRunText as $r, getShapeGradientFillEffective as $s, getPresentationShapeCountsBySlide as $t, getPresentationHyperlinkCountsBySlide as A, setTableCellAnchor as Aa, getShapeIndex as Ac, isShapeImageGrayscale as Ai, PresentationInput as Al, ExtendedProperties as An, clearSlideComments as Ao, getParagraphBullet as Ar, clearShapeFill as As, addSectionHeaderSlide as At, emu as Au, getSlidesWithNotes as B, setTableStyleFlags as Ba, ShapeBounds as Bc, getMediaParts as Bi, TableCellData as Bl, findLayoutsWithPlaceholderType as Bn, getCommentPosition as Bo, getShapeParagraphElements as Br, setShapeNoFill as Bs, reverseSlides as Bt, getAllHyperlinks as C, insertTableRow as Ca, findShapesByName as Cc, getShapeImageFillBytes as Ci, setShapeBounds as Cl, setSlideHidden as Cn, ShapeClickAction as Co, PresentationTheme as Cr, clearShapeEffects as Cs, addSlideMedia as Ct, PresetShape as Cu, getDistinctHyperlinkUrls as D, removeTableColumn as Da, findSlidePlaceholder as Dc, getShapeImagePartName as Di, SlideSection as Dl, removeThumbnail as Dn, setShapeImage as Do, setPresentationTheme as Dr, getShapeEffectsEffective as Ds, ungroupShapes as Dt, ImageFormat as Du, getAllTables as E, mergeTableCells as Ea, findShapesWithHyperlinks as Ec, getShapeImageOpacity as Ei, shapesOverlap as El, getThumbnail as En, ImageFit as Eo, setPresentationFonts as Er, getShapeEffects as Es, groupShapes as Et, VideoFormat as Eu, getSlideNotesLength as F, setTableCellText as Fa, getSlideShapes as Fc, MediaPart as Fi, PresentationData as Fl, incrementRevision as Fn, findCommentsByText as Fo, getParagraphLevel as Fr, setShapeAdjustValues as Fs, duplicateSlideAt as Ft, removeSlideNotes as G, findChartsBySeriesName as Ga, getGroupTransform as Gc, listPackageParts as Gi, AnimationOptions as Gl, getSlideLayoutPartName as Gn, getPresentationCommentCountsBySlide as Go, getShapeRunText as Gr, setShapeSize as Gs, SlideOutlineEntry as Gt, getSlidesWithTables as H, SlideChartData as Ha, findShapesAtPoint as Hc, getPackageSize as Hi, CommentPosition as Hl, findSlideLayoutByPartName as Hn, getCommentText as Ho, getShapeRunCount as Hr, setShapePatternFill as Hs, swapSlides as Ht, getSlidesWithCharts as I, setTableCellTextDirection as Ia, getSlidesWithEmptyPlaceholders as Ic, PackagePartInfo as Ii, SlideCommentData as Il, setCoreProperties as In, findSlidesWithCommentsByAuthor as Io, getParagraphLineSpacing as Ir, setShapeFill as Is, importSlide as It, clearSlideTransition as J, getPresentationChartCountsBySlide as Ja, getShapeAdjustValues as Jc, slidesUsingMediaPart as Ji, TransitionOptions as Jl, getSlideLayoutUsageCounts as Jn, getSlideComments as Jo, setParagraphBullet as Jr, setShapeStrokeCap as Js, findSlideByTitle as Jt, replaceHyperlink as K, findChartsWithDataLabels as Ka, getMaxShapeId as Kc, readPackagePart as Ki, SlideTransition as Kl, getSlideLayoutPlaceholders as Kn, getPresentationCommenters as Ko, isParagraphBulletPicture as Kr, setShapeStroke as Ks, findSlideByPartName as Kt, getSlidesWithComments as L, setTableCellTextFormat as La, replaceTokensInSlide as Lc, PresentationSummary as Li, SlideData as Ll, setExtendedProperties as Ln, getCommentAuthor as Lo, getParagraphSpacing as Lr, setShapeFlip as Ls, mergePresentations as Lt, getPresentationNotesLengthsBySlide as M, setTableCellFill as Ma, getShapeXmlString as Mc, setShapeImageContrast as Mi, createPresentation as Ml, getExtendedProperties as Mn, findCommentsAfter as Mo, getParagraphBulletStyle as Mr, getShapePatternFill as Ms, addSlideAt as Mt, mm as Mu, getPresentationNotesText as N, setTableCellMargins as Na, getShapesBounds as Nc, setShapeImageCrop as Ni, loadPresentation as Nl, getPresentationCreated as Nn, findCommentsBefore as No, getParagraphEndFormat as Nr, getShapeStrokeArrow as Ns, addTitleSlide as Nt, pt as Nu, getEmptySlides as O, removeTableRow as Oa, findSlidePlaceholderByIdx as Oc, hasShapeImage as Oi, getSlideSections as Ol, setThumbnail as On, addSlideComment as Oo, ShapeParagraphElement as Or, setShapeGlow as Os, addBlankSlide as Ot, Emu as Ou, getSlideNotes as P, setTableCellParagraphs as Pa, getSlideLayout as Pc, setShapeImageOpacity as Pi, savePresentation as Pl, getPresentationModified as Pn, findCommentsByAuthor as Po, getParagraphIndent as Pr, getShapeStrokeDash as Ps, duplicateSlide as Pt, resolveDeckBodyTextColor as Q, getShapeChartSeriesNames as Qa, getShapeCenter as Qc, TableCellBorder as Qi, GeomPoint as Ql, addSlideImage as Qn, TextWrap as Qo, setShapeRunHyperlink as Qr, getShapeGradientFill as Qs, getOutlineText as Qt, getSlidesWithHyperlinks as R, setTableColumnWidth as Ra, setSlideLayout as Rc, _internalPackageOf as Ri, SlideLayoutData as Rl, touchModified as Rn, getCommentAuthors as Ro, getShapeHyperlinkTooltip as Rr, setShapeGradientFill as Rs, moveSlide as Rt, getAllComments as S, insertTableColumn as Sa, findShapesByKind as Sc, getShapeImageDuotone as Si, setShapeAltTitle as Sl, searchSlides as Sn, ChartView3D as So, PresentationFontsInput as Sr, ShapeEffectAny as Ss, SlideMediaSource as St, asColor as Su, getAllNotes as T, isTableShape as Ta, findShapesByText as Tc, getShapeImageLinkUrl as Ti, setShapeHidden as Tl, PresentationThumbnail as Tn, setShapeClickAction as To, getPresentationTheme as Tr, getShapeEffect as Ts, getShapeMedia as Tt, AudioFormat as Tu, getVisibleSlides as U, addSlideChart as Ua, findShapesInRect as Uc, getPresentationSummary as Ui, SlideComment as Ul, findSlideLayoutByType as Un, getCommentsSortedByDate as Uo, getShapeRunHyperlink as Ur, setShapePosition as Us, AllShapesEntry as Ut, getSlidesWithOverlap as V, setTableStyleId as Va, centerShapeOnSlide as Vc, getOrphanMediaPartNames as Vi, CommentAuthor as Vl, findSlideLayout as Vn, getCommentSlide as Vo, getShapeRunClickAction as Vr, setShapeNoStroke as Vs, sortSlides as Vt, hasSlideNotes as W, findChartByKind as Wa, getGroupChildren as Wc, getSlideMediaPartNames as Wi, AnimationEffect as Wl, getSlideLayoutName as Wn, getPresentationCommentCountsByAuthor as Wo, getShapeRunHyperlinkTooltip as Wr, setShapeRotation as Ws, SlideInfo as Wt, setSlideTransition as X, getShapeChartCategories as Xa, getShapeBounds as Xc, IssueSeverity as Xi, GeomCommand as Xl, getSlideLayouts as Xn, TextAnchor as Xo, setParagraphLineSpacing as Xr, setShapeStrokeDash as Xs, findSlidesByText as Xt, getSlideTransition as Y, getPresentationChartKindCounts as Ya, getShapeAltTitle as Yc, validatePresentation as Yi, CustomGeometry as Yl, getSlideLayoutUsageCountsByType as Yn, removeSlideComment as Yo, setParagraphLevel as Yr, setShapeStrokeCompound as Ys, findSlidesByNotes as Yt, getEffectiveColorMap as Z, getShapeChartKind as Za, getShapeBoundsResolved as Zc, ValidationIssue as Zi, GeomPath as Zl, getUnusedSlideLayouts as Zn, TextAutoFit as Zo, setParagraphSpacing as Zr, setShapeStrokeJoin as Zs, getAllShapes as Zt, clearSlideHyperlinks as _, getTableDimensions as _a, findShapeById as _c, getShapeImageBiLevelThreshold as _i, isShapeHidden as _l, replaceTextInNotes as _n, ChartSpec as _o, setShapeRunFormat as _r, setShapeTextDirection as _s, getSlideMasterShapes as _t, ReadTextFormat as _u, SlideSize as a, getTableCellAlignment as aa, getShapeFillEffective as ac, clearSlideAnimations as ai, getShapePlaceholderIdx as al, getSlideCount as an, ChartDataLabels as ao, clearSlideShapes as ar, getShapeTextColumns as as, getSlideBackgroundPatternFill as at, ShadowOptions as au, findSlidesWithChartTrendlines as b, getTableStyleFlags as ba, findShapeInPresentation as bc, getShapeImageContrast as bi, pointInShape as bl, replaceTextInSlideNotes as bn, ChartTrendline as bo, resolveDrawingColorOpacity as br, setShapeTextWrap as bs, ShapeMedia as bt, HexColor as bu, PresentationChartEntry as c, getTableCellFill as ca, getShapeStrokeCap as cc, setShapeAnimation as ci, getShapePreset as cl, getSlideLayoutCount as cn, ChartErrorBarAmount as co, removeShape as cr, getShapeTextWrap as cs, getSlideLayoutBackgroundGradientFill as ct, PatternFillOptions as cu, PresentationImageEntry as d, getTableCellPosition as da, getShapeStrokeCompound as dc, findOverlappingShapePairs as di, getShapeText as dl, getSlideText as dn, ChartKind as do, setShapeZIndex as dr, setShapeParagraphs as ds, getSlideLayoutBackgroundShapes as dt, ReadGradientStop as du, TableCellParagraph as ea, ShapeFill as ec, getSlideBody as ei, getShapeDescription as el, getPresentationText as en, getShapeChartSpec as eo, addSlideShape as er, getShapeBodyPrEffective as es, SlideLayoutBackgroundShape as et, ArrowOptions as eu, PresentationNotesEntry as f, getTableCellSpan as fa, getShapeStrokeEffective as fc, findShapesOutsideCanvas as fi, getSlideMasterCount as fl, getSlideTextLength as fn, ChartManualLayout as fo, ParagraphProperties as fr, setShapeText as fs, getSlideLayoutShapes as ft, BulletStyle as fu, clearAllSlideNotes as g, getTableColumnWidths as ga, findEmptyPlaceholders as gc, getPresentationImageCountsBySlide as gi, getUnusedSlideMasters as gl, isSlideHidden as gn, ChartSeriesAxis as go, setShapeHyperlink as gr, setShapeTextColumns as gs, getSlideMasterBackgroundPatternFill as gt, RunSpec as gu, clearAllHyperlinks as h, getTableCells as ha, getShapeStrokeWidth as hc, findSlidesByLayoutType as hi, getSlideMasterUsageCounts as hl, getSlidesByLayout as hn, ChartSeries as ho, getShapeRunFormatEffective as hr, setShapeTextBodyRotationDeg as hs, getSlideMasterBackgroundImageBytes as ht, ParagraphSpec as hu, SLIDE_SIZE_4_3 as i, getTableCell as ia, getShapeFillColorResolved as ic, setSlideTitle as ii, getShapeName as il, getSlideAt as in, ChartDataLabelPosition as io, bringShapeToFront as ir, getShapeTextBodyRotationDeg as is, getSlideBackgroundImageBytes as it, GlowOptions as iu, getPresentationNotesLength as j, setTableCellBorders as ja, getShapeSlide as jc, setShapeImageBrightness as ji, PresentationSize as jl, getCoreProperties as jn, findCommentAuthorByName as jo, getParagraphBulletImageBytes as jr, clearShapeStroke as js, addSlide as jt, inches as ju, getHiddenSlides as k, setTableCellAlignment as ka, findSlidePlaceholders as kc, hasShapeText as ki, setSlideSections as kl, CoreProperties as kn, clearAllSlideComments as ko, getParagraphAlignment as kr, setShapeShadow as ks, addContentSlide as kt, cm as ku, PresentationCommentEntry as l, getTableCellMargins as la, getShapeStrokeColor as lc, ImageCrop as li, getShapeRotation as ll, getSlideOutline as ln, ChartErrorBars as lo, sendShapeBackward as lr, setShapeAlignment as ls, getSlideLayoutBackgroundImageBytes as lt, PatternPreset as lu, appendSlideNotes as m, getTableCellTextDirection as ma, getShapeStrokeOpacity as mc, findSlidesByLayoutPartName as mi, getSlideMasterPartNames as ml, getSlides as mn, ChartSecondaryValueAxis as mo, getShapeHyperlink as mr, setShapeTextAutoFit as ms, getSlideMasterBackgroundGradientFill as mt, ParagraphAlignmentToken as mu, SLIDE_SIZE_16_10 as n, getPresentationTableCountsBySlide as na, getShapeFill as nc, setSlideBody as ni, getShapeId as nl, getPresentationTextLengthsBySlide as nn, setChartSpec as no, addSlideTextBox as nr, getShapeTextAutoFit as ns, getSlideBackground as nt, LineEndSize as nu, getSlideSize as o, getTableCellAnchor as oa, getShapeFillOpacity as oc, findShapesWithAnimation as oi, getShapePlaceholderType as ol, getSlideIndex as on, ChartDataTable as oo, copyShape as or, getShapeTextDirection as os, getSlideColorMapOverride as ot, GradientFillOptions as ou, PresentationTableEntry as p, getTableCellText as pa, getShapeStrokeJoin as pc, findSlidesByLayoutName as pi, getSlideMasterPartName as pl, getSlideXmlString as pn, ChartOfPie as po, getParagraphPropertiesEffective as pr, setShapeTextAnchor as ps, getSlideMasterBackground as pt, ParagraphAlignment as pu, setSlideNotes as q, findChartsWithTrendlines as qa, getMaxShapeIdInPresentation as qc, setMediaPartBytes as qi, TransitionEffect as ql, getSlideLayoutType as qn, getSlideCommentAuthors as qo, setParagraphAlignment as qr, setShapeStrokeArrow as qs, findSlideByText as qt, SLIDE_SIZE_16_9 as r, getSlideTables as ra, getShapeFillColor as rc, setSlidePlaceholders as ri, getShapeKind as rl, getShapeAt as rn, ChartAxisScaling as ro, bringShapeForward as rr, getShapeTextAutoFitParams as rs, getSlideBackgroundGradientFill as rt, LineEndType as ru, setSlideSize as s, getTableCellBorders as sa, getShapeStroke as sc, getShapeAnimation as si, getShapePosition as sl, getSlideInfo as sn, ChartDateAxis as so, getShapeZIndex as sr, getShapeTextMargins as ss, getSlideLayoutBackground as st, GradientStop as su, VERSION as t, clearTableCellFill as ta, ShapeStroke as tc, getSlideTitle as ti, getShapeFlip as tl, getPresentationTextLength as tn, getSlideCharts as to, addSlideTable as tr, getShapeTextAnchor as ts, clearSlideBackground as tt, LineDash as tu, PresentationHyperlinkEntry as u, getTableCellParagraphs as ua, getShapeStrokeColorResolved as uc, findFlippedShapes as ui, getShapeSize as ul, getSlidePartName as un, ChartGrouping as uo, sendShapeToBack as ur, setShapeBulletStyle as us, getSlideLayoutBackgroundPatternFill as ut, ReadGradientFill as uu, findSlidesByHyperlink as v, getTableRowHeights as va, findShapeByName as vc, getShapeImageBrightness as vi, isShapePlaceholder as vl, replaceTextInPresentation as vn, ChartTextStyle as vo, getShapeRunFormat as vr, setShapeTextFormat as vs, setSlideBackground as vt, TextFormat as vu, getAllImages as w, isChartShape as wa, findShapesByPreset as wc, getShapeImageFormat as wi, setShapeDescription as wl, slideHasAnimations as wn, getShapeClickAction as wo, getPresentationFonts as wr, findShapesByEffect as ws, findShapesWithMedia as wt, PlaceholderType as wu, getAllCharts as x, getTableStyleId as xa, findShapesByHyperlink as xc, getShapeImageCrop as xi, renameShape as xl, replaceTokensInPresentation as xn, ChartUpDownBars as xo, PresentationFonts as xr, ShapeEffect as xs, SlideMediaOptions as xt, SchemeColorToken as xu, findSlidesWithChartKind as y, getTableSize as ya, findShapeByText as yc, getShapeImageBytes as yi, isShapeTextBox as yl, replaceTextInSlide as yn, ChartTimeUnit as yo, resolveDrawingColor as yr, setShapeTextMargins as ys, setSlideBackgroundImage as yt, Color as yu, getSlidesWithImages as z, setTableRowHeight as za, translateShapes as zc, compactPackage as zi, SlideShapeData as zl, SlideLayoutPlaceholder as zn, getCommentDate as zo, getShapeParagraphCount as zr, setShapeImageFill as zs, removeSlide as zt };
-//# sourceMappingURL=index-CfANfMvY.d.ts.map
+export { getSlideNotes as $, getShapeImageLinkUrl as $a, removeSlideComment as $c, shapesOverlap as $d, TextFill as $f, getParagraphLineSpacing as $i, setShapeAdjustValues as $l, addTitleSlide as $n, getTableStyleFlags as $o, removeThumbnail as $r, ScatterChartSeries as $s, getSlideMasterBackgroundImageBytes as $t, findShapesWithHyperlinks as $u, PresentationNotesEntry as A, AnimationSequenceKind as Aa, clearAllSlideComments as Ac, getShapeKind as Ad, PathFillMode as Af, addSlideShape as Ai, setShapeTextAutoFit as Al, ShapeStyleFontReference as An, TableCellBorders as Ao, getSlideInfo as Ar, getPresentationChartKindCounts as As, setSlideMasterBackgroundStyle as At, getShapeFillColor as Au, getAllCharts as B, findShapesOutsideCanvas as Ba, getCommentDate as Bc, getSlideMasterPartName as Bd, LightRigType as Bf, sendShapeToBack as Bi, ShapeEffectAny as Bl, isShapeLocked as Bn, getTableCellFill as Bo, isSlideHidden as Br, BubbleChartSpec as Bs, getSlideBackgroundImageFillLayout as Bt, getShapeStrokeJoin as Bu, getPresentationFirstSlideNumber as C, setSlidePlaceholders as Ca, ReadChartSpec as Cc, getShapeBounds as Cd, SlideTransition as Cf, getUnusedSlideLayouts as Ci, getShapeTextWrap as Cl, addSlideMedia as Cn, setMediaPartBytes as Co, Emu as Cp, getPresentationText as Cr, SlideChartData as Cs, getSlideTransitionSound as Ct, getPresentationFonts as Cu, PresentationCommentEntry as D, getShapeAnimation as Da, ImageFit as Dc, getShapeDescription as Dd, GeomCommand as Df, setSlideLayoutPlaceholderBounds as Di, setShapeText as Dl, setShapeMediaPlayback as Dn, ValidationIssue as Do, mm as Dp, getSlideAt as Dr, findChartsWithDataLabels as Ds, resolveDeckBodyTextColor as Dt, ShapeFill as Du, PresentationChartEntry as E, findShapesWithAnimation as Ea, setShapeClickAction as Ec, getShapeCustomGeometry as Ed, CustomGeometry as Ef, setSlideLayoutName as Ei, setShapeParagraphs as El, getShapeMediaPlayback as En, IssueSeverity as Eo, inches as Ep, getShapeAt as Er, findChartsBySeriesName as Es, getEffectiveColorMap as Et, setPresentationTheme as Eu, clearAllSlideNotes as F, ImageCrop as Fa, findCommentsByAuthor as Fc, getShapePreset as Fd, Bevel as Ff, clearSlideShapes as Fi, setShapeTextFormat as Fl, setShapeTextLanguage as Fn, getTableCell as Fo, getSlideTextLength as Fr, getShapeChartSpec as Fs, copySlideBackground as Ft, getShapeStrokeCap as Fu, getAllTables as G, getShapeImageBiLevelThreshold as Ga, getCommentStatus as Gc, isShapePlaceholder as Gd, Text3D as Gf, ShapeParagraphElement as Gi, getShapeEffectsEffective as Gl, resetSlideLayout as Gn, getTableCellSpan as Go, replaceTextInSlideNotes as Gr, ComboChartSpec as Gs, getSlideLayoutBackground as Gt, findShapeByName as Gu, getAllHyperlinks as H, findSlidesByLayoutPartName as Ha, getCommentParent as Hc, getSlideMasterUsageCounts as Hd, ReadText3D as Hf, getShapeRunFormat as Hi, findShapesByEffect as Hl, setShapeLocked as Hn, getTableCellParagraphs as Ho, replaceTextInNotes as Hr, ChartSpec as Hs, getSlideBackgroundImageOpacity as Ht, getShapeStrokeWidth as Hu, clearSlideHyperlinks as I, ImageRecolor as Ia, findCommentsByText as Ic, getShapeRotation as Id, BevelPreset as If, copyShape as Ii, setShapeTextMargins as Il, CustomGeometryInput as In, getTableCellAlignment as Io, getSlideXmlString as Ir, getSlideCharts as Is, getSlideBackground as It, getShapeStrokeColor as Iu, getHiddenSlides as J, getShapeImageContrast as Ja, getPresentationCommentCountsByAuthor as Jc, renameShape as Jd, ParagraphAlignmentToken as Jf, getParagraphBulletImageBytes as Ji, clearShapeFill as Jl, addBlankSlide as Jn, getTableCells as Jo, setSlideBackgroundGraphicsHidden as Jr, OfPieChartSpec as Js, getSlideLayoutBackgroundPatternFill as Jt, findShapesByHyperlink as Ju, getDistinctHyperlinkUrls as K, getShapeImageBrightness as Ka, getCommentText as Kc, isShapeTextBox as Kd, BulletStyle as Kf, getParagraphAlignment as Ki, setShapeGlow as Kl, resetSlidePlaceholderGeometry as Kn, getTableCellText as Ko, replaceTokensInPresentation as Kr, DoughnutChartSpec as Ks, getSlideLayoutBackgroundGradientFill as Kt, findShapeByText as Ku, findSlidesByHyperlink as L, ImageRecolorColor as La, findSlidesWithCommentsByAuthor as Lc, getShapeSize as Ld, CameraPreset as Lf, getShapeZIndex as Li, setShapeTextWrap as Ll, CustomGeometryPathInput as Ln, getTableCellAnchor as Lo, getSlides as Lr, setChartSpec as Ls, getSlideBackgroundGradientFill as Lt, getShapeStrokeColorResolved as Lu, SlideNotesTextFormatOptions as M, AnimationTarget as Ma, findCommentAuthorByName as Mc, getShapePlaceholderIdx as Md, LineDash as Mf, addSlideTextBox as Mi, setShapeTextColumns as Ml, ShapeStyleReference as Mn, clearTableCellFill as Mo, getSlideOutline as Mr, getShapeChartKind as Ms, SlideLayoutBackgroundShape as Mt, getShapeFillEffective as Mu, appendSlideNotes as N, AnimationValueAfterEnd as Na, findCommentsAfter as Nc, getShapePlaceholderType as Nd, LineEndSize as Nf, bringShapeForward as Ni, setShapeTextDirection as Nl, setShapeStyle as Nn, getPresentationTableCountsBySlide as No, getSlidePartName as Nr, getShapeChartSeriesNames as Ns, applySlideBackgroundToAll as Nt, getShapeFillOpacity as Nu, PresentationHyperlinkEntry as O, getSlideAnimations as Oa, setShapeImage as Oc, getShapeFlip as Od, GeomPath as Of, addSlideImage as Oi, setShapeText3D as Ol, groupShapes as On, TableCellAppearanceEffective as Oo, pt as Op, getSlideCount as Or, findChartsWithTrendlines as Os, SlideMasterBackgroundStyle as Ot, ShapeStroke as Ou, clearAllHyperlinks as P, SlideAnimationStep as Pa, findCommentsBefore as Pc, getShapePosition as Pd, LineEndType as Pf, bringShapeToFront as Pi, setShapeTextField as Pl, getShapeTextLanguage as Pn, getSlideTables as Po, getSlideText as Pr, getShapeChartSeriesValues as Ps, clearSlideBackground as Pt, getShapeStroke as Pu, getPresentationNotesText as Q, getShapeImageFormat as Qa, getSlideComments as Qc, setShapeHidden as Qd, ReadTextFormat as Qf, getParagraphLevel as Qi, getShapeStrokeDash as Ql, addSlideAt as Qn, getTableSize as Qo, getThumbnail as Qr, RadarChartSpec as Qs, getSlideMasterBackgroundGradientFill as Qt, findShapesByText as Qu, findSlidesWithChartKind as R, findFlippedShapes as Ra, getCommentAuthor as Rc, getShapeText as Rd, LightRig as Rf, removeShape as Ri, TextCase as Rl, setShapeCustomGeometry as Rn, getTableCellAppearanceEffective as Ro, getSlidesByLayout as Rr, Bar3DChartSpec as Rs, getSlideBackgroundImageBytes as Rt, getShapeStrokeCompound as Ru, SlideSize as S, setSlideBody as Sa, ChartView3D as Sc, getShapeAltTitle as Sd, AnimationStartCondition as Sf, getSlideLayouts as Si, getShapeTextMargins as Sl, SlideMediaSource as Sn, readPackagePart as So, ImageFormat as Sp, getPresentationShapeCountsBySlide as Sr, splitTableCell as Ss, getSlideTransition as St, PresentationTheme as Su, setSlideSize as T, clearSlideAnimations as Ta, getShapeClickAction as Tc, getShapeCenter as Td, TransitionOptions as Tf, setSlideLayoutBackground as Ti, setShapeBulletStyle as Tl, getShapeMedia as Tn, validatePresentation as To, emu as Tp, getPresentationTextLengthsBySlide as Tr, findChartByKind as Ts, setSlideTransitionSound as Tt, setPresentationFonts as Tu, getAllImages as U, findSlidesByLayoutType as Ua, getCommentPosition as Uc, getUnusedSlideMasters as Ud, Rotation3D as Uf, resolveDrawingColor as Ui, getShapeEffect as Ul, addMissingSlidePlaceholders as Un, getTableCellPosition as Uo, replaceTextInPresentation as Ur, ChartVariant as Us, getSlideBackgroundPatternFill as Ut, findEmptyPlaceholders as Uu, getAllComments as V, findSlidesByLayoutName as Va, getCommentFormat as Vc, getSlideMasterPartNames as Vd, PresetMaterial as Vf, setShapeZIndex as Vi, clearShapeEffects as Vl, setShapeAspectRatioLocked as Vn, getTableCellMargins as Vo, isSlideLayoutBackgroundGraphicsHidden as Vr, CandlestickChartSpec as Vs, getSlideBackgroundImageIntrinsicSize as Vt, getShapeStrokeOpacity as Vu, getAllNotes as W, getPresentationImageCountsBySlide as Wa, getCommentSlide as Wc, isShapeHidden as Wd, Scene3D as Wf, resolveDrawingColorOpacity as Wi, getShapeEffects as Wl, addSlidePlaceholder as Wn, getTableCellRunFormatEffective as Wo, replaceTextInSlide as Wr, ComboChartSeries as Ws, getSlideColorMapOverride as Wt, findShapeById as Wu, getPresentationNotesLength as X, getShapeImageDuotone as Xa, getPresentationCommenters as Xc, setShapeBounds as Xd, RunSpec as Xf, getParagraphEndFormat as Xi, getShapePatternFill as Xl, addSectionHeaderSlide as Xn, getTableDimensions as Xo, slideHasAnimations as Xr, PieChartSpec as Xs, getSlideLayoutShapes as Xt, findShapesByName as Xu, getPresentationHyperlinkCountsBySlide as Y, getShapeImageCrop as Ya, getPresentationCommentCountsBySlide as Yc, setShapeAltTitle as Yd, ParagraphSpec as Yf, getParagraphBulletStyle as Yi, clearShapeStroke as Yl, addContentSlide as Yn, getTableColumnWidths as Yo, setSlideHidden as Yr, Pie3DChartSpec as Ys, getSlideLayoutBackgroundShapes as Yt, findShapesByKind as Yu, getPresentationNotesLengthsBySlide as Z, getShapeImageFillBytes as Za, getSlideCommentAuthors as Zc, setShapeDescription as Zd, ReadTextFill as Zf, getParagraphIndent as Zi, getShapeStrokeArrow as Zl, addSlide as Zn, getTableRowHeights as Zo, PresentationThumbnail as Zr, PlainChartSeries as Zs, getSlideMasterBackground as Zt, findShapesByPreset as Zu, setSlideOutlineCollapsed as _, setParagraphTypography as _a, ChartSeriesAxis as _c, getGroupChildren as _d, CommentPosition as _f, getSlideLayoutPartName as _i, getShapeTextAutoFit as _l, MediaFade as _n, getOrphanMediaPartNames as _o, ColorTransform as _p, findSlideByTitle as _r, setTableCellTextFormat as _s, setSlideNotesFormat as _t, setShapeStrokeJoin as _u, getShapeImageFillLayout as a, getShapeRunCount as aa, ChartDataLabelPosition as ac, getShapeXmlString as ad, createPresentation as af, getPresentationCreated as ai, getParagraphPropertiesEffective as al, setSlideBackgroundImageFillLayout as an, resetShapeImageColorEffects as ao, PatternFillOptions as ap, removeSlide as ar, mergeTableCells as as, getSlidesWithComments as at, setShapeNoStroke as au, SLIDE_SIZE_16_9 as b, getSlideBody as ba, ChartTrendline as bc, getMaxShapeIdInPresentation as bd, AnimationEffect as bf, getSlideLayoutUsageCounts as bi, getShapeTextColumns as bl, ShapeMedia as bn, getSlideMediaPartNames as bo, AudioFormat as bp, getAllShapes as br, setTableStyleFlags as bs, TransitionSoundInput as bt, PresentationFonts as bu, DrawingGuide as c, getShapeRunText as ca, ChartDateAxis as cc, getSlideShapes as cd, PresentationData as cf, setCoreProperties as ci, setShapeHyperlink as cl, ImageFillLayout as cn, setShapeImageCrop as co, ReadGradientStop as cp, swapSlides as cr, setTableCellAlignment as cs, getSlidesWithNotes as ct, setShapePreset as cu, getDrawingGuidesVisible as d, setParagraphBullet as da, ChartGrouping as dc, setSlideLayout as dd, SlideLayoutData as df, SlideLayoutPlaceholder as di, TextAutoFit as dl, AnimationPatch as dn, MediaPart as do, ReflectionOptions as dp, setCustomShows as dr, setTableCellClickAction as ds, getVisibleSlides as dt, setShapeSlideBackgroundFill as du, getParagraphSpacing as ea, ScatterChartSpec as ec, findSlidePlaceholder as ed, SlideSection as ef, setThumbnail as ei, setCommentStatus as el, getSlideMasterBackgroundPatternFill as en, getShapeImageOpacity as eo, TextFormat as ep, duplicateSlide as er, getTableStyleId as es, getSlideNotesLength as et, setShapeFill as eu, getGridSpacing as f, setParagraphIndent as fa, ChartKind as fc, translateShapes as fd, SlideShapeData as ff, findLayoutsWithPlaceholderType as fi, TextWrap as fl, moveSlideAnimation as fn, PackagePartInfo as fo, ShadowOptions as fp, AllShapesEntry as fr, setTableCellFill as fs, hasSlideNotes as ft, setShapeStroke as fu, setGridSpacing as g, setParagraphTabs as ga, ChartSeries as gc, findShapesInRect as gd, CommentAuthor as gf, getSlideLayoutName as gi, getShapeTextAnchor as gl, MediaBookmark as gn, getMediaParts as go, asColor as gp, findSlideByText as gr, setTableCellTextDirection as gs, setSlideNotes as gt, setShapeStrokeDash as gu, setDrawingGuidesVisible as h, setParagraphSpacing as ha, ChartSecondaryValueAxis as hc, findShapesAtPoint as hd, CommentStatus as hf, findSlideLayoutByType as hi, getShapeText3D as hl, resetShapeVideoFormatting as hn, compactPackage as ho, SchemeColorToken as hp, findSlideByPartName as hr, setTableCellText as hs, resolveSlideNotesTextColor as ht, setShapeStrokeCompound as hu, setSlideShowProperties as i, getShapeRunClickAction as ia, ChartAxisScaling as ic, getShapeSlide as id, PresentationSize as if, getExtendedProperties as ii, ParagraphTabStop as il, setSlideBackgroundImage as in, isShapeImageGrayscale as io, GradientStop as ip, moveSlide as ir, isTableShape as is, getSlidesWithCharts as it, setShapeNoFill as iu, PresentationTableEntry as j, AnimationStart as ja, clearSlideComments as jc, getShapeName as jd, ArrowOptions as jf, addSlideTable as ji, setShapeTextBodyRotationDeg as jl, ShapeStyleOptions as jn, TableCellParagraph as jo, getSlideLayoutCount as jr, getShapeChartCategories as js, SlideBackground as jt, getShapeFillColorResolved as ju, PresentationImageEntry as k, setShapeAnimation as ka, addSlideComment as kc, getShapeId as kd, GeomPoint as kf, addSlideLine as ki, setShapeTextAnchor as kl, ungroupShapes as kn, TableCellBorder as ko, getSlideIndex as kr, getPresentationChartCountsBySlide as ks, getSlideMasterBackgroundStyles as kt, getShapeFill as ku, getCollapsedOutlineSlides as l, isParagraphBulletPicture as la, ChartErrorBarAmount as lc, getSlidesWithEmptyPlaceholders as ld, SlideCommentData as lf, setExtendedProperties as li, setShapeRunFormat as ll, ImageTileAlignment as ln, setShapeImageOpacity as lo, GlowOptions as lp, CustomShow as lr, setTableCellAnchor as ls, getSlidesWithOverlap as lt, setShapeRotation as lu, setDrawingGuides as m, setParagraphLineSpacing as ma, ChartOfPie as mc, centerShapeOnSlide as md, COMMENT_STATUSES as mf, findSlideLayoutByPartName as mi, getShapeBodyPrEffective as ml, updateSlideAnimation as mn, _internalPackageOf as mo, HexColor as mp, SlideOutlineEntry as mr, setTableCellParagraphs as ms, replaceHyperlink as mt, setShapeStrokeCap as mu, SlideShowProperties as n, getShapeParagraphCount as na, SurfaceChartSpec as nc, findSlidePlaceholders as nd, setSlideSections as nf, ExtendedProperties as ni, ParagraphBulletDetail as nl, setSlideBackground as nn, hasShapeImage as no, toWritableTextFormat as np, importSlide as nr, insertTableRow as ns, getSlideNotesParagraphEndFormat as nt, setShapeGradientFill as nu, getShapeImageIntrinsicSize as o, getShapeRunHyperlink as oa, ChartDataLabels as oc, getShapesBounds as od, loadPresentation as of, getPresentationModified as oi, getShapeHyperlink as ol, setSlideBackgroundImageOpacity as on, setShapeImageBrightness as oo, PatternPreset as op, reverseSlides as or, removeTableColumn as os, getSlidesWithHyperlinks as ot, setShapePatternFill as ou, getSnapToGrid as p, setParagraphLevel as pa, ChartManualLayout as pc, ShapeBounds as pd, TableCellData as pf, findSlideLayout as pi, appendShapeText as pl, removeSlideAnimation as pn, PresentationSummary as po, Color as pp, SlideInfo as pr, setTableCellMargins as ps, removeSlideNotes as pt, setShapeStrokeArrow as pu, getEmptySlides as q, getShapeImageBytes as qa, getCommentsSortedByDate as qc, pointInShape as qd, ParagraphAlignment as qf, getParagraphBullet as qi, setShapeShadow as ql, resetSlidePlaceholderTextFormatting as qn, getTableCellTextDirection as qo, searchSlides as qr, LineArea3DChartSpec as qs, getSlideLayoutBackgroundImageBytes as qt, findShapeInPresentation as qu, getSlideShowProperties as r, getShapeParagraphElements as ra, isChartSpec as rc, getShapeIndex as rd, PresentationInput as rf, getCoreProperties as ri, ParagraphProperties as rl, setSlideBackgroundGradientFill as rn, hasShapeText as ro, GradientFillOptions as rp, mergePresentations as rr, isChartShape as rs, getSlideNotesTextFormats as rt, setShapeImageFill as ru, setShapeImageFillLayout as s, getShapeRunHyperlinkTooltip as sa, ChartDataTable as sc, getSlideLayout as sd, savePresentation as sf, incrementRevision as si, getShapeRunFormatEffective as sl, setSlideBackgroundPatternFill as sn, setShapeImageContrast as so, ReadGradientFill as sp, sortSlides as sr, removeTableRow as ss, getSlidesWithImages as st, setShapePosition as su, VERSION as t, getShapeHyperlinkTooltip as ta, StockChartSpec as tc, findSlidePlaceholderByIdx as td, getSlideSections as tf, CoreProperties as ti, setCommentText as tl, getSlideMasterShapes as tn, getShapeImagePartName as to, TextOutline as tp, duplicateSlideAt as tr, insertTableColumn as ts, getSlideNotesLineBreaks as tt, setShapeFlip as tu, getDrawingGuides as u, setParagraphAlignment as ua, ChartErrorBars as uc, replaceTokensInSlide as ud, SlideData as uf, touchModified as ui, TextAnchor as ul, ImageTileFlip as un, setShapeImageRecolor as uo, InnerShadowOptions as up, getCustomShows as ur, setTableCellBorders as us, getSlidesWithTables as ut, setShapeSize as uu, setSnapToGrid as v, setShapeRunHyperlink as va, ChartTextStyle as vc, getGroupTransform as vd, SlideComment as vf, getSlideLayoutPlaceholders as vi, getShapeTextAutoFitParams as vl, MediaPlayback as vn, getPackageSize as vo, PresetShape as vp, findSlidesByNotes as vr, setTableColumnWidth as vs, transformSlideNotesCase as vt, getShapeGradientFill as vu, getSlideSize as w, setSlideTitle as wa, ShapeClickAction as wc, getShapeBoundsResolved as wd, TransitionEffect as wf, clearSlideLayoutBackground as wi, setShapeAlignment as wl, findShapesWithMedia as wn, slidesUsingMediaPart as wo, cm as wp, getPresentationTextLength as wr, addSlideChart as ws, setSlideTransition as wt, getPresentationTheme as wu, SLIDE_SIZE_4_3 as x, getSlideTitle as xa, ChartUpDownBars as xc, getShapeAdjustValues as xd, AnimationOptions as xf, getSlideLayoutUsageCountsByType as xi, getShapeTextDirection as xl, SlideMediaOptions as xn, listPackageParts as xo, VideoFormat as xp, getOutlineText as xr, setTableStyleId as xs, clearSlideTransition as xt, PresentationFontsInput as xu, SLIDE_SIZE_16_10 as y, setShapeRunText as ya, ChartTimeUnit as yc, getMaxShapeId as yd, AnimationDirection as yf, getSlideLayoutType as yi, getShapeTextBodyRotationDeg as yl, MediaTrim as yn, getPresentationSummary as yo, PlaceholderType as yp, findSlidesByText as yr, setTableRowHeight as ys, TransitionSound as yt, getShapeGradientFillEffective as yu, findSlidesWithChartTrendlines as z, findOverlappingShapePairs as za, getCommentAuthors as zc, getSlideMasterCount as zd, LightRigDirection as zf, sendShapeBackward as zi, ShapeEffect as zl, isShapeAspectRatioLocked as zn, getTableCellBorders as zo, isSlideBackgroundGraphicsHidden as zr, BubbleChartSeries as zs, getSlideBackgroundImageCrop as zt, getShapeStrokeEffective as zu };
+//# sourceMappingURL=index-Dnzhy4tZ.d.ts.map