pptx-react-viewer 4.3.0 → 4.5.0

package/dist/i18n/zh-CN.cjs

@@ -1763,6 +1763,12 @@ var translations14 = {
   "pptx.compare.noDifferences": "\u6CA1\u6709\u5DEE\u5F02",
   "pptx.compare.summary": "\u6DFB\u52A0\u4E86 {{added}}\uFF0C\u5220\u9664\u4E86 {{removed}}\uFF0C\u66F4\u6539\u4E86 {{changed}}",
   "pptx.compare.title": "\u6BD4\u8F83",
+  "pptx.canvasContextMenu.ariaLabel": "\u753B\u5E03\u53F3\u952E\u83DC\u5355",
+  "pptx.canvasContextMenu.formatBackground": "\u8BBE\u7F6E\u80CC\u666F\u683C\u5F0F...",
+  "pptx.canvasContextMenu.gridAndGuides": "\u7F51\u683C\u548C\u53C2\u8003\u7EBF",
+  "pptx.canvasContextMenu.layout": "\u7248\u5F0F",
+  "pptx.canvasContextMenu.resetSlide": "\u91CD\u7F6E\u5E7B\u706F\u7247",
+  "pptx.canvasContextMenu.ruler": "\u6807\u5C3A",
   "pptx.contextMenu.addComment": "\u6DFB\u52A0\u6279\u6CE8",
   "pptx.contextMenu.bringForward": "\u4E0A\u79FB\u4E00\u5C42",
   "pptx.contextMenu.bringToFront": "\u7F6E\u4E8E\u9876\u5C42",
@@ -1772,7 +1778,10 @@ var translations14 = {
   "pptx.contextMenu.deleteColumn": "\u5220\u9664\u5217",
   "pptx.contextMenu.deleteRow": "\u5220\u9664\u884C",
   "pptx.contextMenu.duplicate": "\u590D\u5236",
+  "pptx.contextMenu.editAltText": "\u7F16\u8F91\u66FF\u6362\u6587\u5B57...",
   "pptx.contextMenu.editHyperlink": "\u7F16\u8F91\u8D85\u94FE\u63A5",
+  "pptx.contextMenu.editText": "\u7F16\u8F91\u6587\u5B57",
+  "pptx.contextMenu.formatShape": "\u8BBE\u7F6E\u5F62\u72B6\u683C\u5F0F...",
   "pptx.contextMenu.group": "\u7EC4\u5408",
   "pptx.contextMenu.insertColumnLeft": "\u5411\u5DE6\u63D2\u5165\u5217",
   "pptx.contextMenu.insertColumnRight": "\u5728\u53F3\u4FA7\u63D2\u5165\u5217",
@@ -1781,10 +1790,18 @@ var translations14 = {
   "pptx.contextMenu.mergeCells": "\u5411\u53F3\u5408\u5E76",
   "pptx.contextMenu.mergeSelectedCells": "\u5408\u5E76\u9009\u5B9A\u7684\u5355\u5143\u683C",
   "pptx.contextMenu.paste": "\u7C98\u8D34",
+  "pptx.contextMenu.saveAsPicture": "\u53E6\u5B58\u4E3A\u56FE\u7247...",
   "pptx.contextMenu.sendBackward": "\u4E0B\u79FB\u4E00\u5C42",
   "pptx.contextMenu.sendToBack": "\u7F6E\u4E8E\u5E95\u5C42",
+  "pptx.contextMenu.sizeAndPosition": "\u5927\u5C0F\u548C\u4F4D\u7F6E...",
   "pptx.contextMenu.splitCell": "\u62C6\u5206\u5355\u5143\u683C",
   "pptx.contextMenu.ungroup": "\u53D6\u6D88\u7EC4\u5408",
+  "pptx.pasteSpecial.dialogTitle": "\u9009\u62E9\u6027\u7C98\u8D34",
+  "pptx.pasteSpecial.keepSourceFormatting": "\u4FDD\u7559\u6E90\u683C\u5F0F",
+  "pptx.pasteSpecial.keepTextOnly": "\u53EA\u4FDD\u7559\u6587\u672C",
+  "pptx.pasteSpecial.optionsLabel": "\u7C98\u8D34\u9009\u9879",
+  "pptx.pasteSpecial.picture": "\u56FE\u7247",
+  "pptx.pasteSpecial.useDestinationTheme": "\u4F7F\u7528\u76EE\u6807\u4E3B\u9898",
   "pptx.hyperlink.actionEndShow": "\u7ED3\u675F\u653E\u6620",
   "pptx.hyperlink.actionFirstSlide": "\u7B2C\u4E00\u5F20\u5E7B\u706F\u7247",
   "pptx.hyperlink.actionLabel": "\u64CD\u4F5C",
@@ -2124,6 +2141,7 @@ var translations17 = {
   "pptx.media.startAutomatically": "\u81EA\u52A8",
   "pptx.media.playAcrossSlides": "\u8DE8\u5E7B\u706F\u7247\u64AD\u653E",
   "pptx.media.fullScreen": "\u5168\u5C4F",
+  "pptx.media.onlineVideoTitle": "\u5728\u7EBF\u89C6\u9891",
   "pptx.media.hideWhenNotPlaying": "\u4E0D\u64AD\u653E\u65F6\u9690\u85CF",
   "pptx.media.bookmarks": "\u4E66\u7B7E",
   "pptx.media.bookmark": "\u4E66\u7B7E",
@@ -2485,6 +2503,15 @@ var translations19 = {
   "pptx.slideSorter.contextMenu.hideSlides": "\u9690\u85CF\u5E7B\u706F\u7247",
   "pptx.slideSorter.contextMenu.paste": "\u7C98\u8D34",
   "pptx.slideSorter.contextMenu.showSlides": "\u663E\u793A\u5E7B\u706F\u7247",
+  "pptx.slidesPane.contextMenu.newSlide": "\u65B0\u5EFA\u5E7B\u706F\u7247",
+  "pptx.slidesPane.contextMenu.duplicate": "\u590D\u5236\u5E7B\u706F\u7247",
+  "pptx.slidesPane.contextMenu.duplicateCount": "\u590D\u5236 {{count}} \u5F20\u5E7B\u706F\u7247",
+  "pptx.slidesPane.contextMenu.delete": "\u5220\u9664\u5E7B\u706F\u7247",
+  "pptx.slidesPane.contextMenu.deleteCount": "\u5220\u9664 {{count}} \u5F20\u5E7B\u706F\u7247",
+  "pptx.slidesPane.contextMenu.layout": "\u7248\u5F0F",
+  "pptx.slidesPane.contextMenu.hide": "\u9690\u85CF\u5E7B\u706F\u7247",
+  "pptx.slidesPane.contextMenu.show": "\u663E\u793A\u5E7B\u706F\u7247",
+  "pptx.slidesPane.contextMenu.addSection": "\u6DFB\u52A0\u8282",
   "pptx.mobileBar.ariaLabel": "\u7F16\u8F91\u5668\u64CD\u4F5C",
   "pptx.mobileBar.slideControls": "\u5E7B\u706F\u7247\u63A7\u4EF6",
   "pptx.mobileBar.previousSlide": "\u4E0A\u4E00\u5F20\u5E7B\u706F\u7247",
@@ -2766,6 +2793,12 @@ var translations21 = {
   "pptx.transition.morphOption.byObject": "\u6309\u5BF9\u8C61",
   "pptx.transition.morphOption.byWord": "\u6309\u5B57\u8BCD",
   "pptx.transition.morphOption.byChar": "\u6309\u5B57\u7B26",
+  "pptx.transition.pattern": "\u56FE\u6848",
+  "pptx.transition.pattern.diamond": "\u83F1\u5F62",
+  "pptx.transition.pattern.hexagon": "\u516D\u8FB9\u5F62",
+  "pptx.transition.pattern.strip": "\u6761\u5E26",
+  "pptx.transition.pattern.rectangle": "\u77E9\u5F62",
+  "pptx.transition.thruBlk": "\u7ECF\u9ED1\u573A\u8FC7\u6E21",
   "pptx.keepAnnotations.title": "\u4FDD\u7559\u58A8\u8FF9\u6807\u6CE8\uFF1F",
   "pptx.keepAnnotations.description": "\u60A8\u5728 {{slides}} \u5F20\u5E7B\u706F\u7247\u4E0A\u6DFB\u52A0\u4E86 {{count}} \u6761\u58A8\u8FF9\u6807\u6CE8\u3002\u8981\u5C06\u5176\u4FDD\u7559\u5728\u5E7B\u706F\u7247\u4E0A\uFF0C\u8FD8\u662F\u653E\u5F03\uFF1F",
   "pptx.keepAnnotations.discard": "\u653E\u5F03",

package/dist/i18n/zh-CN.mjs

@@ -1737,6 +1737,12 @@ var translations14 = {
   "pptx.compare.noDifferences": "\u6CA1\u6709\u5DEE\u5F02",
   "pptx.compare.summary": "\u6DFB\u52A0\u4E86 {{added}}\uFF0C\u5220\u9664\u4E86 {{removed}}\uFF0C\u66F4\u6539\u4E86 {{changed}}",
   "pptx.compare.title": "\u6BD4\u8F83",
+  "pptx.canvasContextMenu.ariaLabel": "\u753B\u5E03\u53F3\u952E\u83DC\u5355",
+  "pptx.canvasContextMenu.formatBackground": "\u8BBE\u7F6E\u80CC\u666F\u683C\u5F0F...",
+  "pptx.canvasContextMenu.gridAndGuides": "\u7F51\u683C\u548C\u53C2\u8003\u7EBF",
+  "pptx.canvasContextMenu.layout": "\u7248\u5F0F",
+  "pptx.canvasContextMenu.resetSlide": "\u91CD\u7F6E\u5E7B\u706F\u7247",
+  "pptx.canvasContextMenu.ruler": "\u6807\u5C3A",
   "pptx.contextMenu.addComment": "\u6DFB\u52A0\u6279\u6CE8",
   "pptx.contextMenu.bringForward": "\u4E0A\u79FB\u4E00\u5C42",
   "pptx.contextMenu.bringToFront": "\u7F6E\u4E8E\u9876\u5C42",
@@ -1746,7 +1752,10 @@ var translations14 = {
   "pptx.contextMenu.deleteColumn": "\u5220\u9664\u5217",
   "pptx.contextMenu.deleteRow": "\u5220\u9664\u884C",
   "pptx.contextMenu.duplicate": "\u590D\u5236",
+  "pptx.contextMenu.editAltText": "\u7F16\u8F91\u66FF\u6362\u6587\u5B57...",
   "pptx.contextMenu.editHyperlink": "\u7F16\u8F91\u8D85\u94FE\u63A5",
+  "pptx.contextMenu.editText": "\u7F16\u8F91\u6587\u5B57",
+  "pptx.contextMenu.formatShape": "\u8BBE\u7F6E\u5F62\u72B6\u683C\u5F0F...",
   "pptx.contextMenu.group": "\u7EC4\u5408",
   "pptx.contextMenu.insertColumnLeft": "\u5411\u5DE6\u63D2\u5165\u5217",
   "pptx.contextMenu.insertColumnRight": "\u5728\u53F3\u4FA7\u63D2\u5165\u5217",
@@ -1755,10 +1764,18 @@ var translations14 = {
   "pptx.contextMenu.mergeCells": "\u5411\u53F3\u5408\u5E76",
   "pptx.contextMenu.mergeSelectedCells": "\u5408\u5E76\u9009\u5B9A\u7684\u5355\u5143\u683C",
   "pptx.contextMenu.paste": "\u7C98\u8D34",
+  "pptx.contextMenu.saveAsPicture": "\u53E6\u5B58\u4E3A\u56FE\u7247...",
   "pptx.contextMenu.sendBackward": "\u4E0B\u79FB\u4E00\u5C42",
   "pptx.contextMenu.sendToBack": "\u7F6E\u4E8E\u5E95\u5C42",
+  "pptx.contextMenu.sizeAndPosition": "\u5927\u5C0F\u548C\u4F4D\u7F6E...",
   "pptx.contextMenu.splitCell": "\u62C6\u5206\u5355\u5143\u683C",
   "pptx.contextMenu.ungroup": "\u53D6\u6D88\u7EC4\u5408",
+  "pptx.pasteSpecial.dialogTitle": "\u9009\u62E9\u6027\u7C98\u8D34",
+  "pptx.pasteSpecial.keepSourceFormatting": "\u4FDD\u7559\u6E90\u683C\u5F0F",
+  "pptx.pasteSpecial.keepTextOnly": "\u53EA\u4FDD\u7559\u6587\u672C",
+  "pptx.pasteSpecial.optionsLabel": "\u7C98\u8D34\u9009\u9879",
+  "pptx.pasteSpecial.picture": "\u56FE\u7247",
+  "pptx.pasteSpecial.useDestinationTheme": "\u4F7F\u7528\u76EE\u6807\u4E3B\u9898",
   "pptx.hyperlink.actionEndShow": "\u7ED3\u675F\u653E\u6620",
   "pptx.hyperlink.actionFirstSlide": "\u7B2C\u4E00\u5F20\u5E7B\u706F\u7247",
   "pptx.hyperlink.actionLabel": "\u64CD\u4F5C",
@@ -2098,6 +2115,7 @@ var translations17 = {
   "pptx.media.startAutomatically": "\u81EA\u52A8",
   "pptx.media.playAcrossSlides": "\u8DE8\u5E7B\u706F\u7247\u64AD\u653E",
   "pptx.media.fullScreen": "\u5168\u5C4F",
+  "pptx.media.onlineVideoTitle": "\u5728\u7EBF\u89C6\u9891",
   "pptx.media.hideWhenNotPlaying": "\u4E0D\u64AD\u653E\u65F6\u9690\u85CF",
   "pptx.media.bookmarks": "\u4E66\u7B7E",
   "pptx.media.bookmark": "\u4E66\u7B7E",
@@ -2459,6 +2477,15 @@ var translations19 = {
   "pptx.slideSorter.contextMenu.hideSlides": "\u9690\u85CF\u5E7B\u706F\u7247",
   "pptx.slideSorter.contextMenu.paste": "\u7C98\u8D34",
   "pptx.slideSorter.contextMenu.showSlides": "\u663E\u793A\u5E7B\u706F\u7247",
+  "pptx.slidesPane.contextMenu.newSlide": "\u65B0\u5EFA\u5E7B\u706F\u7247",
+  "pptx.slidesPane.contextMenu.duplicate": "\u590D\u5236\u5E7B\u706F\u7247",
+  "pptx.slidesPane.contextMenu.duplicateCount": "\u590D\u5236 {{count}} \u5F20\u5E7B\u706F\u7247",
+  "pptx.slidesPane.contextMenu.delete": "\u5220\u9664\u5E7B\u706F\u7247",
+  "pptx.slidesPane.contextMenu.deleteCount": "\u5220\u9664 {{count}} \u5F20\u5E7B\u706F\u7247",
+  "pptx.slidesPane.contextMenu.layout": "\u7248\u5F0F",
+  "pptx.slidesPane.contextMenu.hide": "\u9690\u85CF\u5E7B\u706F\u7247",
+  "pptx.slidesPane.contextMenu.show": "\u663E\u793A\u5E7B\u706F\u7247",
+  "pptx.slidesPane.contextMenu.addSection": "\u6DFB\u52A0\u8282",
   "pptx.mobileBar.ariaLabel": "\u7F16\u8F91\u5668\u64CD\u4F5C",
   "pptx.mobileBar.slideControls": "\u5E7B\u706F\u7247\u63A7\u4EF6",
   "pptx.mobileBar.previousSlide": "\u4E0A\u4E00\u5F20\u5E7B\u706F\u7247",
@@ -2740,6 +2767,12 @@ var translations21 = {
   "pptx.transition.morphOption.byObject": "\u6309\u5BF9\u8C61",
   "pptx.transition.morphOption.byWord": "\u6309\u5B57\u8BCD",
   "pptx.transition.morphOption.byChar": "\u6309\u5B57\u7B26",
+  "pptx.transition.pattern": "\u56FE\u6848",
+  "pptx.transition.pattern.diamond": "\u83F1\u5F62",
+  "pptx.transition.pattern.hexagon": "\u516D\u8FB9\u5F62",
+  "pptx.transition.pattern.strip": "\u6761\u5E26",
+  "pptx.transition.pattern.rectangle": "\u77E9\u5F62",
+  "pptx.transition.thruBlk": "\u7ECF\u9ED1\u573A\u8FC7\u6E21",
   "pptx.keepAnnotations.title": "\u4FDD\u7559\u58A8\u8FF9\u6807\u6CE8\uFF1F",
   "pptx.keepAnnotations.description": "\u60A8\u5728 {{slides}} \u5F20\u5E7B\u706F\u7247\u4E0A\u6DFB\u52A0\u4E86 {{count}} \u6761\u58A8\u8FF9\u6807\u6CE8\u3002\u8981\u5C06\u5176\u4FDD\u7559\u5728\u5E7B\u706F\u7247\u4E0A\uFF0C\u8FD8\u662F\u653E\u5F03\uFF1F",
   "pptx.keepAnnotations.discard": "\u653E\u5F03",

package/dist/i18n.js

@@ -1,19 +1,19 @@
 'use strict';
 
-var chunkW5KLLGVH_js = require('./chunk-W5KLLGVH.js');
+var chunkUMQV2432_js = require('./chunk-UMQV2432.js');
 require('./chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "LOCALE_CATALOG", {
   enumerable: true,
-  get: function () { return chunkW5KLLGVH_js.LOCALE_CATALOG; }
+  get: function () { return chunkUMQV2432_js.LOCALE_CATALOG; }
 });
 Object.defineProperty(exports, "keyToLabel", {
   enumerable: true,
-  get: function () { return chunkW5KLLGVH_js.keyToLabel; }
+  get: function () { return chunkUMQV2432_js.keyToLabel; }
 });
 Object.defineProperty(exports, "translationsEn", {
   enumerable: true,
-  get: function () { return chunkW5KLLGVH_js.translationsEn; }
+  get: function () { return chunkUMQV2432_js.translationsEn; }
 });

package/dist/i18n.mjs

@@ -1,2 +1,2 @@
-export { LOCALE_CATALOG, keyToLabel, translationsEn } from './chunk-OBQ453H6.mjs';
+export { LOCALE_CATALOG, keyToLabel, translationsEn } from './chunk-APAVAD2A.mjs';
 import './chunk-XGB3TDIC.mjs';

package/dist/index.d.ts

@@ -1713,6 +1713,16 @@ interface TextStyle {
   hyperlinkHighlightClick?: boolean;
   /** Whether hyperlink ends a sound (`a:hlinkClick/@endSnd`). */
   hyperlinkEndSound?: boolean;
+  /**
+   * Raw `a:hlinkClick/a:extLst` child, preserved verbatim for round-trip.
+   * Carries vendor extensions this engine does not interpret, most commonly
+   * `ahyp:hlinkClr` (Microsoft's "hyperlink color" extension,
+   * `{A12FA001-AC4F-418D-AE19-62706E023703}`), which records whether a
+   * hyperlink run should paint with the theme's text colour instead of the
+   * hyperlink colour. Dropping the whole `a:extLst` silently reverted such a
+   * run to the default (themed) hyperlink colour on save.
+   */
+  hyperlinkExtensionXml?: XmlObject;
   /** Kumimoji (ideographic text combining) flag for vertical CJK text (`a:rPr/@kumimoji`). */
   kumimoji?: boolean;
   /** Normalize height flag (`a:rPr/@normalizeH`). */
@@ -1815,6 +1825,15 @@ interface TextStyle {
   textInnerShadowOffsetX?: number;
   /** Text inner shadow vertical offset in px. */
   textInnerShadowOffsetY?: number;
+  /**
+   * Original inner-shadow colour-choice XML (`a:innerShdw`'s
+   * `a:prstClr`/`a:schemeClr`/`a:srgbClr`/… child), preserved verbatim so an
+   * authored preset or theme colour round-trips instead of always being
+   * re-serialized as a resolved `a:srgbClr`. Mirrors {@link textGlowColorXml}.
+   */
+  textInnerShadowColorXml?: XmlObject;
+  /** Theme colour slot the inner shadow colour resolved from, when it is `a:schemeClr`. */
+  textInnerShadowColorRef?: PptxThemeColorRef;
   /** Preset shadow type from `a:prstShdw/@prst` (e.g. "shdw1"..."shdw20"). */
   textPresetShadowName?: string;
   /** Preset shadow colour as hex string. */
@@ -1827,6 +1846,18 @@ interface TextStyle {
   textPresetShadowDirection?: number;
   /** Text blur effect radius in px (`a:blur`). */
   textBlurRadius?: number;
+  /**
+   * Text soft-edge radius in px (`a:softEdge/@rad`).
+   *
+   * Feathers the glyph's own edges (a uniform blur of the alpha silhouette,
+   * the same effect a shape's `a:softEdge` gives its fill), unrelated to
+   * `a:blur` (which blurs the whole run, colour included) or a shadow. Never
+   * parsed before this field existed, so `a:softEdge` on a run was silently
+   * dropped: PowerPoint fades the glyphs to near-transparent at their
+   * outline (COM-verified, `audit-text` slide 14's "SOFTEDGE" run), while
+   * the viewer painted them fully crisp.
+   */
+  textSoftEdgeRadius?: number;
   /**
    * Raw `a:effectDag` XML node from `a:rPr`, preserved verbatim for
    * round-trip serialisation. Mirrors the shape-level
@@ -1866,6 +1897,15 @@ interface TextStyle {
   textGlowRadius?: number;
   /** Text glow opacity (0-1). */
   textGlowOpacity?: number;
+  /**
+   * Original glow colour-choice XML (`a:glow`'s `a:schemeClr`/`a:srgbClr`/…
+   * child), preserved verbatim so a theme colour reference round-trips
+   * instead of always being re-serialized as a resolved `a:srgbClr` (which
+   * cuts the glow off from theme/Recolor changes).
+   */
+  textGlowColorXml?: XmlObject;
+  /** Theme colour slot the glow colour resolved from, when it is `a:schemeClr`. */
+  textGlowColorRef?: PptxThemeColorRef;
   /** Text reflection enabled flag. */
   textReflection?: boolean;
   /** Text reflection blur radius in px. */
@@ -2002,6 +2042,18 @@ interface BulletInfo {
   paragraphIndex?: number;
   /** Bullet font family from `a:buFont`. */
   fontFamily?: string;
+  /**
+   * PANOSE font-matching hint from `a:buFont/@panose`. `a:buFont` is a
+   * CT_TextFont, the same complex type as `a:latin`/`a:ea`/`a:cs`/`a:sym`
+   * (which carry the equivalent `TextStyle.latinFontPanose` etc.), so a
+   * bullet's own PANOSE/pitch-family/charset decide the fallback glyph
+   * PowerPoint substitutes when the named typeface is missing.
+   */
+  fontPanose?: string;
+  /** Font pitch-and-family byte from `a:buFont/@pitchFamily`. */
+  fontPitchFamily?: number;
+  /** Font character-set byte from `a:buFont/@charset`. */
+  fontCharset?: number;
   /** Bullet size as percentage of text font size from `a:buSzPct`. */
   sizePercent?: number;
   /** Bullet size in points from `a:buSzPts`. */
@@ -3438,6 +3490,15 @@ interface PptxChartHistogramOptions {
   intervalClosed?: 'l' | 'r';
   underflow?: number | 'auto';
   overflow?: number | 'auto';
+  /**
+   * `c:layoutPr/cx:aggregation` was authored instead of `cx:binning`: the
+   * raw rows are CATEGORICAL (a Pareto chart's `clusteredColumn` series
+   * counting occurrences of each authored category, COM-verified against
+   * charts-com.pptx slide 31 / chartEx6.xml), not a numeric range to bin.
+   * Mutually exclusive with `binSize`/`binCount`/`intervalClosed`, which
+   * only apply to a true numeric-value histogram.
+   */
+  aggregateByCategory?: boolean;
 }
 /** Office 2016 ChartEx waterfall series layout options. */
 interface PptxChartWaterfallOptions {
@@ -4102,6 +4163,18 @@ interface PptxChartData {
    * the source" and callers should treat it as `true`. Surface only.
    */
   wireframe?: boolean;
+  /**
+   * Whether the surface chart is the 2-D "top view" projection
+   * (`c:surfaceChart`, PowerPoint's "Contour" / "Wireframe Contour" types)
+   * rather than the 3-D isometric one (`c:surface3DChart`, "3-D Surface" /
+   * "3-D Surface (Wireframe)"). Both element names map to chart type
+   * `"surface"`; this bit is the only thing that tells the renderer which
+   * of the two projections PowerPoint actually drew, since a top-view
+   * surface has no Z-axis at all (only category and series axes) while the
+   * 3-D one draws all three. Surface only; `undefined` for every other
+   * chart type.
+   */
+  surfaceTopView?: boolean;
   /**
    * Scatter presentation mode (`c:scatterChart/c:scatterStyle/@val`).
    *
@@ -7291,11 +7364,17 @@ interface ZoomPptxElement extends PptxElementBase, PptxImageProperties {
    * `zmPr/@returnToParent` (MS-PPTX `CT_ZoomObjectProperties`, shared by all
    * three Zoom kinds): whether continuing forward from the destination slide
    * during a live show returns to this Zoom's origin slide instead of
-   * advancing linearly through the deck. OOXML default is `true` when the
-   * attribute is present but this codebase leaves it `undefined` when the
-   * source XML omits it, so a round-trip never fabricates the attribute.
-   * For `zoomType: 'summary'`, this mirrors the first tile's own value; see
-   * {@link SummaryZoomTarget.returnToParent} for the per-tile value.
+   * advancing linearly through the deck. The schema declares `<xsd:attribute
+   * name="returnToParent" type="xsd:boolean" use="optional" default="true"/>`,
+   * so an ABSENT attribute means `true`, not `false`. This codebase still
+   * leaves the field `undefined` (rather than fabricating `true`) when the
+   * source XML omits it, so a round-trip never invents an attribute the
+   * source never had; a CONSUMER of this field (playback, e.g.
+   * `pptx-viewer-shared`'s `resolveZoomNavigationTarget`) must read
+   * `returnToParent !== false`, not `Boolean(returnToParent)`, to get the
+   * spec-correct effective value. For `zoomType: 'summary'`, this mirrors the
+   * first tile's own value; see {@link SummaryZoomTarget.returnToParent} for
+   * the per-tile value.
    */
   returnToParent?: boolean;
   /**
@@ -9295,7 +9374,12 @@ interface PptxSlideTransition {
   spokes?: number;
   /** Pattern type for shred transition. */
   pattern?: string;
-  /** Through-black flag for blinds/checker (OOXML `@_thruBlk`). */
+  /**
+   * Through-black flag (OOXML `@_thruBlk`). COM-verified to actually apply to
+   * `cut` and `fade` (see {@link TRANSITION_THRUBLK_TYPES}); parsed generically
+   * off any standard transition child so an unexpected authored value still
+   * round-trips.
+   */
   thruBlk?: boolean;
   /** Split orientation (horz/vert) parsed from `@_orient`. */
   orient?: PptxSplitOrientation;
@@ -12190,7 +12274,7 @@ interface ReflectionWrapperStyle {
   top: string;
   width: string;
   height: string;
-  /** Mirror (`scaleY(-1)`) composed with `@sx`/`@sy`/`@kx`/`@ky`/`@rot`. */
+  /** `scale(@sx, @sy)` (the sign of `@sy` IS the mirror) composed with `@kx`/`@ky`/`@rot`. */
   transform: string;
   /** Anchor point for the transform above, from `@algn` (default `center top`). */
   transformOrigin: string;
@@ -13153,6 +13237,28 @@ interface EditorImagePasteOptions {
   insertElement(element: ImagePptxElement): void;
 }
 //#endregion
+//#region src/render/zoom-return-navigation.d.ts
+/**
+ * The navigation-relevant fields of a Zoom click target, independent of
+ * `zoomType`.
+ *
+ * `returnToParent` is already resolved to its EFFECTIVE value here (not the
+ * raw, possibly-`undefined` `ZoomPptxElement`/`SummaryZoomTarget` field):
+ * `CT_ZoomObjectProperties/@returnToParent` (MS-PPTX) is `<xsd:attribute
+ * name="returnToParent" type="xsd:boolean" use="optional" default="true"/>`,
+ * so an ABSENT attribute means true, not false. Core deliberately stores
+ * `undefined` rather than fabricating `true` (so a round-trip never invents
+ * an attribute the source never had), which makes `Boolean(x)` the wrong way
+ * to read it; the two `resolve*NavigationTarget` functions below are the only
+ * place that distinction should be made.
+ */
+interface ZoomNavigationTarget {
+  targetSlideIndex: number;
+  targetSectionId?: string;
+  returnToParent: boolean;
+  transitionDurationMs?: number;
+}
+//#endregion
 //#region src/render/account.d.ts
 /** Local-only display profile shown in File > Account. Never sent anywhere; purely cosmetic. */
 interface ViewerProfile {
@@ -14416,6 +14522,8 @@ interface SlideCanvasProps {
   onContextMenu: (elementId: string, e: React$1__default.MouseEvent) => void;
   /** Called when the user presses mouse down on empty canvas space. */
   onCanvasMouseDown?: (e: React$1__default.MouseEvent) => void;
+  /** Right-click on empty canvas (no element hit); opens the canvas context menu. */
+  onCanvasContextMenu?: (e: React$1__default.MouseEvent) => void;
   onResizePointerDown: (elementId: string, e: React$1__default.MouseEvent, handle: string) => void;
   onAdjustmentPointerDown: (elementId: string, e: React$1__default.MouseEvent, descriptor: ShapeAdjustmentHandleDescriptor) => void;
   /** Commit a new rotation (degrees) when the on-canvas rotate handle is dragged. */
@@ -14494,7 +14602,7 @@ interface SlideCanvasProps {
   /** All slides in the presentation (for zoom element thumbnails). */
   allSlides?: readonly PptxSlide[];
   /** Callback fired when a zoom element is clicked in presentation mode. */
-  onZoomClick?: (targetSlideIndex: number, returnSlideIndex: number) => void;
+  onZoomClick?: (target: ZoomNavigationTarget, returnSlideIndex: number) => void;
   /** Index of the current slide (for zoom return navigation). */
   sourceSlideIndex?: number;
   /** Context for text field placeholder substitution (slide number, header/footer, etc.). */