pptx-vanilla-viewer 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import "fast-xml-parser";
 import "jszip";
 import "html2canvas-pro";
-//#region ../core/dist/presentation-BfnrtJV1.d.ts
+//#region ../core/dist/presentation-BAMjUmQZ.d.ts
 /**
  * Action types: hyperlinks, slide jumps, macros, and action buttons.
  *
@@ -596,6 +596,10 @@ interface Text3DStyle {
 interface Pptx3DScene {
   /** Camera preset type, e.g. "orthographicFront", "perspectiveFront". */
   cameraPreset?: string;
+  /** Camera field of view in 1/60000 degrees (`a:camera/@fov`). */
+  cameraFieldOfView?: number;
+  /** Camera zoom as an OOXML percentage fraction (`a:camera/@zoom`, 1 = 100%). */
+  cameraZoom?: number;
   /** Camera rotation around X axis in 1/60000 degrees. */
   cameraRotX?: number;
   /** Camera rotation around Y axis in 1/60000 degrees. */
@@ -606,6 +610,12 @@ interface Pptx3DScene {
   lightRigType?: string;
   /** Light rig direction, e.g. "t", "b", "l", "r", "tl". */
   lightRigDirection?: string;
+  /** Light-rig rotation latitude in 1/60000 degrees. */
+  lightRigRotX?: number;
+  /** Light-rig rotation longitude in 1/60000 degrees. */
+  lightRigRotY?: number;
+  /** Light-rig rotation revolution in 1/60000 degrees. */
+  lightRigRotZ?: number;
   /** Whether a 3D backdrop plane is present (`a:backdrop`). */
   hasBackdrop?: boolean;
   /** Backdrop plane anchor X in EMU. */
@@ -614,6 +624,18 @@ interface Pptx3DScene {
   backdropAnchorY?: number;
   /** Backdrop plane anchor Z in EMU. */
   backdropAnchorZ?: number;
+  /** Backdrop normal vector X component. */
+  backdropNormalX?: number;
+  /** Backdrop normal vector Y component. */
+  backdropNormalY?: number;
+  /** Backdrop normal vector Z component. */
+  backdropNormalZ?: number;
+  /** Backdrop up vector X component. */
+  backdropUpX?: number;
+  /** Backdrop up vector Y component. */
+  backdropUpY?: number;
+  /** Backdrop up vector Z component. */
+  backdropUpZ?: number;
 }
 /**
  * 3D shape extrusion/bevel from `a:sp3d`.
@@ -731,9 +753,13 @@ interface ShapeStyle {
    */
   fillColorXml?: XmlObject;
   fillGradient?: string;
+  /** Original `gradFill` XML retained for unknown-child and extension round-tripping. */
+  fillGradientXml?: XmlObject;
   fillMode?: 'solid' | 'gradient' | 'pattern' | 'none' | 'image' | 'theme' | 'group';
   fillPatternPreset?: string;
   fillPatternBackgroundColor?: string;
+  /** Original `pattFill` XML retained for unknown-child round-tripping. */
+  fillPatternXml?: XmlObject;
   /** Raw XML node for pattern fill foreground colour (preserves color transforms). */
   fillPatternFgClrXml?: XmlObject;
   /** Raw XML node for pattern fill background colour (preserves color transforms). */
@@ -799,6 +825,14 @@ interface ShapeStyle {
   /** Pen line alignment (`a:ln/@algn`): `ctr` (centre, default) or `in` (inside). */
   lineAlignment?: 'ctr' | 'in';
   shadowColor?: string;
+  /** Preserved source `a:effectLst`, including unknown effects and extensions. */
+  effectListXml?: XmlObject;
+  /** Original outer-shadow node used for lossless surgical updates. */
+  outerShadowXml?: XmlObject;
+  /** Resolved source shadow colour used to detect colour edits. */
+  outerShadowOriginalColor?: string;
+  /** Source shadow opacity used to detect alpha edits. */
+  outerShadowOriginalOpacity?: number;
   shadowBlur?: number;
   shadowOffsetX?: number;
   shadowOffsetY?: number;
@@ -842,11 +876,23 @@ interface ShapeStyle {
   /** Multiple shadow layers (for advanced effects). */
   shadows?: ShadowEffect[];
   glowColor?: string;
+  /** Original glow node used for lossless surgical updates. */
+  glowXml?: XmlObject;
+  /** Resolved source glow colour used to detect colour edits. */
+  glowOriginalColor?: string;
+  /** Source glow opacity used to detect alpha edits. */
+  glowOriginalOpacity?: number;
   glowRadius?: number;
   glowOpacity?: number;
   softEdgeRadius?: number;
   /** Inner shadow colour (`a:innerShdw`). */
   innerShadowColor?: string;
+  /** Original inner-shadow node used for lossless surgical updates. */
+  innerShadowXml?: XmlObject;
+  /** Resolved source inner-shadow colour used to detect colour edits. */
+  innerShadowOriginalColor?: string;
+  /** Source inner-shadow opacity used to detect alpha edits. */
+  innerShadowOriginalOpacity?: number;
   /** Inner shadow opacity (0-1). */
   innerShadowOpacity?: number;
   /** Inner shadow blur radius in px. */
@@ -855,8 +901,12 @@ interface ShapeStyle {
   innerShadowOffsetX?: number;
   /** Inner shadow vertical offset in px. */
   innerShadowOffsetY?: number;
+  /** Original soft-edge node, including vendor attributes and extensions. */
+  softEdgeXml?: XmlObject;
   /** Reflection effect — distance from shape bottom in px. */
   reflectionBlurRadius?: number;
+  /** Original reflection node, including vendor attributes and extensions. */
+  reflectionXml?: XmlObject;
   /** Reflection start opacity (0-1). */
   reflectionStartOpacity?: number;
   /** Reflection end opacity (0-1). */
@@ -1350,6 +1400,8 @@ interface TextStyle {
   text3d?: Text3DStyle;
   /** 3D scene (camera + light rig) settings on the text body (`a:bodyPr/a:scene3d`). */
   textBodyScene3d?: Pptx3DScene;
+  /** Raw `a:scene3d` subtree used to preserve extensions and unmodelled children. */
+  textBodyScene3dXml?: XmlObject;
   /**
    * Raw `<a:extLst>` subtree captured from `<a:bodyPr>`. Preserved verbatim so
    * authored extensions (e.g. content placeholders, custom application data)
@@ -1723,6 +1775,24 @@ interface PlaceholderTextLevelStyle {
   spaceBefore?: number;
   spaceAfter?: number;
 }
+/** Tick-mark placement from ChartML `ST_TickMark`. */
+type PptxChartTickMark = 'cross' | 'in' | 'none' | 'out';
+/** Typed axis tick and category/date label controls. */
+interface PptxChartAxisLabelFormatting {
+  /** Primary and secondary tick-mark placement. */
+  majorTickMark?: PptxChartTickMark;
+  minorTickMark?: PptxChartTickMark;
+  /** Tick-label position from ChartML `ST_TickLblPos`. */
+  tickLblPos?: 'high' | 'low' | 'nextTo' | 'none';
+  /** Automatic category/date axis behavior (`c:auto`). */
+  auto?: boolean;
+  /** Category-axis label alignment (`c:lblAlgn`). */
+  labelAlignment?: 'ctr' | 'l' | 'r';
+  /** Category/date label distance, from 0 through 1000 percent. */
+  labelOffset?: number;
+  /** Suppress multi-level category labels (`c:noMultiLvlLbl`). */
+  noMultiLevelLabels?: boolean;
+}
 /**
  * Chart types: chart categories, series data, style metadata, data tables,
  * trendlines, error bars, and the composite `PptxChartData`.
@@ -1765,6 +1835,7 @@ type PptxChartTrendlineType = 'linear' | 'exponential' | 'logarithmic' | 'polyno
  */
 interface PptxChartTrendline {
   trendlineType: PptxChartTrendlineType;
+  name?: string;
   order?: number;
   period?: number;
   forward?: number;
@@ -1773,6 +1844,13 @@ interface PptxChartTrendline {
   displayRSq?: boolean;
   displayEq?: boolean;
   color?: string;
+  label?: PptxChartTrendlineLabel | null;
+}
+/** Typed, commonly edited properties of `c:trendlineLbl`. */
+interface PptxChartTrendlineLabel {
+  layout?: PptxChartManualLayout;
+  numberFormatCode?: string;
+  sourceLinked?: boolean;
 }
 /** Error-bar direction axis. */
 type PptxChartErrBarDir = 'x' | 'y';
@@ -1809,6 +1887,8 @@ interface PptxChartErrBars {
   val?: number;
   customPlus?: number[];
   customMinus?: number[];
+  noEndCap?: boolean;
+  color?: string;
 }
 /**
  * Visibility flags for the chart data table (axes + legend keys).
@@ -1858,6 +1938,13 @@ interface PptxChartShapeProps {
   /** Line dash style (a:prstDash/@val), e.g. 'solid', 'dash', 'dot', 'lgDash'. */
   strokeDashStyle?: string;
 }
+/** Up/down bar formatting on line and stock charts (`c:upDownBars`). */
+interface PptxChartUpDownBars {
+  /** Gap between bars as a percentage, constrained to 0 through 500. */
+  gapWidth?: number;
+  upBars?: PptxChartShapeProps;
+  downBars?: PptxChartShapeProps;
+}
 /** Marker appearance on a chart series or data point. */
 interface PptxChartMarker {
   symbol: PptxChartMarkerSymbol;
@@ -1872,25 +1959,40 @@ interface PptxChartDataPoint {
   invertIfNegative?: boolean;
   marker?: PptxChartMarker;
 }
+/** Schema values accepted by `c:dLblPos`. */
+type PptxChartDataLabelPosition = 'bestFit' | 'b' | 'ctr' | 'inBase' | 'inEnd' | 'l' | 'outEnd' | 'r' | 't';
 /** Individual data label override (c:dLbl). */
 interface PptxChartDataLabel {
   idx: number;
+  /** Suppress this data point's automatically generated label. */
+  deleted?: boolean;
   showVal?: boolean;
   showCatName?: boolean;
   showSerName?: boolean;
   showPercent?: boolean;
   showLegendKey?: boolean;
   showBubbleSize?: boolean;
-  position?: string;
+  position?: PptxChartDataLabelPosition;
   text?: string;
+  separator?: string;
+  showLeaderLines?: boolean;
 }
 /** Axis number format. */
 interface PptxChartAxisNumFmt {
   formatCode: string;
   sourceLinked?: boolean;
 }
+/** Typed contents of a value-axis display-unit label (`c:dispUnitsLbl`). */
+interface PptxChartDisplayUnitsLabel {
+  /** Literal label text. Omit to preserve the source text subtree. */
+  text?: string;
+  /** Manual label placement. `null` removes only the manual layout. */
+  layout?: PptxChartManualLayout | null;
+  /** Label shape formatting. `null` removes `c:spPr`. */
+  spPr?: PptxChartShapeProps | null;
+}
 /** Axis formatting for category, value, or date axes. */
-interface PptxChartAxisFormatting {
+interface PptxChartAxisFormatting extends PptxChartAxisLabelFormatting {
   axisType: 'catAx' | 'valAx' | 'dateAx' | 'serAx';
   /** Axis position: "b" (bottom), "l" (left), "r" (right), "t" (top). */
   axPos?: 'b' | 'l' | 'r' | 't';
@@ -1924,8 +2026,12 @@ interface PptxChartAxisFormatting {
   displayUnits?: 'hundreds' | 'thousands' | 'tenThousands' | 'hundredThousands' | 'millions' | 'tenMillions' | 'hundredMillions' | 'billions' | 'trillions' | 'custom';
   /** Custom display unit divisor value (c:dispUnits/c:custUnit/@val). Only used when displayUnits is 'custom'. */
   displayUnitsValue?: number;
-  /** Display units label text (c:dispUnits/c:dispUnitsLbl). Overrides the built-in default label when present. */
-  displayUnitsLabel?: string;
+  /**
+   * Display-unit label contents (`c:dispUnits/c:dispUnitsLbl`). A string is
+   * retained as a compatibility shorthand for `{ text: string }`; `null`
+   * explicitly removes the label.
+   */
+  displayUnitsLabel?: string | PptxChartDisplayUnitsLabel | null;
   /** Whether logarithmic scaling is enabled (presence of c:scaling/c:logBase). */
   logScale?: boolean;
   /** Logarithmic base value (c:scaling/c:logBase/@val), typically 10 or e. */
@@ -1934,8 +2040,6 @@ interface PptxChartAxisFormatting {
   majorUnit?: number;
   /** Minor-unit interval between secondary tick marks (c:minorUnit/@val). */
   minorUnit?: number;
-  /** Tick-label position (c:tickLblPos/@val): 'high', 'low', 'nextTo', or 'none'. */
-  tickLblPos?: 'high' | 'low' | 'nextTo' | 'none';
 }
 /** 3D wall or floor element formatting. */
 interface PptxChart3DSurface {
@@ -1994,12 +2098,32 @@ interface PptxChartDataLabelOptions {
   showPercent?: boolean;
   /** Show the legend key swatch (`c:showLegendKey`). */
   showLegendKey?: boolean;
+  /** Show bubble size (`c:showBubbleSize`). */
+  showBubbleSize?: boolean;
+  /** Text placed between combined label components (`c:separator`). */
+  separator?: string;
+  /** Show leader lines where supported (`c:showLeaderLines`). */
+  showLeaderLines?: boolean;
   /**
    * Label position (`c:dLblPos`). Valid values depend on the chart type
    * (`ctr`, `inEnd`, `inBase`, `outEnd`, `bestFit`, `l`, `r`, `t`, `b`).
    * Omit to let PowerPoint use the type default.
    */
-  position?: 'ctr' | 'inEnd' | 'inBase' | 'outEnd' | 'bestFit' | 'l' | 'r' | 't' | 'b';
+  position?: PptxChartDataLabelPosition;
+}
+/** Typed text defaults for a single chart legend entry. */
+interface PptxChartLegendTextStyle {
+  fontFamily?: string;
+  fontSize?: number;
+  bold?: boolean;
+  italic?: boolean;
+  color?: string;
+}
+/** Per-series legend entry override (`c:legendEntry`). */
+interface PptxChartLegendEntry {
+  index: number;
+  deleted?: boolean;
+  textStyle?: PptxChartLegendTextStyle;
 }
 /**
  * Style / formatting metadata for a chart.
@@ -2022,6 +2146,8 @@ interface PptxChartStyle {
   hasLegend?: boolean;
   /** Legend position (t, b, l, r, tr). */
   legendPosition?: string;
+  /** Per-series visibility and text-style overrides. */
+  legendEntries?: PptxChartLegendEntry[];
   /** Whether the chart has a title. */
   hasTitle?: boolean;
   /** Whether gridlines are visible. */
@@ -2082,6 +2208,14 @@ interface PptxChartOfPieOptions {
   serLines?: boolean;
   gapWidth?: number;
 }
+/** Classic `c:bubbleChart` options from CT_BubbleChart. */
+interface PptxBubbleChartOptions {
+  bubble3D?: boolean;
+  /** Bubble diameter scale in percent, constrained to 0 through 300. */
+  bubbleScale?: number;
+  showNegativeBubbles?: boolean;
+  sizeRepresents?: 'area' | 'w';
+}
 /**
  * 3D viewing parameters for a chart (`c:view3D`, ECMA-376 §21.2.2.228 /
  * CT_View3D).
@@ -2122,6 +2256,27 @@ interface PptxChartChrome {
   dispBlanksAs?: 'gap' | 'zero' | 'span';
   showDLblsOverMax?: boolean;
 }
+/** Manual chart placement from `c:layout/c:manualLayout` (CT_ManualLayout). */
+interface PptxChartManualLayout {
+  layoutTarget?: 'inner' | 'outer';
+  xMode?: 'edge' | 'factor';
+  yMode?: 'edge' | 'factor';
+  widthMode?: 'edge' | 'factor';
+  heightMode?: 'edge' | 'factor';
+  x?: number;
+  y?: number;
+  width?: number;
+  height?: number;
+}
+/**
+ * Typed manual layouts for chart regions that accept `c:layout`.
+ * A `null` region removes its manual layout without removing extensions.
+ */
+interface PptxChartLayouts {
+  title?: PptxChartManualLayout | null;
+  plotArea?: PptxChartManualLayout | null;
+  legend?: PptxChartManualLayout | null;
+}
 /** Parsed data extracted from an embedded xlsx workbook. */
 interface PptxEmbeddedWorkbookData {
   /** Category labels from the first column/row. */
@@ -2163,9 +2318,12 @@ interface PptxChartData {
   chartPartPath?: string;
   /** Internal: relationship ID linking the graphic frame to the chart part. */
   chartRelationshipId?: string;
-  dataTable?: PptxChartDataTable;
+  /** `null` explicitly removes an existing ChartML data table. */
+  dataTable?: PptxChartDataTable | null;
   dropLines?: PptxChartLineStyle;
   hiLowLines?: PptxChartLineStyle;
+  /** `null` explicitly removes an existing up/down-bars container. */
+  upDownBars?: PptxChartUpDownBars | null;
   axes?: PptxChartAxisFormatting[];
   floor?: PptxChart3DSurface;
   sideWall?: PptxChart3DSurface;
@@ -2223,6 +2381,8 @@ interface PptxChartData {
    * `ofPieChart` element can be re-emitted on save with full fidelity.
    */
   ofPieOptions?: PptxChartOfPieOptions;
+  /** Classic bubble-chart display options (`c:bubbleChart`). */
+  bubbleOptions?: PptxBubbleChartOptions;
   /**
    * 3D viewing parameters (`c:view3D`, CT_View3D).
    *
@@ -2238,6 +2398,8 @@ interface PptxChartData {
    * source data, so absence does not produce empty `<c:…/>` placeholders.
    */
   chartChrome?: PptxChartChrome;
+  /** Editable manual placement for the title, plot area, and legend. */
+  layouts?: PptxChartLayouts;
   /**
    * Raw `c:userShapes` XML subtree (a drawing tree) preserved verbatim.
    *
@@ -2262,105 +2424,52 @@ interface PptxChartData {
    */
   clrMapOvr?: Record<string, string>;
 }
-/**
- * Image types: effects, crop shapes, and properties shared by image/picture
- * elements.
- *
- * @module pptx-types/image
- */
-/**
- * Blend mode for `a:blend` container nodes inside an `a:effectDag` (CT_BlendEffect).
- *
- * Per ECMA-376 §20.1.8.10, valid values are: `darken`, `lighten`, `mult`,
- * `over`, `screen`.
- */
 type EffectDagBlendMode = 'darken' | 'lighten' | 'mult' | 'over' | 'screen';
-/**
- * Container node kind inside an `a:effectDag` (CT_EffectContainer @type).
- *
- * Per ECMA-376 §20.1.8.20, `sib` (sibling) draws each child independently
- * over the same source; `tree` (tree) chains effects so each sees the output
- * of its siblings.
- */
 type EffectDagContainerType = 'sib' | 'tree';
-/**
- * Typed model of the directed-acyclic effect graph stored in `a:effectDag`.
- *
- * The four "structural" container/transform nodes are typed; any other inner
- * effect (e.g. `a:outerShdw`, `a:glow`, `a:alphaInv`) is preserved verbatim
- * as a raw XML object via the {@link EffectDagRawLeaf} variant so we never
- * have to recurse into the full effect taxonomy.
- *
- * @example
- * ```ts
- * // <a:effectDag>
- * //   <a:cont type="sib">
- * //     <a:blend blend="mult"><a:cont type="tree" /></a:blend>
- * //   </a:cont>
- * // </a:effectDag>
- * const dag: EffectDagContainer = {
- *   kind: "cont",
- *   type: "sib",
- *   children: [{
- *     kind: "blend",
- *     mode: "mult",
- *     container: { kind: "cont", type: "tree", children: [] },
- *   }],
- * };
- * ```
- */
-type EffectDagNode = EffectDagContainer | EffectDagBlend | EffectDagXfrm | EffectDagRelOff | EffectDagRawLeaf;
-/** `a:cont` — CT_EffectContainer. Recursive; mirrors the top-level `effectDag`. */
+type EffectDagNode = EffectDagContainer | EffectDagBlend | EffectDagXfrm | EffectDagRelOff | EffectDagBlur | EffectDagPresetShadow | EffectDagRawLeaf;
 interface EffectDagContainer {
   kind: 'cont';
-  /** `@type` — `sib` or `tree`. */
   type: EffectDagContainerType;
-  /** Optional `@name` attribute. */
   name?: string;
-  /** Ordered children. */
   children: EffectDagNode[];
 }
-/** `a:blend` — CT_BlendEffect. Always wraps a single `a:cont` child. */
 interface EffectDagBlend {
   kind: 'blend';
-  /** `@blend` attribute. */
   mode: EffectDagBlendMode;
-  /** Required child `a:cont` container. */
   container: EffectDagContainer;
 }
-/** `a:xfrmEffect` — CT_TransformEffect. Affine transform with no children. */
 interface EffectDagXfrm {
   kind: 'xfrmEffect';
-  /** Horizontal scale, percentage * 1000 (e.g. 100000 = 100%). */
   sx?: number;
-  /** Vertical scale, percentage * 1000. */
   sy?: number;
-  /** Horizontal skew, degrees * 60000. */
   kx?: number;
-  /** Vertical skew, degrees * 60000. */
   ky?: number;
-  /** Horizontal translation in EMU. */
   tx?: number;
-  /** Vertical translation in EMU. */
   ty?: number;
 }
-/** `a:relOff` — CT_RelativeOffsetEffect. Relative offset in 1000ths of a percent. */
 interface EffectDagRelOff {
   kind: 'relOff';
-  /** Horizontal offset, percentage * 1000. */
   tx?: number;
-  /** Vertical offset, percentage * 1000. */
   ty?: number;
 }
-/**
- * Catch-all leaf preserving any non-container effect (e.g. `a:outerShdw`,
- * `a:glow`, `a:alphaInv`) as raw XML. Re-emitted verbatim on save.
- */
+/** Typed CT_BlurEffect with its original payload retained for lossless edits. */
+interface EffectDagBlur {
+  kind: 'blur';
+  radiusEmu?: number;
+  grow?: boolean;
+  xml: XmlObject;
+}
+/** Typed CT_PresetShadowEffect with colour and extension XML retained verbatim. */
+interface EffectDagPresetShadow {
+  kind: 'prstShdw';
+  preset?: `shdw${number}`;
+  distanceEmu?: number;
+  direction?: number;
+  xml: XmlObject;
+}
 interface EffectDagRawLeaf {
   kind: 'raw';
-  /** Local element name without the `a:` prefix (e.g. `outerShdw`, `glow`). */
   tag: string;
-  /** Raw XML object captured at load — preserved verbatim on save. */
   xml: Record<string, unknown>;
 }
 /**
@@ -2588,6 +2697,11 @@ declare module './shape-style' {
  * ```
  */
 type PptxMediaType = 'video' | 'audio' | 'unknown';
+type PptxMediaReferenceKind = 'audioCd' | 'wavAudioFile' | 'audioFile' | 'videoFile' | 'quickTimeFile';
+interface PptxAudioCdPosition {
+  track: number;
+  time?: number;
+}
 /**
  * A named bookmark within a media clip timeline.
  *
@@ -2663,6 +2777,33 @@ interface MediaCaptionTrack {
   /** Whether this track is the default/active one. */
   isDefault?: boolean;
 }
+/** Typed, editable metadata from a DiagramML layout-definition part. */
+interface PptxSmartArtLocalizedText {
+  value: string;
+  language?: string;
+}
+interface PptxSmartArtLayoutCategory {
+  type: string;
+  priority: number;
+}
+/** Identity and ordering metadata from DiagramML CT_LayoutNode. */
+interface PptxSmartArtLayoutNode {
+  name?: string;
+  styleLabel?: string;
+  childOrder?: 'b' | 't';
+  moveWith?: string;
+  children?: PptxSmartArtLayoutNode[];
+}
+/** Metadata and root node from DiagramML CT_DiagramDefinition. */
+interface PptxSmartArtLayoutDefinition {
+  uniqueId?: string;
+  minimumVersion?: string;
+  defaultStyle?: string;
+  titles?: PptxSmartArtLocalizedText[];
+  descriptions?: PptxSmartArtLocalizedText[];
+  categories?: PptxSmartArtLayoutCategory[];
+  rootNode: PptxSmartArtLayoutNode;
+}
 /**
  * SmartArt node types: per-run text, per-node visual override, and the
  * data-model node itself. Split out of `smart-art.ts` to keep each type file
@@ -2750,6 +2891,8 @@ interface PptxSmartArtNodeStyle {
 interface PptxSmartArtNode {
   id: string;
   text: string;
+  /** CT_Pt connection identifier, when the point references a connection. */
+  connectionId?: string | null;
   parentId?: string;
   children?: PptxSmartArtNode[];
   /** Node type from `@_type` attribute (e.g. "doc", "node", "asst", "pres"). */
@@ -2770,6 +2913,63 @@ interface PptxSmartArtNode {
    */
   style?: PptxSmartArtNodeStyle;
 }
+/** Editable metadata shared by DiagramML quick-style and color definitions. */
+interface PptxSmartArtDefinitionText {
+  value: string;
+  language?: string;
+}
+interface PptxSmartArtDefinitionCategory {
+  type: string;
+  priority: number;
+}
+type PptxSmartArtColorApplicationMethod = 'span' | 'cycle' | 'repeat';
+type PptxSmartArtHueDirection = 'cw' | 'ccw';
+/** CT_Colors application metadata. Color-choice children remain preserved XML. */
+interface PptxSmartArtColorListMetadata {
+  method?: PptxSmartArtColorApplicationMethod;
+  hueDirection?: PptxSmartArtHueDirection;
+}
+/** CT_StyleLabel metadata from a quick-style definition. */
+interface PptxSmartArtQuickStyleLabel {
+  name: string;
+}
+/** CT_CTStyleLabel metadata from a color-transform definition. */
+interface PptxSmartArtColorStyleLabel {
+  name: string;
+  fill?: PptxSmartArtColorListMetadata;
+  line?: PptxSmartArtColorListMetadata;
+  effect?: PptxSmartArtColorListMetadata;
+  textLine?: PptxSmartArtColorListMetadata;
+  textFill?: PptxSmartArtColorListMetadata;
+  textEffect?: PptxSmartArtColorListMetadata;
+}
+interface PptxSmartArtDefinitionMetadata {
+  uniqueId?: string;
+  minimumVersion?: string;
+  titles?: PptxSmartArtDefinitionText[];
+  descriptions?: PptxSmartArtDefinitionText[];
+  categories?: PptxSmartArtDefinitionCategory[];
+}
+/** Typed CT_ColorTransform metadata and the resolved legacy color palette. */
+interface PptxSmartArtColorTransform extends PptxSmartArtDefinitionMetadata {
+  /** Legacy resolved display name. */
+  name?: string;
+  /** Ordered resolved fill colors for rendering. */
+  fillColors: string[];
+  /** Ordered resolved line colors for rendering. */
+  lineColors: string[];
+  /** Ordered CT_CTStyleLabel metadata. */
+  labels?: PptxSmartArtColorStyleLabel[];
+}
+/** Typed CT_StyleDefinition metadata and legacy rendering hint. */
+interface PptxSmartArtQuickStyle extends PptxSmartArtDefinitionMetadata {
+  /** Legacy resolved display name. */
+  name?: string;
+  /** Legacy effect-intensity rendering hint. */
+  effectIntensity?: string;
+  /** Ordered CT_StyleLabel metadata. Complex style payload remains preserved XML. */
+  labels?: PptxSmartArtQuickStyleLabel[];
+}
 /**
  * SmartArt types: layout categories, layout presets, colour schemes,
  * data-model nodes/connections, drawing shapes, chrome, and the composite
@@ -2831,6 +3031,8 @@ type SmartArtStyle = 'flat' | 'moderate' | 'intense';
  * ```
  */
 interface PptxSmartArtConnection {
+  /** Stable CT_Cxn model identifier. Required when serialized. */
+  modelId?: string | null;
   /** Model ID of the source node. */
   sourceId: string;
   /** Model ID of the destination node. */
@@ -2841,6 +3043,12 @@ interface PptxSmartArtConnection {
   srcOrd?: number;
   /** Destination index for ordering. */
   destOrd?: number;
+  /** Model ID of the parent transition point associated with this edge. */
+  parentTransitionId?: string | null;
+  /** Model ID of the sibling transition point associated with this edge. */
+  siblingTransitionId?: string | null;
+  /** Layout presentation identifier used by presentation connections. */
+  presentationId?: string | null;
 }
 /**
  * A pre-computed shape from `ppt/diagrams/drawing*.xml`.
@@ -2907,45 +3115,6 @@ interface PptxSmartArtChrome {
   /** Outline stroke width in points. */
   outlineWidth?: number;
 }
-/**
- * Colour transform entry from `ppt/diagrams/colors*.xml`.
- *
- * @example
- * ```ts
- * const transform: PptxSmartArtColorTransform = {
- *   name: "Colorful - Accent Colors",
- *   fillColors: ["#4F81BD", "#C0504D", "#9BBB59"],
- *   lineColors: ["#385D8A", "#8C3836", "#71893F"],
- * };
- * // => satisfies PptxSmartArtColorTransform
- * ```
- */
-interface PptxSmartArtColorTransform {
-  /** Colour scheme name / title. */
-  name?: string;
-  /** Ordered list of fill colours (hex) for each node. */
-  fillColors: string[];
-  /** Ordered list of line colours (hex). */
-  lineColors: string[];
-}
-/**
- * Style entry from `ppt/diagrams/quickStyles*.xml`.
- *
- * @example
- * ```ts
- * const qs: PptxSmartArtQuickStyle = {
- *   name: "Moderate Effect",
- *   effectIntensity: "moderate",
- * };
- * // => satisfies PptxSmartArtQuickStyle
- * ```
- */
-interface PptxSmartArtQuickStyle {
-  /** Style name / title. */
-  name?: string;
-  /** Effect intensity identifier (e.g. "subtle", "moderate", "intense"). */
-  effectIntensity?: string;
-}
 /**
  * Complete parsed SmartArt data for a {@link SmartArtPptxElement}.
  *
@@ -2985,14 +3154,28 @@ interface PptxSmartArtData {
   colorTransform?: PptxSmartArtColorTransform;
   /** Quick style from `ppt/diagrams/quickStyles*.xml`. */
   quickStyle?: PptxSmartArtQuickStyle;
+  /** Editable metadata from the related DiagramML layout definition. */
+  layoutDefinition?: PptxSmartArtLayoutDefinition;
   /** Relationship ID for the diagram data part (for round-trip save). */
   dataRelId?: string;
+  /** Relationship ID for the diagram layout part. */
+  layoutRelId?: string;
   /** Relationship ID for the drawing part. */
   drawingRelId?: string;
   /** Relationship ID for the colours part. */
   colorsRelId?: string;
   /** Relationship ID for the quick-styles part. */
   styleRelId?: string;
+  /** Internal save hint: the layout definition changed in the editor. */
+  layoutDirty?: boolean;
+  /** Internal save hint: typed layout-definition metadata changed. */
+  layoutDefinitionDirty?: boolean;
+  /** Internal save hint: quick-style definition metadata changed. */
+  quickStyleDirty?: boolean;
+  /** Internal save hint: color-transform definition metadata changed. */
+  colorTransformDirty?: boolean;
+  /** Internal save hint: cached drawing geometry or text changed in the editor. */
+  drawingDirty?: boolean;
 }
 /**
  * Table types: cell styling, cell data, rows, table data, and the parsed
@@ -3599,6 +3782,11 @@ interface MediaPptxElement extends PptxElementBase {
   mediaPath?: string;
   mediaData?: string;
   mediaMimeType?: string;
+  mediaReferenceKind?: PptxMediaReferenceKind;
+  mediaReferenceName?: string;
+  audioCdStart?: PptxAudioCdPosition;
+  audioCdEnd?: PptxAudioCdPosition;
+  rawMediaReferenceXml?: XmlObject;
   /** Trim start in milliseconds (from p:cMediaNode p:cTn @st). */
   trimStartMs?: number;
   /** Trim end in milliseconds (from p:cMediaNode p:cTn @end). */
@@ -3852,6 +4040,16 @@ interface PptxHandoutMaster {
   /** Colour map from `<p:clrMap>` (12 alias attributes). Applied at save time. */
   clrMap?: Record<string, string>;
 }
+/**
+ * Active tab within the master view sidebar.
+ *
+ * @example
+ * ```ts
+ * const tab: MasterViewTab = "slides";
+ * // => "slides" — one of: "slides" | "notes" | "handout"
+ * ```
+ */
+type MasterViewTab = 'slides' | 'notes' | 'handout';
 /**
  * Structured slide master data.
  *
@@ -4019,6 +4217,44 @@ type PptxAnimationTrigger = 'onClick' | 'onShapeClick' | 'onHover' | 'afterPrevi
  * is preserved alongside other animations.
  */
 type PptxNativeAnimationKind = 'media';
+/** A target selected by `p:tgtEl` in the PresentationML timing model. */
+type PptxAnimationTarget = {
+  type: 'shape';
+  shapeId: string;
+  rawXml?: XmlObject;
+} | {
+  type: 'slide';
+  rawXml?: XmlObject;
+} | {
+  type: 'sound';
+  relationshipId: string;
+  name?: string;
+  rawXml?: XmlObject;
+} | {
+  type: 'ink';
+  shapeId: string;
+  rawXml?: XmlObject;
+} | {
+  type: 'unknown';
+  rawXml: XmlObject;
+};
+/** Nested build choice carried by `p:bldGraphic`. */
+type PptxGraphicBuild = {
+  mode: 'asOne';
+  rawXml?: XmlObject;
+} | {
+  mode: 'sub';
+  kind: 'diagram';
+  build: string;
+  reverse: boolean;
+  rawXml?: XmlObject;
+} | {
+  mode: 'sub';
+  kind: 'chart';
+  build: string;
+  animateBackground: boolean;
+  rawXml?: XmlObject;
+};
 /**
  * Parsed native animation record from `p:timing / p:tnLst`.
  *
@@ -4040,6 +4276,8 @@ type PptxNativeAnimationKind = 'media';
 interface PptxNativeAnimation {
   /** Target element/shape ID. */
   targetId?: string;
+  /** Full timing target, including sound and ink target variants. */
+  target?: PptxAnimationTarget;
   /** Trigger type. */
   trigger?: PptxAnimationTrigger;
   /** Shape ID that triggers this animation when clicked (interactive sequence). */
@@ -4144,6 +4382,8 @@ interface PptxNativeAnimation {
    * that aren't OLE charts).
    */
   graphicBuild?: string;
+  /** Schema-accurate `p:bldGraphic/p:bldAsOne|p:bldSub` representation. */
+  graphicBuildProperties?: PptxGraphicBuild;
   /**
    * Opaque map of `p:cTn` attributes that don't have a typed home on this
    * interface but must round-trip through parse → save. Keys are stored
@@ -4260,6 +4500,8 @@ interface AnimationCondition {
   targetShapeId?: string;
   /** Whether the condition targets a slide (from `p:tgtEl/p:sldTgt`). */
   targetSlide?: boolean;
+  /** Full target choice, including `p:sndTgt` and `p:inkTgt`. */
+  target?: PptxAnimationTarget;
 }
 /** Iteration configuration from `p:iterate`. */
 interface PptxAnimationIterate {
@@ -4362,6 +4604,10 @@ interface PptxElementAnimation {
 interface PptxComment {
   id: string;
   text: string;
+  /** Storage vocabulary used by this comment. Omitted means legacy PresentationML. */
+  format?: 'legacy' | 'modern';
+  /** Stable GUID author identifier used by Office 2021 modern comments. */
+  authorId?: string;
   /** Optional parent comment id for reply threading metadata. */
   parentId?: string;
   author?: string;
@@ -4370,12 +4616,35 @@ interface PptxComment {
   y?: number;
   /** Whether this comment has been resolved/marked done. */
   resolved?: boolean;
+  /** Native p188 status token. */
+  status?: 'active' | 'resolved' | 'closed';
+  /** Modern comment classification tags and author IDs that liked the comment. */
+  tags?: string[];
+  likes?: string[];
+  startDate?: string;
+  dueDate?: string;
+  assignedTo?: string[];
+  /** Task completion in thousandths of a percent, from 0 through 100000. */
+  complete?: number;
+  priority?: number;
+  title?: string;
   /** Modern threaded comment support (p15:threadingInfo). */
   threadId?: string;
   /** Replies to this comment (for modern threaded comments). */
   replies?: PptxComment[];
   /** ID of the element this comment is associated with (if any). */
   elementId?: string;
+  /** Original `p:cm` subtree, retained for unknown child and extension preservation. */
+  rawXml?: XmlObject;
+}
+/** Office 2021 comment author from the p188 Author part. */
+interface PptxModernCommentAuthor {
+  id: string;
+  name: string;
+  initials?: string;
+  userId: string;
+  providerId: string;
+  rawXml?: XmlObject;
 }
 /**
  * A comment author from `ppt/commentAuthors.xml`.
@@ -4408,6 +4677,8 @@ interface PptxCommentAuthor {
   lastIdx: number;
   /** Colour index assigned to this author (`@_clrIdx`). */
   clrIdx: number;
+  /** Original `p:cmAuthor` subtree, retained for unknown attribute preservation. */
+  rawXml?: XmlObject;
 }
 /**
  * A compatibility warning generated during parse or save when the
@@ -4853,6 +5124,8 @@ interface PptxTheme {
 type PptxTransitionType = 'none' | 'cut' | 'fade' | 'push' | 'wipe' | 'split' | 'randomBar' | 'blinds' | 'checker' | 'circle' | 'comb' | 'cover' | 'diamond' | 'dissolve' | 'plus' | 'pull' | 'random' | 'strips' | 'uncover' | 'wedge' | 'wheel' | 'zoom' | 'newsflash' | 'morph' | 'conveyor' | 'doors' | 'ferris' | 'flash' | 'flythrough' | 'gallery' | 'glitter' | 'honeycomb' | 'pan' | 'prism' | 'reveal' | 'ripple' | 'shred' | 'switch' | 'vortex' | 'warp' | 'wheelReverse' | 'window' | 'cube' | 'flip' | 'rotate' | 'orbit';
 /** Split orientation from OOXML `@_orient`. */
 type PptxSplitOrientation = 'horz' | 'vert';
+/** Schema-defined `ST_TransitionSpeed` values. */
+type PptxTransitionSpeed = 'slow' | 'med' | 'fast';
 /**
  * Slide transition configuration.
  *
@@ -4869,6 +5142,8 @@ type PptxSplitOrientation = 'horz' | 'vert';
  */
 interface PptxSlideTransition {
   type: PptxTransitionType;
+  /** Schema-defined transition speed. Defaults to `fast` when omitted. */
+  speed?: PptxTransitionSpeed;
   durationMs?: number;
   direction?: string;
   advanceOnClick?: boolean;
@@ -4883,6 +5158,10 @@ interface PptxSlideTransition {
   orient?: PptxSplitOrientation;
   /** Relationship ID of transition sound from `p:sndAc/p:stSnd/@r:embed` when present. */
   soundRId?: string;
+  /** Embedded WAV display name from `p:stSnd/p:snd/@name`. */
+  soundName?: string;
+  /** Whether the transition sound repeats until another sound starts. */
+  soundLoop?: boolean;
   /** Resolved transition sound media path within the package. */
   soundPath?: string;
   /** Human-readable sound file name (extracted from soundPath). */
@@ -4896,6 +5175,8 @@ interface PptxSlideTransition {
   rawSoundAction?: XmlObject;
   /** Preserved extension-list XML node from `p:extLst` within the transition for lossless round-trip. */
   rawExtLst?: XmlObject;
+  /** Original transition node, retained to preserve unknown attributes and children. */
+  rawTransition?: XmlObject;
 }
 /**
  * View properties types parsed from `ppt/viewProps.xml`.
@@ -5133,6 +5414,8 @@ interface PptxSlide {
   /** Optional `<p:cSld @name>` value of the notes slide, for round-trip. */
   notesCSldName?: string;
   comments?: PptxComment[];
+  /** Source package metadata for an Office 2021 p188 comment part. */
+  modernCommentPart?: PptxModernCommentPart;
   warnings?: PptxCompatibilityWarning[];
   rawXml?: XmlObject;
   /** Per-slide colour map override parsed from `p:clrMapOvr`. */
@@ -5151,6 +5434,24 @@ interface PptxSlide {
   activeXControls?: PptxActiveXControl[];
   /** Per-slide header/footer flags from `<p:hf>` (P-H3). */
   headerFooterFlags?: PptxHeaderFooterFlags;
+  /** Server-backed slide synchronization metadata stored in a related OPC part. */
+  slideSynchronization?: PptxSlideSyncProperties;
+}
+interface PptxModernCommentPart {
+  path: string;
+  relationshipId: string;
+  /** Original p188:cmLst root, including unknown attributes and extensions. */
+  rawXml?: XmlObject;
+}
+/** Metadata from a `p:sldSyncPr` slide synchronization data part. */
+interface PptxSlideSyncProperties {
+  serverSlideId: string;
+  serverSlideModifiedTime: string;
+  clientInsertedTime: string;
+  extensionList?: XmlObject;
+  rawXml?: XmlObject;
+  partPath?: string;
+  relationshipId?: string;
 }
 /**
  * A slide layout available in the loaded presentation.
@@ -5278,6 +5579,8 @@ interface PptxCustomShow {
   id: string;
   /** Ordered list of slide relationship IDs included in this custom show. */
   slideRIds: string[];
+  /** Original `p:custShow` subtree used to preserve unmodelled attributes and extensions. */
+  rawXml?: XmlObject;
 }
 /**
  * An ordered section in the presentation (from `p:sectionLst` / `p14:sectionLst`).
@@ -5306,6 +5609,8 @@ interface PptxSection {
   collapsed?: boolean;
   /** Section highlight color hex (from p15:sectionPr/@clr). */
   color?: string;
+  /** Original section subtree used to preserve unmodelled attributes and extensions. */
+  rawXml?: XmlObject;
 }
 /**
  * Write-protection hash data parsed from `p:modifyVerifier` in `presentation.xml`.
@@ -5469,6 +5774,8 @@ interface PptxData {
   thumbnailData?: Uint8Array;
   /** Comment authors parsed from `ppt/commentAuthors.xml` for round-trip preservation. */
   commentAuthors?: PptxCommentAuthor[];
+  /** Office 2021 p188 authors from the modern Author part. */
+  modernCommentAuthors?: PptxModernCommentAuthor[];
   /**
    * OOXML conformance class of the loaded file.
    * - `'strict'` -- ISO/IEC 29500 Strict (uses `purl.oclc.org` namespace URIs)
@@ -7064,6 +7371,102 @@ interface CanvasSize {
   width: number;
   height: number;
 }
+/** Viewer interaction mode: read-only, edit, presentation, or master-view. */
+type ViewerMode = 'preview' | 'edit' | 'present' | 'master';
+/**
+ * Framework-agnostic imperative API contract for the PowerPoint viewer.
+ *
+ * Each binding (React `forwardRef` handle, Vue `defineExpose`, Angular public
+ * methods) implements this interface so consumers get a consistent progressive
+ * API regardless of framework.
+ */
+interface PowerPointViewerAPI {
+  /** Serialise the current presentation to `.pptx` bytes. */
+  getContent: () => Promise<Uint8Array>;
+  /** Navigate to a specific slide by zero-based index. */
+  goTo: (slideIndex: number) => void;
+  /** Navigate to the previous slide. */
+  goPrev: () => void;
+  /** Navigate to the next slide. */
+  goNext: () => void;
+  /** Undo the last editing action. No-op when nothing to undo. */
+  undo: () => void;
+  /** Redo the last undone action. No-op when nothing to redo. */
+  redo: () => void;
+  /** Whether an undo action is available. */
+  canUndo: () => boolean;
+  /** Whether a redo action is available. */
+  canRedo: () => boolean;
+  /** Get the current zoom level (1 = 100%). */
+  getZoom: () => number;
+  /** Set the zoom level (clamped to min/max bounds). */
+  setZoom: (level: number) => void;
+  /** Zoom in by one step. */
+  zoomIn: () => void;
+  /** Zoom out by one step. */
+  zoomOut: () => void;
+  /** Reset zoom to 100%. */
+  zoomReset: () => void;
+  /** Get the current viewer mode. */
+  getMode: () => ViewerMode;
+  /** Switch the viewer mode (e.g. 'edit', 'preview', 'present'). */
+  setMode: (mode: ViewerMode) => void;
+  /** Get the zero-based active slide index. */
+  getActiveSlideIndex: () => number;
+  /** Set the active slide by zero-based index (alias of goTo). */
+  setActiveSlideIndex: (index: number) => void;
+  /** Get the total number of slides. */
+  getSlideCount: () => number;
+  /** Whether the document has unsaved changes. */
+  isDirty: () => boolean;
+  /**
+   * Get the full slide array. Returns the actual `PptxSlide[]` from the
+   * internal model with full type information (elements, notes, transitions,
+   * animations, etc.). The returned reference is a snapshot; mutations are
+   * not reflected back unless done via the manipulation methods.
+   */
+  getSlides: () => readonly PptxSlide[];
+  /** Get a single slide by zero-based index, or undefined if out of range. */
+  getSlide: (index: number) => PptxSlide | undefined;
+  /** Get the currently active slide. */
+  getActiveSlide: () => PptxSlide | undefined;
+  /** Add a blank slide after the given index (or at end if omitted). */
+  addSlide: (afterIndex?: number) => void;
+  /** Delete slides at the given zero-based indexes. At least one slide is kept. */
+  deleteSlides: (indexes: number[]) => void;
+  /** Duplicate slides at the given zero-based indexes. */
+  duplicateSlides: (indexes: number[]) => void;
+  /** Move a slide from one position to another. */
+  moveSlide: (fromIndex: number, toIndex: number) => void;
+  /** Toggle the hidden flag on slides at the given indexes. */
+  toggleHideSlides: (indexes: number[]) => void;
+  /**
+   * Get the elements on a slide. Defaults to the active slide when
+   * `slideIndex` is omitted. Returns the full `PptxElement[]` with
+   * all type-specific properties intact.
+   */
+  getElements: (slideIndex?: number) => readonly PptxElement[];
+  /** Get a single element by ID from the active slide (or a specified slide). */
+  getElementById: (elementId: string, slideIndex?: number) => PptxElement | undefined;
+  /**
+   * Update one or more properties of an element by ID on the active slide.
+   * Accepts a `Partial<PptxElement>` patch (e.g. `{ x: 100, width: 300 }`).
+   */
+  updateElement: (elementId: string, updates: Partial<PptxElement>) => void;
+  /** Delete elements by their IDs from the active slide. */
+  deleteElements: (elementIds: string[]) => void;
+  /**
+   * Duplicate an element on the active slide.
+   * Returns the new element's ID, or undefined if the source was not found.
+   */
+  duplicateElement: (elementId: string) => string | undefined;
+  /** Get the IDs of currently selected elements. */
+  getSelectedElementIds: () => string[];
+  /** Programmatically select elements by their IDs. */
+  selectElements: (ids: string[]) => void;
+  /** Clear the current selection. */
+  clearSelection: () => void;
+}
 /** Collaboration role within a session. */
 type CollaborationRole = 'owner' | 'collaborator' | 'viewer';
 /**
@@ -7076,10 +7479,12 @@ type CollaborationRole = 'owner' | 'collaborator' | 'viewer';
  *   any signaling server, which makes this mode usable from static hosting.
  */
 type CollaborationTransport = 'websocket' | 'webrtc';
+/** How the local user entered a collaboration session. */
+type CollaborationSessionIntent = 'create' | 'join';
 /**
  * Real-time collaboration configuration.
  *
- * The same shape is accepted by the React, Vue, and Angular bindings.
+ * The same shape is accepted by every framework binding.
  */
 interface CollaborationConfig {
   /** Unique identifier for the collaboration room (alphanumeric, hyphens, underscores). */
@@ -7107,6 +7512,13 @@ interface CollaborationConfig {
   authToken?: string;
   /** Role in the session; defaults to `'collaborator'`. */
   role?: CollaborationRole;
+  /**
+   * Whether this client created the room or joined an existing room. Providers
+   * do not use this value, but hosts can use it to avoid publishing local file
+   * bytes when handling a join request. Omitted values retain the legacy
+   * create-session behaviour.
+   */
+  sessionIntent?: CollaborationSessionIntent;
   /**
    * Elected-writer write-back callback (Area 3 of the C3 hardening plan).
    *
@@ -7241,6 +7653,19 @@ interface SanitizedPresence {
   selectedElementId?: string;
   role?: CollaborationRole;
 }
+/**
+ * A font supplied by the host application. The package never ships fonts:
+ * applications provide a licensed URL, data URL, or blob URL for their users.
+ */
+interface ViewerFontSource {
+  family: string;
+  src: string;
+  format?: 'truetype' | 'opentype' | 'woff' | 'woff2';
+  weight?: string | number;
+  style?: 'normal' | 'italic';
+}
+declare function parsePresentationSessionId(hash: string): string | null;
+declare function loadPresentationDeck(sessionId: string): Promise<Uint8Array | null>;
 /**
  * Pure, framework-agnostic helpers for freehand ink drawing, shared by every
  * binding. No framework imports, so these can be unit-tested without TestBed.
@@ -7401,6 +7826,15 @@ interface ViewerState {
   templateElementsBySlideId: Record<string, PptxElement[]>;
   /** Parsed slide masters and layouts used by the dedicated master canvas. */
   slideMasters: PptxSlideMaster[];
+  /** Parsed notes master and its portrait page size. */
+  notesMaster?: PptxNotesMaster;
+  notesCanvasSize?: CanvasSize;
+  /** Parsed handout master. */
+  handoutMaster?: PptxHandoutMaster;
+  /** Active master-workspace tab. */
+  masterViewTab: MasterViewTab;
+  /** Preview layout used by the handout master workspace. */
+  handoutSlidesPerPage: number;
   /** Active master/layout canvas, or null for normal slide view. */
   masterViewTarget: {
     masterIndex: number;
@@ -7486,20 +7920,9 @@ interface AnimationActions {
  * Z-order, align, flip, and group/ungroup actions for the ribbon's
  * Home > Arrange group.
  *
- * Align/distribute: the vanilla editor's selection model is single-element
- * only (see `state/viewer-state.ts`), so `alignElements` reaches the
- * single-selection "align to slide" mode ({@link alignToCanvas}), matching
- * PowerPoint's own behaviour when nothing else is selected. Multi-selection
- * "align to selection bounding box" / distribute (needing >= 2 / >= 3
- * elements, see `editor-arrange-mutations.ts`) is unreachable until a
- * multi-select model lands; `canDistribute` is therefore always `false` today
- * (see `editing-chrome-sync.ts`), a documented limitation rather than a bug.
- *
- * Group: needs >= 2 selected elements to be meaningful, so it too is
- * unreachable under single selection; `groupSelected` is a deliberate no-op
- * kept only so the ribbon button (permanently disabled, with an explanatory
- * title) has something to call. Ungroup works today: it applies to whichever
- * single `group` element is selected.
+ * A single selection aligns against the slide canvas. Shift-click or marquee
+ * multi-selection aligns against the collective bounds, enables distribution
+ * for three or more elements, and enables grouping for two or more elements.
  */
 interface ArrangeActions {
   bringForward(): void;
@@ -7816,6 +8239,41 @@ interface Inspector {
   setEditable(editable: boolean): void;
 }
 //#endregion
+//#region src/viewer/ui/master-view-sidebar.d.ts
+interface MasterViewSidebarOptions {
+  tab: MasterViewTab;
+  masters: readonly PptxSlideMaster[];
+  active: {
+    masterIndex: number;
+    layoutIndex: number | null;
+  };
+  canvasSize: CanvasSize;
+  notesBackground?: string;
+  notesPlaceholders?: readonly {
+    type: string;
+    idx?: string;
+  }[];
+  notesMasterPresent: boolean;
+  handoutBackground?: string;
+  handoutPlaceholders?: readonly {
+    type: string;
+    idx?: string;
+  }[];
+  handoutMasterPresent: boolean;
+  handoutSlidesPerPage: number;
+  renderStage(slide: PptxSlide, scale: number): HTMLElement;
+  onSelect(masterIndex: number, layoutIndex: number | null): void;
+  onTabChange(tab: MasterViewTab): void;
+  onCollapse(): void;
+  onHandoutSlidesPerPageChange(count: number): void;
+  onMasterBackgroundColorChange(color: string): void;
+}
+interface MasterViewSidebar {
+  el: HTMLElement;
+  render(options: MasterViewSidebarOptions): void;
+  setVisible(visible: boolean): void;
+}
+//#endregion
 //#region src/viewer/ui/ribbon/ribbon-types.d.ts
 /** Draw tab state to reflect (current tool/colour/width). */
 interface RibbonDrawState {
@@ -7958,6 +8416,8 @@ interface ViewerChrome {
   inspector: Inspector | null;
   /** Cross-slide accessibility checker results, opened from the View ribbon. */
   accessibility: AccessibilityPanel;
+  /** Dedicated Slide/Notes/Handout master workspace navigation. */
+  masterSidebar: MasterViewSidebar;
   thumbnails: ThumbnailRail | null;
   /** Scrollable centring viewport around the stage. */
   viewport: HTMLElement;
@@ -8009,6 +8469,9 @@ interface EditorController {
   deleteSelected(): void;
   duplicateSelected(): string | null;
   getSelectedElementId(): string | null;
+  selectElements(ids: string[]): void;
+  applyElementPatch(id: string, patch: Partial<PptxElement>): void;
+  commitSlides(slides: PptxSlide[], currentSlide?: number): void;
   /** Switch the Draw ribbon tab's active tool (also clears selection when leaving `'select'`). */
   setDrawTool(tool: DrawTool): void;
   /** Set the pen/highlighter stroke colour used by the next committed stroke. */
@@ -8020,6 +8483,7 @@ interface EditorController {
   /** The Find & Replace actions for the ribbon's docked panel. */
   getFindReplaceActions(): FindReplaceActions;
   commitNotes(notes: string, notesSegments?: TextSegment[]): void;
+  setHandoutSlidesPerPage(count: number): void;
   save(): Promise<Uint8Array>;
   downloadPptx(fileName?: string): Promise<void>;
   destroy(): void;
@@ -8086,6 +8550,12 @@ interface ElementRenderContext {
   readonly document: Document;
   /** The slide being rendered. */
   readonly slide: PptxSlide;
+  /** Full deck, used by Zoom elements to resolve their target preview. */
+  readonly slides?: readonly PptxSlide[];
+  /** Zero-based active slide index for Zoom return navigation. */
+  readonly currentSlideIndex?: number;
+  /** Presentation-only Zoom tile activation callback. */
+  readonly onZoomClick?: (targetSlideIndex: number, returnSlideIndex: number) => void;
   /** Full slide canvas size in CSS px (elements are positioned in this space). */
   readonly canvasSize: CanvasSize;
   /**
@@ -8199,6 +8669,10 @@ interface SlideStageOptions {
   smartArt3D?: boolean;
   /** True only for the live presentation stage; see `ElementRenderContext.presenting`. */
   presenting?: boolean;
+  /** Full deck and active index used by presentation Zoom elements. */
+  slides?: readonly PptxSlide[];
+  currentSlideIndex?: number;
+  onZoomClick?: (targetSlideIndex: number, returnSlideIndex: number) => void;
   /**
    * True only for the main (interactive) canvas, never the thumbnail rail.
    * Marks every rendered element (recursively, including group children) with
@@ -8226,10 +8700,9 @@ declare function renderSlideStage(options: SlideStageOptions): HTMLElement;
  * The registry the viewer uses by default.
  *
  * Dedicated renderers: `text`, `shape`, `image`, `picture`, `group`,
- * `connector`, `table`, `chart`, `smartArt`, `media`, `ink`, `ole`. The
- * remaining types (`contentPart`, `zoom`, `model3d`, `unknown`) fall through
- * to the typed placeholder fallback until their renderers land; see
- * `./README.md` for the contract to add one.
+ * `connector`, `table`, `chart`, `smartArt`, `media`, `ink`, `ole`,
+ * `contentPart`, `zoom`, and `model3d`. Only unknown extension elements fall
+ * through to the typed placeholder fallback.
  */
 declare function createDefaultRegistry(): ElementRendererRegistry;
 //#endregion
@@ -8442,6 +8915,8 @@ interface PptxViewerOptions extends PptxViewerCallbacks {
    * `loadFile` / `loadUrl` later.
    */
   source?: PptxViewerSource;
+  /** Licensed font sources supplied by the host application. */
+  fonts?: ViewerFontSource[];
   /** Viewer chrome theme (shared `ViewerTheme`: colors, radius, CSS vars). */
   theme?: ViewerTheme;
   /** Display name shown in the PowerPoint-style title bar. */
@@ -8530,7 +9005,7 @@ interface PptxViewerOptions extends PptxViewerCallbacks {
   shareDefaults?: ShareDefaults;
 }
 /** The viewer handle returned by `createPptxViewer`. */
-interface PptxViewerInstance {
+interface PptxViewerInstance extends PowerPointViewerAPI {
   /** Load a presentation from bytes or a Blob/File (replaces the current one). */
   loadFile(file: Blob | ArrayBuffer | Uint8Array): Promise<void>;
   /** Fetch and load a presentation from a URL. */
@@ -8548,7 +9023,7 @@ interface PptxViewerInstance {
   /** Effective zoom scale (1 = 100%), after fit resolution. */
   getZoom(): number;
   /** Set an explicit zoom scale, or `'fit'` for fit-to-viewport. */
-  setZoom(zoom: ZoomLevel): void;
+  setZoom(zoom: number): void;
   zoomIn(): void;
   zoomOut(): void;
   zoomToFit(): void;
@@ -8677,6 +9152,7 @@ interface ChromeHost {
   goToSlide(index: number): void;
   getSlideCount(): number;
   enterPresentation(): Promise<void>;
+  openPresenterView(): void;
   exitPresentation(): Promise<void>;
   openBroadcast(): void;
   openAccessibility(): void;
@@ -8744,6 +9220,13 @@ declare class PptxViewer extends ViewerExportHost implements PptxViewerInstance,
   private readonly sessions;
   private readonly controls;
   private destroyed;
+  private presenterChannel;
+  private audienceWindow;
+  private presenterSessionId;
+  private presenterSequence;
+  private presenterSnapshot;
+  private disposePresenterConsole;
+  private userFontsStyle;
   constructor(container: HTMLElement, options?: PptxViewerOptions);
   loadFile(file: Blob | ArrayBuffer | Uint8Array): Promise<void>;
   loadUrl(url: string): Promise<void>;
@@ -8753,15 +9236,50 @@ declare class PptxViewer extends ViewerExportHost implements PptxViewerInstance,
   getSlideCount: () => number;
   getCurrentSlide: () => number;
   getZoom: () => number;
-  setZoom(zoom: ZoomLevel): void;
+  setZoom(zoom: number): void;
   zoomIn: () => void;
   zoomOut: () => void;
   zoomToFit: () => void;
+  zoomReset: () => void;
+  goTo: (index: number) => void;
+  goPrev: () => void;
+  goNext: () => void;
+  getContent: () => Promise<Uint8Array>;
+  getMode: () => ViewerMode;
+  setMode: (mode: ViewerMode) => void;
+  getActiveSlideIndex: () => number;
+  setActiveSlideIndex: (index: number) => void;
+  isDirty: () => boolean;
+  getSlides: () => readonly PptxSlide[];
+  getSlide: (index: number) => PptxSlide | undefined;
+  getActiveSlide: () => PptxSlide | undefined;
+  getElements: (index?: number) => readonly PptxElement[];
+  getElementById: (id: string, index?: number) => PptxElement | undefined;
+  updateElement: (id: string, updates: Partial<PptxElement>) => void;
+  deleteElements: (ids: string[]) => void;
+  duplicateElement: (id: string) => string | undefined;
+  getSelectedElementIds: () => string[];
+  selectElements: (ids: string[]) => void;
+  clearSelection: () => void;
+  addSlide: (afterIndex?: number) => void;
+  deleteSlides: (indexes: number[]) => void;
+  duplicateSlides: (indexes: number[]) => void;
+  moveSlide: (fromIndex: number, toIndex: number) => void;
+  toggleHideSlides: (indexes: number[]) => void;
+  private renumber;
   /** Expand/collapse the speaker-notes panel; persists for the instance's life. */
   toggleNotes(): void;
   setTheme(theme: ViewerTheme | undefined): void;
   /** Run the shared WCAG checks against the live deck and show the results. */
   openAccessibility(): void;
+  /** Open a clean audience display while retaining this editor as the presenter surface. */
+  openPresenterView(): void;
+  private getPresenterChannel;
+  private isAudienceWindowOpen;
+  private syncAudience;
+  private updatePresenterSnapshot;
+  private connectAudienceRole;
+  private closeAudienceWindow;
   setLocale(locale: string): void;
   setEditable(editable: boolean): void;
   setEditTemplateMode(enabled: boolean): void;
@@ -8822,5 +9340,5 @@ type TranslationKey = keyof typeof translationsEn;
  */
 declare function keyToLabel(key: string): string;
 //#endregion
-export { type AutosaveRecord, type AutosaveStatus, type CollaborationConfig, type CollaborationRole, type CollaborationTransport, type ConnectionStatus, type CssStyleMap, type ElementRenderContext, type ElementRenderer, type ElementRendererRegistry, type ExportGifOptions, type ExportPdfOptions, type ExportProgress, type ExportVideoOptions, type OpenPrintWindow, type PptxElement, type PptxElementType, type PptxHandler, type PptxSlide, PptxViewer, type PptxViewerCallbacks, type PptxViewerInstance, type PptxViewerOptions, type PptxViewerSource, type PrintOptions, type SlideStageOptions, type TranslationKey, type TranslationMessages, type Translator, type ViewerState, type ViewerTheme, type ViewerThemeColors, type ZoomLevel, applyStyleMap, createDefaultRegistry, createEl, createElementRendererRegistry, createPptxViewer, createSvgEl, createTranslator, defaultCssVars, defaultRadius, defaultThemeColors, getViewerCss, keyToLabel, renderSlideStage, themeToCssVars, translationsEn, vermilionDarkTheme, vermilionLightTheme };
+export { type AutosaveRecord, type AutosaveStatus, type CollaborationConfig, type CollaborationRole, type CollaborationTransport, type ConnectionStatus, type CssStyleMap, type ElementRenderContext, type ElementRenderer, type ElementRendererRegistry, type ExportGifOptions, type ExportPdfOptions, type ExportProgress, type ExportVideoOptions, type OpenPrintWindow, type PptxElement, type PptxElementType, type PptxHandler, type PptxSlide, PptxViewer, type PptxViewerCallbacks, type PptxViewerInstance, type PptxViewerOptions, type PptxViewerSource, type PrintOptions, type SlideStageOptions, type TranslationKey, type TranslationMessages, type Translator, type ViewerState, type ViewerTheme, type ViewerThemeColors, type ZoomLevel, applyStyleMap, createDefaultRegistry, createEl, createElementRendererRegistry, createPptxViewer, createSvgEl, createTranslator, defaultCssVars, defaultRadius, defaultThemeColors, getViewerCss, keyToLabel, loadPresentationDeck, parsePresentationSessionId, renderSlideStage, themeToCssVars, translationsEn, vermilionDarkTheme, vermilionLightTheme };
 //# sourceMappingURL=index.d.ts.map