pptx-vanilla-viewer 0.7.0 → 0.9.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-BLbjWKxK.d.ts
 /**
  * Action types: hyperlinks, slide jumps, macros, and action buttons.
  *
@@ -43,6 +43,48 @@ interface PptxAction {
   /** Resolved media target path for the optional click sound. */
   soundPath?: string;
 }
+/**
+ * High-level action type for the action settings UI.
+ * Maps to OOXML `ppaction://` verbs + external URLs.
+ *
+ * @example
+ * ```ts
+ * const type: ElementActionType = "slide";
+ * // => "slide" — one of: "none" | "url" | "slide" | "firstSlide" | "lastSlide" | "prevSlide" | "nextSlide" | "endShow"
+ * ```
+ */
+type ElementActionType = 'none' | 'url' | 'slide' | 'firstSlide' | 'lastSlide' | 'prevSlide' | 'nextSlide' | 'endShow';
+/**
+ * User-facing action configuration stored on an element.
+ * This is a convenience wrapper around the lower-level `PptxAction` that maps
+ * to/from OOXML hyperlink/action attributes.
+ *
+ * @example
+ * ```ts
+ * const action: ElementAction = {
+ *   trigger: "click",
+ *   type: "url",
+ *   url: "https://example.com",
+ * };
+ *
+ * const jumpToSlide: ElementAction = {
+ *   trigger: "click",
+ *   type: "slide",
+ *   slideIndex: 5,
+ * };
+ * // => satisfies ElementAction
+ * ```
+ */
+interface ElementAction {
+  /** When the action fires. */
+  trigger: 'click' | 'hover';
+  /** What kind of action to perform. */
+  type: ElementActionType;
+  /** External URL (for 'url' type). */
+  url?: string;
+  /** Zero-based slide index (for 'slide' type). */
+  slideIndex?: number;
+}
 /**
  * Shared value types used across the entire PPTX editor type system.
  *
@@ -357,6 +399,8 @@ interface CustomGeometryPath {
  * and the text rectangle are not lost when a custGeom is edited and saved.
  */
 interface CustomGeometryRawData {
+  /** Raw `a:avLst` XML content (adjustment value list). */
+  avLstXml?: unknown;
   /** Raw `a:gdLst` XML content (guide list). */
   gdLstXml?: unknown;
   /** Raw `a:ahLst` XML content (adjustment handles). */
@@ -497,7 +541,7 @@ interface PptxCustomPathProperties {
   pathHeight?: number;
   /** Structured custom geometry paths for editing (maps to a:custGeom/a:pathLst). */
   customGeometryPaths?: CustomGeometryPath[];
-  /** Raw a:gdLst/a:ahLst/a:cxnLst/a:rect XML preserved for round-trip serialization. */
+  /** Raw adjustment/guide/handle/connection/text-rectangle XML preserved for serialization. */
   customGeometryRawData?: CustomGeometryRawData;
   /**
    * Typed XY adjustment handles parsed from `a:custGeom/a:ahLst/a:ahXY`.
@@ -596,6 +640,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 +654,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 +668,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`.
@@ -683,6 +749,12 @@ type PptxTextWarpPreset = 'textNoShape' | 'textPlain' | 'textStop' | 'textTriang
  *
  * @module pptx-types/shape-style
  */
+interface PptxCustomDashSegment {
+  /** Dash length as a non-negative percentage in thousandths of one percent. */
+  dash: number;
+  /** Space length as a non-negative percentage in thousandths of one percent. */
+  space: number;
+}
 /**
  * Comprehensive visual style for a shape, connector, or image element.
  *
@@ -731,9 +803,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 +875,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 +926,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 +951,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). */
@@ -887,11 +987,12 @@ interface ShapeStyle {
   connectorStartConnection?: ConnectorConnectionPoint;
   /** Connection point for the end of a connector. */
   connectorEndConnection?: ConnectorConnectionPoint;
-  /** Custom dash segments array (`a:custDash/a:ds`). Each entry has dash length and space length in EMU. */
-  customDashSegments?: Array<{
-    dash: number;
-    space: number;
-  }>;
+  /** Custom dash pattern, measured relative to line width in thousandths of one percent. */
+  customDashSegments?: PptxCustomDashSegment[];
+  /** Original `a:ds` payloads retained by index for lossless edits. */
+  customDashSegmentXml?: XmlObject[];
+  /** Original `a:custDash` payload retained for lossless edits. */
+  customDashXml?: XmlObject;
   /** 3D scene/camera settings from `a:scene3d`. */
   scene3d?: Pptx3DScene;
   /** 3D shape extrusion/bevel from `a:sp3d`. */
@@ -1001,6 +1102,8 @@ interface ShapeStyle {
  * ```
  */
 interface TextStyle {
+  /** Original `a:rPr` XML retained by projections that share the shape-text model. */
+  runPropertiesXml?: XmlObject;
   fontFamily?: string;
   fontSize?: number;
   /** When true, renderer should shrink text to fit the shape bounds. */
@@ -1350,6 +1453,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 +1828,114 @@ 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;
+  /** Number of category/date labels between rendered labels. */
+  tickLabelSkip?: number;
+  /** Number of category/date tick positions between major tick marks. */
+  tickMarkSkip?: number;
+  /** Suppress multi-level category labels (`c:noMultiLvlLbl`). */
+  noMultiLevelLabels?: boolean;
+}
+interface PptxChartPivotFormat {
+  index: number;
+  shapePropertiesXml?: XmlObject | null;
+  markerXml?: XmlObject | null;
+  dataLabelXml?: XmlObject | null;
+  extensionListXml?: XmlObject | null;
+  rawXml?: XmlObject;
+}
+/** Editable classic ChartML `c:pivotFmts` collection. */
+interface PptxChartPivotFormats {
+  formats: PptxChartPivotFormat[];
+  rawXml?: XmlObject;
+}
+/** Editable classic ChartML `c:pivotSource` metadata. */
+interface PptxChartPivotSource {
+  /** Pivot table reference stored as `c:name` text. */
+  name: string;
+  /** Required unsigned format identifier stored in `c:fmtId/@val`. */
+  formatId: number;
+  /** Internal source subtree used to preserve extensions and foreign markup. */
+  rawXml?: XmlObject;
+}
+/** Headers and footers used when a classic ChartML chart is printed. */
+interface PptxChartPrintHeaderFooter {
+  oddHeader?: string;
+  oddFooter?: string;
+  evenHeader?: string;
+  evenFooter?: string;
+  firstHeader?: string;
+  firstFooter?: string;
+  alignWithMargins?: boolean;
+  differentOddEven?: boolean;
+  differentFirst?: boolean;
+  /** Original subtree retained for foreign attributes and extension children. */
+  rawXml?: unknown;
+}
+/** Required page margins from ChartML `c:pageMargins`, measured in inches. */
+interface PptxChartPageMargins {
+  left: number;
+  right: number;
+  top: number;
+  bottom: number;
+  header: number;
+  footer: number;
+  /** Original leaf retained for foreign attributes. */
+  rawXml?: unknown;
+}
+/** Printer page configuration from ChartML `c:pageSetup`. */
+interface PptxChartPageSetup {
+  paperSize?: number;
+  firstPageNumber?: number;
+  orientation?: 'default' | 'portrait' | 'landscape';
+  blackAndWhite?: boolean;
+  draft?: boolean;
+  useFirstPageNumber?: boolean;
+  horizontalDpi?: number;
+  verticalDpi?: number;
+  copies?: number;
+  /** Original leaf retained for foreign attributes. */
+  rawXml?: unknown;
+}
+/** Editable `c:printSettings` content from a classic ChartML chart space. */
+interface PptxChartPrintSettings {
+  headerFooter?: PptxChartPrintHeaderFooter | null;
+  pageMargins?: PptxChartPageMargins | null;
+  pageSetup?: PptxChartPageSetup | null;
+  /** `null` removes the legacy header/footer drawing relationship element. */
+  legacyDrawingHeaderFooterRelationshipId?: string | null;
+  /** Original subtree retained for unknown and extension content. */
+  rawXml?: unknown;
+}
+/** Editable classic ChartML `c:protection` settings. */
+interface PptxChartProtection {
+  /** Prevent editing the chart object. */
+  chartObject?: boolean | null;
+  /** Prevent editing the chart data. */
+  data?: boolean | null;
+  /** Prevent editing chart formatting. */
+  formatting?: boolean | null;
+  /** Prevent selecting chart elements. */
+  selection?: boolean | null;
+  /** Prevent chart user-interface operations. */
+  userInterface?: boolean | null;
+  /** Internal source subtree used to preserve foreign markup during edits. */
+  rawXml?: XmlObject;
+}
 /**
  * Chart types: chart categories, series data, style metadata, data tables,
  * trendlines, error bars, and the composite `PptxChartData`.
@@ -1765,6 +1978,7 @@ type PptxChartTrendlineType = 'linear' | 'exponential' | 'logarithmic' | 'polyno
  */
 interface PptxChartTrendline {
   trendlineType: PptxChartTrendlineType;
+  name?: string;
   order?: number;
   period?: number;
   forward?: number;
@@ -1773,6 +1987,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 +2030,8 @@ interface PptxChartErrBars {
   val?: number;
   customPlus?: number[];
   customMinus?: number[];
+  noEndCap?: boolean;
+  color?: string;
 }
 /**
  * Visibility flags for the chart data table (axes + legend keys).
@@ -1858,9 +2081,17 @@ 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;
+  /** Marker size in points, constrained by ST_MarkerSize to 2 through 72. */
   size?: number;
   spPr?: PptxChartShapeProps;
 }
@@ -1871,26 +2102,43 @@ interface PptxChartDataPoint {
   explosion?: number;
   invertIfNegative?: boolean;
   marker?: PptxChartMarker;
+  /** Render a bubble-chart point with a 3-D appearance. */
+  bubble3D?: boolean;
 }
+/** 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';
@@ -1898,6 +2146,12 @@ interface PptxChartAxisFormatting {
   axisId?: number;
   /** Cross-axis identifier — the axis this axis crosses. */
   crossAxisId?: number;
+  /** Automatic crossing mode (`c:crosses`). Mutually exclusive with `crossesAt`. */
+  crosses?: 'autoZero' | 'min' | 'max';
+  /** Explicit crossing value (`c:crossesAt`). Units depend on the axis type. */
+  crossesAt?: number;
+  /** Whether a value axis crosses between or at category tick marks. */
+  crossBetween?: 'between' | 'midCat';
   numFmt?: PptxChartAxisNumFmt;
   titleText?: string;
   spPr?: PptxChartShapeProps;
@@ -1915,6 +2169,8 @@ interface PptxChartAxisFormatting {
   min?: number;
   /** Maximum axis value override (c:max/@val). */
   max?: number;
+  /** Axis value direction (`c:scaling/c:orientation/@val`). */
+  orientation?: 'minMax' | 'maxMin';
   /** Whether the axis is deleted/hidden (c:delete/@val). */
   deleted?: boolean;
   /**
@@ -1924,8 +2180,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,14 +2194,69 @@ 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';
+  /** Calendar unit used to interpret date-axis serial values. */
+  baseTimeUnit?: 'days' | 'months' | 'years';
+  majorTimeUnit?: 'days' | 'months' | 'years';
+  minorTimeUnit?: 'days' | 'months' | 'years';
 }
 /** 3D wall or floor element formatting. */
 interface PptxChart3DSurface {
   thickness?: number;
   spPr?: PptxChartShapeProps;
 }
+/** Office 2016 ChartEx box-and-whisker series layout options. */
+interface PptxChartBoxWhiskerOptions {
+  quartileMethod?: 'inclusive' | 'exclusive';
+  showMeanLine?: boolean;
+  showMeanMarker?: boolean;
+  /** Show non-outlier (inner) data points. */
+  showInnerPoints?: boolean;
+  showOutlierPoints?: boolean;
+}
+/** Office 2016 ChartEx histogram and Pareto series layout options. */
+interface PptxChartHistogramOptions {
+  /** Maps to `clusteredColumn` for histogram columns or `paretoLine`. */
+  layout?: 'histogram' | 'pareto';
+  /** Exactly one of binSize and binCount is emitted by the ChartEx writer. */
+  binSize?: number;
+  binCount?: number;
+  intervalClosed?: 'l' | 'r';
+  underflow?: number | 'auto';
+  overflow?: number | 'auto';
+}
+/** Office 2016 ChartEx waterfall series layout options. */
+interface PptxChartWaterfallOptions {
+  /** Zero-based data point indexes rendered as absolute subtotal or total bars. */
+  subtotalIndices?: number[];
+  /** Whether connector lines are visible between adjacent bars. */
+  connectorLines?: boolean;
+}
+/** Office 2016 ChartEx geographic series dimensions and layout options. */
+interface PptxChartRegionMapOptions {
+  /** Optional provider entity identifiers aligned with categories and values. */
+  entityIds?: string[];
+  /** Original `cx:pt/@idx` values for category points. */
+  categorySourceIndices?: number[];
+  /** Original `cx:pt/@idx` values for colour-value points. */
+  valueSourceIndices?: number[];
+  /** Original `cx:pt/@idx` values for entity-ID points. */
+  entityIdSourceIndices?: number[];
+  regionLabelLayout?: 'none' | 'bestFitOnly' | 'showAll';
+  projectionType?: 'mercator' | 'miller' | 'robinson' | 'albers';
+  viewedRegionType?: 'dataOnly' | 'postalCode' | 'county' | 'state' | 'countryRegion' | 'countryRegionList' | 'world';
+  cultureLanguage?: string;
+  /** ISO-3166-1 alpha-2 region code. */
+  cultureRegion?: string;
+  attribution?: string;
+  /** Opaque authored provider cache under `cx:geography/cx:geoCache`. */
+  geographyCache?: XmlObject;
+}
+/** Layout for parent category labels in a hierarchical ChartEx treemap. */
+type PptxChartParentLabelLayout = 'none' | 'banner' | 'overlapping';
+/** Per-series layout options for an Office 2016+ ChartEx treemap. */
+interface PptxChartTreemapOptions {
+  parentLabelLayout?: PptxChartParentLabelLayout;
+}
 /**
  * A single data series within a chart.
  *
@@ -1977,6 +2292,11 @@ interface PptxChartSeries {
    * series.
    */
   seriesChartType?: PptxChartType;
+  boxWhiskerOptions?: PptxChartBoxWhiskerOptions;
+  histogramOptions?: PptxChartHistogramOptions;
+  waterfallOptions?: PptxChartWaterfallOptions;
+  regionMapOptions?: PptxChartRegionMapOptions;
+  treemapOptions?: PptxChartTreemapOptions;
 }
 /**
  * Chart-level data-label options (`c:dLbls` directly under a chart-type
@@ -1994,12 +2314,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 +2362,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 +2424,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 +2472,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. */
@@ -2131,6 +2502,16 @@ interface PptxEmbeddedWorkbookData {
     name: string;
     values: number[];
   }>;
+  /** Whether the workbook uses the 1904 date system. */
+  date1904?: boolean;
+}
+/** Raw numeric category cache used by a classic ChartML date axis. */
+interface PptxChartDateCategories {
+  values: number[];
+  /** False/default uses Excel's 1900 date system; true uses the 1904 system. */
+  date1904?: boolean;
+  /** Number format copied from the numeric category cache. */
+  formatCode?: string;
 }
 /**
  * Complete parsed chart data for a {@link ChartPptxElement}.
@@ -2154,6 +2535,13 @@ interface PptxChartData {
   title?: string;
   chartType: PptxChartType;
   categories: string[];
+  /**
+   * Hierarchical category levels in source XML order for ChartEx hierarchy charts.
+   * Level 0 contains the leaf labels and remains mirrored by {@link categories}
+   * for consumers that only understand a flat category axis.
+   */
+  categoryLevels?: string[][];
+  dateCategories?: PptxChartDateCategories;
   series: PptxChartSeries[];
   /** Chart style/formatting metadata. */
   style?: PptxChartStyle;
@@ -2163,9 +2551,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;
@@ -2187,12 +2578,7 @@ interface PptxChartData {
    * The chart still renders using its cached series data; this field
    * is metadata about the data origin, preserved for round-trip fidelity.
    */
-  pivotSource?: {
-    /** Pivot table reference name, e.g. "[workbook.xlsx]Sheet1!PivotTable1". */
-    name: string;
-    /** Format identifier from c:fmtId/@val. */
-    formatId?: number;
-  };
+  pivotSource?: PptxChartPivotSource | null;
   /**
    * Whether only visible cells are plotted (c:plotVisOnly).
    * When `true` (the default), hidden cells are excluded from the chart.
@@ -2215,6 +2601,12 @@ interface PptxChartData {
    * - `"acrossLinear"` — gradient across series
    */
   colorMethod?: 'cycle' | 'withinLinear' | 'acrossLinear';
+  /** Internal source color-style part path used for lossless dirty saves. */
+  colorStylePartPath?: string;
+  /** Internal parsed palette snapshot used to detect actual edits. */
+  colorStyleOriginalPalette?: string[];
+  /** Internal parsed method snapshot used to detect actual edits. */
+  colorStyleOriginalMethod?: 'cycle' | 'withinLinear' | 'acrossLinear';
   /**
    * Pie-of-pie / Bar-of-pie options (`c:ofPieChart`, CT_OfPieChart).
    *
@@ -2223,6 +2615,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 +2632,12 @@ interface PptxChartData {
    * source data, so absence does not produce empty `<c:…/>` placeholders.
    */
   chartChrome?: PptxChartChrome;
+  /** `c:chartSpace/c:printSettings`; `null` removes the container on save. */
+  printSettings?: PptxChartPrintSettings | null;
+  /** `c:chartSpace/c:protection`; `null` removes the container on save. */
+  protection?: PptxChartProtection | null;
+  /** Editable manual placement for the title, plot area, and legend. */
+  layouts?: PptxChartLayouts;
   /**
    * Raw `c:userShapes` XML subtree (a drawing tree) preserved verbatim.
    *
@@ -2254,7 +2654,8 @@ interface PptxChartData {
    * for charts whose data originates from a PivotTable. Preserved
    * verbatim for round-trip fidelity.
    */
-  pivotFmtsXml?: unknown;
+  /** Typed pivot-chart format persistence; `null` removes `c:pivotFmts`. */
+  pivotFormats?: PptxChartPivotFormats | null;
   /**
    * Color-map override (`c:clrMapOvr`) carrying 12 attributes that
    * remap theme colour roles for this chart only. Preserved as a flat
@@ -2262,105 +2663,58 @@ 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 | EffectDagAlphaOutset | 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_AlphaOutsetEffect with original XML retained for lossless edits. */
+interface EffectDagAlphaOutset {
+  kind: 'alphaOutset';
+  radiusEmu?: number;
+  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>;
 }
 /**
@@ -2388,6 +2742,8 @@ interface PptxImageEffects {
   duotone?: {
     color1: string;
     color2: string;
+    /** Original effect XML, retained while the resolved colours are unchanged. */
+    rawXml?: XmlObject;
   };
   /** Grayscale flag. */
   grayscale?: boolean;
@@ -2402,8 +2758,10 @@ interface PptxImageEffects {
   artisticEffect?: string;
   /** Artistic effect radius/amount. */
   artisticRadius?: number;
-  /** Alpha modulation fixed — overall opacity (0-100, where 100 = fully opaque). */
+  /** Alpha modulation fixed: non-negative percentage (100 means unchanged opacity). */
   alphaModFix?: number;
+  /** Original alpha modulation fixed node, including foreign attributes. */
+  alphaModFixRawXml?: XmlObject;
   /** Bi-level threshold — converts to 1-bit black/white (0-100). */
   biLevel?: number;
   /** Colour change — swap one colour range for another (used for transparency keying). */
@@ -2412,7 +2770,13 @@ interface PptxImageEffects {
     clrTo: string;
     /** Whether the target colour is fully transparent (alpha = 0). */
     clrToTransparent?: boolean;
+    /** Original effect XML, including colour transforms and extensions. */
+    rawXml?: XmlObject;
   };
+  /** Original grayscale node, including extension or foreign attributes. */
+  grayscaleRawXml?: XmlObject;
+  /** Original bi-level node, including extension or foreign attributes. */
+  biLevelRawXml?: XmlObject;
   /**
    * Alpha inverse effect (`a:alphaInv`). Inverts the alpha channel; an optional
    * colour child shifts the inversion baseline.
@@ -2420,11 +2784,17 @@ interface PptxImageEffects {
   alphaInv?: {
     /** Optional baseline colour (hex). */
     color?: string;
+    /** Original effect XML, including colour transforms and foreign attributes. */
+    rawXml?: XmlObject;
   };
   /** Alpha ceiling (`a:alphaCeiling`) — clamps any non-zero alpha to fully opaque. Boolean flag. */
   alphaCeiling?: boolean;
+  /** Original alpha ceiling node, including foreign attributes. */
+  alphaCeilingRawXml?: XmlObject;
   /** Alpha floor (`a:alphaFloor`) — clamps any non-fully-opaque alpha to fully transparent. Boolean flag. */
   alphaFloor?: boolean;
+  /** Original alpha floor node, including foreign attributes. */
+  alphaFloorRawXml?: XmlObject;
   /**
    * Alpha modulate (`a:alphaMod`). The schema requires a single `cont` (effect
    * container) child; we preserve the inner XML opaquely for round-trip.
@@ -2432,11 +2802,17 @@ interface PptxImageEffects {
   alphaMod?: {
     /** Raw opaque XML for the `a:cont` child to preserve on save. */
     contRawXml?: Record<string, unknown>;
+    /** Original effect XML, including foreign attributes. */
+    rawXml?: XmlObject;
   };
   /** Alpha replace (`a:alphaRepl`) — replaces alpha with the given fixed-percent value (0..100). */
   alphaRepl?: number;
+  /** Original alpha replace node, including foreign attributes. */
+  alphaReplRawXml?: XmlObject;
   /** Alpha bi-level (`a:alphaBiLevel`) — threshold (0..100) above which alpha becomes fully opaque. */
   alphaBiLevel?: number;
+  /** Original alpha bi-level node, including foreign attributes. */
+  alphaBiLevelRawXml?: XmlObject;
   /**
    * Colour replace (`a:clrRepl`) — replaces all colour information in an image
    * with the given solid colour. Stores the raw colour child to preserve scheme
@@ -2588,6 +2964,13 @@ declare module './shape-style' {
  * ```
  */
 type PptxMediaType = 'video' | 'audio' | 'unknown';
+type PptxMediaReferenceKind = 'audioCd' | 'wavAudioFile' | 'audioFile' | 'videoFile' | 'quickTimeFile';
+interface PptxAudioCdPosition {
+  track: number;
+  time?: number;
+  /** Original `st` or `end` node, retained for lossless edits. */
+  rawXml?: XmlObject;
+}
 /**
  * A named bookmark within a media clip timeline.
  *
@@ -2663,6 +3046,109 @@ interface MediaCaptionTrack {
   /** Whether this track is the default/active one. */
   isDefault?: boolean;
 }
+type PptxSmartArtConstraintRelationship = 'self' | 'ch' | 'des';
+type PptxSmartArtConstraintOperator = 'none' | 'equ' | 'gte' | 'lte';
+type PptxSmartArtConstraintPointType = 'all' | 'doc' | 'node' | 'norm' | 'nonNorm' | 'asst' | 'nonAsst' | 'parTrans' | 'pres' | 'sibTrans';
+interface PptxSmartArtConstraintTarget {
+  for?: PptxSmartArtConstraintRelationship;
+  forName?: string;
+  pointType?: PptxSmartArtConstraintPointType;
+}
+/** Editable DiagramML CT_Constraint. */
+interface PptxSmartArtConstraint extends PptxSmartArtConstraintTarget {
+  type: string;
+  referenceType?: string;
+  referenceFor?: PptxSmartArtConstraintRelationship;
+  referenceForName?: string;
+  referencePointType?: PptxSmartArtConstraintPointType;
+  operator?: PptxSmartArtConstraintOperator;
+  value?: number;
+  factor?: number;
+  /** Original constraint retained for foreign attributes and extension content. */
+  rawXml?: XmlObject;
+}
+/** Editable DiagramML CT_NumericRule. */
+interface PptxSmartArtNumericRule extends PptxSmartArtConstraintTarget {
+  type: string;
+  value?: number;
+  factor?: number;
+  max?: number;
+  /** Original rule retained for foreign attributes and extension content. */
+  rawXml?: XmlObject;
+}
+/** Typed, editable metadata from a DiagramML layout-definition part. */
+interface PptxSmartArtLocalizedText {
+  value: string;
+  language?: string;
+}
+interface PptxSmartArtLayoutCategory {
+  type: string;
+  priority: number;
+}
+interface PptxSmartArtAlgorithmParameter {
+  type: string;
+  value?: string;
+}
+/** Typed DiagramML CT_Algorithm data attached to a layout node. */
+interface PptxSmartArtLayoutAlgorithm {
+  type: string;
+  revision?: number;
+  parameters?: PptxSmartArtAlgorithmParameter[];
+}
+interface PptxSmartArtIteratorAttributes {
+  name?: string;
+  reference?: string;
+  axis?: string[];
+  pointTypes?: string[];
+  hideLastTransition?: boolean[];
+  start?: number[];
+  count?: number[];
+  step?: number[];
+}
+interface PptxSmartArtForEach extends PptxSmartArtIteratorAttributes {
+  rawXml?: XmlObject;
+}
+interface PptxSmartArtWhen extends PptxSmartArtIteratorAttributes {
+  function: string;
+  argument?: string;
+  operator: string;
+  value: string;
+  rawXml?: XmlObject;
+}
+interface PptxSmartArtChoose {
+  name?: string;
+  when: PptxSmartArtWhen[];
+  otherwise?: {
+    name?: string;
+    rawXml?: XmlObject;
+  } | null;
+  rawXml?: XmlObject;
+}
+/** Identity and ordering metadata from DiagramML CT_LayoutNode. */
+interface PptxSmartArtLayoutNode {
+  name?: string;
+  styleLabel?: string;
+  childOrder?: 'b' | 't';
+  moveWith?: string;
+  algorithm?: PptxSmartArtLayoutAlgorithm;
+  forEach?: PptxSmartArtForEach[];
+  choose?: PptxSmartArtChoose[];
+  constraints?: PptxSmartArtConstraint[];
+  rules?: PptxSmartArtNumericRule[];
+  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;
+  /** Original definition retained for constraint evaluation and foreign rules. */
+  rawXml?: XmlObject;
+}
 /**
  * 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
@@ -2695,6 +3181,54 @@ interface PptxSmartArtTextRun {
    * round-trip. Untyped XML, hence the loose record shape.
    */
   rPr?: Record<string, unknown>;
+  /** Resolved standard shape-text style derived from {@link rPr}. */
+  style?: TextStyle;
+  /** Raw run XML used to retain unmodelled extension children on save. */
+  rawXml?: Record<string, unknown>;
+  /** Original direct-child order, including unmodelled extension children. */
+  childOrder?: string[];
+}
+/** An ordered item within a SmartArt text paragraph. */
+type PptxSmartArtTextParagraphItem = {
+  kind: 'run';
+  run: PptxSmartArtTextRun;
+} | {
+  kind: 'break';
+  rPr?: Record<string, unknown>;
+  style?: TextStyle;
+  rawXml?: Record<string, unknown>;
+  childOrder?: string[];
+} | {
+  kind: 'field';
+  id?: string;
+  fieldType?: string;
+  text: string;
+  rPr?: Record<string, unknown>;
+  style?: TextStyle;
+  pPr?: Record<string, unknown>;
+  rawXml?: Record<string, unknown>;
+  childOrder?: string[];
+} | {
+  kind: 'tab';
+  rawXml?: Record<string, unknown>;
+  childOrder?: string[];
+} | {
+  kind: 'raw';
+  name: string;
+  value: unknown;
+};
+/** A complete `a:p` paragraph in a SmartArt data-model text body. */
+interface PptxSmartArtTextParagraph {
+  /** Paragraph properties (`a:pPr`) preserved verbatim. */
+  pPr?: Record<string, unknown>;
+  /** Text children in source order. */
+  items: PptxSmartArtTextParagraphItem[];
+  /** End-paragraph run properties (`a:endParaRPr`) preserved verbatim. */
+  endParaRPr?: Record<string, unknown>;
+  /** Resolved style for the paragraph terminator. */
+  endParaStyle?: TextStyle;
+  /** Raw paragraph XML used to retain unmodelled extension children on save. */
+  rawXml?: Record<string, unknown>;
 }
 /**
  * Per-node visual override for a SmartArt node.
@@ -2750,6 +3284,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"). */
@@ -2762,6 +3298,11 @@ interface PptxSmartArtNode {
    * is not flattened. When {@link text} diverges, the runs are ignored.
    */
   runs?: PptxSmartArtTextRun[];
+  /**
+   * Complete typed paragraph model. Unlike {@link runs}, this retains every
+   * paragraph and the ordered run, field, break, and tab children within it.
+   */
+  paragraphs?: PptxSmartArtTextParagraph[];
   /**
    * Optional per-node visual override (fill / line / font colour, bold /
    * italic). Read at parse time from the point's `spPr` / first-run `rPr`, set
@@ -2770,6 +3311,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 +3429,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 +3441,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`.
@@ -2857,7 +3463,7 @@ interface PptxSmartArtConnection {
  * // => satisfies PptxSmartArtDrawingShape
  * ```
  */
-interface PptxSmartArtDrawingShape {
+interface PptxSmartArtDrawingShape extends PptxCustomPathProperties {
   /** Shape ID within the drawing. */
   id: string;
   /** Preset geometry type (e.g. "roundRect", "ellipse"). */
@@ -2881,6 +3487,8 @@ interface PptxSmartArtDrawingShape {
   strokeWidth?: number;
   /** Text content of the shape. */
   text?: string;
+  /** Standard rich-text segments projected from the associated SmartArt node. */
+  textSegments?: TextSegment[];
   /** Font size in points. */
   fontSize?: number;
   /** Font colour (hex). */
@@ -2907,45 +3515,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 +3554,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 +4182,13 @@ interface MediaPptxElement extends PptxElementBase {
   mediaPath?: string;
   mediaData?: string;
   mediaMimeType?: string;
+  mediaReferenceKind?: PptxMediaReferenceKind;
+  mediaReferenceName?: string;
+  /** Explicit DrawingML `audioFile/@contentType` value when present. */
+  mediaReferenceContentType?: 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). */
@@ -3719,6 +4309,10 @@ interface ContentPartPptxElement extends PptxElementBase {
   type: 'contentPart';
   /** Ink strokes contained in this content part. */
   inkStrokes?: ContentPartInkStroke[];
+  /** Package path of the related InkML part. */
+  inkPartPath?: string;
+  /** Parsed InkML root retained for unknown-node preservation on dirty save. */
+  inkPartRawXml?: XmlObject;
 }
 /**
  * A Slide Zoom or Section Zoom element (PowerPoint Zoom Object).
@@ -3739,12 +4333,32 @@ interface ContentPartPptxElement extends PptxElementBase {
  */
 interface ZoomPptxElement extends PptxElementBase, PptxImageProperties {
   type: 'zoom';
-  /** Type of zoom: slide-level or section-level. */
-  zoomType: 'slide' | 'section';
+  /** Type of zoom: slide-level, section-level, or a multi-section summary. */
+  zoomType: 'slide' | 'section' | 'summary';
   /** Zero-based index of the target slide. */
   targetSlideIndex: number;
   /** Section ID for section zoom. */
   targetSectionId?: string;
+  /** Ordered section tiles in a Summary Zoom container. */
+  summaryTargets?: SummaryZoomTarget[];
+  /** Layout mode authored on the Summary Zoom container. */
+  summaryLayout?: 'grid' | 'fixed';
+}
+/** A single section tile within a PowerPoint Summary Zoom container. */
+interface SummaryZoomTarget extends PptxImageProperties {
+  sectionId: string;
+  targetSlideIndex: number;
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+  title?: string;
+  description?: string;
+  offsetFactorX?: number;
+  offsetFactorY?: number;
+  scaleFactorX?: number;
+  scaleFactorY?: number;
+  rawXml?: XmlObject;
 }
 /**
  * A 3D model object embedded via `p16:model3D` inside an
@@ -3852,6 +4466,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 +4643,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 +4702,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 +4808,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 +4926,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 {
@@ -4337,6 +5005,32 @@ interface PptxElementAnimation {
   /** Whether to stop any currently playing sound (`p:endSnd`). */
   stopSound?: boolean;
 }
+interface PptxEmbeddedFontDataId {
+  /** Required relationship identifier from `r:id`. */
+  relationshipId?: string | null;
+  /** Original leaf retained for unknown attribute preservation. */
+  rawXml?: XmlObject;
+}
+interface PptxEmbeddedFontDescriptor {
+  typeface?: string | null;
+  panose?: string | null;
+  pitchFamily?: string | null;
+  charset?: string | null;
+  rawXml?: XmlObject;
+}
+interface PptxEmbeddedFontListEntry {
+  font: PptxEmbeddedFontDescriptor;
+  regular?: PptxEmbeddedFontDataId | null;
+  bold?: PptxEmbeddedFontDataId | null;
+  italic?: PptxEmbeddedFontDataId | null;
+  boldItalic?: PptxEmbeddedFontDataId | null;
+  rawXml?: XmlObject;
+}
+interface PptxEmbeddedFontList {
+  fonts: PptxEmbeddedFontListEntry[];
+  /** Original list retained for unknown attribute and child preservation. */
+  rawXml?: XmlObject;
+}
 /**
  * Metadata types: slide comments, compatibility warnings, tags,
  * custom properties, core/app document properties.
@@ -4362,6 +5056,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 +5068,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 +5129,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
@@ -4462,9 +5185,17 @@ interface PptxTag {
  */
 interface PptxTagCollection {
   /** File path within the PPTX archive. */
-  path: string;
+  path?: string;
+  /** Package owner of the tags relationship. New collections default to presentation. */
+  owner?: 'presentation' | 'slide' | 'part';
+  /** Source OPC part that owns the relationship, e.g. ppt/slides/slide1.xml. */
+  sourcePartPath?: string;
+  /** Durable relationship identifier from the owning part. */
+  relationshipId?: string;
   /** Tags in this collection. */
   tags: PptxTag[];
+  /** Parsed tag-list XML retained for unknown-node preservation. */
+  rawXml?: XmlObject;
 }
 /**
  * A custom document property from `docProps/custom.xml`.
@@ -4569,6 +5300,18 @@ interface PptxAppProperties {
   /** Hyperlink base URL. */
   hyperlinkBase?: string;
 }
+type PptxPrintOutput = 'slides' | 'handouts1' | 'handouts2' | 'handouts3' | 'handouts4' | 'handouts6' | 'handouts9' | 'notes' | 'outline';
+type PptxPrintColorMode = 'bw' | 'gray' | 'clr';
+/** PresentationML `CT_PrintProperties` (`p:prnPr`). */
+interface PptxPresentationPrintProperties {
+  printWhat?: PptxPrintOutput | null;
+  colorMode?: PptxPrintColorMode | null;
+  hiddenSlides?: boolean | null;
+  scaleToFitPaper?: boolean | null;
+  frameSlides?: boolean | null;
+  /** Original subtree retained for unknown attributes and `p:extLst`. */
+  rawXml?: XmlObject;
+}
 /**
  * Resolved hex values for the 12 theme colour slots.
  *
@@ -4853,6 +5596,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 +5614,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 +5630,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 +5647,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`.
@@ -4914,6 +5667,11 @@ interface PptxViewScale {
   n: number;
   /** Denominator of the scale percentage (e.g. 100 for 100%). */
   d: number;
+  /** Optional independent vertical scale. When absent, the X scale is used. */
+  sy?: {
+    n: number;
+    d: number;
+  };
 }
 /**
  * Origin point for a view (x, y in twips or EMU).
@@ -4922,6 +5680,16 @@ interface PptxViewOrigin {
   x: number;
   y: number;
 }
+/** A horizontal or vertical drawing guide in slide coordinates. */
+interface PptxViewGuide {
+  orientation?: 'horz' | 'vert';
+  position?: number;
+}
+/** Positive grid spacing from `p:gridSpacing`. */
+interface PptxGridSpacing {
+  cx: number;
+  cy: number;
+}
 /**
  * Restored region dimensions for normal view splitter.
  * Represents `p:restoredLeft` or `p:restoredTop`.
@@ -4963,6 +5731,10 @@ interface PptxCommonSlideViewProperties {
   snapToObjects?: boolean;
   /** Whether drawing guides are shown. */
   showGuides?: boolean;
+  /** Whether the application may vary the scale automatically. */
+  variableScale?: boolean;
+  /** Drawing guides shown in this slide view. */
+  guides?: PptxViewGuide[];
   /** View origin (scroll position). */
   origin?: PptxViewOrigin;
   /** View scale. */
@@ -4990,6 +5762,8 @@ interface PptxViewProperties {
   };
   /** Notes view properties. */
   notesViewPr?: PptxCommonSlideViewProperties;
+  /** Grid spacing in positive DrawingML coordinates. */
+  gridSpacing?: PptxGridSpacing;
   /** Raw XML preserved for lossless round-trip of unparsed attributes. */
   rawXml?: Record<string, unknown>;
 }
@@ -5003,12 +5777,16 @@ interface PptxViewProperties {
  * @see ECMA-376 Part 1, §19.2.1.3 (custDataLst), §19.3.1.6 (custData)
  */
 interface PptxCustomerData {
-  /** Resolved part path inside the package (e.g. `ppt/customerData/item1.xml`). */
-  id: string;
+  /** Resolved part path inside the package (e.g. `customXml/item1.xml`). */
+  id?: string;
   /** Relationship ID referencing the custom data part. */
-  relId: string;
+  relId?: string;
   /** Raw string content of the custom data part (if resolvable). */
   data?: string;
+  /** OPC content type for the custom data part. */
+  contentType?: string;
+  /** Raw `p:custData` XML retained for unknown-node preservation. */
+  rawXml?: XmlObject;
 }
 /**
  * An ActiveX control reference from `p:controls / p:control`.
@@ -5133,6 +5911,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 +5931,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.
@@ -5237,11 +6035,13 @@ interface PptxPresentationProperties {
   showSlidesTo?: number;
   /** Whether to show subtitles/captions during presentation mode. */
   showSubtitles?: boolean;
-  /** Print settings: slides per page. */
+  /** Typed `p:prnPr` settings. Set to null during save to remove the element. */
+  printProperties?: PptxPresentationPrintProperties | null;
+  /** @deprecated Use `printProperties.printWhat`; retained as a handout compatibility alias. */
   printSlidesPerPage?: number;
-  /** Print settings: frame slides. */
+  /** @deprecated Use `printProperties.frameSlides`. */
   printFrameSlides?: boolean;
-  /** Print settings: colour mode (from `p:prnPr/@clrMode`). */
+  /** @deprecated Use `printProperties.colorMode`. */
   printColorMode?: 'clr' | 'gray' | 'bw';
   /** Most-recently-used colours from the presentation palette. */
   mruColors?: string[];
@@ -5278,6 +6078,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 +6108,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`.
@@ -5374,11 +6178,13 @@ interface PptxPhotoAlbum {
  */
 interface PptxKinsoku {
   /** Language code (e.g. "ja-JP", "zh-CN"). */
-  lang?: string;
+  lang?: string | null;
   /** Characters that cannot begin a line. */
   invalStChars?: string;
   /** Characters that cannot end a line. */
   invalEndChars?: string;
+  /** Original leaf retained for unknown attribute preservation. */
+  rawXml?: XmlObject;
 }
 /**
  * Root data structure returned by {@link PptxHandlerCore.load}.
@@ -5429,6 +6235,8 @@ interface PptxData {
   isPasswordProtected?: boolean;
   /** Embedded font data (name + binary data URL) extracted from the presentation. */
   embeddedFonts?: PptxEmbeddedFont[];
+  /** Typed `p:embeddedFontLst` package metadata, including unresolved variants. */
+  embeddedFontList?: PptxEmbeddedFontList;
   /** Most-recently-used colour list from presentation properties. */
   mruColors?: string[];
   /** Parsed notes master data if present in the PPTX. */
@@ -5469,6 +6277,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)
@@ -5585,6 +6395,30 @@ interface PptxEmbeddedFont {
   originalPartBytes?: Uint8Array;
 }
 //#endregion
+//#region ../core/dist/SvgExporter-CxE3LpEi.d.ts
+/**
+ * Headless SVG exporter — converts parsed {@link PptxSlide} data to
+ * SVG XML strings without requiring a browser DOM.
+ *
+ * All output is generated via string concatenation so the exporter
+ * works in any JavaScript runtime (Node, Bun, Deno, Workers, etc.).
+ *
+ * @module converter/SvgExporter
+ */
+/**
+ * Options controlling SVG export behaviour.
+ */
+interface SvgExportOptions {
+  /** Include hidden slides when exporting all. Default `false`. */
+  includeHidden?: boolean;
+  /** Slide indices to export (0-based). If omitted, all slides are exported. */
+  slideIndices?: number[];
+  /** Default font family when the element does not specify one. */
+  defaultFontFamily?: string;
+  /** Default font size in points when the element does not specify one. */
+  defaultFontSize?: number;
+}
+//#endregion
 //#region ../core/dist/index.d.ts
 /**
  * Built-in theme presets modelled after common PowerPoint themes.
@@ -5758,10 +6592,17 @@ interface ChartSeriesInput {
   name: string;
   values: number[];
   color?: string;
+  boxWhiskerOptions?: PptxChartBoxWhiskerOptions;
+  histogramOptions?: PptxChartHistogramOptions;
+  waterfallOptions?: PptxChartWaterfallOptions;
+  regionMapOptions?: PptxChartRegionMapOptions;
+  treemapOptions?: PptxChartTreemapOptions;
 }
 interface ChartInput {
   series: ChartSeriesInput[];
   categories: string[];
+  /** ChartEx hierarchy levels in leaf-to-root XML order. */
+  categoryLevels?: string[][];
   title?: string;
   hasLegend?: boolean;
   legendPosition?: 't' | 'b' | 'l' | 'r' | 'tr';
@@ -6267,10 +7108,12 @@ interface PptxHandlerSaveOptions {
   slideLayouts?: PptxSlideLayout[];
   /** Updated tag collections to save back to ppt/tags/tag*.xml. */
   tags?: PptxTagCollection[];
+  /** Presentation-level customer data references to author or update. */
+  customerData?: PptxCustomerData[];
   /** Photo album metadata to save back to `p:photoAlbum`. */
   photoAlbum?: PptxPhotoAlbum;
   /** East Asian line-break settings to save back to `p:kinsoku`. */
-  kinsoku?: PptxKinsoku;
+  kinsoku?: PptxKinsoku | null;
   /** Write-protection verifier. Set to `null` to remove, `undefined` to preserve existing. */
   modifyVerifier?: PptxModifyVerifier | null;
   /** View properties to save back to ppt/viewProps.xml. */
@@ -6302,6 +7145,8 @@ interface PptxHandlerSaveOptions {
    * preserved (i.e. the default is lossless round-trip).
    */
   embeddedFonts?: PptxEmbeddedFont[];
+  /** Typed embedded-font list metadata. Set to null to remove fonts and relationships. */
+  embeddedFontList?: PptxEmbeddedFontList | null;
   /**
    * OOXML conformance class for the saved output.
    * - `'preserve'` (default): use the same conformance as the loaded file.
@@ -7064,6 +7909,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 +8017,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 +8050,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).
    *
@@ -7178,6 +8128,53 @@ type AnimationGroup = 'entrance' | 'emphasis' | 'exit';
  */
 /** Edge / centre that {@link alignElements} can snap a selection to. */
 type AlignEdge = 'left' | 'centerH' | 'right' | 'top' | 'middle' | 'bottom';
+/**
+ * Text-field placeholder substitution, shared by every binding's text
+ * renderer.
+ *
+ * Pure string logic: resolves OOXML field runs (slide number, date/time,
+ * header/footer, document properties, slide title) into their display text.
+ * Extracted from the React `viewer/utils/text-field-substitution` module so
+ * every binding substitutes identically.
+ */
+/** Context for substituting field placeholders (slide number, date/time, header/footer, etc.). */
+interface FieldSubstitutionContext {
+  slideNumber?: number;
+  dateTimeText?: string;
+  /** OOXML date-format pattern from header/footer settings (e.g. "M/d/yyyy"). */
+  dateFormat?: string;
+  /** Footer text from PptxHeaderFooter settings. */
+  footerText?: string;
+  /** Header text from PptxHeaderFooter settings. */
+  headerText?: string;
+  /** Custom document properties for `docproperty` field substitution (keyed by property name). */
+  customProperties?: ReadonlyArray<{
+    name: string;
+    value: string;
+  }>;
+  /** Locale string for date/time formatting (e.g. "en-US"). Falls back to browser default. */
+  locale?: string;
+  /** Title text extracted from the first title placeholder on the slide. */
+  slideTitle?: string;
+}
+/**
+ * Changes to apply to textStyle from the advanced panel.
+ * Every key maps 1-to-1 to TextStyle fields.
+ */
+type TextAdvancedChanges = Partial<Pick<TextStyle, 'characterSpacing' | 'lineSpacing' | 'lineSpacingExactPt' | 'paragraphSpacingBefore' | 'paragraphSpacingAfter' | 'align' | 'vAlign' | 'paragraphIndent' | 'paragraphMarginLeft' | 'textDirection' | 'rtl'>>;
+/**
+ * Utilities for reading and restoring text selections within the inline text
+ * editor contentEditable, and for applying style updates to a subset of text
+ * segments based on the current selection. Framework-agnostic (uses DOM globals
+ * only; no framework imports).
+ */
+/** Describes which segments (and offsets within them) are selected. */
+interface InlineTextSelection {
+  startSegIdx: number;
+  startOffset: number;
+  endSegIdx: number;
+  endOffset: number;
+}
 /**
  * "Change Case" text mutation (PowerPoint's Aa dropdown: Sentence case, lower,
  * UPPER, Capitalize Each Word, tOGGLE cASE). Unlike `textCaps` (a purely
@@ -7241,6 +8238,33 @@ 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>;
+/**
+ * alignment-guides.ts: pure helpers for the View > H/V Guides feature
+ * (draggable alignment guides), shared across bindings. Framework-free so it
+ * unit-tests in isolation.
+ *
+ * Distinct from `snap-guides.ts`, which computes snap geometry while dragging;
+ * this module owns the persistent guide list CRUD (`Guide` carries an `id`).
+ */
+/** A single alignment guide, positioned in authored slide pixels. */
+interface Guide {
+  id: string;
+  axis: 'h' | 'v';
+  position: number;
+}
 /**
  * Pure, framework-agnostic helpers for freehand ink drawing, shared by every
  * binding. No framework imports, so these can be unit-tested without TestBed.
@@ -7397,10 +8421,33 @@ type DrawTool = 'select' | 'pen' | 'highlighter' | 'eraser';
 interface ViewerState {
   /** Parsed slides (image/media URLs already patched in by the load pipeline). */
   slides: PptxSlide[];
+  /** Presentation sections used to group slides in the thumbnail rail. */
+  sections: PptxSection[];
+  presentationProperties: PptxPresentationProperties;
+  headerFooter: PptxHeaderFooter;
+  coreProperties?: PptxCoreProperties;
+  appProperties?: PptxAppProperties;
+  customProperties: PptxCustomProperty[];
+  customShows: PptxCustomShow[];
+  embeddedFonts: PptxEmbeddedFont[];
+  hasDigitalSignatures: boolean;
+  digitalSignatureCount: number;
+  isPasswordProtected: boolean;
   /** Inherited layout/master elements, separated so interaction can be gated. */
   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;
+  /** Whether the loaded package contains a VBA project. */
+  hasMacros: boolean;
+  /** 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;
@@ -7430,6 +8477,18 @@ interface ViewerState {
   selectedElementId: string | null;
   /** All selected top-level element ids; the primary selection is listed last. */
   selectedElementIds: string[];
+  /** Active table cell for cell-scoped inspector formatting. */
+  selectedTableCell: {
+    row: number;
+    column: number;
+  } | null;
+  /** Shift-select range of active table cells, including the anchor. */
+  selectedTableCells: Array<{
+    row: number;
+    column: number;
+  }>;
+  /** Active rich-text range captured from the inline editor. */
+  selectedTextRange: InlineTextSelection | null;
   /** Source element id while the one-shot Format Painter is armed. */
   formatPainterSourceId: string | null;
   /** When true, selection and element mutations target inherited template elements. */
@@ -7460,6 +8519,13 @@ interface ViewerState {
   drawColor: string;
   /** Stroke width (px) for the pen/highlighter tools. */
   drawWidth: number;
+  showGrid: boolean;
+  showRulers: boolean;
+  snapToGrid: boolean;
+  snapToShape: boolean;
+  guides: Guide[];
+  eyedropperActive: boolean;
+  spellCheckEnabled: boolean;
 }
 //#endregion
 //#region src/viewer/editor/editor-animation-actions.d.ts
@@ -7479,6 +8545,19 @@ interface ViewerState {
 interface AnimationActions {
   addAnimation(group: AnimationGroup, preset: PptxAnimationPreset): void;
   removeAnimation(): void;
+  setAnimationTiming(elementId: string, patch: {
+    durationMs?: number;
+    delayMs?: number;
+    trigger?: PptxAnimationTrigger;
+    direction?: PptxAnimationDirection;
+    sequence?: PptxAnimationSequence;
+    timingCurve?: PptxAnimationTimingCurve;
+    repeatCount?: number;
+    repeatMode?: PptxAnimationRepeatMode | 'none';
+    triggerShapeId?: string;
+  }): void;
+  reorderAnimation(elementId: string, direction: 'up' | 'down'): void;
+  moveAnimation(elementId: string, index: number): void;
 }
 //#endregion
 //#region src/viewer/editor/editor-arrange-actions.d.ts
@@ -7486,20 +8565,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;
@@ -7589,6 +8657,13 @@ interface InkActions {
 /** The element kinds the Insert ribbon tab can create directly. */
 type InsertKind = 'text' | 'table' | 'shape';
 //#endregion
+//#region src/viewer/editor/table-editor-mutations.d.ts
+interface TableCellPosition {
+  row: number;
+  column: number;
+}
+type TableStructureAction = 'insertRowAbove' | 'insertRowBelow' | 'deleteRow' | 'insertColumnLeft' | 'insertColumnRight' | 'deleteColumn';
+//#endregion
 //#region src/viewer/editor/editor-inspector-actions.d.ts
 /**
  * Element-type-aware inspector actions: text vertical-align/wrap/autofit,
@@ -7597,14 +8672,14 @@ type InsertKind = 'text' | 'table' | 'shape';
  * thin `applyToSelected` wrapper around pure builders from `pptx-viewer-shared`
  * (or the local `patchShapeStyle`), mirroring `editor-text-actions.ts`.
  *
- * These extend the base position/size/rotation + flat fill/stroke inspector
- * that `editor-edit-ops.ts` already exposes; see `ui/inspector/` for the
- * per-element-type panels that call these.
+ * The corresponding panels live under `ui/inspector/`.
  */
 interface InspectorActions {
   setTextVerticalAlign(vAlign: NonNullable<TextStyle['vAlign']>): void;
   setTextWrap(wrap: NonNullable<TextStyle['textWrap']>): void;
   setAutoFitMode(mode: NonNullable<TextStyle['autoFitMode']>): void;
+  setTextAdvanced(patch: TextAdvancedChanges): void;
+  setTextStyle(patch: Partial<TextStyle>, selection?: InlineTextSelection | null): void;
   setFillOpacity(opacity: number): void;
   setStrokeOpacity(opacity: number): void;
   setGradientFill(state: GradientState): void;
@@ -7615,14 +8690,39 @@ interface InspectorActions {
   setImageContrast(value: number): void;
   setImageSaturation(value: number): void;
   setImageCrop(edge: 'left' | 'top' | 'right' | 'bottom', value: number): void;
+  setImageEffects(patch: Partial<PptxImageEffects>): void;
+  setElementAction(trigger: 'click' | 'hover', action: ElementAction): void;
+  setChartData(data: PptxChartData): void;
+  setMediaProperties(patch: Partial<MediaPptxElement>): void;
   setTableHeaderRow(enabled: boolean): void;
   setTableBandedRows(enabled: boolean): void;
   setTableCellPadding(padding: number): void;
+  setTableOptions(patch: Partial<PptxTableData>, cellStyle?: Partial<PptxTableCellStyle>): void;
+  setTableCellStyle(row: number, column: number, patch: Partial<PptxTableCellStyle>): void;
+  setTableCellStyles(cells: TableCellPosition[], patch: Partial<PptxTableCellStyle>): void;
+  mutateTableStructure(cell: TableCellPosition, action: TableStructureAction): void;
+  setTableColumnWidth(column: number, percent: number): void;
+  setTableRowHeight(row: number, height: number): void;
+  mergeTableCells(cells: TableCellPosition[]): void;
+  splitTableCell(cell: TableCellPosition): void;
   setSmartArtNodeText(nodeId: string, text: string): void;
+  setSmartArtNodeStyle(nodeId: string, patch: Partial<PptxSmartArtNodeStyle>): void;
+  mutateSmartArtNode(nodeId: string, action: 'add' | 'addChild' | 'remove' | 'promote' | 'demote'): void;
   setSmartArtLayout(layout: SmartArtLayoutType): void;
   setSmartArtColorScheme(scheme: SmartArtColorScheme): void;
 }
 //#endregion
+//#region src/viewer/editor/editor-section-actions.d.ts
+/** History-aware slide section actions exposed to the rail and Home ribbon. */
+interface SectionActions {
+  addSection(name: string, afterSlideIndex?: number): string | null;
+  renameSection(sectionId: string, name: string): void;
+  deleteSection(sectionId: string): void;
+  moveSection(sectionId: string, direction: 'up' | 'down'): void;
+  moveSlidesToSection(slideIndexes: number[], targetSectionId: string): void;
+  toggleSection(sectionId: string): void;
+}
+//#endregion
 //#region src/viewer/editor/editor-slide-actions.d.ts
 /**
  * New/duplicate/delete-slide actions for the ribbon's Home > Slides group,
@@ -7704,11 +8804,15 @@ interface GeometryPatch {
  * -> commit) via the shared {@link EditorOps}.
  */
 interface EditActions extends TextActions, ArrangeActions, ClipboardActions, SlideActions, SlideBackgroundActions, TransitionActions, AnimationActions, InspectorActions, InkActions {
+  /** Slide section CRUD and ordering actions. */
+  sections: SectionActions;
   comments: CommentActions;
   toggleFormatPainter(): void;
   setShapeFill(color: string): void;
   setShapeStroke(color: string): void;
   setShapeStrokeWidth(width: number): void;
+  setShapeStyle(patch: Partial<ShapeStyle>): void;
+  setShapeType(shapeType: string): void;
   /** Commit an inspector geometry edit (X/Y/W/H/rotation). */
   setGeometry(patch: GeometryPatch): void;
   insert(kind: InsertKind, shapeType?: ShapePresetType): void;
@@ -7722,6 +8826,12 @@ interface EditActions extends TextActions, ArrangeActions, ClipboardActions, Sli
   insertField(fieldType: string, value?: string): void;
   duplicateSelected(): void;
   deleteSelected(): void;
+  toggleViewOption(option: 'showGrid' | 'showRulers' | 'snapToGrid' | 'snapToShape'): void;
+  addGuide(axis: Guide['axis']): void;
+  activateEyedropper(): void;
+  toggleSpellCheck(): void;
+  replaceSelectedImage(): Promise<void>;
+  resetSelectedImage(): void;
 }
 //#endregion
 //#region src/viewer/editor/editor-find-replace-actions.d.ts
@@ -7781,6 +8891,8 @@ interface InspectorState {
   canShape: boolean;
   canText: boolean;
   isImage: boolean;
+  isChart: boolean;
+  isMedia: boolean;
   isTable: boolean;
   isSmartArt: boolean;
   smartArtData: PptxSmartArtData | undefined;
@@ -7792,6 +8904,9 @@ interface InspectorState {
   fillColor: string | undefined;
   strokeColor: string | undefined;
   strokeWidth: number;
+  shapeStyle: ShapeStyle | undefined;
+  shapeType: string | undefined;
+  isConnector: boolean;
   fillOpacity: number;
   strokeOpacity: number;
   gradientEnabled: boolean;
@@ -7799,16 +8914,61 @@ interface InspectorState {
   vAlign: 'top' | 'middle' | 'bottom';
   textWrap: 'square' | 'none';
   autoFitMode: 'shrink' | 'normal' | 'none';
+  characterSpacing: number;
+  lineSpacing: number;
+  lineSpacingExactPt: number | null;
+  paragraphSpacingBefore: number;
+  paragraphSpacingAfter: number;
+  paragraphIndent: number;
+  paragraphMarginLeft: number;
+  textDirection: 'horizontal' | 'vertical' | 'vertical270' | 'eaVert' | 'wordArtVert' | 'wordArtVertRtl' | 'mongolianVert';
+  textRtl: boolean;
+  textStyle: TextStyle | undefined;
+  selectedTextRange: InlineTextSelection | null;
   imageBrightness: number;
   imageContrast: number;
   imageSaturation: number;
+  imageArtisticEffect: string;
+  imageTransparency: number;
+  imageBiLevel: number;
+  imageDuotone1: string;
+  imageDuotone2: string;
+  imageColorWash?: {
+    color: string;
+    opacity: number;
+  };
+  actionClick?: ElementAction;
+  actionHover?: ElementAction;
+  chartData?: PptxChartData;
+  media?: MediaPptxElement;
+  mediaPreviewUrl?: string;
+  mediaPosterUrl?: string;
   cropLeft: number;
   cropTop: number;
   cropRight: number;
   cropBottom: number;
   tableHeaderRow: boolean;
   tableBandedRows: boolean;
+  tableBandedColumns: boolean;
+  tableLastRow: boolean;
+  tableFirstCol: boolean;
+  tableLastCol: boolean;
+  tableRtl: boolean;
+  tableStyleId: string;
+  tableCellBackground: string;
+  tableCellBorder: string;
   tableCellPadding: number;
+  selectedTableCell: {
+    row: number;
+    column: number;
+  } | null;
+  selectedTableCells: Array<{
+    row: number;
+    column: number;
+  }>;
+  tableCellStyle: PptxTableCellStyle | undefined;
+  tableColumnWidths: number[];
+  tableRowHeights: number[];
 }
 interface Inspector {
   el: HTMLElement;
@@ -7816,6 +8976,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 {
@@ -7841,6 +9036,8 @@ interface RibbonSelectionState {
   slideCount: number;
   selectedCount?: number;
   formatPainterActive?: boolean;
+  selectedElementId?: string;
+  animations?: readonly PptxElementAnimation[];
 }
 //#endregion
 //#region src/viewer/ui/mobile-action-sheets.d.ts
@@ -7898,6 +9095,8 @@ interface Ribbon {
   /** Reflect the current Draw tab tool/colour/width (store-driven). */
   setDrawState(state: RibbonDrawState): void;
   setTemplateEditing(active: boolean): void;
+  setHasMacros(hasMacros: boolean): void;
+  setSubtitlesVisible(visible: boolean): void;
   openEquationEditor(id: string, omml: Record<string, unknown>): void;
 }
 //#endregion
@@ -7915,11 +9114,19 @@ interface StatusBar {
   setDirty(dirty: boolean): void;
 }
 //#endregion
+//#region src/viewer/ui/thumbnail-sections.d.ts
+interface ThumbnailSectionActions {
+  toggle(sectionId: string): void;
+  rename(sectionId: string, name: string): void;
+  delete(sectionId: string): void;
+  move(sectionId: string, direction: 'up' | 'down'): void;
+}
+//#endregion
 //#region src/viewer/ui/thumbnails.d.ts
 interface ThumbnailRail {
   el: HTMLElement;
   /** Rebuild the rail for a new slide list (uses `renderStage` per slide). */
-  render(slides: PptxSlide[], canvasSize: CanvasSize, renderStage: (slide: PptxSlide, scale: number) => HTMLElement): void;
+  render(slides: PptxSlide[], canvasSize: CanvasSize, renderStage: (slide: PptxSlide, scale: number) => HTMLElement, sections?: readonly PptxSection[], sectionActions?: ThumbnailSectionActions): void;
   /** Highlight the active slide and scroll it into view. */
   setActive(index: number): void;
   /** Show or hide the rail. */
@@ -7958,6 +9165,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 +9218,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,7 +9232,14 @@ interface EditorController {
   /** The Find & Replace actions for the ribbon's docked panel. */
   getFindReplaceActions(): FindReplaceActions;
   commitNotes(notes: string, notesSegments?: TextSegment[]): void;
-  save(): Promise<Uint8Array>;
+  setHandoutSlidesPerPage(count: number): void;
+  updateDocumentProperties(core: PptxCoreProperties, app: PptxAppProperties, custom: PptxCustomProperty[]): void;
+  updatePresentationProperties(value: PptxPresentationProperties): void;
+  updateHeaderFooter(value: PptxHeaderFooter): void;
+  updateCustomShows(value: PptxCustomShow[]): void;
+  save(format?: PptxSaveFormat): Promise<Uint8Array>;
+  downloadAs(format: PptxSaveFormat, fileName?: string): Promise<void>;
+  packageForSharing(fileName?: string): Promise<void>;
   downloadPptx(fileName?: string): Promise<void>;
   destroy(): void;
 }
@@ -8039,6 +9258,8 @@ interface SyncStageParams {
   slideIndex: number;
   /** True only when the live (fullscreen) presentation stage is active. */
   presenting: boolean;
+  /** Presentation-level switch parsed from `p:showPr`. */
+  showWithAnimation?: boolean;
 }
 /**
  * The presentation-mode playback state machine for the vanilla binding.
@@ -8086,6 +9307,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;
   /**
@@ -8100,6 +9327,7 @@ interface ElementRenderContext {
   readonly colorScheme?: PptxThemeColorScheme;
   /** Parsed `ppt/tableStyles.xml` definitions used by table band/header styling. */
   readonly tableStyleMap?: ParsedTableStyleMap;
+  readonly fieldContext?: FieldSubstitutionContext;
   /** Shared-dictionary translator (`pptx.*` keys). */
   readonly t: Translator;
   /**
@@ -8114,6 +9342,8 @@ interface ElementRenderContext {
    * slideshow behaviour. `false` for the editor canvas and thumbnail rail.
    */
   readonly presenting: boolean;
+  readonly onSmartArtNodeTextChange?: (element: PptxElement, nodeId: string, text: string) => void;
+  readonly onSmartArtNodeFillChange?: (element: PptxElement, nodeId: string, fill: string) => void;
   /** The registry in effect, for renderers that need to inspect it. */
   readonly registry: ElementRendererRegistry;
   /**
@@ -8191,6 +9421,7 @@ interface SlideStageOptions {
   colorScheme?: PptxThemeColorScheme;
   /** Optional parsed table-style definitions for theme-aware table rendering. */
   tableStyleMap?: ParsedTableStyleMap;
+  fieldContext?: FieldSubstitutionContext;
   registry: ElementRendererRegistry;
   t: Translator;
   /** Scale applied via CSS transform (default 1). */
@@ -8199,6 +9430,12 @@ 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;
+  onSmartArtNodeTextChange?: (element: PptxElement, nodeId: string, text: string) => void;
+  onSmartArtNodeFillChange?: (element: PptxElement, nodeId: string, fill: string) => void;
   /**
    * True only for the main (interactive) canvas, never the thumbnail rail.
    * Marks every rendered element (recursively, including group children) with
@@ -8226,10 +9463,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
@@ -8395,6 +9631,12 @@ interface ExportPdfOptions {
   signal?: AbortSignal;
 }
 //#endregion
+//#region src/viewer/export/export-svg.d.ts
+/** Export one parsed slide as resolution-independent SVG markup. */
+declare function exportSlideToSvg(slide: PptxSlide, width: number, height: number, options?: SvgExportOptions): string;
+/** Export the selected slides in a parsed presentation as SVG markup. */
+declare function exportAllSlidesToSvg(data: PptxData, options?: SvgExportOptions): string[];
+//#endregion
 //#region src/viewer/load/source.d.ts
 /**
  * Content sources accepted by the vanilla viewer: raw bytes, a Blob/File, or
@@ -8442,6 +9684,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 +9774,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 +9792,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;
@@ -8571,7 +9815,11 @@ interface PptxViewerInstance {
   canUndo(): boolean;
   canRedo(): boolean;
   /** Serialise the (edited) presentation to `.pptx` bytes and clear dirty. */
-  save(): Promise<Uint8Array>;
+  save(format?: PptxSaveFormat): Promise<Uint8Array>;
+  /** Save and download a presentation in a supported OpenXML format. */
+  downloadAs(format: PptxSaveFormat, fileName?: string): Promise<void>;
+  /** Bundle the current presentation and usage notes in a shareable ZIP. */
+  packageForSharing(fileName?: string): Promise<void>;
   /** `save()` + trigger a browser download (default `presentation.pptx`). */
   downloadPptx(fileName?: string): Promise<void>;
   /** Delete the selected element (no-op without a selection). */
@@ -8584,6 +9832,8 @@ interface PptxViewerInstance {
    * (dynamically imported), so the first call pays a one-time load cost.
    */
   exportSlidePng(index?: number): Promise<void>;
+  /** Copy a slide to the system clipboard as a PNG image. */
+  copySlideAsImage(index?: number): Promise<void>;
   /**
    * Export every slide as a multi-page PDF download (one slide per page).
    * `jspdf` is dynamically imported on first use.
@@ -8673,21 +9923,47 @@ interface ChromeHost {
   redo(): void;
   toggleAutosave(): boolean;
   downloadPptx(): Promise<void>;
+  downloadAs(format: PptxSaveFormat): Promise<void>;
+  packageForSharing(): Promise<void>;
   toggleNotes(): void;
   goToSlide(index: number): void;
   getSlideCount(): number;
   enterPresentation(): Promise<void>;
+  openPresenterView(): void;
   exitPresentation(): Promise<void>;
   openBroadcast(): void;
+  openShare(): void;
   openAccessibility(): void;
+  openSettings(tab?: 'general' | 'shortcuts'): void;
+  openHeaderFooter(): void;
+  openCompare(): void;
+  openSetUpSlideShow(): void;
+  startRehearsal(): void;
+  toggleSubtitles(): void;
+  openSelectionPane(): void;
+  openSlideSorter(): void;
+  openComments(): void;
+  openHyperlink(): void;
+  openCustomShows(): void;
+  openDocumentProperties(): void;
+  openFontEmbedding(): void;
+  openDigitalSignatures(): void;
+  openPasswordProtection(): void;
+  openVersionHistory(): void;
   toggleTemplateEditing(): void;
   toggleMasterNavigation(): void;
   exportSlidePng(): Promise<void>;
+  copySlideAsImage(): Promise<void>;
   exportPdf(): Promise<void>;
   exportGif(): Promise<void>;
   exportVideo(): Promise<void>;
   print(): Promise<boolean>;
+  openPrintDialog(): void;
+  openFile(): void;
+  openRecentFile(key: string): void;
+  createPresentation(templateId: string): void;
   setTheme(theme: ViewerTheme | undefined): void;
+  applyPresentationTheme(presetId: string): void;
 }
 //#endregion
 //#region src/viewer/export-lifecycle.d.ts
@@ -8695,6 +9971,8 @@ interface ChromeHost {
 interface ViewerExportApi {
   /** Export a single slide as a PNG download. Defaults to the current slide. */
   exportSlidePng(index?: number): Promise<void>;
+  /** Copy a slide to the system clipboard as a PNG image. */
+  copySlideAsImage(index?: number): Promise<void>;
   /** Export every slide as a multi-page PDF download (one slide per page). */
   exportPdf(options?: ExportPdfOptions): Promise<void>;
   /** Export every slide as an animated GIF download (one frame per slide). */
@@ -8717,6 +9995,7 @@ interface ExportLifecycle extends ViewerExportApi {
 declare abstract class ViewerExportHost implements ViewerExportApi {
   protected abstract readonly exporter: ExportLifecycle;
   exportSlidePng(index?: number): Promise<void>;
+  copySlideAsImage(index?: number): Promise<void>;
   exportPdf(options?: ExportPdfOptions): Promise<void>;
   exportGif(options?: ExportGifOptions): Promise<void>;
   exportVideo(options?: ExportVideoOptions): Promise<void>;
@@ -8744,8 +10023,23 @@ 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;
+  private embedFontsEnabled;
+  private signatureWarningAcknowledged;
+  private detachSignatureWarning;
+  private annotations;
+  private parityWorkflows;
   constructor(container: HTMLElement, options?: PptxViewerOptions);
   loadFile(file: Blob | ArrayBuffer | Uint8Array): Promise<void>;
+  openFile(): void;
+  openRecentFile(key: string): void;
+  createPresentation(templateId: string): void;
   loadUrl(url: string): Promise<void>;
   next: () => void;
   prev: () => void;
@@ -8753,15 +10047,69 @@ 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;
+  applyPresentationTheme(presetId: string): void;
   /** Run the shared WCAG checks against the live deck and show the results. */
   openAccessibility(): void;
+  openSettings(tab?: 'general' | 'shortcuts'): void;
+  openSetUpSlideShow(): void;
+  toggleSubtitles(): void;
+  openHeaderFooter(): void;
+  openCompare(): void;
+  openPrintDialog(): void;
+  startRehearsal(): void;
+  openSelectionPane(): void;
+  openSlideSorter(): void;
+  openComments(): void;
+  openHyperlink(): void;
+  openCustomShows(): void;
+  /** Open the document metadata editor backed by the current loaded deck. */
+  openDocumentProperties(): void;
+  openFontEmbedding(): void;
+  openDigitalSignatures(): void;
+  openPasswordProtection(): void;
+  openVersionHistory(): 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;
@@ -8772,8 +10120,10 @@ declare class PptxViewer extends ViewerExportHost implements PptxViewerInstance,
   toggleAutosave(): boolean;
   canUndo: () => boolean;
   canRedo: () => boolean;
-  save(): Promise<Uint8Array>;
+  save(format?: PptxSaveFormat): Promise<Uint8Array>;
+  downloadAs(format: PptxSaveFormat, fileName?: string): Promise<void>;
   downloadPptx(fileName?: string): Promise<void>;
+  packageForSharing(fileName?: string): Promise<void>;
   deleteSelected: () => void;
   getSelectedElementId: () => string | null;
   enterPresentation(): Promise<void>;
@@ -8787,6 +10137,7 @@ declare class PptxViewer extends ViewerExportHost implements PptxViewerInstance,
   setAutosaveEnabled(enabled: boolean): void;
   isAutosaveEnabled: () => boolean;
   openBroadcast(): void;
+  openShare(): void;
   destroy(): void;
   private remountChrome;
 }
@@ -8822,5 +10173,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 SvgExportOptions, type TranslationKey, type TranslationMessages, type Translator, type ViewerState, type ViewerTheme, type ViewerThemeColors, type ZoomLevel, applyStyleMap, createDefaultRegistry, createEl, createElementRendererRegistry, createPptxViewer, createSvgEl, createTranslator, defaultCssVars, defaultRadius, defaultThemeColors, exportAllSlidesToSvg, exportSlideToSvg, getViewerCss, keyToLabel, loadPresentationDeck, parsePresentationSessionId, renderSlideStage, themeToCssVars, translationsEn, vermilionDarkTheme, vermilionLightTheme };
 //# sourceMappingURL=index.d.ts.map