@office-kit/pptx 0.22.0 → 0.24.0

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

@@ -329,6 +329,17 @@ interface ShadowOptions {
   readonly alignment?: 'tl' | 't' | 'tr' | 'l' | 'ctr' | 'r' | 'bl' | 'b' | 'br';
   /** Whether the shadow rotates with its shape; defaults to false. */
   readonly rotateWithShape?: boolean;
+  /**
+   * Horizontal scale (`sx`); defaults to one. The reference desktop app's Size field sets
+   * both scales, and its perspective presets flatten the shadow with `sy`.
+   */
+  readonly scaleX?: number;
+  /** Vertical scale (`sy`); defaults to one. Negative values mirror vertically. */
+  readonly scaleY?: number;
+  /** Horizontal skew (`kx`) in degrees, strictly between -90 and 90. */
+  readonly skewX?: number;
+  /** Vertical skew (`ky`) in degrees, strictly between -90 and 90. */
+  readonly skewY?: number;
 }
 /** Character or shape inner-shadow parameters from `<a:innerShdw>`. */
 interface InnerShadowOptions {
@@ -406,7 +417,7 @@ interface GradientStop {
   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. */
+  /** The reference desktop app's brightness from -1 (black) to 1 (white); 0 leaves the color unchanged. */
   readonly brightness?: number;
 }
 interface GradientFillOptions {
@@ -444,7 +455,7 @@ interface GradientFillOptions {
   };
   /**
    * Gradient tile bounds as fractional insets from the shape's edges.
-   * Negative values extend the tile beyond that edge. Mac PowerPoint uses
+   * Negative values extend the tile beyond that edge. The reference desktop app on Mac uses
    * right/bottom -1 for its bottom-right radial direction. Mirrors `<a:tileRect>`.
    */
   readonly tileRect?: GradientFillOptions['focus'];
@@ -476,6 +487,39 @@ interface PatternFillOptions {
   readonly backgroundTransforms?: readonly ColorTransform[];
 }
 //#endregion
+//#region src/internal/drawingml/stroke.d.ts
+/**
+ * A non-solid line paint — the fill choice of `CT_LineProperties` other than
+ * `<a:solidFill>` (which `color` spells) and `<a:noFill>`. Only gradients are
+ * modelled; the reference desktop app's Format pane offers no other kind for a line.
+ */
+type LineFill = {
+  readonly kind: 'gradient';
+} & GradientFillOptions;
+/** A line paint read back from a deck; stop colors widen to `string`. */
+type ReadLineFill = {
+  readonly kind: 'gradient';
+} & ReadGradientFill;
+/**
+ * ECMA-376 §20.1.10.49 `ST_PresetLineDashVal` tokens. The reference desktop app's
+ * "Dash type" dropdown maps to these.
+ */
+type LineDash = 'solid' | 'dot' | 'dash' | 'lgDash' | 'dashDot' | 'lgDashDot' | 'lgDashDotDot' | 'sysDash' | 'sysDot' | 'sysDashDot' | 'sysDashDotDot';
+/** ECMA-376 §20.1.10.39 `ST_LineEndType`. */
+type LineEndType = 'none' | 'triangle' | 'stealth' | 'diamond' | 'oval' | 'arrow';
+/** ECMA-376 `ST_LineEndWidth` / `ST_LineEndLength`. */
+type LineEndSize = 'sm' | 'med' | 'lg';
+interface ArrowOptions {
+  readonly type: LineEndType;
+  readonly width?: LineEndSize;
+  readonly length?: LineEndSize;
+}
+/**
+ * The reference desktop app's Sketched style presets ([MS-ODRAWXML] §2.38,
+ * `EG_LineSketchType`), named after their `ask:lineSketch*` elements.
+ */
+type LineSketch = 'curved' | 'freehand' | 'scribble';
+//#endregion
 //#region src/internal/drawingml/text-format.d.ts
 interface TextFormat {
   /** Latin font family (`Calibri`, `Arial`, ...). Sets `<a:latin>`. */
@@ -502,7 +546,7 @@ interface TextFormat {
   color?: Color | null;
   /**
    * Ordered adjustments to `color` (`<a:lumMod>`, `<a:tint>`, `<a:alpha>`,
-   * ...), written as children of its color element — PowerPoint's theme
+   * ...), written as children of its color element — the reference desktop app'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.
    */
@@ -512,7 +556,11 @@ interface TextFormat {
    * fill. Both are the same OOXML fill choice, so supplying both is rejected.
    */
   textFill?: TextFill;
-  bold?: boolean;
+  /**
+   * `null` removes `b`, so the run inherits its weight again; `false` writes
+   * `b="0"`, which overrides an inherited bold.
+   */
+  bold?: boolean | null;
   italic?: boolean;
   /**
    * Underline style. `true` is shorthand for `'sng'` (single). Pass the
@@ -534,21 +582,22 @@ interface TextFormat {
   strike?: boolean | string;
   /**
    * Character spacing in 1/100 points (`0` = default). Negative values
-   * tighten, positive values loosen. Mirrors `<a:rPr spc="…"/>`.
+   * tighten, positive values loosen. Mirrors `<a:rPr spc="…"/>`. `null`
+   * removes it, so the run inherits its spacing again.
    */
-  spc?: number;
+  spc?: number | null;
   /**
    * 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="…"/>`. Mac PowerPoint was observed to
+   * ≥12pt. Mirrors `<a:rPr kern="…"/>`. The reference desktop app on Mac 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). */
+  /** Normalize character heights (`<a:rPr normalizeH>`; the reference desktop app'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
+   * `-0.25` = subscript). The reference desktop app emits ST_Percentage; this getter
    * returns the unit-fraction form for ergonomic comparisons.
    */
   baseline?: number;
@@ -583,11 +632,22 @@ interface TextFormat {
   /** Reflection below the glyphs — `<a:reflection>` in the run's effect list. */
   reflection?: ReflectionOptions | null;
 }
+/**
+ * Non-solid glyph fill. `none` is `<a:noFill>` (glyphs show only their
+ * outline); `image` is `<a:blipFill>`, the picture stretched over the text
+ * block — the reference desktop app's Picture or texture fill. Its `bytes` must be PNG, JPEG,
+ * GIF, BMP, TIFF or WebP, and each edit embeds them once per part.
+ */
 type TextFill = ({
   readonly kind: 'gradient';
 } & GradientFillOptions) | ({
   readonly kind: 'pattern';
-} & PatternFillOptions);
+} & PatternFillOptions) | {
+  readonly kind: 'none';
+} | {
+  readonly kind: 'image';
+  readonly bytes: Uint8Array;
+};
 type ReadTextFill = ({
   readonly kind: 'gradient';
 } & ReadGradientFill) | {
@@ -597,6 +657,16 @@ type ReadTextFill = ({
   readonly background: string;
   readonly foregroundTransforms?: PatternFillOptions['foregroundTransforms'];
   readonly backgroundTransforms?: PatternFillOptions['backgroundTransforms'];
+} | {
+  readonly kind: 'none';
+} | {
+  readonly kind: 'image';
+  /**
+   * The picture, when the reader can reach the part that holds it — the
+   * run's own slide. A picture inherited from a layout or master, or one
+   * behind a broken relationship, reads without bytes.
+   */
+  readonly bytes?: Uint8Array;
 };
 /** A run's outline: `CT_LineProperties` as far as text uses it. */
 interface TextOutline {
@@ -604,15 +674,22 @@ interface TextOutline {
   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). */
+  /** Line width in EMU. The reference desktop app's thinnest visible text outline is 9525 (0.75pt). */
   readonly widthEmu?: number;
+  /**
+   * Gradient outline (`<a:gradFill>` in the run's `<a:ln>`), as on
+   * `setShapeStroke`. Exclusive with `color`.
+   */
+  readonly fill?: LineFill;
 }
 /**
  * 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' | 'textFill' | 'underlineColor' | 'highlight' | 'outline' | 'shadow' | 'innerShadow' | 'glow' | 'reflection'> & {
+type ReadTextFormat = Omit<TextFormat, 'bold' | 'spc' | 'color' | 'textFill' | 'underlineColor' | 'highlight' | 'outline' | 'shadow' | 'innerShadow' | 'glow' | 'reflection'> & {
+  bold?: boolean;
+  spc?: number;
   color?: string | null;
   underlineColor?: string | null;
   highlight?: string | null;
@@ -630,8 +707,9 @@ type ReadTextFormat = Omit<TextFormat, 'color' | 'textFill' | 'underlineColor' |
   textFill?: ReadTextFill;
 };
 /** A run outline read back from a deck. `color` widens for the same reason. */
-type ReadTextOutline = Omit<TextOutline, 'color'> & {
+type ReadTextOutline = Omit<TextOutline, 'color' | 'fill'> & {
   readonly color?: string;
+  readonly fill?: ReadLineFill;
 };
 /**
  * Converts a format read back from a deck into one a writer accepts. The
@@ -677,7 +755,7 @@ type ParagraphAlignmentToken = (typeof ALIGNMENT_TOKENS)[number];
 interface RunSpec {
   /**
    * Run text, written verbatim — unlike `setShapeText`, newlines are not
-   * split into paragraphs (PowerPoint shows a CR LF inside a run as a line
+   * split into paragraphs (the reference desktop app shows a CR LF inside a run as a line
    * break, which some exporters rely on).
    */
   readonly text: string;
@@ -695,7 +773,7 @@ interface ParagraphSpec {
 }
 //#endregion
 //#region src/internal/drawingml/text-3d.d.ts
-/** ECMA-376 `ST_PresetCameraType`; PowerPoint's flat WordArt uses `'orthographicFront'`. */
+/** ECMA-376 `ST_PresetCameraType`; the reference desktop app's flat text-art presets use `'orthographicFront'`. */
 type CameraPreset = (typeof CAMERA_PRESETS)[number];
 /** ECMA-376 `ST_LightRigType` (`'threePt'`, `'soft'`, `'harsh'`, ...). */
 type LightRigType = (typeof LIGHT_RIG_TYPES)[number];
@@ -721,6 +799,13 @@ interface LightRig {
 /** `<a:scene3d>`: the camera and light the 3-D text is rendered with. */
 interface Scene3D {
   readonly camera: CameraPreset;
+  /**
+   * The camera's `<a:rot>`, which overrides the preset's orientation —
+   * the reference desktop app's X / Y / Z Rotation fields.
+   */
+  readonly cameraRotation?: Rotation3D;
+  /** The camera's field of view (`fov`) in degrees, `[0, 180]`; the reference desktop app's Perspective field. */
+  readonly fieldOfViewDeg?: number;
   readonly lightRig: LightRig;
 }
 /** `CT_Bevel`. Omitted fields take the schema defaults: `circle`, 76200 × 76200 EMU. */
@@ -730,7 +815,7 @@ interface Bevel {
   readonly heightEmu?: number;
 }
 /**
- * 3-D on a text body — what PowerPoint writes for WordArt bevels. `scene`
+ * 3-D on a text body — what the reference desktop app writes for text-art bevels. `scene`
  * becomes `<a:scene3d>`; the other fields become `<a:sp3d>`, written when any
  * of them is set.
  */
@@ -738,8 +823,18 @@ interface Text3D {
   readonly scene?: Scene3D;
   /** Top bevel (`<a:bevelT>`). */
   readonly bevelTop?: Bevel;
+  /** Bottom bevel (`<a:bevelB>`). */
+  readonly bevelBottom?: Bevel;
   /** Extrusion depth (`extrusionH`) in EMU. */
   readonly extrusionHeightEmu?: number;
+  /** Extrusion color (`<a:extrusionClr>`). Same accepted forms as `TextFormat.color`. */
+  readonly extrusionColor?: Color;
+  /** Ordered adjustments to `extrusionColor`. Requires `extrusionColor`. */
+  readonly extrusionColorTransforms?: readonly ColorTransform[];
+  /** Contour width (`contourW`) in EMU. */
+  readonly contourWidthEmu?: number;
+  /** Distance from the ground (`z`) in EMU; may be negative. */
+  readonly distanceFromGroundEmu?: number;
   /** Surface material (`prstMaterial`). */
   readonly material?: PresetMaterial;
   /** Contour color (`<a:contourClr>`). Same accepted forms as `TextFormat.color`. */
@@ -747,26 +842,14 @@ interface Text3D {
   /** 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
 /**
- * ECMA-376 §20.1.10.49 `ST_PresetLineDashVal` tokens. PowerPoint's
- * "Dash type" dropdown maps to these.
+ * A 3-D read back from a deck; `contourColor` and `extrusionColor` are the raw
+ * `#RRGGBB` or scheme token.
  */
-type LineDash = 'solid' | 'dot' | 'dash' | 'lgDash' | 'dashDot' | 'lgDashDot' | 'lgDashDotDot' | 'sysDash' | 'sysDot' | 'sysDashDot' | 'sysDashDotDot';
-/** ECMA-376 §20.1.10.39 `ST_LineEndType`. */
-type LineEndType = 'none' | 'triangle' | 'stealth' | 'diamond' | 'oval' | 'arrow';
-/** ECMA-376 `ST_LineEndWidth` / `ST_LineEndLength`. */
-type LineEndSize = 'sm' | 'med' | 'lg';
-interface ArrowOptions {
-  readonly type: LineEndType;
-  readonly width?: LineEndSize;
-  readonly length?: LineEndSize;
-}
+type ReadText3D = Omit<Text3D, 'contourColor' | 'extrusionColor'> & {
+  readonly contourColor?: string;
+  readonly extrusionColor?: string;
+};
 //#endregion
 //#region src/internal/drawingml/custom-geometry.d.ts
 /** A point in the path's own coordinate space, fully evaluated. */
@@ -837,6 +920,14 @@ interface CustomGeometry {
   readonly textRect: GeomTextRect | null;
 }
 //#endregion
+//#region src/internal/drawingml/builtin-picture-styles.generated.d.ts
+/** The reference desktop app's built-in picture styles, in the order of its Picture Styles gallery. */
+declare const BUILTIN_PICTURE_STYLES: readonly ["Simple Frame, White", "Beveled Matte, White", "Metal Frame", "Drop Shadow Rectangle", "Reflected Rounded Rectangle", "Soft Edge Rectangle", "Double Frame, Black", "Thick Matte, Black", "Simple Frame, Black", "Beveled Oval, Black", "Compound Frame, Black", "Moderate Frame, Black", "Center Shadow Rectangle", "Rounded Diagonal Corner, White", "Snip Diagonal Corner, White", "Moderate Frame, White", "Rotated, White", "Perspective Shadow, White", "Relaxed Perspective, White", "Soft Edge Oval", "Bevel Rectangle", "Bevel Perspective", "Reflected Perspective Right", "Bevel Perspective Left, White", "Reflected Bevel, Black", "Reflected Bevel, White", "Metal Rounded Rectangle", "Metal Oval"];
+//#endregion
+//#region src/internal/drawingml/picture-styles.d.ts
+/** English name of one of the reference desktop app's built-in picture styles (its gallery tooltip). */
+type BuiltinPictureStyleName = (typeof BUILTIN_PICTURE_STYLES)[number];
+//#endregion
 //#region src/internal/drawingml/geometry.d.ts
 interface Position {
   /** Left edge offset from the slide origin, in EMU. */
@@ -851,43 +942,399 @@ interface Size {
   readonly h: number;
 }
 //#endregion
+//#region src/internal/presentationml/builtin-table-styles.generated.d.ts
+/** The reference desktop app’s built-in table styles, in the order of its Table Styles gallery. */
+declare const BUILTIN_TABLE_STYLES: readonly [{
+  readonly id: "{2D5ABB26-0587-4C30-8999-92F81FD0307C}";
+  readonly name: "No Style, No Grid";
+  readonly category: "bestMatch";
+}, {
+  readonly id: "{3C2FFA5D-87B4-456A-9821-1D502468CF0F}";
+  readonly name: "Themed Style 1 - Accent 1";
+  readonly category: "bestMatch";
+}, {
+  readonly id: "{284E427A-3D55-4303-BF80-6455036E1DE7}";
+  readonly name: "Themed Style 1 - Accent 2";
+  readonly category: "bestMatch";
+}, {
+  readonly id: "{69C7853C-536D-4A76-A0AE-DD22124D55A5}";
+  readonly name: "Themed Style 1 - Accent 3";
+  readonly category: "bestMatch";
+}, {
+  readonly id: "{775DCB02-9BB8-47FD-8907-85C794F793BA}";
+  readonly name: "Themed Style 1 - Accent 4";
+  readonly category: "bestMatch";
+}, {
+  readonly id: "{35758FB7-9AC5-4552-8A53-C91805E547FA}";
+  readonly name: "Themed Style 1 - Accent 5";
+  readonly category: "bestMatch";
+}, {
+  readonly id: "{08FB837D-C827-4EFA-A057-4D05807E0F7C}";
+  readonly name: "Themed Style 1 - Accent 6";
+  readonly category: "bestMatch";
+}, {
+  readonly id: "{5940675A-B579-460E-94D1-54222C63F5DA}";
+  readonly name: "No Style, Table Grid";
+  readonly category: "bestMatch";
+}, {
+  readonly id: "{D113A9D2-9D6B-4929-AA2D-F23B5EE8CBE7}";
+  readonly name: "Themed Style 2 - Accent 1";
+  readonly category: "bestMatch";
+}, {
+  readonly id: "{18603FDC-E32A-4AB5-989C-0864C3EAD2B8}";
+  readonly name: "Themed Style 2 - Accent 2";
+  readonly category: "bestMatch";
+}, {
+  readonly id: "{306799F8-075E-4A3A-A7F6-7FBC6576F1A4}";
+  readonly name: "Themed Style 2 - Accent 3";
+  readonly category: "bestMatch";
+}, {
+  readonly id: "{E269D01E-BC32-4049-B463-5C60D7B0CCD2}";
+  readonly name: "Themed Style 2 - Accent 4";
+  readonly category: "bestMatch";
+}, {
+  readonly id: "{327F97BB-C833-4FB7-BDE5-3F7075034690}";
+  readonly name: "Themed Style 2 - Accent 5";
+  readonly category: "bestMatch";
+}, {
+  readonly id: "{638B1855-1B75-4FBE-930C-398BA8C253C6}";
+  readonly name: "Themed Style 2 - Accent 6";
+  readonly category: "bestMatch";
+}, {
+  readonly id: "{9D7B26C5-4107-4FEC-AEDC-1716B250A1EF}";
+  readonly name: "Light Style 1";
+  readonly category: "light";
+}, {
+  readonly id: "{3B4B98B0-60AC-42C2-AFA5-B58CD77FA1E5}";
+  readonly name: "Light Style 1 - Accent 1";
+  readonly category: "light";
+}, {
+  readonly id: "{0E3FDE45-AF77-4B5C-9715-49D594BDF05E}";
+  readonly name: "Light Style 1 - Accent 2";
+  readonly category: "light";
+}, {
+  readonly id: "{C083E6E3-FA7D-4D7B-A595-EF9225AFEA82}";
+  readonly name: "Light Style 1 - Accent 3";
+  readonly category: "light";
+}, {
+  readonly id: "{D27102A9-8310-4765-A935-A1911B00CA55}";
+  readonly name: "Light Style 1 - Accent 4";
+  readonly category: "light";
+}, {
+  readonly id: "{5FD0F851-EC5A-4D38-B0AD-8093EC10F338}";
+  readonly name: "Light Style 1 - Accent 5";
+  readonly category: "light";
+}, {
+  readonly id: "{68D230F3-CF80-4859-8CE7-A43EE81993B5}";
+  readonly name: "Light Style 1 - Accent 6";
+  readonly category: "light";
+}, {
+  readonly id: "{7E9639D4-E3E2-4D34-9284-5A2195B3D0D7}";
+  readonly name: "Light Style 2";
+  readonly category: "light";
+}, {
+  readonly id: "{69012ECD-51FC-41F1-AA8D-1B2483CD663E}";
+  readonly name: "Light Style 2 - Accent 1";
+  readonly category: "light";
+}, {
+  readonly id: "{72833802-FEF1-4C79-8D5D-14CF1EAF98D9}";
+  readonly name: "Light Style 2 - Accent 2";
+  readonly category: "light";
+}, {
+  readonly id: "{F2DE63D5-997A-4646-A377-4702673A728D}";
+  readonly name: "Light Style 2 - Accent 3";
+  readonly category: "light";
+}, {
+  readonly id: "{17292A2E-F333-43FB-9621-5CBBE7FDCDCB}";
+  readonly name: "Light Style 2 - Accent 4";
+  readonly category: "light";
+}, {
+  readonly id: "{5A111915-BE36-4E01-A7E5-04B1672EAD32}";
+  readonly name: "Light Style 2 - Accent 5";
+  readonly category: "light";
+}, {
+  readonly id: "{912C8C85-51F0-491E-9774-3900AFEF0FD7}";
+  readonly name: "Light Style 2 - Accent 6";
+  readonly category: "light";
+}, {
+  readonly id: "{616DA210-FB5B-4158-B5E0-FEB733F419BA}";
+  readonly name: "Light Style 3";
+  readonly category: "light";
+}, {
+  readonly id: "{BC89EF96-8CEA-46FF-86C4-4CE0E7609802}";
+  readonly name: "Light Style 3 - Accent 1";
+  readonly category: "light";
+}, {
+  readonly id: "{5DA37D80-6434-44D0-A028-1B22A696006F}";
+  readonly name: "Light Style 3 - Accent 2";
+  readonly category: "light";
+}, {
+  readonly id: "{8799B23B-EC83-4686-B30A-512413B5E67A}";
+  readonly name: "Light Style 3 - Accent 3";
+  readonly category: "light";
+}, {
+  readonly id: "{ED083AE6-46FA-4A59-8FB0-9F97EB10719F}";
+  readonly name: "Light Style 3 - Accent 4";
+  readonly category: "light";
+}, {
+  readonly id: "{BDBED569-4797-4DF1-A0F4-6AAB3CD982D8}";
+  readonly name: "Light Style 3 - Accent 5";
+  readonly category: "light";
+}, {
+  readonly id: "{E8B1032C-EA38-4F05-BA0D-38AFFFC7BED3}";
+  readonly name: "Light Style 3 - Accent 6";
+  readonly category: "light";
+}, {
+  readonly id: "{793D81CF-94F2-401A-BA57-92F5A7B2D0C5}";
+  readonly name: "Medium Style 1";
+  readonly category: "medium";
+}, {
+  readonly id: "{B301B821-A1FF-4177-AEE7-76D212191A09}";
+  readonly name: "Medium Style 1 - Accent 1";
+  readonly category: "medium";
+}, {
+  readonly id: "{9DCAF9ED-07DC-4A11-8D7F-57B35C25682E}";
+  readonly name: "Medium Style 1 - Accent 2";
+  readonly category: "medium";
+}, {
+  readonly id: "{1FECB4D8-DB02-4DC6-A0A2-4F2EBAE1DC90}";
+  readonly name: "Medium Style 1 - Accent 3";
+  readonly category: "medium";
+}, {
+  readonly id: "{1E171933-4619-4E11-9A3F-F7608DF75F80}";
+  readonly name: "Medium Style 1 - Accent 4";
+  readonly category: "medium";
+}, {
+  readonly id: "{FABFCF23-3B69-468F-B69F-88F6DE6A72F2}";
+  readonly name: "Medium Style 1 - Accent 5";
+  readonly category: "medium";
+}, {
+  readonly id: "{10A1B5D5-9B99-4C35-A422-299274C87663}";
+  readonly name: "Medium Style 1 - Accent 6";
+  readonly category: "medium";
+}, {
+  readonly id: "{073A0DAA-6AF3-43AB-8588-CEC1D06C72B9}";
+  readonly name: "Medium Style 2";
+  readonly category: "medium";
+}, {
+  readonly id: "{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}";
+  readonly name: "Medium Style 2 - Accent 1";
+  readonly category: "medium";
+}, {
+  readonly id: "{21E4AEA4-8DFA-4A89-87EB-49C32662AFE0}";
+  readonly name: "Medium Style 2 - Accent 2";
+  readonly category: "medium";
+}, {
+  readonly id: "{F5AB1C69-6EDB-4FF4-983F-18BD219EF322}";
+  readonly name: "Medium Style 2 - Accent 3";
+  readonly category: "medium";
+}, {
+  readonly id: "{00A15C55-8517-42AA-B614-E9B94910E393}";
+  readonly name: "Medium Style 2 - Accent 4";
+  readonly category: "medium";
+}, {
+  readonly id: "{7DF18680-E054-41AD-8BC1-D1AEF772440D}";
+  readonly name: "Medium Style 2 - Accent 5";
+  readonly category: "medium";
+}, {
+  readonly id: "{93296810-A885-4BE3-A3E7-6D5BEEA58F35}";
+  readonly name: "Medium Style 2 - Accent 6";
+  readonly category: "medium";
+}, {
+  readonly id: "{8EC20E35-A176-4012-BC5E-935CFFF8708E}";
+  readonly name: "Medium Style 3";
+  readonly category: "medium";
+}, {
+  readonly id: "{6E25E649-3F16-4E02-A733-19D2CDBF48F0}";
+  readonly name: "Medium Style 3 - Accent 1";
+  readonly category: "medium";
+}, {
+  readonly id: "{85BE263C-DBD7-4A20-BB59-AAB30ACAA65A}";
+  readonly name: "Medium Style 3 - Accent 2";
+  readonly category: "medium";
+}, {
+  readonly id: "{EB344D84-9AFB-497E-A393-DC336BA19D2E}";
+  readonly name: "Medium Style 3 - Accent 3";
+  readonly category: "medium";
+}, {
+  readonly id: "{EB9631B5-78F2-41C9-869B-9F39066F8104}";
+  readonly name: "Medium Style 3 - Accent 4";
+  readonly category: "medium";
+}, {
+  readonly id: "{74C1A8A3-306A-4EB7-A6B1-4F7E0EB9C5D6}";
+  readonly name: "Medium Style 3 - Accent 5";
+  readonly category: "medium";
+}, {
+  readonly id: "{2A488322-F2BA-4B5B-9748-0D474271808F}";
+  readonly name: "Medium Style 3 - Accent 6";
+  readonly category: "medium";
+}, {
+  readonly id: "{D7AC3CCA-C797-4891-BE02-D94E43425B78}";
+  readonly name: "Medium Style 4";
+  readonly category: "medium";
+}, {
+  readonly id: "{69CF1AB2-1976-4502-BF36-3FF5EA218861}";
+  readonly name: "Medium Style 4 - Accent 1";
+  readonly category: "medium";
+}, {
+  readonly id: "{8A107856-5554-42FB-B03E-39F5DBC370BA}";
+  readonly name: "Medium Style 4 - Accent 2";
+  readonly category: "medium";
+}, {
+  readonly id: "{0505E3EF-67EA-436B-97B2-0124C06EBD24}";
+  readonly name: "Medium Style 4 - Accent 3";
+  readonly category: "medium";
+}, {
+  readonly id: "{C4B1156A-380E-4F78-BDF5-A606A8083BF9}";
+  readonly name: "Medium Style 4 - Accent 4";
+  readonly category: "medium";
+}, {
+  readonly id: "{22838BEF-8BB2-4498-84A7-C5851F593DF1}";
+  readonly name: "Medium Style 4 - Accent 5";
+  readonly category: "medium";
+}, {
+  readonly id: "{16D9F66E-5EB9-4882-86FB-DCBF35E3C3E4}";
+  readonly name: "Medium Style 4 - Accent 6";
+  readonly category: "medium";
+}, {
+  readonly id: "{E8034E78-7F5D-4C2E-B375-FC64B27BC917}";
+  readonly name: "Dark Style 1";
+  readonly category: "dark";
+}, {
+  readonly id: "{125E5076-3810-47DD-B79F-674D7AD40C01}";
+  readonly name: "Dark Style 1 - Accent 1";
+  readonly category: "dark";
+}, {
+  readonly id: "{37CE84F3-28C3-443E-9E96-99CF82512B78}";
+  readonly name: "Dark Style 1 - Accent 2";
+  readonly category: "dark";
+}, {
+  readonly id: "{D03447BB-5D67-496B-8E87-E561075AD55C}";
+  readonly name: "Dark Style 1 - Accent 3";
+  readonly category: "dark";
+}, {
+  readonly id: "{E929F9F4-4A8F-4326-A1B4-22849713DDAB}";
+  readonly name: "Dark Style 1 - Accent 4";
+  readonly category: "dark";
+}, {
+  readonly id: "{8FD4443E-F989-4FC4-A0C8-D5A2AF1F390B}";
+  readonly name: "Dark Style 1 - Accent 5";
+  readonly category: "dark";
+}, {
+  readonly id: "{AF606853-7671-496A-8E4F-DF71F8EC918B}";
+  readonly name: "Dark Style 1 - Accent 6";
+  readonly category: "dark";
+}, {
+  readonly id: "{5202B0CA-FC54-4496-8BCA-5EF66A818D29}";
+  readonly name: "Dark Style 2";
+  readonly category: "dark";
+}, {
+  readonly id: "{0660B408-B3CF-4A94-85FC-2B1E0A45F4A2}";
+  readonly name: "Dark Style 2 - Accent 1/Accent 2";
+  readonly category: "dark";
+}, {
+  readonly id: "{91EBBBCC-DAD2-459C-BE2E-F6DE35CF9A28}";
+  readonly name: "Dark Style 2 - Accent 3/Accent 4";
+  readonly category: "dark";
+}, {
+  readonly id: "{46F890A9-2807-4EBB-B81D-B2AA78EC7F39}";
+  readonly name: "Dark Style 2 - Accent 5/Accent 6";
+  readonly category: "dark";
+}];
+//#endregion
+//#region src/internal/presentationml/table-styles.d.ts
+/** English name the reference desktop app writes as `styleName` for a built-in table style. */
+type BuiltinTableStyleName = (typeof BUILTIN_TABLE_STYLES)[number]['name'];
+/** One entry of {@link BUILTIN_TABLE_STYLES}. */
+type BuiltinTableStyle = (typeof BUILTIN_TABLE_STYLES)[number];
+//#endregion
+//#region src/internal/presentationml/default-masters.d.ts
+type MasterPlaceholderType = 'title' | 'body' | 'dt' | 'ftr' | 'sldNum';
+/** Insert Placeholder's menu, in the reference desktop app's order. */
+type LayoutPlaceholderKind = 'content' | 'verticalContent' | 'text' | 'verticalText' | 'picture' | 'chart' | 'table' | 'smartArt' | 'media' | 'onlineImage';
+type NotesMasterPlaceholderType = 'hdr' | 'dt' | 'sldImg' | 'body' | 'ftr' | 'sldNum';
+type HandoutMasterPlaceholderType = 'hdr' | 'dt' | 'ftr' | 'sldNum';
+//#endregion
 //#region src/internal/presentationml/transition-builder.d.ts
+type TransitionSpeed = 'slow' | 'med' | 'fast';
 /**
  * Every transition effect element name in `CT_SlideTransition`'s choice
- * (ECMA-376 pml.xsd). The token is emitted verbatim as `<p:{token}/>`, so this
- * list is both the type's domain and the write-time validation domain —
- * keeping them one declaration stops them drifting apart.
+ * (ECMA-376 pml.xsd), emitted verbatim as `<p:{token}/>`.
  */
-declare const TRANSITION_EFFECTS: readonly ["blinds", "checker", "circle", "dissolve", "comb", "cover", "cut", "diamond", "fade", "newsflash", "plus", "pull", "push", "random", "randomBar", "split", "strips", "wedge", "wheel", "wipe", "zoom"];
 /**
- * Transition effect token. Maps to a `<p:{token}/>` child of
- * `<p:transition>`, except `'none'`: that is the library-level sentinel for
- * "no effect element", which the schema's choice has no member for.
+ * Every effect element `setSlideTransition` writes, ECMA-376 and extensions
+ * alike. The list is both the type's domain and the write-time validation
+ * domain — keeping them one declaration stops them drifting apart.
+ */
+declare const TRANSITION_EFFECTS: readonly ["blinds", "checker", "circle", "dissolve", "comb", "cover", "cut", "diamond", "fade", "newsflash", "plus", "pull", "push", "random", "randomBar", "split", "strips", "wedge", "wheel", "wipe", "zoom", "conveyor", "doors", "ferris", "flash", "flip", "flythrough", "gallery", "glitter", "honeycomb", "pan", "prism", "reveal", "ripple", "shred", "switch", "vortex", "warp", "wheelReverse", "window", "prstTrans", "morph"];
+/**
+ * Transition effect token. Maps to the `<p:{token}/>` (or `<p14:…>`,
+ * `<p15:prstTrans>`, `<p159:morph>`) child of `<p:transition>`, except
+ * `'none'`: that is the library-level sentinel for "no effect element", which
+ * the schema's choice has no member for.
  */
 type TransitionEffect = 'none' | (typeof TRANSITION_EFFECTS)[number];
+/**
+ * The `prst` names [MS-PPTX] §2.4.3.8 defines for `p15:prstTrans`. The
+ * attribute is an `xsd:string` naming "the internal resource to use", so a
+ * name outside this list is one the reference desktop app has no transition for.
+ */
+declare const TRANSITION_PRESETS: readonly ["fallOver", "drape", "curtains", "wind", "prestige", "fracture", "crush", "peelOff", "pageCurlDouble", "pageCurlSingle", "airplane", "origami"];
+/** A `p15:prstTrans` preset name. */
+type TransitionPreset = (typeof TRANSITION_PRESETS)[number];
+/** ST_TransitionMorphOption ([MS-PPTX] §2.6.4.1): what Morph matches between slides. */
+type MorphOption = 'byObject' | 'byWord' | 'byChar';
 interface TransitionOptions {
   effect: TransitionEffect;
-  /** Effect speed. Defaults to omitted (PowerPoint treats absence as `med`). */
-  speed?: 'slow' | 'med' | 'fast';
+  /**
+   * Effect speed: 0.5 s (`fast`), 0.75 s (`med`) or 1 s (`slow`). Omitted, it
+   * is the schema default `fast` (ECMA-376 pml.xsd, CT_SlideTransition).
+   */
+  speed?: TransitionSpeed;
   /**
    * Direction, valid only for effects that carry a `dir` attribute and only
-   * within that effect's domain (validated on write):
-   *   - `blinds`/`checker`/`comb`/`randomBar`: `horz` | `vert`
-   *   - `push`/`wipe`: `l` | `r` | `u` | `d`
+   * within that effect's domain (validated on write). The side tokens name
+   * the way the slide moves, so the reference desktop app's "From Right" is `l`.
+   *   - `blinds`/`checker`/`comb`/`randomBar`/`doors`/`window`: `horz` | `vert`
+   *   - `push`/`wipe`/`vortex`/`pan`/`glitter`/`prism`: `l` | `r` | `u` | `d`
    *   - `cover`/`pull`: the above plus `lu` | `ru` | `ld` | `rd`
    *   - `strips`: `lu` | `ru` | `ld` | `rd`
-   *   - `zoom`/`split`: `in` | `out`
+   *   - `ripple`: `center` | `lu` | `ru` | `ld` | `rd`
+   *   - `switch`/`flip`/`ferris`/`gallery`/`conveyor`/`reveal`: `l` | `r`
+   *   - `zoom`/`split`/`warp`/`flythrough`/`shred`: `in` | `out`
    * A mismatched effect/direction pair throws; on any other effect a stray
    * `direction` is ignored.
    */
   direction?: string;
-  /** For `wheel`: number of spokes (unsigned integer). Omitted means 4. */
+  /** For `wheel` and `wheelReverse`: 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. */
+  /** For `fade`, `cut` and `reveal`: pass `true` to go through black. */
   thruBlack?: boolean;
-  /** Whether clicking advances; default `true` (PowerPoint's default). */
+  /**
+   * For `glitter`: `diamond` (the default) or `hexagon`. For `shred`: `strip`
+   * (the default) or `rectangle` — the reference desktop app's "Strips" and "Particles".
+   */
+  pattern?: 'diamond' | 'hexagon' | 'strip' | 'rectangle';
+  /**
+   * For `prism`: the slide's content turns rather than the slide itself
+   * (the reference desktop app's Rotate and Orbit, against Cube and Box).
+   */
+  isContent?: boolean;
+  /** For `prism`: the turn faces inwards (the reference desktop app's Box and Orbit). */
+  isInverted?: boolean;
+  /** For `flythrough`: the slides bounce at the end. */
+  hasBounce?: boolean;
+  /** For `prstTrans`: which preset transition. Required for that effect. */
+  preset?: TransitionPreset;
+  /** For `prstTrans`: mirror the preset left to right ("Right" instead of "Left"). */
+  invertX?: boolean;
+  /** For `prstTrans`: mirror the preset top to bottom. */
+  invertY?: boolean;
+  /** For `morph`: what is matched between the slides. Defaults to `byObject`. */
+  morphOption?: MorphOption;
+  /** Whether clicking advances; default `true` (the reference desktop app's default). */
   advanceOnClick?: boolean;
   /**
    * Milliseconds to auto-advance after this slide. Omit for click-only
@@ -895,53 +1342,157 @@ interface TransitionOptions {
    */
   advanceAfterMs?: number;
   /**
-   * Effect duration in milliseconds (PowerPoint 2010's `p14:dur`). ECMA-376
+   * Effect duration in milliseconds (`p14:dur`, [MS-PPTX]). 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`.
+   * the reference desktop app writes it:
+   *   - `spd` is the fastest speed at least this long (≤ 500 ms `fast`,
+   *     ≤ 750 ms `med`, otherwise `slow`) unless `speed` is given; a derived
+   *     `fast` is left out, being the schema default.
+   *   - A duration equal to its speed's own (500, 750 or 1000 ms) is that
+   *     speed alone: no `p14:dur`, and it reads back as `speed`.
+   *   - Any other duration is an `mc:AlternateContent` whose `p14` choice
+   *     carries `p14:dur` and whose fallback carries only `spd`.
    */
   durationMs?: number;
 }
 /**
  * A transition read back from a deck. `effect` widens to `string` because a
  * file authored elsewhere can carry an effect element this library does not
- * model; writing one still requires a `TransitionEffect`.
+ * model; writing one still requires a `TransitionEffect`. `preset` widens the
+ * same way.
  */
-type SlideTransition = Omit<TransitionOptions, 'effect'> & {
+type SlideTransition = Omit<TransitionOptions, 'effect' | 'preset'> & {
   effect: string;
+  preset?: string;
+};
+//#endregion
+//#region src/internal/presentationml/animation-emphasis-options.d.ts
+/** Which way Spin turns — the reference desktop app's Effect Options "Direction". */
+type AnimationSpinDirection = 'clockwise' | 'counterclockwise';
+/**
+ * Which way Grow/Shrink scales: both axes, or only the width (`'horizontal'`)
+ * or only the height (`'vertical'`).
+ */
+type AnimationScaleDirection = 'both' | 'horizontal' | 'vertical';
+/**
+ * The colour a colour emphasis effect changes to: a theme slot or an sRGB
+ * value, optionally with DrawingML colour transforms — the tints and shades
+ * of a theme colour palette are `lumMod` / `lumOff` on the theme slot.
+ */
+type AnimationColor = Color | {
+  readonly color: Color;
+  readonly colorTransforms?: readonly ColorTransform[];
 };
 //#endregion
 //#region src/internal/presentationml/animation-builder.d.ts
 /**
- * What kind of effect to apply.
+ * What kind of effect to apply — one token per entry of the reference desktop app's Entrance,
+ * Emphasis and Exit galleries, named after the gallery entry.
  *
- * 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.
+ * Entrance effects put the shape on the slide and end in `In` (`appear` aside);
+ * exit effects take it off and end in `Out` (`disappear` aside). Emphasis
+ * effects animate a shape that is already on the slide and never decide
+ * whether it is shown.
+ *
+ * Where a gallery name would not tell two presets apart, the token does:
+ * `zoomIn` is the reference desktop app's "Zoom" (preset 53, which fades as it grows) and
+ * `basicZoomIn` its "Basic Zoom" (preset 23); `floatIn` / `floatOut` are
+ * "Float In" / "Float Out" (preset 42) and `floatingIn` / `floatingOut` the
+ * "Float" entrance and exit (preset 30).
  */
-type AnimationEffect = 'appear' | 'fadeIn' | 'flyIn' | 'zoomIn' | 'disappear' | 'fadeOut' | 'flyOut' | 'zoomOut' | 'spin';
+type AnimationEffect = 'appear' | 'blindsIn' | 'checkerboardIn' | 'dissolveIn' | 'flyIn' | 'peekIn' | 'randomBarsIn' | 'shapeIn' | 'splitIn' | 'stripsIn' | 'wedgeIn' | 'wheelIn' | 'wipeIn' | 'expandIn' | 'fadeIn' | 'swivelIn' | 'zoomIn' | 'centerRevolveIn' | 'floatIn' | 'growTurnIn' | 'riseUpIn' | 'spinnerIn' | 'basicZoomIn' | 'stretchIn' | 'boomerangIn' | 'bounceIn' | 'creditsIn' | 'curveUpIn' | 'dropIn' | 'flipIn' | 'floatingIn' | 'pinwheelIn' | 'spiralIn' | 'basicSwivelIn' | 'whipIn' | 'blindsOut' | 'checkerboardOut' | 'disappear' | 'dissolveOut' | 'flyOut' | 'peekOut' | 'randomBarsOut' | 'shapeOut' | 'splitOut' | 'stripsOut' | 'wedgeOut' | 'wheelOut' | 'wipeOut' | 'contractOut' | 'fadeOut' | 'swivelOut' | 'zoomOut' | 'centerRevolveOut' | 'collapseOut' | 'floatOut' | 'shrinkTurnOut' | 'sinkDownOut' | 'spinnerOut' | 'basicZoomOut' | 'stretchyOut' | 'boomerangOut' | 'bounceOut' | 'creditsOut' | 'curveDownOut' | 'dropOut' | 'flipOut' | 'floatingOut' | 'pinwheelOut' | 'spiralOut' | 'basicSwivelOut' | 'whipOut' | 'fillColor' | 'fontColor' | 'growShrink' | 'lineColor' | 'spin' | 'transparency' | 'boldFlash' | 'brushColor' | 'complementaryColor' | 'complementaryColor2' | 'contrastingColor' | 'darken' | 'desaturate' | 'lighten' | 'objectColor' | 'pulse' | 'underline' | 'colorPulse' | 'growWithColor' | 'shimmer' | 'teeter' | 'blink' | 'boldReveal' | 'wave';
 /**
  * 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';
+ * the reference desktop app's "From Bottom" / Google Slides' "Fly in from bottom" — or, for
+ * the four corners, the corner. A wipe or a peek names an edge too; strips
+ * name a corner.
+ */
+type AnimationDirection = 'top' | 'right' | 'bottom' | 'left' | 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight';
+/** Which way blinds, random bars and a split run — and a checkerboard: across or down. */
+type AnimationOrientation = 'horizontal' | 'vertical';
+/** Whether a shape or split effect opens from the centre outwards or closes inwards. */
+type AnimationInOut = 'in' | 'out';
+/** The outline a `shapeIn` / `shapeOut` reveals the object through. */
+type AnimationShape = 'circle' | 'box' | 'diamond' | 'plus';
+/**
+ * How an effect on a shape with text treats the text — the reference desktop app's Effect
+ * Options "Sequence":
+ *
+ *   - `'asOneObject'` animates the shape and its text together, as one effect.
+ *   - `'allAtOnce'` gives each paragraph an effect of its own, all starting
+ *     together (`<p:bldP build="allAtOnce">`).
+ *   - `'byParagraph'` gives each paragraph an effect of its own, one click (or
+ *     start condition) apiece (`<p:bldP build="p">`).
+ */
+type AnimationTextBuild = 'asOneObject' | 'allAtOnce' | 'byParagraph';
 /** 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;
   /**
-   * 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.
+   * Which edge of the slide a `'flyIn'` comes from, or a `'flyOut'` leaves by
+   * — any of the eight. `'wipeIn'`, `'wipeOut'`, `'peekIn'` and `'peekOut'`
+   * take one of the four edges, `'stripsIn'` and `'stripsOut'` one of the four
+   * corners. Defaults to the reference desktop app's own default for the preset (`'bottom'`;
+   * `'bottomLeft'` for strips). Passing it for an effect that takes no
+   * direction is an error rather than a no-op: it would otherwise read as a
+   * direction the file never records. The same holds for the options below.
    */
   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.
+   * For blinds, random bars and split: which way the bars run. For a
+   * checkerboard, `'horizontal'` is the reference desktop app's "Across" and `'vertical'` its
+   * "Down". Defaults to `'horizontal'` (`'vertical'` for split).
+   */
+  readonly orientation?: AnimationOrientation;
+  /**
+   * For shape and split: open from the centre (`'out'`) or close in on it
+   * (`'in'`). Defaults to `'in'` — `'out'` for `'shapeOut'`, as in the reference desktop app.
+   */
+  readonly inOut?: AnimationInOut;
+  /** For `'shapeIn'` / `'shapeOut'`: the outline. Defaults to `'circle'`. */
+  readonly shape?: AnimationShape;
+  /** For `'wheelIn'` / `'wheelOut'`: 1, 2, 3, 4 or 8 spokes. Defaults to 1. */
+  readonly spokes?: number;
+  /** For `'spin'`: which way it turns. Defaults to `'clockwise'`. */
+  readonly spinDirection?: AnimationSpinDirection;
+  /**
+   * For `'spin'`: how far it turns, in degrees. The reference desktop app's menu offers 90
+   * (Quarter Spin), 180 (Half Spin), 360 (Full Spin, the default) and 720
+   * (Two Spins); any positive angle can be written.
+   */
+  readonly spinDegrees?: number;
+  /**
+   * For `'growShrink'`: scale both axes (the default), or only the width
+   * (`'horizontal'`) or only the height (`'vertical'`).
+   */
+  readonly scaleDirection?: AnimationScaleDirection;
+  /**
+   * For `'growShrink'`: the size to reach, in percent of the shape's own.
+   * The reference desktop app's menu offers 25 (Tiny), 50 (Smaller), 150 (Larger, the
+   * default) and 400 (Huge).
+   */
+  readonly scalePercent?: number;
+  /**
+   * For `'transparency'`: how transparent the shape becomes, 0–100. The reference desktop app
+   * offers 25, 50 (the default), 75 and 100.
+   */
+  readonly transparencyPercent?: number;
+  /**
+   * For the colour emphasis effects — `'fillColor'`, `'fontColor'`,
+   * `'lineColor'`, `'brushColor'`, `'objectColor'`, `'colorPulse'` and
+   * `'growWithColor'` — the colour to change to. Defaults to Accent 2, and to
+   * Background 1 for `'colorPulse'`, as the reference desktop app's gallery does.
+   */
+  readonly color?: AnimationColor;
+  /**
+   * How long the effect runs, in milliseconds. Defaults to the reference desktop app's default
+   * for the preset (`defaultAnimationDurationMs`). An effect made of several
+   * behaviours is scaled as a whole, the way the reference desktop app's Duration box does.
+   * `'appear'` and `'disappear'` are instantaneous and write no timed
+   * behaviour, so it does not reach them; `'transparency'` and `'boldReveal'`
+   * hold until the end of the slide and take none.
    */
   readonly durationMs?: number;
   /**
@@ -955,12 +1506,13 @@ interface AnimationOptions {
   /** 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.
+   * How the shape's text is animated — the reference desktop app's Effect Options "Sequence".
+   * Defaults to `'asOneObject'`, the gallery's own default. `'allAtOnce'` and
+   * `'byParagraph'` give every paragraph an effect of its own: started together
+   * for the first, each on its own start (a click apiece by default) for the
+   * second. Fill Color and Line Color animate the shape and take neither.
    */
-  readonly byParagraph?: boolean;
+  readonly build?: AnimationTextBuild;
 }
 //#endregion
 //#region src/internal/presentationml/comments-part.d.ts
@@ -1112,15 +1664,15 @@ type PresentationSize = '16:9' | '4:3';
 /**
  * Creates a fresh, immediately-authorable `PresentationData`.
  *
- * The returned deck carries a slide master, the Office theme, and three
+ * The returned deck carries a slide master, the default theme, and three
  * slide layouts — `'Blank'`, `'Title Slide'`, and `'Title and Content'` —
  * but no slides yet. Add one with {@link addSlide} (or the
  * `addBlankSlide` / `addTitleSlide` / `addContentSlide` helpers), then
- * `savePresentation` to emit a `.pptx` that opens cleanly in PowerPoint,
+ * `savePresentation` to emit a `.pptx` that opens cleanly in the reference desktop app,
  * Keynote, Google Slides, and LibreOffice.
  *
  * @param options.size Slide aspect ratio. `'16:9'` (12192000×6858000 EMU,
- *   PowerPoint's modern default) or `'4:3'` (9144000×6858000). Defaults to
+ *   The reference desktop app's modern default) or `'4:3'` (9144000×6858000). Defaults to
  *   `'16:9'`.
  */
 declare const createPresentation: (options?: {
@@ -1148,7 +1700,7 @@ interface SlideSection {
 declare const getSlideSections: (pres: PresentationData) => ReadonlyArray<SlideSection>;
 /**
  * Replaces the deck's section list with `sections`. Each section is
- * given a fresh GUID `id` attribute (PowerPoint generates one per
+ * given a fresh GUID `id` attribute (the reference desktop app generates one per
  * section; we synthesize a deterministic-ish one based on index +
  * timestamp for v1).
  *
@@ -1209,6 +1761,21 @@ declare const getShapeAdjustValues: (shape: SlideShapeData) => Record<string, nu
  * this when it gets `null`.
  */
 declare const getShapeCustomGeometry: (shape: SlideShapeData) => CustomGeometry | null;
+/**
+ * Evaluates a preset shape's outline (`<a:prstGeom>`, ECMA-376 §20.1.9.18)
+ * at `size`, from the standard's own preset definitions: the same paths,
+ * shading modes (`lighten` / `darken` …) and text rectangle the reference desktop app uses.
+ * The result has the shape of {@link getShapeCustomGeometry}'s, so a
+ * renderer draws presets and custom geometry the same way.
+ *
+ * `adjustValues` are the shape's adjust handles (`getShapeAdjustValues`);
+ * each replaces the preset default of the same name. Returns `null` for a
+ * preset name ECMA-376 does not define.
+ */
+declare const getPresetGeometry: (preset: PresetShape | string, size: {
+  readonly w: Emu;
+  readonly h: Emu;
+}, adjustValues?: Readonly<Record<string, number>>) => CustomGeometry | null;
 /**
  * Returns the highest `cNvPr@id` used by any shape on the slide,
  * or `0` when the slide has no shapes with non-negative ids.
@@ -1276,13 +1843,13 @@ declare const getUnusedSlideMasters: (pres: PresentationData) => ReadonlyArray<s
 declare const getShapeName: (shape: SlideShapeData) => string;
 /**
  * Renames the shape's `cNvPr@name`. The display name is what
- * PowerPoint shows in the Selection Pane and what `findShapeByName`
- * matches on. Empty strings are allowed (matches PowerPoint behavior).
+ * the reference desktop app shows in the Selection Pane and what `findShapeByName`
+ * matches on. Empty strings are allowed (matches the reference desktop app's behavior).
  */
 /**
  * Reads the shape's alt-text description (`<p:cNvPr descr="...">`).
  * Accessibility tools (screen readers, contrast checkers) and
- * PowerPoint's "Alt Text" pane look at this field. Returns `null`
+ * the reference desktop app's "Alt Text" pane look at this field. Returns `null`
  * when no description is set.
  */
 declare const getShapeDescription: (shape: SlideShapeData) => string | null;
@@ -1295,7 +1862,7 @@ declare const getShapeDescription: (shape: SlideShapeData) => string | null;
 declare const setShapeDescription: (shape: SlideShapeData, description: string | null) => void;
 /**
  * Reads the shape's alt-text title (`<p:cNvPr title="...">`).
- * PowerPoint surfaces this alongside `descr` in its Alt Text pane
+ * The reference desktop app surfaces this alongside `descr` in its Alt Text pane
  * as a short heading. Returns `null` when no title is set.
  */
 declare const getShapeAltTitle: (shape: SlideShapeData) => string | null;
@@ -1307,17 +1874,18 @@ declare const getShapeAltTitle: (shape: SlideShapeData) => string | null;
 declare const setShapeAltTitle: (shape: SlideShapeData, title: string | null) => void;
 /**
  * `true` when the shape's `<p:cNvPr hidden="1">` is set. Hidden
- * shapes are skipped by PowerPoint's renderer but stay in the
+ * shapes are skipped by the reference desktop app's renderer but stay in the
  * shape tree — useful for variant slides that toggle which boxes
  * are visible.
  */
 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.
+ * shapes remain in the document but the reference desktop app doesn't render them.
  */
 declare function setShapeHidden(shape: SlideShapeData, hidden: boolean): void;
 declare function setShapeHidden(shapes: readonly SlideShapeData[], hidden: boolean): void;
+/** Renames the shape: the name the Selection Pane shows (`<p:cNvPr name>`). */
 declare const renameShape: (shape: SlideShapeData, newName: string) => void;
 declare const getShapePlaceholderType: (shape: SlideShapeData) => string | null;
 declare const getShapePlaceholderIdx: (shape: SlideShapeData) => number | null;
@@ -1331,7 +1899,7 @@ declare const getShapePlaceholderIdx: (shape: SlideShapeData) => number | null;
 declare const isShapePlaceholder: (shape: SlideShapeData) => boolean;
 /**
  * `true` when the shape is a **text box** (`<p:cNvSpPr txBox="1">`) rather than
- * an autoshape. The distinction drives default text formatting: PowerPoint /
+ * an autoshape. The distinction drives default text formatting: the reference desktop app and
  * LibreOffice left-align and top-anchor text-box text, but center-align and
  * middle-anchor autoshape text when the deck author left those unset.
  */
@@ -1467,7 +2035,7 @@ declare const getSlideShapes: (slide: SlideData) => ReadonlyArray<SlideShapeData
 /**
  * Rebinds the slide to a different layout. The slide's own content
  * (shapes, text, geometry) is preserved verbatim; only the
- * `slideLayout` rel is updated so PowerPoint re-renders with the new
+ * `slideLayout` rel is updated so the reference desktop app re-renders with the new
  * layout's placeholder positions and theme.
  *
  * The new layout must already be a part of the package — pass one
@@ -1620,7 +2188,7 @@ declare const findShapeInPresentation: (pres: PresentationData, name: string | R
  *
  * Tokens must fit within a single text run (see `replaceTokensInTree`
  * in `drawingml/`). Cross-run replacements aren't supported — use
- * `findSlidePlaceholder` + a setText path when PowerPoint has
+ * `findSlidePlaceholder` + a setText path when the reference desktop app has
  * fragmented the run sequence.
  */
 declare const replaceTokensInSlide: (slide: SlideData, tokens: Record<string, string>) => number;
@@ -1646,6 +2214,8 @@ type ShapeFill = {
  * Reads back the shape's stroke (`<a:ln>`). Returns:
  *
  *   - `{ kind: 'solid', color, widthEmu? }` for a solid-color outline.
+ *   - `{ kind: 'gradient', widthEmu? }` for a gradient line; read its stops
+ *     with `getShapeStrokeGradient`.
  *   - `{ kind: 'none' }` when an `<a:noFill>` sits inside `<a:ln>`.
  *   - `{ kind: 'inherit' }` when no `<a:ln>` is present.
  */
@@ -1653,6 +2223,9 @@ type ShapeStroke = {
   readonly kind: 'solid';
   readonly color: string;
   readonly widthEmu?: number;
+} | {
+  readonly kind: 'gradient';
+  readonly widthEmu?: number;
 } | {
   readonly kind: 'none';
 } | {
@@ -1679,7 +2252,7 @@ declare const getShapeStrokeWidth: (shape: SlideShapeData) => number | null;
  *
  * Companion to `getShapeStrokeColor`, which surfaces only the raw
  * `#RRGGBB` / `scheme:<token>` string — fine for round-tripping but
- * wrong for rendering, because PowerPoint paints the *transformed*
+ * wrong for rendering, because the reference desktop app paints the *transformed*
  * color, not the base one.
  */
 declare const getShapeStrokeColorResolved: (pres: PresentationData, shape: SlideShapeData) => string | null;
@@ -1687,7 +2260,7 @@ declare const getShapeStrokeColorResolved: (pres: PresentationData, shape: Slide
  * Returns the opacity (`0`–`1`) of the shape's own solid outline, read from
  * the `<a:alpha>` / `<a:alphaMod>` / `<a:alphaOff>` children of its color
  * element, or `null` when the outline isn't a solid color or carries no
- * alpha transform (PowerPoint draws it fully opaque). Companion to
+ * alpha transform (the reference desktop app draws it fully opaque). Companion to
  * `getShapeStrokeColorResolved`, which never carries the alpha channel.
  */
 declare const getShapeStrokeOpacity: (shape: SlideShapeData, pres?: PresentationData) => number | null;
@@ -1715,6 +2288,14 @@ declare const getShapeStrokeCompound: (shape: SlideShapeData, pres?: Presentatio
  * stroke layer wins.
  */
 declare const getShapeStrokeEffective: (pres: PresentationData, shape: SlideShapeData) => ShapeStroke;
+/**
+ * Returns the full gradient (`stops`, direction, rotation) of a gradient line,
+ * or `null` when the line is not one. Without `pres` only the shape's own
+ * `<a:ln>` is read; with it, the line `getShapeStrokeEffective` resolves —
+ * style matrix and placeholder cascade included — and every stop carries its
+ * theme- and transform-resolved `resolvedColor`.
+ */
+declare const getShapeStrokeGradient: (shape: SlideShapeData, pres?: PresentationData) => ReadGradientFill | null;
 declare const getShapeStroke: (shape: SlideShapeData) => ShapeStroke;
 /**
  * Convenience over `getShapeFill(shape)`: returns the solid-fill
@@ -1733,14 +2314,14 @@ declare const getShapeFillColor: (shape: SlideShapeData) => string | null;
  *
  * Companion to `getShapeFillColor`, which surfaces only the raw
  * `#RRGGBB` / `scheme:<token>` string. Renderers and exporters that
- * need the color PowerPoint actually paints should call this.
+ * need the color the reference desktop app actually paints should call this.
  */
 declare const getShapeFillColorResolved: (pres: PresentationData, shape: SlideShapeData) => string | null;
 /**
  * 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
+ * transform (the reference desktop app paints it fully opaque). Companion to
  * `getShapeFillColorResolved`, which never carries the alpha channel —
  * OOXML encodes color and alpha independently. Pass `pres` to resolve the
  * shape's theme fill reference when no direct fill is present.
@@ -1901,7 +2482,7 @@ declare const setShapeRotation: (shape: SlideShapeData, degrees: number) => void
  *
  * The common use is the corner radius of the `roundRect` preset, whose `adj`
  * guide runs `0..50000` (thousandths of a percent of the shorter side;
- * `16667` ≈ the PowerPoint default, `0` = square corners, `50000` = fully
+ * `16667` ≈ the reference desktop app's default, `0` = square corners, `50000` = fully
  * rounded). For example, `setShapeAdjustValues(shape, { adj: 5000 })` gives a
  * subtle 5% rounding.
  *
@@ -1949,7 +2530,7 @@ declare const setShapeGradientFill: (shape: SlideShapeData, options: GradientFil
  * the pattern. Both accept `#RRGGBB`, bare `RRGGBB`, or scheme tokens
  * (`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.
+ * `pct5`, foreground `accent1` and background `bg1`, as in the reference desktop app on Mac.
  */
 declare const setShapePatternFill: (shape: SlideShapeData, options: Partial<PatternFillOptions>) => void;
 /**
@@ -1963,7 +2544,7 @@ declare const setShapePatternFill: (shape: SlideShapeData, options: Partial<Patt
  * 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.
+ * which is what the reference desktop app paints when the attribute is absent.
  */
 declare const getShapePatternFill: (pres: PresentationData, shape: SlideShapeData, options?: {
   readonly preserveTheme?: boolean;
@@ -1993,12 +2574,36 @@ declare const setShapeNoFill: (shape: SlideShapeData) => void;
  * from the layout / master placeholder it descends from.
  */
 declare const clearShapeFill: (shape: SlideShapeData) => void;
-/** Updates outline color, width and/or opacity (0–1); omitted properties are preserved. */
+/**
+ * Updates outline color, width and/or opacity (0–1); omitted properties are
+ * preserved. `fill: { kind: 'gradient', ... }` paints a gradient line instead
+ * of `color` (the reference desktop app's Gradient line); it takes the same options as
+ * `setShapeGradientFill` and is exclusive with `color` and `opacity`.
+ */
 declare const setShapeStroke: (shape: SlideShapeData, options: {
   color?: Color;
   widthEmu?: number;
   opacity?: number;
+  fill?: LineFill;
 }) => void;
+/**
+ * Sets the reference desktop app's Sketched style on the outline (`'curved'`, `'freehand'`
+ * or `'scribble'`), or removes it with `null`. Stored as the 2021
+ * `ask:lineSketchStyleProps` extension of `<a:ln>`, which older readers
+ * ignore. A new sketch gets a seed derived from the shape id, so the same
+ * deck always saves the same bytes.
+ *
+ * The reference desktop app writes the hand-drawn outline into the shape's geometry and keeps the
+ * original beside the style; this library keeps the true geometry instead (and
+ * restores it when editing a sketch the reference desktop app wrote), leaving the roughening to
+ * the renderer.
+ */
+declare const setShapeStrokeSketch: (shape: SlideShapeData, sketch: LineSketch | null) => void;
+/**
+ * Reads the outline's sketched style, or `null` when it has none. Only the
+ * shape's own `<a:ln>` is consulted.
+ */
+declare const getShapeStrokeSketch: (shape: SlideShapeData) => LineSketch | null;
 /** Sets an explicit "no outline" on the shape. */
 declare const setShapeNoStroke: (shape: SlideShapeData) => void;
 /**
@@ -2068,6 +2673,8 @@ declare const setShapeStrokeJoin: (shape: SlideShapeData, join: "round" | "bevel
 declare const setShapeStrokeCompound: (shape: SlideShapeData, cmpd: "sng" | "dbl" | "thickThin" | "thinThick" | "tri" | null) => void;
 //#endregion
 //#region src/api/fn/shape-effects.d.ts
+/** A shape's 3-D (`setShape3D`): the same DrawingML vocabulary as text 3-D. */
+type Shape3D = Text3D;
 /**
  * Read-back for `setShapeShadow` / `setShapeGlow`. Returns the kind
  * of effect currently on the shape's `<a:effectLst>`, or `null` when
@@ -2091,7 +2698,7 @@ type ShapeEffect = {
  * `CT_EffectStyleItem` (ECMA-376 §20.1.8.x) — outer shadow, inner
  * shadow, glow, reflection, soft-edge, blur. Returned in document
  * order so renderers can chain filters with the same composition
- * PowerPoint applies.
+ * the reference desktop app applies.
  *
  * Lengths are EMU; angles are degrees clockwise from 3 o'clock;
  * opacity is a unit fraction (0..1) when the spec exposes one.
@@ -2105,6 +2712,10 @@ type ShapeEffectAny = {
   readonly blurEmu: number;
   readonly distEmu: number;
   readonly angleDeg: number;
+  readonly scaleX?: number;
+  readonly scaleY?: number;
+  readonly skewX?: number;
+  readonly skewY?: number;
 } | {
   readonly kind: 'innerShdw';
   readonly color: string;
@@ -2147,7 +2758,7 @@ declare const getShapeEffect: (shape: SlideShapeData) => ShapeEffect | null;
  * 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
+ * helper. `getShapeEffects` is what renderers want because the reference desktop app
  * composes multiple effects in a single filter (shadow + glow, etc.).
  */
 declare const getShapeEffects: (pres: PresentationData, shape: SlideShapeData) => readonly ShapeEffectAny[];
@@ -2165,24 +2776,59 @@ declare const findShapesByEffect: (pres: PresentationData, slide: SlideData, kin
  * cascade when the shape itself has no `<a:effectLst>`. Inherits
  * "all or nothing" — once any layer supplies an effect list, that
  * list is used; layers further down aren't merged in. This matches
- * PowerPoint's behaviour (effect lists override rather than compose).
+ * the reference desktop app's behaviour (effect lists override rather than compose).
  */
 declare const getShapeEffectsEffective: (pres: PresentationData, shape: SlideShapeData) => readonly ShapeEffectAny[];
 /**
  * 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. Replaces an existing drop shadow and leaves the shape's other
- * effects in place; `clearShapeEffects` is the way to remove them all.
+ * effects in place; `null` removes only the drop shadow and
+ * `clearShapeEffects` removes every effect.
+ */
+declare const setShapeShadow: (shape: SlideShapeData, options?: ShadowOptions | null) => void;
+/**
+ * Sets an inner shadow (`<a:innerShdw>`) on the shape, replacing only a
+ * prior inner shadow. Defaults: black, 4pt blur, 3pt offset, 45°. `null`
+ * removes it.
  */
-declare const setShapeShadow: (shape: SlideShapeData, options?: ShadowOptions) => void;
+declare const setShapeInnerShadow: (shape: SlideShapeData, options: InnerShadowOptions | null) => void;
 /**
  * Sets a glow around the shape. The radius is in EMU (default 5pt =
  * 63500). Replaces an existing glow and composes with a shadow, in the
- * order `CT_EffectList` states.
+ * order `CT_EffectList` states. `null` removes only the glow.
+ */
+declare const setShapeGlow: (shape: SlideShapeData, options: GlowOptions | null) => void;
+/**
+ * Sets a reflection (`<a:reflection>`) of the shape, replacing only a prior
+ * reflection. A mirrored reflection below the shape is `scaleY: -1` with
+ * `alignment: 'bl'`, fading from `startOpacity` to `opacity` by
+ * `endPosition`. `null` removes it.
  */
-declare const setShapeGlow: (shape: SlideShapeData, options: GlowOptions) => void;
+declare const setShapeReflection: (shape: SlideShapeData, options: ReflectionOptions | null) => void;
+/**
+ * Softens the shape's edges (`<a:softEdge>`) by `radiusEmu`, replacing a
+ * prior soft edge. `null` removes it.
+ */
+declare const setShapeSoftEdge: (shape: SlideShapeData, radiusEmu: number | null) => void;
 /** Removes any effects (shadow / glow / future presets) from the shape. */
 declare const clearShapeEffects: (shape: SlideShapeData) => void;
+/**
+ * Sets the shape's own 3-D — `<a:scene3d>` (camera, rotation, lighting) and
+ * `<a:sp3d>` (bevels, depth, contour, material, distance from ground) in
+ * `<p:spPr>`, what the reference desktop app's 3-D Format and 3-D Rotation write. Same
+ * vocabulary as `setShapeText3D`, which puts it on the text body instead. A
+ * field left out removes what it describes; settings this API does not model
+ * (camera zoom, backdrop, ...) are kept while their element remains. `null`
+ * removes both elements.
+ */
+declare const setShape3D: (shape: SlideShapeData, value: Shape3D | null) => void;
+/**
+ * Reads the 3-D on the shape's own `<p:spPr>` (see `setShape3D`), or `null`
+ * when it has neither `<a:scene3d>` nor `<a:sp3d>`. A theme's effect style
+ * is not consulted.
+ */
+declare const getShape3D: (shape: SlideShapeData) => ReadText3D | null;
 //#endregion
 //#region src/internal/drawingml/text-body-edit.d.ts
 type TextCase = 'sentence' | 'lower' | 'upper' | 'title' | 'toggle';
@@ -2200,7 +2846,7 @@ type TextCase = 'sentence' | 'lower' | 'upper' | 'title' | 'toggle';
  * 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`.
+ * Change Case, as the reference desktop app does, to the whole text or to `options.range`.
  */
 declare const setShapeText: (shape: SlideShapeData, value: string | {
   case: TextCase;
@@ -2214,7 +2860,7 @@ declare const setShapeText: (shape: SlideShapeData, value: string | {
   };
 }) => void;
 /**
- * Replaces the shape's text with a single field — text PowerPoint fills in
+ * Replaces the shape's text with a single field — text the reference desktop app 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
@@ -2222,13 +2868,13 @@ declare const setShapeText: (shape: SlideShapeData, value: string | {
  * 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
+ * that does not evaluate fields shows — the reference desktop app 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
+ * carried onto the field, the way the reference desktop app 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.
+ * nothing else, which is how the reference desktop app writes slide numbers and dates.
  */
 declare const setShapeTextField: (shape: SlideShapeData, type: string, options?: {
   text?: string;
@@ -2255,7 +2901,7 @@ declare const appendShapeText: (shape: SlideShapeData, value: string) => void;
  */
 type TextAnchor = 'top' | 'center' | 'bottom';
 /**
- * Word wrap mode on a text body. `'square'` (PowerPoint default for
+ * Word wrap mode on a text body. `'square'` (the reference desktop app's default for
  * textboxes) wraps lines at the shape's width; `'none'` lets text
  * overflow horizontally.
  */
@@ -2265,7 +2911,7 @@ type TextAutoFit = 'none' | 'normal' | 'shape';
 /**
  * Sets the text-body word-wrap mode.
  *
- *   - `'square'` writes `wrap="square"` — PowerPoint default for textboxes.
+ *   - `'square'` writes `wrap="square"` — the reference desktop app's default for textboxes.
  *   - `'none'`   writes `wrap="none"`  — text can overflow horizontally.
  *
  * Throws for non-text-bearing shape kinds.
@@ -2286,7 +2932,7 @@ declare const getShapeTextWrap: (shape: SlideShapeData) => TextWrap | null;
 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`
+ * `<a:bodyPr>`, where the reference desktop app writes its text-art 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
@@ -2295,6 +2941,16 @@ declare const setShapeTextAutoFit: (shape: SlideShapeData, mode: TextAutoFit) =>
  * non-text-bearing shape kinds.
  */
 declare const setShapeText3D: (shape: SlideShapeData, value: Text3D | null) => void;
+/**
+ * Sets the reference desktop app's Keep text flat (`<a:bodyPr><a:flatTx/>`): the text stays
+ * flat, out of the shape's 3-D scene, when the shape is rotated in 3-D.
+ * `<a:flatTx>` and the text body's own `<a:sp3d>` are one schema choice, so
+ * keeping text flat removes a text bevel or extrusion set by
+ * `setShapeText3D`. Throws for non-text-bearing shape kinds.
+ */
+declare const setShapeTextFlat: (shape: SlideShapeData, flat: boolean) => void;
+/** Reads Keep text flat (see `setShapeTextFlat`) from the shape's own text body. */
+declare const getShapeTextFlat: (shape: SlideShapeData) => boolean;
 /**
  * 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>`.
@@ -2303,11 +2959,11 @@ declare const setShapeText3D: (shape: SlideShapeData, value: Text3D | null) => v
 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).
+ * present (the reference desktop app applies a layout-inherited default in that case).
  */
 declare const getShapeTextAutoFit: (shape: SlideShapeData) => TextAutoFit | null;
 /**
- * Reads the scale parameters PowerPoint stores on `<a:normAutofit>`
+ * Reads the scale parameters the reference desktop app stores on `<a:normAutofit>`
  * once it has shrunk a text body to fit. Returns `null` if the body
  * doesn't carry `<a:normAutofit>` or the attributes are absent. Both
  * fields are unitless ratios in `[0, 1]`:
@@ -2316,7 +2972,7 @@ declare const getShapeTextAutoFit: (shape: SlideShapeData) => TextAutoFit | null
  *   - `lnSpcReduction` — subtract from the line-height ratio. Default `0`.
  *
  * Companion to `getShapeTextAutoFit`. Renderers that want to match
- * PowerPoint's actual on-screen text size apply these factors to the
+ * the reference desktop app's actual on-screen text size apply these factors to the
  * authored font sizes; without them, every long title overflows.
  */
 declare const getShapeTextAutoFitParams: (shape: SlideShapeData) => {
@@ -2334,7 +2990,7 @@ declare const getShapeTextAutoFitParams: (shape: SlideShapeData) => {
 declare const getShapeTextAnchor: (shape: SlideShapeData) => TextAnchor | null;
 /**
  * Reads back the internal margins of the shape's text frame. Sides
- * that are absent in the XML default to `null` (PowerPoint applies
+ * that are absent in the XML default to `null` (the reference desktop app applies
  * its built-in default for the missing side).
  */
 /**
@@ -2364,7 +3020,7 @@ declare const setShapeTextColumns: (shape: SlideShapeData, columns: {
  * Reads the shape's text-body rotation from `<a:bodyPr rot="N"/>`.
  * `rot` is stored in 60000ths of a degree (OOXML angle units); the
  * returned value is in degrees. Positive values rotate clockwise per
- * PowerPoint's convention. Returns `null` when the attribute is
+ * the reference desktop app's convention. Returns `null` when the attribute is
  * absent.
  *
  * Distinct from the shape's own `<p:xfrm rot=…>` (the geometry
@@ -2374,7 +3030,7 @@ declare const setShapeTextColumns: (shape: SlideShapeData, columns: {
 declare const getShapeTextBodyRotationDeg: (shape: SlideShapeData) => number | null;
 /**
  * Sets the shape's text-body rotation (`<a:bodyPr rot="N"/>`), measured
- * in degrees. Positive rotates clockwise per PowerPoint's convention.
+ * in degrees. Positive rotates clockwise per the reference desktop app's convention.
  * Passing `null` clears the attribute so the shape inherits the default
  * (`0`). Throws for non-text-bearing shape kinds.
  *
@@ -2392,7 +3048,7 @@ declare const setShapeTextBodyRotationDeg: (shape: SlideShapeData, rotationDeg:
  *   - `wordArtVert` — characters not rotated, stacked vertically.
  *   - `eaVert` — East-Asian vertical: characters upright, columns right-to-left.
  *   - `mongolianVert` — Mongolian: rotated 90°, columns left-to-right.
- *   - `wordArtVertRtl` — RTL word-art stacked vertically.
+ *   - `wordArtVertRtl` — upright characters stacked vertically, columns right-to-left.
  *
  * Returns `null` when the attribute is absent or set to the default
  * `horz`.
@@ -2439,7 +3095,7 @@ declare const getShapeBodyPrEffective: (pres: PresentationData, shape: SlideShap
 };
 /**
  * Sets vertical anchoring. `centered` centers the text block without changing
- * paragraph alignment (PowerPoint's Top / Middle / Bottom Centered options).
+ * paragraph alignment (the reference desktop app'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?: {
@@ -2450,7 +3106,7 @@ declare const setShapeTextAnchor: (shape: SlideShapeData, anchor: TextAnchor, op
  * 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),
+ * The reference desktop app's defaults for a textbox: left/right 91440 (0.1in),
  * top/bottom 45720 (0.05in).
  *
  *   setShapeTextMargins(shape, { left: 0, right: 0 }); // flush-left text
@@ -2531,6 +3187,43 @@ declare function setShapeParagraphs(shapes: ReadonlyArray<SlideShapeData>, parag
   }>;
 }): void;
 //#endregion
+//#region src/api/fn/shape-color.d.ts
+/**
+ * Resolves a DrawingML color element (`<a:srgbClr>` / `<a:schemeClr>` /
+ * `<a:sysClr>` / `<a:prstClr>`) with all its `<a:lumMod>` / `<a:tint>` /
+ * `<a:shade>` / `<a:satMod>` etc. transform children applied. Returns
+ * `null` when the color is a scheme token and no theme is supplied to
+ * resolve it.
+ *
+ * Exposed because both run-format and fill-format code paths need to
+ * apply the same transform pipeline; keeping a single implementation
+ * means future spec-coverage additions only have to land in one place.
+ */
+declare const resolveDrawingColor: (colorEl: XmlElement, theme: PresentationTheme | null, clrMap?: Readonly<Record<string, string>> | null) => string | null;
+/**
+ * Resolves the opacity a DrawingML color element carries through its
+ * `<a:alpha>` / `<a:alphaMod>` / `<a:alphaOff>` children (ECMA-376
+ * §20.1.2.3.1–3) to a `0`–`1` fraction, applied in document order from a
+ * fully opaque base. Returns `null` when the element has no alpha
+ * transform — the reference desktop app paints that opaque, but callers can still tell
+ * "unspecified" apart from an explicit `1`.
+ *
+ * Kept separate from `resolveDrawingColor` because alpha never changes the
+ * `#RRGGBB`; OOXML encodes the two independently and renderers emit the
+ * opacity next to the color (`fill-opacity` / `stroke-opacity`).
+ */
+declare const resolveDrawingColorOpacity: (colorEl: XmlElement) => number | null;
+/**
+ * Reads back the format of a single run. Returns `null` when the run
+ * has no `<a:rPr>` (it inherits its format from the paragraph /
+ * layout / master). Boolean attributes that are explicitly `"0"`
+ * decode to `false`.
+ *
+ * Use `getShapeRunFormatEffective` if you want the resolved format
+ * after walking the placeholder / lstStyle / master inheritance chain.
+ */
+declare const getShapeRunFormat: (shape: SlideShapeData, paragraphIndex: number, runIndex: number) => ReadTextFormat | null;
+//#endregion
 //#region src/api/fn/shape-paragraph.d.ts
 /**
  * Resolves a run's effective character properties by walking the
@@ -2618,7 +3311,7 @@ interface ParagraphProperties {
   rtl: boolean | null;
   /**
    * Bullet resolved through the cascade (`<a:buChar>` / `<a:buAutoNum>` /
-   * `<a:buNone>`). Master `bodyStyle` levels author the PowerPoint default
+   * `<a:buNone>`). Master `bodyStyle` levels author the reference desktop app's default
    * "•", so body placeholders get their bullet from here even when no
    * slide-level `<a:pPr>` carries one.
    */
@@ -2843,7 +3536,7 @@ declare const getCommentParent: (comment: SlideCommentData) => SlideCommentData
 /**
  * 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.
+ * `<p188:cm>` thread the reference desktop app writes from 2021 on.
  */
 declare const getCommentFormat: (comment: SlideCommentData) => "legacy" | "modern";
 /**
@@ -2983,7 +3676,7 @@ interface ChartSeries {
   readonly name: string;
   /**
    * Numeric values, one per category. `null` slots become empty cells in
-   * the embedded workbook (PowerPoint draws them as a gap). Lengths
+   * the embedded workbook (the reference desktop app draws them as a gap). Lengths
    * shorter than the category count are right-padded with `null`.
    *
    * For `scatter` / `bubble` kinds there are no categories: `values`
@@ -3022,7 +3715,7 @@ interface ChartSeries {
   readonly chartKind?: 'bar' | 'column' | 'line' | 'area';
   /**
    * Plot this series against the secondary value axis — the right-hand
-   * axis PowerPoint shows for combo charts with mixed units
+   * axis the reference desktop app shows for combo charts with mixed units
    * (`<c:valAx>` pair with `axPos="r"` plus a deleted companion
    * `<c:catAx>`). The builder emits the secondary axis pair on demand.
    * Only meaningful for the category kinds; rejected for pie / doughnut.
@@ -3056,14 +3749,14 @@ interface ChartSeries {
    */
   readonly markerSymbol?: 'none' | 'auto' | 'circle' | 'square' | 'diamond' | 'triangle' | 'star' | 'x' | 'plus' | 'dash' | 'dot' | 'picture';
   /**
-   * Marker size in points (`<c:marker><c:size val="N"/>`). PowerPoint
+   * Marker size in points (`<c:marker><c:size val="N"/>`). The reference desktop app
    * default ~5. Only meaningful when `markerSymbol` isn't `none`.
    */
   readonly markerSizePt?: number;
   /**
    * Optional marker fill + outline color (`<c:marker><c:spPr>`), as an sRGB
    * hex. Defaults to `color`. The builder always writes it for line /
-   * scatter / radar series, because PowerPoint paints a marker without
+   * scatter / radar series, because the reference desktop app paints a marker without
    * `<c:spPr>` in the theme's automatic color instead of the series color.
    */
   readonly markerColor?: string;
@@ -3096,7 +3789,7 @@ interface ChartSeries {
   /**
    * Optional per-data-point data-label overrides
    * (`<c:dLbls><c:dLbl><c:idx val="N"/>…`). Sparse — `null` slots fall back
-   * to the series-level `dataLabels`. PowerPoint draws the per-point element
+   * to the series-level `dataLabels`. The reference desktop app draws the per-point element
    * over the series defaults, which is how pie / doughnut exporters give each
    * slice its own label content and font.
    */
@@ -3169,7 +3862,7 @@ interface ChartErrorBars {
 interface ChartTrendline {
   /**
    * Optional custom label for the trendline (`<c:trendline><c:name>…`).
-   * Defaults to PowerPoint's auto-generated label
+   * Defaults to the reference desktop app's auto-generated label
    * (e.g. "Linear (X)" / "MA(5) (X)") when omitted.
    */
   readonly name?: string;
@@ -3232,7 +3925,7 @@ interface ChartDataLabels {
   readonly showPercent: boolean;
   /**
    * Number-format code from `<c:dLbls><c:numFmt formatCode="…"/>`. When
-   * set, value labels are projected through this Excel-style format
+   * set, value labels are projected through this spreadsheet-style format
    * (same subset the value axis honors: `"0%"`, `"#,##0"`, `"$#,##0"`,
    * `"0.00"`). Independent of `ChartAxisScaling.numberFormat`.
    */
@@ -3294,7 +3987,7 @@ interface ChartAxisScaling {
   /**
    * Number-format code from `<c:numFmt formatCode="…"/>`. Common
    * values: `"0%"`, `"0.0%"`, `"#,##0"`, `"$#,##0"`, `"yyyy-mm-dd"`.
-   * Renderers project a subset of Excel-style formats to label text.
+   * Renderers project a subset of spreadsheet number formats to label text.
    */
   readonly numberFormat?: string;
   /**
@@ -3336,10 +4029,10 @@ interface ChartView3D {
   readonly rotY?: number;
   /**
    * Right-angle axes (`<c:rAngAx>`): an oblique projection that ignores
-   * `perspective`. PowerPoint's default for bar / column / line / area.
+   * `perspective`. The reference desktop app's default for bar / column / line / area.
    */
   readonly rightAngleAxes?: boolean;
-  /** Field of view, 0..240 (`<c:perspective>`); PowerPoint's default is 30. */
+  /** Field of view, 0..240 (`<c:perspective>`); the reference desktop app's default is 30. */
   readonly perspective?: number;
   /** Depth as a percent of the chart width, 20..2000 (`<c:depthPercent>`). */
   readonly depthPercent?: number;
@@ -3373,7 +4066,7 @@ interface ChartOfPie {
 }
 /** Up / down bars between the first and last line series (`<c:upDownBars>`). */
 interface ChartUpDownBars {
-  /** Bar width gap, 0..500 percent (`<c:gapWidth>`); PowerPoint's default is 150. */
+  /** Bar width gap, 0..500 percent (`<c:gapWidth>`); the reference desktop app's default is 150. */
   readonly gapWidthPct?: number;
   /** Fill of the rising bars as `#RRGGBB` (`<c:upBars>`). */
   readonly upColor?: string;
@@ -3461,7 +4154,7 @@ interface ChartTextStyle {
    * `<a:rPr><a:latin typeface="…"/><a:ea typeface="…"/>`. East-asian is
    * set alongside latin so a Japanese / CJK family (e.g. `'Yu Gothic'`)
    * renders the labels instead of the renderer's latin-only fallback.
-   * Mirrors the latin/ea pairing PowerPoint emits for CJK chart fonts.
+   * Mirrors the latin/ea pairing the reference desktop app emits for CJK chart fonts.
    */
   readonly font?: string;
   /**
@@ -3485,7 +4178,7 @@ interface ChartTextStyle {
  * that `ChartSeries.secondaryAxis` series plot against. The fields mirror
  * the primary `valueAxis*` fields of `ChartSpec` without the prefix, limited
  * to what a right-hand axis needs; the axis position (`r`) and crossing
- * (`max`) stay fixed. Omit the whole object for PowerPoint's defaults.
+ * (`max`) stay fixed. Omit the whole object for the reference desktop app's defaults.
  */
 interface ChartSecondaryValueAxis {
   readonly scaling?: ChartAxisScaling;
@@ -3567,7 +4260,7 @@ interface ReadChartSpec {
   /**
    * Authored rotation on the category-axis tick labels, in degrees. From
    * `<c:catAx><c:txPr><a:bodyPr rot="N"/>` where N is in 60000ths of a
-   * degree. Positive values rotate clockwise (PowerPoint convention),
+   * degree. Positive values rotate clockwise (the reference desktop app's convention),
    * matching the SVG `transform=rotate()` sense.
    */
   readonly categoryAxisLabelRotationDeg?: number;
@@ -3575,7 +4268,7 @@ interface ReadChartSpec {
   /** Authored font / color on the value-axis title. */
   readonly valueAxisTitleStyle?: ChartTextStyle;
   /**
-   * Rotation of the value-axis title, in degrees clockwise. PowerPoint
+   * Rotation of the value-axis title, in degrees clockwise. The reference desktop app
    * often emits `-90` (or `vert270`) so the title reads bottom-to-top
    * alongside the axis. Maps to `<c:valAx><c:title><c:tx><c:rich>
    * <a:bodyPr rot="N"/>` (60000ths of a degree on the wire).
@@ -3633,7 +4326,7 @@ interface ReadChartSpec {
   /**
    * Authored width of the value-axis major gridlines in EMU — the `w` of
    * the same `<a:ln>` as `valueAxisMajorGridlineColor` (12700 = 1 pt).
-   * `undefined` leaves the width to the application (PowerPoint: 0.75 pt).
+   * `undefined` leaves the width to the application (the reference desktop app: 0.75 pt).
    */
   readonly valueAxisMajorGridlineWidthEmu?: number;
   /** Companion width of the value-axis minor gridlines. */
@@ -3697,28 +4390,28 @@ interface ReadChartSpec {
   readonly categoryAxisLabelOffset?: number;
   /**
    * Multi-line category-label alignment relative to the tick mark —
-   * `<c:catAx><c:lblAlgn val="ctr|l|r"/>`. PowerPoint defaults to
+   * `<c:catAx><c:lblAlgn val="ctr|l|r"/>`. The reference desktop app defaults to
    * `ctr` when omitted; the authored value wins.
    */
   readonly categoryAxisLabelAlign?: 'ctr' | 'l' | 'r';
   /**
    * Number-format code for the category-axis tick labels —
    * `<c:catAx><c:numFmt formatCode="…"/>`. Most useful on date-style
-   * categories (`"mm/dd/yyyy"`, `"mmm"`, etc.) but accepts any Excel
+   * categories (`"mm/dd/yyyy"`, `"mmm"`, etc.) but accepts any spreadsheet
    * format string. Independent of `valueAxis.numberFormat` (which
    * targets the value axis).
    */
   readonly categoryAxisNumberFormat?: string;
   /**
    * Toggle multi-level (hierarchical) category labels —
-   * `<c:catAx><c:noMultiLvlLbl val="0|1"/>`. PowerPoint defaults to
+   * `<c:catAx><c:noMultiLvlLbl val="0|1"/>`. The reference desktop app defaults to
    * `0` (multi-level labels stack). Set to `true` to flatten
    * hierarchical categories into a single row.
    */
   readonly categoryAxisNoMultiLevelLabel?: boolean;
   /**
    * Category-axis order — `'minMax'` (the data's natural order) or
-   * `'maxMin'` (reversed). For bar charts PowerPoint typically emits
+   * `'maxMin'` (reversed). For bar charts the reference desktop app typically emits
    * `maxMin` so the first category sits at the top instead of the
    * bottom; honour the authored value when present.
    */
@@ -3729,7 +4422,7 @@ interface ReadChartSpec {
    * Where the category axis crosses the value axis. Either an enum
    * keyword (`<c:valAx><c:crosses val="autoZero|min|max"/>`) or a
    * specific numeric value (`<c:valAx><c:crossesAt val="N"/>`). The two
-   * forms are mutually exclusive — PowerPoint emits one or the other.
+   * forms are mutually exclusive — the reference desktop app emits one or the other.
    * Default is `autoZero` (the category axis sits at value 0 if the
    * range straddles zero, otherwise at the closer extreme).
    */
@@ -3740,43 +4433,43 @@ interface ReadChartSpec {
    * Whether the value axis crosses the category axis *between* tick
    * marks (the default for bar / column / area) or *at* each tick mark
    * (the default for line / scatter). Maps to `<c:valAx>
-   * <c:crossBetween val="between|midCat"/>`. PowerPoint emits this when
+   * <c:crossBetween val="between|midCat"/>`. The reference desktop app emits this when
    * the chart kind makes the default value non-obvious — surface it
    * here so the round-trip preserves the authored intent.
    */
   readonly valueAxisCrossBetween?: 'between' | 'midCat';
   /**
    * When `false`, plot data from hidden cells in the embedded workbook
-   * — maps to `<c:plotVisOnly val="0"/>`. PowerPoint's default is
+   * — maps to `<c:plotVisOnly val="0"/>`. The reference desktop app's default is
    * `true` (only plot visible cells), so omitting this field emits
-   * `val="1"` to stay round-trip-safe with PowerPoint-authored files.
+   * `val="1"` to stay round-trip-safe with files the reference desktop app authored.
    */
   readonly plotVisibleCellsOnly?: boolean;
   /**
    * Renders the chart area with rounded corners
-   * (`<c:chartSpace><c:roundedCorners val="1"/>`). PowerPoint's default
+   * (`<c:chartSpace><c:roundedCorners val="1"/>`). The reference desktop app's default
    * is `false`; surface only when explicitly `true` so the round-trip
    * doesn't add a redundant `false`.
    */
   readonly roundedCorners?: boolean;
   /**
-   * PowerPoint built-in chart-style preset
+   * The reference desktop app's built-in chart-style preset
    * (`<c:chartSpace><c:style val="N"/>`), 1–48. Encodes a curated combo
    * of theme accent colors, gradients, effects, and font sizes that
-   * PowerPoint applies when the user picks a chart style from the
+   * the reference desktop app applies when the user picks a chart style from the
    * "Chart Styles" gallery. Surface for round-trip parity; renderers in
    * @office-kit/pptx don't (yet) interpret it.
    */
   readonly chartStyle?: number;
   /**
    * Language code for the chart's number / date formatters
-   * (`<c:chartSpace><c:lang val="…"/>`). PowerPoint emits the user's
-   * Office UI language (e.g. `'en-US'`, `'ja-JP'`). Carried for
+   * (`<c:chartSpace><c:lang val="…"/>`). The reference desktop app emits the user's
+   * Authoring app UI language (e.g. `'en-US'`, `'ja-JP'`). Carried for
    * round-trip parity; renderers in @office-kit/pptx don't act on it yet.
    */
   readonly language?: string;
   /**
-   * `<c:chartSpace><c:date1904 val="…"/>` — the Excel date-system flag.
+   * `<c:chartSpace><c:date1904 val="…"/>` — the spreadsheet date-system flag.
    * `false` (the default) uses the 1900-epoch; `true` uses 1904.
    * Surface for parity; renderers don't act on it yet.
    */
@@ -3796,14 +4489,14 @@ interface ReadChartSpec {
   readonly hiLowLines?: boolean;
   /**
    * Whether a line chart draws point markers (`<c:lineChart><c:marker
-   * val="1"/>`). `true` is PowerPoint's "Line with Markers" subtype;
+   * val="1"/>`). `true` is the reference desktop app's "Line with Markers" subtype;
    * absent / `false` is the plain "Line" subtype (no markers). Only
    * meaningful for `kind: 'line'`.
    */
   readonly lineMarkers?: boolean;
   /**
    * Gap between adjacent bar groups in `<c:gapWidth val="N"/>` units
-   * (0..500, percent of bar width). Default 150 (= 1.5×) in PowerPoint.
+   * (0..500, percent of bar width). Default 150 (= 1.5×) in the reference desktop app.
    */
   readonly gapWidthPct?: number;
   /**
@@ -3888,7 +4581,7 @@ interface ReadChartSpec {
   readonly radarStyle?: 'standard' | 'marker' | 'filled';
   /**
    * Bubble-size scale percentage from `<c:bubbleChart><c:bubbleScale
-   * val="N"/>` (0..300, PowerPoint default 100). Scales every bubble's
+   * val="N"/>` (0..300, the reference desktop app's default 100). Scales every bubble's
    * rendered radius proportionally.
    */
   readonly bubbleScale?: number;
@@ -3896,13 +4589,13 @@ interface ReadChartSpec {
    * Whether a bubble's `<c:bubbleSize>` maps to the bubble's area or its
    * width — `<c:bubbleChart><c:sizeRepresents val="area|w"/>` (ECMA-376
    * ST_SizeRepresents; the `'w'` token is surfaced as `'width'`).
-   * PowerPoint's default is `'area'`, so radius scales with `sqrt(size)`;
+   * The reference desktop app's default is `'area'`, so radius scales with `sqrt(size)`;
    * `'width'` scales radius linearly with size.
    */
   readonly bubbleSizeRepresents?: 'area' | 'width';
   /**
    * Shade bubbles as spheres — `<c:bubble3D val="1"/>` on each series of the
-   * bubble chart (PowerPoint's "3-D Bubble" subtype). Unlike the
+   * bubble chart (the reference desktop app's "3-D Bubble" subtype). Unlike the
    * other 3-D variants it has no camera, so `view3D` does not apply.
    */
   readonly bubble3D?: boolean;
@@ -3912,7 +4605,7 @@ interface ReadChartSpec {
    * 3-D view. Its presence selects the 3-D plot-group element for `bar` /
    * `column` / `line` / `area` / `pie`; for `surface` it only positions the
    * camera. Rejected for every other kind, and for combo charts (a 3-D
-   * group cannot share a plot area with another group in PowerPoint).
+   * group cannot share a plot area with another group in the reference desktop app).
    */
   readonly view3D?: ChartView3D;
   /** Shape of 3-D bars / columns (`<c:bar3DChart><c:shape>`). Requires `view3D`. */
@@ -4142,7 +4835,7 @@ type SurfaceChartSpec = Fields<VariantField<'surface'>> & CategoryAxisMode & {
  * 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.
+ * the reference desktop app offers to repair.
  *
  * `readChartSpec` returns the permissive `ReadChartSpec` instead, because a
  * deck authored elsewhere can combine fields no kind allows; narrow one back
@@ -4157,6 +4850,11 @@ type ChartSpec = ComboChartSpec | Bar3DChartSpec | LineArea3DChartSpec | PieChar
 declare const isChartSpec: (spec: ReadChartSpec) => spec is ChartSpec;
 //#endregion
 //#region src/api/fn/charts.d.ts
+/**
+ * Adds a native chart to the slide at `x`/`y` with size `w`×`h` (EMU),
+ * built from `spec`, with an embedded workbook so the reference desktop app's "Edit data"
+ * opens the chart's numbers. Returns the chart's graphic-frame shape.
+ */
 declare const addSlideChart: (slide: SlideData, opts: {
   spec: ChartSpec;
   x: Emu;
@@ -4178,13 +4876,13 @@ interface SlideChartData {
 /**
  * Replaces the chart definition on an existing graphic-frame chart
  * shape. Updates the inline `<c:strCache>` / `<c:numCache>` blocks so
- * PowerPoint renders the new data without opening the embedded
+ * the reference desktop app renders the new data without opening the embedded
  * workbook. The shape's geometry (position / size / rotation) is
  * preserved verbatim.
  *
  * The embedded xlsx is re-written too — it's what the "Edit data"
  * affordance opens. The previous workbook is replaced wholesale (no
- * attempt to preserve styles a user added through Excel).
+ * attempt to preserve styles a user added in a spreadsheet app).
  *
  * Pass any `ChartSpec`, including a different `kind` from the
  * original; this acts as "change my column chart to a line chart with
@@ -4321,21 +5019,25 @@ declare const isChartShape: (shape: SlideShapeData) => boolean;
 declare const getTableCells: (table: SlideShapeData) => ReadonlyArray<ReadonlyArray<TableCellData>>;
 /**
  * Reads the table-style GUID from `<a:tbl><a:tblPr><a:tableStyleId>`.
- * PowerPoint uses GUIDs to reference built-in table styles
+ * The reference desktop app uses GUIDs to reference built-in table styles
  * (`{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}` = "Medium Style 2 -
  * Accent 1", etc.) and theme-local styles. Returns `null` when the
  * table doesn't reference one (uses the slide's default style).
  */
 declare const getTableStyleId: (table: SlideShapeData) => string | null;
 /**
- * Writes `<a:tbl><a:tblPr><a:tableStyleId>` to the given GUID. Pass
- * `null` to remove the element so the table falls back to the slide's
- * default style. The GUID must include its curly braces — e.g.
- * `'{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}'` (PowerPoint's "Medium
- * Style 2 - Accent 1"). Creates `<a:tblPr>` if absent. Throws when the
- * shape isn't a table graphic frame.
+ * Applies a table style by writing `<a:tbl><a:tblPr><a:tableStyleId>`.
+ * `styleId` is a style GUID with its curly braces — e.g.
+ * `'{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}'` — or the English name of one
+ * of the reference desktop app's built-in styles (`'Medium Style 2 - Accent 1'`; see
+ * `BUILTIN_TABLE_STYLES`). For a built-in style, the reference desktop app's definition is
+ * added to `ppt/tableStyles.xml` (creating the part if needed) unless the
+ * deck already defines that GUID, as the reference desktop app does when you pick a style.
+ * Pass `null` to remove the element so the table falls back to the deck's
+ * default style. Creates `<a:tblPr>` if absent. Throws when the shape isn't
+ * a table graphic frame or `styleId` is neither a GUID nor a built-in name.
  */
-declare const setTableStyleId: (table: SlideShapeData, styleId: string | null) => void;
+declare const setTableStyleId: (table: SlideShapeData, styleId: BuiltinTableStyleName | (string & {}) | null) => void;
 /**
  * Reads the boolean style flags off `<a:tblPr>` — which header /
  * footer rows + columns are banded or emphasised. Mirrors the
@@ -4365,7 +5067,7 @@ declare const getTableStyleFlags: (table: SlideShapeData) => {
  * Sets one or more boolean style flags on `<a:tblPr>`. Only the keys
  * present in `flags` are touched — omitted keys are left at their
  * current state. A flag set to `false` strips the attribute (rather
- * than emitting `="0"`), matching how PowerPoint round-trips defaults.
+ * than emitting `="0"`), matching how the reference desktop app round-trips defaults.
  *
  * See `getTableStyleFlags` for the meaning of each flag.
  */
@@ -4414,7 +5116,7 @@ declare const getTableRowHeights: (table: SlideShapeData) => ReadonlyArray<Emu>;
  * Sets a single column's width on the table grid. Throws on
  * out-of-range column indices or non-table shapes. The total table
  * width is not auto-adjusted — callers are responsible for keeping
- * the sum consistent with the table's `<a:xfrm>` extent if PowerPoint
+ * the sum consistent with the table's `<a:xfrm>` extent if the reference desktop app
  * is to render the table without clipping.
  */
 declare const setTableColumnWidth: (table: SlideShapeData, col: number, width: Emu) => void;
@@ -4480,7 +5182,7 @@ declare const getTableCellSpan: (cell: TableCellData) => {
  * The block's top-left cell `(row, col)` becomes the anchor and carries
  * `gridSpan` (= `colSpan`) / `rowSpan`; the cells it covers are marked
  * `hMerge` / `vMerge` per ECMA-376 §21.1.3.18 (`CT_TableCell`) so the
- * grid stays rectangular while PowerPoint paints only the anchor. This
+ * grid stays rectangular while the reference desktop app paints only the anchor. This
  * is the write counterpart to {@link getTableCellSpan}.
  *
  * Constraints, enforced loudly (these are authoring-boundary inputs):
@@ -4489,7 +5191,7 @@ declare const getTableCellSpan: (cell: TableCellData) => {
  *     (a 1×1 "merge" is a no-op the caller didn't mean).
  *   - The block must lie fully inside the table grid.
  *   - No cell in the block may already participate in another merge —
- *     overlapping merges corrupt the grid and trip PowerPoint's repair
+ *     overlapping merges corrupt the grid and trip the reference desktop app's repair
  *     dialog. Split the existing merge first.
  *
  * The anchor cell's text is preserved. `coveredText: 'keep'` (the default)
@@ -4565,6 +5267,12 @@ declare const setTableCellBorders: (cell: TableCellData, sides: {
  * top alongside its column.
  */
 declare const getTableCellTextDirection: (cell: TableCellData) => "vert" | "vert270" | "wordArtVert" | "eaVert" | "mongolianVert" | "wordArtVertRtl" | null;
+/**
+ * Reads the 3-D on the cell's text body (`<a:scene3d>` / `<a:sp3d>` under its
+ * `<a:bodyPr>`) — the table-cell counterpart of `getShapeText3D`. Returns
+ * `null` when the body has neither.
+ */
+declare const getTableCellText3D: (cell: TableCellData) => ReadText3D | null;
 /**
  * Sets the cell's text-direction via `<a:tcPr vert="…"/>`. Same six
  * `ST_TextVerticalType` values as `setShapeTextDirection`. Passing
@@ -4587,7 +5295,7 @@ declare const setTableCellAnchor: (cell: TableCellData, anchor: "top" | "center"
 /**
  * Reads the cell's inset margins (`<a:tcPr marL marR marT marB>`) in
  * EMU. Each side is `null` when the cell doesn't author it (renderers
- * should fall back to PowerPoint's defaults — 91440 EMU / 0.1 inch
+ * should fall back to the reference desktop app's defaults — 91440 EMU / 0.1 inch
  * for the horizontal margins, 45720 EMU for the vertical).
  */
 declare const getTableCellMargins: (cell: TableCellData) => {
@@ -4599,7 +5307,7 @@ declare const getTableCellMargins: (cell: TableCellData) => {
 /**
  * Sets the cell's inset margins (`<a:tcPr marL marR marT marB>`) in
  * EMU. Sides set to `null` are stripped from the XML so they fall back
- * to PowerPoint's defaults. Creates `<a:tcPr>` if absent.
+ * to the reference desktop app's defaults. Creates `<a:tcPr>` if absent.
  *
  * Pass `null` for the whole `margins` arg to drop every authored side
  * at once.
@@ -4616,7 +5324,7 @@ declare const getTableCellText: (cell: TableCellData) => string;
 interface TableCellParagraph {
   /**
    * Horizontal alignment from `<a:pPr algn>`, or `null` when unset (the
-   * cell then inherits PowerPoint's left default).
+   * cell then inherits the reference desktop app's left default).
    */
   readonly align: ParagraphAlignment | null;
   /** Runs / fields / breaks in document order, with their literal `<a:rPr>` format. */
@@ -4673,10 +5381,27 @@ declare const getTableCellFill: (cell: TableCellData) => string | null;
 /** Effective cell appearance after table-style and cell-property inheritance. */
 interface TableCellAppearanceEffective {
   readonly fill: ShapeFill;
+  /** Opacity (0–1) of a solid `fill` whose color carries an alpha transform. */
+  readonly fillOpacity?: number;
   readonly borders: TableCellBorders;
 }
 /** Resolves table-style `tcStyle` fills and borders, then overlays local `tcPr`. */
 declare const getTableCellAppearanceEffective: (pres: PresentationData, cell: TableCellData) => TableCellAppearanceEffective;
+/** Effective background drawn behind a table's cells. */
+interface TableBackgroundEffective {
+  readonly fill: ShapeFill;
+  /** Opacity (0–1) of a solid `fill` whose color carries an alpha transform. */
+  readonly fillOpacity?: number;
+  /** Stops (with theme-resolved colors) and direction of a gradient `fill`. */
+  readonly gradient?: ReadGradientFill;
+}
+/**
+ * Resolves the table background: a fill on `<a:tblPr>` itself, else the
+ * table style's `<a:tblBg>` (the reference desktop app's Themed Styles use a theme
+ * style-matrix fill there). Cells without a fill of their own show it.
+ * Returns `null` when neither defines one. The `tblBg` effect is not read.
+ */
+declare const getTableBackgroundEffective: (pres: PresentationData, table: SlideShapeData) => TableBackgroundEffective | null;
 /** 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.
@@ -4720,7 +5445,7 @@ declare const getTableCellPosition: (cell: TableCellData) => {
  * spec token (`l`, `ctr`, `r`, `just`, `dist`, `justLow`, `thaiDist`) — so
  * `setTableCellAlignment(cell, 'center')` reads back as `'ctr'`. Returns
  * `null` when the cell has no `<a:txBody>`, or its first paragraph has no
- * valid `algn` attribute (PowerPoint then defaults to `l`). For a
+ * valid `algn` attribute (the reference desktop app then defaults to `l`). For a
  * plain-English name per paragraph, use `getTableCellParagraphs`.
  */
 declare const getTableCellAlignment: (cell: TableCellData) => ParagraphAlignmentToken | null;
@@ -4893,8 +5618,8 @@ type ImageRecolorColor = Color | {
   readonly colorTransforms?: readonly ColorTransform[];
 };
 /**
- * A PowerPoint image recolor operation. Threshold is expressed as a percent
- * (0..100), matching `getShapeImageBiLevelThreshold` and PowerPoint's UI.
+ * An image recolor operation from the reference desktop app. Threshold is expressed as a percent
+ * (0..100), matching `getShapeImageBiLevelThreshold` and the reference desktop app's UI.
  */
 type ImageRecolor = {
   readonly kind: 'none';
@@ -4956,7 +5681,7 @@ declare const findOverlappingShapePairs: (slide: SlideData) => ReadonlyArray<rea
 /**
  * Returns every shape on the slide whose bounding box extends past
  * the slide canvas (`getSlideSize(pres)`). Useful audit helper for
- * catching shapes that PowerPoint will silently render off-screen
+ * catching shapes that the reference desktop app will silently render off-screen
  * or clip on export. Shapes without `<a:xfrm>` bounds are skipped.
  *
  * If the presentation has no slide-size declared, every positioned
@@ -5005,28 +5730,28 @@ declare const findSlidesByLayoutType: (pres: PresentationData, layoutType: Slide
  * `null` for embedded pictures, non-picture shapes, or when the
  * relationship doesn't resolve.
  *
- * PowerPoint emits `r:link` when the user inserts via "Link to file"
+ * The reference desktop app emits `r:link` when the user inserts via "Link to file"
  * instead of "Insert Picture". The bytes live outside the package, so
  * `getShapeImageBytes` can't render them — readers / preview tools
  * should fall back to this URL or a placeholder.
  */
 /**
  * Returns `true` when the picture's `<a:blip>` carries `<a:grayscl/>`
- * — PowerPoint's "Color > Grayscale" recolor preset. Renderers can
+ * — the reference desktop app's "Color > Grayscale" recolor preset. Renderers can
  * project this onto a CSS `filter: grayscale(100%)` or an SVG
  * `<feColorMatrix>` desaturation.
  */
 declare const isShapeImageGrayscale: (shape: SlideShapeData) => boolean;
 /**
  * Returns the threshold of the picture's `<a:blip><a:biLevel thresh="…"/>`
- * effect — PowerPoint's "Color > Black and White" preset. Threshold is
+ * effect — the reference desktop app's "Color > Black and White" preset. Threshold is
  * a percent (0..100); pixels brighter become white, darker become black.
  * Returns `null` when no biLevel transform is set.
  */
 declare const getShapeImageBiLevelThreshold: (shape: SlideShapeData) => number | null;
 /**
  * Reads the picture's duotone color transform from `<a:blip><a:duotone>`.
- * PowerPoint emits two `<a:srgbClr>` (or scheme color) children for a
+ * The reference desktop app emits two `<a:srgbClr>` (or scheme color) children for a
  * two-color duotone effect — typical "Picture Tools › Recolor".
  * By default colors are resolved to RGB for rendering. Pass
  * `{ resolveColors: false }` to preserve authoring color models and
@@ -5077,9 +5802,20 @@ declare const getShapeImageFillBytes: (shape: SlideShapeData) => Uint8Array | nu
  * embedded image or the bytes don't match a recognized signature.
  */
 declare const getShapeImageFormat: (shape: SlideShapeData) => ImageFormat | null;
+/** One of the reference desktop app's Artistic Effects ([MS-ODRAWXML] CT_PictureEffect, `a14:artistic*`). */
+type ImageArtisticEffect = 'marker' | 'pencilGrayscale' | 'pencilSketch' | 'lineDrawing' | 'chalkSketch' | 'paintStrokes' | 'paintBrush' | 'glowDiffused' | 'blur' | 'lightScreen' | 'watercolorSponge' | 'filmGrain' | 'mosaicBubbles' | 'glass' | 'cement' | 'texturizer' | 'crisscrossEtching' | 'pastelsSmooth' | 'plasticWrap' | 'cutout' | 'photocopy' | 'glowEdges';
+/**
+ * Reads the Artistic Effect the reference desktop app applied to a picture or image fill, or
+ * `null` when there is none.
+ *
+ * The reference desktop app stores the effect in the blip's `a14:imgProps` extension next to
+ * a relationship to the original picture (JPEG XR). The embedded picture is
+ * already the effect's result, so renderers draw it as is.
+ */
+declare const getShapeImageArtisticEffect: (shape: SlideShapeData) => ImageArtisticEffect | null;
 /**
  * Reads the picture or image fill's opacity (0–1 fraction). Returns `null` when no
- * `<a:alphaModFix>` is present (PowerPoint treats absence as fully
+ * `<a:alphaModFix>` is present (the reference desktop app treats absence as fully
  * opaque); returns `1` when an explicit alphaModFix sets full opacity.
  */
 declare const getShapeImageOpacity: (shape: SlideShapeData) => number | null;
@@ -5124,21 +5860,21 @@ declare const getShapeImageContrast: (shape: SlideShapeData) => number | null;
  */
 declare const getShapeImageBrightness: (shape: SlideShapeData) => number | null;
 /**
- * Clears PowerPoint's image color corrections from a picture or image fill.
+ * Clears the reference desktop app'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.
+ * Applies an image recolor from the reference desktop app 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.
+ * Pass `null` to restore the reference desktop app'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;
@@ -5208,10 +5944,36 @@ interface SlideAnimationStep {
   /** `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.
+   * Which edge (or corner) of the slide a fly, wipe or peek comes from or
+   * leaves by, or which corner strips start from. `null` for every other
+   * effect — the preset states no direction, so neither does this. The same
+   * goes for the four options below, each `null` unless the effect takes it.
    */
   readonly direction: AnimationDirection | null;
+  /** Blinds, checkerboard, random bars and split: which way the bars run. */
+  readonly orientation: AnimationOrientation | null;
+  /** Shape and split: whether the effect closes in on the centre or opens out of it. */
+  readonly inOut: AnimationInOut | null;
+  /** Shape: the outline the object is revealed or hidden through. */
+  readonly shape: AnimationShape | null;
+  /** Wheel: how many spokes. */
+  readonly spokes: number | null;
+  /** Spin: which way it turns. */
+  readonly spinDirection: AnimationSpinDirection | null;
+  /** Spin: how far it turns, in degrees. */
+  readonly spinDegrees: number | null;
+  /** Grow/Shrink: which axes it scales. */
+  readonly scaleDirection: AnimationScaleDirection | null;
+  /** Grow/Shrink: the size it reaches, in percent of the shape's own. */
+  readonly scalePercent: number | null;
+  /** Transparency: how transparent the shape becomes, 0–100. */
+  readonly transparencyPercent: number | null;
+  /**
+   * The colour emphasis effects: the colour they change to — a theme slot as
+   * `scheme:accent2`, an sRGB value as `#RRGGBB`, with its colour transforms
+   * when it has any.
+   */
+  readonly color: AnimationColor | null;
   readonly presetId: number | null;
   readonly presetClass: string | null;
   /** `'unknown'` when the node type is not one this library models. */
@@ -5229,8 +5991,13 @@ interface SlideAnimationStep {
    * 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;
+  /**
+   * How the effect's build entry reveals the shape's text (`<p:bldP build>`):
+   * as one object (`whole`, or no entry), all paragraphs at once
+   * (`allAtOnce`), one paragraph at a time (`p`), or `'custom'` (`cust`) — a
+   * build the reference desktop app's own Effect Options do not offer.
+   */
+  readonly build: AnimationTextBuild | 'custom';
   readonly buildLevel: number | null;
   /**
    * Which `<p:seq>` the step lives in, named after its `nodeType`. Only
@@ -5272,22 +6039,41 @@ type AnimationSequenceKind = 'mainSeq' | 'interactiveSeq' | 'other';
  * renumbered to stay unique. To clear every animation first, call
  * `clearSlideAnimations`.
  *
- * Supported `effect` tokens:
- *
- *   - `'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.
+ * `effect` is any entry of the reference desktop app's Entrance, Emphasis and Exit
+ * galleries (see `AnimationEffect`), written exactly as the reference desktop app writes it:
+ * the same preset numbers and the same behaviours, so the deck plays the same
+ * in the reference desktop app as an effect picked from its gallery.
+ *
+ * Effect Options are the options the reference desktop app offers for the preset:
+ *
+ *   - `direction` — `'flyIn'` / `'flyOut'` take any edge or corner of the
+ *     slide (`'bottom'` by default); `'wipe…'` and `'peek…'` one of the four
+ *     edges; `'strips…'` one of the four corners (`'bottomLeft'` by default).
+ *   - `orientation` — blinds, random bars and checkerboard (`'horizontal'`)
+ *     and split (`'vertical'`).
+ *   - `inOut` — shape and split: close in on the centre (`'in'`) or open out
+ *     of it (`'out'`). The reference desktop app's Shape exit defaults to `'out'`.
+ *   - `shape` — `'circle'` (the default), `'box'`, `'diamond'` or `'plus'`.
+ *   - `spokes` — wheel: 1 (the default), 2, 3, 4 or 8.
+ *   - `spinDirection` and `spinDegrees` — spin: `'clockwise'` (the default)
+ *     or `'counterclockwise'`, through any positive angle (360 by default).
+ *   - `scaleDirection` and `scalePercent` — grow/shrink: `'both'` axes (the
+ *     default), `'horizontal'` or `'vertical'`, to any positive size (150 %).
+ *   - `transparencyPercent` — transparency: 0–100 (50 by default).
+ *   - `color` — the colour emphasis effects (fill, font, line, brush and
+ *     object colour, colour pulse, grow with colour): a theme slot or
+ *     `#RRGGBB`, optionally with colour transforms. Accent 2 by default, and
+ *     Background 1 for colour pulse.
+ *
+ * An option passed for an effect that does not take it is an error rather
+ * than a no-op.
+ *
+ * `durationMs` defaults to the reference desktop app's default for the preset
+ * (`defaultAnimationDurationMs`). An effect made of several behaviours — a
+ * Bounce, a Teeter — is scaled as a whole, the way the reference desktop app's Duration box
+ * scales it. `appear` and `disappear` are instantaneous and write no timed
+ * behaviour; `transparency` and `boldReveal` hold until the slide ends and
+ * take no duration.
  *
  * `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.
@@ -5297,16 +6083,19 @@ type AnimationSequenceKind = 'mainSeq' | 'interactiveSeq' | 'other';
  * 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.
+ * before it ends — it runs indefinitely, states no duration, repeats, runs
+ * letter by letter, or starts from another node rather than at a fixed offset.
+ * The slide is left untouched; `'click'` and `'withPrevious'` need no such
+ * measurement.
+ *
+ * `build` is the reference desktop app's Effect Options "Sequence". `'asOneObject'` (the
+ * default) animates the shape with its text as one effect. `'allAtOnce'` and
+ * `'byParagraph'` give every paragraph its own effect: all of them starting
+ * together, or each on its own `start` — so the default `'click'` advances a
+ * paragraph per click. They share a single `<p:bldP>`, which is how the reference desktop app
+ * 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`.
@@ -5316,8 +6105,7 @@ declare const setShapeAnimation: (shape: SlideShapeData, opts: AnimationOptions)
  * Returns the animation effect bound to this shape via the slide's
  * `<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.
+ * the `AnimationEffect` tokens are reported as `null` rather than guessed at.
  */
 declare const getShapeAnimation: (shape: SlideShapeData) => AnimationEffect | null;
 /**
@@ -5331,7 +6119,7 @@ declare const getSlideAnimations: (slide: SlideData) => readonly SlideAnimationS
  * effect (i.e. `getShapeAnimation(shape)` is not `null`). Pair to
  * `slideHasAnimations`. Useful for audit reports — "which shapes on
  * this slide actually animate?" before exporting to a video pipeline
- * that doesn't honor PowerPoint's timing tree.
+ * that doesn't honor the reference desktop app's timing tree.
  */
 declare const findShapesWithAnimation: (slide: SlideData) => ReadonlyArray<SlideShapeData>;
 /** Removes every animation on the slide, keeping its media play controls. */
@@ -5447,7 +6235,7 @@ declare const getShapeRunHyperlink: (shape: SlideShapeData, paragraphIndex: numb
 /**
  * Reads the tooltip text on the shape's `<a:hlinkClick tooltip="…"/>`.
  * Returns `null` when no hyperlink is set or the link doesn't author
- * a tooltip. Tooltips show up in PowerPoint when the user hovers over
+ * a tooltip. Tooltips show up in the reference desktop app when the user hovers over
  * a linked shape in slide-show mode.
  *
  * Scans run-level `<a:rPr><a:hlinkClick>` first (where
@@ -5481,7 +6269,7 @@ declare const getShapeRunClickAction: (shape: SlideShapeData, paragraphIndex: nu
 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
+ * 0-indexed; the reference desktop app accepts 0 through 8. Pass `0` to clear an
  * existing level — `<a:pPr lvl="0"/>` is the same as omitting the attr.
  * Indents matching the previous level's default bullet pair follow the level;
  * other indent values are preserved.
@@ -5513,7 +6301,7 @@ declare const setParagraphLevel: (shape: SlideShapeData | TableCellData, paragra
 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. A UTF-16 range returns the levels of all
+ * absent — the reference desktop app's default. A UTF-16 range returns the levels of all
  * touched paragraphs in order. Invalid indices or ranges throw RangeError.
  */
 declare function getParagraphLevel(shape: SlideShapeData | TableCellData, paragraphIndex: number): number;
@@ -5523,7 +6311,7 @@ declare function getParagraphLevel(shape: SlideShapeData | TableCellData, range:
 }): 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
+ * a "point" is 1/72 inch). The reference desktop app stores these as hundredths of a
  * point inside `<a:pPr><a:spcBef>/<a:spcAft><a:spcPts val="…"/>` —
  * the helper converts.
  *
@@ -5549,7 +6337,7 @@ declare const getParagraphSpacing: (shape: SlideShapeData | TableCellData, parag
 /**
  * Reads the paragraph's left / right / first-line indents from
  * `<a:pPr marL="…" marR="…" indent="…"/>`. Each is in EMU (matching
- * PowerPoint's internal storage); positive means a positive indent,
+ * the reference desktop app's internal storage); positive means a positive indent,
  * negative `indent` is a hanging indent (typical for bullets).
  *
  * Returns `null` for sides the paragraph doesn't set (those inherit
@@ -5572,7 +6360,7 @@ declare const setParagraphIndent: (shape: SlideShapeData | TableCellData, paragr
   firstLineEmu?: number | null;
 }) => void;
 /**
- * Reads the paragraph's `<a:lnSpc>` line spacing. PowerPoint stores
+ * Reads the paragraph's `<a:lnSpc>` line spacing. The reference desktop app stores
  * line spacing two ways:
  *
  *   - Multiple of the natural line height — `<a:spcPct val="150000"/>`
@@ -5680,43 +6468,6 @@ declare const setParagraphTabs: (shape: SlideShapeData | TableCellData, paragrap
   defaultTabSizeEmu?: number | null;
 }) => void;
 //#endregion
-//#region src/api/fn/shape-color.d.ts
-/**
- * Resolves a DrawingML color element (`<a:srgbClr>` / `<a:schemeClr>` /
- * `<a:sysClr>` / `<a:prstClr>`) with all its `<a:lumMod>` / `<a:tint>` /
- * `<a:shade>` / `<a:satMod>` etc. transform children applied. Returns
- * `null` when the color is a scheme token and no theme is supplied to
- * resolve it.
- *
- * Exposed because both run-format and fill-format code paths need to
- * apply the same transform pipeline; keeping a single implementation
- * means future spec-coverage additions only have to land in one place.
- */
-declare const resolveDrawingColor: (colorEl: XmlElement, theme: PresentationTheme | null, clrMap?: Readonly<Record<string, string>> | null) => string | null;
-/**
- * Resolves the opacity a DrawingML color element carries through its
- * `<a:alpha>` / `<a:alphaMod>` / `<a:alphaOff>` children (ECMA-376
- * §20.1.2.3.1–3) to a `0`–`1` fraction, applied in document order from a
- * fully opaque base. Returns `null` when the element has no alpha
- * transform — PowerPoint paints that opaque, but callers can still tell
- * "unspecified" apart from an explicit `1`.
- *
- * Kept separate from `resolveDrawingColor` because alpha never changes the
- * `#RRGGBB`; OOXML encodes the two independently and renderers emit the
- * opacity next to the color (`fill-opacity` / `stroke-opacity`).
- */
-declare const resolveDrawingColorOpacity: (colorEl: XmlElement) => number | null;
-/**
- * Reads back the format of a single run. Returns `null` when the run
- * has no `<a:rPr>` (it inherits its format from the paragraph /
- * layout / master). Boolean attributes that are explicitly `"0"`
- * decode to `false`.
- *
- * Use `getShapeRunFormatEffective` if you want the resolved format
- * after walking the placeholder / lstStyle / master inheritance chain.
- */
-declare const getShapeRunFormat: (shape: SlideShapeData, paragraphIndex: number, runIndex: number) => ReadTextFormat | null;
-//#endregion
 //#region src/api/fn/shape-removal-zorder.d.ts
 /**
  * Copies a shape into `targetSlide`, including nested shapes and relationships.
@@ -5751,13 +6502,6 @@ declare const getShapeZIndex: (shape: SlideShapeData) => number;
 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.
- *
- * Removing a picture does NOT delete the underlying media part — it
- * may be referenced from other slides.
- */
 /**
  * Removes every shape (sp / pic / cxnSp / graphicFrame / grpSp) from
  * the slide's `<p:spTree>`. The required `<p:nvGrpSpPr>` and
@@ -5767,6 +6511,13 @@ declare const sendShapeBackward: (shape: SlideShapeData | readonly SlideShapeDat
  * Useful for "start this slide over but keep its layout binding."
  */
 declare const clearSlideShapes: (slide: SlideData) => void;
+/**
+ * Removes the shape from its slide's shape tree. Subsequent property
+ * reads on this handle reflect the stale snapshot — discard it after.
+ *
+ * Removing a picture does NOT delete the underlying media part — it
+ * may be referenced from other slides.
+ */
 declare const removeShape: (shape: SlideShapeData) => void;
 //#endregion
 //#region src/api/fn/shape-authoring.d.ts
@@ -5817,7 +6568,7 @@ declare const addSlideLine: (slide: SlideData, opts: {
 }) => SlideShapeData;
 /**
  * Adds a table to the slide. Cells render as plain text; `firstRow` /
- * `bandRow` flags drive PowerPoint's banded-header look unless options say
+ * `bandRow` flags drive the reference desktop app's banded-header look unless options say
  * otherwise.
  *
  * Cell text color is baked from the deck's resolved body-text color so the
@@ -5866,7 +6617,7 @@ declare const addSlideImage: (slide: SlideData, bytes: Uint8Array, opts: {
 //#endregion
 //#region src/api/fn/layout-edit.d.ts
 /**
- * Renames the layout. This is the name PowerPoint shows in the
+ * Renames the layout. This is the name the reference desktop app 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.
@@ -5891,13 +6642,34 @@ declare const clearSlideLayoutBackground: (layout: SlideLayoutData) => void;
  *
  * 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
+ * `<a:xfrm>` keeps it, exactly as the reference desktop app 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/_part-placeholders.d.ts
+/**
+ * Read-only view of one placeholder on a slide layout or master. Surfaces the
+ * fields a slide-author cares about when binding a slide to a layout: which
+ * slot is for the title, which is for the body, etc.
+ */
+interface SlideLayoutPlaceholder {
+  /** `<p:ph type="...">`. `null` when omitted — the spec default is `obj`. */
+  readonly type: string | null;
+  /** `<p:ph idx="...">`. `null` when omitted — spec default is `0`. */
+  readonly idx: number | null;
+  /** `<p:cNvPr name="...">` — what the reference desktop app shows in the selection pane. */
+  readonly name: string;
+  /**
+   * Position + size in EMU. A layout placeholder with no `<a:xfrm>` of its
+   * own inherits them from the master. `null` when the placeholder has no
+   * explicit transform.
+   */
+  readonly bounds: ShapeBounds | null;
+}
+//#endregion
 //#region src/api/fn/layouts.d.ts
-/** PowerPoint's user-visible layout name. */
+/** The reference desktop app's user-visible layout name. */
 declare const getSlideLayoutName: (layout: SlideLayoutData) => string;
 /**
  * Returns the package part name (e.g. `/ppt/slideLayouts/slideLayout3.xml`)
@@ -5911,26 +6683,6 @@ declare const getSlideLayoutPartName: (layout: SlideLayoutData) => string;
  * `findSlideByPartName` for layouts.
  */
 declare const findSlideLayoutByPartName: (pres: PresentationData, partName: string) => SlideLayoutData | null;
-/**
- * Read-only view of one placeholder on a slide layout. Surfaces the
- * three fields a slide-author cares about when binding a slide to a
- * layout: which slot is for the title, which is for the body, etc.
- */
-interface SlideLayoutPlaceholder {
-  /** `<p:ph type="...">`. `null` when omitted — spec default is `body`. */
-  readonly type: string | null;
-  /** `<p:ph idx="...">`. `null` when omitted — spec default is `0`. */
-  readonly idx: number | null;
-  /** `<p:cNvPr name="...">` — what PowerPoint shows in the selection pane. */
-  readonly name: string;
-  /**
-   * Layout-defined position + size in EMU. A slide placeholder with no
-   * `<a:xfrm>` of its own inherits these. `null` when the layout
-   * placeholder also lacks an explicit transform (rare — usually the
-   * master defines it then).
-   */
-  readonly bounds: ShapeBounds | null;
-}
 /**
  * Enumerates the placeholder shapes on a slide layout. Non-placeholder
  * shapes (decorative rectangles, watermarks added to the layout) are
@@ -5950,7 +6702,7 @@ declare const getSlideLayoutPlaceholders: (layout: SlideLayoutData) => ReadonlyA
  * String matching is **case-sensitive** and exact: `findSlideLayout(pres,
  * 'Blank')` matches a layout named `"Blank"` but not `"blank"`. The
  * user-visible name is also locale-dependent (a deck authored in a
- * non-English PowerPoint localizes `"Blank"`), so prefer
+ * The reference desktop app localizes `"Blank"`), so prefer
  * {@link findSlideLayoutByType} — which matches the locale-stable
  * `<p:sldLayout type="…">` token (`'blank'`, `'title'`, `'obj'`, …) —
  * when you need a robust lookup. Pass a `RegExp` with the `i` flag here
@@ -5969,7 +6721,7 @@ declare const findLayoutsWithPlaceholderType: (pres: PresentationData, type: Pla
  * token. Unlike `findSlideLayout` (which matches the user-visible
  * name, and is therefore locale-sensitive), this matches the spec
  * token — `title`, `obj`, `twoObj`, `blank`, etc. — and is stable
- * across PowerPoint UI languages.
+ * across the reference desktop app's UI languages.
  */
 declare const findSlideLayoutByType: (pres: PresentationData, layoutType: SlideLayoutType | string) => SlideLayoutData | null;
 /**
@@ -6006,12 +6758,135 @@ declare const getUnusedSlideLayouts: (pres: PresentationData) => ReadonlyArray<S
 declare const getSlideLayoutUsageCountsByType: (pres: PresentationData) => Readonly<Record<string, number>>;
 declare const getSlideLayoutUsageCounts: (pres: PresentationData) => Readonly<Record<string, number>>;
 //#endregion
+//#region src/api/fn/slide-masters.d.ts
+/** The master's layouts, in the order the reference desktop app's Slide Master pane lists them. */
+declare const getSlideMasterLayouts: (pres: PresentationData, master: string) => ReadonlyArray<SlideLayoutData>;
+/**
+ * The master's own placeholders (title, body, date, footer, slide number) and
+ * where it puts them. A layout placeholder without a transform of its own sits
+ * where the master's placeholder of the same type does.
+ */
+declare const getSlideMasterPlaceholders: (pres: PresentationData, master: string) => ReadonlyArray<SlideLayoutPlaceholder>;
+/**
+ * The master's name, as the reference desktop app shows it in Slide Master view ("<theme
+ * name> Slide Master"). The reference desktop app keeps it as the name of the master's theme
+ * (`<a:theme name>`), not in the master part, so renaming a master renames its
+ * theme.
+ */
+declare const getSlideMasterName: (pres: PresentationData, master: string) => string;
+/**
+ * Whether the master is preserved (`<p:sldMaster preserve="1">`): the reference desktop app
+ * deletes a master that is not preserved once no slide uses it.
+ */
+declare const isSlideMasterPreserved: (pres: PresentationData, master: string) => boolean;
+/** Renames the master (its theme; see `getSlideMasterName`). */
+declare const setSlideMasterName: (pres: PresentationData, master: string, name: string) => void;
+/** Sets or clears Preserve Master. */
+declare const setSlideMasterPreserved: (pres: PresentationData, master: string, preserved: boolean) => void;
+/**
+ * Insert Slide Master: adds the reference desktop app's default master, with its own
+ * copy of the default theme named "Custom Design" and the eleven default
+ * layouts, after the existing masters. The master is preserved, as the reference desktop app
+ * marks a master it inserts. Returns the new master's part name.
+ */
+declare const addSlideMaster: (pres: PresentationData) => string;
+/**
+ * Deletes a master with its layouts and, when nothing else uses it, its theme.
+ * Like the reference desktop app's Delete, this refuses (throws) while any slide uses one of
+ * the master's layouts, and for the presentation's only master.
+ */
+declare const removeSlideMaster: (pres: PresentationData, master: string) => void;
+/**
+ * Insert Layout: adds the reference desktop app's "Custom Layout" — a title and the date,
+ * footer and slide-number placeholders — to `master`, at `index` in its layout
+ * list (the end by default). Repeats are named "1_Custom Layout", and so on.
+ */
+declare const addSlideLayout: (pres: PresentationData, master: string, options?: {
+  index?: number;
+}) => SlideLayoutData;
+/**
+ * Deletes a layout. Like the reference desktop app's Delete, this refuses (throws) while any
+ * slide uses the layout, and for a master's only layout.
+ */
+declare const removeSlideLayout: (layout: SlideLayoutData) => void;
+/**
+ * Master Layout: removes one of the master's five placeholders, or puts it
+ * back where the reference desktop app's default master has it.
+ */
+declare const setSlideMasterPlaceholderIncluded: (pres: PresentationData, master: string, type: MasterPlaceholderType, included: boolean) => void;
+/** The layout's Title checkbox: removes its title, or adds one that follows the master's. */
+declare const setSlideLayoutTitleIncluded: (layout: SlideLayoutData, included: boolean) => void;
+/**
+ * The layout's Footers checkbox: removes its date, footer and slide-number
+ * placeholders, or adds whichever are missing (they follow the master's).
+ */
+declare const setSlideLayoutFootersIncluded: (layout: SlideLayoutData, included: boolean) => void;
+/**
+ * Hide Background Graphics on a layout (`showMasterSp="0"`): slides on it stop
+ * showing the master's decorative shapes; the layout's own shapes stay.
+ */
+declare const setSlideLayoutBackgroundGraphicsHidden: (layout: SlideLayoutData, hidden: boolean) => void;
+/**
+ * Insert Placeholder: draws a placeholder of `kind` on the layout at `bounds`.
+ * Slides added on the layout get the placeholder; content and text
+ * placeholders carry the master's five prompt levels, the others their
+ * kind's prompt ("Picture", "Chart", …). Returns the placeholder's index in
+ * `getSlideLayoutPlaceholders`.
+ */
+declare const addSlideLayoutPlaceholder: (layout: SlideLayoutData, kind: LayoutPlaceholderKind, bounds: ShapeBounds) => number;
+//#endregion
+//#region src/api/fn/page-masters.d.ts
+/**
+ * The notes master's placeholders (header, date, slide image, notes body,
+ * footer, slide number) and where they sit on the page, or `null` when the
+ * presentation has no notes master.
+ */
+declare const getNotesMasterPlaceholders: (pres: PresentationData) => ReadonlyArray<SlideLayoutPlaceholder> | null;
+/**
+ * The handout master's placeholders (header, date, footer, page number), or
+ * `null` when the presentation has no handout master.
+ */
+declare const getHandoutMasterPlaceholders: (pres: PresentationData) => ReadonlyArray<SlideLayoutPlaceholder> | null;
+/**
+ * The Notes Master tab's placeholder checkboxes: removes a placeholder from
+ * the notes master, or puts it back where the reference desktop app's default puts it.
+ * Creates the default notes master when the presentation has none.
+ */
+declare const setNotesMasterPlaceholderIncluded: (pres: PresentationData, type: NotesMasterPlaceholderType, included: boolean) => void;
+/** The Handout Master tab's placeholder checkboxes; see `setNotesMasterPlaceholderIncluded`. */
+declare const setHandoutMasterPlaceholderIncluded: (pres: PresentationData, type: HandoutMasterPlaceholderType, included: boolean) => void;
+/**
+ * The notes and handout page (`<p:notesSz>`), in EMU. Notes pages, handouts
+ * and the outline print on it; it is portrait unless it is wider than tall.
+ */
+declare const getNotesPageSize: (pres: PresentationData) => {
+  width: Emu;
+  height: Emu;
+};
+/**
+ * Handout Orientation / Notes Page Orientation. Both turn the one notes page
+ * (`<p:notesSz>`) that notes pages and handouts share, and the reference desktop app moves
+ * the notes master, the handout master and every notes page with it.
+ */
+declare const setNotesPageOrientation: (pres: PresentationData, orientation: "portrait" | "landscape") => void;
+/** The Handout Master tab's Slides Per Page choices (`'outline'` is Slide Outline). */
+type HandoutSlidesPerPage = 1 | 2 | 3 | 4 | 6 | 9 | 'outline';
+/**
+ * How many slides the handout master lays out per page. The handout master
+ * part has nowhere to keep it; the schema's only home for a handout layout is
+ * the print settings' `<p:prnPr prnWhat>` in the presentation properties, so
+ * that is where it is read from (six when it names no handout layout).
+ */
+declare const getHandoutSlidesPerPage: (pres: PresentationData) => HandoutSlidesPerPage;
+/** Sets the handout's slides per page; see `getHandoutSlidesPerPage`. */
+declare const setHandoutSlidesPerPage: (pres: PresentationData, slidesPerPage: HandoutSlidesPerPage) => void;
+//#endregion
 //#region src/api/fn/properties.d.ts
 /**
  * Document-level metadata from `/docProps/core.xml` (Open Packaging
- * Conventions). Surfaces the fields PowerPoint, Keynote, and
+ * Conventions). Surfaces the fields the reference desktop app, Keynote, and
  * everyone else exchange via OPC core-properties — these are the
- * values shown in PowerPoint's "File › Properties" / "Info" panel.
+ * values shown in the reference desktop app's "File › Properties" / "Info" panel.
  */
 interface CoreProperties {
   readonly title: string | null;
@@ -6066,7 +6941,7 @@ declare const getCoreProperties: (pres: PresentationData) => CoreProperties | nu
  * override) if the package didn't have one.
  *
  * Note: setting `created` / `modified` requires an ISO-8601 timestamp
- * string (e.g. `'2026-05-15T12:34:56Z'`). PowerPoint expects the
+ * string (e.g. `'2026-05-15T12:34:56Z'`). The reference desktop app expects the
  * `xsi:type="dcterms:W3CDTF"` attribute on these elements but readers
  * we tested all accept missing-attribute output too; this helper
  * therefore omits the attribute for simplicity.
@@ -6074,13 +6949,13 @@ declare const getCoreProperties: (pres: PresentationData) => CoreProperties | nu
 declare const setCoreProperties: (pres: PresentationData, values: Partial<CoreProperties>) => void;
 /**
  * Selected string fields from `/docProps/app.xml`
- * (extended-properties / "app props"). PowerPoint exposes these
+ * (extended-properties / "app props"). The reference desktop app exposes these
  * under File › Info / Properties as the "Origin" and "Related
  * People" groups.
  *
  * Numeric / derived fields (`Slides`, `Words`, `Paragraphs`, …) are
- * intentionally omitted — they're recomputed by PowerPoint on save
- * and reading them tends to lie about decks edited outside Office.
+ * intentionally omitted — they're recomputed by the reference desktop app on save
+ * and reading them tends to lie about decks edited in other apps.
  */
 interface ExtendedProperties {
   readonly application: string | null;
@@ -6110,7 +6985,7 @@ declare const setExtendedProperties: (pres: PresentationData, values: Partial<Ex
 //#endregion
 //#region src/api/fn/thumbnail.d.ts
 /**
- * The package's thumbnail image, when present. PowerPoint, the OS
+ * The package's thumbnail image, when present. The reference desktop app, the OS
  * file picker, and SharePoint preview decks via this. Format is
  * what's encoded in the thumbnail part — usually JPEG.
  */
@@ -6368,7 +7243,7 @@ interface AllShapesEntry {
 declare const getAllShapes: (pres: PresentationData) => ReadonlyArray<AllShapesEntry>;
 /**
  * Returns `true` when the slide carries `show="0"` on its root
- * `<p:sld>` element. PowerPoint hides such slides from the slideshow
+ * `<p:sld>` element. The reference desktop app hides such slides from the slideshow
  * but keeps them in the editing surface.
  */
 declare const isSlideHidden: (slide: SlideData) => boolean;
@@ -6378,7 +7253,7 @@ declare const isSlideBackgroundGraphicsHidden: (slide: SlideData) => boolean;
 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
+ * The reference desktop app'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;
@@ -6394,7 +7269,7 @@ declare const setSlideBackgroundGraphicsHidden: (slide: SlideData, hidden: boole
 declare const slideHasAnimations: (slide: SlideData) => boolean;
 /**
  * Toggles the slide's visibility in the slideshow. Hiding adds
- * `show="0"`; showing removes the attribute (PowerPoint treats absence
+ * `show="0"`; showing removes the attribute (the reference desktop app treats absence
  * as the default `show="1"`).
  */
 declare const setSlideHidden: (slide: SlideData, hidden: boolean) => void;
@@ -6467,7 +7342,7 @@ declare const addContentSlide: (pres: PresentationData, opts: {
 /**
  * Sugar over `addSlide` + `setSlideTitle` for the section-divider
  * pattern. Picks `<p:sldLayout type="secHead">` when present (the
- * PowerPoint "Section Header" layout); otherwise falls back to a
+ * the reference desktop app's "Section Header" layout); otherwise falls back to a
  * `title`-typed layout or the first available layout.
  */
 declare const addSectionHeaderSlide: (pres: PresentationData, title: string) => SlideData;
@@ -6499,7 +7374,7 @@ declare const addSlide: (pres: PresentationData, options: {
  *
  * Media parts are intentionally NOT cleaned up — they may be shared
  * with other slides. The freed `sldId` is NOT reused on subsequent
- * `addSlide` calls (PowerPoint quirk, see plan §Risks).
+ * `addSlide` calls (the reference desktop app's quirk, see plan §Risks).
  */
 declare const removeSlide: (pres: PresentationData, slide: SlideData) => void;
 /**
@@ -6511,7 +7386,7 @@ declare const removeSlide: (pres: PresentationData, slide: SlideData) => void;
  *
  * Internally walks `<p:sldIdLst>` and re-emits its `<p:sldId>` children
  * in the new order. Slide parts and rels are untouched — only the
- * order in which PowerPoint plays them changes.
+ * order in which the reference desktop app plays them changes.
  */
 declare const sortSlides: (pres: PresentationData, compareFn: (a: SlideData, b: SlideData) => number) => void;
 /**
@@ -6616,7 +7491,7 @@ declare const addMissingSlidePlaceholders: (slide: SlideData) => number;
  * 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
+ * from the master, without changing the layout (as the reference desktop app does when
  * demoting outline text into a Title Only slide). Returns null if absent there.
  */
 declare const addSlidePlaceholder: (slide: SlideData, type: PlaceholderType, options?: {
@@ -6646,12 +7521,12 @@ declare const resetSlidePlaceholderTextFormatting: (slide: SlideData) => number;
 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. */
+/** Whether the object's movement and resizing are both locked, as in the reference desktop app's Selection Pane. */
 declare const isShapeLocked: (shape: SlideShapeData) => boolean;
-/** Whether PowerPoint preserves this object's aspect ratio while resizing it. */
+/** Whether the reference desktop app 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,
+ * Locks or unlocks object geometry like the reference desktop app'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.
@@ -6679,7 +7554,7 @@ interface CustomGeometryInput {
 }
 /**
  * Replaces the shape's geometry (preset or custom) with the given paths. The
- * text rectangle is the whole shape, as PowerPoint writes for freeforms.
+ * text rectangle is the whole shape, as the reference desktop app writes for freeforms.
  * Coordinates are rounded to integers, which the schema requires.
  */
 declare const setShapeCustomGeometry: (shape: SlideShapeData, geometry: CustomGeometryInput) => void;
@@ -6689,6 +7564,13 @@ declare const setShapeCustomGeometry: (shape: SlideShapeData, geometry: CustomGe
 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;
+/**
+ * The literal `lang` of each run, field and line break in a paragraph, in
+ * `getShapeParagraphElements` order, or `null` where the element names none.
+ * Renderers use it for language-dependent layout such as the character a
+ * decimal tab aligns on.
+ */
+declare const getParagraphElementLanguages: (target: SlideShapeData | TableCellData, paragraphIndex: number) => ReadonlyArray<string | null>;
 //#endregion
 //#region src/api/fn/shape-style.d.ts
 /** One DrawingML style-list reference used by a shape quick style. */
@@ -6697,7 +7579,7 @@ interface ShapeStyleReference {
   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). */
+  /** Ordered DrawingML color transforms (for example the reference desktop app's shade). */
   readonly colorTransforms?: readonly ColorTransform[];
 }
 interface ShapeStyleFontReference {
@@ -6804,7 +7686,7 @@ type ShapeMedia = {
 declare const addSlideMedia: (slide: SlideData, opts: SlideMediaOptions) => SlideShapeData;
 /**
  * Returns the clip behind a media picture, or `null` when the shape is not
- * one. Reads PowerPoint-, PptxGenJS- and python-pptx-authored media alike: the
+ * one. Reads media authored by the reference desktop app, PptxGenJS and python-pptx alike: the
  * embedded part is taken from `<p14:media r:embed>` when present and from the
  * DrawingML `r:link` otherwise; a relationship with an external target is
  * reported as `'online'`.
@@ -6831,7 +7713,7 @@ interface MediaBookmark {
  * 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.
+ * Trimming and fades are stored in the `p14:media` extension ([MS-PPTX]).
  * `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).
  */
@@ -6842,7 +7724,7 @@ interface MediaPlayback {
   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. */
+  /** Playback volume, 0–1. The reference desktop app's own default is 0.8. */
   readonly volume: number;
   readonly muted: boolean;
   /** Video only: plays filling the screen. */
@@ -6879,9 +7761,43 @@ declare const getShapeMediaPlayback: (shape: SlideShapeData) => MediaPlayback |
  */
 declare const setShapeMediaPlayback: (shape: SlideShapeData, options: Partial<MediaPlayback>) => void;
 //#endregion
+//#region src/api/fn/shape-picture-style.d.ts
+/**
+ * Applies one of the reference desktop app's built-in Picture Styles (see
+ * `BUILTIN_PICTURE_STYLES`) to a picture. Like the reference desktop app, it replaces the
+ * picture's geometry, fill, border, effects and 3-D in `<p:spPr>` with the
+ * style's own markup — which names no theme color, so the result does not
+ * follow the theme — and keeps the picture, its crop and its position. Throws
+ * when the shape is not a picture or `style` is not a built-in name.
+ */
+declare const setShapePictureStyle: (shape: SlideShapeData, style: BuiltinPictureStyleName) => void;
+/**
+ * The built-in picture style whose markup the picture's `<p:spPr>` carries
+ * exactly (position, size and extensions aside), or `null`. A deck does not
+ * record which style was applied, so a picture styled and then edited — a
+ * different border, an extra effect — reads as `null`.
+ */
+declare const getShapePictureStyle: (shape: SlideShapeData) => BuiltinPictureStyleName | null;
+/**
+ * `ST_BlipCompression`: the target a picture was compressed for. The reference desktop app's
+ * Compress Pictures writes `print` (220 ppi), `screen` (150 ppi) and `email`
+ * (96 ppi); `hqprint` and `none` are the schema's other values.
+ */
+type ImageCompressionState = 'email' | 'screen' | 'print' | 'hqprint' | 'none';
+/** The picture's `a:blip/@cstate`, or `null` when it has none. */
+declare const getShapeImageCompressionState: (shape: SlideShapeData) => ImageCompressionState | null;
+/**
+ * Records what a picture was compressed for, as Compress Pictures does: it
+ * sets `a:blip/@cstate` and adds the `a14:useLocalDpi` extension (without a
+ * `val`, meaning true) that the reference desktop app writes alongside it. `null` removes
+ * both. This only labels the picture; resample the pixels with
+ * `setShapeImage`.
+ */
+declare const setShapeImageCompressionState: (shape: SlideShapeData, state: ImageCompressionState | null) => void;
+//#endregion
 //#region src/api/fn/shape-video.d.ts
 /**
- * Restores a video to PowerPoint's default shape formatting.
+ * Restores a video to the reference desktop app'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,
@@ -6895,30 +7811,56 @@ declare const resetShapeVideoFormatting: (shape: SlideShapeData) => void;
  * 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.
+ * `build` is not an attribute flip: a paragraph build (`'allAtOnce'`,
+ * `'byParagraph'`) replaces the effect with one per paragraph of the shape's
+ * text, and `'asOneObject'` replaces the whole build with a single effect on
+ * the shape; switching between the two paragraph builds replaces every
+ * paragraph's effect. In every direction 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.
+   * Which edge a fly, wipe or peek comes from or leaves by, or which corner
+   * strips start from. 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 takes no direction is an error — including
+   * one this patch is turning into such an effect. The same holds for the
+   * four options below; `setShapeAnimation` documents which effects take
+   * which.
    */
   readonly direction?: AnimationDirection;
+  readonly orientation?: AnimationOrientation;
+  readonly inOut?: AnimationInOut;
+  readonly shape?: AnimationShape;
+  readonly spokes?: number;
+  /**
+   * The emphasis effects' own options, as `setShapeAnimation` takes them:
+   * Spin's direction and angle, Grow/Shrink's axes and size, Transparency's
+   * amount, and the colour of the colour effects.
+   */
+  readonly spinDirection?: AnimationSpinDirection;
+  readonly spinDegrees?: number;
+  readonly scaleDirection?: AnimationScaleDirection;
+  readonly scalePercent?: number;
+  readonly transparencyPercent?: number;
+  readonly color?: AnimationColor;
+  /**
+   * How long the effect runs. Left out, a changed effect keeps the duration
+   * the slide gave it, unless the patch changes the preset itself: a new
+   * preset takes its own default length, as picking one from the reference desktop app's
+   * gallery does.
+   */
   readonly durationMs?: number;
   readonly start?: AnimationStartCondition;
   readonly delayMs?: number;
-  readonly byParagraph?: boolean;
+  readonly build?: AnimationTextBuild;
 }
 /**
- * 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.
+ * Changes one effect: its preset, its options, how long it runs, when it
+ * starts, and how the shape's text is built.
  *
  * 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
@@ -7192,7 +8134,8 @@ declare const setSlideBackgroundImageOpacity: (slide: SlideData, opacity: number
 /**
  * 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.
+ * A new pattern uses the reference desktop app's defaults: pct5, accent1 foreground, bg1
+ * background.
  */
 declare const setSlideBackgroundPatternFill: (slide: SlideData, options: Partial<PatternFillOptions>) => void;
 /**
@@ -7204,8 +8147,8 @@ declare const setSlideBackgroundPatternFill: (slide: SlideData, options: Partial
 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.
+ * Like the reference desktop app on Mac, 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;
 /**
@@ -7225,7 +8168,7 @@ 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).
+ * Choose one of the reference desktop app'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.
@@ -7251,13 +8194,14 @@ declare const getSlideMasterBackgroundStyles: (slide: SlideData) => SlideMasterB
  * The slide's effective color map: the master's `<p:clrMap>`, overlaid by a
  * 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.
+ * the standard map for decks that omit it. Given a layout, it is the map the
+ * layout itself is drawn with (its master's, under its own override).
  *
  * Pass the result to color resolution / renderers so `schemeClr` tokens map to
- * the theme slot PowerPoint actually paints — critical for decks with an
+ * the theme slot the reference desktop app actually paints — critical for decks with an
  * inverted map (`bg1="dk1" tx1="lt1"`).
  */
-declare const getEffectiveColorMap: (slide: SlideData) => Record<string, string>;
+declare const getEffectiveColorMap: (slide: SlideData | SlideLayoutData) => Record<string, string>;
 /**
  * The concrete `#RRGGBB` color the deck paints body text in, resolved through
  * the effective color map + theme. Read from the master's `bodyStyle` level-1
@@ -7269,7 +8213,7 @@ declare const getEffectiveColorMap: (slide: SlideData) => Record<string, string>
  * the SAME as the background, making the text invisible. Baking the body color
  * in keeps generated tables / charts readable on whatever surface the deck uses.
  */
-declare const resolveDeckBodyTextColor: (slide: SlideData) => string | null;
+declare const resolveDeckBodyTextColor: (slide: SlideData | SlideLayoutData) => string | null;
 //#endregion
 //#region src/api/fn/slide-transition.d.ts
 /**
@@ -7280,7 +8224,7 @@ declare const resolveDeckBodyTextColor: (slide: SlideData) => string | null;
 declare const getSlideTransition: (slide: SlideData) => SlideTransition | null;
 /**
  * Sets the slide's transition effect. A sound set with
- * `setSlideTransitionSound` is kept, as PowerPoint keeps it when the effect
+ * `setSlideTransitionSound` is kept, as the reference desktop app keeps it when the effect
  * changes.
  */
 declare const setSlideTransition: (slide: SlideData, options: TransitionOptions) => void;
@@ -7312,7 +8256,7 @@ declare const getSlideTransitionSound: (slide: SlideData) => TransitionSound | n
 /**
  * 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.
+ * the reference desktop app stores a sound on a "None" transition.
  */
 declare const setSlideTransitionSound: (slide: SlideData, sound: TransitionSoundInput | null) => void;
 //#endregion
@@ -7636,7 +8580,7 @@ declare const setSlideNotes: (slide: SlideData, value: string, options?: {
   };
   newlines?: "paragraph" | "break";
 }) => void;
-/** Applies PowerPoint-style Change Case to a speaker-notes range. */
+/** Applies Change Case, as the reference desktop app does, to a speaker-notes range. */
 declare const transformSlideNotesCase: (slide: SlideData, value: TextCase, options?: {
   range?: {
     start: number;
@@ -7680,7 +8624,7 @@ declare const clearAllSlideNotes: (pres: PresentationData) => number;
 //#endregion
 //#region src/api/fn/slide-size.d.ts
 /**
- * Width × height of the slide canvas, in EMU. `type` is PowerPoint's
+ * Width × height of the slide canvas, in EMU. `type` is the reference desktop app's
  * aspect-ratio hint (`screen4x3`, `screen16x9`, ...); the actual size
  * is always `width` × `height`.
  */
@@ -7692,7 +8636,7 @@ 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
+ * The number the reference desktop app 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.
@@ -7714,7 +8658,7 @@ declare const setSlideSize: (pres: PresentationData, opts: SlideSize, options?:
 }) => void;
 /** 10in × 7.5in (`screen4x3`). */
 declare const SLIDE_SIZE_4_3: SlideSize;
-/** 13.333in × 7.5in (`screen16x9`) — Office 2013+ default. */
+/** 13.333in × 7.5in (`screen16x9`) — the default since 2013. */
 declare const SLIDE_SIZE_16_9: SlideSize;
 /** 13.333in × 8.33in (`screen16x10`). */
 declare const SLIDE_SIZE_16_10: SlideSize;
@@ -7737,17 +8681,19 @@ declare function getDrawingGuidesVisible(presentation: PresentationData): boolea
 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;
+/** Turns snapping objects to the document grid (View ▸ Guides ▸ Snap to Grid) on or off. */
 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;
+/** Sets the document grid's horizontal (`x`) and vertical (`y`) spacing, in EMU. */
 declare const setGridSpacing: (presentation: PresentationData, spacing: {
   x: number;
   y: number;
 }) => void;
-/** Slides whose bodies are collapsed in PowerPoint's outline view, in deck order. */
+/** Slides whose bodies are collapsed in the reference desktop app'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;
@@ -7794,7 +8740,7 @@ interface SlideShowProperties {
   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`
+   * reveals its play bar. The reference desktop app stores it as `p14:showMediaCtrls`
    * in the show properties' extension list; omit it to leave the file as is.
    */
   showMediaControls?: boolean;
@@ -7807,5 +8753,5 @@ declare function setSlideShowProperties(pres: PresentationData, settings: SlideS
 //#region src/api/index.d.ts
 declare const VERSION: string;
 //#endregion
-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
+export { getSlideNotes as $, findShapesWithAnimation as $a, ChartUpDownBars as $c, getSlideLayout as $d, loadPresentation as $f, SlideLayoutPlaceholder as $i, getShapeTextAutoFitParams as $l, resetSlidePlaceholderTextFormatting as $n, slidesUsingMediaPart as $o, BulletStyle as $p, searchSlides as $r, setTableStyleId as $s, getSlideMasterBackgroundImageBytes as $t, setShapeRotation as $u, PresentationNotesEntry as A, getShapeParagraphElements as Aa, RadarChartSpec as Ac, getShapeStrokeEffective as Ad, getShapeSize as Af, getSlideMasterName as Ai, getSlideComments as Al, asColor as Am, getShapeMedia as An, getShapeImagePartName as Ao, MasterPlaceholderType as Ap, getPresentationTextLength as Ar, getTableSize as As, setSlideMasterBackgroundStyle as At, getShapeEffectsEffective as Au, getAllCharts as B, setParagraphLevel as Ba, ChartDateAxis as Bc, findShapesByHyperlink as Bd, pointInShape as Bf, setSlideMasterPreserved as Bi, setShapeHyperlink as Bl, inches as Bm, getShapeTextLanguage as Bn, MediaPart as Bo, GeomPoint as Bp, getSlideText as Br, setTableCellAlignment as Bs, getSlideBackgroundImageFillLayout as Bt, getShapeStrokeArrow as Bu, getPresentationFirstSlideNumber as C, getParagraphEndFormat as Ca, ComboChartSpec as Cc, getShapeFillEffective as Cd, getShapeKind as Cf, setHandoutSlidesPerPage as Ci, getCommentStatus as Cl, GlowOptions as Cm, MediaPlayback as Cn, getShapeImageContrast as Co, MorphOption as Cp, findSlideByTitle as Cr, getTableCellText as Cs, getSlideTransitionSound as Ct, ShapeEffect as Cu, PresentationCommentEntry as D, getParagraphSpacing as Da, Pie3DChartSpec as Dc, getShapeStrokeColor as Dd, getShapePosition as Df, addSlideLayoutPlaceholder as Di, getPresentationCommentCountsBySlide as Dl, Color as Dm, SlideMediaSource as Dn, getShapeImageFormat as Do, TransitionPreset as Dp, getOutlineText as Dr, getTableColumnWidths as Ds, resolveDeckBodyTextColor as Dt, getShape3D as Du, PresentationChartEntry as E, getParagraphLineSpacing as Ea, OfPieChartSpec as Ec, getShapeStrokeCap as Ed, getShapePlaceholderType as Ef, addSlideLayout as Ei, getPresentationCommentCountsByAuthor as El, ShadowOptions as Em, SlideMediaOptions as En, getShapeImageFillBytes as Eo, TransitionOptions as Ep, getAllShapes as Er, getTableCells as Es, getEffectiveColorMap as Et, findShapesByEffect as Eu, clearAllSlideNotes as F, getShapeRunText as Fa, isChartSpec as Fc, findEmptyPlaceholders as Fd, getSlideMasterUsageCounts as Ff, setSlideLayoutBackgroundGraphicsHidden as Fi, ParagraphProperties as Fl, VideoFormat as Fm, ShapeStyleFontReference as Fn, setShapeImageBrightness as Fo, BuiltinPictureStyleName as Fp, getSlideIndex as Fr, isChartShape as Fs, copySlideBackground as Ft, setShapeShadow as Fu, getAllTables as G, setShapeRunHyperlink as Ga, ChartManualLayout as Gc, findShapesWithHyperlinks as Gd, setShapeHidden as Gf, getSlideLayoutName as Gi, TextAnchor as Gl, isShapeAspectRatioLocked as Gn, getMediaParts as Go, LightRig as Gp, isSlideBackgroundGraphicsHidden as Gr, setTableCellMargins as Gs, getSlideLayoutBackground as Gt, setShapeFlip as Gu, getAllHyperlinks as H, setParagraphSpacing as Ha, ChartErrorBars as Hc, findShapesByName as Hd, setShapeAltTitle as Hf, findSlideLayout as Hi, getShapeRunFormat as Hl, pt as Hm, CustomGeometryInput as Hn, PresentationSummary as Ho, Bevel as Hp, getSlideXmlString as Hr, setTableCellBorders as Hs, getSlideBackgroundImageOpacity as Ht, getShapeStrokeSketch as Hu, clearSlideHyperlinks as I, isParagraphBulletPicture as Ia, ChartAxisScaling as Ic, findShapeById as Id, getUnusedSlideMasters as If, setSlideLayoutFootersIncluded as Ii, ParagraphTabStop as Il, ImageFormat as Im, ShapeStyleOptions as In, setShapeImageContrast as Io, BUILTIN_PICTURE_STYLES as Ip, getSlideInfo as Ir, isTableShape as Is, getSlideBackground as It, setShapeSoftEdge as Iu, getHiddenSlides as J, getSlideTitle as Ja, ChartSeries as Jc, findSlidePlaceholders as Jd, getSlideSections as Jf, getSlideLayoutType as Ji, appendShapeText as Jl, setShapeLocked as Jn, getPresentationSummary as Jo, PresetMaterial as Jp, replaceTextInNotes as Jr, setTableCellTextDirection as Js, getSlideLayoutBackgroundPatternFill as Jt, setShapeNoFill as Ju, getDistinctHyperlinkUrls as K, setShapeRunText as Ka, ChartOfPie as Kc, findSlidePlaceholder as Kd, shapesOverlap as Kf, getSlideLayoutPartName as Ki, TextAutoFit as Kl, isShapeLocked as Kn, getOrphanMediaPartNames as Ko, LightRigDirection as Kp, isSlideHidden as Kr, setTableCellParagraphs as Ks, getSlideLayoutBackgroundGradientFill as Kt, setShapeGradientFill as Ku, findSlidesByHyperlink as L, setParagraphAlignment as La, ChartDataLabelPosition as Lc, findShapeByName as Ld, isShapeHidden as Lf, setSlideLayoutTitleIncluded as Li, getParagraphPropertiesEffective as Ll, Emu as Lm, ShapeStyleReference as Ln, setShapeImageCrop as Lo, CustomGeometry as Lp, getSlideLayoutCount as Lr, mergeTableCells as Ls, getSlideBackgroundGradientFill as Lt, clearShapeFill as Lu, SlideNotesTextFormatOptions as M, getShapeRunCount as Ma, ScatterChartSpec as Mc, getShapeStrokeJoin as Md, getSlideMasterCount as Mf, isSlideMasterPreserved as Mi, setCommentStatus as Ml, PresetShape as Mm, setShapeMediaPlayback as Mn, hasShapeText as Mo, BuiltinTableStyle as Mp, getShapeAt as Mr, getTableStyleId as Ms, SlideLayoutBackgroundShape as Mt, setShapeGlow as Mu, appendSlideNotes as N, getShapeRunHyperlink as Na, StockChartSpec as Nc, getShapeStrokeOpacity as Nd, getSlideMasterPartName as Nf, removeSlideLayout as Ni, setCommentText as Nl, PlaceholderType as Nm, groupShapes as Nn, isShapeImageGrayscale as No, BuiltinTableStyleName as Np, getSlideAt as Nr, insertTableColumn as Ns, applySlideBackgroundToAll as Nt, setShapeInnerShadow as Nu, PresentationHyperlinkEntry as O, getShapeHyperlinkTooltip as Oa, PieChartSpec as Oc, getShapeStrokeColorResolved as Od, getShapePreset as Of, addSlideMaster as Oi, getPresentationCommenters as Ol, HexColor as Om, addSlideMedia as On, getShapeImageLinkUrl as Oo, HandoutMasterPlaceholderType as Op, getPresentationShapeCountsBySlide as Or, getTableDimensions as Os, SlideMasterBackgroundStyle as Ot, getShapeEffect as Ou, clearAllHyperlinks as P, getShapeRunHyperlinkTooltip as Pa, SurfaceChartSpec as Pc, getShapeStrokeWidth as Pd, getSlideMasterPartNames as Pf, removeSlideMaster as Pi, ParagraphBulletDetail as Pl, AudioFormat as Pm, ungroupShapes as Pn, resetShapeImageColorEffects as Po, BUILTIN_TABLE_STYLES as Pp, getSlideCount as Pr, insertTableRow as Ps, clearSlideBackground as Pt, setShapeReflection as Pu, getPresentationNotesText as Q, clearSlideAnimations as Qa, ChartTrendline as Qc, getShapesBounds as Qd, createPresentation as Qf, getUnusedSlideLayouts as Qi, getShapeTextAutoFit as Ql, resetSlidePlaceholderGeometry as Qn, setMediaPartBytes as Qo, Text3D as Qp, replaceTokensInPresentation as Qr, setTableStyleFlags as Qs, getSlideMasterBackgroundGradientFill as Qt, setShapePreset as Qu, findSlidesWithChartKind as R, setParagraphBullet as Ra, ChartDataLabels as Rc, findShapeByText as Rd, isShapePlaceholder as Rf, setSlideMasterName as Ri, getShapeHyperlink as Rl, cm as Rm, setShapeStyle as Rn, setShapeImageOpacity as Ro, GeomCommand as Rp, getSlideOutline as Rr, removeTableColumn as Rs, getSlideBackgroundImageBytes as Rt, clearShapeStroke as Ru, SlideSize as S, getParagraphBulletStyle as Sa, ComboChartSeries as Sc, getShapeFillColorResolved as Sd, getShapeId as Sf, setHandoutMasterPlaceholderIncluded as Si, getCommentSlide as Sl, ReadGradientStop as Sm, MediaFade as Sn, getShapeImageBytes as So, AnimationSpinDirection as Sp, findSlideByText as Sr, getTableCellSpan as Ss, getSlideTransition as St, Shape3D as Su, setSlideSize as T, getParagraphLevel as Ta, LineArea3DChartSpec as Tc, getShapeStroke as Td, getShapePlaceholderIdx as Tf, setNotesPageOrientation as Ti, getCommentsSortedByDate as Tl, ReflectionOptions as Tm, ShapeMedia as Tn, getShapeImageDuotone as To, TransitionEffect as Tp, findSlidesByText as Tr, getTableCellTextDirection as Ts, setSlideTransitionSound as Tt, clearShapeEffects as Tu, getAllImages as U, setParagraphTabs as Ua, ChartGrouping as Uc, findShapesByPreset as Ud, setShapeBounds as Uf, findSlideLayoutByPartName as Ui, resolveDrawingColor as Ul, CustomGeometryPathInput as Un, _internalPackageOf as Uo, BevelPreset as Up, getSlides as Ur, setTableCellClickAction as Us, getSlideBackgroundPatternFill as Ut, setShapeAdjustValues as Uu, getAllComments as V, setParagraphLineSpacing as Va, ChartErrorBarAmount as Vc, findShapesByKind as Vd, renameShape as Vf, findLayoutsWithPlaceholderType as Vi, setShapeRunFormat as Vl, mm as Vm, setShapeTextLanguage as Vn, PackagePartInfo as Vo, PathFillMode as Vp, getSlideTextLength as Vr, setTableCellAnchor as Vs, getSlideBackgroundImageIntrinsicSize as Vt, getShapeStrokeDash as Vu, getAllNotes as W, setParagraphTypography as Wa, ChartKind as Wc, findShapesByText as Wd, setShapeDescription as Wf, findSlideLayoutByType as Wi, resolveDrawingColorOpacity as Wl, setShapeCustomGeometry as Wn, compactPackage as Wo, CameraPreset as Wp, getSlidesByLayout as Wr, setTableCellFill as Ws, getSlideColorMapOverride as Wt, setShapeFill as Wu, getPresentationNotesLength as X, setSlidePlaceholders as Xa, ChartTextStyle as Xc, getShapeSlide as Xd, PresentationInput as Xf, getSlideLayoutUsageCountsByType as Xi, getShapeText3D as Xl, addSlidePlaceholder as Xn, listPackageParts as Xo, Rotation3D as Xp, replaceTextInSlide as Xr, setTableColumnWidth as Xs, getSlideLayoutShapes as Xt, setShapePatternFill as Xu, getPresentationHyperlinkCountsBySlide as Y, setSlideBody as Ya, ChartSeriesAxis as Yc, getShapeIndex as Yd, setSlideSections as Yf, getSlideLayoutUsageCounts as Yi, getShapeBodyPrEffective as Yl, addMissingSlidePlaceholders as Yn, getSlideMediaPartNames as Yo, ReadText3D as Yp, replaceTextInPresentation as Yr, setTableCellTextFormat as Ys, getSlideLayoutBackgroundShapes as Yt, setShapeNoStroke as Yu, getPresentationNotesLengthsBySlide as Z, setSlideTitle as Za, ChartTimeUnit as Zc, getShapeXmlString as Zd, PresentationSize as Zf, getSlideLayouts as Zi, getShapeTextAnchor as Zl, resetSlideLayout as Zn, readPackagePart as Zo, Scene3D as Zp, replaceTextInSlideNotes as Zr, setTableRowHeight as Zs, getSlideMasterBackground as Zt, setShapePosition as Zu, setSlideOutlineCollapsed as _, setShapeZIndex as _a, BubbleChartSeries as _c, setPresentationTheme as _d, getShapeBoundsResolved as _f, HandoutSlidesPerPage as _i, getCommentAuthors as _l, GradientFillOptions as _m, getShapeImageCompressionState as _n, findSlidesByLayoutType as _o, AnimationShape as _p, setCustomShows as _r, getTableCellFill as _s, setSlideNotesFormat as _t, setShapeTextFlat as _u, getShapeImageFillLayout as a, addSlideLine as aa, findChartsWithDataLabels as ac, setShapeStrokeCompound as ad, ShapeBounds as af, removeThumbnail as ai, ImageFit as al, ReadTextFormat as am, setSlideBackgroundImageFillLayout as an, AnimationTarget as ao, SlideShapeData as ap, addTitleSlide as ar, TableCellBorder as as, getSlidesWithComments as at, getShapeTextWrap as au, SLIDE_SIZE_16_9 as b, getParagraphBullet as ba, ChartSpec as bc, getShapeFill as bd, getShapeDescription as bf, getNotesMasterPlaceholders as bi, getCommentParent as bl, PatternPreset as bm, setShapePictureStyle as bn, getShapeImageBiLevelThreshold as bo, AnimationColor as bp, SlideOutlineEntry as br, getTableCellPosition as bs, TransitionSoundInput as bt, setShapeTextWrap as bu, DrawingGuide as c, addSlideTextBox as ca, getPresentationChartKindCounts as cc, setShapeStrokeSketch as cd, findShapesInRect as cf, ExtendedProperties as ci, clearAllSlideComments as cl, TextOutline as cm, ImageFillLayout as cn, ImageArtisticEffect as co, CommentStatus as cp, importSlide as cr, clearTableCellFill as cs, getSlidesWithNotes as ct, setShapeParagraphs as cu, getDrawingGuidesVisible as d, clearSlideShapes as da, getShapeChartSeriesNames as dc, PresentationFonts as dd, getMaxShapeId as df, getPresentationCreated as di, findCommentsAfter as dl, LineDash as dm, AnimationPatch as dn, ImageRecolorColor as do, SlideComment as dp, removeSlide as dr, getTableBackgroundEffective as ds, getVisibleSlides as dt, setShapeTextAnchor as du, clearSlideLayoutBackground as ea, splitTableCell as ec, setShapeSize as ed, getSlideShapes as ef, setSlideBackgroundGraphicsHidden as ei, ChartView3D as el, ParagraphAlignment as em, getSlideMasterBackgroundPatternFill as en, getShapeAnimation as eo, savePresentation as ep, addBlankSlide as er, validatePresentation as es, getSlideNotesLength as et, getShapeTextBodyRotationDeg as eu, getGridSpacing as f, copyShape as fa, getShapeChartSeriesValues as fc, PresentationFontsInput as fd, getMaxShapeIdInPresentation as ff, getPresentationModified as fi, findCommentsBefore as fl, LineEndSize as fm, moveSlideAnimation as fn, findFlippedShapes as fo, AnimationDirection as fp, reverseSlides as fr, getTableCell as fs, hasSlideNotes as ft, setShapeTextAutoFit as fu, setGridSpacing as g, sendShapeToBack as ga, Bar3DChartSpec as gc, setPresentationFonts as gd, getShapeBounds as gf, touchModified as gi, getCommentAuthor as gl, ReadLineFill as gm, ImageCompressionState as gn, findSlidesByLayoutPartName as go, AnimationOrientation as gp, getCustomShows as gr, getTableCellBorders as gs, setSlideNotes as gt, setShapeTextField as gu, setDrawingGuidesVisible as h, sendShapeBackward as ha, setChartSpec as hc, getPresentationTheme as hd, getShapeAltTitle as hf, setExtendedProperties as hi, findSlidesWithCommentsByAuthor as hl, LineSketch as hm, resetShapeVideoFormatting as hn, findSlidesByLayoutName as ho, AnimationOptions as hp, CustomShow as hr, getTableCellAppearanceEffective as hs, resolveSlideNotesTextColor as ht, setShapeTextDirection as hu, setSlideShowProperties as i, addSlideImage as ia, findChartsBySeriesName as ic, setShapeStrokeCap as id, translateShapes as if, getThumbnail as ii, setShapeClickAction as il, ReadTextFill as im, setSlideBackgroundImage as in, AnimationStart as io, SlideLayoutData as ip, addSlideAt as ir, TableCellAppearanceEffective as is, getSlidesWithCharts as it, getShapeTextMargins as iu, PresentationTableEntry as j, getShapeRunClickAction as ja, ScatterChartSeries as jc, getShapeStrokeGradient as jd, getShapeText as jf, getSlideMasterPlaceholders as ji, removeSlideComment as jl, ColorTransform as jm, getShapeMediaPlayback as jn, hasShapeImage as jo, NotesMasterPlaceholderType as jp, getPresentationTextLengthsBySlide as jr, getTableStyleFlags as js, SlideBackground as jt, setShape3D as ju, PresentationImageEntry as k, getShapeParagraphCount as ka, PlainChartSeries as kc, getShapeStrokeCompound as kd, getShapeRotation as kf, getSlideMasterLayouts as ki, getSlideCommentAuthors as kl, SchemeColorToken as km, findShapesWithMedia as kn, getShapeImageOpacity as ko, LayoutPlaceholderKind as kp, getPresentationText as kr, getTableRowHeights as ks, getSlideMasterBackgroundStyles as kt, getShapeEffects as ku, getCollapsedOutlineSlides as l, bringShapeForward as la, getShapeChartCategories as lc, getShapeGradientFill as ld, getGroupChildren as lf, getCoreProperties as li, clearSlideComments as ll, toWritableTextFormat as lm, ImageTileAlignment as ln, ImageCrop as lo, CommentAuthor as lp, mergePresentations as lr, getPresentationTableCountsBySlide as ls, getSlidesWithOverlap as lt, setShapeText as lu, setDrawingGuides as m, removeShape as ma, getSlideCharts as mc, getPresentationFonts as md, getShapeAdjustValues as mf, setCoreProperties as mi, findCommentsByText as ml, LineFill as mm, updateSlideAnimation as mn, findShapesOutsideCanvas as mo, AnimationInOut as mp, swapSlides as mr, getTableCellAnchor as ms, replaceHyperlink as mt, setShapeTextColumns as mu, SlideShowProperties as n, setSlideLayoutName as na, addSlideChart as nc, setShapeStroke as nd, replaceTokensInSlide as nf, slideHasAnimations as ni, ShapeClickAction as nl, ParagraphSpec as nm, setSlideBackground as nn, setShapeAnimation as no, SlideCommentData as np, addSectionHeaderSlide as nr, ValidationIssue as ns, getSlideNotesParagraphEndFormat as nt, getShapeTextDirection as nu, getShapeImageIntrinsicSize as o, addSlideShape as oa, findChartsWithTrendlines as oc, setShapeStrokeDash as od, centerShapeOnSlide as of, setThumbnail as oi, setShapeImage as ol, TextFill as om, setSlideBackgroundImageOpacity as on, AnimationValueAfterEnd as oo, TableCellData as op, duplicateSlide as or, TableCellBorders as os, getSlidesWithHyperlinks as ot, setShapeAlignment as ou, getSnapToGrid as p, getShapeZIndex as pa, getShapeChartSpec as pc, PresentationTheme as pd, getPresetGeometry as pf, incrementRevision as pi, findCommentsByAuthor as pl, LineEndType as pm, removeSlideAnimation as pn, findOverlappingShapePairs as po, AnimationEffect as pp, sortSlides as pr, getTableCellAlignment as ps, removeSlideNotes as pt, setShapeTextBodyRotationDeg as pu, getEmptySlides as q, getSlideBody as qa, ChartSecondaryValueAxis as qc, findSlidePlaceholderByIdx as qd, SlideSection as qf, getSlideLayoutPlaceholders as qi, TextWrap as ql, setShapeAspectRatioLocked as qn, getPackageSize as qo, LightRigType as qp, isSlideLayoutBackgroundGraphicsHidden as qr, setTableCellText as qs, getSlideLayoutBackgroundImageBytes as qt, setShapeImageFill as qu, getSlideShowProperties as r, setSlideLayoutPlaceholderBounds as ra, findChartByKind as rc, setShapeStrokeArrow as rd, setSlideLayout as rf, PresentationThumbnail as ri, getShapeClickAction as rl, RunSpec as rm, setSlideBackgroundGradientFill as rn, AnimationSequenceKind as ro, SlideData as rp, addSlide as rr, TableBackgroundEffective as rs, getSlideNotesTextFormats as rt, getShapeTextFlat as ru, setShapeImageFillLayout as s, addSlideTable as sa, getPresentationChartCountsBySlide as sc, setShapeStrokeJoin as sd, findShapesAtPoint as sf, CoreProperties as si, addSlideComment as sl, TextFormat as sm, setSlideBackgroundPatternFill as sn, SlideAnimationStep as so, COMMENT_STATUSES as sp, duplicateSlideAt as sr, TableCellParagraph as ss, getSlidesWithImages as st, setShapeBulletStyle as su, VERSION as t, setSlideLayoutBackground as ta, SlideChartData as tc, setShapeSlideBackgroundFill as td, getSlidesWithEmptyPlaceholders as tf, setSlideHidden as ti, ReadChartSpec as tl, ParagraphAlignmentToken as tm, getSlideMasterShapes as tn, getSlideAnimations as to, PresentationData as tp, addContentSlide as tr, IssueSeverity as ts, getSlideNotesLineBreaks as tt, getShapeTextColumns as tu, getDrawingGuides as u, bringShapeToFront as ua, getShapeChartKind as uc, getShapeGradientFillEffective as ud, getGroupTransform as uf, getExtendedProperties as ui, findCommentAuthorByName as ul, ArrowOptions as um, ImageTileFlip as un, ImageRecolor as uo, CommentPosition as up, moveSlide as ur, getSlideTables as us, getSlidesWithTables as ut, setShapeText3D as uu, setSnapToGrid as v, ShapeParagraphElement as va, BubbleChartSpec as vc, ShapeFill as vd, getShapeCenter as vf, getHandoutMasterPlaceholders as vi, getCommentDate as vl, GradientStop as vm, getShapePictureStyle as vn, getPresentationImageCountsBySlide as vo, AnimationStartCondition as vp, AllShapesEntry as vr, getTableCellMargins as vs, transformSlideNotesCase as vt, setShapeTextFormat as vu, getSlideSize as w, getParagraphIndent as wa, DoughnutChartSpec as wc, getShapeFillOpacity as wd, getShapeName as wf, setNotesMasterPlaceholderIncluded as wi, getCommentText as wl, InnerShadowOptions as wm, MediaTrim as wn, getShapeImageCrop as wo, SlideTransition as wp, findSlidesByNotes as wr, getTableCellText3D as ws, setSlideTransition as wt, ShapeEffectAny as wu, SLIDE_SIZE_4_3 as x, getParagraphBulletImageBytes as xa, ChartVariant as xc, getShapeFillColor as xd, getShapeFlip as xf, getNotesPageSize as xi, getCommentPosition as xl, ReadGradientFill as xm, MediaBookmark as xn, getShapeImageBrightness as xo, AnimationScaleDirection as xp, findSlideByPartName as xr, getTableCellRunFormatEffective as xs, clearSlideTransition as xt, TextCase as xu, SLIDE_SIZE_16_10 as y, getParagraphAlignment as ya, CandlestickChartSpec as yc, ShapeStroke as yd, getShapeCustomGeometry as yf, getHandoutSlidesPerPage as yi, getCommentFormat as yl, PatternFillOptions as ym, setShapeImageCompressionState as yn, getShapeImageArtisticEffect as yo, AnimationTextBuild as yp, SlideInfo as yr, getTableCellParagraphs as ys, TransitionSound as yt, setShapeTextMargins as yu, findSlidesWithChartTrendlines as z, setParagraphIndent as za, ChartDataTable as zc, findShapeInPresentation as zd, isShapeTextBox as zf, setSlideMasterPlaceholderIncluded as zi, getShapeRunFormatEffective as zl, emu as zm, getParagraphElementLanguages as zn, setShapeImageRecolor as zo, GeomPath as zp, getSlidePartName as zr, removeTableRow as zs, getSlideBackgroundImageCrop as zt, getShapePatternFill as zu };
+//# sourceMappingURL=index-WCK8v0WT.d.ts.map